@ekwo-ai/factur-x 0.4.0

package/dist/rounding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rounding.js","sourceRoot":"","sources":["../src/rounding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,QAAQ,GAAG,CAAC;IACvD,MAAM,MAAM,GAAG,EAAE,IAAI,QAAQ,CAAC;IAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;IACxC,0EAA0E;IAC1E,4EAA4E;IAC5E,iDAAiD;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;IAC7D,qEAAqE;IACrE,sCAAsC;IACtC,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC"}

package/dist/totals.d.ts

@@ -0,0 +1,13 @@
+import type { Invoice, InvoiceLine, InvoiceTotals, VatCategory } from './types.js';
+/** The one rounding rule, at two decimals. See `rounding.ts`. */
+export declare function round2(v: number): number;
+/** The VAT category of a line, explicit or derived from the parties. */
+export declare function lineVatCategory(line: InvoiceLine, invoice: Invoice): VatCategory;
+/** Line net amount (BT-131): explicit, or quantity × unit price rounded to the cent. */
+export declare function lineNetAmount(line: InvoiceLine): number;
+/**
+ * VAT breakdown and document totals, computed the way EN 16931 expects them:
+ * one group per category and rate, VAT computed on the rounded group basis.
+ */
+export declare function computeTotals(invoice: Invoice): InvoiceTotals;
+//# sourceMappingURL=totals.d.ts.map

package/dist/totals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"totals.d.ts","sourceRoot":"","sources":["../src/totals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAgB,WAAW,EAAE,MAAM,YAAY,CAAC;AAIjG,iEAAiE;AACjE,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW,CAUhF;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CA6B7D"}

package/dist/totals.js

@@ -0,0 +1,55 @@
+import { roundCurrency } from './rounding.js';
+import { defaultVatCategory } from './vat.js';
+/** The one rounding rule, at two decimals. See `rounding.ts`. */
+export function round2(v) {
+    return roundCurrency(v, 2);
+}
+/** The VAT category of a line, explicit or derived from the parties. */
+export function lineVatCategory(line, invoice) {
+    return (line.vatCategory ??
+        defaultVatCategory({
+            rate: line.vatRate,
+            sellerCountry: invoice.seller.address.country,
+            buyerCountry: invoice.buyer.address.country,
+            buyerHasVatId: !!invoice.buyer.vatId,
+        }));
+}
+/** Line net amount (BT-131): explicit, or quantity × unit price rounded to the cent. */
+export function lineNetAmount(line) {
+    return round2(line.netAmount ?? line.quantity * line.unitPrice);
+}
+/**
+ * VAT breakdown and document totals, computed the way EN 16931 expects them:
+ * one group per category and rate, VAT computed on the rounded group basis.
+ */
+export function computeTotals(invoice) {
+    const groups = new Map();
+    let lineTotal = 0;
+    for (const line of invoice.lines) {
+        const category = lineVatCategory(line, invoice);
+        const rate = category === 'S' ? line.vatRate : 0;
+        const net = lineNetAmount(line);
+        lineTotal = round2(lineTotal + net);
+        const key = `${category}:${rate}`;
+        const group = groups.get(key) ?? { category, rate, basis: 0, tax: 0 };
+        group.basis = round2(group.basis + net);
+        groups.set(key, group);
+    }
+    let taxTotal = 0;
+    for (const group of groups.values()) {
+        group.tax = round2((group.basis * group.rate) / 100);
+        taxTotal = round2(taxTotal + group.tax);
+    }
+    const grandTotal = round2(lineTotal + taxTotal);
+    const prepaid = round2(invoice.prepaidAmount ?? 0);
+    return {
+        lineTotal,
+        taxBasisTotal: lineTotal,
+        taxTotal,
+        grandTotal,
+        prepaid,
+        duePayable: round2(grandTotal - prepaid),
+        breakdown: [...groups.values()],
+    };
+}
+//# sourceMappingURL=totals.js.map

