<?php
/**
 * Pending action row value object.
 *
 * @package AgentFirewall
 */

declare(strict_types=1);

namespace AgentFirewall\Model;

use DateTimeImmutable;

defined( 'ABSPATH' ) || exit;

/**
 * Immutable row from adaf_pending (approval queue, ADR-8).
 */
final class PendingAction {

	/**
	 * Constructor.
	 *
	 * @param int                    $id                         Row id.
	 * @param int                    $ledger_id                  Linked ledger entry.
	 * @param int                    $agent_id                   Requesting agent.
	 * @param string                 $ability_name               Ability (or synthesized REST action name).
	 * @param array<string, mixed>   $stored_input               Payload to execute on approval.
	 * @param DateTimeImmutable|null $initial_entity_modified_at Target's modified timestamp at queue time.
	 * @param DateTimeImmutable      $expires_at                 Expiry deadline.
	 * @param string                 $status                     pending|approved|rejected|expired|drift_conflict|refused.
	 * @param int|null               $decided_by                 Deciding WP user.
	 * @param DateTimeImmutable|null $decided_at                 Decision timestamp.
	 * @param array<string, mixed>|null $request                 REST request envelope
	 *                                                            to re-send on approval
	 *                                                            (AF-18.2); null for other
	 *                                                            doors and for rows held
	 *                                                            before it existed.
	 */
	public function __construct(
		public readonly int $id,
		public readonly int $ledger_id,
		public readonly int $agent_id,
		public readonly string $ability_name,
		public readonly array $stored_input,
		public readonly ?DateTimeImmutable $initial_entity_modified_at,
		public readonly DateTimeImmutable $expires_at,
		public readonly string $status,
		public readonly ?int $decided_by,
		public readonly ?DateTimeImmutable $decided_at,
		public readonly ?array $request = null
	) {
	}
}