@open-nav/core 0.1.0

package/dist/money/summary.js

@@ -0,0 +1,236 @@
+import { Decimal, sum } from './decimal.js';
+/** Decimal places NAV's MonetaryType permits. */
+const MONETARY_SCALE = 2;
+/**
+ * Compute the invoice summary from the lines.
+ *
+ * The summary is not free-form: `summaryByVatRate` must carry one entry per
+ * distinct VAT rate appearing on the lines, its net and VAT amounts must be
+ * the sums of the corresponding line amounts, and the invoice totals must be
+ * the sums of those. NAV rejects the whole batch when they disagree, so this
+ * derives them rather than trusting a caller to keep them in step.
+ *
+ * Lines are grouped by their entire `lineVatRate` value, not by percentage
+ * alone: a 27% line and an exempt line are different rates, and so are two
+ * exempt lines citing different legal grounds.
+ */
+export function computeInvoiceSummary(invoice, options = {}) {
+    const scale = options.scale ?? MONETARY_SCALE;
+    const mode = options.mode ?? 'half-up';
+    const lines = invoice.invoiceLines?.line ?? [];
+    const normal = lines.filter((line) => line.lineAmountsNormal !== undefined);
+    const simplified = lines.filter((line) => line.lineAmountsSimplified !== undefined);
+    const summary = {};
+    if (simplified.length > 0) {
+        summary.summarySimplified = groupBy(simplified, (line) => line.lineAmountsSimplified.lineVatRate).map(([vatRate, group]) => ({
+            vatRate,
+            vatContentGrossAmount: total(group.map((line) => line.lineAmountsSimplified.lineGrossAmountSimplified), scale, mode),
+            vatContentGrossAmountHUF: total(group.map((line) => line.lineAmountsSimplified.lineGrossAmountSimplifiedHUF), scale, mode),
+        }));
+    }
+    if (normal.length > 0 || simplified.length === 0) {
+        const byVatRate = groupBy(normal, (line) => line.lineAmountsNormal.lineVatRate).map(([vatRate, group]) => ({
+            vatRate,
+            vatRateNetData: {
+                vatRateNetAmount: total(group.map((line) => line.lineAmountsNormal.lineNetAmountData.lineNetAmount), scale, mode),
+                vatRateNetAmountHUF: total(group.map((line) => line.lineAmountsNormal.lineNetAmountData.lineNetAmountHUF), scale, mode),
+            },
+            vatRateVatData: {
+                vatRateVatAmount: total(group.map((line) => lineVatAmount(line, 'amount', scale, mode)), scale, mode),
+                vatRateVatAmountHUF: total(group.map((line) => lineVatAmount(line, 'huf', scale, mode)), scale, mode),
+            },
+        }));
+        summary.summaryNormal = {
+            summaryByVatRate: byVatRate,
+            invoiceNetAmount: total(byVatRate.map((entry) => entry.vatRateNetData.vatRateNetAmount), scale, mode),
+            invoiceNetAmountHUF: total(byVatRate.map((entry) => entry.vatRateNetData.vatRateNetAmountHUF), scale, mode),
+            invoiceVatAmount: total(byVatRate.map((entry) => entry.vatRateVatData.vatRateVatAmount), scale, mode),
+            invoiceVatAmountHUF: total(byVatRate.map((entry) => entry.vatRateVatData.vatRateVatAmountHUF), scale, mode),
+        };
+    }
+    summary.summaryGrossData = {
+        invoiceGrossAmount: grossTotal(summary, 'amount', scale, mode),
+        invoiceGrossAmountHUF: grossTotal(summary, 'huf', scale, mode),
+    };
+    return summary;
+}
+/**
+ * Check that an invoice's stated summary agrees with its lines.
+ *
+ * Returns the discrepancies rather than throwing, because a report that lists
+ * every mismatch at once is far more useful than the first one NAV happens to
+ * complain about.
+ */
+export function checkInvoiceSummary(invoice, options = {}) {
+    if (!hasAmountBearingLines(invoice))
+        return [];
+    const issues = [];
+    const stated = invoice.invoiceSummary;
+    const expected = computeInvoiceSummary(invoice, options);
+    const compare = (path, actual, wanted) => {
+        if (actual === undefined || wanted === undefined)
+            return;
+        if (!Decimal.from(actual).equals(Decimal.from(wanted))) {
+            issues.push({
+                path,
+                code: 'SUMMARY_MISMATCH',
+                message: `is ${actual} but the lines total ${wanted}`,
+            });
+        }
+    };
+    if (stated.summaryNormal && expected.summaryNormal) {
+        const statedNormal = stated.summaryNormal;
+        const expectedNormal = expected.summaryNormal;
+        compare('invoiceSummary.summaryNormal.invoiceNetAmount', statedNormal.invoiceNetAmount, expectedNormal.invoiceNetAmount);
+        compare('invoiceSummary.summaryNormal.invoiceNetAmountHUF', statedNormal.invoiceNetAmountHUF, expectedNormal.invoiceNetAmountHUF);
+        compare('invoiceSummary.summaryNormal.invoiceVatAmount', statedNormal.invoiceVatAmount, expectedNormal.invoiceVatAmount);
+        compare('invoiceSummary.summaryNormal.invoiceVatAmountHUF', statedNormal.invoiceVatAmountHUF, expectedNormal.invoiceVatAmountHUF);
+        if (statedNormal.summaryByVatRate.length !== expectedNormal.summaryByVatRate.length) {
+            issues.push({
+                path: 'invoiceSummary.summaryNormal.summaryByVatRate',
+                code: 'SUMMARY_VAT_RATE_COUNT',
+                message: `has ${statedNormal.summaryByVatRate.length} entries but the lines use ` +
+                    `${expectedNormal.summaryByVatRate.length} distinct VAT rates`,
+            });
+        }
+        else {
+            // Order is not significant, so match entries by their VAT rate.
+            for (const [index, statedEntry] of statedNormal.summaryByVatRate.entries()) {
+                const key = vatRateKey(statedEntry.vatRate);
+                const expectedEntry = expectedNormal.summaryByVatRate.find((candidate) => vatRateKey(candidate.vatRate) === key);
+                const path = `invoiceSummary.summaryNormal.summaryByVatRate.${index}`;
+                if (!expectedEntry) {
+                    issues.push({
+                        path,
+                        code: 'SUMMARY_VAT_RATE_UNKNOWN',
+                        message: 'states a VAT rate that no line uses',
+                    });
+                    continue;
+                }
+                compare(`${path}.vatRateNetData.vatRateNetAmount`, statedEntry.vatRateNetData.vatRateNetAmount, expectedEntry.vatRateNetData.vatRateNetAmount);
+                compare(`${path}.vatRateVatData.vatRateVatAmount`, statedEntry.vatRateVatData.vatRateVatAmount, expectedEntry.vatRateVatData.vatRateVatAmount);
+            }
+        }
+    }
+    if (stated.summaryGrossData && expected.summaryGrossData) {
+        compare('invoiceSummary.summaryGrossData.invoiceGrossAmount', stated.summaryGrossData.invoiceGrossAmount, expected.summaryGrossData.invoiceGrossAmount);
+        compare('invoiceSummary.summaryGrossData.invoiceGrossAmountHUF', stated.summaryGrossData.invoiceGrossAmountHUF, expected.summaryGrossData.invoiceGrossAmountHUF);
+    }
+    return issues;
+}
+/**
+ * Check every invoice in a document, including batch modification documents.
+ *
+ * Paths are prefixed with the batch index so a caller can tell which invoice
+ * of a multi-invoice document is out.
+ */
+export function checkDocumentSummaries(document, options = {}) {
+    const single = document.invoiceMain.invoice;
+    if (single)
+        return checkInvoiceSummary(single, options);
+    return (document.invoiceMain.batchInvoice ?? []).flatMap((entry) => checkInvoiceSummary(entry.invoice, options).map((issue) => ({
+        ...issue,
+        path: `batchInvoice.${entry.batchIndex}.${issue.path}`,
+    })));
+}
+function grossTotal(summary, which, scale, mode) {
+    const parts = [];
+    if (summary.summaryNormal) {
+        parts.push(which === 'amount'
+            ? summary.summaryNormal.invoiceNetAmount
+            : summary.summaryNormal.invoiceNetAmountHUF, which === 'amount'
+            ? summary.summaryNormal.invoiceVatAmount
+            : summary.summaryNormal.invoiceVatAmountHUF);
+    }
+    for (const entry of summary.summarySimplified ?? []) {
+        parts.push(which === 'amount' ? entry.vatContentGrossAmount : entry.vatContentGrossAmountHUF);
+    }
+    return total(parts, scale, mode);
+}
+/**
+ * VAT of a line, stated or derived.
+ *
+ * `lineVatData` is optional in the schema, and NAV's own advance-invoice
+ * samples omit it: the line states its net amount and its rate, and the VAT
+ * follows from the two. Treating an absent `lineVatData` as zero would make
+ * every such invoice look unbalanced.
+ *
+ * When the rate is not a percentage — exempt, out of scope, reverse charge —
+ * there is no VAT to derive and the contribution is zero.
+ */
+function lineVatAmount(line, which, scale, mode) {
+    const amounts = line.lineAmountsNormal;
+    const stated = which === 'amount' ? amounts.lineVatData?.lineVatAmount : amounts.lineVatData?.lineVatAmountHUF;
+    if (stated !== undefined)
+        return stated;
+    const percentage = amounts.lineVatRate.vatPercentage;
+    if (percentage === undefined)
+        return '0';
+    const net = which === 'amount'
+        ? amounts.lineNetAmountData.lineNetAmount
+        : amounts.lineNetAmountData.lineNetAmountHUF;
+    return Decimal.from(net).multiply(percentage).round(scale, mode).toString();
+}
+/**
+ * Whether any line carries amounts at all.
+ *
+ * A line-data modification document can reference lines of the original
+ * invoice without restating amounts. There is nothing to reconcile then, and
+ * reporting a mismatch would be a false positive.
+ */
+export function hasAmountBearingLines(invoice) {
+    return (invoice.invoiceLines?.line ?? []).some((line) => line.lineAmountsNormal !== undefined || line.lineAmountsSimplified !== undefined);
+}
+function total(values, scale, mode) {
+    return sum(values).round(scale, mode).toString();
+}
+function groupBy(lines, rateOf) {
+    const groups = new Map();
+    for (const line of lines) {
+        const rate = rateOf(line);
+        const key = vatRateKey(rate);
+        const existing = groups.get(key);
+        if (existing)
+            existing[1].push(line);
+        else
+            groups.set(key, [rate, [line]]);
+    }
+    return [...groups.values()];
+}
+/**
+ * Stable identity of a VAT rate.
+ *
+ * Numeric rates are compared by value, so `0.27` and `0.2700` group together.
+ *
+ * Exemption and out-of-scope rates are identified by their `case` — the legal
+ * ground code — and *not* by the accompanying `reason`, which is free text.
+ * NAV's own new-means-of-transport sample makes the point: the line cites
+ * case `KBAUK` with reason "Áfa tv. 89. §" while the summary cites the same
+ * case with reason "Adómentes Közösségen belüli új közlekedési eszköz
+ * értékesítés". Same rate, different prose. Grouping on the prose would split
+ * one rate into two and report a spurious mismatch.
+ */
+export function vatRateKey(rate) {
+    const parts = [];
+    for (const key of Object.keys(rate).sort()) {
+        const value = rate[key];
+        if (value === undefined)
+            continue;
+        if ((key === 'vatPercentage' || key === 'vatContent') && typeof value === 'string') {
+            parts.push(`${key}=${Decimal.from(value).round(6).toString()}`);
+        }
+        else if (isDetailedReason(value)) {
+            parts.push(`${key}=${value.case}`);
+        }
+        else {
+            parts.push(`${key}=${JSON.stringify(value)}`);
+        }
+    }
+    return parts.join('|');
+}
+function isDetailedReason(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.case === 'string');
+}
+//# sourceMappingURL=summary.js.map