package/dist/totals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"totals.js","sourceRoot":"","sources":["../src/totals.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C,iEAAiE;AACjE,MAAM,UAAU,MAAM,CAAC,CAAS;IAC9B,OAAO,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,eAAe,CAAC,IAAiB,EAAE,OAAgB;IACjE,OAAO,CACL,IAAI,CAAC,WAAW;QAChB,kBAAkB,CAAC;YACjB,IAAI,EAAE,IAAI,CAAC,OAAO;YAClB,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO;YAC7C,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO;YAC3C,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK;SACrC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAC,IAAiB;IAC7C,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC/C,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAChC,SAAS,GAAG,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;QACtE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QACpC,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACrD,QAAQ,GAAG,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,GAAG,QAAQ,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC;IACnD,OAAO;QACL,SAAS;QACT,aAAa,EAAE,SAAS;QACxB,QAAQ;QACR,UAAU;QACV,OAAO;QACP,UAAU,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC;QACxC,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Public types of `@ekwo-ai/factur-x`. The invoice model is deliberately
+ * small and neutral: it maps one-to-one to the EN 16931 semantic model
+ * without carrying any application-specific field.
+ */
+/** ISO-8601 calendar date, `YYYY-MM-DD`. */
+export type IsoDate = string;
+/** ISO 4217 currency code, e.g. `"EUR"`. */
+export type CurrencyCode = string;
+/**
+ * VAT category codes of EN 16931 (UNTDID 5305 subset).
+ * - `S` standard rate
+ * - `Z` zero rated
+ * - `E` exempt
+ * - `AE` reverse charge
+ * - `K` intra-community supply
+ * - `G` export outside the EU
+ * - `O` not subject to VAT
+ */
+export type VatCategory = 'S' | 'Z' | 'E' | 'AE' | 'K' | 'G' | 'O';
+/**
+ * Factur-X / ZUGFeRD conformance levels. The generator emits the same
+ * structure for `basic` and `en16931`; the level only changes the guideline
+ * identifier in the XML and the XMP metadata of the PDF.
+ */
+export type Profile = 'minimum' | 'basic-wl' | 'basic' | 'en16931' | 'extended';
+/** Document type codes of UNTDID 1001 accepted by Factur-X. */
+export type DocumentType = 'invoice' | 'credit-note' | 'corrected-invoice' | 'self-billed-invoice' | 'prepayment-invoice';
+export interface PostalAddress {
+    line1: string;
+    line2?: string;
+    line3?: string;
+    postalCode: string;
+    city: string;
+    /** ISO 3166-1 alpha-2. */
+    country: string;
+    /** Region, province, state. */
+    subdivision?: string;
+}
+/**
+ * Legal registration identifier with its ISO 6523 ICD scheme
+ * (`"0002"` SIREN/SIRET, `"0208"` Belgian enterprise number, `"0009"` SIRET…).
+ */
+export interface LegalIdentifier {
+    scheme: string;
+    value: string;
+}
+export interface Party {
+    name: string;
+    address: PostalAddress;
+    /** VAT identifier with country prefix, e.g. `"BE0123456749"`. */
+    vatId?: string;
+    /** Legal registration identifier (BT-30 / BT-47). */
+    legalId?: LegalIdentifier;
+    /** Electronic address (BT-34 / BT-49), e.g. an e-mail. */
+    electronicAddress?: {
+        scheme: string;
+        value: string;
+    };
+    /** Contact person (BG-6 / BG-9). */
+    contact?: {
+        name?: string;
+        phone?: string;
+        email?: string;
+    };
+}
+export interface InvoiceLine {
+    /** Line identifier (BT-126). Defaults to the 1-based position. */
+    id?: string;
+    /** Item name (BT-153). */
+    name: string;
+    /** Item description (BT-154). */
+    description?: string;
+    /** Invoiced quantity (BT-129). */
+    quantity: number;
+    /** UN/ECE Recommendation 20 unit code (BT-130). Defaults to `"C62"` (unit). */
+    unitCode?: string;
+    /** Net unit price, excluding VAT (BT-146). */
+    unitPrice: number;
+    /** VAT rate in percent (BT-152), e.g. `21`. */
+    vatRate: number;
+    /** VAT category (BT-151). Derived from the rate and the parties when omitted. */
+    vatCategory?: VatCategory;
+    /** Line net amount (BT-131). Defaults to `quantity × unitPrice`, rounded to the cent. */
+    netAmount?: number;
+    /** Line note (BT-127). */
+    note?: string;
+    /** Seller item identifier (BT-155). */
+    sellerItemId?: string;
+}
+export interface PaymentInstructions {
+    /** UNTDID 4461 code (BT-81). Defaults to `"58"` (SEPA credit transfer) when an IBAN is given. */
+    meansCode?: string;
+    /** Payee IBAN (BT-84). */
+    iban?: string;
+    /** Payee BIC (BT-86). Omitted from the XML below the EN 16931 level. */
+    bic?: string;
+    /** Remittance information (BT-83). */
+    reference?: string;
+    /** Free-text payment terms (BT-20). */
+    terms?: string;
+}
+export interface Invoice {
+    /** Invoice number (BT-1). */
+    number: string;
+    /** Defaults to `"invoice"`. */
+    type?: DocumentType;
+    /** Issue date (BT-2). */
+    issueDate: IsoDate;
+    /** Payment due date (BT-9). */
+    dueDate?: IsoDate;
+    /** Actual delivery date (BT-72). Defaults to the issue date. */
+    deliveryDate?: IsoDate;
+    /** Invoice currency (BT-5). Defaults to `"EUR"`. */
+    currency?: CurrencyCode;
+    seller: Party;
+    buyer: Party;
+    lines: InvoiceLine[];
+    /** Buyer reference (BT-10), e.g. the French « service exécutant » code. */
+    buyerReference?: string;
+    /** Purchase order reference (BT-13). */
+    orderReference?: string;
+    /** Contract reference (BT-12). */
+    contractReference?: string;
+    /** Invoice being corrected or credited (BG-3). */
+    precedingInvoice?: {
+        number: string;
+        issueDate?: IsoDate;
+    };
+    /** Invoice note (BT-22). */
+    note?: string;
+    payment?: PaymentInstructions;
+    /** Amount already paid (BT-113). */
+    prepaidAmount?: number;
+    /**
+     * Overrides the reason texts attached to exempt VAT categories (BT-120).
+     * Defaults are neutral English sentences; see {@link DEFAULT_EXEMPTION_REASONS}.
+     */
+    exemptionReasons?: Partial<Record<Exclude<VatCategory, 'S' | 'Z'>, string>>;
+}
+export interface VatBreakdown {
+    category: VatCategory;
+    rate: number;
+    /** Sum of the line net amounts in this group (BT-116). */
+    basis: number;
+    /** VAT amount of the group (BT-117). */
+    tax: number;
+}
+export interface InvoiceTotals {
+    /** Sum of line net amounts (BT-106). */
+    lineTotal: number;
+    /** Taxable amount (BT-109). */
+    taxBasisTotal: number;
+    /** Total VAT (BT-110). */
+    taxTotal: number;
+    /** Amount with VAT (BT-112). */
+    grandTotal: number;
+    /** Amount already paid (BT-113). */
+    prepaid: number;
+    /** Amount due for payment (BT-115). */
+    duePayable: number;
+    breakdown: VatBreakdown[];
+}
+export interface GenerateOptions {
+    /** Defaults to `"basic"`, the widest-supported level. */
+    profile?: Profile;
+    /** Business process identifier (BT-23). Defaults to `"A1"`. */
+    businessProcess?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Public types of `@ekwo-ai/factur-x`. The invoice model is deliberately
+ * small and neutral: it maps one-to-one to the EN 16931 semantic model
+ * without carrying any application-specific field.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/units.d.ts

@@ -0,0 +1,32 @@
+/**
+ * UN/ECE Recommendation 20 unit codes, and a lenient mapping from the words
+ * people type on invoices (FR / NL / EN / DE).
+ */
+export declare const UNIT_CODES: {
+    readonly UNIT: "C62";
+    readonly PIECE: "H87";
+    readonly HOUR: "HUR";
+    readonly DAY: "DAY";
+    readonly WEEK: "WEE";
+    readonly MONTH: "MON";
+    readonly YEAR: "ANN";
+    readonly KILOGRAM: "KGM";
+    readonly GRAM: "GRM";
+    readonly TONNE: "TNE";
+    readonly LITRE: "LTR";
+    readonly METRE: "MTR";
+    readonly SQUARE_METRE: "MTK";
+    readonly CUBIC_METRE: "MTQ";
+    readonly KILOMETRE: "KMT";
+    readonly KILOWATT_HOUR: "KWH";
+    readonly MEGAWATT_HOUR: "MWH";
+    readonly LOT: "LO";
+    readonly SET: "SET";
+    readonly PACKAGE: "XPK";
+};
+/**
+ * Returns the UN/ECE code for a unit written in words, passes a three-letter
+ * code through, and falls back to `C62` (unit).
+ */
+export declare function toUnitCode(unit: string | null | undefined): string;
+//# sourceMappingURL=units.d.ts.map

package/dist/units.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../src/units.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;CAqBb,CAAC;AAsBX;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAOlE"}

package/dist/units.js

@@ -0,0 +1,61 @@
+/**
+ * UN/ECE Recommendation 20 unit codes, and a lenient mapping from the words
+ * people type on invoices (FR / NL / EN / DE).
+ */
+export const UNIT_CODES = {
+    UNIT: 'C62',
+    PIECE: 'H87',
+    HOUR: 'HUR',
+    DAY: 'DAY',
+    WEEK: 'WEE',
+    MONTH: 'MON',
+    YEAR: 'ANN',
+    KILOGRAM: 'KGM',
+    GRAM: 'GRM',
+    TONNE: 'TNE',
+    LITRE: 'LTR',
+    METRE: 'MTR',
+    SQUARE_METRE: 'MTK',
+    CUBIC_METRE: 'MTQ',
+    KILOMETRE: 'KMT',
+    KILOWATT_HOUR: 'KWH',
+    MEGAWATT_HOUR: 'MWH',
+    LOT: 'LO',
+    SET: 'SET',
+    PACKAGE: 'XPK',
+};
+const WORDS = {
+    // hours
+    h: 'HUR', hr: 'HUR', hour: 'HUR', hours: 'HUR', heure: 'HUR', heures: 'HUR', uur: 'HUR', uren: 'HUR', stunde: 'HUR', stunden: 'HUR',
+    // days
+    d: 'DAY', j: 'DAY', day: 'DAY', days: 'DAY', jour: 'DAY', jours: 'DAY', dag: 'DAY', dagen: 'DAY', tag: 'DAY', tage: 'DAY',
+    // weeks, months, years
+    week: 'WEE', weeks: 'WEE', semaine: 'WEE', semaines: 'WEE', weken: 'WEE', woche: 'WEE',
+    month: 'MON', months: 'MON', mois: 'MON', maand: 'MON', maanden: 'MON', monat: 'MON', monate: 'MON',
+    year: 'ANN', years: 'ANN', an: 'ANN', ans: 'ANN', année: 'ANN', années: 'ANN', jaar: 'ANN', jahr: 'ANN',
+    // mass, volume, length, area
+    kg: 'KGM', kilo: 'KGM', g: 'GRM', t: 'TNE', tonne: 'TNE', l: 'LTR', litre: 'LTR', liter: 'LTR',
+    m: 'MTR', km: 'KMT', m2: 'MTK', 'm²': 'MTK', m3: 'MTQ', 'm³': 'MTQ',
+    // energy
+    kwh: 'KWH', mwh: 'MWH',
+    // counting
+    unit: 'C62', units: 'C62', unité: 'C62', unités: 'C62', eenheid: 'C62', stück: 'C62', stk: 'C62',
+    piece: 'H87', pieces: 'H87', pièce: 'H87', pièces: 'H87', pc: 'H87', pcs: 'H87', stuk: 'H87', stuks: 'H87',
+    lot: 'LO', set: 'SET', package: 'XPK', colis: 'XPK', pak: 'XPK',
+};
+/**
+ * Returns the UN/ECE code for a unit written in words, passes a three-letter
+ * code through, and falls back to `C62` (unit).
+ */
+export function toUnitCode(unit) {
+    if (!unit)
+        return UNIT_CODES.UNIT;
+    const key = unit.trim().toLowerCase();
+    const mapped = WORDS[key];
+    if (mapped)
+        return mapped;
+    if (/^[A-Z0-9]{2,3}$/.test(unit.trim()))
+        return unit.trim();
+    return UNIT_CODES.UNIT;
+}
+//# sourceMappingURL=units.js.map

package/dist/units.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.js","sourceRoot":"","sources":["../src/units.ts"],"names":[],"mappings":"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"}

package/dist/vat.d.ts

@@ -0,0 +1,23 @@
+import type { VatCategory } from './types.js';
+/** EU member states, ISO 3166-1 alpha-2. */
+export declare const EU_COUNTRIES: ReadonlySet<string>;
+export declare function isEuCountry(code: string): boolean;
+/**
+ * Picks the VAT category of a line when the caller does not state it.
+ * Positive rate → standard. Zero rate: domestic → zero-rated; EU buyer with a
+ * VAT identifier → intra-community supply; EU buyer without → exempt;
+ * non-EU buyer → export.
+ */
+export declare function defaultVatCategory(input: {
+    rate: number;
+    sellerCountry: string;
+    buyerCountry: string;
+    buyerHasVatId: boolean;
+}): VatCategory;
+/** Categories that require an exemption reason (BR-E-10, BR-AE-10, BR-IC-10, BR-G-10, BR-O-10). */
+export declare const EXEMPT_CATEGORIES: ReadonlySet<VatCategory>;
+/** VATEX exemption reason codes (BT-121) where one exists. */
+export declare const EXEMPTION_REASON_CODES: Readonly<Partial<Record<VatCategory, string>>>;
+/** Neutral default reason texts (BT-120). Override per invoice with `exemptionReasons`. */
+export declare const DEFAULT_EXEMPTION_REASONS: Readonly<Record<Exclude<VatCategory, 'S' | 'Z'>, string>>;
+//# sourceMappingURL=vat.d.ts.map

package/dist/vat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vat.d.ts","sourceRoot":"","sources":["../src/vat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,4CAA4C;AAC5C,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,CAG3C,CAAC;AAEH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;CACxB,GAAG,WAAW,CAOd;AAED,mGAAmG;AACnG,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,WAAW,CAAuC,CAAC;AAE/F,8DAA8D;AAC9D,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAKjF,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,GAAG,GAAG,CAAC,EAAE,MAAM,CAAC,CAM/F,CAAC"}

package/dist/vat.js

@@ -0,0 +1,43 @@
+/** EU member states, ISO 3166-1 alpha-2. */
+export const EU_COUNTRIES = new Set([
+    'AT', 'BE', 'BG', 'CY', 'CZ', 'DE', 'DK', 'EE', 'ES', 'FI', 'FR', 'GR', 'HR', 'HU',
+    'IE', 'IT', 'LT', 'LU', 'LV', 'MT', 'NL', 'PL', 'PT', 'RO', 'SE', 'SI', 'SK',
+]);
+export function isEuCountry(code) {
+    return EU_COUNTRIES.has(code.toUpperCase());
+}
+/**
+ * Picks the VAT category of a line when the caller does not state it.
+ * Positive rate → standard. Zero rate: domestic → zero-rated; EU buyer with a
+ * VAT identifier → intra-community supply; EU buyer without → exempt;
+ * non-EU buyer → export.
+ */
+export function defaultVatCategory(input) {
+    if (input.rate > 0)
+        return 'S';
+    const seller = input.sellerCountry.toUpperCase();
+    const buyer = input.buyerCountry.toUpperCase();
+    if (seller === buyer)
+        return 'Z';
+    if (isEuCountry(buyer))
+        return input.buyerHasVatId ? 'K' : 'E';
+    return 'G';
+}
+/** Categories that require an exemption reason (BR-E-10, BR-AE-10, BR-IC-10, BR-G-10, BR-O-10). */
+export const EXEMPT_CATEGORIES = new Set(['E', 'AE', 'K', 'G', 'O']);
+/** VATEX exemption reason codes (BT-121) where one exists. */
+export const EXEMPTION_REASON_CODES = {
+    K: 'VATEX-EU-IC',
+    AE: 'VATEX-EU-AE',
+    G: 'VATEX-EU-G',
+    O: 'VATEX-EU-O',
+};
+/** Neutral default reason texts (BT-120). Override per invoice with `exemptionReasons`. */
+export const DEFAULT_EXEMPTION_REASONS = {
+    E: 'Exempt from VAT',
+    AE: 'Reverse charge: VAT to be accounted for by the recipient',
+    K: 'Intra-community supply, exempt from VAT',
+    G: 'Export outside the European Union, exempt from VAT',
+    O: 'Not subject to VAT',
+};
+//# sourceMappingURL=vat.js.map

package/dist/vat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vat.js","sourceRoot":"","sources":["../src/vat.ts"],"names":[],"mappings":"AAEA,4CAA4C;AAC5C,MAAM,CAAC,MAAM,YAAY,GAAwB,IAAI,GAAG,CAAC;IACvD,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAClF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CAC7E,CAAC,CAAC;AAEH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAKlC;IACC,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IAC/C,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,GAAG,CAAC;IACjC,IAAI,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC/D,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mGAAmG;AACnG,MAAM,CAAC,MAAM,iBAAiB,GAA6B,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAE/F,8DAA8D;AAC9D,MAAM,CAAC,MAAM,sBAAsB,GAAmD;IACpF,CAAC,EAAE,aAAa;IAChB,EAAE,EAAE,aAAa;IACjB,CAAC,EAAE,YAAY;IACf,CAAC,EAAE,YAAY;CAChB,CAAC;AAEF,2FAA2F;AAC3F,MAAM,CAAC,MAAM,yBAAyB,GAA8D;IAClG,CAAC,EAAE,iBAAiB;IACpB,EAAE,EAAE,0DAA0D;IAC9D,CAAC,EAAE,yCAAyC;IAC5C,CAAC,EAAE,oDAAoD;IACvD,CAAC,EAAE,oBAAoB;CACxB,CAAC"}

package/dist/xmp.d.ts

@@ -0,0 +1,17 @@
+import type { Profile } from './types.js';
+/** XMP `fx:ConformanceLevel` values, exact spelling required by readers. */
+export declare const CONFORMANCE_LEVELS: Readonly<Record<Profile, string>>;
+export interface XmpOptions {
+    profile: Profile;
+    title?: string;
+    creator?: string;
+    producer?: string;
+    /** Timestamp written to the metadata. Defaults to now. */
+    date?: Date;
+}
+/**
+ * XMP packet declaring a PDF/A-3 document with the Factur-X extension schema,
+ * as required by the Factur-X specification (§ 6.2).
+ */
+export declare function buildXmpMetadata(options: XmpOptions): string;
+//# sourceMappingURL=xmp.d.ts.map

package/dist/xmp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xmp.d.ts","sourceRoot":"","sources":["../src/xmp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAMhE,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAsD5D"}

package/dist/xmp.js

@@ -0,0 +1,70 @@
+/** XMP `fx:ConformanceLevel` values, exact spelling required by readers. */
+export const CONFORMANCE_LEVELS = {
+    minimum: 'MINIMUM',
+    'basic-wl': 'BASIC WL',
+    basic: 'BASIC',
+    en16931: 'EN 16931',
+    extended: 'EXTENDED',
+};
+function escapeXml(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+/**
+ * XMP packet declaring a PDF/A-3 document with the Factur-X extension schema,
+ * as required by the Factur-X specification (§ 6.2).
+ */
+export function buildXmpMetadata(options) {
+    const date = (options.date ?? new Date()).toISOString();
+    const title = escapeXml(options.title ?? 'Invoice');
+    const creator = escapeXml(options.creator ?? '@ekwo-ai/factur-x');
+    const producer = escapeXml(options.producer ?? '@ekwo-ai/factur-x');
+    const property = (name, description) => `<rdf:li rdf:parseType="Resource"><pdfaProperty:name>${name}</pdfaProperty:name><pdfaProperty:valueType>Text</pdfaProperty:valueType><pdfaProperty:category>external</pdfaProperty:category><pdfaProperty:description>${description}</pdfaProperty:description></rdf:li>`;
+    return `<?xpacket begin="" 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: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:dc="http://purl.org/dc/elements/1.1/">
+      <dc:title><rdf:Alt><rdf:li xml:lang="x-default">${title}</rdf:li></rdf:Alt></dc:title>
+      <dc:creator><rdf:Seq><rdf:li>${creator}</rdf:li></rdf:Seq></dc:creator>
+    </rdf:Description>
+    <rdf:Description rdf:about="" xmlns:pdf="http://ns.adobe.com/pdf/1.3/">
+      <pdf:Producer>${producer}</pdf:Producer>
+    </rdf:Description>
+    <rdf:Description rdf:about="" xmlns:xmp="http://ns.adobe.com/xap/1.0/">
+      <xmp:CreatorTool>${creator}</xmp:CreatorTool>
+      <xmp:CreateDate>${date}</xmp:CreateDate>
+      <xmp:ModifyDate>${date}</xmp:ModifyDate>
+    </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>
+                ${property('DocumentFileName', 'name of the embedded XML invoice file')}
+                ${property('DocumentType', 'INVOICE')}
+                ${property('Version', 'The actual version of the Factur-X XML schema')}
+                ${property('ConformanceLevel', 'The conformance level of the embedded Factur-X data')}
+              </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:DocumentType>INVOICE</fx:DocumentType>
+      <fx:DocumentFileName>factur-x.xml</fx:DocumentFileName>
+      <fx:Version>1.0</fx:Version>
+      <fx:ConformanceLevel>${CONFORMANCE_LEVELS[options.profile]}</fx:ConformanceLevel>
+    </rdf:Description>
+  </rdf:RDF>
+</x:xmpmeta>
+<?xpacket end="w"?>`;
+}
+//# sourceMappingURL=xmp.js.map

package/dist/xmp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xmp.js","sourceRoot":"","sources":["../src/xmp.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,MAAM,CAAC,MAAM,kBAAkB,GAAsC;IACnE,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,UAAU;IACtB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,UAAU;IACnB,QAAQ,EAAE,UAAU;CACrB,CAAC;AAWF,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAmB;IAClD,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACxD,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,IAAI,mBAAmB,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,IAAI,mBAAmB,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,WAAmB,EAAE,EAAE,CACrD,uDAAuD,IAAI,6JAA6J,WAAW,sCAAsC,CAAC;IAC5Q,OAAO;;;;;;;;wDAQ+C,KAAK;qCACxB,OAAO;;;sBAGtB,QAAQ;;;yBAGL,OAAO;wBACR,IAAI;wBACJ,IAAI;;;;;;;;;;;kBAWV,QAAQ,CAAC,kBAAkB,EAAE,uCAAuC,CAAC;kBACrE,QAAQ,CAAC,cAAc,EAAE,SAAS,CAAC;kBACnC,QAAQ,CAAC,SAAS,EAAE,+CAA+C,CAAC;kBACpE,QAAQ,CAAC,kBAAkB,EAAE,qDAAqD,CAAC;;;;;;;;;;;6BAWxE,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC;;;;oBAI5C,CAAC;AACrB,CAAC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@ekwo-ai/factur-x",
+  "version": "0.4.0",
+  "description": "Factur-X / ZUGFeRD e-invoices in TypeScript: EN 16931 CII XML from a plain invoice object, PDF/A-3 embedding and extraction.",
+  "keywords": [
+    "factur-x",
+    "facturx",
+    "zugferd",
+    "en16931",
+    "cii",
+    "e-invoicing",
+    "einvoice",
+    "pdf-a3",
+    "invoice",
+    "peppol"
+  ],
+  "license": "MIT",
+  "author": "Ekwo AI",
+  "homepage": "https://github.com/Ekwo-ai/ekwo-os/tree/main/packages/formats/factur-x#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ekwo-ai/ekwo-os.git",
+    "directory": "packages/formats/factur-x"
+  },
+  "bugs": {
+    "url": "https://github.com/Ekwo-ai/ekwo-os/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./pdf": {
+      "types": "./dist/pdf.d.ts",
+      "import": "./dist/pdf.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "example": "tsx examples/basic.ts",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "dependencies": {
+    "pdf-lib": "^1.17.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsx": "^4.20.0",
+    "typescript": "^5.9.0",
+    "vitest": "^3.2.0"
+  }
+}