@zapier/zapier-sdk-cli 0.13.16 → 0.14.1

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { Command } from 'commander';
+import { Command, CommanderError } from 'commander';
 import { z } from 'zod';
-import { createFunction, OutputPropertySchema, DEFAULT_CONFIG_PATH, createZapierSdkWithoutRegistry, registryPlugin, ZapierValidationError, ZapierUnknownError, batch, toSnakeCase, ZapierError, formatErrorMessage, getOsInfo, getPlatformVersions, getCiPlatform, isCi, isPositional, getReleaseId, getCurrentTimestamp, generateEventId } from '@zapier/zapier-sdk';
+import { createFunction, OutputPropertySchema, DEFAULT_CONFIG_PATH, createZapierSdkWithoutRegistry, registryPlugin, ZapierError, ZapierValidationError, ZapierUnknownError, batch, toSnakeCase, formatErrorMessage, getOsInfo, getPlatformVersions, getCiPlatform, isCi, isPositional, getReleaseId, getCurrentTimestamp, generateEventId } from '@zapier/zapier-sdk';
 import inquirer from 'inquirer';
 import chalk3 from 'chalk';
 import util from 'util';
@@ -14,11 +14,35 @@ import ora from 'ora';
 import { startMcpServerAsProcess } from '@zapier/zapier-sdk-mcp';
 import { buildSync } from 'esbuild';
 import * as fs from 'fs';
+import { existsSync } from 'fs';
 import * as path from 'path';
 import { resolve, join } from 'path';
 import { mkdir, writeFile, access } from 'fs/promises';
 import * as ts from 'typescript';
+import packageJsonLib from 'package-json';
+import Conf from 'conf';
+import isInstalledGlobally from 'is-installed-globally';
 
+var ZapierCliError = class extends ZapierError {
+};
+var ZapierCliUserCancellationError = class extends ZapierCliError {
+  constructor(message = "Operation cancelled by user") {
+    super(message);
+    this.name = "ZapierCliUserCancellationError";
+    this.code = "ZAPIER_CLI_USER_CANCELLATION";
+    this.exitCode = 0;
+  }
+};
+var ZapierCliExitError = class extends ZapierCliError {
+  constructor(message, exitCode = 1) {
+    super(message);
+    this.name = "ZapierCliExitError";
+    this.code = "ZAPIER_CLI_EXIT";
+    this.exitCode = exitCode;
+  }
+};
+
+// src/utils/parameter-resolver.ts
 function getLocalResolutionOrder(paramName, resolvers, resolved = /* @__PURE__ */ new Set()) {
   const resolver = resolvers[paramName];
   if (!resolver || resolver.type === "static") {
@@ -125,7 +149,7 @@ var SchemaParameterResolver = class {
         } catch (error) {
           if (this.isUserCancellation(error)) {
             console.log(chalk3.yellow("\n\nOperation cancelled by user"));
-            process.exit(0);
+            throw new ZapierCliUserCancellationError();
           }
           throw error;
         }
@@ -163,7 +187,7 @@ var SchemaParameterResolver = class {
         } catch (error) {
           if (this.isUserCancellation(error)) {
             console.log(chalk3.yellow("\n\nOperation cancelled by user"));
-            process.exit(0);
+            throw new ZapierCliUserCancellationError();
           }
           throw error;
         }
@@ -198,7 +222,7 @@ var SchemaParameterResolver = class {
           } catch (error) {
             if (this.isUserCancellation(error)) {
               console.log(chalk3.yellow("\n\nOperation cancelled by user"));
-              process.exit(0);
+              throw new ZapierCliUserCancellationError();
             }
             throw error;
           }
@@ -452,7 +476,7 @@ Optional fields${pathContext}:`));
         } catch (error) {
           if (this.isUserCancellation(error)) {
             console.log(chalk3.yellow("\n\nOperation cancelled by user"));
-            process.exit(0);
+            throw new ZapierCliUserCancellationError();
           }
           throw error;
         }
@@ -517,7 +541,7 @@ Optional fields${pathContext}:`));
     } catch (error) {
       if (this.isUserCancellation(error)) {
         console.log(chalk3.yellow("\n\nOperation cancelled by user"));
-        process.exit(0);
+        throw new ZapierCliUserCancellationError();
       }
       throw error;
     }
@@ -740,8 +764,8 @@ function generateCliCommands(program2, sdk2) {
       return;
     }
     const cliCommandName = methodNameToCliCommand(fnInfo.name);
