using DocumentService.Client.Models.Requests;

namespace DocumentService.Client.Interfaces;

/// <summary>
/// Client for PDF digital signing.
/// </summary>
public interface IPdfSignatureClient
{
    /// <summary>
    /// Digitally signs a PDF (Base64 JSON).
    /// </summary>
    /// <param name="pdfBytes">PDF to sign</param>
    /// <param name="options">Signing options (metadata + appearance)</param>
    /// <param name="signatureImageBytes">Optional signature image (PNG/JPEG)</param>
    /// <param name="cancellationToken">Cancellation token</param>
    /// <returns>Signed PDF as stream</returns>
    Task<Stream> SignAsync(byte[] pdfBytes, SignPdfOptions options, byte[]? signatureImageBytes = null, CancellationToken cancellationToken = default);
}