Function handleError

src/errors/handler.ts:5–124

(err: unknown)

import { detectOutputFormat } from "../output/formatter";

export function handleError(err: unknown): never {
  if (err instanceof CLIError) {
    const format = detectOutputFormat(process.env.MINIMAX_OUTPUT);

    if (format === "json") {
      process.stderr.write(JSON.stringify(err.toJSON(), null, 2) + "\n");
    } else {
      process.stderr.write(`\nError: ${err.message}\n`);
      if (err.hint) {
        process.stderr.write(`\n  ${err.hint.split("\n").join("\n  ")}\n`);
      }
      process.stderr.write(`  (exit code ${err.exitCode})\n`);
    }
    process.exit(err.exitCode);
  }

  if (err instanceof Error) {
    if (
      err.name === "AbortError" ||
      err.name === "TimeoutError" ||
      err.message.includes("timed out")
    ) {
      const timeout = new CLIError(
        "Request timed out.",
        ExitCode.TIMEOUT,
        "Try increasing --timeout (e.g. --timeout 60).\n" +
          "If this happens on every request with a valid API key, you may be hitting the wrong region.\n" +
          "Run: mmx auth status   — to check your credentials and region.\n" +
          "Run: mmx config set region global   (or cn) — to override the region.",
      );
      return handleError(timeout);
    }

    // Detect TypeError from fetch with invalid URL (e.g., malformed MINIMAX_BASE_URL)
    if (err instanceof TypeError && err.message === "fetch failed") {
      const networkErr = new CLIError(
        "Network request failed.",
        ExitCode.NETWORK,
        "Check your network connection.\n" +
          "To use a proxy: set HTTPS_PROXY env var, or run: mmx config set --key proxy --value http://HOST:PORT",
      );
      return handleError(networkErr);
    }

    // Detect network-level errors (proxy, connection refused, DNS, etc.)
    const msg = err.message.toLowerCase();
    const isNetworkError =
      msg.includes("failed to fetch") ||
      msg.includes("connection refused") ||
      msg.includes("econnrefused") ||
      msg.includes("connection reset") ||
      msg.includes("econnreset") ||
      msg.includes("network error") ||
      msg.includes("enotfound") ||
      msg.includes("getaddrinfo") ||
      msg.includes("proxy") ||
      msg.includes("socket") ||
      msg.includes("etimedout") ||