-    const config = createCommandConfig(cliCommandName, fnInfo, sdk2);
-    addCommand(program2, cliCommandName, config);
+    const config2 = createCommandConfig(cliCommandName, fnInfo, sdk2);
+    addCommand(program2, cliCommandName, config2);
   });
   program2.configureHelp({
     formatHelp: (cmd, helper) => {
@@ -883,17 +907,28 @@ function createCommandConfig(cliCommandName, functionInfo, sdk2) {
           console.error(
             "\n" + chalk3.dim(`Use --help to see available options`)
           );
+          throw new ZapierCliExitError("Validation failed", 1);
         } catch {
-          console.error(chalk3.red("Error:"), error.message);
+          console.error(
+            chalk3.red("Error:"),
+            error instanceof Error ? error.message : String(error)
+          );
+          throw new ZapierCliExitError(
+            error instanceof Error ? error.message : String(error),
+            1
+          );
         }
+      } else if (error instanceof ZapierCliError) {
+        throw error;
       } else if (error instanceof ZapierError) {
         const formattedMessage = formatErrorMessage(error);
         console.error(chalk3.red("\u274C Error:"), formattedMessage);
+        throw new ZapierCliExitError(formattedMessage, 1);
       } else {
         const errorMessage = error instanceof Error ? error.message : "Unknown error";
         console.error(chalk3.red("\u274C Error:"), errorMessage);
+        throw new ZapierCliExitError(errorMessage, 1);
       }
-      process.exit(1);
     }
   };
   return {
@@ -902,10 +937,10 @@ function createCommandConfig(cliCommandName, functionInfo, sdk2) {
     handler
   };
 }