package/dist/money/summary.js.map

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

package/dist/time.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Render the `header/timestamp` value: UTC, ISO 8601, millisecond precision,
+ * e.g. `2026-09-03T14:25:11.482Z`.
+ */
+export declare function toHeaderTimestamp(value?: Date | string): string;
+/**
+ * Render a timestamp the way the request signature consumes it: UTC,
+ * `yyyyMMddHHmmss`, truncated to whole seconds, no separators.
+ *
+ * This must correspond to the same instant as the `header/timestamp` of the
+ * request, otherwise NAV rejects the signature.
+ */
+export declare function toSignatureTimestamp(value?: Date | string): string;
+/** Render a NAV `date` field (`xs:date`) as `yyyy-MM-dd` in UTC. */
+export declare function toNavDate(value?: Date | string): string;
+//# sourceMappingURL=time.d.ts.map

package/dist/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,GAAE,IAAI,GAAG,MAAmB,GAAG,MAAM,CAE3E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,GAAE,IAAI,GAAG,MAAmB,GAAG,MAAM,CAI9E;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,KAAK,GAAE,IAAI,GAAG,MAAmB,GAAG,MAAM,CAKnE"}

package/dist/time.js

@@ -0,0 +1,41 @@
+import { NavValidationError } from './errors.js';
+/**
+ * Render the `header/timestamp` value: UTC, ISO 8601, millisecond precision,
+ * e.g. `2026-09-03T14:25:11.482Z`.
+ */
+export function toHeaderTimestamp(value = new Date()) {
+    return toDate(value).toISOString();
+}
+/**
+ * Render a timestamp the way the request signature consumes it: UTC,
+ * `yyyyMMddHHmmss`, truncated to whole seconds, no separators.
+ *
+ * This must correspond to the same instant as the `header/timestamp` of the
+ * request, otherwise NAV rejects the signature.
+ */
+export function toSignatureTimestamp(value = new Date()) {
+    const iso = toDate(value).toISOString();
+    // 2026-09-03T14:25:11.482Z -> 20260903142511
+    return `${iso.slice(0, 4)}${iso.slice(5, 7)}${iso.slice(8, 10)}${iso.slice(11, 13)}${iso.slice(14, 16)}${iso.slice(17, 19)}`;
+}
+/** Render a NAV `date` field (`xs:date`) as `yyyy-MM-dd` in UTC. */
+export function toNavDate(value = new Date()) {
+    if (typeof value === 'string' && /^\d{4}-\d{2}-\d{2}$/.test(value)) {
+        return value;
+    }
+    return toDate(value).toISOString().slice(0, 10);
+}
+function toDate(value) {
+    const date = typeof value === 'string' ? new Date(value) : value;
+    if (Number.isNaN(date.getTime())) {
+        throw new NavValidationError('Invalid timestamp', [
+            {
+                path: 'timestamp',
+                code: 'INVALID_TIMESTAMP',
+                message: `cannot be parsed as a date: ${JSON.stringify(value)}`,
+            },
+        ]);
+    }
+    return date;
+}
+//# sourceMappingURL=time.js.map

