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

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

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

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

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

package/dist/esm/aeat/response.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../src/aeat/response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AA2E5C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,gBAAgB,EAAE,KAAK;IACvB,mBAAmB,EAAE,IAAI;IACzB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,KAAK;IACpB,UAAU,EAAE,IAAI;CACjB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,mEAAmE;IACnE,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAA+B,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4EAA4E;IAC5E,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,MAAM,CAA4B,CAAC;IAC3E,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAA4B,CAAC;IAEvE,mDAAmD;IACnD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAwC,CAAC;IAEtE,MAAM,MAAM,GAAiB;QAC3B,SAAS;QACT,IAAI,EAAE,CAAC,MAAM,IAAI,IAAI,CAA4B;KAClD,CAAC;IAEF,qCAAqC;IACrC,IAAI,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;SAAM,IAAI,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;SAAM,IAAI,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACrC,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,MAA2C;IAC9D,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,MAAM,CAA4B,CAAC;IAC5E,OAAO;QACL,cAAc,EAAE,GAAG,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC;QACzC,mBAAmB,EAAE,GAAG,CAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC;QACnD,wBAAwB,EAAE,GAAG,CAAC,EAAE,CAAC,0BAA0B,CAAC,CAAC;QAC7D,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QACnB,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;QACzB,wBAAwB,EAAE,GAAG,CAAC,EAAE,CAAC,0BAA0B,CAAC,CAAC;QAC7D,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,MAA2C;IAC9D,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,2FAA2F;IAC3F,uDAAuD;IACvD,MAAM,YAAY,GAChB,MAAM,CAAC,kDAAkD,CAAC;QAC1D,MAAM,CAAC,iBAAiB,CAAC;QACzB,MAAM,CAAC,WAAW,CAAC,CAAC;IACtB,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;QAC3C,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAA4B,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QAC5F,CAAC,CAAC,YAAY;YACZ,CAAC,CAAC,CAAC,mBAAmB,CAAC,YAAuC,CAAC,CAAC;YAChE,CAAC,CAAC,SAAS,CAAC;IAChB,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7B,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACvC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACjD,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM;QAC9B,SAAS,EAAE,SAA2C;KACvD,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,SAAS,mBAAmB,CAC1B,GAA4B;IAE5B,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,0BAA0B,CAAC,IAAI,GAAG,CAA4B,CAAC;IAClF,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAA4B,CAAC;IACxE,OAAO;QACL,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAC7C,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC5B,wBAAwB,EAAE,GAAG,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAChE,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,MAA2C;IAC5D,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,OAAO;QACL,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACzC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QACnD,sBAAsB,EAAE,GAAG,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;QAC7D,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;KAC9B,CAAC;AACJ,CAAC;AAED,SAAS,GAAG,CAAC,KAAc;IACzB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

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

