@firela/billclaw-core 0.1.3

package/dist/models/config.js

@@ -0,0 +1,168 @@
+/**
+ * Zod schemas for BillClaw configuration
+ *
+ * This file contains Zod schemas for type-safe configuration validation.
+ * These schemas are framework-agnostic and work across all adapters.
+ */
+import { z } from "zod";
+/**
+ * Account types supported by BillClaw
+ */
+export const AccountTypeSchema = z.enum(["plaid", "gocardless", "gmail"]);
+/**
+ * Sync frequency options
+ */
+export const SyncFrequencySchema = z.enum([
+    "realtime",
+    "hourly",
+    "daily",
+    "weekly",
+    "manual",
+]);
+/**
+ * Plaid environment options
+ */
+export const PlaidEnvironmentSchema = z.enum([
+    "sandbox",
+    "development",
+    "production",
+]);
+/**
+ * Webhook event types
+ */
+export const WebhookEventTypeSchema = z.enum([
+    "transaction.new",
+    "transaction.updated",
+    "transaction.deleted",
+    "sync.started",
+    "sync.completed",
+    "sync.failed",
+    "account.connected",
+    "account.disconnected",
+    "account.error",
+    "webhook.test",
+]);
+/**
+ * Per-account configuration
+ */
+export const AccountConfigSchema = z.object({
+    id: z.string().min(1),
+    type: AccountTypeSchema,
+    name: z.string().min(1),
+    enabled: z.boolean().default(false),
+    syncFrequency: SyncFrequencySchema.default("daily"),
+    lastSync: z.string().optional(),
+    lastStatus: z.enum(["success", "error", "pending"]).optional(),
+    // Plaid-specific
+    plaidItemId: z.string().optional(),
+    plaidAccessToken: z.string().optional(),
+    // GoCardless-specific
+    gocardlessRequisitionId: z.string().optional(),
+    gocardlessAccessToken: z.string().optional(),
+    // Gmail-specific
+    gmailEmailAddress: z.string().email().optional(),
+    gmailFilters: z.array(z.string()).optional(),
+});
+/**
+ * Webhook configuration
+ */
+export const WebhookConfigSchema = z.object({
+    enabled: z.boolean().default(false),
+    url: z.string().url().optional(),
+    secret: z.string().optional(),
+    retryPolicy: z
+        .object({
+        maxRetries: z.number().int().min(0).default(3),
+        initialDelay: z.number().int().min(0).default(1000),
+        maxDelay: z.number().int().min(0).default(30000),
+    })
+        .default({
+        maxRetries: 3,
+        initialDelay: 1000,
+        maxDelay: 30000,
+    }),
+    events: z
+        .array(WebhookEventTypeSchema)
+        .default(["transaction.new", "sync.failed", "account.error"]),
+});
+/**
+ * Storage configuration
+ */
+export const StorageConfigSchema = z.object({
+    path: z.string().default("~/.billclaw"),
+    format: z.enum(["json", "csv", "both"]).default("json"),
+    encryption: z
+        .object({
+        enabled: z.boolean().default(false),
+        keyPath: z.string().optional(),
+    })
+        .default({
+        enabled: false,
+    }),
+});
+/**
+ * Plaid configuration
+ */
+export const PlaidConfigSchema = z.object({
+    clientId: z.string().optional(),
+    secret: z.string().optional(),
+    environment: PlaidEnvironmentSchema.default("sandbox"),
+    webhookUrl: z.string().url().optional(),
+});
+/**
+ * GoCardless configuration
+ */
+export const GoCardlessConfigSchema = z.object({
+    accessToken: z.string().optional(),
+    environment: z.enum(["sandbox", "live"]).default("sandbox"),
+});
+/**
+ * Gmail configuration
+ */
+export const GmailConfigSchema = z.object({
+    clientId: z.string().optional(),
+    clientSecret: z.string().optional(),
+    historyId: z.string().optional(),
+    pubsubTopic: z.string().optional(),
+    senderWhitelist: z.array(z.string()).default([]),
+    keywords: z
+        .array(z.string())
+        .default(["invoice", "statement", "bill due", "receipt", "payment due"]),
+    // Recognition rules
+    confidenceThreshold: z.number().min(0).max(1).default(0.5),
+    requireAmount: z.boolean().default(false),
+    requireDate: z.boolean().default(false),
+    // Custom bill type patterns
+    billTypePatterns: z.record(z.array(z.string())).optional(),
+});
+/**
+ * Sync configuration
+ */
+export const SyncConfigSchema = z.object({
+    defaultFrequency: SyncFrequencySchema.default("daily"),
+    retryOnFailure: z.boolean().default(true),
+    maxRetries: z.number().int().min(0).default(3),
+});
+/**
+ * Main BillClaw configuration schema
+ */
+export const BillclawConfigSchema = z.object({
+    accounts: z.array(AccountConfigSchema).default([]),
+    webhooks: z.array(WebhookConfigSchema).default([]),
+    storage: StorageConfigSchema.default({
+        path: "~/.billclaw",
+        format: "json",
+        encryption: { enabled: false },
+    }),
+    sync: SyncConfigSchema.default({
+        defaultFrequency: "daily",
+        retryOnFailure: true,
+        maxRetries: 3,
+    }),
+    plaid: PlaidConfigSchema.default({
+        environment: "sandbox",
+    }),
+    gocardless: GoCardlessConfigSchema.optional(),
+    gmail: GmailConfigSchema.optional(),
+});
+//# sourceMappingURL=config.js.map