package/dist/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAuB,IAAI,IAAI,EAAE;IACjE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAuB,IAAI,IAAI,EAAE;IACpE,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACxC,6CAA6C;IAC7C,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;AAC/H,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,SAAS,CAAC,QAAuB,IAAI,IAAI,EAAE;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACnE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,MAAM,CAAC,KAAoB;IAClC,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACjE,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,kBAAkB,CAAC,mBAAmB,EAAE;YAChD;gBACE,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,+BAA+B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;aAChE;SACF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/validation/issue.d.ts

@@ -0,0 +1,67 @@
+import type { NavFaultCode } from '../generated/fault-codes.js';
+/**
+ * How much a finding matters.
+ *
+ * `error` means NAV would reject the report. `warning` means the data is
+ * accepted but suspect — a tax number whose check digit is wrong, say, which
+ * NAV validates against its taxpayer registry rather than arithmetically.
+ * Keeping the two apart is what makes the validator usable: a validator that
+ * cries wolf gets switched off.
+ */
+export type Severity = 'error' | 'warning';
+/**
+ * Findings this library reports that NAV has no code for.
+ *
+ * Kept separate from NAV's codes rather than forced into an approximate one,
+ * so it is always clear whether a finding means "the service would say this"
+ * or "we noticed this".
+ */
+export type LocalFaultCode = 
+/** A tax number's check digit does not match. NAV checks its registry instead. */
+'LOCAL_TAXPAYER_ID_CHECK_DIGIT'
+/** A county code outside the set NAV is known to issue. */
+ | 'LOCAL_COUNTY_CODE_UNKNOWN'
+/** A VAT percentage that is not a current Hungarian rate. */
+ | 'LOCAL_VAT_PERCENTAGE_UNUSUAL';
+export type FaultCode = NavFaultCode | LocalFaultCode;
+export interface InvoiceValidationIssue {
+    /**
+     * The fault code. Where NAV defines one it is used verbatim, so a local
+     * failure names exactly what the service would have said, and the compiler
+     * checks it against the generated catalogue.
+     */
+    code: FaultCode;
+    /** `nav` for a code NAV defines, `local` for one of ours. */
+    origin: 'nav' | 'local';
+    severity: Severity;
+    /** Dotted path to the offending value, e.g. `invoiceLines.line.2.quantity`. */
+    path: string;
+    /** What is wrong, with the offending values quoted. */
+    message: string;
+    /** NAV's own description of the fault, in the requested language. */
+    navMessage?: string;
+}
+export interface ValidationReport {
+    /** True when there are no errors. Warnings do not make a report invalid. */
+    valid: boolean;
+    errors: InvoiceValidationIssue[];
+    warnings: InvoiceValidationIssue[];
+    /** Everything, in the order found. */
+    issues: InvoiceValidationIssue[];
+}
+export type MessageLanguage = 'en' | 'hu' | 'de';
+/** Collects findings while rules run, then assembles the report. */
+export declare class IssueCollector {
+    private readonly language;
+    private readonly collected;
+    constructor(language?: MessageLanguage);
+    add(code: FaultCode, severity: Severity, path: string, message: string): void;
+    error(code: FaultCode, path: string, message: string): void;
+    warn(code: FaultCode, path: string, message: string): void;
+    report(): ValidationReport;
+}
+/** Whether a code is one NAV defines, as opposed to one of ours. */
+export declare function isNavCode(code: FaultCode): code is NavFaultCode;
+/** NAV's description of a fault code, for surfacing in your own UI. */
+export declare function faultMessage(code: FaultCode, language?: MessageLanguage): string;
+//# sourceMappingURL=issue.d.ts.map

