<?php
/**
 * Subscription Period
 *
 * @author    Pronamic <info@pronamic.eu>
 * @copyright 2005-2026 Pronamic
 * @license   GPL-3.0-or-later
 * @package   Pronamic\WordPress\Pay\Subscriptions
 */

namespace Pronamic\WordPress\Pay\Subscriptions;

use Pronamic\WordPress\DateTime\DateTime;
use Pronamic\WordPress\Money\Money;
use Pronamic\WordPress\Pay\MoneyJsonTransformer;
use Pronamic\WordPress\Pay\Payments\Payment;

/**
 * Subscription Period
 *
 * @version 2.5.0
 * @since   2.4.0
 */
class SubscriptionPeriod {
	/**
	 * Phase.
	 *
	 * @var SubscriptionPhase
	 */
	private $phase;

	/**
	 * The start date of this period.
	 *
	 * @var DateTime
	 */
	private $start_date;

	/**
	 * The end date of this period.
	 *
	 * @var DateTime
	 */
	private $end_date;

	/**
	 * The amount to pay for this period.
	 *
	 * @var Money
	 */
	private $amount;

	/**
	 * Construct and initialize subscription period object.
	 *
	 * @param SubscriptionPhase  $phase        Subscription phase.
	 * @param \DateTimeInterface $start_date   Start date.
	 * @param \DateTimeInterface $end_date     End date.
	 * @param Money              $amount       Taxed amount.
	 */
	public function __construct( SubscriptionPhase $phase, \DateTimeInterface $start_date, \DateTimeInterface $end_date, Money $amount ) {
		$this->phase      = $phase;
		$this->start_date = DateTime::create_from_interface( $start_date );
		$this->end_date   = DateTime::create_from_interface( $end_date );
		$this->amount     = $amount;
	}

	/**
	 * Get phase.
	 *
	 * @return SubscriptionPhase
	 */
	public function get_phase() {
		return $this->phase;
	}

	/**
	 * Set phase.
	 *
	 * @param SubscriptionPhase $phase Phase.
	 * @return void
	 */
	public function set_phase( SubscriptionPhase $phase ) {
		$this->phase = $phase;
	}

	/**
	 * Get start date.
	 *
	 * @return DateTime
	 */
	public function get_start_date() {
		return $this->start_date;
	}

	/**
	 * Get end date.
	 *
	 * @return DateTime
	 */
	public function get_end_date() {
		return $this->end_date;
	}

	/**
	 * Get amount.
	 *
	 * @return Money
	 */
	public function get_amount() {
		return $this->amount;
	}

	/**
	 * Is trial period?
	 *
	 * @return bool
	 */
	public function is_trial() {
		return $this->phase->is_trial();
	}

	/**
	 * New payment.
	 *
	 * @return Payment
	 */
	public function new_payment() {
		$subscription = $this->phase->get_subscription();

		$payment = $subscription->new_payment();

		$payment->add_period( $this );

		$payment->set_total_amount( $this->phase->get_amount() );

		return $payment;
	}

	/**
	 * From JSON.
	 *
	 * @param mixed $json Subscription period JSON.
	 * @return SubscriptionPeriod
	 * @throws \InvalidArgumentException Throws exception on invalid JSON.
	 * @throws \Exception                Throws exception on problem.
	 */
	public static function from_json( $json ) {
		if ( ! is_object( $json ) ) {
			throw new \InvalidArgumentException( 'JSON value must be an object.' );
		}

		if ( ! isset( $json->phase ) ) {
			throw new \InvalidArgumentException( 'Object must contain `phase` property.' );
		}

		if ( ! isset( $json->start_date ) ) {
			throw new \InvalidArgumentException( 'Object must contain `start_date` property.' );
		}

		if ( ! isset( $json->end_date ) ) {
			throw new \InvalidArgumentException( 'Object must contain `end_date` property.' );
		}

		if ( ! isset( $json->amount ) ) {
			throw new \InvalidArgumentException( 'Object must contain `amount` property.' );
		}

		/**
		 * Phase.
		 */
		if ( ! property_exists( $json->phase, 'subscription' ) ) {
			throw new \InvalidArgumentException( 'The `phase` property must contain a `subscription` property.' );
		}

		if ( ! property_exists( $json->phase, 'sequence_number' ) ) {
			throw new \InvalidArgumentException( 'The `phase` property must contain a `sequence_number` property.' );
		}

		/**
		 * Subscription.
		 */
		if ( ! \property_exists( $json->phase->subscription, 'id' ) ) {
			throw new \InvalidArgumentException( 'The `subscription` property must contain an `id` property.' );
		}

		$subscription = \get_pronamic_subscription( $json->phase->subscription->id );

		if ( null === $subscription ) {
			throw new \Exception(
				\sprintf(
					'Unable to find subscription by id: %s.',
					\esc_html( $json->phase->subscription->id )
				)
			);
		}

		$phase = $subscription->get_phase_by_sequence_number( $json->phase->sequence_number );

		if ( null === $phase ) {
			throw new \Exception(
				\sprintf(
					'Unable to find subscription phase by sequence number: %s.',
					\esc_html( $json->phase->sequence_number )
				)
			);
		}

		$start_date = new DateTime( $json->start_date );
		$end_date   = new DateTime( $json->end_date );

		$amount = MoneyJsonTransformer::from_json( $json->amount );

		return new self( $phase, $start_date, $end_date, $amount );
	}

	/**
	 * To JSON.
	 *
	 * @return object
	 */
	public function to_json() {
		$json = (object) [
			'phase'      => (object) [
				'$ref'            => \rest_url(
					\sprintf(
						'/%s/%s/%d/phases/%d',
						'pronamic-pay/v1',
						'subscriptions',
						$this->phase->get_subscription()->get_id(),
						$this->phase->get_sequence_number()
					)
				),
				'subscription'    => (object) [
					'$ref' => \rest_url(
						\sprintf(
							'/%s/%s/%d',
							'pronamic-pay/v1',
							'subscriptions',
							$this->phase->get_subscription()->get_id()
						)
					),
					'id'   => $this->phase->get_subscription()->get_id(),
				],
				'sequence_number' => $this->phase->get_sequence_number(),
			],
			'start_date' => $this->start_date->format( \DATE_ATOM ),
			'end_date'   => $this->end_date->format( \DATE_ATOM ),
			'amount'     => $this->amount->jsonSerialize(),
		];

		return $json;
	}

	/**
	 * Human readable range.
	 *
	 * @param null|string $format    Date format.
	 * @param string      $separator Period separator.
	 * @return string
	 */
	public function human_readable_range( $format = null, $separator = '–' ) {
		$start = $this->get_start_date();
		$end   = $this->get_end_date();

		if ( null === $format ) {
			$format = __( 'D j M Y', 'pronamic-ideal' );
		}

		$format_start = $format;
		$format_end   = $format;

		// Check if year is equal.
		if ( $start->format( 'Y' ) === $end->format( 'Y' ) ) {
			$format_start = \str_replace( ' Y', '', $format_start );

			// Check if month is equal.
			if ( $start->format( 'm' ) === $end->format( 'm' ) ) {
				$format_start = \str_replace( ' m', '', $format_start );
				$format_start = \str_replace( ' M', '', $format_start );
			}
		}

		// Check if day is equal.
		if ( $start->format( 'D' ) === $end->format( 'D' ) ) {
			$format_end = \str_replace( 'D ', '', $format_end );
		}

		return \sprintf(
			'%1$s %2$s %3$s',
			$start->format_i18n( $format_start ),
			\esc_html( $separator ),
			$end->format_i18n( $format_end )
		);
	}
}
