@lunchflow/actual-flow 0.0.1

package/dist/ui.js

@@ -0,0 +1,278 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerminalUI = void 0;
+const inquirer_1 = __importDefault(require("inquirer"));
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const cli_table3_1 = __importDefault(require("cli-table3"));
+class TerminalUI {
+    async showWelcome() {
+        console.clear();
+        console.log(chalk_1.default.blue.bold('\n🍽️  Lunch Flow → Actual Budget Importer\n'));
+        console.log(chalk_1.default.gray('This tool helps you import transactions from Lunch Flow to Actual Budget\n'));
+    }
+    async getLunchFlowCredentials() {
+        console.log(chalk_1.default.yellow('📡 Lunch Flow Configuration\n'));
+        const answers = await inquirer_1.default.prompt([
+            {
+                type: 'input',
+                name: 'apiKey',
+                message: 'Enter your Lunch Flow API key:',
+                validate: (input) => input.length > 0 || 'API key is required',
+            },
+            {
+                type: 'input',
+                name: 'baseUrl',
+                message: 'Enter Lunch Flow API base URL:',
+                default: 'https://api.lunchflow.com',
+                validate: (input) => {
+                    try {
+                        new URL(input);
+                        return true;
+                    }
+                    catch {
+                        return 'Please enter a valid URL';
+                    }
+                },
+            },
+        ]);
+        return answers;
+    }
+    async getActualBudgetCredentials() {
+        console.log(chalk_1.default.yellow('\n💰 Actual Budget Configuration\n'));
+        console.log(chalk_1.default.gray('To find your budget sync ID:'));
+        console.log(chalk_1.default.gray('1. Open Actual Budget in your browser'));
+        console.log(chalk_1.default.gray('2. Go to Settings → Show advanced settings'));
+        console.log(chalk_1.default.gray('3. Look for "Sync ID" - that\'s your budget sync ID'));
+        console.log(chalk_1.default.gray('4. Or check the URL: http://localhost:5007/budget/your-sync-id'));
+        console.log(chalk_1.default.gray('5. The sync ID is the part after "/budget/"\n'));
+        const answers = await inquirer_1.default.prompt([
+            {
+                type: 'input',
+                name: 'serverUrl',
+                message: 'Enter Actual Budget server URL:',
+                default: 'http://localhost:5007',
+                validate: (input) => {
+                    try {
+                        new URL(input);
+                        return true;
+                    }
+                    catch {
+                        return 'Please enter a valid URL';
+                    }
+                },
+            },
+            {
+                type: 'input',
+                name: 'budgetSyncId',
+                message: 'Enter Actual Budget budget sync ID:',
+                validate: (input) => input.length > 0 || 'Budget sync ID is required',
+            },
+            {
+                type: 'password',
+                name: 'password',
+                message: 'Enter Actual Budget password (optional):',
+                mask: '*',
+            },
+        ]);
+        return answers;
+    }
+    async showConnectionStatus(status) {
+        console.log(chalk_1.default.blue('\n🔗 Connection Status\n'));
+        const lfStatus = status.lunchFlow ? chalk_1.default.green('✅ Connected') : chalk_1.default.red('❌ Disconnected');
+        const abStatus = status.actualBudget ? chalk_1.default.green('✅ Connected') : chalk_1.default.red('❌ Disconnected');
+        console.log(`Lunch Flow: ${lfStatus}`);
+        console.log(`Actual Budget: ${abStatus}\n`);
+    }
+    async showAccountsTable(accounts, title) {
+        console.log(chalk_1.default.blue(`\n${title}\n`));
+        if (accounts.length === 0) {
+            console.log(chalk_1.default.yellow('No accounts found.\n'));
+            return;
+        }
+        const table = new cli_table3_1.default({
+            head: ['ID', 'Name'],
+            colWidths: [8, 25],
+            style: {
+                head: ['cyan'],
+                border: ['gray'],
+            }
+        });
+        accounts.forEach(account => {
+            table.push([
+                account.id.toString().substring(0, 8) + '...',
+                account.name,
+            ]);
+        });
+        console.log(table.toString());
+    }
+    async configureAccountMappings(lfAccounts, abAccounts) {
+        console.log(chalk_1.default.yellow('\n📋 Configure Account Mappings\n'));
+        console.log(chalk_1.default.gray('Map each Lunch Flow account to an Actual Budget account:\n'));
+        const mappings = [];
+        for (const lfAccount of lfAccounts) {
+            const choices = abAccounts.map(abAccount => ({
+                name: `${abAccount.name} (${abAccount.currency})`,
+                value: abAccount.id,
+            }));
+            const answer = await inquirer_1.default.prompt([
+                {
+                    type: 'list',
+                    name: 'abAccountId',
+                    message: `Map "${lfAccount.name}" (${lfAccount.institution_name}) to:`,
+                    choices: [
+                        { name: 'Skip this account', value: 'skip' },
+                        ...choices,
+                    ],
+                },
+            ]);
+            if (answer.abAccountId !== 'skip') {
+                const abAccount = abAccounts.find(a => a.id === answer.abAccountId);
+                if (abAccount) {
+                    mappings.push({
+                        lunchFlowAccountId: lfAccount.id,
+                        lunchFlowAccountName: lfAccount.name,
+                        actualBudgetAccountId: abAccount.id,
+                        actualBudgetAccountName: abAccount.name,
+                    });
+                }
+            }
+        }
+        return mappings;
+    }
+    async showAccountMappings(mappings) {
+        console.log(chalk_1.default.blue('\n📋 Current Account Mappings\n'));
+        if (mappings.length === 0) {
+            console.log(chalk_1.default.yellow('No account mappings configured.\n'));
+            return;
+        }
+        const table = new cli_table3_1.default({
+            head: ['Lunch Flow Account', '→', 'Actual Budget Account'],
+            colWidths: [25, 3, 25],
+            style: {
+                head: ['cyan'],
+                border: ['gray'],
+            }
+        });
+        mappings.forEach(mapping => {
+            table.push([
+                mapping.lunchFlowAccountName,
+                '→',
+                mapping.actualBudgetAccountName
+            ]);
+        });
+        console.log(table.toString());
+    }
+    async confirmImport(transactionCount, dateRange) {
+        console.log(chalk_1.default.yellow('\n⚠️  Import Confirmation\n'));
+        console.log(`Date Range: ${dateRange.startDate} to ${dateRange.endDate}`);
+        console.log(`Transactions to import: ${transactionCount}\n`);
+        const answer = await inquirer_1.default.prompt([
+            {
+                type: 'confirm',
+                name: 'confirm',
+                message: 'Proceed with import?',
+                default: true,
+            },
+        ]);
+        return answer.confirm;
+    }
+    async showMainMenu() {
+        console.log(chalk_1.default.blue('\n🎯 Main Menu\n'));
+        const answer = await inquirer_1.default.prompt([
+            {
+                type: 'list',
+                name: 'action',
+                message: 'What would you like to do?',
+                choices: [
+                    { name: '🔗 Test connections', value: 'test' },
+                    { name: '📋 List available budgets', value: 'list-budgets' },
+                    { name: '📋 Configure account mappings', value: 'configure' },
+                    { name: '📊 Show current mappings', value: 'show' },
+                    { name: '📥 Import transactions', value: 'import' },
+                    { name: '⚙️  Reconfigure credentials', value: 'reconfigure' },
+                    { name: '❌ Exit', value: 'exit' },
+                ],
+            },
+        ]);
+        return answer.action;
+    }
+    async showReconfigureMenu() {
+        console.log(chalk_1.default.yellow('\n⚙️  Reconfigure Credentials\n'));
+        const answer = await inquirer_1.default.prompt([
+            {
+                type: 'list',
+                name: 'action',
+                message: 'What would you like to reconfigure?',
+                choices: [
+                    { name: 'Lunch Flow credentials', value: 'lunchflow' },
+                    { name: 'Actual Budget credentials', value: 'actualbudget' },
+                    { name: 'Both', value: 'both' },
+                    { name: 'Cancel', value: 'cancel' },
+                ],
+            },
+        ]);
+        return answer.action;
+    }
+    showSpinner(message) {
+        return (0, ora_1.default)(message).start();
+    }
+    showSuccess(message) {
+        console.log(chalk_1.default.green(`✅ ${message}`));
+    }
+    showError(message) {
+        console.log(chalk_1.default.red(`❌ ${message}`));
+    }
+    showInfo(message) {
+        console.log(chalk_1.default.blue(`ℹ️  ${message}`));
+    }
+    showWarning(message) {
+        console.log(chalk_1.default.yellow(`⚠️  ${message}`));
+    }
+    async showTransactionPreview(transactions, accounts, count = 10) {
+        console.log(chalk_1.default.blue(`\n📊 Transaction Preview (showing first ${Math.min(count, transactions.length)})\n`));
+        if (transactions.length === 0) {
+            console.log(chalk_1.default.yellow('No transactions to preview.\n'));
+            return;
+        }
+        const accountNames = accounts.reduce((acc, account) => {
+            acc[account.id] = account.name;
+            return acc;
+        }, {});
+        const table = new cli_table3_1.default({
+            head: ['Date', 'Description', 'Amount', 'Account'],
+            colWidths: [12, 30, 12, 20],
+            style: {
+                head: ['cyan'],
+                border: ['gray'],
+            }
+        });
+        transactions
+            .sort((a, b) => new Date(b.date).getTime() - new Date(a.date).getTime())
+            .slice(0, count)
+            .forEach(transaction => {
+            const amount = transaction.amount / 100;
+            const amountDisplay = transaction.amount >= 0
+                ? chalk_1.default.green(`+${amount.toFixed(2)}`)
+                : chalk_1.default.red(`-${Math.abs(amount).toFixed(2)}`);
+            table.push([
+                transaction.date,
+                transaction.imported_payee,
+                amountDisplay,
+                accountNames[transaction.account] || 'Unknown'
+            ]);
+        });
+        console.log(table.toString());
+        if (transactions.length > count) {
+            console.log(chalk_1.default.gray(`... and ${transactions.length - count} more transactions\n`));
+        }
+        else {
+            console.log();
+        }
+    }
+}
+exports.TerminalUI = TerminalUI;
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

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

