using EnvelopeGenerator.ReceiverUI.Client.Models;
using EnvelopeGenerator.ReceiverUI.Client.Services.Base;

namespace EnvelopeGenerator.ReceiverUI.Client.Services;

/// <summary>
/// Kommuniziert mit dem ReceiverAuthController der API.
/// 
/// Drei Methoden — eine pro Endpunkt:
/// 1. GetStatusAsync    → GET  /api/receiverauth/{key}/status
/// 2. SubmitAccessCodeAsync → POST /api/receiverauth/{key}/access-code
/// 3. SubmitTfaCodeAsync    → POST /api/receiverauth/{key}/tfa
/// </summary>
public interface IReceiverAuthService
{
    /// <summary>Prüft den aktuellen Status des Empfänger-Flows</summary>
    Task<ApiResponse<ReceiverAuthModel>> GetStatusAsync(string key, CancellationToken ct = default);

    /// <summary>Sendet den Zugangscode zur Prüfung</summary>
    Task<ApiResponse<ReceiverAuthModel>> SubmitAccessCodeAsync(
        string key, string accessCode, bool preferSms, CancellationToken ct = default);

    /// <summary>Sendet den TFA-Code (SMS oder Authenticator) zur Prüfung</summary>
    Task<ApiResponse<ReceiverAuthModel>> SubmitTfaCodeAsync(
        string key, string code, string type, CancellationToken ct = default);
}