@open-nav/invoicing 0.1.0

package/LICENSE

@@ -0,0 +1,29 @@
+MIT License
+
+Copyright (c) 2026 open-nav contributors
+
+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.
+
+---
+
+This repository vendors XML schemas, sample documents and validation message
+catalogues published by the Hungarian Tax and Customs Administration
+(Nemzeti Adó- és Vámhivatal) under the MIT license. Those files live under
+`schemas/` and `conformance/`, retain NAV's copyright, and are covered by
+`schemas/NAV-LICENCE.md`. See `schemas/README.md` for provenance.

package/README.md

@@ -0,0 +1,190 @@
+# @open-nav/invoicing
+
+Turn NAV invoice data into the two documents an invoicing program has to be
+able to produce: a printable invoice, and the tax authority data export.
+
+## The printable invoice
+
+```sh
+open-nav render invoice.xml --pdf invoice.pdf --theme theme.json
+```
+
+```ts
+import { renderInvoicePdf, renderInvoiceHtml, loadTheme } from '@open-nav/invoicing';
+
+const theme = loadTheme('theme.json');
+const pdf = await renderInvoicePdf(invoice, { theme }); // Buffer
+const html = renderInvoiceHtml(invoice, { theme }); // string
+```
+
+### Styling
+
+Everything visual comes from a theme, which can live in a JSON file next to
+its logo — see [`examples/invoice-theme.json`](../../examples/invoice-theme.json).
+
+| Field                                                 | Purpose                                                                |
+| ----------------------------------------------------- | ---------------------------------------------------------------------- |
+| `accentColor`                                         | Title, the grand total, the rule above it                              |
+| `inkColor`, `mutedColor`, `panelColor`, `borderColor` | The rest of the palette                                                |
+| `fontFamily`, `baseFontSize`                          | Typography; everything scales from the base size                       |
+| `pageSize`, `pageMargin`                              | `@page` setup, e.g. `A4` and `16mm 14mm`                               |
+| `logo` / `logoFile`                                   | Header logo. `logoFile` is read relative to the theme file and inlined |
+| `issuerContact`                                       | Extra lines in the supplier block: phone, email, web                   |
+| `footerLines`                                         | Footer: payment terms, company registration, bank details              |
+| `zebraRows`                                           | Tint alternate table rows                                              |
+| `provenanceNote`                                      | Whether to print the "rendered from reported data" line                |
+| `customCss`                                           | Appended after the generated stylesheet. The escape hatch              |
+
+Theme values end up inside the stylesheet, so they are **validated rather
+than interpolated**: a colour must look like a CSS colour, a font stack may
+not contain parentheses (no font name does, and allowing them would admit
+`url(...)`), and a logo must be a `data:` URI or an `http(s)` URL. A bad value
+names the field it came from.
+
+`--logo` on the command line overrides the theme's, so one branded theme can
+be shared and a single document still overridden.
+
+### How the PDF is made, and why
+
+`ő` and `ű` are the whole difficulty. Both lie outside WinAnsi, the encoding
+the PDF core fonts use, so **a font has to be embedded** for a Hungarian
+invoice to spell itself. (This is not hypothetical: of the fonts installed on
+the machine this was developed on, one — Loma — is missing exactly those four
+characters and nothing else.)
+
+There are two engines, and the default needs nothing installed.
+
+**`native`** — the default. pdfmake lays the document out, pdfkit writes the
+PDF, and the Roboto files pdfmake bundles supply the glyphs. Roboto covers
+Latin Extended-A, is Apache-2.0, and embeds as a subset with a correct
+ToUnicode map, so the text stays searchable and copyable. Output is around a
+quarter the size of a browser's.
+
+```ts
+const pdf = await renderInvoicePdf(invoice, { theme }); // native
+```
+
+Bring your own font if the brand needs one:
+
+```ts
+const pdf = await renderInvoicePdf(invoice, {
+  theme,
+  font: { name: 'Inter', normal: 'fonts/Inter-Regular.ttf', bold: 'fonts/Inter-SemiBold.ttf' },
+});
+```
+
+**`browser`** — renders the HTML document and converts it with Chrome,
+Chromium or Edge. It follows the HTML exactly, which matters if you have
+styled it with `customCss` beyond what the native layout reproduces.
+
+```sh
+open-nav render invoice.xml --pdf invoice.pdf --engine browser --no-sandbox
+```
+
+`findBrowser()` locates one: an explicit `OPEN_NAV_BROWSER`, `CHROME_PATH` or
+`PUPPETEER_EXECUTABLE_PATH`, then a Playwright install, then the usual
+locations, then `PATH` — preferring a full build over a headless shell, which
+cannot print. Or supply `convert` and use Playwright directly:
+
+```ts
+import { chromium } from 'playwright';
+
+const convert = async (html: string) => {
+  const browser = await chromium.launch();
+  const page = await browser.newPage();
+  await page.setContent(html, { waitUntil: 'load' });
+  const pdf = await page.pdf({ printBackground: true });
+  await browser.close();
+  return pdf;
+};
+
+const pdf = await renderInvoicePdf(invoice, { convert }); // implies browser
+```
+
+**The browser sandbox stays on by default.** Invoice data is input, and the
+sandbox is what contains a malicious document, so conversion fails as root —
+usual in a container. Pass `sandbox: false`, or `--no-sandbox`, deliberately.
+
+The native engine has no such exposure: it fetches nothing and reads nothing
+but the font files it registered, both enforced through pdfmake's access
+policies rather than left at their permissive defaults.
+
+### The two engines are two layouts
+
+They follow the same theme, but the native engine builds the page from
+pdfmake's document model rather than CSS, so **they will not match pixel for
+pixel**. Known differences: party boxes have square corners rather than
+rounded, an SVG logo is skipped because pdfmake cannot rasterise one (use PNG
+or JPEG), and `customCss` applies only to HTML. The native engine adds page
+numbers when a document runs to more than one page.
+
+The HTML has no external references — no fonts, scripts or images fetched — so
+it renders the same offline and archives as a single file. Keep the logo
+inlined for that reason; a logo fetched over the network is the usual cause of
+a conversion that hangs, or a PDF that silently comes out logo-less.
+
+### It derives the markings the law requires
+
+Section 169 of the VAT Act prescribes more than figures. An exempt supply must
+state its legal ground, a domestic reverse charge must say _fordított adózás_,
+cash accounting must say _pénzforgalmi elszámolás_, a margin scheme must name
+which one. These are derived from the invoice data and printed with the
+provision they come from, because a missing phrase makes an invoice defective
+even when every number on it is right:
+
+```text
+JOGSZABÁLYI JELÖLÉSEK
+  • fordított adózás (Áfa tv. 169. § n))
+  • különbözet szerinti szabályozás – használt cikkek (Áfa tv. 169. § o) p))
+  • Adómentes — TAM — Mentes ÁFA tv. 85.§ (1) i) (Áfa tv. 169. § m))
+```
+
+Also handled: simplified and aggregate invoices get their own title, a
+modification document names the invoice it amends, a foreign-currency invoice
+shows the rate and the forint total, a private person is never named, and a
+batch document renders each invoice on its own page.
+
+Amounts are formatted from the exact decimal strings, never through a
+JavaScript number, so an 18 digit total survives to the page.
+
+## The data export
+
+Decree **23/2014. (VI. 30.) NGM** requires every invoicing program to have a
+built-in _adóhatósági ellenőrzési adatszolgáltatás_ function that exports the
+invoices issued in a date range, or in an invoice number range, as XML.
+
+```sh
+open-nav export invoices/*.xml --out export/ --from 2024-01-01 --to 2024-12-31
+```
+
+Two structures are permitted. Annexes 2 and 3 of the decree define one
+(`szamla.xsd`); **section 13/A(1)** permits the other — the structure
+published for the online invoice data service, which is `invoiceData.xsd`.
+This produces the second, because it is the schema this project already
+generates, validates and round-trips against NAV's own documents.
+
+That choice belongs to the taxpayer. **If your auditor asks for the Annex 3
+structure specifically, this export is not it.**
+
+The export writes one XML per invoice plus a `manifest.json` recording what
+was selected, the structure used with the provision that permits it, and the
+SHA-256 of every file — so the export can later be shown to be the one that
+was produced.
+
+### Invoice number ranges order naturally
+
+Selecting `2024/1` to `2024/10` by plain text comparison excludes `2024/9`,
+because `"2024/9" > "2024/10"` as text. Digit runs are therefore compared as
+numbers by default, so a requested range does not silently lose invoices from
+the middle of it. Pass `compareInvoiceNumbers` if your numbering needs
+something else.
+
+## What this does not claim
+
+It does not make anyone's invoicing program compliant. Gapless numbering,
+immutable storage and the audit trail are the issuer's obligations, and a
+rendered document is a presentation of reported data, not the legal original.
+
+## Licence
+
+MIT. Not affiliated with NAV.

