@stackforge-eu/factur-x 0.1.0

package/dist/index.js

@@ -0,0 +1,1285 @@
+import * as path2 from 'path';
+import path2__default from 'path';
+import { fileURLToPath } from 'url';
+import * as fs from 'fs';
+import { AFRelationship, PDFDocument, PDFName, PDFDict, PDFStream, PDFRawStream, decodePDFRawStream, PDFArray, PDFRef, PDFString, PDFHexString } from 'pdf-lib';
+
+// node_modules/tsup/assets/esm_shims.js
+var getFilename = () => fileURLToPath(import.meta.url);
+var getDirname = () => path2__default.dirname(getFilename());
+var __dirname$1 = /* @__PURE__ */ getDirname();
+
+// src/types/input.ts
+var DocumentTypeCode = /* @__PURE__ */ ((DocumentTypeCode2) => {
+  DocumentTypeCode2["REQUEST_FOR_PAYMENT"] = "71";
+  DocumentTypeCode2["DEBIT_NOTE_GOODS_SERVICES"] = "80";
+  DocumentTypeCode2["CREDIT_NOTE_GOODS_SERVICES"] = "81";
+  DocumentTypeCode2["METERED_SERVICES_INVOICE"] = "82";
+  DocumentTypeCode2["CREDIT_NOTE_FINANCIAL_ADJUSTMENTS"] = "83";
+  DocumentTypeCode2["DEBIT_NOTE_FINANCIAL_ADJUSTMENTS"] = "84";
+  DocumentTypeCode2["TAX_NOTIFICATION"] = "102";
+  DocumentTypeCode2["INVOICING_DATA_SHEET"] = "130";
+  DocumentTypeCode2["DIRECT_PAYMENT_VALUATION"] = "202";
+  DocumentTypeCode2["PROVISIONAL_PAYMENT_VALUATION"] = "203";
+  DocumentTypeCode2["PAYMENT_VALUATION"] = "204";
+  DocumentTypeCode2["INTERIM_APPLICATION_FOR_PAYMENT"] = "211";
+  DocumentTypeCode2["FINAL_PAYMENT_REQUEST"] = "218";
+  DocumentTypeCode2["PAYMENT_REQUEST_COMPLETED_UNITS"] = "219";
+  DocumentTypeCode2["SELF_BILLED_CREDIT_NOTE"] = "261";
+  DocumentTypeCode2["CONSOLIDATED_CREDIT_NOTE"] = "262";
+  DocumentTypeCode2["PRICE_VARIATION_INVOICE"] = "295";
+  DocumentTypeCode2["CREDIT_NOTE_PRICE_VARIATION"] = "296";
+  DocumentTypeCode2["DELCREDERE_CREDIT_NOTE"] = "308";
+  DocumentTypeCode2["PROFORMA_INVOICE"] = "325";
+  DocumentTypeCode2["PARTIAL_INVOICE"] = "326";
+  DocumentTypeCode2["COMMERCIAL_INVOICE_PACKING_LIST"] = "331";
+  DocumentTypeCode2["COMMERCIAL_INVOICE"] = "380";
+  DocumentTypeCode2["CREDIT_NOTE"] = "381";
+  DocumentTypeCode2["COMMISSION_NOTE"] = "382";
+  DocumentTypeCode2["DEBIT_NOTE"] = "383";
+  DocumentTypeCode2["CORRECTED_INVOICE"] = "384";
+  DocumentTypeCode2["CONSOLIDATED_INVOICE"] = "385";
+  DocumentTypeCode2["PREPAYMENT_INVOICE"] = "386";
+  DocumentTypeCode2["HIRE_INVOICE"] = "387";
+  DocumentTypeCode2["TAX_INVOICE"] = "388";
+  DocumentTypeCode2["SELF_BILLED_INVOICE"] = "389";
+  DocumentTypeCode2["DELCREDERE_INVOICE"] = "390";
+  DocumentTypeCode2["FACTORED_INVOICE"] = "393";
+  DocumentTypeCode2["LEASE_INVOICE"] = "394";
+  DocumentTypeCode2["CONSIGNMENT_INVOICE"] = "395";
+  DocumentTypeCode2["FACTORED_CREDIT_NOTE"] = "396";
+  DocumentTypeCode2["OCR_PAYMENT_CREDIT_NOTE"] = "420";
+  DocumentTypeCode2["DEBIT_ADVICE"] = "456";
+  DocumentTypeCode2["REVERSAL_OF_DEBIT"] = "457";
+  DocumentTypeCode2["REVERSAL_OF_CREDIT"] = "458";
+  DocumentTypeCode2["SELF_BILLED_CORRECTIVE_INVOICE"] = "471";
+  DocumentTypeCode2["FACTORED_CORRECTIVE_INVOICE"] = "472";
+  DocumentTypeCode2["SELF_BILLED_FACTORED_CORRECTIVE_INVOICE"] = "473";
+  DocumentTypeCode2["SELF_BILLED_PREPAYMENT_INVOICE"] = "500";
+  DocumentTypeCode2["SELF_BILLED_FACTORED_INVOICE"] = "501";
+  DocumentTypeCode2["SELF_BILLED_FACTORED_CREDIT_NOTE"] = "502";
+  DocumentTypeCode2["PREPAYMENT_CREDIT_NOTE"] = "503";
+  DocumentTypeCode2["SELF_BILLED_DEBIT_NOTE"] = "527";
+  DocumentTypeCode2["FORWARDERS_CREDIT_NOTE"] = "532";
+  DocumentTypeCode2["FORWARDERS_INVOICE_DISCREPANCY_REPORT"] = "553";
+  DocumentTypeCode2["INSURERS_INVOICE"] = "575";
+  DocumentTypeCode2["FORWARDERS_INVOICE"] = "623";
+  DocumentTypeCode2["PORT_CHARGES_DOCUMENTS"] = "633";
+  DocumentTypeCode2["INVOICE_INFO_ACCOUNTING"] = "751";
+  DocumentTypeCode2["FREIGHT_INVOICE"] = "780";
+  DocumentTypeCode2["CLAIM_NOTIFICATION"] = "817";
+  DocumentTypeCode2["CONSULAR_INVOICE"] = "870";
+  DocumentTypeCode2["PARTIAL_CONSTRUCTION_INVOICE"] = "875";
+  DocumentTypeCode2["PARTIAL_FINAL_CONSTRUCTION_INVOICE"] = "876";
+  DocumentTypeCode2["FINAL_CONSTRUCTION_INVOICE"] = "877";
+  return DocumentTypeCode2;
+})(DocumentTypeCode || {});
+var UnitCode = /* @__PURE__ */ ((UnitCode2) => {
+  UnitCode2["UNIT"] = "C62";
+  UnitCode2["EACH"] = "EA";
+  UnitCode2["PIECE"] = "H87";
+  UnitCode2["NUMBER_OF_ARTICLES"] = "NAR";
+  UnitCode2["PAIR"] = "PR";
+  UnitCode2["SET"] = "SET";
+  UnitCode2["DOZEN"] = "DZN";
+  UnitCode2["LOT"] = "LOT";
+  UnitCode2["HUNDRED"] = "CEN";
+  UnitCode2["THOUSAND"] = "MIL";
+  UnitCode2["MINUTE"] = "MIN";
+  UnitCode2["HOUR"] = "HUR";
+  UnitCode2["DAY"] = "DAY";
+  UnitCode2["WEEK"] = "WEE";
+  UnitCode2["MONTH"] = "MON";
+  UnitCode2["YEAR"] = "ANN";
+  UnitCode2["GRAM"] = "GRM";
+  UnitCode2["KILOGRAM"] = "KGM";
+  UnitCode2["TONNE"] = "TNE";
+  UnitCode2["MILLIMETRE"] = "MMT";
+  UnitCode2["CENTIMETRE"] = "CMT";
+  UnitCode2["METRE"] = "MTR";
+  UnitCode2["KILOMETRE"] = "KMT";
+  UnitCode2["SQUARE_METRE"] = "MTK";
+  UnitCode2["MILLILITRE"] = "MLT";
+  UnitCode2["LITRE"] = "LTR";
+  UnitCode2["CUBIC_METRE"] = "MTQ";
+  UnitCode2["KILOWATT_HOUR"] = "KWH";
+  UnitCode2["MEGAWATT_HOUR"] = "MWH";
+  UnitCode2["PACKAGE"] = "XPK";
+  UnitCode2["PALLET"] = "XPX";
+  UnitCode2["BOX"] = "XBX";
+  UnitCode2["CARTON"] = "XCT";
+  UnitCode2["BYTE"] = "AD";
+  UnitCode2["KILOBYTE"] = "2P";
+  UnitCode2["MEGABYTE"] = "4L";
+  UnitCode2["GIGABYTE"] = "E34";
+  UnitCode2["TERABYTE"] = "E35";
+  UnitCode2["PETABYTE"] = "E36";
+  UnitCode2["BYTE_PER_SECOND"] = "P93";
+  UnitCode2["KILOBYTE_PER_SECOND"] = "P94";
+  UnitCode2["LUMP_SUM"] = "LS";
+  UnitCode2["PERCENT"] = "P1";
+  UnitCode2["SHEET"] = "ST";
+  UnitCode2["ROLL"] = "RO";
+  return UnitCode2;
+})(UnitCode || {});
+
+// src/flavors/constants.ts
+var Profile = /* @__PURE__ */ ((Profile2) => {
+  Profile2["MINIMUM"] = "MINIMUM";
+  Profile2["BASIC_WL"] = "BASIC_WL";
+  Profile2["BASIC"] = "BASIC";
+  Profile2["EN16931"] = "EN16931";
+  Profile2["EXTENDED"] = "EXTENDED";
+  return Profile2;
+})(Profile || {});
+var Flavor = /* @__PURE__ */ ((Flavor2) => {
+  Flavor2["FACTUR_X"] = "factur-x";
+  Flavor2["ZUGFERD"] = "zugferd";
+  Flavor2["XRECHNUNG"] = "xrechnung";
+  Flavor2["CHRONO_PRO"] = "chrono-pro";
+  return Flavor2;
+})(Flavor || {});
+var PROFILE_URNS = {
+  MINIMUM: "urn:factur-x.eu:1p0:minimum",
+  BASIC_WL: "urn:factur-x.eu:1p0:basicwl",
+  BASIC: "urn:factur-x.eu:1p0:basic",
+  EN16931: "urn:factur-x.eu:1p0:en16931",
+  EXTENDED: "urn:factur-x.eu:1p0:extended"
+};
+var FLAVOR_DEFAULT_TYPE_CODES = {
+  ["factur-x" /* FACTUR_X */]: "380" /* COMMERCIAL_INVOICE */,
+  ["zugferd" /* ZUGFERD */]: "380" /* COMMERCIAL_INVOICE */,
+  ["xrechnung" /* XRECHNUNG */]: "380" /* COMMERCIAL_INVOICE */,
+  ["chrono-pro" /* CHRONO_PRO */]: "380" /* COMMERCIAL_INVOICE */
+};
+var PROFILE_SCHEMA_DIRS = {
+  MINIMUM: "minimum",
+  BASIC_WL: "basic-wl",
+  BASIC: "basic",
+  EN16931: "en16931",
+  EXTENDED: "extended"
+};
+var PROFILE_MAIN_XSD = {
+  MINIMUM: "FACTUR-X_MINIMUM.xsd",
+  BASIC_WL: "FACTUR-X_BASIC-WL.xsd",
+  BASIC: "FACTUR-X_BASIC.xsd",
+  EN16931: "FACTUR-X_EN16931.xsd",
+  EXTENDED: "FACTUR-X_EXTENDED.xsd"
+};
+
+// src/flavors/registry.ts
+var ALL_PROFILES = [
+  "MINIMUM" /* MINIMUM */,
+  "BASIC_WL" /* BASIC_WL */,
+  "BASIC" /* BASIC */,
+  "EN16931" /* EN16931 */,
+  "EXTENDED" /* EXTENDED */
+];
+var CHRONO_PRO_PROFILES = [
+  "MINIMUM" /* MINIMUM */,
+  "BASIC_WL" /* BASIC_WL */,
+  "BASIC" /* BASIC */,
+  "EN16931" /* EN16931 */
+];
+var FLAVOR_CONFIGS = {
+  ["factur-x" /* FACTUR_X */]: {
+    name: "Factur-X",
+    supportedProfiles: ALL_PROFILES,
+    defaultTypeCode: "380" /* COMMERCIAL_INVOICE */,
+    attachmentFilename: "factur-x.xml",
+    embedInPdf: true,
+    description: "French/German hybrid invoice format based on EN 16931."
+  },
+  ["zugferd" /* ZUGFERD */]: {
+    name: "ZUGFeRD",
+    supportedProfiles: ALL_PROFILES,
+    defaultTypeCode: "380" /* COMMERCIAL_INVOICE */,
+    attachmentFilename: "factur-x.xml",
+    embedInPdf: true,
+    description: "German electronic invoice format. ZUGFeRD 2.4 uses factur-x.xml."
+  },
+  ["xrechnung" /* XRECHNUNG */]: {
+    name: "XRechnung",
+    supportedProfiles: ["EN16931" /* EN16931 */],
+    defaultTypeCode: "380" /* COMMERCIAL_INVOICE */,
+    businessProcessUrn: "urn:fdc:peppol.eu:2017:poacc:billing:01:1.0",
+    attachmentFilename: "xrechnung.xml",
+    embedInPdf: false,
+    description: "German government invoice format. XML only, no PDF embedding."
+  },
+  ["chrono-pro" /* CHRONO_PRO */]: {
+    name: "Chrono Pro",
+    supportedProfiles: CHRONO_PRO_PROFILES,
+    defaultTypeCode: "380" /* COMMERCIAL_INVOICE */,
+    attachmentFilename: "factur-x.xml",
+    embedInPdf: true,
+    description: "Belgian e-invoicing solution using Factur-X subset."
+  }
+};
+function getFlavorConfig(flavor) {
+  return FLAVOR_CONFIGS[flavor];
+}
+function validateFlavorProfile(flavor, profile) {
+  const config = FLAVOR_CONFIGS[flavor];
+  if (!config.supportedProfiles.includes(profile)) {
+    throw new Error(
+      `Profile "${profile}" is not supported for flavor "${flavor}". Supported: ${config.supportedProfiles.join(", ")}.`
+    );
+  }
+}
+function resolveTypeCode(input, flavor) {
+  const inputTypeCode = input.document?.typeCode;
+  if (inputTypeCode) {
+    return inputTypeCode;
+  }
+  return FLAVOR_CONFIGS[flavor].defaultTypeCode;
+}
+function resolveBusinessProcessUrn(input, flavor) {
+  const inputBusinessProcessId = input.document?.businessProcessId;
+  if (inputBusinessProcessId) {
+    return inputBusinessProcessId;
+  }
+  return FLAVOR_CONFIGS[flavor].businessProcessUrn;
+}
+
+// src/core/xml-builder.ts
+var PROFILE_LEVEL = {
+  MINIMUM: 0,
+  BASIC_WL: 1,
+  BASIC: 2,
+  EN16931: 3,
+  EXTENDED: 4
+};
+function atLeast(current, minimum) {
+  return PROFILE_LEVEL[current] >= PROFILE_LEVEL[minimum];
+}
+function escapeXml(value) {
+  return value.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F]/g, "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function formatDate(isoDate) {
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(isoDate)) {
+    throw new Error(`Invalid date format "${isoDate}": expected YYYY-MM-DD (e.g. "2025-03-15").`);
+  }
+  return isoDate.replace(/-/g, "");
+}
+function fmtAmt(n) {
+  if (!Number.isFinite(n)) {
+    throw new Error(`Invalid amount value: ${n}. Expected a finite number.`);
+  }
+  return n.toFixed(2);
+}
+function tag(name, content, attrs) {
+  const a = attrs ? Object.entries(attrs).map(([k, v]) => ` ${k}="${escapeXml(v)}"`).join("") : "";
+  return `<${name}${a}>${content}</${name}>`;
+}
+function dateEl(wrapper, isoDate) {
+  return tag(wrapper, tag("udt:DateTimeString", formatDate(isoDate), { format: "102" }));
+}
+function buildAddress(addr) {
+  let x = "";
+  if (addr.postalCode) x += tag("ram:PostcodeCode", escapeXml(addr.postalCode));
+  x += tag("ram:LineOne", escapeXml(addr.line1));
+  if (addr.line2) x += tag("ram:LineTwo", escapeXml(addr.line2));
+  if (addr.line3) x += tag("ram:LineThree", escapeXml(addr.line3));
+  x += tag("ram:CityName", escapeXml(addr.city));
+  x += tag("ram:CountryID", escapeXml(addr.country));
+  if (addr.subdivision) x += tag("ram:CountrySubDivisionName", escapeXml(addr.subdivision));
+  return tag("ram:PostalTradeAddress", x);
+}
+function buildContact(c) {
+  let x = "";
+  if (c.name) x += tag("ram:PersonName", escapeXml(c.name));
+  if (c.department) x += tag("ram:DepartmentName", escapeXml(c.department));
+  if (c.phone)
+    x += tag("ram:TelephoneUniversalCommunication", tag("ram:CompleteNumber", escapeXml(c.phone)));
+  if (c.email) x += tag("ram:EmailURIUniversalCommunication", tag("ram:URIID", escapeXml(c.email)));
+  return tag("ram:DefinedTradeContact", x);
+}
+function buildParty(p, profile) {
+  let x = "";
+  if (p.id) {
+    const ids = Array.isArray(p.id) ? p.id : [p.id];
+    for (const id of ids) x += tag("ram:ID", escapeXml(id));
+  }
+  if (p.globalId) x += tag("ram:GlobalID", escapeXml(p.globalId));
+  x += tag("ram:Name", escapeXml(p.name));
+  if (p.description && atLeast(profile, "EN16931" /* EN16931 */))
+    x += tag("ram:Description", escapeXml(p.description));
+  if (p.legalOrganization) {
+    let lo = "";
+    if (p.legalOrganization.id) lo += tag("ram:ID", escapeXml(p.legalOrganization.id));
+    if (p.legalOrganization.tradingName)
+      lo += tag("ram:TradingBusinessName", escapeXml(p.legalOrganization.tradingName));
+    x += tag("ram:SpecifiedLegalOrganization", lo);
+  }
+  if (p.contact && atLeast(profile, "EN16931" /* EN16931 */)) x += buildContact(p.contact);
+  if (p.address && atLeast(profile, "BASIC_WL" /* BASIC_WL */)) x += buildAddress(p.address);
+  if (p.electronicAddress)
+    x += tag("ram:URIUniversalCommunication", tag("ram:URIID", escapeXml(p.electronicAddress)));
+  if (p.taxRegistrations) {
+    for (const tr of p.taxRegistrations) {
+      x += tag(
+        "ram:SpecifiedTaxRegistration",
+        tag("ram:ID", escapeXml(tr.id), { schemeID: tr.schemeId ?? "VA" })
+      );
+    }
+  }
+  return x;
+}
+function buildLineItem(line, profile) {
+  let doc = tag("ram:LineID", escapeXml(line.id));
+  if (line.note) doc += tag("ram:IncludedNote", tag("ram:Content", escapeXml(line.note)));
+  let prod = "";
+  if (line.standardIdentifier) prod += tag("ram:GlobalID", escapeXml(line.standardIdentifier));
+  if (line.sellerAssignedId) prod += tag("ram:SellerAssignedID", escapeXml(line.sellerAssignedId));
+  if (line.buyerAssignedId) prod += tag("ram:BuyerAssignedID", escapeXml(line.buyerAssignedId));
+  prod += tag("ram:Name", escapeXml(line.name));
+  if (line.description) prod += tag("ram:Description", escapeXml(line.description));
+  if (line.originCountry && atLeast(profile, "EN16931" /* EN16931 */))
+    prod += tag("ram:OriginTradeCountry", tag("ram:ID", escapeXml(line.originCountry)));
+  let agree = "";
+  if (line.buyerOrderLineId && atLeast(profile, "EN16931" /* EN16931 */))
+    agree += tag(
+      "ram:BuyerOrderReferencedDocument",
+      tag("ram:LineID", escapeXml(line.buyerOrderLineId))
+    );
+  if (line.grossUnitPrice !== void 0)
+    agree += tag(
+      "ram:GrossPriceProductTradePrice",
+      tag("ram:ChargeAmount", fmtAmt(line.grossUnitPrice))
+    );
+  agree += tag("ram:NetPriceProductTradePrice", tag("ram:ChargeAmount", fmtAmt(line.unitPrice)));
+  const unitCode = line.unitCode ?? "C62" /* UNIT */;
+  const delivery = tag("ram:BilledQuantity", line.quantity.toString(), {
+    unitCode
+  });
+  let settle = "";
+  if (line.vatCategoryCode || line.vatRatePercent !== void 0) {
+    let tx = tag("ram:TypeCode", "VAT");
+    if (line.vatCategoryCode) tx += tag("ram:CategoryCode", escapeXml(line.vatCategoryCode));
+    if (line.vatRatePercent !== void 0)
+      tx += tag("ram:RateApplicablePercent", line.vatRatePercent.toString());
+    settle += tag("ram:ApplicableTradeTax", tx);
+  }
+  const lineTotal = line.lineTotal ?? line.quantity * line.unitPrice;
+  settle += tag(
+    "ram:SpecifiedTradeSettlementLineMonetarySummation",
+    tag("ram:LineTotalAmount", fmtAmt(lineTotal))
+  );
+  return tag(
+    "ram:IncludedSupplyChainTradeLineItem",
+    tag("ram:AssociatedDocumentLineDocument", doc) + tag("ram:SpecifiedTradeProduct", prod) + tag("ram:SpecifiedLineTradeAgreement", agree) + tag("ram:SpecifiedLineTradeDelivery", delivery) + tag("ram:SpecifiedLineTradeSettlement", settle)
+  );
+}
+function buildAllowanceCharge(ac) {
+  let x = tag("ram:ChargeIndicator", tag("ram:Indicator", ac.isCharge ? "true" : "false"));
+  if (ac.percent !== void 0) x += tag("ram:CalculationPercent", ac.percent.toString());
+  if (ac.baseAmount !== void 0) x += tag("ram:BasisAmount", fmtAmt(ac.baseAmount));
+  x += tag("ram:ActualAmount", fmtAmt(ac.amount));
+  if (ac.reasonCode) x += tag("ram:ReasonCode", escapeXml(ac.reasonCode));
+  if (ac.reason) x += tag("ram:Reason", escapeXml(ac.reason));
+  if (ac.vatCategoryCode || ac.vatRatePercent !== void 0) {
+    let tx = tag("ram:TypeCode", "VAT");
+    if (ac.vatCategoryCode) tx += tag("ram:CategoryCode", escapeXml(ac.vatCategoryCode));
+    if (ac.vatRatePercent !== void 0)
+      tx += tag("ram:RateApplicablePercent", ac.vatRatePercent.toString());
+    x += tag("ram:CategoryTradeTax", tx);
+  }
+  return tag("ram:SpecifiedTradeAllowanceCharge", x);
+}
+function buildVatBreakdown(vb) {
+  let x = tag("ram:CalculatedAmount", fmtAmt(vb.taxAmount));
+  x += tag("ram:TypeCode", "VAT");
+  if (vb.exemptionReason) x += tag("ram:ExemptionReason", escapeXml(vb.exemptionReason));
+  x += tag("ram:BasisAmount", fmtAmt(vb.taxableAmount));
+  x += tag("ram:CategoryCode", escapeXml(vb.categoryCode));
+  if (vb.exemptionReasonCode)
+    x += tag("ram:ExemptionReasonCode", escapeXml(vb.exemptionReasonCode));
+  x += tag("ram:RateApplicablePercent", vb.ratePercent.toString());
+  return tag("ram:ApplicableTradeTax", x);
+}
+function buildMonetarySummation(t, profile) {
+  let x = "";
+  if (atLeast(profile, "BASIC_WL" /* BASIC_WL */)) {
+    x += tag("ram:LineTotalAmount", fmtAmt(t.lineTotal));
+    if (t.chargeTotal !== void 0) x += tag("ram:ChargeTotalAmount", fmtAmt(t.chargeTotal));
+    if (t.allowanceTotal !== void 0)
+      x += tag("ram:AllowanceTotalAmount", fmtAmt(t.allowanceTotal));
+  }
+  x += tag("ram:TaxBasisTotalAmount", fmtAmt(t.taxBasisTotal));
+  x += tag("ram:TaxTotalAmount", fmtAmt(t.taxTotal), {
+    currencyID: t.currency
+  });
+  x += tag("ram:GrandTotalAmount", fmtAmt(t.grandTotal));
+  if (atLeast(profile, "BASIC_WL" /* BASIC_WL */) && t.prepaidAmount !== void 0)
+    x += tag("ram:TotalPrepaidAmount", fmtAmt(t.prepaidAmount));
+  x += tag("ram:DuePayableAmount", fmtAmt(t.duePayableAmount));
+  return tag("ram:SpecifiedTradeSettlementHeaderMonetarySummation", x);
+}
+function buildXml(input, profile, flavor) {
+  if (!input) {
+    throw new Error('buildXml: "input" is required.');
+  }
+  if (!profile) {
+    throw new Error('buildXml: "profile" is required (e.g. Profile.EN16931).');
+  }
+  if (!input.document) {
+    throw new Error('buildXml: "input.document" is required (id, issueDate, etc.).');
+  }
+  if (!input.seller) {
+    throw new Error('buildXml: "input.seller" is required (seller name and details).');
+  }
+  if (!input.buyer) {
+    throw new Error('buildXml: "input.buyer" is required (buyer name and details).');
+  }
+  if (!input.totals) {
+    throw new Error('buildXml: "input.totals" is required (monetary totals).');
+  }
+  const { document: doc, seller, buyer, totals, payment } = input;
+  const fl = flavor ?? "factur-x" /* FACTUR_X */;
+  const typeCode = resolveTypeCode(input, fl);
+  let ctx = "";
+  if (doc.businessProcessId)
+    ctx += tag(
+      "ram:BusinessProcessSpecifiedDocumentContextParameter",
+      tag("ram:ID", escapeXml(doc.businessProcessId))
+    );
+  ctx += tag(
+    "ram:GuidelineSpecifiedDocumentContextParameter",
+    tag("ram:ID", PROFILE_URNS[profile])
+  );
+  let edoc = tag("ram:ID", escapeXml(doc.id));
+  if (doc.name && atLeast(profile, "EXTENDED" /* EXTENDED */)) edoc += tag("ram:Name", escapeXml(doc.name));
+  edoc += tag("ram:TypeCode", typeCode);
+  edoc += dateEl("ram:IssueDateTime", doc.issueDate);
+  if (doc.language && atLeast(profile, "EXTENDED" /* EXTENDED */))
+    edoc += tag("ram:LanguageID", escapeXml(doc.language));
+  if (doc.notes && atLeast(profile, "BASIC_WL" /* BASIC_WL */)) {
+    for (const note of doc.notes) {
+      let n = tag("ram:Content", escapeXml(note.content));
+      if (note.subjectCode) n += tag("ram:SubjectCode", escapeXml(note.subjectCode));
+      edoc += tag("ram:IncludedNote", n);
+    }
+  }
+  let tx = "";
+  if (atLeast(profile, "BASIC" /* BASIC */) && input.lines) {
+    for (const line of input.lines) tx += buildLineItem(line, profile);
+  }
+  let agree = "";
+  if (doc.buyerReference) agree += tag("ram:BuyerReference", escapeXml(doc.buyerReference));
+  agree += tag("ram:SellerTradeParty", buildParty(seller, profile));
+  agree += tag("ram:BuyerTradeParty", buildParty(buyer, profile));
+  if (input.sellerTaxRepresentative && atLeast(profile, "BASIC_WL" /* BASIC_WL */))
+    agree += tag(
+      "ram:SellerTaxRepresentativeTradeParty",
+      buildParty(input.sellerTaxRepresentative, profile)
+    );
+  if (input.references && atLeast(profile, "BASIC_WL" /* BASIC_WL */)) {
+    for (const ref of input.references) {
+      const refType = ref.type ?? "order";
+      if (refType === "preceding" || refType === "despatch") continue;
+      const inner = tag("ram:IssuerAssignedID", escapeXml(ref.id)) + (ref.issueDate ? dateEl("ram:FormattedIssueDateTime", ref.issueDate) : "");
+      switch (refType) {
+        case "order":
+          agree += tag("ram:BuyerOrderReferencedDocument", inner);
+          break;
+        case "contract":
+          agree += tag("ram:ContractReferencedDocument", inner);
+          break;
+        case "seller-order":
+          if (atLeast(profile, "EN16931" /* EN16931 */))
+            agree += tag("ram:SellerOrderReferencedDocument", inner);
+          break;
+        case "project":
+          if (atLeast(profile, "EN16931" /* EN16931 */))
+            agree += tag("ram:SpecifiedProcuringProject", tag("ram:ID", escapeXml(ref.id)));
+          break;
+      }
+    }
+  }
+  tx += tag("ram:ApplicableHeaderTradeAgreement", agree);
+  let del = "";
+  if (input.delivery && atLeast(profile, "BASIC_WL" /* BASIC_WL */)) {
+    if (input.delivery.partyName || input.delivery.location) {
+      let sp = "";
+      if (input.delivery.partyName) sp += tag("ram:Name", escapeXml(input.delivery.partyName));
+      if (input.delivery.location) sp += buildAddress(input.delivery.location);
+      del += tag("ram:ShipToTradeParty", sp);
+    }
+    if (input.delivery.date)
+      del += tag(
+        "ram:ActualDeliverySupplyChainEvent",
+        dateEl("ram:OccurrenceDateTime", input.delivery.date)
+      );
+    if (input.delivery.despatchAdviceReference)
+      del += tag(
+        "ram:DespatchAdviceReferencedDocument",
+        tag("ram:IssuerAssignedID", escapeXml(input.delivery.despatchAdviceReference))
+      );
+  }
+  if (input.references && atLeast(profile, "BASIC_WL" /* BASIC_WL */)) {
+    for (const ref of input.references) {
+      if (ref.type === "despatch") {
+        let inner = tag("ram:IssuerAssignedID", escapeXml(ref.id));
+        if (ref.issueDate) inner += dateEl("ram:FormattedIssueDateTime", ref.issueDate);
+        del += tag("ram:DespatchAdviceReferencedDocument", inner);
+      }
+    }
+  }
+  tx += tag("ram:ApplicableHeaderTradeDelivery", del);
+  let sett = "";
+  if (payment?.creditorReference && atLeast(profile, "BASIC_WL" /* BASIC_WL */))
+    sett += tag("ram:CreditorReferenceID", escapeXml(payment.creditorReference));
+  if (payment?.paymentReference && atLeast(profile, "BASIC_WL" /* BASIC_WL */))
+    sett += tag("ram:PaymentReference", escapeXml(payment.paymentReference));
+  if (totals.taxCurrency) sett += tag("ram:TaxCurrencyCode", escapeXml(totals.taxCurrency));
+  sett += tag("ram:InvoiceCurrencyCode", escapeXml(totals.currency));
+  if (input.payee && atLeast(profile, "BASIC_WL" /* BASIC_WL */))
+    sett += tag("ram:PayeeTradeParty", buildParty(input.payee, profile));
+  if (payment?.meansCode && atLeast(profile, "BASIC_WL" /* BASIC_WL */)) {
+    let pm = tag("ram:TypeCode", escapeXml(payment.meansCode));
+    if (payment.iban || payment.accountId || payment.accountName) {
+      let acct = "";
+      if (payment.iban) acct += tag("ram:IBANID", escapeXml(payment.iban));
+      if (payment.accountId) acct += tag("ram:ProprietaryID", escapeXml(payment.accountId));
+      if (payment.accountName && atLeast(profile, "EN16931" /* EN16931 */))
+        acct += tag("ram:AccountName", escapeXml(payment.accountName));
+      pm += tag("ram:PayeePartyCreditorFinancialAccount", acct);
+    }
+    if (payment.bic && atLeast(profile, "EN16931" /* EN16931 */))
+      pm += tag(
+        "ram:PayeeSpecifiedCreditorFinancialInstitution",
+        tag("ram:BICID", escapeXml(payment.bic))
+      );
+    if (payment.debtorIban)
+      pm += tag(
+        "ram:PayerPartyDebtorFinancialAccount",
+        tag("ram:IBANID", escapeXml(payment.debtorIban))
+      );
+    sett += tag("ram:SpecifiedTradeSettlementPaymentMeans", pm);
+  }
+  if (input.vatBreakdown && atLeast(profile, "BASIC_WL" /* BASIC_WL */))
+    for (const vb of input.vatBreakdown) sett += buildVatBreakdown(vb);
+  if (input.billingPeriod && atLeast(profile, "BASIC_WL" /* BASIC_WL */)) {
+    let bp = "";
+    if (input.billingPeriod.startDate)
+      bp += dateEl("ram:StartDateTime", input.billingPeriod.startDate);
+    if (input.billingPeriod.endDate) bp += dateEl("ram:EndDateTime", input.billingPeriod.endDate);
+    sett += tag("ram:BillingSpecifiedPeriod", bp);
+  }
+  if (input.allowancesCharges && atLeast(profile, "BASIC_WL" /* BASIC_WL */))
+    for (const ac of input.allowancesCharges) sett += buildAllowanceCharge(ac);
+  const dueDate = payment?.dueDate ?? doc.dueDate;
+  if (atLeast(profile, "BASIC_WL" /* BASIC_WL */) && (payment?.termsDescription || dueDate || payment?.mandateId)) {
+    let pt = "";
+    if (payment?.termsDescription)
+      pt += tag("ram:Description", escapeXml(payment.termsDescription));
+    if (dueDate) pt += dateEl("ram:DueDateDateTime", dueDate);
+    if (payment?.mandateId) pt += tag("ram:DirectDebitMandateID", escapeXml(payment.mandateId));
+    sett += tag("ram:SpecifiedTradePaymentTerms", pt);
+  }
+  sett += buildMonetarySummation(totals, profile);
+  if (input.references && atLeast(profile, "BASIC_WL" /* BASIC_WL */)) {
+    for (const ref of input.references) {
+      if (ref.type === "preceding") {
+        let inner = tag("ram:IssuerAssignedID", escapeXml(ref.id));
+        if (ref.issueDate) inner += dateEl("ram:FormattedIssueDateTime", ref.issueDate);
+        sett += tag("ram:InvoiceReferencedDocument", inner);
+      }
+    }
+  }
+  tx += tag("ram:ApplicableHeaderTradeSettlement", sett);
+  return '<?xml version="1.0" encoding="UTF-8"?><rsm:CrossIndustryInvoice xmlns:rsm="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100" xmlns:ram="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100" xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100" xmlns:qdt="urn:un:unece:uncefact:data:standard:QualifiedDataType:100">' + tag("rsm:ExchangedDocumentContext", ctx) + tag("rsm:ExchangedDocument", edoc) + tag("rsm:SupplyChainTradeTransaction", tx) + "</rsm:CrossIndustryInvoice>";
+}
+
+// src/validation/profile-validator.ts
+var PROFILE_LEVEL2 = {
+  MINIMUM: 0,
+  BASIC_WL: 1,
+  BASIC: 2,
+  EN16931: 3,
+  EXTENDED: 4
+};
+function addError(errors, field, message, profile) {
+  errors.push({ field, message, profile });
+}
+function validateInput(input, profile) {
+  const errors = [];
+  const level = PROFILE_LEVEL2[profile];
+  const req = (minProfile) => level >= PROFILE_LEVEL2[minProfile];
+  if (!input.document) {
+    addError(errors, "document", "Document is required", "MINIMUM" /* MINIMUM */);
+  } else {
+    if (req("MINIMUM" /* MINIMUM */)) {
+      if (!input.document.id) {
+        addError(errors, "document.id", "Document ID is required", "MINIMUM" /* MINIMUM */);
+      }
+      if (!input.document.issueDate) {
+        addError(errors, "document.issueDate", "Document issue date is required", "MINIMUM" /* MINIMUM */);
+      }
+    }
+  }
+  if (!input.seller) {
+    addError(errors, "seller", "Seller is required", "MINIMUM" /* MINIMUM */);
+  } else {
+    if (req("MINIMUM" /* MINIMUM */) && !input.seller.name) {
+      addError(errors, "seller.name", "Seller name is required", "MINIMUM" /* MINIMUM */);
+    }
+    if (req("BASIC_WL" /* BASIC_WL */)) {
+      if (!input.seller.address) {
+        addError(
+          errors,
+          "seller.address",
+          "Seller address is required for BASIC_WL",
+          "BASIC_WL" /* BASIC_WL */
+        );
+      } else if (!input.seller.address.country) {
+        addError(
+          errors,
+          "seller.address.country",
+          "Seller address country is required for BASIC_WL",
+          "BASIC_WL" /* BASIC_WL */
+        );
+      }
+    }
+  }
+  if (!input.buyer) {
+    addError(errors, "buyer", "Buyer is required", "MINIMUM" /* MINIMUM */);
+  } else {
+    if (req("MINIMUM" /* MINIMUM */) && !input.buyer.name) {
+      addError(errors, "buyer.name", "Buyer name is required", "MINIMUM" /* MINIMUM */);
+    }
+    if (req("BASIC_WL" /* BASIC_WL */)) {
+      if (!input.buyer.address) {
+        addError(
+          errors,
+          "buyer.address",
+          "Buyer address is required for BASIC_WL",
+          "BASIC_WL" /* BASIC_WL */
+        );
+      } else if (!input.buyer.address.country) {
+        addError(
+          errors,
+          "buyer.address.country",
+          "Buyer address country is required for BASIC_WL",
+          "BASIC_WL" /* BASIC_WL */
+        );
+      }
+    }
+  }
+  if (!input.totals) {
+    addError(errors, "totals", "Totals are required", "MINIMUM" /* MINIMUM */);
+  } else {
+    if (req("MINIMUM" /* MINIMUM */)) {
+      if (input.totals.taxBasisTotal == null) {
+        addError(errors, "totals.taxBasisTotal", "Tax basis total is required", "MINIMUM" /* MINIMUM */);
+      }
+      if (input.totals.grandTotal == null) {
+        addError(errors, "totals.grandTotal", "Grand total is required", "MINIMUM" /* MINIMUM */);
+      }
+      if (input.totals.duePayableAmount == null) {
+        addError(
+          errors,
+          "totals.duePayableAmount",
+          "Due payable amount is required",
+          "MINIMUM" /* MINIMUM */
+        );
+      }
+      if (!input.totals.currency) {
+        addError(errors, "totals.currency", "Currency is required", "MINIMUM" /* MINIMUM */);
+      }
+    }
+    if (req("BASIC_WL" /* BASIC_WL */)) {
+      if (input.totals.lineTotal == null) {
+        addError(
+          errors,
+          "totals.lineTotal",
+          "Line total is required for BASIC_WL",
+          "BASIC_WL" /* BASIC_WL */
+        );
+      }
+      if (input.totals.taxTotal == null) {
+        addError(errors, "totals.taxTotal", "Tax total is required for BASIC_WL", "BASIC_WL" /* BASIC_WL */);
+      }
+    }
+  }
+  if (req("BASIC_WL" /* BASIC_WL */)) {
+    const vat = input.vatBreakdown;
+    if (!vat || vat.length === 0) {
+      addError(
+        errors,
+        "vatBreakdown",
+        "VAT breakdown with at least one entry is required for BASIC_WL",
+        "BASIC_WL" /* BASIC_WL */
+      );
+    } else {
+      vat.forEach((entry, i) => {
+        if (!entry.categoryCode) {
+          addError(
+            errors,
+            `vatBreakdown[${i}].categoryCode`,
+            "VAT breakdown entry categoryCode is required",
+            "BASIC_WL" /* BASIC_WL */
+          );
+        }
+        if (entry.ratePercent == null) {
+          addError(
+            errors,
+            `vatBreakdown[${i}].ratePercent`,
+            "VAT breakdown entry ratePercent is required",
+            "BASIC_WL" /* BASIC_WL */
+          );
+        }
+        if (entry.taxableAmount == null) {
+          addError(
+            errors,
+            `vatBreakdown[${i}].taxableAmount`,
+            "VAT breakdown entry taxableAmount is required",
+            "BASIC_WL" /* BASIC_WL */
+          );
+        }
+        if (entry.taxAmount == null) {
+          addError(
+            errors,
+            `vatBreakdown[${i}].taxAmount`,
+            "VAT breakdown entry taxAmount is required",
+            "BASIC_WL" /* BASIC_WL */
+          );
+        }
+      });
+    }
+  }
+  if (req("BASIC" /* BASIC */)) {
+    const lines = input.lines;
+    if (!lines || lines.length === 0) {
+      addError(errors, "lines", "At least one invoice line is required for BASIC", "BASIC" /* BASIC */);
+    } else {
+      lines.forEach((line, i) => {
+        if (!line.id) {
+          addError(errors, `lines[${i}].id`, "Line ID is required", "BASIC" /* BASIC */);
+        }
+        if (!line.name) {
+          addError(errors, `lines[${i}].name`, "Line name is required", "BASIC" /* BASIC */);
+        }
+        if (line.quantity == null) {
+          addError(errors, `lines[${i}].quantity`, "Line quantity is required", "BASIC" /* BASIC */);
+        }
+        if (line.unitPrice == null) {
+          addError(errors, `lines[${i}].unitPrice`, "Line unit price is required", "BASIC" /* BASIC */);
+        }
+      });
+    }
+  }
+  if (req("EN16931" /* EN16931 */) && input.lines && input.lines.length > 0) {
+    input.lines.forEach((line, i) => {
+      if (line.vatCategoryCode == null || line.vatCategoryCode === "") {
+        addError(
+          errors,
+          `lines[${i}].vatCategoryCode`,
+          "Line VAT category code is required for EN16931",
+          "EN16931" /* EN16931 */
+        );
+      }
+      if (line.vatRatePercent == null) {
+        addError(
+          errors,
+          `lines[${i}].vatRatePercent`,
+          "Line VAT rate percent is required for EN16931",
+          "EN16931" /* EN16931 */
+        );
+      }
+    });
+  }
+  return {
+    valid: errors.length === 0,
+    errors
+  };
+}
+function findSchemaDir(startDir) {
+  let dir = startDir;
+  for (let i = 0; i < 6; i++) {
+    const candidate = path2.join(dir, "schema");
+    if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
+      return candidate;
+    }
+    const parent = path2.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  throw new Error(
+    "Could not auto-detect the schema directory. Pass `schemaBasePath` pointing to the folder that contains `schema/`."
+  );
+}
+function resolveXsdPath(profile, schemaBasePath) {
+  const base = schemaBasePath ? path2.join(schemaBasePath, "schema") : findSchemaDir(__dirname$1);
+  const profileDir = path2.join(base, PROFILE_SCHEMA_DIRS[profile]);
+  const xsdFile = path2.join(profileDir, PROFILE_MAIN_XSD[profile]);
+  if (!fs.existsSync(xsdFile)) {
+    throw new Error(
+      `XSD schema file not found: ${xsdFile}. Ensure the schema files are installed with the package.`
+    );
+  }
+  return xsdFile;
+}
+async function validateXsd(xml, profile, options) {
+  const xsdPath = resolveXsdPath(profile, options?.schemaBasePath);
+  const {
+    XmlDocument,
+    XsdValidator,
+    XmlValidateError,
+    xmlRegisterInputProvider,
+    XmlBufferInputProvider
+  } = await import('libxml2-wasm');
+  const schemaDir = path2.dirname(xsdPath);
+  const files = fs.readdirSync(schemaDir).filter((f) => f.endsWith(".xsd"));
+  const buffers = {};
+  for (const file of files) {
+    const filePath = path2.join(schemaDir, file);
+    buffers[filePath] = fs.readFileSync(filePath);
+    buffers[`file://${filePath}`] = buffers[filePath];
+    buffers[file] = buffers[filePath];
+  }
+  const provider = new XmlBufferInputProvider(buffers);
+  xmlRegisterInputProvider(provider);
+  let xsdDoc;
+  let validator;
+  let xmlDoc;
+  try {
+    const xsdContent = fs.readFileSync(xsdPath, "utf-8");
+    xsdDoc = XmlDocument.fromString(xsdContent, { url: `file://${xsdPath}` });
+    validator = XsdValidator.fromDoc(xsdDoc);
+    xmlDoc = XmlDocument.fromString(xml);
+    validator.validate(xmlDoc);
+    return { valid: true, errors: [] };
+  } catch (err) {
+    if (err instanceof XmlValidateError) {
+      const errors = (err.details ?? []).map((d) => ({
+        message: d.message,
+        line: d.line,
+        column: d.col
+      }));
+      if (errors.length === 0) {
+        errors.push({ message: err.message || "XSD validation failed" });
+      }
+      return { valid: false, errors };
+    }
+    throw err;
+  } finally {
+    xmlDoc?.dispose();
+    validator?.dispose();
+    xsdDoc?.dispose();
+  }
+}
+var AF_RELATIONSHIP_MAP = {
+  Alternative: AFRelationship.Alternative,
+  Data: AFRelationship.Data,
+  Source: AFRelationship.Source
+};
+function resolveAfRelationship(profile, override) {
+  if (override) return AF_RELATIONSHIP_MAP[override];
+  switch (profile) {
+    case "MINIMUM" /* MINIMUM */:
+    case "BASIC_WL" /* BASIC_WL */:
+      return AFRelationship.Data;
+    default:
+      return AFRelationship.Alternative;
+  }
+}
+function buildXmpMetadata(opts) {
+  const esc = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+  return `<?xpacket begin="\uFEFF" id="W5M0MpCehiHzreSzNTczkc9d"?>
+<x:xmpmeta xmlns:x="adobe:ns:meta/">
+  <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
+
+    <rdf:Description rdf:about=""
+        xmlns:dc="http://purl.org/dc/elements/1.1/">
+      <dc:title>
+        <rdf:Alt>
+          <rdf:li xml:lang="x-default">${esc(opts.title)}</rdf:li>
+        </rdf:Alt>
+      </dc:title>
+      <dc:creator>
+        <rdf:Seq>
+          <rdf:li>${esc(opts.author)}</rdf:li>
+        </rdf:Seq>
+      </dc:creator>
+      <dc:description>
+        <rdf:Alt>
+          <rdf:li xml:lang="x-default">${esc(opts.subject)}</rdf:li>
+        </rdf:Alt>
+      </dc:description>
+    </rdf:Description>
+
+    <rdf:Description rdf:about=""
+        xmlns:pdf="http://ns.adobe.com/pdf/1.3/">
+      <pdf:Producer>${esc(opts.producer)}</pdf:Producer>
+    </rdf:Description>
+
+    <rdf:Description rdf:about=""
+        xmlns:xmp="http://ns.adobe.com/xap/1.0/">
+      <xmp:CreatorTool>${esc(opts.creator)}</xmp:CreatorTool>
+      <xmp:CreateDate>${opts.createDate}</xmp:CreateDate>
+      <xmp:ModifyDate>${opts.modifyDate}</xmp:ModifyDate>
+    </rdf:Description>
+
+    <rdf:Description rdf:about=""
+        xmlns:pdfaid="http://www.aiim.org/pdfa/ns/id/">
+      <pdfaid:part>3</pdfaid:part>
+      <pdfaid:conformance>B</pdfaid:conformance>
+    </rdf:Description>
+
+    <rdf:Description rdf:about=""
+        xmlns:pdfaExtension="http://www.aiim.org/pdfa/ns/extension/"
+        xmlns:pdfaSchema="http://www.aiim.org/pdfa/ns/schema#"
+        xmlns:pdfaProperty="http://www.aiim.org/pdfa/ns/property#">
+      <pdfaExtension:schemas>
+        <rdf:Bag>
+          <rdf:li rdf:parseType="Resource">
+            <pdfaSchema:schema>Factur-X PDFA Extension Schema</pdfaSchema:schema>
+            <pdfaSchema:namespaceURI>urn:factur-x:pdfa:CrossIndustryDocument:invoice:1p0#</pdfaSchema:namespaceURI>
+            <pdfaSchema:prefix>fx</pdfaSchema:prefix>
+            <pdfaSchema:property>
+              <rdf:Seq>
+                <rdf:li rdf:parseType="Resource">
+                  <pdfaProperty:name>DocumentFileName</pdfaProperty:name>
+                  <pdfaProperty:valueType>Text</pdfaProperty:valueType>
+                  <pdfaProperty:category>external</pdfaProperty:category>
+                  <pdfaProperty:description>Name of the embedded XML invoice file</pdfaProperty:description>
+                </rdf:li>
+                <rdf:li rdf:parseType="Resource">
+                  <pdfaProperty:name>DocumentType</pdfaProperty:name>
+                  <pdfaProperty:valueType>Text</pdfaProperty:valueType>
+                  <pdfaProperty:category>external</pdfaProperty:category>
+                  <pdfaProperty:description>INVOICE</pdfaProperty:description>
+                </rdf:li>
+                <rdf:li rdf:parseType="Resource">
+                  <pdfaProperty:name>ConformanceLevel</pdfaProperty:name>
+                  <pdfaProperty:valueType>Text</pdfaProperty:valueType>
+                  <pdfaProperty:category>external</pdfaProperty:category>
+                  <pdfaProperty:description>Factur-X conformance level</pdfaProperty:description>
+                </rdf:li>
+                <rdf:li rdf:parseType="Resource">
+                  <pdfaProperty:name>Version</pdfaProperty:name>
+                  <pdfaProperty:valueType>Text</pdfaProperty:valueType>
+                  <pdfaProperty:category>external</pdfaProperty:category>
+                  <pdfaProperty:description>Version of the Factur-X XML schema</pdfaProperty:description>
+                </rdf:li>
+              </rdf:Seq>
+            </pdfaSchema:property>
+          </rdf:li>
+        </rdf:Bag>
+      </pdfaExtension:schemas>
+    </rdf:Description>
+
+    <rdf:Description rdf:about=""
+        xmlns:fx="urn:factur-x:pdfa:CrossIndustryDocument:invoice:1p0#">
+      <fx:DocumentFileName>${esc(opts.documentFileName)}</fx:DocumentFileName>
+      <fx:DocumentType>INVOICE</fx:DocumentType>
+      <fx:ConformanceLevel>${esc(opts.conformanceLevel)}</fx:ConformanceLevel>
+      <fx:Version>1.0</fx:Version>
+    </rdf:Description>
+
+  </rdf:RDF>
+</x:xmpmeta>
+<?xpacket end="w"?>`;
+}
+async function embedFacturX(options) {
+  const {
+    pdf,
+    profile,
+    flavor = "factur-x" /* FACTUR_X */,
+    validateBeforeEmbed = true,
+    validateXsd: runXsdValidation = false,
+    addPdfA3Metadata = true,
+    meta
+  } = options;
+  if (!options.xml && !options.input) {
+    throw new Error('Either "xml" or "input" must be provided to embedFacturX.');
+  }
+  validateFlavorProfile(flavor, profile);
+  const flavorConfig = getFlavorConfig(flavor);
+  let xml = options.xml;
+  let validation;
+  let xsdValidation;
+  if (!xml) {
+    const input = options.input;
+    if (validateBeforeEmbed) {
+      validation = validateInput(input, profile);
+      if (!validation.valid) {
+        throw new Error(
+          `Input validation failed for profile "${profile}":
+` + validation.errors.map((e) => `  - ${e.field}: ${e.message}`).join("\n")
+        );
+      }
+    }
+    xml = buildXml(input, profile, flavor);
+  }
+  if (runXsdValidation) {
+    xsdValidation = await validateXsd(xml, profile);
+    if (!xsdValidation.valid) {
+      throw new Error(
+        `XSD validation failed for profile "${profile}":
+` + xsdValidation.errors.map((e) => `  - ${e.message}`).join("\n")
+      );
+    }
+  }
+  const pdfDoc = await PDFDocument.load(pdf, { updateMetadata: false });
+  const xmlBytes = new TextEncoder().encode(xml);
+  const afRel = resolveAfRelationship(profile, options.afRelationship);
+  await pdfDoc.attach(xmlBytes, flavorConfig.attachmentFilename, {
+    mimeType: "text/xml",
+    afRelationship: afRel,
+    description: "Factur-X Invoice"
+  });
+  const now = /* @__PURE__ */ new Date();
+  const title = meta?.title ?? "Factur-X Invoice";
+  const author = meta?.author ?? "";
+  const subject = meta?.subject ?? "";
+  const creator = meta?.creator ?? "factur-x";
+  const producer = "factur-x (pdf-lib)";
+  pdfDoc.setTitle(title);
+  if (author) pdfDoc.setAuthor(author);
+  if (subject) pdfDoc.setSubject(subject);
+  pdfDoc.setCreator(creator);
+  pdfDoc.setProducer(producer);
+  pdfDoc.setCreationDate(now);
+  pdfDoc.setModificationDate(now);
+  if (addPdfA3Metadata) {
+    const isoDate = now.toISOString();
+    const xmpXml = buildXmpMetadata({
+      title,
+      author,
+      subject,
+      creator,
+      producer,
+      createDate: isoDate,
+      modifyDate: isoDate,
+      documentFileName: flavorConfig.attachmentFilename,
+      conformanceLevel: profile
+    });
+    const xmpBytes = new TextEncoder().encode(xmpXml);
+    const metadataStream = pdfDoc.context.stream(xmpBytes, {
+      Type: "Metadata",
+      Subtype: "XML",
+      Length: xmpBytes.length
+    });
+    const metadataRef = pdfDoc.context.register(metadataStream);
+    pdfDoc.catalog.set(PDFName.of("Metadata"), metadataRef);
+  }
+  const resultPdf = await pdfDoc.save();
+  return {
+    pdf: resultPdf,
+    xml,
+    ...validation ? { validation } : {},
+    ...xsdValidation ? { xsdValidation } : {}
+  };
+}
+var KNOWN_ATTACHMENT_NAMES = [
+  "factur-x.xml",
+  "xrechnung.xml",
+  "zugferd-invoice.xml",
+  "ZUGFeRD-invoice.xml"
+];
+function decodePdfString(obj) {
+  if (obj instanceof PDFString) return obj.decodeText();
+  if (obj instanceof PDFHexString) return obj.decodeText();
+  if (typeof obj === "string") return obj;
+  return void 0;
+}
+function resolve(doc, obj) {
+  if (obj instanceof PDFRef) return doc.context.lookup(obj);
+  return obj;
+}
+function detectProfile(xml) {
+  const profileMap = {
+    "urn:factur-x.eu:1p0:minimum": "MINIMUM" /* MINIMUM */,
+    "urn:factur-x.eu:1p0:basicwl": "BASIC_WL" /* BASIC_WL */,
+    "urn:factur-x.eu:1p0:basic": "BASIC" /* BASIC */,
+    "urn:factur-x.eu:1p0:en16931": "EN16931" /* EN16931 */,
+    "urn:factur-x.eu:1p0:extended": "EXTENDED" /* EXTENDED */,
+    "urn:cen.eu:en16931:2017": "EN16931" /* EN16931 */,
+    "urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0": "EN16931" /* EN16931 */,
+    "urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_2.3": "EN16931" /* EN16931 */,
+    "urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_2.2": "EN16931" /* EN16931 */
+  };
+  for (const [urn, profile] of Object.entries(profileMap)) {
+    if (xml.includes(urn)) return profile;
+  }
+  return void 0;
+}
+async function extractXml(pdf, options) {
+  const pdfDoc = await PDFDocument.load(pdf, { updateMetadata: false });
+  const catalog = pdfDoc.catalog;
+  const namesDict = resolve(pdfDoc, catalog.get(PDFName.of("Names")));
+  if (!(namesDict instanceof PDFDict)) {
+    throw new Error("PDF does not contain a Names dictionary \u2014 no embedded files found.");
+  }
+  const embeddedFilesObj = resolve(pdfDoc, namesDict.get(PDFName.of("EmbeddedFiles")));
+  if (!(embeddedFilesObj instanceof PDFDict)) {
+    throw new Error("PDF does not contain an EmbeddedFiles name tree.");
+  }
+  const targetNames = options?.filename ? [options.filename] : KNOWN_ATTACHMENT_NAMES;
+  const entries = collectNameTreeEntries(pdfDoc, embeddedFilesObj);
+  for (const [name, fileSpecRef] of entries) {
+    if (!targetNames.some((t) => name.toLowerCase() === t.toLowerCase())) {
+      continue;
+    }
+    const fileSpec = resolve(pdfDoc, fileSpecRef);
+    if (!(fileSpec instanceof PDFDict)) continue;
+    const efDict = resolve(pdfDoc, fileSpec.get(PDFName.of("EF")));
+    if (!(efDict instanceof PDFDict)) continue;
+    const streamRef = efDict.get(PDFName.of("F"));
+    const stream = resolve(pdfDoc, streamRef);
+    if (!(stream instanceof PDFStream)) continue;
+    const rawBytes = stream instanceof PDFRawStream ? decodePDFRawStream(stream).decode() : stream.getContents();
+    const xml = new TextDecoder("utf-8").decode(rawBytes);
+    const profile = detectProfile(xml);
+    return { xml, filename: name, profile };
+  }
+  throw new Error(
+    `No Factur-X / ZUGFeRD XML attachment found in PDF. Searched for: ${targetNames.join(", ")}.`
+  );
+}
+function collectNameTreeEntries(doc, node) {
+  const results = [];
+  const namesArray = resolve(doc, node.get(PDFName.of("Names")));
+  if (namesArray instanceof PDFArray) {
+    for (let i = 0; i < namesArray.size(); i += 2) {
+      const keyObj = resolve(doc, namesArray.get(i));
+      const valObj = namesArray.get(i + 1);
+      const key = decodePdfString(keyObj);
+      if (key != null) {
+        results.push([key, valObj]);
+      }
+    }
+  }
+  const kidsArray = resolve(doc, node.get(PDFName.of("Kids")));
+  if (kidsArray instanceof PDFArray) {
+    for (let i = 0; i < kidsArray.size(); i++) {
+      const kid = resolve(doc, kidsArray.get(i));
+      if (kid instanceof PDFDict) {
+        results.push(...collectNameTreeEntries(doc, kid));
+      }
+    }
+  }
+  return results;
+}
+
+// src/core/xrechnung.ts
+function toXRechnung(input, options) {
+  const profile = options?.profile ?? "EN16931" /* EN16931 */;
+  const validate = options?.validate ?? true;
+  validateFlavorProfile("xrechnung" /* XRECHNUNG */, profile);
+  let validation;
+  if (validate) {
+    validation = validateInput(input, profile);
+    if (!validation.valid) {
+      throw new Error(
+        `Input validation failed for XRechnung (profile "${profile}"):
+` + validation.errors.map((e) => `  - ${e.field}: ${e.message}`).join("\n")
+      );
+    }
+  }
+  const enrichedInput = {
+    ...input,
+    document: {
+      ...input.document,
+      businessProcessId: resolveBusinessProcessUrn(input, "xrechnung" /* XRECHNUNG */)
+    }
+  };
+  const xml = buildXml(enrichedInput, profile, "xrechnung" /* XRECHNUNG */);
+  return {
+    xml,
+    ...validation ? { validation } : {}
+  };
+}
+/**
+ * Factur-X Input Object Types
+ *
+ * These types define the structured input for invoice generation across
+ * all supported profiles (MINIMUM → EXTENDED) and flavors (factur-x,
+ * zugferd, xrechnung, chrono-pro).
+ *
+ * Fields are annotated with their EN 16931 Business Term (BT) mapping
+ * and the minimum profile level at which they become relevant.
+ *
+ * @module types/input
+ * @see docs/INPUT_OBJECT_SPECIFICATION.md
+ * @see https://fnfe-mpe.org/factur-x/
+ * @license EUPL-1.2
+ */
+/**
+ * XSD Schema Validation
+ *
+ * Validates generated CII XML against the official Factur-X / ZUGFeRD XSD
+ * schemas using {@link https://github.com/jameslan/libxml2-wasm | libxml2-wasm}
+ * (WebAssembly port of libxml2).
+ *
+ * Schema files are shipped with the package in `schema/` and loaded at
+ * validation time.  Because `libxml2-wasm` is ESM-only, this module uses
+ * dynamic `import()` so the package stays consumable from both CJS and ESM.
+ *
+ * @module validation/xsd-validator
+ * @license EUPL-1.2
+ */
+/**
+ * Factur-X PDF Embedding
+ *
+ * Embeds structured invoice XML into a PDF document and ensures
+ * PDF/A-3 compliance via XMP metadata.
+ *
+ * @module core/embed
+ * @license EUPL-1.2
+ */
+/**
+ * Factur-X / ZUGFeRD XML Extraction from PDF
+ *
+ * Reads an embedded CII XML attachment from a PDF document.
+ * Supports detection of all standard attachment filenames
+ * (`factur-x.xml`, `xrechnung.xml`, `zugferd-invoice.xml`, `ZUGFeRD-invoice.xml`).
+ *
+ * @module core/extract
+ * @license EUPL-1.2
+ */
+/**
+ * XRechnung Generation
+ *
+ * Generates standalone CII XML for German B2G (XRechnung) use.
+ * XRechnung is a pure-XML format (no PDF embedding) that conforms
+ * to EN 16931 with additional PEPPOL/German government requirements.
+ *
+ * @module core/xrechnung
+ * @license EUPL-1.2
+ */
+/**
+ * Factur-X — Embed Structured Invoices into PDF
+ *
+ * Generate Factur-X, ZUGFeRD, and XRechnung compliant invoice XML
+ * from a typed input object, validate it against XSD schemas, and
+ * embed it into PDF/A-3 documents — or output standalone XRechnung XML.
+ * Also extracts existing XML from Factur-X/ZUGFeRD PDFs.
+ *
+ * @packageDocumentation
+ * @license EUPL-1.2
+ *
+ * @example
+ * ```ts
+ * import { embedFacturX, toXRechnung, extractXml } from '@stackforge-eu/factur-x';
+ *
+ * // Embed Factur-X XML into an existing PDF
+ * const result = await embedFacturX({
+ *   pdf: existingPdfBytes,
+ *   input: invoiceData,
+ *   profile: Profile.EN16931,
+ *   flavor: Flavor.ZUGFERD,
+ * });
+ *
+ * // Generate XRechnung XML (no PDF)
+ * const { xml } = toXRechnung(invoiceData);
+ *
+ * // Extract XML from an existing PDF
+ * const { xml: extracted, profile } = await extractXml(pdfBytes);
+ * ```
+ */
+
+export { DocumentTypeCode, FLAVOR_CONFIGS, FLAVOR_DEFAULT_TYPE_CODES, Flavor, PROFILE_MAIN_XSD, PROFILE_SCHEMA_DIRS, PROFILE_URNS, Profile, UnitCode, buildXml, embedFacturX, escapeXml, extractXml, getFlavorConfig, resolveBusinessProcessUrn, resolveTypeCode, toXRechnung, validateFlavorProfile, validateInput, validateXsd };