@firela/billclaw-core 0.1.3

package/dist/exporters/ledger.js

@@ -0,0 +1,139 @@
+/**
+ * Ledger (ledger-cli) export functionality for BillClaw
+ *
+ * This module provides functionality to export BillClaw transactions
+ * to the Ledger plain text accounting format.
+ *
+ * Ledger format reference: https://www.ledger-cli.org/3.0/doc/ledger3.html
+ */
+import { readTransactions } from "../storage/transaction-storage.js";
+/**
+ * Convert a BillClaw transaction to Ledger format
+ */
+export function transactionToLedger(txn, options) {
+    const currency = options.commodity || "$";
+    // Format date
+    const date = txn.date.replace(/-/g, "/");
+    // Build payee/code line
+    const payee = txn.merchantName || "Unknown";
+    // Build tags
+    let tags = "";
+    if (options.includeTags) {
+        const sourceTag = txn.paymentChannel === "email" ? "#gmail" : "#plaid";
+        tags = `  ; :${sourceTag}:`;
+        if (txn.pending) {
+            tags += ":pending:";
+        }
+    }
+    // Build transaction header
+    let output = `${date} ${payee}\n`;
+    // Determine target account based on category
+    const targetAccount = options.tagAccounts?.[txn.category?.[0] || ""] ||
+        options.payeeAccount ||
+        "Expenses:Unknown";
+    // Format amount (convert from cents to dollars)
+    const amount = (Math.abs(txn.amount) / 100).toFixed(2);
+    // Build postings
+    if (txn.amount < 0) {
+        // Expense/Outflow
+        output += `    ${targetAccount}    ${currency}${amount}\n`;
+        output += `    Assets:Bank:Checking\n`;
+    }
+    else {
+        // Income/Inflow
+        output += `    Assets:Bank:Checking    ${currency}${amount}\n`;
+        output += `    ${targetAccount}\n`;
+    }
+    // Add tags if requested
+    if (tags) {
+        output += tags + "\n";
+    }
+    return output;
+}
+/**
+ * Export transactions to Ledger format
+ */
+export async function exportToLedger(transactions, options) {
+    if (transactions.length === 0) {
+        return "; No transactions found\n";
+    }
+    // Build Ledger file
+    let output = `;; Ledger export from BillClaw\n`;
+    output += `;; Account: ${options.accountId}\n`;
+    output += `;; Period: ${options.year}-${String(options.month).padStart(2, "0")}\n`;
+    output += `;; Exported: ${new Date().toISOString()}\n`;
+    output += "\n";
+    // Add each transaction
+    for (const txn of transactions) {
+        output += transactionToLedger(txn, options);
+        output += "\n";
+    }
+    return output;
+}
+/**
+ * Export transactions from storage to Ledger format
+ */
+export async function exportStorageToLedger(accountId, year, month, storageConfig, options) {
+    const transactions = await readTransactions(accountId, year, month, storageConfig);
+    const fullOptions = {
+        accountId,
+        year,
+        month,
+        ...options,
+    };
+    return exportToLedger(transactions, fullOptions);
+}
+/**
+ * Get recommended account mappings for Ledger
+ *
+ * Returns a suggested mapping of BillClaw categories to Ledger accounts
+ */
+export function getLedgerAccountMappings() {
+    return {
+        // Food & Dining
+        "Food and Drink": "Expenses:Food:Restaurants",
+        "Fast Food": "Expenses:Food:FastFood",
+        Groceries: "Expenses:Food:Groceries",
+        // Transportation
+        Travel: "Expenses:Travel",
+        Gasoline: "Expenses:Transport:Fuel",
+        Parking: "Expenses:Transport:Parking",
+        Taxi: "Expenses:Transport:Taxi",
+        "Ride Share": "Expenses:Transport:Rideshare",
+        "Public Transportation": "Expenses:Transport:Public",
+        // Shopping
+        Shopping: "Expenses:Shopping:General",
+        Electronics: "Expenses:Shopping:Electronics",
+        Clothing: "Expenses:Shopping:Clothing",
+        "Home Improvement": "Expenses:Home:Improvement",
+        // Entertainment
+        Entertainment: "Expenses:Entertainment:General",
+        Movies: "Expenses:Entertainment:Movies",
+        Music: "Expenses:Entertainment:Music",
+        Games: "Expenses:Entertainment:Games",
+        Sports: "Expenses:Entertainment:Sports",
+        // Bills & Utilities
+        Utilities: "Expenses:Utilities:General",
+        Electric: "Expenses:Utilities:Electric",
+        Gas: "Expenses:Utilities:Gas",
+        Water: "Expenses:Utilities:Water",
+        Internet: "Expenses:Utilities:Internet",
+        Phone: "Expenses:Utilities:Phone",
+        Subscription: "Expenses:Subscriptions",
+        // Health
+        Healthcare: "Expenses:Health:Medical",
+        Pharmacy: "Expenses:Health:Pharmacy",
+        Insurance: "Expenses:Insurance:Health",
+        // Financial
+        Finance: "Expenses:Financial:Fees",
+        "Bank Fee": "Expenses:Financial:BankFees",
+        Interest: "Expenses:Financial:Interest",
+        Transfer: "Expenses:Financial:Transfer",
+        // Income
+        Income: "Income:General",
+        Salary: "Income:Salary",
+        Refund: "Income:Refunds",
+        Investment: "Income:Investments",
+    };
+}
+//# sourceMappingURL=ledger.js.map

