<?php

declare(strict_types=1);

namespace App\Administration\Domain\Model\RefreshToken;

/**
 * Empreinte du device pour validation de l'origine du refresh token.
 *
 * Calculée comme SHA-256(User-Agent) pour identifier le device/navigateur.
 *
 * Note: L'IP n'est intentionnellement PAS incluse car les utilisateurs
 * mobiles ou VPN changent fréquemment d'IP, ce qui invaliderait leur
 * session de façon inattendue.
 */
final readonly class DeviceFingerprint
{
    private function __construct(
        public string $value,
    ) {
    }

    /**
     * Crée une empreinte à partir des informations de la requête.
     *
     * @param string $userAgent  User-Agent du navigateur
     * @param string $_ipAddress Non utilisé (conservé pour compatibilité API)
     */
    public static function fromRequest(string $userAgent, string $_ipAddress = ''): self
    {
        $fingerprint = hash('sha256', $userAgent);

        return new self($fingerprint);
    }

    /**
     * Reconstitue une empreinte depuis le stockage.
     */
    public static function fromString(string $fingerprint): self
    {
        return new self($fingerprint);
    }

    public function equals(self $other): bool
    {
        return hash_equals($this->value, $other->value);
    }

    public function __toString(): string
    {
        return $this->value;
    }
}