package/dist/color.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Colour conversion for the PDF engine.
+ *
+ * A browser accepts every CSS colour form; PDF does not — pdfkit understands
+ * hex and the CSS colour keywords. Converting here means a theme behaves the
+ * same whichever engine renders it, rather than silently losing a colour in
+ * one of them.
+ */
+/**
+ * Convert any accepted theme colour to `#rrggbb`.
+ *
+ * Alpha is dropped: PDF has no per-colour alpha in this position, and a
+ * silently half-transparent rule is worse than an opaque one.
+ */
+export declare function toHexColor(value: string, fallback?: string): string;
+/**
+ * Convert a CSS length to PDF points.
+ *
+ * `em`, `rem` and `%` are relative to a layout that does not exist here, so
+ * they fall back rather than being guessed at.
+ */
+export declare function toPoints(value: string, fallback: number): number;
+/**
+ * Expand a CSS margin shorthand into PDF's `[left, top, right, bottom]`.
+ *
+ * CSS orders shorthand clockwise from the top; pdfmake starts at the left.
+ * Getting that wrong swaps the margins on a non-square page, which is exactly
+ * the kind of error nobody notices until something prints.
+ */
+export declare function toMargins(value: string, fallback: number): [number, number, number, number];
+//# sourceMappingURL=color.d.ts.map

