@ekwo-ai/factur-x 0.4.0

package/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+All notable changes to this project are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project adheres to
+[Semantic Versioning](https://semver.org/).
+
+## [Unreleased]
+
+## [0.2.0] — 2026-09-14
+
+Released with Ekwo OS `v0.2.0`, the first tagged release of the repository this
+package lives in.
+
+### Fixed
+- **A negative half was rounded the wrong way.** The totals used
+  `Math.round((v + EPSILON) * 100) / 100`, which goes towards positive infinity
+  and turns `-0.005` into `-0.00` — so a credit note was not its invoice with
+  the sign flipped, and the cent was found by whoever filed the return. The new
+  `roundCurrency` rounds half up on the absolute value, which is symmetric by
+  construction, and is the same file in the three packages that hold a copy.
+
+## [0.1.0] — 2026-09-11
+
+### Added
+- `generateCiiXml`: EN 16931 CII XML for the MINIMUM, BASIC WL, BASIC, EN 16931 and
+  EXTENDED Factur-X profiles, with VAT breakdown rules, credit notes and prepayments.
+- `computeTotals`, VAT category and unit-code helpers.
+- `@ekwo-ai/factur-x/pdf`: `embedFacturX` (PDF/A-3 attachment + XMP) and `extractFacturX`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ekwo AI
+
+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/README.md

@@ -0,0 +1,117 @@
+# @ekwo-ai/factur-x
+
+Factur-X / ZUGFeRD electronic invoices in TypeScript.
+
+- **CII XML from a plain invoice object.** EN 16931 semantic model, UN/CEFACT CII D16B
+  syntax, element order of the schema, VAT breakdown rules (`BR-S`, `BR-Z`, `BR-E`, `BR-AE`,
+  `BR-IC`, `BR-G`, `BR-O`). Profiles MINIMUM, BASIC WL, BASIC (default), EN 16931, EXTENDED.
+- **PDF/A-3 embedding.** Attaches the XML as `factur-x.xml` with `AFRelationship /Alternative`
+  and writes the XMP packet with the Factur-X extension schema.
+- **Extraction.** Reads `factur-x.xml` or `zugferd-invoice.xml` back from any PDF.
+- **Totals you can trust.** One VAT group per category and rate, VAT computed on the rounded
+  basis, prepayments, credit notes referencing the original invoice.
+- Zero dependencies for the XML part; `pdf-lib` only for the PDF part (separate entry point).
+
+## Install
+
+```sh
+npm install @ekwo-ai/factur-x
+```
+
+## Usage
+
+```ts
+import { generateCiiXml, computeTotals } from '@ekwo-ai/factur-x';
+import { embedFacturX, extractFacturX } from '@ekwo-ai/factur-x/pdf';
+
+const invoice = {
+  number: 'INV-2026-0042',
+  issueDate: '2026-03-31',
+  dueDate: '2026-04-30',
+  seller: {
+    name: 'Exemple Conseil SA',
+    vatId: 'BE0123456749',
+    legalId: { scheme: '0208', value: '0123456749' },   // Belgian enterprise number
+    address: { line1: "Rue de l'Exemple 1", postalCode: '1000', city: 'Bruxelles', country: 'BE' },
+  },
+  buyer: {
+    name: 'Société Fictive SAS',
+    vatId: 'FR12345678901',
+    legalId: { scheme: '0002', value: '345678901' },    // SIREN
+    address: { line1: '10 avenue des Tests', postalCode: '75001', city: 'Paris', country: 'FR' },
+  },
+  buyerReference: 'SERVICE-EXEC-42',
+  lines: [
+    { name: 'Consulting days', quantity: 3, unitCode: 'day', unitPrice: 950, vatRate: 0 },
+    { name: 'Software licence', quantity: 1, unitPrice: 1200, vatRate: 0 },
+  ],
+  payment: { iban: 'BE71 0961 2345 6769' },
+};
+
+const xml = generateCiiXml(invoice);                       // BASIC profile
+const totals = computeTotals(invoice);                     // { lineTotal, taxTotal, grandTotal, duePayable, breakdown }
+
+const pdf = await embedFacturX(visualPdfBytes, xml, { title: 'Invoice INV-2026-0042' });
+const back = await extractFacturX(pdf);                    // { filename: 'factur-x.xml', xml }
+```
+
+`npm run example` runs [`examples/basic.ts`](examples/basic.ts) end to end.
+
+### VAT categories
+
+Each line carries a `vatRate`. The category (BT-151) is derived when you do not state it:
+positive rate → `S`; zero rate at home → `Z`; zero rate to an EU business with a VAT id → `K`
+(intra-community); to an EU buyer without one → `E`; outside the EU → `G`. Set `vatCategory`
+on the line to override (`AE` reverse charge, `O` not subject to VAT…). Exempt groups get a
+reason text (BT-120, override with `invoice.exemptionReasons`) and the VATEX code where one
+exists.
+
+### Identifiers
+
+| Field | Example | XML |
+|---|---|---|
+| `vatId` | `BE0123456749`, `FR12345678901` | `SpecifiedTaxRegistration/ID[@schemeID="VA"]` |
+| `legalId` | `{ scheme: '0208', value: '0123456749' }` (BE), `{ scheme: '0002', value: '345678901' }` (FR SIREN) | `SpecifiedLegalOrganization/ID[@schemeID]` |
+| `buyerReference` | French « service exécutant » code | `BuyerReference` (BT-10) |
+| `orderReference` | purchase order | `BuyerOrderReferencedDocument` (BT-13) |
+
+### Units
+
+`unitCode` accepts a UN/ECE Recommendation 20 code (`HUR`, `DAY`, `KWH`…) or an everyday
+word in French, Dutch, English or German (`heures`, `dagen`, `m²`, `Stück`). Unknown values fall
+back to `C62` (unit). See `UNIT_CODES` and `toUnitCode`.
+
+## API
+
+| Export | Description |
+|---|---|
+| `generateCiiXml(invoice, { profile?, businessProcess? })` | CII XML string. |
+| `computeTotals(invoice)` | VAT breakdown and document totals (BT-106 … BT-117). |
+| `defaultVatCategory`, `EXEMPTION_REASON_CODES`, `DEFAULT_EXEMPTION_REASONS` | VAT helpers. |
+| `toUnitCode`, `UNIT_CODES` | Unit helpers. |
+| `buildXmpMetadata`, `CONFORMANCE_LEVELS`, `GUIDELINES`, `DOCUMENT_TYPE_CODES` | Constants of the specification. |
+| `embedFacturX(pdf, xml, { profile?, title?, creator?, producer?, date? })` *(`/pdf`)* | Returns a new PDF with the XML attached and the PDF/A-3 XMP packet. |
+| `extractFacturX(pdf)` *(`/pdf`)* | `{ filename, xml }` or `null`. |
+
+## Scope and limitations
+
+- Allowances and charges (BG-20, BG-21, BG-27, BG-28), gross prices with discounts and
+  multiple deliveries are not modelled yet.
+- The PDF part embeds the data and declares PDF/A-3; it does not convert the visual PDF to
+  PDF/A (fonts, colour profiles, output intent). Validate the result with the tool of your
+  platform before going live.
+- No XSD or Schematron validation is performed. Test against a validator such as the FNFE
+  Factur-X validator or the Mustang project.
+
+## Development
+
+```sh
+npm install
+npm run typecheck
+npm test
+npm run build
+```
+
+## License
+
+[MIT](LICENSE) © Ekwo AI

package/dist/cii.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Cross Industry Invoice (CII, UN/CEFACT D16B) XML for Factur-X / ZUGFeRD,
+ * following the element order of the EN 16931 schema and its business rules
+ * for VAT breakdowns.
+ */
+import type { DocumentType, GenerateOptions, Invoice, Profile } from './types.js';
+/** Guideline identifiers (BT-24) per conformance level. */
+export declare const GUIDELINES: Readonly<Record<Profile, string>>;
+/** UNTDID 1001 document type codes (BT-3). */
+export declare const DOCUMENT_TYPE_CODES: Readonly<Record<DocumentType, string>>;
+export declare function escapeXml(s: string): string;
+/**
+ * The CII XML document for an invoice, as a UTF-8 string ready to be
+ * embedded as `factur-x.xml`.
+ */
+export declare function generateCiiXml(invoice: Invoice, options?: GenerateOptions): string;
+//# sourceMappingURL=cii.d.ts.map

package/dist/cii.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cii.d.ts","sourceRoot":"","sources":["../src/cii.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,OAAO,EAAS,OAAO,EAAE,MAAM,YAAY,CAAC;AAKzF,2DAA2D;AAC3D,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAMxD,CAAC;AAEF,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAMtE,CAAC;AAEF,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAO3C;AA2CD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,eAAoB,GAAG,MAAM,CAgJtF"}

package/dist/cii.js

@@ -0,0 +1,204 @@
+import { computeTotals, lineNetAmount, lineVatCategory } from './totals.js';
+import { toUnitCode } from './units.js';
+import { DEFAULT_EXEMPTION_REASONS, EXEMPTION_REASON_CODES, EXEMPT_CATEGORIES } from './vat.js';
+/** Guideline identifiers (BT-24) per conformance level. */
+export const GUIDELINES = {
+    minimum: 'urn:factur-x.eu:1p0:minimum',
+    'basic-wl': 'urn:factur-x.eu:1p0:basicwl',
+    basic: 'urn:cen.eu:en16931:2017#compliant#urn:factur-x.eu:1p0:basic',
+    en16931: 'urn:cen.eu:en16931:2017',
+    extended: 'urn:cen.eu:en16931:2017#conformant#urn:factur-x.eu:1p0:extended',
+};
+/** UNTDID 1001 document type codes (BT-3). */
+export const DOCUMENT_TYPE_CODES = {
+    invoice: '380',
+    'credit-note': '381',
+    'corrected-invoice': '384',
+    'self-billed-invoice': '389',
+    'prepayment-invoice': '386',
+};
+export function escapeXml(s) {
+    return s
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+const amount = (n) => n.toFixed(2);
+const quantity = (n) => n.toFixed(4);
+const ymd = (iso) => iso.replace(/-/g, '').slice(0, 8);
+const date102 = (iso) => `<udt:DateTimeString format="102">${ymd(iso)}</udt:DateTimeString>`;
+const tag = (name, value) => (value ? `<${name}>${escapeXml(value)}</${name}>` : '');
+function partyXml(name, party, profile) {
+    const a = party.address;
+    const legal = party.legalId
+        ? `<ram:SpecifiedLegalOrganization><ram:ID schemeID="${escapeXml(party.legalId.scheme)}">${escapeXml(party.legalId.value.replace(/\s/g, ''))}</ram:ID></ram:SpecifiedLegalOrganization>`
+        : '';
+    const contact = profile === 'en16931' || profile === 'extended'
+        ? party.contact
+            ? `<ram:DefinedTradeContact>${tag('ram:PersonName', party.contact.name)}${party.contact.phone ? `<ram:TelephoneUniversalCommunication>${tag('ram:CompleteNumber', party.contact.phone)}</ram:TelephoneUniversalCommunication>` : ''}${party.contact.email ? `<ram:EmailURIUniversalCommunication>${tag('ram:URIID', party.contact.email)}</ram:EmailURIUniversalCommunication>` : ''}</ram:DefinedTradeContact>`
+            : ''
+        : '';
+    const electronic = party.electronicAddress
+        ? `<ram:URIUniversalCommunication><ram:URIID schemeID="${escapeXml(party.electronicAddress.scheme)}">${escapeXml(party.electronicAddress.value)}</ram:URIID></ram:URIUniversalCommunication>`
+        : '';
+    const vat = party.vatId
+        ? `<ram:SpecifiedTaxRegistration><ram:ID schemeID="VA">${escapeXml(party.vatId.replace(/\s/g, ''))}</ram:ID></ram:SpecifiedTaxRegistration>`
+        : '';
+    return `<ram:${name}>
+        ${tag('ram:Name', party.name)}
+        ${legal}${contact}
+        <ram:PostalTradeAddress>
+          ${tag('ram:PostcodeCode', a.postalCode)}
+          ${tag('ram:LineOne', a.line1)}
+          ${tag('ram:LineTwo', a.line2)}
+          ${tag('ram:LineThree', a.line3)}
+          ${tag('ram:CityName', a.city)}
+          <ram:CountryID>${escapeXml(a.country.toUpperCase())}</ram:CountryID>
+          ${tag('ram:CountrySubDivisionName', a.subdivision)}
+        </ram:PostalTradeAddress>
+        ${electronic}${vat}
+      </ram:${name}>`;
+}
+/**
+ * The CII XML document for an invoice, as a UTF-8 string ready to be
+ * embedded as `factur-x.xml`.
+ */
+export function generateCiiXml(invoice, options = {}) {
+    const profile = options.profile ?? 'basic';
+    const currency = (invoice.currency ?? 'EUR').toUpperCase();
+    const totals = computeTotals(invoice);
+    const typeCode = DOCUMENT_TYPE_CODES[invoice.type ?? 'invoice'];
+    const lines = invoice.lines
+        .map((line, i) => {
+        const category = lineVatCategory(line, invoice);
+        const rate = category === 'S' ? line.vatRate : 0;
+        return `
+    <ram:IncludedSupplyChainTradeLineItem>
+      <ram:AssociatedDocumentLineDocument>
+        <ram:LineID>${escapeXml(line.id ?? String(i + 1))}</ram:LineID>
+        ${line.note ? `<ram:IncludedNote>${tag('ram:Content', line.note)}</ram:IncludedNote>` : ''}
+      </ram:AssociatedDocumentLineDocument>
+      <ram:SpecifiedTradeProduct>
+        ${tag('ram:SellerAssignedID', line.sellerItemId)}
+        ${tag('ram:Name', line.name)}
+        ${tag('ram:Description', line.description)}
+      </ram:SpecifiedTradeProduct>
+      <ram:SpecifiedLineTradeAgreement>
+        <ram:NetPriceProductTradePrice>
+          <ram:ChargeAmount>${amount(line.unitPrice)}</ram:ChargeAmount>
+        </ram:NetPriceProductTradePrice>
+      </ram:SpecifiedLineTradeAgreement>
+      <ram:SpecifiedLineTradeDelivery>
+        <ram:BilledQuantity unitCode="${escapeXml(toUnitCode(line.unitCode))}">${quantity(line.quantity)}</ram:BilledQuantity>
+      </ram:SpecifiedLineTradeDelivery>
+      <ram:SpecifiedLineTradeSettlement>
+        <ram:ApplicableTradeTax>
+          <ram:TypeCode>VAT</ram:TypeCode>
+          <ram:CategoryCode>${category}</ram:CategoryCode>
+          ${category === 'O' ? '' : `<ram:RateApplicablePercent>${amount(rate)}</ram:RateApplicablePercent>`}
+        </ram:ApplicableTradeTax>
+        <ram:SpecifiedTradeSettlementLineMonetarySummation>
+          <ram:LineTotalAmount>${amount(lineNetAmount(line))}</ram:LineTotalAmount>
+        </ram:SpecifiedTradeSettlementLineMonetarySummation>
+      </ram:SpecifiedLineTradeSettlement>
+    </ram:IncludedSupplyChainTradeLineItem>`;
+    })
+        .join('');
+    // Header VAT breakdown. Element order of the schema: CalculatedAmount,
+    // TypeCode, ExemptionReason, BasisAmount, CategoryCode, ExemptionReasonCode,
+    // DueDateTypeCode, RateApplicablePercent.
+    const breakdown = totals.breakdown
+        .map((g) => {
+        const exempt = EXEMPT_CATEGORIES.has(g.category);
+        const reason = exempt
+            ? invoice.exemptionReasons?.[g.category] ??
+                DEFAULT_EXEMPTION_REASONS[g.category]
+            : undefined;
+        const reasonCode = exempt ? EXEMPTION_REASON_CODES[g.category] : undefined;
+        return `
+      <ram:ApplicableTradeTax>
+        <ram:CalculatedAmount>${amount(g.tax)}</ram:CalculatedAmount>
+        <ram:TypeCode>VAT</ram:TypeCode>
+        ${tag('ram:ExemptionReason', reason)}
+        <ram:BasisAmount>${amount(g.basis)}</ram:BasisAmount>
+        <ram:CategoryCode>${g.category}</ram:CategoryCode>
+        ${tag('ram:ExemptionReasonCode', reasonCode)}
+        ${g.category === 'O' ? '' : `<ram:RateApplicablePercent>${amount(g.rate)}</ram:RateApplicablePercent>`}
+      </ram:ApplicableTradeTax>`;
+    })
+        .join('');
+    const p = invoice.payment;
+    const paymentMeans = p && (p.iban || p.meansCode)
+        ? `
+      <ram:SpecifiedTradeSettlementPaymentMeans>
+        <ram:TypeCode>${escapeXml(p.meansCode ?? '58')}</ram:TypeCode>
+        ${p.iban ? `<ram:PayeePartyCreditorFinancialAccount><ram:IBANID>${escapeXml(p.iban.replace(/\s/g, ''))}</ram:IBANID></ram:PayeePartyCreditorFinancialAccount>` : ''}
+        ${p.bic && (profile === 'en16931' || profile === 'extended') ? `<ram:PayeeSpecifiedCreditorFinancialInstitution><ram:BICID>${escapeXml(p.bic)}</ram:BICID></ram:PayeeSpecifiedCreditorFinancialInstitution>` : ''}
+      </ram:SpecifiedTradeSettlementPaymentMeans>`
+        : '';
+    const paymentTerms = p?.terms || invoice.dueDate
+        ? `
+      <ram:SpecifiedTradePaymentTerms>
+        ${tag('ram:Description', p?.terms)}
+        ${invoice.dueDate ? `<ram:DueDateDateTime>${date102(invoice.dueDate)}</ram:DueDateDateTime>` : ''}
+      </ram:SpecifiedTradePaymentTerms>`
+        : '';
+    const preceding = invoice.precedingInvoice
+        ? `
+      <ram:InvoiceReferencedDocument>
+        ${tag('ram:IssuerAssignedID', invoice.precedingInvoice.number)}
+        ${invoice.precedingInvoice.issueDate ? `<ram:FormattedIssueDateTime><qdt:DateTimeString format="102">${ymd(invoice.precedingInvoice.issueDate)}</qdt:DateTimeString></ram:FormattedIssueDateTime>` : ''}
+      </ram:InvoiceReferencedDocument>`
+        : '';
+    const note = invoice.note?.replace(/\s+/g, ' ').trim();
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<rsm:CrossIndustryInvoice xmlns:rsm="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100" xmlns:qdt="urn:un:unece:uncefact:data:standard:QualifiedDataType:100" xmlns:ram="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100" xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100">
+  <rsm:ExchangedDocumentContext>
+    <ram:BusinessProcessSpecifiedDocumentContextParameter>
+      <ram:ID>${escapeXml(options.businessProcess ?? 'A1')}</ram:ID>
+    </ram:BusinessProcessSpecifiedDocumentContextParameter>
+    <ram:GuidelineSpecifiedDocumentContextParameter>
+      <ram:ID>${GUIDELINES[profile]}</ram:ID>
+    </ram:GuidelineSpecifiedDocumentContextParameter>
+  </rsm:ExchangedDocumentContext>
+  <rsm:ExchangedDocument>
+    <ram:ID>${escapeXml(invoice.number)}</ram:ID>
+    <ram:TypeCode>${typeCode}</ram:TypeCode>
+    <ram:IssueDateTime>${date102(invoice.issueDate)}</ram:IssueDateTime>
+    ${note ? `<ram:IncludedNote>${tag('ram:Content', note)}</ram:IncludedNote>` : ''}
+  </rsm:ExchangedDocument>
+  <rsm:SupplyChainTradeTransaction>${lines}
+    <ram:ApplicableHeaderTradeAgreement>
+      ${tag('ram:BuyerReference', invoice.buyerReference)}
+      ${partyXml('SellerTradeParty', invoice.seller, profile)}
+      ${partyXml('BuyerTradeParty', invoice.buyer, profile)}
+      ${invoice.orderReference ? `<ram:BuyerOrderReferencedDocument>${tag('ram:IssuerAssignedID', invoice.orderReference)}</ram:BuyerOrderReferencedDocument>` : ''}
+      ${invoice.contractReference ? `<ram:ContractReferencedDocument>${tag('ram:IssuerAssignedID', invoice.contractReference)}</ram:ContractReferencedDocument>` : ''}
+    </ram:ApplicableHeaderTradeAgreement>
+    <ram:ApplicableHeaderTradeDelivery>
+      <ram:ActualDeliverySupplyChainEvent>
+        <ram:OccurrenceDateTime>${date102(invoice.deliveryDate ?? invoice.issueDate)}</ram:OccurrenceDateTime>
+      </ram:ActualDeliverySupplyChainEvent>
+    </ram:ApplicableHeaderTradeDelivery>
+    <ram:ApplicableHeaderTradeSettlement>
+      ${tag('ram:PaymentReference', p?.reference)}
+      <ram:InvoiceCurrencyCode>${escapeXml(currency)}</ram:InvoiceCurrencyCode>${paymentMeans}${breakdown}${paymentTerms}
+      <ram:SpecifiedTradeSettlementHeaderMonetarySummation>
+        <ram:LineTotalAmount>${amount(totals.lineTotal)}</ram:LineTotalAmount>
+        <ram:TaxBasisTotalAmount>${amount(totals.taxBasisTotal)}</ram:TaxBasisTotalAmount>
+        <ram:TaxTotalAmount currencyID="${escapeXml(currency)}">${amount(totals.taxTotal)}</ram:TaxTotalAmount>
+        <ram:GrandTotalAmount>${amount(totals.grandTotal)}</ram:GrandTotalAmount>
+        ${totals.prepaid ? `<ram:TotalPrepaidAmount>${amount(totals.prepaid)}</ram:TotalPrepaidAmount>` : ''}
+        <ram:DuePayableAmount>${amount(totals.duePayable)}</ram:DuePayableAmount>
+      </ram:SpecifiedTradeSettlementHeaderMonetarySummation>${preceding}
+    </ram:ApplicableHeaderTradeSettlement>
+  </rsm:SupplyChainTradeTransaction>
+</rsm:CrossIndustryInvoice>
+`
+        .split('\n')
+        .filter((l) => l.trim() !== '')
+        .join('\n') + '\n';
+}
+//# sourceMappingURL=cii.js.map

package/dist/cii.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { generateCiiXml, escapeXml, GUIDELINES, DOCUMENT_TYPE_CODES } from './cii.js';
+export { computeTotals, lineNetAmount, lineVatCategory, round2 } from './totals.js';
+export { defaultVatCategory, isEuCountry, EU_COUNTRIES, EXEMPT_CATEGORIES, EXEMPTION_REASON_CODES, DEFAULT_EXEMPTION_REASONS, } from './vat.js';
+export { toUnitCode, UNIT_CODES } from './units.js';
+export { buildXmpMetadata, CONFORMANCE_LEVELS } from './xmp.js';
+export type { XmpOptions } from './xmp.js';
+export type { CurrencyCode, DocumentType, GenerateOptions, Invoice, InvoiceLine, InvoiceTotals, IsoDate, LegalIdentifier, Party, PaymentInstructions, PostalAddress, Profile, VatBreakdown, VatCategory, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAChE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,OAAO,EACP,WAAW,EACX,aAAa,EACb,OAAO,EACP,eAAe,EACf,KAAK,EACL,mBAAmB,EACnB,aAAa,EACb,OAAO,EACP,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { generateCiiXml, escapeXml, GUIDELINES, DOCUMENT_TYPE_CODES } from './cii.js';
+export { computeTotals, lineNetAmount, lineVatCategory, round2 } from './totals.js';
+export { defaultVatCategory, isEuCountry, EU_COUNTRIES, EXEMPT_CATEGORIES, EXEMPTION_REASON_CODES, DEFAULT_EXEMPTION_REASONS, } from './vat.js';
+export { toUnitCode, UNIT_CODES } from './units.js';
+export { buildXmpMetadata, CONFORMANCE_LEVELS } from './xmp.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC"}

package/dist/pdf.d.ts

@@ -0,0 +1,32 @@
+import type { Profile } from './types.js';
+export declare const FACTURX_FILENAME = "factur-x.xml";
+/** File name used by ZUGFeRD 2.x documents; accepted when reading. */
+export declare const ZUGFERD_FILENAME = "zugferd-invoice.xml";
+export interface EmbedOptions {
+    /** Defaults to `"basic"`. Must match the guideline used for the XML. */
+    profile?: Profile;
+    title?: string;
+    creator?: string;
+    producer?: string;
+    /** Timestamp for the attachment and the XMP packet. Defaults to now. */
+    date?: Date;
+}
+/**
+ * Returns a copy of `pdf` carrying `xml` as `factur-x.xml`.
+ *
+ * The visual PDF itself is left untouched: fonts, colour profiles and output
+ * intents are the responsibility of the producer of the original file. Strict
+ * PDF/A-3 validators may still flag those; the invoice data is embedded and
+ * readable, which is what e-invoicing platforms check.
+ */
+export declare function embedFacturX(pdf: Uint8Array | ArrayBuffer, xml: string, options?: EmbedOptions): Promise<Uint8Array>;
+export interface ExtractedInvoice {
+    filename: string;
+    xml: string;
+}
+/**
+ * Reads the embedded invoice XML (`factur-x.xml` or `zugferd-invoice.xml`)
+ * from a PDF. Returns `null` when the file carries none.
+ */
+export declare function extractFacturX(pdf: Uint8Array | ArrayBuffer): Promise<ExtractedInvoice | null>;
+//# sourceMappingURL=pdf.d.ts.map

package/dist/pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../src/pdf.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAC/C,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,wBAAwB,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,UAAU,GAAG,WAAW,EAC7B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,UAAU,CAAC,CAuBrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAiBpG"}

package/dist/pdf.js

@@ -0,0 +1,89 @@
+/**
+ * PDF side of Factur-X: attach the CII XML to a PDF as `factur-x.xml` with
+ * `AFRelationship /Alternative`, declare the document as PDF/A-3 in XMP, and
+ * read the XML back from an existing Factur-X / ZUGFeRD file.
+ *
+ * Only this module depends on `pdf-lib`; import it from `@ekwo-ai/factur-x/pdf`.
+ */
+import { AFRelationship, PDFArray, PDFDict, PDFDocument, PDFHexString, PDFName, PDFRawStream, PDFString, decodePDFRawStream, } from 'pdf-lib';
+import { buildXmpMetadata } from './xmp.js';
+export const FACTURX_FILENAME = 'factur-x.xml';
+/** File name used by ZUGFeRD 2.x documents; accepted when reading. */
+export const ZUGFERD_FILENAME = 'zugferd-invoice.xml';
+/**
+ * Returns a copy of `pdf` carrying `xml` as `factur-x.xml`.
+ *
+ * The visual PDF itself is left untouched: fonts, colour profiles and output
+ * intents are the responsibility of the producer of the original file. Strict
+ * PDF/A-3 validators may still flag those; the invoice data is embedded and
+ * readable, which is what e-invoicing platforms check.
+ */
+export async function embedFacturX(pdf, xml, options = {}) {
+    const profile = options.profile ?? 'basic';
+    const date = options.date ?? new Date();
+    const doc = await PDFDocument.load(pdf, { updateMetadata: false });
+    await doc.attach(new TextEncoder().encode(xml), FACTURX_FILENAME, {
+        mimeType: 'text/xml',
+        description: 'Factur-X invoice data (CII)',
+        creationDate: date,
+        modificationDate: date,
+        afRelationship: AFRelationship.Alternative,
+    });
+    const xmp = new TextEncoder().encode(buildXmpMetadata({ profile, ...options, date }));
+    const stream = doc.context.stream(xmp, { Type: 'Metadata', Subtype: 'XML', Length: xmp.length });
+    doc.catalog.set(PDFName.of('Metadata'), doc.context.register(stream));
+    if (options.title)
+        doc.setTitle(options.title);
+    if (options.creator)
+        doc.setCreator(options.creator);
+    doc.setProducer(options.producer ?? '@ekwo-ai/factur-x');
+    doc.setModificationDate(date);
+    return doc.save({ useObjectStreams: false });
+}
+/**
+ * Reads the embedded invoice XML (`factur-x.xml` or `zugferd-invoice.xml`)
+ * from a PDF. Returns `null` when the file carries none.
+ */
+export async function extractFacturX(pdf) {
+    const doc = await PDFDocument.load(pdf, { updateMetadata: false, ignoreEncryption: true });
+    const names = doc.catalog.lookupMaybe(PDFName.of('Names'), PDFDict);
+    const embedded = names?.lookupMaybe(PDFName.of('EmbeddedFiles'), PDFDict);
+    if (!embedded)
+        return null;
+    const wanted = new Set([FACTURX_FILENAME, ZUGFERD_FILENAME]);
+    for (const [name, spec] of walkNameTree(doc, embedded)) {
+        if (!wanted.has(name))
+            continue;
+        const ef = spec.lookupMaybe(PDFName.of('EF'), PDFDict);
+        const candidate = ef?.lookup(PDFName.of('UF')) ?? ef?.lookup(PDFName.of('F'));
+        if (!(candidate instanceof PDFRawStream))
+            continue;
+        const stream = candidate;
+        const bytes = decodePDFRawStream(stream).decode();
+        return { filename: name, xml: new TextDecoder('utf-8').decode(bytes) };
+    }
+    return null;
+}
+/** Yields `[fileName, fileSpecification]` pairs of an EmbeddedFiles name tree. */
+function* walkNameTree(doc, node) {
+    const names = node.lookupMaybe(PDFName.of('Names'), PDFArray);
+    if (names) {
+        for (let i = 0; i + 1 < names.size(); i += 2) {
+            const spec = names.lookup(i + 1);
+            if (!(spec instanceof PDFDict))
+                continue;
+            const text = (o) => (o instanceof PDFString || o instanceof PDFHexString ? o.decodeText() : undefined);
+            const name = text(spec.lookup(PDFName.of('UF'))) ?? text(spec.lookup(PDFName.of('F'))) ?? text(names.lookup(i)) ?? '';
+            yield [name, spec];
+        }
+    }
+    const kids = node.lookupMaybe(PDFName.of('Kids'), PDFArray);
+    if (kids) {
+        for (let i = 0; i < kids.size(); i++) {
+            const kid = kids.lookupMaybe(i, PDFDict);
+            if (kid)
+                yield* walkNameTree(doc, kid);
+        }
+    }
+}
+//# sourceMappingURL=pdf.js.map

package/dist/pdf.js.map

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

package/dist/rounding.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The one rounding rule of Ekwo: **half up, on the absolute value, at the
+ * currency's decimals**.
+ *
+ * Three packages used to answer this differently — `Math.round((v + EPSILON) *
+ * 100) / 100`, `Math.round(v * 100) / 100` and `Number.prototype.toFixed(2)` —
+ * and the three disagreed on the two cases that matter: a negative half, where
+ * `Math.round` goes towards positive infinity and turns -0.005 into -0.00, and
+ * a value a binary float cannot hold, where 2.675 becomes 2.67 because
+ * `2.675 * 100` is really 267.49999999999994. A credit note is a sale with the
+ * sign flipped; a rule that treats the two differently puts a cent between an
+ * invoice and its credit note, and the cent is found by the person filing the
+ * return.
+ *
+ * Half up on the absolute value is what an invoice, a VAT return and a set of
+ * annual accounts are written with, and it is symmetric by construction: the
+ * rounding of -x is the rounding of x with the sign put back.
+ *
+ * The file is deliberately identical in every package that holds a copy. A
+ * format brick may not import the core or another brick, so the rule is
+ * duplicated rather than shared — and `tests/rounding.test.ts` reads the
+ * copies and refuses one that has drifted. See `docs/decisions.md`.
+ */
+export declare function roundCurrency(value: number, decimals?: number): number;
+//# sourceMappingURL=rounding.d.ts.map

package/dist/rounding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rounding.d.ts","sourceRoot":"","sources":["../src/rounding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAUjE"}

package/dist/rounding.js

@@ -0,0 +1,35 @@
+/**
+ * The one rounding rule of Ekwo: **half up, on the absolute value, at the
+ * currency's decimals**.
+ *
+ * Three packages used to answer this differently — `Math.round((v + EPSILON) *
+ * 100) / 100`, `Math.round(v * 100) / 100` and `Number.prototype.toFixed(2)` —
+ * and the three disagreed on the two cases that matter: a negative half, where
+ * `Math.round` goes towards positive infinity and turns -0.005 into -0.00, and
+ * a value a binary float cannot hold, where 2.675 becomes 2.67 because
+ * `2.675 * 100` is really 267.49999999999994. A credit note is a sale with the
+ * sign flipped; a rule that treats the two differently puts a cent between an
+ * invoice and its credit note, and the cent is found by the person filing the
+ * return.
+ *
+ * Half up on the absolute value is what an invoice, a VAT return and a set of
+ * annual accounts are written with, and it is symmetric by construction: the
+ * rounding of -x is the rounding of x with the sign put back.
+ *
+ * The file is deliberately identical in every package that holds a copy. A
+ * format brick may not import the core or another brick, so the rule is
+ * duplicated rather than shared — and `tests/rounding.test.ts` reads the
+ * copies and refuses one that has drifted. See `docs/decisions.md`.
+ */
+export function roundCurrency(value, decimals = 2) {
+    const factor = 10 ** decimals;
+    const scaled = Math.abs(value) * factor;
+    // The nudge is proportional to the number, which is what makes it work at
+    // 1.005 and at 1000000.005 alike, and far too small to move a value that is
+    // not already within a bit of the halfway point.
+    const rounded = Math.round(scaled + Number.EPSILON * scaled);
+    // `-0` is a value of its own in JavaScript and it prints as "-0.00".
+    // Adding zero turns it back into `0`.
+    return (value < 0 ? -rounded : rounded) / factor + 0;
+}
+//# sourceMappingURL=rounding.js.map