@firela/billclaw-core 0.1.3

package/dist/services/event-emitter.js

@@ -0,0 +1,287 @@
+/**
+ * Event emitter for BillClaw webhook events
+ *
+ * This module provides a centralized way to emit and forward webhook events
+ * to configured external webhook endpoints.
+ *
+ * Framework-agnostic: Uses Logger interface instead of framework-specific APIs.
+ */
+import * as crypto from "node:crypto";
+/**
+ * Emit a BillClaw event
+ *
+ * This function creates a standardized event and forwards it to all
+ * configured external webhooks that are subscribed to this event type.
+ *
+ * @param logger - Logger instance for logging
+ * @param webhooks - Array of webhook configurations
+ * @param eventType - Type of event to emit
+ * @param data - Event data
+ */
+export async function emitEvent(logger, webhooks, eventType, data) {
+    const enabledWebhooks = webhooks.filter((w) => w.enabled && w.url);
+    if (enabledWebhooks.length === 0) {
+        logger.debug?.(`No webhooks configured, skipping event: ${eventType}`);
+        return;
+    }
+    // Create standardized event
+    const event = {
+        id: generateEventId(),
+        event: eventType,
+        timestamp: new Date().toISOString(),
+        version: "1.0",
+        data,
+    };
+    logger.info?.(`Emitting event: ${eventType} (${event.id})`);
+    // Forward to configured webhooks (fire-and-forget)
+    const promises = enabledWebhooks.map(async (webhook) => {
+        // Check if this webhook is subscribed to this event
+        if (webhook.events &&
+            webhook.events.length > 0 &&
+            !webhook.events.includes(eventType)) {
+            return;
+        }
+        // Skip webhooks without URL (shouldn't happen due to filter, but TypeScript needs guard)
+        if (!webhook.url) {
+            return;
+        }
+        // Send webhook with retry logic (don't await)
+        sendWebhook(logger, webhook, event).catch((error) => {
+            logger.debug?.(`Webhook emission failed:`, error);
+        });
+    });
+    // Fire-and-forget: don't await webhook delivery
+    Promise.all(promises).catch(() => {
+        // All promises handled individually
+    });
+}
+/**
+ * Emit transaction.new event
+ */
+export async function emitTransactionNew(logger, webhooks, transaction) {
+    await emitEvent(logger, webhooks, "transaction.new", transaction);
+}
+/**
+ * Emit transaction.updated event
+ */
+export async function emitTransactionUpdated(logger, webhooks, transaction) {
+    await emitEvent(logger, webhooks, "transaction.updated", transaction);
+}
+/**
+ * Emit transaction.deleted event
+ */
+export async function emitTransactionDeleted(logger, webhooks, transactionId, accountId) {
+    await emitEvent(logger, webhooks, "transaction.deleted", {
+        transactionId,
+        accountId,
+    });
+}
+/**
+ * Emit sync.started event
+ */
+export async function emitSyncStarted(logger, webhooks, accountId, syncId) {
+    await emitEvent(logger, webhooks, "sync.started", {
+        accountId,
+        syncId,
+        status: "started",
+    });
+}
+/**
+ * Emit sync.completed event
+ */
+export async function emitSyncCompleted(logger, webhooks, syncData) {
+    await emitEvent(logger, webhooks, "sync.completed", syncData);
+}
+/**
+ * Emit sync.failed event
+ */
+export async function emitSyncFailed(logger, webhooks, accountId, syncId, error) {
+    await emitEvent(logger, webhooks, "sync.failed", {
+        accountId,
+        syncId,
+        status: "failed",
+        error,
+    });
+}
+/**
+ * Emit account.connected event
+ */
+export async function emitAccountConnected(logger, webhooks, accountId, accountType) {
+    await emitEvent(logger, webhooks, "account.connected", {
+        accountId,
+        accountType,
+        status: "connected",
+    });
+}
+/**
+ * Emit account.disconnected event
+ */
+export async function emitAccountDisconnected(logger, webhooks, accountId, accountType) {
+    await emitEvent(logger, webhooks, "account.disconnected", {
+        accountId,
+        accountType,
+        status: "disconnected",
+    });
+}
+/**
+ * Emit account.error event
+ */
+export async function emitAccountError(logger, webhooks, accountId, accountType, error) {
+    await emitEvent(logger, webhooks, "account.error", {
+        accountId,
+        accountType,
+        status: "error",
+        error,
+    });
+}
+/**
+ * Emit webhook.test event
+ */
+export async function emitWebhookTest(logger, webhooks, message = "Test webhook from BillClaw") {
+    await emitEvent(logger, webhooks, "webhook.test", {
+        message,
+        triggeredBy: "user",
+    });
+}
+/**
+ * Send webhook to external endpoint with signature and retry logic
+ *
+ * @param logger - Logger instance
+ * @param webhook - Webhook configuration with url, secret, retryPolicy
+ * @param event - Event to send
+ */
+async function sendWebhook(logger, webhook, event) {
+    const maxRetries = webhook.retryPolicy?.maxRetries || 3;
+    const initialDelay = webhook.retryPolicy?.initialDelay || 1000;
+    const maxDelay = webhook.retryPolicy?.maxDelay || 30000;
+    // Create payload
+    const payload = { ...event };
+    // Sign payload if secret is configured
+    if (webhook.secret) {
+        payload.signature = generateSignature(event, webhook.secret);
+    }
+    let attempt = 0;
+    let delay = initialDelay;
+    while (attempt < maxRetries) {
+        try {
+            const response = await fetch(webhook.url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "User-Agent": "BillClaw/1.0",
+                    "X-Billclaw-Event-Id": event.id,
+                    "X-Billclaw-Event-Type": event.event,
+                    "X-Billclaw-Timestamp": event.timestamp,
+                    ...(payload.signature && {
+                        "X-Billclaw-Signature": payload.signature,
+                    }),
+                },
+                body: JSON.stringify(payload),
+            });
+            if (response.ok) {
+                logger.info?.(`Webhook sent successfully to ${webhook.url}`);
+                return;
+            }
+            // Don't retry client errors (4xx)
+            if (response.status >= 400 && response.status < 500) {
+                logger.warn?.(`Webhook rejected by ${webhook.url}: ${response.status}`);
+                return;
+            }
+            throw new Error(`Webhook failed: ${response.status}`);
+        }
+        catch (error) {
+            attempt++;
+            if (attempt >= maxRetries) {
+                logger.error?.(`Webhook failed after ${maxRetries} retries to ${webhook.url}:`, error);
+                return;
+            }
+            // Exponential backoff with jitter (30%)
+            const jitter = Math.random() * 0.3 * delay;
+            await new Promise((resolve) => setTimeout(resolve, delay + jitter));
+            delay = Math.min(delay * 2, maxDelay);
+        }
+    }
+}
+/**
+ * Generate HMAC-SHA256 signature for webhook payload
+ *
+ * @param event - Event to sign
+ * @param secret - Secret key for HMAC
+ * @returns Signature in format "sha256=<hex>"
+ */
+export function generateSignature(event, secret) {
+    // Create payload to sign (all fields except signature)
+    const payload = {
+        id: event.id,
+        event: event.event,
+        timestamp: event.timestamp,
+        version: event.version,
+        data: event.data,
+    };
+    const payloadString = JSON.stringify(payload);
+    // Compute HMAC-SHA256
+    const hmac = crypto.createHmac("sha256", secret);
+    hmac.update(payloadString);
+    return `sha256=${hmac.digest("hex")}`;
+}
+/**
+ * Verify webhook signature
+ *
+ * Returns true if the signature matches the computed signature.
+ * Uses timing-safe comparison to prevent timing attacks.
+ *
+ * @param payload - JSON string payload
+ * @param signature - Signature to verify (format: "sha256=<hex>")
+ * @param secret - Secret key for HMAC
+ * @returns True if signature is valid
+ */
+export function verifySignature(payload, signature, secret) {
+    try {
+        const expectedSignature = crypto
+            .createHmac("sha256", secret)
+            .update(payload)
+            .digest("hex");
+        const providedSignature = signature.replace("sha256=", "");
+        // Use timing-safe comparison to prevent timing attacks
+        return crypto.timingSafeEqual(Buffer.from(expectedSignature), Buffer.from(providedSignature));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Generate unique event ID
+ *
+ * Format: evt_<timestamp>_<random>
+ * Example: evt_lz1h2x3a4b5c6d_abc123def4567
+ */
+function generateEventId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 15);
+    return `evt_${timestamp}_${random}`;
+}
+/**
+ * Type guard to check if an event is a transaction event
+ */
+export function isTransactionEvent(event) {
+    return (event.event === "transaction.new" ||
+        event.event === "transaction.updated" ||
+        event.event === "transaction.deleted");
+}
+/**
+ * Type guard to check if an event is a sync event
+ */
+export function isSyncEvent(event) {
+    return (event.event === "sync.started" ||
+        event.event === "sync.completed" ||
+        event.event === "sync.failed");
+}
+/**
+ * Type guard to check if an event is an account event
+ */
+export function isAccountEvent(event) {
+    return (event.event === "account.connected" ||
+        event.event === "account.disconnected" ||
+        event.event === "account.error");
+}
+//# sourceMappingURL=event-emitter.js.map

