@dwast/verifactu-lib 0.1.0-beta.0

package/dist/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/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"}

package/dist/core/xml/generator.js

@@ -0,0 +1,103 @@
+/**
+ * Escapa caracteres especiales para XML.
+ */
+function escapeXml(value) {
+    return value
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+/**
+ * Formatea un número con 2 decimales (formato Verifactu).
+ */
+function formatAmount(value) {
+    return value.toFixed(2);
+}
+/**
+ * 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 function generateInvoiceXml(invoice, previousHash) {
+    const { id, emisor, desglose, tipoFactura, tipoDesglose } = invoice;
+    const detalles = desglose.tipoOperaciones
+        .map((op) => {
+        const iva = op.detallesIva
+            .map((d) => `      <DetalleIVA>` +
+            `<TipoImpositivo>${formatAmount(d.tipoImpositivo)}</TipoImpositivo>` +
+            `<BaseImponible>${formatAmount(d.baseImponible)}</BaseImponible>` +
+            `<CuotaRepercutida>${formatAmount(d.cuotaRepercutida)}</CuotaRepercutida>` +
+            `</DetalleIVA>`)
+            .join('\n');
+        return (`    <DesgloseTipoOperacion>` +
+            `<TipoOperacion>${escapeXml(op.tipoOperacion)}</TipoOperacion>` +
+            `\n      <DesgloseIVA>\n${iva}\n      </DesgloseIVA>` +
+            `\n    </DesgloseTipoOperacion>`);
+    })
+        .join('\n');
+    const xml = [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        '<RegistroFactura>',
+        '  <IDFactura>',
+        '    <IDEmisorFactura>',
+        `      <NIF>${escapeXml(emisor.nif)}</NIF>`,
+        `      <NombreRazon>${escapeXml(emisor.nombreRazon)}</NombreRazon>`,
+        emisor.pais ? `      <Pais>${escapeXml(emisor.pais)}</Pais>` : '',
+        emisor.codigoPostal ? `      <CodigoPostal>${escapeXml(emisor.codigoPostal)}</CodigoPostal>` : '',
+        emisor.municipio ? `      <Municipio>${escapeXml(emisor.municipio)}</Municipio>` : '',
+        emisor.direccion ? `      <Direccion>${escapeXml(emisor.direccion)}</Direccion>` : '',
+        '    </IDEmisorFactura>',
+        id.serie ? `    <SerieFactura>${escapeXml(id.serie)}</SerieFactura>` : '',
+        `    <NumeroFactura>${escapeXml(id.numero)}</NumeroFactura>`,
+        `    <FechaExpedicionFactura>${id.fechaExpedicion}</FechaExpedicionFactura>`,
+        id.fechaOperacion ? `    <FechaOperacion>${id.fechaOperacion}</FechaOperacion>` : '',
+        '  </IDFactura>',
+        `  <TipoFactura>${tipoFactura}</TipoFactura>`,
+        `  <TipoDesglose>${tipoDesglose}</TipoDesglose>`,
+        '  <Desglose>',
+        detalles,
+        '  </Desglose>',
+        `  <CuotaTotal>${formatAmount(desglose.cuotaTotal)}</CuotaTotal>`,
+        '  <Encadenamiento>',
+        `    <HashAnterior>${previousHash ?? ''}</HashAnterior>`,
+        '  </Encadenamiento>',
+        '</RegistroFactura>',
+    ]
+        .filter((line) => line !== '')
+        .join('\n');
+    return xml;
+}
+/**
+ * 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 function generateAnulacionXml(anulacion, previousHash) {
+    const xml = [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        '<RegistroFactura>',
+        '  <RegistroAnulacion>',
+        '    <IDFactura>',
+        '      <IDEmisorFactura>',
+        `        <NIF>${escapeXml(anulacion.idEmisorFacturaAnulada)}</NIF>`,
+        '      </IDEmisorFactura>',
+        `      <NumeroFactura>${escapeXml(anulacion.numSerieFacturaAnulada)}</NumeroFactura>`,
+        `      <FechaExpedicionFactura>${anulacion.fechaExpedicionFacturaAnulada}</FechaExpedicionFactura>`,
+        '    </IDFactura>',
+        `    <Huella>${anulacion.huellaFacturaAnulada}</Huella>`,
+        '  </RegistroAnulacion>',
+        '  <Encadenamiento>',
+        `    <HashAnterior>${previousHash ?? ''}</HashAnterior>`,
+        '  </Encadenamiento>',
+        '</RegistroFactura>',
+    ].join('\n');
+    return xml;
+}
+//# sourceMappingURL=generator.js.map

package/dist/core/xml/generator.js.map

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

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

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

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

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

package/dist/core/xml/index.js

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

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

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './core/index.js';
+export * from './aeat/index.js';
+export * from './integration/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/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/index.js

@@ -0,0 +1,4 @@
+export * from './core/index.js';
+export * from './aeat/index.js';
+export * from './integration/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/integration/index.d.ts

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

package/dist/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"}

package/dist/integration/index.js

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

package/dist/integration/index.js.map

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

package/dist/integration/repository.d.ts

@@ -0,0 +1,77 @@
+import type { Event } from '../core/models/event.js';
+/**
+ * Estado de un registro de facturación en el sistema consumidor.
+ */
+export type RecordStatus = 'PENDING' | 'SENT' | 'CONFIRMED' | 'REJECTED' | 'ANNULLED';
+/**
+ * Registro de facturación persistido en el sistema consumidor.
+ */
+export interface StoredRecord {
+    /** Identificador interno del registro. */
+    id: string;
+    /** Referencia a la factura (serie + número). */
+    invoiceId: string;
+    /** XML Verifactu generado. */
+    xml: string;
+    /** Hash del propio registro (huella). */
+    hash: string;
+    /** Hash del registro anterior en la cadena. */
+    previousHash: string | null;
+    /** Payload del QR Verifactu (URL de verificación con el hash). */
+    qrPayload?: string;
+    /** Estado del registro. */
+    status: RecordStatus;
+    /** Fecha/hora de creación. */
+    createdAt: string;
+    /** Fecha/hora de última actualización. */
+    updatedAt: string;
+}
+/**
+ * Respuesta de AEAT persistida en el sistema consumidor.
+ *
+ * La AEAT exige conservar la respuesta de cada envío para poder acreditar
+ * la remisión. El sistema consumidor DEBE guardar estas respuestas en una
+ * tabla (ver `schema.sql`).
+ */
+export interface StoredResponse {
+    /** Identificador interno de la respuesta. */
+    id: string;
+    /** Referencia al registro enviado. */
+    recordId: string;
+    /** Identificador de la operación devuelto por AEAT. */
+    operationId: string;
+    /** Estado devuelto por AEAT. */
+    status: 'OK' | 'ERROR';
+    /** Mensaje de AEAT. */
+    message?: string;
+    /** Código de error de AEAT (si lo hay). */
+    errorCode?: string;
+    /** Cuerpo completo de la respuesta (para auditoría). */
+    rawResponse?: string;
+    /** Fecha/hora de la respuesta. */
+    receivedAt: string;
+}
+/**
+ * Repositorio que el sistema consumidor DEBE implementar para persistir
+ * los registros y las respuestas de Verifactu.
+ *
+ * La librería no impone un ORM concreto (Mongoose, Prisma, etc.): define
+ * esta interfaz y el sistema consumidor la adapta a su stack MERN.
+ */
+export interface VerifactuRepository {
+    /** Guarda un registro de facturación. */
+    saveRecord(record: StoredRecord): Promise<void>;
+    /** Actualiza el estado de un registro. */
+    updateRecordStatus(id: string, status: RecordStatus): Promise<void>;
+    /** Obtiene un registro por su id. */
+    getRecord(id: string): Promise<StoredRecord | null>;
+    /** Obtiene el último registro (para conocer el hash anterior). */
+    getLastRecord(): Promise<StoredRecord | null>;
+    /** Guarda la respuesta de AEAT. */
+    saveResponse(response: StoredResponse): Promise<void>;
+    /** Obtiene las respuestas de un registro. */
+    getResponses(recordId: string): Promise<StoredResponse[]>;
+    /** Guarda un evento. */
+    saveEvent(event: Event): Promise<void>;
+}
+//# sourceMappingURL=repository.d.ts.map

package/dist/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/integration/repository.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=repository.js.map

package/dist/integration/repository.js.map

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

package/dist/integration/service.d.ts

@@ -0,0 +1,36 @@
+import type { Invoice } from '../core/models/invoice.js';
+import type { VerifactuClient } from '../aeat/client.js';
+import type { VerifactuRepository, StoredRecord } from './repository.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`).
+ */
+export declare class VerifactuService {
+    private readonly repository;
+    private readonly client;
+    constructor(repository: VerifactuRepository, client: VerifactuClient);
+    /**
+     * Registra una factura: genera el XML, calcula el hash encadenado, guarda
+     * el registro y lo envía a AEAT, persistiendo la respuesta.
+     */
+    registerInvoice(invoice: Invoice): Promise<StoredRecord>;
+    /**
+     * 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.
+     */
+    annulInvoice(invoiceId: string): Promise<StoredRecord>;
+    /**
+     * 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.
+     */
+    modifyInvoice(invoiceId: string, correctedInvoice: Invoice): Promise<StoredRecord>;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/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/integration/service.js

@@ -0,0 +1,140 @@
+import { generateInvoiceXml, generateAnulacionXml } from '../core/xml/generator.js';
+import { computeRegistroAlta, computeRegistroAnulacion } from '../core/hash/chain.js';
+import { buildQrPayload } from '../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`).
+ */
+export 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 = generateInvoiceXml(invoice, previousHash);
+        const hash = 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: 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 = generateAnulacionXml({
+            idEmisorFacturaAnulada: original.invoiceId,
+            numSerieFacturaAnulada: original.invoiceId,
+            fechaExpedicionFacturaAnulada: new Date().toISOString().slice(0, 10),
+            huellaFacturaAnulada: original.hash,
+        }, previousHash);
+        const hash = 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);
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/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/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@dwast/verifactu-lib",
+  "version": "0.1.0-beta.0",
+  "description": "Librería para la gestión de Verifactu (RD 1007/2023): modelo de datos, encadenado hash, generación XML, QR y cliente AEAT.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js"
+    },
+    "./aeat": {
+      "types": "./dist/aeat/index.d.ts",
+      "import": "./dist/aeat/index.js"
+    },
+    "./integration": {
+      "types": "./dist/integration/index.d.ts",
+      "import": "./dist/integration/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src test",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "verifactu",
+    "aeat",
+    "factura",
+    "facturacion",
+    "hash",
+    "qr"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  }
+}