package/dist/validation/issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue.d.ts","sourceRoot":"","sources":["../../src/validation/issue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,MAAM,cAAc;AACxB,kFAAkF;AAChF,+BAA+B;AACjC,2DAA2D;GACzD,2BAA2B;AAC7B,6DAA6D;GAC3D,8BAA8B,CAAC;AAEnC,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,cAAc,CAAC;AAEtD,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,IAAI,EAAE,SAAS,CAAC;IAChB,6DAA6D;IAC7D,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC;IACxB,QAAQ,EAAE,QAAQ,CAAC;IACnB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,QAAQ,EAAE,sBAAsB,EAAE,CAAC;IACnC,sCAAsC;IACtC,MAAM,EAAE,sBAAsB,EAAE,CAAC;CAClC;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjD,oEAAoE;AACpE,qBAAa,cAAc;IAGb,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;gBAE7B,QAAQ,GAAE,eAAsB;IAE7D,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAY7E,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3D,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI1D,MAAM,IAAI,gBAAgB;CAK3B;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,IAAI,YAAY,CAE/D;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,GAAE,eAAsB,GAAG,MAAM,CAEtF"}

package/dist/validation/issue.js

@@ -0,0 +1,40 @@
+import { NAV_FAULT_MESSAGES } from '../generated/fault-codes.js';
+/** Collects findings while rules run, then assembles the report. */
+export class IssueCollector {
+    language;
+    collected = [];
+    constructor(language = 'en') {
+        this.language = language;
+    }
+    add(code, severity, path, message) {
+        const navMessage = isNavCode(code) ? NAV_FAULT_MESSAGES[code][this.language] : undefined;
+        this.collected.push({
+            code,
+            origin: isNavCode(code) ? 'nav' : 'local',
+            severity,
+            path,
+            message,
+            ...(navMessage ? { navMessage } : {}),
+        });
+    }
+    error(code, path, message) {
+        this.add(code, 'error', path, message);
+    }
+    warn(code, path, message) {
+        this.add(code, 'warning', path, message);
+    }
+    report() {
+        const errors = this.collected.filter((issue) => issue.severity === 'error');
+        const warnings = this.collected.filter((issue) => issue.severity === 'warning');
+        return { valid: errors.length === 0, errors, warnings, issues: [...this.collected] };
+    }
+}
+/** Whether a code is one NAV defines, as opposed to one of ours. */
+export function isNavCode(code) {
+    return code in NAV_FAULT_MESSAGES;
+}
+/** NAV's description of a fault code, for surfacing in your own UI. */
+export function faultMessage(code, language = 'en') {
+    return isNavCode(code) ? (NAV_FAULT_MESSAGES[code][language] ?? '') : '';
+}
+//# sourceMappingURL=issue.js.map

