<?php
/**
 * Cost resolution result.
 *
 * @package Kayvandra\MarginBeacon
 */

declare(strict_types=1);

namespace Kayvandra\MarginBeacon\Application\Cost;

use Kayvandra\MarginBeacon\Domain\Money\MoneyAmount;

/**
 * Value object for a resolved unit cost.
 */
final class CostResolution {

	/**
	 * @var MoneyAmount|null
	 */
	private $amount;

	/**
	 * @var string
	 */
	private $source;

	/**
	 * exact|estimated|missing
	 *
	 * @var string
	 */
	private $confidence;

	/**
	 * explicit|ambiguous|missing
	 *
	 * @var string
	 */
	private $presence;

	/**
	 * @var string|null
	 */
	private $reason_code;

	/**
	 * @param MoneyAmount|null $amount      Amount or null.
	 * @param string           $source      Source key.
	 * @param string           $confidence  Confidence.
	 * @param string           $presence    Presence.
	 * @param string|null      $reason_code Reason.
	 */
	public function __construct( $amount, $source, $confidence, $presence, $reason_code = null ) {
		$this->amount      = $amount;
		$this->source      = $source;
		$this->confidence  = $confidence;
		$this->presence    = $presence;
		$this->reason_code = $reason_code;
	}

	/**
	 * Missing cost — never coerce to zero.
	 *
	 * @param string $reason Reason code.
	 * @return CostResolution
	 */
	public static function missing( $reason = 'MB_COST_MISSING' ) {
		return new self( null, 'none', 'missing', 'missing', $reason );
	}

	/**
	 * Ambiguous zero from source without presence semantics.
	 *
	 * @return CostResolution
	 */
	public static function ambiguous_zero() {
		return new self( null, 'unresolved', 'missing', 'ambiguous', 'MB_COST_PRESENCE_UNRESOLVED' );
	}

	/**
	 * @return MoneyAmount|null
	 */
	public function amount() {
		return $this->amount;
	}

	/**
	 * @return string
	 */
	public function source() {
		return $this->source;
	}

	/**
	 * @return string
	 */
	public function confidence() {
		return $this->confidence;
	}

	/**
	 * @return string
	 */
	public function presence() {
		return $this->presence;
	}

	/**
	 * @return string|null
	 */
	public function reason_code() {
		return $this->reason_code;
	}

	/**
	 * @return bool
	 */
	public function is_resolved() {
		return null !== $this->amount;
	}
}