@ekwo-ai/transaction-journal 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,96 @@
+# `@ekwo-ai/transaction-journal`
+
+Reads a **transaction journal** saved as CSV — the report a ledger prints of
+every transaction it posted, one after the other, each line of a transaction
+on a row of its own — into plain objects, in TypeScript, with no
+dependencies. Beside it, the list of accounts, exported the same way.
+
+```ts
+import { readTransactionJournal } from '@ekwo-ai/transaction-journal';
+
+const books = readTransactionJournal([journal, accountList], { dateOrder: 'mdy' });
+
+books.entries;    // [{ journal: 'Invoice', number: '1001', date: '2025-01-15', lines: […] }, …]
+books.accounts;   // [{ code: '1200', name: 'Accounts Receivable (A/R)', type: 'Accounts receivable (A/R)' }, …]
+books.violations; // a transaction that does not balance, a line that belongs to none
+```
+
+## The files
+
+**The journal** (required). Such a ledger exports its reports as a
+spreadsheet, not as CSV: open it and save it as CSV. A report is laid out for a
+person, and nothing on a line names the transaction it belongs to, so it is
+read in order:
+
+- the **header** is the first row that names a `Date`, an `Account` (or an
+  `Account #`), a `Debit` and a `Credit` — the title rows above it are passed
+  over, and so is an empty first column;
+- a row with an account and a **date starts** a transaction — unless it
+  repeats the date, the `Transaction Type` and the `Num` of the transaction
+  just before it, which a layout that prints them on every line does;
+- a row with an account and **no date continues** the transaction above;
+- a row with **no account ends** it: the total of a transaction, a blank row,
+  the total of the report, the footer.
+
+Optional columns: `Transaction Type` (kept as the journal of the entry), `Num`
+(its number and reference), `Name` — or `Customer full name`, `Vendor`,
+`Supplier`, `Employee` where the report shows those instead — and
+`Memo/Description`.
+
+- An **account** is identified by its number, `Account #`, where the report
+  has the column — tick it among the report's columns before exporting — and
+  otherwise by the name the list of accounts gives a number to, or by its
+  name alone.
+- 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 company, and the file does not say it.
+  A date in ISO or with its month in letters (`Jan 15, 2025`) 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. A currency symbol, or anything else,
+  is refused.
+
+**The list of accounts** (optional): `Account` (or `Full name`), `Type`, and
+`Account #` where it has one; the rest is ignored. The type is kept in the
+list's words.
+
+## 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 company's and
+does not name it, and no amount in another currency is read. Amounts are decimal strings, never negative. What does not add up comes back in
+`violations`; what is not a journal 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 transaction-journal <files…> --date-order mdy`.
+
+## Sources
+
+This reader was written against the **Journal** report of **QuickBooks
+Online**, read on 24 September 2026 from its help centre:
+
+- [Print a journal entry report](https://quickbooks.intuit.com/learn-support/en-us/help-article/journal-entries/print-journal-entry-report/L1IhAG8PT_US_en_US):
+  the Journal report, its filter by transaction type, and its columns — `Name`,
+  or `Customer full name`, `Employee`, `Vendor` in its place;
+- [Customize reports](https://quickbooks.intuit.com/learn-support/en-us/help-article/customize-reports/customize-reports-quickbooks-online/L0gKmSawG_US_en_US)
+  and [Export reports to Excel](https://quickbooks.intuit.com/learn-support/en-us/help-article/report-management/export-reports-excel-quickbooks-online/L7iAoP97n_US_en_US):
+  the columns a report shows, its number format, and its export — to Excel or
+  PDF, not to CSV;
+- [Export your QuickBooks Online data](https://quickbooks.intuit.com/learn-support/en-us/help-article/list-management/export-reports-lists-data-quickbooks-online/L1xleDrLp_US_en_US):
+  the Account List, the chart of accounts, exported to Excel the same way.
+
+`ekwo import quickbooks-online <files…>` is the same as
+`ekwo import transaction-journal`.
+
+What those pages do not state — the exact text of the title and total rows,
+whether a line repeats the date of its transaction — is why the reader finds
+the header by its columns, and a transaction by the order of its rows under
+either layout, 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,80 @@
+/**
+ * A transaction journal saved as CSV: the report a ledger prints of every
+ * transaction it posted, one after the other, each line of a transaction on a
+ * row of its own. Such a ledger 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 list of accounts, exported and saved the same way.
+ *
+ * What sets this report apart from a journal report that numbers its journals
+ * is that **nothing on a line names the transaction it belongs to**: a
+ * transaction is the rows that follow each other under one date, one type and
+ * one number. So the report is read in order:
+ *
+ * - a row with an account and a date **starts** a transaction — unless it
+ *   repeats the date, the type and the number of the transaction just before,
+ *   which some layouts print on every line;
+ * - a row with an account and no date **continues** the transaction above it;
+ * - a row with no account — the total of a transaction, a blank row, the total
+ *   of the report, a footer — **ends** it.
+ *
+ * The header is the first row that names a date, an account, a debit and a
+ * credit; the title rows above it are passed over. Columns are found by their
+ * names, never by their position.
+ *
+ * A date written in 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 company, and the
+ * file does not say it.
+ *
+ * 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 TransactionJournalOptions 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 JOURNAL_COLUMNS: {
+    readonly date: readonly ["date", "transaction date"];
+    readonly type: readonly ["transaction type", "type"];
+    readonly number: readonly ["num", "no.", "no", "number", "ref no."];
+    readonly name: readonly ["name"];
+    readonly customer: readonly ["customer full name", "customer"];
+    readonly vendor: readonly ["vendor", "supplier"];
+    readonly employee: readonly ["employee"];
+    readonly memo: readonly ["memo/description", "memo", "description"];
+    readonly accountNumber: readonly ["account #", "account number", "account no."];
+    readonly account: readonly ["account", "account full name", "account name"];
+    readonly debit: readonly ["debit"];
+    readonly credit: readonly ["credit"];
+};
+/** The columns of the list of accounts. */
+export declare const ACCOUNT_LIST_COLUMNS: {
+    readonly account: readonly ["account", "full name", "account full name", "account name", "name"];
+    readonly number: readonly ["account #", "account number", "number"];
+    readonly type: readonly ["type", "account type"];
+};
+/**
+ * Reads the files — the journal, and optionally the list of accounts — in any
+ * order, each recognised by its header.
+ */
+export declare function readTransactionJournal(inputs: readonly (string | Uint8Array)[], options?: TransactionJournalOptions): ImportedBooks;
+/**
+ * A date, or null for a cell that is not one. 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 — a currency symbol included — 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;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,yBAA0B,SAAQ,WAAW;IAC5D,2GAA2G;IAC3G,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,oEAAoE;AACpE,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAalB,CAAC;AAEX,2CAA2C;AAC3C,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAwCX;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,UAAU,CAAC,EAAE,EAAE,OAAO,GAAE,yBAA8B,GAAG,aAAa,CAoKvI;AAID;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoChG;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,325 @@
+/**
+ * A transaction journal saved as CSV: the report a ledger prints of every
+ * transaction it posted, one after the other, each line of a transaction on a
+ * row of its own. Such a ledger 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 list of accounts, exported and saved the same way.
+ *
+ * What sets this report apart from a journal report that numbers its journals
+ * is that **nothing on a line names the transaction it belongs to**: a
+ * transaction is the rows that follow each other under one date, one type and
+ * one number. So the report is read in order:
+ *
+ * - a row with an account and a date **starts** a transaction — unless it
+ *   repeats the date, the type and the number of the transaction just before,
+ *   which some layouts print on every line;
+ * - a row with an account and no date **continues** the transaction above it;
+ * - a row with no account — the total of a transaction, a blank row, the total
+ *   of the report, a footer — **ends** it.
+ *
+ * The header is the first row that names a date, an account, a debit and a
+ * credit; the title rows above it are passed over. Columns are found by their
+ * names, never by their position.
+ *
+ * A date written in 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 company, and the
+ * file does not say it.
+ *
+ * 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 JOURNAL_COLUMNS = {
+    date: ['date', 'transaction date'],
+    type: ['transaction type', 'type'],
+    number: ['num', 'no.', 'no', 'number', 'ref no.'],
+    name: ['name'],
+    customer: ['customer full name', 'customer'],
+    vendor: ['vendor', 'supplier'],
+    employee: ['employee'],
+    memo: ['memo/description', 'memo', 'description'],
+    accountNumber: ['account #', 'account number', 'account no.'],
+    account: ['account', 'account full name', 'account name'],
+    debit: ['debit'],
+    credit: ['credit'],
+};
+/** The columns of the list of accounts. */
+export const ACCOUNT_LIST_COLUMNS = {
+    account: ['account', 'full name', 'account full name', 'account name', 'name'],
+    number: ['account #', 'account number', 'number'],
+    type: ['type', 'account type'],
+};
+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 isJournalHeader(keys) {
+    return (has(keys, JOURNAL_COLUMNS.date) &&
+        (has(keys, JOURNAL_COLUMNS.account) || has(keys, JOURNAL_COLUMNS.accountNumber)) &&
+        has(keys, JOURNAL_COLUMNS.debit) &&
+        has(keys, JOURNAL_COLUMNS.credit));
+}
+function isAccountListHeader(keys) {
+    return has(keys, ACCOUNT_LIST_COLUMNS.account) && has(keys, ACCOUNT_LIST_COLUMNS.type) && !has(keys, JOURNAL_COLUMNS.debit);
+}
+/**
+ * Reads the files — the journal, and optionally the list of accounts — in any
+ * order, each recognised by its header.
+ */
+export function readTransactionJournal(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, or one
+        // inside quotes only ("January 1-31, 2025"), so the separator is read from
+        // the first line that holds one outside quotes.
+        const firstWithSeparator = text.split(/\r?\n/).find((line) => /[,;\t]/.test(line.replace(/"[^"]*"/g, ''))) ?? '';
+        const separator = separatorOf(firstWithSeparator);
+        return { file: index + 1, separator, rows: parseCsv(text, separator) };
+    });
+    const violations = [];
+    const accounts = new Map();
+    const contacts = new Map();
+    /** The list of accounts, by the name a line displays: its number where the list gives one, and its type. */
+    const listed = new Map();
+    const journals = [];
+    for (const sheet of sheets) {
+        if (sheet.rows.length === 0)
+            throw new BooksFileError('empty_file', `file ${sheet.file} is empty`);
+        const journalAt = sheet.rows.findIndex((r) => isJournalHeader(r.fields.map(headerKey)));
+        if (journalAt !== -1) {
+            journals.push({ sheet, headerAt: journalAt });
+            continue;
+        }
+        const listAt = sheet.rows.findIndex((r) => isAccountListHeader(r.fields.map(headerKey)));
+        if (listAt === -1) {
+            throw new BooksFileError('missing_column', `file ${sheet.file} is neither a journal (a header with Date, Account, Debit and Credit) nor a list of accounts (Account, Type)`);
+        }
+        const at = locate(sheet.rows[listAt].fields.map(headerKey), ACCOUNT_LIST_COLUMNS);
+        for (const { fields } of sheet.rows.slice(listAt + 1)) {
+            const cell = (column) => {
+                const index = at[column];
+                return index === undefined ? '' : (fields[index] ?? '').trim();
+            };
+            const name = cell('account');
+            const type = cell('type');
+            // A row with a name and no type is a heading or a footer of the list.
+            if (name === '' || type === '')
+                continue;
+            listed.set(name, { number: cell('number') === '' ? null : cell('number'), type });
+        }
+    }
+    if (journals.length === 0) {
+        throw new BooksFileError('missing_column', 'no file is a journal: one needs a header row with Date, Account, Debit and Credit');
+    }
+    const entries = [];
+    for (const { sheet, headerAt } of journals) {
+        const header = sheet.rows[headerAt];
+        const at = locate(header.fields.map(headerKey), JOURNAL_COLUMNS);
+        let open = null;
+        for (const { row, fields } of sheet.rows.slice(headerAt + 1)) {
+            const cell = (column) => {
+                const index = at[column];
+                return index === undefined ? '' : (fields[index] ?? '').trim();
+            };
+            const accountName = cell('account');
+            const accountNumber = cell('accountNumber');
+            if (accountName === '' && accountNumber === '') {
+                // A total, a blank row, the total of the report, a footer: the
+                // transaction above is over.
+                open = null;
+                continue;
+            }
+            const date = readDate(cell('date'), options.dateOrder, row);
+            if (date === null && cell('date') !== '') {
+                violations.push({ rule: 'required', message: `"${cell('date')}" stands where the date of a line is, and the line was left out`, row });
+                continue;
+            }
+            const type = cell('type');
+            const number = cell('number');
+            if (date !== null) {
+                const key = `${date}\u0000${type}\u0000${number}`;
+                if (open === null || open.key !== key) {
+                    const memo = cell('memo');
+                    const entry = {
+                        journal: type === '' ? null : type,
+                        journalName: type === '' ? null : type,
+                        number: number === '' ? null : number,
+                        date,
+                        reference: number === '' ? null : number,
+                        description: memo === '' ? null : memo,
+                        lines: [],
+                        row,
+                        debits: 0n,
+                        credits: 0n,
+                    };
+                    entries.push(entry);
+                    open = { key, entry };
+                }
+            }
+            else if (open === null) {
+                violations.push({ rule: 'no_transaction', message: 'a line with no date follows no dated line of the same transaction, and was left out', row });
+                continue;
+            }
+            const entry = open.entry;
+            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;
+            }
+            const onList = listed.get(accountName);
+            const code = accountNumber !== '' ? accountNumber : (onList?.number ?? accountName);
+            if (!accounts.has(code)) {
+                accounts.set(code, { code, name: accountName === '' ? null : accountName, type: onList?.type ?? null });
+            }
+            const party = [cell('name'), cell('customer'), cell('vendor'), cell('employee')].find((value) => value !== '') ?? '';
+            if (party !== '' && !contacts.has(party)) {
+                contacts.set(party, { code: party, name: party, vatNumber: null, registrationNumber: null, email: null, country: null });
+            }
+            const label = cell('memo');
+            const line = {
+                account: code,
+                contact: party === '' ? null : party,
+                label: label === '' ? null : label,
+                debit: formatDecimal(debit),
+                credit: formatDecimal(credit),
+                currency: null,
+                amountCurrency: null,
+                dueDate: null,
+                matching: null,
+            };
+            entry.lines.push(line);
+            entry.debits += debit;
+            entry.credits += credit;
+        }
+    }
+    const read = [];
+    for (const { debits, credits, ...entry } of entries) {
+        if (debits !== credits) {
+            const name = [entry.journal, entry.number].filter((part) => part !== null).join(' ') || 'a transaction';
+            violations.push({
+                rule: 'balance',
+                message: `${name} of ${entry.date} has debit ${formatDecimal(debits)} and credit ${formatDecimal(credits)}`,
+                row: entry.row,
+            });
+        }
+        read.push(entry);
+    }
+    if (read.length === 0)
+        throw new BooksFileError('empty_file', 'the journal holds no dated line');
+    return {
+        format: 'transaction-journal',
+        // A report prints amounts in the currency of the company 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. 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 (value === '')
+        return null;
+    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 — a currency symbol included — 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: `transaction-journal` 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 256 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,gDAAgD;IAChD,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;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,55 @@
+{
+  "name": "@ekwo-ai/transaction-journal",
+  "version": "0.9.0",
+  "description": "Reads a transaction journal saved as CSV — each transaction a run of rows under one date, type and number, closed by its total — with the list of accounts exported beside it, into plain objects in TypeScript: amounts as decimal strings, and what does not add up. Zero dependencies.",
+  "keywords": [
+    "transaction-journal",
+    "journal",
+    "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/transaction-journal#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ekwo-ai/ekwo-os.git",
+    "directory": "packages/formats/transaction-journal"
+  },
+  "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"
+  }
+}