package/dist/services/event-emitter.js.map

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

package/dist/services/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Services module for BillClaw core package
+ *
+ * This module exports service utilities for webhook events,
+ * including event emission, signature generation, and retry logic.
+ */
+export * from "./event-emitter.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/services/index.js

@@ -0,0 +1,8 @@
+/**
+ * Services module for BillClaw core package
+ *
+ * This module exports service utilities for webhook events,
+ * including event emission, signature generation, and retry logic.
+ */
+export * from "./event-emitter.js";
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

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

package/dist/sources/gmail/bill-recognizer.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Bill Recognition Service - Framework-agnostic bill detection from email content
+ *
+ * Analyzes email content to determine if it's a bill and extracts relevant information.
+ * Uses keyword matching, sender detection, and confidence scoring.
+ */
+export interface EmailContent {
+    id: string;
+    subject: string;
+    from: string;
+    to?: string;
+    date: string;
+    body: string;
+    attachments?: Array<{
+        filename: string;
+        contentType: string;
+        data?: string;
+    }>;
+}
+export interface GmailConfig {
+    clientId?: string;
+    clientSecret?: string;
+    historyId?: string;
+    pubsubTopic?: string;
+    senderWhitelist: string[];
+    keywords: string[];
+    confidenceThreshold: number;
+    requireAmount: boolean;
+    requireDate: boolean;
+    billTypePatterns?: Record<string, string[]>;
+}
+export interface BillRecognition {
+    isBill: boolean;
+    confidence: number;
+    amount?: number;
+    currency?: string;
+    dueDate?: string;
+    billType?: string;
+    merchant?: string;
+    accountNumber?: string;
+    reasons: string[];
+}
+/**
+ * Default bill detection keywords
+ * Includes both phrases and individual words for better matching
+ */
+export declare const DEFAULT_KEYWORDS: string[];
+/**
+ * Known billing domains (extracted from common service providers)
+ */
+export declare const KNOWN_BILLING_DOMAINS: string[];
+/**
+ * Extract domain from email address
+ */
+export declare function extractDomain(email: string): string;
+/**
+ * Recognize if an email is a bill and extract relevant information
+ */
+export declare function recognizeBill(email: EmailContent, config: GmailConfig): BillRecognition;
+/**
+ * Recognize bills from multiple emails
+ */
+export declare function recognizeBills(emails: EmailContent[], config: GmailConfig): BillRecognition[];
+/**
+ * Filter emails to only bills based on recognition
+ */
+export declare function filterToBills(emails: EmailContent[], config: GmailConfig): Array<{
+    email: EmailContent;
+    recognition: BillRecognition;
+}>;
+//# sourceMappingURL=bill-recognizer.d.ts.map

package/dist/sources/gmail/bill-recognizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bill-recognizer.d.ts","sourceRoot":"","sources":["../../../src/sources/gmail/bill-recognizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAA;QAChB,WAAW,EAAE,MAAM,CAAA;QACnB,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAC,CAAA;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,aAAa,EAAE,OAAO,CAAA;IACtB,WAAW,EAAE,OAAO,CAAA;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAC5C;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,UAgC5B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,UAmBjC,CAAA;AAyCD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnD;AAkKD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,WAAW,GAClB,eAAe,CAkGjB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EAAE,EACtB,MAAM,EAAE,WAAW,GAClB,eAAe,EAAE,CAEnB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EAAE,EACtB,MAAM,EAAE,WAAW,GAClB,KAAK,CAAC;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,WAAW,EAAE,eAAe,CAAA;CAAE,CAAC,CAO9D"}