package/install.sh

@@ -0,0 +1,55 @@
+#!/bin/bash
+
+echo "🍽️  Installing Lunch Flow → Actual Budget Importer"
+echo "=================================================="
+
+# Check if Node.js is installed
+if ! command -v node &> /dev/null; then
+    echo "❌ Node.js is not installed. Please install Node.js 16+ first."
+    echo "   Visit: https://nodejs.org/"
+    exit 1
+fi
+
+# Check Node.js version
+NODE_VERSION=$(node -v | cut -d'v' -f2 | cut -d'.' -f1)
+if [ "$NODE_VERSION" -lt 16 ]; then
+    echo "❌ Node.js version 16+ is required. Current version: $(node -v)"
+    exit 1
+fi
+
+echo "✅ Node.js $(node -v) detected"
+
+# Check if pnpm is installed
+if ! command -v pnpm &> /dev/null; then
+    echo "❌ pnpm is not installed. Please install pnpm first."
+    echo "   Run: npm install -g pnpm"
+    echo "   Or visit: https://pnpm.io/installation"
+    exit 1
+fi
+
+echo "✅ pnpm $(pnpm --version) detected"
+
+# Install dependencies
+echo "📦 Installing dependencies..."
+pnpm install
+
+if [ $? -ne 0 ]; then
+    echo "❌ Failed to install dependencies"
+    exit 1
+fi
+
+# Build the project
+echo "🔨 Building project..."
+pnpm run build
+
+if [ $? -ne 0 ]; then
+    echo "❌ Failed to build project"
+    exit 1
+fi
+
+echo "✅ Installation complete!"
+echo ""
+echo "🚀 To get started, run:"
+echo "   pnpm start"
+echo ""
+echo "📖 For more information, see README.md"

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@lunchflow/actual-flow",
+  "version": "0.0.1",
+  "description": "Import transactions from Lunch Flow to Actual Budget with terminal UI.",
+  "main": "dist/index.js",
+  "bin": {
+    "actual-flow": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts",
+    "prepare": "pnpm run build",
+    "install:dev": "pnpm install",
+    "clean": "rm -rf dist"
+  },
+  "keywords": ["lunch-flow", "actual-budget", "importer", "transactions"],
+  "author": "Amr Awad",
+  "license": "MIT",
+  "dependencies": {
+    "@actual-app/api": "^25.9.0",
+    "inquirer": "^8.2.6",
+    "chalk": "^4.1.2",
+    "ora": "^5.4.1",
+    "axios": "^1.6.0",
+    "dotenv": "^16.3.1",
+    "cli-table3": "^0.6.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/inquirer": "^9.0.7",
+    "typescript": "^5.0.0",
+    "ts-node": "^10.9.0"
+  }
+}

