@ekwo-ai/coda 0.4.0

package/dist/records.js

@@ -0,0 +1,91 @@
+import { StatementFileError } from './errors.js';
+const BYTE_ORDER_MARK = 0xfeff;
+const END_OF_FILE_MARK = 0x1a;
+const REPLACEMENT = 0xfffd;
+/** A control character other than the two that end a line, or the replacement character. */
+function unreadable(code) {
+    if (code === 0x0a || code === 0x0d)
+        return false;
+    return code < 0x20 || (code >= 0x7f && code <= 0x9f) || code === REPLACEMENT;
+}
+/**
+ * Bytes to text, fatally: a byte that is not the encoding announced is an
+ * error and not a replacement character in somebody's name. ISO-8859-1 maps
+ * every byte, so it is never guessed — the caller says so, or the bytes are
+ * UTF-8 (of which ASCII, which is what the standard writes, is a subset).
+ */
+export function decode(input, encoding, maxBytes) {
+    let text;
+    if (typeof input === 'string') {
+        if (input.length > maxBytes) {
+            throw new StatementFileError('too_large', `the file is longer than ${maxBytes} bytes`);
+        }
+        text = input;
+    }
+    else {
+        if (input.byteLength > maxBytes) {
+            throw new StatementFileError('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 StatementFileError('unsupported_encoding', "the bytes are not UTF-8; if the bank writes ISO-8859-1, say so with { encoding: 'iso-8859-1' } — it is not guessed, because every sequence of bytes is valid ISO-8859-1");
+            }
+        }
+    }
+    if (text.charCodeAt(0) === BYTE_ORDER_MARK)
+        text = text.slice(1);
+    // The DOS end-of-file mark some transfers leave behind.
+    let end = text.length;
+    while (end > 0 && text.charCodeAt(end - 1) === END_OF_FILE_MARK)
+        end -= 1;
+    text = text.slice(0, end);
+    for (let i = 0; i < text.length; i += 1) {
+        const code = text.charCodeAt(i);
+        if (unreadable(code)) {
+            throw new StatementFileError('unsupported_encoding', `the file holds the character U+${code.toString(16).toUpperCase().padStart(4, '0')} at offset ${i}: a control or replacement character, which is a file decoded with the wrong encoding, or not a text file`);
+        }
+    }
+    return text;
+}
+/**
+ * The records of the file: its lines, or — when the file has no line break at
+ * all, as some transfers deliver it — consecutive slices of the record length.
+ * Every record is exactly `length` characters, or the file is refused: nothing
+ * is padded and nothing is trimmed, because the last position of a record
+ * means something.
+ */
+export function splitRecords(text, length) {
+    let records;
+    if (!/[\r\n]/.test(text) && text.length > length) {
+        if (text.length % length !== 0) {
+            throw new StatementFileError('invalid_record_length', `the file has no line break and its ${text.length} characters are not a whole number of ${length}-character records`);
+        }
+        records = [];
+        for (let i = 0; i < text.length; i += length)
+            records.push(text.slice(i, i + length));
+    }
+    else {
+        records = text.split(/\r\n|\n|\r/);
+        while (records.length > 0 && records[records.length - 1] === '')
+            records.pop();
+    }
+    if (records.length === 0)
+        throw new StatementFileError('empty_file', 'the file holds no record');
+    records.forEach((record, index) => {
+        if (record.length !== length) {
+            throw new StatementFileError('invalid_record_length', `${record.length} characters where the format has ${length}`, index + 1);
+        }
+    });
+    return records;
+}
+//# sourceMappingURL=records.js.map

