<?php
/**
 * WooCommerce Subscriptions.
 *
 * A renewal is a SECOND conversion against the ORIGINAL referral, with
 * kind=recurring. It is never a duplicate of the first sale, and it is never
 * a new, unattributed sale either. That single distinction is what lets one
 * model serve both the ecommerce and the subscription market.
 *
 * Every entry point here is guarded, because Subscriptions is a paid
 * extension most shops do not have.
 *
 * @package Affiliatant
 */

defined( 'ABSPATH' ) || exit;

/**
 * Carries the referral from the first order onto the subscription, and reads
 * it back on every renewal.
 */
class Affiliatant_Subscriptions {

	/**
	 * Hook up, if Subscriptions is there at all.
	 *
	 * @return void
	 */
	public static function boot() {
		if ( ! self::available() ) {
			return;
		}

		// woocommerce.com/document/subscriptions/develop/action-reference/
		//   do_action( 'woocommerce_checkout_subscription_created', $subscription, $order, $recurring_cart );
		// Fires once per subscription, with the subscription pending. This is
		// where the referral is copied onto the SUBSCRIPTION, because the
		// renewal order two years from now has no session, no cookie and no
		// link back to the original order other than this.
		add_action( 'woocommerce_checkout_subscription_created', array( __CLASS__, 'on_created' ), 10, 2 );

		//   do_action( 'woocommerce_subscription_renewal_payment_complete', $subscription, $last_order );
		// Renewals only, never the initial order and never a switch.
		add_action( 'woocommerce_subscription_renewal_payment_complete', array( __CLASS__, 'on_renewal_paid' ), 10, 2 );
	}

	/**
	 * Is WooCommerce Subscriptions active?
	 *
	 * The function check rather than the class check is the useful one: the
	 * wcs_* helpers also ship in subscriptions-core, which other Woo
	 * extensions bundle without the full Subscriptions plugin.
	 *
	 * @return bool
	 */
	public static function available() {
		return function_exists( 'wcs_order_contains_renewal' )
			&& function_exists( 'wcs_get_subscriptions_for_renewal_order' );
	}

	/**
	 * sale or recurring.
	 *
	 * @param WC_Order $order Order.
	 * @return string
	 */
	public static function kind_for_order( $order ) {
		if ( ! self::available() || ! is_a( $order, 'WC_Order' ) ) {
			return 'sale';
		}

		return wcs_order_contains_renewal( $order ) ? 'recurring' : 'sale';
	}

	/**
	 * The referral stored on the subscription a renewal order belongs to.
	 *
	 * Only consulted when the renewal order itself carries no click, which is
	 * the normal case: a renewal order is created by a scheduled job with no
	 * browser anywhere near it.
	 *
	 * @param WC_Order $order Renewal order.
	 * @return array
	 */
	public static function context_for_renewal( $order ) {
		if ( ! self::available() || ! is_a( $order, 'WC_Order' ) ) {
			return array();
		}
		if ( ! wcs_order_contains_renewal( $order ) ) {
			return array();
		}

		foreach ( (array) wcs_get_subscriptions_for_renewal_order( $order ) as $subscription ) {
			// WC_Subscription extends WC_Order, so the CRUD meta API is the
			// same one and there is no `get_post_meta` here either.
			$context = Affiliatant_Order::context( $subscription );
			if ( array() !== $context ) {
				return $context;
			}
		}

		return array();
	}

	/**
	 * Copy the referral onto the subscription at checkout.
	 *
	 * @param WC_Subscription $subscription The new subscription.
	 * @param WC_Order        $order        The order that created it.
	 * @return void
	 */
	public static function on_created( $subscription, $order = null ) {
		try {
			if ( ! Affiliatant_Settings::active() || ! is_a( $subscription, 'WC_Order' ) ) {
				return;
			}

			$context = is_a( $order, 'WC_Order' ) ? Affiliatant_Order::context( $order ) : array();
			if ( array() === $context ) {
				$context = Affiliatant_Capture::current();
			}
			if ( array() === $context ) {
				return;
			}

			Affiliatant_Order::bind( $subscription, $context );
		} catch ( \Throwable $e ) {
			Affiliatant_Sender::log( 'Binding a click to a subscription failed: ' . $e->getMessage() );
		}
	}

	/**
	 * A renewal was paid.
	 *
	 * The renewal order also moves to a paid status, so the status hook will
	 * reach the same order and compute the same event id. Both are registered
	 * because a gateway that marks a renewal paid without a status transition
	 * would otherwise be missed, and the queue's unique event id means two
	 * triggers still produce one conversion.
	 *
	 * @param WC_Subscription $subscription The subscription.
	 * @param WC_Order        $last_order   The renewal order.
	 * @return void
	 */
	public static function on_renewal_paid( $subscription, $last_order = null ) {
		try {
			if ( ! is_a( $last_order, 'WC_Order' ) ) {
				return;
			}
			Affiliatant_Reporter::report_sale( $last_order );
		} catch ( \Throwable $e ) {
			Affiliatant_Sender::log( 'Reporting a subscription renewal failed: ' . $e->getMessage() );
		}
	}
}