@ekwo-ai/xaf 0.9.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Karuna Co OÜ, trading as Ekwo
+
+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.

package/README.md

@@ -0,0 +1,80 @@
+# `@ekwo-ai/xaf`
+
+Reads an **XML Audit File Financial** — the *XML Auditfile Financieel*, XAF,
+the file an accounting package hands over when an auditor or a tax authority
+asks for the books of a year — into plain objects, in TypeScript, with no
+dependencies. Versions **3.2** and **4.0** are read, each recognised by the
+namespace of its schema.
+
+```ts
+import { readXaf } from '@ekwo-ai/xaf';
+
+const books = readXaf(bytes); // a string, or the bytes of the file
+
+books.version;     // '4.0'
+books.currency;    // 'EUR', from header/curCode
+books.entries;     // [{ journal: 'VK', number: '2025001', date: '2025-01-15', lines: […] }, …]
+books.opening;     // the obLine of the opening balance
+books.openingDate; // opBalDate (3.2), or the first day of the year (4.0)
+books.violations;  // a transaction that does not balance, totals the lines disagree with
+```
+
+## What is read
+
+| Part of the books | Where it sits in the file |
+|---|---|
+| currency | `header/curCode` |
+| accounts | `company/generalLedger/ledgerAccount`: `accID`, `accDesc`, `accTp` (`B`, `P`, `M`, kept as written) |
+| parties | `company/customersSuppliers/customerSupplier`: `custSupID`, `custSupName`, `eMail`, `taxRegIdent`, `commerceNr`, the country of its first address |
+| opening balance | `company/openingBalance/obLine`: `accID`, `amnt`, `amntTp`; its date `opBalDate` in 3.2, `header/startDate` in 4.0, which has none |
+| entries | `company/transactions/journal` (`jrnID`, `desc`) `/transaction` (`nr`, `desc`, `trDt`) |
+| lines | `trLine`: `accID`, `desc`, `amnt` and `amntTp` (`D` or `C`), `custSupID`, `docRef` (the first one is the entry's reference), `currency/curCode` and `curAmnt`, and in 3.2 `matchKeyID` |
+
+- An amount is an `xsd:decimal`; its side is `amntTp`. A negative amount is
+  the other side.
+- The file states its own totals — `linesCount`, `totalDebit`, `totalCredit` —
+  for the opening balance and for the transactions, and each is held against
+  what the lines add up to. A file that disagrees with itself, or a transaction
+  that does not balance, comes back as written, with a violation.
+- The encoding is the one the XML declaration names — UTF-8 or ISO-8859-1 —
+  and UTF-8 when it names none, as XML provides. A caller who names another
+  is refused rather than obeyed.
+- The XML is read by a strict reader of its own: no DOCTYPE, no entity beyond
+  the five XML predefines, bounds on size, depth and element count.
+
+What is not read: the sub-ledgers of version 3.2 (`subledgers`,
+`obSubledgers`), which restate by party what the lines already say; the VAT
+codes and the tax amounts of a line; the periods; the history of changes.
+
+## What it returns
+
+The shape declared in [`src/types.ts`](./src/types.ts), which is, field for
+field, the shape every reader of an accounting export in this repository
+declares for itself, plus the `version` of the file and the `openingDate` of
+its opening balance. Amounts are decimal strings, never negative. What is not
+an audit file is thrown as a `BooksFileError` with a `code`.
+
+It knows no chart of accounts: in [Ekwo OS](https://github.com/Ekwo-ai/ekwo-os)
+the correspondence is made by `ekwo import xaf <file>`.
+
+## Sources
+
+The format was read on 24 September 2026 from the schemas the Dutch tax
+administration publishes on its developer portal — `XmlAuditfileFinancieel3.2.xsd`
+and `XmlAuditfileFinancieel4.0.xsd`, kept under [`test/xsd/`](./test/xsd/README.md)
+with where each came from — and from the pages of that portal:
+[Auditfile Financieel (XAF) v 3.2.1](https://odb.belastingdienst.nl/auditfiles/auditfile-financieel-xaf-v-3-2-1/),
+[XMLAuditfile Financieel (XAF) v 4.0.3](https://odb.belastingdienst.nl/auditfiles/xmlauditfile-financieel-xaf-v-4-0-3/),
+[Achtergrond informatie XAF4.0](https://odb.belastingdienst.nl/auditfiles/achtergrond-informatie-xaf4-0/).
+
+It was written against the audit file **Exact Online** exports, as its help
+centre describes it on the same day:
+[Auditfiles in xml-formaat (XAF) exporteren](https://support.exactonline.com/community/s/article/All-All-HNO-Task-general-importexport-gen-impexp-auditt?language=nl_NL)
+— *Import/Export > Export > Audit file*; entries not yet processed are not in
+the file. `ekwo import exact-online <file>` is the same as `ekwo import xaf`.
+
+The fixtures under `test/fixtures/`, one per version, are written by hand, hold
+no real data, and are validated against the schema of their version by
+`test/schema.test.ts`.
+
+MIT.

package/dist/decimal.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Amounts as the file wrote them, added without a float.
+ *
+ * An audit file writes its amounts as `xsd:decimal` with two fraction digits
+ * at most, the side in an element of its own. An amount is held here as a
+ * `bigint` of millionths — the unit every reader of books in this repository
+ * adds in — and what leaves is a string with two decimals, and more when the
+ * file wrote more that are not zero.
+ */
+/**
+ * An `xsd:decimal` as millionths, or null when it is not one: an optional
+ * sign, digits, an optional point and digits. No exponent, no thousands
+ * separator, no comma — the lexical space of the type, and nothing else.
+ */
+export declare function parseXsdDecimal(text: string): bigint | null;
+/** Millionths as a decimal string: signed, two decimals, more when they are written. */
+export declare function formatDecimal(value: bigint): string;
+//# sourceMappingURL=decimal.d.ts.map

package/dist/decimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.d.ts","sourceRoot":"","sources":["../src/decimal.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS3D;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMnD"}

package/dist/decimal.js

@@ -0,0 +1,39 @@
+/**
+ * Amounts as the file wrote them, added without a float.
+ *
+ * An audit file writes its amounts as `xsd:decimal` with two fraction digits
+ * at most, the side in an element of its own. An amount is held here as a
+ * `bigint` of millionths — the unit every reader of books in this repository
+ * adds in — and what leaves is a string with two decimals, and more when the
+ * file wrote more that are not zero.
+ */
+const SCALE = 6;
+const UNIT = 10n ** BigInt(SCALE);
+const XSD_DECIMAL = /^([+-])?([0-9]*)(?:\.([0-9]*))?$/;
+/**
+ * An `xsd:decimal` as millionths, or null when it is not one: an optional
+ * sign, digits, an optional point and digits. No exponent, no thousands
+ * separator, no comma — the lexical space of the type, and nothing else.
+ */
+export function parseXsdDecimal(text) {
+    const match = XSD_DECIMAL.exec(text.trim());
+    if (match === null)
+        return null;
+    const whole = match[2] ?? '';
+    const fraction = match[3] ?? '';
+    if (whole === '' && fraction === '')
+        return null;
+    if (fraction.length > SCALE)
+        return null;
+    const units = BigInt(whole === '' ? '0' : whole) * UNIT + BigInt(fraction.padEnd(SCALE, '0') || '0');
+    return match[1] === '-' ? -units : units;
+}
+/** Millionths as a decimal string: signed, two decimals, more when they are written. */
+export function formatDecimal(value) {
+    const negative = value < 0n;
+    const digits = (negative ? -value : value).toString().padStart(SCALE + 1, '0');
+    const whole = digits.slice(0, -SCALE);
+    const fraction = digits.slice(-SCALE).replace(/0+$/, '').padEnd(2, '0');
+    return `${negative ? '-' : ''}${whole}.${fraction}`;
+}
+//# sourceMappingURL=decimal.js.map

package/dist/decimal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.js","sourceRoot":"","sources":["../src/decimal.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,KAAK,GAAG,CAAC,CAAC;AAChB,MAAM,IAAI,GAAG,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;AAClC,MAAM,WAAW,GAAG,kCAAkC,CAAC;AAEvD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,KAAK,KAAK,EAAE,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,QAAQ,CAAC,MAAM,GAAG,KAAK;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;IACrG,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AAC3C,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,QAAQ,GAAG,KAAK,GAAG,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxE,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,QAAQ,EAAE,CAAC;AACtD,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,35 @@
+/**
+ * What makes a file unreadable, as opposed to books that read and do not add
+ * up. The second comes back in `violations`; the first is thrown, because a
+ * file that is not an audit file has no line to hang a violation on.
+ */
+export type BooksFileErrorCode = 
+/** Larger than `maxBytes`. Refused before a single character is read. */
+'too_large'
+/** Bytes that are not the encoding the declaration names, or a caller who names another one. */
+ | 'unsupported_encoding'
+/** A `<!DOCTYPE`. No audit file needs one, and every entity attack does. */
+ | 'doctype_forbidden'
+/** An entity other than the five XML predefines and character references. */
+ | 'undefined_entity'
+/** Elements nested deeper than an audit file ever nests them. */
+ | 'too_deep'
+/** More elements than `maxElements`. */
+ | 'too_many_elements'
+/** Not well-formed XML, in the subset this reader takes. */
+ | 'malformed_xml'
+/** Well-formed, and not an audit file: another root, another namespace. */
+ | 'not_an_auditfile'
+/** An audit file of a version this reader was not written against. */
+ | 'unsupported_version'
+/** An element the schema requires, missing. */
+ | 'missing_element'
+/** A value the schema does not allow where it is: a date, an amount, a side. */
+ | 'invalid_value';
+export declare class BooksFileError extends Error {
+    readonly code: BooksFileErrorCode;
+    /** Kept for the shape the other readers share; an XML file has no rows. */
+    readonly row: number | null;
+    constructor(code: BooksFileErrorCode, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,kBAAkB;AAC5B,yEAAyE;AACvE,WAAW;AACb,gGAAgG;GAC9F,sBAAsB;AACxB,4EAA4E;GAC1E,mBAAmB;AACrB,6EAA6E;GAC3E,kBAAkB;AACpB,iEAAiE;GAC/D,UAAU;AACZ,wCAAwC;GACtC,mBAAmB;AACrB,4DAA4D;GAC1D,eAAe;AACjB,2EAA2E;GACzE,kBAAkB;AACpB,sEAAsE;GACpE,qBAAqB;AACvB,+CAA+C;GAC7C,iBAAiB;AACnB,gFAAgF;GAC9E,eAAe,CAAC;AAEpB,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,2EAA2E;IAC3E,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEhB,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM;CAMtD"}

package/dist/errors.js

@@ -0,0 +1,12 @@
+export class BooksFileError extends Error {
+    code;
+    /** Kept for the shape the other readers share; an XML file has no rows. */
+    row;
+    constructor(code, message) {
+        super(message);
+        this.name = 'BooksFileError';
+        this.code = code;
+        this.row = null;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AA6BA,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAqB;IAClC,2EAA2E;IAClE,GAAG,CAAgB;IAE5B,YAAY,IAAwB,EAAE,OAAe;QACnD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;IAClB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The XML Audit File Financial — the *XML Auditfile Financieel*, XAF — read
+ * back: the file an accounting package hands over when an auditor or a tax
+ * authority asks for the books of a year, in the XML the published schema
+ * defines. Versions 3.2 and 4.0 are read, each recognised by its namespace;
+ * any other is refused by name.
+ *
+ * What is taken from it, and where it sits in the file:
+ *
+ * - the **currency** of the books, `header/curCode`;
+ * - the **accounts**, `company/generalLedger/ledgerAccount` — `accID`,
+ *   `accDesc`, and `accTp` kept as written;
+ * - the **parties**, `company/customersSuppliers/customerSupplier`, by their
+ *   `custSupID`;
+ * - the **opening balance**, `company/openingBalance/obLine`;
+ * - the **entries**, `company/transactions/journal/transaction`, each with its
+ *   lines, `trLine`: an account, an amount and its side (`amnt`, `amntTp`),
+ *   a party, an amount in another currency.
+ *
+ * The file states its own totals — the number of lines, the debits and the
+ * credits of the opening and of the transactions — and each is held against
+ * what its lines add up to: a file that disagrees with itself comes back with
+ * a violation, as written.
+ *
+ * It depends on nothing, reads no database and knows no chart of accounts.
+ */
+import type { ImportedBooks, ReadOptions } from './types.js';
+export * from './types.js';
+export { BooksFileError, type BooksFileErrorCode } from './errors.js';
+/** The versions read, by the namespace their schema declares. */
+export declare const XAF_NAMESPACES: {
+    readonly '3.2': "http://www.auditfiles.nl/XAF/3.2";
+    readonly '4.0': "http://www.odb.belastingdienst.nl/Belastingdienst/BCPP/1.1/structures/XmlauditfileXAF_4.0";
+};
+export type XafVersion = keyof typeof XAF_NAMESPACES;
+/** The books of an audit file, and the version it was written in. */
+export interface XafBooks extends ImportedBooks {
+    version: XafVersion;
+}
+/**
+ * Reads an audit file, as a string or as the bytes of the file. Entries are
+ * the `transaction` elements of each `journal`; the opening balance is the
+ * `obLine` elements, which carry no date of their own — the version 3.2 gives
+ * one, `opBalDate`, which `openingDate` returns, and the version 4.0 opens on
+ * `header/startDate`.
+ */
+export declare function readXaf(input: string | Uint8Array, options?: ReadOptions): XafBooks & {
+    openingDate: string | null;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,KAAK,EAEV,aAAa,EAIb,WAAW,EAEZ,MAAM,YAAY,CAAC;AAGpB,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAItE,iEAAiE;AACjE,eAAO,MAAM,cAAc;;;CAGjB,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,cAAc,CAAC;AAErD,qEAAqE;AACrE,MAAM,WAAW,QAAS,SAAQ,aAAa;IAC7C,OAAO,EAAE,UAAU,CAAC;CACrB;AA4ED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,GAAE,WAAgB,GAAG,QAAQ,GAAG;IAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CA6KxH"}

package/dist/index.js

@@ -0,0 +1,272 @@
+/**
+ * The XML Audit File Financial — the *XML Auditfile Financieel*, XAF — read
+ * back: the file an accounting package hands over when an auditor or a tax
+ * authority asks for the books of a year, in the XML the published schema
+ * defines. Versions 3.2 and 4.0 are read, each recognised by its namespace;
+ * any other is refused by name.
+ *
+ * What is taken from it, and where it sits in the file:
+ *
+ * - the **currency** of the books, `header/curCode`;
+ * - the **accounts**, `company/generalLedger/ledgerAccount` — `accID`,
+ *   `accDesc`, and `accTp` kept as written;
+ * - the **parties**, `company/customersSuppliers/customerSupplier`, by their
+ *   `custSupID`;
+ * - the **opening balance**, `company/openingBalance/obLine`;
+ * - the **entries**, `company/transactions/journal/transaction`, each with its
+ *   lines, `trLine`: an account, an amount and its side (`amnt`, `amntTp`),
+ *   a party, an amount in another currency.
+ *
+ * The file states its own totals — the number of lines, the debits and the
+ * credits of the opening and of the transactions — and each is held against
+ * what its lines add up to: a file that disagrees with itself comes back with
+ * a violation, as written.
+ *
+ * It depends on nothing, reads no database and knows no chart of accounts.
+ */
+import { formatDecimal, parseXsdDecimal } from './decimal.js';
+import { BooksFileError } from './errors.js';
+import { parseXml } from './xml.js';
+export * from './types.js';
+export { BooksFileError } from './errors.js';
+const DEFAULTS = { maxBytes: 256 * 1024 * 1024, maxElements: 20_000_000, maxDepth: 32 };
+/** The versions read, by the namespace their schema declares. */
+export const XAF_NAMESPACES = {
+    '3.2': 'http://www.auditfiles.nl/XAF/3.2',
+    '4.0': 'http://www.odb.belastingdienst.nl/Belastingdienst/BCPP/1.1/structures/XmlauditfileXAF_4.0',
+};
+/** The element children of `parent` called `name`, in its namespace. */
+function all(parent, name) {
+    return parent === undefined ? [] : parent.children.filter((child) => child.name === name && child.namespace === parent.namespace);
+}
+function one(parent, name) {
+    return all(parent, name)[0];
+}
+/** The trimmed text of the child `name`, or '' where there is none. */
+function text(parent, name) {
+    return one(parent, name)?.text.trim() ?? '';
+}
+function required(parent, name, where) {
+    const value = text(parent, name);
+    if (value === '')
+        throw new BooksFileError('missing_element', `${where} has no ${name}, which the schema requires`);
+    return value;
+}
+/** An `xsd:date`, its time zone set aside, checked against the calendar. */
+function isoDate(value, where) {
+    const match = /^(\d{4})-(\d{2})-(\d{2})(?:Z|[+-]\d{2}:\d{2})?$/.exec(value);
+    if (match === null)
+        throw new BooksFileError('invalid_value', `${where}: "${value}" is not an xsd:date, YYYY-MM-DD`);
+    const iso = `${match[1]}-${match[2]}-${match[3]}`;
+    const parsed = new Date(`${iso}T00:00:00Z`);
+    if (Number.isNaN(parsed.getTime()) || parsed.toISOString().slice(0, 10) !== iso) {
+        throw new BooksFileError('invalid_value', `${where}: ${value} is not a day of the calendar`);
+    }
+    return iso;
+}
+function amountOf(value, where) {
+    const parsed = parseXsdDecimal(value);
+    if (parsed === null)
+        throw new BooksFileError('invalid_value', `${where}: "${value}" is not an amount`);
+    return parsed;
+}
+/**
+ * The debit and the credit of an amount and its side. A negative amount — the
+ * schema's decimal allows a sign — is the other side, as it is everywhere
+ * else in this repository.
+ */
+function sides(element, where) {
+    const amount = amountOf(required(element, 'amnt', where), where);
+    const side = required(element, 'amntTp', where);
+    if (side !== 'D' && side !== 'C')
+        throw new BooksFileError('invalid_value', `${where}: amntTp is "${side}", and the schema allows D or C`);
+    const signed = side === 'D' ? amount : -amount;
+    return signed >= 0n ? { debit: signed, credit: 0n } : { debit: 0n, credit: -signed };
+}
+/** The totals a part of the file states, held against what its lines add up to. */
+function checkTotals(part, what, counted, violations) {
+    const lines = text(part, 'linesCount');
+    const debit = text(part, 'totalDebit');
+    const credit = text(part, 'totalCredit');
+    if (lines !== '' && lines !== String(counted.lines)) {
+        violations.push({ rule: 'lines_count', message: `the ${what} say they hold ${lines} lines, and ${counted.lines} are in the file`, row: null });
+    }
+    if (debit !== '' && amountOf(debit, `the ${what}' totalDebit`) !== counted.debit) {
+        violations.push({ rule: 'total_debit', message: `the ${what} state a total debit of ${debit}, and their lines add up to ${formatDecimal(counted.debit)}`, row: null });
+    }
+    if (credit !== '' && amountOf(credit, `the ${what}' totalCredit`) !== counted.credit) {
+        violations.push({ rule: 'total_credit', message: `the ${what} state a total credit of ${credit}, and their lines add up to ${formatDecimal(counted.credit)}`, row: null });
+    }
+}
+const EMPTY_LINE = { contact: null, label: null, currency: null, amountCurrency: null, dueDate: null, matching: null };
+/**
+ * Reads an audit file, as a string or as the bytes of the file. Entries are
+ * the `transaction` elements of each `journal`; the opening balance is the
+ * `obLine` elements, which carry no date of their own — the version 3.2 gives
+ * one, `opBalDate`, which `openingDate` returns, and the version 4.0 opens on
+ * `header/startDate`.
+ */
+export function readXaf(input, options = {}) {
+    const root = parseXml(input, { maxBytes: options.maxBytes ?? DEFAULTS.maxBytes, maxElements: options.maxElements ?? DEFAULTS.maxElements, maxDepth: DEFAULTS.maxDepth }, options.encoding);
+    const version = Object.entries(XAF_NAMESPACES).find(([, namespace]) => namespace === root.namespace)?.[0];
+    if (root.name !== 'auditfile') {
+        throw new BooksFileError('not_an_auditfile', `the document element is <${root.name}>, and an audit file's is <auditfile>`);
+    }
+    if (version === undefined) {
+        throw new BooksFileError(/XAF/i.test(root.namespace) ? 'unsupported_version' : 'not_an_auditfile', `the namespace is "${root.namespace}"; this reader reads the audit file of version 3.2 (${XAF_NAMESPACES['3.2']}) and 4.0 (${XAF_NAMESPACES['4.0']})`);
+    }
+    const header = one(root, 'header');
+    if (header === undefined)
+        throw new BooksFileError('missing_element', 'the audit file has no header');
+    const currency = required(header, 'curCode', 'the header').toUpperCase();
+    if (!/^[A-Z]{3}$/.test(currency))
+        throw new BooksFileError('invalid_value', `the header's curCode is "${currency}", and an ISO 4217 code is three letters`);
+    const startDate = isoDate(required(header, 'startDate', 'the header'), 'the header startDate');
+    const company = one(root, 'company');
+    if (company === undefined)
+        throw new BooksFileError('missing_element', 'the audit file has no company');
+    const violations = [];
+    const accounts = new Map();
+    const contacts = new Map();
+    for (const account of all(one(company, 'generalLedger'), 'ledgerAccount')) {
+        const code = required(account, 'accID', 'a ledgerAccount');
+        const name = text(account, 'accDesc');
+        const type = text(account, 'accTp');
+        accounts.set(code, { code, name: name === '' ? null : name, type: type === '' ? null : type });
+    }
+    for (const party of all(one(company, 'customersSuppliers'), 'customerSupplier')) {
+        const code = required(party, 'custSupID', 'a customerSupplier');
+        const name = text(party, 'custSupName');
+        const address = all(party, 'streetAddress').concat(all(party, 'postalAddress')).map((a) => text(a, 'country').toUpperCase()).find((c) => c !== '');
+        const country = address ?? text(party, 'taxRegistrationCountry').toUpperCase();
+        const vat = text(party, 'taxRegIdent');
+        const registration = text(party, 'commerceNr');
+        const email = text(party, 'eMail');
+        contacts.set(code, {
+            code,
+            name: name === '' ? code : name,
+            vatNumber: vat === '' ? null : vat,
+            registrationNumber: registration === '' ? null : registration,
+            email: email === '' ? null : email,
+            country: /^[A-Z]{2}$/.test(country) ? country : null,
+        });
+    }
+    const knowAccount = (code) => {
+        if (!accounts.has(code))
+            accounts.set(code, { code, name: null, type: null });
+    };
+    // The opening balance.
+    const opening = [];
+    let openingDate = null;
+    const openingBalance = one(company, 'openingBalance');
+    if (openingBalance !== undefined) {
+        const written = text(openingBalance, 'opBalDate');
+        openingDate = written === '' ? startDate : isoDate(written, 'the opening balance opBalDate');
+        const counted = { lines: 0, debit: 0n, credit: 0n };
+        for (const obLine of all(openingBalance, 'obLine')) {
+            const where = `opening balance line ${text(obLine, 'nr') || counted.lines + 1}`;
+            const account = required(obLine, 'accID', where);
+            const { debit, credit } = sides(obLine, where);
+            knowAccount(account);
+            opening.push({ ...EMPTY_LINE, account, debit: formatDecimal(debit), credit: formatDecimal(credit) });
+            counted.lines += 1;
+            counted.debit += debit;
+            counted.credit += credit;
+        }
+        checkTotals(openingBalance, 'opening balance', counted, violations);
+        if (counted.debit !== counted.credit) {
+            violations.push({
+                rule: 'opening_balance',
+                message: `the opening balance has debit ${formatDecimal(counted.debit)} and credit ${formatDecimal(counted.credit)}`,
+                row: null,
+            });
+        }
+    }
+    // The entries.
+    const entries = [];
+    const transactions = one(company, 'transactions');
+    if (transactions !== undefined) {
+        const counted = { lines: 0, debit: 0n, credit: 0n };
+        for (const journal of all(transactions, 'journal')) {
+            const code = required(journal, 'jrnID', 'a journal');
+            const journalName = text(journal, 'desc');
+            for (const transaction of all(journal, 'transaction')) {
+                const number = required(transaction, 'nr', `a transaction of journal ${code}`);
+                const where = `transaction ${number} of journal ${code}`;
+                const date = isoDate(required(transaction, 'trDt', where), `${where}, trDt`);
+                const lines = [];
+                let debits = 0n;
+                let credits = 0n;
+                let reference = null;
+                for (const trLine of all(transaction, 'trLine')) {
+                    const at = `line ${text(trLine, 'nr') || lines.length + 1} of ${where}`;
+                    const account = required(trLine, 'accID', at);
+                    const { debit, credit } = sides(trLine, at);
+                    knowAccount(account);
+                    const party = text(trLine, 'custSupID');
+                    if (party !== '' && !contacts.has(party)) {
+                        contacts.set(party, { code: party, name: party, vatNumber: null, registrationNumber: null, email: null, country: null });
+                    }
+                    const foreign = one(trLine, 'currency');
+                    const foreignCode = text(foreign, 'curCode').toUpperCase();
+                    const foreignAmount = text(foreign, 'curAmnt');
+                    const inCurrency = foreign === undefined || foreignAmount === '' ? null : amountOf(foreignAmount, `${at}, curAmnt`);
+                    const docRef = text(trLine, 'docRef');
+                    if (reference === null && docRef !== '')
+                        reference = docRef;
+                    const label = text(trLine, 'desc');
+                    const matching = text(trLine, 'matchKeyID');
+                    lines.push({
+                        account,
+                        contact: party === '' ? null : party,
+                        label: label === '' ? null : label,
+                        debit: formatDecimal(debit),
+                        credit: formatDecimal(credit),
+                        currency: foreignCode === '' || inCurrency === null ? null : foreignCode,
+                        amountCurrency: foreignCode === '' || inCurrency === null ? null : formatDecimal(inCurrency < 0n ? -inCurrency : inCurrency),
+                        dueDate: null,
+                        matching: matching === '' ? null : matching,
+                    });
+                    debits += debit;
+                    credits += credit;
+                }
+                if (lines.length === 0) {
+                    violations.push({ rule: 'empty_entry', message: `${where} has no line`, row: null });
+                }
+                else if (debits !== credits) {
+                    violations.push({ rule: 'balance', message: `${where} has debit ${formatDecimal(debits)} and credit ${formatDecimal(credits)}`, row: null });
+                }
+                counted.lines += lines.length;
+                counted.debit += debits;
+                counted.credit += credits;
+                const description = text(transaction, 'desc');
+                entries.push({
+                    journal: code,
+                    journalName: journalName === '' ? null : journalName,
+                    number,
+                    date,
+                    reference,
+                    description: description !== '' ? description : (lines[0]?.label ?? null),
+                    lines,
+                    row: null,
+                });
+            }
+        }
+        checkTotals(transactions, 'transactions', counted, violations);
+    }
+    if (entries.length === 0 && opening.length === 0) {
+        throw new BooksFileError('missing_element', 'the audit file holds no transaction and no opening balance');
+    }
+    return {
+        format: 'xaf',
+        version,
+        currency,
+        accounts: [...accounts.values()],
+        contacts: [...contacts.values()],
+        entries,
+        opening,
+        openingDate,
+        violations,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * What a set of books is once it has been read out of the software that kept
+ * them: accounts, parties, entries and an opening balance. The shape is
+ * declared here and imported from nowhere — it names no table and no ledger.
+ *
+ * It is, field for field, the shape every reader of an accounting export in
+ * this repository declares for itself (`@ekwo-ai/fec`, and the readers beside
+ * this one), so whatever takes one takes the others. It is not a shared
+ * abstraction: none imports another, and a reader that has nothing to say for
+ * a part of it returns that part empty.
+ *
+ * Every amount is a **decimal string**, never negative: a line carries a debit
+ * or a credit, and the side is the sign. No figure passes through a `number`.
+ */
+/** ISO 8601 calendar date, `YYYY-MM-DD`. */
+export type IsoDate = string;
+/** A fixed-point number, `1234.50`, never negative. */
+export type Decimal = string;
+/** One account of the chart the books were kept on, in the words of that software. */
+export interface ImportedAccount {
+    code: string;
+    name: string | null;
+    /** What the source calls its kind, verbatim. Null when it says nothing. */
+    type: string | null;
+}
+/** A customer, a supplier or anybody else a line names. */
+export interface ImportedContact {
+    /** How the source identifies the party on a line: its code, or its name where it has no code. */
+    code: string;
+    name: string;
+    vatNumber: string | null;
+    registrationNumber: string | null;
+    email: string | null;
+    /** ISO 3166-1 alpha-2, when the source writes one. Never inferred. */
+    country: string | null;
+}
+export interface ImportedLine {
+    /** The account code in the source's chart. */
+    account: string;
+    /** The `code` of an {@link ImportedContact}, or null. */
+    contact: string | null;
+    label: string | null;
+    debit: Decimal;
+    credit: Decimal;
+    /** A foreign currency the line was in, when the source says so. */
+    currency: string | null;
+    /** The amount in that currency, never negative. */
+    amountCurrency: Decimal | null;
+    dueDate: IsoDate | null;
+    /** The reconciliation mark the source put on the line, as written. */
+    matching: string | null;
+}
+export interface ImportedEntry {
+    /** The journal code in the source, or null when it has none. */
+    journal: string | null;
+    journalName: string | null;
+    /** The entry's number in the source. */
+    number: string | null;
+    date: IsoDate;
+    reference: string | null;
+    description: string | null;
+    lines: ImportedLine[];
+    /** The row of the file the entry starts on, from 1, for a message. */
+    row: number | null;
+}
+export interface Violation {
+    rule: string;
+    message: string;
+    /** The row of the file, from 1, or null for a rule about the whole file. */
+    row: number | null;
+}
+export interface ImportedBooks {
+    /** Which reader: `xaf` here. */
+    format: string;
+    /** The currency the file says its amounts are in. Null when it says none: never guessed. */
+    currency: string | null;
+    accounts: ImportedAccount[];
+    contacts: ImportedContact[];
+    entries: ImportedEntry[];
+    /** A trial balance: one line per account, to become the opening entry of a year. */
+    opening: ImportedLine[];
+    violations: Violation[];
+}
+export type Encoding = 'utf-8' | 'iso-8859-1';
+export interface ReadOptions {
+    /**
+     * How bytes are decoded. An XML file says it in its declaration, and that is
+     * what is read: UTF-8 when it says nothing, as XML itself provides. Given
+     * here, it has to agree with the declaration, or the file is refused — the
+     * caller and the file disagreeing is not settled by picking one.
+     */
+    encoding?: Encoding;
+    /** Refused beyond this many bytes, before anything is read. Default 256 MiB. */
+    maxBytes?: number;
+    /** Refused beyond this many elements, counted while reading. Default 20 million. */
+    maxElements?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,4CAA4C;AAC5C,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,uDAAuD;AACvD,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,sFAAsF;AACtF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,iGAAiG;IACjG,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,sEAAsE;IACtE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,mDAAmD;IACnD,cAAc,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,sEAAsE;IACtE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,wCAAwC;IACxC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,sEAAsE;IACtE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,oFAAoF;IACpF,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,16 @@
+/**
+ * What a set of books is once it has been read out of the software that kept
+ * them: accounts, parties, entries and an opening balance. The shape is
+ * declared here and imported from nowhere — it names no table and no ledger.
+ *
+ * It is, field for field, the shape every reader of an accounting export in
+ * this repository declares for itself (`@ekwo-ai/fec`, and the readers beside
+ * this one), so whatever takes one takes the others. It is not a shared
+ * abstraction: none imports another, and a reader that has nothing to say for
+ * a part of it returns that part empty.
+ *
+ * Every amount is a **decimal string**, never negative: a line carries a debit
+ * or a credit, and the side is the sign. No figure passes through a `number`.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/xml.d.ts

@@ -0,0 +1,47 @@
+import type { Encoding } from './types.js';
+/**
+ * A strict, small XML reader, written here because an audit file comes from
+ * outside and this package depends on nothing. It is the reader the bank
+ * statement brick of this repository wrote for the same reasons, copied rather
+ * than shared, with one difference: an audit file may be written in Latin-1,
+ * and says so in its declaration.
+ *
+ * It reads the XML accounting software writes and refuses the XML an attacker
+ * writes:
+ *
+ * - **no DOCTYPE at all**, so no internal subset, no entity declaration, no
+ *   external entity, no parameter entity — the billion-laughs family and the
+ *   XXE family both start with `<!DOCTYPE` and both stop there;
+ * - the five predefined entities and numeric character references, and any
+ *   other `&name;` is an error rather than an empty string;
+ * - a size limit applied before anything is read, a depth limit and an element
+ *   limit applied while reading, and no recursion: nesting costs heap the
+ *   limits bound, never stack;
+ * - the encoding the declaration names — UTF-8 when it names none, as XML
+ *   provides — decoded fatally where a byte can be wrong, and refused when the
+ *   caller names another;
+ * - namespaces resolved, because a file may write `<auditfile xmlns="…">` or
+ *   `<x:auditfile xmlns:x="…">` and both are the same file.
+ *
+ * It is not a general XML parser and says so: element and attribute names are
+ * ASCII (every name of the audit file is), and nothing is validated against a
+ * schema.
+ */
+export interface XmlElement {
+    /** Local name, without prefix. */
+    name: string;
+    /** Namespace URI, `''` when the element is in none. */
+    namespace: string;
+    /** Attributes by the name they were written under; `xmlns` ones left out. */
+    attributes: Record<string, string>;
+    children: XmlElement[];
+    /** The element's own character data, concatenated; children's is theirs. */
+    text: string;
+}
+export interface XmlLimits {
+    maxBytes: number;
+    maxDepth: number;
+    maxElements: number;
+}
+export declare function parseXml(input: string | Uint8Array, limits: XmlLimits, encoding?: Encoding): XmlElement;
+//# sourceMappingURL=xml.d.ts.map

package/dist/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../src/xml.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AA2JD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAsKvG"}

package/dist/xml.js

@@ -0,0 +1,303 @@
+import { BooksFileError } from './errors.js';
+const NAME = /[A-Za-z_][A-Za-z0-9_.-]*(?::[A-Za-z_][A-Za-z0-9_.-]*)?/y;
+const ATTRIBUTE = /\s+([A-Za-z_][A-Za-z0-9_.-]*(?::[A-Za-z_][A-Za-z0-9_.-]*)?)\s*=\s*(?:"([^<"]*)"|'([^<']*)')/y;
+const DECLARATION = /^<\?xml\s+version\s*=\s*(?:"1\.[0-9]+"|'1\.[0-9]+')(?:\s+encoding\s*=\s*(?:"([A-Za-z][A-Za-z0-9._-]*)"|'([A-Za-z][A-Za-z0-9._-]*)'))?(?:\s+standalone\s*=\s*(?:"(?:yes|no)"|'(?:yes|no)'))?\s*\?>/;
+const REFERENCE = /&(?:#x([0-9a-fA-F]+)|#([0-9]+)|([A-Za-z_][A-Za-z0-9_.-]*));/g;
+const PREDEFINED = {
+    lt: '<',
+    gt: '>',
+    amp: '&',
+    quot: '"',
+    apos: "'",
+};
+const XML_NAMESPACE = 'http://www.w3.org/XML/1998/namespace';
+function malformed(what, at) {
+    return new BooksFileError('malformed_xml', `${what} (at character ${at})`);
+}
+/** XML 1.0 `Char`, by code point. */
+function isXmlChar(code) {
+    return (code === 0x9 ||
+        code === 0xa ||
+        code === 0xd ||
+        (code >= 0x20 && code <= 0xd7ff) ||
+        (code >= 0xe000 && code <= 0xfffd) ||
+        (code >= 0x10000 && code <= 0x10ffff));
+}
+/** The first code unit XML does not allow in a document, or -1. */
+function firstForbiddenCharacter(source) {
+    for (let index = 0; index < source.length; index += 1) {
+        const code = source.charCodeAt(index);
+        if (code >= 0x20 && code < 0xfffe)
+            continue;
+        if (code === 0x9 || code === 0xa || code === 0xd)
+            continue;
+        return index;
+    }
+    return -1;
+}
+function decodeReferences(raw, at) {
+    if (!raw.includes('&'))
+        return raw;
+    let out = '';
+    let last = 0;
+    for (const match of raw.matchAll(REFERENCE)) {
+        const index = match.index;
+        const between = raw.slice(last, index);
+        if (between.includes('&'))
+            throw malformed('a bare "&"', at + last + between.indexOf('&'));
+        out += between;
+        if (match[3] !== undefined) {
+            const value = PREDEFINED[match[3]];
+            if (value === undefined) {
+                throw new BooksFileError('undefined_entity', `entity &${match[3]}; is not one of the five XML predefines, and this reader declares no other (at character ${at + index})`);
+            }
+            out += value;
+        }
+        else {
+            const code = match[1] !== undefined ? parseInt(match[1], 16) : parseInt(match[2], 10);
+            if (!isXmlChar(code)) {
+                throw malformed(`character reference ${match[0]} is not an XML character`, at + index);
+            }
+            out += String.fromCodePoint(code);
+        }
+        last = index + match[0].length;
+    }
+    const rest = raw.slice(last);
+    if (rest.includes('&'))
+        throw malformed('a bare "&"', at + last + rest.indexOf('&'));
+    return out + rest;
+}
+/** The encodings a declaration may name, by the label it uses. */
+const LABELS = {
+    'utf-8': 'utf-8',
+    utf8: 'utf-8',
+    'iso-8859-1': 'iso-8859-1',
+    'iso8859-1': 'iso-8859-1',
+    latin1: 'iso-8859-1',
+    'latin-1': 'iso-8859-1',
+};
+function decode(input, limits, said) {
+    if (typeof input === 'string') {
+        // A string has no bytes to count; its length is the closest honest bound,
+        // and no encoding writes a code unit in less than one byte.
+        if (input.length > limits.maxBytes) {
+            throw new BooksFileError('too_large', `the file is ${input.length} characters, over the limit of ${limits.maxBytes}`);
+        }
+        return input.charCodeAt(0) === 0xfeff ? input.slice(1) : input;
+    }
+    if (input.byteLength > limits.maxBytes) {
+        throw new BooksFileError('too_large', `the file is ${input.byteLength} bytes, over the limit of ${limits.maxBytes}`);
+    }
+    const first = input[0];
+    const second = input[1];
+    if ((first === 0xfe && second === 0xff) || (first === 0xff && second === 0xfe)) {
+        throw new BooksFileError('unsupported_encoding', 'the file is UTF-16; this reader takes UTF-8 or Latin-1');
+    }
+    // The declaration is ASCII in both encodings read here, so it can be read
+    // before the rest is decoded.
+    const bom = first === 0xef && second === 0xbb && input[2] === 0xbf;
+    const head = String.fromCharCode(...input.subarray(bom ? 3 : 0, Math.min(input.length, 256)));
+    const declaration = DECLARATION.exec(head);
+    const label = (declaration?.[1] ?? declaration?.[2])?.toLowerCase();
+    let encoding = 'utf-8';
+    if (label !== undefined) {
+        const known = LABELS[label];
+        if (known === undefined) {
+            throw new BooksFileError('unsupported_encoding', `the file declares encoding ${label}; this reader takes UTF-8 or ISO-8859-1 — decode it first and pass the string`);
+        }
+        encoding = known;
+    }
+    if (said !== undefined && said !== encoding) {
+        throw new BooksFileError('unsupported_encoding', `the file is ${label === undefined ? 'UTF-8, as XML is when its declaration names no encoding' : `declared ${label}`}, and ${said} was asked for; the file is read as it says, never as somebody else says`);
+    }
+    if (encoding === 'iso-8859-1') {
+        if (bom)
+            throw new BooksFileError('unsupported_encoding', 'the file starts with the byte order mark of UTF-8 and declares ISO-8859-1');
+        const parts = [];
+        for (let i = 0; i < input.length; i += 8192)
+            parts.push(String.fromCharCode(...input.subarray(i, i + 8192)));
+        return parts.join('');
+    }
+    let text;
+    try {
+        text = new TextDecoder('utf-8', { fatal: true }).decode(input);
+    }
+    catch {
+        throw new BooksFileError('unsupported_encoding', "the bytes are not UTF-8, and the declaration names no other encoding; a file saved in Latin-1 says so in its declaration");
+    }
+    return text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+}
+function isSpace(character) {
+    return character === ' ' || character === '\n' || character === '\t';
+}
+export function parseXml(input, limits, encoding) {
+    const source = decode(input, limits, encoding).replace(/\r\n?/g, '\n');
+    const forbidden = firstForbiddenCharacter(source);
+    if (forbidden !== -1)
+        throw malformed('a control character XML does not allow', forbidden);
+    let at = 0;
+    const declaration = DECLARATION.exec(source);
+    if (declaration)
+        at = declaration[0].length;
+    const rootScope = new Map([['xml', XML_NAMESPACE]]);
+    const stack = [];
+    let root;
+    let elements = 0;
+    const addText = (raw, where, literal) => {
+        const top = stack[stack.length - 1];
+        if (top === undefined) {
+            if (raw.trim() !== '')
+                throw malformed('text outside the document element', where);
+            return;
+        }
+        top.text.push(literal ? raw : decodeReferences(raw, where));
+    };
+    while (at < source.length) {
+        const lt = source.indexOf('<', at);
+        if (lt === -1) {
+            addText(source.slice(at), at, false);
+            at = source.length;
+            break;
+        }
+        if (lt > at)
+            addText(source.slice(at, lt), at, false);
+        at = lt;
+        if (source.startsWith('<!--', at)) {
+            const end = source.indexOf('-->', at + 4);
+            if (end === -1)
+                throw malformed('a comment that never ends', at);
+            at = end + 3;
+            continue;
+        }
+        if (source.startsWith('<![CDATA[', at)) {
+            if (stack.length === 0)
+                throw malformed('a CDATA section outside the document element', at);
+            const end = source.indexOf(']]>', at + 9);
+            if (end === -1)
+                throw malformed('a CDATA section that never ends', at);
+            addText(source.slice(at + 9, end), at, true);
+            at = end + 3;
+            continue;
+        }
+        if (source.startsWith('<!DOCTYPE', at)) {
+            throw new BooksFileError('doctype_forbidden', 'the file carries a DOCTYPE; an audit file needs none, and entity declarations are refused unread');
+        }
+        if (source.startsWith('<!', at))
+            throw malformed('a markup declaration', at);
+        if (source.startsWith('<?', at)) {
+            const end = source.indexOf('?>', at + 2);
+            if (end === -1)
+                throw malformed('a processing instruction that never ends', at);
+            if (/^<\?xml[\s?]/i.test(source.slice(at, at + 6))) {
+                throw malformed('an XML declaration anywhere but the first character', at);
+            }
+            at = end + 2;
+            continue;
+        }
+        if (source.startsWith('</', at)) {
+            NAME.lastIndex = at + 2;
+            const name = NAME.exec(source);
+            if (!name)
+                throw malformed('a closing tag without a name', at);
+            let end = NAME.lastIndex;
+            while (isSpace(source[end]))
+                end += 1;
+            if (source[end] !== '>')
+                throw malformed('a closing tag that never ends', at);
+            const open = stack.pop();
+            if (open === undefined || open.qualifiedName !== name[0]) {
+                throw malformed(`</${name[0]}> closes ${open ? `<${open.qualifiedName}>` : 'nothing'}`, at);
+            }
+            open.element.text = open.text.join('');
+            at = end + 1;
+            continue;
+        }
+        // An opening tag.
+        NAME.lastIndex = at + 1;
+        const name = NAME.exec(source);
+        if (!name)
+            throw malformed('a "<" that opens nothing', at);
+        if (root !== undefined && stack.length === 0) {
+            throw malformed('a second document element', at);
+        }
+        elements += 1;
+        if (elements > limits.maxElements) {
+            throw new BooksFileError('too_many_elements', `the file holds more than ${limits.maxElements} elements`);
+        }
+        if (stack.length >= limits.maxDepth) {
+            throw new BooksFileError('too_deep', `elements are nested deeper than ${limits.maxDepth}`);
+        }
+        let cursor = NAME.lastIndex;
+        const written = [];
+        for (;;) {
+            ATTRIBUTE.lastIndex = cursor;
+            const attribute = ATTRIBUTE.exec(source);
+            if (!attribute)
+                break;
+            const raw = (attribute[2] ?? attribute[3]);
+            written.push([
+                attribute[1],
+                decodeReferences(raw, cursor).replace(/[\t\n]/g, ' '),
+            ]);
+            cursor = ATTRIBUTE.lastIndex;
+        }
+        while (isSpace(source[cursor]))
+            cursor += 1;
+        const selfClosing = source[cursor] === '/';
+        if (selfClosing)
+            cursor += 1;
+        if (source[cursor] !== '>')
+            throw malformed(`<${name[0]}> is not a well-formed tag`, at);
+        const parentScope = stack[stack.length - 1]?.scope ?? rootScope;
+        let scope = parentScope;
+        const attributes = {};
+        const seen = new Set();
+        for (const [key, value] of written) {
+            if (seen.has(key))
+                throw malformed(`attribute ${key} is written twice on <${name[0]}>`, at);
+            seen.add(key);
+            if (key === 'xmlns' || key.startsWith('xmlns:')) {
+                if (scope === parentScope)
+                    scope = new Map(parentScope);
+                const prefix = key === 'xmlns' ? '' : key.slice(6);
+                if (prefix === 'xml' || prefix === 'xmlns') {
+                    throw malformed(`prefix ${prefix} cannot be declared`, at);
+                }
+                if (prefix !== '' && value === '')
+                    throw malformed(`prefix ${prefix} is bound to nothing`, at);
+                scope.set(prefix, value);
+            }
+            else {
+                attributes[key] = value;
+            }
+        }
+        const colon = name[0].indexOf(':');
+        const prefix = colon === -1 ? '' : name[0].slice(0, colon);
+        const namespace = scope.get(prefix);
+        if (namespace === undefined && prefix !== '') {
+            throw malformed(`prefix ${prefix} is bound to no namespace`, at);
+        }
+        const element = {
+            name: colon === -1 ? name[0] : name[0].slice(colon + 1),
+            namespace: namespace ?? '',
+            attributes,
+            children: [],
+            text: '',
+        };
+        const parent = stack[stack.length - 1];
+        if (parent)
+            parent.element.children.push(element);
+        else
+            root = element;
+        if (!selfClosing)
+            stack.push({ element, qualifiedName: name[0], scope, text: [] });
+        at = cursor + 1;
+    }
+    const unclosed = stack[stack.length - 1];
+    if (unclosed)
+        throw malformed(`<${unclosed.qualifiedName}> is never closed`, source.length);
+    if (root === undefined)
+        throw malformed('no document element', 0);
+    return root;
+}
+//# sourceMappingURL=xml.js.map

package/dist/xml.js.map

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@ekwo-ai/xaf",
+  "version": "0.9.0",
+  "description": "Reads an XML Audit File Financial (XAF, versions 3.2 and 4.0) — the accounts, the parties, the opening balance and every transaction of a year — into plain objects in TypeScript: amounts as decimal strings, the file's own totals checked, and what does not add up. A strict XML reader, no DOCTYPE, no entities. Zero dependencies.",
+  "keywords": [
+    "xaf",
+    "auditfile",
+    "audit-file",
+    "xml",
+    "accounting",
+    "bookkeeping",
+    "migration",
+    "import",
+    "parser"
+  ],
+  "license": "MIT",
+  "author": "Ekwo AI",
+  "homepage": "https://github.com/Ekwo-ai/ekwo-os/tree/main/packages/formats/xaf#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ekwo-ai/ekwo-os.git",
+    "directory": "packages/formats/xaf"
+  },
+  "bugs": {
+    "url": "https://github.com/Ekwo-ai/ekwo-os/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.0",
+    "vitest": "^3.2.0",
+    "xmllint-wasm": "^5.3.0"
+  }
+}