/**
 * Formatos de firma admitidos directamente por AutoScript.
 */
export type SignatureFormat = "PAdES" | "CAdES" | "XAdES" | "FacturaE";
/**
 * Algoritmos habituales de firma. Se permiten cadenas adicionales para no
 * bloquear algoritmos incorporados por versiones futuras de AutoScript.
 */
export type SignatureAlgorithm = "SHA256withRSA" | "SHA384withRSA" | "SHA512withRSA" | (string & {});
/**
 * Datos aceptados por el cliente.
 */
export type SignableData = string | ArrayBuffer | Uint8Array | Blob;
/**
 * Parámetros extra serializables por AutoScript.
 */
export type ExtraParameters = Readonly<Record<string, string | number | boolean | null | undefined>>;
/**
 * Opciones comunes de una operación de firma.
 */
export interface SignOptions {
    readonly data: SignableData;
    readonly algorithm?: SignatureAlgorithm;
    readonly format: SignatureFormat;
    readonly parameters?: ExtraParameters;
}
/**
 * Resultado normalizado de una firma.
 */
export interface SignResult {
    readonly signature: string;
    readonly certificate?: string;
    readonly extraData?: string;
}
/**
 * Resultado de la selección de certificado.
 */
export interface CertificateResult {
    readonly certificate: string;
}
/**
 * Configuración del cliente.
 */
export interface AutoFirmaClientOptions {
    readonly autoScript?: AutoScriptApi;
    readonly storageUrl?: string;
    readonly retrieveUrl?: string;
    readonly appName?: string;
    readonly locale?: string;
}
/**
 * Superficie mínima del objeto global oficial AutoScript.
 */
export interface AutoScriptApi {
    cargarAppAfirma?: () => void;
    setServlets?: (storageUrl: string, retrieveUrl: string) => void;
    setAppName?: (name: string) => void;
    setLocale?: (locale: string) => void;
    sign: SignatureOperation;
    createBatch?: (algorithm: string, format: string, suboperation: string, parameters: string) => void;
    addDocumentToBatch?: (id: string, data: string, format: null, suboperation: null, parameters: string | null) => void;
    setLocalBatchProcess?: (local: boolean) => void;
    signBatchProcess?: (stopOnError: boolean, preSignerUrl: null, postSignerUrl: null, certificateFilters: string, success: (result: unknown, certificate?: string) => void, failure: NativeFailureCallback) => void;
    coSign?: SignatureOperation;
    counterSign?: SignatureOperation;
    selectCertificate?: (parameters: string, success: (certificate: string) => void, failure: NativeFailureCallback) => void;
    saveDataToFile?: (data: string, title: string, filename: string, extension: string, description: string, success: () => void, failure: NativeFailureCallback) => void;
    checkTime?: (checkType: string, maxMillis?: number, checkUrl?: string) => void;
}
/**
 * Callback nativo de error de AutoScript.
 */
export type NativeFailureCallback = (errorType: string, errorMessage: string) => void;
/**
 * Operación nativa basada en callbacks.
 */
export type SignatureOperation = (data: string, algorithm: string, format: string, parameters: string, success: (signature: string, certificate?: string, extraData?: string) => void, failure: NativeFailureCallback) => void;
/**
 * Opciones para guardar datos mediante AutoFirma.
 */
export interface SaveOptions {
    readonly data: string;
    readonly title: string;
    readonly filename: string;
    readonly extension: string;
    readonly description: string;
}
/**
 * Opciones de comprobación de hora. Los valores admitidos por AutoScript son
 * `CT_NO`, `CT_RECOMMENDED` y `CT_OBLIGATORY`. Si no se indica `maxMillis`,
 * AutoScript aplica su propio valor por defecto (300000 ms, 5 minutos).
 */
export interface CheckTimeOptions {
    readonly checkType?: "CT_NO" | "CT_RECOMMENDED" | "CT_OBLIGATORY";
    readonly maxMillis?: number;
    readonly checkUrl?: string;
}
/**
 * Contrato desacoplado que facilita sustituir el cliente en pruebas.
 */
export interface SignatureClient {
    sign(options: SignOptions): Promise<SignResult>;
    signBatch(options: SignBatchOptions): Promise<SignBatchResult>;
    coSign(options: SignOptions): Promise<SignResult>;
    counterSign(options: SignOptions): Promise<SignResult>;
    selectCertificate(parameters?: ExtraParameters): Promise<CertificateResult>;
    saveDataToFile(options: SaveOptions): Promise<void>;
    checkTime(options?: CheckTimeOptions): Promise<void>;
}
/**
 * Lote local con formato y parámetros comunes a todos los documentos, salvo
 * los que cada documento traiga como propios.
 */
export interface SignBatchOptions {
    readonly documents: readonly {
        readonly id: string;
        readonly data: SignableData;
        /**
         * Parámetros propios de este documento. AutoFirma los usa **en lugar de**
         * los del lote, no encima: si un documento trae los suyos, tiene que
         * traerlos completos. Un objeto vacío hereda los del lote. Sirve para que
         * cada PDF lleve su sello en su página y su rectángulo.
         */
        readonly parameters?: ExtraParameters;
    }[];
    readonly format: SignatureFormat;
    readonly algorithm?: SignatureAlgorithm;
    readonly parameters?: ExtraParameters;
    readonly certificateFilters?: ExtraParameters;
    /** Por defecto false: conserva las firmas correctas si otra falla. */
    readonly stopOnError?: boolean;
}
/** Resultado nativo por documento; DONE_AND_SAVED no implica guardado en servidor. */
export interface BatchDocumentResult {
    readonly id: string;
    readonly result: string;
    readonly signature?: string;
    readonly description?: string;
}
export interface SignBatchResult {
    readonly signs: readonly BatchDocumentResult[];
    readonly certificate?: string;
}