package/dist/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuBH;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAY,GAAG,MAAM,CA+BtE;AAqED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQhE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAU3F"}

package/dist/color.js

@@ -0,0 +1,150 @@
+/**
+ * Colour conversion for the PDF engine.
+ *
+ * A browser accepts every CSS colour form; PDF does not — pdfkit understands
+ * hex and the CSS colour keywords. Converting here means a theme behaves the
+ * same whichever engine renders it, rather than silently losing a colour in
+ * one of them.
+ */
+/** CSS colour keywords, kept to the ones a document is plausibly styled with. */
+const KEYWORDS = {
+    black: '#000000',
+    white: '#ffffff',
+    red: '#ff0000',
+    green: '#008000',
+    blue: '#0000ff',
+    navy: '#000080',
+    teal: '#008080',
+    olive: '#808000',
+    purple: '#800080',
+    maroon: '#800000',
+    gray: '#808080',
+    grey: '#808080',
+    silver: '#c0c0c0',
+    orange: '#ffa500',
+    yellow: '#ffff00',
+    rebeccapurple: '#663399',
+    transparent: '#ffffff',
+};
+/**
+ * Convert any accepted theme colour to `#rrggbb`.
+ *
+ * Alpha is dropped: PDF has no per-colour alpha in this position, and a
+ * silently half-transparent rule is worse than an opaque one.
+ */
+export function toHexColor(value, fallback = '#000000') {
+    const input = value.trim().toLowerCase();
+    const keyword = KEYWORDS[input];
+    if (keyword)
+        return keyword;
+    if (input.startsWith('#')) {
+        const digits = input.slice(1);
+        if (digits.length === 3 || digits.length === 4) {
+            const [r, g, b] = [...digits.slice(0, 3)];
+            return `#${r}${r}${g}${g}${b}${b}`;
+        }
+        if (digits.length === 6 || digits.length === 8)
+            return `#${digits.slice(0, 6)}`;
+        return fallback;
+    }
+    const rgb = /^rgba?\(([^)]+)\)$/.exec(input);
+    if (rgb) {
+        const parts = splitComponents(rgb[1]);
+        if (parts.length < 3)
+            return fallback;
+        return hex(channel(parts[0]), channel(parts[1]), channel(parts[2]));
+    }
+    const hsl = /^hsla?\(([^)]+)\)$/.exec(input);
+    if (hsl) {
+        const parts = splitComponents(hsl[1]);
+        if (parts.length < 3)
+            return fallback;
+        return hslToHex(angle(parts[0]), percent(parts[1]), percent(parts[2]));
+    }
+    return fallback;
+}
+function splitComponents(body) {
+    return body
+        .split(/[,\s/]+/)
+        .map((part) => part.trim())
+        .filter((part) => part !== '');
+}
+/** An rgb channel: 0-255, or a percentage. */
+function channel(part) {
+    const value = part.endsWith('%')
+        ? (Number.parseFloat(part) / 100) * 255
+        : Number.parseFloat(part);
+    return clamp(Math.round(value), 0, 255);
+}
+function angle(part) {
+    const value = Number.parseFloat(part);
+    return Number.isFinite(value) ? ((value % 360) + 360) % 360 : 0;
+}
+function percent(part) {
+    const value = Number.parseFloat(part);
+    return clamp(Number.isFinite(value) ? value / 100 : 0, 0, 1);
+}
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+function hex(r, g, b) {
+    return `#${[r, g, b].map((c) => c.toString(16).padStart(2, '0')).join('')}`;
+}
+function hslToHex(hue, saturation, lightness) {
+    const chroma = (1 - Math.abs(2 * lightness - 1)) * saturation;
+    const sector = hue / 60;
+    const second = chroma * (1 - Math.abs((sector % 2) - 1));
+    const [r, g, b] = sector < 1
+        ? [chroma, second, 0]
+        : sector < 2
+            ? [second, chroma, 0]
+            : sector < 3
+                ? [0, chroma, second]
+                : sector < 4
+                    ? [0, second, chroma]
+                    : sector < 5
+                        ? [second, 0, chroma]
+                        : [chroma, 0, second];
+    const offset = lightness - chroma / 2;
+    return hex(Math.round((r + offset) * 255), Math.round((g + offset) * 255), Math.round((b + offset) * 255));
+}
+/** Units CSS uses that convert to PDF points without a layout context. */
+const UNIT_TO_POINTS = {
+    pt: 1,
+    px: 0.75,
+    pc: 12,
+    mm: 72 / 25.4,
+    cm: 72 / 2.54,
+    in: 72,
+};
+/**
+ * Convert a CSS length to PDF points.
+ *
+ * `em`, `rem` and `%` are relative to a layout that does not exist here, so
+ * they fall back rather than being guessed at.
+ */
+export function toPoints(value, fallback) {
+    const match = /^([0-9.]+)([a-z%]*)$/.exec(value.trim());
+    if (!match)
+        return fallback;
+    const size = Number.parseFloat(match[1]);
+    if (!Number.isFinite(size))
+        return fallback;
+    const unit = match[2] === '' ? 'pt' : match[2];
+    const factor = UNIT_TO_POINTS[unit];
+    return factor === undefined ? fallback : size * factor;
+}
+/**
+ * Expand a CSS margin shorthand into PDF's `[left, top, right, bottom]`.
+ *
+ * CSS orders shorthand clockwise from the top; pdfmake starts at the left.
+ * Getting that wrong swaps the margins on a non-square page, which is exactly
+ * the kind of error nobody notices until something prints.
+ */
+export function toMargins(value, fallback) {
+    const parts = value.trim().split(/\s+/).filter(Boolean);
+    const points = parts.map((part) => toPoints(part, fallback));
+    const [top = fallback, right = points[0] ?? fallback, bottom = points[0] ?? fallback, left = points[1] ?? points[0] ?? fallback,] = points;
+    return [left, top, right, bottom];
+}
+//# sourceMappingURL=color.js.map

