<?php
/**
 * Outcome of a signed call to the backend.
 *
 * @package CortexCommerce
 */

namespace CortexCommerce\Support;

defined( 'ABSPATH' ) || exit;

/**
 * 2xx is ok. A network error, 408, 429 or 5xx is ours to retry later. Anything else (any other 4xx, or a 3xx:
 * redirects are never followed) is a refusal.
 */
final class SignedResponse {

	const OK      = 'ok';
	const RETRY   = 'retry';
	const REFUSED = 'refused';

	/**
	 * @var string One of the constants above.
	 */
	public $kind;

	/**
	 * @var int HTTP status; 0 when the request never got an answer.
	 */
	public $status;

	/**
	 * @var array<string, mixed>|null The decoded JSON object, or null.
	 */
	public $json;

	/**
	 * @var string The transport error, when there was one.
	 */
	public $error;

	/**
	 * @var string The raw body, exactly as received: a signed answer is verified on these bytes, before decoding.
	 */
	public $body;

	/**
	 * @var string The X-Cortex-Response-Signature header, or '' when the answer carries none.
	 */
	public $signature;

	/**
	 * @param array<string, mixed>|null $json Decoded body.
	 */
	public function __construct( int $status, ?array $json, string $error = '', string $body = '', string $signature = '' ) {
		$this->status    = $status;
		$this->json      = $json;
		$this->error     = $error;
		$this->body      = $body;
		$this->signature = $signature;
		if ( $status >= 200 && $status < 300 ) {
			$this->kind = self::OK;
		} elseif ( 0 === $status || 408 === $status || 429 === $status || $status >= 500 ) {
			$this->kind = self::RETRY;
		} else {
			$this->kind = self::REFUSED;
		}
	}

	public function ok(): bool {
		return self::OK === $this->kind;
	}

	/**
	 * For log lines: the transport error or the HTTP status. Never the body.
	 */
	public function describe(): string {
		return 0 === $this->status ? $this->error : 'HTTP ' . $this->status;
	}
}