@open-nav/core 0.1.0

package/dist/validation/tax-number.js

@@ -0,0 +1,79 @@
+/**
+ * Hungarian tax number checks.
+ *
+ * A tax number is eleven digits in three parts: an eight digit core
+ * (törzsszám) whose last digit is a check digit, a one digit VAT code
+ * (áfakód), and a two digit county code (megyekód). NAV's schemas carry the
+ * three parts separately, in `taxpayerId`, `vatCode` and `countyCode`.
+ */
+/** Weights applied to the first seven digits of the core number. */
+const CHECK_WEIGHTS = [9, 7, 3, 1, 9, 7, 3];
+/**
+ * County codes NAV issues.
+ *
+ * This set is **not** in the XSD, which only constrains the field to two
+ * digits, so it is best-effort and is reported as a warning rather than an
+ * error. Budapest and Pest county use 41 to 44; 51 is used for taxpayers
+ * registered by the large taxpayers directorate.
+ */
+const COUNTY_CODES = new Set([
+    ...range(2, 20), // the counties, alphabetically
+    ...range(22, 44), // remaining counties plus the capital
+    51,
+]);
+function range(from, to) {
+    return Array.from({ length: to - from + 1 }, (_, index) => from + index);
+}
+/**
+ * Whether the check digit of an eight digit core tax number is consistent.
+ *
+ * Verified against the real tax numbers in NAV's published samples. Note that
+ * two of the four tax numbers those samples use (`98765432`, `87654321`) are
+ * obvious placeholders and do *not* satisfy the check — evidence that NAV
+ * validates a tax number against its taxpayer registry rather than
+ * arithmetically. Treat a failure here as a likely typo, and use
+ * `queryTaxpayer` when you need an authoritative answer.
+ */
+export function isValidTaxpayerId(taxpayerId) {
+    if (!/^\d{8}$/.test(taxpayerId))
+        return false;
+    const sum = CHECK_WEIGHTS.reduce((total, weight, index) => total + Number(taxpayerId[index]) * weight, 0);
+    return (10 - (sum % 10)) % 10 === Number(taxpayerId[7]);
+}
+/** The check digit an eight digit core tax number should end with. */
+export function taxpayerIdCheckDigit(firstSevenDigits) {
+    if (!/^\d{7}$/.test(firstSevenDigits)) {
+        throw new Error(`Expected seven digits, got ${JSON.stringify(firstSevenDigits)}`);
+    }
+    const sum = CHECK_WEIGHTS.reduce((total, weight, index) => total + Number(firstSevenDigits[index]) * weight, 0);
+    return (10 - (sum % 10)) % 10;
+}
+/** Whether a VAT code is one NAV defines. */
+export function isValidVatCode(vatCode) {
+    return /^[1-5]$/.test(vatCode);
+}
+/** Whether a county code is one NAV issues. Best-effort; see COUNTY_CODES. */
+export function isValidCountyCode(countyCode) {
+    return /^\d{2}$/.test(countyCode) && COUNTY_CODES.has(Number(countyCode));
+}
+/**
+ * Split an eleven digit tax number into the three parts NAV's schema wants.
+ *
+ * Accepts the common written forms — `12345678-2-41`, `12345678 2 41` and
+ * `12345678241` — because that is how the number appears on paper, and
+ * pasting it whole into `taxpayerId` is the mistake this avoids.
+ */
+export function parseTaxNumber(input) {
+    const digits = input.replace(/[\s-]/g, '');
+    if (/^\d{8}$/.test(digits))
+        return { taxpayerId: digits };
+    if (/^\d{11}$/.test(digits)) {
+        return {
+            taxpayerId: digits.slice(0, 8),
+            vatCode: digits.slice(8, 9),
+            countyCode: digits.slice(9, 11),
+        };
+    }
+    throw new Error(`Expected an 8 or 11 digit Hungarian tax number, got ${JSON.stringify(input)}`);
+}
+//# sourceMappingURL=tax-number.js.map

package/dist/validation/tax-number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tax-number.js","sourceRoot":"","sources":["../../src/validation/tax-number.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oEAAoE;AACpE,MAAM,aAAa,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAU,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,GAAG,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,+BAA+B;IAChD,GAAG,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,sCAAsC;IACxD,EAAE;CACH,CAAC,CAAC;AAEH,SAAS,KAAK,CAAC,IAAY,EAAE,EAAU;IACrC,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAC9B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,EACpE,CAAC,CACF,CAAC;IACF,OAAO,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,oBAAoB,CAAC,gBAAwB;IAC3D,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAC9B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,EAC1E,CAAC,CACF,CAAC;IACF,OAAO,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;AAChC,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,OAAO,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;AAC5E,CAAC;AAQD;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC3C,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAC1D,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YAC9B,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YAC3B,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SAChC,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,uDAAuD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAClG,CAAC"}

