@fin.cx/einvoice 5.0.2

package/dist_ts/formats/utils/format.detector.js

@@ -0,0 +1,249 @@
+import { InvoiceFormat } from '../../interfaces/common.js';
+import { DOMParser, xpath } from '../../plugins.js';
+import { CII_PROFILE_IDS, ZUGFERD_V1_NAMESPACES } from '../cii/cii.types.js';
+/**
+ * Utility class for detecting invoice formats
+ */
+export class FormatDetector {
+    /**
+     * Detects the format of an XML document
+     * @param xml XML content to analyze
+     * @returns Detected invoice format
+     */
+    static detectFormat(xml) {
+        try {
+            // Quick check for empty or invalid XML
+            if (!xml || typeof xml !== 'string' || xml.trim().length === 0) {
+                return InvoiceFormat.UNKNOWN;
+            }
+            // Quick string-based pre-checks for performance
+            const quickCheck = FormatDetector.quickFormatCheck(xml);
+            if (quickCheck !== InvoiceFormat.UNKNOWN) {
+                return quickCheck;
+            }
+            // More thorough parsing-based checks
+            const doc = new DOMParser().parseFromString(xml, 'application/xml');
+            const root = doc.documentElement;
+            if (!root) {
+                return InvoiceFormat.UNKNOWN;
+            }
+            // UBL detection (Invoice or CreditNote root element)
+            if (FormatDetector.isUBLFormat(root)) {
+                // Check for XRechnung customization
+                if (FormatDetector.isXRechnungFormat(doc)) {
+                    return InvoiceFormat.XRECHNUNG;
+                }
+                return InvoiceFormat.UBL;
+            }
+            // Factur-X/ZUGFeRD detection (CrossIndustryInvoice root element)
+            if (FormatDetector.isCIIFormat(root)) {
+                return FormatDetector.detectCIIFormat(doc, xml);
+            }
+            // ZUGFeRD v1 detection (CrossIndustryDocument root element)
+            if (FormatDetector.isZUGFeRDV1Format(root)) {
+                return InvoiceFormat.ZUGFERD;
+            }
+            // FatturaPA detection
+            if (FormatDetector.isFatturaPAFormat(root)) {
+                return InvoiceFormat.FATTURAPA;
+            }
+            return InvoiceFormat.UNKNOWN;
+        }
+        catch (error) {
+            console.error('Error detecting format:', error);
+            return InvoiceFormat.UNKNOWN;
+        }
+    }
+    /**
+     * Performs a quick format check based on string content
+     * This is faster than full XML parsing for obvious cases
+     * @param xml XML string
+     * @returns Detected format or UNKNOWN if more analysis is needed
+     */
+    static quickFormatCheck(xml) {
+        const lowerXml = xml.toLowerCase();
+        // Check for obvious Factur-X indicators
+        if (lowerXml.includes('factur-x.eu') ||
+            lowerXml.includes('factur-x.xml') ||
+            lowerXml.includes('factur-x:') ||
+            lowerXml.includes('urn:cen.eu:en16931:2017') && lowerXml.includes('factur-x')) {
+            return InvoiceFormat.FACTURX;
+        }
+        // Check for obvious ZUGFeRD indicators
+        if (lowerXml.includes('zugferd:') ||
+            lowerXml.includes('zugferd-invoice.xml') ||
+            lowerXml.includes('urn:ferd:') ||
+            lowerXml.includes('urn:zugferd')) {
+            return InvoiceFormat.ZUGFERD;
+        }
+        // Check for obvious XRechnung indicators
+        if (lowerXml.includes('xrechnung') ||
+            lowerXml.includes('urn:xoev-de:kosit:standard:xrechnung')) {
+            return InvoiceFormat.XRECHNUNG;
+        }
+        // Check for obvious FatturaPA indicators
+        if (lowerXml.includes('fatturapa') ||
+            lowerXml.includes('fattura elettronica') ||
+            lowerXml.includes('fatturaelettronica')) {
+            return InvoiceFormat.FATTURAPA;
+        }
+        // Need more analysis
+        return InvoiceFormat.UNKNOWN;
+    }
+    /**
+     * Checks if the document is a UBL format
+     * @param root Root element
+     * @returns True if it's a UBL format
+     */
+    static isUBLFormat(root) {
+        return (root.nodeName === 'Invoice' ||
+            root.nodeName === 'CreditNote' ||
+            root.nodeName === 'ubl:Invoice' ||
+            root.nodeName === 'ubl:CreditNote' ||
+            root.nodeName.endsWith(':Invoice') ||
+            root.nodeName.endsWith(':CreditNote'));
+    }
+    /**
+     * Checks if the document is an XRechnung format
+     * @param doc XML document
+     * @returns True if it's an XRechnung format
+     */
+    static isXRechnungFormat(doc) {
+        try {
+            // Set up namespaces for XPath queries
+            const namespaces = {
+                'cbc': 'urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2',
+                'ubl': 'urn:oasis:names:specification:ubl:schema:xsd:Invoice-2'
+            };
+            // Create XPath selector with namespaces
+            const select = xpath.useNamespaces(namespaces);
+            // Use getElementsByTagName directly for more reliable results
+            const customizationNodes = doc.getElementsByTagName('cbc:CustomizationID');
+            // Check if any CustomizationID node contains "xrechnung"
+            for (let i = 0; i < customizationNodes.length; i++) {
+                const node = customizationNodes[i];
+                if (node.textContent && node.textContent.includes('xrechnung')) {
+                    return true;
+                }
+            }
+            return false;
+        }
+        catch (error) {
+            console.warn('Error checking for XRechnung format:', error);
+            // If direct DOM access fails, try a string-based approach
+            const xmlStr = new XMLSerializer().serializeToString(doc);
+            return xmlStr.includes('xrechnung') || xmlStr.includes('XRechnung');
+        }
+    }
+    /**
+     * Checks if the document is a CII format (Factur-X/ZUGFeRD v2+)
+     * @param root Root element
+     * @returns True if it's a CII format
+     */
+    static isCIIFormat(root) {
+        return (root.nodeName === 'rsm:CrossIndustryInvoice' ||
+            root.nodeName === 'CrossIndustryInvoice' ||
+            root.nodeName.endsWith(':CrossIndustryInvoice'));
+    }
+    /**
+     * Checks if the document is a ZUGFeRD v1 format
+     * @param root Root element
+     * @returns True if it's a ZUGFeRD v1 format
+     */
+    static isZUGFeRDV1Format(root) {
+        return (root.nodeName === 'rsm:CrossIndustryDocument' ||
+            root.nodeName === 'CrossIndustryDocument' ||
+            root.nodeName === 'ram:CrossIndustryDocument' ||
+            root.nodeName.endsWith(':CrossIndustryDocument'));
+    }
+    /**
+     * Checks if the document is a FatturaPA format
+     * @param root Root element
+     * @returns True if it's a FatturaPA format
+     */
+    static isFatturaPAFormat(root) {
+        return (root.nodeName === 'FatturaElettronica' ||
+            (root.getAttribute('xmlns') && root.getAttribute('xmlns').includes('fatturapa.gov.it')));
+    }
+    /**
+     * Detects the specific CII format (Factur-X vs ZUGFeRD)
+     * @param doc XML document
+     * @param xml Original XML string for fallback checks
+     * @returns Detected format
+     */
+    static detectCIIFormat(doc, xml) {
+        try {
+            // Use direct DOM traversal instead of XPath for more reliable behavior
+            const contextNodes = doc.getElementsByTagNameNS('urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100', 'ExchangedDocumentContext');
+            if (contextNodes.length === 0) {
+                // Try without namespace
+                const noNsContextNodes = doc.getElementsByTagName('ExchangedDocumentContext');
+                if (noNsContextNodes.length === 0) {
+                    // Fallback to string-based detection
+                    return FormatDetector.detectCIIFormatFromString(xml);
+                }
+            }
+            // Loop through all potential context nodes
+            const allContextNodes = [...Array.from(contextNodes), ...Array.from(doc.getElementsByTagName('ExchangedDocumentContext'))];
+            for (const contextNode of allContextNodes) {
+                // Find guideline parameter
+                const guidelineNodes = contextNode.getElementsByTagName('ram:GuidelineSpecifiedDocumentContextParameter');
+                if (guidelineNodes.length === 0) {
+                    continue;
+                }
+                for (const guidelineNode of Array.from(guidelineNodes)) {
+                    // Find ID element
+                    const idNodes = guidelineNode.getElementsByTagName('ram:ID');
+                    if (idNodes.length === 0) {
+                        continue;
+                    }
+                    for (const idNode of Array.from(idNodes)) {
+                        const profileText = idNode.textContent || '';
+                        // Check for ZUGFeRD profiles (v1 and v2)
+                        if (profileText.includes('zugferd') ||
+                            profileText.includes('urn:ferd:') ||
+                            profileText === CII_PROFILE_IDS.ZUGFERD_BASIC ||
+                            profileText === CII_PROFILE_IDS.ZUGFERD_COMFORT ||
+                            profileText === CII_PROFILE_IDS.ZUGFERD_EXTENDED ||
+                            profileText === CII_PROFILE_IDS.ZUGFERD_V1_BASIC ||
+                            profileText === CII_PROFILE_IDS.ZUGFERD_V1_COMFORT ||
+                            profileText === CII_PROFILE_IDS.ZUGFERD_V1_EXTENDED) {
+                            return InvoiceFormat.ZUGFERD;
+                        }
+                        // Check for Factur-X profiles
+                        if (profileText.includes('factur-x') ||
+                            profileText === CII_PROFILE_IDS.FACTURX_MINIMUM ||
+                            profileText === CII_PROFILE_IDS.FACTURX_BASIC ||
+                            profileText === CII_PROFILE_IDS.FACTURX_EN16931) {
+                            return InvoiceFormat.FACTURX;
+                        }
+                    }
+                }
+            }
+            // If we reach here, fall back to string checking
+            return FormatDetector.detectCIIFormatFromString(xml);
+        }
+        catch (error) {
+            console.warn('Error detecting CII format, falling back to generic CII:', error);
+            return FormatDetector.detectCIIFormatFromString(xml);
+        }
+    }
+    /**
+     * Fallback method to detect CII format from string content
+     * @param xml XML string
+     * @returns Detected format
+     */
+    static detectCIIFormatFromString(xml) {
+        // Check for Factur-X indicators
+        if (xml.includes('factur-x') || xml.includes('Factur-X')) {
+            return InvoiceFormat.FACTURX;
+        }
+        // Check for ZUGFeRD indicators
+        if (xml.includes('zugferd') || xml.includes('ZUGFeRD')) {
+            return InvoiceFormat.ZUGFERD;
+        }
+        // Generic CII if we can't determine more specifically
+        return InvoiceFormat.CII;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZm9ybWF0LmRldGVjdG9yLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvZm9ybWF0cy91dGlscy9mb3JtYXQuZGV0ZWN0b3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBQzNELE9BQU8sRUFBRSxTQUFTLEVBQUUsS0FBSyxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDcEQsT0FBTyxFQUFFLGVBQWUsRUFBRSxxQkFBcUIsRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBRTdFOztHQUVHO0FBQ0gsTUFBTSxPQUFPLGNBQWM7SUFDekI7Ozs7T0FJRztJQUNJLE1BQU0sQ0FBQyxZQUFZLENBQUMsR0FBVztRQUNwQyxJQUFJLENBQUM7WUFDSCx1Q0FBdUM7WUFDdkMsSUFBSSxDQUFDLEdBQUcsSUFBSSxPQUFPLEdBQUcsS0FBSyxRQUFRLElBQUksR0FBRyxDQUFDLElBQUksRUFBRSxDQUFDLE1BQU0sS0FBSyxDQUFDLEVBQUUsQ0FBQztnQkFDL0QsT0FBTyxhQUFhLENBQUMsT0FBTyxDQUFDO1lBQy9CLENBQUM7WUFFRCxnREFBZ0Q7WUFDaEQsTUFBTSxVQUFVLEdBQUcsY0FBYyxDQUFDLGdCQUFnQixDQUFDLEdBQUcsQ0FBQyxDQUFDO1lBQ3hELElBQUksVUFBVSxLQUFLLGFBQWEsQ0FBQyxPQUFPLEVBQUUsQ0FBQztnQkFDekMsT0FBTyxVQUFVLENBQUM7WUFDcEIsQ0FBQztZQUVELHFDQUFxQztZQUNyQyxNQUFNLEdBQUcsR0FBRyxJQUFJLFNBQVMsRUFBRSxDQUFDLGVBQWUsQ0FBQyxHQUFHLEVBQUUsaUJBQWlCLENBQUMsQ0FBQztZQUNwRSxNQUFNLElBQUksR0FBRyxHQUFHLENBQUMsZUFBZSxDQUFDO1lBRWpDLElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztnQkFDVixPQUFPLGFBQWEsQ0FBQyxPQUFPLENBQUM7WUFDL0IsQ0FBQztZQUVELHFEQUFx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

package/dist_ts/formats/validation/en16931.validator.d.ts

@@ -0,0 +1,23 @@
+/**
+ * EN16931 mandatory field validator
+ * Validates that invoices contain the minimum required fields per the EN16931 standard
+ */
+export declare class EN16931Validator {
+    /**
+     * Valid ISO 4217 currency codes (common subset)
+     */
+    private static readonly VALID_CURRENCIES;
+    /**
+     * Validates that an invoice object contains all mandatory EN16931 fields
+     * @param invoice The invoice object to validate
+     * @throws Error if mandatory fields are missing
+     */
+    static validateMandatoryFields(invoice: any): void;
+    /**
+     * Validates mandatory fields for a parsed XML structure
+     * @param doc The parsed XML document
+     * @param format The invoice format
+     * @throws Error if mandatory fields are missing in XML
+     */
+    static validateXmlMandatoryFields(doc: Document, format: string): void;
+}

package/dist_ts/formats/validation/en16931.validator.js

@@ -0,0 +1,119 @@
+/**
+ * EN16931 mandatory field validator
+ * Validates that invoices contain the minimum required fields per the EN16931 standard
+ */
+export class EN16931Validator {
+    /**
+     * Valid ISO 4217 currency codes (common subset)
+     */
+    static { this.VALID_CURRENCIES = [
+        'AED', 'AFN', 'ALL', 'AMD', 'ANG', 'AOA', 'ARS', 'AUD', 'AWG', 'AZN',
+        'BAM', 'BBD', 'BDT', 'BGN', 'BHD', 'BIF', 'BMD', 'BND', 'BOB', 'BRL',
+        'BSD', 'BTN', 'BWP', 'BYN', 'BZD', 'CAD', 'CDF', 'CHF', 'CLP', 'CNY',
+        'COP', 'CRC', 'CUC', 'CUP', 'CVE', 'CZK', 'DJF', 'DKK', 'DOP', 'DZD',
+        'EGP', 'ERN', 'ETB', 'EUR', 'FJD', 'FKP', 'GBP', 'GEL', 'GGP', 'GHS',
+        'GIP', 'GMD', 'GNF', 'GTQ', 'GYD', 'HKD', 'HNL', 'HRK', 'HTG', 'HUF',
+        'IDR', 'ILS', 'IMP', 'INR', 'IQD', 'IRR', 'ISK', 'JEP', 'JMD', 'JOD',
+        'JPY', 'KES', 'KGS', 'KHR', 'KMF', 'KPW', 'KRW', 'KWD', 'KYD', 'KZT',
+        'LAK', 'LBP', 'LKR', 'LRD', 'LSL', 'LYD', 'MAD', 'MDL', 'MGA', 'MKD',
+        'MMK', 'MNT', 'MOP', 'MRU', 'MUR', 'MVR', 'MWK', 'MXN', 'MYR', 'MZN',
+        'NAD', 'NGN', 'NIO', 'NOK', 'NPR', 'NZD', 'OMR', 'PAB', 'PEN', 'PGK',
+        'PHP', 'PKR', 'PLN', 'PYG', 'QAR', 'RON', 'RSD', 'RUB', 'RWF', 'SAR',
+        'SBD', 'SCR', 'SDG', 'SEK', 'SGD', 'SHP', 'SLL', 'SOS', 'SPL', 'SRD',
+        'STN', 'SYP', 'SZL', 'THB', 'TJS', 'TMT', 'TND', 'TOP', 'TRY', 'TTD',
+        'TVD', 'TWD', 'TZS', 'UAH', 'UGX', 'USD', 'UYU', 'UZS', 'VEF', 'VND',
+        'VUV', 'WST', 'XAF', 'XCD', 'XDR', 'XOF', 'XPF', 'YER', 'ZAR', 'ZMW',
+        'ZWD'
+    ]; }
+    /**
+     * Validates that an invoice object contains all mandatory EN16931 fields
+     * @param invoice The invoice object to validate
+     * @throws Error if mandatory fields are missing
+     */
+    static validateMandatoryFields(invoice) {
+        const errors = [];
+        // BR-01: Invoice number is mandatory
+        if (!invoice.id && !invoice.accountingDocId && !invoice.invoiceId) {
+            errors.push('BR-01: Invoice number is mandatory');
+        }
+        // BR-02: Invoice issue date is mandatory
+        if (!invoice.date && !invoice.issueDate) {
+            errors.push('BR-02: Invoice issue date is mandatory');
+        }
+        // BR-06: Seller name is mandatory
+        if (!invoice.from?.name) {
+            errors.push('BR-06: Seller name is mandatory');
+        }
+        // BR-07: Buyer name is mandatory  
+        if (!invoice.to?.name) {
+            errors.push('BR-07: Buyer name is mandatory');
+        }
+        // BR-16: Invoice line is mandatory (at least one)
+        if (!invoice.items || invoice.items.length === 0) {
+            errors.push('BR-16: At least one invoice line is mandatory');
+        }
+        // BR-03: Invoice type code is mandatory
+        if (!invoice.accountingDocType) {
+            errors.push('BR-03: Invoice type code is mandatory');
+        }
+        // BR-05: Invoice currency code is mandatory
+        if (!invoice.currency) {
+            errors.push('BR-05: Invoice currency code is mandatory');
+        }
+        else {
+            // Validate currency format
+            if (!this.VALID_CURRENCIES.includes(invoice.currency.toUpperCase())) {
+                errors.push(`Invalid currency code: ${invoice.currency}. Must be a valid ISO 4217 currency code`);
+            }
+        }
+        // BR-08: Seller postal address is mandatory
+        if (!invoice.from?.address?.city || !invoice.from?.address?.postalCode || (!invoice.from?.address?.countryCode && !invoice.from?.address?.country)) {
+            errors.push('BR-08: Seller postal address (city, postal code, country) is mandatory');
+        }
+        // BR-10: Buyer postal address is mandatory
+        if (!invoice.to?.address?.city || !invoice.to?.address?.postalCode || (!invoice.to?.address?.countryCode && !invoice.to?.address?.country)) {
+            errors.push('BR-10: Buyer postal address (city, postal code, country) is mandatory');
+        }
+        if (errors.length > 0) {
+            throw new Error(`EN16931 validation failed:\n${errors.join('\n')}`);
+        }
+    }
+    /**
+     * Validates mandatory fields for a parsed XML structure
+     * @param doc The parsed XML document
+     * @param format The invoice format
+     * @throws Error if mandatory fields are missing in XML
+     */
+    static validateXmlMandatoryFields(doc, format) {
+        const errors = [];
+        if (format === 'ubl' || format === 'xrechnung') {
+            // Check for UBL mandatory fields
+            const id = doc.getElementsByTagName('cbc:ID')[0]?.textContent;
+            if (!id) {
+                errors.push('BR-01: Invoice ID is missing in XML');
+            }
+            const issueDate = doc.getElementsByTagName('cbc:IssueDate')[0]?.textContent;
+            if (!issueDate) {
+                errors.push('BR-02: Invoice issue date is missing in XML');
+            }
+            const sellerName = doc.querySelector('AccountingSupplierParty PartyName Name')?.textContent ||
+                doc.querySelector('AccountingSupplierParty PartyLegalEntity RegistrationName')?.textContent;
+            if (!sellerName) {
+                errors.push('BR-06: Seller name is missing in XML');
+            }
+            const buyerName = doc.querySelector('AccountingCustomerParty PartyName Name')?.textContent ||
+                doc.querySelector('AccountingCustomerParty PartyLegalEntity RegistrationName')?.textContent;
+            if (!buyerName) {
+                errors.push('BR-07: Buyer name is missing in XML');
+            }
+            const invoiceLines = doc.getElementsByTagName('InvoiceLine');
+            if (invoiceLines.length === 0) {
+                errors.push('BR-16: No invoice lines found in XML');
+            }
+        }
+        if (errors.length > 0) {
+            throw new Error(`EN16931 XML validation failed:\n${errors.join('\n')}`);
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW4xNjkzMS52YWxpZGF0b3IuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9mb3JtYXRzL3ZhbGlkYXRpb24vZW4xNjkzMS52YWxpZGF0b3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7OztHQUdHO0FBQ0gsTUFBTSxPQUFPLGdCQUFnQjtJQUMzQjs7T0FFRzthQUNxQixxQkFBZ0IsR0FBRztRQUN6QyxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLO1FBQ3BFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUs7UUFDcEUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSztRQUNwRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLO1FBQ3BFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUs7UUFDcEUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSztRQUNwRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLO1FBQ3BFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUs7UUFDcEUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSztRQUNwRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLO1FBQ3BFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUs7UUFDcEUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSztRQUNwRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLO1FBQ3BFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUs7UUFDcEUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSztRQUNwRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLEtBQUssRUFBRSxLQUFLLEVB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

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

@@ -0,0 +1,18 @@
+import { BaseValidator } from './base.validator.js';
+/**
+ * Factory to create the appropriate validator based on the XML format
+ */
+export declare class ValidatorFactory {
+    /**
+     * Creates a validator for the specified XML content
+     * @param xml XML content to validate
+     * @returns Appropriate validator instance
+     */
+    static createValidator(xml: string): BaseValidator;
+    /**
+     * Detects the invoice format from XML content
+     * @param xml XML content to analyze
+     * @returns Detected invoice format
+     */
+    private static detectFormat;
+}

package/dist_ts/formats/validator.factory.js

@@ -0,0 +1,78 @@
+import { InvoiceFormat } from '../interfaces.js';
+import { BaseValidator } from './base.validator.js';
+import { FacturXValidator } from './facturx.validator.js';
+import { UBLValidator } from './ubl.validator.js';
+import { DOMParser } from 'xmldom';
+/**
+ * Factory to create the appropriate validator based on the XML format
+ */
+export class ValidatorFactory {
+    /**
+     * Creates a validator for the specified XML content
+     * @param xml XML content to validate
+     * @returns Appropriate validator instance
+     */
+    static createValidator(xml) {
+        const format = ValidatorFactory.detectFormat(xml);
+        switch (format) {
+            case InvoiceFormat.UBL:
+            case InvoiceFormat.XRECHNUNG:
+                return new UBLValidator(xml);
+            case InvoiceFormat.CII:
+            case InvoiceFormat.ZUGFERD:
+            case InvoiceFormat.FACTURX:
+                return new FacturXValidator(xml);
+            // FatturaPA and other formats would be implemented here
+            default:
+                throw new Error(`Unsupported invoice format: ${format}`);
+        }
+    }
+    /**
+     * Detects the invoice format from XML content
+     * @param xml XML content to analyze
+     * @returns Detected invoice format
+     */
+    static detectFormat(xml) {
+        try {
+            const doc = new DOMParser().parseFromString(xml, 'application/xml');
+            const root = doc.documentElement;
+            if (!root) {
+                return InvoiceFormat.UNKNOWN;
+            }
+            // UBL detection (Invoice or CreditNote root element)
+            if (root.nodeName === 'Invoice' || root.nodeName === 'CreditNote') {
+                // Check if it's XRechnung by looking at CustomizationID
+                const customizationNodes = root.getElementsByTagName('cbc:CustomizationID');
+                if (customizationNodes.length > 0) {
+                    const customizationId = customizationNodes[0].textContent || '';
+                    if (customizationId.includes('xrechnung') || customizationId.includes('XRechnung')) {
+                        return InvoiceFormat.XRECHNUNG;
+                    }
+                }
+                return InvoiceFormat.UBL;
+            }
+            // Factur-X/ZUGFeRD detection (CrossIndustryInvoice root element)
+            if (root.nodeName === 'rsm:CrossIndustryInvoice' || root.nodeName === 'CrossIndustryInvoice') {
+                // Check for profile to determine if it's Factur-X or ZUGFeRD
+                const profileNodes = root.getElementsByTagName('ram:ID');
+                for (let i = 0; i < profileNodes.length; i++) {
+                    const profileText = profileNodes[i].textContent || '';
+                    if (profileText.includes('factur-x') || profileText.includes('Factur-X')) {
+                        return InvoiceFormat.FACTURX;
+                    }
+                    if (profileText.includes('zugferd') || profileText.includes('ZUGFeRD')) {
+                        return InvoiceFormat.ZUGFERD;
+                    }
+                }
+                // If no specific profile found, default to CII
+                return InvoiceFormat.CII;
+            }
+            // FatturaPA detection would be implemented here
+            return InvoiceFormat.UNKNOWN;
+        }
+        catch (error) {
+            return InvoiceFormat.UNKNOWN;
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmFsaWRhdG9yLmZhY3RvcnkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9mb3JtYXRzL3ZhbGlkYXRvci5mYWN0b3J5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUVqRCxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDcEQsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFDMUQsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBQ2xELE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxRQUFRLENBQUM7QUFFbkM7O0dBRUc7QUFDSCxNQUFNLE9BQU8sZ0JBQWdCO0lBQzNCOzs7O09BSUc7SUFDSSxNQUFNLENBQUMsZUFBZSxDQUFDLEdBQVc7UUFDdkMsTUFBTSxNQUFNLEdBQUcsZ0JBQWdCLENBQUMsWUFBWSxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBRWxELFFBQVEsTUFBTSxFQUFFLENBQUM7WUFDZixLQUFLLGFBQWEsQ0FBQyxHQUFHLENBQUM7WUFDdkIsS0FBSyxhQUFhLENBQUMsU0FBUztnQkFDMUIsT0FBTyxJQUFJLFlBQVksQ0FBQyxHQUFHLENBQUMsQ0FBQztZQUUvQixLQUFLLGFBQWEsQ0FBQyxHQUFHLENBQUM7WUFDdkIsS0FBSyxhQUFhLENBQUMsT0FBTyxDQUFDO1lBQzNCLEtBQUssYUFBYSxDQUFDLE9BQU87Z0JBQ3hCLE9BQU8sSUFBSSxnQkFBZ0IsQ0FBQyxHQUFHLENBQUMsQ0FBQztZQUVuQyx3REFBd0Q7WUFFeEQ7Z0JBQ0UsTUFBTSxJQUFJLEtBQUssQ0FBQywrQkFBK0IsTUFBTSxFQUFFLENBQUMsQ0FBQztRQUM3RCxDQUFDO0lBQ0gsQ0FBQztJQUVEOzs7O09BSUc7SUFDSyxNQUFNLENBQUMsWUFBWSxDQUFDLEdBQVc7UUFDckMsSUFBSSxDQUFDO1lBQ0gsTUFBTSxHQUFHLEdBQUcsSUFBSSxTQUFTLEVBQUUsQ0FBQyxlQUFlLENBQUMsR0FBRyxFQUFFLGlCQUFpQixDQUFDLENBQUM7WUFDcEUsTUFBTSxJQUFJLEdBQUcsR0FBRyxDQUFDLGVBQWUsQ0FBQztZQUVqQyxJQUFJLENBQUMsSUFBSSxFQUFFLENBQUM7Z0JBQ1YsT0FBTyxhQUFhLENBQUMsT0FBTyxDQUFDO1lBQy9CLENBQUM7WUFFRCxxREFBcUQ7WUFDckQsSUFBSSxJQUFJLENBQUMsUUFBUSxLQUFLLFNBQVMsSUFBSSxJQUFJLENBQUMsUUFBUSxLQUFLLFlBQVksRUFBRSxDQUFDO2dCQUNsRSx3REFBd0Q7Z0JBQ3hELE1BQU0sa0JBQWtCLEdBQUcsSUFBSSxDQUFDLG9CQUFvQixDQUFDLHFCQUFxQixDQUFDLENBQUM7Z0JBQzVFLElBQUksa0JBQWtCLENBQUMsTUFBTSxHQUFHLENBQUMsRUFBRSxDQUFDO29CQUNsQyxNQUFNLGVBQWUsR0FBRyxrQkFBa0IsQ0FBQyxDQUFDLENBQUMsQ0FBQyxXQUFXLElBQUksRUFBRSxDQUFDO29CQUNoRSxJQUFJLGVBQWUsQ0FBQyxRQUFRLENBQUMsV0FBVyxDQUFDLElBQUksZUFBZSxDQUFDLFFBQVEsQ0FBQyxXQUFXLENBQUMsRUFBRSxDQUFDO3dCQUNuRixPQUFPLGFBQWEsQ0FBQyxTQUFTLENBQUM7b0JBQ2pDLENBQUM7Z0JBQ0gsQ0FBQztnQkFFRCxPQUFPLGFBQWEsQ0FBQyxHQUFHLENBQUM7WUFDM0IsQ0FBQztZQUVELGlFQUFpRTtZQUNqRSxJQUFJLElBQUksQ0FBQyxRQUFRLEtBQUssMEJBQTBCLElBQUksSUFBSSxDQUFDLFFBQVEsS0FBSyxzQkFBc0IsRUFBRSxDQUFDO2dCQUM3Riw2REFBNkQ7Z0JBQzdELE1BQU0sWUFBWSxHQUFHLElBQUksQ0FBQyxvQkFBb0IsQ0FBQyxRQUFRLENBQUMsQ0FBQztnQkFDekQsS0FBSyxJQUFJLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxHQUFHLFlBQVksQ0FBQyxNQUFNLEVBQUUsQ0FBQyxFQUFFLEVBQUUsQ0FBQztvQkFDN0MsTUFBTSxXQUFXLEdBQUcsWUFBWSxDQUFDLENBQUMsQ0FBQyxDQUFDLFdBQVcsSUFBSSxFQUFFLENBQUM7b0JBRXRELElBQUksV0FBVyxDQUFDLFFBQVEsQ0FBQyxVQUFVLENBQUMsSUFBSSxXQUFXLENBQUMsUUFBUSxDQUFDLFVBQVUsQ0FBQyxFQUFFLENBQUM7d0JBQ3pFLE9BQU8sYUFBYSxDQUFDLE9BQU8sQ0FBQztvQkFDL0IsQ0FBQztvQkFFRCxJQUFJLFdBQVcsQ0FBQyxRQUFRLENBQUMsU0FBUyxDQUFDLElBQUksV0FBVyxDQUFDLFFBQVEsQ0FBQyxTQUFTLENBQUMsRUFBRSxDQUFDO3dCQUN2RSxPQUFPLGFBQWEsQ0FBQyxPQUFPLENBQUM7b0JBQy9CLENBQUM7Z0JBQ0gsQ0FBQztnQkFFRCwrQ0FBK0M7Z0JBQy9DLE9BQU8sYUFBYSxDQUFDLEdBQUcsQ0FBQztZQUMzQixDQUFDO1lBRUQsZ0RBQWdEO1lBRWhELE9BQU8sYUFBYSxDQUFDLE9BQU8sQ0FBQztRQUMvQixDQUFDO1FBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQztZQUNmLE9BQU8sYUFBYSxDQUFDLE9BQU8sQ0FBQztRQUMvQixDQUFDO0lBQ0gsQ0FBQztDQUNGIn0=

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

@@ -0,0 +1,28 @@
+import * as plugins from '../plugins.js';
+import { BaseDecoder } from './base.decoder.js';
+/**
+ * A decoder specifically for XInvoice/XRechnung format.
+ * XRechnung is the German implementation of the European standard EN16931
+ * for electronic invoices to the German public sector.
+ */
+export declare class XInvoiceDecoder extends BaseDecoder {
+    private xmlDoc;
+    private namespaces;
+    constructor(xmlString: string);
+    /**
+     * Set up namespaces from the document
+     */
+    private setupNamespaces;
+    /**
+     * Extract element text by tag name with namespace awareness
+     */
+    private getElementText;
+    /**
+     * Converts XInvoice/XRechnung XML to a structured letter object
+     */
+    getLetterData(): Promise<plugins.tsclass.business.ILetter>;
+    /**
+     * Extracts invoice items from XInvoice document
+     */
+    private extractInvoiceItems;
+}