<?php
/**
 * Result of converting an order intent.
 *
 * @package Bookline
 */

declare( strict_types=1 );

namespace Bookline\Application\OrderIntent;

/**
 * Idempotent conversion response (docs/19 §4).
 *
 * @since 0.1.0
 */
final class ConversionResult {

	/**
	 * Constructor.
	 *
	 * @param int  $order_id        Resulting order id.
	 * @param bool $created_now     True when this call created the order.
	 * @param bool $already_existed True when a prior conversion already finished.
	 */
	public function __construct(
		private readonly int $order_id,
		private readonly bool $created_now,
		private readonly bool $already_existed,
	) {}

	/**
	 * Fresh conversion.
	 *
	 * @param int $order_id Order id.
	 *
	 * @since 0.1.0
	 */
	public static function created( int $order_id ): self {
		return new self( $order_id, true, false );
	}

	/**
	 * Duplicate submit after a successful conversion.
	 *
	 * @param int $order_id Existing order id.
	 *
	 * @since 0.1.0
	 */
	public static function already_converted( int $order_id ): self {
		return new self( $order_id, false, true );
	}

	/**
	 * Order id.
	 *
	 * @since 0.1.0
	 */
	public function order_id(): int {
		return $this->order_id;
	}

	/**
	 * Whether this call created the order.
	 *
	 * @since 0.1.0
	 */
	public function created_now(): bool {
		return $this->created_now;
	}

	/**
	 * Whether the order already existed from a prior conversion.
	 *
	 * @since 0.1.0
	 */
	public function already_existed(): bool {
		return $this->already_existed;
	}
}