Des factures Factur-X conformes,
en TypeScript, sans rien deviner.

import { cents, computeTotals, percent, quantity, unitPrice, assertValidInvoice } from 'facturx-sdk';

const draft = {
  id: 'F-2026-0001', issueDate: '2026-09-11', typeCode: '380', currency: 'EUR',
  operationCategory: 'services',                       // nature de l'opération (réforme)
  seller: { name: 'Atelier Exemple SAS', siren: '443061841', vatId: 'FR64443061841',
            address: { postCode: '75011', city: 'Paris', countryCode: 'FR' } },
  buyer:  { name: 'Client Démo SARL', siren: '732829320',
            electronicAddress: { value: '732829320', scheme: '0225' },   // routage plateforme
            address: { postCode: '69002', city: 'Lyon', countryCode: 'FR' } },
  delivery: { date: '2026-09-10' },
  lines: [{ id: '1', name: 'Conseil', quantity: quantity(20000), unitCode: 'DAY',
            unitPrice: unitPrice(8000000), netAmount: cents(160000),
            tax: { category: 'S', rate: percent('20') } }],
  paymentTerms: { dueDate: '2026-10-11', latePenaltyRate: percent('10'),
                  recoveryIndemnity: cents(4000), earlyPaymentDiscount: 'none' },
};

const invoice = assertValidInvoice({ ...draft, ...computeTotals(draft) });
// sinon : FacturXValidationError { issues: [{ code: 'BR-CO-15', path: 'totals.taxInclusiveAmount', … }] }

import { toCiiXml } from 'facturx-sdk';
import { renderInvoicePdf, embedFacturX } from 'facturx-sdk/pdf';

// La page lisible, dessinée depuis le modèle : plus besoin d'apporter son PDF
const page = await renderInvoicePdf(invoice, {
  fonts: { regular: ttf, bold: ttfBold },   // police statique, embarquée
  footer: 'SARL au capital de 10 000 € · RCS Paris 443 061 841',
});

// La page + le XML → PDF/A-3 Factur-X, validé par veraPDF à chaque commit
const pdfA3 = await embedFacturX(page, { invoice }, {
  outputIntent: { iccProfile: srgb },
});

import { fromCiiXml, readCiiGuideline } from 'facturx-sdk';
import { extractInvoice } from 'facturx-sdk/pdf';

// PDF reçu → facture typée, validée (ou undefined sans Factur-X)
const received = await extractInvoice(pdfBytes);

// XML reçu → facture typée ; FacturXParseError { code, path } si illisible
const invoice = fromCiiXml(xmlString);

// Router sans tout lire : profil (BT-24) et cadre de facturation (BT-23)
const { guidelineId, businessProcessId } = readCiiGuideline(xmlString);