@liasse/factur-x 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Liasse
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,396 @@
+import { z } from 'zod';
+
+/** A postal address (EN 16931 BG-5 / BG-8). */
+declare const AddressSchema: z.ZodObject<{
+    line1: z.ZodOptional<z.ZodString>;
+    line2: z.ZodOptional<z.ZodString>;
+    city: z.ZodString;
+    postcode: z.ZodString;
+    /** ISO 3166-1 alpha-2 country code (e.g. "FR"). */
+    countryCode: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    city: string;
+    postcode: string;
+    countryCode: string;
+    line1?: string | undefined;
+    line2?: string | undefined;
+}, {
+    city: string;
+    postcode: string;
+    line1?: string | undefined;
+    line2?: string | undefined;
+    countryCode?: string | undefined;
+}>;
+type Address = z.infer<typeof AddressSchema>;
+/** A trade party — seller (BG-4) or buyer (BG-7). */
+declare const PartySchema: z.ZodObject<{
+    name: z.ZodString;
+    /** Legal registration id, e.g. SIREN/SIRET (BT-30 / BT-47). */
+    registrationId: z.ZodOptional<z.ZodString>;
+    /** Scheme for the registration id (ISO 6523), e.g. "0002" for SIRENE. */
+    registrationScheme: z.ZodDefault<z.ZodString>;
+    /** VAT identifier, e.g. "FR40123456789" (BT-31 / BT-48). */
+    vatId: z.ZodOptional<z.ZodString>;
+    address: z.ZodObject<{
+        line1: z.ZodOptional<z.ZodString>;
+        line2: z.ZodOptional<z.ZodString>;
+        city: z.ZodString;
+        postcode: z.ZodString;
+        /** ISO 3166-1 alpha-2 country code (e.g. "FR"). */
+        countryCode: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        city: string;
+        postcode: string;
+        countryCode: string;
+        line1?: string | undefined;
+        line2?: string | undefined;
+    }, {
+        city: string;
+        postcode: string;
+        line1?: string | undefined;
+        line2?: string | undefined;
+        countryCode?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    registrationScheme: string;
+    address: {
+        city: string;
+        postcode: string;
+        countryCode: string;
+        line1?: string | undefined;
+        line2?: string | undefined;
+    };
+    registrationId?: string | undefined;
+    vatId?: string | undefined;
+}, {
+    name: string;
+    address: {
+        city: string;
+        postcode: string;
+        line1?: string | undefined;
+        line2?: string | undefined;
+        countryCode?: string | undefined;
+    };
+    registrationId?: string | undefined;
+    registrationScheme?: string | undefined;
+    vatId?: string | undefined;
+}>;
+type Party = z.infer<typeof PartySchema>;
+/** An invoice line (BG-25). */
+declare const LineSchema: z.ZodObject<{
+    /** Line id; auto-numbered from 1 when omitted. */
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    quantity: z.ZodNumber;
+    /** UN/ECE Rec 20 unit code (default "C62" = one/piece). */
+    unitCode: z.ZodDefault<z.ZodString>;
+    /** Net unit price (BT-146). */
+    unitPrice: z.ZodNumber;
+    /** VAT rate as a percentage, e.g. 20 for 20 % (BT-152). */
+    vatRate: z.ZodNumber;
+    /** VAT category code (BT-151): S standard, Z zero, E exempt, … */
+    vatCategory: z.ZodDefault<z.ZodEnum<["S", "Z", "E", "AE", "K", "G", "O"]>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    quantity: number;
+    unitCode: string;
+    unitPrice: number;
+    vatRate: number;
+    vatCategory: "S" | "Z" | "E" | "AE" | "K" | "G" | "O";
+    id?: string | undefined;
+}, {
+    name: string;
+    quantity: number;
+    unitPrice: number;
+    vatRate: number;
+    id?: string | undefined;
+    unitCode?: string | undefined;
+    vatCategory?: "S" | "Z" | "E" | "AE" | "K" | "G" | "O" | undefined;
+}>;
+type Line = z.infer<typeof LineSchema>;
+/** A Factur-X invoice (EN 16931 core). */
+declare const InvoiceSchema: z.ZodObject<{
+    /** Invoice number (BT-1). */
+    number: z.ZodString;
+    /** Issue date as YYYY-MM-DD or a Date (BT-2). */
+    issueDate: z.ZodUnion<[z.ZodString, z.ZodDate]>;
+    /** Document type code (BT-3); 380 = commercial invoice. */
+    typeCode: z.ZodDefault<z.ZodNumber>;
+    /** Invoice currency, ISO 4217 (BT-5). */
+    currency: z.ZodDefault<z.ZodString>;
+    /** Buyer reference / order ref (BT-10) — often required (e.g. Chorus Pro). */
+    buyerReference: z.ZodOptional<z.ZodString>;
+    /** Payment due date as YYYY-MM-DD or a Date (BT-9). */
+    dueDate: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodDate]>>;
+    seller: z.ZodObject<{
+        name: z.ZodString;
+        /** Legal registration id, e.g. SIREN/SIRET (BT-30 / BT-47). */
+        registrationId: z.ZodOptional<z.ZodString>;
+        /** Scheme for the registration id (ISO 6523), e.g. "0002" for SIRENE. */
+        registrationScheme: z.ZodDefault<z.ZodString>;
+        /** VAT identifier, e.g. "FR40123456789" (BT-31 / BT-48). */
+        vatId: z.ZodOptional<z.ZodString>;
+        address: z.ZodObject<{
+            line1: z.ZodOptional<z.ZodString>;
+            line2: z.ZodOptional<z.ZodString>;
+            city: z.ZodString;
+            postcode: z.ZodString;
+            /** ISO 3166-1 alpha-2 country code (e.g. "FR"). */
+            countryCode: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            city: string;
+            postcode: string;
+            countryCode: string;
+            line1?: string | undefined;
+            line2?: string | undefined;
+        }, {
+            city: string;
+            postcode: string;
+            line1?: string | undefined;
+            line2?: string | undefined;
+            countryCode?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        registrationScheme: string;
+        address: {
+            city: string;
+            postcode: string;
+            countryCode: string;
+            line1?: string | undefined;
+            line2?: string | undefined;
+        };
+        registrationId?: string | undefined;
+        vatId?: string | undefined;
+    }, {
+        name: string;
+        address: {
+            city: string;
+            postcode: string;
+            line1?: string | undefined;
+            line2?: string | undefined;
+            countryCode?: string | undefined;
+        };
+        registrationId?: string | undefined;
+        registrationScheme?: string | undefined;
+        vatId?: string | undefined;
+    }>;
+    buyer: z.ZodObject<{
+        name: z.ZodString;
+        /** Legal registration id, e.g. SIREN/SIRET (BT-30 / BT-47). */
+        registrationId: z.ZodOptional<z.ZodString>;
+        /** Scheme for the registration id (ISO 6523), e.g. "0002" for SIRENE. */
+        registrationScheme: z.ZodDefault<z.ZodString>;
+        /** VAT identifier, e.g. "FR40123456789" (BT-31 / BT-48). */
+        vatId: z.ZodOptional<z.ZodString>;
+        address: z.ZodObject<{
+            line1: z.ZodOptional<z.ZodString>;
+            line2: z.ZodOptional<z.ZodString>;
+            city: z.ZodString;
+            postcode: z.ZodString;
+            /** ISO 3166-1 alpha-2 country code (e.g. "FR"). */
+            countryCode: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            city: string;
+            postcode: string;
+            countryCode: string;
+            line1?: string | undefined;
+            line2?: string | undefined;
+        }, {
+            city: string;
+            postcode: string;
+            line1?: string | undefined;
+            line2?: string | undefined;
+            countryCode?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        registrationScheme: string;
+        address: {
+            city: string;
+            postcode: string;
+            countryCode: string;
+            line1?: string | undefined;
+            line2?: string | undefined;
+        };
+        registrationId?: string | undefined;
+        vatId?: string | undefined;
+    }, {
+        name: string;
+        address: {
+            city: string;
+            postcode: string;
+            line1?: string | undefined;
+            line2?: string | undefined;
+            countryCode?: string | undefined;
+        };
+        registrationId?: string | undefined;
+        registrationScheme?: string | undefined;
+        vatId?: string | undefined;
+    }>;
+    lines: z.ZodArray<z.ZodObject<{
+        /** Line id; auto-numbered from 1 when omitted. */
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        quantity: z.ZodNumber;
+        /** UN/ECE Rec 20 unit code (default "C62" = one/piece). */
+        unitCode: z.ZodDefault<z.ZodString>;
+        /** Net unit price (BT-146). */
+        unitPrice: z.ZodNumber;
+        /** VAT rate as a percentage, e.g. 20 for 20 % (BT-152). */
+        vatRate: z.ZodNumber;
+        /** VAT category code (BT-151): S standard, Z zero, E exempt, … */
+        vatCategory: z.ZodDefault<z.ZodEnum<["S", "Z", "E", "AE", "K", "G", "O"]>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        quantity: number;
+        unitCode: string;
+        unitPrice: number;
+        vatRate: number;
+        vatCategory: "S" | "Z" | "E" | "AE" | "K" | "G" | "O";
+        id?: string | undefined;
+    }, {
+        name: string;
+        quantity: number;
+        unitPrice: number;
+        vatRate: number;
+        id?: string | undefined;
+        unitCode?: string | undefined;
+        vatCategory?: "S" | "Z" | "E" | "AE" | "K" | "G" | "O" | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    number: string;
+    issueDate: string | Date;
+    typeCode: number;
+    currency: string;
+    seller: {
+        name: string;
+        registrationScheme: string;
+        address: {
+            city: string;
+            postcode: string;
+            countryCode: string;
+            line1?: string | undefined;
+            line2?: string | undefined;
+        };
+        registrationId?: string | undefined;
+        vatId?: string | undefined;
+    };
+    buyer: {
+        name: string;
+        registrationScheme: string;
+        address: {
+            city: string;
+            postcode: string;
+            countryCode: string;
+            line1?: string | undefined;
+            line2?: string | undefined;
+        };
+        registrationId?: string | undefined;
+        vatId?: string | undefined;
+    };
+    lines: {
+        name: string;
+        quantity: number;
+        unitCode: string;
+        unitPrice: number;
+        vatRate: number;
+        vatCategory: "S" | "Z" | "E" | "AE" | "K" | "G" | "O";
+        id?: string | undefined;
+    }[];
+    buyerReference?: string | undefined;
+    dueDate?: string | Date | undefined;
+}, {
+    number: string;
+    issueDate: string | Date;
+    seller: {
+        name: string;
+        address: {
+            city: string;
+            postcode: string;
+            line1?: string | undefined;
+            line2?: string | undefined;
+            countryCode?: string | undefined;
+        };
+        registrationId?: string | undefined;
+        registrationScheme?: string | undefined;
+        vatId?: string | undefined;
+    };
+    buyer: {
+        name: string;
+        address: {
+            city: string;
+            postcode: string;
+            line1?: string | undefined;
+            line2?: string | undefined;
+            countryCode?: string | undefined;
+        };
+        registrationId?: string | undefined;
+        registrationScheme?: string | undefined;
+        vatId?: string | undefined;
+    };
+    lines: {
+        name: string;
+        quantity: number;
+        unitPrice: number;
+        vatRate: number;
+        id?: string | undefined;
+        unitCode?: string | undefined;
+        vatCategory?: "S" | "Z" | "E" | "AE" | "K" | "G" | "O" | undefined;
+    }[];
+    typeCode?: number | undefined;
+    currency?: string | undefined;
+    buyerReference?: string | undefined;
+    dueDate?: string | Date | undefined;
+}>;
+type Invoice = z.input<typeof InvoiceSchema>;
+type ResolvedInvoice = z.infer<typeof InvoiceSchema>;
+declare function round2(n: number): number;
+interface VatGroup {
+    rate: number;
+    category: string;
+    basis: number;
+    tax: number;
+}
+interface InvoiceTotals {
+    lineTotal: number;
+    taxBasisTotal: number;
+    taxTotal: number;
+    grandTotal: number;
+    duePayable: number;
+    vatBreakdown: VatGroup[];
+    lineAmounts: number[];
+}
+/** Compute line amounts, the VAT breakdown by (rate, category) and the totals. */
+declare function computeTotals(invoice: ResolvedInvoice): InvoiceTotals;
+
+/** EN 16931 guideline identifier carried by the Factur-X "EN 16931" profile. */
+declare const EN16931_GUIDELINE = "urn:cen.eu:en16931:2017";
+/**
+ * Generate the Cross Industry Invoice (CII) XML for the **EN 16931** Factur-X
+ * profile from invoice data. This is the TS happy-path: it produces a
+ * well-formed, semantically-correct CII; full Schematron validation is left to
+ * the conformance sidecar.
+ */
+declare function generateCII(input: Invoice): string;
+
+interface EmbedOptions {
+    /** Name of the embedded XML part. Factur-X requires `factur-x.xml`. */
+    filename?: string;
+    /** Factur-X conformance level declared in the XMP. */
+    conformanceLevel?: string;
+}
+/**
+ * Embed a CII XML string into a PDF, producing a Factur-X invoice: the XML is
+ * attached as an associated file and the Factur-X XMP metadata is written.
+ *
+ * This is the TS happy-path (recognised by Chorus Pro / common readers). Strict
+ * **PDF/A-3b conformance** (ICC profile, embedded fonts, Schematron validation)
+ * is the job of the conformance sidecar — not provided here.
+ */
+declare function embedFacturX(pdfBytes: Uint8Array, xml: string, options?: EmbedOptions): Promise<Uint8Array>;
+/** Convenience: generate the CII for an invoice and embed it into a PDF. */
+declare function facturX(invoice: Invoice, pdfBytes: Uint8Array, options?: EmbedOptions): Promise<Uint8Array>;
+
+export { type Address, AddressSchema, EN16931_GUIDELINE, type EmbedOptions, type Invoice, InvoiceSchema, type InvoiceTotals, type Line, LineSchema, type Party, PartySchema, type ResolvedInvoice, type VatGroup, computeTotals, embedFacturX, facturX, generateCII, round2 };

package/dist/index.js

@@ -0,0 +1,269 @@
+// src/schema.ts
+import { z } from "zod";
+var AddressSchema = z.object({
+  line1: z.string().optional(),
+  line2: z.string().optional(),
+  city: z.string().min(1),
+  postcode: z.string().min(1),
+  /** ISO 3166-1 alpha-2 country code (e.g. "FR"). */
+  countryCode: z.string().length(2).default("FR")
+});
+var PartySchema = z.object({
+  name: z.string().min(1),
+  /** Legal registration id, e.g. SIREN/SIRET (BT-30 / BT-47). */
+  registrationId: z.string().optional(),
+  /** Scheme for the registration id (ISO 6523), e.g. "0002" for SIRENE. */
+  registrationScheme: z.string().default("0002"),
+  /** VAT identifier, e.g. "FR40123456789" (BT-31 / BT-48). */
+  vatId: z.string().optional(),
+  address: AddressSchema
+});
+var LineSchema = z.object({
+  /** Line id; auto-numbered from 1 when omitted. */
+  id: z.string().optional(),
+  name: z.string().min(1),
+  quantity: z.number(),
+  /** UN/ECE Rec 20 unit code (default "C62" = one/piece). */
+  unitCode: z.string().default("C62"),
+  /** Net unit price (BT-146). */
+  unitPrice: z.number(),
+  /** VAT rate as a percentage, e.g. 20 for 20 % (BT-152). */
+  vatRate: z.number().min(0),
+  /** VAT category code (BT-151): S standard, Z zero, E exempt, … */
+  vatCategory: z.enum(["S", "Z", "E", "AE", "K", "G", "O"]).default("S")
+});
+var InvoiceSchema = z.object({
+  /** Invoice number (BT-1). */
+  number: z.string().min(1),
+  /** Issue date as YYYY-MM-DD or a Date (BT-2). */
+  issueDate: z.union([z.string(), z.date()]),
+  /** Document type code (BT-3); 380 = commercial invoice. */
+  typeCode: z.number().int().default(380),
+  /** Invoice currency, ISO 4217 (BT-5). */
+  currency: z.string().length(3).default("EUR"),
+  /** Buyer reference / order ref (BT-10) — often required (e.g. Chorus Pro). */
+  buyerReference: z.string().optional(),
+  /** Payment due date as YYYY-MM-DD or a Date (BT-9). */
+  dueDate: z.union([z.string(), z.date()]).optional(),
+  seller: PartySchema,
+  buyer: PartySchema,
+  lines: z.array(LineSchema).min(1)
+});
+function round2(n) {
+  return Math.round((n + Number.EPSILON) * 100) / 100;
+}
+function computeTotals(invoice) {
+  const lineAmounts = invoice.lines.map((l) => round2(l.quantity * l.unitPrice));
+  const lineTotal = round2(lineAmounts.reduce((a, b) => a + b, 0));
+  const groups = /* @__PURE__ */ new Map();
+  invoice.lines.forEach((line, i) => {
+    const key = `${line.vatCategory}:${line.vatRate}`;
+    const g = groups.get(key) ?? { rate: line.vatRate, category: line.vatCategory, basis: 0, tax: 0 };
+    g.basis = round2(g.basis + lineAmounts[i]);
+    groups.set(key, g);
+  });
+  const vatBreakdown = [...groups.values()].map((g) => ({
+    ...g,
+    tax: round2(g.basis * g.rate / 100)
+  }));
+  const taxBasisTotal = lineTotal;
+  const taxTotal = round2(vatBreakdown.reduce((a, g) => a + g.tax, 0));
+  const grandTotal = round2(taxBasisTotal + taxTotal);
+  return {
+    lineTotal,
+    taxBasisTotal,
+    taxTotal,
+    grandTotal,
+    duePayable: grandTotal,
+    vatBreakdown,
+    lineAmounts
+  };
+}
+
+// src/cii.ts
+import { create } from "xmlbuilder2";
+var NS = {
+  rsm: "urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100",
+  ram: "urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100",
+  udt: "urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100"
+};
+var EN16931_GUIDELINE = "urn:cen.eu:en16931:2017";
+function amount(n) {
+  return n.toFixed(2);
+}
+function ciiDate(value) {
+  const d = value instanceof Date ? value : new Date(value);
+  if (Number.isNaN(d.getTime())) throw new Error(`Invalid date: ${String(value)}`);
+  const yyyy = d.getUTCFullYear();
+  const mm = String(d.getUTCMonth() + 1).padStart(2, "0");
+  const dd = String(d.getUTCDate()).padStart(2, "0");
+  return `${yyyy}${mm}${dd}`;
+}
+function dateTimeString(value) {
+  return { "udt:DateTimeString": { "@format": "102", "#": ciiDate(value) } };
+}
+function party(p) {
+  return {
+    "ram:Name": p.name,
+    ...p.registrationId ? {
+      "ram:SpecifiedLegalOrganization": {
+        "ram:ID": { "@schemeID": p.registrationScheme, "#": p.registrationId }
+      }
+    } : {},
+    "ram:PostalTradeAddress": {
+      "ram:PostcodeCode": p.address.postcode,
+      ...p.address.line1 ? { "ram:LineOne": p.address.line1 } : {},
+      ...p.address.line2 ? { "ram:LineTwo": p.address.line2 } : {},
+      "ram:CityName": p.address.city,
+      "ram:CountryID": p.address.countryCode
+    },
+    ...p.vatId ? { "ram:SpecifiedTaxRegistration": { "ram:ID": { "@schemeID": "VA", "#": p.vatId } } } : {}
+  };
+}
+function generateCII(input) {
+  const invoice = InvoiceSchema.parse(input);
+  const totals = computeTotals(invoice);
+  const lineItems = invoice.lines.map((line, i) => ({
+    "ram:AssociatedDocumentLineDocument": { "ram:LineID": line.id ?? String(i + 1) },
+    "ram:SpecifiedTradeProduct": { "ram:Name": line.name },
+    "ram:SpecifiedLineTradeAgreement": {
+      "ram:NetPriceProductTradePrice": { "ram:ChargeAmount": amount(line.unitPrice) }
+    },
+    "ram:SpecifiedLineTradeDelivery": {
+      "ram:BilledQuantity": { "@unitCode": line.unitCode, "#": String(line.quantity) }
+    },
+    "ram:SpecifiedLineTradeSettlement": {
+      "ram:ApplicableTradeTax": {
+        "ram:TypeCode": "VAT",
+        "ram:CategoryCode": line.vatCategory,
+        "ram:RateApplicablePercent": String(line.vatRate)
+      },
+      "ram:SpecifiedTradeSettlementLineMonetarySummation": {
+        "ram:LineTotalAmount": amount(totals.lineAmounts[i])
+      }
+    }
+  }));
+  const headerTax = totals.vatBreakdown.map((g) => ({
+    "ram:CalculatedAmount": amount(g.tax),
+    "ram:TypeCode": "VAT",
+    "ram:BasisAmount": amount(g.basis),
+    "ram:CategoryCode": g.category,
+    "ram:RateApplicablePercent": String(g.rate)
+  }));
+  const obj = {
+    "rsm:CrossIndustryInvoice": {
+      "@xmlns:rsm": NS.rsm,
+      "@xmlns:ram": NS.ram,
+      "@xmlns:udt": NS.udt,
+      "rsm:ExchangedDocumentContext": {
+        "ram:GuidelineSpecifiedDocumentContextParameter": { "ram:ID": EN16931_GUIDELINE }
+      },
+      "rsm:ExchangedDocument": {
+        "ram:ID": invoice.number,
+        "ram:TypeCode": String(invoice.typeCode),
+        "ram:IssueDateTime": dateTimeString(invoice.issueDate)
+      },
+      "rsm:SupplyChainTradeTransaction": {
+        "ram:IncludedSupplyChainTradeLineItem": lineItems,
+        "ram:ApplicableHeaderTradeAgreement": {
+          ...invoice.buyerReference ? { "ram:BuyerReference": invoice.buyerReference } : {},
+          "ram:SellerTradeParty": party(invoice.seller),
+          "ram:BuyerTradeParty": party(invoice.buyer)
+        },
+        "ram:ApplicableHeaderTradeDelivery": {},
+        "ram:ApplicableHeaderTradeSettlement": {
+          "ram:InvoiceCurrencyCode": invoice.currency,
+          "ram:ApplicableTradeTax": headerTax,
+          ...invoice.dueDate ? {
+            "ram:SpecifiedTradePaymentTerms": {
+              "ram:DueDateDateTime": dateTimeString(invoice.dueDate)
+            }
+          } : {},
+          "ram:SpecifiedTradeSettlementHeaderMonetarySummation": {
+            "ram:LineTotalAmount": amount(totals.lineTotal),
+            "ram:TaxBasisTotalAmount": amount(totals.taxBasisTotal),
+            "ram:TaxTotalAmount": { "@currencyID": invoice.currency, "#": amount(totals.taxTotal) },
+            "ram:GrandTotalAmount": amount(totals.grandTotal),
+            "ram:DuePayableAmount": amount(totals.duePayable)
+          }
+        }
+      }
+    }
+  };
+  return create({ encoding: "UTF-8" }, obj).end({ prettyPrint: true });
+}
+
+// src/embed.ts
+import { AFRelationship, PDFDocument, PDFName, PDFRawStream } from "pdf-lib";
+function facturXXmp(filename, level) {
+  const prop = (name, desc) => `<rdf:li rdf:parseType="Resource"><pdfaProperty:name>${name}</pdfaProperty:name><pdfaProperty:valueType>Text</pdfaProperty:valueType><pdfaProperty:category>external</pdfaProperty:category><pdfaProperty:description>${desc}</pdfaProperty:description></rdf:li>`;
+  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: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:fx="urn:factur-x:pdfa:CrossIndustryDocument:invoice:1p0#">
+   <fx:DocumentType>INVOICE</fx:DocumentType>
+   <fx:DocumentFileName>${filename}</fx:DocumentFileName>
+   <fx:Version>1.0</fx:Version>
+   <fx:ConformanceLevel>${level}</fx:ConformanceLevel>
+  </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>
+        ${prop("DocumentFileName", "name of the embedded XML invoice file")}
+        ${prop("DocumentType", "INVOICE")}
+        ${prop("Version", "the actual version of the Factur-X data")}
+        ${prop("ConformanceLevel", "the conformance level of the Factur-X data")}
+       </rdf:Seq>
+      </pdfaSchema:property>
+     </rdf:li>
+    </rdf:Bag>
+   </pdfaExtension:schemas>
+  </rdf:Description>
+ </rdf:RDF>
+</x:xmpmeta>
+<?xpacket end="w"?>`;
+}
+async function embedFacturX(pdfBytes, xml, options = {}) {
+  const filename = options.filename ?? "factur-x.xml";
+  const level = options.conformanceLevel ?? "EN 16931";
+  const pdf = await PDFDocument.load(pdfBytes);
+  await pdf.attach(new TextEncoder().encode(xml), filename, {
+    mimeType: "text/xml",
+    description: "Factur-X invoice",
+    afRelationship: AFRelationship.Alternative,
+    creationDate: /* @__PURE__ */ new Date(),
+    modificationDate: /* @__PURE__ */ new Date()
+  });
+  const metaStream = PDFRawStream.of(
+    pdf.context.obj({ Type: "Metadata", Subtype: "XML" }),
+    new TextEncoder().encode(facturXXmp(filename, level))
+  );
+  pdf.catalog.set(PDFName.of("Metadata"), pdf.context.register(metaStream));
+  return pdf.save({ useObjectStreams: false });
+}
+async function facturX(invoice, pdfBytes, options = {}) {
+  return embedFacturX(pdfBytes, generateCII(invoice), options);
+}
+export {
+  AddressSchema,
+  EN16931_GUIDELINE,
+  InvoiceSchema,
+  LineSchema,
+  PartySchema,
+  computeTotals,
+  embedFacturX,
+  facturX,
+  generateCII,
+  round2
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema.ts","../src/cii.ts","../src/embed.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/** A postal address (EN 16931 BG-5 / BG-8). */\nexport const AddressSchema = z.object({\n  line1: z.string().optional(),\n  line2: z.string().optional(),\n  city: z.string().min(1),\n  postcode: z.string().min(1),\n  /** ISO 3166-1 alpha-2 country code (e.g. \"FR\"). */\n  countryCode: z.string().length(2).default(\"FR\"),\n});\nexport type Address = z.infer<typeof AddressSchema>;\n\n/** A trade party — seller (BG-4) or buyer (BG-7). */\nexport const PartySchema = z.object({\n  name: z.string().min(1),\n  /** Legal registration id, e.g. SIREN/SIRET (BT-30 / BT-47). */\n  registrationId: z.string().optional(),\n  /** Scheme for the registration id (ISO 6523), e.g. \"0002\" for SIRENE. */\n  registrationScheme: z.string().default(\"0002\"),\n  /** VAT identifier, e.g. \"FR40123456789\" (BT-31 / BT-48). */\n  vatId: z.string().optional(),\n  address: AddressSchema,\n});\nexport type Party = z.infer<typeof PartySchema>;\n\n/** An invoice line (BG-25). */\nexport const LineSchema = z.object({\n  /** Line id; auto-numbered from 1 when omitted. */\n  id: z.string().optional(),\n  name: z.string().min(1),\n  quantity: z.number(),\n  /** UN/ECE Rec 20 unit code (default \"C62\" = one/piece). */\n  unitCode: z.string().default(\"C62\"),\n  /** Net unit price (BT-146). */\n  unitPrice: z.number(),\n  /** VAT rate as a percentage, e.g. 20 for 20 % (BT-152). */\n  vatRate: z.number().min(0),\n  /** VAT category code (BT-151): S standard, Z zero, E exempt, … */\n  vatCategory: z.enum([\"S\", \"Z\", \"E\", \"AE\", \"K\", \"G\", \"O\"]).default(\"S\"),\n});\nexport type Line = z.infer<typeof LineSchema>;\n\n/** A Factur-X invoice (EN 16931 core). */\nexport const InvoiceSchema = z.object({\n  /** Invoice number (BT-1). */\n  number: z.string().min(1),\n  /** Issue date as YYYY-MM-DD or a Date (BT-2). */\n  issueDate: z.union([z.string(), z.date()]),\n  /** Document type code (BT-3); 380 = commercial invoice. */\n  typeCode: z.number().int().default(380),\n  /** Invoice currency, ISO 4217 (BT-5). */\n  currency: z.string().length(3).default(\"EUR\"),\n  /** Buyer reference / order ref (BT-10) — often required (e.g. Chorus Pro). */\n  buyerReference: z.string().optional(),\n  /** Payment due date as YYYY-MM-DD or a Date (BT-9). */\n  dueDate: z.union([z.string(), z.date()]).optional(),\n  seller: PartySchema,\n  buyer: PartySchema,\n  lines: z.array(LineSchema).min(1),\n});\nexport type Invoice = z.input<typeof InvoiceSchema>;\nexport type ResolvedInvoice = z.infer<typeof InvoiceSchema>;\n\nexport function round2(n: number): number {\n  return Math.round((n + Number.EPSILON) * 100) / 100;\n}\n\nexport interface VatGroup {\n  rate: number;\n  category: string;\n  basis: number;\n  tax: number;\n}\n\nexport interface InvoiceTotals {\n  lineTotal: number;\n  taxBasisTotal: number;\n  taxTotal: number;\n  grandTotal: number;\n  duePayable: number;\n  vatBreakdown: VatGroup[];\n  lineAmounts: number[];\n}\n\n/** Compute line amounts, the VAT breakdown by (rate, category) and the totals. */\nexport function computeTotals(invoice: ResolvedInvoice): InvoiceTotals {\n  const lineAmounts = invoice.lines.map((l) => round2(l.quantity * l.unitPrice));\n  const lineTotal = round2(lineAmounts.reduce((a, b) => a + b, 0));\n\n  const groups = new Map<string, VatGroup>();\n  invoice.lines.forEach((line, i) => {\n    const key = `${line.vatCategory}:${line.vatRate}`;\n    const g = groups.get(key) ?? { rate: line.vatRate, category: line.vatCategory, basis: 0, tax: 0 };\n    g.basis = round2(g.basis + lineAmounts[i]);\n    groups.set(key, g);\n  });\n  const vatBreakdown = [...groups.values()].map((g) => ({\n    ...g,\n    tax: round2((g.basis * g.rate) / 100),\n  }));\n\n  const taxBasisTotal = lineTotal;\n  const taxTotal = round2(vatBreakdown.reduce((a, g) => a + g.tax, 0));\n  const grandTotal = round2(taxBasisTotal + taxTotal);\n\n  return {\n    lineTotal,\n    taxBasisTotal,\n    taxTotal,\n    grandTotal,\n    duePayable: grandTotal,\n    vatBreakdown,\n    lineAmounts,\n  };\n}\n","import { create } from \"xmlbuilder2\";\nimport {\n  InvoiceSchema,\n  computeTotals,\n  type Invoice,\n  type Party,\n  type ResolvedInvoice,\n} from \"./schema.js\";\n\nconst NS = {\n  rsm: \"urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100\",\n  ram: \"urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100\",\n  udt: \"urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100\",\n};\n\n/** EN 16931 guideline identifier carried by the Factur-X \"EN 16931\" profile. */\nexport const EN16931_GUIDELINE = \"urn:cen.eu:en16931:2017\";\n\nfunction amount(n: number): string {\n  return n.toFixed(2);\n}\n\nfunction ciiDate(value: string | Date): string {\n  const d = value instanceof Date ? value : new Date(value);\n  if (Number.isNaN(d.getTime())) throw new Error(`Invalid date: ${String(value)}`);\n  const yyyy = d.getUTCFullYear();\n  const mm = String(d.getUTCMonth() + 1).padStart(2, \"0\");\n  const dd = String(d.getUTCDate()).padStart(2, \"0\");\n  return `${yyyy}${mm}${dd}`;\n}\n\nfunction dateTimeString(value: string | Date): Record<string, unknown> {\n  return { \"udt:DateTimeString\": { \"@format\": \"102\", \"#\": ciiDate(value) } };\n}\n\nfunction party(p: Party): Record<string, unknown> {\n  return {\n    \"ram:Name\": p.name,\n    ...(p.registrationId\n      ? {\n          \"ram:SpecifiedLegalOrganization\": {\n            \"ram:ID\": { \"@schemeID\": p.registrationScheme, \"#\": p.registrationId },\n          },\n        }\n      : {}),\n    \"ram:PostalTradeAddress\": {\n      \"ram:PostcodeCode\": p.address.postcode,\n      ...(p.address.line1 ? { \"ram:LineOne\": p.address.line1 } : {}),\n      ...(p.address.line2 ? { \"ram:LineTwo\": p.address.line2 } : {}),\n      \"ram:CityName\": p.address.city,\n      \"ram:CountryID\": p.address.countryCode,\n    },\n    ...(p.vatId\n      ? { \"ram:SpecifiedTaxRegistration\": { \"ram:ID\": { \"@schemeID\": \"VA\", \"#\": p.vatId } } }\n      : {}),\n  };\n}\n\n/**\n * Generate the Cross Industry Invoice (CII) XML for the **EN 16931** Factur-X\n * profile from invoice data. This is the TS happy-path: it produces a\n * well-formed, semantically-correct CII; full Schematron validation is left to\n * the conformance sidecar.\n */\nexport function generateCII(input: Invoice): string {\n  const invoice: ResolvedInvoice = InvoiceSchema.parse(input);\n  const totals = computeTotals(invoice);\n\n  const lineItems = invoice.lines.map((line, i) => ({\n    \"ram:AssociatedDocumentLineDocument\": { \"ram:LineID\": line.id ?? String(i + 1) },\n    \"ram:SpecifiedTradeProduct\": { \"ram:Name\": line.name },\n    \"ram:SpecifiedLineTradeAgreement\": {\n      \"ram:NetPriceProductTradePrice\": { \"ram:ChargeAmount\": amount(line.unitPrice) },\n    },\n    \"ram:SpecifiedLineTradeDelivery\": {\n      \"ram:BilledQuantity\": { \"@unitCode\": line.unitCode, \"#\": String(line.quantity) },\n    },\n    \"ram:SpecifiedLineTradeSettlement\": {\n      \"ram:ApplicableTradeTax\": {\n        \"ram:TypeCode\": \"VAT\",\n        \"ram:CategoryCode\": line.vatCategory,\n        \"ram:RateApplicablePercent\": String(line.vatRate),\n      },\n      \"ram:SpecifiedTradeSettlementLineMonetarySummation\": {\n        \"ram:LineTotalAmount\": amount(totals.lineAmounts[i]),\n      },\n    },\n  }));\n\n  const headerTax = totals.vatBreakdown.map((g) => ({\n    \"ram:CalculatedAmount\": amount(g.tax),\n    \"ram:TypeCode\": \"VAT\",\n    \"ram:BasisAmount\": amount(g.basis),\n    \"ram:CategoryCode\": g.category,\n    \"ram:RateApplicablePercent\": String(g.rate),\n  }));\n\n  const obj = {\n    \"rsm:CrossIndustryInvoice\": {\n      \"@xmlns:rsm\": NS.rsm,\n      \"@xmlns:ram\": NS.ram,\n      \"@xmlns:udt\": NS.udt,\n      \"rsm:ExchangedDocumentContext\": {\n        \"ram:GuidelineSpecifiedDocumentContextParameter\": { \"ram:ID\": EN16931_GUIDELINE },\n      },\n      \"rsm:ExchangedDocument\": {\n        \"ram:ID\": invoice.number,\n        \"ram:TypeCode\": String(invoice.typeCode),\n        \"ram:IssueDateTime\": dateTimeString(invoice.issueDate),\n      },\n      \"rsm:SupplyChainTradeTransaction\": {\n        \"ram:IncludedSupplyChainTradeLineItem\": lineItems,\n        \"ram:ApplicableHeaderTradeAgreement\": {\n          ...(invoice.buyerReference ? { \"ram:BuyerReference\": invoice.buyerReference } : {}),\n          \"ram:SellerTradeParty\": party(invoice.seller),\n          \"ram:BuyerTradeParty\": party(invoice.buyer),\n        },\n        \"ram:ApplicableHeaderTradeDelivery\": {},\n        \"ram:ApplicableHeaderTradeSettlement\": {\n          \"ram:InvoiceCurrencyCode\": invoice.currency,\n          \"ram:ApplicableTradeTax\": headerTax,\n          ...(invoice.dueDate\n            ? {\n                \"ram:SpecifiedTradePaymentTerms\": {\n                  \"ram:DueDateDateTime\": dateTimeString(invoice.dueDate),\n                },\n              }\n            : {}),\n          \"ram:SpecifiedTradeSettlementHeaderMonetarySummation\": {\n            \"ram:LineTotalAmount\": amount(totals.lineTotal),\n            \"ram:TaxBasisTotalAmount\": amount(totals.taxBasisTotal),\n            \"ram:TaxTotalAmount\": { \"@currencyID\": invoice.currency, \"#\": amount(totals.taxTotal) },\n            \"ram:GrandTotalAmount\": amount(totals.grandTotal),\n            \"ram:DuePayableAmount\": amount(totals.duePayable),\n          },\n        },\n      },\n    },\n  };\n\n  return create({ encoding: \"UTF-8\" }, obj).end({ prettyPrint: true });\n}\n","import { AFRelationship, PDFDocument, PDFName, PDFRawStream } from \"pdf-lib\";\nimport { generateCII } from \"./cii.js\";\nimport type { Invoice } from \"./schema.js\";\n\nexport interface EmbedOptions {\n  /** Name of the embedded XML part. Factur-X requires `factur-x.xml`. */\n  filename?: string;\n  /** Factur-X conformance level declared in the XMP. */\n  conformanceLevel?: string;\n}\n\nfunction facturXXmp(filename: string, level: string): string {\n  const prop = (name: string, desc: string) =>\n    `<rdf:li rdf:parseType=\"Resource\"><pdfaProperty:name>${name}</pdfaProperty:name><pdfaProperty:valueType>Text</pdfaProperty:valueType><pdfaProperty:category>external</pdfaProperty:category><pdfaProperty:description>${desc}</pdfaProperty:description></rdf:li>`;\n  return `<?xpacket begin=\"\" id=\"W5M0MpCehiHzreSzNTczkc9d\"?>\n<x:xmpmeta xmlns:x=\"adobe:ns:meta/\">\n <rdf:RDF xmlns:rdf=\"http://www.w3.org/1999/02/22-rdf-syntax-ns#\">\n  <rdf:Description rdf:about=\"\" xmlns:pdfaid=\"http://www.aiim.org/pdfa/ns/id/\">\n   <pdfaid:part>3</pdfaid:part>\n   <pdfaid:conformance>B</pdfaid:conformance>\n  </rdf:Description>\n  <rdf:Description rdf:about=\"\" xmlns:fx=\"urn:factur-x:pdfa:CrossIndustryDocument:invoice:1p0#\">\n   <fx:DocumentType>INVOICE</fx:DocumentType>\n   <fx:DocumentFileName>${filename}</fx:DocumentFileName>\n   <fx:Version>1.0</fx:Version>\n   <fx:ConformanceLevel>${level}</fx:ConformanceLevel>\n  </rdf:Description>\n  <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#\">\n   <pdfaExtension:schemas>\n    <rdf:Bag>\n     <rdf:li rdf:parseType=\"Resource\">\n      <pdfaSchema:schema>Factur-X PDFA Extension Schema</pdfaSchema:schema>\n      <pdfaSchema:namespaceURI>urn:factur-x:pdfa:CrossIndustryDocument:invoice:1p0#</pdfaSchema:namespaceURI>\n      <pdfaSchema:prefix>fx</pdfaSchema:prefix>\n      <pdfaSchema:property>\n       <rdf:Seq>\n        ${prop(\"DocumentFileName\", \"name of the embedded XML invoice file\")}\n        ${prop(\"DocumentType\", \"INVOICE\")}\n        ${prop(\"Version\", \"the actual version of the Factur-X data\")}\n        ${prop(\"ConformanceLevel\", \"the conformance level of the Factur-X data\")}\n       </rdf:Seq>\n      </pdfaSchema:property>\n     </rdf:li>\n    </rdf:Bag>\n   </pdfaExtension:schemas>\n  </rdf:Description>\n </rdf:RDF>\n</x:xmpmeta>\n<?xpacket end=\"w\"?>`;\n}\n\n/**\n * Embed a CII XML string into a PDF, producing a Factur-X invoice: the XML is\n * attached as an associated file and the Factur-X XMP metadata is written.\n *\n * This is the TS happy-path (recognised by Chorus Pro / common readers). Strict\n * **PDF/A-3b conformance** (ICC profile, embedded fonts, Schematron validation)\n * is the job of the conformance sidecar — not provided here.\n */\nexport async function embedFacturX(\n  pdfBytes: Uint8Array,\n  xml: string,\n  options: EmbedOptions = {},\n): Promise<Uint8Array> {\n  const filename = options.filename ?? \"factur-x.xml\";\n  const level = options.conformanceLevel ?? \"EN 16931\";\n\n  const pdf = await PDFDocument.load(pdfBytes);\n\n  await pdf.attach(new TextEncoder().encode(xml), filename, {\n    mimeType: \"text/xml\",\n    description: \"Factur-X invoice\",\n    afRelationship: AFRelationship.Alternative,\n    creationDate: new Date(),\n    modificationDate: new Date(),\n  });\n\n  const metaStream = PDFRawStream.of(\n    pdf.context.obj({ Type: \"Metadata\", Subtype: \"XML\" }),\n    new TextEncoder().encode(facturXXmp(filename, level)),\n  );\n  pdf.catalog.set(PDFName.of(\"Metadata\"), pdf.context.register(metaStream));\n\n  // Avoid compressed object streams — friendlier for Factur-X / PDF-A readers.\n  return pdf.save({ useObjectStreams: false });\n}\n\n/** Convenience: generate the CII for an invoice and embed it into a PDF. */\nexport async function facturX(\n  invoice: Invoice,\n  pdfBytes: Uint8Array,\n  options: EmbedOptions = {},\n): Promise<Uint8Array> {\n  return embedFacturX(pdfBytes, generateCII(invoice), options);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@liasse/factur-x",
+  "version": "0.2.0",
+  "description": "Liasse Factur-X module — generate the EN 16931 CII XML and embed it into a PDF to produce a Factur-X invoice (TS happy-path).",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "pdf-lib": "^1.17.1",
+    "xmlbuilder2": "^4.0.3",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}