<?php
/**
 * Minimal HTTP client the OpenAI provider needs.
 *
 * @package Fitzaro
 */

namespace Fitzaro\Provider\OpenAi;

defined( 'ABSPATH' ) || exit;

/**
 * WordPress uses wp_remote_request() (WpHttp); tests use a fake.
 */
interface Http {

	/**
	 * Sends a request. Null when the server could not be reached (DNS, TLS, timeout).
	 *
	 * @param string                $method  HTTP method.
	 * @param string                $url     URL.
	 * @param array<string, string> $headers Headers.
	 * @param string|null           $body    Body.
	 * @param int                   $timeout Seconds.
	 * @return array{status: int, body: string}|null
	 */
	public function request( string $method, string $url, array $headers, ?string $body, int $timeout ): ?array;
}