@firela/billclaw-core 0.1.3

package/dist/errors/errors.js

@@ -0,0 +1,315 @@
+/**
+ * Error handling utilities for BillClaw
+ *
+ * Provides user-friendly error messages, recovery suggestions,
+ * and troubleshooting guides.
+ *
+ * Framework-agnostic: Logger is provided via runtime abstraction.
+ */
+/**
+ * Error categories for better user messaging
+ */
+export var ErrorCategory;
+(function (ErrorCategory) {
+    // Configuration errors
+    ErrorCategory["CONFIG"] = "configuration";
+    ErrorCategory["CREDENTIALS"] = "credentials";
+    ErrorCategory["NETWORK"] = "network";
+    // Plaid errors
+    ErrorCategory["PLAID_API"] = "plaid_api";
+    ErrorCategory["PLAID_AUTH"] = "plaid_auth";
+    ErrorCategory["PLAID_ITEM"] = "plaid_item";
+    // Gmail errors
+    ErrorCategory["GMAIL_API"] = "gmail_api";
+    ErrorCategory["GMAIL_AUTH"] = "gmail_auth";
+    // Storage errors
+    ErrorCategory["STORAGE"] = "storage";
+    ErrorCategory["FILE_SYSTEM"] = "file_system";
+    // General errors
+    ErrorCategory["UNKNOWN"] = "unknown";
+})(ErrorCategory || (ErrorCategory = {}));
+/**
+ * Create a user-friendly error
+ */
+export function createUserError(category, title, message, suggestions, docsLink, originalError) {
+    return {
+        type: "UserError",
+        category,
+        title,
+        message,
+        suggestions,
+        docsLink,
+        error: originalError,
+    };
+}
+/**
+ * Format error for display to user
+ */
+export function formatError(error) {
+    const lines = [];
+    // Header with category emoji
+    const categoryEmoji = getCategoryEmoji(error.category);
+    lines.push(`${categoryEmoji} ${error.title}`);
+    lines.push("");
+    // Message
+    lines.push(error.message);
+    lines.push("");
+    // Suggestions
+    if (error.suggestions.length > 0) {
+        lines.push("Suggestions:");
+        for (let i = 0; i < error.suggestions.length; i++) {
+            lines.push(`   ${i + 1}. ${error.suggestions[i]}`);
+        }
+    }
+    // Docs link
+    if (error.docsLink) {
+        lines.push("");
+        lines.push(`Learn more: ${error.docsLink}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Get emoji for error category
+ */
+function getCategoryEmoji(category) {
+    const emojis = {
+        [ErrorCategory.CONFIG]: "⚙️",
+        [ErrorCategory.CREDENTIALS]: "🔑",
+        [ErrorCategory.NETWORK]: "🌐",
+        [ErrorCategory.PLAID_API]: "🏦",
+        [ErrorCategory.PLAID_AUTH]: "🔐",
+        [ErrorCategory.PLAID_ITEM]: "📝",
+        [ErrorCategory.GMAIL_API]: "📧",
+        [ErrorCategory.GMAIL_AUTH]: "🔐",
+        [ErrorCategory.STORAGE]: "💾",
+        [ErrorCategory.FILE_SYSTEM]: "📁",
+        [ErrorCategory.UNKNOWN]: "❓",
+    };
+    return emojis[category] || "❓";
+}
+/**
+ * Parse Plaid error codes and create user-friendly errors
+ */
+export function parsePlaidError(error) {
+    const errorCode = error.error_code || "UNKNOWN";
+    const errorMessage = error.error_message || error.display_message || "An error occurred";
+    const requestId = error.request_id;
+    // Login required
+    if (errorCode === "ITEM_LOGIN_REQUIRED" ||
+        error.error_type === "ITEM_LOGIN_REQUIRED") {
+        return createUserError(ErrorCategory.PLAID_AUTH, "Account Re-Authentication Required", "Your bank account requires re-authentication. This happens when your bank credentials have changed or expired.", [
+            "Re-authenticate via your adapter's setup command",
+            "This will open a secure browser window where you can log into your bank",
+            "After re-authentication, your transactions will sync normally",
+        ], "https://plaid.com/docs/errors/#item-login-required");
+    }
+    // Invalid credentials
+    if (errorCode === "INVALID_ACCESS_TOKEN" ||
+        error.error_type === "INVALID_ACCESS_TOKEN") {
+        return createUserError(ErrorCategory.PLAID_AUTH, "Invalid Access Token", "Your access token is invalid. This can happen if the token was revoked or corrupted.", [
+            "Run your adapter's setup command to reconnect your account",
+            "If this persists, remove and re-add the account",
+        ], "https://plaid.com/docs/errors/#invalid-access-token");
+    }
+    // Product not ready
+    if (errorCode === "PRODUCT_NOT_READY") {
+        return createUserError(ErrorCategory.PLAID_API, "Account Not Ready", "Your account is not fully set up yet. Plaid is still processing your account information.", [
+            "Wait a few minutes and try again",
+            "If this persists, contact Plaid support",
+        ], "https://plaid.com/docs/errors/#product-not-ready");
+    }
+    // Rate limit
+    if (errorCode === "RATE_LIMIT_EXCEEDED") {
+        return createUserError(ErrorCategory.PLAID_API, "API Rate Limit Exceeded", "Too many requests have been made to the Plaid API. Please wait before trying again.", [
+            "Wait a few minutes before syncing again",
+            "Consider syncing less frequently (e.g., daily instead of hourly)",
+            "If you need higher rate limits, upgrade your Plaid plan",
+        ], "https://plaid.com/docs/errors/#rate-limit-exceeded");
+    }
+    // Institution down
+    if (errorCode === "INSTITUTION_DOWN") {
+        return createUserError(ErrorCategory.PLAID_API, "Bank temporarily unavailable", "Your bank's systems are temporarily down for maintenance.", [
+            "Wait a few minutes and try again",
+            "Check your bank's website for service status updates",
+            "Your transactions will sync automatically once the bank is back online",
+        ], undefined);
+    }
+    // Invalid credentials
+    if (errorCode === "INVALID_CREDENTIALS") {
+        return createUserError(ErrorCategory.PLAID_API, "Invalid API Credentials", "The Plaid API credentials configured are invalid.", [
+            "Configure your Plaid client ID and secret",
+            "Verify your credentials at https://dashboard.plaid.com",
+        ], "https://dashboard.plaid.com");
+    }
+    // Generic Plaid error
+    return createUserError(ErrorCategory.PLAID_API, "Plaid API Error", `${errorMessage}${requestId ? ` (Request ID: ${requestId})` : ""}`, [
+        "Try again in a few minutes",
+        "Check Plaid status at https://status.plaid.com",
+    ], "https://plaid.com/docs/errors/");
+}
+/**
+ * Parse Gmail API errors and create user-friendly errors
+ */
+export function parseGmailError(error) {
+    const statusCode = error.status || error.code || 0;
+    // Unauthorized
+    if (statusCode === 401) {
+        return createUserError(ErrorCategory.GMAIL_AUTH, "Gmail Authentication Failed", "Your Gmail access has expired or been revoked. You need to re-authenticate.", [
+            "Re-authenticate with Gmail via your adapter's setup command",
+            "Make sure you grant read-only access to your Gmail",
+            "Check that Google Cloud OAuth credentials are valid",
+        ], "https://developers.google.com/gmail/api/auth");
+    }
+    // Forbidden
+    if (statusCode === 403) {
+        return createUserError(ErrorCategory.GMAIL_API, "Gmail Access Denied", "Access to Gmail was denied. This usually means the OAuth token lacks the required permissions.", [
+            "Make sure the Gmail API is enabled in Google Cloud Console",
+            "Verify that the OAuth consent screen includes 'gmail.readonly' scope",
+            "Re-authenticate to grant proper permissions",
+        ], "https://developers.google.com/gmail/api/auth");
+    }
+    // Not found
+    if (statusCode === 404) {
+        return createUserError(ErrorCategory.GMAIL_API, "Gmail API Not Found", "The Gmail API endpoint could not be found. This may be a configuration issue.", [
+            "Verify the Gmail API is enabled in your Google Cloud project",
+            "Check that the API name is correct: 'gmail.api'",
+            "Try re-enabling the Gmail API in Google Cloud Console",
+        ], "https://console.cloud.google.com/apis/library/gmail-api");
+    }
+    // Rate limit
+    if (statusCode === 429) {
+        return createUserError(ErrorCategory.GMAIL_API, "Gmail API Rate Limit Exceeded", "Too many requests have been made to the Gmail API. You've hit the daily quota limit.", [
+            "Wait until tomorrow when the quota resets",
+            "Reduce sync frequency to avoid hitting the limit",
+            "Consider using Gmail push notifications instead of polling",
+            "Free tier: 250 quota units/day",
+        ], "https://developers.google.com/gmail/api/v1/quota");
+    }
+    // Generic Gmail error
+    return createUserError(ErrorCategory.GMAIL_API, "Gmail API Error", error.message || "An error occurred while communicating with Gmail", [
+        "Check your internet connection",
+        "Verify Gmail API is enabled in Google Cloud Console",
+        "Try again in a few minutes",
+    ], "https://developers.google.com/gmail/api");
+}
+/**
+ * Parse network errors
+ */
+export function parseNetworkError(error) {
+    const message = error.message.toLowerCase();
+    // Connection refused
+    if (message.includes("econnrefused") ||
+        message.includes("connection refused")) {
+        return createUserError(ErrorCategory.NETWORK, "Connection Refused", "Could not connect to the server. The service may be down or your network is blocking the connection.", [
+            "Check your internet connection",
+            "Verify you're not behind a firewall or proxy",
+            "If using a VPN, try disconnecting it",
+            "Check if the service is temporarily down",
+        ], undefined);
+    }
+    // Timeout
+    if (message.includes("timeout") || message.includes("timed out")) {
+        return createUserError(ErrorCategory.NETWORK, "Request Timeout", "The request took too long to complete. This could be due to slow network or server issues.", [
+            "Check your internet connection speed",
+            "Try again in a few minutes",
+            "If syncing many transactions, consider reducing the date range",
+        ], undefined);
+    }
+    // DNS resolution failed
+    if (message.includes("enotfound") || message.includes("getaddrinfo")) {
+        return createUserError(ErrorCategory.NETWORK, "DNS Resolution Failed", "Could not resolve the server address. This might be a DNS or network configuration issue.", [
+            "Check your internet connection",
+            "Try switching to a different DNS server (e.g., 8.8.8.8)",
+            "Flush your DNS cache",
+            "If you're using a VPN, try disconnecting it",
+        ], undefined);
+    }
+    // Generic network error
+    return createUserError(ErrorCategory.NETWORK, "Network Error", error.message || "An error occurred while communicating with the server", [
+        "Check your internet connection",
+        "Try again in a few minutes",
+        "If the problem persists, check your network settings",
+    ], undefined);
+}
+/**
+ * Parse file system errors
+ */
+export function parseFileSystemError(error, filePath) {
+    const code = error.code;
+    const message = error.message;
+    // Permission denied
+    if (code === "EACCES" || code === "EPERM") {
+        return createUserError(ErrorCategory.FILE_SYSTEM, "Permission Denied", `Cannot access ${filePath || "file or directory"}. You don't have the required permissions.`, [
+            "Check file/directory permissions",
+            "Ensure the user has read/write access to the data directory",
+        ], undefined);
+    }
+    // No space left
+    if (code === "ENOSPC") {
+        return createUserError(ErrorCategory.STORAGE, "Disk Full", "No space left on device. Cannot save transactions.", [
+            "Free up disk space by deleting unnecessary files",
+            "Consider moving the BillClaw data directory to a drive with more space",
+        ], undefined);
+    }
+    // Directory not found
+    if (code === "ENOENT" && message.includes("no such file")) {
+        return createUserError(ErrorCategory.FILE_SYSTEM, "File or Directory Not Found", `The file or directory ${filePath || ""} does not exist.`, [
+            "Run setup to initialize BillClaw",
+            "Verify the data directory path is correct",
+        ], undefined);
+    }
+    // Generic file system error
+    return createUserError(ErrorCategory.FILE_SYSTEM, "File System Error", message || "An error occurred while accessing the file system", [
+        "Check file/directory permissions",
+        "Ensure the data directory exists and is writable",
+        "Try running setup to reinitialize",
+    ], undefined);
+}
+/**
+ * Type guard to check if error is a UserError
+ */
+export function isUserError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "type" in error &&
+        error.type === "UserError");
+}
+/**
+ * Log error with context for debugging
+ */
+export function logError(logger, error, context) {
+    const logData = {
+        timestamp: new Date().toISOString(),
+        category: isUserError(error) ? error.category : ErrorCategory.UNKNOWN,
+        message: error.message,
+        context,
+    };
+    if (isUserError(error) && error.error) {
+        logData.originalError = {
+            name: error.error.name,
+            message: error.error.message,
+            stack: error.error.stack,
+        };
+    }
+    logger?.error?.("BillClaw error:", JSON.stringify(logData, null, 2));
+}
+/**
+ * Get troubleshooting guide URL for error category
+ */
+export function getTroubleshootingUrl(category) {
+    const baseUrl = "https://github.com/fire-la/billclaw/blob/main/docs/troubleshooting.md";
+    const urls = {
+        [ErrorCategory.CONFIG]: `${baseUrl}#configuration-issues`,
+        [ErrorCategory.CREDENTIALS]: `${baseUrl}#credentials--authentication`,
+        [ErrorCategory.NETWORK]: `${baseUrl}#network-issues`,
+        [ErrorCategory.PLAID_API]: `${baseUrl}#plaid-integration`,
+        [ErrorCategory.PLAID_AUTH]: `${baseUrl}#credentials--authentication`,
+        [ErrorCategory.PLAID_ITEM]: `${baseUrl}#plaid-integration`,
+        [ErrorCategory.GMAIL_API]: `${baseUrl}#gmail-integration`,
+        [ErrorCategory.GMAIL_AUTH]: `${baseUrl}#credentials--authentication`,
+        [ErrorCategory.STORAGE]: `${baseUrl}#storage-issues`,
+        [ErrorCategory.FILE_SYSTEM]: `${baseUrl}#storage-issues`,
+    };
+    return urls[category] || baseUrl;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors/errors.js.map

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

package/dist/errors/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Error handling utilities for BillClaw
+ *
+ * @packageDocumentation
+ */
+export * from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/errors/index.js

@@ -0,0 +1,7 @@
+/**
+ * Error handling utilities for BillClaw
+ *
+ * @packageDocumentation
+ */
+export * from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

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

package/dist/exporters/beancount.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Beancount export functionality for BillClaw
+ *
+ * This module provides functionality to export BillClaw transactions
+ * to the Beancount plain text accounting format.
+ *
+ * Beancount format reference: https://beancount.github.io/docs/beancount_language_syntax.html
+ */
+import type { Transaction } from "../storage/transaction-storage.js";
+import type { StorageConfig } from "../models/config.js";
+/**
+ * Beancount transaction options
+ */
+export interface BeancountExportOptions {
+    accountId: string;
+    year: number;
+    month: number;
+    commodity?: string;
+    payeeAccount?: string;
+    tagAccounts?: Record<string, string>;
+    includeTags?: boolean;
+    dateFormat?: string;
+}
+/**
+ * Convert a BillClaw transaction to Beancount format
+ */
+export declare function transactionToBeancount(txn: Transaction, options: BeancountExportOptions): string;
+/**
+ * Export transactions to Beancount format
+ */
+export declare function exportToBeancount(transactions: Transaction[], options: BeancountExportOptions): Promise<string>;
+/**
+ * Export transactions from storage to Beancount format
+ */
+export declare function exportStorageToBeancount(accountId: string, year: number, month: number, storageConfig: StorageConfig, options?: Partial<BeancountExportOptions>): Promise<string>;
+/**
+ * Get recommended account mappings for Beancount
+ *
+ * Returns a suggested mapping of BillClaw categories to Beancount accounts
+ */
+export declare function getBeancountAccountMappings(): Record<string, string>;
+//# sourceMappingURL=beancount.d.ts.map

package/dist/exporters/beancount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beancount.d.ts","sourceRoot":"","sources":["../../src/exporters/beancount.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAA;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGxD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,sBAAsB,GAC9B,MAAM,CAiDR;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,WAAW,EAAE,EAC3B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,aAAa,EAC5B,OAAO,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACxC,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsDpE"}

package/dist/exporters/beancount.js

@@ -0,0 +1,141 @@
+/**
+ * Beancount export functionality for BillClaw
+ *
+ * This module provides functionality to export BillClaw transactions
+ * to the Beancount plain text accounting format.
+ *
+ * Beancount format reference: https://beancount.github.io/docs/beancount_language_syntax.html
+ */
+import { readTransactions } from "../storage/transaction-storage.js";
+/**
+ * Convert a BillClaw transaction to Beancount format
+ */
+export function transactionToBeancount(txn, options) {
+    const currency = options.commodity || "USD";
+    // Format date
+    const date = txn.date;
+    // Build payee line
+    const payee = txn.merchantName || "Unknown";
+    const narration = txn.category?.join(", ") || "";
+    // 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}"${tags}\n`;
+    // Add narration if present
+    if (narration) {
+        output += `  "${narration}"\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}  ${amount} ${currency}\n`;
+        output += `  Assets:Bank:Checking\n`;
+    }
+    else {
+        // Income/Inflow
+        output += `  Assets:Bank:Checking  ${amount} ${currency}\n`;
+        output += `  ${targetAccount}\n`;
+    }
+    return output;
+}
+/**
+ * Export transactions to Beancount format
+ */
+export async function exportToBeancount(transactions, options) {
+    // Build Beancount file header (always include this)
+    let output = `;; Beancount 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";
+    if (transactions.length === 0) {
+        output += "; No transactions found\n";
+        return output;
+    }
+    // Add each transaction
+    for (const txn of transactions) {
+        output += transactionToBeancount(txn, options);
+        output += "\n";
+    }
+    return output;
+}
+/**
+ * Export transactions from storage to Beancount format
+ */
+export async function exportStorageToBeancount(accountId, year, month, storageConfig, options) {
+    const transactions = await readTransactions(accountId, year, month, storageConfig);
+    const fullOptions = {
+        accountId,
+        year,
+        month,
+        ...options,
+    };
+    return exportToBeancount(transactions, fullOptions);
+}
+/**
+ * Get recommended account mappings for Beancount
+ *
+ * Returns a suggested mapping of BillClaw categories to Beancount accounts
+ */
+export function getBeancountAccountMappings() {
+    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=beancount.js.map

package/dist/exporters/beancount.js.map

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

package/dist/exporters/index.d.ts

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

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

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

package/dist/exporters/index.js

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

package/dist/exporters/index.js.map

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

package/dist/exporters/ledger.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 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 type { Transaction } from "../storage/transaction-storage.js";
+import type { StorageConfig } from "../models/config.js";
+/**
+ * Ledger transaction options
+ */
+export interface LedgerExportOptions {
+    accountId: string;
+    year: number;
+    month: number;
+    commodity?: string;
+    payeeAccount?: string;
+    tagAccounts?: Record<string, string>;
+    includeTags?: boolean;
+    dateFormat?: string;
+}
+/**
+ * Convert a BillClaw transaction to Ledger format
+ */
+export declare function transactionToLedger(txn: Transaction, options: LedgerExportOptions): string;
+/**
+ * Export transactions to Ledger format
+ */
+export declare function exportToLedger(transactions: Transaction[], options: LedgerExportOptions): Promise<string>;
+/**
+ * Export transactions from storage to Ledger format
+ */
+export declare function exportStorageToLedger(accountId: string, year: number, month: number, storageConfig: StorageConfig, options?: Partial<LedgerExportOptions>): Promise<string>;
+/**
+ * Get recommended account mappings for Ledger
+ *
+ * Returns a suggested mapping of BillClaw categories to Ledger accounts
+ */
+export declare function getLedgerAccountMappings(): Record<string, string>;
+//# sourceMappingURL=ledger.d.ts.map

package/dist/exporters/ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../../src/exporters/ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAA;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGxD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,mBAAmB,GAC3B,MAAM,CAgDR;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,YAAY,EAAE,WAAW,EAAE,EAC3B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,aAAa,EAC5B,OAAO,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GACrC,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAsDjE"}