using System.Security.Cryptography;

namespace Halo.Core.Auth;

/// <summary>Eine laufende Anmeldung per Code — für den Fernseher.</summary>
///
/// <remarks>
/// <para>
/// Ein Passwort auf der Apple-TV-Fernbedienung einzutippen ist eine Zumutung,
/// die man selbst jedes Mal spürt. Stattdessen: sechsstelliger Code auf dem
/// Bildschirm, Bestätigung am Telefon.
/// </para>
/// <para>
/// <b>Der Code allein holt nie ein Token ab.</b> Dafür gibt es den Abholschein,
/// den nur das anfragende Gerät kennt und der hier nur als Fingerabdruck
/// liegt. Ohne ihn könnte jemand sechsstellige Zahlen durchprobieren — eine
/// Million Versuche sind nichts, und am Ende stünde ein fremdes Gerät in der
/// Mediathek.
/// </para>
/// </remarks>
public sealed class AuthCode
{
    /// <summary>Kurz genug zum Vorlesen, lang genug zum Nichterraten.</summary>
    public const int CodeLength = 6;

    /// <summary>So lange, wie jemand braucht, um zum Telefon zu greifen.</summary>
    public static readonly TimeSpan Lifetime = TimeSpan.FromMinutes(5);

    public Guid Id { get; init; } = Guid.CreateVersion7();
    public required string Code { get; init; }
    public required string HandleFingerprint { get; init; }
    public required string DeviceName { get; init; }
    public required string DeviceId { get; init; }
    public DateTimeOffset CreatedAt { get; init; } = DateTimeOffset.UtcNow;
    public required DateTimeOffset ExpiresAt { get; init; }

    /// <summary>Wer bestätigt hat — <c>null</c>, solange niemand.</summary>
    public Guid? ApprovedByUserId { get; set; }

    /// <summary>Wann das Token abgeholt wurde. Danach ist der Code verbraucht.</summary>
    public DateTimeOffset? ConsumedAt { get; set; }

    public bool IsExpired(DateTimeOffset now) => now >= ExpiresAt;

    /// <summary>Ob jetzt ein Token herausgegeben werden darf.</summary>
    public bool CanBeRedeemed(DateTimeOffset now) =>
        ApprovedByUserId is not null && ConsumedAt is null && !IsExpired(now);

    /// <summary>Sechs Ziffern, gleichverteilt gezogen.</summary>
    ///
    /// <remarks>
    /// <see cref="RandomNumberGenerator"/> und nicht <see cref="Random"/>: der
    /// Code ist ein Zugang. Die obere Grenze ist ausschliesslich, führende
    /// Nullen bleiben erhalten.
    /// </remarks>
    public static string NewCode() =>
        RandomNumberGenerator.GetInt32(0, 1_000_000).ToString("D" + CodeLength);
}