@fin.cx/einvoice 5.0.2

package/dist_ts/formats/ubl/ubl.decoder.d.ts

@@ -0,0 +1,61 @@
+import { BaseDecoder } from '../base/base.decoder.js';
+import type { TInvoice, TCreditNote, TDebitNote } from '../../interfaces/common.js';
+import { UBLDocumentType } from './ubl.types.js';
+import { xpath } from '../../plugins.js';
+/**
+ * Base decoder for UBL-based invoice formats
+ */
+export declare abstract class UBLBaseDecoder extends BaseDecoder {
+    protected doc: Document;
+    protected namespaces: Record<string, string>;
+    protected select: xpath.XPathSelect;
+    constructor(xml: string, skipValidation?: boolean);
+    /**
+     * Decodes UBL XML into a TInvoice object
+     * @returns Promise resolving to a TInvoice object
+     */
+    decode(): Promise<TInvoice>;
+    /**
+     * Gets the UBL document type
+     * @returns UBL document type
+     */
+    protected getDocumentType(): UBLDocumentType;
+    /**
+     * Decodes a UBL credit note
+     * @returns Promise resolving to a TCreditNote object
+     */
+    protected abstract decodeCreditNote(): Promise<TCreditNote>;
+    /**
+     * Decodes a UBL debit note (invoice)
+     * @returns Promise resolving to a TDebitNote object
+     */
+    protected abstract decodeDebitNote(): Promise<TDebitNote>;
+    /**
+     * Gets a text value from an XPath expression
+     * @param xpath XPath expression
+     * @param context Optional context node
+     * @returns Text value or empty string if not found
+     */
+    protected getText(xpathExpr: string, context?: Node): string;
+    /**
+     * Gets a number value from an XPath expression
+     * @param xpath XPath expression
+     * @param context Optional context node
+     * @returns Number value or 0 if not found or not a number
+     */
+    protected getNumber(xpathExpr: string, context?: Node): number;
+    /**
+     * Gets a date value from an XPath expression
+     * @param xpath XPath expression
+     * @param context Optional context node
+     * @returns Date timestamp or current time if not found or invalid
+     */
+    protected getDate(xpathExpr: string, context?: Node): number;
+    /**
+     * Checks if a node exists
+     * @param xpath XPath expression
+     * @param context Optional context node
+     * @returns True if node exists
+     */
+    protected exists(xpathExpr: string, context?: Node): boolean;
+}

package/dist_ts/formats/ubl/ubl.decoder.js

