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

package/dist/cjs/integration/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./repository.js"), exports);
+__exportStar(require("./service.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/integration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integration/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,+CAA6B"}

package/dist/cjs/integration/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../src/integration/repository.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,MAAM,GACN,WAAW,GACX,UAAU,GACV,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,qCAAqC;IACrC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACpD,kEAAkE;IAClE,aAAa,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAC9C,mCAAmC;IACnC,YAAY,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,6CAA6C;IAC7C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC1D,wBAAwB;IACxB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC"}

package/dist/cjs/integration/repository.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=repository.js.map

package/dist/cjs/integration/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../../src/integration/repository.ts"],"names":[],"mappings":""}

package/dist/cjs/integration/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/integration/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAIzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEzE;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,UAAU,EAAE,mBAAmB,EAC/B,MAAM,EAAE,eAAe;IAG1C;;;OAGG;IACG,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;IAmD9D;;;;;OAKG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA8D5D;;;;;;OAMG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;CAOzF"}

package/dist/cjs/integration/service.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VerifactuService = void 0;
+const generator_js_1 = require("../core/xml/generator.js");
+const chain_js_1 = require("../core/hash/chain.js");
+const qr_js_1 = require("../core/qr/qr.js");
+/**
+ * Servicio de orquestación de Verifactu.
+ *
+ * Une el núcleo puro (generación XML + hash) con el cliente AEAT y la
+ * persistencia. El sistema consumidor DEBE proporcionar un repositorio que
+ * implemente `VerifactuRepository` (ver `repository.ts` y `schema.sql`).
+ */
+class VerifactuService {
+    repository;
+    client;
+    constructor(repository, client) {
+        this.repository = repository;
+        this.client = client;
+    }
+    /**
+     * Registra una factura: genera el XML, calcula el hash encadenado, guarda
+     * el registro y lo envía a AEAT, persistiendo la respuesta.
+     */
+    async registerInvoice(invoice) {
+        // 1. Obtener el hash del último registro para encadenar.
+        const last = await this.repository.getLastRecord();
+        const previousHash = last?.hash ?? null;
+        // 2. Generar XML y calcular la huella (hash) del registro.
+        const xml = (0, generator_js_1.generateInvoiceXml)(invoice, previousHash);
+        const hash = (0, chain_js_1.computeRegistroAlta)({
+            idEmisorFactura: invoice.emisor.nif,
+            numSerieFactura: `${invoice.id.serie ?? ''}${invoice.id.numero}`,
+            fechaExpedicionFactura: invoice.id.fechaExpedicion,
+            tipoFactura: invoice.tipoFactura,
+            cuotaTotal: invoice.desglose.cuotaTotal.toFixed(2),
+            importeTotal: invoice.desglose.importeTotal.toFixed(2),
+            huellaAnterior: previousHash,
+            fechaHoraHusoGenRegistro: new Date().toISOString(),
+        });
+        // 3. Persistir el registro como PENDING.
+        const now = new Date().toISOString();
+        const record = {
+            id: `${invoice.id.serie ?? ''}${invoice.id.numero}`,
+            invoiceId: `${invoice.id.serie ?? ''}${invoice.id.numero}`,
+            xml,
+            hash,
+            previousHash,
+            qrPayload: (0, qr_js_1.buildQrPayload)(hash),
+            status: 'PENDING',
+            createdAt: now,
+            updatedAt: now,
+        };
+        await this.repository.saveRecord(record);
+        // 4. Enviar a AEAT y persistir la respuesta.
+        const result = await this.client.sendRecord(xml);
+        await this.repository.saveResponse({
+            id: `${record.id}-${Date.now()}`,
+            recordId: record.id,
+            operationId: result.operationId,
+            status: result.status,
+            message: result.message,
+            receivedAt: new Date().toISOString(),
+        });
+        // 5. Actualizar el estado del registro según la respuesta.
+        const status = result.status === 'OK' ? 'CONFIRMED' : 'REJECTED';
+        await this.repository.updateRecordStatus(record.id, status);
+        return { ...record, status };
+    }
+    /**
+     * Anula una factura previamente registrada.
+     *
+     * Genera un registro de anulación que referencia la factura anulada,
+     * lo envía a AEAT y marca la factura original como ANNULLED.
+     */
+    async annulInvoice(invoiceId) {
+        // 1. Obtener la factura original (para su huella) y el último registro.
+        const original = await this.repository.getRecord(invoiceId);
+        if (!original) {
+            throw new Error(`No existe el registro a anular: ${invoiceId}`);
+        }
+        const last = await this.repository.getLastRecord();
+        const previousHash = last?.hash ?? null;
+        // 2. Generar XML de anulación y calcular la huella.
+        const xml = (0, generator_js_1.generateAnulacionXml)({
+            idEmisorFacturaAnulada: original.invoiceId,
+            numSerieFacturaAnulada: original.invoiceId,
+            fechaExpedicionFacturaAnulada: new Date().toISOString().slice(0, 10),
+            huellaFacturaAnulada: original.hash,
+        }, previousHash);
+        const hash = (0, chain_js_1.computeRegistroAnulacion)({
+            idEmisorFacturaAnulada: original.invoiceId,
+            numSerieFacturaAnulada: original.invoiceId,
+            fechaExpedicionFacturaAnulada: new Date().toISOString().slice(0, 10),
+            huellaAnterior: previousHash,
+            fechaHoraHusoGenRegistro: new Date().toISOString(),
+        });
+        // 3. Persistir el registro de anulación como PENDING.
+        const now = new Date().toISOString();
+        const record = {
+            id: `${invoiceId}-ANUL`,
+            invoiceId,
+            xml,
+            hash,
+            previousHash,
+            status: 'PENDING',
+            createdAt: now,
+            updatedAt: now,
+        };
+        await this.repository.saveRecord(record);
+        // 4. Enviar a AEAT y persistir la respuesta.
+        const result = await this.client.sendRecord(xml);
+        await this.repository.saveResponse({
+            id: `${record.id}-${Date.now()}`,
+            recordId: record.id,
+            operationId: result.operationId,
+            status: result.status,
+            message: result.message,
+            receivedAt: new Date().toISOString(),
+        });
+        // 5. Actualizar estados.
+        const status = result.status === 'OK' ? 'CONFIRMED' : 'REJECTED';
+        await this.repository.updateRecordStatus(record.id, status);
+        if (result.status === 'OK') {
+            await this.repository.updateRecordStatus(invoiceId, 'ANNULLED');
+        }
+        return { ...record, status };
+    }
+    /**
+     * Modifica una factura previamente registrada.
+     *
+     * Verifactu no tiene un tipo "modificación": se implementa como anulación
+     * del registro original + alta con los datos corregidos. El usuario solo
+     * envía la referencia a la factura original y la factura corregida.
+     */
+    async modifyInvoice(invoiceId, correctedInvoice) {
+        // 1. Anular la factura original.
+        await this.annulInvoice(invoiceId);
+        // 2. Emitir la factura corregida como un nuevo alta.
+        return this.registerInvoice(correctedInvoice);
+    }
+}
+exports.VerifactuService = VerifactuService;
+//# sourceMappingURL=service.js.map

package/dist/cjs/integration/service.js.map

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

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

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

@@ -0,0 +1,57 @@
+/**
+ * Cliente para los servicios web de AEAT (Verifactu).
+ *
+ * Capa de red, separada del núcleo puro. Depende de credenciales y entornos
+ * (producción vs. pruebas), por lo que no debe acoplarse a la lógica de
+ * negocio.
+ *
+ * NOTA: los endpoints y el formato de petición/respuesta deben ajustarse a
+ * la documentación oficial de la AEAT (remisión voluntaria / bajo
+ * requerimiento). Este cliente expone una implementación base con `fetch`
+ * y rutas configurables.
+ */
+export interface VerifactuClientConfig {
+    /** URL base del servicio AEAT. */
+    baseUrl: string;
+    /** Token de autenticación (OAuth) o certificado. */
+    authToken?: string;
+    /** Ruta del endpoint de envío de registros. */
+    sendPath?: string;
+    /** Ruta del endpoint de consulta de estado. */
+    statusPath?: string;
+    /** Timeout de petición en ms. */
+    timeoutMs?: number;
+}
+export interface SendResult {
+    /** Identificador de la operación devuelto por AEAT. */
+    operationId: string;
+    /** Estado de la respuesta. */
+    status: 'OK' | 'ERROR';
+    /** Mensaje de la AEAT. */
+    message?: string;
+    /** Código de error de AEAT (si lo hay). */
+    errorCode?: string;
+    /** Cuerpo completo de la respuesta (para auditoría). */
+    rawResponse?: string;
+}
+/**
+ * Cliente de servicios AEAT para Verifactu.
+ */
+export declare class VerifactuClient {
+    private readonly config;
+    constructor(config: VerifactuClientConfig);
+    /**
+     * Envía un registro (factura o evento) a AEAT.
+     */
+    sendRecord(xml: string): Promise<SendResult>;
+    /**
+     * Consulta el estado de una operación enviada.
+     */
+    getOperationStatus(operationId: string): Promise<SendResult>;
+    /**
+     * Parsea la respuesta de AEAT. La estructura exacta depende del servicio;
+     * este es un mapeo base que el consumidor puede sobrescribir.
+     */
+    protected parseResponse(raw: string, httpStatus: number): SendResult;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/aeat/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAUD;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,MAAM,EAAE,qBAAqB;IASzC;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA0BlD;;OAEG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAkBlE;;;OAGG;IACH,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU;CAqBrE"}

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,2 @@
+export * from './client.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"}

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"}

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

@@ -0,0 +1,97 @@
+/**
+ * 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;
+/**
+ * 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;
+    /** 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":"AAEA;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,GAAG,MAAM,CAO5F;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,yCAAyC;IACzC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iDAAiD;IACjD,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,sDAAsD;IACtD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,4CAA4C;IAC5C,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iDAAiD;IACjD,6BAA6B,EAAE,MAAM,CAAC;IACtC,2CAA2C;IAC3C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iDAAiD;IACjD,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAWxE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAQlF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAEpE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAE9E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAE1F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,sBAAsB,EAC7B,YAAY,EAAE,MAAM,GACnB,OAAO,CAET;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,MAAM,CAAK;IAEnB,2EAA2E;IAC3E,IAAI,QAAQ,IAAI,MAAM,GAAG,IAAI,CAE5B;IAED,mDAAmD;IACnD,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,GAAG,MAAM;IAOlE;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,sBAAsB,EAAE,gBAAgB,CAAC,GAAG,MAAM;IAO5E,0BAA0B;IAC1B,KAAK,IAAI,IAAI;CAId"}

package/dist/esm/core/hash/chain.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/hash/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/esm/core/hash/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/hash/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,5 @@
+export * from './models/index.js';
+export * from './hash/index.js';
+export * from './xml/index.js';
+export * from './qr/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/esm/core/models/event.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Tipos de evento de registro Verifactu.
+ * - ALTA: alta de una factura.
+ * - ANULACION: anulación de una factura previamente registrada.
+ * - MODIFICACION: modificación de una factura.
+ */
+export type EventType = 'ALTA' | 'ANULACION' | 'MODIFICACION';
+/**
+ * Evento de registro Verifactu.
+ */
+export interface Event {
+    /** Tipo de evento. */
+    type: EventType;
+    /** Fecha/hora del evento en formato ISO 8601. */
+    fechaHora: string;
+    /** Referencia a la factura asociada. */
+    invoiceId: string;
+    /** Motivo de anulación (obligatorio si type === 'ANULACION'). */
+    motivoAnulacion?: string;
+    /** Referencia a la factura que se anula (para ANULACION). */
+    facturaAnulada?: string;
+    /** Metadatos adicionales. */
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=event.d.ts.map

package/dist/esm/core/models/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../../../src/core/models/event.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,cAAc,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,sBAAsB;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/esm/core/models/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../../../src/core/models/event.ts"],"names":[],"mappings":""}

package/dist/esm/core/models/index.d.ts

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

package/dist/esm/core/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/esm/core/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/esm/core/models/invoice.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Datos identificativos del emisor de la factura.
+ * Verifactu exige identificar al emisor (NIF, nombre/razón social).
+ */
+export interface Emisor {
+    /** NIF del emisor. */
+    nif: string;
+    /** Nombre o razón social. */
+    nombreRazon: string;
+    /** Código de país (ISO 3166-1 alpha-2). Opcional si es España. */
+    pais?: string;
+    /** Código postal. */
+    codigoPostal?: string;
+    /** Municipio. */
+    municipio?: string;
+    /** Dirección. */
+    direccion?: string;
+}
+/**
+ * Identificación de la factura.
+ */
+export interface FacturaId {
+    /** Serie de la factura (opcional). */
+    serie?: string;
+    /** Número de la factura. */
+    numero: string;
+    /** Fecha de expedición en formato ISO (YYYY-MM-DD). */
+    fechaExpedicion: string;
+    /** Fecha de operación (opcional). */
+    fechaOperacion?: string;
+}
+/**
+ * Tipo de factura Verifactu (F1–F9).
+ */
+export type TipoFactura = 'F1' | 'F2' | 'F3' | 'F4' | 'F5' | 'F6' | 'F7' | 'F8' | 'F9';
+/**
+ * Tipo de desglose Verifactu (S1–S6).
+ */
+export type TipoDesglose = 'S1' | 'S2' | 'S3' | 'S4' | 'S5' | 'S6';
+/**
+ * Detalle de IVA de una línea de desglose.
+ */
+export interface DetalleIva {
+    /** Tipo impositivo (%). */
+    tipoImpositivo: number;
+    /** Base imponible. */
+    baseImponible: number;
+    /** Cuota repercutida. */
+    cuotaRepercutida: number;
+}
+/**
+ * Desglose de la operación por tipo de operación e IVA.
+ */
+export interface DesgloseTipoOperacion {
+    /** Clave de tipo de operación (p. ej. '01'). */
+    tipoOperacion: string;
+    /** Detalles de IVA. */
+    detallesIva: DetalleIva[];
+}
+/**
+ * Desglose completo de la factura.
+ */
+export interface Desglose {
+    /** Desglose por tipo de operación. */
+    tipoOperaciones: DesgloseTipoOperacion[];
+    /** Cuota total de la factura. */
+    cuotaTotal: number;
+    /** Importe total de la factura. */
+    importeTotal: number;
+}
+/**
+ * Factura en el modelo de datos Verifactu.
+ */
+export interface Invoice {
+    /** Identificación de la factura. */
+    id: FacturaId;
+    /** Emisor de la factura. */
+    emisor: Emisor;
+    /** Desglose de la factura. */
+    desglose: Desglose;
+    /** Tipo de factura. */
+    tipoFactura: TipoFactura;
+    /** Tipo de desglose. */
+    tipoDesglose: TipoDesglose;
+    /** Descripción de la operación. */
+    descripcion?: string;
+    /** Metadatos adicionales libres. */
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=invoice.d.ts.map

package/dist/esm/core/models/invoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice.d.ts","sourceRoot":"","sources":["../../../../src/core/models/invoice.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,eAAe,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;AAET;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2BAA2B;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,sCAAsC;IACtC,eAAe,EAAE,qBAAqB,EAAE,CAAC;IACzC,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,oCAAoC;IACpC,EAAE,EAAE,SAAS,CAAC;IACd,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IACnB,uBAAuB;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,wBAAwB;IACxB,YAAY,EAAE,YAAY,CAAC;IAC3B,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/esm/core/models/invoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice.js","sourceRoot":"","sources":["../../../../src/core/models/invoice.ts"],"names":[],"mappings":""}

package/dist/esm/core/qr/index.d.ts

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

package/dist/esm/core/qr/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/qr/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/esm/core/qr/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/qr/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/esm/core/qr/qr.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Construye el payload del QR Verifactu.
+ *
+ * El QR Verifactu codifica una URL de verificación que incluye el hash del
+ * registro, de modo que cualquier persona pueda verificar la integridad de
+ * la factura contra la AEAT.
+ *
+ * @param hash        Hash del registro (encadenado).
+ * @param baseUrl     URL base de verificación de la AEAT.
+ * @param extraParams Parámetros adicionales a incluir en la URL.
+ */
+export declare function buildQrPayload(hash: string, baseUrl?: string, extraParams?: Record<string, string>): string;
+//# sourceMappingURL=qr.d.ts.map

package/dist/esm/core/qr/qr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr.d.ts","sourceRoot":"","sources":["../../../../src/core/qr/qr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,SAA8D,EACrE,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACvC,MAAM,CAGR"}

package/dist/esm/core/qr/qr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr.js","sourceRoot":"","sources":["../../../../src/core/qr/qr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,OAAO,GAAG,2DAA2D,EACrE,cAAsC,EAAE;IAExC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC;IAC7D,OAAO,GAAG,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AAC3C,CAAC"}

package/dist/esm/core/xml/generator.d.ts

@@ -0,0 +1,32 @@
+import type { Invoice } from '../models/invoice.js';
+/**
+ * Datos de la factura que se anula.
+ */
+export interface AnulacionInput {
+    /** NIF 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) de la factura anulada. */
+    huellaFacturaAnulada: string;
+}
+/**
+ * Genera el XML Verifactu de una factura (registro de alta).
+ *
+ * Estructura basada en el RD 1007/2023 y la documentación técnica de la
+ * AEAT. NOTA: el esquema XSD oficial debe validarse antes de producción;
+ * este esqueleto refleja los bloques principales (IDFactura, IDEmisorFactura,
+ * TipoFactura, TipoDesglose, Desglose, CuotaTotal, Encadenamiento, Huella).
+ */
+export declare function generateInvoiceXml(invoice: Invoice, previousHash: string | null): string;
+/**
+ * Genera el XML Verifactu de un registro de anulación.
+ *
+ * Referencia la factura anulada (IDFactura + Huella) y encadena con el hash
+ * anterior. Estructura basada en el RD 1007/2023; validar contra el XSD
+ * oficial antes de producción.
+ */
+export declare function generateAnulacionXml(anulacion: AnulacionInput, previousHash: string | null): string;
+//# sourceMappingURL=generator.d.ts.map

package/dist/esm/core/xml/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../src/core/xml/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,sBAAsB,EAAE,MAAM,CAAC;IAC/B,4CAA4C;IAC5C,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iDAAiD;IACjD,6BAA6B,EAAE,MAAM,CAAC;IACtC,2CAA2C;IAC3C,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAqBD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAwDxF;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,cAAc,EACzB,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,MAAM,CAqBR"}