@stephendolan/ynab-cli 1.2.4 → 1.2.6

package/dist/cli.js

@@ -3,9 +3,6 @@
 // src/cli.ts
 import { Command as Command11 } from "commander";
 
-// src/lib/utils.ts
-import { format, parseISO } from "date-fns";
-
 // src/lib/errors.ts
 var YnabCliError = class extends Error {
   constructor(message, statusCode) {
@@ -162,7 +159,10 @@ function parseStatusFilter(value) {
   const validStatuses = ["cleared", "uncleared", "reconciled"];
   for (const status of statuses) {
     if (!validStatuses.includes(status)) {
-      throw new YnabCliError(`Invalid status '${status}'. Must be one of: ${validStatuses.join(", ")}`, 400);
+      throw new YnabCliError(
+        `Invalid status '${status}'. Must be one of: ${validStatuses.join(", ")}`,
+        400
+      );
     }
   }
   return statuses;
@@ -196,11 +196,11 @@ function applyFieldSelection(items, fields) {
   return items.map((item) => {
     const filtered = {};
     const itemRecord = item;
-    fieldList.forEach((field) => {
+    for (const field of fieldList) {
       if (field in itemRecord) {
         filtered[field] = itemRecord[field];
       }
-    });
+    }
     return filtered;
   });
 }
@@ -475,14 +475,6 @@ var YnabClient = class {
       return response.data.account;
     });
   }
-  async createAccount(accountData, budgetId) {
-    return this.withErrorHandling(async () => {
-      const api = await this.getApi();
-      const id = await this.getBudgetId(budgetId);
-      const response = await api.accounts.createAccount(id, accountData);
-      return response.data.account;
-    });
-  }
   async getCategories(budgetId, lastKnowledgeOfServer) {
     return this.withErrorHandling(async () => {
       const api = await this.getApi();
@@ -502,22 +494,6 @@ var YnabClient = class {
       return response.data.category;
     });
   }
-  async updateCategory(categoryId, data, budgetId) {
-    return this.withErrorHandling(async () => {
-      const api = await this.getApi();
-      const id = await this.getBudgetId(budgetId);
-      const response = await api.categories.updateCategory(id, categoryId, data);
-      return response.data.category;
-    });
-  }
-  async getMonthCategory(month, categoryId, budgetId) {
-    return this.withErrorHandling(async () => {
-      const api = await this.getApi();
-      const id = await this.getBudgetId(budgetId);
-      const response = await api.categories.getMonthCategoryById(id, month, categoryId);
-      return response.data.category;
-    });
-  }
   async updateMonthCategory(month, categoryId, data, budgetId) {
     return this.withErrorHandling(async () => {
       const api = await this.getApi();
@@ -553,22 +529,6 @@ var YnabClient = class {
       return response.data.payee;
     });
   }
-  async getPayeeLocations(budgetId) {
-    return this.withErrorHandling(async () => {
-      const api = await this.getApi();
-      const id = await this.getBudgetId(budgetId);
-      const response = await api.payeeLocations.getPayeeLocations(id);
-      return response.data.payee_locations;
-    });
-  }
-  async getPayeeLocation(payeeLocationId, budgetId) {
-    return this.withErrorHandling(async () => {
-      const api = await this.getApi();
-      const id = await this.getBudgetId(budgetId);
-      const response = await api.payeeLocations.getPayeeLocationById(id, payeeLocationId);
-      return response.data.payee_location;
-    });
-  }
   async getPayeeLocationsByPayee(payeeId, budgetId) {
     return this.withErrorHandling(async () => {
       const api = await this.getApi();
@@ -679,34 +639,14 @@ var YnabClient = class {
       return response.data.transaction;
     });
   }
-  async createTransactions(transactionsData, budgetId) {
-    return this.withErrorHandling(async () => {
-      const api = await this.getApi();
-      const id = await this.getBudgetId(budgetId);
-      const response = await api.transactions.createTransactions(id, transactionsData);
-      return response.data;
-    });
-  }
   async updateTransaction(transactionId, transactionData, budgetId) {
     return this.withErrorHandling(async () => {
       const api = await this.getApi();
       const id = await this.getBudgetId(budgetId);
-      const response = await api.transactions.updateTransaction(
-        id,
-        transactionId,
-        transactionData
-      );
+      const response = await api.transactions.updateTransaction(id, transactionId, transactionData);
       return response.data.transaction;
     });
   }
-  async updateTransactions(transactionsData, budgetId) {
-    return this.withErrorHandling(async () => {
-      const api = await this.getApi();
-      const id = await this.getBudgetId(budgetId);
-      const response = await api.transactions.updateTransactions(id, transactionsData);
-      return response.data;
-    });
-  }
   async deleteTransaction(transactionId, budgetId) {
     return this.withErrorHandling(async () => {
       const api = await this.getApi();
@@ -748,26 +688,6 @@ var YnabClient = class {
       return response.data.scheduled_transaction;
     });
   }
-  async createScheduledTransaction(data, budgetId) {
-    return this.withErrorHandling(async () => {
-      const api = await this.getApi();
-      const id = await this.getBudgetId(budgetId);
-      const response = await api.scheduledTransactions.createScheduledTransaction(id, data);
-      return response.data.scheduled_transaction;
-    });
-  }
-  async updateScheduledTransaction(scheduledTransactionId, data, budgetId) {
-    return this.withErrorHandling(async () => {
-      const api = await this.getApi();
-      const id = await this.getBudgetId(budgetId);
-      const response = await api.scheduledTransactions.updateScheduledTransaction(
-        id,
-        scheduledTransactionId,
-        data
-      );
-      return response.data.scheduled_transaction;
-    });
-  }
   async deleteScheduledTransaction(scheduledTransactionId, budgetId) {
     return this.withErrorHandling(async () => {
       const api = await this.getApi();
@@ -784,8 +704,9 @@ var YnabClient = class {
       await this.getApi();
       const fullPath = path.includes("{budget_id}") ? path.replace("{budget_id}", await this.getBudgetId(budgetId)) : path;
       const url = `https://api.ynab.com/v1${fullPath}`;
+      const accessToken = await auth.getAccessToken() || process.env.YNAB_API_KEY;
       const headers = {
-        Authorization: `Bearer ${await auth.getAccessToken()}`,
+        Authorization: `Bearer ${accessToken}`,
         "Content-Type": "application/json"
       };
       const httpMethod = method.toUpperCase();
@@ -845,40 +766,46 @@ function buildUpdateObject(options, mapping) {
 // src/commands/auth.ts
 function createAuthCommand() {
   const cmd = new Command("auth").description("Authentication management");
-  cmd.command("login").description("Configure access token").action(withErrorHandling(async () => {
-    const token = await promptForAccessToken();
-    await auth.setAccessToken(token);
-    client.clearApi();
-    try {
-      const user = await client.getUser();
-      outputJson({
-        message: "Successfully authenticated",
-        user: { id: user?.id }
-      });
-    } catch (error) {
-      await auth.deleteAccessToken();
+  cmd.command("login").description("Configure access token").action(
+    withErrorHandling(async () => {
+      const token = await promptForAccessToken();
+      await auth.setAccessToken(token);
       client.clearApi();
-      throw error;
-    }
-  }));
-  cmd.command("status").description("Check authentication status").action(withErrorHandling(async () => {
-    const isAuthenticated = await auth.isAuthenticated();
-    if (!isAuthenticated) {
-      outputJson({ authenticated: false, message: "Not authenticated" });
-      return;
-    }
-    try {
-      const user = await client.getUser();
-      outputJson({ authenticated: true, user: { id: user?.id } });
-    } catch (error) {
-      outputJson({ authenticated: false, message: "Token exists but is invalid" });
-    }
-  }));
-  cmd.command("logout").description("Remove stored credentials").action(withErrorHandling(async () => {
-    await auth.logout();
-    client.clearApi();
-    outputJson({ message: "Successfully logged out" });
-  }));
+      try {
+        const user = await client.getUser();
+        outputJson({
+          message: "Successfully authenticated",
+          user: { id: user?.id }
+        });
+      } catch (error) {
+        await auth.deleteAccessToken();
+        client.clearApi();
+        throw error;
+      }
+    })
+  );
+  cmd.command("status").description("Check authentication status").action(
+    withErrorHandling(async () => {
+      const isAuthenticated = await auth.isAuthenticated();
+      if (!isAuthenticated) {
+        outputJson({ authenticated: false, message: "Not authenticated" });
+        return;
+      }
+      try {
+        const user = await client.getUser();
+        outputJson({ authenticated: true, user: { id: user?.id } });
+      } catch {
+        outputJson({ authenticated: false, message: "Token exists but is invalid" });
+      }
+    })
+  );
+  cmd.command("logout").description("Remove stored credentials").action(
+    withErrorHandling(async () => {
+      await auth.logout();
+      client.clearApi();
+      outputJson({ message: "Successfully logged out" });
+    })
+  );
   return cmd;
 }
 
@@ -886,10 +813,12 @@ function createAuthCommand() {
 import { Command as Command2 } from "commander";
 function createUserCommand() {
   const cmd = new Command2("user").description("User information");
-  cmd.command("info").description("Get authenticated user information").action(withErrorHandling(async () => {
-    const user = await client.getUser();
-    outputJson(user);
-  }));
+  cmd.command("info").description("Get authenticated user information").action(
+    withErrorHandling(async () => {
+      const user = await client.getUser();
+      outputJson(user);
+    })
+  );
   return cmd;
 }
 
@@ -897,30 +826,38 @@ function createUserCommand() {
 import { Command as Command3 } from "commander";
 function createBudgetsCommand() {
   const cmd = new Command3("budgets").description("Budget operations");
-  cmd.command("list").description("List all budgets").option("--include-accounts", "Include accounts in response").action(withErrorHandling(async (options) => {
-    const result = await client.getBudgets(options.includeAccounts);
-    outputJson(result?.budgets);
-  }));
-  cmd.command("view").description("View budget details (uses default if no id provided)").argument("[id]", "Budget ID").action(withErrorHandling(async (id) => {
-    const result = await client.getBudget(id);
-    outputJson(result?.budget);
-  }));
-  cmd.command("settings").description("View budget settings").argument("[id]", "Budget ID").action(withErrorHandling(async (id) => {
-    const settings = await client.getBudgetSettings(id);
-    outputJson(settings);
-  }));
-  cmd.command("set-default").description("Set default budget for commands").argument("<id>", "Budget ID").action(withErrorHandling(async (id) => {
-    const result = await client.getBudgets();
-    const budget = result?.budgets.find((b) => b.id === id);
-    if (!budget) {
-      throw new YnabCliError(`Budget with ID ${id} not found`, 404);
-    }
-    config.setDefaultBudget(id);
-    outputJson({
-      message: "Default budget set",
-      budget: { id: budget.id, name: budget.name }
-    });
-  }));
+  cmd.command("list").description("List all budgets").option("--include-accounts", "Include accounts in response").action(
+    withErrorHandling(async (options) => {
+      const result = await client.getBudgets(options.includeAccounts);
+      outputJson(result?.budgets);
+    })
+  );
+  cmd.command("view").description("View budget details (uses default if no id provided)").argument("[id]", "Budget ID").action(
+    withErrorHandling(async (id) => {
+      const result = await client.getBudget(id);
+      outputJson(result?.budget);
+    })
+  );
+  cmd.command("settings").description("View budget settings").argument("[id]", "Budget ID").action(
+    withErrorHandling(async (id) => {
+      const settings = await client.getBudgetSettings(id);
+      outputJson(settings);
+    })
+  );
+  cmd.command("set-default").description("Set default budget for commands").argument("<id>", "Budget ID").action(
+    withErrorHandling(async (id) => {
+      const result = await client.getBudgets();
+      const budget = result?.budgets.find((b) => b.id === id);
+      if (!budget) {
+        throw new YnabCliError(`Budget with ID ${id} not found`, 404);
+      }
+      config.setDefaultBudget(id);
+      outputJson({
+        message: "Default budget set",
+        budget: { id: budget.id, name: budget.name }
+      });
+    })
+  );
   return cmd;
 }
 
@@ -928,22 +865,30 @@ function createBudgetsCommand() {
 import { Command as Command4 } from "commander";
 function createAccountsCommand() {
   const cmd = new Command4("accounts").description("Account operations");
-  cmd.command("list").description("List all accounts").option("-b, --budget <id>", "Budget ID").action(withErrorHandling(async (options) => {
-    const result = await client.getAccounts(options.budget);
-    outputJson(result?.accounts);
-  }));
-  cmd.command("view").description("View account details").argument("<id>", "Account ID").option("-b, --budget <id>", "Budget ID").action(withErrorHandling(async (id, options) => {
-    const account = await client.getAccount(id, options.budget);
-    outputJson(account);
-  }));
-  cmd.command("transactions").description("List transactions for account").argument("<id>", "Account ID").option("-b, --budget <id>", "Budget ID").option("--since <date>", "Filter transactions since date (YYYY-MM-DD)").option("--type <type>", "Filter by transaction type").action(withErrorHandling(async (id, options) => {
-    const result = await client.getTransactionsByAccount(id, {
-      budgetId: options.budget,
-      sinceDate: options.since,
-      type: options.type
-    });
-    outputJson(result?.transactions);
-  }));
+  cmd.command("list").description("List all accounts").option("-b, --budget <id>", "Budget ID").action(
+    withErrorHandling(async (options) => {
+      const result = await client.getAccounts(options.budget);
+      outputJson(result?.accounts);
+    })
+  );
+  cmd.command("view").description("View account details").argument("<id>", "Account ID").option("-b, --budget <id>", "Budget ID").action(
+    withErrorHandling(async (id, options) => {
+      const account = await client.getAccount(id, options.budget);
+      outputJson(account);
+    })
+  );
+  cmd.command("transactions").description("List transactions for account").argument("<id>", "Account ID").option("-b, --budget <id>", "Budget ID").option("--since <date>", "Filter transactions since date (YYYY-MM-DD)").option("--type <type>", "Filter by transaction type").action(
+    withErrorHandling(
+      async (id, options) => {
+        const result = await client.getTransactionsByAccount(id, {
+          budgetId: options.budget,
+          sinceDate: options.since,
+          type: options.type
+        });
+        outputJson(result?.transactions);
+      }
+    )
+  );
   return cmd;
 }
 
@@ -951,36 +896,50 @@ function createAccountsCommand() {
 import { Command as Command5 } from "commander";
 function createCategoriesCommand() {
   const cmd = new Command5("categories").description("Category operations");
-  cmd.command("list").description("List all categories").option("-b, --budget <id>", "Budget ID").option("--last-knowledge <number>", "Last knowledge of server", parseInt).action(withErrorHandling(async (options) => {
-    const result = await client.getCategories(options.budget, options.lastKnowledge);
-    outputJson(result?.category_groups);
-  }));
-  cmd.command("view").description("View category details").argument("<id>", "Category ID").option("-b, --budget <id>", "Budget ID").action(withErrorHandling(async (id, options) => {
-    const category = await client.getCategory(id, options.budget);
-    outputJson(category);
-  }));
-  cmd.command("budget").description("Set category budgeted amount for a month (overrides existing amount)").argument("<id>", "Category ID").requiredOption("--month <month>", "Month in YYYY-MM-DD format (e.g., 2025-07-01)").requiredOption("--amount <amount>", "Total budgeted amount to set (e.g., 100.50)", parseFloat).option("-b, --budget <id>", "Budget ID").action(withErrorHandling(async (id, options) => {
-    if (isNaN(options.amount)) {
-      throw new YnabCliError("Amount must be a valid number", 400);
-    }
-    const milliunits = amountToMilliunits(options.amount);
-    const category = await client.updateMonthCategory(
-      options.month,
-      id,
-      { category: { budgeted: milliunits } },
-      options.budget
-    );
-    outputJson(category);
-  }));
-  cmd.command("transactions").description("List transactions for category").argument("<id>", "Category ID").option("-b, --budget <id>", "Budget ID").option("--since <date>", "Filter transactions since date (YYYY-MM-DD)").option("--type <type>", "Filter by transaction type").option("--last-knowledge <number>", "Last knowledge of server", parseInt).action(withErrorHandling(async (id, options) => {
-    const result = await client.getTransactionsByCategory(id, {
-      budgetId: options.budget,
-      sinceDate: options.since,
-      type: options.type,
-      lastKnowledgeOfServer: options.lastKnowledge
-    });
-    outputJson(result?.transactions);
-  }));
+  cmd.command("list").description("List all categories").option("-b, --budget <id>", "Budget ID").option("--last-knowledge <number>", "Last knowledge of server", parseInt).action(
+    withErrorHandling(
+      async (options) => {
+        const result = await client.getCategories(options.budget, options.lastKnowledge);
+        outputJson(result?.category_groups);
+      }
+    )
+  );
+  cmd.command("view").description("View category details").argument("<id>", "Category ID").option("-b, --budget <id>", "Budget ID").action(
+    withErrorHandling(async (id, options) => {
+      const category = await client.getCategory(id, options.budget);
+      outputJson(category);
+    })
+  );
+  cmd.command("budget").description("Set category budgeted amount for a month (overrides existing amount)").argument("<id>", "Category ID").requiredOption("--month <month>", "Month in YYYY-MM-DD format (e.g., 2025-07-01)").requiredOption("--amount <amount>", "Total budgeted amount to set (e.g., 100.50)", parseFloat).option("-b, --budget <id>", "Budget ID").action(
+    withErrorHandling(
+      async (id, options) => {
+        if (isNaN(options.amount)) {
+          throw new YnabCliError("Amount must be a valid number", 400);
+        }
+        const milliunits = amountToMilliunits(options.amount);
+        const category = await client.updateMonthCategory(
+          options.month,
+          id,
+          { category: { budgeted: milliunits } },
+          options.budget
+        );
+        outputJson(category);
+      }
+    )
+  );
+  cmd.command("transactions").description("List transactions for category").argument("<id>", "Category ID").option("-b, --budget <id>", "Budget ID").option("--since <date>", "Filter transactions since date (YYYY-MM-DD)").option("--type <type>", "Filter by transaction type").option("--last-knowledge <number>", "Last knowledge of server", parseInt).action(
+    withErrorHandling(
+      async (id, options) => {
+        const result = await client.getTransactionsByCategory(id, {
+          budgetId: options.budget,
+          sinceDate: options.since,
+          type: options.type,
+          lastKnowledgeOfServer: options.lastKnowledge
+        });
+        outputJson(result?.transactions);
+      }
+    )
+  );
   return cmd;
 }
 
@@ -1032,161 +991,207 @@ function buildTransactionData(options) {
 }
 function createTransactionsCommand() {
   const cmd = new Command6("transactions").description("Transaction operations");
-  cmd.command("list").description("List transactions").option("-b, --budget <id>", "Budget ID").option("--account <id>", "Filter by account ID").option("--category <id>", "Filter by category ID").option("--payee <id>", "Filter by payee ID").option("--since <date>", "Filter transactions since date (YYYY-MM-DD)").option("--until <date>", "Filter transactions until date (YYYY-MM-DD)").option("--type <type>", "Filter by transaction type").option("--approved <value>", "Filter by approval status: true or false").option("--status <statuses>", "Filter by cleared status: cleared, uncleared, reconciled (comma-separated for multiple)").option("--min-amount <amount>", "Minimum amount in currency units (e.g., 10.50)", parseFloat).option("--max-amount <amount>", "Maximum amount in currency units (e.g., 100.00)", parseFloat).option("--fields <fields>", "Comma-separated list of fields to include (e.g., id,date,amount,memo)").action(withErrorHandling(async (options) => {
-    const params = {
-      budgetId: options.budget,
-      sinceDate: options.since,
-      type: options.type
-    };
-    const result = options.account ? await client.getTransactionsByAccount(options.account, params) : options.category ? await client.getTransactionsByCategory(options.category, params) : options.payee ? await client.getTransactionsByPayee(options.payee, params) : await client.getTransactions(params);
-    const transactions = result?.transactions || [];
-    const filtered = applyTransactionFilters(transactions, {
-      until: options.until,
-      approved: options.approved,
-      status: options.status,
-      minAmount: options.minAmount,
-      maxAmount: options.maxAmount
-    });
-    const selected = applyFieldSelection(filtered, options.fields);
-    outputJson(selected);
-  }));
-  cmd.command("view").description("View single transaction").argument("<id>", "Transaction ID").option("-b, --budget <id>", "Budget ID").action(withErrorHandling(async (id, options) => {
-    const transaction = await client.getTransaction(id, options.budget);
-    outputJson(transaction);
-  }));
-  cmd.command("create").description("Create transaction").option("-b, --budget <id>", "Budget ID").option("--account <id>", "Account ID").option("--date <date>", "Date (YYYY-MM-DD)").option("--amount <amount>", "Amount in currency units (e.g., 10.50)", parseFloat).option("--payee-name <name>", "Payee name").option("--payee-id <id>", "Payee ID").option("--category-id <id>", "Category ID").option("--memo <memo>", "Memo").option("--cleared <status>", "Cleared status (cleared, uncleared, reconciled)").option("--approved", "Mark as approved").action(withErrorHandling(async (options) => {
-    const shouldPrompt = isInteractive() && !options.amount;
-    if (shouldPrompt && !options.account) {
-      throw new YnabCliError("--account is required. Interactive mode cannot auto-select an account.", 400);
-    }
-    const transactionData = shouldPrompt ? { ...await promptForTransaction(), account_id: options.account } : buildTransactionData(options);
-    const transaction = await client.createTransaction(
-      { transaction: transactionData },
-      options.budget
-    );
-    outputJson(transaction);
-  }));
-  cmd.command("update").description("Update transaction").argument("<id>", "Transaction ID").option("-b, --budget <id>", "Budget ID").option("--account <id>", "Account ID").option("--date <date>", "Date (YYYY-MM-DD)").option("--amount <amount>", "Amount in currency units", parseFloat).option("--payee-name <name>", "Payee name").option("--payee-id <id>", "Payee ID").option("--category-id <id>", "Category ID").option("--memo <memo>", "Memo").option("--cleared <status>", "Cleared status").option("--approved", "Mark as approved").action(withErrorHandling(async (id, options) => {
-    const transactionData = buildUpdateObject(options, {
-      account: "account_id",
-      date: "date",
-      payeeName: "payee_name",
-      payeeId: "payee_id",
-      categoryId: "category_id",
-      memo: "memo",
-      cleared: "cleared",
-      approved: "approved"
-    });
-    if (options.amount !== void 0) {
-      transactionData.amount = amountToMilliunits(options.amount);
-    }
-    const transaction = await client.updateTransaction(
-      id,
-      { transaction: transactionData },
-      options.budget
-    );
-    outputJson(transaction);
-  }));
-  cmd.command("delete").description("Delete transaction").argument("<id>", "Transaction ID").option("-b, --budget <id>", "Budget ID").option("-y, --yes", "Skip confirmation").action(withErrorHandling(async (id, options) => {
-    if (!await confirmDelete("transaction", options.yes)) {
-      return;
-    }
-    const transaction = await client.deleteTransaction(id, options.budget);
-    outputJson({ message: "Transaction deleted", transaction });
-  }));
-  cmd.command("import").description("Import transactions").option("-b, --budget <id>", "Budget ID").action(withErrorHandling(async (options) => {
-    const transactionIds = await client.importTransactions(options.budget);
-    outputJson({ transaction_ids: transactionIds });
-  }));
-  cmd.command("split").description("Split transaction into multiple categories. Amounts should be in dollars (e.g., 10.50).").argument("<id>", "Transaction ID").requiredOption("--splits <json>", 'JSON array of splits with dollar amounts: [{"amount": -21.40, "category_id": "xxx", "memo": "..."}]').option("-b, --budget <id>", "Budget ID").option("-f, --force", "Force update of already-split transactions by deleting and recreating").action(withErrorHandling(async (id, options) => {
-    let parsedSplits;
-    try {
-      parsedSplits = JSON.parse(options.splits);
-    } catch (error) {
-      throw new YnabCliError("Invalid JSON in --splits parameter", 400);
-    }
-    const splits = validateJson(parsedSplits, TransactionSplitSchema, "transaction splits");
-    const splitsInMilliunits = splits.map((split) => ({
-      ...split,
-      amount: amountToMilliunits(split.amount)
-    }));
-    const existingTransaction = await client.getTransaction(id, options.budget);
-    const isAlreadySplit = existingTransaction.subtransactions && existingTransaction.subtransactions.length > 0;
-    if (isAlreadySplit && !options.force) {
-      throw new YnabCliError(
-        "Transaction is already split. YNAB API does not support updating split transactions. Use --force to delete and recreate the transaction with new splits.",
-        400
-      );
-    }
-    if (isAlreadySplit) {
-      await client.deleteTransaction(id, options.budget);
-      const recreatedTransaction = await client.createTransaction(
-        {
-          transaction: {
-            account_id: existingTransaction.account_id,
-            date: existingTransaction.date,
-            amount: existingTransaction.amount,
-            payee_id: existingTransaction.payee_id,
-            payee_name: existingTransaction.payee_name,
-            category_id: null,
-            memo: existingTransaction.memo,
-            cleared: existingTransaction.cleared,
-            approved: existingTransaction.approved,
-            flag_color: existingTransaction.flag_color,
-            subtransactions: splitsInMilliunits
-          }
-        },
-        options.budget
-      );
-      outputJson(recreatedTransaction);
-    } else {
-      const transaction = await client.updateTransaction(
-        id,
-        {
-          transaction: {
-            category_id: null,
-            subtransactions: splitsInMilliunits
-          }
-        },
-        options.budget
-      );
+  cmd.command("list").description("List transactions").option("-b, --budget <id>", "Budget ID").option("--account <id>", "Filter by account ID").option("--category <id>", "Filter by category ID").option("--payee <id>", "Filter by payee ID").option("--since <date>", "Filter transactions since date (YYYY-MM-DD)").option("--until <date>", "Filter transactions until date (YYYY-MM-DD)").option("--type <type>", "Filter by transaction type").option("--approved <value>", "Filter by approval status: true or false").option(
+    "--status <statuses>",
+    "Filter by cleared status: cleared, uncleared, reconciled (comma-separated for multiple)"
+  ).option("--min-amount <amount>", "Minimum amount in currency units (e.g., 10.50)", parseFloat).option("--max-amount <amount>", "Maximum amount in currency units (e.g., 100.00)", parseFloat).option(
+    "--fields <fields>",
+    "Comma-separated list of fields to include (e.g., id,date,amount,memo)"
+  ).action(
+    withErrorHandling(
+      async (options) => {
+        const params = {
+          budgetId: options.budget,
+          sinceDate: options.since,
+          type: options.type
+        };
+        const result = options.account ? await client.getTransactionsByAccount(options.account, params) : options.category ? await client.getTransactionsByCategory(options.category, params) : options.payee ? await client.getTransactionsByPayee(options.payee, params) : await client.getTransactions(params);
+        const transactions = result?.transactions || [];
+        const filtered = applyTransactionFilters(transactions, {
+          until: options.until,
+          approved: options.approved,
+          status: options.status,
+          minAmount: options.minAmount,
+          maxAmount: options.maxAmount
+        });
+        const selected = applyFieldSelection(filtered, options.fields);
+        outputJson(selected);
+      }
+    )
+  );
+  cmd.command("view").description("View single transaction").argument("<id>", "Transaction ID").option("-b, --budget <id>", "Budget ID").action(
+    withErrorHandling(async (id, options) => {
+      const transaction = await client.getTransaction(id, options.budget);
       outputJson(transaction);
-    }
-  }));
-  cmd.command("search").description("Search transactions").option("-b, --budget <id>", "Budget ID").option("--memo <text>", "Search in memo field").option("--payee-name <name>", "Search in payee name").option("--amount <amount>", "Search for exact amount in currency units", parseFloat).option("--since <date>", "Search transactions since date (YYYY-MM-DD)").option("--until <date>", "Search transactions until date (YYYY-MM-DD)").option("--approved <value>", "Filter by approval status: true or false").option("--status <statuses>", "Filter by cleared status: cleared, uncleared, reconciled (comma-separated)").option("--fields <fields>", "Comma-separated list of fields to include").action(withErrorHandling(async (options) => {
-    if (!options.memo && !options.payeeName && options.amount === void 0) {
-      throw new YnabCliError("At least one search criteria required: --memo, --payee-name, or --amount", 400);
-    }
-    const params = {
-      budgetId: options.budget,
-      sinceDate: options.since
-    };
-    const result = await client.getTransactions(params);
-    let transactions = result?.transactions || [];
-    if (options.memo) {
-      const searchTerm = options.memo.toLowerCase();
-      transactions = transactions.filter(
-        (t) => t.memo?.toLowerCase().includes(searchTerm)
-      );
-    }
-    if (options.payeeName) {
-      const searchTerm = options.payeeName.toLowerCase();
-      transactions = transactions.filter(
-        (t) => t.payee_name?.toLowerCase().includes(searchTerm)
-      );
-    }
-    if (options.amount !== void 0) {
-      const amountMilliunits = amountToMilliunits(options.amount);
-      transactions = transactions.filter((t) => t.amount === amountMilliunits);
-    }
-    transactions = applyTransactionFilters(transactions, {
-      until: options.until,
-      approved: options.approved,
-      status: options.status
-    });
-    const filteredTransactions = applyFieldSelection(transactions, options.fields);
-    outputJson(filteredTransactions);
-  }));
+    })
+  );
+  cmd.command("create").description("Create transaction").option("-b, --budget <id>", "Budget ID").option("--account <id>", "Account ID").option("--date <date>", "Date (YYYY-MM-DD)").option("--amount <amount>", "Amount in currency units (e.g., 10.50)", parseFloat).option("--payee-name <name>", "Payee name").option("--payee-id <id>", "Payee ID").option("--category-id <id>", "Category ID").option("--memo <memo>", "Memo").option("--cleared <status>", "Cleared status (cleared, uncleared, reconciled)").option("--approved", "Mark as approved").action(
+    withErrorHandling(
+      async (options) => {
+        const shouldPrompt = isInteractive() && !options.amount;
+        if (shouldPrompt && !options.account) {
+          throw new YnabCliError(
+            "--account is required. Interactive mode cannot auto-select an account.",
+            400
+          );
+        }
+        const transactionData = shouldPrompt ? { ...await promptForTransaction(), account_id: options.account } : buildTransactionData(options);
+        const transaction = await client.createTransaction(
+          { transaction: transactionData },
+          options.budget
+        );
+        outputJson(transaction);
+      }
+    )
+  );
+  cmd.command("update").description("Update transaction").argument("<id>", "Transaction ID").option("-b, --budget <id>", "Budget ID").option("--account <id>", "Account ID").option("--date <date>", "Date (YYYY-MM-DD)").option("--amount <amount>", "Amount in currency units", parseFloat).option("--payee-name <name>", "Payee name").option("--payee-id <id>", "Payee ID").option("--category-id <id>", "Category ID").option("--memo <memo>", "Memo").option("--cleared <status>", "Cleared status").option("--approved", "Mark as approved").action(
+    withErrorHandling(
+      async (id, options) => {
+        const transactionData = buildUpdateObject(options, {
+          account: "account_id",
+          date: "date",
+          payeeName: "payee_name",
+          payeeId: "payee_id",
+          categoryId: "category_id",
+          memo: "memo",
+          cleared: "cleared",
+          approved: "approved"
+        });
+        if (options.amount !== void 0) {
+          transactionData.amount = amountToMilliunits(options.amount);
+        }
+        const transaction = await client.updateTransaction(
+          id,
+          { transaction: transactionData },
+          options.budget
+        );
+        outputJson(transaction);
+      }
+    )
+  );
+  cmd.command("delete").description("Delete transaction").argument("<id>", "Transaction ID").option("-b, --budget <id>", "Budget ID").option("-y, --yes", "Skip confirmation").action(
+    withErrorHandling(
+      async (id, options) => {
+        if (!await confirmDelete("transaction", options.yes)) {
+          return;
+        }
+        const transaction = await client.deleteTransaction(id, options.budget);
+        outputJson({ message: "Transaction deleted", transaction });
+      }
+    )
+  );
+  cmd.command("import").description("Import transactions").option("-b, --budget <id>", "Budget ID").action(
+    withErrorHandling(async (options) => {
+      const transactionIds = await client.importTransactions(options.budget);
+      outputJson({ transaction_ids: transactionIds });
+    })
+  );
+  cmd.command("split").description(
+    "Split transaction into multiple categories. Amounts should be in dollars (e.g., 10.50)."
+  ).argument("<id>", "Transaction ID").requiredOption(
+    "--splits <json>",
+    'JSON array of splits with dollar amounts: [{"amount": -21.40, "category_id": "xxx", "memo": "..."}]'
+  ).option("-b, --budget <id>", "Budget ID").option("-f, --force", "Force update of already-split transactions by deleting and recreating").action(
+    withErrorHandling(
+      async (id, options) => {
+        let parsedSplits;
+        try {
+          parsedSplits = JSON.parse(options.splits);
+        } catch {
+          throw new YnabCliError("Invalid JSON in --splits parameter", 400);
+        }
+        const splits = validateJson(parsedSplits, TransactionSplitSchema, "transaction splits");
+        const splitsInMilliunits = splits.map((split) => ({
+          ...split,
+          amount: amountToMilliunits(split.amount)
+        }));
+        const existingTransaction = await client.getTransaction(id, options.budget);
+        const isAlreadySplit = existingTransaction.subtransactions && existingTransaction.subtransactions.length > 0;
+        if (isAlreadySplit && !options.force) {
+          throw new YnabCliError(
+            "Transaction is already split. YNAB API does not support updating split transactions. Use --force to delete and recreate the transaction with new splits.",
+            400
+          );
+        }
+        if (isAlreadySplit) {
+          await client.deleteTransaction(id, options.budget);
+          const recreatedTransaction = await client.createTransaction(
+            {
+              transaction: {
+                account_id: existingTransaction.account_id,
+                date: existingTransaction.date,
+                amount: existingTransaction.amount,
+                payee_id: existingTransaction.payee_id,
+                payee_name: existingTransaction.payee_name,
+                category_id: null,
+                memo: existingTransaction.memo,
+                cleared: existingTransaction.cleared,
+                approved: existingTransaction.approved,
+                flag_color: existingTransaction.flag_color,
+                subtransactions: splitsInMilliunits
+              }
+            },
+            options.budget
+          );
+          outputJson(recreatedTransaction);
+        } else {
+          const transaction = await client.updateTransaction(
+            id,
+            {
+              transaction: {
+                category_id: null,
+                subtransactions: splitsInMilliunits
+              }
+            },
+            options.budget
+          );
+          outputJson(transaction);
+        }
+      }
+    )
+  );
+  cmd.command("search").description("Search transactions").option("-b, --budget <id>", "Budget ID").option("--memo <text>", "Search in memo field").option("--payee-name <name>", "Search in payee name").option("--amount <amount>", "Search for exact amount in currency units", parseFloat).option("--since <date>", "Search transactions since date (YYYY-MM-DD)").option("--until <date>", "Search transactions until date (YYYY-MM-DD)").option("--approved <value>", "Filter by approval status: true or false").option(
+    "--status <statuses>",
+    "Filter by cleared status: cleared, uncleared, reconciled (comma-separated)"
+  ).option("--fields <fields>", "Comma-separated list of fields to include").action(
+    withErrorHandling(
+      async (options) => {
+        if (!options.memo && !options.payeeName && options.amount === void 0) {
+          throw new YnabCliError(
+            "At least one search criteria required: --memo, --payee-name, or --amount",
+            400
+          );
+        }
+        const params = {
+          budgetId: options.budget,
+          sinceDate: options.since
+        };
+        const result = await client.getTransactions(params);
+        let transactions = result?.transactions || [];
+        if (options.memo) {
+          const searchTerm = options.memo.toLowerCase();
+          transactions = transactions.filter((t) => t.memo?.toLowerCase().includes(searchTerm));
+        }
+        if (options.payeeName) {
+          const searchTerm = options.payeeName.toLowerCase();
+          transactions = transactions.filter(
+            (t) => t.payee_name?.toLowerCase().includes(searchTerm)
+          );
+        }
+        if (options.amount !== void 0) {
+          const amountMilliunits = amountToMilliunits(options.amount);
+          transactions = transactions.filter((t) => t.amount === amountMilliunits);
+        }
+        transactions = applyTransactionFilters(transactions, {
+          until: options.until,
+          approved: options.approved,
+          status: options.status
+        });
+        const filteredTransactions = applyFieldSelection(transactions, options.fields);
+        outputJson(filteredTransactions);
+      }
+    )
+  );
   return cmd;
 }
 
@@ -1194,24 +1199,37 @@ function createTransactionsCommand() {
 import { Command as Command7 } from "commander";
 function createScheduledCommand() {
   const cmd = new Command7("scheduled").description("Scheduled transaction operations");
-  cmd.command("list").description("List all scheduled transactions").option("-b, --budget <id>", "Budget ID").option("--last-knowledge <number>", "Last knowledge of server", parseInt).action(withErrorHandling(async (options) => {
-    const result = await client.getScheduledTransactions(options.budget, options.lastKnowledge);
-    outputJson(result?.scheduled_transactions);
-  }));
-  cmd.command("view").description("View scheduled transaction").argument("<id>", "Scheduled transaction ID").option("-b, --budget <id>", "Budget ID").action(withErrorHandling(async (id, options) => {
-    const scheduledTransaction = await client.getScheduledTransaction(id, options.budget);
-    outputJson(scheduledTransaction);
-  }));
-  cmd.command("delete").description("Delete scheduled transaction").argument("<id>", "Scheduled transaction ID").option("-b, --budget <id>", "Budget ID").option("-y, --yes", "Skip confirmation").action(withErrorHandling(async (id, options) => {
-    if (!await confirmDelete("scheduled transaction", options.yes)) {
-      return;
-    }
-    const scheduledTransaction = await client.deleteScheduledTransaction(id, options.budget);
-    outputJson({
-      message: "Scheduled transaction deleted",
-      scheduled_transaction: scheduledTransaction
-    });
-  }));
+  cmd.command("list").description("List all scheduled transactions").option("-b, --budget <id>", "Budget ID").option("--last-knowledge <number>", "Last knowledge of server", parseInt).action(
+    withErrorHandling(
+      async (options) => {
+        const result = await client.getScheduledTransactions(
+          options.budget,
+          options.lastKnowledge
+        );
+        outputJson(result?.scheduled_transactions);
+      }
+    )
+  );
+  cmd.command("view").description("View scheduled transaction").argument("<id>", "Scheduled transaction ID").option("-b, --budget <id>", "Budget ID").action(
+    withErrorHandling(async (id, options) => {
+      const scheduledTransaction = await client.getScheduledTransaction(id, options.budget);
+      outputJson(scheduledTransaction);
+    })
+  );
+  cmd.command("delete").description("Delete scheduled transaction").argument("<id>", "Scheduled transaction ID").option("-b, --budget <id>", "Budget ID").option("-y, --yes", "Skip confirmation").action(
+    withErrorHandling(
+      async (id, options) => {
+        if (!await confirmDelete("scheduled transaction", options.yes)) {
+          return;
+        }
+        const scheduledTransaction = await client.deleteScheduledTransaction(id, options.budget);
+        outputJson({
+          message: "Scheduled transaction deleted",
+          scheduled_transaction: scheduledTransaction
+        });
+      }
+    )
+  );
   return cmd;
 }
 
@@ -1219,38 +1237,54 @@ function createScheduledCommand() {
 import { Command as Command8 } from "commander";
 function createPayeesCommand() {
   const cmd = new Command8("payees").description("Payee operations");
-  cmd.command("list").description("List all payees").option("-b, --budget <id>", "Budget ID").option("--last-knowledge <number>", "Last knowledge of server", parseInt).action(withErrorHandling(async (options) => {
-    const result = await client.getPayees(options.budget, options.lastKnowledge);
-    outputJson(result?.payees);
-  }));
-  cmd.command("view").description("View payee details").argument("<id>", "Payee ID").option("-b, --budget <id>", "Budget ID").action(withErrorHandling(async (id, options) => {
-    const payee = await client.getPayee(id, options.budget);
-    outputJson(payee);
-  }));
-  cmd.command("update").description("Rename payee").argument("<id>", "Payee ID").requiredOption("--name <name>", "New payee name").option("-b, --budget <id>", "Budget ID").action(withErrorHandling(async (id, options) => {
-    if (!options.name?.trim()) {
-      throw new YnabCliError("Name cannot be empty", 400);
-    }
-    const payee = await client.updatePayee(
-      id,
-      { payee: { name: options.name } },
-      options.budget
-    );
-    outputJson(payee);
-  }));
-  cmd.command("locations").description("List locations for payee").argument("<id>", "Payee ID").option("-b, --budget <id>", "Budget ID").action(withErrorHandling(async (id, options) => {
-    const locations = await client.getPayeeLocationsByPayee(id, options.budget);
-    outputJson(locations);
-  }));
-  cmd.command("transactions").description("List transactions for payee").argument("<id>", "Payee ID").option("-b, --budget <id>", "Budget ID").option("--since <date>", "Filter transactions since date (YYYY-MM-DD)").option("--type <type>", "Filter by transaction type").option("--last-knowledge <number>", "Last knowledge of server", parseInt).action(withErrorHandling(async (id, options) => {
-    const result = await client.getTransactionsByPayee(id, {
-      budgetId: options.budget,
-      sinceDate: options.since,
-      type: options.type,
-      lastKnowledgeOfServer: options.lastKnowledge
-    });
-    outputJson(result?.transactions);
-  }));
+  cmd.command("list").description("List all payees").option("-b, --budget <id>", "Budget ID").option("--last-knowledge <number>", "Last knowledge of server", parseInt).action(
+    withErrorHandling(
+      async (options) => {
+        const result = await client.getPayees(options.budget, options.lastKnowledge);
+        outputJson(result?.payees);
+      }
+    )
+  );
+  cmd.command("view").description("View payee details").argument("<id>", "Payee ID").option("-b, --budget <id>", "Budget ID").action(
+    withErrorHandling(async (id, options) => {
+      const payee = await client.getPayee(id, options.budget);
+      outputJson(payee);
+    })
+  );
+  cmd.command("update").description("Rename payee").argument("<id>", "Payee ID").requiredOption("--name <name>", "New payee name").option("-b, --budget <id>", "Budget ID").action(
+    withErrorHandling(
+      async (id, options) => {
+        if (!options.name?.trim()) {
+          throw new YnabCliError("Name cannot be empty", 400);
+        }
+        const payee = await client.updatePayee(
+          id,
+          { payee: { name: options.name } },
+          options.budget
+        );
+        outputJson(payee);
+      }
+    )
+  );
+  cmd.command("locations").description("List locations for payee").argument("<id>", "Payee ID").option("-b, --budget <id>", "Budget ID").action(
+    withErrorHandling(async (id, options) => {
+      const locations = await client.getPayeeLocationsByPayee(id, options.budget);
+      outputJson(locations);
+    })
+  );
+  cmd.command("transactions").description("List transactions for payee").argument("<id>", "Payee ID").option("-b, --budget <id>", "Budget ID").option("--since <date>", "Filter transactions since date (YYYY-MM-DD)").option("--type <type>", "Filter by transaction type").option("--last-knowledge <number>", "Last knowledge of server", parseInt).action(
+    withErrorHandling(
+      async (id, options) => {
+        const result = await client.getTransactionsByPayee(id, {
+          budgetId: options.budget,
+          sinceDate: options.since,
+          type: options.type,
+          lastKnowledgeOfServer: options.lastKnowledge
+        });
+        outputJson(result?.transactions);
+      }
+    )
+  );
   return cmd;
 }
 
@@ -1258,14 +1292,20 @@ function createPayeesCommand() {
 import { Command as Command9 } from "commander";
 function createMonthsCommand() {
   const cmd = new Command9("months").description("Monthly budget operations");
-  cmd.command("list").description("List all budget months").option("-b, --budget <id>", "Budget ID").option("--last-knowledge <number>", "Last knowledge of server", parseInt).action(withErrorHandling(async (options) => {
-    const result = await client.getBudgetMonths(options.budget, options.lastKnowledge);
-    outputJson(result?.months);
-  }));
-  cmd.command("view").description("View specific month details").argument("<month>", "Month in YYYY-MM-DD format (e.g., 2025-07-01)").option("-b, --budget <id>", "Budget ID").action(withErrorHandling(async (month, options) => {
-    const monthData = await client.getBudgetMonth(month, options.budget);
-    outputJson(monthData);
-  }));
+  cmd.command("list").description("List all budget months").option("-b, --budget <id>", "Budget ID").option("--last-knowledge <number>", "Last knowledge of server", parseInt).action(
+    withErrorHandling(
+      async (options) => {
+        const result = await client.getBudgetMonths(options.budget, options.lastKnowledge);
+        outputJson(result?.months);
+      }
+    )
+  );
+  cmd.command("view").description("View specific month details").argument("<month>", "Month in YYYY-MM-DD format (e.g., 2025-07-01)").option("-b, --budget <id>", "Budget ID").action(
+    withErrorHandling(async (month, options) => {
+      const monthData = await client.getBudgetMonth(month, options.budget);
+      outputJson(monthData);
+    })
+  );
   return cmd;
 }
 
@@ -1274,32 +1314,36 @@ import { Command as Command10 } from "commander";
 var VALID_HTTP_METHODS = ["GET", "POST", "PUT", "PATCH", "DELETE"];
 function createApiCommand() {
   const cmd = new Command10("api").description("Raw API access");
-  cmd.argument("<method>", "HTTP method (GET, POST, PUT, PATCH, DELETE)").argument("<path>", "API path (e.g., /budgets or /budgets/{budget_id}/transactions)").option("-b, --budget <id>", "Budget ID (used to replace {budget_id} in path)").option("--data <json>", "JSON data for POST/PUT/PATCH requests").description("Make raw API calls to YNAB").action(withErrorHandling(async (method, path, options) => {
-    const upperMethod = method.toUpperCase();
-    if (!VALID_HTTP_METHODS.includes(upperMethod)) {
-      throw new YnabCliError(
-        `Invalid HTTP method: ${method}. Must be one of: ${VALID_HTTP_METHODS.join(", ")}`,
-        400
-      );
-    }
-    let data;
-    if (options.data) {
-      try {
-        const parsedData = JSON.parse(options.data);
-        data = validateJson(parsedData, ApiDataSchema, "API data");
-      } catch (error) {
-        throw new YnabCliError("Invalid JSON in --data parameter", 400);
+  cmd.argument("<method>", "HTTP method (GET, POST, PUT, PATCH, DELETE)").argument("<path>", "API path (e.g., /budgets or /budgets/{budget_id}/transactions)").option("-b, --budget <id>", "Budget ID (used to replace {budget_id} in path)").option("--data <json>", "JSON data for POST/PUT/PATCH requests").description("Make raw API calls to YNAB").action(
+    withErrorHandling(
+      async (method, path, options) => {
+        const upperMethod = method.toUpperCase();
+        if (!VALID_HTTP_METHODS.includes(upperMethod)) {
+          throw new YnabCliError(
+            `Invalid HTTP method: ${method}. Must be one of: ${VALID_HTTP_METHODS.join(", ")}`,
+            400
+          );
+        }
+        let data;
+        if (options.data) {
+          try {
+            const parsedData = JSON.parse(options.data);
+            data = validateJson(parsedData, ApiDataSchema, "API data");
+          } catch {
+            throw new YnabCliError("Invalid JSON in --data parameter", 400);
+          }
+        }
+        const result = await client.rawApiCall(upperMethod, path, data, options.budget);
+        outputJson(result);
       }
-    }
-    const result = await client.rawApiCall(upperMethod, path, data, options.budget);
-    outputJson(result);
-  }));
+    )
+  );
   return cmd;
 }
 
 // src/cli.ts
 var program = new Command11();
-program.name("ynab").description("A command-line interface for You Need a Budget (YNAB)").version("1.2.4").option("-c, --compact", "Minified JSON output (single line)").hook("preAction", (thisCommand) => {
+program.name("ynab").description("A command-line interface for You Need a Budget (YNAB)").version("1.2.6").option("-c, --compact", "Minified JSON output (single line)").hook("preAction", (thisCommand) => {
   const options = thisCommand.opts();
   setOutputOptions({
     compact: options.compact