@dynamicore/jumio-sdk 1.0.0

package/dist/client-BR1xIZ0X.d.ts

@@ -0,0 +1,252 @@
+import { AxiosInstance } from 'axios';
+
+/**
+ * Estados posibles del flujo de verificación en Jumio.
+ */
+type JumioWorkflowStatus = "PENDING" | "INITIATED" | "ACQUIRED" | "SUBMITTED" | "PROCESSED" | "APPROVED_VERIFIED" | "REJECTED" | "FAILED" | "ERROR" | "DENIED" | "EXPIRED" | "ABANDONED" | (string & {});
+/**
+ * Tipos de entrada soportados para las imágenes del documento.
+ */
+type ImageSource = string | Blob | File | ArrayBuffer | Uint8Array | {
+    url?: unknown;
+} | {
+    [key: string]: unknown;
+};
+/**
+ * Función personalizada para firmar URLs de S3 o descargar recursos privados.
+ */
+type S3SignerFunction = (pathOrUrl: string, expires?: number) => Promise<string | {
+    url?: unknown;
+} | unknown>;
+/**
+ * Función o valor para proveer el token de autenticación.
+ */
+type AuthTokenProvider = string | (() => string | undefined | null | Promise<string | undefined | null>);
+/**
+ * Opciones de configuración para instanciar el cliente JumioClient.
+ */
+interface JumioClientConfig {
+    /**
+     * URL base de la API de DynamiCore / Backend.
+     * @default "https://front.dynamicore.io"
+     */
+    baseUrl?: string;
+    /**
+     * Endpoint específico del servicio de verificación Jumio.
+     * @default "/marketplace/apps/jumio"
+     */
+    endpoint?: string;
+    /**
+     * Header de contexto moral / negocio enviado en las peticiones.
+     */
+    context?: string;
+    /**
+     * Token de autenticación o función que lo obtiene.
+     */
+    authToken?: AuthTokenProvider;
+    /**
+     * Prefijo para el header Authorization (por defecto vacío o "Bearer ").
+     * @default ""
+     */
+    authTokenPrefix?: string;
+    /**
+     * Timeout en milisegundos para las peticiones POST de verificación.
+     * @default 180000 (3 minutos)
+     */
+    requestTimeout?: number;
+    /**
+     * Timeout en milisegundos para las peticiones GET de status.
+     * @default 120000 (2 minutos)
+     */
+    statusTimeout?: number;
+    /**
+     * Número máximo de reintentos ante timeouts o fallas transitorias de red.
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * Delay base en milisegundos para el backoff exponencial de reintentos.
+     * @default 800
+     */
+    retryDelayMs?: number;
+    /**
+     * Intervalo en milisegundos entre consultas sucesivas de sondeo (polling).
+     * @default 10000 (10 segundos)
+     */
+    pollingIntervalMs?: number;
+    /**
+     * Número máximo de intentos de sondeo antes de timeout.
+     * @default 20 (20 x 10s = aprox 200 segundos)
+     */
+    maxPollingAttempts?: number;
+    /**
+     * Función opcional para firmar rutas u URLs de Amazon S3.
+     */
+    s3Signer?: S3SignerFunction;
+    /**
+     * Headers HTTP adicionales para incluir en cada petición.
+     */
+    customHeaders?: Record<string, string>;
+    /**
+     * Instancia personalizada de Axios (opcional).
+     */
+    axiosInstance?: AxiosInstance;
+}
+/**
+ * Payload enviado a la API de verificación de Jumio.
+ */
+interface JumioVerificationPayload {
+    client: string;
+    front_image_b64: string;
+    back_image_b64: string;
+    [key: string]: unknown;
+}
+/**
+ * Estructura de respuesta de datos de verificación.
+ */
+interface JumioVerificationData {
+    valid?: boolean;
+    status?: JumioWorkflowStatus;
+    workflowStatus?: JumioWorkflowStatus;
+    decision?: string;
+    accountId?: string;
+    workflowId?: string;
+    message?: string;
+    [key: string]: unknown;
+}
+/**
+ * Estructura inicial devuelta al iniciar el flujo de verificación.
+ */
+interface JumioIneStartData extends JumioVerificationData {
+    accountId?: string;
+    workflowId?: string;
+}
+/**
+ * Resultado estructurado retornado por el cliente tras una validación.
+ */
+interface VerifyIneResult {
+    /**
+     * Indica si la validación fue exitosa (true) o fallida/rechazada (false).
+     */
+    valid: boolean;
+    /**
+     * Estado actual o final del flujo de Jumio.
+     */
+    status?: JumioWorkflowStatus;
+    /**
+     * Identificador de cuenta en Jumio.
+     */
+    accountId?: string;
+    /**
+     * Identificador del workflow en Jumio.
+     */
+    workflowId?: string;
+    /**
+     * Datos completos devueltos por la API de Jumio/DynamiCore.
+     */
+    data: unknown;
+    /**
+     * Mensaje descriptivo o de error si la validación falló.
+     */
+    errorMessage?: string;
+}
+/**
+ * Callback ejecutado cuando el sondeo resuelve un estado final.
+ */
+type JumioStatusResolvedCallback = (result: VerifyIneResult) => void;
+/**
+ * Callback ejecutado si ocurre un error durante el sondeo o la petición.
+ */
+type JumioStatusErrorCallback = (error: Error) => void;
+/**
+ * Callback de progreso para reportar avances de conversión o polling.
+ */
+type JumioProgressCallback = (stage: string, percent?: number) => void;
+/**
+ * Parámetros de entrada para la función `verifyIne`.
+ */
+interface VerifyIneInput {
+    /**
+     * Identificador único del cliente (persona, usuario o ID externo).
+     */
+    clientId: string;
+    /**
+     * Imagen frontal del documento (INE): URL, ruta S3, File, Blob o Base64.
+     */
+    frontImage: ImageSource;
+    /**
+     * Imagen trasera/reverso del documento (INE): URL, ruta S3, File, Blob o Base64.
+     */
+    backImage: ImageSource;
+    /**
+     * Si es `true`, la promesa espera hasta que Jumio resuelva el resultado final (bloqueante).
+     * Si es `false` (por defecto), inicia la validación, retorna de inmediato y ejecuta el sondeo en 2do plano.
+     * @default false
+     */
+    awaitFinalStatus?: boolean;
+    /**
+     * Callback invocado cuando se completa el proceso de validación (síncrono o en segundo plano).
+     */
+    onStatusResolved?: JumioStatusResolvedCallback;
+    /**
+     * Callback invocado ante errores no recuperables durante la validación o sondeo.
+     */
+    onStatusError?: JumioStatusErrorCallback;
+    /**
+     * Callback opcional para reportar etapas del proceso.
+     */
+    onProgress?: JumioProgressCallback;
+    /**
+     * Señal de cancelación (AbortSignal) para abortar peticiones o sondeo activo.
+     */
+    signal?: AbortSignal;
+}
+/**
+ * Opciones para el método de polling de estado.
+ */
+interface PollStatusOptions {
+    pollingIntervalMs?: number;
+    maxAttempts?: number;
+    signal?: AbortSignal;
+    onAttempt?: (attempt: number, maxAttempts: number, lastData: unknown) => void;
+}
+
+/**
+ * Cliente principal para gestionar validaciones de identidad mediante Jumio.
+ */
+declare class JumioClient {
+    private readonly http;
+    private readonly config;
+    constructor(config?: JumioClientConfig);
+    /**
+     * Inicia el proceso de verificación convirtiendo las imágenes y enviando el payload inicial a Jumio.
+     */
+    startIneVerification(params: {
+        clientId: string;
+        frontImage: ImageSource;
+        backImage: ImageSource;
+        signal?: AbortSignal;
+        onProgress?: JumioProgressCallback;
+    }): Promise<JumioIneStartData>;
+    /**
+     * Consulta una única vez el estado actual de la validación.
+     */
+    getIneStatus(accountId: string, workflowId: string, signal?: AbortSignal): Promise<JumioVerificationData>;
+    /**
+     * Sondea periódicamente el estado hasta obtener un resultado definitivo.
+     */
+    pollIneStatus(accountId: string, workflowId: string, options?: PollStatusOptions): Promise<VerifyIneResult>;
+    /**
+     * Ejecuta el flujo completo de validación de INE.
+     *
+     * @param input Parámetros de validación y callbacks.
+     * @returns `VerifyIneResult` con el resultado inicial o definitivo según `awaitFinalStatus`.
+     */
+    verifyIne(input: VerifyIneInput): Promise<VerifyIneResult>;
+}
+/**
+ * Fábrica para crear una nueva instancia de `JumioClient`.
+ */
+declare function createJumioClient(config?: JumioClientConfig): JumioClient;
+
+export { type AuthTokenProvider as A, type ImageSource as I, JumioClient as J, type PollStatusOptions as P, type S3SignerFunction as S, type VerifyIneInput as V, type JumioClientConfig as a, type JumioIneStartData as b, type JumioProgressCallback as c, type JumioStatusErrorCallback as d, type JumioStatusResolvedCallback as e, type JumioVerificationData as f, type JumioVerificationPayload as g, type JumioWorkflowStatus as h, type VerifyIneResult as i, createJumioClient as j };