package/pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+packages:
+  - '.'

package/src/actual-budget-client.ts

@@ -0,0 +1,132 @@
+import * as actualAPI from '@actual-app/api';
+import { ActualBudgetTransaction, ActualBudgetAccount } from './types';
+import fs from 'fs';
+import path from 'path';
+
+export class ActualBudgetClient {
+  private serverUrl: string;
+  private budgetSyncId: string;
+  private password?: string;
+  private connected: boolean = false;
+  private dataDir: string;
+
+  constructor(serverUrl: string, budgetSyncId: string, password?: string) {
+    this.serverUrl = serverUrl;
+    this.budgetSyncId = budgetSyncId;
+    this.password = password;
+    this.dataDir = './actual-data'; // Local cache directory
+  }
+
+  async connect(): Promise<boolean> {
+    try {
+      // Ensure data directory exists
+      if (!fs.existsSync(this.dataDir)) {
+        fs.mkdirSync(this.dataDir, { recursive: true });
+      }
+
+      await actualAPI.init({
+        dataDir: this.dataDir,
+        serverURL: this.serverUrl,
+        password: this.password,
+      });
+      
+      // Download the budget to local cache
+      await actualAPI.downloadBudget(this.budgetSyncId);
+      
+      this.connected = true;
+      return true;
+    } catch (error: any) {
+      if (error.message.includes('budget directory does not exist')) {
+        console.error(`Budget with sync ID "${this.budgetSyncId}" does not exist on the server.`);
+        console.error('Please check your budget sync ID and try again.');
+      } else if (error.message.includes('ECONNREFUSED')) {
+        console.error(`Cannot connect to Actual Budget server at ${this.serverUrl}`);
+        console.error('Please check that your Actual Budget server is running.');
+      } else if (error.message.includes('not found')) {
+        console.error(`Budget with sync ID "${this.budgetSyncId}" not found on the server.`);
+        console.error('Please verify your budget sync ID in Actual Budget settings.');
+      } else {
+        console.error('Failed to connect to Actual Budget:', error.message);
+      }
+      this.connected = false;
+      return false;
+    }
+  }
+
+  async testConnection(): Promise<boolean> {
+    try {
+      await this.connect();
+      return this.connected;
+    } catch (error: any) {
+      console.error('Actual Budget connection test failed:', error.message);
+      return false;
+    }
+  }
+
+  async getAccounts(): Promise<ActualBudgetAccount[]> {
+    if (!this.connected) {
+      await this.connect();
+    }
+
+    try {
+      const accounts = await actualAPI.getAccounts();
+      return accounts.map((account: any) => ({
+        id: account.id,
+        name: account.name,
+        type: account.type as any,
+        balance: actualAPI.utils.integerToAmount(account.balance || 0),
+        currency: 'USD', // Assuming USD, adjust as needed
+      }));
+    } catch (error: any) {
+      console.error('Failed to fetch Actual Budget accounts:', error.message);
+      throw new Error(`Failed to fetch accounts: ${error.message}`);
+    }
+  }
+
+  async importTransactions(transactions: ActualBudgetTransaction[]): Promise<void> {
+    if (!this.connected) {
+      await this.connect();
+    }
+
+    try {
+      const result = await actualAPI.importTransactions(transactions[0].account, transactions);
+      console.log('Transactions imported successfully:', result);
+    } catch (error: any) {
+      console.error('Failed to import transactions to Actual Budget:', error.message);
+      throw new Error(`Failed to import transactions: ${error.message}`);
+    }
+  }
+
+  async listAvailableBudgets(): Promise<{ id: string; name: string }[]> {
+    try {
+      // Ensure data directory exists
+      if (!fs.existsSync(this.dataDir)) {
+        fs.mkdirSync(this.dataDir, { recursive: true });
+      }
+
+      await actualAPI.init({
+        dataDir: this.dataDir,
+        serverURL: this.serverUrl,
+        password: this.password,
+      });
+      
+      const budgets = await actualAPI.getBudgets();
+      return budgets.map((budget: any) => ({
+        id: budget.id,
+        name: budget.name || 'Unnamed Budget'
+      }));
+    } catch (error: any) {
+      console.error('Failed to fetch available budgets:', error.message);
+      throw new Error(`Failed to fetch budgets: ${error.message}`);
+    }
+  }
+
+  async shutdown(): Promise<void> {
+    try {
+      await actualAPI.shutdown();
+      this.connected = false;
+    } catch (error: any) {
+      console.error('Error during shutdown:', error.message);
+    }
+  }
+}