package/dist/models/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/models/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC,CAAA;AAGzE;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC;IACxC,UAAU;IACV,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,QAAQ;CACT,CAAC,CAAA;AAGF;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,SAAS;IACT,aAAa;IACb,YAAY;CACb,CAAC,CAAA;AAGF;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,iBAAiB;IACjB,qBAAqB;IACrB,qBAAqB;IACrB,cAAc;IACd,gBAAgB;IAChB,aAAa;IACb,mBAAmB;IACnB,sBAAsB;IACtB,eAAe;IACf,cAAc;CACf,CAAC,CAAA;AAGF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACnC,aAAa,EAAE,mBAAmB,CAAC,OAAO,CAAC,OAAO,CAAC;IACnD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9D,iBAAiB;IACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,sBAAsB;IACtB,uBAAuB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9C,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5C,iBAAiB;IACjB,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE;IAChD,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAA;AAGF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACnC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,WAAW,EAAE,CAAC;SACX,MAAM,CAAC;QACN,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC9C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QACnD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;KACjD,CAAC;SACD,OAAO,CAAC;QACP,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,KAAK;KAChB,CAAC;IACJ,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,sBAAsB,CAAC;SAC7B,OAAO,CAAC,CAAC,iBAAiB,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;CAChE,CAAC,CAAA;AAGF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACvD,UAAU,EAAE,CAAC;SACV,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC/B,CAAC;SACD,OAAO,CAAC;QACP,OAAO,EAAE,KAAK;KACf,CAAC;CACL,CAAC,CAAA;AAGF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,WAAW,EAAE,sBAAsB,CAAC,OAAO,CAAC,SAAS,CAAC;IACtD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAA;AAGF;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;CAC5D,CAAC,CAAA;AAGF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAChD,QAAQ,EAAE,CAAC;SACR,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,OAAO,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IAC1E,oBAAoB;IACpB,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IAC1D,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACzC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACvC,4BAA4B;IAC5B,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC3D,CAAC,CAAA;AAGF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,gBAAgB,EAAE,mBAAmB,CAAC,OAAO,CAAC,OAAO,CAAC;IACtD,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;CAC/C,CAAC,CAAA;AAGF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAClD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAClD,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC;QACnC,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;KAC/B,CAAC;IACF,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC;QAC7B,gBAAgB,EAAE,OAAO;QACzB,cAAc,EAAE,IAAI;QACpB,UAAU,EAAE,CAAC;KACd,CAAC;IACF,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC;QAC/B,WAAW,EAAE,SAAS;KACvB,CAAC;IACF,UAAU,EAAE,sBAAsB,CAAC,QAAQ,EAAE;IAC7C,KAAK,EAAE,iBAAiB,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAA"}

package/dist/models/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Data models and schemas for BillClaw
+ *
+ * @packageDocumentation
+ */
+export * from "./config.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/models/index.js

