feat(core): improve in-memory validation, FatturaPA detection coverage, and published type compatibility

ts/formats/ubl/ubl.decoder.ts

@@ -3,6 +3,13 @@ import type { TInvoice, TCreditNote, TDebitNote } from '../../interfaces/common.
 import { UBLDocumentType, UBL_NAMESPACES } from './ubl.types.js';
 import { DOMParser, xpath } from '../../plugins.js';
 
+const ublParser = new DOMParser();
+const ublNamespaces = {
+  cbc: UBL_NAMESPACES.CBC,
+  cac: UBL_NAMESPACES.CAC,
+};
+const ublSelect = xpath.useNamespaces(ublNamespaces);
+
 /**
  * Base decoder for UBL-based invoice formats
  */
@@ -15,16 +22,17 @@ export abstract class UBLBaseDecoder extends BaseDecoder {
     super(xml, skipValidation);
 
     // Parse XML document
-    this.doc = new DOMParser().parseFromString(xml, 'application/xml');
+      this.doc = ublParser.parseFromString(xml, 'application/xml');
 
-    // Set up namespaces for XPath queries
-    this.namespaces = {
-      cbc: UBL_NAMESPACES.CBC,
-      cac: UBL_NAMESPACES.CAC
-    };
+      // Set up namespaces for XPath queries
+      this.namespaces = ublNamespaces;
 
-    // Create XPath selector with namespaces
-    this.select = xpath.useNamespaces(this.namespaces);
+      // Create XPath selector with namespaces
+      this.select = ublSelect;
+  }
+
+  public override getParsedDocument(): Document {
+    return this.doc;
   }
 
   /**
@@ -75,7 +83,8 @@ export abstract class UBLBaseDecoder extends BaseDecoder {
    * @returns Text value or empty string if not found
    */
   protected getText(xpathExpr: string, context?: Node): string {
-    const node = this.select(xpathExpr, context || this.doc)[0];
+    const result = this.select(xpathExpr, context || this.doc);
+    const node = Array.isArray(result) ? result[0] : null;
     return node ? (node.textContent || '') : '';
   }