chore(cli): wrap third-party errors (get-port, latest-version, inquirer, stream-json) in CliError

- getLatestVersionOfCli: catch PackageNotFoundError/SyntaxError from
  latest-version, rethrow as CliError(NETWORK_ERROR)
- CliContext.getInput: catch ExitPromptError from @inquirer/prompts,
  convert to TaskAbortSignal (matches confirmPrompt behavior)
- cli.ts docs dev: catch SystemError from get-port, rethrow as
  CliError(ENVIRONMENT_ERROR)
- diff.ts readIr: catch stream-json parser errors from
  streamObjectFromFile, report as CliError(PARSE_ERROR)

Made-with: Cursor

Author: FedeZara

packages/cli/cli/src/cli-context/CliContext.ts

@@ -457,7 +457,15 @@ export class CliContext {
      * @returns Promise<string> representing the user's input
      */
     public async getInput(config: { message: string; default?: string }): Promise<string> {
-        return await input({ message: config.message, default: config.default });
+        try {
+            return await input({ message: config.message, default: config.default });
+        } catch (error) {
+            if ((error as Error)?.name === "ExitPromptError") {
+                this.logger.info("\nCancelled by user.");
+                throw new TaskAbortSignal();
+            }
+            throw error;
+        }
     }
 }
 

packages/cli/cli/src/cli-context/upgrade-utils/getLatestVersionOfCli.ts

@@ -1,3 +1,4 @@
+import { CliError } from "@fern-api/task-context";
 import latestVersion from "latest-version";
 
 import { CliEnvironment } from "../CliEnvironment.js";
@@ -14,7 +15,14 @@ export async function getLatestVersionOfCli({
     if (cliEnvironment.packageName !== "fern-api" || cliEnvironment.packageVersion === "0.0.0") {
         return cliEnvironment.packageVersion;
     }
-    return latestVersion(cliEnvironment.packageName, {
-        version: includePreReleases ? "prerelease" : "latest"
-    });
+    try {
+        return await latestVersion(cliEnvironment.packageName, {
+            version: includePreReleases ? "prerelease" : "latest"
+        });
+    } catch (error) {
+        throw new CliError({
+            message: `Failed to resolve latest CLI version: ${error instanceof Error ? error.message : String(error)}`,
+            code: "NETWORK_ERROR"
+        });
+    }
 }

packages/cli/cli/src/cli.ts

@@ -1903,18 +1903,27 @@ function addDocsDevCommand(cli: Argv<GlobalCliOptions>, cliContext: CliContext)
             }
 
             let port: number;
-            if (argv.port != null) {
-                port = argv.port;
-            } else {
-                port = await getPort({ port: [3000, 3001, 3002, 3003, 3004, 3005, 3006, 3007, 3008, 3009, 3010] });
-            }
-
             let backendPort: number;
-            if (argv.backendPort != null) {
-                backendPort = argv.backendPort;
-            } else {
-                backendPort = await getPort({
-                    port: [3001, 3002, 3003, 3004, 3005, 3006, 3007, 3008, 3009, 3010, 3011]
+            try {
+                if (argv.port != null) {
+                    port = argv.port;
+                } else {
+                    port = await getPort({
+                        port: [3000, 3001, 3002, 3003, 3004, 3005, 3006, 3007, 3008, 3009, 3010]
+                    });
+                }
+
+                if (argv.backendPort != null) {
+                    backendPort = argv.backendPort;
+                } else {
+                    backendPort = await getPort({
+                        port: [3001, 3002, 3003, 3004, 3005, 3006, 3007, 3008, 3009, 3010, 3011]
+                    });
+                }
+            } catch (error) {
+                throw new CliError({
+                    message: `Failed to find an available port: ${error instanceof Error ? error.message : String(error)}`,
+                    code: "ENVIRONMENT_ERROR"
                 });
             }
             const bundlePath: string | undefined = argv.bundlePath;

packages/cli/cli/src/commands/diff/diff.ts

@@ -76,7 +76,17 @@ async function readIr({
         context.failWithoutThrowing(`File not found: ${absoluteFilepath}`, undefined, { code: "CONFIG_ERROR" });
         throw new TaskAbortSignal();
     }
-    const ir = await streamObjectFromFile(absoluteFilepath);
+    let ir: unknown;
+    try {
+        ir = await streamObjectFromFile(absoluteFilepath);
+    } catch (error) {
+        context.failWithoutThrowing(
+            `Failed to parse IR file ${absoluteFilepath}: ${error instanceof Error ? error.message : String(error)}`,
+            error,
+            { code: "PARSE_ERROR" }
+        );
+        throw new TaskAbortSignal();
+    }
     const parsed = serialization.IntermediateRepresentation.parse(ir);
     if (!parsed.ok) {
         context.failWithoutThrowing(`Invalid --${flagName}; expected a filepath containing a valid IR`, undefined, {