package/dist/validation/validate.d.ts

@@ -0,0 +1,29 @@
+import type { InvoiceData } from '../generated/types.js';
+import { type MessageLanguage, type ValidationReport } from './issue.js';
+import { type InvoiceValidationContext } from './rules.js';
+export interface ValidateInvoiceOptions extends InvoiceValidationContext {
+    /** Language for NAV's own fault descriptions. Defaults to English. */
+    language?: MessageLanguage;
+    /** Skip the business rules and check only the schema. */
+    schemaOnly?: boolean;
+}
+/**
+ * Check an invoice data report before sending it.
+ *
+ * Two layers run: the schema, derived from NAV's XSDs, and the business rules
+ * that are decidable from the document alone. Every finding carries NAV's own
+ * fault code where one exists, so a failure here reads the same as the
+ * rejection it prevents.
+ *
+ * Warnings do not make a report invalid. The distinction matters: a tax number
+ * whose check digit is wrong is worth flagging, but NAV validates tax numbers
+ * against its registry, so treating it as an error would reject documents the
+ * service accepts.
+ *
+ * ```ts
+ * const report = validateInvoice(invoice, { operation: 'CREATE' });
+ * if (!report.valid) console.error(report.errors);
+ * ```
+ */
+export declare function validateInvoice(document: InvoiceData, options?: ValidateInvoiceOptions): ValidationReport;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/validation/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAkB,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEzF,OAAO,EAAyB,KAAK,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAElF,MAAM,WAAW,sBAAuB,SAAQ,wBAAwB;IACtE,sEAAsE;IACtE,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,yDAAyD;IACzD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE,sBAA2B,GACnC,gBAAgB,CAWlB"}

package/dist/validation/validate.js

@@ -0,0 +1,33 @@
+import { IssueCollector } from './issue.js';
+import { collectSchemaIssues } from './schema.js';
+import { collectBusinessIssues } from './rules.js';
+/**
+ * Check an invoice data report before sending it.
+ *
+ * Two layers run: the schema, derived from NAV's XSDs, and the business rules
+ * that are decidable from the document alone. Every finding carries NAV's own
+ * fault code where one exists, so a failure here reads the same as the
+ * rejection it prevents.
+ *
+ * Warnings do not make a report invalid. The distinction matters: a tax number
+ * whose check digit is wrong is worth flagging, but NAV validates tax numbers
+ * against its registry, so treating it as an error would reject documents the
+ * service accepts.
+ *
+ * ```ts
+ * const report = validateInvoice(invoice, { operation: 'CREATE' });
+ * if (!report.valid) console.error(report.errors);
+ * ```
+ */
+export function validateInvoice(document, options = {}) {
+    const collector = new IssueCollector(options.language ?? 'en');
+    collectSchemaIssues('InvoiceData', document, collector);
+    const report = collector.report();
+    // Business rules read the document as typed data; running them over a
+    // structurally invalid document would produce noise, not findings.
+    if (options.schemaOnly || report.errors.length > 0)
+        return report;
+    collectBusinessIssues(document, collector, options);
+    return collector.report();
+}
+//# sourceMappingURL=validate.js.map

package/dist/validation/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/validation/validate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAA+C,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAiC,MAAM,YAAY,CAAC;AASlF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAqB,EACrB,UAAkC,EAAE;IAEpC,MAAM,SAAS,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC;IAC/D,mBAAmB,CAAC,aAAa,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;IAClC,sEAAsE;IACtE,mEAAmE;IACnE,IAAI,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IAElE,qBAAqB,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACpD,OAAO,SAAS,CAAC,MAAM,EAAE,CAAC;AAC5B,CAAC"}