-function addCommand(program2, commandName, config) {
-  const command = program2.command(commandName).description(config.description);
+function addCommand(program2, commandName, config2) {
+  const command = program2.command(commandName).description(config2.description);
   let hasPositionalArray = false;
-  config.parameters.forEach((param) => {
+  config2.parameters.forEach((param) => {
     const kebabName = param.name.replace(/([A-Z])/g, "-$1").toLowerCase();
     if (param.hasResolver && param.required) {
       command.argument(
@@ -957,7 +992,7 @@ function addCommand(program2, commandName, config) {
     }
   });
   command.option("--json", "Output raw JSON instead of formatted results");
-  command.action(config.handler);
+  command.action(config2.handler);
 }
 function convertCliArgsToSdkParams(parameters, positionalArgs, options) {
   const sdkParams = {};
@@ -1167,7 +1202,11 @@ var spinPromise = async (promise, text) => {
     spinner.succeed();
     return result;
   } catch (error) {
-    spinner.fail();
+    if (error instanceof ZapierCliUserCancellationError) {
+      spinner.stop();
+    } else {
+      spinner.fail();
+    }
     throw error;
   }
 };
@@ -1183,6 +1222,11 @@ var log = {
   },
   warn: (message, ...args) => {
     console.log(chalk3.yellow("\u26A0"), message, ...args);
+  },
+  debug: (message, ...args) => {
+    if (process.env.DEBUG === "true" || process.argv.includes("--debug")) {
+      console.log(chalk3.gray("\u{1F41B}"), message, ...args);
+    }
   }
 };
 var log_default = log;
@@ -1285,7 +1329,11 @@ var login = async ({
   const availablePort = await findAvailablePort();
   const redirectUri = `http://localhost:${availablePort}/oauth`;
   log_default.info(`Using port ${availablePort} for OAuth callback`);
-  const { promise: promisedCode, resolve: setCode } = getCallablePromise_default();
+  const {
+    promise: promisedCode,
+    resolve: setCode,
+    reject: rejectCode
+  } = getCallablePromise_default();
   const app = express();
   app.get("/oauth", (req, res) => {
     setCode(String(req.query.code));
@@ -1301,7 +1349,7 @@ var login = async ({
   const cleanup = () => {
     server.close();
     log_default.info("\n\u274C Login cancelled by user");
-    process.exit(0);
+    rejectCode(new ZapierCliUserCancellationError());
   };
   process.on("SIGINT", cleanup);
   process.on("SIGTERM", cleanup);
@@ -1377,7 +1425,7 @@ var LoginSchema = z.object({
 
 // package.json
 var package_default = {
-  version: "0.13.16"};
+  version: "0.14.1"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {
@@ -1449,7 +1497,6 @@ var loginWithSdk = createFunction(
     });
     const user = await getLoggedInUser();
     console.log(`\u2705 Successfully logged in as ${user.email}`);
-    setTimeout(() => process.exit(0), 100);
   }
 );
 var loginPlugin = ({ context }) => {
@@ -2649,7 +2696,213 @@ function createZapierCliSdk(options = {}) {
 
 // package.json with { type: 'json' }
 var package_default2 = {
-  version: "0.13.16"};
+  name: "@zapier/zapier-sdk-cli",
+  version: "0.14.1"};
+function detectPackageManager(cwd = process.cwd()) {
+  const ua = process.env.npm_config_user_agent;
+  if (ua) {
+    if (ua.includes("yarn")) return { name: "yarn", source: "runtime" };
+    if (ua.includes("pnpm")) return { name: "pnpm", source: "runtime" };
+    if (ua.includes("bun")) return { name: "bun", source: "runtime" };
+    if (ua.includes("npm")) return { name: "npm", source: "runtime" };
+  }
+  const files = [
+    ["pnpm-lock.yaml", "pnpm"],
+    ["yarn.lock", "yarn"],
+    ["bun.lockb", "bun"],
+    ["package-lock.json", "npm"]
+  ];
+  for (const [file, name] of files) {
+    if (existsSync(join(cwd, file))) {
+      return { name, source: "lockfile" };
+    }
+  }
+  return { name: "unknown", source: "fallback" };
+}
+function getUpdateCommand(packageName) {
+  const pm = detectPackageManager();
+  const isGlobal = isInstalledGlobally;
+  if (isGlobal) {
+    switch (pm.name) {
+      case "yarn":
+        return `yarn global upgrade ${packageName}@latest`;
+      case "pnpm":
+        return `pnpm update -g ${packageName}@latest`;
+      case "bun":
+        return `bun update -g ${packageName}@latest`;
+      case "npm":
+        return `npm update -g ${packageName}@latest`;
+      case "unknown":
+        return `npm update -g ${packageName}@latest`;
+    }
+  } else {
+    switch (pm.name) {
+      case "yarn":
+        return `yarn upgrade ${packageName}@latest`;
+      case "pnpm":
+        return `pnpm update ${packageName}@latest`;
+      case "bun":
+        return `bun update ${packageName}@latest`;
+      case "npm":
+        return `npm update ${packageName}@latest`;
+      case "unknown":
+        return `npm update ${packageName}@latest`;
+    }
+  }
+}
+
+// src/utils/version-checker.ts
+var config = null;
+function getConfig() {
+  if (!config) {
+    config = new Conf({ projectName: "zapier-sdk-cli" });
+  }
+  return config;
+}
+var ONE_DAY_MS = 24 * 60 * 60 * 1e3;
+var CACHE_RESET_INTERVAL_MS = (() => {
+  const { ZAPIER_SDK_UPDATE_CHECK_INTERVAL_MS = `${ONE_DAY_MS}` } = process.env;
+  const interval = parseInt(ZAPIER_SDK_UPDATE_CHECK_INTERVAL_MS);
+  if (isNaN(interval) || interval < 0) {
+    return -1;
+  }
+  return interval;
+})();
+function getVersionCache() {
+  try {
+    const cache = getConfig().get("version_cache");
+    const now = Date.now();
+    if (!cache || !cache.last_reset_timestamp || now - cache.last_reset_timestamp >= CACHE_RESET_INTERVAL_MS) {
+      const newCache = {
+        last_reset_timestamp: now,
+        packages: {}
+      };
+      getConfig().set("version_cache", newCache);
+      return newCache;
+    }
+    return cache;
+  } catch (error) {
+    log_default.debug(`Failed to read version cache: ${error}`);
+    return {
+      last_reset_timestamp: Date.now(),
+      packages: {}
+    };
+  }
+}
+function setCachedPackageInfo(packageName, version, info) {
+  try {
+    const cache = getVersionCache();
+    if (!cache.packages[packageName]) {
+      cache.packages[packageName] = {};
+    }
+    cache.packages[packageName][version] = info;
+    getConfig().set("version_cache", cache);
+  } catch (error) {
+    log_default.debug(`Failed to cache package info: ${error}`);
+  }
+}
+function getCachedPackageInfo(packageName, version) {
+  try {
+    const cache = getVersionCache();
+    return cache.packages[packageName]?.[version];
+  } catch (error) {
+    log_default.debug(`Failed to get cached package info: ${error}`);
+    return void 0;
+  }
+}
+async function fetchCachedPackageInfo(packageName, version) {
+  const cacheKey = version || "latest";
+  let cachedInfo = getCachedPackageInfo(packageName, cacheKey);
+  if (cachedInfo) {
+    return cachedInfo;
+  }
+  const packageInfo = await packageJsonLib(packageName, {
+    version,
+    fullMetadata: true
+  });
+  const info = {
+    version: packageInfo.version,
+    deprecated: packageInfo.deprecated,
+    fetched_at: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  setCachedPackageInfo(packageName, cacheKey, info);
+  return info;
+}
+async function checkForUpdates({
+  packageName,
+  currentVersion
+}) {
+  try {
+    const latestPackageInfo = await fetchCachedPackageInfo(packageName);
+    const latestVersion = latestPackageInfo.version;
+    const hasUpdate = currentVersion !== latestVersion;
+    let currentPackageInfo;
+    try {
+      currentPackageInfo = await fetchCachedPackageInfo(
+        packageName,
+        currentVersion
+      );
+    } catch (error) {
+      log_default.debug(`Failed to check deprecation for current version: ${error}`);
+      currentPackageInfo = latestPackageInfo;
+    }
+    const isDeprecated = Boolean(currentPackageInfo.deprecated);
+    const deprecationMessage = isDeprecated ? String(currentPackageInfo.deprecated) : void 0;
+    return {
+      hasUpdate,
+      latestVersion,
+      currentVersion,
+      isDeprecated,
+      deprecationMessage
+    };
+  } catch (error) {
+    log_default.debug(`Failed to check for updates: ${error}`);
+    return {
+      hasUpdate: false,
+      currentVersion,
+      isDeprecated: false
+    };
+  }
+}
+function displayUpdateNotification(versionInfo, packageName) {
+  if (versionInfo.isDeprecated) {
+    console.error();
+    console.error(
+      chalk3.red.bold("\u26A0\uFE0F  DEPRECATION WARNING") + chalk3.red(
+        ` - ${packageName} v${versionInfo.currentVersion} is deprecated.`
+      )
+    );
+    if (versionInfo.deprecationMessage) {
+      console.error(chalk3.red(`   ${versionInfo.deprecationMessage}`));
+    }
+    console.error(chalk3.red(`   Please update to the latest version.`));
+    console.error();
+  }
+  if (versionInfo.hasUpdate) {
+    console.log();
+    console.log(
+      chalk3.yellow.bold("\u{1F4E6} Update available!") + chalk3.yellow(
+        ` ${packageName} v${versionInfo.currentVersion} \u2192 v${versionInfo.latestVersion}`
+      )
+    );
+    console.log(
+      chalk3.yellow(
+        `   Run ${chalk3.bold(getUpdateCommand(packageName))} to update.`
+      )
+    );
+    console.log();
+  }
+}
+async function checkAndNotifyUpdates({
+  packageName,
+  currentVersion
+}) {
+  if (CACHE_RESET_INTERVAL_MS < 0) {
+    return;
+  }
+  const versionInfo = await checkForUpdates({ packageName, currentVersion });
+  displayUpdateNotification(versionInfo, packageName);
+}
 
 // src/cli.ts
 var program = new Command();
@@ -2677,4 +2930,25 @@ var sdk = createZapierCliSdk({
   trackingBaseUrl
 });
 generateCliCommands(program, sdk);
-program.parse();
+program.exitOverride();
+(async () => {
+  let exitCode = 0;
+  const versionCheckPromise = checkAndNotifyUpdates({
+    packageName: package_default2.name,
+    currentVersion: package_default2.version
+  });
+  try {
+    await program.parseAsync();
+  } catch (error) {
+    if (error instanceof ZapierCliError) {
+      exitCode = error.exitCode;
+    } else if (error instanceof CommanderError) {
+      exitCode = error.exitCode;
+    } else {
+      console.error("Unexpected error:", error);
+      exitCode = 1;
+    }
+  }
+  await versionCheckPromise;
+  process.exit(exitCode);
+})();

package/dist/index.cjs

@@ -49,6 +49,18 @@ var ts__namespace = /*#__PURE__*/_interopNamespace(ts);
 // src/sdk.ts
 var LOGIN_PORTS = [49505, 50575, 52804, 55981, 61010, 63851];
 var LOGIN_TIMEOUT_MS = 3e5;
+var ZapierCliError = class extends zapierSdk.ZapierError {
+};
+var ZapierCliUserCancellationError = class extends ZapierCliError {
+  constructor(message = "Operation cancelled by user") {
+    super(message);
+    this.name = "ZapierCliUserCancellationError";
+    this.code = "ZAPIER_CLI_USER_CANCELLATION";
+    this.exitCode = 0;
+  }
+};
+
+// src/utils/spinner.ts
 var spinPromise = async (promise, text) => {
   const spinner = ora__default.default(text).start();
   try {
@@ -56,7 +68,11 @@ var spinPromise = async (promise, text) => {
     spinner.succeed();
     return result;
   } catch (error) {
-    spinner.fail();
+    if (error instanceof ZapierCliUserCancellationError) {
+      spinner.stop();
+    } else {
+      spinner.fail();
+    }
     throw error;
   }
 };
@@ -72,6 +88,11 @@ var log = {
   },
   warn: (message, ...args) => {
     console.log(chalk__default.default.yellow("\u26A0"), message, ...args);
+  },
+  debug: (message, ...args) => {
+    if (process.env.DEBUG === "true" || process.argv.includes("--debug")) {
+      console.log(chalk__default.default.gray("\u{1F41B}"), message, ...args);
+    }
   }
 };
 var log_default = log;
@@ -174,7 +195,11 @@ var login = async ({
   const availablePort = await findAvailablePort();
   const redirectUri = `http://localhost:${availablePort}/oauth`;
   log_default.info(`Using port ${availablePort} for OAuth callback`);
-  const { promise: promisedCode, resolve: setCode } = getCallablePromise_default();
+  const {
+    promise: promisedCode,
+    resolve: setCode,
+    reject: rejectCode
+  } = getCallablePromise_default();
   const app = express__default.default();
   app.get("/oauth", (req, res) => {
     setCode(String(req.query.code));
@@ -190,7 +215,7 @@ var login = async ({
   const cleanup = () => {
     server.close();
     log_default.info("\n\u274C Login cancelled by user");
-    process.exit(0);
+    rejectCode(new ZapierCliUserCancellationError());
   };
   process.on("SIGINT", cleanup);
   process.on("SIGTERM", cleanup);
@@ -266,7 +291,7 @@ var LoginSchema = zod.z.object({
 
 // package.json
 var package_default = {
-  version: "0.13.16"};
+  version: "0.14.1"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {
@@ -338,7 +363,6 @@ var loginWithSdk = zapierSdk.createFunction(
     });
     const user = await zapierSdkCliLogin.getLoggedInUser();
     console.log(`\u2705 Successfully logged in as ${user.email}`);
-    setTimeout(() => process.exit(0), 100);
   }
 );
 var loginPlugin = ({ context }) => {

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { createFunction, OutputPropertySchema, DEFAULT_CONFIG_PATH, getOsInfo, getPlatformVersions, getCiPlatform, isCi, createZapierSdkWithoutRegistry, registryPlugin, getReleaseId, getCurrentTimestamp, generateEventId, ZapierValidationError, ZapierUnknownError, batch, toSnakeCase } from '@zapier/zapier-sdk';
+import { createFunction, OutputPropertySchema, DEFAULT_CONFIG_PATH, ZapierError, getOsInfo, getPlatformVersions, getCiPlatform, isCi, createZapierSdkWithoutRegistry, registryPlugin, getReleaseId, getCurrentTimestamp, generateEventId, ZapierValidationError, ZapierUnknownError, batch, toSnakeCase } from '@zapier/zapier-sdk';
 import open from 'open';
 import crypto from 'crypto';
 import express from 'express';
@@ -18,6 +18,18 @@ import * as ts from 'typescript';
 // src/sdk.ts
 var LOGIN_PORTS = [49505, 50575, 52804, 55981, 61010, 63851];
 var LOGIN_TIMEOUT_MS = 3e5;
+var ZapierCliError = class extends ZapierError {
+};
+var ZapierCliUserCancellationError = class extends ZapierCliError {
+  constructor(message = "Operation cancelled by user") {
+    super(message);
+    this.name = "ZapierCliUserCancellationError";
+    this.code = "ZAPIER_CLI_USER_CANCELLATION";
+    this.exitCode = 0;
+  }
+};
+
+// src/utils/spinner.ts
 var spinPromise = async (promise, text) => {
   const spinner = ora(text).start();
   try {
@@ -25,7 +37,11 @@ var spinPromise = async (promise, text) => {
     spinner.succeed();
     return result;
   } catch (error) {
-    spinner.fail();
+    if (error instanceof ZapierCliUserCancellationError) {
+      spinner.stop();
+    } else {
+      spinner.fail();
+    }
     throw error;
   }
 };
@@ -41,6 +57,11 @@ var log = {
   },
   warn: (message, ...args) => {
     console.log(chalk.yellow("\u26A0"), message, ...args);
+  },
+  debug: (message, ...args) => {
+    if (process.env.DEBUG === "true" || process.argv.includes("--debug")) {
+      console.log(chalk.gray("\u{1F41B}"), message, ...args);
+    }
   }
 };
 var log_default = log;
@@ -143,7 +164,11 @@ var login = async ({
   const availablePort = await findAvailablePort();
   const redirectUri = `http://localhost:${availablePort}/oauth`;
   log_default.info(`Using port ${availablePort} for OAuth callback`);
-  const { promise: promisedCode, resolve: setCode } = getCallablePromise_default();
+  const {
+    promise: promisedCode,
+    resolve: setCode,
+    reject: rejectCode
+  } = getCallablePromise_default();
   const app = express();
   app.get("/oauth", (req, res) => {
     setCode(String(req.query.code));
@@ -159,7 +184,7 @@ var login = async ({
   const cleanup = () => {
     server.close();
     log_default.info("\n\u274C Login cancelled by user");
-    process.exit(0);
+    rejectCode(new ZapierCliUserCancellationError());
   };
   process.on("SIGINT", cleanup);
   process.on("SIGTERM", cleanup);
@@ -235,7 +260,7 @@ var LoginSchema = z.object({
 
 // package.json
 var package_default = {
-  version: "0.13.16"};
+  version: "0.14.1"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {
@@ -307,7 +332,6 @@ var loginWithSdk = createFunction(
     });
     const user = await getLoggedInUser();
     console.log(`\u2705 Successfully logged in as ${user.email}`);
-    setTimeout(() => process.exit(0), 100);
   }
 );
 var loginPlugin = ({ context }) => {

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zapier/zapier-sdk-cli",
-    "version": "0.13.16",
+    "version": "0.14.1",
     "description": "Command line interface for Zapier SDK",
     "main": "dist/index.cjs",
     "module": "dist/index.mjs",
@@ -46,12 +46,15 @@
         "chalk": "^5.3.0",
         "cli-table3": "^0.6.5",
         "commander": "^12.0.0",
+        "conf": "^14.0.0",
         "esbuild": "^0.25.5",
         "express": "^5.1.0",
         "inquirer": "^12.6.3",
+        "is-installed-globally": "^1.0.0",
         "jsonwebtoken": "^9.0.2",
         "open": "^10.2.0",
         "ora": "^8.2.0",
+        "package-json": "^10.0.1",
         "pkce-challenge": "^5.0.0",
         "typescript": "^5.8.3",
         "zod": "^3.25.67"

package/dist/src/cli.js

@@ -1,8 +1,10 @@
 #!/usr/bin/env node
-import { Command } from "commander";
+import { Command, CommanderError } from "commander";
 import { generateCliCommands } from "./utils/cli-generator";
 import { createZapierCliSdk } from "./sdk";
 import packageJson from "../package.json" with { type: "json" };
+import { ZapierCliError } from "./utils/errors";
+import { checkAndNotifyUpdates } from "./utils/version-checker";
 const program = new Command();
 program
     .name("zapier-sdk")
@@ -39,4 +41,32 @@ const sdk = createZapierCliSdk({
 // Generate CLI commands from SDK schemas (including CLI plugins)
 generateCliCommands(program, sdk);
 // MCP command now handled by plugin
-program.parse();
+// Override Commander's default exit behavior to handle our custom errors
+program.exitOverride();
+(async () => {
+    let exitCode = 0;
+    // Start version checking non-blocking
+    const versionCheckPromise = checkAndNotifyUpdates({
+        packageName: packageJson.name,
+        currentVersion: packageJson.version,
+    });
+    try {
+        await program.parseAsync();
+    }
+    catch (error) {
+        if (error instanceof ZapierCliError) {
+            exitCode = error.exitCode;
+        }
+        else if (error instanceof CommanderError) {
+            exitCode = error.exitCode;
+        }
+        else {
+            // For any other unexpected errors, exit with code 1
+            console.error("Unexpected error:", error);
+            exitCode = 1;
+        }
+    }
+    // Wait for version checking to complete
+    await versionCheckPromise;
+    process.exit(exitCode);
+})();