crewli/api/app/FormBuilder/Bindings/BindingApplicationResult.php

<?php

declare(strict_types=1);

namespace App\FormBuilder\Bindings;

use Throwable;

/**
 * RFC-WS-6 §3 (Q4) — the result of applying a single resolved binding
 * to its target. Sealed via two named constructors so consumers can't
 * synthesise impossible states (success-with-exception, etc.).
 */
final readonly class BindingApplicationResult
{
    private function __construct(
        public string $bindingId,
        public string $targetEntity,
        public string $targetAttribute,
        public bool $success,
        public mixed $oldValue,
        public mixed $newValue,
        public ?string $exceptionClass = null,
        public ?string $exceptionMessage = null,
    ) {}

    public static function succeeded(
        string $bindingId,
        string $targetEntity,
        string $targetAttribute,
        mixed $oldValue,
        mixed $newValue,
    ): self {
        return new self(
            bindingId: $bindingId,
            targetEntity: $targetEntity,
            targetAttribute: $targetAttribute,
            success: true,
            oldValue: $oldValue,
            newValue: $newValue,
        );
    }

    public static function failed(
        string $bindingId,
        string $targetEntity,
        string $targetAttribute,
        Throwable $e,
    ): self {
        return new self(
            bindingId: $bindingId,
            targetEntity: $targetEntity,
            targetAttribute: $targetAttribute,
            success: false,
            oldValue: null,
            newValue: null,
            exceptionClass: $e::class,
            exceptionMessage: $e->getMessage(),
        );
    }
}