@jasy/cli 1.0.0-alpha.1

package/dist/core/export.js

@@ -0,0 +1,150 @@
+import { deflateRawSync } from "node:zlib";
+const money = (n) => n.toFixed(2);
+const addressLine = (a) => [a.line1, [a.postCode, a.city].filter(Boolean).join(" "), a.country].filter(Boolean).join(", ");
+/** A flat totals summary, the four amounts a reader cares about. */
+function summary(inv, t) {
+    return {
+        net: t.taxBasisTotal, // BT-109
+        vat: t.taxTotal, // BT-110
+        gross: t.grandTotal, // BT-112
+        due: t.duePayable, // BT-115
+        currency: inv.currency,
+    };
+}
+/** Full invoice model + a computed totals block, pretty-printed. */
+export function exportJson(inv, t) {
+    return JSON.stringify(Object.assign(Object.assign({}, inv), { totals: summary(inv, t) }), null, 2);
+}
+/** A plain-text receipt - no ANSI, safe to pipe or save. */
+export function exportText(inv, t) {
+    const L = [];
+    L.push(`Invoice ${inv.number}`);
+    L.push(`Date    ${inv.issueDate}${inv.dueDate ? `   due ${inv.dueDate}` : ""}`);
+    if (inv.buyerReference)
+        L.push(`Ref     ${inv.buyerReference}`);
+    L.push("");
+    L.push(`From    ${inv.seller.name}`);
+    L.push(`        ${addressLine(inv.seller.address)}`);
+    if (inv.seller.vatId)
+        L.push(`        VAT ${inv.seller.vatId}`);
+    L.push(`To      ${inv.buyer.name}`);
+    L.push(`        ${addressLine(inv.buyer.address)}`);
+    L.push("");
+    L.push(`${"Qty".padEnd(8)}${"Unit".padEnd(6)}${"Item".padEnd(34)}${"Net".padStart(12)}`);
+    inv.lines.forEach((l, i) => {
+        L.push(`${String(l.quantity).padEnd(8)}${l.unit.padEnd(6)}${l.name.slice(0, 33).padEnd(34)}${money(t.lineNets[i]).padStart(12)}`);
+    });
+    L.push("─".repeat(60));
+    const s = summary(inv, t);
+    L.push(`${"Net".padStart(48)}${money(s.net).padStart(12)}`);
+    L.push(`${"VAT".padStart(48)}${money(s.vat).padStart(12)}`);
+    L.push(`${`Total ${s.currency}`.padStart(48)}${money(s.gross).padStart(12)}`);
+    return L.join("\n") + "\n";
+}
+// ── minimal ZIP container (for the .xlsx); each part deflated via zlib ──────────────────────────────
+function crc32(buf) {
+    let c = ~0;
+    for (let i = 0; i < buf.length; i++) {
+        c ^= buf[i];
+        for (let k = 0; k < 8; k++)
+            c = (c >>> 1) ^ (0xedb88320 & -(c & 1));
+    }
+    return ~c >>> 0;
+}
+function zip(files) {
+    const locals = [];
+    const central = [];
+    let offset = 0;
+    for (const f of files) {
+        const name = Buffer.from(f.name, "utf-8");
+        const crc = crc32(f.data); // CRC is always over the *uncompressed* data
+        const raw = f.data.length;
+        const body = deflateRawSync(f.data); // ZIP method 8 = raw DEFLATE
+        const comp = body.length;
+        const local = Buffer.alloc(30);
+        local.writeUInt32LE(0x04034b50, 0);
+        local.writeUInt16LE(20, 4); // version needed
+        local.writeUInt16LE(8, 8); // method 8 = deflate
+        local.writeUInt32LE(crc, 14);
+        local.writeUInt32LE(comp, 18); // compressed size
+        local.writeUInt32LE(raw, 22); // uncompressed size
+        local.writeUInt16LE(name.length, 26);
+        locals.push(local, name, body);
+        const cen = Buffer.alloc(46);
+        cen.writeUInt32LE(0x02014b50, 0);
+        cen.writeUInt16LE(20, 4); // version made by
+        cen.writeUInt16LE(20, 6); // version needed
+        cen.writeUInt16LE(8, 10); // method 8 = deflate
+        cen.writeUInt32LE(crc, 16);
+        cen.writeUInt32LE(comp, 20);
+        cen.writeUInt32LE(raw, 24);
+        cen.writeUInt16LE(name.length, 28);
+        cen.writeUInt32LE(offset, 42); // local header offset
+        central.push(cen, name);
+        offset += local.length + name.length + comp;
+    }
+    const cd = Buffer.concat(central);
+    const eocd = Buffer.alloc(22);
+    eocd.writeUInt32LE(0x06054b50, 0);
+    eocd.writeUInt16LE(files.length, 8);
+    eocd.writeUInt16LE(files.length, 10);
+    eocd.writeUInt32LE(cd.length, 12);
+    eocd.writeUInt32LE(offset, 16);
+    return Buffer.concat([...locals, cd, eocd]);
+}
+/** Escape `& < >` and drop chars illegal in XML 1.0 (everything < 0x20 except tab/LF/CR), one pass. */
+const xmlEsc = (s) => {
+    let out = "";
+    for (let i = 0; i < s.length; i++) {
+        const c = s.charCodeAt(i);
+        if (c < 0x20 && c !== 0x09 && c !== 0x0a && c !== 0x0d)
+            continue;
+        const ch = s[i];
+        out += ch === "&" ? "&amp;" : ch === "<" ? "&lt;" : ch === ">" ? "&gt;" : ch;
+    }
+    return out;
+};
+/** A worksheet cell: inline string or bare number. */
+const cell = (ref, v) => typeof v === "number"
+    ? `<c r="${ref}"><v>${v}</v></c>`
+    : `<c r="${ref}" t="inlineStr"><is><t xml:space="preserve">${xmlEsc(v)}</t></is></c>`;
+const row = (r, cells) => `<row r="${r}">${cells.map((v, i) => cell(`${String.fromCharCode(65 + i)}${r}`, v)).join("")}</row>`;
+/** A minimal single-sheet .xlsx with the invoice header, line items and totals. */
+export function exportXlsx(inv, t) {
+    const s = summary(inv, t);
+    const rows = [];
+    let r = 1;
+    rows.push(row(r++, ["Invoice", inv.number]));
+    rows.push(row(r++, ["Date", inv.issueDate]));
+    if (inv.dueDate)
+        rows.push(row(r++, ["Due", inv.dueDate]));
+    rows.push(row(r++, ["From", inv.seller.name]));
+    rows.push(row(r++, ["To", inv.buyer.name]));
+    r++; // blank
+    rows.push(row(r++, ["Qty", "Unit", "Item", "Net"]));
+    inv.lines.forEach((l, i) => rows.push(row(r++, [l.quantity, l.unit, l.name, t.lineNets[i]])));
+    r++; // blank
+    rows.push(row(r++, ["", "", "Net", s.net]));
+    rows.push(row(r++, ["", "", "VAT", s.vat]));
+    rows.push(row(r++, ["", "", `Total ${s.currency}`, s.gross]));
+    const sheet = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><worksheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main"><sheetData>${rows.join("")}</sheetData></worksheet>`;
+    const workbook = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><workbook xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"><sheets><sheet name="Invoice" sheetId="1" r:id="rId1"/></sheets></workbook>`;
+    const wbRels = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet" Target="worksheets/sheet1.xml"/></Relationships>`;
+    const rootRels = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="xl/workbook.xml"/></Relationships>`;
+    const contentTypes = `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="xml" ContentType="application/xml"/><Override PartName="/xl/workbook.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml"/><Override PartName="/xl/worksheets/sheet1.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml"/></Types>`;
+    return zip([
+        { name: "[Content_Types].xml", data: Buffer.from(contentTypes) },
+        { name: "_rels/.rels", data: Buffer.from(rootRels) },
+        { name: "xl/workbook.xml", data: Buffer.from(workbook) },
+        { name: "xl/_rels/workbook.xml.rels", data: Buffer.from(wbRels) },
+        { name: "xl/worksheets/sheet1.xml", data: Buffer.from(sheet) },
+    ]);
+}
+/** Export to the requested format - string for json/txt, Buffer for the binary xlsx. */
+export function exportInvoice(inv, t, format) {
+    if (format === "json")
+        return exportJson(inv, t);
+    if (format === "txt")
+        return exportText(inv, t);
+    return exportXlsx(inv, t);
+}

package/dist/core/extract.d.ts

@@ -0,0 +1,2 @@
+/** The embedded XML of a ZUGFeRD / XRechnung PDF, as a UTF-8 string. Throws if the PDF carries none. */
+export declare function extractEmbeddedXml(pdf: Uint8Array): string;

package/dist/core/extract.js

@@ -0,0 +1,80 @@
+import { inflateSync } from "node:zlib";
+// PDF → embedded XML. Pulls the e-invoice XML (factur-x.xml) out of a ZUGFeRD / XRechnung PDF/A-3.
+// Minimal by design: we do NOT parse the whole PDF (no pdf.js). We resolve the /EmbeddedFile stream
+// object, read its bytes, and FlateDecode-inflate them when filtered. jasy *wrote* the PDF - here we
+// read the embedded part back out. The foundation the whole CLI hangs off (read → parse → validate).
+/** The embedded XML of a ZUGFeRD / XRechnung PDF, as a UTF-8 string. Throws if the PDF carries none. */
+export function extractEmbeddedXml(pdf) {
+    const buf = Buffer.from(pdf);
+    const s = buf.toString("latin1"); // 1 byte per char → string index == byte offset
+    const objNum = findEmbeddedFileObject(s);
+    if (objNum === null) {
+        throw new Error("No embedded XML found - is this a ZUGFeRD / Factur-X PDF?");
+    }
+    const obj = locateObject(s, objNum);
+    if (!obj)
+        throw new Error(`Embedded-file object ${objNum} not found in the PDF.`);
+    const bytes = readStream(buf, s, obj.dataStart, obj.dict);
+    const flated = /\/Filter\s*(?:\[\s*)?\/FlateDecode/.test(obj.dict);
+    return (flated ? inflateSync(bytes) : bytes).toString("utf-8");
+}
+// The e-invoice XML's EmbeddedFile object number. A PDF may embed SEVERAL files (e.g. a tool also
+// attaches its own gobl.json / source) - so we collect every Filespec and pick the invoice XML by name
+// (factur-x.xml / zugferd-invoice.xml / xrechnung.xml / order-x.xml), then any .xml, then the first.
+function findEmbeddedFileObject(s) {
+    var _a, _b;
+    const specs = [];
+    const efRe = /\/EF\s*<<[^>]*?\/(?:UF|F)\s+(\d+)\s+0\s+R/g;
+    for (let m = efRe.exec(s); m; m = efRe.exec(s)) {
+        specs.push({ obj: Number(m[1]), name: filespecName(s, m.index) });
+    }
+    if (specs.length) {
+        const invoiceXml = /(factur-x|zugferd-invoice|xrechnung|order-x|cii)\.xml$/i;
+        const pick = (_b = (_a = specs.find((sp) => invoiceXml.test(sp.name))) !== null && _a !== void 0 ? _a : specs.find((sp) => /\.xml$/i.test(sp.name))) !== null && _b !== void 0 ? _b : specs[0];
+        return pick.obj;
+    }
+    const t = s.search(/\/Type\s*\/EmbeddedFile/);
+    if (t >= 0) {
+        // the enclosing "N 0 obj" is the last object definition before the /Type
+        const m = s.slice(0, t).match(/(\d+)\s+0\s+obj(?![\s\S]*\d+\s+0\s+obj)/);
+        if (m)
+            return Number(m[1]);
+    }
+    return null;
+}
+/** The /F or /UF filename of the Filespec that owns the /EF at `idx` (look just before it, else after). */
+function filespecName(s, idx) {
+    const before = s.slice(Math.max(0, idx - 400), idx).match(/\/(?:UF|F)\s*\(([^)]*)\)[^(]*$/);
+    if (before)
+        return before[1];
+    const after = s.slice(idx, idx + 400).match(/\/(?:UF|F)\s*\(([^)]*)\)/);
+    return after ? after[1] : "";
+}
+function locateObject(s, objNum) {
+    const m = new RegExp(`(?:^|[^0-9])${objNum}\\s+0\\s+obj`).exec(s);
+    if (!m)
+        return null;
+    const streamKw = s.indexOf("stream", m.index + m[0].length);
+    if (streamKw < 0)
+        return null;
+    const dict = s.slice(m.index + m[0].length, streamKw);
+    // "stream" is followed by CRLF or LF before the data begins
+    let dataStart = streamKw + "stream".length;
+    if (s[dataStart] === "\r")
+        dataStart++;
+    if (s[dataStart] === "\n")
+        dataStart++;
+    return { dict, dataStart };
+}
+// Stream bytes: the direct /Length when present (precise), else everything up to "endstream".
+function readStream(buf, s, dataStart, dict) {
+    const len = dict.match(/\/Length\s+(\d+)(?!\s+\d+\s+R)/); // direct length, not an indirect ref
+    if (len)
+        return buf.subarray(dataStart, dataStart + Number(len[1]));
+    let end = s.indexOf("endstream", dataStart);
+    if (s[end - 1] === "\n")
+        end--;
+    if (s[end - 1] === "\r")
+        end--;
+    return buf.subarray(dataStart, end);
+}

package/dist/core/parse.d.ts

@@ -0,0 +1,7 @@
+import type { Invoice } from "@jasy/zugferd";
+/** Parse a UN/CEFACT CII invoice (EN16931 / ZUGFeRD / XRechnung-CII) into the Invoice model. */
+export declare function parseCII(xml: string): Invoice;
+/** Parse an OASIS UBL invoice (EN16931 / PEPPOL / XRechnung-UBL) into the Invoice model. */
+export declare function parseUBL(xml: string): Invoice;
+/** Parse e-invoice XML into the Invoice model, picking CII/UBL from what it is. */
+export declare function parseInvoice(xml: string): Invoice;

package/dist/core/parse.js

@@ -0,0 +1,395 @@
+import { detectInvoice } from "./detect.js";
+// XML → Invoice. Hand-rolled, scope-based extraction of the known EN16931 tags (we emit them in
+// @jasy/zugferd, so we know every path). No XML-parser dependency. CII first; UBL plugs in next.
+// Round-trip safe: parsing an invoice we generated and re-emitting reproduces the same XML.
+const unesc = (s) => s.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
+/** Inner content of the first `<tag …>…</tag>` (CII tags don't self-nest, so non-greedy is exact). */
+function inner(xml, tag) {
+    var _a;
+    if (xml === undefined)
+        return undefined;
+    return (_a = new RegExp(`<${tag}(?:\\s[^>]*)?>([\\s\\S]*?)</${tag}>`).exec(xml)) === null || _a === void 0 ? void 0 : _a[1];
+}
+/** Inner content of every `<tag …>…</tag>`. */
+function innerAll(xml, tag) {
+    if (xml === undefined)
+        return [];
+    const re = new RegExp(`<${tag}(?:\\s[^>]*)?>([\\s\\S]*?)</${tag}>`, "g");
+    const out = [];
+    for (let m = re.exec(xml); m; m = re.exec(xml))
+        out.push(m[1]);
+    return out;
+}
+/** Text value of the first leaf `<tag …>value</tag>`, unescaped. */
+function val(xml, tag) {
+    const c = inner(xml, tag);
+    return c === undefined ? undefined : unesc(c);
+}
+/** An attribute on the first `<tag … name="X" …>`. */
+function attr(xml, tag, name) {
+    var _a;
+    if (xml === undefined)
+        return undefined;
+    return (_a = new RegExp(`<${tag}\\s[^>]*\\b${name}="([^"]*)"`).exec(xml)) === null || _a === void 0 ? void 0 : _a[1];
+}
+const num = (s) => (s === undefined ? 0 : parseFloat(s));
+/** `format="102"` date `20260620` → `2026-06-20`. */
+function date(scope) {
+    const d = val(scope, "udt:DateTimeString");
+    return d && d.length === 8 ? `${d.slice(0, 4)}-${d.slice(4, 6)}-${d.slice(6, 8)}` : undefined;
+}
+function parseAddress(s) {
+    var _a;
+    return {
+        postCode: val(s, "ram:PostcodeCode"),
+        line1: val(s, "ram:LineOne"),
+        line2: val(s, "ram:LineTwo"),
+        line3: val(s, "ram:LineThree"),
+        city: val(s, "ram:CityName"),
+        subdivision: val(s, "ram:CountrySubDivisionName"),
+        country: (_a = val(s, "ram:CountryID")) !== null && _a !== void 0 ? _a : "",
+    };
+}
+function parseContact(s) {
+    if (!s)
+        return undefined;
+    const c = {
+        name: val(s, "ram:PersonName"),
+        phone: val(inner(s, "ram:TelephoneUniversalCommunication"), "ram:CompleteNumber"),
+        email: val(inner(s, "ram:EmailURIUniversalCommunication"), "ram:URIID"),
+    };
+    return c.name || c.phone || c.email ? c : undefined;
+}
+/** `<ram:ID schemeID="VA">…</ram:ID>` inside a party's tax registrations (VA = VAT id, FC = tax no.). */
+function taxReg(s, scheme) {
+    const m = new RegExp(`<ram:ID schemeID="${scheme}">([^<]*)</ram:ID>`).exec(s);
+    return m ? unesc(m[1]) : undefined;
+}
+function parseSeller(s) {
+    var _a, _b;
+    const org = inner(s, "ram:SpecifiedLegalOrganization");
+    return {
+        name: (_a = val(s, "ram:Name")) !== null && _a !== void 0 ? _a : "",
+        tradingName: val(org, "ram:TradingBusinessName"),
+        legalRegistrationId: val(org, "ram:ID"),
+        vatId: taxReg(s, "VA"),
+        taxNumber: taxReg(s, "FC"),
+        electronicAddress: val(inner(s, "ram:URIUniversalCommunication"), "ram:URIID"),
+        address: parseAddress((_b = inner(s, "ram:PostalTradeAddress")) !== null && _b !== void 0 ? _b : ""),
+        contact: parseContact(inner(s, "ram:DefinedTradeContact")),
+    };
+}
+function parseBuyer(s) {
+    var _a, _b;
+    const org = inner(s, "ram:SpecifiedLegalOrganization");
+    return {
+        name: (_a = val(s, "ram:Name")) !== null && _a !== void 0 ? _a : "",
+        tradingName: val(org, "ram:TradingBusinessName"),
+        legalRegistrationId: val(org, "ram:ID"),
+        vatId: taxReg(s, "VA"),
+        electronicAddress: val(inner(s, "ram:URIUniversalCommunication"), "ram:URIID"),
+        address: parseAddress((_b = inner(s, "ram:PostalTradeAddress")) !== null && _b !== void 0 ? _b : ""),
+        contact: parseContact(inner(s, "ram:DefinedTradeContact")),
+    };
+}
+function parseLine(s, index) {
+    var _a, _b, _c, _d, _e, _f, _g, _h;
+    const doc = (_a = inner(s, "ram:AssociatedDocumentLineDocument")) !== null && _a !== void 0 ? _a : "";
+    const product = (_b = inner(s, "ram:SpecifiedTradeProduct")) !== null && _b !== void 0 ? _b : "";
+    const price = (_c = inner(s, "ram:NetPriceProductTradePrice")) !== null && _c !== void 0 ? _c : "";
+    const del = (_d = inner(s, "ram:SpecifiedLineTradeDelivery")) !== null && _d !== void 0 ? _d : "";
+    const tax = (_e = inner(inner(s, "ram:SpecifiedLineTradeSettlement"), "ram:ApplicableTradeTax")) !== null && _e !== void 0 ? _e : "";
+    const id = val(doc, "ram:LineID");
+    const note = inner(doc, "ram:IncludedNote");
+    const basis = inner(price, "ram:BasisQuantity");
+    return {
+        id: id !== undefined && id !== String(index + 1) ? id : undefined, // omit the auto-number
+        name: (_f = val(product, "ram:Name")) !== null && _f !== void 0 ? _f : "",
+        description: val(product, "ram:Description"),
+        sellerItemId: val(product, "ram:SellerAssignedID"),
+        buyerItemId: val(product, "ram:BuyerAssignedID"),
+        standardItemId: val(product, "ram:GlobalID"),
+        quantity: num(val(del, "ram:BilledQuantity")),
+        unit: (_g = attr(del, "ram:BilledQuantity", "unitCode")) !== null && _g !== void 0 ? _g : "",
+        netUnitPrice: num(val(price, "ram:ChargeAmount")),
+        priceBaseQuantity: basis ? num(val(price, "ram:BasisQuantity")) : undefined,
+        vat: {
+            category: ((_h = val(tax, "ram:CategoryCode")) !== null && _h !== void 0 ? _h : "S"),
+            ratePercent: num(val(tax, "ram:RateApplicablePercent")),
+        },
+        note: note ? val(note, "ram:Content") : undefined,
+    };
+}
+/** A document-level allowance (discount) or charge (surcharge), BG-20 / BG-21. */
+function parseAllowanceCii(ac) {
+    var _a;
+    const cat = inner(ac, "ram:CategoryTradeTax");
+    return {
+        isCharge: val(inner(ac, "ram:ChargeIndicator"), "udt:Indicator") === "true",
+        amount: num(val(ac, "ram:ActualAmount")),
+        reason: val(ac, "ram:Reason"),
+        reasonCode: val(ac, "ram:ReasonCode"),
+        vat: {
+            category: ((_a = val(cat, "ram:CategoryCode")) !== null && _a !== void 0 ? _a : "S"),
+            ratePercent: num(val(cat, "ram:RateApplicablePercent")),
+        },
+    };
+}
+/** VAT exemption reasons (BT-120/121) keyed by category, read off the BG-23 breakdown groups. */
+function exemptionsCii(set) {
+    const out = {};
+    for (const g of innerAll(set, "ram:ApplicableTradeTax")) {
+        const cat = val(g, "ram:CategoryCode");
+        const text = val(g, "ram:ExemptionReason");
+        const code = val(g, "ram:ExemptionReasonCode");
+        if (cat && (text || code))
+            out[cat] = { text, code };
+    }
+    return Object.keys(out).length ? out : undefined;
+}
+/** Parse a UN/CEFACT CII invoice (EN16931 / ZUGFeRD / XRechnung-CII) into the Invoice model. */
+export function parseCII(xml) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    const header = (_a = inner(xml, "rsm:ExchangedDocument")) !== null && _a !== void 0 ? _a : "";
+    const tx = (_b = inner(xml, "rsm:SupplyChainTradeTransaction")) !== null && _b !== void 0 ? _b : "";
+    const agr = (_c = inner(tx, "ram:ApplicableHeaderTradeAgreement")) !== null && _c !== void 0 ? _c : "";
+    const del = (_d = inner(tx, "ram:ApplicableHeaderTradeDelivery")) !== null && _d !== void 0 ? _d : "";
+    const set = (_e = inner(tx, "ram:ApplicableHeaderTradeSettlement")) !== null && _e !== void 0 ? _e : "";
+    const type = num(val(header, "ram:TypeCode"));
+    const notes = innerAll(header, "ram:IncludedNote")
+        .map((n) => val(n, "ram:Content"))
+        .filter((n) => !!n);
+    const shipTo = inner(del, "ram:ShipToTradeParty");
+    const deliveryDate = date(inner(del, "ram:ActualDeliverySupplyChainEvent"));
+    const delivery = shipTo || deliveryDate
+        ? {
+            date: deliveryDate,
+            recipientName: val(shipTo, "ram:Name"),
+            address: shipTo && inner(shipTo, "ram:PostalTradeAddress")
+                ? parseAddress(inner(shipTo, "ram:PostalTradeAddress"))
+                : undefined,
+        }
+        : undefined;
+    const pm = inner(set, "ram:SpecifiedTradeSettlementPaymentMeans");
+    const acct = inner(pm, "ram:PayeePartyCreditorFinancialAccount");
+    const inst = inner(pm, "ram:PayeeSpecifiedCreditorFinancialInstitution");
+    const terms = inner(set, "ram:SpecifiedTradePaymentTerms");
+    const payment = pm || terms
+        ? {
+            meansCode: val(pm, "ram:TypeCode"),
+            meansText: val(pm, "ram:Information"),
+            iban: val(acct, "ram:IBANID"),
+            accountName: val(acct, "ram:AccountName"),
+            bic: val(inst, "ram:BICID"),
+            terms: val(terms, "ram:Description"),
+        }
+        : undefined;
+    const totals = inner(set, "ram:SpecifiedTradeSettlementHeaderMonetarySummation");
+    const paid = val(totals, "ram:TotalPrepaidAmount");
+    const allowancesCharges = innerAll(set, "ram:SpecifiedTradeAllowanceCharge").map(parseAllowanceCii);
+    return {
+        number: (_f = val(header, "ram:ID")) !== null && _f !== void 0 ? _f : "",
+        issueDate: (_g = date(inner(header, "ram:IssueDateTime"))) !== null && _g !== void 0 ? _g : "",
+        type: type && type !== 380 ? type : undefined,
+        currency: (_h = val(set, "ram:InvoiceCurrencyCode")) !== null && _h !== void 0 ? _h : "",
+        dueDate: date(inner(terms, "ram:DueDateDateTime")),
+        buyerReference: val(agr, "ram:BuyerReference"),
+        purchaseOrderRef: val(inner(agr, "ram:BuyerOrderReferencedDocument"), "ram:IssuerAssignedID"),
+        contractRef: val(inner(agr, "ram:ContractReferencedDocument"), "ram:IssuerAssignedID"),
+        notes: notes.length ? notes : undefined,
+        seller: parseSeller((_j = inner(agr, "ram:SellerTradeParty")) !== null && _j !== void 0 ? _j : ""),
+        buyer: parseBuyer((_k = inner(agr, "ram:BuyerTradeParty")) !== null && _k !== void 0 ? _k : ""),
+        delivery,
+        payeeName: val(inner(set, "ram:PayeeTradeParty"), "ram:Name"),
+        lines: innerAll(tx, "ram:IncludedSupplyChainTradeLineItem").map(parseLine),
+        allowancesCharges: allowancesCharges.length ? allowancesCharges : undefined,
+        vatExemptionReasons: exemptionsCii(set),
+        payment,
+        paidAmount: paid ? num(paid) : undefined,
+    };
+}
+// ── UBL (OASIS Invoice-2) - the second EN16931 syntax (PEPPOL; XRechnung accepts it too) ────────────
+function parseAddressUbl(s) {
+    var _a;
+    return {
+        line1: val(s, "cbc:StreetName"),
+        line2: val(s, "cbc:AdditionalStreetName"),
+        line3: val(inner(s, "cac:AddressLine"), "cbc:Line"),
+        city: val(s, "cbc:CityName"),
+        postCode: val(s, "cbc:PostalZone"),
+        subdivision: val(s, "cbc:CountrySubentity"),
+        country: (_a = val(inner(s, "cac:Country"), "cbc:IdentificationCode")) !== null && _a !== void 0 ? _a : "",
+    };
+}
+function parseContactUbl(s) {
+    if (!s)
+        return undefined;
+    const c = {
+        name: val(s, "cbc:Name"),
+        phone: val(s, "cbc:Telephone"),
+        email: val(s, "cbc:ElectronicMail"),
+    };
+    return c.name || c.phone || c.email ? c : undefined;
+}
+/** A party's tax id by scheme: the cbc:CompanyID whose cac:TaxScheme is "VAT" (BT-31) or "FC" (BT-32). */
+function ublTaxId(party, scheme) {
+    for (const pts of innerAll(party, "cac:PartyTaxScheme")) {
+        if (val(inner(pts, "cac:TaxScheme"), "cbc:ID") === scheme)
+            return val(pts, "cbc:CompanyID");
+    }
+    return undefined;
+}
+function parsePartyUbl(scope) {
+    var _a, _b, _c;
+    const party = (_a = inner(scope, "cac:Party")) !== null && _a !== void 0 ? _a : "";
+    const legal = inner(party, "cac:PartyLegalEntity");
+    return {
+        party,
+        name: (_b = val(legal, "cbc:RegistrationName")) !== null && _b !== void 0 ? _b : "",
+        tradingName: val(inner(party, "cac:PartyName"), "cbc:Name"),
+        legalRegistrationId: val(legal, "cbc:CompanyID"),
+        vatId: ublTaxId(party, "VAT"),
+        electronicAddress: val(party, "cbc:EndpointID"),
+        address: parseAddressUbl((_c = inner(party, "cac:PostalAddress")) !== null && _c !== void 0 ? _c : ""),
+        contact: parseContactUbl(inner(party, "cac:Contact")),
+    };
+}
+function parseLineUbl(s, index) {
+    var _a, _b, _c, _d, _e, _f;
+    const item = (_a = inner(s, "cac:Item")) !== null && _a !== void 0 ? _a : "";
+    const price = (_b = inner(s, "cac:Price")) !== null && _b !== void 0 ? _b : "";
+    const tax = (_c = inner(item, "cac:ClassifiedTaxCategory")) !== null && _c !== void 0 ? _c : "";
+    const id = val(s, "cbc:ID");
+    const base = val(price, "cbc:BaseQuantity");
+    return {
+        id: id !== undefined && id !== String(index + 1) ? id : undefined, // omit the auto-number
+        name: (_d = val(item, "cbc:Name")) !== null && _d !== void 0 ? _d : "",
+        description: val(item, "cbc:Description"),
+        sellerItemId: val(inner(item, "cac:SellersItemIdentification"), "cbc:ID"),
+        buyerItemId: val(inner(item, "cac:BuyersItemIdentification"), "cbc:ID"),
+        standardItemId: val(inner(item, "cac:StandardItemIdentification"), "cbc:ID"),
+        quantity: num(val(s, "cbc:InvoicedQuantity")),
+        unit: (_e = attr(s, "cbc:InvoicedQuantity", "unitCode")) !== null && _e !== void 0 ? _e : "",
+        netUnitPrice: num(val(price, "cbc:PriceAmount")),
+        priceBaseQuantity: base !== undefined ? num(base) : undefined,
+        vat: {
+            category: ((_f = val(tax, "cbc:ID")) !== null && _f !== void 0 ? _f : "S"),
+            ratePercent: num(val(tax, "cbc:Percent")),
+        },
+        note: val(s, "cbc:Note"),
+    };
+}
+function parseAllowanceUbl(ac) {
+    var _a;
+    const cat = inner(ac, "cac:TaxCategory");
+    return {
+        isCharge: val(ac, "cbc:ChargeIndicator") === "true",
+        amount: num(val(ac, "cbc:Amount")),
+        reason: val(ac, "cbc:AllowanceChargeReason"),
+        reasonCode: val(ac, "cbc:AllowanceChargeReasonCode"),
+        vat: {
+            category: ((_a = val(cat, "cbc:ID")) !== null && _a !== void 0 ? _a : "S"),
+            ratePercent: num(val(cat, "cbc:Percent")),
+        },
+    };
+}
+function exemptionsUbl(xml) {
+    const out = {};
+    for (const sub of innerAll(inner(xml, "cac:TaxTotal"), "cac:TaxSubtotal")) {
+        const tc = inner(sub, "cac:TaxCategory");
+        const cat = val(tc, "cbc:ID");
+        const text = val(tc, "cbc:TaxExemptionReason");
+        const code = val(tc, "cbc:TaxExemptionReasonCode");
+        if (cat && (text || code))
+            out[cat] = { text, code };
+    }
+    return Object.keys(out).length ? out : undefined;
+}
+/** Parse an OASIS UBL invoice (EN16931 / PEPPOL / XRechnung-UBL) into the Invoice model. */
+export function parseUBL(xml) {
+    var _a, _b, _c, _d, _e;
+    // UBL has no head wrapper; the header fields are direct children before the supplier party
+    const cut = xml.indexOf("<cac:AccountingSupplierParty");
+    const head = cut >= 0 ? xml.slice(0, cut) : xml;
+    const seller = parsePartyUbl((_a = inner(xml, "cac:AccountingSupplierParty")) !== null && _a !== void 0 ? _a : "");
+    const buyer = parsePartyUbl((_b = inner(xml, "cac:AccountingCustomerParty")) !== null && _b !== void 0 ? _b : "");
+    const type = num(val(head, "cbc:InvoiceTypeCode"));
+    const notes = innerAll(head, "cbc:Note")
+        .map(unesc)
+        .filter((n) => n.length > 0);
+    const del = inner(xml, "cac:Delivery");
+    const dLoc = inner(del, "cac:DeliveryLocation");
+    const deliveryDate = val(del, "cbc:ActualDeliveryDate"); // UBL dates are plain ISO, no 102 format
+    const dParty = inner(del, "cac:DeliveryParty");
+    const delivery = del && (deliveryDate || dParty || dLoc)
+        ? {
+            date: deliveryDate,
+            recipientName: val(inner(dParty, "cac:PartyName"), "cbc:Name"),
+            address: inner(dLoc, "cac:PostalAddress")
+                ? parseAddressUbl(inner(dLoc, "cac:PostalAddress"))
+                : undefined,
+        }
+        : undefined;
+    const pm = inner(xml, "cac:PaymentMeans");
+    const acct = inner(pm, "cac:PayeeFinancialAccount");
+    const terms = inner(xml, "cac:PaymentTerms");
+    const payment = pm || terms
+        ? {
+            meansCode: val(pm, "cbc:PaymentMeansCode"),
+            reference: val(pm, "cbc:PaymentID"),
+            iban: val(acct, "cbc:ID"),
+            accountName: val(acct, "cbc:Name"),
+            bic: val(inner(acct, "cac:FinancialInstitutionBranch"), "cbc:ID"),
+            terms: val(terms, "cbc:Note"),
+        }
+        : undefined;
+    const paid = val(inner(xml, "cac:LegalMonetaryTotal"), "cbc:PrepaidAmount");
+    // document-level allowances/charges live before the lines (UBL also allows them per-line, which we skip)
+    const li = xml.indexOf("<cac:InvoiceLine");
+    const allowancesCharges = innerAll(li >= 0 ? xml.slice(0, li) : xml, "cac:AllowanceCharge").map(parseAllowanceUbl);
+    return {
+        number: (_c = val(head, "cbc:ID")) !== null && _c !== void 0 ? _c : "",
+        issueDate: (_d = val(head, "cbc:IssueDate")) !== null && _d !== void 0 ? _d : "",
+        type: type && type !== 380 ? type : undefined,
+        currency: (_e = val(head, "cbc:DocumentCurrencyCode")) !== null && _e !== void 0 ? _e : "",
+        dueDate: val(head, "cbc:DueDate"),
+        buyerReference: val(head, "cbc:BuyerReference"),
+        purchaseOrderRef: val(inner(head, "cac:OrderReference"), "cbc:ID"),
+        contractRef: val(inner(head, "cac:ContractDocumentReference"), "cbc:ID"),
+        notes: notes.length ? notes : undefined,
+        seller: {
+            name: seller.name,
+            tradingName: seller.tradingName,
+            legalRegistrationId: seller.legalRegistrationId,
+            vatId: seller.vatId,
+            taxNumber: ublTaxId(seller.party, "FC"),
+            electronicAddress: seller.electronicAddress,
+            address: seller.address,
+            contact: seller.contact,
+        },
+        buyer: {
+            name: buyer.name,
+            tradingName: buyer.tradingName,
+            legalRegistrationId: buyer.legalRegistrationId,
+            vatId: buyer.vatId,
+            electronicAddress: buyer.electronicAddress,
+            address: buyer.address,
+            contact: buyer.contact,
+        },
+        delivery,
+        lines: innerAll(xml, "cac:InvoiceLine").map(parseLineUbl),
+        allowancesCharges: allowancesCharges.length ? allowancesCharges : undefined,
+        vatExemptionReasons: exemptionsUbl(xml),
+        payment,
+        paidAmount: paid !== undefined ? num(paid) : undefined,
+    };
+}
+/** Parse e-invoice XML into the Invoice model, picking CII/UBL from what it is. */
+export function parseInvoice(xml) {
+    const { syntax } = detectInvoice(xml);
+    if (syntax === "UBL")
+        return parseUBL(xml);
+    if (syntax === "CII")
+        return parseCII(xml);
+    throw new Error(`${syntax} parsing is not implemented yet`);
+}

package/dist/core/pdfa.d.ts

@@ -0,0 +1,12 @@
+export interface PdfaCheck {
+    id: string;
+    label: string;
+    ok: boolean;
+    detail?: string;
+}
+export interface PdfaReport {
+    /** true when every structural check passed (NOT an ISO certification - see veraPDF for that). */
+    ok: boolean;
+    checks: PdfaCheck[];
+}
+export declare function checkPdfA3(pdf: Uint8Array): PdfaReport;