package/dist/validation/issue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue.js","sourceRoot":"","sources":["../../src/validation/issue.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AA2DjE,oEAAoE;AACpE,MAAM,OAAO,cAAc;IAGI;IAFZ,SAAS,GAA6B,EAAE,CAAC;IAE1D,YAA6B,WAA4B,IAAI;QAAhC,aAAQ,GAAR,QAAQ,CAAwB;IAAG,CAAC;IAEjE,GAAG,CAAC,IAAe,EAAE,QAAkB,EAAE,IAAY,EAAE,OAAe;QACpE,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACzF,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAClB,IAAI;YACJ,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO;YACzC,QAAQ;YACR,IAAI;YACJ,OAAO;YACP,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAe,EAAE,IAAY,EAAE,OAAe;QAClD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,CAAC,IAAe,EAAE,IAAY,EAAE,OAAe;QACjD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM;QACJ,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;QAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;QAChF,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;IACvF,CAAC;CACF;AAED,oEAAoE;AACpE,MAAM,UAAU,SAAS,CAAC,IAAe;IACvC,OAAO,IAAI,IAAI,kBAAkB,CAAC;AACpC,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,YAAY,CAAC,IAAe,EAAE,WAA4B,IAAI;IAC5E,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3E,CAAC"}

package/dist/validation/rules.d.ts

