@firela/billclaw-core 0.1.3

package/dist/sources/gmail/gmail-fetch.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Gmail data source for BillClaw - Framework-agnostic Gmail integration
+ *
+ * Core business logic for fetching and processing bill emails from Gmail.
+ * OAuth token management is provided by the adapter layer.
+ */
+import type { Logger } from "../../errors/errors.js";
+import type { StorageConfig } from "../../models/config.js";
+import { type EmailContent, type GmailConfig } from "./bill-recognizer.js";
+export interface GmailAccount {
+    id: string;
+    gmailEmailAddress: string;
+}
+export interface GmailFetchResult {
+    success: boolean;
+    accountId: string;
+    emailsProcessed: number;
+    billsExtracted: number;
+    transactionsAdded: number;
+    transactionsUpdated: number;
+    errors?: string[];
+}
+/**
+ * Gmail fetcher options
+ */
+export interface GmailFetcherOptions {
+    accessToken: string;
+    userId?: string;
+    query?: string;
+    maxResults?: number;
+}
+/**
+ * Fetch emails from Gmail API
+ *
+ * NOTE: This is a framework-agnostic function that requires OAuth tokens.
+ * The adapter layer (OpenClaw or CLI) provides the access token.
+ *
+ * This implementation uses a simple fetch-based approach. For production use,
+ * consider using the official Gmail API client library.
+ */
+export declare function fetchGmailEmails(options: GmailFetcherOptions, config: GmailConfig, logger: Logger): Promise<EmailContent[]>;
+/**
+ * Fetch bills from Gmail
+ *
+ * Main entry point for Gmail bill fetching workflow:
+ * 1. Fetch emails matching criteria
+ * 2. Recognize which emails are bills
+ * 3. Parse bill emails into transactions
+ * 4. Store transactions
+ */
+export declare function fetchGmailBills(account: GmailAccount, _days: number | undefined, gmailConfig: GmailConfig, storageConfig: StorageConfig, logger: Logger, accessToken?: string): Promise<GmailFetchResult>;
+export * from "./bill-recognizer.js";
+export * from "./email-parser.js";
+//# sourceMappingURL=gmail-fetch.d.ts.map

package/dist/sources/gmail/gmail-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail-fetch.d.ts","sourceRoot":"","sources":["../../../src/sources/gmail/gmail-fetch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAG3D,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAA;AAM7B,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAoBD;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,EAAE,CAAC,CA8DzB;AA6KD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,MAAM,YAAK,EAClB,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC,CA8G3B;AAGD,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA"}

package/dist/sources/gmail/gmail-fetch.js

