@fin.cx/camt 1.1.0

package/dist_ts/00_commitinfo_data.d.ts

@@ -0,0 +1,8 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export declare const commitinfo: {
+    name: string;
+    version: string;
+    description: string;
+};

package/dist_ts/00_commitinfo_data.js

@@ -0,0 +1,9 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export const commitinfo = {
+    name: '@fin.cx/camt',
+    version: '1.1.0',
+    description: 'ISO 20022 CAMT.052/053/054 bank statement parser with exact integer-cent amounts and SEPA reference extraction'
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxjQUFjO0lBQ3BCLE9BQU8sRUFBRSxPQUFPO0lBQ2hCLFdBQVcsRUFBRSxnSEFBZ0g7Q0FDOUgsQ0FBQSJ9

package/dist_ts/camt.parser.d.ts

@@ -0,0 +1,12 @@
+import type { ICamtStatement, IStatementConsistency } from './camt.types.js';
+/**
+ * Parse a CAMT.052/053/054 document into normalized statements.
+ */
+export declare function parseCamt(xml: string): ICamtStatement[];
+/**
+ * Statement-internal completeness check: opening booked balance plus booked
+ * entry movement must equal the closing booked balance, exactly.
+ * Cross-statement continuity (gapless sequence of statements) lives in
+ * @fin.cx/bankrec.
+ */
+export declare function validateStatementConsistency(statement: ICamtStatement): IStatementConsistency;

package/dist_ts/camt.parser.js

@@ -0,0 +1,250 @@
+/**
+ * ISO 20022 CAMT parser (camt.052 account report, camt.053 statement,
+ * camt.054 debit/credit notification).
+ *
+ * Money safety: fast-xml-parser runs with parseTagValue/parseAttributeValue
+ * DISABLED so amounts stay strings until they are converted to exact integer
+ * cents via @fin.cx/calculation. Handles the namespace versions in circulation
+ * (.001.02 classic through .001.08+ post-2019 EBICS) — structural differences
+ * (e.g. Sts as string vs { Cd }) are normalized.
+ */
+import * as plugins from './camt.plugins.js';
+const { centsFromString } = plugins.calculation;
+const ALWAYS_ARRAY = new Set([
+    'Stmt',
+    'Rpt',
+    'Ntfctn',
+    'Bal',
+    'Ntry',
+    'NtryDtls',
+    'TxDtls',
+    'Ustrd',
+]);
+function parseXml(xml) {
+    const parser = new plugins.XMLParser({
+        ignoreAttributes: false,
+        attributeNamePrefix: '@_',
+        parseTagValue: false,
+        parseAttributeValue: false,
+        removeNSPrefix: true,
+        isArray: (name) => ALWAYS_ARRAY.has(name),
+    });
+    return parser.parse(xml);
+}
+function node(value) {
+    return value && typeof value === 'object' ? value : undefined;
+}
+function text(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    const asNode = node(value);
+    if (asNode && typeof asNode['#text'] === 'string')
+        return asNode['#text'];
+    return undefined;
+}
+function amountCentsOf(value) {
+    const asNode = node(value);
+    const raw = text(value);
+    if (raw === undefined)
+        return null;
+    return {
+        amountCents: centsFromString(raw),
+        currency: asNode?.['@_Ccy'] ?? '',
+    };
+}
+/** Sts is a plain code in camt *.001.02 and { Cd } from .001.08 on */
+function statusOf(value) {
+    return text(value) ?? text(node(value)?.Cd) ?? '';
+}
+function dateOf(value) {
+    const asNode = node(value);
+    const date = text(asNode?.Dt) ?? text(asNode?.DtTm) ?? text(value);
+    return date ? date.slice(0, 10) : undefined;
+}
+function partyName(value) {
+    const asNode = node(value);
+    // .001.08 wraps the party in Pty (Dbtr > Pty > Nm); .001.02 has Nm directly
+    return text(asNode?.Nm) ?? text(node(asNode?.Pty)?.Nm);
+}
+function ibanOf(value) {
+    return text(node(node(value)?.Id)?.IBAN);
+}
+function bicOf(value) {
+    const fin = node(node(value)?.FinInstnId);
+    return text(fin?.BICFI) ?? text(fin?.BIC);
+}
+function toArray(value) {
+    if (value === undefined || value === null)
+        return [];
+    return Array.isArray(value) ? value : [value];
+}
+function parseTransactionDetails(txDtls, entryCdtDbt) {
+    const refs = node(txDtls?.Refs);
+    const parties = node(txDtls?.RltdPties);
+    const agents = node(txDtls?.RltdAgts);
+    const remittance = node(txDtls?.RmtInf);
+    const returnInfo = node(txDtls?.RtrInf);
+    // the counterparty depends on direction: credits come FROM the debtor,
+    // debits go TO the creditor
+    const isCredit = entryCdtDbt === 'CRDT';
+    const counterparty = isCredit ? parties?.Dbtr : parties?.Cdtr;
+    const counterpartyAccount = isCredit ? parties?.DbtrAcct : parties?.CdtrAcct;
+    const counterpartyAgent = isCredit ? agents?.DbtrAgt : agents?.CdtrAgt;
+    const amount = amountCentsOf(txDtls?.Amt) ?? amountCentsOf(node(txDtls?.AmtDtls)?.TxAmt && node(node(txDtls?.AmtDtls)?.TxAmt)?.Amt);
+    const structured = node(remittance?.Strd);
+    const creditorReference = text(node(structured?.CdtrRefInf)?.Ref);
+    return {
+        endToEndId: text(refs?.EndToEndId),
+        mandateId: text(refs?.MndtId),
+        instructionId: text(refs?.InstrId),
+        transactionId: text(refs?.TxId),
+        paymentInformationId: text(refs?.PmtInfId),
+        counterpartyName: partyName(counterparty),
+        counterpartyIban: ibanOf(counterpartyAccount),
+        counterpartyBic: bicOf(counterpartyAgent),
+        remittanceUnstructured: toArray(remittance?.Ustrd)
+            .map((entry) => text(entry))
+            .filter((entry) => entry !== undefined),
+        creditorReference,
+        returnReasonCode: text(node(returnInfo?.Rsn)?.Cd),
+        returnAdditionalInfo: text(returnInfo?.AddtlInf),
+        amountCents: amount?.amountCents,
+        currency: amount?.currency || undefined,
+        creditDebit: text(txDtls?.CdtDbtInd) ?? undefined,
+    };
+}
+function parseEntry(ntry) {
+    const amount = amountCentsOf(ntry?.Amt);
+    if (!amount) {
+        throw new Error('CAMT entry without Amt — refusing to parse a statement with unreadable amounts');
+    }
+    const creditDebit = text(ntry?.CdtDbtInd) ?? 'CRDT';
+    const bankCode = node(ntry?.BkTxCd);
+    const domain = node(bankCode?.Domn);
+    const family = node(domain?.Fmly);
+    const details = [];
+    for (const dtls of toArray(ntry?.NtryDtls)) {
+        for (const tx of toArray(node(dtls)?.TxDtls)) {
+            details.push(parseTransactionDetails(node(tx), creditDebit));
+        }
+    }
+    return {
+        amountCents: amount.amountCents,
+        currency: amount.currency,
+        creditDebit,
+        status: statusOf(ntry?.Sts),
+        bookingDate: dateOf(ntry?.BookgDt),
+        valueDate: dateOf(ntry?.ValDt),
+        accountServicerRef: text(ntry?.AcctSvcrRef),
+        entryRef: text(ntry?.NtryRef),
+        reversal: text(ntry?.RvslInd) === 'true',
+        bankTransactionCode: bankCode
+            ? {
+                domain: text(domain?.Cd),
+                family: text(family?.Cd),
+                subFamily: text(family?.SubFmlyCd),
+                proprietary: text(node(bankCode?.Prtry)?.Cd),
+            }
+            : undefined,
+        details,
+    };
+}
+function parseBalance(bal) {
+    const amount = amountCentsOf(bal?.Amt);
+    if (!amount)
+        return null;
+    const type = text(node(node(bal?.Tp)?.CdOrPrtry)?.Cd) ?? '';
+    return {
+        type,
+        amountCents: amount.amountCents,
+        currency: amount.currency,
+        creditDebit: text(bal?.CdtDbtInd) ?? 'CRDT',
+        date: dateOf(bal?.Dt) ?? '',
+    };
+}
+function parseStatement(stmt, kind, messageId) {
+    const account = node(stmt?.Acct);
+    const sequence = text(stmt?.ElctrncSeqNb);
+    return {
+        kind,
+        messageId,
+        statementId: text(stmt?.Id) ?? '',
+        sequenceNumber: sequence !== undefined ? Number.parseInt(sequence, 10) : undefined,
+        creationDateTime: text(stmt?.CreDtTm),
+        accountIban: ibanOf(account),
+        accountCurrency: text(account?.Ccy),
+        accountOwnerName: partyName(account?.Ownr),
+        servicerBic: bicOf(account?.Svcr),
+        balances: toArray(stmt?.Bal)
+            .map((bal) => parseBalance(node(bal)))
+            .filter((bal) => bal !== null),
+        entries: toArray(stmt?.Ntry).map((ntry) => parseEntry(node(ntry))),
+    };
+}
+/**
+ * Parse a CAMT.052/053/054 document into normalized statements.
+ */
+export function parseCamt(xml) {
+    const document = node(parseXml(xml).Document);
+    if (!document) {
+        throw new Error('Not an ISO 20022 document (no Document root)');
+    }
+    const statementRoot = node(document.BkToCstmrStmt) ?? node(document.BkToCstmrAcctRpt) ?? node(document.BkToCstmrDbtCdtNtfctn);
+    if (!statementRoot) {
+        throw new Error('Unsupported ISO 20022 message — expected BkToCstmrStmt (053), BkToCstmrAcctRpt (052), or BkToCstmrDbtCdtNtfctn (054)');
+    }
+    const kind = document.BkToCstmrStmt
+        ? '053'
+        : document.BkToCstmrAcctRpt
+            ? '052'
+            : '054';
+    const containers = kind === '053' ? statementRoot.Stmt : kind === '052' ? statementRoot.Rpt : statementRoot.Ntfctn;
+    const messageId = text(node(statementRoot.GrpHdr)?.MsgId) ?? '';
+    return toArray(containers).map((stmt) => parseStatement(node(stmt), kind, messageId));
+}
+function signed(balance) {
+    return balance.creditDebit === 'CRDT' ? balance.amountCents : -balance.amountCents;
+}
+/**
+ * Statement-internal completeness check: opening booked balance plus booked
+ * entry movement must equal the closing booked balance, exactly.
+ * Cross-statement continuity (gapless sequence of statements) lives in
+ * @fin.cx/bankrec.
+ */
+export function validateStatementConsistency(statement) {
+    const issues = [];
+    const opening = statement.balances.find((bal) => bal.type === 'OPBD') ??
+        statement.balances.find((bal) => bal.type === 'PRCD');
+    const closing = statement.balances.find((bal) => bal.type === 'CLBD');
+    let movement = 0;
+    for (const entry of statement.entries) {
+        if (entry.status !== 'BOOK')
+            continue;
+        movement += entry.creditDebit === 'CRDT' ? entry.amountCents : -entry.amountCents;
+    }
+    if (!opening)
+        issues.push('no opening balance (OPBD/PRCD)');
+    if (!closing)
+        issues.push('no closing balance (CLBD)');
+    if (opening && closing) {
+        const expected = signed(opening) + movement;
+        if (expected !== signed(closing)) {
+            issues.push(`balance chain broken: opening ${signed(opening)} + movement ${movement} = ${expected} !== closing ${signed(closing)} (cents)`);
+        }
+        if (opening.currency !== closing.currency) {
+            issues.push(`currency mismatch: ${opening.currency} vs ${closing.currency}`);
+        }
+    }
+    return {
+        valid: issues.length === 0,
+        issues,
+        openingCents: opening ? signed(opening) : null,
+        closingCents: closing ? signed(closing) : null,
+        bookedMovementCents: movement,
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2FtdC5wYXJzZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9jYW10LnBhcnNlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7O0dBU0c7QUFDSCxPQUFPLEtBQUssT0FBTyxNQUFNLG1CQUFtQixDQUFDO0FBWTdDLE1BQU0sRUFBRSxlQUFlLEVBQUUsR0FBRyxPQUFPLENBQUMsV0FBVyxDQUFDO0FBRWhELE1BQU0sWUFBWSxHQUFHLElBQUksR0FBRyxDQUFDO0lBQzNCLE1BQU07SUFDTixLQUFLO0lBQ0wsUUFBUTtJQUNSLEtBQUs7SUFDTCxNQUFNO0lBQ04sVUFBVTtJQUNWLFFBQVE7SUFDUixPQUFPO0NBQ1IsQ0FBQyxDQUFDO0FBRUgsU0FBUyxRQUFRLENBQUMsR0FBVztJQUMzQixNQUFNLE1BQU0sR0FBRyxJQUFJLE9BQU8sQ0FBQyxTQUFTLENBQUM7UUFDbkMsZ0JBQWdCLEVBQUUsS0FBSztRQUN2QixtQkFBbUIsRUFBRSxJQUFJO1FBQ3pCLGFBQWEsRUFBRSxLQUFLO1FBQ3BCLG1CQUFtQixFQUFFLEtBQUs7UUFDMUIsY0FBYyxFQUFFLElBQUk7UUFDcEIsT0FBTyxFQUFFLENBQUMsSUFBWSxFQUFFLEVBQUUsQ0FBQyxZQUFZLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQztLQUNsRCxDQUFDLENBQUM7SUFDSCxPQUFPLE1BQU0sQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUE0QixDQUFDO0FBQ3RELENBQUM7QUFJRCxTQUFTLElBQUksQ0FBQyxLQUFjO0lBQzFCLE9BQU8sS0FBSyxJQUFJLE9BQU8sS0FBSyxLQUFLLFFBQVEsQ0FBQyxDQUFDLENBQUUsS0FBaUMsQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUFDO0FBQzdGLENBQUM7QUFFRCxTQUFTLElBQUksQ0FBQyxLQUFjO0lBQzFCLElBQUksS0FBSyxLQUFLLFNBQVMsSUFBSSxLQUFLLEtBQUssSUFBSTtRQUFFLE9BQU8sU0FBUyxDQUFDO0lBQzVELElBQUks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

package/dist_ts/camt.plugins.d.ts

@@ -0,0 +1,3 @@
+import * as calculation from '@fin.cx/calculation';
+import { XMLParser } from 'fast-xml-parser';
+export { calculation, XMLParser };

package/dist_ts/camt.plugins.js

@@ -0,0 +1,4 @@
+import * as calculation from '@fin.cx/calculation';
+import { XMLParser } from 'fast-xml-parser';
+export { calculation, XMLParser };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2FtdC5wbHVnaW5zLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvY2FtdC5wbHVnaW5zLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxXQUFXLE1BQU0scUJBQXFCLENBQUM7QUFDbkQsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBRTVDLE9BQU8sRUFBRSxXQUFXLEVBQUUsU0FBUyxFQUFFLENBQUMifQ==

package/dist_ts/camt.types.d.ts

@@ -0,0 +1,79 @@
+import type { TCents } from '@fin.cx/calculation';
+export type { TCents };
+export type TCamtKind = '052' | '053' | '054';
+export type TCreditDebit = 'CRDT' | 'DBIT';
+/**
+ * Balance types per ISO 20022: OPBD opening booked, CLBD closing booked,
+ * PRCD previously closed booked, CLAV closing available, FWAV forward
+ * available, ITBD interim booked.
+ */
+export interface ICamtBalance {
+    type: string;
+    amountCents: TCents;
+    currency: string;
+    creditDebit: TCreditDebit;
+    /** ISO date (YYYY-MM-DD) */
+    date: string;
+}
+export interface ICamtTransactionDetails {
+    endToEndId?: string;
+    mandateId?: string;
+    instructionId?: string;
+    transactionId?: string;
+    paymentInformationId?: string;
+    counterpartyName?: string;
+    counterpartyIban?: string;
+    counterpartyBic?: string;
+    remittanceUnstructured: string[];
+    /** structured creditor reference (RF...) when present */
+    creditorReference?: string;
+    returnReasonCode?: string;
+    returnAdditionalInfo?: string;
+    /** per-transaction amount inside batch entries */
+    amountCents?: TCents;
+    currency?: string;
+    creditDebit?: TCreditDebit;
+}
+export interface ICamtEntry {
+    amountCents: TCents;
+    currency: string;
+    creditDebit: TCreditDebit;
+    /** BOOK, PDNG, INFO */
+    status: string;
+    /** ISO date (YYYY-MM-DD) */
+    bookingDate?: string;
+    valueDate?: string;
+    accountServicerRef?: string;
+    entryRef?: string;
+    reversal: boolean;
+    bankTransactionCode?: {
+        domain?: string;
+        family?: string;
+        subFamily?: string;
+        proprietary?: string;
+    };
+    /** one per TxDtls; batch entries carry several */
+    details: ICamtTransactionDetails[];
+}
+export interface ICamtStatement {
+    kind: TCamtKind;
+    messageId: string;
+    statementId: string;
+    /** electronic sequence number when the bank provides one */
+    sequenceNumber?: number;
+    creationDateTime?: string;
+    accountIban?: string;
+    accountCurrency?: string;
+    accountOwnerName?: string;
+    servicerBic?: string;
+    balances: ICamtBalance[];
+    entries: ICamtEntry[];
+}
+export interface IStatementConsistency {
+    valid: boolean;
+    issues: string[];
+    /** signed cents: opening booked balance (DBIT negative) */
+    openingCents: TCents | null;
+    closingCents: TCents | null;
+    bookedMovementCents: TCents;
+}

package/dist_ts/camt.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2FtdC50eXBlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL2NhbXQudHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/dist_ts/index.d.ts

@@ -0,0 +1,2 @@
+export * from './camt.types.js';
+export * from './camt.parser.js';

package/dist_ts/index.js

@@ -0,0 +1,3 @@
+export * from './camt.types.js';
+export * from './camt.parser.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMsa0JBQWtCLENBQUMifQ==

package/license

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 Task Venture Capital GmbH
+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/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@fin.cx/camt",
+  "version": "1.1.0",
+  "private": false,
+  "description": "ISO 20022 CAMT.052/053/054 bank statement parser with exact integer-cent amounts and SEPA reference extraction",
+  "main": "dist_ts/index.js",
+  "typings": "dist_ts/index.d.ts",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://code.foss.global/fin.cx/camt.git"
+  },
+  "keywords": [
+    "camt",
+    "camt.053",
+    "camt.052",
+    "camt.054",
+    "iso20022",
+    "bank statement",
+    "sepa",
+    "ebics",
+    "reconciliation",
+    "typescript"
+  ],
+  "author": "fin.cx",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://code.foss.global/fin.cx/camt/issues"
+  },
+  "homepage": "https://code.foss.global/fin.cx/camt#readme",
+  "dependencies": {
+    "@fin.cx/calculation": "^1.1.1",
+    "fast-xml-parser": "^5.9.3"
+  },
+  "devDependencies": {
+    "@git.zone/tsbuild": "^4.4.2",
+    "@git.zone/tsrun": "^2.0.5",
+    "@git.zone/tstest": "^3.6.6",
+    "@types/node": "^26.1.1"
+  },
+  "files": [
+    "ts/**/*",
+    "dist_ts/**/*",
+    "dist_ts_web/**/*",
+    "readme.md",
+    "license"
+  ],
+  "scripts": {
+    "test": "(tstest test/ --verbose)",
+    "build": "(tsbuild --web --node)",
+    "buildDocs": "tsdoc"
+  }
+}

