<?php
/**
 * Stamps orders placed before Agent Stamp was active, from what WooCommerce saved.
 *
 * WooCommerce keeps each order's user-agent and source. That is enough to name
 * a declared agent, a crawler claim, an API order, or an ordinary browser. A
 * signature and the checkout page signals were never saved, so a past order can
 * never be stamped signed, Likely agent, or Unattended.
 *
 * @package AgentStamp
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

class AgentStamp_History {

	const NOTE = ' Stamped later from the saved user-agent. A signature and checkout page signals were not available.';

	/**
	 * @param string $user_agent The order's saved customer user-agent.
	 * @param string $via        WooCommerce created_via.
	 * @param int    $now
	 * @return array{verdict:string,name:string,confidence:string,detail:string}|null Null when the order is not a purchase someone placed.
	 */
	public static function classify_saved( $user_agent, $via, $now ) {
		$via = (string) $via;
		if ( 'admin' === $via ) {
			return array(
				'verdict'    => 'human',
				'name'       => '',
				'confidence' => 'browser',
				'detail'     => 'Placed from the WordPress admin.',
			);
		}
		$api = AgentStamp_Classifier::is_api_channel( $via );
		if ( ! $api && ! in_array( $via, array( 'checkout', 'store-api' ), true ) ) {
			return null;
		}

		$classifier = new AgentStamp_Classifier(
			new AgentStamp_Signature( new AgentStamp_Directory(), new AgentStamp_Wp_Nonces() )
		);
		$result     = $classifier->classify( new AgentStamp_Request( 'POST', '', (string) $user_agent, array() ), (int) $now );
		if ( $api ) {
			$result = AgentStamp_Classifier::for_channel( $result, (string) $user_agent, $via );
		}
		$result['detail'] .= self::NOTE;
		return $result;
	}
}