@@ -0,0 +1,300 @@
+/**
+ * Gmail data source for BillClaw - Framework-agnostic Gmail integration
+ *
+ * Core business logic for fetching and processing bill emails from Gmail.
+ * OAuth token management is provided by the adapter layer.
+ */
+import { appendTransactions } from "../../storage/transaction-storage.js";
+import { filterToBills, } from "./bill-recognizer.js";
+import { parseBillToTransaction, } from "./email-parser.js";
+/**
+ * Fetch emails from Gmail API
+ *
+ * NOTE: This is a framework-agnostic function that requires OAuth tokens.
+ * The adapter layer (OpenClaw or CLI) provides the access token.
+ *
+ * This implementation uses a simple fetch-based approach. For production use,
+ * consider using the official Gmail API client library.
+ */
+export async function fetchGmailEmails(options, config, logger) {
+    const { accessToken, userId = "me", query, maxResults = 50 } = options;
+    logger.info?.("Fetching emails from Gmail API...");
+    // Build Gmail search query
+    let searchQuery = query || buildGmailQuery(config);
+    try {
+        // Construct Gmail API URL
+        const apiUrl = new URL(`https://www.googleapis.com/gmail/v1/users/${userId}/messages`);
+        apiUrl.searchParams.set("q", searchQuery);
+        apiUrl.searchParams.set("maxResults", maxResults.toString());
+        // Fetch message list
+        const response = await fetch(apiUrl.toString(), {
+            headers: {
+                Authorization: `Bearer ${accessToken}`,
+                Accept: "application/json",
+            },
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Gmail API error: ${response.status} ${errorText}`);
+        }
+        const data = (await response.json());
+        const messages = data.messages || [];
+        logger.info?.(`Found ${messages.length} messages matching query`);
+        if (messages.length === 0) {
+            return [];
+        }
+        // Fetch full message details for each message
+        const emails = [];
+        for (const message of messages) {
+            try {
+                const email = await fetchGmailMessage(userId, message.id, accessToken);
+                if (email) {
+                    emails.push(email);
+                }
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : "Unknown error";
+                logger.warn?.(`Failed to fetch message ${message.id}: ${errorMsg}`);
+            }
+        }
+        return emails;
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : "Unknown error";
+        logger.error?.(`Gmail fetch failed: ${errorMsg}`);
+        throw error;
+    }
+}
+/**
+ * Fetch a single Gmail message with full details
+ */
+async function fetchGmailMessage(userId, messageId, accessToken) {
+    const apiUrl = new URL(`https://www.googleapis.com/gmail/v1/users/${userId}/messages/${messageId}`);
+    apiUrl.searchParams.set("format", "full");
+    const response = await fetch(apiUrl.toString(), {
+        headers: {
+            Authorization: `Bearer ${accessToken}`,
+            Accept: "application/json",
+        },
+    });
+    if (!response.ok) {
+        return null;
+    }
+    const message = (await response.json());
+    return parseGmailMessage(message);
+}
+/**
+ * Parse Gmail API message into EmailContent
+ */
+function parseGmailMessage(message) {
+    const headers = message.payload.headers || [];
+    const getHeader = (name) => {
+        const header = headers.find((h) => h.name.toLowerCase() === name.toLowerCase());
+        return header?.value || "";
+    };
+    const subject = getHeader("Subject");
+    const from = getHeader("From");
+    const to = getHeader("To");
+    const date = getHeader("Date");
+    // Extract body text
+    const body = extractMessageBody(message.payload);
+    return {
+        id: message.id,
+        subject,
+        from,
+        to,
+        date,
+        body,
+    };
+}
+/**
+ * Extract message body from Gmail payload
+ * Handles both plain text and HTML, traversing parts if needed
+ */
+function extractMessageBody(payload) {
+    // If body has data, decode it
+    if (payload.body?.data) {
+        return base64UrlDecode(payload.body.data);
+    }
+    // If there are parts, traverse them to find text content
+    if (payload.parts) {
+        for (const part of payload.parts) {
+            // Prefer plain text over HTML
+            if (part.mimeType === "text/plain" && part.body?.data) {
+                return base64UrlDecode(part.body.data);
+            }
+            if (part.mimeType === "text/html" && part.body?.data) {
+                // Strip HTML tags for plain text
+                const html = base64UrlDecode(part.body.data);
+                return html
+                    .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, "")
+                    .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, "")
+                    .replace(/<[^>]+>/g, " ")
+                    .replace(/\s+/g, " ")
+                    .trim();
+            }
+            // Recurse into nested parts
+            const nestedBody = extractMessageBody(part);
+            if (nestedBody) {
+                return nestedBody;
+            }
+        }
+    }
+    return "";
+}
+/**
+ * Decode base64url encoded string
+ */
+function base64UrlDecode(encoded) {
+    // Replace base64url characters with base64 standard
+    const base64 = encoded.replace(/-/g, "+").replace(/_/g, "/");
+    // Add padding if needed
+    const padded = base64.padEnd(Math.ceil(base64.length / 4) * 4, "=");
+    // Decode
+    try {
+        const binary = atob(padded);
+        const bytes = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i++) {
+            bytes[i] = binary.charCodeAt(i);
+        }
+        return new TextDecoder().decode(bytes);
+    }
+    catch {
+        // Fallback for simple base64 without padding
+        return atob(base64);
+    }
+}
+/**
+ * Build Gmail search query from config
+ */
+function buildGmailQuery(config) {
+    const parts = [];
+    // Add keyword search
+    if (config.keywords.length > 0) {
+        const keywordQuery = config.keywords.map((k) => `"${k}"`).join(" OR ");
+        parts.push(`(${keywordQuery})`);
+    }
+    // Add sender whitelist
+    if (config.senderWhitelist.length > 0) {
+        const senderQuery = config.senderWhitelist
+            .map((s) => {
+            if (s.startsWith("@")) {
+                return `from:${s}`;
+            }
+            return `from:${s}`;
+        })
+            .join(" OR ");
+        parts.push(`(${senderQuery})`);
+    }
+    // Add time filter (emails from last 30 days)
+    parts.push("newer_than:30d");
+    return parts.join(" ");
+}
+/**
+ * Parse ParsedTransaction to Transaction format for storage
+ */
+function parsedToStorageTransaction(parsed) {
+    return {
+        transactionId: parsed.transactionId,
+        plaidTransactionId: parsed.transactionId, // Gmail uses same field
+        accountId: parsed.accountId,
+        date: parsed.date,
+        amount: parsed.amount,
+        currency: parsed.currency,
+        category: parsed.category,
+        merchantName: parsed.merchantName,
+        paymentChannel: parsed.paymentChannel,
+        pending: parsed.pending,
+        createdAt: new Date().toISOString(),
+    };
+}
+/**
+ * Fetch bills from Gmail
+ *
+ * Main entry point for Gmail bill fetching workflow:
+ * 1. Fetch emails matching criteria
+ * 2. Recognize which emails are bills
+ * 3. Parse bill emails into transactions
+ * 4. Store transactions
+ */
+export async function fetchGmailBills(account, _days = 30, gmailConfig, storageConfig, logger, accessToken) {
+    if (!accessToken) {
+        return {
+            success: false,
+            accountId: account.id,
+            emailsProcessed: 0,
+            billsExtracted: 0,
+            transactionsAdded: 0,
+            transactionsUpdated: 0,
+            errors: ["No OAuth access token provided"],
+        };
+    }
+    try {
+        logger.info?.(`Fetching Gmail bills for account ${account.id}...`);
+        // Step 1: Fetch emails from Gmail
+        const emails = await fetchGmailEmails({
+            accessToken,
+            query: buildGmailQuery(gmailConfig),
+            maxResults: 50,
+        }, gmailConfig, logger);
+        logger.info?.(`Fetched ${emails.length} emails from Gmail`);
+        if (emails.length === 0) {
+            return {
+                success: true,
+                accountId: account.id,
+                emailsProcessed: 0,
+                billsExtracted: 0,
+                transactionsAdded: 0,
+                transactionsUpdated: 0,
+            };
+        }
+        // Step 2: Recognize bills from emails
+        const billEmails = filterToBills(emails, gmailConfig);
+        logger.info?.(`Identified ${billEmails.length} bill emails (threshold: ${gmailConfig.confidenceThreshold})`);
+        if (billEmails.length === 0) {
+            return {
+                success: true,
+                accountId: account.id,
+                emailsProcessed: emails.length,
+                billsExtracted: 0,
+                transactionsAdded: 0,
+                transactionsUpdated: 0,
+            };
+        }
+        // Step 3: Parse bills into transactions
+        const transactions = [];
+        for (const { email, recognition } of billEmails) {
+            const parsed = parseBillToTransaction(account.id, email.id, email.subject, email.body, email.from, email.date, recognition);
+            transactions.push(parsedToStorageTransaction(parsed));
+        }
+        // Step 4: Store transactions
+        const now = new Date();
+        const storageResult = await appendTransactions(account.id, now.getFullYear(), now.getMonth() + 1, transactions, storageConfig);
+        logger.info?.(`Stored ${storageResult.added} new, ${storageResult.updated} updated transactions`);
+        return {
+            success: true,
+            accountId: account.id,
+            emailsProcessed: emails.length,
+            billsExtracted: billEmails.length,
+            transactionsAdded: storageResult.added,
+            transactionsUpdated: storageResult.updated,
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : "Unknown error";
+        logger.error?.(`Gmail fetch failed: ${errorMsg}`);
+        return {
+            success: false,
+            accountId: account.id,
+            emailsProcessed: 0,
+            billsExtracted: 0,
+            transactionsAdded: 0,
+            transactionsUpdated: 0,
+            errors: [errorMsg],
+        };
+    }
+}
+// Re-export types and functions from submodules
+export * from "./bill-recognizer.js";
+export * from "./email-parser.js";
+//# sourceMappingURL=gmail-fetch.js.map

package/dist/sources/gmail/gmail-fetch.js.map

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

package/dist/sources/gmail/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Gmail data source for BillClaw
+ *
+ * @packageDocumentation
+ */
+export * from "./gmail-fetch.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/sources/gmail/index.d.ts.map

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

package/dist/sources/gmail/index.js

@@ -0,0 +1,7 @@
+/**
+ * Gmail data source for BillClaw
+ *
+ * @packageDocumentation
+ */
+export * from "./gmail-fetch.js";
+//# sourceMappingURL=index.js.map

package/dist/sources/gmail/index.js.map

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

package/dist/sources/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Data sources for BillClaw
+ *
+ * @packageDocumentation
+ */
+export * from "./plaid/index.js";
+export * from "./gmail/index.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/sources/index.js

@@ -0,0 +1,8 @@
+/**
+ * Data sources for BillClaw
+ *
+ * @packageDocumentation
+ */
+export * from "./plaid/index.js";
+export * from "./gmail/index.js";
+//# sourceMappingURL=index.js.map

package/dist/sources/index.js.map

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

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

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

package/dist/sources/plaid/index.d.ts.map

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

package/dist/sources/plaid/index.js

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

package/dist/sources/plaid/index.js.map

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

package/dist/sources/plaid/plaid-sync.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Plaid data source for BillClaw - Framework-agnostic Plaid integration
+ */
+import { PlaidApi } from "plaid";
+import type { StorageConfig, WebhookConfig } from "../../models/config.js";
+import type { Transaction } from "../../storage/transaction-storage.js";
+import type { Logger } from "../../errors/errors.js";
+export interface PlaidConfig {
+    clientId: string;
+    secret: string;
+    environment: "sandbox" | "development" | "production";
+}
+export interface PlaidAccount {
+    id: string;
+    plaidAccessToken: string;
+}
+export interface PlaidSyncResult {
+    success: boolean;
+    accountId: string;
+    transactionsAdded: number;
+    transactionsUpdated: number;
+    cursor: string;
+    errors?: string[];
+    requiresReauth?: boolean;
+}
+/**
+ * Create Plaid API client
+ */
+export declare function createPlaidClient(config: PlaidConfig): PlaidApi;
+/**
+ * Convert Plaid transaction to internal format
+ */
+export declare function convertTransaction(plaidTxn: any, accountId: string): Transaction;
+/**
+ * Sync transactions from a single Plaid account
+ */
+export declare function syncPlaidAccount(account: PlaidAccount, plaidClient: PlaidApi, storageConfig: StorageConfig, logger: Logger, webhooks?: WebhookConfig[]): Promise<PlaidSyncResult>;
+/**
+ * Sync multiple Plaid accounts
+ */
+export declare function syncPlaidAccounts(accounts: PlaidAccount[], plaidConfig: PlaidConfig, storageConfig: StorageConfig, logger: Logger, webhooks?: WebhookConfig[]): Promise<PlaidSyncResult[]>;
+//# sourceMappingURL=plaid-sync.d.ts.map

package/dist/sources/plaid/plaid-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plaid-sync.d.ts","sourceRoot":"","sources":["../../../src/sources/plaid/plaid-sync.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAiB,QAAQ,EAAqB,MAAM,OAAO,CAAA;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC1E,OAAO,KAAK,EACV,WAAW,EAEZ,MAAM,sCAAsC,CAAA;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAUpD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,SAAS,GAAG,aAAa,GAAG,YAAY,CAAA;CACtD;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,iBAAiB,EAAE,MAAM,CAAA;IACzB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,CAqB/D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,GAAG,EACb,SAAS,EAAE,MAAM,GAChB,WAAW,CAcb;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,QAAQ,EACrB,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,aAAa,EAAO,GAC7B,OAAO,CAAC,eAAe,CAAC,CAmJ1B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,YAAY,EAAE,EACxB,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,aAAa,EAAO,GAC7B,OAAO,CAAC,eAAe,EAAE,CAAC,CA0B5B"}