@perrylink/dsh-bankrec 0.1.0-alpha.3 → 0.1.0-alpha.4

package/README.md

@@ -1,3 +1,3 @@
 # @perrylink/dsh-bankrec
 Bank CSV/GL ingest, 1:1 matching and 3-sheet reconciliation workpaper — SKU-06 S1 public/synthetic demo. **Partial, not GA**: 0 real firms; user-approved public/synthetic (2026-10-31).
-Tools: `bankrec.ingest`, `bankrec.ingest_camt` (CAMT.053), `bankrec.reconcile_camt`, `bankrec.match`, `bankrec.export` (Bank/GL/Matches xlsx). Env `DSH_BANKREC_HOME`. Apache-2.0.
+Tools: `bankrec.ingest`, `bankrec.ingest_camt` (CAMT.053), `bankrec.ingest_mt940`, `bankrec.reconcile_camt`, `bankrec.match`, `bankrec.export` (Bank/GL/Matches xlsx). Env `DSH_BANKREC_HOME`. Apache-2.0.

package/lib/core/mt940.d.ts

@@ -0,0 +1,7 @@
+import type { TxnRecord } from '../plugin/storage.js';
+export declare function parseMt940(text: string, accountOverride?: string, evidenceSha?: string): TxnRecord[];
+export interface Mt940Balance {
+    opening_cents: number;
+    closing_cents: number;
+}
+export declare function parseMt940Balances(text: string): Mt940Balance;

package/lib/core/mt940.js

@@ -0,0 +1,55 @@
+import { createHash } from 'node:crypto';
+import { BankrecError, cents } from './bankrec.js';
+function dateOf(yymmdd) {
+    if (!/^\d{6}$/.test(yymmdd))
+        throw new BankrecError('E_BR_CSV_INVALID', `MT940 bad date: ${yymmdd}`);
+    return `20${yymmdd.slice(0, 2)}-${yymmdd.slice(2, 4)}-${yymmdd.slice(4, 6)}`;
+}
+export function parseMt940(text, accountOverride, evidenceSha) {
+    const lines = text.replace(/\r/g, '').split('\n');
+    const account = accountOverride?.trim() || lines.find((line) => line.startsWith(':25:'))?.slice(4).trim() || '';
+    if (!account)
+        throw new BankrecError('E_BR_CSV_INVALID', 'MT940 has no :25: account');
+    const evidence = evidenceSha ?? createHash('sha256').update(text).digest('hex');
+    const out = [];
+    let pending;
+    for (const line of lines) {
+        if (line.startsWith(':61:')) {
+            const body = line.slice(4);
+            const match = body.match(/^(\d{6})(?:\d{4})?([CD]R?)([\d.,]+)([A-Z].*)$/);
+            if (!match)
+                throw new BankrecError('E_BR_CSV_INVALID', `MT940 bad :61: ${line}`);
+            const sign = match[2].startsWith('D') ? -1 : 1;
+            const amount = sign * cents(match[3].replace(/\./g, '').replace(',', '.'));
+            const tail = match[4];
+            const refMatch = tail.match(/\/\/(.+)$/);
+            const reference = refMatch?.[1] ?? tail.replace(/^[A-Z]{4}/, '').slice(0, 80) ?? 'mt940';
+            pending = { date: dateOf(match[1]), amount, reference };
+            out.push({ txn_id: `mt940-${account}-${match[1]}-${out.length}`, account_id: account, period: pending.date.slice(0, 7), side: 'bank', date: pending.date, amount_cents: amount, reference, evidence_sha256: evidence, created_at: new Date().toISOString() });
+        }
+        else if (line.startsWith(':86:') && pending) {
+            const description = line.slice(4).trim();
+            if (description) {
+                const last = out[out.length - 1];
+                if (last)
+                    last.reference = `${last.reference} ${description}`.trim().slice(0, 200);
+            }
+        }
+    }
+    if (out.length === 0)
+        throw new BankrecError('E_BR_CSV_INVALID', 'MT940 has no :61: entries');
+    return out;
+}
+export function parseMt940Balances(text) {
+    const line60 = text.split(/\r?\n/).find((line) => line.startsWith(':60F:'));
+    const line62 = text.split(/\r?\n/).find((line) => line.startsWith(':62F:'));
+    const parse = (line) => {
+        if (!line)
+            throw new BankrecError('E_BR_CSV_INVALID', 'MT940 lacks :60F:/:62F:');
+        const m = line.match(/^:[0-9]{2}F:([CD])(\d{6})[A-Z]{3}([\d.,]+)$/);
+        if (!m)
+            throw new BankrecError('E_BR_CSV_INVALID', `bad MT940 balance: ${line}`);
+        return (m[1] === 'D' ? -1 : 1) * cents(m[3].replace(/\./g, '').replace(',', '.'));
+    };
+    return { opening_cents: parse(line60), closing_cents: parse(line62) };
+}

package/lib/plugin/tools.js

@@ -5,6 +5,7 @@ import * as XLSX from 'xlsx';
 import { defineTool } from '@deepseek-ai/dsh-tools';
 import { BankrecError, parseCsv } from '../core/bankrec.js';
 import { parseCamt, parseCamtBalances } from '../core/camt.js';