package/dist/xml/descriptor.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Runtime description of the NAV schemas.
+ *
+ * The generated `TYPES` table in `../generated/schema.js` is the single source
+ * of truth for element order, namespaces, cardinality, choice exclusivity and
+ * value constraints. Serialisation, parsing and validation are all driven from
+ * it, so moving to a future interface version is a regeneration rather than a
+ * rewrite of three separate hand-maintained code paths.
+ */
+/** Short key for each namespace in the Online Számla schemas. */
+export type NsKey = 'common' | 'base' | 'data' | 'api' | 'annul' | 'metrics';
+export declare const NAMESPACE_URIS: Record<NsKey, string>;
+/** How a value is carried in XML. */
+export type PrimitiveKind = 'string' | 'decimal' | 'integer' | 'boolean' | 'date' | 'dateTime' | 'base64Binary';
+export interface FieldDescriptor {
+    /** Element local name. */
+    name: string;
+    /** Namespace that *declares* this element, which may differ from its parent's. */
+    ns: NsKey;
+    /** Key into the `TYPES` table, or an `xs:` primitive. */
+    type: string;
+    /** `minOccurs="0"`. Choice members are always optional. */
+    optional?: boolean;
+    /** `maxOccurs` greater than one, or unbounded. */
+    repeated?: boolean;
+    /** Upper bound when the schema states a finite one. */
+    maxOccurs?: number;
+}
+export interface ChoiceGroupDescriptor {
+    members: string[];
+    /** `true` when exactly one member must be present; `false` when at most one may be. */
+    required: boolean;
+}
+export interface AttributeDescriptor {
+    name: string;
+    type: string;
+    required: boolean;
+}
+export interface ComplexDescriptor {
+    kind: 'complex';
+    name: string;
+    ns: NsKey;
+    /** Name of the corresponding generated TypeScript type. */
+    tsName: string;
+    /** `element` for child elements, `simple` for text content plus attributes. */
+    content: 'element' | 'simple';
+    /** Type of the text value when `content` is `simple`. */
+    contentType?: string;
+    /** Child elements in schema order — which is the order NAV requires. */
+    fields: FieldDescriptor[];
+    choiceGroups?: ChoiceGroupDescriptor[];
+    attributes?: AttributeDescriptor[];
+}
+export interface SimpleDescriptor {
+    kind: 'simple';
+    name: string;
+    ns: NsKey;
+    tsName: string;
+    primitive: PrimitiveKind;
+    /** Permitted values, when the type is an enumeration. */
+    enumValues?: string[];
+    /** Most derived `xs:pattern` of the restriction chain. */
+    pattern?: string;
+    length?: number;
+    minLength?: number;
+    maxLength?: number;
+    totalDigits?: number;
+    fractionDigits?: number;
+    minInclusive?: string;
+    maxInclusive?: string;
+    minExclusive?: string;
+    maxExclusive?: string;
+}
+export type Descriptor = ComplexDescriptor | SimpleDescriptor;
+export interface RootDescriptor {
+    name: string;
+    ns: NsKey;
+    type: string;
+}
+/** Primitive kinds of the `xs:` built-ins referenced directly by the schemas. */
+export declare const XS_PRIMITIVES: Record<string, PrimitiveKind>;
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/xml/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../src/xml/descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iEAAiE;AACjE,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,CAAC;AAE7E,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAOhD,CAAC;AAEF,qCAAqC;AACrC,MAAM,MAAM,aAAa,GACvB,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,cAAc,CAAC;AAEtF,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,EAAE,EAAE,KAAK,CAAC;IACV,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uFAAuF;IACvF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,KAAK,CAAC;IACV,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,OAAO,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC9B,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACvC,UAAU,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,aAAa,CAAC;IACzB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,UAAU,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAE9D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;CACd;AAED,iFAAiF;AACjF,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAYvD,CAAC"}

package/dist/xml/descriptor.js

@@ -0,0 +1,32 @@
+/**
+ * Runtime description of the NAV schemas.
+ *
+ * The generated `TYPES` table in `../generated/schema.js` is the single source
+ * of truth for element order, namespaces, cardinality, choice exclusivity and
+ * value constraints. Serialisation, parsing and validation are all driven from
+ * it, so moving to a future interface version is a regeneration rather than a
+ * rewrite of three separate hand-maintained code paths.
+ */
+export const NAMESPACE_URIS = {
+    common: 'http://schemas.nav.gov.hu/NTCA/1.0/common',
+    base: 'http://schemas.nav.gov.hu/OSA/3.0/base',
+    data: 'http://schemas.nav.gov.hu/OSA/3.0/data',
+    api: 'http://schemas.nav.gov.hu/OSA/3.0/api',
+    annul: 'http://schemas.nav.gov.hu/OSA/3.0/annul',
+    metrics: 'http://schemas.nav.gov.hu/OSA/3.0/metrics',
+};
+/** Primitive kinds of the `xs:` built-ins referenced directly by the schemas. */
+export const XS_PRIMITIVES = {
+    'xs:string': 'string',
+    'xs:decimal': 'decimal',
+    'xs:int': 'integer',
+    'xs:integer': 'integer',
+    'xs:long': 'integer',
+    'xs:nonNegativeInteger': 'integer',
+    'xs:positiveInteger': 'integer',
+    'xs:boolean': 'boolean',
+    'xs:date': 'date',
+    'xs:dateTime': 'dateTime',
+    'xs:base64Binary': 'base64Binary',
+};
+//# sourceMappingURL=descriptor.js.map