@@ -73,6 +73,44 @@ export declare function verifyRegistroAlta(input: RegistroAltaInput, expectedHas
  * Verifica que el hash de un registro de anulación coincide con el esperado.
  */
 export declare function verifyRegistroAnulacion(input: RegistroAnulacionInput, expectedHash: string): boolean;
+/**
+ * Campos de un registro de evento (RegistroEvento).
+ *
+ * Nota: el nombre `NIF` aparece DOS veces (posiciones 1 y 6): una para el
+ * sistema informático y otra para el obligado a emitir.
+ */
+export interface RegistroEventoInput {
+    /** NIF del sistema informático (NIF, posición 1). */
+    nifSistemaInformatico: string;
+    /** Identificador del evento (ID). */
+    id: string;
+    /** Identificador del sistema informático. */
+    idSistemaInformatico: string;
+    /** Versión del sistema informático. */
+    version: string;
+    /** Número de instalación. */
+    numeroInstalacion: string;
+    /** NIF del obligado a emitir (NIF, posición 6). */
+    nifObligado: string;
+    /** Tipo de evento. */
+    tipoEvento: string;
+    /** Huella (hash) del registro anterior, o null para el primero. */
+    huellaAnterior: string | null;
+    /** Fecha/hora de generación con huso horario. */
+    fechaHoraHusoGenEvento: string;
+}
+/**
+ * Construye la cadena canónica a hashear de un registro de evento.
+ */
+export declare function concatenateRegistroEvento(input: RegistroEventoInput): string;
+/**
+ * Calcula la huella (hash) de un registro de evento.
+ */
+export declare function computeRegistroEvento(input: RegistroEventoInput): string;
+/**
+ * Verifica que el hash de un registro de evento coincide con el esperado.
+ */
+export declare function verifyRegistroEvento(input: RegistroEventoInput, expectedHash: string): boolean;
 /**
  * Cadena de hash con estado, para encadenar registros de forma secuencial.
  */
@@ -91,6 +129,10 @@ export declare class HashChain {
      * Encadena un nuevo registro de anulación y devuelve su huella.
      */
     pushAnulacion(input: Omit<RegistroAnulacionInput, 'huellaAnterior'>): string;
+    /**
+     * Encadena un nuevo registro de evento y devuelve su huella.
+     */
+    pushEvento(input: Omit<RegistroEventoInput, 'huellaAnterior'>): string;
     /** Reinicia la cadena. */
     reset(): void;
 }

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

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

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

@@ -74,6 +74,34 @@ export function verifyRegistroAlta(input, expectedHash) {
 export function verifyRegistroAnulacion(input, expectedHash) {
     return computeRegistroAnulacion(input).toLowerCase() === expectedHash.toLowerCase();
 }
+/**
+ * Construye la cadena canónica a hashear de un registro de evento.
+ */
+export function concatenateRegistroEvento(input) {
+    return concatenateFields([
+        ['NIF', input.nifSistemaInformatico],
+        ['ID', input.id],
+        ['IdSistemaInformatico', input.idSistemaInformatico],
+        ['Version', input.version],
+        ['NumeroInstalacion', input.numeroInstalacion],
+        ['NIF', input.nifObligado],
+        ['TipoEvento', input.tipoEvento],
+        ['HuellaEvento', input.huellaAnterior],
+        ['FechaHoraHusoGenEvento', input.fechaHoraHusoGenEvento],
+    ]);
+}
+/**
+ * Calcula la huella (hash) de un registro de evento.
+ */
+export function computeRegistroEvento(input) {
+    return sha256(concatenateRegistroEvento(input));
+}
+/**
+ * Verifica que el hash de un registro de evento coincide con el esperado.
+ */
+export function verifyRegistroEvento(input, expectedHash) {
+    return computeRegistroEvento(input).toLowerCase() === expectedHash.toLowerCase();
+}
 /**
  * Cadena de hash con estado, para encadenar registros de forma secuencial.
  */
@@ -106,6 +134,15 @@ export class HashChain {
         this._count += 1;
         return hash;
     }
+    /**
+     * Encadena un nuevo registro de evento y devuelve su huella.
+     */
+    pushEvento(input) {
+        const hash = computeRegistroEvento({ ...input, huellaAnterior: this._lastHash });
+        this._lastHash = hash;
+        this._count += 1;
+        return hash;
+    }
     /** Reinicia la cadena. */
     reset() {
         this._lastHash = null;

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

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

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

@@ -2,4 +2,6 @@ export * from './models/index.js';
 export * from './hash/index.js';
 export * from './xml/index.js';
 export * from './qr/index.js';
+export * from './validation/index.js';
+export * from './utils/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}

package/dist/esm/core/index.js

@@ -2,4 +2,6 @@ export * from './models/index.js';
 export * from './hash/index.js';
 export * from './xml/index.js';
 export * from './qr/index.js';
+export * from './validation/index.js';
+export * from './utils/index.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +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"}
+{"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;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}

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

@@ -38,36 +38,48 @@ export type TipoFactura = 'F1' | 'F2' | 'F3' | 'F4' | 'F5' | 'F6' | 'F7' | 'F8'
  */
 export type TipoDesglose = 'S1' | 'S2' | 'S3' | 'S4' | 'S5' | 'S6';
 /**
- * Detalle de IVA de una línea de desglose.
+ * Detalle de desglose de una línea (DetalleType del XSD de AEAT).
  */
-export interface DetalleIva {
+export interface DetalleDesglose {
+    /** Calificación de la operación (p. ej. '01'). */
+    calificacionOperacion: string;
+    /** Clave de régimen (obligatoria si Impuesto es IVA/IPSI/IGIC). */
+    claveRegimen?: string;
     /** Tipo impositivo (%). */
-    tipoImpositivo: number;
-    /** Base imponible. */
+    tipoImpositivo?: number;
+    /** Base imponible o importe no sujeto. */
     baseImponible: number;
     /** Cuota repercutida. */
-    cuotaRepercutida: number;
+    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.
+ * Desglose completo de la factura (DesgloseType del XSD de AEAT).
  */
 export interface Desglose {
-    /** Desglose por tipo de operación. */
-    tipoOperaciones: DesgloseTipoOperacion[];
+    /** Detalles de desglose (DetalleDesglose). */
+    detalles: DetalleDesglose[];
     /** Cuota total de la factura. */
     cuotaTotal: number;
     /** Importe total de la factura. */
     importeTotal: number;
 }
+/**
+ * Sistema informático que genera el registro (SistemaInformaticoType del XSD).
+ */
+export interface SistemaInformatico {
+    /** Nombre o razón social del titular. */
+    nombreRazon: string;
+    /** NIF del titular. */
+    nif: string;
+    /** Nombre del sistema informático. */
+    nombreSistemaInformatico: string;
+    /** Identificador del sistema informático. */
+    idSistemaInformatico: string;
+    /** Versión del sistema informático. */
+    version: string;
+    /** Número de instalación. */
+    numeroInstalacion: string;
+}
 /**
  * Factura en el modelo de datos Verifactu.
  */
@@ -84,6 +96,19 @@ export interface Invoice {
     tipoDesglose: TipoDesglose;
     /** Descripción de la operación. */
     descripcion?: string;
+    /** Destinatarios de la operación (obligatorio para F1/F3/R1-R4). */
+    destinatarios?: {
+        nombreRazon: string;
+        nif: string;
+    }[];
+    /** Sistema informático que genera el registro. */
+    sistemaInformatico: SistemaInformatico;
+    /** Fecha/hora de generación con huso horario (ISO 8601). */
+    fechaHoraHusoGenRegistro: string;
+    /** Huella (hash) del registro. */
+    huella: string;
+    /** Versión del esquema (por defecto '1.0'). */
+    idVersion?: string;
     /** Metadatos adicionales libres. */
     metadata?: Record<string, unknown>;
 }

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

@@ -1 +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"}
+{"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,eAAe;IAC9B,kDAAkD;IAClD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,8CAA8C;IAC9C,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,wBAAwB,EAAE,MAAM,CAAC;IACjC,6CAA6C;IAC7C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;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,oEAAoE;IACpE,aAAa,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvD,kDAAkD;IAClD,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,4DAA4D;IAC5D,wBAAwB,EAAE,MAAM,CAAC;IACjC,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/esm/core/utils/date.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Utilidades de fecha/hora para Verifactu.
+ *
+ * AEAT exige que `FechaHoraHusoGenRegistro` sea la fecha/hora actual del
+ * sistema con su huso horario (margen de 240 segundos). Este helper genera
+ * ese valor detectando automáticamente el offset de zona, sin asumir un
+ * huso fijo (p. ej. `+02:00`).
+ */
+/**
+ * Devuelve la fecha/hora actual en formato ISO 8601 con el offset de zona
+ * detectado automáticamente, p. ej. `2026-09-07T10:12:41+02:00`.
+ *
+ * @param date Fecha a formatear (por defecto, ahora).
+ */
+export declare function nowIsoWithOffset(date?: Date): string;
+//# sourceMappingURL=date.d.ts.map

package/dist/esm/core/utils/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../../../src/core/utils/date.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAShE"}

package/dist/esm/core/utils/date.js

@@ -0,0 +1,24 @@
+/**
+ * Utilidades de fecha/hora para Verifactu.
+ *
+ * AEAT exige que `FechaHoraHusoGenRegistro` sea la fecha/hora actual del
+ * sistema con su huso horario (margen de 240 segundos). Este helper genera
+ * ese valor detectando automáticamente el offset de zona, sin asumir un
+ * huso fijo (p. ej. `+02:00`).
+ */
+const pad = (n) => String(n).padStart(2, '0');
+/**
+ * Devuelve la fecha/hora actual en formato ISO 8601 con el offset de zona
+ * detectado automáticamente, p. ej. `2026-09-07T10:12:41+02:00`.
+ *
+ * @param date Fecha a formatear (por defecto, ahora).
+ */
+export function nowIsoWithOffset(date = new Date()) {
+    const off = -date.getTimezoneOffset();
+    const sign = off >= 0 ? '+' : '-';
+    const abs = Math.abs(off);
+    return (`${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}` +
+        `T${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}` +
+        `${sign}${pad(Math.floor(abs / 60))}:${pad(abs % 60)}`);
+}
+//# sourceMappingURL=date.js.map

package/dist/esm/core/utils/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../../../src/core/utils/date.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAa,IAAI,IAAI,EAAE;IACtD,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,CACL,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE;QAC1E,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE;QAC9E,GAAG,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,CACvD,CAAC;AACJ,CAAC"}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/esm/core/validation/validate.d.ts

@@ -0,0 +1,18 @@
+import type { Invoice } from '../models/invoice.js';
+/**
+ * Resultado de la validación de una factura.
+ */
+export interface ValidationResult {
+    /** `true` si la factura es válida. */
+    valid: boolean;
+    /** Lista de errores (campos obligatorios o con formato incorrecto). */
+    errors: string[];
+}
+/**
+ * Valida una factura antes de enviarla a AEAT.
+ *
+ * Comprueba los campos obligatorios y el formato de las fechas (el XSD
+ * `fecha` de AEAT usa `DD-MM-YYYY`). Devuelve `{ valid, errors }`.
+ */
+export declare function validateInvoice(invoice: Invoice): ValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/esm/core/validation/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../src/core/validation/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,uEAAuE;IACvE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,CAoDlE"}

package/dist/esm/core/validation/validate.js

@@ -0,0 +1,62 @@
+/**
+ * Valida una factura antes de enviarla a AEAT.
+ *
+ * Comprueba los campos obligatorios y el formato de las fechas (el XSD
+ * `fecha` de AEAT usa `DD-MM-YYYY`). Devuelve `{ valid, errors }`.
+ */
+export function validateInvoice(invoice) {
+    const errors = [];
+    // Identificación de la factura.
+    if (!invoice.id?.numero)
+        errors.push('id.numero es obligatorio');
+    if (!invoice.id?.fechaExpedicion) {
+        errors.push('id.fechaExpedicion es obligatorio');
+    }
+    else if (!/^\d{2}-\d{2}-\d{4}$/.test(invoice.id.fechaExpedicion)) {
+        errors.push('id.fechaExpedicion debe tener formato DD-MM-YYYY');
+    }
+    // Emisor.
+    if (!invoice.emisor?.nif)
+        errors.push('emisor.nif es obligatorio');
+    if (!invoice.emisor?.nombreRazon)
+        errors.push('emisor.nombreRazon es obligatorio');
+    // Tipo de factura.
+    if (!invoice.tipoFactura)
+        errors.push('tipoFactura es obligatorio');
+    // Desglose.
+    if (!invoice.desglose?.detalles?.length) {
+        errors.push('desglose.detalles debe tener al menos un detalle');
+    }
+    else {
+        invoice.desglose.detalles.forEach((d, i) => {
+            if (!d.calificacionOperacion)
+                errors.push(`desglose.detalles[${i}].calificacionOperacion es obligatorio`);
+            if (d.baseImponible === undefined || d.baseImponible === null) {
+                errors.push(`desglose.detalles[${i}].baseImponible es obligatorio`);
+            }
+            if (d.tipoImpositivo !== undefined && !d.claveRegimen) {
+                errors.push(`desglose.detalles[${i}].claveRegimen es obligatorio si hay tipoImpositivo`);
+            }
+        });
+    }
+    if (invoice.desglose?.cuotaTotal === undefined)
+        errors.push('desglose.cuotaTotal es obligatorio');
+    if (invoice.desglose?.importeTotal === undefined)
+        errors.push('desglose.importeTotal es obligatorio');
+    // Destinatarios obligatorios para F1/F3 (según AEAT).
+    if (['F1', 'F3'].includes(invoice.tipoFactura) && !invoice.destinatarios?.length) {
+        errors.push('destinatarios es obligatorio para tipoFactura F1/F3');
+    }
+    // Sistema informático.
+    if (!invoice.sistemaInformatico?.nif)
+        errors.push('sistemaInformatico.nif es obligatorio');
+    if (!invoice.sistemaInformatico?.idSistemaInformatico) {
+        errors.push('sistemaInformatico.idSistemaInformatico es obligatorio');
+    }
+    // Fecha/hora de generación.
+    if (!invoice.fechaHoraHusoGenRegistro) {
+        errors.push('fechaHoraHusoGenRegistro es obligatorio');
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=validate.js.map