package/dist/color.js.map

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

package/dist/export.d.ts

@@ -0,0 +1,89 @@
+import { type InvoiceData } from '@open-nav/core';
+/**
+ * The data export an invoicing program must be able to produce.
+ *
+ * Decree 23/2014. (VI. 30.) NGM requires every invoicing program to have a
+ * built-in "adóhatósági ellenőrzési adatszolgáltatás" function that exports
+ * the invoices issued in a given date range, or in a given invoice number
+ * range, as XML.
+ *
+ * Two structures are permitted. Annexes 2 and 3 of the decree define one
+ * (`szamla.xsd`); section 13/A(1) permits the other — the structure published
+ * for the online invoice data service, which is `invoiceData.xsd`. This
+ * implementation produces the second, because it is the same schema this
+ * project already generates, validates and round-trips against NAV's own
+ * sample documents.
+ *
+ * That choice belongs to the taxpayer, not to this library. If your auditor
+ * asks for the Annex 3 structure specifically, this export is not it.
+ */
+export interface DataExportSelection {
+    /** First issue date to include, inclusive, as `yyyy-mm-dd`. */
+    issueDateFrom?: string;
+    /** Last issue date to include, inclusive. */
+    issueDateTo?: string;
+    /** First invoice number to include, inclusive. */
+    invoiceNumberFrom?: string;
+    /** Last invoice number to include, inclusive. */
+    invoiceNumberTo?: string;
+}
+export interface DataExportOptions extends DataExportSelection {
+    /**
+     * How invoice numbers are ordered when a number range is given.
+     *
+     * The default compares digit runs numerically, so `2024/9` sorts before
+     * `2024/10`. Plain text ordering puts them the other way round and would
+     * silently drop invoices from the middle of a requested range — which is
+     * the kind of mistake an audit is precisely designed to find.
+     */
+    compareInvoiceNumbers?: (left: string, right: string) => number;
+    /** Injectable clock, so an export is reproducible in tests. */
+    now?: () => Date;
+}
+export interface ExportedFile {
+    /** Path within the export, e.g. `invoices/2024-000123.xml`. */
+    name: string;
+    contents: string;
+}
+export interface ExportedInvoice {
+    invoiceNumber: string;
+    invoiceIssueDate: string;
+    file: string;
+    /** SHA-256 of the file, so the export can be shown to be unaltered. */
+    sha256: string;
+}
+export interface DataExportManifest {
+    /** What was asked for. */
+    selection: DataExportSelection;
+    /** The structure used, and the provision that permits it. */
+    structure: {
+        schema: string;
+        namespace: string;
+        basis: string;
+    };
+    generatedAt: string;
+    invoiceCount: number;
+    invoices: ExportedInvoice[];
+}
+export interface DataExportResult {
+    /** Every file in the export, manifest included. */
+    files: ExportedFile[];
+    manifest: DataExportManifest;
+}
+/**
+ * Natural ordering for invoice numbers: digit runs compare as numbers.
+ *
+ * `2024/9` before `2024/10`, and `A-2` before `A-10`.
+ */
+export declare function compareInvoiceNumbersNaturally(left: string, right: string): number;
+/** Whether an invoice falls inside the requested selection. */
+export declare function isSelected(invoice: InvoiceData, options: DataExportOptions): boolean;
+/**
+ * Build the export from a set of invoices.
+ *
+ * One XML file per invoice, plus a manifest recording what was selected and
+ * the SHA-256 of every file, so the export can later be shown to be the one
+ * that was produced.
+ */
+export declare function createDataExport(invoices: InvoiceData[], options?: DataExportOptions): DataExportResult;
+//# sourceMappingURL=export.d.ts.map

