<?php
/**
 * Interception outcome value object.
 *
 * @package AgentFirewall
 */

declare(strict_types=1);

namespace AgentFirewall\Intercept;

use AgentFirewall\Policy\Decision;

defined( 'ABSPATH' ) || exit;

/**
 * Result of running an action through the interception pipeline.
 */
final class InterceptionOutcome {

	/**
	 * Constructor.
	 *
	 * @param Decision    $decision   Policy decision.
	 * @param int         $ledger_id  Ledger row recording this action.
	 * @param int|null    $pending_id Pending queue row (REQUIRE_APPROVAL only).
	 * @param string|null $reason      Denial reason (see Evaluation constants).
	 * @param int|null    $retry_after Seconds until a retry could succeed.
	 */
	public function __construct(
		public readonly Decision $decision,
		public readonly int $ledger_id,
		public readonly ?int $pending_id = null,
		public readonly ?string $reason = null,
		public readonly ?int $retry_after = null
	) {
	}

	/**
	 * Whether the original operation may execute now.
	 */
	public function may_execute(): bool {
		return Decision::ALLOW === $this->decision || Decision::LOG_ONLY === $this->decision;
	}
}