Action.php

<?php
/**
 * @author enea dhack <contact@vaened.dev>
 * @link https://vaened.dev DevFolio
 */

declare(strict_types=1);

namespace Vaened\DeltaOrchestrator;

use Closure;
use Vaened\DeltaOrchestrator\Bindings\Behavior;
use Vaened\DeltaOrchestrator\Exceptions\InvalidActionDefinition;
use Vaened\DeltaOrchestrator\Rules\Rule;

final readonly class Action
{
    /**
     * @param array<int, Field|Behavior> $fields
     * @param Closure(Field ...$fields): mixed $apply
     * @param (Closure(Field ...$fields): Rule)|null $when
     * @param string|null $description
     */
    public function __construct(
        private array    $fields,
        private Closure  $apply,
        private ?Closure $when = null,
        private ?string  $description = null,
    )
    {
        if ($this->fields === []) {
            throw new InvalidActionDefinition(
                reason     : 'Action fields cannot be empty',
                description: $this->description,
            );
        }
    }

    /**
     * @return array<int, Field|Behavior>
     */
    public function fields(): array
    {
        return $this->fields;
    }

    /**
     * @return Closure(Field ...$fields): mixed
     */
    public function apply(): Closure
    {
        return $this->apply;
    }

    /**
     * @return (Closure(Field ...$fields): Rule)|null
     */
    public function when(): ?Closure
    {
        return $this->when;
    }

    public function description(): ?string
    {
        return $this->description;
    }
}