package/dist/xml/descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.js","sourceRoot":"","sources":["../../src/xml/descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,CAAC,MAAM,cAAc,GAA0B;IACnD,MAAM,EAAE,2CAA2C;IACnD,IAAI,EAAE,wCAAwC;IAC9C,IAAI,EAAE,wCAAwC;IAC9C,GAAG,EAAE,uCAAuC;IAC5C,KAAK,EAAE,yCAAyC;IAChD,OAAO,EAAE,2CAA2C;CACrD,CAAC;AA8EF,iFAAiF;AACjF,MAAM,CAAC,MAAM,aAAa,GAAkC;IAC1D,WAAW,EAAE,QAAQ;IACrB,YAAY,EAAE,SAAS;IACvB,QAAQ,EAAE,SAAS;IACnB,YAAY,EAAE,SAAS;IACvB,SAAS,EAAE,SAAS;IACpB,uBAAuB,EAAE,SAAS;IAClC,oBAAoB,EAAE,SAAS;IAC/B,YAAY,EAAE,SAAS;IACvB,SAAS,EAAE,MAAM;IACjB,aAAa,EAAE,UAAU;IACzB,iBAAiB,EAAE,cAAc;CAClC,CAAC"}

package/dist/xml/read.d.ts

@@ -0,0 +1,25 @@
+export interface ParseOptions {
+    /**
+     * What to do with elements the schema does not declare.
+     *
+     * `error` (the default) surfaces them, which is what you want for documents
+     * you produced yourself. Use `ignore` when reading responses from a NAV
+     * deployment that may be ahead of the vendored schema.
+     */
+    unknownElements?: 'error' | 'ignore';
+}
+export interface ParsedDocument {
+    /** Root element name, e.g. `ManageInvoiceResponse`. */
+    root: string;
+    value: unknown;
+}
+/**
+ * Parse a NAV document into the shape of its generated type.
+ *
+ * The root element name decides which descriptor is used, so responses and
+ * invoice payloads both go through the same path.
+ */
+export declare function parseDocument(xml: string, options?: ParseOptions): ParsedDocument;
+/** Parse a document whose root is known, returning the generated type. */
+export declare function parseDocumentAs<T>(xml: string, rootName: string, options?: ParseOptions): T;
+//# sourceMappingURL=read.d.ts.map

package/dist/xml/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/xml/read.ts"],"names":[],"mappings":"AA6BA,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAiED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,cAAc,CA8BrF;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,CAAC,CAM3F"}

package/dist/xml/read.js

