using SchotzIadKmTracker.Api.Models.Entities;

namespace SchotzIadKmTracker.Api.Services;

/// <summary>
/// Service d'émission des jetons JWT d'authentification.
/// </summary>
public interface IJwtService
{
    /// <summary>
    /// Émet un Jeton_JWT signé en HS256 pour le compte fourni.
    /// </summary>
    /// <remarks>
    /// Le jeton porte les claims <c>sub</c> (identifiant du compte), <c>email</c> et un
    /// identifiant unique <c>jti</c>. Sa date d'expiration vaut l'instant courant plus
    /// <c>JwtOptions.ExpirationMinutes</c> (720 minutes / 12 h par défaut). Aucune donnée
    /// sensible n'est incluse (jamais le hachage du mot de passe).
    /// Exigences 2.1 (émission du jeton à la connexion), 2.4 (date d'expiration associée),
    /// 5.4 (expiration à 12 h par défaut).
    /// </remarks>
    /// <param name="compte">Le compte pour lequel émettre le jeton.</param>
    /// <returns>Le Jeton_JWT sérialisé (chaîne compacte).</returns>
    string GenererJeton(Compte compte);
}