<?php
/**
 * Orders as Matomo sees them.
 *
 * @package Rahkar\WP
 */

declare( strict_types = 1 );

namespace Rahkar\WP\Modules\Matomo;

use Rahkar\WP\Customers\Stats;
use WC_Order;
use WC_Order_Item_Product;

defined( 'ABSPATH' ) || exit;

/**
 * One description of an order for both ways it reaches Matomo — the thank-you
 * page and the server-side job — so the two can never send different numbers
 * for the same order id, and the browser's visitor id kept on the order.
 */
final class Orders {

	/**
	 * Order meta: the Matomo visitor id of the browser that placed the order.
	 */
	public const META_VISITOR = '_rahkar_matomo_vid';

	/**
	 * Order meta: when the server-side send was answered, or `rejected`.
	 */
	public const META_SENT = '_rahkar_matomo_sent';

	/**
	 * Keep the buyer's visitor id on a new order (contract 1.3, `analytics`).
	 *
	 * @param mixed $order The order being created.
	 *
	 * @internal Hooked to the classic and block checkouts.
	 */
	public static function stamp( $order ): void {
		$site = Config::site();

		if ( ! $order instanceof WC_Order || null === $site ) {
			return;
		}

		$id = Parse::visitorId( $_COOKIE, $site['site'] ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- Only a 16-hex id is taken out, by a strict pattern.

		if ( null === $id ) {
			return;
		}

		$order->update_meta_data( self::META_VISITOR, $id );
		$order->save_meta_data();
	}

	/**
	 * The visitor id kept on an order, or null.
	 *
	 * @param WC_Order $order The order.
	 */
	public static function visitorId( WC_Order $order ): ?string {
		$id = (string) $order->get_meta( self::META_VISITOR );

		return 1 === preg_match( '/^[0-9a-f]{16}$/', $id ) ? $id : null;
	}

	/**
	 * `analytics` for an order snapshot (contract 1.3).
	 *
	 * @param WC_Order $order The order.
	 *
	 * @return array{visitor_id: string}|null
	 */
	public static function analytics( WC_Order $order ): ?array {
		$id = self::visitorId( $order );

		return null === $id ? null : [ 'visitor_id' => $id ];
	}

	/**
	 * Is the order in one of the store's sale statuses?
	 *
	 * @param WC_Order $order The order.
	 */
	public static function isSale( WC_Order $order ): bool {
		return in_array( $order->get_status(), Stats::saleStatuses(), true );
	}

	/**
	 * The order's items and totals, in rials where the currency converts.
	 *
	 * Each item goes under its parent product id, not its SKU: SKUs are optional
	 * in WooCommerce and the dashboard knows products by id (DATA-MODEL §4-29).
	 *
	 * @param WC_Order $order The order.
	 *
	 * @return array{id: string, items: list<array{0: string, 1: string, 2: string, 3: float, 4: int}>, total: float, subtotal: float, tax: float, shipping: float, discount: float}
	 */
	public static function ecommerce( WC_Order $order ): array {
		$currency = $order->get_currency();
		$items    = [];

		foreach ( $order->get_items() as $item ) {
			if ( ! $item instanceof WC_Order_Item_Product ) {
				continue;
			}

			$quantity = max( 1, (int) $item->get_quantity() );
			$items[]  = [
				(string) $item->get_product_id(),
				$item->get_name(),
				'',
				Parse::money( (float) $item->get_subtotal() / $quantity, $currency ),
				$quantity,
			];
		}

		$discount = (float) $order->get_discount_total();

		return [
			'id'       => (string) $order->get_id(),
			'items'    => $items,
			'total'    => Parse::money( $order->get_total(), $currency ),
			'subtotal' => Parse::money( (float) $order->get_subtotal() - $discount, $currency ),
			'tax'      => Parse::money( $order->get_total_tax(), $currency ),
			'shipping' => Parse::money( $order->get_shipping_total(), $currency ),
			'discount' => Parse::money( $discount, $currency ),
		];
	}
}