@firela/billclaw-core 0.1.3

package/dist/storage/transaction-storage.js

@@ -0,0 +1,193 @@
+/**
+ * Local file storage utilities for BillClaw data
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as os from "node:os";
+/**
+ * Get the base storage directory
+ */
+export async function getStorageDir(config) {
+    const storagePath = config?.path || "~/.billclaw";
+    const expandedPath = storagePath.replace(/^~/, os.homedir());
+    return expandedPath;
+}
+/**
+ * Initialize storage directory structure
+ */
+export async function initializeStorage(config) {
+    const baseDir = await getStorageDir(config);
+    const directories = [
+        baseDir,
+        path.join(baseDir, "accounts"),
+        path.join(baseDir, "transactions"),
+        path.join(baseDir, "sync"),
+    ];
+    for (const dir of directories) {
+        try {
+            await fs.mkdir(dir, { recursive: true });
+        }
+        catch {
+            // Directory may already exist
+        }
+    }
+}
+/**
+ * Read account registry
+ */
+export async function readAccountRegistry(config) {
+    const baseDir = await getStorageDir(config);
+    const filePath = path.join(baseDir, "accounts.json");
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        // File doesn't exist yet
+        return [];
+    }
+}
+/**
+ * Write account registry
+ */
+export async function writeAccountRegistry(accounts, config) {
+    const baseDir = await getStorageDir(config);
+    const filePath = path.join(baseDir, "accounts.json");
+    await initializeStorage(config);
+    await fs.writeFile(filePath, JSON.stringify(accounts, null, 2), "utf-8");
+}
+/**
+ * Read transactions for an account and month
+ */
+export async function readTransactions(accountId, year, month, config) {
+    const baseDir = await getStorageDir(config);
+    const monthStr = month.toString().padStart(2, "0");
+    const filePath = path.join(baseDir, "transactions", accountId, `${year}`, `${monthStr}.json`);
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Write transactions for an account and month
+ * Uses atomic write (temp file + rename) for safety
+ */
+export async function writeTransactions(accountId, year, month, transactions, config) {
+    const baseDir = await getStorageDir(config);
+    const monthStr = month.toString().padStart(2, "0");
+    const dirPath = path.join(baseDir, "transactions", accountId, `${year}`);
+    const filePath = path.join(dirPath, `${monthStr}.json`);
+    await fs.mkdir(dirPath, { recursive: true });
+    // Atomic write: write to temp file first, then rename
+    const tempPath = filePath + ".tmp";
+    await fs.writeFile(tempPath, JSON.stringify(transactions, null, 2), "utf-8");
+    await fs.rename(tempPath, filePath);
+}
+/**
+ * Append transactions to existing month file (with deduplication)
+ */
+export async function appendTransactions(accountId, year, month, newTransactions, config) {
+    const existing = await readTransactions(accountId, year, month, config);
+    const existingIds = new Set(existing.map((t) => t.transactionId));
+    let added = 0;
+    let updated = 0;
+    for (const txn of newTransactions) {
+        if (existingIds.has(txn.transactionId)) {
+            // Update existing transaction
+            const index = existing.findIndex((t) => t.transactionId === txn.transactionId);
+            if (index !== -1) {
+                existing[index] = txn;
+                updated++;
+            }
+        }
+        else {
+            // Add new transaction
+            existing.push(txn);
+            existingIds.add(txn.transactionId);
+            added++;
+        }
+    }
+    // Sort by date descending
+    existing.sort((a, b) => b.date.localeCompare(a.date));
+    await writeTransactions(accountId, year, month, existing, config);
+    return { added, updated };
+}
+/**
+ * Read sync state for an account
+ */
+export async function readSyncStates(accountId, config) {
+    const baseDir = await getStorageDir(config);
+    const dirPath = path.join(baseDir, "sync", accountId);
+    try {
+        const files = await fs.readdir(dirPath);
+        const states = [];
+        for (const file of files) {
+            if (!file.endsWith(".json"))
+                continue;
+            const filePath = path.join(dirPath, file);
+            const content = await fs.readFile(filePath, "utf-8");
+            states.push(JSON.parse(content));
+        }
+        return states.sort((a, b) => b.startedAt.localeCompare(a.startedAt));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Write sync state
+ */
+export async function writeSyncState(state, config) {
+    const baseDir = await getStorageDir(config);
+    const dirPath = path.join(baseDir, "sync", state.accountId);
+    const filePath = path.join(dirPath, `${state.syncId}.json`);
+    await fs.mkdir(dirPath, { recursive: true });
+    await fs.writeFile(filePath, JSON.stringify(state, null, 2), "utf-8");
+}
+/**
+ * Read global cursor
+ */
+export async function readGlobalCursor(config) {
+    const baseDir = await getStorageDir(config);
+    const filePath = path.join(baseDir, "cursor.json");
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write global cursor
+ */
+export async function writeGlobalCursor(cursor, config) {
+    const baseDir = await getStorageDir(config);
+    const filePath = path.join(baseDir, "cursor.json");
+    await initializeStorage(config);
+    await fs.writeFile(filePath, JSON.stringify(cursor, null, 2), "utf-8");
+}
+/**
+ * Deduplicate transactions within a time window (24 hours)
+ */
+export function deduplicateTransactions(transactions, windowHours = 24) {
+    const seen = new Set();
+    const windowStart = Date.now() - windowHours * 60 * 60 * 1000;
+    const result = [];
+    // Sort by date ascending
+    const sorted = [...transactions].sort((a, b) => a.date.localeCompare(b.date));
+    for (const txn of sorted) {
+        const key = `${txn.accountId}_${txn.plaidTransactionId}`;
+        const txnDate = new Date(txn.date).getTime();
+        // Only include if not seen, or outside deduplication window
+        if (!seen.has(key) || txnDate > windowStart) {
+            seen.add(key);
+            result.push(txn);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=transaction-storage.js.map

package/dist/storage/transaction-storage.js.map

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

package/dist/sync/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Sync service for BillClaw
+ *
+ * @packageDocumentation
+ */
+export * from "./sync-service.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,mBAAmB,CAAA"}

package/dist/sync/index.js

@@ -0,0 +1,7 @@
+/**
+ * Sync service for BillClaw
+ *
+ * @packageDocumentation
+ */
+export * from "./sync-service.js";
+//# sourceMappingURL=index.js.map

package/dist/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,mBAAmB,CAAA"}

package/dist/sync/sync-service.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Sync service for BillClaw - Framework-agnostic background sync logic
+ */
+import type { AccountConfig } from "../models/config.js";
+import type { Logger } from "../errors/errors.js";
+export interface SyncResult {
+    accountId: string;
+    success: boolean;
+    transactionsAdded: number;
+    transactionsUpdated: number;
+    errors?: string[];
+}
+export interface SyncServiceState {
+    isRunning: boolean;
+    lastSync: string | null;
+    nextSync: string | null;
+    accountsSynced: number;
+}
+/**
+ * Sync function interface - adapters provide the actual sync implementation
+ */
+export interface SyncProvider {
+    syncAccount(accountId: string): Promise<SyncResult>;
+}
+/**
+ * Calculate next sync time based on sync frequency
+ */
+export declare function calculateNextSync(frequency: string, lastSync?: Date): Date;
+/**
+ * Check if an account is due for sync
+ */
+export declare function isDueForSync(account: AccountConfig): boolean;
+/**
+ * Sync all accounts that are due for sync
+ *
+ * @param accounts - All configured accounts
+ * @param syncProvider - Provider that implements the actual sync logic
+ * @param logger - Logger for output
+ * @returns Array of sync results
+ */
+export declare function syncDueAccounts(accounts: AccountConfig[], syncProvider: SyncProvider, logger: Logger): Promise<SyncResult[]>;
+//# sourceMappingURL=sync-service.d.ts.map

package/dist/sync/sync-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-service.d.ts","sourceRoot":"","sources":["../../src/sync/sync-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAEjD,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,iBAAiB,EAAE,MAAM,CAAA;IACzB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;CACpD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CA+B1E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAmB5D;AAkCD;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,aAAa,EAAE,EACzB,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,EAAE,CAAC,CAkCvB"}

package/dist/sync/sync-service.js

@@ -0,0 +1,112 @@
+/**
+ * Sync service for BillClaw - Framework-agnostic background sync logic
+ */
+/**
+ * Calculate next sync time based on sync frequency
+ */
+export function calculateNextSync(frequency, lastSync) {
+    const now = new Date();
+    const base = lastSync || now;
+    switch (frequency) {
+        case "realtime":
+            // Webhook-based, no scheduled sync
+            return new Date(0);
+        case "hourly":
+            return new Date(base.getTime() + 60 * 60 * 1000);
+        case "daily":
+            // Next day at same time
+            const nextDay = new Date(base);
+            nextDay.setDate(nextDay.getDate() + 1);
+            return nextDay;
+        case "weekly":
+            // Next week on same day
+            const nextWeek = new Date(base);
+            nextWeek.setDate(nextWeek.getDate() + 7);
+            return nextWeek;
+        case "manual":
+            // No scheduled sync
+            return new Date(0);
+        default:
+            return new Date(base.getTime() + 24 * 60 * 60 * 1000);
+    }
+}
+/**
+ * Check if an account is due for sync
+ */
+export function isDueForSync(account) {
+    if (!account.enabled || !account.lastSync) {
+        return true;
+    }
+    const lastSync = new Date(account.lastSync);
+    const nextSync = calculateNextSync(account.syncFrequency, lastSync);
+    // Manual accounts never sync automatically
+    if (account.syncFrequency === "manual") {
+        return false;
+    }
+    // Realtime accounts sync via webhook, not scheduled
+    if (account.syncFrequency === "realtime") {
+        return false;
+    }
+    return new Date() >= nextSync;
+}
+/**
+ * Sync a single account using the provided sync provider
+ */
+async function syncAccount(accountId, syncProvider, logger) {
+    try {
+        const result = await syncProvider.syncAccount(accountId);
+        if (result.success) {
+            logger.info?.(`Sync completed for ${accountId}: ${result.transactionsAdded} added, ${result.transactionsUpdated} updated`);
+        }
+        else {
+            logger.error?.(`Sync failed for ${accountId}:`, result.errors || []);
+        }
+        return result;
+    }
+    catch (error) {
+        logger.error?.(`Error syncing ${accountId}:`, error);
+        return {
+            accountId,
+            success: false,
+            transactionsAdded: 0,
+            transactionsUpdated: 0,
+            errors: [error instanceof Error ? error.message : String(error)],
+        };
+    }
+}
+/**
+ * Sync all accounts that are due for sync
+ *
+ * @param accounts - All configured accounts
+ * @param syncProvider - Provider that implements the actual sync logic
+ * @param logger - Logger for output
+ * @returns Array of sync results
+ */
+export async function syncDueAccounts(accounts, syncProvider, logger) {
+    logger.info?.("BillClaw sync service started");
+    // Filter for enabled accounts
+    const enabledAccounts = accounts.filter((acc) => acc.enabled);
+    if (enabledAccounts.length === 0) {
+        logger.info?.("No enabled accounts to sync");
+        return [];
+    }
+    logger.info?.(`Found ${enabledAccounts.length} enabled accounts to check`);
+    const results = [];
+    let syncedCount = 0;
+    for (const account of enabledAccounts) {
+        if (isDueForSync(account)) {
+            logger.info?.(`Syncing account: ${account.name} (${account.id})`);
+            const result = await syncAccount(account.id, syncProvider, logger);
+            results.push(result);
+            if (result.success) {
+                syncedCount++;
+            }
+        }
+        else {
+            logger.info?.(`Skipping ${account.name} (${account.id}): not due for sync`);
+        }
+    }
+    logger.info?.(`Sync service completed: ${syncedCount} accounts synced`);
+    return results;
+}
+//# sourceMappingURL=sync-service.js.map

package/dist/sync/sync-service.js.map

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

package/dist/test-fixtures.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Test fixtures for BillClaw
+ */
+import type { AccountConfig, BillclawConfig } from "@firela/billclaw-core";
+/**
+ * Sample Plaid transaction data (external format)
+ */
+export interface PlaidTransactionData {
+    transaction_id: string;
+    account_id: string;
+    date: string;
+    amount: number;
+    iso_currency_code: string;
+    category?: string[];
+    merchant_name?: string;
+    payment_channel?: string;
+    pending?: boolean;
+}
+export declare const mockPlaidTransactions: PlaidTransactionData[];
+/**
+ * Sample account configurations
+ */
+export declare const mockAccounts: AccountConfig[];
+/**
+ * Sample complete configuration
+ */
+export declare const mockConfig: BillclawConfig;
+/**
+ * Sample Gmail email content
+ */
+export declare const mockGmailEmails: {
+    id: string;
+    from: string;
+    subject: string;
+    body: string;
+    date: string;
+}[];
+//# sourceMappingURL=test-fixtures.d.ts.map

package/dist/test-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-fixtures.d.ts","sourceRoot":"","sources":["../src/test-fixtures.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAE1E;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,iBAAiB,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,eAAO,MAAM,qBAAqB,EAAE,oBAAoB,EAuBvD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,aAAa,EA8BvC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,cAqCxB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;GA8B3B,CAAA"}

package/dist/test-fixtures.js

@@ -0,0 +1,137 @@
+/**
+ * Test fixtures for BillClaw
+ */
+export const mockPlaidTransactions = [
+    {
+        transaction_id: "plaid-txn-001",
+        account_id: "plaid-acct-123",
+        date: "2024-01-15",
+        amount: 125.5,
+        iso_currency_code: "USD",
+        category: ["Food", "Restaurants"],
+        merchant_name: "Test Restaurant",
+        payment_channel: "online",
+        pending: false,
+    },
+    {
+        transaction_id: "plaid-txn-002",
+        account_id: "plaid-acct-123",
+        date: "2024-01-16",
+        amount: 45.99,
+        iso_currency_code: "USD",
+        category: ["Shopping", "Electronics"],
+        merchant_name: "Tech Store",
+        payment_channel: "in store",
+        pending: true,
+    },
+];
+/**
+ * Sample account configurations
+ */
+export const mockAccounts = [
+    {
+        id: "plaid-sandbox-123",
+        type: "plaid",
+        name: "Test Bank Account",
+        enabled: true,
+        syncFrequency: "daily",
+        lastSync: "2024-01-16T10:30:00Z",
+        lastStatus: "success",
+        plaidItemId: "item-sandbox-123",
+        plaidAccessToken: "access-sandbox-test",
+    },
+    {
+        id: "gmail-bill-456",
+        type: "gmail",
+        name: "Gmail Bills",
+        enabled: true,
+        syncFrequency: "weekly",
+        lastSync: "2024-01-15T08:00:00Z",
+        lastStatus: "success",
+        gmailEmailAddress: "user@example.com",
+        gmailFilters: ["from:billing@*"],
+    },
+    {
+        id: "gocardless-sandbox-789",
+        type: "gocardless",
+        name: "European Bank",
+        enabled: false,
+        syncFrequency: "manual",
+    },
+];
+/**
+ * Sample complete configuration
+ */
+export const mockConfig = {
+    accounts: mockAccounts,
+    webhooks: [
+        {
+            enabled: true,
+            url: "https://example.com/webhook",
+            secret: "webhook-secret-key",
+            events: ["transaction.new", "sync.failed"],
+            retryPolicy: {
+                maxRetries: 3,
+                initialDelay: 1000,
+                maxDelay: 30000,
+            },
+        },
+    ],
+    storage: {
+        path: "~/.billclaw",
+        format: "json",
+        encryption: { enabled: false },
+    },
+    sync: {
+        defaultFrequency: "daily",
+        maxRetries: 3,
+        retryOnFailure: true,
+    },
+    plaid: {
+        clientId: "test-client-id",
+        secret: "test-secret",
+        environment: "sandbox",
+    },
+    gmail: {
+        senderWhitelist: ["billing@*"],
+        keywords: ["invoice", "receipt", "statement"],
+        confidenceThreshold: 0.5,
+        requireAmount: false,
+        requireDate: false,
+    },
+};
+/**
+ * Sample Gmail email content
+ */
+export const mockGmailEmails = [
+    {
+        id: "gmail-msg-001",
+        from: "billing@company.com",
+        subject: "Your invoice for January",
+        body: `
+      Dear Customer,
+
+      Your invoice for January is ready.
+
+      Amount Due: $89.00
+      Due Date: January 31, 2024
+
+      Thank you for your business.
+    `,
+        date: "2024-01-15T10:00:00Z",
+    },
+    {
+        id: "gmail-msg-002",
+        from: "receipt@store.com",
+        subject: "Receipt for your purchase",
+        body: `
+      Thank you for your purchase!
+
+      Item: Widget Pro
+      Amount: $29.99
+      Date: 01/16/2024
+    `,
+        date: "2024-01-16T14:30:00Z",
+    },
+];
+//# sourceMappingURL=test-fixtures.js.map

package/dist/test-fixtures.js.map

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

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@firela/billclaw-core",
+  "version": "0.1.3",
+  "description": "BillClaw Core - Framework-agnostic business logic for financial data import",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "financial-data",
+    "plaid",
+    "gocardless",
+    "banking",
+    "transactions",
+    "bills",
+    "data-sovereignty"
+  ],
+  "author": "fire-la",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fire-la/billclaw.git",
+    "directory": "packages/core"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.0",
+    "@types/proper-lockfile": "^4.1.2",
+    "@vitest/coverage-v8": "^4.0.18",
+    "oxfmt": "^0.1.0",
+    "oxlint": "^0.15.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  },
+  "optionalDependencies": {
+    "keytar": "^6.0.1"
+  },
+  "dependencies": {
+    "plaid": "^32.0.0",
+    "proper-lockfile": "^4.1.2",
+    "zod": "^3.25.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "lint": "oxlint",
+    "format": "oxfmt src/",
+    "format:write": "oxfmt -w src/",
+    "clean": "rm -rf dist"
+  }
+}