package/src/config-manager.ts

@@ -0,0 +1,128 @@
+import fs from 'fs';
+import path from 'path';
+import { Config, AccountMapping } from './types';
+
+export class ConfigManager {
+  private configPath: string;
+
+  constructor(configPath: string = path.join(process.cwd(), 'config.json')) {
+    this.configPath = configPath;
+  }
+
+  loadConfig(): Config | null {
+    try {
+      if (!fs.existsSync(this.configPath)) {
+        return null;
+      }
+      const configData = fs.readFileSync(this.configPath, 'utf8');
+      const config = JSON.parse(configData);
+      
+      // Validate config structure
+      if (!this.validateConfig(config)) {
+        console.warn('Invalid config file structure, will recreate');
+        return null;
+      }
+      
+      return config;
+    } catch (error) {
+      console.error('Failed to load config:', error);
+      return null;
+    }
+  }
+
+  saveConfig(config: Config): void {
+    try {
+      // Ensure directory exists
+      const dir = path.dirname(this.configPath);
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+      }
+      
+      fs.writeFileSync(this.configPath, JSON.stringify(config, null, 2));
+    } catch (error) {
+      console.error('Failed to save config:', error);
+      throw error;
+    }
+  }
+
+  createDefaultConfig(): Config {
+    return {
+      lunchFlow: {
+        apiKey: '',
+        baseUrl: 'https://api.lunchflow.com',
+      },
+      actualBudget: {
+        serverUrl: '',
+        budgetSyncId: '',
+        password: '',
+      },
+      accountMappings: [],
+    };
+  }
+
+  updateLunchFlowConfig(apiKey: string, baseUrl: string): void {
+    const config = this.loadConfig() || this.createDefaultConfig();
+    config.lunchFlow = { apiKey, baseUrl };
+    this.saveConfig(config);
+  }
+
+  updateActualBudgetConfig(serverUrl: string, budgetSyncId: string, password?: string): void {
+    const config = this.loadConfig() || this.createDefaultConfig();
+    config.actualBudget = { serverUrl, budgetSyncId, password };
+    this.saveConfig(config);
+  }
+
+  updateAccountMappings(mappings: AccountMapping[]): void {
+    const config = this.loadConfig();
+    if (config) {
+      config.accountMappings = mappings;
+      this.saveConfig(config);
+    }
+  }
+
+  private validateConfig(config: any): boolean {
+    return (
+      config &&
+      typeof config === 'object' &&
+      config.lunchFlow &&
+      typeof config.lunchFlow.apiKey === 'string' &&
+      typeof config.lunchFlow.baseUrl === 'string' &&
+      config.actualBudget &&
+      typeof config.actualBudget.serverUrl === 'string' &&
+      typeof config.actualBudget.budgetSyncId === 'string' &&
+      Array.isArray(config.accountMappings)
+    );
+  }
+
+  getConfigPath(): string {
+    return this.configPath;
+  }
+
+  // Check if config exists and has required fields
+  isConfigured(): boolean {
+    const config = this.loadConfig();
+    return config !== null && 
+           config.lunchFlow.apiKey.length > 0 && 
+           config.actualBudget.serverUrl.length > 0 && 
+           config.actualBudget.budgetSyncId.length > 0;
+  }
+
+  // Get a safe version of config for display (hides sensitive data)
+  getSafeConfig(): Partial<Config> | null {
+    const config = this.loadConfig();
+    if (!config) return null;
+
+    return {
+      lunchFlow: {
+        apiKey: config.lunchFlow.apiKey ? '***' + config.lunchFlow.apiKey.slice(-4) : '',
+        baseUrl: config.lunchFlow.baseUrl,
+      },
+      actualBudget: {
+        serverUrl: config.actualBudget.serverUrl,
+        budgetSyncId: config.actualBudget.budgetSyncId,
+        password: config.actualBudget.password ? '***' : '',
+      },
+      accountMappings: config.accountMappings,
+    };
+  }
+}