package/readme.md

@@ -0,0 +1,89 @@
+# @dwast/verifactu-lib
+
+Librería privada (npm) para la gestión de **Verifactu** (Ley 18/2022 y RD 1007/2023) en un stack MERN (JS/TS).
+
+## ¿Qué resuelve?
+
+Verifactu no es solo "endpoints": el núcleo es la generación de facturas en formato XML con los campos obligatorios, el **encadenado hash** (SHA-256) que garantiza integridad e inmutabilidad, el **QR Verifactu** y el registro de eventos. La comunicación con AEAT es solo una parte.
+
+La librería se divide en tres capas:
+
+- **`core`** — Núcleo puro, sin dependencias de red ni de framework. Fácil de testear y de usar en cualquier parte del stack.
+- **`aeat`** — Cliente para los servicios de AEAT (depende de credenciales y entornos).
+- **`integration`** — Capa de orquestación que define los **requisitos del sistema consumidor** (persistencia de registros y respuestas en tablas) y une núcleo + AEAT.
+
+## Estructura
+
+```
+src/
+├── core/
+│   ├── models/     # Tipos: Invoice, Emisor, Desglose, Event, etc.
+│   ├── hash/       # Encadenado hash (SHA-256)
+│   ├── xml/        # Generación XML Verifactu (RegistroFactura)
+│   └── qr/         # Generación QR Verifactu
+├── aeat/           # Cliente de servicios AEAT
+├── integration/    # Repositorio, servicio de orquestación y schema.sql
+└── index.ts
+```
+
+## Requisitos del sistema consumidor
+
+La capa `integration` define qué debe aportar el sistema que use la librería:
+
+1. **Persistencia de registros y respuestas.** El sistema DEBE implementar la interfaz `VerifactuRepository` (ver `src/integration/repository.ts`) y disponer de las tablas de `src/integration/schema.sql` (`verifactu_records`, `verifactu_responses`, `verifactu_events`). La AEAT exige conservar la respuesta de cada envío para acreditar la remisión.
+2. **Cliente AEAT configurado.** El sistema DEBE proporcionar un `VerifactuClient` con las credenciales y el entorno adecuados.
+
+### Ejemplo de uso
+
+```ts
+import { VerifactuService } from '@dwast/verifactu-lib/integration';
+import { VerifactuClient } from '@dwast/verifactu-lib/aeat';
+import { MyMongoRepository } from './my-repo'; // implementa VerifactuRepository
+
+const repo = new MyMongoRepository();
+const client = new VerifactuClient({ baseUrl: 'https://...', authToken: '...' });
+const service = new VerifactuService(repo, client);
+
+await service.registerInvoice({
+  id: { serie: 'A', numero: '2025-001', fechaExpedicion: '2025-07-01' },
+  emisor: { nif: 'B12345678', nombreRazon: 'Empresa S.L.' },
+  tipoFactura: 'F1',
+  tipoDesglose: 'S1',
+  desglose: {
+    tipoOperaciones: [
+      { tipoOperacion: '01', detallesIva: [{ tipoImpositivo: 21, baseImponible: 100, cuotaRepercutida: 21 }] },
+    ],
+    cuotaTotal: 21,
+    importeTotal: 121,
+  },
+});
+```
+
+## Scripts
+
+```bash
+npm run build       # compila a dist/
+npm run typecheck   # typecheck sin emitir
+npm test            # ejecuta vitest
+```
+
+## Publicación
+
+Paquete privado (`"private": true`). Instálalo desde un registry privado (GitHub Packages, Verdaccio, GitLab Package Registry) o directamente desde el repo:
+
+```bash
+npm install git+https://github.com/tu-org/verifactu-lib.git
+```
+
+## Algoritmo de huella (hash)
+
+La huella de un registro Verifactu **no se calcula sobre el XML**, sino sobre una cadena canónica de campos concatenados en el formato `nombreCampo=valor&...`:
+
+- **Alta (8 campos):** `IDEmisorFactura`, `NumSerieFactura`, `FechaExpedicionFactura`, `TipoFactura`, `CuotaTotal`, `ImporteTotal`, `Huella` (hash anterior), `FechaHoraHusoGenRegistro`.
+- **Anulación (5 campos):** `IDEmisorFacturaAnulada`, `NumSerieFacturaAnulada`, `FechaExpedicionFacturaAnulada`, `Huella`, `FechaHoraHusoGenRegistro`.
+
+Reglas: se recortan espacios al inicio/final, los campos vacíos van como `nombreCampo=`, **no se aplica URL-encoding**, y el resultado es **SHA-256 en hexadecimal MAYÚSCULA** (64 caracteres). El hash anterior se coloca en el campo `Huella` en su posición exacta. La implementación está verificada contra los [vectores oficiales de la AEAT](https://www.agenciatributaria.es/static_files/AEAT_Desarrolladores/EEDD/IVA/VERI-FACTU/Veri-Factu_especificaciones_huella_hash_registros.pdf).
+
+## Nota sobre el esquema oficial
+
+El XML generado sigue la estructura del RD 1007/2023 y la documentación de la AEAT, pero **debe validarse contra el XSD oficial** (descargable desde el [portal de desarrolladores de la AEAT](https://www.agenciatributaria.es/AEAT.desarrolladores/Desarrolladores/_menu_/Documentacion/Sistemas_Informaticos_de_Facturacion_y_Sistemas_VERI_FACTU/Sistemas_Informaticos_de_Facturacion_y_Sistemas_VERI_FACTU.html)) antes de producción.