@dwast/verifactu-lib 0.1.0-beta.0 → 0.1.0-beta.2

package/dist/esm/aeat/client.js

@@ -0,0 +1,259 @@
+import https from 'node:https';
+import { buildRemisionEnvelope, AEAT_INFORMACION_NAMESPACE } from '../core/xml/generator.js';
+import { parseSoapResponse } from './response.js';
+/**
+ * URL base del servicio AEAT en PRODUCCIÓN (Verifactu v1.0).
+ * Fuente: Veri-Factu_Descripcion_SWeb.pdf (Anexo I, entorno de producción).
+ */
+export const AEAT_PRODUCTION_BASE_URL = 'https://www2.agenciatributaria.gob.es';
+/**
+ * URL base del servicio AEAT en PRUEBAS/desarrollo (Verifactu v1.0).
+ * Fuente: Veri-Factu_Descripcion_SWeb.pdf (Anexo I, entorno de pruebas).
+ */
+export const AEAT_TEST_BASE_URL = 'https://prewww2.aeat.es';
+/**
+ * Ruta del WSDL del servicio SistemaFacturacion (Verifactu v1.0).
+ */
+export const AEAT_WSDL_PATH = '/static_files/common/internet/dep/aplicaciones/es/aeat/tikeV1.0/cont/ws/SistemaFacturacion.wsdl';
+/**
+ * Endpoint SOAP de remisión voluntaria (VerifactuSOAP).
+ * - Producción: `https://www1.agenciatributaria.gob.es/wlpl/TIKE-CONT/ws/SistemaFacturacion/VerifactuSOAP`
+ * - Pruebas:    `https://prewww1.aeat.es/wlpl/TIKE-CONT/ws/SistemaFacturacion/VerifactuSOAP`
+ */
+export const AEAT_PRODUCTION_SOAP_URL = 'https://www1.agenciatributaria.gob.es/wlpl/TIKE-CONT/ws/SistemaFacturacion/VerifactuSOAP';
+export const AEAT_TEST_SOAP_URL = 'https://prewww1.aeat.es/wlpl/TIKE-CONT/ws/SistemaFacturacion/VerifactuSOAP';
+/**
+ * Endpoint SOAP de remisión bajo requerimiento (RequerimientoSOAP).
+ */
+export const AEAT_PRODUCTION_REQUERIMIENTO_URL = 'https://www1.agenciatributaria.gob.es/wlpl/TIKE-CONT/ws/SistemaFacturacion/RequerimientoSOAP';
+export const AEAT_TEST_REQUERIMIENTO_URL = 'https://prewww1.aeat.es/wlpl/TIKE-CONT/ws/SistemaFacturacion/RequerimientoSOAP';
+/**
+ * Operación SOAP de alta/anulación de registros.
+ */
+export const AEAT_OPERATION_REGISTRO = 'RegFactuSistemaFacturacion';
+/**
+ * Operación SOAP de consulta.
+ */
+export const AEAT_OPERATION_CONSULTA = 'ConsultaFactuSistemaFacturacion';
+/**
+ * Namespace del servicio (targetNamespace del WSDL).
+ */
+export const AEAT_SOAP_NAMESPACE = 'https://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/tike/cont/ws/SistemaFacturacion.wsdl';
+/**
+ * Namespace del elemento de consulta (`ConsultaLR.xsd`).
+ */
+export const AEAT_CONSULTA_NAMESPACE = 'https://www2.agenciatributaria.gob.es/static_files/common/internet/dep/aplicaciones/es/aeat/tike/cont/ws/ConsultaLR.xsd';
+/**
+ * Resuelve la URL base efectiva según el entorno.
+ *
+ * Regla: **por defecto se usa producción** (la app real factura en prod).
+ * - Si `env` es `production` (o no se indica), usa `baseUrl`.
+ * - Si `env` es `test`/`development`, usa `testBaseUrl`.
+ *
+ * Los tests se ejecutan aparte y fijan `env: 'test'` + `testBaseUrl` para
+ * usar desarrollo (sin necesidad de indicar la URL de producción).
+ */
+export function resolveBaseUrl(config) {
+    const env = config.env ?? 'production';
+    if (env !== 'production') {
+        if (config.testBaseUrl) {
+            return config.testBaseUrl;
+        }
+        throw new Error('env no es "production" y no se ha proporcionado testBaseUrl.');
+    }
+    if (!config.baseUrl) {
+        throw new Error('env es "production" y no se ha proporcionado baseUrl.');
+    }
+    return config.baseUrl;
+}
+/**
+ * Cliente de servicios AEAT para Verifactu.
+ */
+export class VerifactuClient {
+    config;
+    agent;
+    constructor(config) {
+        this.config = {
+            operation: AEAT_OPERATION_REGISTRO,
+            namespace: AEAT_SOAP_NAMESPACE,
+            timeoutMs: 10_000,
+            ...config,
+            baseUrl: resolveBaseUrl(config),
+        };
+        // Si hay certificado y clave, se usan en el handshake TLS (mTLS).
+        this.agent = new https.Agent(this.config.cert && this.config.key
+            ? { cert: this.config.cert, key: this.config.key }
+            : undefined);
+    }
+    /**
+     * Envía un registro (factura o evento) a AEAT mediante SOAP.
+     */
+    async sendRecord(xml) {
+        const envelope = buildRemisionEnvelope(xml);
+        const url = new URL(this.config.baseUrl);
+        const headers = {
+            'Content-Type': 'text/xml; charset=utf-8',
+            SOAPAction: '',
+            Accept: 'application/xml',
+        };
+        if (this.config.authToken) {
+            headers.Authorization = `Bearer ${this.config.authToken}`;
+        }
+        return this.request(url, 'POST', headers, envelope);
+    }
+    /**
+     * @deprecated La consulta por ID de operación no está soportada por el
+     * esquema `ConsultaLR.xsd` de AEAT (devuelve error 4118). Usa
+     * {@link queryInvoice} para consultar registros por número de factura.
+     */
+    async getOperationStatus(operationId) {
+        const consultaXml = `<ConsultaFactuSistemaFacturacion xmlns="${this.config.namespace}"><ID>${operationId}</ID></ConsultaFactuSistemaFacturacion>`;
+        const envelope = buildRemisionEnvelope(consultaXml);
+        const url = new URL(this.config.baseUrl);
+        const headers = {
+            'Content-Type': 'text/xml; charset=utf-8',
+            SOAPAction: '',
+            Accept: 'application/xml',
+        };
+        if (this.config.authToken) {
+            headers.Authorization = `Bearer ${this.config.authToken}`;
+        }
+        return this.request(url, 'POST', headers, envelope);
+    }
+    /**
+     * Consulta un registro de facturación por número de factura y devuelve la
+     * respuesta completa (incluida la huella confirmada por AEAT).
+     *
+     * Usa la operación `ConsultaFactuSistemaFacturacion` (mismo endpoint SOAP).
+     */
+    async queryInvoice(params) {
+        const consultaXml = [
+            `<sfLRC:ConsultaFactuSistemaFacturacion xmlns:sfLRC="${AEAT_CONSULTA_NAMESPACE}" xmlns:sf="${AEAT_INFORMACION_NAMESPACE}">`,
+            '  <sfLRC:Cabecera>',
+            '    <sf:IDVersion>1.0</sf:IDVersion>',
+            '    <sf:ObligadoEmision>',
+            `      <sf:NombreRazon>${params.obligado.nombreRazon}</sf:NombreRazon>`,
+            `      <sf:NIF>${params.obligado.nif}</sf:NIF>`,
+            '    </sf:ObligadoEmision>',
+            '  </sfLRC:Cabecera>',
+            '  <sfLRC:FiltroConsulta>',
+            '    <sfLRC:PeriodoImputacion>',
+            `      <sf:Ejercicio>${params.ejercicio}</sf:Ejercicio>`,
+            `      <sf:Periodo>${params.periodo}</sf:Periodo>`,
+            '    </sfLRC:PeriodoImputacion>',
+            ...(params.numSerieFactura
+                ? [`    <sfLRC:NumSerieFactura>${params.numSerieFactura}</sfLRC:NumSerieFactura>`]
+                : []),
+            '  </sfLRC:FiltroConsulta>',
+            '</sfLRC:ConsultaFactuSistemaFacturacion>',
+        ].join('\n');
+        const envelope = buildRemisionEnvelope(consultaXml);
+        const url = new URL(this.config.baseUrl);
+        const headers = {
+            'Content-Type': 'text/xml; charset=utf-8',
+            SOAPAction: '',
+            Accept: 'application/xml',
+        };
+        if (this.config.authToken) {
+            headers.Authorization = `Bearer ${this.config.authToken}`;
+        }
+        return this.request(url, 'POST', headers, envelope);
+    }
+    /**
+     * Realiza la petición HTTPS usando el agente (con mTLS si hay certificado).
+     */
+    request(url, method, headers, body) {
+        return new Promise((resolve, reject) => {
+            const req = https.request({
+                hostname: url.hostname,
+                port: url.port || 443,
+                path: `${url.pathname}${url.search}`,
+                method,
+                headers,
+                agent: this.agent,
+            }, (res) => {
+                let raw = '';
+                res.setEncoding('utf8');
+                res.on('data', (chunk) => {
+                    raw += chunk;
+                });
+                res.on('end', () => {
+                    resolve(this.parseResponse(raw, res.statusCode ?? 0));
+                });
+            });
+            req.on('error', reject);
+            req.setTimeout(this.config.timeoutMs, () => {
+                req.destroy(new Error(`Timeout tras ${this.config.timeoutMs}ms`));
+            });
+            if (body) {
+                req.write(body);
+            }
+            req.end();
+        });
+    }
+    /**
+     * Parsea la respuesta de AEAT. La estructura exacta depende del servicio;
+     * este es un mapeo base que el consumidor puede sobrescribir.
+     *
+     * Devuelve SIEMPRE todo lo recibido: la respuesta completa parseada en
+     * `data` y el cuerpo crudo en `rawResponse`, tanto si es OK como error.
+     */
+    parseResponse(raw, httpStatus) {
+        let operationId = '';
+        let status = httpStatus >= 200 && httpStatus < 300 ? 'OK' : 'ERROR';
+        let message;
+        let errorCode;
+        let data;
+        let response;
+        // AEAT responde en SOAP/XML: se normaliza a JSON.
+        const soap = parseSoapResponse(raw);
+        if (soap) {
+            response = soap;
+            data = soap.body;
+            operationId = String(soap.body['ID'] ?? soap.body['IdPeticion'] ?? '');
+            // Estado según el registro/consulta/evento mapeado.
+            const reg = soap.registro;
+            const con = soap.consulta;
+            const ev = soap.evento;
+            const estado = reg?.estadoRegistro ?? con?.estado ?? ev?.estadoEvento;
+            if (estado) {
+                status = /OK|ACEPTAD|CONFIRMAD|CORRECT/i.test(estado) ? 'OK' : 'ERROR';
+            }
+            errorCode = reg?.codigoErrorRegistro ?? con?.codigoError ?? ev?.codigoErrorEvento;
+            message =
+                reg?.descripcionErrorRegistro ??
+                    con?.descripcionError ??
+                    ev?.descripcionErrorEvento ??
+                    estado;
+        }
+        else {
+            // Respuesta no XML/JSON: se conserva el cuerpo como mensaje.
+            try {
+                const json = JSON.parse(raw);
+                data = json;
+                operationId = String(json.operationId ?? json.id ?? '');
+                if (json.status === 'OK' || json.status === 'ERROR') {
+                    status = json.status;
+                }
+                message = json.message;
+                errorCode = json.errorCode;
+            }
+            catch {
+                message = raw;
+            }
+        }
+        return {
+            operationId,
+            status,
+            message,
+            errorCode,
+            rawResponse: raw,
+            data,
+            response,
+            registro: response?.registro,
+            consulta: response?.consulta,
+            evento: response?.evento,
+        };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/aeat/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/aeat/client.ts"],"names":[],"mappings":"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"}

package/dist/esm/aeat/index.d.ts

@@ -0,0 +1,3 @@
+export * from './client.js';
+export * from './response.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/aeat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/aeat/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/esm/aeat/index.js

@@ -0,0 +1,3 @@
+export * from './client.js';
+export * from './response.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/aeat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/aeat/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/esm/aeat/response.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Respuesta de AEAT para un registro de facturación (alta/anulación).
+ *
+ * AEAT devuelve un SOAP XML; este tipo es el resultado normalizado a JSON
+ * para que el sistema consumidor lo persista y lo maneje con facilidad.
+ */
+export interface RegistroResponse {
+    /** Estado del registro devuelto por AEAT. */
+    estadoRegistro?: string;
+    /** Código de error del registro (si lo hay). */
+    codigoErrorRegistro?: string;
+    /** Descripción del error del registro (si lo hay). */
+    descripcionErrorRegistro?: string;
+    /** CSV (Código Seguro de Verificación) si AEAT lo devuelve. */
+    csv?: string;
+    /** Huella (hash) del registro confirmado por AEAT. */
+    huella?: string;
+    /** Fecha/hora de generación del registro en AEAT. */
+    fechaHoraHusoGenRegistro?: string;
+    /** Identificador de la factura (si AEAT lo devuelve). */
+    idFactura?: string;
+}
+/**
+ * Respuesta de AEAT para una consulta de estado de operación.
+ */
+export interface ConsultaResponse {
+    /** Estado de la operación consultada. */
+    estado?: string;
+    /** Código de error (si lo hay). */
+    codigoError?: string;
+    /** Descripción del error (si lo hay). */
+    descripcionError?: string;
+    /** CSV de la operación consultada. */
+    csv?: string;
+    /** Huella (hash) de la operación consultada. */
+    huella?: string;
+    /** Registros devueltos por la consulta. */
+    registros?: RegistroResponse[];
+}
+/**
+ * Respuesta de AEAT para un registro de evento.
+ */
+export interface EventoResponse {
+    /** Estado del evento devuelto por AEAT. */
+    estadoEvento?: string;
+    /** Código de error del evento (si lo hay). */
+    codigoErrorEvento?: string;
+    /** Descripción del error del evento (si lo hay). */
+    descripcionErrorEvento?: string;
+    /** CSV del evento si AEAT lo devuelve. */
+    csv?: string;
+    /** Huella (hash) del evento confirmado por AEAT. */
+    huella?: string;
+}
+/**
+ * Resultado normalizado de una respuesta SOAP de AEAT.
+ */
+export interface SoapResponse {
+    /** Nombre del elemento raíz del body SOAP (p. ej. `RespuestaRegFactuSistemaFacturacion`). */
+    operation: string;
+    /** Objeto JSON completo parseado del body SOAP. */
+    body: Record<string, unknown>;
+    /** Respuesta tipada de registro (si la operación es de registro). */
+    registro?: RegistroResponse;
+    /** Respuesta tipada de consulta (si la operación es de consulta). */
+    consulta?: ConsultaResponse;
+    /** Respuesta tipada de evento (si la operación es de evento). */
+    evento?: EventoResponse;
+}
+/**
+ * Convierte un XML SOAP de AEAT a un objeto JSON normalizado.
+ *
+ * Extrae el body del sobre SOAP y mapea los campos a las interfaces tipadas
+ * (`RegistroResponse`, `ConsultaResponse`, `EventoResponse`). Si el XML no
+ * es parseable, devuelve `null`.
+ */
+export declare function parseSoapResponse(xml: string): SoapResponse | null;
+//# sourceMappingURL=response.d.ts.map

package/dist/esm/aeat/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../../src/aeat/response.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sDAAsD;IACtD,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oDAAoD;IACpD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6FAA6F;IAC7F,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,iEAAiE;IACjE,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAUD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAqClE"}

package/dist/esm/aeat/response.js

@@ -0,0 +1,114 @@
+import { XMLParser } from 'fast-xml-parser';
+const parser = new XMLParser({
+    ignoreAttributes: false,
+    attributeNamePrefix: '@_',
+    removeNSPrefix: true,
+    parseTagValue: false,
+    trimValues: true,
+});
+/**
+ * Convierte un XML SOAP de AEAT a un objeto JSON normalizado.
+ *
+ * Extrae el body del sobre SOAP y mapea los campos a las interfaces tipadas
+ * (`RegistroResponse`, `ConsultaResponse`, `EventoResponse`). Si el XML no
+ * es parseable, devuelve `null`.
+ */
+export function parseSoapResponse(xml) {
+    // Solo procesar si parece XML (evita parsear JSON u otros textos).
+    if (typeof xml !== 'string' || !xml.trim().startsWith('<')) {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = parser.parse(xml);
+    }
+    catch {
+        return null;
+    }
+    // Navegar hasta el body del sobre SOAP (removeNSPrefix elimina el prefijo).
+    const envelope = (parsed['Envelope'] ?? parsed);
+    const body = (envelope['Body'] ?? envelope);
+    // El body contiene un único elemento de operación.
+    const keys = Object.keys(body).filter((k) => k !== 'Body');
+    const operation = keys[0] ?? '';
+    const opBody = body[operation];
+    const result = {
+        operation,
+        body: (opBody ?? body),
+    };
+    // Mapear según el tipo de operación.
+    if (/RegFactu|Registro/i.test(operation)) {
+        result.registro = mapRegistro(opBody);
+    }
+    else if (/Consulta/i.test(operation)) {
+        result.consulta = mapConsulta(opBody);
+    }
+    else if (/Evento/i.test(operation)) {
+        result.evento = mapEvento(opBody);
+    }
+    return result;
+}
+function mapRegistro(opBody) {
+    if (!opBody)
+        return undefined;
+    const rf = (opBody['RegistroFactura'] ?? opBody);
+    return {
+        estadoRegistro: str(rf['EstadoRegistro']),
+        codigoErrorRegistro: str(rf['CodigoErrorRegistro']),
+        descripcionErrorRegistro: str(rf['DescripcionErrorRegistro']),
+        csv: str(rf['CSV']),
+        huella: str(rf['Huella']),
+        fechaHoraHusoGenRegistro: str(rf['FechaHoraHusoGenRegistro']),
+        idFactura: str(rf['IDFactura']),
+    };
+}
+function mapConsulta(opBody) {
+    if (!opBody)
+        return undefined;
+    // La consulta devuelve los registros en `RegistroRespuestaConsultaFactuSistemaFacturacion`
+    // (o `RegistroFactura`/`Registros` en otros formatos).
+    const registrosRaw = opBody['RegistroRespuestaConsultaFactuSistemaFacturacion'] ??
+        opBody['RegistroFactura'] ??
+        opBody['Registros'];
+    const registros = Array.isArray(registrosRaw)
+        ? registrosRaw.map((r) => mapRegistroConsulta(r)).filter(Boolean)
+        : registrosRaw
+            ? [mapRegistroConsulta(registrosRaw)]
+            : undefined;
+    return {
+        estado: str(opBody['Estado']),
+        codigoError: str(opBody['CodigoError']),
+        descripcionError: str(opBody['DescripcionError']),
+        csv: str(opBody['CSV']),
+        huella: registros?.[0]?.huella,
+        registros: registros,
+    };
+}
+/** Mapea un registro de la respuesta de consulta (con `DatosRegistroFacturacion`). */
+function mapRegistroConsulta(raw) {
+    const datos = (raw['DatosRegistroFacturacion'] ?? raw);
+    const estado = (raw['EstadoRegistro'] ?? {});
+    return {
+        estadoRegistro: str(estado['EstadoRegistro']),
+        huella: str(datos['Huella']),
+        fechaHoraHusoGenRegistro: str(datos['FechaHoraHusoGenRegistro']),
+        idFactura: str(raw['IDFactura']),
+    };
+}
+function mapEvento(opBody) {
+    if (!opBody)
+        return undefined;
+    return {
+        estadoEvento: str(opBody['EstadoEvento']),
+        codigoErrorEvento: str(opBody['CodigoErrorEvento']),
+        descripcionErrorEvento: str(opBody['DescripcionErrorEvento']),
+        csv: str(opBody['CSV']),
+        huella: str(opBody['Huella']),
+    };
+}
+function str(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    return String(value);
+}
+//# sourceMappingURL=response.js.map

package/dist/esm/aeat/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../src/aeat/response.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/hash/chain.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Calcula el hash SHA-256 de un dato en hexadecimal MAYÚSCULA.
+ * Verifactu exige el hash en hexadecimal en mayúsculas (64 caracteres).
+ */
+export declare function sha256(data: string | Buffer): string;
+/**
+ * Concatena los campos de un registro en el formato Verifactu:
+ * `nombreCampo1=valor1&nombreCampo2=valor2&...`
+ *
+ * Reglas de normalización (AEAT):
+ * - Se eliminan los espacios al inicio y final de cada valor (trim).
+ * - Los campos vacíos o ausentes se incluyen como `nombreCampo=` (sin valor).
+ * - No se aplica URL-encoding ni escaping a caracteres especiales.
+ */
+export declare function concatenateFields(fields: Array<[string, string | null | undefined]>): string;
+/**
+ * Campos de un registro de alta (RegistroAlta) para el cálculo de la huella.
+ */
+export interface RegistroAltaInput {
+    /** Identificador del emisor (NIF). */
+    idEmisorFactura: string;
+    /** Número y serie de la factura. */
+    numSerieFactura: string;
+    /** Fecha de expedición de la factura. */
+    fechaExpedicionFactura: string;
+    /** Tipo de factura (F1, F2, ...). */
+    tipoFactura: string;
+    /** Cuota total. */
+    cuotaTotal: string;
+    /** Importe total. */
+    importeTotal: string;
+    /** Huella (hash) del registro anterior, o null para el primero. */
+    huellaAnterior: string | null;
+    /** Fecha/hora de generación con huso horario. */
+    fechaHoraHusoGenRegistro: string;
+}
+/**
+ * Campos de un registro de anulación (RegistroAnulacion).
+ */
+export interface RegistroAnulacionInput {
+    /** Identificador del emisor de la factura anulada. */
+    idEmisorFacturaAnulada: string;
+    /** Número y serie de la factura anulada. */
+    numSerieFacturaAnulada: string;
+    /** Fecha de expedición de la factura anulada. */
+    fechaExpedicionFacturaAnulada: string;
+    /** Huella (hash) del registro anterior. */
+    huellaAnterior: string | null;
+    /** Fecha/hora de generación con huso horario. */
+    fechaHoraHusoGenRegistro: string;
+}
+/**
+ * Construye la cadena canónica a hashear de un registro de alta.
+ */
+export declare function concatenateRegistroAlta(input: RegistroAltaInput): string;
+/**
+ * Construye la cadena canónica a hashear de un registro de anulación.
+ */
+export declare function concatenateRegistroAnulacion(input: RegistroAnulacionInput): string;
+/**
+ * Calcula la huella (hash) de un registro de alta.
+ */
+export declare function computeRegistroAlta(input: RegistroAltaInput): string;
+/**
+ * Calcula la huella (hash) de un registro de anulación.
+ */
+export declare function computeRegistroAnulacion(input: RegistroAnulacionInput): string;
+/**
+ * Verifica que el hash de un registro de alta coincide con el esperado.
+ */
+export declare function verifyRegistroAlta(input: RegistroAltaInput, expectedHash: string): boolean;
+/**
+ * Verifica que el hash de un registro de anulación coincide con el esperado.
+ */
+export declare function verifyRegistroAnulacion(input: RegistroAnulacionInput, expectedHash: string): boolean;
+/**
+ * Campos de un registro de evento (RegistroEvento).
+ *
+ * Nota: el nombre `NIF` aparece DOS veces (posiciones 1 y 6): una para el
+ * sistema informático y otra para el obligado a emitir.
+ */
+export interface RegistroEventoInput {
+    /** NIF del sistema informático (NIF, posición 1). */
+    nifSistemaInformatico: string;
+    /** Identificador del evento (ID). */
+    id: string;
+    /** Identificador del sistema informático. */
+    idSistemaInformatico: string;
+    /** Versión del sistema informático. */
+    version: string;
+    /** Número de instalación. */
+    numeroInstalacion: string;
+    /** NIF del obligado a emitir (NIF, posición 6). */
+    nifObligado: string;
+    /** Tipo de evento. */
+    tipoEvento: string;
+    /** Huella (hash) del registro anterior, o null para el primero. */
+    huellaAnterior: string | null;
+    /** Fecha/hora de generación con huso horario. */
+    fechaHoraHusoGenEvento: string;
+}
+/**
+ * Construye la cadena canónica a hashear de un registro de evento.
+ */
+export declare function concatenateRegistroEvento(input: RegistroEventoInput): string;
+/**
+ * Calcula la huella (hash) de un registro de evento.
+ */
+export declare function computeRegistroEvento(input: RegistroEventoInput): string;
+/**
+ * Verifica que el hash de un registro de evento coincide con el esperado.
+ */
+export declare function verifyRegistroEvento(input: RegistroEventoInput, expectedHash: string): boolean;
+/**
+ * Cadena de hash con estado, para encadenar registros de forma secuencial.
+ */
+export declare class HashChain {
+    private _lastHash;
+    private _count;
+    /** Hash del último registro encadenado, o `null` si aún no hay ninguno. */
+    get lastHash(): string | null;
+    /** Número de registros encadenados hasta ahora. */
+    get count(): number;
+    /**
+     * Encadena un nuevo registro de alta y devuelve su huella.
+     */
+    pushAlta(input: Omit<RegistroAltaInput, 'huellaAnterior'>): string;
+    /**
+     * Encadena un nuevo registro de anulación y devuelve su huella.
+     */
+    pushAnulacion(input: Omit<RegistroAnulacionInput, 'huellaAnterior'>): string;
+    /**
+     * Encadena un nuevo registro de evento y devuelve su huella.
+     */
+    pushEvento(input: Omit<RegistroEventoInput, 'huellaAnterior'>): string;
+    /** Reinicia la cadena. */
+    reset(): void;
+}
+//# sourceMappingURL=chain.d.ts.map

package/dist/esm/core/hash/chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../../../src/core/hash/chain.ts"],"names":[],"mappings":"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"}