<?php

declare(strict_types=1);

namespace App\Core;

/**
 * Lecture de la requête entrante pour les endpoints JSON.
 *
 * Les deux méthodes coupent l'exécution en cas de non-conformité plutôt que de
 * lever une exception : l'appelant peut donc enchaîner sans bloc try/catch.
 */
final class Request
{
    /**
     * Décode le corps JSON de la requête.
     *
     * @return array<string, mixed>
     */
    public static function json(): array
    {
        $payload = json_decode((string) file_get_contents('php://input'), true);
        if (!is_array($payload)) {
            JsonResponse::send(400, ['error' => 'Corps JSON invalide.']);
        }

        return $payload;
    }

    /**
     * Impose le verbe HTTP attendu (typiquement « POST » pour un endpoint mutant).
     */
    public static function requireMethod(string $method): void
    {
        if (strtoupper($_SERVER['REQUEST_METHOD'] ?? 'GET') !== strtoupper($method)) {
            JsonResponse::send(405, ['error' => 'Méthode non autorisée.']);
        }
    }
}