@@ -0,0 +1,230 @@
+import { XMLParser } from 'fast-xml-parser';
+import { NavValidationError } from '../errors.js';
+import { ROOTS, TYPES } from '../generated/schema.js';
+import { NAMESPACE_URIS, XS_PRIMITIVES, } from './descriptor.js';
+const URI_TO_NS = Object.fromEntries(Object.entries(NAMESPACE_URIS).map(([key, uri]) => [uri, key]));
+const parser = new XMLParser({
+    preserveOrder: true,
+    ignoreAttributes: false,
+    attributeNamePrefix: '@',
+    trimValues: true,
+    // Values are converted according to the schema, not guessed from their
+    // shape: an invoice number of "2021000123" must stay a string.
+    parseTagValue: false,
+    parseAttributeValue: false,
+});
+/** Namespace prefixes in scope, inherited down the tree. */
+class Scope {
+    byPrefix;
+    defaultUri;
+    constructor(byPrefix = new Map(), defaultUri = undefined) {
+        this.byPrefix = byPrefix;
+        this.defaultUri = defaultUri;
+    }
+    extend(attributes) {
+        let next;
+        let defaultUri = this.defaultUri;
+        for (const [name, value] of Object.entries(attributes)) {
+            if (name === '@xmlns') {
+                defaultUri = value;
+            }
+            else if (name.startsWith('@xmlns:')) {
+                next ??= new Map(this.byPrefix);
+                next.set(name.slice('@xmlns:'.length), value);
+            }
+        }
+        if (!next && defaultUri === this.defaultUri)
+            return this;
+        return new Scope(next ?? this.byPrefix, defaultUri);
+    }
+    resolve(prefix) {
+        return prefix === '' ? this.defaultUri : this.byPrefix.get(prefix);
+    }
+}
+function tagOf(node) {
+    const tag = Object.keys(node).find((key) => key !== ':@');
+    if (tag === undefined)
+        throw new NavValidationError('Malformed XML node');
+    return tag;
+}
+function childrenOf(node) {
+    const value = node[tagOf(node)];
+    return Array.isArray(value) ? value : [];
+}
+function attrsOf(node) {
+    return node[':@'] ?? {};
+}
+function textOf(node) {
+    return childrenOf(node)
+        .filter((child) => tagOf(child) === '#text')
+        .map((child) => String(child['#text']))
+        .join('');
+}
+function elementChildren(node) {
+    return childrenOf(node).filter((child) => {
+        const tag = tagOf(child);
+        return tag !== '#text' && tag !== '#comment' && !tag.startsWith('?');
+    });
+}
+function splitName(qname) {
+    const index = qname.indexOf(':');
+    return index === -1
+        ? { prefix: '', local: qname }
+        : { prefix: qname.slice(0, index), local: qname.slice(index + 1) };
+}
+/**
+ * Parse a NAV document into the shape of its generated type.
+ *
+ * The root element name decides which descriptor is used, so responses and
+ * invoice payloads both go through the same path.
+ */
+export function parseDocument(xml, options = {}) {
+    const document = parser.parse(xml);
+    const rootNode = document.find((node) => {
+        const tag = tagOf(node);
+        return tag !== '#text' && tag !== '#comment' && !tag.startsWith('?');
+    });
+    if (!rootNode) {
+        throw new NavValidationError('No root element found in document');
+    }
+    const { local } = splitName(tagOf(rootNode));
+    const root = ROOTS[local];
+    if (!root) {
+        throw new NavValidationError(`Unknown document root ${local}`, [
+            {
+                path: '',
+                code: 'UNKNOWN_ROOT',
+                message: `expected one of ${Object.keys(ROOTS).join(', ')}`,
+            },
+        ]);
+    }
+    const issues = [];
+    const scope = new Scope().extend(attrsOf(rootNode));
+    const value = readComplex(rootNode, root.type, scope, local, issues, options);
+    if (issues.length > 0) {
+        throw new NavValidationError(`Cannot parse ${local}`, issues);
+    }
+    return { root: local, value };
+}
+/** Parse a document whose root is known, returning the generated type. */
+export function parseDocumentAs(xml, rootName, options) {
+    const parsed = parseDocument(xml, options);
+    if (parsed.root !== rootName) {
+        throw new NavValidationError(`Expected a ${rootName} document but found ${parsed.root}`);
+    }
+    return parsed.value;
+}
+function readComplex(node, typeKey, scope, path, issues, options) {
+    const descriptor = TYPES[typeKey];
+    if (!descriptor) {
+        issues.push({
+            path,
+            code: 'UNKNOWN_TYPE',
+            message: `${typeKey} is not in the generated schema`,
+        });
+        return undefined;
+    }
+    if (descriptor.kind === 'simple') {
+        return readPrimitive(descriptor.primitive, textOf(node), path, issues);
+    }
+    if (descriptor.content === 'simple') {
+        return readSimpleContent(node, descriptor, path, issues);
+    }
+    const result = {};
+    const localScope = scope.extend(attrsOf(node));
+    for (const child of elementChildren(node)) {
+        const { prefix, local } = splitName(tagOf(child));
+        const childScope = localScope.extend(attrsOf(child));
+        const uri = childScope.resolve(prefix);
+        const ns = uri === undefined ? undefined : URI_TO_NS[uri];
+        const field = descriptor.fields.find((candidate) => candidate.name === local && (ns === undefined || candidate.ns === ns));
+        if (!field) {
+            if (options.unknownElements !== 'ignore') {
+                issues.push({
+                    path: path ? `${path}.${local}` : local,
+                    code: 'UNKNOWN_ELEMENT',
+                    message: `is not declared on ${descriptor.name}`,
+                });
+            }
+            continue;
+        }
+        const fieldPath = path ? `${path}.${field.name}` : field.name;
+        const primitive = XS_PRIMITIVES[field.type];
+        const value = primitive
+            ? readPrimitive(primitive, textOf(child), fieldPath, issues)
+            : readComplex(child, field.type, childScope, fieldPath, issues, options);
+        if (field.repeated) {
+            result[field.name] ??= [];
+            result[field.name].push(value);
+        }
+        else {
+            result[field.name] = value;
+        }
+    }
+    return result;
+}
+function readSimpleContent(node, descriptor, path, issues) {
+    const contentDescriptor = descriptor.contentType ? TYPES[descriptor.contentType] : undefined;
+    const kind = XS_PRIMITIVES[descriptor.contentType ?? ''] ??
+        (contentDescriptor?.kind === 'simple' ? contentDescriptor.primitive : 'string');
+    const result = {
+        value: readPrimitive(kind, textOf(node), `${path}.value`, issues),
+    };
+    const attributes = attrsOf(node);
+    for (const attribute of descriptor.attributes ?? []) {
+        const raw = attributes[`@${attribute.name}`];
+        if (raw === undefined) {
+            if (attribute.required) {
+                issues.push({
+                    path: `${path}@${attribute.name}`,
+                    code: 'REQUIRED',
+                    message: 'attribute is required',
+                });
+            }
+            continue;
+        }
+        const attributeDescriptor = TYPES[attribute.type];
+        const attributeKind = XS_PRIMITIVES[attribute.type] ??
+            (attributeDescriptor?.kind === 'simple' ? attributeDescriptor.primitive : 'string');
+        result[attribute.name] = readPrimitive(attributeKind, raw, `${path}@${attribute.name}`, issues);
+    }
+    return result;
+}
+function readPrimitive(kind, raw, path, issues) {
+    switch (kind) {
+        case 'boolean':
+            if (raw === 'true' || raw === '1')
+                return true;
+            if (raw === 'false' || raw === '0')
+                return false;
+            issues.push({ path, code: 'EXPECTED_BOOLEAN', message: `expected a boolean, got "${raw}"` });
+            return undefined;
+        case 'integer': {
+            if (!/^-?\d+$/.test(raw)) {
+                issues.push({
+                    path,
+                    code: 'EXPECTED_INTEGER',
+                    message: `expected an integer, got "${raw}"`,
+                });
+                return undefined;
+            }
+            const parsed = Number(raw);
+            if (!Number.isSafeInteger(parsed)) {
+                issues.push({
+                    path,
+                    code: 'INTEGER_OUT_OF_RANGE',
+                    message: `${raw} exceeds the safe integer range`,
+                });
+                return undefined;
+            }
+            return parsed;
+        }
+        case 'base64Binary':
+            // XML permits whitespace inside base64; NAV's own samples wrap it.
+            return raw.replace(/\s+/g, '');
+        default:
+            // Decimals stay strings deliberately, see the generator's TS_PRIMITIVES.
+            return raw;
+    }
+}
+//# sourceMappingURL=read.js.map

