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

package/dist/cjs/core/xml/index.js

@@ -0,0 +1,18 @@
+"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("./generator.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/core/xml/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/xml/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B"}

package/dist/cjs/index.d.ts.map

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

package/dist/cjs/index.js

@@ -0,0 +1,20 @@
+"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("./core/index.js"), exports);
+__exportStar(require("./aeat/index.js"), exports);
+__exportStar(require("./integration/index.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

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

package/dist/cjs/integration/accountability.d.ts

@@ -0,0 +1,41 @@
+import type { Invoice } from '../core/models/invoice.js';
+import type { VerifactuRepository, StoredRecord } from './repository.js';
+/**
+ * Configuración de la integración de accountability (contabilidad).
+ *
+ * Se puede aportar el material TLS ya extraído (`cert`/`key`) o el `.p12`
+ * en bruto (`p12Buffer` + `p12Password`). El NIF del emisor se aporta
+ * siempre en `nif` (la librería no interpreta los campos del certificado).
+ */
+export interface AccountabilityConfig {
+    /** URL base del servicio AEAT. */
+    baseUrl: string;
+    /** NIF del emisor. */
+    nif: string;
+    /** Certificado de cliente en PEM (mTLS). */
+    cert?: string;
+    /** Clave privada del cliente en PEM (mTLS). */
+    key?: string;
+    /** Contenido del `.p12` (alternativa a `cert`/`key`). */
+    p12Buffer?: Buffer;
+    /** Contraseña del `.p12`. */
+    p12Password?: string;
+}
+/**
+ * Integración de accountability (contabilidad) para Verifactu.
+ *
+ * Une las credenciales del certificado (`.p12`) con el cliente mTLS y la
+ * persistencia, para registrar facturas de forma verificable ante la AEAT.
+ */
+export declare class AccountabilityService {
+    private readonly repository;
+    private readonly client;
+    private readonly nif;
+    constructor(repository: VerifactuRepository, config: AccountabilityConfig);
+    /**
+     * Registra una factura (alta) ante la AEAT, usando el certificado del
+     * emisor para autenticar el envío.
+     */
+    registerInvoice(invoice: Invoice): Promise<StoredRecord>;
+}
+//# sourceMappingURL=accountability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"accountability.d.ts","sourceRoot":"","sources":["../../../src/integration/accountability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAOzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEzE;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,qBAAqB;IAK9B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAGV,UAAU,EAAE,mBAAmB,EAChD,MAAM,EAAE,oBAAoB;IAwB9B;;;OAGG;IACG,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;CAqD/D"}

package/dist/cjs/integration/accountability.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountabilityService = 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");
+const date_js_1 = require("../core/utils/date.js");
+const client_js_1 = require("../aeat/client.js");
+const p12_js_1 = require("./p12.js");
+/**
+ * Integración de accountability (contabilidad) para Verifactu.
+ *
+ * Une las credenciales del certificado (`.p12`) con el cliente mTLS y la
+ * persistencia, para registrar facturas de forma verificable ante la AEAT.
+ */
+class AccountabilityService {
+    repository;
+    client;
+    nif;
+    constructor(repository, config) {
+        this.repository = repository;
+        let cert;
+        let key;
+        if (config.p12Buffer && config.p12Password) {
+            const content = (0, p12_js_1.readP12)(config.p12Buffer, config.p12Password);
+            cert = content.certificates[0];
+            key = content.keys[0];
+        }
+        else if (config.cert && config.key) {
+            cert = config.cert;
+            key = config.key;
+        }
+        if (!cert || !key) {
+            throw new Error('AccountabilityService requiere un .p12 (p12Buffer + p12Password) o cert/key PEM.');
+        }
+        this.nif = config.nif;
+        this.client = new client_js_1.VerifactuClient({ baseUrl: config.baseUrl, cert, key });
+    }
+    /**
+     * Registra una factura (alta) ante la AEAT, usando el certificado del
+     * emisor para autenticar el envío.
+     */
+    async registerInvoice(invoice) {
+        // El NIF del emisor se toma del certificado (o del config).
+        const invoiceConNif = {
+            ...invoice,
+            emisor: { ...invoice.emisor, nif: this.nif },
+        };
+        const last = await this.repository.getLastRecord();
+        const previousHash = last?.hash ?? null;
+        const xml = (0, generator_js_1.generateInvoiceXml)(invoiceConNif, previousHash);
+        const fechaHoraHusoGenRegistro = (0, date_js_1.nowIsoWithOffset)();
+        const hash = (0, chain_js_1.computeRegistroAlta)({
+            idEmisorFactura: this.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,
+        });
+        const now = new Date().toISOString();
+        const record = {
+            id: `${invoice.id.serie ?? ''}${invoice.id.numero}`,
+            invoiceId: `${invoice.id.serie ?? ''}${invoice.id.numero}`,
+            emisorNif: this.nif,
+            xml,
+            hash,
+            previousHash,
+            qrPayload: (0, qr_js_1.buildQrPayload)(hash),
+            status: 'PENDING',
+            createdAt: now,
+            updatedAt: now,
+        };
+        await this.repository.saveRecord(record);
+        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(),
+        });
+        const status = result.status === 'OK' ? 'CONFIRMED' : 'REJECTED';
+        await this.repository.updateRecordStatus(record.id, status);
+        return { ...record, status };
+    }
+}
+exports.AccountabilityService = AccountabilityService;
+//# sourceMappingURL=accountability.js.map

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

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