+import { parseMt940 } from '../core/mt940.js';
 const text = (t) => [{ type: 'text', text: t }];
 const sha = (v) => createHash('sha256').update(v).digest('hex');
 export function createTools(deps) {
@@ -25,8 +26,10 @@ export function createTools(deps) {
     const camt = defineTool({ name: 'bankrec.ingest_camt', description: 'Ingest CAMT.053 XML bank statement entries; supports DBIT/CRDT and stores bank rows. Local R1 write.', parameters: { camt_xml: { type: 'string', required: true }, account_id: { type: 'string' } }, output: { schema: { type: 'object', additionalProperties: false, properties: { rows: { type: 'number', required: true }, accounts: { type: 'array', items: { type: 'string' }, required: true }, periods: { type: 'array', items: { type: 'string' }, required: true } } }, render: (_a, v) => text(`CAMT rows=${v.rows}`) }, async execute(a) { const rows = parseCamt(a.camt_xml, a.account_id); for (const t of rows)
             await deps.transactions.put(t.txn_id, t); return { rows: rows.length, accounts: [...new Set(rows.map(r => r.account_id))], periods: [...new Set(rows.map(r => r.period))] }; } });
     const exportTool = defineTool({ name: 'bankrec.export', description: 'Export 3-sheet reconciliation xlsx (Bank, GL, Matches). Local R1 write.', parameters: { account_id: { type: 'string', required: true }, period: { type: 'string', required: true } }, output: { schema: { type: 'object', additionalProperties: false, properties: { path: { type: 'string', required: true }, sha256: { type: 'string', required: true }, sheets: { type: 'number', required: true } } }, render: (_a, v) => text(`export ${v.sheets} sheets`) }, async execute(args) { const all = [...deps.transactions.entries()].map(([, v]) => v).filter(t => t.account_id === args.account_id && t.period === args.period); const ms = [...deps.matches.entries()].map(([, v]) => v); const wb = XLSX.utils.book_new(); XLSX.utils.book_append_sheet(wb, XLSX.utils.json_to_sheet(all.filter(t => t.side === 'bank').map(t => ({ date: t.date, amount_cents: t.amount_cents, reference: t.reference, txn_id: t.txn_id }))), 'Bank'); XLSX.utils.book_append_sheet(wb, XLSX.utils.json_to_sheet(all.filter(t => t.side === 'gl').map(t => ({ date: t.date, amount_cents: t.amount_cents, reference: t.reference, txn_id: t.txn_id }))), 'GL'); XLSX.utils.book_append_sheet(wb, XLSX.utils.json_to_sheet(ms), 'Matches'); const dir = path.join(deps.baseDir, 'exports'); await mkdir(dir, { recursive: true }); const p = path.join(dir, `${args.account_id}-${args.period}.xlsx`); const b = Buffer.from(XLSX.write(wb, { type: 'buffer', bookType: 'xlsx' })); await writeFile(p, b); return { path: p, sha256: sha(b), sheets: wb.SheetNames.length }; } });
+    const mt940 = defineTool({ name: 'bankrec.ingest_mt940', description: 'Ingest MT940 statement entries; local R1 write.', parameters: { mt940_text: { type: 'string', required: true }, account_id: { type: 'string' } }, output: { schema: { type: 'object', additionalProperties: false, properties: { rows: { type: 'number', required: true }, account: { type: 'string', required: true } } }, render: (_a, v) => text(`MT940 rows=${v.rows}`) }, async execute(a) { const rows = parseMt940(a.mt940_text, a.account_id); for (const t of rows)
+            await deps.transactions.put(t.txn_id, t); return { rows: rows.length, account: rows[0].account_id }; } });
     const reconcile = defineTool({ name: 'bankrec.reconcile_camt', description: 'Check CAMT.053 opening/closing balance continuity against the sum of entries; read-only.', parameters: { camt_xml: { type: 'string', required: true }, account_id: { type: 'string' } }, output: { schema: { type: 'object', additionalProperties: false, properties: { opening_cents: { type: 'number', required: true }, closing_cents: { type: 'number', required: true }, net_cents: { type: 'number', required: true }, difference_cents: { type: 'number', required: true }, balanced: { type: 'boolean', required: true } } }, render: (_a, v) => text(`CAMT balance ${v.balanced ? 'ok' : 'DIFF'} (${v.difference_cents})`) }, async execute(a) { const allBalances = parseCamtBalances(a.camt_xml); const accounts = [...new Set(allBalances.map(b => b.account))]; const account = a.account_id ?? (accounts.length === 1 ? accounts[0] : undefined); if (!account)
             throw new BankrecError('E_BR_CSV_INVALID', 'multiple accounts; account_id required'); const balances = allBalances.filter(b => b.account === account); const rows = parseCamt(a.camt_xml).filter(r => r.account_id === account); const open = balances.find(b => /^OPBD|^PRCD/.test(b.type)); const close = balances.find(b => /^CLBD|^CLAV/.test(b.type)); if (!open || !close)
             throw new BankrecError('E_BR_CSV_INVALID', 'CAMT lacks opening/closing balance'); const net = rows.reduce((n, r) => n + r.amount_cents, 0); const diff = open.amount_cents + net - close.amount_cents; return { opening_cents: open.amount_cents, closing_cents: close.amount_cents, net_cents: net, difference_cents: diff, balanced: diff === 0 }; } });
-    return [ingest, camt, match, reconcile, exportTool];
+    return [ingest, camt, mt940, match, reconcile, exportTool];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@perrylink/dsh-bankrec",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.4",
   "description": "Bank statement ingest, 1:1 matching and reconciliation workpaper (SKU-06 S1 public/synthetic demo).",
   "type": "module",
   "main": "./lib/plugin/index.js",