<?php
/**
 * Free-shipping coupon presentation helpers (PRD 12.8.1 / AC-029).
 *
 * @package Kayvandra\MarginBeacon
 */

declare(strict_types=1);

namespace Kayvandra\MarginBeacon\Application\OrderRisk;

/**
 * Detects free-shipping coupons and supplies Safe display label.
 */
final class FreeShippingScope {

	/**
	 * Merchant label when merchandise margin is Safe but shipping is out of scope.
	 *
	 * @return string
	 */
	public static function safe_label() {
		return __( 'Product margin Safe — shipping cost excluded', 'marginbeacon' );
	}

	/**
	 * Short list-column label.
	 *
	 * @return string
	 */
	public static function safe_label_short() {
		return __( 'Safe — shipping excluded', 'marginbeacon' );
	}

	/**
	 * Whether order has a native coupon with free-shipping flag.
	 *
	 * @param \WC_Order $order Order.
	 * @return bool
	 */
	public static function order_has_free_shipping_coupon( $order ) {
		if ( ! $order || ! is_object( $order ) ) {
			return false;
		}
		foreach ( $order->get_items( 'coupon' ) as $item ) {
			$code = is_callable( array( $item, 'get_code' ) ) ? (string) $item->get_code() : '';
			if ( '' === $code || ! class_exists( '\WC_Coupon' ) ) {
				continue;
			}
			$coupon = new \WC_Coupon( $code );
			if ( $coupon->get_id() && $coupon->get_free_shipping() ) {
				return true;
			}
		}
		return false;
	}

	/**
	 * @param array $coverage Coverage JSON array.
	 * @return bool
	 */
	public static function coverage_excludes_shipping( array $coverage ) {
		return ! empty( $coverage['shipping_cost_excluded'] );
	}
}