@@ -0,0 +1,95 @@
+import { BaseDecoder } from '../base/base.decoder.js';
+import { UBLDocumentType, UBL_NAMESPACES } from './ubl.types.js';
+import { DOMParser, xpath } from '../../plugins.js';
+/**
+ * Base decoder for UBL-based invoice formats
+ */
+export class UBLBaseDecoder extends BaseDecoder {
+    constructor(xml, skipValidation = false) {
+        super(xml, skipValidation);
+        // Parse XML document
+        this.doc = new DOMParser().parseFromString(xml, 'application/xml');
+        // Set up namespaces for XPath queries
+        this.namespaces = {
+            cbc: UBL_NAMESPACES.CBC,
+            cac: UBL_NAMESPACES.CAC
+        };
+        // Create XPath selector with namespaces
+        this.select = xpath.useNamespaces(this.namespaces);
+    }
+    /**
+     * Decodes UBL XML into a TInvoice object
+     * @returns Promise resolving to a TInvoice object
+     */
+    async decode() {
+        // Determine document type
+        const documentType = this.getDocumentType();
+        if (documentType === UBLDocumentType.CREDIT_NOTE) {
+            return this.decodeCreditNote();
+        }
+        else {
+            return this.decodeDebitNote();
+        }
+    }
+    /**
+     * Gets the UBL document type
+     * @returns UBL document type
+     */
+    getDocumentType() {
+        const rootName = this.doc.documentElement.nodeName;
+        if (rootName === UBLDocumentType.CREDIT_NOTE) {
+            return UBLDocumentType.CREDIT_NOTE;
+        }
+        else {
+            return UBLDocumentType.INVOICE;
+        }
+    }
+    /**
+     * Gets a text value from an XPath expression
+     * @param xpath XPath expression
+     * @param context Optional context node
+     * @returns Text value or empty string if not found
+     */
+    getText(xpathExpr, context) {
+        const node = this.select(xpathExpr, context || this.doc)[0];
+        return node ? (node.textContent || '') : '';
+    }
+    /**
+     * Gets a number value from an XPath expression
+     * @param xpath XPath expression
+     * @param context Optional context node
+     * @returns Number value or 0 if not found or not a number
+     */
+    getNumber(xpathExpr, context) {
+        const text = this.getText(xpathExpr, context);
+        const num = parseFloat(text);
+        return isNaN(num) ? 0 : num;
+    }
+    /**
+     * Gets a date value from an XPath expression
+     * @param xpath XPath expression
+     * @param context Optional context node
+     * @returns Date timestamp or current time if not found or invalid
+     */
+    getDate(xpathExpr, context) {
+        const text = this.getText(xpathExpr, context);
+        if (!text)
+            return Date.now();
+        const date = new Date(text);
+        return isNaN(date.getTime()) ? Date.now() : date.getTime();
+    }
+    /**
+     * Checks if a node exists
+     * @param xpath XPath expression
+     * @param context Optional context node
+     * @returns True if node exists
+     */
+    exists(xpathExpr, context) {
+        const nodes = this.select(xpathExpr, context || this.doc);
+        if (Array.isArray(nodes)) {
+            return nodes.length > 0;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidWJsLmRlY29kZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9mb3JtYXRzL3VibC91YmwuZGVjb2Rlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFFdEQsT0FBTyxFQUFFLGVBQWUsRUFBRSxjQUFjLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUNqRSxPQUFPLEVBQUUsU0FBUyxFQUFFLEtBQUssRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRXBEOztHQUVHO0FBQ0gsTUFBTSxPQUFnQixjQUFlLFNBQVEsV0FBVztJQUt0RCxZQUFZLEdBQVcsRUFBRSxpQkFBMEIsS0FBSztRQUN0RCxLQUFLLENBQUMsR0FBRyxFQUFFLGNBQWMsQ0FBQyxDQUFDO1FBRTNCLHFCQUFxQjtRQUNyQixJQUFJLENBQUMsR0FBRyxHQUFHLElBQUksU0FBUyxFQUFFLENBQUMsZUFBZSxDQUFDLEdBQUcsRUFBRSxpQkFBaUIsQ0FBQyxDQUFDO1FBRW5FLHNDQUFzQztRQUN0QyxJQUFJLENBQUMsVUFBVSxHQUFHO1lBQ2hCLEdBQUcsRUFBRSxjQUFjLENBQUMsR0FBRztZQUN2QixHQUFHLEVBQUUsY0FBYyxDQUFDLEdBQUc7U0FDeEIsQ0FBQztRQUVGLHdDQUF3QztRQUN4QyxJQUFJLENBQUMsTUFBTSxHQUFHLEtBQUssQ0FBQyxhQUFhLENBQUMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxDQUFDO0lBQ3JELENBQUM7SUFFRDs7O09BR0c7SUFDSSxLQUFLLENBQUMsTUFBTTtRQUNqQiwwQkFBMEI7UUFDMUIsTUFBTSxZQUFZLEdBQUcsSUFBSSxDQUFDLGVBQWUsRUFBRSxDQUFDO1FBRTVDLElBQUksWUFBWSxLQUFLLGVBQWUsQ0FBQyxXQUFXLEVBQUUsQ0FBQztZQUNqRCxPQUFPLElBQUksQ0FBQyxnQkFBZ0IsRUFBeUIsQ0FBQztRQUN4RCxDQUFDO2FBQU0sQ0FBQztZQUNOLE9BQU8sSUFBSSxDQUFDLGVBQWUsRUFBeUIsQ0FBQztRQUN2RCxDQUFDO0lBQ0gsQ0FBQztJQUVEOzs7T0FHRztJQUNPLGVBQWU7UUFDdkIsTUFBTSxRQUFRLEdBQUcsSUFBSSxDQUFDLEdBQUcsQ0FBQyxlQUFlLENBQUMsUUFBUSxDQUFDO1FBRW5ELElBQUksUUFBUSxLQUFLLGVBQWUsQ0FBQyxXQUFXLEVBQUUsQ0FBQztZQUM3QyxPQUFPLGVBQWUsQ0FBQyxXQUFXLENBQUM7UUFDckMsQ0FBQzthQUFNLENBQUM7WUFDTixPQUFPLGVBQWUsQ0FBQyxPQUFPLENBQUM7UUFDakMsQ0FBQztJQUNILENBQUM7SUFjRDs7Ozs7T0FLRztJQUNPLE9BQU8sQ0FBQyxTQUFpQixFQUFFLE9BQWM7UUFDakQsTUFBTSxJQUFJLEdBQUcsSUFBSSxDQUFDLE1BQU0sQ0FBQyxTQUFTLEVBQUUsT0FBTyxJQUFJLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztRQUM1RCxPQUFPLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsV0FBVyxJQUFJLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7SUFDOUMsQ0FBQztJQUVEOzs7OztPQUtHO0lBQ08sU0FBUyxDQUFDLFNBQWlCLEVBQUUsT0FBYztRQUNuRCxNQUFNLElBQUksR0FBRyxJQUFJLENBQUMsT0FBTyxDQUFDLFNBQVMsRUFBRSxPQUFPLENBQUMsQ0FBQztRQUM5QyxNQUFNLEdBQUcsR0FBRyxVQUFVLENBQUMsSUFBSSxDQUFDLENBQUM7UUFDN0IsT0FBTyxLQUFLLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDO0lBQzlCLENBQUM7SUFFRDs7Ozs7T0FLRztJQUNPLE9BQU8sQ0FBQyxTQUFpQixFQUFFLE9BQWM7UUFDakQsTUFBTSxJQUFJLEdBQUcsSUFBSSxDQUFDLE9BQU8sQ0FBQyxTQUFTLEVBQUUsT0FBTyxDQUFDLENBQUM7UUFDOUMsSUFBSSxDQUFDLElBQUk7WUFBRSxPQUFPLElBQUksQ0FBQyxHQUFHLEVBQUUsQ0FBQztRQUU3QixNQUFNLElBQUksR0FBRyxJQUFJLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUM1QixPQUFPLEtBQUssQ0FBQyxJQUFJLENBQUMsT0FBTyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsT0FBTyxFQUFFLENBQUM7SUFDN0QsQ0FBQztJQUVEOzs7OztPQUtHO0lBQ08sTUFBTSxDQUFDLFNBQWlCLEVBQUUsT0FBYztRQUNoRCxNQUFNLEtBQUssR0FBRyxJQUFJLENBQUMsTUFBTSxDQUFDLFNBQVMsRUFBRSxPQUFPLElBQUksSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQzFELElBQUksS0FBSyxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDO1lBQ3pCLE9BQU8sS0FBSyxDQUFDLE1BQU0sR0FBRyxDQUFDLENBQUM7UUFDMUIsQ0FBQztRQUNELE9BQU8sS0FBSyxDQUFDO0lBQ2YsQ0FBQztDQUNGIn0=

package/dist_ts/formats/ubl/ubl.encoder.d.ts

@@ -0,0 +1,38 @@
+import { BaseEncoder } from '../base/base.encoder.js';
+import type { TInvoice, TCreditNote, TDebitNote } from '../../interfaces/common.js';
+import { UBLDocumentType } from './ubl.types.js';
+/**
+ * Base encoder for UBL-based invoice formats
+ */
+export declare abstract class UBLBaseEncoder extends BaseEncoder {
+    /**
+     * Encodes a TInvoice object into UBL XML
+     * @param invoice TInvoice object to encode
+     * @returns UBL XML string
+     */
+    encode(invoice: TInvoice): Promise<string>;
+    /**
+     * Encodes a TCreditNote object into UBL XML
+     * @param creditNote TCreditNote object to encode
+     * @returns UBL XML string
+     */
+    protected abstract encodeCreditNote(creditNote: TCreditNote): Promise<string>;
+    /**
+     * Encodes a TDebitNote object into UBL XML
+     * @param debitNote TDebitNote object to encode
+     * @returns UBL XML string
+     */
+    protected abstract encodeDebitNote(debitNote: TDebitNote): Promise<string>;
+    /**
+     * Creates the XML declaration and root element
+     * @param documentType UBL document type
+     * @returns XML string with declaration and root element
+     */
+    protected createXmlRoot(documentType: UBLDocumentType): string;
+    /**
+     * Formats a date as an ISO string (YYYY-MM-DD)
+     * @param timestamp Timestamp to format
+     * @returns Formatted date string
+     */
+    protected formatDate(timestamp: number): string;
+}

package/dist_ts/formats/ubl/ubl.encoder.js

@@ -0,0 +1,46 @@
+import { BaseEncoder } from '../base/base.encoder.js';
+import { UBLDocumentType, UBL_NAMESPACES } from './ubl.types.js';
+/**
+ * Base encoder for UBL-based invoice formats
+ */
+export class UBLBaseEncoder extends BaseEncoder {
+    /**
+     * Encodes a TInvoice object into UBL XML
+     * @param invoice TInvoice object to encode
+     * @returns UBL XML string
+     */
+    async encode(invoice) {
+        // TInvoice is always an invoice, treat it as debit note for encoding
+        return this.encodeDebitNote(invoice);
+    }
+    /**
+     * Creates the XML declaration and root element
+     * @param documentType UBL document type
+     * @returns XML string with declaration and root element
+     */
+    createXmlRoot(documentType) {
+        return `<?xml version="1.0" encoding="UTF-8"?>
+<${documentType} xmlns="urn:oasis:names:specification:ubl:schema:xsd:${documentType}-2"
+  xmlns:cac="${UBL_NAMESPACES.CAC}"
+  xmlns:cbc="${UBL_NAMESPACES.CBC}">
+</${documentType}>`;
+    }
+    /**
+     * Formats a date as an ISO string (YYYY-MM-DD)
+     * @param timestamp Timestamp to format
+     * @returns Formatted date string
+     */
+    formatDate(timestamp) {
+        // Ensure timestamp is valid
+        if (!timestamp || isNaN(timestamp)) {
+            timestamp = Date.now();
+        }
+        const date = new Date(timestamp);
+        // Check if date is valid
+        if (isNaN(date.getTime())) {
+            return new Date().toISOString().split('T')[0];
+        }
+        return date.toISOString().split('T')[0];
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidWJsLmVuY29kZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9mb3JtYXRzL3VibC91YmwuZW5jb2Rlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFFdEQsT0FBTyxFQUFFLGVBQWUsRUFBRSxjQUFjLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUVqRTs7R0FFRztBQUNILE1BQU0sT0FBZ0IsY0FBZSxTQUFRLFdBQVc7SUFDdEQ7Ozs7T0FJRztJQUNJLEtBQUssQ0FBQyxNQUFNLENBQUMsT0FBaUI7UUFDbkMscUVBQXFFO1FBQ3JFLE9BQU8sSUFBSSxDQUFDLGVBQWUsQ0FBQyxPQUFnQyxDQUFDLENBQUM7SUFDaEUsQ0FBQztJQWdCRDs7OztPQUlHO0lBQ08sYUFBYSxDQUFDLFlBQTZCO1FBQ25ELE9BQU87R0FDUixZQUFZLHdEQUF3RCxZQUFZO2VBQ3BFLGNBQWMsQ0FBQyxHQUFHO2VBQ2xCLGNBQWMsQ0FBQyxHQUFHO0lBQzdCLFlBQVksR0FBRyxDQUFDO0lBQ2xCLENBQUM7SUFFRDs7OztPQUlHO0lBQ08sVUFBVSxDQUFDLFNBQWlCO1FBQ3BDLDRCQUE0QjtRQUM1QixJQUFJLENBQUMsU0FBUyxJQUFJLEtBQUssQ0FBQyxTQUFTLENBQUMsRUFBRSxDQUFDO1lBQ25DLFNBQVMsR0FBRyxJQUFJLENBQUMsR0FBRyxFQUFFLENBQUM7UUFDekIsQ0FBQztRQUNELE1BQU0sSUFBSSxHQUFHLElBQUksSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFDO1FBQ2pDLHlCQUF5QjtRQUN6QixJQUFJLEtBQUssQ0FBQyxJQUFJLENBQUMsT0FBTyxFQUFFLENBQUMsRUFBRSxDQUFDO1lBQzFCLE9BQU8sSUFBSSxJQUFJLEVBQUUsQ0FBQyxXQUFXLEVBQUUsQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUM7UUFDaEQsQ0FBQztRQUNELE9BQU8sSUFBSSxDQUFDLFdBQVcsRUFBRSxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUMxQyxDQUFDO0NBQ0YifQ==

package/dist_ts/formats/ubl/ubl.types.d.ts

@@ -0,0 +1,16 @@
+/**
+ * UBL-specific types and constants
+ */
+export declare const UBL_NAMESPACES: {
+    CBC: string;
+    CAC: string;
+    UBL: string;
+};
+export declare enum UBLDocumentType {
+    INVOICE = "Invoice",
+    CREDIT_NOTE = "CreditNote"
+}
+export declare const UBL_CUSTOMIZATION_IDS: {
+    XRECHNUNG: string;
+    PEPPOL_BIS: string;
+};

package/dist_ts/formats/ubl/ubl.types.js

@@ -0,0 +1,21 @@
+/**
+ * UBL-specific types and constants
+ */
+// UBL namespaces
+export const UBL_NAMESPACES = {
+    CBC: 'urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2',
+    CAC: 'urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2',
+    UBL: 'urn:oasis:names:specification:ubl:schema:xsd:Invoice-2'
+};
+// UBL document types
+export var UBLDocumentType;
+(function (UBLDocumentType) {
+    UBLDocumentType["INVOICE"] = "Invoice";
+    UBLDocumentType["CREDIT_NOTE"] = "CreditNote";
+})(UBLDocumentType || (UBLDocumentType = {}));
+// UBL customization IDs for different formats
+export const UBL_CUSTOMIZATION_IDS = {
+    XRECHNUNG: 'urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_2.0',
+    PEPPOL_BIS: 'urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0'
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidWJsLnR5cGVzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvZm9ybWF0cy91YmwvdWJsLnR5cGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBRUgsaUJBQWlCO0FBQ2pCLE1BQU0sQ0FBQyxNQUFNLGNBQWMsR0FBRztJQUM1QixHQUFHLEVBQUUsc0VBQXNFO0lBQzNFLEdBQUcsRUFBRSwwRUFBMEU7SUFDL0UsR0FBRyxFQUFFLHdEQUF3RDtDQUM5RCxDQUFDO0FBRUYscUJBQXFCO0FBQ3JCLE1BQU0sQ0FBTixJQUFZLGVBR1g7QUFIRCxXQUFZLGVBQWU7SUFDekIsc0NBQW1CLENBQUE7SUFDbkIsNkNBQTBCLENBQUE7QUFDNUIsQ0FBQyxFQUhXLGVBQWUsS0FBZixlQUFlLFFBRzFCO0FBRUQsOENBQThDO0FBQzlDLE1BQU0sQ0FBQyxNQUFNLHFCQUFxQixHQUFHO0lBQ25DLFNBQVMsRUFBRSw0RUFBNEU7SUFDdkYsVUFBVSxFQUFFLDRFQUE0RTtDQUN6RixDQUFDIn0=

package/dist_ts/formats/ubl/ubl.validator.d.ts

@@ -0,0 +1,50 @@
+import { BaseValidator } from '../base/base.validator.js';
+import { ValidationLevel } from '../../interfaces/common.js';
+import type { ValidationResult } from '../../interfaces/common.js';
+import { xpath } from '../../plugins.js';
+/**
+ * Base validator for UBL-based invoice formats
+ */
+export declare abstract class UBLBaseValidator extends BaseValidator {
+    protected doc: Document;
+    protected namespaces: Record<string, string>;
+    protected select: xpath.XPathSelect;
+    constructor(xml: string);
+    /**
+     * Validates UBL XML against the specified level of validation
+     * @param level Validation level
+     * @returns Result of validation
+     */
+    validate(level?: ValidationLevel): ValidationResult;
+    /**
+     * Validates UBL XML against schema
+     * @returns True if schema validation passed
+     */
+    protected validateSchema(): boolean;
+    /**
+     * Validates structure of the UBL XML document
+     * @returns True if structure validation passed
+     */
+    protected abstract validateStructure(): boolean;
+    /**
+     * Gets a text value from an XPath expression
+     * @param xpath XPath expression
+     * @param context Optional context node
+     * @returns Text value or empty string if not found
+     */
+    protected getText(xpathExpr: string, context?: Node): string;
+    /**
+     * Gets a number value from an XPath expression
+     * @param xpath XPath expression
+     * @param context Optional context node
+     * @returns Number value or 0 if not found or not a number
+     */
+    protected getNumber(xpathExpr: string, context?: Node): number;
+    /**
+     * Checks if a node exists
+     * @param xpath XPath expression
+     * @param context Optional context node
+     * @returns True if node exists
+     */
+    protected exists(xpathExpr: string, context?: Node): boolean;
+}

package/dist_ts/formats/ubl/ubl.validator.js

@@ -0,0 +1,112 @@
+import { BaseValidator } from '../base/base.validator.js';
+import { ValidationLevel } from '../../interfaces/common.js';
+import { UBLDocumentType } from './ubl.types.js';
+import { DOMParser, xpath } from '../../plugins.js';
+/**
+ * Base validator for UBL-based invoice formats
+ */
+export class UBLBaseValidator extends BaseValidator {
+    constructor(xml) {
+        super(xml);
+        try {
+            // Parse XML document
+            this.doc = new DOMParser().parseFromString(xml, 'application/xml');
+            // Set up namespaces for XPath queries
+            this.namespaces = {
+                cbc: 'urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2',
+                cac: 'urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2'
+            };
+            // Create XPath selector with namespaces
+            this.select = xpath.useNamespaces(this.namespaces);
+        }
+        catch (error) {
+            this.addError('UBL-PARSE', `Failed to parse XML: ${error}`, '/');
+        }
+    }
+    /**
+     * Validates UBL XML against the specified level of validation
+     * @param level Validation level
+     * @returns Result of validation
+     */
+    validate(level = ValidationLevel.SYNTAX) {
+        // Reset errors
+        this.errors = [];
+        // Check if document was parsed successfully
+        if (!this.doc) {
+            return {
+                valid: false,
+                errors: this.errors,
+                level: level
+            };
+        }
+        // Perform validation based on level
+        let valid = true;
+        if (level === ValidationLevel.SYNTAX) {
+            valid = this.validateSchema();
+        }
+        else if (level === ValidationLevel.SEMANTIC) {
+            valid = this.validateSchema() && this.validateStructure();
+        }
+        else if (level === ValidationLevel.BUSINESS) {
+            valid = this.validateSchema() &&
+                this.validateStructure() &&
+                this.validateBusinessRules();
+        }
+        return {
+            valid,
+            errors: this.errors,
+            level
+        };
+    }
+    /**
+     * Validates UBL XML against schema
+     * @returns True if schema validation passed
+     */
+    validateSchema() {
+        // Basic schema validation (simplified for now)
+        if (!this.doc)
+            return false;
+        // Check for root element
+        const root = this.doc.documentElement;
+        if (!root || (root.nodeName !== UBLDocumentType.INVOICE && root.nodeName !== UBLDocumentType.CREDIT_NOTE)) {
+            this.addError('UBL-SCHEMA-1', `Root element must be ${UBLDocumentType.INVOICE} or ${UBLDocumentType.CREDIT_NOTE}`, '/');
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Gets a text value from an XPath expression
+     * @param xpath XPath expression
+     * @param context Optional context node
+     * @returns Text value or empty string if not found
+     */
+    getText(xpathExpr, context) {
+        const node = this.select(xpathExpr, context || this.doc)[0];
+        return node ? (node.textContent || '') : '';
+    }
+    /**
+     * Gets a number value from an XPath expression
+     * @param xpath XPath expression
+     * @param context Optional context node
+     * @returns Number value or 0 if not found or not a number
+     */
+    getNumber(xpathExpr, context) {
+        const text = this.getText(xpathExpr, context);
+        const num = parseFloat(text);
+        return isNaN(num) ? 0 : num;
+    }
+    /**
+     * Checks if a node exists
+     * @param xpath XPath expression
+     * @param context Optional context node
+     * @returns True if node exists
+     */
+    exists(xpathExpr, context) {
+        const nodes = this.select(xpathExpr, context || this.doc);
+        if (Array.isArray(nodes)) {
+            return nodes.length > 0;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidWJsLnZhbGlkYXRvci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzL2Zvcm1hdHMvdWJsL3VibC52YWxpZGF0b3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQzFELE9BQU8sRUFBRSxlQUFlLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUU3RCxPQUFPLEVBQUUsZUFBZSxFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFDakQsT0FBTyxFQUFFLFNBQVMsRUFBRSxLQUFLLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUVwRDs7R0FFRztBQUNILE1BQU0sT0FBZ0IsZ0JBQWlCLFNBQVEsYUFBYTtJQUsxRCxZQUFZLEdBQVc7UUFDckIsS0FBSyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBRVgsSUFBSSxDQUFDO1lBQ0gscUJBQXFCO1lBQ3JCLElBQUksQ0FBQyxHQUFHLEdBQUcsSUFBSSxTQUFTLEVBQUUsQ0FBQyxlQUFlLENBQUMsR0FBRyxFQUFFLGlCQUFpQixDQUFDLENBQUM7WUFFbkUsc0NBQXNDO1lBQ3RDLElBQUksQ0FBQyxVQUFVLEdBQUc7Z0JBQ2hCLEdBQUcsRUFBRSxzRUFBc0U7Z0JBQzNFLEdBQUcsRUFBRSwwRUFBMEU7YUFDaEYsQ0FBQztZQUVGLHdDQUF3QztZQUN4QyxJQUFJLENBQUMsTUFBTSxHQUFHLEtBQUssQ0FBQyxhQUFhLENBQUMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxDQUFDO1FBQ3JELENBQUM7UUFBQyxPQUFPLEtBQUssRUFBRSxDQUFDO1lBQ2YsSUFBSSxDQUFDLFFBQVEsQ0FBQyxXQUFXLEVBQUUsd0JBQXdCLEtBQUssRUFBRSxFQUFFLEdBQUcsQ0FBQyxDQUFDO1FBQ25FLENBQUM7SUFDSCxDQUFDO0lBRUQ7Ozs7T0FJRztJQUNJLFFBQVEsQ0FBQyxRQUF5QixlQUFlLENBQUMsTUFBTTtRQUM3RCxlQUFlO1FBQ2YsSUFBSSxDQUFD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

package/dist_ts/formats/ubl/xrechnung/xrechnung.decoder.d.ts

@@ -0,0 +1,34 @@
+import { UBLBaseDecoder } from '../ubl.decoder.js';
+import type { TCreditNote, TDebitNote } from '../../../interfaces/common.js';
+/**
+ * Decoder for XRechnung (UBL) format
+ * Implements decoding of XRechnung invoices to TInvoice
+ */
+export declare class XRechnungDecoder extends UBLBaseDecoder {
+    /**
+     * Decodes a UBL credit note
+     * @returns Promise resolving to a TCreditNote object
+     */
+    protected decodeCreditNote(): Promise<TCreditNote>;
+    /**
+     * Decodes a UBL debit note (invoice)
+     * @returns Promise resolving to a TDebitNote object
+     */
+    protected decodeDebitNote(): Promise<TDebitNote>;
+    /**
+     * Extracts common invoice data from XRechnung XML
+     * @returns Common invoice data
+     */
+    private extractCommonData;
+    /**
+     * Extracts party information from XML
+     * @param partyPath XPath to the party element
+     * @returns TContact object
+     */
+    private extractParty;
+    /**
+     * Creates an empty TContact object
+     * @returns Empty TContact object
+     */
+    private createEmptyContact;
+}