@bank-mcp/server 0.1.0

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG"}

package/dist/index.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+/**
+ * bank-mcp — Banking data MCP server
+ *
+ * Usage:
+ *   npx @bank-mcp/server          Start MCP server (for MCP clients)
+ *   npx @bank-mcp/server init     Interactive setup wizard
+ *   npx @bank-mcp/server --mock   Start with mock data (no config needed)
+ */
+import { startServer } from "./server.js";
+import { runInit } from "./init.js";
+const args = process.argv.slice(2);
+if (args.includes("init")) {
+    runInit().catch((err) => {
+        console.error("Init failed:", err);
+        process.exit(1);
+    });
+}
+else if (args.includes("--mock")) {
+    // Force mock provider: override config to use mock connection
+    process.env.BANK_MCP_MOCK = "1";
+    startServer().catch((err) => {
+        console.error("Server failed:", err);
+        process.exit(1);
+    });
+}
+else {
+    startServer().catch((err) => {
+        console.error("Server failed:", err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEnC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;IAC1B,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACtB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;KAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;IACnC,8DAA8D;IAC9D,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,GAAG,CAAC;IAChC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QAC1B,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;KAAM,CAAC;IACN,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QAC1B,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Interactive setup wizard — walks the user through configuring a
+ * bank connection. Uses plain readline (no heavy dependencies).
+ */
+export declare function runInit(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAkG7C"}

package/dist/init.js

@@ -0,0 +1,96 @@
+import { createInterface } from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+import { loadConfig, saveConfig, getConfigPath } from "./config.js";
+import { listProviders } from "./providers/registry.js";
+/**
+ * Interactive setup wizard — walks the user through configuring a
+ * bank connection. Uses plain readline (no heavy dependencies).
+ */
+export async function runInit() {
+    const rl = createInterface({ input: stdin, output: stdout });
+    try {
+        console.log("\n  bank-mcp — Banking data for your AI assistant\n");
+        // 1. Select provider
+        const providers = listProviders();
+        console.log("  Available providers:");
+        providers.forEach((p, i) => {
+            console.log(`    ${i + 1}. ${p.displayName}`);
+        });
+        const providerIdx = parseInt(await rl.question("\n? Select provider (number): "), 10) - 1;
+        const provider = providers[providerIdx];
+        if (!provider) {
+            console.error("  Invalid selection.");
+            return;
+        }
+        // 2. Collect config fields
+        const schema = provider.getConfigSchema();
+        const config = {};
+        for (const field of schema) {
+            const label = field.required ? field.label : `${field.label} (optional)`;
+            const defaultHint = field.default ? ` [${field.default}]` : "";
+            const answer = await rl.question(`? ${label}${defaultHint}: `);
+            config[field.name] = answer || field.default || "";
+        }
+        // 3. Connection label
+        const label = await rl.question("? Connection label (e.g. ING Bank - Main): ");
+        // 4. Connection ID (slug from label)
+        const id = (label || provider.name)
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, "-")
+            .replace(/^-|-$/g, "");
+        // 5. Validate by fetching accounts
+        console.log("\n  Validating connection...");
+        try {
+            provider.validateConfig(config);
+            const accounts = await provider.listAccounts(config);
+            if (accounts.length === 0) {
+                console.log("  Warning: No accounts found. Config saved anyway.\n");
+            }
+            else {
+                console.log(`  Found ${accounts.length} account(s):`);
+                for (const acc of accounts) {
+                    console.log(`    - ${acc.iban} (${acc.name}, ${acc.currency})`);
+                }
+                // Store fetched accounts in config for faster subsequent access
+                config.accounts = accounts.map((a) => ({
+                    uid: a.uid,
+                    iban: a.iban,
+                    name: a.name,
+                    currency: a.currency,
+                }));
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`  Validation failed: ${msg}`);
+            const proceed = await rl.question("  Save anyway? (y/N): ");
+            if (proceed.toLowerCase() !== "y")
+                return;
+        }
+        // 6. Save config
+        const appConfig = loadConfig();
+        const connection = {
+            id,
+            provider: provider.name,
+            label: label || provider.displayName,
+            config,
+        };
+        // Replace if same ID exists, otherwise append
+        const existing = appConfig.connections.findIndex((c) => c.id === id);
+        if (existing >= 0) {
+            appConfig.connections[existing] = connection;
+        }
+        else {
+            appConfig.connections.push(connection);
+        }
+        saveConfig(appConfig);
+        console.log(`\n  Config saved to ${getConfigPath()}`);
+        console.log(`\n  Add to your MCP client config (.mcp.json):`);
+        console.log(`  { "mcpServers": { "bank": { "command": "npx", "args": ["@bank-mcp/server"] } } }`);
+        console.log();
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

package/dist/providers/base.d.ts

@@ -0,0 +1,22 @@
+import type { BankAccount, Transaction, Balance, TransactionFilter, ConfigField } from "../types.js";
+/**
+ * Abstract base for all bank providers.
+ *
+ * Each provider translates a specific banking API into the normalized
+ * BankAccount / Transaction / Balance types.
+ */
+export declare abstract class BankProvider {
+    abstract readonly name: string;
+    abstract readonly displayName: string;
+    /** Throw if required config fields are missing or invalid. */
+    abstract validateConfig(config: Record<string, unknown>): void;
+    /** Fetch all accounts accessible via this connection. */
+    abstract listAccounts(config: Record<string, unknown>): Promise<BankAccount[]>;
+    /** Fetch transactions with optional filtering. */
+    abstract listTransactions(config: Record<string, unknown>, accountId: string, filter?: TransactionFilter): Promise<Transaction[]>;
+    /** Fetch current balance(s) for an account. */
+    abstract getBalance(config: Record<string, unknown>, accountId: string): Promise<Balance[]>;
+    /** Describe config fields for the init wizard. */
+    abstract getConfigSchema(): ConfigField[];
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/providers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/providers/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,OAAO,EACP,iBAAiB,EACjB,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,8BAAsB,YAAY;IAChC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAEtC,8DAA8D;IAC9D,QAAQ,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAE9D,yDAAyD;IACzD,QAAQ,CAAC,YAAY,CACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,WAAW,EAAE,CAAC;IAEzB,kDAAkD;IAClD,QAAQ,CAAC,gBAAgB,CACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,WAAW,EAAE,CAAC;IAEzB,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,CACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,EAAE,CAAC;IAErB,kDAAkD;IAClD,QAAQ,CAAC,eAAe,IAAI,WAAW,EAAE;CAC1C"}

package/dist/providers/base.js

@@ -0,0 +1,9 @@
+/**
+ * Abstract base for all bank providers.
+ *
+ * Each provider translates a specific banking API into the normalized
+ * BankAccount / Transaction / Balance types.
+ */
+export class BankProvider {
+}
+//# sourceMappingURL=base.js.map

package/dist/providers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/providers/base.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,MAAM,OAAgB,YAAY;CA2BjC"}

package/dist/providers/enable-banking/auth.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generate a JWT for Enable Banking API authentication.
+ *
+ * RS256 with kid=appId in the header. Tokens live 1 hour.
+ * A fresh token is generated per request — no caching needed
+ * since generation is sub-millisecond.
+ */
+export declare function generateJwt(appId: string, privateKeyPath: string): string;
+//# sourceMappingURL=auth.d.ts.map

package/dist/providers/enable-banking/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/providers/enable-banking/auth.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAoBzE"}

package/dist/providers/enable-banking/auth.js

@@ -0,0 +1,30 @@
+import jwt from "jsonwebtoken";
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+/**
+ * Generate a JWT for Enable Banking API authentication.
+ *
+ * RS256 with kid=appId in the header. Tokens live 1 hour.
+ * A fresh token is generated per request — no caching needed
+ * since generation is sub-millisecond.
+ */
+export function generateJwt(appId, privateKeyPath) {
+    const expandedPath = privateKeyPath.replace(/^~/, process.env.HOME || "");
+    const privateKey = readFileSync(resolve(expandedPath), "utf-8");
+    const now = Math.floor(Date.now() / 1000);
+    const payload = {
+        iss: "enablebanking.com",
+        aud: "api.enablebanking.com",
+        iat: now,
+        exp: now + 3600,
+    };
+    return jwt.sign(payload, privateKey, {
+        algorithm: "RS256",
+        header: {
+            alg: "RS256",
+            typ: "JWT",
+            kid: appId,
+        },
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/providers/enable-banking/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/providers/enable-banking/auth.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,cAAc,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,cAAsB;IAC/D,MAAM,YAAY,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC1E,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;IAEhE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG;QACd,GAAG,EAAE,mBAAmB;QACxB,GAAG,EAAE,uBAAuB;QAC5B,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG,GAAG,IAAI;KAChB,CAAC;IAEF,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE;QACnC,SAAS,EAAE,OAAO;QAClB,MAAM,EAAE;YACN,GAAG,EAAE,OAAO;YACZ,GAAG,EAAE,KAAK;YACV,GAAG,EAAE,KAAK;SACX;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/providers/enable-banking/index.d.ts

@@ -0,0 +1,12 @@
+import { BankProvider } from "../base.js";
+import type { BankAccount, Transaction, Balance, TransactionFilter, ConfigField } from "../../types.js";
+export declare class EnableBankingProvider extends BankProvider {
+    readonly name = "enable-banking";
+    readonly displayName = "Enable Banking (PSD2)";
+    validateConfig(config: Record<string, unknown>): void;
+    getConfigSchema(): ConfigField[];
+    listAccounts(config: Record<string, unknown>): Promise<BankAccount[]>;
+    listTransactions(config: Record<string, unknown>, accountId: string, filter?: TransactionFilter): Promise<Transaction[]>;
+    getBalance(config: Record<string, unknown>, accountId: string): Promise<Balance[]>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/enable-banking/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/enable-banking/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,OAAO,EACP,iBAAiB,EACjB,WAAW,EACZ,MAAM,gBAAgB,CAAC;AA8BxB,qBAAa,qBAAsB,SAAQ,YAAY;IACrD,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,2BAA2B;IAE/C,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIrD,eAAe,IAAI,WAAW,EAAE;IAuB1B,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA6BrE,gBAAgB,CACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,WAAW,EAAE,CAAC;IAwDnB,UAAU,CACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,EAAE,CAAC;CAqBtB"}

package/dist/providers/enable-banking/index.js

@@ -0,0 +1,171 @@
+import { BankProvider } from "../base.js";
+import { generateJwt } from "./auth.js";
+import { httpFetch } from "../../utils/http.js";
+const API_BASE = "https://api.enablebanking.com";
+function parseConfig(raw) {
+    const appId = raw.appId;
+    const privateKeyPath = raw.privateKeyPath;
+    const sessionId = raw.sessionId;
+    if (!appId || !privateKeyPath || !sessionId) {
+        throw new Error("Enable Banking config requires: appId, privateKeyPath, sessionId");
+    }
+    return {
+        appId,
+        privateKeyPath,
+        sessionId,
+        validUntil: raw.validUntil,
+        accounts: raw.accounts,
+    };
+}
+export class EnableBankingProvider extends BankProvider {
+    name = "enable-banking";
+    displayName = "Enable Banking (PSD2)";
+    validateConfig(config) {
+        parseConfig(config);
+    }
+    getConfigSchema() {
+        return [
+            {
+                name: "appId",
+                label: "App ID",
+                type: "string",
+                required: true,
+            },
+            {
+                name: "privateKeyPath",
+                label: "Path to RSA private key (.pem)",
+                type: "path",
+                required: true,
+            },
+            {
+                name: "sessionId",
+                label: "Session ID",
+                type: "string",
+                required: true,
+            },
+        ];
+    }
+    async listAccounts(config) {
+        const eb = parseConfig(config);
+        // If accounts are cached in config, return those
+        if (eb.accounts?.length) {
+            return eb.accounts.map((a) => ({
+                uid: a.uid,
+                iban: a.iban,
+                name: a.name,
+                currency: a.currency,
+                connectionId: "", // filled by caller
+            }));
+        }
+        // Otherwise fetch from API
+        const token = generateJwt(eb.appId, eb.privateKeyPath);
+        const data = (await httpFetch(`${API_BASE}/sessions/${eb.sessionId}`, {
+            headers: authHeaders(token),
+        }));
+        return data.accounts.map((a) => ({
+            uid: a.uid,
+            iban: a.iban,
+            name: a.account_name || a.iban,
+            currency: a.currency || "EUR",
+            connectionId: "",
+        }));
+    }
+    async listTransactions(config, accountId, filter) {
+        const eb = parseConfig(config);
+        const token = generateJwt(eb.appId, eb.privateKeyPath);
+        const headers = authHeaders(token);
+        const allTx = [];
+        let continuationKey;
+        // Pagination loop — Enable Banking uses continuation_key cursor
+        do {
+            const params = new URLSearchParams();
+            if (filter?.dateFrom)
+                params.set("date_from", filter.dateFrom);
+            if (filter?.dateTo)
+                params.set("date_to", filter.dateTo);
+            if (continuationKey)
+                params.set("continuation_key", continuationKey);
+            const qs = params.toString();
+            const url = `${API_BASE}/accounts/${accountId}/transactions${qs ? `?${qs}` : ""}`;
+            const data = (await httpFetch(url, {
+                headers,
+                timeoutMs: 60000,
+            }));
+            for (const raw of data.transactions) {
+                allTx.push(normalizeTransaction(raw, accountId));
+            }
+            continuationKey = data.continuation_key;
+        } while (continuationKey);
+        // Apply local filters the API doesn't support natively
+        let filtered = allTx;
+        if (filter?.amountMin !== undefined) {
+            filtered = filtered.filter((t) => Math.abs(t.amount) >= filter.amountMin);
+        }
+        if (filter?.amountMax !== undefined) {
+            filtered = filtered.filter((t) => Math.abs(t.amount) <= filter.amountMax);
+        }
+        if (filter?.type) {
+            filtered = filtered.filter((t) => t.type === filter.type);
+        }
+        if (filter?.limit) {
+            filtered = filtered.slice(0, filter.limit);
+        }
+        return filtered;
+    }
+    async getBalance(config, accountId) {
+        const eb = parseConfig(config);
+        const token = generateJwt(eb.appId, eb.privateKeyPath);
+        const data = (await httpFetch(`${API_BASE}/accounts/${accountId}/balances`, { headers: authHeaders(token) }));
+        return data.balances.map((b) => ({
+            accountId,
+            amount: parseFloat(b.balance_amount.amount),
+            currency: b.balance_amount.currency,
+            type: b.balance_type,
+        }));
+    }
+}
+// --- Internal helpers ---
+function authHeaders(token) {
+    return {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json",
+        Accept: "application/json",
+    };
+}
+/**
+ * Normalize an Enable Banking raw transaction into our standard format.
+ *
+ * Direction logic:
+ *   DBIT → expense: merchant = creditor.name (who you paid)
+ *   CRDT → income:  merchant = debtor.name (who paid you)
+ *
+ * Description priority: counterpart name > remittance text > "Unknown"
+ */
+function normalizeTransaction(raw, accountId) {
+    const amount = parseFloat(raw.transaction_amount.amount);
+    const cdi = raw.credit_debit_indicator || "";
+    const isDebit = cdi === "DBIT" || amount < 0;
+    // Build remittance text (defensive: can be array or string)
+    const remittance = Array.isArray(raw.remittance_information)
+        ? raw.remittance_information.join(" ")
+        : String(raw.remittance_information || "");
+    // Counterpart name depends on direction
+    const merchantName = isDebit ? raw.creditor?.name : raw.debtor?.name;
+    const description = merchantName || remittance || "Unknown transaction";
+    // Unique ID: entry_reference preferred, fallback to composed ID
+    const id = raw.entry_reference ||
+        `eb:${accountId}:${raw.transaction_id || Date.now()}`;
+    return {
+        id,
+        accountId,
+        date: raw.booking_date || new Date().toISOString().slice(0, 10),
+        amount: isDebit ? -Math.abs(amount) : Math.abs(amount),
+        currency: raw.transaction_amount.currency,
+        description,
+        merchantName: merchantName || undefined,
+        type: isDebit ? "debit" : "credit",
+        reference: remittance || undefined,
+        rawData: raw,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/enable-banking/index.js.map

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

package/dist/providers/mock/index.d.ts

@@ -0,0 +1,18 @@
+import { BankProvider } from "../base.js";
+import type { BankAccount, Transaction, Balance, TransactionFilter, ConfigField } from "../../types.js";
+/**
+ * Mock provider with deterministic fake data.
+ * Used for demos, testing, and development without real bank credentials.
+ *
+ * Run with: npx @bank-mcp/server --mock
+ */
+export declare class MockProvider extends BankProvider {
+    readonly name = "mock";
+    readonly displayName = "Mock Bank (Demo Data)";
+    validateConfig(): void;
+    getConfigSchema(): ConfigField[];
+    listAccounts(): Promise<BankAccount[]>;
+    listTransactions(_config: Record<string, unknown>, accountId: string, filter?: TransactionFilter): Promise<Transaction[]>;
+    getBalance(_config: Record<string, unknown>, accountId: string): Promise<Balance[]>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/mock/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/mock/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,OAAO,EACP,iBAAiB,EACjB,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,WAAW,2BAA2B;IAE/C,cAAc,IAAI,IAAI;IAItB,eAAe,IAAI,WAAW,EAAE;IAI1B,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAmBtC,gBAAgB,CACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,WAAW,EAAE,CAAC;IAyBnB,UAAU,CACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,EAAE,CAAC;CAqBtB"}

package/dist/providers/mock/index.js

@@ -0,0 +1,151 @@
+import { BankProvider } from "../base.js";
+/**
+ * Mock provider with deterministic fake data.
+ * Used for demos, testing, and development without real bank credentials.
+ *
+ * Run with: npx @bank-mcp/server --mock
+ */
+export class MockProvider extends BankProvider {
+    name = "mock";
+    displayName = "Mock Bank (Demo Data)";
+    validateConfig() {
+        // No config needed
+    }
+    getConfigSchema() {
+        return [];
+    }
+    async listAccounts() {
+        return [
+            {
+                uid: "mock-checking-001",
+                iban: "PL61109010140000071219812874",
+                name: "Konto Direct",
+                currency: "PLN",
+                connectionId: "",
+            },
+            {
+                uid: "mock-savings-001",
+                iban: "PL72109010140000071219812999",
+                name: "Konto Oszczednosciowe",
+                currency: "PLN",
+                connectionId: "",
+            },
+        ];
+    }
+    async listTransactions(_config, accountId, filter) {
+        let txs = generateMockTransactions(accountId);
+        if (filter?.dateFrom) {
+            txs = txs.filter((t) => t.date >= filter.dateFrom);
+        }
+        if (filter?.dateTo) {
+            txs = txs.filter((t) => t.date <= filter.dateTo);
+        }
+        if (filter?.amountMin !== undefined) {
+            txs = txs.filter((t) => Math.abs(t.amount) >= filter.amountMin);
+        }
+        if (filter?.amountMax !== undefined) {
+            txs = txs.filter((t) => Math.abs(t.amount) <= filter.amountMax);
+        }
+        if (filter?.type) {
+            txs = txs.filter((t) => t.type === filter.type);
+        }
+        if (filter?.limit) {
+            txs = txs.slice(0, filter.limit);
+        }
+        return txs;
+    }
+    async getBalance(_config, accountId) {
+        const amounts = {
+            "mock-checking-001": 12450.67,
+            "mock-savings-001": 45000.0,
+        };
+        return [
+            {
+                accountId,
+                amount: amounts[accountId] || 1000.0,
+                currency: "PLN",
+                type: "closingBooked",
+            },
+            {
+                accountId,
+                amount: (amounts[accountId] || 1000.0) + 250.0,
+                currency: "PLN",
+                type: "expected",
+            },
+        ];
+    }
+}
+function generateMockTransactions(accountId) {
+    const today = new Date();
+    const txs = [];
+    const merchants = [
+        { name: "Biedronka", min: 30, max: 180 },
+        { name: "Lidl", min: 40, max: 200 },
+        { name: "Żabka", min: 5, max: 45 },
+        { name: "Orlen", min: 150, max: 350 },
+        { name: "Allegro", min: 20, max: 500 },
+        { name: "Netflix", min: 43, max: 43 },
+        { name: "Spotify", min: 29.99, max: 29.99 },
+        { name: "PZU Ubezpieczenie", min: 180, max: 180 },
+        { name: "Orange Polska", min: 79, max: 79 },
+        { name: "Inea Internet", min: 69, max: 69 },
+    ];
+    const incomes = [
+        { name: "TechCorp Sp. z o.o.", amount: 12500, desc: "Wynagrodzenie" },
+        { name: "Freelance Client", amount: 3500, desc: "Faktura 2026/02" },
+    ];
+    // Generate 90 days of transactions (deterministic via simple seed)
+    for (let day = 0; day < 90; day++) {
+        const date = new Date(today);
+        date.setDate(date.getDate() - day);
+        const dateStr = date.toISOString().slice(0, 10);
+        // 1-3 expenses per day
+        const txCount = (day % 3) + 1;
+        for (let i = 0; i < txCount; i++) {
+            const merchant = merchants[(day * 3 + i) % merchants.length];
+            const amount = merchant.min === merchant.max
+                ? merchant.min
+                : merchant.min +
+                    ((day * 7 + i * 13) % (merchant.max - merchant.min));
+            txs.push({
+                id: `mock-tx-${accountId}-${day}-${i}`,
+                accountId,
+                date: dateStr,
+                amount: -Math.round(amount * 100) / 100,
+                currency: "PLN",
+                description: merchant.name,
+                merchantName: merchant.name,
+                type: "debit",
+            });
+        }
+        // Salary on the 10th, freelance on the 25th
+        if (date.getDate() === 10) {
+            txs.push({
+                id: `mock-tx-${accountId}-salary-${dateStr}`,
+                accountId,
+                date: dateStr,
+                amount: incomes[0].amount,
+                currency: "PLN",
+                description: incomes[0].desc,
+                merchantName: incomes[0].name,
+                type: "credit",
+            });
+        }
+        if (date.getDate() === 25) {
+            txs.push({
+                id: `mock-tx-${accountId}-freelance-${dateStr}`,
+                accountId,
+                date: dateStr,
+                amount: incomes[1].amount,
+                currency: "PLN",
+                description: incomes[1].desc,
+                merchantName: incomes[1].name,
+                type: "credit",
+            });
+        }
+    }
+    // Sort by date descending
+    txs.sort((a, b) => b.date.localeCompare(a.date));
+    return txs;
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/mock/index.js.map

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

package/dist/providers/plaid/index.d.ts

@@ -0,0 +1,12 @@
+import { BankProvider } from "../base.js";
+import type { BankAccount, Transaction, Balance, TransactionFilter, ConfigField } from "../../types.js";
+export declare class PlaidProvider extends BankProvider {
+    readonly name = "plaid";
+    readonly displayName = "Plaid (US/CA/EU)";
+    validateConfig(config: Record<string, unknown>): void;
+    getConfigSchema(): ConfigField[];
+    listAccounts(config: Record<string, unknown>): Promise<BankAccount[]>;
+    listTransactions(config: Record<string, unknown>, accountId: string, filter?: TransactionFilter): Promise<Transaction[]>;
+    getBalance(config: Record<string, unknown>, accountId: string): Promise<Balance[]>;
+}
+//# sourceMappingURL=index.d.ts.map