package/dist/records.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,254 @@
+/**
+ * What a statement is once it has been read: an account, two balances and
+ * lines. The shape is declared here and imported from nowhere — it names no
+ * table and no ledger. It is, field for field, the shape `@ekwo-ai/camt053`
+ * declares for itself, so whatever takes one takes the other; what only CODA
+ * says comes after, under names of its own.
+ *
+ * Every amount is a **decimal string**, signed from the account holder's side:
+ * money in is positive, money out is negative, an overdrawn balance is
+ * negative. No figure of a statement passes through a `number`.
+ */
+/**
+ * How an account is identified, which the file says itself (record 1,
+ * position 2): an IBAN, or a domestic number that is not one.
+ */
+export type AccountIdentifier = {
+    kind: 'iban';
+    /** As written, without spaces, upper case. */
+    value: string;
+} | {
+    kind: 'other';
+    /** As written, without spaces. */
+    value: string;
+    /** `BBAN` when the file says the number is a domestic one; null for a counterparty's, which says nothing. */
+    scheme: string | null;
+    issuer: string | null;
+};
+export interface StatementAccount {
+    identifier: AccountIdentifier;
+    /** The ISO currency code of the account zone. Null when the zone leaves it blank. */
+    currency: string | null;
+    /** Record 1, "account description". */
+    name: string | null;
+    /** Record 1, "name of the account holder". */
+    ownerName: string | null;
+    /** Record 0, "BIC of the bank holding the account". */
+    servicerBic: string | null;
+}
+export interface StatementBalance {
+    /** `OPBD` for the old balance (record 1), `CLBD` for the new one (record 8). */
+    type: string;
+    /** Signed: a debit balance is negative. */
+    amount: string;
+    /** The currency of the account zone; null when the file leaves it blank. */
+    currency: string | null;
+    /** `YYYY-MM-DD`. */
+    date: string | null;
+}
+export interface StructuredReference {
+    /** Twelve digits for a Belgian structured communication, `RF…` for an ISO 11649 one — bare, as a camt.053 carries it. */
+    reference: string;
+    /** `SCOR`. */
+    type: string | null;
+    /** `BBA` for communication types 101 and 102, `ISO` for type 100. */
+    issuer: string | null;
+}
+export interface Remittance {
+    /** The free communication, the pieces of records 2.1, 2.2 and 2.3 put back together. */
+    unstructured: string[];
+    structured: StructuredReference[];
+}
+export interface Counterparty {
+    name: string | null;
+    account: AccountIdentifier | null;
+    /** Record 2.2, "BIC of the counterparty's bank". */
+    agentBic: string | null;
+    /** Information record of type 008 (money out) or 009 (money in). */
+    ultimateName: string | null;
+}
+export interface BankTransactionCode {
+    /** Always null: CODA has its own code list, not the ISO 20022 one. */
+    domain: string | null;
+    family: string | null;
+    subFamily: string | null;
+    /** The eight digits of the transaction code, as written. */
+    proprietary: string | null;
+    /** `CODA`. */
+    proprietaryIssuer: string | null;
+}
+/** The eight positions of a CODA transaction code, apart. */
+export interface CodaTransactionCode {
+    /** 0 simple, 1 and 2 totals, 3 simple with detail, 5 to 9 details. */
+    type: string;
+    family: string;
+    transaction: string;
+    category: string;
+}
+export interface StatementLine {
+    /** Position among the statement's lines, from 1. */
+    index: number;
+    /** Which movement of the statement this line comes from, from 1: one per continuous sequence number. */
+    entry: number;
+    /**
+     * When the movement was a total split into its details: which one this is,
+     * from 1, and out of how many. Both null when the line is the whole movement.
+     */
+    detail: number | null;
+    detailCount: number | null;
+    /** `BOOK`: a coded statement carries booked movements and nothing else. */
+    status: string;
+    booked: boolean;
+    /** Transaction 49 or 99 of its family: a correction or cancellation entry. */
+    reversal: boolean;
+    /** Record 2.1, "entry date". */
+    bookingDate: string | null;
+    /** Record 2.1, "value date"; null when the bank writes 000000. */
+    valueDate: string | null;
+    /** Signed: positive is money in. Null when the file's figure is unreadable. */
+    amount: string | null;
+    currency: string | null;
+    /** Signed amount of the whole movement when this line is one part of it. */
+    entryAmount: string | null;
+    /**
+     * Record 2.1, "reference number of the bank" — which the standard calls
+     * purely informative, and which a bank may change without notice. Null when
+     * blank or all zeros.
+     */
+    bankReference: string | null;
+    /** Always null: CODA numbers a movement by its position, which is `sequenceNumber`. */
+    entryReference: string | null;
+    /** Record 2.2, "customer reference", on a simple movement or a detail. */
+    endToEndId: string | null;
+    transactionId: string | null;
+    instructionId: string | null;
+    /** Record 2.2, "customer reference", on a total (types 1 and 2). */
+    paymentInformationId: string | null;
+    /** The mandate reference of a structured communication of type 127. */
+    mandateId: string | null;
+    counterparty: Counterparty | null;
+    remittance: Remittance;
+    bankTransactionCode: BankTransactionCode | null;
+    /** Record 2.2, "ISO reason return code", else the reason of a type 127 communication. */
+    returnReason: string | null;
+    /** Always null: a CODA reports in the currency of the account. */
+    instructedAmount: {
+        amount: string;
+        currency: string;
+    } | null;
+    exchangeRate: string | null;
+    /** The free text of the information records (3) of the movement, joined. */
+    additionalInformation: string | null;
+    /** "Continuous sequence number", as written. */
+    sequenceNumber: string;
+    /** "Detail number", as written: `0000` for the movement itself. */
+    detailNumber: string;
+    transactionCode: CodaTransactionCode | null;
+    /** Position 125 of record 2.1, as written; `0` when the record opens or closes no globalisation. */
+    globalisationCode: string;
+    /** A structured communication, as written, whether or not this reader decodes its type. */
+    structuredCommunication: {
+        type: string;
+        text: string;
+    } | null;
+    /** Record 2.2: 1 reject, 2 return, 3 refund, 4 reversal, 5 cancellation. */
+    rTransactionType: string | null;
+    categoryPurpose: string | null;
+    purpose: string | null;
+    /** Every information record (3) of the movement: its communication type, or null when free, and its text. */
+    information: {
+        type: string | null;
+        text: string;
+    }[];
+}
+export interface Statement {
+    /**
+     * CODA gives a statement no identifier. This one is made of what it does
+     * give: the year of the creation date and the sequence number of the coded
+     * statement, `2026-042`. The same file always makes the same one.
+     */
+    id: string;
+    /** Record 1, "sequence number of the coded statement of account": restarts at 001 each year. */
+    electronicSequenceNumber: string | null;
+    /**
+     * Always null. The number of the paper statement is in `paperSequenceNumber`:
+     * the standard lets a bank write a Julian date or zeros there, so it is not
+     * offered as a number whose holes mean a missing statement.
+     */
+    legalSequenceNumber: string | null;
+    /** Record 0, "creation date", by day. */
+    createdAt: string | null;
+    /** Always null: the dates of the two balances are what CODA gives. */
+    period: {
+        from: string | null;
+        to: string | null;
+    } | null;
+    page: {
+        number: string;
+        last: boolean;
+    } | null;
+    account: StatementAccount;
+    openingBalance: StatementBalance | null;
+    closingBalance: StatementBalance | null;
+    balances: StatementBalance[];
+    lines: StatementLine[];
+    /**
+     * Old balance plus the movements equals new balance: true, false, or null
+     * when it could not be checked. False is reported as `balance_mismatch` and
+     * **never corrected**.
+     */
+    balanced: boolean | null;
+    paperSequenceNumber: string | null;
+    /** Record 0, position 17: the bank says this file is a duplicate of one it already sent. */
+    duplicate: boolean;
+    /** Record 0, "file reference as determined by the bank". */
+    fileReference: string | null;
+    /** Record 0, "name addressee". */
+    addressee: string | null;
+    /** Record 0, "identification number of the account holder", as written. */
+    holderIdentification: string | null;
+    /** Record 0, code "separate application": `00000` is every movement of the account. */
+    separateApplication: string;
+    /** The free communications (record 4), one text per communication. */
+    freeCommunications: string[];
+}
+export interface Violation {
+    /** A stable token, for a caller that branches on it. */
+    code: ViolationCode;
+    /** What is wrong, in a sentence. */
+    message: string;
+    /** Which statement of the file, from 1. */
+    statement: number;
+    /** Which line of that statement (`StatementLine.index`), where there is one. */
+    line?: number;
+}
+export type ViolationCode = 'balance_mismatch' | 'closing_balance_missing' | 'currency_missing' | 'record_count_mismatch' | 'debit_total_mismatch' | 'credit_total_mismatch' | 'separate_application' | 'invalid_amount' | 'invalid_direction' | 'invalid_date' | 'booking_date_missing' | 'invalid_iban' | 'invalid_structured_reference' | 'batch_not_split';
+export interface StatementFile {
+    format: 'coda';
+    /** The version code of the header record: `2`. */
+    version: string;
+    /**
+     * What was read, under one name: `coda.2`. The word is XML's and is kept
+     * because it is the key under which `@ekwo-ai/camt053` says the same thing.
+     */
+    namespace: string;
+    statements: Statement[];
+    violations: Violation[];
+}
+export interface ReadOptions {
+    /** Refuse a larger file unread. Default 32 MiB. */
+    maxBytes?: number;
+    /**
+     * How bytes are decoded. Default `utf-8`, fatally — which reads ASCII, the
+     * character set of the standard. `iso-8859-1` is said, never guessed.
+     * Ignored when the input is already a string.
+     */
+    encoding?: 'utf-8' | 'iso-8859-1';
+    /**
+     * CODA writes a year on two digits. `YY` at or above this is 19YY, under it
+     * 20YY. Default 80: version 2 of the standard has no file from before 1980
+     * and this reader will need another look in 2080.
+     */
+    pivotYear?: 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":"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"}

package/dist/types.js

@@ -0,0 +1,13 @@
+/**
+ * What a statement is once it has been read: an account, two balances and
+ * lines. The shape is declared here and imported from nowhere — it names no
+ * table and no ledger. It is, field for field, the shape `@ekwo-ai/camt053`
+ * declares for itself, so whatever takes one takes the other; what only CODA
+ * says comes after, under names of its own.
+ *
+ * Every amount is a **decimal string**, signed from the account holder's side:
+ * money in is positive, money out is negative, an overdrawn balance is
+ * negative. No figure of a statement 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;;;;;;;;;;GAUG"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@ekwo-ai/coda",
+  "version": "0.4.0",
+  "description": "Reads a CODA coded statement of account (Febelfin, version 2) into plain objects in TypeScript: account, balances and lines, amounts as decimal strings, and what does not add up. Zero dependencies.",
+  "keywords": [
+    "coda",
+    "febelfin",
+    "bank-statement",
+    "coded-statement-of-account",
+    "reconciliation",
+    "structured-communication",
+    "fixed-width",
+    "parser"
+  ],
+  "license": "MIT",
+  "author": "Ekwo AI",
+  "homepage": "https://github.com/Ekwo-ai/ekwo-os/tree/main/packages/formats/coda#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ekwo-ai/ekwo-os.git",
+    "directory": "packages/formats/coda"
+  },
+  "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"
+  }
+}