package/dist/cjs/integration/index.d.ts

@@ -0,0 +1,5 @@
+export * from './repository.js';
+export * from './service.js';
+export * from './p12.js';
+export * from './accountability.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integration/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC"}

package/dist/cjs/integration/index.js

@@ -0,0 +1,21 @@
+"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);
+__exportStar(require("./p12.js"), exports);
+__exportStar(require("./accountability.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;AAC7B,2CAAyB;AACzB,sDAAoC"}

package/dist/cjs/integration/p12.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Un campo (bag) del `.p12`.
+ */
+export interface P12Bag {
+    /** Tipo del bag (certBag, keyBag, pkcs8ShroudedKeyBag, ...). */
+    type: string;
+    /** Contenido en formato PEM (si es un certificado o clave). */
+    pem?: string;
+    /** Valor en bruto (si no es PEM). */
+    value?: unknown;
+}
+/**
+ * Contenido completo de un `.p12`, con todos sus campos.
+ */
+export interface P12Content {
+    /** Todos los bags encontrados, en orden. */
+    bags: P12Bag[];
+    /** Certificados en PEM (conveniencia). */
+    certificates: string[];
+    /** Claves privadas en PEM (conveniencia). */
+    keys: string[];
+}
+/**
+ * Lee un certificado `.p12`/`.pfx` e itera todos sus campos (bags),
+ * devolviéndolos todos. La librería no interpreta qué campo es cada cosa:
+ * simplemente expone el contenido para que la aplicación lo use.
+ *
+ * @param buffer   Contenido del archivo `.p12`/`.pfx`.
+ * @param password Contraseña del `.p12`.
+ */
+export declare function readP12(buffer: Buffer, password: string): P12Content;
+/**
+ * Extrae el NIF de un certificado en PEM.
+ *
+ * El NIF suele aparecer en el `serialNumber` (p. ej. `IDCES-74654958V`) o como
+ * primer token del `commonName` (p. ej. `74654958V ANTONIO JOSE RECHE`).
+ * Devuelve `null` si no se puede determinar.
+ */
+export declare function extractNifFromCertificate(pem: string): string | null;
+/**
+ * Información de un certificado en PEM: NIF y nombre/razón del titular.
+ */
+export interface CertificateInfo {
+    /** NIF del titular del certificado. */
+    nif: string;
+    /** Nombre o razón social del titular. */
+    nombreRazon: string;
+}
+/**
+ * Extrae el NIF y el nombre/razón del titular de un certificado en PEM.
+ *
+ * El NIF se obtiene del `serialNumber` (p. ej. `IDCES-74654958V`) o del primer
+ * token del `commonName`. El nombre se compone de `givenName` + `surname`, o
+ * del `commonName` sin el prefijo de NIF. Devuelve `null` si no se puede
+ * determinar el NIF.
+ */
+export declare function extractCertificateInfo(pem: string): CertificateInfo | null;
+//# sourceMappingURL=p12.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"p12.d.ts","sourceRoot":"","sources":["../../../src/integration/p12.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,0CAA0C;IAC1C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CA6BpE;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuBpE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAuC1E"}

package/dist/cjs/integration/p12.js

@@ -0,0 +1,127 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readP12 = readP12;
+exports.extractNifFromCertificate = extractNifFromCertificate;
+exports.extractCertificateInfo = extractCertificateInfo;
+const node_forge_1 = __importDefault(require("node-forge"));
+/**
+ * Lee un certificado `.p12`/`.pfx` e itera todos sus campos (bags),
+ * devolviéndolos todos. La librería no interpreta qué campo es cada cosa:
+ * simplemente expone el contenido para que la aplicación lo use.
+ *
+ * @param buffer   Contenido del archivo `.p12`/`.pfx`.
+ * @param password Contraseña del `.p12`.
+ */
+function readP12(buffer, password) {
+    const asn1 = node_forge_1.default.asn1.fromDer(node_forge_1.default.util.createBuffer(new Uint8Array(buffer)));
+    const p12 = node_forge_1.default.pkcs12.pkcs12FromAsn1(asn1, password);
+    const bags = [];
+    const certificates = [];
+    const keys = [];
+    p12.safeContents.forEach((safe) => {
+        safe.safeBags.forEach((bag) => {
+            const type = bag.type ?? 'unknown';
+            let pem;
+            let value;
+            if (bag.cert) {
+                pem = node_forge_1.default.pki.certificateToPem(bag.cert);
+                certificates.push(pem);
+            }
+            else if (bag.key) {
+                pem = node_forge_1.default.pki.privateKeyToPem(bag.key);
+                keys.push(pem);
+            }
+            else {
+                value = bag.attributes;
+            }
+            bags.push({ type, pem, value });
+        });
+    });
+    return { bags, certificates, keys };
+}
+/**
+ * Extrae el NIF de un certificado en PEM.
+ *
+ * El NIF suele aparecer en el `serialNumber` (p. ej. `IDCES-74654958V`) o como
+ * primer token del `commonName` (p. ej. `74654958V ANTONIO JOSE RECHE`).
+ * Devuelve `null` si no se puede determinar.
+ */
+function extractNifFromCertificate(pem) {
+    try {
+        const cert = node_forge_1.default.pki.certificateFromPem(pem);
+        const attrs = cert.subject.attributes;
+        // serialNumber: "IDCES-74654958V" o directamente "B12345678"
+        const serial = attrs.find((a) => a.name === 'serialNumber')?.value;
+        if (serial) {
+            const m = String(serial).match(/IDCES-(\S+)/i) ?? String(serial).match(/^([A-Z0-9]{8,9})/i);
+            if (m && m[1])
+                return m[1];
+        }
+        // commonName: "74654958V ANTONIO JOSE RECHE (R: B18579458)"
+        const cn = attrs.find((a) => a.name === 'commonName')?.value;
+        if (cn) {
+            const m = String(cn).match(/^([A-Z0-9]{8,9})/i);
+            if (m && m[1])
+                return m[1];
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Extrae el NIF y el nombre/razón del titular de un certificado en PEM.
+ *
+ * El NIF se obtiene del `serialNumber` (p. ej. `IDCES-74654958V`) o del primer
+ * token del `commonName`. El nombre se compone de `givenName` + `surname`, o
+ * del `commonName` sin el prefijo de NIF. Devuelve `null` si no se puede
+ * determinar el NIF.
+ */
+function extractCertificateInfo(pem) {
+    try {
+        const cert = node_forge_1.default.pki.certificateFromPem(pem);
+        const attrs = cert.subject.attributes;
+        // NIF
+        const serial = attrs.find((a) => a.name === 'serialNumber')?.value;
+        let nif = null;
+        if (serial) {
+            const m = String(serial).match(/IDCES-(\S+)/i) ?? String(serial).match(/^([A-Z0-9]{8,9})/i);
+            if (m && m[1])
+                nif = m[1];
+        }
+        if (!nif) {
+            const cn = attrs.find((a) => a.name === 'commonName')?.value;
+            if (cn) {
+                const m = String(cn).match(/^([A-Z0-9]{8,9})/i);
+                if (m && m[1])
+                    nif = m[1];
+            }
+        }
+        if (!nif)
+            return null;
+        // Nombre: givenName + surname, o commonName sin el NIF.
+        const given = attrs.find((a) => a.name === 'givenName')?.value;
+        const surname = attrs.find((a) => a.name === 'surname')?.value;
+        let nombreRazon = '';
+        if (given)
+            nombreRazon += given;
+        if (surname)
+            nombreRazon += (nombreRazon ? ' ' : '') + surname;
+        nombreRazon = nombreRazon.trim();
+        if (!nombreRazon) {
+            const cn = attrs.find((a) => a.name === 'commonName')?.value;
+            if (cn) {
+                nombreRazon = String(cn).replace(/^[A-Z0-9]{8,9}\s*/, '').split(' (R:')[0]?.trim() ?? '';
+            }
+        }
+        return { nif, nombreRazon };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=p12.js.map

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

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

package/dist/{integration → cjs/integration}/repository.d.ts

@@ -11,6 +11,8 @@ export interface StoredRecord {
     id: string;
     /** Referencia a la factura (serie + número). */
     invoiceId: string;
+    /** NIF del emisor de la factura. */
+    emisorNif: string;
     /** XML Verifactu generado. */
     xml: string;
     /** Hash del propio registro (huella). */

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,oCAAoC;IACpC,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/{integration → cjs/integration}/service.d.ts

@@ -1,4 +1,5 @@
 import type { Invoice } from '../core/models/invoice.js';
+import { type EventoInput } from '../core/xml/generator.js';
 import type { VerifactuClient } from '../aeat/client.js';
 import type { VerifactuRepository, StoredRecord } from './repository.js';
 /**
@@ -11,7 +12,8 @@ import type { VerifactuRepository, StoredRecord } from './repository.js';
 export declare class VerifactuService {
     private readonly repository;
     private readonly client;
-    constructor(repository: VerifactuRepository, client: VerifactuClient);
+    private readonly certificatePem?;
+    constructor(repository: VerifactuRepository, client: VerifactuClient, certificatePem?: string | undefined);
     /**
      * Registra una factura: genera el XML, calcula el hash encadenado, guarda
      * el registro y lo envía a AEAT, persistiendo la respuesta.
@@ -23,7 +25,7 @@ export declare class VerifactuService {
      * Genera un registro de anulación que referencia la factura anulada,
      * lo envía a AEAT y marca la factura original como ANNULLED.
      */
-    annulInvoice(invoiceId: string): Promise<StoredRecord>;
+    annulInvoice(invoiceId: string, invoice?: Invoice): Promise<StoredRecord>;
     /**
      * Modifica una factura previamente registrada.
      *
@@ -32,5 +34,12 @@ export declare class VerifactuService {
      * envía la referencia a la factura original y la factura corregida.
      */
     modifyInvoice(invoiceId: string, correctedInvoice: Invoice): Promise<StoredRecord>;
+    /**
+     * Registra un evento (RegistroEvento) ante AEAT.
+     *
+     * Genera el XML del evento, calcula su huella encadenada con el último
+     * registro, persiste el evento y lo envía a AEAT.
+     */
+    registerEvent(evento: EventoInput): Promise<StoredRecord>;
 }
 //# sourceMappingURL=service.d.ts.map

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;AACzD,OAAO,EAAqG,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAM/J,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAQzE;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAFf,UAAU,EAAE,mBAAmB,EAC/B,MAAM,EAAE,eAAe,EACvB,cAAc,CAAC,EAAE,MAAM,YAAA;IAG1C;;;OAGG;IACG,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;IAiE9D;;;;;OAKG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;IA8E/E;;;;;;OAMG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;IAQxF;;;;;OAKG;IACG,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;CAoDhE"}