using DocumentOperator.Domain.Models.ValueObjects;

namespace DocumentOperator.Application.Common.Interfaces;

public interface IPdfProcessor
{
    /// <summary>
    /// Validates a PDF and extracts metadata.
    /// </summary>
    /// <param name="pdfBytes">PDF content as byte array</param>
    /// <returns>PDF metadata (page count, size, version, attachments)</returns>
    /// <exception cref="Domain.Common.Exceptions.PdfProcessingException">
    /// Thrown when PDF is corrupted or cannot be processed
    /// </exception>
    Task<PdfMetadata> ValidateAsync(byte[] pdfBytes);

    /// <summary>
    /// Validates a PDF/A document and checks conformance level.
    /// </summary>
    /// <param name="pdfBytes">PDF content as byte array</param>
    /// <returns>PDF/A metadata including conformance level and validation errors/warnings</returns>
    /// <exception cref="Domain.Common.Exceptions.PdfProcessingException">
    /// Thrown when PDF is corrupted or cannot be processed
    /// </exception>
    Task<PdfAMetadata> ValidatePdfAAsync(byte[] pdfBytes);
}