@@ -0,0 +1,8 @@
+/**
+ * Data models and schemas for BillClaw
+ *
+ * @packageDocumentation
+ */
+// Configuration schemas
+export * from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/models/index.js.map

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

package/dist/runtime/index.d.ts

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

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

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

package/dist/runtime/index.js

@@ -0,0 +1,7 @@
+/**
+ * Runtime abstractions for BillClaw
+ *
+ * @packageDocumentation
+ */
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

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

package/dist/runtime/types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Runtime abstractions for BillClaw
+ *
+ * These interfaces define the contracts that adapters (OpenClaw, CLI, etc.)
+ * must implement to provide framework-specific functionality to the core.
+ */
+import type { Logger } from "../errors/errors.js";
+import type { BillclawConfig, StorageConfig } from "../models/config.js";
+/**
+ * Configuration provider - loads and provides configuration
+ */
+export interface ConfigProvider {
+    /**
+     * Get the full BillClaw configuration
+     */
+    getConfig(): Promise<BillclawConfig>;
+    /**
+     * Get the storage configuration
+     */
+    getStorageConfig(): Promise<StorageConfig>;
+    /**
+     * Update a specific account configuration
+     */
+    updateAccount(accountId: string, updates: Partial<any>): Promise<void>;
+    /**
+     * Get account configuration by ID
+     */
+    getAccount(accountId: string): Promise<any | null>;
+}
+/**
+ * Event emitter - emits events for synchronization and monitoring
+ */
+export interface EventEmitter {
+    /**
+     * Emit an event
+     */
+    emit(event: string, data?: unknown): void;
+    /**
+     * Register an event listener
+     */
+    on(event: string, handler: (data?: unknown) => void): void;
+    /**
+     * Remove an event listener
+     */
+    off(event: string, handler: (data?: unknown) => void): void;
+}
+/**
+ * Runtime context - provides all framework-specific functionality
+ */
+export interface RuntimeContext {
+    /**
+     * Logger for output
+     */
+    logger: Logger;
+    /**
+     * Configuration provider
+     */
+    config: ConfigProvider;
+    /**
+     * Event emitter
+     */
+    events?: EventEmitter;
+    /**
+     * Platform-specific utilities
+     */
+    platform?: {
+        /**
+         * Get the home directory
+         */
+        getHomeDir(): string;
+        /**
+         * Get the data directory
+         */
+        getDataDir(): string;
+        /**
+         * Open a URL in the browser
+         */
+        openUrl(url: string): Promise<void>;
+    };
+}
+/**
+ * Default console logger implementation
+ */
+export declare class ConsoleLogger implements Logger {
+    info(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+}
+/**
+ * In-memory event emitter implementation
+ */
+export declare class MemoryEventEmitter implements EventEmitter {
+    private listeners;
+    emit(event: string, data?: unknown): void;
+    on(event: string, handler: (data?: unknown) => void): void;
+    off(event: string, handler: (data?: unknown) => void): void;
+}
+/**
+ * Simple in-memory config provider
+ */
+export declare class MemoryConfigProvider implements ConfigProvider {
+    private config;
+    constructor(config: BillclawConfig);
+    getConfig(): Promise<BillclawConfig>;
+    getStorageConfig(): Promise<StorageConfig>;
+    updateAccount(accountId: string, updates: Partial<any>): Promise<void>;
+    getAccount(accountId: string): Promise<any | null>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/types.d.ts.map

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

package/dist/runtime/types.js

@@ -0,0 +1,85 @@
+/**
+ * Runtime abstractions for BillClaw
+ *
+ * These interfaces define the contracts that adapters (OpenClaw, CLI, etc.)
+ * must implement to provide framework-specific functionality to the core.
+ */
+/**
+ * Default console logger implementation
+ */
+export class ConsoleLogger {
+    info(...args) {
+        console.log("[INFO]", ...args);
+    }
+    error(...args) {
+        console.error("[ERROR]", ...args);
+    }
+    warn(...args) {
+        console.warn("[WARN]", ...args);
+    }
+    debug(...args) {
+        if (process.env.DEBUG) {
+            console.debug("[DEBUG]", ...args);
+        }
+    }
+}
+/**
+ * In-memory event emitter implementation
+ */
+export class MemoryEventEmitter {
+    listeners = new Map();
+    emit(event, data) {
+        const handlers = this.listeners.get(event);
+        if (handlers) {
+            for (const handler of handlers) {
+                try {
+                    handler(data);
+                }
+                catch (error) {
+                    console.error(`Error in event handler for ${event}:`, error);
+                }
+            }
+        }
+    }
+    on(event, handler) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        this.listeners.get(event).add(handler);
+    }
+    off(event, handler) {
+        const handlers = this.listeners.get(event);
+        if (handlers) {
+            handlers.delete(handler);
+        }
+    }
+}
+/**
+ * Simple in-memory config provider
+ */
+export class MemoryConfigProvider {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async getConfig() {
+        return this.config;
+    }
+    async getStorageConfig() {
+        return (this.config.storage || {
+            path: "~/.billclaw",
+            format: "json",
+            encryption: { enabled: false },
+        });
+    }
+    async updateAccount(accountId, updates) {
+        const account = this.config.accounts.find((a) => a.id === accountId);
+        if (account) {
+            Object.assign(account, updates);
+        }
+    }
+    async getAccount(accountId) {
+        return this.config.accounts.find((a) => a.id === accountId) || null;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/runtime/types.js.map

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

package/dist/security/audit.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Security audit logging for BillClaw
+ *
+ * Provides audit logging for all credential operations:
+ * - Credential access (read/write/delete)
+ * - Account linking/unlinking
+ * - Sync operations
+ * - Configuration changes
+ *
+ * Audit logs are stored locally and can be exported for compliance.
+ */
+import type { Logger } from "../errors/errors.js";
+/**
+ * Audit event types
+ */
+export declare enum AuditEventType {
+    CREDENTIAL_CREATED = "credential.created",
+    CREDENTIAL_READ = "credential.read",
+    CREDENTIAL_WRITE = "credential.write",
+    CREDENTIAL_UPDATED = "credential.updated",
+    CREDENTIAL_DELETED = "credential.deleted",
+    CREDENTIAL_DELETE = "credential.delete",// Alias for backward compatibility
+    CREDENTIAL_EXPORTED = "credential.exported",
+    ACCOUNT_LINKED = "account.linked",
+    ACCOUNT_UNLINKED = "account.unlinked",
+    ACCOUNT_SYNCED = "account.synced",
+    ACCOUNT_SYNC_FAILED = "account.sync_failed",
+    CONFIG_UPDATED = "config.updated",
+    CONFIG_READ = "config.read",
+    AUTH_SUCCESS = "auth.success",
+    AUTH_FAILED = "auth.failed",
+    AUTH_REFRESHED = "auth.refreshed",
+    DATA_EXPORTED = "data.exported",
+    DATA_IMPORTED = "data.imported",
+    DATA_DELETED = "data.deleted",
+    ACCOUNT_ACCESS = "account.access",
+    SYNC_STARTED = "sync.started",
+    SYNC_COMPLETED = "sync.completed",
+    SYNC_FAILED = "sync.failed",
+    CONFIG_CHANGE = "config.change"
+}
+/**
+ * Audit event severity
+ */
+export declare enum AuditSeverity {
+    INFO = "info",
+    LOW = "low",
+    MEDIUM = "medium",
+    HIGH = "high",
+    WARNING = "warning",
+    ERROR = "error",
+    CRITICAL = "critical"
+}
+/**
+ * Audit event entry
+ */
+export interface AuditEvent {
+    id: string;
+    timestamp: string;
+    type: AuditEventType;
+    severity: AuditSeverity;
+    message: string;
+    details?: Record<string, unknown>;
+    userId?: string;
+    ipAddress?: string;
+    userAgent?: string;
+}
+/**
+ * Audit log configuration
+ */
+export interface AuditConfig {
+    dataDir?: string;
+    maxEntries?: number;
+    retentionDays?: number;
+}
+/**
+ * Audit logger class
+ */
+export declare class AuditLogger {
+    private config;
+    private baseDir;
+    private logFilePath;
+    private logger?;
+    constructor(configOrPath?: AuditConfig | string, logger?: Logger);
+    /**
+     * Get the audit log file path
+     */
+    private getAuditFilePath;
+    /**
+     * Ensure audit directory exists
+     */
+    private ensureAuditDir;
+    /**
+     * Rotate audit logs if they exceed max entries
+     */
+    private rotateIfNeeded;
+    /**
+     * Log an audit event
+     */
+    log(type: AuditEventType, message: string, details?: Record<string, unknown>, severity?: AuditSeverity): Promise<void>;
+    /**
+     * Generate a unique event ID
+     */
+    private generateEventId;
+    /**
+     * Read all audit events
+     */
+    readEvents(limit?: number): Promise<AuditEvent[]>;
+    /**
+     * Query audit events by type
+     */
+    queryByType(type: AuditEventType, limit?: number): Promise<AuditEvent[]>;
+    /**
+     * Query audit events by severity
+     */
+    queryBySeverity(severity: AuditSeverity, limit?: number): Promise<AuditEvent[]>;
+    /**
+     * Clear all audit events
+     */
+    clear(): Promise<void>;
+    /**
+     * Get audit log statistics
+     */
+    getStats(): Promise<{
+        totalEvents: number;
+        byType: Record<string, number>;
+        bySeverity: Record<string, number>;
+    }>;
+}
+/**
+ * Create an audit logger with the given configuration
+ */
+export declare function createAuditLogger(config?: AuditConfig, logger?: Logger): AuditLogger;
+/**
+ * Convenience functions for common audit events
+ */
+export declare class AuditHelpers {
+    private audit;
+    constructor(audit: AuditLogger);
+    logCredentialCreated(credentialType: string, accountId: string): Promise<void>;
+    logCredentialRead(credentialType: string, accountId: string): Promise<void>;
+    logCredentialDeleted(credentialType: string, accountId: string): Promise<void>;
+    logAccountLinked(accountType: string, accountId: string): Promise<void>;
+    logAccountUnlinked(accountType: string, accountId: string): Promise<void>;
+    logAuthFailed(accountType: string, reason: string): Promise<void>;
+    logDataExported(dataType: string, count: number): Promise<void>;
+}
+//# sourceMappingURL=audit.d.ts.map

package/dist/security/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/security/audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAEjD;;GAEG;AACH,oBAAY,cAAc;IAExB,kBAAkB,uBAAuB;IACzC,eAAe,oBAAoB;IACnC,gBAAgB,qBAAqB;IACrC,kBAAkB,uBAAuB;IACzC,kBAAkB,uBAAuB;IACzC,iBAAiB,sBAAsB,CAAE,mCAAmC;IAC5E,mBAAmB,wBAAwB;IAG3C,cAAc,mBAAmB;IACjC,gBAAgB,qBAAqB;IACrC,cAAc,mBAAmB;IACjC,mBAAmB,wBAAwB;IAG3C,cAAc,mBAAmB;IACjC,WAAW,gBAAgB;IAG3B,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;IAGjC,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;IAC/B,YAAY,iBAAiB;IAG7B,cAAc,mBAAmB;IACjC,YAAY,iBAAiB;IAC7B,cAAc,mBAAmB;IACjC,WAAW,gBAAgB;IAC3B,aAAa,kBAAkB;CAChC;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,cAAc,CAAA;IACpB,QAAQ,EAAE,aAAa,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAWD;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,MAAM,CAAC,CAAQ;gBAEX,YAAY,GAAE,WAAW,GAAG,MAAW,EAAE,MAAM,CAAC,EAAE,MAAM;IAiBpE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;YACW,cAAc;IAI5B;;OAEG;YACW,cAAc;IAkC5B;;OAEG;IACG,GAAG,CACP,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,GAAE,aAAkC,GAC3C,OAAO,CAAC,IAAI,CAAC;IAuBhB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACG,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA6BvD;;OAEG;IACG,WAAW,CACf,IAAI,EAAE,cAAc,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,EAAE,CAAC;IAMxB;;OAEG;IACG,eAAe,CACnB,QAAQ,EAAE,aAAa,EACvB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,EAAE,CAAC;IAMxB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QACxB,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KACnC,CAAC;CAgBH;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,CAAC,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,MAAM,GACd,WAAW,CAEb;AAED;;GAEG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,WAAW;IAEhC,oBAAoB,CACxB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IASV,iBAAiB,CACrB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IASV,oBAAoB,CACxB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IASV,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IASV,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IASV,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASjE,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQtE"}