namespace DocumentService.Client.Interfaces;

/// <summary>
/// Client for Swiss QR Code extraction operations.
/// </summary>
public interface ISwissQrCodeClient
{
    /// <summary>
    /// Extracts Swiss QR Code from PDF (multipart).
    /// </summary>
    /// <param name="pdfStream">PDF file stream</param>
    /// <param name="raw">If true, returns raw QR text lines instead of parsed Bill object</param>
    /// <param name="cancellationToken">Cancellation token</param>
    /// <returns>Swiss QR Code extraction result</returns>
    Task<SwissQrCodeExtractionResult> ExtractSwissQrCodeAsync(Stream pdfStream, bool raw = false, CancellationToken cancellationToken = default);

    /// <summary>
    /// Extracts Swiss QR Code from PDF (Base64).
    /// </summary>
    /// <param name="pdfBytes">PDF file as byte array</param>
    /// <param name="raw">If true, returns raw QR text lines instead of parsed Bill object</param>
    /// <param name="cancellationToken">Cancellation token</param>
    /// <returns>Swiss QR Code extraction result</returns>
    Task<SwissQrCodeExtractionResult> ExtractSwissQrCodeAsync(byte[] pdfBytes, bool raw = false, CancellationToken cancellationToken = default);
}

/// <summary>
/// DTO for Swiss QR Code extraction result
/// </summary>
public record SwissQrCodeExtractionResult
{
    /// <summary>Parsed Swiss QR bill object. <c>null</c> when <c>raw=true</c> was requested.</summary>
    public object? Bill { get; init; }
    /// <summary>Raw QR code text lines. Populated when <c>raw=true</c> was requested.</summary>
    public List<string> RawLines { get; init; } = new();
}