<?php
/**
 * Result of one HTTP check (after following redirects).
 *
 * @package Unbreak
 */

namespace Unbreak\Check;

defined( 'ABSPATH' ) || exit;

/**
 * Plain value object passed from the HTTP checker to the classifier.
 */
final class Response {

	/**
	 * Final HTTP status code, or null when no response was received.
	 *
	 * @var int|null
	 */
	public $code = null;

	/**
	 * Transport error category: '', dns, timeout, connection, ssl, too_many_redirects, invalid_url, blocked.
	 *
	 * @var string
	 */
	public $error_type = '';

	/**
	 * Human-readable error (cURL / WP_Error text).
	 *
	 * @var string
	 */
	public $error_message = '';

	/**
	 * URL of the last request in the redirect chain.
	 *
	 * @var string
	 */
	public $final_url = '';

	/**
	 * Number of redirects followed.
	 *
	 * @var int
	 */
	public $redirect_count = 0;

	/**
	 * Lowercased response headers of the final response.
	 *
	 * @var array<string,string>
	 */
	public $headers = array();

	/**
	 * Beginning of the response body (GET requests only; capped).
	 *
	 * @var string
	 */
	public $body = '';

	/**
	 * Total time spent in milliseconds.
	 *
	 * @var int
	 */
	public $response_ms = 0;

	/**
	 * Redirect chain: each hop as [url, status code].
	 *
	 * @var array<int,array{0:string,1:int}>
	 */
	public $chain = array();

	/**
	 * HTTP method used for the final attempt.
	 *
	 * @var string
	 */
	public $method = 'HEAD';

	/**
	 * Build a response for a successful status without a network request (internal fast path).
	 *
	 * @param string $url     URL.
	 * @param string $message Note stored as the error message column.
	 */
	public static function verified( string $url, string $message ): self {
		$r                = new self();
		$r->code          = 200;
		$r->final_url     = $url;
		$r->error_message = $message;
		$r->method        = 'NONE';
		return $r;
	}

	/**
	 * Header value ('' if absent).
	 *
	 * @param string $name Header name (any case).
	 */
	public function header( string $name ): string {
		$name = strtolower( $name );
		return $this->headers[ $name ] ?? '';
	}
}