@@ -0,0 +1,34 @@
+import type { InvoiceData } from '../generated/types.js';
+import type { IssueCollector } from './issue.js';
+/**
+ * Business rules that are decidable from the document alone.
+ *
+ * Each rule reports NAV's own fault code where one exists, so a local failure
+ * names exactly what the service would have said. Rules that need state only
+ * NAV holds — whether an invoice number was used before, whether a referenced
+ * invoice exists, whether a tax number is registered — cannot be checked here
+ * and are listed in `LOCALLY_UNDECIDABLE` for the record.
+ */
+export interface InvoiceValidationContext {
+    /**
+     * The operation the document will be submitted under.
+     *
+     * Several rules depend on it: an original invoice must not reference
+     * another document, and a modification must.
+     */
+    operation?: 'CREATE' | 'MODIFY' | 'STORNO';
+    /**
+     * The tax number the request authenticates as. NAV rejects a report whose
+     * supplier is someone else.
+     */
+    supplierTaxNumber?: string;
+    /** Today's date as `yyyy-mm-dd`, for the date rules. Defaults to the system date. */
+    today?: string;
+}
+/**
+ * Faults NAV reports that no local validator can decide, because they depend
+ * on NAV's own records. Documented so the coverage of this module is honest.
+ */
+export declare const LOCALLY_UNDECIDABLE: readonly ["INVOICE_NUMBER_NOT_UNIQUE", "INVALID_INVOICE_REFERENCE", "INVALID_ANNULMENT_REFERENCE", "MULTIPLE_INVOICES_FOUND", "MODIFICATION_INDEX_NOT_UNIQUE", "MODIFY_WITHOUT_MASTER_MISMATCH", "INVOICE_TYPE_MISMATCH", "INVOICE_LINE_ALREADY_EXISTS", "ANNULMENT_IN_PROGRESS", "CUSTOMER_NOT_ASSIGNED", "INCORRECT_HEAD_DATA_CUSTOMER_TAX_NUMBER"];
+export declare function collectBusinessIssues(document: InvoiceData, collector: IssueCollector, context?: InvoiceValidationContext): void;
+//# sourceMappingURL=rules.d.ts.map

package/dist/validation/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/validation/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAsC,MAAM,uBAAuB,CAAC;AAI7F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD;;;;;;;;GAQG;AAEH,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3C;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,uVAYtB,CAAC;AAEX,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,cAAc,EACzB,OAAO,GAAE,wBAA6B,GACrC,IAAI,CA+BN"}