package/dist/exporters/ledger.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * BillClaw Core - Framework-agnostic business logic for financial data import
+ *
+ * This package contains all core functionality with zero dependencies on any
+ * AI framework (OpenClaw, OpenHands, etc.).
+ *
+ * @packageDocumentation
+ */
+export { Billclaw } from "./billclaw.js";
+export * from "./models/index.js";
+export * from "./storage/index.js";
+export * from "./sync/index.js";
+export { syncPlaidAccounts, syncPlaidAccount, createPlaidClient, convertTransaction, type PlaidConfig, type PlaidAccount, type PlaidSyncResult, } from "./sources/plaid/plaid-sync.js";
+export { fetchGmailBills, fetchGmailEmails, recognizeBill, parseBillToTransaction, type GmailConfig, type GmailAccount, type GmailFetchResult, type GmailFetcherOptions, type EmailContent, type BillRecognition, } from "./sources/gmail/gmail-fetch.js";
+export { exportToBeancount, exportStorageToBeancount, transactionToBeancount, getBeancountAccountMappings, type BeancountExportOptions, } from "./exporters/beancount.js";
+export { exportToLedger, exportStorageToLedger, transactionToLedger, getLedgerAccountMappings, type LedgerExportOptions, } from "./exporters/ledger.js";
+export * from "./errors/index.js";
+export * from "./credentials/index.js";
+export * from "./security/index.js";
+export * from "./runtime/index.js";
+export * from "./services/index.js";
+export declare const VERSION: "0.0.1";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAGxC,cAAc,mBAAmB,CAAA;AAGjC,cAAc,oBAAoB,CAAA;AAGlC,cAAc,iBAAiB,CAAA;AAG/B,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,eAAe,GACrB,MAAM,+BAA+B,CAAA;AACtC,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,sBAAsB,EACtB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,eAAe,GACrB,MAAM,gCAAgC,CAAA;AAGvC,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,EAC3B,KAAK,sBAAsB,GAC5B,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,KAAK,mBAAmB,GACzB,MAAM,uBAAuB,CAAA;AAG9B,cAAc,mBAAmB,CAAA;AAGjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AAGnC,cAAc,oBAAoB,CAAA;AAGlC,cAAc,qBAAqB,CAAA;AAGnC,eAAO,MAAM,OAAO,EAAG,OAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,34 @@
+/**
+ * BillClaw Core - Framework-agnostic business logic for financial data import
+ *
+ * This package contains all core functionality with zero dependencies on any
+ * AI framework (OpenClaw, OpenHands, etc.).
+ *
+ * @packageDocumentation
+ */
+// Main class
+export { Billclaw } from "./billclaw.js";
+// Models and schemas
+export * from "./models/index.js";
+// Storage
+export * from "./storage/index.js";
+// Sync
+export * from "./sync/index.js";
+// Data sources (note: some types may overlap with parsers)
+export { syncPlaidAccounts, syncPlaidAccount, createPlaidClient, convertTransaction, } from "./sources/plaid/plaid-sync.js";
+export { fetchGmailBills, fetchGmailEmails, recognizeBill, parseBillToTransaction, } from "./sources/gmail/gmail-fetch.js";
+// Exporters
+export { exportToBeancount, exportStorageToBeancount, transactionToBeancount, getBeancountAccountMappings, } from "./exporters/beancount.js";
+export { exportToLedger, exportStorageToLedger, transactionToLedger, getLedgerAccountMappings, } from "./exporters/ledger.js";
+// Errors
+export * from "./errors/index.js";
+// Credentials & Security
+export * from "./credentials/index.js";
+export * from "./security/index.js";
+// Runtime abstractions
+export * from "./runtime/index.js";
+// Services (event emission, webhooks)
+export * from "./services/index.js";
+// Version
+export const VERSION = "0.0.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":"AAAA;;;;;;;GAOG;AAEH,aAAa;AACb,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,qBAAqB;AACrB,cAAc,mBAAmB,CAAA;AAEjC,UAAU;AACV,cAAc,oBAAoB,CAAA;AAElC,OAAO;AACP,cAAc,iBAAiB,CAAA;AAE/B,2DAA2D;AAC3D,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GAInB,MAAM,+BAA+B,CAAA;AACtC,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,sBAAsB,GAOvB,MAAM,gCAAgC,CAAA;AAEvC,YAAY;AACZ,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,GAE5B,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,GAEzB,MAAM,uBAAuB,CAAA;AAE9B,SAAS;AACT,cAAc,mBAAmB,CAAA;AAEjC,yBAAyB;AACzB,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AAEnC,uBAAuB;AACvB,cAAc,oBAAoB,CAAA;AAElC,sCAAsC;AACtC,cAAc,qBAAqB,CAAA;AAEnC,UAAU;AACV,MAAM,CAAC,MAAM,OAAO,GAAG,OAAgB,CAAA"}