@ekwo-ai/core 0.11.1 → 0.12.0

package/README.md

@@ -12,6 +12,9 @@ TypeScript row types and a typed client for the
 - **A thin client** over the functions that carry the accounting rules —
   `post_document`, `reconcile`, `trial_balance`, `vat_return`, `fec_lines`.
   Everything else is a table, and Supabase already exposes those as REST.
+- **The functions the command line and the MCP server share** — keeping the
+  books, issuing an electronic invoice, proving a filing by its hash — so a
+  rule exists once.
 - **No runtime dependency of its own.** `@supabase/supabase-js` is an optional
   peer; `@ekwo-ai/fec` is there because `generateFec()` on the client writes
   the file it has just fetched.
@@ -64,6 +67,8 @@ const file = generateFec(lines, { decimalSeparator: ',', fieldSeparator: '|' });
 | `isRegistered(instance)` | Whether the operator opted into registering with Ekwo. |
 | `isSale`, `isCreditNote`, `isAccountable` | Document type predicates. |
 | `createContact`, `createDocument`, `addDocumentLine`, `updateDocumentLines`, `postDocument`, `recordPayment`, `reconcile`, `settleFromStatement`, `listDocuments`, `getDocument`, … | Keeping the books, once for every surface: the functions the MCP server and the `ekwo` command line both call. Each takes a `Backend` — five operations, `select` `insert` `update` `remove` `rpc` — that the caller implements over whatever reaches the database as a user. No accounting rule is in them; the schema holds those. |
+| `validateEinvoice`, `issueEinvoice`, `einvoiceStatus`, `listEinvoiceTransmissions`, `EinvoiceTransport`, `directoryTransport` | The electronic invoice of a posted sale, through the `einvoicing` module, and the contract a transport implements — `send`, `status`, `receive`, `lookup`, with no credential crossing it. The one transport that ships writes files to a folder. |
+| `proveFile`, `upgradeFilingProofs`, `lookupFilingProof`, `checkProof` | The sha256 of a filed file committed to Bitcoin through the public OpenTimestamps calendars, and checked later by anybody holding the file ([`docs/filing-proofs.md`](../../docs/filing-proofs.md)). |
 | `BooksError`, `isRefusalState`, `socleCode`, `isServiceRoleKey` | What an error of that layer looks like, what counts as the database refusing, and the one key no surface accepts. |
 | Types | `Instance`, `InstanceAdmin`, `MemberRole`, `CompanyRole`, `Account`, `Journal`, `Entry`, `EntryLine`, `EkwoDocument`, `DocumentLine`, `Tax`, `TaxPosting`, `Contact`, `TrialBalanceRow`, `AgedBalanceRow`, `VatReturnRow`, … |
 

package/dist/books/document-pdf.d.ts

