@dwast/verifactu-lib 0.1.0-beta.0

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

@@ -0,0 +1,87 @@
+/**
+ * Cliente de servicios AEAT para Verifactu.
+ */
+export class VerifactuClient {
+    config;
+    constructor(config) {
+        this.config = {
+            sendPath: '/verifactu/registro',
+            statusPath: '/verifactu/estado',
+            timeoutMs: 10_000,
+            ...config,
+        };
+    }
+    /**
+     * Envía un registro (factura o evento) a AEAT.
+     */
+    async sendRecord(xml) {
+        const url = `${this.config.baseUrl}${this.config.sendPath}`;
+        const headers = {
+            'Content-Type': 'application/xml',
+            Accept: 'application/json',
+        };
+        if (this.config.authToken) {
+            headers.Authorization = `Bearer ${this.config.authToken}`;
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.config.timeoutMs);
+        try {
+            const res = await fetch(url, {
+                method: 'POST',
+                headers,
+                body: xml,
+                signal: controller.signal,
+            });
+            const raw = await res.text();
+            return this.parseResponse(raw, res.status);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /**
+     * Consulta el estado de una operación enviada.
+     */
+    async getOperationStatus(operationId) {
+        const url = `${this.config.baseUrl}${this.config.statusPath}/${encodeURIComponent(operationId)}`;
+        const headers = { Accept: 'application/json' };
+        if (this.config.authToken) {
+            headers.Authorization = `Bearer ${this.config.authToken}`;
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.config.timeoutMs);
+        try {
+            const res = await fetch(url, { method: 'GET', headers, signal: controller.signal });
+            const raw = await res.text();
+            return this.parseResponse(raw, res.status);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /**
+     * Parsea la respuesta de AEAT. La estructura exacta depende del servicio;
+     * este es un mapeo base que el consumidor puede sobrescribir.
+     */
+    parseResponse(raw, httpStatus) {
+        let operationId = '';
+        let status = httpStatus >= 200 && httpStatus < 300 ? 'OK' : 'ERROR';
+        let message;
+        let errorCode;
+        try {
+            const json = JSON.parse(raw);
+            operationId = String(json.operationId ?? json.id ?? '');
+            if (json.status === 'OK' || json.status === 'ERROR') {
+                status = json.status;
+            }
+            message = json.message;
+            errorCode = json.errorCode;
+        }
+        catch {
+            // Respuesta no JSON: se conserva el cuerpo como mensaje.
+            message = raw;
+        }
+        return { operationId, status, message, errorCode, rawResponse: raw };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/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/aeat/index.d.ts

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

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

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

package/dist/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/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/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/core/hash/chain.js

@@ -0,0 +1,115 @@
+import { createHash } from 'node:crypto';
+/**
+ * Calcula el hash SHA-256 de un dato en hexadecimal MAYÚSCULA.
+ * Verifactu exige el hash en hexadecimal en mayúsculas (64 caracteres).
+ */
+export function sha256(data) {
+    return createHash('sha256').update(data).digest('hex').toUpperCase();
+}
+/**
+ * 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 function concatenateFields(fields) {
+    return fields
+        .map(([name, value]) => {
+        const trimmed = value ? value.trim() : '';
+        return `${name}=${trimmed}`;
+    })
+        .join('&');
+}
+/**
+ * Construye la cadena canónica a hashear de un registro de alta.
+ */
+export function concatenateRegistroAlta(input) {
+    return concatenateFields([
+        ['IDEmisorFactura', input.idEmisorFactura],
+        ['NumSerieFactura', input.numSerieFactura],
+        ['FechaExpedicionFactura', input.fechaExpedicionFactura],
+        ['TipoFactura', input.tipoFactura],
+        ['CuotaTotal', input.cuotaTotal],
+        ['ImporteTotal', input.importeTotal],
+        ['Huella', input.huellaAnterior],
+        ['FechaHoraHusoGenRegistro', input.fechaHoraHusoGenRegistro],
+    ]);
+}
+/**
+ * Construye la cadena canónica a hashear de un registro de anulación.
+ */
+export function concatenateRegistroAnulacion(input) {
+    return concatenateFields([
+        ['IDEmisorFacturaAnulada', input.idEmisorFacturaAnulada],
+        ['NumSerieFacturaAnulada', input.numSerieFacturaAnulada],
+        ['FechaExpedicionFacturaAnulada', input.fechaExpedicionFacturaAnulada],
+        ['Huella', input.huellaAnterior],
+        ['FechaHoraHusoGenRegistro', input.fechaHoraHusoGenRegistro],
+    ]);
+}
+/**
+ * Calcula la huella (hash) de un registro de alta.
+ */
+export function computeRegistroAlta(input) {
+    return sha256(concatenateRegistroAlta(input));
+}
+/**
+ * Calcula la huella (hash) de un registro de anulación.
+ */
+export function computeRegistroAnulacion(input) {
+    return sha256(concatenateRegistroAnulacion(input));
+}
+/**
+ * Verifica que el hash de un registro de alta coincide con el esperado.
+ */
+export function verifyRegistroAlta(input, expectedHash) {
+    return computeRegistroAlta(input).toLowerCase() === expectedHash.toLowerCase();
+}
+/**
+ * Verifica que el hash de un registro de anulación coincide con el esperado.
+ */
+export function verifyRegistroAnulacion(input, expectedHash) {
+    return computeRegistroAnulacion(input).toLowerCase() === expectedHash.toLowerCase();
+}
+/**
+ * Cadena de hash con estado, para encadenar registros de forma secuencial.
+ */
+export class HashChain {
+    _lastHash = null;
+    _count = 0;
+    /** Hash del último registro encadenado, o `null` si aún no hay ninguno. */
+    get lastHash() {
+        return this._lastHash;
+    }
+    /** Número de registros encadenados hasta ahora. */
+    get count() {
+        return this._count;
+    }
+    /**
+     * Encadena un nuevo registro de alta y devuelve su huella.
+     */
+    pushAlta(input) {
+        const hash = computeRegistroAlta({ ...input, huellaAnterior: this._lastHash });
+        this._lastHash = hash;
+        this._count += 1;
+        return hash;
+    }
+    /**
+     * Encadena un nuevo registro de anulación y devuelve su huella.
+     */
+    pushAnulacion(input) {
+        const hash = computeRegistroAnulacion({ ...input, huellaAnterior: this._lastHash });
+        this._lastHash = hash;
+        this._count += 1;
+        return hash;
+    }
+    /** Reinicia la cadena. */
+    reset() {
+        this._lastHash = null;
+        this._count = 0;
+    }
+}
+//# sourceMappingURL=chain.js.map

package/dist/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/core/hash/index.d.ts

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

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

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

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

@@ -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.js.map

package/dist/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/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/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/core/models/event.js

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

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

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

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

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

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

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

package/dist/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/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/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/core/models/invoice.js

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

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

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

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

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

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * 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 function buildQrPayload(hash, baseUrl = 'https://www2.agenciatributaria.gob.es/verifactu/verificar', extraParams = {}) {
+    const params = new URLSearchParams({ hash, ...extraParams });
+    return `${baseUrl}?${params.toString()}`;
+}
+//# sourceMappingURL=qr.js.map

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