<?php

declare(strict_types=1);

namespace DomainWarn\WordPress\WordPress;

// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Der Ausnahmetext ist hier Datum, keine Ausgabe: Maskiert wird dort, wo er erscheint (esc_html in der Ansicht, WP_CLI auf der Kommandozeile).

use DomainWarn\WordPress\Service\HttpTransport;
use DomainWarn\WordPress\Service\InsightPayload;
use DomainWarn\WordPress\Service\TransportException;
use DomainWarn\WordPress\Service\TransportResponse;

/**
 * Der Weg nach außen über die HTTP-API von WordPress. Sie wird genommen und nicht cURL direkt, weil Hoster und
 * Sicherheits-Plugins hier eingreifen (Proxy, erlaubte Hosts) – wer das umgeht, funktioniert auf genau den
 * Installationen nicht, die es am nötigsten hätten.
 */
final readonly class WpHttpTransport implements HttpTransport
{
    /** Zeitlimit je Aufruf. Kurz genug, dass ein Seitenaufruf nicht hängen bleibt, wenn DomainWarn nicht antwortet. */
    private const TIMEOUT = 15;

    /** @param  int  $timeout  Sekunden; kürzer, wo ein Besucher auf die Antwort wartet (security.txt) */
    public function __construct(private int $timeout = self::TIMEOUT) {}

    public function request(string $method, string $url, array $headers = [], ?array $json = null): TransportResponse
    {
        $args = [
            'method' => $method,
            'timeout' => $this->timeout,
            'redirection' => 0,
            'headers' => $headers,
            'user-agent' => 'DomainWarn WordPress '.InsightPayload::AGENT_VERSION,
        ];
        if ($json !== null) {
            $args['headers']['Content-Type'] = 'application/json';
            $args['body'] = (string) wp_json_encode($json);
        }

        $response = wp_remote_request($url, $args);
        if (is_wp_error($response)) {
            throw new TransportException($response->get_error_message());
        }

        $headers = [];
        foreach (wp_remote_retrieve_headers($response) as $name => $value) {
            // mehrfach gesetzte Kopfzeilen kommen als Liste; gebraucht wird hier nur die erste (Location, Content-Type)
            $headers[strtolower((string) $name)] = is_array($value) ? (string) reset($value) : (string) $value;
        }

        return new TransportResponse(
            (int) wp_remote_retrieve_response_code($response),
            (string) wp_remote_retrieve_body($response),
            $headers,
        );
    }
}