@@ -0,0 +1,87 @@
+/**
+ * The PDF of a sale invoice or credit note, for every surface at once.
+ *
+ * The command line (`ekwo doc pdf`) and the MCP server (`render_invoice_pdf`)
+ * call this with their own `Backend`, acting as the person signed in. It reads
+ * the four views a document is printed from — `document_header`,
+ * `document_line_items`, `document_tax_summary`, `document_legal_mentions` —
+ * and hands the rows to `@ekwo-ai/invoice-pdf`, which renders them and knows
+ * nothing of a database. Here is what only a client can do: read the views,
+ * fetch the logo the company names by URL, and, when asked, write the CII of
+ * the same document with the Factur-X adapter of the e-invoicing formats and
+ * embed it, so that the PDF is a Factur-X invoice.
+ *
+ * Nothing is recorded. A posted document reproduces from the books; the copy
+ * that was sent to a customer is another thing, and keeping it is not done
+ * here.
+ */
+import { type InvoiceLabels, type InvoicePdfInput, type PageSize } from '@ekwo-ai/invoice-pdf';
+import { type EinvoiceViolation } from '../einvoicing/formats.js';
+import { type Backend } from './backend.js';
+/** The four views of one document. */
+export declare function readDocumentForPdf(backend: Backend, documentId: string): Promise<Omit<InvoicePdfInput, 'logo'>>;
+/** What a logo fetch may be handed: the global `fetch`, or a test's. */
+export type LogoFetch = (url: string, init: {
+    signal: AbortSignal;
+    redirect: 'follow' | 'error';
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    arrayBuffer(): Promise<ArrayBuffer>;
+}>;
+/**
+ * Why a logo URL is not fetched, or null when it may be. Only `http` and
+ * `https`, and never a host that names this machine or a private network: the
+ * URL is a value a member of the company typed, and the server that fetches it
+ * may be somebody else's.
+ */
+export declare function logoUrlRefusal(url: string): string | null;
+/**
+ * The bytes of the logo at `url`, or why there are none. A logo that cannot be
+ * had is not a reason to refuse an invoice: the PDF is rendered with the
+ * company's name instead, and the reason is said.
+ */
+export declare function fetchLogo(url: string, fetchImpl: LogoFetch): Promise<{
+    bytes: Uint8Array;
+} | {
+    skipped: string;
+}>;
+export interface DocumentPdfArgs {
+    document_id: string;
+    /** Embed the CII of the document (Factur-X, EN 16931 profile): the PDF becomes a PDF/A-3 Factur-X invoice. */
+    factur_x?: boolean | undefined;
+    page_size?: PageSize | undefined;
+    /** The words of the layout in the document's language; what is left out is English. */
+    labels?: Partial<InvoiceLabels> | undefined;
+}
+export interface DocumentPdf {
+    document_id: string;
+    doc_type: string;
+    number: string | null;
+    state: string | null;
+    language: string | null;
+    filename: string;
+    title: string;
+    media_type: 'application/pdf';
+    byte_size: number;
+    page_count: number;
+    /** `embedded`, `none` (the company names no logo), or why the one it names was not used. */
+    logo: string;
+    /** Null without --factur-x; otherwise the rules of EN 16931 the embedded XML breaks, as the e-invoicing adapter names them. */
+    factur_x: {
+        profile: 'en16931';
+        violations: EinvoiceViolation[];
+    } | null;
+    file: Uint8Array;
+}
+/**
+ * Renders the PDF of a sale invoice or credit note from the views, and
+ * records nothing. With `factur_x`, the document must be a posted sale: the
+ * CII is written from the books by the same adapter `einvoicing` uses, its
+ * broken rules are returned, and the XML is embedded all the same — a check
+ * that found something, which the caller reports.
+ */
+export declare function renderDocumentPdf(backend: Backend, args: DocumentPdfArgs, deps?: {
+    fetch?: LogoFetch | undefined;
+}): Promise<DocumentPdf>;
+//# sourceMappingURL=document-pdf.d.ts.map

package/dist/books/document-pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-pdf.d.ts","sourceRoot":"","sources":["../../src/books/document-pdf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAQL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,QAAQ,EACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEpF,OAAO,EAAc,KAAK,OAAO,EAAY,MAAM,cAAc,CAAC;AA6ClE,sCAAsC;AACtC,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CA0BxC;AAED,wEAAwE;AACxE,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAA;CAAE,KAAK,OAAO,CAAC;IAC5G,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CACrC,CAAC,CAAC;AAKH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuBzD;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAmBvH;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,8GAA8G;IAC9G,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,SAAS,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACjC,uFAAuF;IACvF,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,iBAAiB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,4FAA4F;IAC5F,IAAI,EAAE,MAAM,CAAC;IACb,+HAA+H;IAC/H,QAAQ,EAAE;QAAE,OAAO,EAAE,SAAS,CAAC;QAAC,UAAU,EAAE,iBAAiB,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IACzE,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,eAAe,EACrB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;CAAO,GAC3C,OAAO,CAAC,WAAW,CAAC,CA+DtB"}

package/dist/books/document-pdf.js

@@ -0,0 +1,222 @@
+/**
+ * The PDF of a sale invoice or credit note, for every surface at once.
+ *
+ * The command line (`ekwo doc pdf`) and the MCP server (`render_invoice_pdf`)
+ * call this with their own `Backend`, acting as the person signed in. It reads
+ * the four views a document is printed from — `document_header`,
+ * `document_line_items`, `document_tax_summary`, `document_legal_mentions` —
+ * and hands the rows to `@ekwo-ai/invoice-pdf`, which renders them and knows
+ * nothing of a database. Here is what only a client can do: read the views,
+ * fetch the logo the company names by URL, and, when asked, write the CII of
+ * the same document with the Factur-X adapter of the e-invoicing formats and
+ * embed it, so that the PDF is a Factur-X invoice.
+ *
+ * Nothing is recorded. A posted document reproduces from the books; the copy
+ * that was sent to a customer is another thing, and keeping it is not done
+ * here.
+ */
+import { embedFacturX } from '@ekwo-ai/factur-x/pdf';
+import { InvoicePdfError, renderFacturXPdf, renderInvoicePdf, } from '@ekwo-ai/invoice-pdf';
+import { EINVOICE_FORMATS } from '../einvoicing/formats.js';
+import { readEinvoiceSource } from '../einvoicing/issue.js';
+import { BooksError } from './backend.js';
+import { onlyVisible } from './shared.js';
+/** Every column of `document_header`, dates and figures as the text the database holds. */
+const HEADER = [
+    'document_id', 'company_id', 'doc_type', 'state', 'payment_state', 'number', 'supplier_reference',
+    'document_date::text', 'accounting_date::text', 'due_date::text', 'delivery_date::text', 'currency_code',
+    'amount_untaxed::text', 'amount_tax::text', 'amount_total::text', 'amount_paid::text', 'amount_residual::text',
+    'payment_terms', 'payment_means_code', 'payment_reference', 'buyer_reference', 'order_reference',
+    'contract_reference', 'project_reference', 'note', 'payee_iban', 'payee_bic',
+    'seller_name', 'seller_legal_name', 'seller_legal_form', 'seller_vat_number', 'seller_registration_number',
+    'seller_address_line1', 'seller_address_line2', 'seller_postal_code', 'seller_city', 'seller_country',
+    'seller_region', 'seller_email', 'seller_phone', 'seller_website', 'seller_logo_url',
+    'seller_share_capital::text', 'seller_share_capital_currency', 'seller_activity_code', 'seller_activity_scheme',
+    'document_template',
+    'buyer_id', 'buyer_name', 'buyer_vat_number', 'buyer_registration_number', 'buyer_address_line1',
+    'buyer_address_line2', 'buyer_postal_code', 'buyer_city', 'buyer_country', 'buyer_region', 'buyer_email',
+    'country', 'number_format', 'numbering_gapless', 'legal_payment_days', 'late_payment_reference', 'tax_point_rule',
+    'einvoice_profile', 'einvoice_mandatory_from::text', 'party_scheme', 'vat_scheme',
+    'language', 'tax_point_date::text', 'delivery_address_line1', 'delivery_postal_code', 'delivery_city',
+    'delivery_country', 'seller_peppol_scheme', 'seller_peppol_identifier', 'buyer_peppol_scheme',
+    'buyer_peppol_identifier',
+];
+/** Every column of `document_line_items`. */
+const LINES = [
+    'document_line_id', 'document_id', 'company_id', 'sequence', 'line_type', 'item_name', 'item_description',
+    'seller_item_identifier', 'product_id', 'product_kind', 'quantity::text', 'unit_code', 'unit_price::text',
+    'discount_percent::text', 'amount_untaxed::text', 'tax_id', 'vat_category', 'vat_rate::text', 'account_id',
+    'tax_treatment', 'tax_exemption_code', 'tax_cash_basis', 'unit_price_includes_tax', 'amount_incl_tax::text',
+];
+/** Every column of `document_tax_summary`. */
+const TAXES = [
+    'document_id', 'company_id', 'doc_type', 'tax_id', 'tax_code', 'tax_name', 'vat_category', 'tax_rate::text',
+    'base_amount::text', 'tax_amount::text', 'tax_charged::text', 'exemption_code', 'exemption_reason',
+    'legal_reference',
+];
+/** Every column of `document_legal_mentions`. */
+const MENTIONS = [
+    'document_id', 'company_id', 'country', 'code', 'applies_when', 'language', 'text', 'text_i18n', 'sequence',
+    'legal_reference',
+];
+/** The four views of one document. */
+export async function readDocumentForPdf(backend, documentId) {
+    const header = onlyVisible(await backend.select({
+        table: 'document_header',
+        columns: HEADER,
+        where: [{ column: 'document_id', op: 'eq', value: documentId }],
+    }), `document ${documentId}`);
+    const where = [{ column: 'document_id', op: 'eq', value: documentId }];
+    const [lines, taxes, mentions] = await Promise.all([
+        backend.select({ table: 'document_line_items', columns: LINES, where, order: [{ column: 'sequence' }] }),
+        backend.select({ table: 'document_tax_summary', columns: TAXES, where, order: [{ column: 'tax_code' }] }),
+        backend.select({
+            table: 'document_legal_mentions',
+            columns: MENTIONS,
+            where,
+            order: [{ column: 'sequence' }, { column: 'code' }],
+        }),
+    ]);
+    return {
+        header: header,
+        lines: lines,
+        taxes: taxes,
+        mentions: mentions,
+    };
+}
+const LOGO_MAX_BYTES = 2 * 1024 * 1024;
+const LOGO_TIMEOUT_MS = 10_000;
+/**
+ * Why a logo URL is not fetched, or null when it may be. Only `http` and
+ * `https`, and never a host that names this machine or a private network: the
+ * URL is a value a member of the company typed, and the server that fetches it
+ * may be somebody else's.
+ */
+export function logoUrlRefusal(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return 'it is not a URL';
+    }
+    if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:')
+        return `${parsed.protocol} is not http or https`;
+    const host = parsed.hostname.toLowerCase().replace(/^\[|\]$/g, '');
+    if (host === 'localhost' || host.endsWith('.localhost') || host.endsWith('.local') || host.endsWith('.internal')) {
+        return `${host} is a local name`;
+    }
+    const v4 = /^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/.exec(host);
+    if (v4 !== null) {
+        const [a, b] = [Number(v4[1]), Number(v4[2])];
+        if (a === 0 || a === 10 || a === 127 || (a === 169 && b === 254) || (a === 172 && b >= 16 && b <= 31) || (a === 192 && b === 168) || (a === 100 && b >= 64 && b <= 127)) {
+            return `${host} is a private or local address`;
+        }
+    }
+    if (host.includes(':') && (host === '::1' || host === '::' || /^f[cd]/.test(host) || /^fe[89ab]/.test(host) || host.startsWith('::ffff:'))) {
+        return `${host} is a private or local address`;
+    }
+    return null;
+}
+/**
+ * The bytes of the logo at `url`, or why there are none. A logo that cannot be
+ * had is not a reason to refuse an invoice: the PDF is rendered with the
+ * company's name instead, and the reason is said.
+ */
+export async function fetchLogo(url, fetchImpl) {
+    const refusal = logoUrlRefusal(url);
+    if (refusal !== null)
+        return { skipped: `the logo URL is not fetched: ${refusal}` };
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), LOGO_TIMEOUT_MS);
+    try {
+        const response = await fetchImpl(url, { signal: controller.signal, redirect: 'error' });
+        if (!response.ok)
+            return { skipped: `the logo URL answered ${response.status}` };
+        const bytes = new Uint8Array(await response.arrayBuffer());
+        if (bytes.byteLength > LOGO_MAX_BYTES)
+            return { skipped: `the logo is ${bytes.byteLength} bytes, over ${LOGO_MAX_BYTES}` };
+        const png = bytes[0] === 0x89 && bytes[1] === 0x50 && bytes[2] === 0x4e && bytes[3] === 0x47;
+        const jpeg = bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff;
+        if (!png && !jpeg)
+            return { skipped: 'the logo is neither a PNG nor a JPEG' };
+        return { bytes };
+    }
+    catch (error) {
+        return { skipped: `the logo could not be fetched: ${error instanceof Error ? error.message : String(error)}` };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Renders the PDF of a sale invoice or credit note from the views, and
+ * records nothing. With `factur_x`, the document must be a posted sale: the
+ * CII is written from the books by the same adapter `einvoicing` uses, its
+ * broken rules are returned, and the XML is embedded all the same — a check
+ * that found something, which the caller reports.
+ */
+export async function renderDocumentPdf(backend, args, deps = {}) {
+    const input = await readDocumentForPdf(backend, args.document_id);
+    const { header } = input;
+    let logo = 'none';
+    const url = typeof header.seller_logo_url === 'string' ? header.seller_logo_url.trim() : '';
+    if (url !== '') {
+        if (deps.fetch === undefined)
+            logo = 'the logo URL is not fetched: no fetch was given';
+        else {
+            const fetched = await fetchLogo(url, deps.fetch);
+            if ('bytes' in fetched) {
+                input.logo = fetched.bytes;
+                logo = 'embedded';
+            }
+            else
+                logo = fetched.skipped;
+        }
+    }
+    const options = {
+        ...(args.page_size === undefined ? {} : { pageSize: args.page_size }),
+        ...(args.labels === undefined ? {} : { labels: args.labels }),
+        producer: '@ekwo-ai/core',
+    };
+    let factur = null;
+    let rendered;
+    try {
+        if (args.factur_x === true) {
+            if (header.state !== 'posted') {
+                throw new BooksError(`document_not_posted: ${String(header.doc_type)} ${String(header.number ?? args.document_id)} is ${String(header.state)}, and a Factur-X invoice is written from a posted document only.`, { hint: 'post_document (ekwo post <document>) books it; without --factur-x the PDF of a draft is rendered and titled as one.' });
+            }
+            const format = EINVOICE_FORMATS['factur-x-en16931'];
+            if (format === undefined)
+                throw new BooksError('format_without_brick: no brick writes factur-x-en16931 in this release.');
+            const written = format.write(await readEinvoiceSource(backend, args.document_id));
+            factur = { profile: 'en16931', violations: written.violations };
+            rendered = await renderFacturXPdf(input, { ...options, xml: written.content, profile: 'en16931', embed: embedFacturX });
+        }
+        else {
+            rendered = await renderInvoicePdf(input, options);
+        }
+    }
+    catch (error) {
+        if (error instanceof InvoicePdfError) {
+            throw new BooksError(`invoice_pdf_unrenderable: ${error.message}`);
+        }
+        throw error;
+    }
+    return {
+        document_id: args.document_id,
+        doc_type: String(header.doc_type),
+        number: header.number ?? null,
+        state: header.state ?? null,
+        language: header.language ?? null,
+        filename: rendered.filename,
+        title: rendered.title,
+        media_type: 'application/pdf',
+        byte_size: rendered.file.byteLength,
+        page_count: rendered.pageCount,
+        logo,
+        factur_x: factur,
+        file: rendered.file,
+    };
+}
+//# sourceMappingURL=document-pdf.js.map

package/dist/books/document-pdf.js.map

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

package/dist/books/index.d.ts

@@ -19,4 +19,5 @@ export * from './entries.js';
 export * from './payments.js';
 export * from './imports.js';
 export * from './statements.js';
+export * from './document-pdf.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/books/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/books/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/books/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/books/index.js

@@ -19,4 +19,5 @@ export * from './entries.js';
 export * from './payments.js';
 export * from './imports.js';
 export * from './statements.js';
+export * from './document-pdf.js';
 //# sourceMappingURL=index.js.map

package/dist/books/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/books/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/books/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,cAAc,CAAC;AAC7B,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC"}

package/dist/einvoicing/directory.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The transport that ships: a folder.
+ *
+ * It writes the file into `<root>/outbox/` and says where. No network, no
+ * credential, no account anywhere — which is what makes it the default, the
+ * one a self-hosted installation can use on the first day, and the one the
+ * tests run end to end. Whatever carries the files further — a script that
+ * uploads them to a portal, the client of an access point, a person — reads
+ * the folder, and may answer through it:
+ *
+ *     <root>/outbox/<file>                       written once, never overwritten
+ *     <root>/outbox/<file>.accepted_by_access_point
+ *     <root>/outbox/<file>.delivered             a receipt: its text is the
+ *     <root>/outbox/<file>.rejected              message, kept word for word
+ *     <root>/inbox/<file>                        what arrived, read by receive()
+ *
+ * The channel is `self`: the company takes the file where it goes, through a
+ * program of its own. A folder cannot tell whether an address is reachable,
+ * and `lookup()` says exactly that.
+ *
+ * A file name carries the first twelve characters of the file's checksum and
+ * the first eight of the sending's identifier. Two issues of one document
+ * never meet in the folder, and neither do two sendings of one file: a file
+ * sent again after a refusal is a new file beside the refused one, so the
+ * receipt of the first is never read as the answer to the second. Writing for
+ * the same sending twice is the same file — the second write finds it and
+ * checks it is byte for byte the one it would have written.
+ */
+import { type EinvoiceFile, type EinvoiceTransport } from './transport.js';
+/** `invoice-INV-1.xml`, a checksum and a sending → `invoice-INV-1.0f343b093112.5c1e0a7d.xml`. */
+export declare function directoryFilename(file: Pick<EinvoiceFile, 'filename' | 'checksum'>, transmissionId: string): string;
+export interface DirectoryTransportOptions {
+    /** Recorded as the service's name. A folder is the company's own act, so none by default. */
+    service?: string | null;
+}
+/** The folder transport, rooted at `root`. The folders are created on first use. */
+export declare function directoryTransport(root: string, options?: DirectoryTransportOptions): EinvoiceTransport;
+//# sourceMappingURL=directory.d.ts.map

package/dist/einvoicing/directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../../src/einvoicing/directory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAMvB,MAAM,gBAAgB,CAAC;AAaxB,iGAAiG;AACjG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,UAAU,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAMnH;AAeD,MAAM,WAAW,yBAAyB;IACxC,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,yBAA8B,GAAG,iBAAiB,CAgE3G"}

package/dist/einvoicing/directory.js

@@ -0,0 +1,121 @@
+/**
+ * The transport that ships: a folder.
+ *
+ * It writes the file into `<root>/outbox/` and says where. No network, no
+ * credential, no account anywhere — which is what makes it the default, the
+ * one a self-hosted installation can use on the first day, and the one the
+ * tests run end to end. Whatever carries the files further — a script that
+ * uploads them to a portal, the client of an access point, a person — reads
+ * the folder, and may answer through it:
+ *
+ *     <root>/outbox/<file>                       written once, never overwritten
+ *     <root>/outbox/<file>.accepted_by_access_point
+ *     <root>/outbox/<file>.delivered             a receipt: its text is the
+ *     <root>/outbox/<file>.rejected              message, kept word for word
+ *     <root>/inbox/<file>                        what arrived, read by receive()
+ *
+ * The channel is `self`: the company takes the file where it goes, through a
+ * program of its own. A folder cannot tell whether an address is reachable,
+ * and `lookup()` says exactly that.
+ *
+ * A file name carries the first twelve characters of the file's checksum and
+ * the first eight of the sending's identifier. Two issues of one document
+ * never meet in the folder, and neither do two sendings of one file: a file
+ * sent again after a refusal is a new file beside the refused one, so the
+ * receipt of the first is never read as the answer to the second. Writing for
+ * the same sending twice is the same file — the second write finds it and
+ * checks it is byte for byte the one it would have written.
+ */
+import { mkdir, readFile, readdir, stat, writeFile } from 'node:fs/promises';
+import { basename, extname, join } from 'node:path';
+import { TransportError, } from './transport.js';
+/** The answers a carrier may leave beside a file, in the order they are read: the furthest first. */
+const RECEIPTS = ['delivered', 'rejected', 'accepted_by_access_point'];
+const OUTBOX = 'outbox';
+const INBOX = 'inbox';
+/** The media type of a file that arrived, from its name. Nothing is guessed beyond the extension. */
+function mediaTypeOf(name) {
+    return extname(name).toLowerCase() === '.xml' ? 'application/xml' : 'application/octet-stream';
+}
+/** `invoice-INV-1.xml`, a checksum and a sending → `invoice-INV-1.0f343b093112.5c1e0a7d.xml`. */
+export function directoryFilename(file, transmissionId) {
+    const safe = basename(file.filename).replace(/[^A-Za-z0-9._-]+/g, '-');
+    const extension = extname(safe);
+    const stem = extension === '' ? safe : safe.slice(0, -extension.length);
+    const sending = transmissionId.replace(/[^A-Za-z0-9]+/g, '').slice(0, 8);
+    return `${stem === '' ? 'einvoice' : stem}.${file.checksum.slice(0, 12)}${sending === '' ? '' : `.${sending}`}${extension}`;
+}
+/** A reference this transport gave, and nothing else: `outbox/<one file name>`. */
+function outboxPath(root, reference) {
+    const name = reference.startsWith(`${OUTBOX}/`) ? reference.slice(OUTBOX.length + 1) : '';
+    if (name === '' || name !== basename(name) || name.startsWith('.')) {
+        throw new TransportError(`unknown_reference: ${reference} is not a file this directory wrote`);
+    }
+    return join(root, OUTBOX, name);
+}
+async function exists(path) {
+    return (await stat(path).catch(() => undefined)) !== undefined;
+}
+/** The folder transport, rooted at `root`. The folders are created on first use. */
+export function directoryTransport(root, options = {}) {
+    return {
+        channel: 'self',
+        service: options.service ?? null,
+        async send(file, metadata) {
+            const name = directoryFilename(file, metadata.transmissionId);
+            const path = join(root, OUTBOX, name);
+            try {
+                await mkdir(join(root, OUTBOX), { recursive: true });
+                await writeFile(path, file.content, { encoding: 'utf8', flag: 'wx' });
+            }
+            catch (error) {
+                const code = error.code;
+                if (code !== 'EEXIST') {
+                    throw new TransportError(`directory_unwritable: ${error.message}`);
+                }
+                // Written already: the same file, or a refusal. Never overwritten.
+                const there = await readFile(path, 'utf8');
+                if (there !== file.content) {
+                    throw new TransportError(`directory_conflict: ${path} already holds another file under this name, and it is not overwritten`);
+                }
+            }
+            return { reference: `${OUTBOX}/${name}`, state: 'submitted', message: null };
+        },
+        async status(reference) {
+            const path = outboxPath(root, reference);
+            for (const state of RECEIPTS) {
+                const receipt = `${path}.${state}`;
+                if (await exists(receipt)) {
+                    const text = await readFile(receipt, 'utf8');
+                    return { state, message: text === '' ? null : text };
+                }
+            }
+            // No receipt: the file is where it was written, or whatever carries the
+            // files took it and has said nothing yet. Either way it was handed over.
+            return { state: 'submitted', message: null };
+        },
+        async receive() {
+            const dir = join(root, INBOX);
+            const names = (await readdir(dir).catch(() => [])).filter((name) => !name.startsWith('.')).sort();
+            const out = [];
+            for (const name of names) {
+                const path = join(dir, name);
+                const info = await stat(path);
+                if (!info.isFile())
+                    continue;
+                out.push({
+                    reference: `${INBOX}/${name}`,
+                    filename: name,
+                    mediaType: mediaTypeOf(name),
+                    content: await readFile(path, 'utf8'),
+                    receivedAt: info.mtime.toISOString(),
+                });
+            }
+            return out;
+        },
+        async lookup() {
+            return { reachable: null, message: 'a directory cannot tell whether an address is reachable' };
+        },
+    };
+}
+//# sourceMappingURL=directory.js.map

package/dist/einvoicing/directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.js","sourceRoot":"","sources":["../../src/einvoicing/directory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EACL,cAAc,GAQf,MAAM,gBAAgB,CAAC;AAExB,qGAAqG;AACrG,MAAM,QAAQ,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,0BAA0B,CAAU,CAAC;AAEhF,MAAM,MAAM,GAAG,QAAQ,CAAC;AACxB,MAAM,KAAK,GAAG,OAAO,CAAC;AAEtB,qGAAqG;AACrG,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,0BAA0B,CAAC;AACjG,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,iBAAiB,CAAC,IAAiD,EAAE,cAAsB;IACzG,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzE,OAAO,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,GAAG,SAAS,EAAE,CAAC;AAC9H,CAAC;AAED,mFAAmF;AACnF,SAAS,UAAU,CAAC,IAAY,EAAE,SAAiB;IACjD,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1F,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,cAAc,CAAC,sBAAsB,SAAS,qCAAqC,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,IAAY;IAChC,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,KAAK,SAAS,CAAC;AACjE,CAAC;AAOD,oFAAoF;AACpF,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,UAAqC,EAAE;IACtF,OAAO;QACL,OAAO,EAAE,MAAM;QACf,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAEhC,KAAK,CAAC,IAAI,CAAC,IAAkB,EAAE,QAAsB;YACnD,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;YAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YACtC,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACrD,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACxE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;gBACnD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACtB,MAAM,IAAI,cAAc,CAAC,yBAA0B,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;gBAChF,CAAC;gBACD,mEAAmE;gBACnE,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBAC3C,IAAI,KAAK,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;oBAC3B,MAAM,IAAI,cAAc,CACtB,uBAAuB,IAAI,wEAAwE,CACpG,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC/E,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,SAAiB;YAC5B,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YACzC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;gBAC7B,MAAM,OAAO,GAAG,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;gBACnC,IAAI,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC1B,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;oBAC7C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBACvD,CAAC;YACH,CAAC;YACD,wEAAwE;YACxE,yEAAyE;YACzE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC/C,CAAC;QAED,KAAK,CAAC,OAAO;YACX,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC9B,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC9G,MAAM,GAAG,GAAmB,EAAE,CAAC;YAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBAC7B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC9B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;oBAAE,SAAS;gBAC7B,GAAG,CAAC,IAAI,CAAC;oBACP,SAAS,EAAE,GAAG,KAAK,IAAI,IAAI,EAAE;oBAC7B,QAAQ,EAAE,IAAI;oBACd,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC;oBAC5B,OAAO,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;oBACrC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;iBACrC,CAAC,CAAC;YACL,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QAED,KAAK,CAAC,MAAM;YACV,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,yDAAyD,EAAE,CAAC;QACjG,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/einvoicing/formats.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Which brick writes which profile, and how each is fed from the books.
+ *
+ * A country pack says which e-invoicing profile its companies issue in —
+ * `peppol-bis-3`, `factur-x-en16931`, `xrechnung`, a PINT — and the socle
+ * compiles it into `country_defaults.einvoice_profile`, which
+ * `document_header` publishes. A profile is a format, not a country: the
+ * mapping below names no country and would be the same for any pack that
+ * declared the same profile.
+ *
+ * **A profile without a brick is refused by name**, `format_without_brick`,
+ * and never written in the nearest format that exists: a file in another
+ * profile is a file the network or the platform refuses, after it has left.
+ * Adding a profile is adding an entry here and a brick under
+ * `packages/formats/`, nothing else.
+ *
+ * Every writer reads the same three rows the views publish and nothing else,
+ * plus one fact the views do not carry and the books do: which invoice a
+ * credit note credits (BG-3), read from `documents.reversed_document_id`.
+ * Nothing is defaulted on the way: a value the books do not hold is a value
+ * the file does not hold, and the rule that wanted it is reported.
+ */
+import { type Row } from '../books/backend.js';
+/** One rule of the format a file breaks, named as the brick or the published rule names it. */
+export interface EinvoiceViolation {
+    code: string;
+    message: string;
+    line?: string;
+}
+/** A posted sale as the books publish it: three views, and the invoice a credit note credits. */
+export interface EinvoiceSource {
+    header: Row;
+    lines: Row[];
+    taxes: Row[];
+    preceding: {
+        number: string;
+        issueDate: string | null;
+    } | null;
+}
+/** What a writer hands back. */
+export interface WrittenEinvoice {
+    content: string;
+    filename: string;
+    violations: EinvoiceViolation[];
+}
+/** One profile a brick writes. */
+export interface EinvoiceFormat {
+    profile: string;
+    /** The package of `packages/formats/` that writes it, by its published name. */
+    brick: string;
+    syntax: string;
+    mediaType: string;
+    /** What the file declares it follows: a customization identifier, a guideline. */
+    specification: string;
+    write(source: EinvoiceSource): WrittenEinvoice;
+}
+/** Every profile a brick of this release writes, by the name a pack declares it under. */
+export declare const EINVOICE_FORMATS: Readonly<Record<string, EinvoiceFormat>>;
+/**
+ * The format of a profile, or the refusal that names what is missing: no
+ * profile in the pack (`no_einvoicing_profile`), or a profile no brick of this
+ * release writes (`format_without_brick`).
+ */
+export declare function einvoiceFormat(profile: string | null | undefined): EinvoiceFormat;
+//# sourceMappingURL=formats.d.ts.map

package/dist/einvoicing/formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../src/einvoicing/formats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH,OAAO,EAAc,KAAK,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAE3D,+FAA+F;AAC/F,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,iGAAiG;AACjG,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,GAAG,CAAC;IACZ,KAAK,EAAE,GAAG,EAAE,CAAC;IACb,KAAK,EAAE,GAAG,EAAE,CAAC;IACb,SAAS,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CAChE;AAED,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACjC;AAED,kCAAkC;AAClC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,CAAC;CAChD;AAmVD,0FAA0F;AAC1F,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAGrE,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,cAAc,CAejF"}