Resolve YNAB SDK, Zod, and TypeScript upgrades

README.md

@@ -115,8 +115,8 @@ ynab scheduled delete <id>
 ### Raw API Access
 
 ```bash
-ynab api GET /budgets
-ynab api POST /budgets/{budget_id}/transactions --data '{"transaction": {...}}'
+ynab api GET /plans
+ynab api POST /plans/{plan_id}/transactions --data '{"transaction": {...}}'
 ```
 
 ### MCP Server

package.json

@@ -50,16 +50,16 @@
     "commander": "^14.0.2",
     "conf": "^15.0.2",
     "dayjs": "^1.11.19",
-    "ynab": "^2.10.0",
-    "zod": "^3.25.0"
+    "ynab": "^4.0.0",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.11",
     "@types/bun": "latest",
     "oxlint": "^1.38.0",
     "tsup": "^8.0.0",
     "tsx": "^4.7.0",
-    "typescript": "^5.3.0",
+    "typescript": "^6.0.2",
     "vitest": "^4.0.4"
   },
   "engines": {

src/commands/api.ts

@@ -13,8 +13,8 @@ export function createApiCommand(): Command {
 
   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)')
+    .argument('<path>', 'API path (e.g., /plans or /plans/{plan_id}/transactions)')
+    .option('-b, --budget <id>', 'Budget ID (used to replace {plan_id} or {budget_id} in path)')
     .option('--data <json>', 'JSON data for POST/PUT/PATCH requests')
     .description('Make raw API calls to YNAB')
     .action(

src/commands/categories.ts

@@ -88,7 +88,15 @@ export function createCategoriesCommand(): Command {
             updateData.goal_target = amountToMilliunits(options.goalTarget);
           }
 
-          const category = await client.updateCategory(id, { category: updateData }, options.budget);
+          const category = await client.updateCategory(
+            id,
+            {
+              category: updateData as NonNullable<
+                Parameters<typeof client.updateCategory>[1]['category']
+              >,
+            },
+            options.budget
+          );
           outputJson(category);
         }
       )

src/commands/transactions.ts

@@ -311,34 +311,38 @@ export function createTransactionsCommand(): Command {
           if (isAlreadySplit) {
             await client.deleteTransaction(id, options.budget);
 
+            const 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,
+            } as unknown as NonNullable<
+              Parameters<typeof client.createTransaction>[0]['transaction']
+            >;
+
             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,
-                },
-              },
+              { transaction },
               options.budget
             );
             outputJson(recreatedTransaction);
           } else {
+            const transactionData = {
+              category_id: null,
+              subtransactions: splitsInMilliunits,
+            } as unknown as NonNullable<
+              Parameters<typeof client.updateTransaction>[1]['transaction']
+            >;
+
             const transaction = await client.updateTransaction(
               id,
-              {
-                transaction: {
-                  category_id: null,
-                  subtransactions: splitsInMilliunits,
-                },
-              },
+              { transaction: transactionData },
               options.budget
             );
             outputJson(transaction);

src/lib/api-client.ts

@@ -63,27 +63,27 @@ export class YnabClient {
 
   async getBudgets(includeAccounts = false) {
     const api = await this.getApi();
-    const response = await api.budgets.getBudgets(includeAccounts);
+    const response = await api.plans.getPlans(includeAccounts);
     return {
-      budgets: response.data.budgets,
+      budgets: response.data.plans,
       server_knowledge: 0,
     };
   }
 
   async getBudget(budgetId?: string, lastKnowledgeOfServer?: number) {
     const api = await this.getApi();
     const id = await this.getBudgetId(budgetId);
-    const response = await api.budgets.getBudgetById(id, lastKnowledgeOfServer);
+    const response = await api.plans.getPlanById(id, lastKnowledgeOfServer);
     return {
-      budget: response.data.budget,
+      budget: response.data.plan,
       server_knowledge: response.data.server_knowledge,
     };
   }
 
   async getBudgetSettings(budgetId?: string) {
     const api = await this.getApi();
     const id = await this.getBudgetId(budgetId);
-    const response = await api.budgets.getBudgetSettingsById(id);
+    const response = await api.plans.getPlanSettingsById(id);
     return response.data.settings;
   }
 
@@ -174,7 +174,7 @@ export class YnabClient {
   async getBudgetMonths(budgetId?: string, lastKnowledgeOfServer?: number) {
     const api = await this.getApi();
     const id = await this.getBudgetId(budgetId);
-    const response = await api.months.getBudgetMonths(id, lastKnowledgeOfServer);
+    const response = await api.months.getPlanMonths(id, lastKnowledgeOfServer);
     return {
       months: response.data.months,
       server_knowledge: response.data.server_knowledge,
@@ -184,7 +184,7 @@ export class YnabClient {
   async getBudgetMonth(month: string, budgetId?: string) {
     const api = await this.getApi();
     const id = await this.getBudgetId(budgetId);
-    const response = await api.months.getBudgetMonth(id, month);
+    const response = await api.months.getPlanMonth(id, month);
     return response.data.month;
   }
 
@@ -369,9 +369,11 @@ export class YnabClient {
   async rawApiCall(method: string, path: string, data?: unknown, budgetId?: string) {
     await this.getApi();
 
-    const fullPath = path.includes('{budget_id}')
-      ? path.replace('{budget_id}', await this.getBudgetId(budgetId))
-      : path;
+    let fullPath = path;
+    if (path.includes('{budget_id}') || path.includes('{plan_id}')) {
+      const id = await this.getBudgetId(budgetId);
+      fullPath = path.replaceAll('{budget_id}', id).replaceAll('{plan_id}', id);
+    }
 
     const url = `https://api.ynab.com/v1${fullPath}`;
     const accessToken = (await auth.getAccessToken()) || process.env.YNAB_API_KEY;

src/lib/errors.ts

@@ -83,6 +83,7 @@ function formatErrorResponse(name: string, detail: string, statusCode: number):
 
   outputJson({ error: { name, detail: enhancedDetail, statusCode } });
   process.exit(1);
+  throw new Error('process.exit returned unexpectedly');
 }
 
 export function handleYnabError(error: unknown): never {