@ekwo-ai/journal-report 0.6.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,92 @@
+# `@ekwo-ai/journal-report`
+
+Reads a **journal report**, or a **general ledger detail**, saved as CSV — the
+report a cloud accounting service prints of every journal it posted, one row
+per line with the number of its journal — into plain objects, in TypeScript,
+with no dependencies. Beside it, the chart of accounts and the contacts, which
+the same service exports as CSV directly.
+
+```ts
+import { readJournalReport } from '@ekwo-ai/journal-report';
+
+const books = readJournalReport([report, chart, contacts], { dateOrder: 'dmy' });
+
+books.entries;    // [{ number: '102', journal: 'Receivable Invoice', date: '2025-01-15', lines: […] }, …]
+books.accounts;   // [{ code: '090', name: 'Business Bank Account', type: 'Bank' }, …]
+books.violations; // a journal that does not balance
+```
+
+## The files
+
+**The report** (required). Such a service exports its reports as a
+spreadsheet, not as CSV: open it and save it as CSV. A report is laid out for a
+person, so:
+
+- the **header** is the first row that names a `Date`, an `Account Code`, a
+  `Debit` and a `Credit` — the title rows above it are passed over;
+- a **line** is a row whose date cell holds a date; the rows that head a group,
+  total it, or give an opening or closing balance are passed over;
+- lines are gathered into entries by their **journal number** (`Journal ID`,
+  `Journal Number`, `Journal #`), which the report has to carry: add the column
+  in the report's column picker before exporting it, with the account code. A
+  report without it is refused by name — there would be no way to put its lines
+  back into entries.
+
+Optional columns: `Source` (kept as the journal of the entry), `Account`,
+`Description`, `Narration`, `Reference`, `Contact`.
+
+- A **date written in digits** — `03/04/2026` — is read in the order the
+  caller names (`dateOrder: 'dmy' | 'mdy' | 'ymd'`) and refused without one:
+  the order follows the region of the organisation, and the file does not say
+  it. A date in ISO or with its month in letters (`3 Apr 2026`) needs none.
+- An **amount** is read as a spreadsheet displays it. In a comma-separated file
+  the decimal mark is a point and a comma only groups thousands, three digits at
+  a time (`1,234.50`). In a file separated by a semicolon or a tab the decimal
+  mark is the one mark the number carries, and thousands are grouped by a space
+  only. A negative is a minus or brackets. Anything else is refused.
+
+**The chart of accounts** (optional): `*Code`, `*Name`, `*Type`, the rest
+ignored. Codes are kept as text: `090` stays `090`.
+
+**The contacts** (optional): `*ContactName`, `AccountNumber`, `EmailAddress`,
+`TaxNumber`, `CompanyNumber`; the country only when it is written as a
+two-letter code.
+
+## 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. A report says no currency: it prints the organisation's
+and does not name it. Amounts are decimal strings, never negative. What does
+not add up comes back in `violations`; what is not a report 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 journal-report <files…> --date-order dmy`.
+
+## Sources
+
+This reader was written against the reports of **Xero**, read on 22 September
+2026 from its help centre:
+
+- [General Ledger Detail report](https://central.xero.com/0/article/General-Ledger-Detail-report)
+  and [Journal report](https://central.xero.com/0/article/Journal-report): the
+  columns each offers, the Journal ID and Account Code columns of the column
+  picker, the grouping by account or none;
+- [Export or print a report](https://central.xero.com/0/article/Export-or-print-a-report):
+  reports export to PDF, a spreadsheet or Google Sheets, not to CSV;
+- [Export or print your chart of accounts](https://central.xero.com/0/article/Export-or-print-your-chart-of-accounts)
+  and [Import a chart of accounts](https://central.xero.com/s/article/Import-a-chart-of-accounts):
+  the columns of the chart and the account types;
+- [Export contacts out of Xero](https://central.xero.com/0/article/Export-contacts-out-of-Xero)
+  and [Import contacts into Xero](https://central.xero.com/0/article/Import-contacts-into-Xero):
+  the columns of the contacts file.
+
+`ekwo import xero <files…>` is the same as `ekwo import journal-report`.
+
+What those pages do not state — the exact text of the title and total rows —
+is why the reader finds the header by its columns and a line by its date,
+rather than by position. The fixtures under `test/fixtures/` are written by
+hand from those pages and hold no real data.
+
+MIT.

package/dist/csv.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The comma-separated values a spreadsheet saves, as RFC 4180 describes them:
+ * fields between double quotes may hold the separator, a line break and a
+ * doubled quote. Nothing else about the file is assumed.
+ *
+ * The separator is **read from the header**, which this format requires: the
+ * first of `,`, `;` and a tab that the header row contains outside quotes. A
+ * spreadsheet saves with a comma or a semicolon depending on the language of
+ * the machine, and the header is the one row whose content is known, so this
+ * is reading the file rather than guessing at it.
+ */
+import type { Encoding } from './types.js';
+export type Separator = ',' | ';' | '\t';
+/** Bytes to text, in the encoding the caller said, refusing what is not that. */
+export declare function decode(input: string | Uint8Array, encoding: Encoding, maxBytes: number): string;
+/** The separator of a header line: the first of the three found outside quotes. */
+export declare function separatorOf(headerLine: string): Separator;
+/** Every row of the file, each an array of fields, with the row number it starts on. */
+export declare function parseCsv(text: string, separator: Separator): {
+    row: number;
+    fields: string[];
+}[];
+/** A header cell as it is compared: trimmed, lower case, without the `*` some exports put on a required column. */
+export declare function headerKey(cell: string): string;
+//# sourceMappingURL=csv.d.ts.map

package/dist/csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../src/csv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI3C,MAAM,MAAM,SAAS,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;AAEzC,iFAAiF;AACjF,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA0B/F;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAQzD;AAED,wFAAwF;AACxF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,CAqDhG;AAED,mHAAmH;AACnH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/csv.js

@@ -0,0 +1,125 @@
+/**
+ * The comma-separated values a spreadsheet saves, as RFC 4180 describes them:
+ * fields between double quotes may hold the separator, a line break and a
+ * doubled quote. Nothing else about the file is assumed.
+ *
+ * The separator is **read from the header**, which this format requires: the
+ * first of `,`, `;` and a tab that the header row contains outside quotes. A
+ * spreadsheet saves with a comma or a semicolon depending on the language of
+ * the machine, and the header is the one row whose content is known, so this
+ * is reading the file rather than guessing at it.
+ */
+import { BooksFileError } from './errors.js';
+const BYTE_ORDER_MARK = 0xfeff;
+/** Bytes to text, in the encoding the caller said, refusing what is not that. */
+export function decode(input, encoding, maxBytes) {
+    let text;
+    if (typeof input === 'string') {
+        if (input.length > maxBytes)
+            throw new BooksFileError('too_large', `the file is longer than ${maxBytes} bytes`);
+        text = input;
+    }
+    else {
+        if (input.byteLength > maxBytes) {
+            throw new BooksFileError('too_large', `the file is ${input.byteLength} bytes, over the limit of ${maxBytes}`);
+        }
+        if (encoding === 'iso-8859-1') {
+            const parts = [];
+            for (let i = 0; i < input.length; i += 8192)
+                parts.push(String.fromCharCode(...input.subarray(i, i + 8192)));
+            text = parts.join('');
+        }
+        else {
+            try {
+                text = new TextDecoder('utf-8', { fatal: true }).decode(input);
+            }
+            catch {
+                throw new BooksFileError('unsupported_encoding', "the bytes are not UTF-8; if the file was saved in Latin-1, say so with { encoding: 'iso-8859-1' } — it is not guessed, because every sequence of bytes is valid Latin-1");
+            }
+        }
+    }
+    if (text.charCodeAt(0) === BYTE_ORDER_MARK)
+        text = text.slice(1);
+    return text;
+}
+/** The separator of a header line: the first of the three found outside quotes. */
+export function separatorOf(headerLine) {
+    let quoted = false;
+    for (const char of headerLine) {
+        if (char === '"')
+            quoted = !quoted;
+        else if (!quoted && (char === ',' || char === ';' || char === '\t'))
+            return char;
+    }
+    // A header of one column has no separator; any will do, and a comma is it.
+    return ',';
+}
+/** Every row of the file, each an array of fields, with the row number it starts on. */
+export function parseCsv(text, separator) {
+    const rows = [];
+    let fields = [];
+    let field = '';
+    let quoted = false;
+    let line = 1;
+    let startedOn = 1;
+    let fieldStarted = false;
+    const endRow = () => {
+        fields.push(field);
+        // A blank line is no row; a row of empty fields is kept and read.
+        if (!(fields.length === 1 && fields[0] === ''))
+            rows.push({ row: startedOn, fields });
+        fields = [];
+        field = '';
+        fieldStarted = false;
+    };
+    for (let i = 0; i < text.length; i += 1) {
+        const char = text[i];
+        if (quoted) {
+            if (char === '"') {
+                if (text[i + 1] === '"') {
+                    field += '"';
+                    i += 1;
+                }
+                else
+                    quoted = false;
+            }
+            else {
+                if (char === '\n')
+                    line += 1;
+                field += char;
+            }
+            continue;
+        }
+        if (char === '"' && !fieldStarted) {
+            quoted = true;
+            fieldStarted = true;
+        }
+        else if (char === separator) {
+            fields.push(field);
+            field = '';
+            fieldStarted = false;
+        }
+        else if (char === '\r' && text[i + 1] === '\n') {
+            // The \n that follows ends the row.
+        }
+        else if (char === '\n' || char === '\r') {
+            endRow();
+            line += 1;
+            startedOn = line;
+        }
+        else {
+            field += char;
+            fieldStarted = true;
+        }
+    }
+    if (quoted)
+        throw new BooksFileError('malformed_csv', 'a quoted field is never closed', startedOn);
+    if (field !== '' || fields.length > 0)
+        endRow();
+    return rows;
+}
+/** A header cell as it is compared: trimmed, lower case, without the `*` some exports put on a required column. */
+export function headerKey(cell) {
+    return cell.trim().replace(/^\*/, '').trim().toLowerCase();
+}
+//# sourceMappingURL=csv.js.map

package/dist/csv.js.map

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

package/dist/decimal.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Amounts added without a float.
+ *
+ * An amount is held as a `bigint` of millionths: enough for any currency and
+ * any rate a spreadsheet prints, and exact. What leaves is a string with two
+ * decimals, and more when the file wrote more that are not zero — dropping a
+ * written zero is not rounding, dropping anything else would be, and is never
+ * done here.
+ */
+/** 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;AAIH,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMnD"}

package/dist/decimal.js

@@ -0,0 +1,19 @@
+/**
+ * Amounts added without a float.
+ *
+ * An amount is held as a `bigint` of millionths: enough for any currency and
+ * any rate a spreadsheet prints, and exact. What leaves is a string with two
+ * decimals, and more when the file wrote more that are not zero — dropping a
+ * written zero is not rounding, dropping anything else would be, and is never
+ * done here.
+ */
+const SCALE = 6;
+/** 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;AAEhB,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,25 @@
+/**
+ * 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 with no header the reader recognises has no row 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 announced. */
+ | 'unsupported_encoding'
+/** Nothing in the file, or a header and nothing under it. */
+ | 'empty_file'
+/** A header that lacks a column the format needs, or names one twice. */
+ | 'missing_column'
+/** A quote that is never closed. */
+ | 'malformed_csv'
+/** A value the format does not allow where it is: a date, an amount. */
+ | 'invalid_value';
+export declare class BooksFileError extends Error {
+    readonly code: BooksFileErrorCode;
+    /** The row the reader stopped on, from 1, when there is one. */
+    readonly row: number | null;
+    constructor(code: BooksFileErrorCode, message: string, row?: number | null);
+}
+//# 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,iDAAiD;GAC/C,sBAAsB;AACxB,6DAA6D;GAC3D,YAAY;AACd,yEAAyE;GACvE,gBAAgB;AAClB,oCAAoC;GAClC,eAAe;AACjB,wEAAwE;GACtE,eAAe,CAAC;AAEpB,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,gEAAgE;IAChE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEhB,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,GAAG,IAAW;CAMjF"}

package/dist/errors.js

@@ -0,0 +1,12 @@
+export class BooksFileError extends Error {
+    code;
+    /** The row the reader stopped on, from 1, when there is one. */
+    row;
+    constructor(code, message, row = null) {
+        super(row === null ? message : `row ${row}: ${message}`);
+        this.name = 'BooksFileError';
+        this.code = code;
+        this.row = row;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAmBA,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAqB;IAClC,gEAAgE;IACvD,GAAG,CAAgB;IAE5B,YAAY,IAAwB,EAAE,OAAe,EAAE,MAAqB,IAAI;QAC9E,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,KAAK,OAAO,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,82 @@
+/**
+ * A journal report, or a general ledger detail, saved as CSV: the report a
+ * cloud accounting service prints of every journal it posted, one row per
+ * line, with the number of the journal the line belongs to. Such a service
+ * exports its reports to a spreadsheet and not to CSV; the spreadsheet is
+ * saved as CSV, and that file is what this reads — beside it, the chart of
+ * accounts and the contacts, which the same service exports as CSV directly.
+ *
+ * A report is laid out for a person: a few rows of title before the header,
+ * rows that head a group or total it, rows of opening and closing balance. So
+ * the header is **the first row that names a date, an account code, a debit
+ * and a credit**, and a line is **a row whose date cell holds a date**; every
+ * other row is a heading or a total and is passed over. Lines are gathered
+ * into entries by their journal number, which the report has to carry.
+ *
+ * A date the report wrote as digits in an order nobody can read off the digits
+ * — `03/04/2026` — is read in the order the caller names, and refused without
+ * one: which order a report uses follows the region of the organisation, and
+ * the file does not say it. A date with the month in letters, or in ISO, needs
+ * no order.
+ *
+ * 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 order of day, month and year in a date written only in digits. */
+export type DateOrder = 'dmy' | 'mdy' | 'ymd';
+export interface JournalReportOptions extends ReadOptions {
+    /** How a date written only in digits is to be read. Required when the report writes one; never guessed. */
+    dateOrder?: DateOrder;
+}
+/** The columns of the report, each under the names it may carry. */
+export declare const REPORT_COLUMNS: {
+    readonly date: readonly ["date"];
+    readonly journal: readonly ["journal id", "journal number", "journal no.", "journal no", "journal #", "journal"];
+    readonly source: readonly ["source", "source type"];
+    readonly accountCode: readonly ["account code"];
+    readonly account: readonly ["account", "account name"];
+    readonly description: readonly ["description"];
+    readonly narration: readonly ["narration"];
+    readonly reference: readonly ["reference"];
+    readonly contact: readonly ["contact", "contact name"];
+    readonly debit: readonly ["debit"];
+    readonly credit: readonly ["credit"];
+};
+/** The columns of the chart of accounts. */
+export declare const CHART_COLUMNS: {
+    readonly code: readonly ["code", "account code"];
+    readonly name: readonly ["name", "account name"];
+    readonly type: readonly ["type", "account type"];
+};
+/** The columns of the contacts. */
+export declare const CONTACT_COLUMNS: {
+    readonly name: readonly ["contactname", "contact name"];
+    readonly accountNumber: readonly ["accountnumber", "account number"];
+    readonly email: readonly ["emailaddress", "email address", "email"];
+    readonly tax: readonly ["taxnumber", "tax number"];
+    readonly company: readonly ["companynumber", "company number"];
+    readonly country: readonly ["pocountry", "sacountry"];
+};
+/**
+ * Reads the files — the report, and optionally the chart of accounts and the
+ * contacts — in any order, each recognised by its header.
+ */
+export declare function readJournalReport(inputs: readonly (string | Uint8Array)[], options?: JournalReportOptions): ImportedBooks;
+/**
+ * A date, or null for a cell that is not one — which is how a heading or a
+ * total row is told from a line. A cell that looks like a date and is not a
+ * day of the calendar is refused, never passed over.
+ */
+export declare function readDate(value: string, order: DateOrder | undefined, row: number): string | null;
+/**
+ * An amount as a spreadsheet displays it once saved as CSV. In a file
+ * separated by commas the decimal mark is a point and a comma can only group
+ * thousands, three digits at a time (`1,234.50`). In a file separated by a
+ * semicolon or a tab the decimal mark is whichever of the two the number
+ * carries once, and thousands may only be grouped by a space. A negative is a
+ * minus or brackets. Anything else is refused.
+ */
+export declare function amount(raw: string, separator: string, row: number): bigint;
+//# 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;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,KAAK,EAEV,aAAa,EAIb,WAAW,EAEZ,MAAM,YAAY,CAAC;AAEpB,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAItE,yEAAyE;AACzE,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAE9C,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,2GAA2G;IAC3G,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,oEAAoE;AACpE,eAAO,MAAM,cAAc;;;;;;;;;;;;CAYjB,CAAC;AAEX,4CAA4C;AAC5C,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,mCAAmC;AACnC,eAAO,MAAM,eAAe;;;;;;;CAOlB,CAAC;AAyBX;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,UAAU,CAAC,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,aAAa,CAwK7H;AAID;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmChG;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CA0B1E"}

package/dist/index.js

@@ -0,0 +1,327 @@
+/**
+ * A journal report, or a general ledger detail, saved as CSV: the report a
+ * cloud accounting service prints of every journal it posted, one row per
+ * line, with the number of the journal the line belongs to. Such a service
+ * exports its reports to a spreadsheet and not to CSV; the spreadsheet is
+ * saved as CSV, and that file is what this reads — beside it, the chart of
+ * accounts and the contacts, which the same service exports as CSV directly.
+ *
+ * A report is laid out for a person: a few rows of title before the header,
+ * rows that head a group or total it, rows of opening and closing balance. So
+ * the header is **the first row that names a date, an account code, a debit
+ * and a credit**, and a line is **a row whose date cell holds a date**; every
+ * other row is a heading or a total and is passed over. Lines are gathered
+ * into entries by their journal number, which the report has to carry.
+ *
+ * A date the report wrote as digits in an order nobody can read off the digits
+ * — `03/04/2026` — is read in the order the caller names, and refused without
+ * one: which order a report uses follows the region of the organisation, and
+ * the file does not say it. A date with the month in letters, or in ISO, needs
+ * no order.
+ *
+ * It depends on nothing, reads no database and knows no chart of accounts.
+ */
+import { decode, headerKey, parseCsv, separatorOf } from './csv.js';
+import { formatDecimal } from './decimal.js';
+import { BooksFileError } from './errors.js';
+export * from './types.js';
+export { BooksFileError } from './errors.js';
+const DEFAULTS = { encoding: 'utf-8', maxBytes: 256 * 1024 * 1024 };
+/** The columns of the report, each under the names it may carry. */
+export const REPORT_COLUMNS = {
+    date: ['date'],
+    journal: ['journal id', 'journal number', 'journal no.', 'journal no', 'journal #', 'journal'],
+    source: ['source', 'source type'],
+    accountCode: ['account code'],
+    account: ['account', 'account name'],
+    description: ['description'],
+    narration: ['narration'],
+    reference: ['reference'],
+    contact: ['contact', 'contact name'],
+    debit: ['debit'],
+    credit: ['credit'],
+};
+/** The columns of the chart of accounts. */
+export const CHART_COLUMNS = {
+    code: ['code', 'account code'],
+    name: ['name', 'account name'],
+    type: ['type', 'account type'],
+};
+/** The columns of the contacts. */
+export const CONTACT_COLUMNS = {
+    name: ['contactname', 'contact name'],
+    accountNumber: ['accountnumber', 'account number'],
+    email: ['emailaddress', 'email address', 'email'],
+    tax: ['taxnumber', 'tax number'],
+    company: ['companynumber', 'company number'],
+    country: ['pocountry', 'sacountry'],
+};
+function locate(keys, spec) {
+    const at = {};
+    for (const [column, names] of Object.entries(spec)) {
+        const found = keys.findIndex((key) => names.includes(key));
+        if (found !== -1)
+            at[column] = found;
+    }
+    return at;
+}
+const has = (keys, names) => keys.some((key) => names.includes(key));
+function isReportHeader(keys) {
+    return has(keys, REPORT_COLUMNS.date) && has(keys, REPORT_COLUMNS.accountCode) && has(keys, REPORT_COLUMNS.debit) && has(keys, REPORT_COLUMNS.credit);
+}
+/**
+ * Reads the files — the report, and optionally the chart of accounts and the
+ * contacts — in any order, each recognised by its header.
+ */
+export function readJournalReport(inputs, options = {}) {
+    const sheets = inputs.map((input, index) => {
+        const text = decode(input, options.encoding ?? DEFAULTS.encoding, options.maxBytes ?? DEFAULTS.maxBytes);
+        // The title rows above the header may hold no separator at all, so the
+        // separator is read from the first line that holds one.
+        const firstWithSeparator = text.split(/\r?\n/).find((line) => /[,;\t]/.test(line)) ?? '';
+        const separator = separatorOf(firstWithSeparator);
+        return { file: index + 1, separator, rows: parseCsv(text, separator) };
+    });
+    const violations = [];
+    const accounts = new Map();
+    const contacts = new Map();
+    const reports = [];
+    for (const sheet of sheets) {
+        const headerAt = sheet.rows.findIndex((r) => isReportHeader(r.fields.map(headerKey)));
+        if (headerAt !== -1) {
+            reports.push({ sheet, headerAt });
+            continue;
+        }
+        const header = sheet.rows[0];
+        if (header === undefined)
+            throw new BooksFileError('empty_file', `file ${sheet.file} is empty`);
+        const keys = header.fields.map(headerKey);
+        if (has(keys, CHART_COLUMNS.code) && has(keys, CHART_COLUMNS.type)) {
+            const at = locate(keys, CHART_COLUMNS);
+            for (const { fields } of sheet.rows.slice(1)) {
+                const code = (fields[at.code] ?? '').trim();
+                if (code === '')
+                    continue;
+                const name = at.name === undefined ? '' : (fields[at.name] ?? '').trim();
+                const type = at.type === undefined ? '' : (fields[at.type] ?? '').trim();
+                accounts.set(code, { code, name: name === '' ? null : name, type: type === '' ? null : type });
+            }
+        }
+        else if (has(keys, CONTACT_COLUMNS.name)) {
+            const at = locate(keys, CONTACT_COLUMNS);
+            for (const { fields } of sheet.rows.slice(1)) {
+                const cell = (column) => {
+                    const index = at[column];
+                    return index === undefined ? '' : (fields[index] ?? '').trim();
+                };
+                const name = cell('name');
+                if (name === '')
+                    continue;
+                const country = cell('country').toUpperCase();
+                contacts.set(name, {
+                    code: name,
+                    name,
+                    vatNumber: cell('tax') === '' ? null : cell('tax'),
+                    registrationNumber: cell('company') === '' ? null : cell('company'),
+                    email: cell('email') === '' ? null : cell('email'),
+                    country: /^[A-Z]{2}$/.test(country) ? country : null,
+                });
+            }
+        }
+        else {
+            throw new BooksFileError('missing_column', `file ${sheet.file} is neither a report (a header with Date, Account Code, Debit and Credit), a chart of accounts (Code, Type) nor contacts (ContactName)`);
+        }
+    }
+    if (reports.length === 0) {
+        throw new BooksFileError('missing_column', 'no file is a report: one needs a header row with Date, Account Code, Debit and Credit');
+    }
+    const entries = new Map();
+    for (const { sheet, headerAt } of reports) {
+        const header = sheet.rows[headerAt];
+        const at = locate(header.fields.map(headerKey), REPORT_COLUMNS);
+        if (at.journal === undefined) {
+            throw new BooksFileError('missing_column', `the report in file ${sheet.file} carries no journal number, and without it its lines cannot be put back into entries. Add the Journal ID column to the report before exporting it`, header.row);
+        }
+        for (const { row, fields } of sheet.rows.slice(headerAt + 1)) {
+            const cell = (column) => {
+                const index = at[column];
+                return index === undefined ? '' : (fields[index] ?? '').trim();
+            };
+            const date = readDate(cell('date'), options.dateOrder, row);
+            if (date === null)
+                continue; // a heading, a total, a balance: not a line
+            const journal = cell('journal');
+            const account = cell('accountCode');
+            if (journal === '' || account === '') {
+                violations.push({ rule: 'required', message: 'a dated line names no journal number or no account code and was left out', row });
+                continue;
+            }
+            let debit = amount(cell('debit'), sheet.separator, row);
+            let credit = amount(cell('credit'), sheet.separator, row);
+            if (debit !== 0n && credit !== 0n)
+                violations.push({ rule: 'one_side', message: 'a line carries both a debit and a credit', row });
+            if (debit < 0n) {
+                credit -= debit;
+                debit = 0n;
+            }
+            if (credit < 0n) {
+                debit -= credit;
+                credit = 0n;
+            }
+            if (!accounts.has(account)) {
+                const name = cell('account');
+                accounts.set(account, { code: account, name: name === '' ? null : name, type: null });
+            }
+            const contact = cell('contact');
+            if (contact !== '' && !contacts.has(contact)) {
+                contacts.set(contact, { code: contact, name: contact, vatNumber: null, registrationNumber: null, email: null, country: null });
+            }
+            const label = cell('description');
+            const line = {
+                account,
+                contact: contact === '' ? null : contact,
+                label: label === '' ? null : label,
+                debit: formatDecimal(debit),
+                credit: formatDecimal(credit),
+                currency: null,
+                amountCurrency: null,
+                dueDate: null,
+                matching: null,
+            };
+            let entry = entries.get(journal);
+            if (entry === undefined) {
+                const source = cell('source');
+                const reference = cell('reference');
+                const narration = cell('narration');
+                entry = {
+                    journal: source === '' ? null : source,
+                    journalName: source === '' ? null : source,
+                    number: journal,
+                    date,
+                    reference: reference === '' ? null : reference,
+                    description: narration !== '' ? narration : line.label,
+                    lines: [],
+                    row,
+                    debits: 0n,
+                    credits: 0n,
+                };
+                entries.set(journal, entry);
+            }
+            else if (entry.date !== date) {
+                violations.push({ rule: 'one_date', message: `journal ${journal} is dated ${entry.date} on its first line and ${date} here`, row });
+            }
+            entry.lines.push(line);
+            entry.debits += debit;
+            entry.credits += credit;
+        }
+    }
+    const read = [];
+    for (const { debits, credits, ...entry } of entries.values()) {
+        if (debits !== credits) {
+            violations.push({
+                rule: 'balance',
+                message: `journal ${entry.number} has debit ${formatDecimal(debits)} and credit ${formatDecimal(credits)}`,
+                row: entry.row,
+            });
+        }
+        read.push(entry);
+    }
+    if (read.length === 0)
+        throw new BooksFileError('empty_file', 'the report holds no dated line');
+    return {
+        format: 'journal-report',
+        // A report prints amounts in the currency of the organisation and does not say which.
+        currency: null,
+        accounts: [...accounts.values()],
+        contacts: [...contacts.values()],
+        entries: read,
+        opening: [],
+        violations,
+    };
+}
+const MONTHS = ['jan', 'feb', 'mar', 'apr', 'may', 'jun', 'jul', 'aug', 'sep', 'oct', 'nov', 'dec'];
+/**
+ * A date, or null for a cell that is not one — which is how a heading or a
+ * total row is told from a line. A cell that looks like a date and is not a
+ * day of the calendar is refused, never passed over.
+ */
+export function readDate(value, order, row) {
+    let y;
+    let m;
+    let d;
+    let match;
+    if ((match = /^(\d{4})-(\d{2})-(\d{2})(?:[ T].*)?$/.exec(value)) !== null) {
+        [y, m, d] = [Number(match[1]), Number(match[2]), Number(match[3])];
+    }
+    else if ((match = /^(\d{1,2})[ -]([A-Za-z]{3,9})[ -](\d{4})$/.exec(value)) !== null) {
+        const month = MONTHS.indexOf(match[2].slice(0, 3).toLowerCase());
+        if (month === -1)
+            return null;
+        [y, m, d] = [Number(match[3]), month + 1, Number(match[1])];
+    }
+    else if ((match = /^([A-Za-z]{3,9}) (\d{1,2}),? (\d{4})$/.exec(value)) !== null) {
+        const month = MONTHS.indexOf(match[1].slice(0, 3).toLowerCase());
+        if (month === -1)
+            return null;
+        [y, m, d] = [Number(match[3]), month + 1, Number(match[2])];
+    }
+    else if ((match = /^(\d{1,4})[/.-](\d{1,2})[/.-](\d{1,4})$/.exec(value)) !== null) {
+        if (order === undefined) {
+            throw new BooksFileError('invalid_value', `"${value}" is a date written in digits, and nothing in the file says in which order; name it (dateOrder: 'dmy', 'mdy' or 'ymd')`, row);
+        }
+        const [a, b, c] = [Number(match[1]), Number(match[2]), Number(match[3])];
+        [y, m, d] = order === 'dmy' ? [c, b, a] : order === 'mdy' ? [c, a, b] : [a, b, c];
+        if (y < 100)
+            y += 2000;
+    }
+    else {
+        return null;
+    }
+    const iso = `${String(y).padStart(4, '0')}-${String(m).padStart(2, '0')}-${String(d).padStart(2, '0')}`;
+    const parsed = new Date(`${iso}T00:00:00Z`);
+    if (Number.isNaN(parsed.getTime()) || parsed.toISOString().slice(0, 10) !== iso) {
+        throw new BooksFileError('invalid_value', `"${value}" is not a date of the calendar`, row);
+    }
+    return iso;
+}
+/**
+ * An amount as a spreadsheet displays it once saved as CSV. In a file
+ * separated by commas the decimal mark is a point and a comma can only group
+ * thousands, three digits at a time (`1,234.50`). In a file separated by a
+ * semicolon or a tab the decimal mark is whichever of the two the number
+ * carries once, and thousands may only be grouped by a space. A negative is a
+ * minus or brackets. Anything else is refused.
+ */
+export function amount(raw, separator, row) {
+    let value = raw.replace(/[  ]/g, ' ').trim();
+    if (value === '')
+        return 0n;
+    let negative = false;
+    if (value.startsWith('(') && value.endsWith(')')) {
+        negative = true;
+        value = value.slice(1, -1).trim();
+    }
+    if (value.startsWith('-')) {
+        negative = !negative;
+        value = value.slice(1).trim();
+    }
+    let normalised = null;
+    if (separator === ',') {
+        if (/^\d{1,3}(,\d{3})+(\.\d+)?$/.test(value) || /^\d+(\.\d+)?$/.test(value))
+            normalised = value.replace(/,/g, '');
+    }
+    else {
+        const grouped = value.replace(/ (?=\d{3}(\D|$))/g, '');
+        if (/^\d+([.,]\d+)?$/.test(grouped))
+            normalised = grouped.replace(',', '.');
+    }
+    if (normalised === null) {
+        throw new BooksFileError('invalid_value', `"${raw}" is not an amount this reader accepts`, row);
+    }
+    const [whole, fraction = ''] = normalised.split('.');
+    if (fraction.length > 6)
+        throw new BooksFileError('invalid_value', `"${raw}" has more than six decimals`, row);
+    const units = BigInt(whole) * 1000000n + BigInt(fraction.padEnd(6, '0') || '0');
+    return negative ? -units : units;
+}
+//# 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,96 @@
+/**
+ * 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: `journal-report` 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. Default `utf-8`, fatally: bytes that are not UTF-8
+     * are refused by name, never read as something else. A spreadsheet that
+     * saves in Latin-1 is said to be so, because every sequence of bytes is
+     * valid Latin-1 and a guess would always succeed.
+     */
+    encoding?: Encoding;
+    /** Refused beyond this many bytes, before anything is read. Default 64 MiB. */
+    maxBytes?: 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,2CAA2C;IAC3C,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,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

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/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@ekwo-ai/journal-report",
+  "version": "0.6.0",
+  "description": "Reads a journal report or a general ledger detail saved as CSV — date, journal number, account code, debit, credit — with the chart of accounts and the contacts exported beside it, into plain objects in TypeScript: amounts as decimal strings, and what does not add up. Zero dependencies.",
+  "keywords": [
+    "journal-report",
+    "general-ledger",
+    "csv",
+    "accounting",
+    "bookkeeping",
+    "migration",
+    "import",
+    "parser"
+  ],
+  "license": "MIT",
+  "author": "Ekwo AI",
+  "homepage": "https://github.com/Ekwo-ai/ekwo-os/tree/main/packages/formats/journal-report#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ekwo-ai/ekwo-os.git",
+    "directory": "packages/formats/journal-report"
+  },
+  "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"
+  }
+}