package/readme.md

@@ -0,0 +1,86 @@
+# @fin.cx/camt
+
+ISO 20022 CAMT.052/053/054 bank statement parser with exact integer-cent
+amounts and SEPA reference extraction. The go-forward statement format for
+EBICS banking (MT940 is legacy — see `@fin.cx/mt940parser` for that).
+
+Built as the ingestion layer for `@fin.cx/bankrec` (bank reconciliation) and
+the `@fin.cx/skr` accounting core: amounts never touch IEEE floats — they are
+parsed from the XML strings straight into integer cents.
+
+## Issue Reporting and Security
+
+For reporting bugs, issues, or security vulnerabilities, please visit [community.foss.global/](https://community.foss.global/). This is the central community hub for all issue reporting. Developers who sign and comply with our contribution agreement and go through identification can also get a [code.foss.global/](https://code.foss.global/) account to submit Pull Requests directly.
+
+## What This Package Does
+
+- Parses camt.053 (statements), camt.052 (account reports), and camt.054
+  (debit/credit notifications), normalized into one statement model
+- Handles the namespace versions in circulation (`.001.02` classic through
+  `.001.08`+ post-2019 EBICS); structural differences are normalized
+- Exact integer-cent amounts (`amountCents`) — `0.01` parses to `1`, never `0.010000000000000002`
+- Extracts SEPA references (EndToEndId, MandateId, TxId), counterparty
+  name/IBAN/BIC (direction-aware: debtor for credits, creditor for debits),
+  unstructured and structured remittance info (RF creditor references),
+  return reasons (e.g. AC04), reversal flags, and bank transaction codes
+- Statement-internal completeness check: opening booked balance + booked
+  movement must equal the closing booked balance to the cent
+
+## Installation
+
+```bash
+pnpm add @fin.cx/camt
+```
+
+## Usage
+
+```ts
+import { parseCamt, validateStatementConsistency } from '@fin.cx/camt';
+
+const statements = parseCamt(camtXmlString);
+
+for (const statement of statements) {
+  const consistency = validateStatementConsistency(statement);
+  if (!consistency.valid) {
+    throw new Error(`Statement broken: ${consistency.issues.join('; ')}`);
+  }
+  for (const entry of statement.entries) {
+    entry.amountCents; // integer cents, exact
+    entry.creditDebit; // 'CRDT' | 'DBIT'
+    entry.details[0]?.endToEndId;
+    entry.details[0]?.counterpartyIban;
+    entry.details[0]?.remittanceUnstructured;
+  }
+}
+```
+
+Cross-statement continuity (gapless statement sequences across files) is the
+job of `@fin.cx/bankrec`, which consumes this model.
+
+## Development
+
+```bash
+pnpm build
+pnpm test
+```
+
+## License and Legal Information
+
+This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the [license](./license) file.
+
+**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.
+
+### Trademarks
+
+This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH or third parties, and are not included within the scope of the MIT license granted herein.
+
+Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines or the guidelines of the respective third-party owners, and any usage must be approved in writing. Third-party trademarks used herein are the property of their respective owners and used only in a descriptive manner, e.g. for an implementation of an API or similar.
+
+### Company Information
+
+Task Venture Capital GmbH
+Registered at District Court Bremen HRB 35230 HB, Germany
+
+For any legal inquiries or further information, please contact us via email at hello@task.vc.
+
+By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.

package/ts/00_commitinfo_data.ts

@@ -0,0 +1,8 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export const commitinfo = {
+  name: '@fin.cx/camt',
+  version: '1.1.0',
+  description: 'ISO 20022 CAMT.052/053/054 bank statement parser with exact integer-cent amounts and SEPA reference extraction'
+}

package/ts/camt.parser.ts

@@ -0,0 +1,288 @@
+/**
+ * ISO 20022 CAMT parser (camt.052 account report, camt.053 statement,
+ * camt.054 debit/credit notification).
+ *
+ * Money safety: fast-xml-parser runs with parseTagValue/parseAttributeValue
+ * DISABLED so amounts stay strings until they are converted to exact integer
+ * cents via @fin.cx/calculation. Handles the namespace versions in circulation
+ * (.001.02 classic through .001.08+ post-2019 EBICS) — structural differences
+ * (e.g. Sts as string vs { Cd }) are normalized.
+ */
+import * as plugins from './camt.plugins.js';
+import type {
+  ICamtBalance,
+  ICamtEntry,
+  ICamtStatement,
+  ICamtTransactionDetails,
+  IStatementConsistency,
+  TCamtKind,
+  TCents,
+  TCreditDebit,
+} from './camt.types.js';
+
+const { centsFromString } = plugins.calculation;
+
+const ALWAYS_ARRAY = new Set([
+  'Stmt',
+  'Rpt',
+  'Ntfctn',
+  'Bal',
+  'Ntry',
+  'NtryDtls',
+  'TxDtls',
+  'Ustrd',
+]);
+
+function parseXml(xml: string): Record<string, unknown> {
+  const parser = new plugins.XMLParser({
+    ignoreAttributes: false,
+    attributeNamePrefix: '@_',
+    parseTagValue: false,
+    parseAttributeValue: false,
+    removeNSPrefix: true,
+    isArray: (name: string) => ALWAYS_ARRAY.has(name),
+  });
+  return parser.parse(xml) as Record<string, unknown>;
+}
+
+type TNode = Record<string, unknown> | undefined;
+
+function node(value: unknown): TNode {
+  return value && typeof value === 'object' ? (value as Record<string, unknown>) : undefined;
+}
+
+function text(value: unknown): string | undefined {
+  if (value === undefined || value === null) return undefined;
+  if (typeof value === 'string') return value;
+  if (typeof value === 'number' || typeof value === 'boolean') return String(value);
+  const asNode = node(value);
+  if (asNode && typeof asNode['#text'] === 'string') return asNode['#text'] as string;
+  return undefined;
+}
+
+function amountCentsOf(value: unknown): { amountCents: TCents; currency: string } | null {
+  const asNode = node(value);
+  const raw = text(value);
+  if (raw === undefined) return null;
+  return {
+    amountCents: centsFromString(raw),
+    currency: (asNode?.['@_Ccy'] as string) ?? '',
+  };
+}
+
+/** Sts is a plain code in camt *.001.02 and { Cd } from .001.08 on */
+function statusOf(value: unknown): string {
+  return text(value) ?? text(node(value)?.Cd) ?? '';
+}
+
+function dateOf(value: unknown): string | undefined {
+  const asNode = node(value);
+  const date = text(asNode?.Dt) ?? text(asNode?.DtTm) ?? text(value);
+  return date ? date.slice(0, 10) : undefined;
+}
+
+function partyName(value: unknown): string | undefined {
+  const asNode = node(value);
+  // .001.08 wraps the party in Pty (Dbtr > Pty > Nm); .001.02 has Nm directly
+  return text(asNode?.Nm) ?? text(node(asNode?.Pty)?.Nm);
+}
+
+function ibanOf(value: unknown): string | undefined {
+  return text(node(node(value)?.Id)?.IBAN);
+}
+
+function bicOf(value: unknown): string | undefined {
+  const fin = node(node(value)?.FinInstnId);
+  return text(fin?.BICFI) ?? text(fin?.BIC);
+}
+
+function toArray(value: unknown): unknown[] {
+  if (value === undefined || value === null) return [];
+  return Array.isArray(value) ? value : [value];
+}
+
+function parseTransactionDetails(txDtls: TNode, entryCdtDbt: TCreditDebit): ICamtTransactionDetails {
+  const refs = node(txDtls?.Refs);
+  const parties = node(txDtls?.RltdPties);
+  const agents = node(txDtls?.RltdAgts);
+  const remittance = node(txDtls?.RmtInf);
+  const returnInfo = node(txDtls?.RtrInf);
+
+  // the counterparty depends on direction: credits come FROM the debtor,
+  // debits go TO the creditor
+  const isCredit = entryCdtDbt === 'CRDT';
+  const counterparty = isCredit ? parties?.Dbtr : parties?.Cdtr;
+  const counterpartyAccount = isCredit ? parties?.DbtrAcct : parties?.CdtrAcct;
+  const counterpartyAgent = isCredit ? agents?.DbtrAgt : agents?.CdtrAgt;
+
+  const amount = amountCentsOf(txDtls?.Amt) ?? amountCentsOf(node(txDtls?.AmtDtls)?.TxAmt && node(node(txDtls?.AmtDtls)?.TxAmt)?.Amt);
+
+  const structured = node(remittance?.Strd);
+  const creditorReference = text(node(structured?.CdtrRefInf)?.Ref);
+
+  return {
+    endToEndId: text(refs?.EndToEndId),
+    mandateId: text(refs?.MndtId),
+    instructionId: text(refs?.InstrId),
+    transactionId: text(refs?.TxId),
+    paymentInformationId: text(refs?.PmtInfId),
+    counterpartyName: partyName(counterparty),
+    counterpartyIban: ibanOf(counterpartyAccount),
+    counterpartyBic: bicOf(counterpartyAgent),
+    remittanceUnstructured: toArray(remittance?.Ustrd)
+      .map((entry) => text(entry))
+      .filter((entry): entry is string => entry !== undefined),
+    creditorReference,
+    returnReasonCode: text(node(returnInfo?.Rsn)?.Cd),
+    returnAdditionalInfo: text(returnInfo?.AddtlInf),
+    amountCents: amount?.amountCents,
+    currency: amount?.currency || undefined,
+    creditDebit: (text(txDtls?.CdtDbtInd) as TCreditDebit | undefined) ?? undefined,
+  };
+}
+
+function parseEntry(ntry: TNode): ICamtEntry {
+  const amount = amountCentsOf(ntry?.Amt);
+  if (!amount) {
+    throw new Error('CAMT entry without Amt — refusing to parse a statement with unreadable amounts');
+  }
+  const creditDebit = (text(ntry?.CdtDbtInd) as TCreditDebit) ?? 'CRDT';
+  const bankCode = node(ntry?.BkTxCd);
+  const domain = node(bankCode?.Domn);
+  const family = node(domain?.Fmly);
+
+  const details: ICamtTransactionDetails[] = [];
+  for (const dtls of toArray(ntry?.NtryDtls)) {
+    for (const tx of toArray(node(dtls)?.TxDtls)) {
+      details.push(parseTransactionDetails(node(tx), creditDebit));
+    }
+  }
+
+  return {
+    amountCents: amount.amountCents,
+    currency: amount.currency,
+    creditDebit,
+    status: statusOf(ntry?.Sts),
+    bookingDate: dateOf(ntry?.BookgDt),
+    valueDate: dateOf(ntry?.ValDt),
+    accountServicerRef: text(ntry?.AcctSvcrRef),
+    entryRef: text(ntry?.NtryRef),
+    reversal: text(ntry?.RvslInd) === 'true',
+    bankTransactionCode: bankCode
+      ? {
+          domain: text(domain?.Cd),
+          family: text(family?.Cd),
+          subFamily: text(family?.SubFmlyCd),
+          proprietary: text(node(bankCode?.Prtry)?.Cd),
+        }
+      : undefined,
+    details,
+  };
+}
+
+function parseBalance(bal: TNode): ICamtBalance | null {
+  const amount = amountCentsOf(bal?.Amt);
+  if (!amount) return null;
+  const type = text(node(node(bal?.Tp)?.CdOrPrtry)?.Cd) ?? '';
+  return {
+    type,
+    amountCents: amount.amountCents,
+    currency: amount.currency,
+    creditDebit: (text(bal?.CdtDbtInd) as TCreditDebit) ?? 'CRDT',
+    date: dateOf(bal?.Dt) ?? '',
+  };
+}
+
+function parseStatement(stmt: TNode, kind: TCamtKind, messageId: string): ICamtStatement {
+  const account = node(stmt?.Acct);
+  const sequence = text(stmt?.ElctrncSeqNb);
+  return {
+    kind,
+    messageId,
+    statementId: text(stmt?.Id) ?? '',
+    sequenceNumber: sequence !== undefined ? Number.parseInt(sequence, 10) : undefined,
+    creationDateTime: text(stmt?.CreDtTm),
+    accountIban: ibanOf(account),
+    accountCurrency: text(account?.Ccy),
+    accountOwnerName: partyName(account?.Ownr),
+    servicerBic: bicOf(account?.Svcr),
+    balances: toArray(stmt?.Bal)
+      .map((bal) => parseBalance(node(bal)))
+      .filter((bal): bal is ICamtBalance => bal !== null),
+    entries: toArray(stmt?.Ntry).map((ntry) => parseEntry(node(ntry))),
+  };
+}
+
+/**
+ * Parse a CAMT.052/053/054 document into normalized statements.
+ */
+export function parseCamt(xml: string): ICamtStatement[] {
+  const document = node(parseXml(xml).Document);
+  if (!document) {
+    throw new Error('Not an ISO 20022 document (no Document root)');
+  }
+
+  const statementRoot =
+    node(document.BkToCstmrStmt) ?? node(document.BkToCstmrAcctRpt) ?? node(document.BkToCstmrDbtCdtNtfctn);
+  if (!statementRoot) {
+    throw new Error(
+      'Unsupported ISO 20022 message — expected BkToCstmrStmt (053), BkToCstmrAcctRpt (052), or BkToCstmrDbtCdtNtfctn (054)',
+    );
+  }
+  const kind: TCamtKind = document.BkToCstmrStmt
+    ? '053'
+    : document.BkToCstmrAcctRpt
+      ? '052'
+      : '054';
+  const containers =
+    kind === '053' ? statementRoot.Stmt : kind === '052' ? statementRoot.Rpt : statementRoot.Ntfctn;
+  const messageId = text(node(statementRoot.GrpHdr)?.MsgId) ?? '';
+
+  return toArray(containers).map((stmt) => parseStatement(node(stmt), kind, messageId));
+}
+
+function signed(balance: ICamtBalance): TCents {
+  return balance.creditDebit === 'CRDT' ? balance.amountCents : -balance.amountCents;
+}
+
+/**
+ * Statement-internal completeness check: opening booked balance plus booked
+ * entry movement must equal the closing booked balance, exactly.
+ * Cross-statement continuity (gapless sequence of statements) lives in
+ * @fin.cx/bankrec.
+ */
+export function validateStatementConsistency(statement: ICamtStatement): IStatementConsistency {
+  const issues: string[] = [];
+  const opening =
+    statement.balances.find((bal) => bal.type === 'OPBD') ??
+    statement.balances.find((bal) => bal.type === 'PRCD');
+  const closing = statement.balances.find((bal) => bal.type === 'CLBD');
+
+  let movement = 0;
+  for (const entry of statement.entries) {
+    if (entry.status !== 'BOOK') continue;
+    movement += entry.creditDebit === 'CRDT' ? entry.amountCents : -entry.amountCents;
+  }
+
+  if (!opening) issues.push('no opening balance (OPBD/PRCD)');
+  if (!closing) issues.push('no closing balance (CLBD)');
+  if (opening && closing) {
+    const expected = signed(opening) + movement;
+    if (expected !== signed(closing)) {
+      issues.push(
+        `balance chain broken: opening ${signed(opening)} + movement ${movement} = ${expected} !== closing ${signed(closing)} (cents)`,
+      );
+    }
+    if (opening.currency !== closing.currency) {
+      issues.push(`currency mismatch: ${opening.currency} vs ${closing.currency}`);
+    }
+  }
+
+  return {
+    valid: issues.length === 0,
+    issues,
+    openingCents: opening ? signed(opening) : null,
+    closingCents: closing ? signed(closing) : null,
+    bookedMovementCents: movement,
+  };
+}

package/ts/camt.plugins.ts

@@ -0,0 +1,4 @@
+import * as calculation from '@fin.cx/calculation';
+import { XMLParser } from 'fast-xml-parser';
+
+export { calculation, XMLParser };

package/ts/camt.types.ts

@@ -0,0 +1,87 @@
+import type { TCents } from '@fin.cx/calculation';
+
+export type { TCents };
+
+export type TCamtKind = '052' | '053' | '054';
+
+export type TCreditDebit = 'CRDT' | 'DBIT';
+
+/**
+ * Balance types per ISO 20022: OPBD opening booked, CLBD closing booked,
+ * PRCD previously closed booked, CLAV closing available, FWAV forward
+ * available, ITBD interim booked.
+ */
+export interface ICamtBalance {
+  type: string;
+  amountCents: TCents;
+  currency: string;
+  creditDebit: TCreditDebit;
+  /** ISO date (YYYY-MM-DD) */
+  date: string;
+}
+
+export interface ICamtTransactionDetails {
+  endToEndId?: string;
+  mandateId?: string;
+  instructionId?: string;
+  transactionId?: string;
+  paymentInformationId?: string;
+  counterpartyName?: string;
+  counterpartyIban?: string;
+  counterpartyBic?: string;
+  remittanceUnstructured: string[];
+  /** structured creditor reference (RF...) when present */
+  creditorReference?: string;
+  returnReasonCode?: string;
+  returnAdditionalInfo?: string;
+  /** per-transaction amount inside batch entries */
+  amountCents?: TCents;
+  currency?: string;
+  creditDebit?: TCreditDebit;
+}
+
+export interface ICamtEntry {
+  amountCents: TCents;
+  currency: string;
+  creditDebit: TCreditDebit;
+  /** BOOK, PDNG, INFO */
+  status: string;
+  /** ISO date (YYYY-MM-DD) */
+  bookingDate?: string;
+  valueDate?: string;
+  accountServicerRef?: string;
+  entryRef?: string;
+  reversal: boolean;
+  bankTransactionCode?: {
+    domain?: string;
+    family?: string;
+    subFamily?: string;
+    proprietary?: string;
+  };
+  /** one per TxDtls; batch entries carry several */
+  details: ICamtTransactionDetails[];
+}
+
+export interface ICamtStatement {
+  kind: TCamtKind;
+  messageId: string;
+  statementId: string;
+  /** electronic sequence number when the bank provides one */
+  sequenceNumber?: number;
+  creationDateTime?: string;
+  accountIban?: string;
+  accountCurrency?: string;
+  accountOwnerName?: string;
+  servicerBic?: string;
+  balances: ICamtBalance[];
+  entries: ICamtEntry[];
+}
+
+export interface IStatementConsistency {
+  valid: boolean;
+  issues: string[];
+  /** signed cents: opening booked balance (DBIT negative) */
+  openingCents: TCents | null;
+  closingCents: TCents | null;
+  bookedMovementCents: TCents;
+}

package/ts/index.ts

@@ -0,0 +1,2 @@
+export * from './camt.types.js';
+export * from './camt.parser.js';