<?php

declare(strict_types=1);

namespace App\Shared\Infrastructure\Captcha;

/**
 * Interface pour la validation des tokens CAPTCHA.
 */
interface TurnstileValidatorInterface
{
    /**
     * Valide un token CAPTCHA.
     *
     * @param string      $token    Le token fourni par le widget CAPTCHA
     * @param string|null $remoteIp L'IP du client (optionnel)
     */
    public function validate(string $token, ?string $remoteIp = null): TurnstileResult;
}