package/dist/core/index.d.mts

@@ -0,0 +1,204 @@
+import { f as JumioVerificationData, I as ImageSource, S as S3SignerFunction, a as JumioClientConfig, P as PollStatusOptions, i as VerifyIneResult } from '../client-BR1xIZ0X.mjs';
+export { A as AuthTokenProvider, J as JumioClient, b as JumioIneStartData, c as JumioProgressCallback, d as JumioStatusErrorCallback, e as JumioStatusResolvedCallback, g as JumioVerificationPayload, h as JumioWorkflowStatus, V as VerifyIneInput, j as createJumioClient } from '../client-BR1xIZ0X.mjs';
+import 'axios';
+
+/**
+ * Error base para todas las excepciones emitidas por el SDK de Jumio.
+ */
+declare class JumioError extends Error {
+    readonly isJumioError = true;
+    readonly statusCode?: number;
+    readonly rawData?: unknown;
+    readonly code?: string;
+    constructor(message: string, options?: {
+        statusCode?: number;
+        rawData?: unknown;
+        code?: string;
+        cause?: unknown;
+    });
+}
+/**
+ * Error lanzado ante demoras excesivas o timeouts del servicio de verificación.
+ */
+declare class JumioTimeoutError extends JumioError {
+    constructor(message?: string, rawData?: unknown);
+}
+/**
+ * Error lanzado cuando no hay conectividad de red o falla el transporte HTTP.
+ */
+declare class JumioNetworkError extends JumioError {
+    constructor(message?: string, cause?: unknown);
+}
+/**
+ * Error lanzado cuando la validación del documento es rechazada o no pasa los criterios.
+ */
+declare class JumioValidationError extends JumioError {
+    constructor(message?: string, rawData?: unknown);
+}
+/**
+ * Error lanzado cuando ocurre un fallo al obtener, descargar o procesar una imagen (frente o reverso).
+ */
+declare class JumioImageProcessingError extends JumioError {
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Error lanzado cuando el sondeo (polling) agota los intentos máximos sin un estado definitivo.
+ */
+declare class JumioPollingTimeoutError extends JumioError {
+    readonly attempts: number;
+    constructor(attempts: number, message?: string, rawData?: unknown);
+}
+/**
+ * Error lanzado cuando la operación es cancelada explícitamente mediante un AbortSignal.
+ */
+declare class JumioAbortError extends JumioError {
+    constructor(message?: string);
+}
+/**
+ * Verifica si un error dado es una instancia de JumioError.
+ */
+declare function isJumioError(error: unknown): error is JumioError;
+
+/**
+ * Lista de estados considerados finales en el flujo de Jumio.
+ */
+declare const FINAL_JUMIO_STATUSES: readonly ["PROCESSED", "APPROVED_VERIFIED", "REJECTED", "FAILED", "ERROR", "DENIED", "EXPIRED", "ABANDONED", "DONE", "COMPLETED", "NOT_READABLE", "FRAUD", "UNSUPPORTED_ID_TYPE"];
+/**
+ * Lista de estados considerados exitosos (aprobados) de forma inequívoca.
+ *
+ * Nota: `PROCESSED` no se considera aprobado por sí solo: en la gateway
+ * DynamiCore/Jumio significa únicamente que el workflow terminó de procesar.
+ * El veredicto real se reporta en los campos `valid` y `decision`
+ * (p. ej. `decision: "NOT_EXECUTED"` con `workflowStatus: "PROCESSED"` es un rechazo).
+ */
+declare const APPROVED_JUMIO_STATUSES: readonly ["APPROVED_VERIFIED", "DONE", "COMPLETED"];
+/**
+ * Convierte un valor a texto en minúsculas sin espacios extremos.
+ */
+declare function toLowerText(value: unknown): string;
+/**
+ * Convierte un valor a texto en mayúsculas sin espacios extremos.
+ */
+declare function toUpperText(value: unknown): string;
+/**
+ * Desempaqueta el envoltorio estándar `{ data: ... }` si está presente en la respuesta.
+ */
+declare function extractEnvelopeData<T>(responseData: unknown): T;
+/**
+ * Desempaqueta recursivamente múltiples niveles de anidación `{ data: { data: ... } }`.
+ */
+declare function extractNestedData(source: unknown, maxDepth?: number): unknown;
+/**
+ * Extrae de forma inteligente el mensaje de error o descripción contenido en una respuesta de Jumio o Axios.
+ */
+declare function extractJumioMessage(source: unknown): string;
+/**
+ * Determina si el estado de workflow reportado por Jumio es definitivo (ha terminado su procesamiento).
+ */
+declare function isFinalJumioStatus(status: unknown): boolean;
+/**
+ * Determina si el estado reportado indica una verificación aprobada y válida.
+ */
+declare function isApprovedJumioStatus(status: unknown): boolean;
+/**
+ * Determina si la decisión final de Jumio indica un documento aprobado.
+ * La decisión es el veredicto real reportado por la gateway
+ * (p. ej. `PASSED` = aprobado, `NOT_EXECUTED` / `REJECTED` / `FAILED` = rechazado).
+ */
+declare function isPassedJumioDecision(decision: unknown): boolean;
+/**
+ * Resuelve la validez final de una verificación priorizando los campos
+ * explícitos (`valid`, `decision`) sobre el estado del workflow:
+ *
+ * 1. `valid` booleano explícito (fuente de verdad de la gateway).
+ * 2. `decision` presente (`PASSED` = válido, cualquier otro valor = inválido).
+ * 3. Fallback conservador basado en el estado del workflow.
+ */
+declare function resolveVerificationValidity(data: Pick<JumioVerificationData, "valid" | "decision">, fallbackStatus: unknown): boolean;
+
+interface RetryOptions {
+    maxRetries?: number;
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+    factor?: number;
+    shouldRetry?: (error: unknown) => boolean;
+    signal?: AbortSignal;
+    onRetry?: (attempt: number, error: unknown, delayMs: number) => void;
+}
+/**
+ * Espera una cantidad dada de milisegundos con soporte para cancelación vía AbortSignal.
+ */
+declare function delay(ms: number, signal?: AbortSignal): Promise<void>;
+/**
+ * Evalúa si un mensaje o error es atribuible a fallos transitorios o timeouts de Jumio que ameritan reintento.
+ */
+declare function shouldRetryJumio(errorOrMessage: unknown): boolean;
+/**
+ * Ejecuta una operación asíncrona con reintentos automáticos y backoff exponencial.
+ */
+declare function withRetry<T>(operation: (attempt: number) => Promise<T>, options?: RetryOptions): Promise<T>;
+
+/**
+ * Elimina el prefijo data URI (ej. "data:image/jpeg;base64,") si existe.
+ */
+declare function stripDataUrlPrefix(dataUrl: string): string;
+/**
+ * Verifica si una cadena parece ser Base64 directo o Data URL.
+ */
+declare function isBase64String(input: string): boolean;
+/**
+ * Extrae la URL utilizable a partir de un objeto candidato devuelto por endpoints de S3 u objetos de formulario.
+ */
+declare function normalizeSignedUrl(input: unknown, fallback?: string): string;
+/**
+ * Convierte un Blob o File en una cadena Base64 pura.
+ */
+declare function blobToBase64(blob: Blob): Promise<string>;
+/**
+ * Convierte un ArrayBuffer o Uint8Array a cadena Base64 pura.
+ */
+declare function arrayBufferToBase64(buffer: ArrayBuffer | Uint8Array): string;
+/**
+ * Descarga una imagen desde una URL HTTP/HTTPS/Blob y la retorna como Base64 puro.
+ */
+declare function fetchUrlAsBase64(url: string, signal?: AbortSignal): Promise<string>;
+/**
+ * Resuelve cualquier tipo de entrada de imagen (URL, ruta S3, File, Blob, Base64) a una cadena Base64 pura.
+ */
+declare function resolveImageSourceToBase64(source: ImageSource, s3Signer?: S3SignerFunction, signal?: AbortSignal): Promise<string>;
+
+declare class JumioHttpClient {
+    private readonly client;
+    private readonly config;
+    constructor(config?: JumioClientConfig);
+    /**
+     * Resuelve los headers dinámicos (token de auth y context).
+     */
+    private resolveHeaders;
+    /**
+     * Normaliza cualquier error de Axios a una excepción tipada JumioError.
+     */
+    private normalizeError;
+    /**
+     * Ejecuta una petición POST al endpoint de Jumio para iniciar o procesar la verificación.
+     */
+    postVerification<T>(payload: unknown, options?: {
+        signal?: AbortSignal;
+        timeout?: number;
+    }): Promise<T>;
+    /**
+     * Ejecuta una petición GET para consultar el estado actual de una verificación de INE.
+     */
+    getVerificationStatus<T>(accountId: string, workflowId: string, options?: {
+        signal?: AbortSignal;
+        timeout?: number;
+    }): Promise<T>;
+    getConfig(): Readonly<JumioClientConfig>;
+}
+
+/**
+ * Sondea activamente el estado de verificación de un workflow de Jumio hasta alcanzar un estado definitivo.
+ */
+declare function pollJumioStatus(http: JumioHttpClient, accountId: string, workflowId: string, options?: PollStatusOptions): Promise<VerifyIneResult>;
+
+export { APPROVED_JUMIO_STATUSES, FINAL_JUMIO_STATUSES, ImageSource, JumioAbortError, JumioClientConfig, JumioError, JumioHttpClient, JumioImageProcessingError, JumioNetworkError, JumioPollingTimeoutError, JumioTimeoutError, JumioValidationError, JumioVerificationData, PollStatusOptions, type RetryOptions, S3SignerFunction, VerifyIneResult, arrayBufferToBase64, blobToBase64, delay, extractEnvelopeData, extractJumioMessage, extractNestedData, fetchUrlAsBase64, isApprovedJumioStatus, isBase64String, isFinalJumioStatus, isJumioError, isPassedJumioDecision, normalizeSignedUrl, pollJumioStatus, resolveImageSourceToBase64, resolveVerificationValidity, shouldRetryJumio, stripDataUrlPrefix, toLowerText, toUpperText, withRetry };

package/dist/core/index.d.ts

@@ -0,0 +1,204 @@
+import { f as JumioVerificationData, I as ImageSource, S as S3SignerFunction, a as JumioClientConfig, P as PollStatusOptions, i as VerifyIneResult } from '../client-BR1xIZ0X.js';
+export { A as AuthTokenProvider, J as JumioClient, b as JumioIneStartData, c as JumioProgressCallback, d as JumioStatusErrorCallback, e as JumioStatusResolvedCallback, g as JumioVerificationPayload, h as JumioWorkflowStatus, V as VerifyIneInput, j as createJumioClient } from '../client-BR1xIZ0X.js';
+import 'axios';
+
+/**
+ * Error base para todas las excepciones emitidas por el SDK de Jumio.
+ */
+declare class JumioError extends Error {
+    readonly isJumioError = true;
+    readonly statusCode?: number;
+    readonly rawData?: unknown;
+    readonly code?: string;
+    constructor(message: string, options?: {
+        statusCode?: number;
+        rawData?: unknown;
+        code?: string;
+        cause?: unknown;
+    });
+}
+/**
+ * Error lanzado ante demoras excesivas o timeouts del servicio de verificación.
+ */
+declare class JumioTimeoutError extends JumioError {
+    constructor(message?: string, rawData?: unknown);
+}
+/**
+ * Error lanzado cuando no hay conectividad de red o falla el transporte HTTP.
+ */
+declare class JumioNetworkError extends JumioError {
+    constructor(message?: string, cause?: unknown);
+}
+/**
+ * Error lanzado cuando la validación del documento es rechazada o no pasa los criterios.
+ */
+declare class JumioValidationError extends JumioError {
+    constructor(message?: string, rawData?: unknown);
+}
+/**
+ * Error lanzado cuando ocurre un fallo al obtener, descargar o procesar una imagen (frente o reverso).
+ */
+declare class JumioImageProcessingError extends JumioError {
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Error lanzado cuando el sondeo (polling) agota los intentos máximos sin un estado definitivo.
+ */
+declare class JumioPollingTimeoutError extends JumioError {
+    readonly attempts: number;
+    constructor(attempts: number, message?: string, rawData?: unknown);
+}
+/**
+ * Error lanzado cuando la operación es cancelada explícitamente mediante un AbortSignal.
+ */
+declare class JumioAbortError extends JumioError {
+    constructor(message?: string);
+}
+/**
+ * Verifica si un error dado es una instancia de JumioError.
+ */
+declare function isJumioError(error: unknown): error is JumioError;
+
+/**
+ * Lista de estados considerados finales en el flujo de Jumio.
+ */
+declare const FINAL_JUMIO_STATUSES: readonly ["PROCESSED", "APPROVED_VERIFIED", "REJECTED", "FAILED", "ERROR", "DENIED", "EXPIRED", "ABANDONED", "DONE", "COMPLETED", "NOT_READABLE", "FRAUD", "UNSUPPORTED_ID_TYPE"];
+/**
+ * Lista de estados considerados exitosos (aprobados) de forma inequívoca.
+ *
+ * Nota: `PROCESSED` no se considera aprobado por sí solo: en la gateway
+ * DynamiCore/Jumio significa únicamente que el workflow terminó de procesar.
+ * El veredicto real se reporta en los campos `valid` y `decision`
+ * (p. ej. `decision: "NOT_EXECUTED"` con `workflowStatus: "PROCESSED"` es un rechazo).
+ */
+declare const APPROVED_JUMIO_STATUSES: readonly ["APPROVED_VERIFIED", "DONE", "COMPLETED"];
+/**
+ * Convierte un valor a texto en minúsculas sin espacios extremos.
+ */
+declare function toLowerText(value: unknown): string;
+/**
+ * Convierte un valor a texto en mayúsculas sin espacios extremos.
+ */
+declare function toUpperText(value: unknown): string;
+/**
+ * Desempaqueta el envoltorio estándar `{ data: ... }` si está presente en la respuesta.
+ */
+declare function extractEnvelopeData<T>(responseData: unknown): T;
+/**
+ * Desempaqueta recursivamente múltiples niveles de anidación `{ data: { data: ... } }`.
+ */
+declare function extractNestedData(source: unknown, maxDepth?: number): unknown;
+/**
+ * Extrae de forma inteligente el mensaje de error o descripción contenido en una respuesta de Jumio o Axios.
+ */
+declare function extractJumioMessage(source: unknown): string;
+/**
+ * Determina si el estado de workflow reportado por Jumio es definitivo (ha terminado su procesamiento).
+ */
+declare function isFinalJumioStatus(status: unknown): boolean;
+/**
+ * Determina si el estado reportado indica una verificación aprobada y válida.
+ */
+declare function isApprovedJumioStatus(status: unknown): boolean;
+/**
+ * Determina si la decisión final de Jumio indica un documento aprobado.
+ * La decisión es el veredicto real reportado por la gateway
+ * (p. ej. `PASSED` = aprobado, `NOT_EXECUTED` / `REJECTED` / `FAILED` = rechazado).
+ */
+declare function isPassedJumioDecision(decision: unknown): boolean;
+/**
+ * Resuelve la validez final de una verificación priorizando los campos
+ * explícitos (`valid`, `decision`) sobre el estado del workflow:
+ *
+ * 1. `valid` booleano explícito (fuente de verdad de la gateway).
+ * 2. `decision` presente (`PASSED` = válido, cualquier otro valor = inválido).
+ * 3. Fallback conservador basado en el estado del workflow.
+ */
+declare function resolveVerificationValidity(data: Pick<JumioVerificationData, "valid" | "decision">, fallbackStatus: unknown): boolean;
+
+interface RetryOptions {
+    maxRetries?: number;
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+    factor?: number;
+    shouldRetry?: (error: unknown) => boolean;
+    signal?: AbortSignal;
+    onRetry?: (attempt: number, error: unknown, delayMs: number) => void;
+}
+/**
+ * Espera una cantidad dada de milisegundos con soporte para cancelación vía AbortSignal.
+ */
+declare function delay(ms: number, signal?: AbortSignal): Promise<void>;
+/**
+ * Evalúa si un mensaje o error es atribuible a fallos transitorios o timeouts de Jumio que ameritan reintento.
+ */
+declare function shouldRetryJumio(errorOrMessage: unknown): boolean;
+/**
+ * Ejecuta una operación asíncrona con reintentos automáticos y backoff exponencial.
+ */
+declare function withRetry<T>(operation: (attempt: number) => Promise<T>, options?: RetryOptions): Promise<T>;
+
+/**
+ * Elimina el prefijo data URI (ej. "data:image/jpeg;base64,") si existe.
+ */
+declare function stripDataUrlPrefix(dataUrl: string): string;
+/**
+ * Verifica si una cadena parece ser Base64 directo o Data URL.
+ */
+declare function isBase64String(input: string): boolean;
+/**
+ * Extrae la URL utilizable a partir de un objeto candidato devuelto por endpoints de S3 u objetos de formulario.
+ */
+declare function normalizeSignedUrl(input: unknown, fallback?: string): string;
+/**
+ * Convierte un Blob o File en una cadena Base64 pura.
+ */
+declare function blobToBase64(blob: Blob): Promise<string>;
+/**
+ * Convierte un ArrayBuffer o Uint8Array a cadena Base64 pura.
+ */
+declare function arrayBufferToBase64(buffer: ArrayBuffer | Uint8Array): string;
+/**
+ * Descarga una imagen desde una URL HTTP/HTTPS/Blob y la retorna como Base64 puro.
+ */
+declare function fetchUrlAsBase64(url: string, signal?: AbortSignal): Promise<string>;
+/**
+ * Resuelve cualquier tipo de entrada de imagen (URL, ruta S3, File, Blob, Base64) a una cadena Base64 pura.
+ */
+declare function resolveImageSourceToBase64(source: ImageSource, s3Signer?: S3SignerFunction, signal?: AbortSignal): Promise<string>;
+
+declare class JumioHttpClient {
+    private readonly client;
+    private readonly config;
+    constructor(config?: JumioClientConfig);
+    /**
+     * Resuelve los headers dinámicos (token de auth y context).
+     */
+    private resolveHeaders;
+    /**
+     * Normaliza cualquier error de Axios a una excepción tipada JumioError.
+     */
+    private normalizeError;
+    /**
+     * Ejecuta una petición POST al endpoint de Jumio para iniciar o procesar la verificación.
+     */
+    postVerification<T>(payload: unknown, options?: {
+        signal?: AbortSignal;
+        timeout?: number;
+    }): Promise<T>;
+    /**
+     * Ejecuta una petición GET para consultar el estado actual de una verificación de INE.
+     */
+    getVerificationStatus<T>(accountId: string, workflowId: string, options?: {
+        signal?: AbortSignal;
+        timeout?: number;
+    }): Promise<T>;
+    getConfig(): Readonly<JumioClientConfig>;
+}
+
+/**
+ * Sondea activamente el estado de verificación de un workflow de Jumio hasta alcanzar un estado definitivo.
+ */
+declare function pollJumioStatus(http: JumioHttpClient, accountId: string, workflowId: string, options?: PollStatusOptions): Promise<VerifyIneResult>;
+
+export { APPROVED_JUMIO_STATUSES, FINAL_JUMIO_STATUSES, ImageSource, JumioAbortError, JumioClientConfig, JumioError, JumioHttpClient, JumioImageProcessingError, JumioNetworkError, JumioPollingTimeoutError, JumioTimeoutError, JumioValidationError, JumioVerificationData, PollStatusOptions, type RetryOptions, S3SignerFunction, VerifyIneResult, arrayBufferToBase64, blobToBase64, delay, extractEnvelopeData, extractJumioMessage, extractNestedData, fetchUrlAsBase64, isApprovedJumioStatus, isBase64String, isFinalJumioStatus, isJumioError, isPassedJumioDecision, normalizeSignedUrl, pollJumioStatus, resolveImageSourceToBase64, resolveVerificationValidity, shouldRetryJumio, stripDataUrlPrefix, toLowerText, toUpperText, withRetry };