@ekwo-ai/cfonb120 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ekwo AI
+
+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,184 @@
+# `@ekwo-ai/cfonb120`
+
+Reads a **CFONB 120** file — the *relevé de compte sur support informatique*
+French banks deliver, records of 120 characters in fixed positions — into plain
+objects, in TypeScript, with no dependencies.
+
+Give it the file and it gives you the statements in it, their lines, and the
+list of what does not add up.
+
+```ts
+import { readCfonb120 } from '@ekwo-ai/cfonb120';
+
+const { statements, violations } = readCfonb120(bytesOrString, { ibanCountry: 'FR' });
+
+for (const statement of statements) {
+  statement.account.identifier; // { kind: 'iban', value } — or { kind: 'other', value } when no country was named
+  statement.openingBalance;     // { type: 'OPBD', amount: '1000.00', currency: 'EUR', date: '2026-02-28' }
+  statement.closingBalance;
+  statement.balanced;           // true, false, or null when it could not be checked
+  for (const line of statement.lines) {
+    line.amount;                // '-450.50' — signed, a decimal string, never a float
+    line.bookingDate;           // '2026-03-06'
+    line.counterparty;          // { name, account, agentBic, ultimateName }
+    line.remittance;            // { unstructured: [...], structured: [{ reference, type, issuer }] }
+    line.additionalInformation; // the label the bank gave the movement
+  }
+}
+```
+
+It knows no database and no ledger. The shape it returns is declared in
+[`src/types.ts`](./src/types.ts), imported from nowhere, and is **field for
+field the shape [`@ekwo-ai/camt053`](../camt053/) declares for itself** — so
+whatever takes a camt.053 that was read takes a CFONB 120 that was read, without
+an adapter. What only this format says comes after those fields, under its own
+names (`interbankOperationCode`, `entryNumber`, `referenceZone`, `unavailable`,
+`complements`…).
+
+A format is not a country. Nothing here assumes the euro, two decimals or a
+language — and the format itself **carries no country**, which is why this
+reader does not supply one (see *The account* below).
+
+## What it does
+
+- Reads records **01** (old balance), **04** (movement), **05** (complement)
+  and **07** (new balance), and returns **every statement** of the file.
+- Reads the **sign written over the last digit** of an amount — `{` and `A` to
+  `I` for 0 to 9 of a credit, `}` and `J` to `R` for 0 to 9 of a debit — and
+  the **number of decimals from the record** (position 20). Amounts come back
+  as decimal strings with exactly that many decimals: `150000` for a yen
+  account, `1.001` for a dinar one. Sums are made on integers; nothing is
+  rounded and nothing knows that a euro has cents.
+- Checks that **old balance + movements = new balance**. When it is not, the
+  statement comes back as the bank wrote it, `balanced` is `false`, and
+  `balance_mismatch` says the difference. **Nothing is corrected.**
+- Reads the **complements** the 2010 addendum standardised for SEPA: payer and
+  beneficiary (`NPY`, `NBE`), their identifiers (`IPY`, `IBE`), the parties
+  behind them (`NPO`, `NBU`), their accounts (`CPY`, `CBE`), the remittance
+  (`LCC` + `LC2`, put back into the one text they were cut from; `LCS`,
+  structured, kept apart), the end-to-end reference and purpose (`RCN`), the
+  payment information and instruction identifiers (`REF`), the mandate and its
+  sequence (`RUM`), the amount of origin and the rate (`MMO`, returned beside
+  what moved, **never converted**), and free lines (`LIB`). Every complement,
+  a bank's own qualifiers included, is also returned as written
+  (`complements`).
+- Names the **counterparty** as the payer of money coming in and the
+  beneficiary of money going out — and the other way round when the movement
+  carries a reject code, where the parties keep the roles they had in the
+  original.
+- Reports a movement **booked outside its statement**
+  (`booking_date_outside_statement`): the brochure defines a statement as the
+  movements booked strictly after the date of the old balance and up to the
+  date of the new one.
+
+## The account, and the country nobody wrote
+
+A CFONB 120 identifies an account by a **bank code, a branch code and an
+account number**. It carries no IBAN and **no country**: the same lay-out is
+used wherever that way of numbering accounts is. So:
+
+- by default the identifier is `{ kind: 'other', value }`, the three joined, as
+  written — and `statement.account` gives them apart;
+- with `{ ibanCountry: 'FR' }` — or any other two letters — it is the IBAN
+  those three make **in the country the caller named**: the key of the relevé
+  d'identité bancaire is computed (`ribKey()`), then the check digits of
+  ISO 13616 (`ibanOf()`). Parts that cannot make one are `invalid_iban`, and
+  the account comes back as written.
+
+The reader never picks the country. Whoever imports the file knows where the
+account is held; the file does not say.
+
+## A statement is hostile input
+
+- **Every record is 120 characters or the file is refused**
+  (`invalid_record_length`, with the record's number). Nothing is padded:
+  a file whose trailing blanks were trimmed on the way is refused, because a
+  reader that pads cannot tell a trimmed record from a truncated one. A file
+  with no line break at all — common for this format — is read as consecutive
+  records, if its length is a whole number of them.
+- **An unknown record code is refused by name** (`unknown_record`), and so is a
+  known one out of place (`unexpected_record`). A file that stops before a new
+  balance is `incomplete_statement`.
+- **A record of another account in the middle of a statement is refused**
+  (`inconsistent_record`): the brochure says bank, branch, currency, decimals
+  and account are identical in every record of one statement. That is also
+  what refuses a movement in another currency, or on another scale.
+- **UTF-8, decoded fatally**, which reads the ASCII the brochure allows.
+  `{ encoding: 'iso-8859-1' }` is said by the caller and never guessed.
+  **EBCDIC**, which the brochure also describes, is `unsupported_encoding`.
+- **Size** is checked before a record is read (`maxBytes`, 32 MiB by default).
+
+## What is thrown, and what comes back as a violation
+
+**Thrown** (`StatementFileError`, with a `code` and the `record` it stopped on):
+`too_large`, `unsupported_encoding`, `empty_file`, `invalid_record_length`,
+`unknown_record`, `unexpected_record`, `inconsistent_record`,
+`incomplete_statement`.
+
+**Returned** in `violations`, with the statement and the line it is on:
+
+| code | when |
+|---|---|
+| `balance_mismatch` | old balance + movements ≠ new balance; the message says the difference |
+| `invalid_amount`, `invalid_date`, `booking_date_missing` | the line comes back with `null` there |
+| `booking_date_outside_statement` | see above |
+| `invalid_iban` | `ibanCountry` was given and the account's parts do not make an IBAN |
+
+## What it does not do
+
+- **It gives a movement no bank reference, because the format has none.**
+  `bankReference` is always `null`. The "numéro d'écriture" is a cheque or
+  remittance number, or zeros; the `REF` complement carries the payer's
+  references, not the bank's; the reference zone is the ordering party's. A
+  core that recognises a line by the reference of the bank will recognise no
+  line of a CFONB 120 in a camt.053 of the same month — it will import both.
+  That is a property of the format, said here rather than papered over.
+- **It gives a statement no number**, for the same reason: its `id` is made of
+  the dates of its two balances.
+- **It converts nothing, matches nothing, and does not decide what a duplicate
+  is.**
+- **It does not explain the operation codes** (interbank or internal), nor the
+  reject codes: they are returned as written.
+- **It does not parse the label** (zone 2-M), whose recommended structure
+  (chapter 5 of the brochure) differs by payment instrument and is a
+  recommendation.
+- **It does not read EBCDIC, the 240-character format, or Windows-1252.**
+
+## Sources
+
+- CFONB, *Relevé de compte sur support informatique* (brochure, July 2004),
+  <https://www.cfonb.org/fichiers/20130612113947_7_4_Releve_de_Compte_sur_support_informatique_2004_07.pdf>.
+- CFONB, *Évolutions du relevé de compte 120 caractères pour les opérations de
+  virements et de prélèvements SEPA*, version 2.0 (March 2010),
+  <https://www.cfonb.org/files/fichiers/20130612114053_7_8_Evol_Releve_Cpt_120_caract._ope._SCT_et_SDD_sepa_V2_0_2010_03.pdf>.
+  Both downloaded on 18 September 2026.
+- ISO 13616 (IBAN), ISO 7064 (MOD 97-10), ISO 4217 (currency codes).
+
+## What is verified, and what is not
+
+**Verified**: every position this reader takes was written from the tables of
+the two documents above, and the test builder (`test/build.ts`) was written
+from the same tables, separately from the reader. The fixtures under
+`test/fixtures/` are what the builder writes, compared on every run. The twenty
+characters that carry a digit and a sign are each read.
+
+**Not verified** — and this is the larger half:
+
+- **No file from a bank has been read.** Every statement here is invented.
+  Reader and builder share an author and a reading of the brochure: where that
+  reading is wrong, both are, and the tests pass. *The first real file from
+  each bank is a test nobody has run.*
+- **How strictly banks keep to 120.** Files whose trailing blanks were trimmed
+  exist; this reader refuses them by name rather than guess what was there.
+- **The counterparty of a rejected operation** — that the parties keep their
+  original roles when a reject code is present — is this package's reading,
+  taken from how the camt.053 reader treats a reversal. Banks may differ.
+- **The key of the relevé d'identité bancaire** is computed from its published
+  rule and held against ISO 13616 in the tests; it is not held against a real
+  account, because none is in this repository.
+- **Which qualifiers banks really send.** The 2010 addendum lists them; banks
+  add their own, which are returned as written and otherwise ignored.
+
+## Licence
+
+MIT. See [`LICENSE`](./LICENSE).

package/dist/checks.d.ts

@@ -0,0 +1,18 @@
+/** ISO 13616: move four characters to the end, letters to numbers, mod 97 is 1. */
+export declare function isValidIban(iban: string): boolean;
+/**
+ * The two-digit key that completes a bank code, a branch code and an account
+ * number into the twenty-three characters printed on a relevé d'identité
+ * bancaire. A letter of the account number counts as a digit: A and J as 1,
+ * B, K and S as 2, … I, R and Z as 9. Null when the three parts are not what
+ * the format says they are.
+ */
+export declare function ribKey(bankCode: string, branchCode: string, accountNumber: string): string | null;
+/**
+ * The IBAN of an account a CFONB 120 identifies, **in the country the caller
+ * names**: the format carries a bank, a branch and an account, and no country —
+ * the same lay-out serves more than one. Null when the parts are not what the
+ * format says, or the country is not two letters.
+ */
+export declare function ibanOf(country: string, bankCode: string, branchCode: string, accountNumber: string): string | null;
+//# sourceMappingURL=checks.d.ts.map

package/dist/checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../src/checks.ts"],"names":[],"mappings":"AAWA,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGjD;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAcjG;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CACpB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,MAAM,GAAG,IAAI,CAMf"}

package/dist/checks.js

@@ -0,0 +1,54 @@
+/** ISO 7064 MOD 97-10 over a string of digits and letters (A = 10 … Z = 35). */
+function mod97(text) {
+    let remainder = 0;
+    for (const character of text) {
+        const code = character.charCodeAt(0);
+        const value = code >= 65 ? code - 55 : code - 48;
+        remainder = (value > 9 ? remainder * 100 + value : remainder * 10 + value) % 97;
+    }
+    return remainder;
+}
+/** ISO 13616: move four characters to the end, letters to numbers, mod 97 is 1. */
+export function isValidIban(iban) {
+    if (!/^[A-Z]{2}[0-9]{2}[A-Z0-9]{1,30}$/.test(iban))
+        return false;
+    return mod97(iban.slice(4) + iban.slice(0, 4)) === 1;
+}
+/**
+ * The two-digit key that completes a bank code, a branch code and an account
+ * number into the twenty-three characters printed on a relevé d'identité
+ * bancaire. A letter of the account number counts as a digit: A and J as 1,
+ * B, K and S as 2, … I, R and Z as 9. Null when the three parts are not what
+ * the format says they are.
+ */
+export function ribKey(bankCode, branchCode, accountNumber) {
+    if (!/^[0-9]{5}$/.test(bankCode) || !/^[0-9]{5}$/.test(branchCode) || !/^[0-9A-Z]{11}$/.test(accountNumber)) {
+        return null;
+    }
+    const numeric = [...accountNumber]
+        .map((character) => {
+        const code = character.charCodeAt(0);
+        if (code < 65)
+            return character;
+        const rank = code - 65; // A = 0
+        return String(rank < 9 ? rank + 1 : rank < 18 ? rank - 8 : rank - 16);
+    })
+        .join('');
+    const sum = 89n * BigInt(bankCode) + 15n * BigInt(branchCode) + 3n * BigInt(numeric);
+    return String(97n - (sum % 97n)).padStart(2, '0');
+}
+/**
+ * The IBAN of an account a CFONB 120 identifies, **in the country the caller
+ * names**: the format carries a bank, a branch and an account, and no country —
+ * the same lay-out serves more than one. Null when the parts are not what the
+ * format says, or the country is not two letters.
+ */
+export function ibanOf(country, bankCode, branchCode, accountNumber) {
+    const key = ribKey(bankCode, branchCode, accountNumber);
+    if (key === null || !/^[A-Z]{2}$/.test(country))
+        return null;
+    const bban = bankCode + branchCode + accountNumber + key;
+    const check = String(98 - mod97(`${bban}${country}00`)).padStart(2, '0');
+    return `${country}${check}${bban}`;
+}
+//# sourceMappingURL=checks.js.map

package/dist/checks.js.map

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

package/dist/decimal.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Amounts as the file wrote them, added without a float.
+ *
+ * A CFONB 120 amount is fourteen positions: thirteen digits, and a last
+ * character that is a digit **and** the sign, written over one another the way
+ * punched cards did. `{` and `A` to `I` are 0 to 9 of a credit; `}` and `J` to
+ * `R` are 0 to 9 of a debit. How many of the fourteen digits are decimals is
+ * said by another position of the same record, and read from there: nothing
+ * here knows that a euro has cents.
+ */
+/** The fourteen positions as a signed integer of minor units, or null when they are not an amount. */
+export declare function parseSigned(field: string): bigint | null;
+/** Fourteen digits, unsigned: the amount of origin of a `MMO` complement. */
+export declare function parseUnsigned(field: string): bigint | null;
+/**
+ * Minor units as a decimal string with exactly the decimals the record
+ * announced: signed, no leading zeros, no exponent, nothing rounded.
+ */
+export declare function formatAmount(value: bigint, decimals: number): 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;;;;;;;;;GASG;AAKH,sGAAsG;AACtG,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQxD;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE1D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMpE"}

package/dist/decimal.js

@@ -0,0 +1,40 @@
+/**
+ * Amounts as the file wrote them, added without a float.
+ *
+ * A CFONB 120 amount is fourteen positions: thirteen digits, and a last
+ * character that is a digit **and** the sign, written over one another the way
+ * punched cards did. `{` and `A` to `I` are 0 to 9 of a credit; `}` and `J` to
+ * `R` are 0 to 9 of a debit. How many of the fourteen digits are decimals is
+ * said by another position of the same record, and read from there: nothing
+ * here knows that a euro has cents.
+ */
+const POSITIVE = '{ABCDEFGHI';
+const NEGATIVE = '}JKLMNOPQR';
+/** The fourteen positions as a signed integer of minor units, or null when they are not an amount. */
+export function parseSigned(field) {
+    if (!/^[0-9]{13}.$/.test(field))
+        return null;
+    const last = field.charAt(13);
+    const positive = POSITIVE.indexOf(last);
+    const negative = NEGATIVE.indexOf(last);
+    if (positive < 0 && negative < 0)
+        return null;
+    const value = BigInt(field.slice(0, 13) + String(positive >= 0 ? positive : negative));
+    return negative >= 0 ? -value : value;
+}
+/** Fourteen digits, unsigned: the amount of origin of a `MMO` complement. */
+export function parseUnsigned(field) {
+    return /^[0-9]+$/.test(field) ? BigInt(field) : null;
+}
+/**
+ * Minor units as a decimal string with exactly the decimals the record
+ * announced: signed, no leading zeros, no exponent, nothing rounded.
+ */
+export function formatAmount(value, decimals) {
+    const negative = value < 0n;
+    const digits = (negative ? -value : value).toString().padStart(decimals + 1, '0');
+    const whole = digits.slice(0, digits.length - decimals);
+    const fraction = decimals === 0 ? '' : `.${digits.slice(-decimals)}`;
+    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;;;;;;;;;GASG;AAEH,MAAM,QAAQ,GAAG,YAAY,CAAC;AAC9B,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B,sGAAsG;AACtG,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvF,OAAO,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AACxC,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,QAAgB;IAC1D,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,QAAQ,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAClF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;IACrE,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,GAAG,QAAQ,EAAE,CAAC;AACrD,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,30 @@
+/**
+ * What makes a file unreadable, as opposed to a statement that reads and does
+ * not add up. The second comes back in `violations`; the first is thrown,
+ * because a format of fixed positions that is off by one character is off for
+ * every field after it, and there is no statement to hang a violation on.
+ */
+export type StatementFileErrorCode = 
+/** Larger than `maxBytes`. Refused before a single character is read. */
+'too_large'
+/** Bytes that are not the encoding announced — EBCDIC among them —, a replacement or a control character. */
+ | 'unsupported_encoding'
+/** Nothing in the file. */
+ | 'empty_file'
+/** A record that is not 120 characters long. */
+ | 'invalid_record_length'
+/** A record whose code is none of 01, 04, 05, 07. */
+ | 'unknown_record'
+/** A known record where the format does not allow it: a movement before an old balance, a complement without its movement. */
+ | 'unexpected_record'
+/** A record that is of another bank, branch, currency, number of decimals or account than the old balance of its statement. */
+ | 'inconsistent_record'
+/** The file stops before the new balance of a statement it began, or an old balance names no account. */
+ | 'incomplete_statement';
+export declare class StatementFileError extends Error {
+    readonly code: StatementFileErrorCode;
+    /** The record the reader stopped on, from 1, when there is one. */
+    readonly record: number | null;
+    constructor(code: StatementFileErrorCode, message: string, record?: 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;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB;AAChC,yEAAyE;AACvE,WAAW;AACb,6GAA6G;GAC3G,sBAAsB;AACxB,2BAA2B;GACzB,YAAY;AACd,gDAAgD;GAC9C,uBAAuB;AACzB,qDAAqD;GACnD,gBAAgB;AAClB,8HAA8H;GAC5H,mBAAmB;AACrB,+HAA+H;GAC7H,qBAAqB;AACvB,yGAAyG;GACvG,sBAAsB,CAAC;AAE3B,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEnB,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,GAAG,IAAW;CAMxF"}

package/dist/errors.js

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

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAwBA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAyB;IACtC,mEAAmE;IAC1D,MAAM,CAAgB;IAE/B,YAAY,IAA4B,EAAE,OAAe,EAAE,SAAwB,IAAI;QACrF,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import type { ReadOptions, StatementFile } from './types.js';
+export { ibanOf, isValidIban, ribKey } from './checks.js';
+export { StatementFileError, type StatementFileErrorCode } from './errors.js';
+export type * from './types.js';
+/** Every record of a CFONB 120 file is this long, the line break not counted. */
+export declare const RECORD_LENGTH = 120;
+/**
+ * Read a CFONB 120 file — a string, or the bytes as they came — into its
+ * statements, their lines, and what does not add up.
+ *
+ * Throws a `StatementFileError` for what is not a readable CFONB 120 at all: a
+ * record of the wrong length, an unknown record, a record out of place or of
+ * another account, an encoding that is not the one announced. Everything else
+ * comes back, with the trouble named in `violations` and nothing silently
+ * repaired: a new balance that does not follow from the old one is returned as
+ * the bank wrote it, and reported.
+ */
+export declare function readCfonb120(input: string | Uint8Array, options?: ReadOptions): StatementFile;
+//# 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":"AAIA,OAAO,KAAK,EAGV,WAAW,EAIX,aAAa,EAId,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC9E,mBAAmB,YAAY,CAAC;AAEhC,iFAAiF;AACjF,eAAO,MAAM,aAAa,MAAM,CAAC;AAmYjC;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,GAAE,WAAgB,GAAG,aAAa,CAUjG"}

package/dist/index.js

@@ -0,0 +1,343 @@
+import { ibanOf, isValidIban } from './checks.js';
+import { formatAmount, parseSigned, parseUnsigned } from './decimal.js';
+import { StatementFileError } from './errors.js';
+import { decode, splitRecords } from './records.js';
+export { ibanOf, isValidIban, ribKey } from './checks.js';
+export { StatementFileError } from './errors.js';
+/** Every record of a CFONB 120 file is this long, the line break not counted. */
+export const RECORD_LENGTH = 120;
+const DEFAULTS = { maxBytes: 32 * 1024 * 1024, pivotYear: 80 };
+// --- positions ---------------------------------------------------------------
+/** Positions `from` to `to` of a record, counted from 1 and inclusive, as the brochure writes them. */
+function at(record, from, to = from) {
+    return record.slice(from - 1, to);
+}
+/** A zone as text: blanks around it gone, null when nothing is left. */
+function zone(record, from, to) {
+    const value = at(record, from, to).trim();
+    return value === '' ? null : value;
+}
+/**
+ * Bank, branch, currency, decimals and account: zones B and D to H, which the
+ * brochure says are identical in every record of one statement. Zone G is
+ * reserved, and left out: a bank that writes something there is not another
+ * account.
+ */
+function identity(record) {
+    return `${at(record, 3, 7)}|${at(record, 12, 20)}|${at(record, 22, 32)}`;
+}
+function gather(records) {
+    const out = [];
+    let current = null;
+    let previous = '';
+    records.forEach((record, index) => {
+        const code = at(record, 1, 2);
+        const refuse = (message) => {
+            throw new StatementFileError('unexpected_record', message, index + 1);
+        };
+        if (!['01', '04', '05', '07'].includes(code)) {
+            throw new StatementFileError('unknown_record', `record code "${code}": a statement of account has 01, 04, 05 and 07`, index + 1);
+        }
+        if (code === '01') {
+            if (current)
+                refuse('an old balance, and the statement before it has no new balance');
+            current = { record: index + 1, oldBalance: record, movements: [] };
+        }
+        else {
+            if (!current)
+                return refuse(`a record ${code} before any old balance`);
+            if (identity(record) !== identity(current.oldBalance)) {
+                throw new StatementFileError('inconsistent_record', `bank, branch, currency, decimals and account are "${identity(record)}" here and "${identity(current.oldBalance)}" on the old balance of the statement: a record of another account, or of another currency, in the middle of this one`, index + 1);
+            }
+            if (code === '04')
+                current.movements.push({ record: index + 1, r04: record, complements: [] });
+            else if (code === '05') {
+                const movement = current.movements[current.movements.length - 1];
+                if (!movement || (previous !== '04' && previous !== '05')) {
+                    return refuse('a complement that follows no movement');
+                }
+                movement.complements.push(record);
+            }
+            else {
+                out.push({ ...current, newBalance: record });
+                current = null;
+            }
+        }
+        previous = code;
+    });
+    if (current) {
+        throw new StatementFileError('incomplete_statement', `the statement that begins at record ${current.record} has no new balance: the file stops before its end`);
+    }
+    return out;
+}
+// --- small readers -----------------------------------------------------------
+/** `JJMMAA` to `YYYY-MM-DD`: null when blank or zeros, undefined when it is not a date. */
+function day(field, pivotYear) {
+    if (field === '000000' || field.trim() === '')
+        return null;
+    if (!/^[0-9]{6}$/.test(field))
+        return undefined;
+    const date = Number(field.slice(0, 2));
+    const month = Number(field.slice(2, 4));
+    const short = Number(field.slice(4, 6));
+    const year = (short >= pivotYear ? 1900 : 2000) + short;
+    if (month < 1 || month > 12 || date < 1)
+        return undefined;
+    const leap = (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+    const length = [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31][month - 1];
+    if (date > length)
+        return undefined;
+    return `${year}-${field.slice(2, 4)}-${field.slice(0, 2)}`;
+}
+/** A counterparty's account: an IBAN when it passes ISO 13616, else what was written. */
+function otherAccount(text) {
+    if (text === null)
+        return null;
+    const value = text.replace(/\s+/g, '').toUpperCase();
+    if (value === '')
+        return null;
+    if (isValidIban(value))
+        return { kind: 'iban', value };
+    return { kind: 'other', value, scheme: null, issuer: null };
+}
+// --- a statement -------------------------------------------------------------
+function readStatement(raw, position, options, violations) {
+    const report = (code, message, line) => {
+        violations.push(line === undefined ? { code, message, statement: position } : { code, message, statement: position, line });
+    };
+    const dayOf = (field, what, line) => {
+        const value = day(field, options.pivotYear);
+        if (value === undefined) {
+            report('invalid_date', `${what} "${field}" is not a date (JJMMAA)`, line);
+            return null;
+        }
+        return value;
+    };
+    const first = raw.oldBalance;
+    const bankCode = at(first, 3, 7);
+    const branchCode = at(first, 12, 16);
+    const accountNumber = at(first, 22, 32).trim().toUpperCase();
+    const currency = /^[A-Z]{3}$/.test(at(first, 17, 19)) ? at(first, 17, 19) : null;
+    if (accountNumber === '' || !/^[0-9]$/.test(at(first, 20))) {
+        throw new StatementFileError('incomplete_statement', accountNumber === ''
+            ? 'the old balance names no account: there is nothing to attach its lines to'
+            : `the number of decimals is "${at(first, 20)}", which is not a digit: no amount of this statement can be read`, raw.record);
+    }
+    const decimals = Number(at(first, 20));
+    let identifier = {
+        kind: 'other',
+        value: `${bankCode}${branchCode}${accountNumber}`.replace(/\s+/g, ''),
+        scheme: null,
+        issuer: null,
+    };
+    if (options.ibanCountry !== null) {
+        const iban = ibanOf(options.ibanCountry, bankCode, branchCode, accountNumber);
+        if (iban === null) {
+            report('invalid_iban', `bank code "${bankCode}", branch code "${branchCode}" and account number "${accountNumber}" do not make an IBAN in "${options.ibanCountry}": five digits, five digits, eleven letters or digits, and a country of two letters; the account is returned as written`);
+        }
+        else
+            identifier = { kind: 'iban', value: iban };
+    }
+    const balance = (type, record, what) => {
+        const scaled = parseSigned(at(record, 91, 104));
+        if (scaled === null) {
+            report('invalid_amount', `the ${what} balance "${at(record, 91, 104)}" is not thirteen digits and a last character that carries the sign ({ A–I, } J–R)`);
+            return null;
+        }
+        return {
+            balance: {
+                type,
+                amount: formatAmount(scaled, decimals),
+                currency,
+                date: dayOf(at(record, 35, 40), `the date of the ${what} balance`),
+            },
+            scaled,
+        };
+    };
+    const opening = balance('OPBD', raw.oldBalance, 'old');
+    const closing = balance('CLBD', raw.newBalance, 'new');
+    const lines = [];
+    let checkable = opening !== null && closing !== null;
+    let movementTotal = 0n;
+    for (const movement of raw.movements) {
+        const index = lines.length + 1;
+        const record = movement.r04;
+        const scaled = parseSigned(at(record, 91, 104));
+        if (scaled === null) {
+            checkable = false;
+            report('invalid_amount', `the amount of movement ${index}, "${at(record, 91, 104)}", is not thirteen digits and a last character that carries the sign ({ A–I, } J–R)`, index);
+        }
+        else
+            movementTotal += scaled;
+        const bookingDate = dayOf(at(record, 35, 40), `the booking date of movement ${index}`, index);
+        if (bookingDate === null)
+            report('booking_date_missing', `movement ${index} has no booking date`, index);
+        else if ((opening?.balance.date && bookingDate <= opening.balance.date) ||
+            (closing?.balance.date && bookingDate > closing.balance.date)) {
+            report('booking_date_outside_statement', `movement ${index} is booked on ${bookingDate}, and the statement runs after ${opening?.balance.date ?? '…'} and up to ${closing?.balance.date ?? '…'}`, index);
+        }
+        // The complements, by qualifier. Zone 2b-M is positions 49 to 118; the
+        // qualifiers that carry two zones cut it at 84.
+        const complements = movement.complements.map((complement) => ({
+            qualifier: at(complement, 46, 48),
+            text: at(complement, 49, 118).trimEnd(),
+            record: complement,
+        }));
+        const find = (qualifier) => complements.find((complement) => complement.qualifier === qualifier)?.record ?? null;
+        const whole = (qualifier) => {
+            const complement = find(qualifier);
+            return complement === null ? null : zone(complement, 49, 118);
+        };
+        const halves = (qualifier) => {
+            const complement = find(qualifier);
+            return complement === null ? [null, null] : [zone(complement, 49, 83), zone(complement, 84, 118)];
+        };
+        const returnReason = (() => {
+            const value = zone(record, 41, 42);
+            return value === null || /^0+$/.test(value) ? null : value;
+        })();
+        const reversal = returnReason !== null;
+        // Who is on the other side: the payer of money coming in, the beneficiary
+        // of money going out — and the reverse on a rejected operation, where the
+        // parties keep the roles they had in the original.
+        const credit = scaled !== null && scaled >= 0n;
+        const payer = credit !== reversal;
+        const counterparty = {
+            name: whole(payer ? 'NPY' : 'NBE'),
+            account: otherAccount(halves(payer ? 'CPY' : 'CBE')[0]),
+            agentBic: null,
+            ultimateName: whole(payer ? 'NPO' : 'NBU'),
+        };
+        const [identifierValue, identifierType] = halves(payer ? 'IPY' : 'IBE');
+        const remittance = { unstructured: [], structured: [] };
+        for (const complement of complements) {
+            if (complement.qualifier === 'LIB' && complement.text.trim() !== '') {
+                remittance.unstructured.push(complement.text.trim());
+            }
+        }
+        const lcc = find('LCC');
+        const lc2 = find('LC2');
+        const client = `${lcc ? at(lcc, 49, 118) : ''}${lc2 ? at(lc2, 49, 118) : ''}`.trim();
+        if (client !== '')
+            remittance.unstructured.push(client);
+        const structured = halves('LCS')[0];
+        if (structured !== null)
+            remittance.structured.push({ reference: structured, type: null, issuer: null });
+        const [endToEndId, purpose] = halves('RCN');
+        const [paymentInformationId, instructionId] = halves('REF');
+        const mandate = find('RUM');
+        let instructedAmount = null;
+        let exchangeRate = null;
+        const origin = find('MMO');
+        if (origin !== null) {
+            const originCurrency = at(origin, 49, 51);
+            const originAmount = parseUnsigned(at(origin, 53, 66));
+            if (/^[A-Z]{3}$/.test(originCurrency) && /^[0-9]$/.test(at(origin, 52)) && originAmount !== null) {
+                instructedAmount = { amount: formatAmount(originAmount, Number(at(origin, 52))), currency: originCurrency };
+            }
+            const rate = parseUnsigned(at(origin, 69, 79));
+            if (/^[0-9]{2}$/.test(at(origin, 67, 68)) && rate !== null && rate !== 0n) {
+                exchangeRate = formatAmount(rate, Number(at(origin, 67, 68)));
+            }
+        }
+        const entryNumber = zone(record, 82, 88);
+        const interbank = zone(record, 33, 34);
+        lines.push({
+            index,
+            entry: index,
+            detail: null,
+            detailCount: null,
+            status: 'BOOK',
+            booked: true,
+            reversal,
+            bookingDate,
+            valueDate: dayOf(at(record, 43, 48), `the value date of movement ${index}`, index),
+            amount: scaled === null ? null : formatAmount(scaled, decimals),
+            currency,
+            entryAmount: null,
+            bankReference: null,
+            entryReference: null,
+            endToEndId,
+            transactionId: null,
+            instructionId,
+            paymentInformationId,
+            mandateId: mandate === null ? null : zone(mandate, 49, 83),
+            counterparty: Object.values(counterparty).every((value) => value === null) ? null : counterparty,
+            remittance,
+            bankTransactionCode: interbank === null
+                ? null
+                : { domain: null, family: null, subFamily: null, proprietary: interbank, proprietaryIssuer: 'CFONB' },
+            returnReason,
+            instructedAmount,
+            exchangeRate,
+            additionalInformation: zone(record, 49, 79),
+            internalOperationCode: zone(record, 8, 11),
+            interbankOperationCode: interbank,
+            entryNumber: entryNumber === null || /^0+$/.test(entryNumber) ? null : entryNumber,
+            commissionExempt: at(record, 89) === '1',
+            unavailable: at(record, 90) === '1',
+            referenceZone: zone(record, 105, 120),
+            purpose,
+            sequenceType: mandate === null ? null : zone(mandate, 84, 87),
+            counterpartyIdentifier: identifierValue === null ? null : { value: identifierValue, type: identifierType },
+            complements: complements.map(({ qualifier, text }) => ({ qualifier, text })),
+        });
+    }
+    // Old balance plus what moved is the new balance, or the file says so.
+    let balanced = null;
+    if (checkable && opening && closing) {
+        const computed = opening.scaled + movementTotal;
+        balanced = computed === closing.scaled;
+        if (!balanced) {
+            report('balance_mismatch', `old balance ${opening.balance.amount} plus movements ${formatAmount(movementTotal, decimals)} is ${formatAmount(computed, decimals)}, and the statement closes at ${closing.balance.amount}: a difference of ${formatAmount(closing.scaled - computed, decimals)}${currency ? ` ${currency}` : ''}`);
+        }
+    }
+    const balances = [opening?.balance, closing?.balance].filter((item) => item !== undefined && item !== null);
+    return {
+        id: `${opening?.balance.date ?? at(raw.oldBalance, 35, 40)}/${closing?.balance.date ?? at(raw.newBalance, 35, 40)}`,
+        electronicSequenceNumber: null,
+        legalSequenceNumber: null,
+        createdAt: null,
+        period: null,
+        page: null,
+        account: {
+            identifier,
+            currency,
+            name: null,
+            ownerName: null,
+            servicerBic: null,
+            bankCode,
+            branchCode,
+            accountNumber,
+            decimals,
+        },
+        openingBalance: opening?.balance ?? null,
+        closingBalance: closing?.balance ?? null,
+        balances,
+        lines,
+        balanced,
+    };
+}
+/**
+ * Read a CFONB 120 file — a string, or the bytes as they came — into its
+ * statements, their lines, and what does not add up.
+ *
+ * Throws a `StatementFileError` for what is not a readable CFONB 120 at all: a
+ * record of the wrong length, an unknown record, a record out of place or of
+ * another account, an encoding that is not the one announced. Everything else
+ * comes back, with the trouble named in `violations` and nothing silently
+ * repaired: a new balance that does not follow from the old one is returned as
+ * the bank wrote it, and reported.
+ */
+export function readCfonb120(input, options = {}) {
+    const text = decode(input, options.encoding ?? 'utf-8', options.maxBytes ?? DEFAULTS.maxBytes);
+    const records = splitRecords(text, RECORD_LENGTH);
+    const violations = [];
+    const settings = {
+        pivotYear: options.pivotYear ?? DEFAULTS.pivotYear,
+        ibanCountry: options.ibanCountry === undefined ? null : options.ibanCountry.toUpperCase(),
+    };
+    const statements = gather(records).map((raw, index) => readStatement(raw, index + 1, settings, violations));
+    return { format: 'cfonb120', version: null, namespace: 'cfonb120', statements, violations };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/records.d.ts

@@ -0,0 +1,18 @@
+export type Encoding = 'utf-8' | 'iso-8859-1';
+/**
+ * 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). EBCDIC, which
+ * the brochure also describes, is neither, and is refused by this name.
+ */
+export declare function decode(input: string | Uint8Array, encoding: Encoding, maxBytes: number): string;
+/**
+ * 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 declare function splitRecords(text: string, length: number): string[];
+//# sourceMappingURL=records.d.ts.map

package/dist/records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../src/records.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAC;AAY9C;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8C/F;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BnE"}

package/dist/records.js

@@ -0,0 +1,92 @@
+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). EBCDIC, which
+ * the brochure also describes, is neither, and is refused by this name.
+ */
+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,239 @@
+/**
+ * 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
+ * CFONB 120 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. A CFONB 120 carries a bank code, a branch code
+ * and an account number, and neither an IBAN nor a country: the identifier is
+ * `other`, the three joined, unless the caller names the country
+ * (`ibanCountry`) — then it is the IBAN those three make there.
+ */
+export type AccountIdentifier = {
+    kind: 'iban';
+    /** Without spaces, upper case. */
+    value: string;
+} | {
+    kind: 'other';
+    /** Bank code, branch code and account number, twenty-one characters; or a counterparty's account as written. */
+    value: string;
+    scheme: string | null;
+    issuer: string | null;
+};
+export interface StatementAccount {
+    identifier: AccountIdentifier;
+    /** Zone E of the records: the ISO 4217 code. */
+    currency: string | null;
+    /** Always null: the format names no account and no holder. */
+    name: string | null;
+    ownerName: string | null;
+    servicerBic: string | null;
+    bankCode: string;
+    branchCode: string;
+    accountNumber: string;
+    /** Zone F: how many of an amount's digits are decimals, as the records of this statement say. */
+    decimals: number;
+}
+export interface StatementBalance {
+    /** `OPBD` for the old balance (record 01), `CLBD` for the new one (record 07). */
+    type: string;
+    /** Signed: a debit balance is negative. */
+    amount: string;
+    currency: string | null;
+    /** `YYYY-MM-DD`. */
+    date: string | null;
+}
+export interface StructuredReference {
+    /** The `LCS` complement: the structured remittance of the payment, as written. */
+    reference: string;
+    /** Always null: the complement carries the reference and not its type. */
+    type: string | null;
+    issuer: string | null;
+}
+export interface Remittance {
+    /** The `LIB` complements, one each, then `LCC` and `LC2` put back into the one text they were cut from. */
+    unstructured: string[];
+    structured: StructuredReference[];
+}
+export interface Counterparty {
+    /** `NPY` for money in, `NBE` for money out — and the other way round on a rejected operation. */
+    name: string | null;
+    /** `CPY` or `CBE`, by the same rule. */
+    account: AccountIdentifier | null;
+    /** Always null. */
+    agentBic: string | null;
+    /** `NPO` or `NBU`, by the same rule. */
+    ultimateName: string | null;
+}
+export interface BankTransactionCode {
+    /** Always null: CFONB has its own code list, not the ISO 20022 one. */
+    domain: string | null;
+    family: string | null;
+    subFamily: string | null;
+    /** Zone 2-I, the two characters of the interbank operation code. */
+    proprietary: string | null;
+    /** `CFONB`. */
+    proprietaryIssuer: string | null;
+}
+export interface StatementLine {
+    /** Position among the statement's lines, from 1. */
+    index: number;
+    /** The same: a CFONB 120 movement is never split. */
+    entry: number;
+    /** Always null. */
+    detail: number | null;
+    detailCount: number | null;
+    /** `BOOK`: by its definition the statement "shows accounting entries only". */
+    status: string;
+    booked: boolean;
+    /** A reject code is present (zone 2-K): the operation comes back. */
+    reversal: boolean;
+    /** Zone 2-J. */
+    bookingDate: string | null;
+    /** Zone 2-L. */
+    valueDate: string | null;
+    /** Signed: positive is money in. Null when the file's figure is unreadable. */
+    amount: string | null;
+    currency: string | null;
+    entryAmount: string | null;
+    /**
+     * Always null. The format has **no reference the bank gives a movement**:
+     * `entryNumber` is a cheque or remittance number or zeros, and the `REF`
+     * complement carries the payer's references, not the bank's.
+     */
+    bankReference: string | null;
+    entryReference: string | null;
+    /** `RCN`, first zone. */
+    endToEndId: string | null;
+    transactionId: string | null;
+    /** `REF`, second zone. */
+    instructionId: string | null;
+    /** `REF`, first zone. */
+    paymentInformationId: string | null;
+    /** `RUM`, first zone. */
+    mandateId: string | null;
+    counterparty: Counterparty | null;
+    remittance: Remittance;
+    bankTransactionCode: BankTransactionCode | null;
+    /** Zone 2-K, the reject code, as written; null when blank or zeros. */
+    returnReason: string | null;
+    /** `MMO`: the amount and currency of origin, unsigned and unconverted. */
+    instructedAmount: {
+        amount: string;
+        currency: string;
+    } | null;
+    /** `MMO`: the rate, with the decimals the complement announces. */
+    exchangeRate: string | null;
+    /** Zone 2-M, the label the bank gives the movement. */
+    additionalInformation: string | null;
+    /** Zone 2-C, the bank's own operation code. */
+    internalOperationCode: string | null;
+    /** Zone 2-I. */
+    interbankOperationCode: string | null;
+    /** Zone 2-O: a cheque, remittance or voucher number; null when zeros. */
+    entryNumber: string | null;
+    /** Zone 2-P is `1`: exempt from the account movement commission. */
+    commissionExempt: boolean;
+    /** Zone 2-Q is `1`: booked, and not available yet. */
+    unavailable: boolean;
+    /** Zone 2-S. */
+    referenceZone: string | null;
+    /** `RCN`, second zone. */
+    purpose: string | null;
+    /** `RUM`, second zone: OOFF, FRST, RCUR, FNAL. */
+    sequenceType: string | null;
+    /** `IPY` or `IBE`: the identifier of the counterparty and what kind of identifier it is. */
+    counterpartyIdentifier: {
+        value: string;
+        type: string | null;
+    } | null;
+    /** Every complement (record 05) of the movement, in order: its qualifier and its seventy positions, as written. */
+    complements: {
+        qualifier: string;
+        text: string;
+    }[];
+}
+export interface Statement {
+    /**
+     * CFONB 120 gives a statement no identifier and no number. This one is made
+     * of what it does give: the dates of its two balances,
+     * `2026-02-28/2026-03-31`. The same file always makes the same one.
+     */
+    id: string;
+    /** Always null: the format numbers no statement. */
+    electronicSequenceNumber: string | null;
+    legalSequenceNumber: string | null;
+    createdAt: string | null;
+    /** Always null: the dates of the two balances are what the format 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;
+}
+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' | 'invalid_amount' | 'invalid_date' | 'booking_date_missing' | 'booking_date_outside_statement' | 'invalid_iban';
+export interface StatementFile {
+    format: 'cfonb120';
+    /** Null: the brochure has an edition (July 2004, completed in March 2010) and the file does not say which it follows. */
+    version: string | null;
+    /**
+     * What was read, under one name: `cfonb120`. 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 brochure. `iso-8859-1` is said, never guessed.
+     * Ignored when the input is already a string.
+     */
+    encoding?: 'utf-8' | 'iso-8859-1';
+    /**
+     * The format writes a year on two digits. `YY` at or above this is 19YY,
+     * under it 20YY. Default 80.
+     */
+    pivotYear?: number;
+    /**
+     * Two letters. When given, every account of the file is returned as the
+     * IBAN its bank code, branch code and account number make **in that
+     * country**. Left out, nothing is assumed and the identifier is `other`:
+     * the format carries no country, and the same lay-out serves several.
+     */
+    ibanCountry?: string;
+}
+//# 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
+ * CFONB 120 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/cfonb120",
+  "version": "0.4.0",
+  "description": "Reads a CFONB 120 statement of account (relevé de compte sur support informatique, 120-character records) into plain objects in TypeScript: account, balances and lines, amounts as decimal strings, and what does not add up. Zero dependencies.",
+  "keywords": [
+    "cfonb",
+    "cfonb120",
+    "afb120",
+    "bank-statement",
+    "releve-de-compte",
+    "reconciliation",
+    "fixed-width",
+    "parser"
+  ],
+  "license": "MIT",
+  "author": "Ekwo AI",
+  "homepage": "https://github.com/Ekwo-ai/ekwo-os/tree/main/packages/formats/cfonb120#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ekwo-ai/ekwo-os.git",
+    "directory": "packages/formats/cfonb120"
+  },
+  "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"
+  }
+}