package/dist/xml/read.js.map

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

package/dist/xml/write.d.ts

@@ -0,0 +1,28 @@
+import { type NsKey } from './descriptor.js';
+/** Prefixes used when a namespace is not the document's default. */
+export declare const NS_PREFIXES: Record<NsKey, string>;
+export interface SerializeOptions {
+    /**
+     * Indentation for pretty printing, or `false` for a single line.
+     *
+     * Defaults to `false`: these documents go over the wire, and for
+     * `manageInvoice` the invoice payload is hashed and base64 encoded, so
+     * there is nothing to be gained from whitespace. Pass `'\t'` or two spaces
+     * when a human has to read the result.
+     */
+    indent?: string | false;
+    /** Emit the XML declaration. Defaults to `true`. */
+    declaration?: boolean;
+}
+/**
+ * Serialise a document from its root element name.
+ *
+ * Element order, namespaces and cardinality all come from the generated
+ * descriptors, so the output follows the XSD's sequence order — which is what
+ * NAV validates against.
+ *
+ * @param rootName root element name, e.g. `InvoiceData` or `ManageInvoiceRequest`
+ * @param value    the document, shaped like the generated type of that root
+ */
+export declare function serializeDocument(rootName: string, value: unknown, options?: SerializeOptions): string;
+//# sourceMappingURL=write.d.ts.map

package/dist/xml/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/xml/write.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,KAAK,EAEX,MAAM,iBAAiB,CAAC;AAEzB,oEAAoE;AACpE,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAO7C,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACxB,oDAAoD;IACpD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAWD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,gBAAqB,GAC7B,MAAM,CAkCR"}