<?php
/**
 * Normalized domain signal for a possible contract-formation event.
 *
 * WooCommerce adapters translate channel-specific hooks into this object. The
 * domain/application layer decides whether the merchant policy matches it.
 *
 * @package Leanmerce\CommerceCompliance
 */

namespace Leanmerce\CommerceCompliance\Domain\Contract;

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

final class ContractFormationEvent {
	public function __construct(
		private readonly int $order_id,
		private readonly string $type,
		private readonly \DateTimeImmutable $occurred_at,
		private readonly string $source,
		private readonly ?string $value = null
	) {
		if ( $order_id <= 0 ) {
			throw new \InvalidArgumentException( 'A positive WooCommerce order ID is required.' );
		}
		if ( ! ContractFormationPolicy::is_supported_type( $type ) ) {
			throw new \InvalidArgumentException( 'Unsupported contract formation event type.' );
		}
	}

	public static function order_created( int $order_id, string $source, ?\DateTimeImmutable $occurred_at = null ): self {
		return new self( $order_id, ContractFormationPolicy::ORDER_CREATED, $occurred_at ?? self::now(), $source );
	}

	public static function payment_completed( int $order_id, string $source = 'woocommerce_payment_complete', ?\DateTimeImmutable $occurred_at = null ): self {
		return new self( $order_id, ContractFormationPolicy::PAYMENT_COMPLETED, $occurred_at ?? self::now(), $source );
	}

	public static function order_status( int $order_id, string $status, string $source = 'woocommerce_order_status_changed', ?\DateTimeImmutable $occurred_at = null ): self {
		return new self( $order_id, ContractFormationPolicy::ORDER_STATUS, $occurred_at ?? self::now(), $source, ContractFormationPolicy::normalize_status( $status ) );
	}

	public static function custom_provider( int $order_id, string $provider_id, ?\DateTimeImmutable $occurred_at = null ): self {
		return new self( $order_id, ContractFormationPolicy::CUSTOM_PROVIDER, $occurred_at ?? self::now(), 'provider:' . trim( $provider_id ), trim( $provider_id ) );
	}

	public function order_id(): int {
		return $this->order_id; }
	public function type(): string {
		return $this->type; }
	public function occurred_at(): \DateTimeImmutable {
		return $this->occurred_at; }
	public function source(): string {
		return $this->source; }
	public function value(): ?string {
		return $this->value; }

	/**
	 * Stable operation key for R1 formation. Different Woo callbacks for the same
	 * order intentionally converge on this key.
	 */
	public function r1_operation_key(): string {
		return 'snapshot:' . $this->order_id . ':R1';
	}

	/** @return array<string,mixed> */
	public function to_array(): array {
		return array(
			'order_id'    => $this->order_id,
			'type'        => $this->type,
			'value'       => $this->value,
			'source'      => $this->source,
			'occurred_at' => $this->occurred_at->setTimezone( new \DateTimeZone( 'UTC' ) )->format( 'Y-m-d\TH:i:s\Z' ),
		);
	}

	private static function now(): \DateTimeImmutable {
		return new \DateTimeImmutable( 'now', new \DateTimeZone( 'UTC' ) );
	}
}