<?php

declare(strict_types=1);

namespace App\FormBuilder\Publishing;

/**
 * RFC-WS-6 §3 (Q13) — outcome of evaluating a single {@see PublishGuard}.
 * Sealed via two named constructors: callers cannot construct
 * inconsistent states (passed-with-message, etc.).
 */
final readonly class PublishGuardResult
{
    /**
     * @param  array<string, mixed>  $context
     */
    private function __construct(
        public string $guardCode,
        public bool $passed,
        public ?string $messageKey = null,
        public ?string $offendingFormFieldId = null,
        public array $context = [],
    ) {}

    public static function passed(string $guardCode): self
    {
        return new self(guardCode: $guardCode, passed: true);
    }

    /**
     * @param  array<string, mixed>  $context
     */
    public static function failed(
        string $guardCode,
        string $messageKey,
        ?string $offendingFormFieldId = null,
        array $context = [],
    ): self {
        return new self(
            guardCode: $guardCode,
            passed: false,
            messageKey: $messageKey,
            offendingFormFieldId: $offendingFormFieldId,
            context: $context,
        );
    }
}