package/dist/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAErE;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAChE,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,SAAS,EAAE,mBAAmB,CAAC;IAC/B,6DAA6D;IAC7D,SAAS,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAsBlF;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAYpF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CA+ClB"}

package/dist/export.js

@@ -0,0 +1,115 @@
+import { createHash } from 'node:crypto';
+import { serializeDocument } from '@open-nav/core';
+/**
+ * Natural ordering for invoice numbers: digit runs compare as numbers.
+ *
+ * `2024/9` before `2024/10`, and `A-2` before `A-10`.
+ */
+export function compareInvoiceNumbersNaturally(left, right) {
+    const chunk = /(\d+|\D+)/g;
+    const leftParts = left.match(chunk) ?? [];
+    const rightParts = right.match(chunk) ?? [];
+    for (let index = 0; index < Math.max(leftParts.length, rightParts.length); index += 1) {
+        const a = leftParts[index];
+        const b = rightParts[index];
+        if (a === undefined)
+            return -1;
+        if (b === undefined)
+            return 1;
+        const aNumeric = /^\d+$/.test(a);
+        const bNumeric = /^\d+$/.test(b);
+        if (aNumeric && bNumeric) {
+            // BigInt, because an invoice number can be longer than a safe integer.
+            const difference = BigInt(a) - BigInt(b);
+            if (difference !== 0n)
+                return difference < 0n ? -1 : 1;
+            continue;
+        }
+        if (a !== b)
+            return a < b ? -1 : 1;
+    }
+    return 0;
+}
+/** Whether an invoice falls inside the requested selection. */
+export function isSelected(invoice, options) {
+    const compare = options.compareInvoiceNumbers ?? compareInvoiceNumbersNaturally;
+    if (options.issueDateFrom && invoice.invoiceIssueDate < options.issueDateFrom)
+        return false;
+    if (options.issueDateTo && invoice.invoiceIssueDate > options.issueDateTo)
+        return false;
+    if (options.invoiceNumberFrom && compare(invoice.invoiceNumber, options.invoiceNumberFrom) < 0) {
+        return false;
+    }
+    if (options.invoiceNumberTo && compare(invoice.invoiceNumber, options.invoiceNumberTo) > 0) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Build the export from a set of invoices.
+ *
+ * One XML file per invoice, plus a manifest recording what was selected and
+ * the SHA-256 of every file, so the export can later be shown to be the one
+ * that was produced.
+ */
+export function createDataExport(invoices, options = {}) {
+    const now = options.now ?? (() => new Date());
+    const compare = options.compareInvoiceNumbers ?? compareInvoiceNumbersNaturally;
+    const selected = invoices
+        .filter((invoice) => isSelected(invoice, options))
+        .sort((left, right) => compare(left.invoiceNumber, right.invoiceNumber));
+    const files = [];
+    const entries = [];
+    const usedNames = new Set();
+    for (const invoice of selected) {
+        const name = uniqueName(`invoices/${safeFileName(invoice.invoiceNumber)}.xml`, usedNames);
+        const contents = serializeDocument('InvoiceData', invoice, { indent: '  ' });
+        files.push({ name, contents });
+        entries.push({
+            invoiceNumber: invoice.invoiceNumber,
+            invoiceIssueDate: invoice.invoiceIssueDate,
+            file: name,
+            sha256: createHash('sha256').update(contents, 'utf8').digest('hex'),
+        });
+    }
+    const selection = {
+        ...(options.issueDateFrom ? { issueDateFrom: options.issueDateFrom } : {}),
+        ...(options.issueDateTo ? { issueDateTo: options.issueDateTo } : {}),
+        ...(options.invoiceNumberFrom ? { invoiceNumberFrom: options.invoiceNumberFrom } : {}),
+        ...(options.invoiceNumberTo ? { invoiceNumberTo: options.invoiceNumberTo } : {}),
+    };
+    const manifest = {
+        selection,
+        structure: {
+            schema: 'invoiceData.xsd',
+            namespace: 'http://schemas.nav.gov.hu/OSA/3.0/data',
+            basis: '23/2014. (VI. 30.) NGM rendelet 13/A. § (1) — the data structure published ' +
+                'for the online invoice data service',
+        },
+        generatedAt: now().toISOString(),
+        invoiceCount: entries.length,
+        invoices: entries,
+    };
+    files.push({ name: 'manifest.json', contents: `${JSON.stringify(manifest, null, 2)}\n` });
+    return { files, manifest };
+}
+/** An invoice number can contain `/`, which a file name cannot. */
+function safeFileName(invoiceNumber) {
+    const cleaned = invoiceNumber.replace(/[^A-Za-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '');
+    return cleaned === '' ? 'invoice' : cleaned;
+}
+/** Two invoice numbers can sanitise to the same name; keep them distinct. */
+function uniqueName(name, used) {
+    if (!used.has(name)) {
+        used.add(name);
+        return name;
+    }
+    for (let suffix = 2;; suffix += 1) {
+        const candidate = name.replace(/\.xml$/, `-${suffix}.xml`);
+        if (!used.has(candidate)) {
+            used.add(candidate);
+            return candidate;
+        }
+    }
+}
+//# sourceMappingURL=export.js.map

package/dist/export.js.map

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

package/dist/format.d.ts

@@ -0,0 +1,23 @@
+export type DocumentLanguage = 'hu' | 'en';
+/**
+ * Format an exact decimal for display without going through a JavaScript
+ * number.
+ *
+ * The amounts on an invoice are exact decimal strings precisely so they do
+ * not lose precision; rendering them through `Number` to get thousands
+ * separators would throw that away at the top of NAV's 18 digit range.
+ */
+export declare function formatAmount(value: string, language: DocumentLanguage, fractionDigits?: number): string;
+/** Format a VAT rate like `0.27` as a percentage. */
+export declare function formatPercentage(value: string, language: DocumentLanguage): string;
+/** Dates are ISO in the data; Hungarian documents write them with dots. */
+export declare function formatDate(value: string, language: DocumentLanguage): string;
+/** Compose a tax number from its parts, in the written form. */
+export declare function formatTaxNumber(parts: {
+    taxpayerId: string;
+    vatCode?: string;
+    countyCode?: string;
+}): string;
+/** Escape text for HTML. */
+export declare function escapeHtml(value: string): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3C;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,gBAAgB,EAC1B,cAAc,SAAI,GACjB,MAAM,CAaR;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAOlF;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAK5E;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAET;AAED,4BAA4B;AAC5B,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhD"}