Publish Stable

- @vercel/build-utils@5.0.5
 - vercel@27.3.0
 - @vercel/client@12.1.4
 - @vercel/go@2.0.9
 - @vercel/hydrogen@0.0.6
 - @vercel/next@3.1.9
 - @vercel/node@2.5.0
 - @vercel/python@3.1.1
 - @vercel/redwood@1.0.10
 - @vercel/remix@1.0.11
 - @vercel/ruby@1.3.17
 - @vercel/static-build@1.0.10

.github/CONTRIBUTING.md

@@ -12,6 +12,7 @@ To get started, execute the following:
 
 ```
 git clone https://github.com/vercel/vercel
+cd vercel
 yarn install
 yarn bootstrap
 yarn build

packages/build-utils/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/build-utils",
-  "version": "5.0.4",
+  "version": "5.0.5",
   "license": "MIT",
   "main": "./dist/index.js",
   "types": "./dist/index.d.js",
@@ -31,11 +31,10 @@
     "@types/node-fetch": "^2.1.6",
     "@types/semver": "6.0.0",
     "@types/yazl": "2.4.2",
-    "@vercel/ncc": "0.24.0",
+    "@vercel/ncc": "0.34.0",
     "aggregate-error": "3.0.1",
     "async-retry": "1.2.3",
     "async-sema": "2.1.4",
-    "boxen": "4.2.0",
     "cross-spawn": "6.0.5",
     "end-of-stream": "1.4.1",
     "fs-extra": "10.0.0",

packages/build-utils/src/fs/run-user-scripts.ts

@@ -305,67 +305,46 @@ export async function scanParentDirs(
 ): Promise<ScanParentDirsResult> {
   assert(path.isAbsolute(destPath));
 
-  let cliType: CliType = 'yarn';
+  const pkgJsonPath = await walkParentDirs({
-  let packageJson: PackageJson | undefined;
+    base: '/',
-  let packageJsonPath: string | undefined;
+    start: destPath,
-  let currentDestPath = destPath;
+    filename: 'package.json',
+  });
+  const packageJson: PackageJson | undefined =
+    readPackageJson && pkgJsonPath
+      ? JSON.parse(await fs.readFile(pkgJsonPath, 'utf8'))
+      : undefined;
+  const [yarnLockPath, npmLockPath, pnpmLockPath] = await walkParentDirsMulti({
+    base: '/',
+    start: destPath,
+    filenames: ['yarn.lock', 'package-lock.json', 'pnpm-lock.yaml'],
+  });
   let lockfileVersion: number | undefined;
+  let cliType: CliType = 'yarn';
 
-  // eslint-disable-next-line no-constant-condition
+  const [hasYarnLock, packageLockJson, pnpmLockYaml] = await Promise.all([
-  while (true) {
+    Boolean(yarnLockPath),
-    packageJsonPath = path.join(currentDestPath, 'package.json');
+    npmLockPath
-    // eslint-disable-next-line no-await-in-loop
+      ? readConfigFile<{ lockfileVersion: number }>(npmLockPath)
-    if (await fs.pathExists(packageJsonPath)) {
+      : null,
-      // Only read the contents of the *first* `package.json` file found,
+    pnpmLockPath
-      // since that's the one related to this installation.
+      ? readConfigFile<{ lockfileVersion: number }>(pnpmLockPath)
-      if (readPackageJson && !packageJson) {
+      : null,
-        // eslint-disable-next-line no-await-in-loop
+  ]);
-        packageJson = JSON.parse(await fs.readFile(packageJsonPath, 'utf8'));
-      }
 
-      // eslint-disable-next-line no-await-in-loop
+  // Priority order is Yarn > pnpm > npm
-      const [packageLockJson, hasYarnLock, pnpmLockYaml] = await Promise.all([
+  if (hasYarnLock) {
-        fs
+    cliType = 'yarn';
-          .readJson(path.join(currentDestPath, 'package-lock.json'))
+  } else if (pnpmLockYaml) {
-          .catch(error => {
+    cliType = 'pnpm';
-            // If the file doesn't exist, fail gracefully otherwise error
+    // just ensure that it is read as a number and not a string
-            if (error.code === 'ENOENT') {
+    lockfileVersion = Number(pnpmLockYaml.lockfileVersion);
-              return null;
+  } else if (packageLockJson) {
-            }
+    cliType = 'npm';
-            throw error;
+    lockfileVersion = packageLockJson.lockfileVersion;
-          }),
-        fs.pathExists(path.join(currentDestPath, 'yarn.lock')),
-        readConfigFile<{ lockfileVersion: number }>(
-          path.join(currentDestPath, 'pnpm-lock.yaml')
-        ),
-      ]);
-
-      // Priority order is Yarn > pnpm > npm
-      // - find highest priority lock file and use that
-      if (hasYarnLock) {
-        cliType = 'yarn';
-      } else if (pnpmLockYaml) {
-        cliType = 'pnpm';
-        // just ensure that it is read as a number and not a string
-        lockfileVersion = Number(pnpmLockYaml.lockfileVersion);
-      } else if (packageLockJson) {
-        cliType = 'npm';
-        lockfileVersion = packageLockJson.lockfileVersion;
-      }
-
-      // Only stop iterating if a lockfile was found, because it's possible
-      // that the lockfile is in a higher path than where the `package.json`
-      // file was found.
-      if (packageLockJson || hasYarnLock || pnpmLockYaml) {
-        break;
-      }
-    }
-
-    const newDestPath = path.dirname(currentDestPath);
-    if (currentDestPath === newDestPath) break;
-    currentDestPath = newDestPath;
   }
 
+  const packageJsonPath = pkgJsonPath || undefined;
   return { cliType, packageJson, lockfileVersion, packageJsonPath };
 }
 
@@ -387,11 +366,48 @@ export async function walkParentDirs({
     }
 
     parent = path.dirname(current);
+
+    if (parent === current) {
+      // Reached root directory of the filesystem
+      break;
+    }
   }
 
   return null;
 }
 
+async function walkParentDirsMulti({
+  base,
+  start,
+  filenames,
+}: {
+  base: string;
+  start: string;
+  filenames: string[];
+}): Promise<(string | undefined)[]> {
+  let parent = '';
+  for (let current = start; base.length <= current.length; current = parent) {
+    const fullPaths = filenames.map(f => path.join(current, f));
+    const existResults = await Promise.all(
+      fullPaths.map(f => fs.pathExists(f))
+    );
+    const foundOneOrMore = existResults.some(b => b);
+
+    if (foundOneOrMore) {
+      return fullPaths.map((f, i) => (existResults[i] ? f : undefined));
+    }
+
+    parent = path.dirname(current);
+
+    if (parent === current) {
+      // Reached root directory of the filesystem
+      break;
+    }
+  }
+
+  return [];
+}
+
 function isSet<T>(v: any): v is Set<T> {
   return v?.constructor?.name === 'Set';
 }

packages/build-utils/test/unit.test.ts

@@ -19,7 +19,7 @@ import {
   Meta,
 } from '../src';
 
-jest.setTimeout(7 * 1000);
+jest.setTimeout(10 * 1000);
 
 async function expectBuilderError(promise: Promise<any>, pattern: string) {
   let result;
@@ -454,6 +454,7 @@ it('should return lockfileVersion 2 with npm7', async () => {
   const result = await scanParentDirs(fixture);
   expect(result.cliType).toEqual('npm');
   expect(result.lockfileVersion).toEqual(2);
+  expect(result.packageJsonPath).toEqual(path.join(fixture, 'package.json'));
 });
 
 it('should not return lockfileVersion with yarn', async () => {
@@ -461,6 +462,7 @@ it('should not return lockfileVersion with yarn', async () => {
   const result = await scanParentDirs(fixture);
   expect(result.cliType).toEqual('yarn');
   expect(result.lockfileVersion).toEqual(undefined);
+  expect(result.packageJsonPath).toEqual(path.join(fixture, 'package.json'));
 });
 
 it('should return lockfileVersion 1 with older versions of npm', async () => {
@@ -468,6 +470,7 @@ it('should return lockfileVersion 1 with older versions of npm', async () => {
   const result = await scanParentDirs(fixture);
   expect(result.cliType).toEqual('npm');
   expect(result.lockfileVersion).toEqual(1);
+  expect(result.packageJsonPath).toEqual(path.join(fixture, 'package.json'));
 });
 
 it('should detect npm Workspaces', async () => {
@@ -475,20 +478,45 @@ it('should detect npm Workspaces', async () => {
   const result = await scanParentDirs(fixture);
   expect(result.cliType).toEqual('npm');
   expect(result.lockfileVersion).toEqual(2);
+  expect(result.packageJsonPath).toEqual(path.join(fixture, 'package.json'));
 });
 
-it('should detect pnpm', async () => {
+it('should detect pnpm without workspace', async () => {
   const fixture = path.join(__dirname, 'fixtures', '22-pnpm');
   const result = await scanParentDirs(fixture);
   expect(result.cliType).toEqual('pnpm');
   expect(result.lockfileVersion).toEqual(5.3);
+  expect(result.packageJsonPath).toEqual(path.join(fixture, 'package.json'));
 });
 
-it('should detect pnpm Workspaces', async () => {
+it('should detect pnpm with workspaces', async () => {
-  const fixture = path.join(__dirname, 'fixtures', '23-pnpm-workspaces/a');
+  const fixture = path.join(__dirname, 'fixtures', '23-pnpm-workspaces/c');
   const result = await scanParentDirs(fixture);
   expect(result.cliType).toEqual('pnpm');
   expect(result.lockfileVersion).toEqual(5.3);
+  expect(result.packageJsonPath).toEqual(path.join(fixture, 'package.json'));
+});
+
+it('should detect package.json in nested backend', async () => {
+  const fixture = path.join(
+    __dirname,
+    '../../node/test/fixtures/18.1-nested-packagejson/backend'
+  );
+  const result = await scanParentDirs(fixture);
+  expect(result.cliType).toEqual('yarn');
+  expect(result.lockfileVersion).toEqual(undefined);
+  expect(result.packageJsonPath).toEqual(path.join(fixture, 'package.json'));
+});
+
+it('should detect package.json in nested frontend', async () => {
+  const fixture = path.join(
+    __dirname,
+    '../../node/test/fixtures/18.1-nested-packagejson/frontend'
+  );
+  const result = await scanParentDirs(fixture);
+  expect(result.cliType).toEqual('yarn');
+  expect(result.lockfileVersion).toEqual(undefined);
+  expect(result.packageJsonPath).toEqual(path.join(fixture, 'package.json'));
 });
 
 it('should only invoke `runNpmInstall()` once per `package.json` file (serial)', async () => {

packages/cli/README.md

@@ -53,13 +53,13 @@ At this point you can make modifications to the CLI source code and test them ou
 cd packages/cli
 ```
 
-From within the `packages/cli` directory, you can use the `ts-eager` command line tool to quickly excute Vercel CLI from its TypeScript source code directly (without having to manually compile first). For example:
+From within the `packages/cli` directory, you can use the "dev" script to quickly execute Vercel CLI from its TypeScript source code directly (without having to manually compile first). For example:
 
 ```bash
-npx ts-eager src
+yarn dev deploy
-npx ts-eager src login
+yarn dev whoami
-npx ts-eager src switch --debug
+yarn dev login
-npx ts-eager src dev
+yarn dev switch --debug
 ```
 
 When you are satisfied with your changes, make a commit and create a pull request!

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vercel",
-  "version": "27.2.0",
+  "version": "27.3.0",
   "preferGlobal": true,
   "license": "Apache-2.0",
   "description": "The command-line interface for Vercel",
@@ -18,8 +18,8 @@
     "test-integration-dev": "yarn test test/dev/",
     "prepublishOnly": "yarn build",
     "coverage": "codecov",
-    "build": "node -r ts-eager/register ./scripts/build.ts",
+    "build": "ts-node ./scripts/build.ts",
-    "build-dev": "node -r ts-eager/register ./scripts/build.ts --dev"
+    "dev": "ts-node ./src/index.ts"
   },
   "bin": {
     "vc": "./dist/index.js",
@@ -42,16 +42,16 @@
     "node": ">= 14"
   },
   "dependencies": {
-    "@vercel/build-utils": "5.0.4",
+    "@vercel/build-utils": "5.0.5",
-    "@vercel/go": "2.0.8",
+    "@vercel/go": "2.0.9",
-    "@vercel/hydrogen": "0.0.5",
+    "@vercel/hydrogen": "0.0.6",
-    "@vercel/next": "3.1.8",
+    "@vercel/next": "3.1.9",
-    "@vercel/node": "2.4.5",
+    "@vercel/node": "2.5.0",
-    "@vercel/python": "3.1.0",
+    "@vercel/python": "3.1.1",
-    "@vercel/redwood": "1.0.9",
+    "@vercel/redwood": "1.0.10",
-    "@vercel/remix": "1.0.10",
+    "@vercel/remix": "1.0.11",
-    "@vercel/ruby": "1.3.16",
+    "@vercel/ruby": "1.3.17",
-    "@vercel/static-build": "1.0.9",
+    "@vercel/static-build": "1.0.10",
     "update-notifier": "5.1.0"
   },
   "devDependencies": {
@@ -59,6 +59,7 @@
     "@next/env": "11.1.2",
     "@sentry/node": "5.5.0",
     "@sindresorhus/slugify": "0.11.0",
+    "@swc/core": "1.2.218",
     "@tootallnate/once": "1.1.2",
     "@types/ansi-escapes": "3.0.0",
     "@types/ansi-regex": "4.0.0",
@@ -96,11 +97,11 @@
     "@types/which": "1.3.2",
     "@types/write-json-file": "2.2.1",
     "@types/yauzl-promise": "2.1.0",
-    "@vercel/client": "12.1.3",
+    "@vercel/client": "12.1.4",
     "@vercel/frameworks": "1.1.1",
     "@vercel/fs-detectors": "2.0.1",
     "@vercel/fun": "1.0.4",
-    "@vercel/ncc": "0.24.0",
+    "@vercel/ncc": "0.34.0",
     "@zeit/source-map-support": "0.6.2",
     "ajv": "6.12.2",
     "alpha-sort": "2.0.1",
@@ -111,6 +112,7 @@
     "async-retry": "1.1.3",
     "async-sema": "2.1.4",
     "ava": "2.2.0",
+    "boxen": "4.2.0",
     "bytes": "3.0.0",
     "chalk": "4.1.0",
     "chance": "1.1.7",
@@ -169,8 +171,8 @@
     "title": "3.4.1",
     "tmp-promise": "1.0.3",
     "tree-kill": "1.2.2",
-    "ts-node": "8.3.0",
+    "ts-node": "10.9.1",
-    "typescript": "4.3.4",
+    "typescript": "4.7.4",
     "universal-analytics": "0.4.20",
     "utility-types": "2.1.0",
     "which": "2.0.2",

packages/cli/scripts/build.ts

@@ -27,33 +27,31 @@ function envToString(key: string) {
 }
 
 async function main() {
-  const isDev = process.argv[2] === '--dev';
+  // Read the secrets from GitHub Actions and generate a file.
+  // During local development, these secrets will be empty.
+  await createConstants();
 
-  if (!isDev) {
+  // `vercel dev` uses chokidar to watch the filesystem, but opts-out of the
-    // Read the secrets from GitHub Actions and generate a file.
+  // `fsevents` feature using `useFsEvents: false`, so delete the module here so
-    // During local development, these secrets will be empty.
+  // that it is not compiled by ncc, which makes the npm package size larger
-    await createConstants();
+  // than necessary.
+  await remove(join(dirRoot, '../../node_modules/fsevents'));
 
-    // `vercel dev` uses chokidar to watch the filesystem, but opts-out of the
+  // Compile the `doT.js` template files for `vercel dev`
-    // `fsevents` feature using `useFsEvents: false`, so delete the module here so
+  console.log();
-    // that it is not compiled by ncc, which makes the npm package size larger
+  await execa(process.execPath, [join(__dirname, 'compile-templates.js')], {
-    // than necessary.
+    stdio: 'inherit',
-    await remove(join(dirRoot, '../../node_modules/fsevents'));
+  });
-
-    // Compile the `doT.js` template files for `vercel dev`
-    console.log();
-    await execa(process.execPath, [join(__dirname, 'compile-templates.js')], {
-      stdio: 'inherit',
-    });
-  }
 
   // Do the initial `ncc` build
   console.log();
-  const args = ['ncc', 'build', '--external', 'update-notifier'];
+  const args = [
-  if (isDev) {
+    'ncc',
-    args.push('--source-map');
+    'build',
-  }
+    '--external',
-  args.push('src/index.ts');
+    'update-notifier',
+    'src/index.ts',
+  ];
   await execa('yarn', args, { stdio: 'inherit', cwd: dirRoot });
 
   // `ncc` has some issues with `@vercel/fun`'s runtime files:
@@ -79,6 +77,7 @@ async function main() {
 
   // Band-aid to bundle stuff that `ncc` neglects to bundle
   await cpy(join(dirRoot, 'src/util/projects/VERCEL_DIR_README.txt'), distRoot);
+  await cpy(join(dirRoot, 'src/util/dev/builder-worker.js'), distRoot);
 
   console.log('Finished building Vercel CLI');
 }

packages/cli/src/commands/alias/ls.ts

@@ -22,19 +22,7 @@ export default async function ls(
 ) {
   const { output } = client;
   const { '--next': nextTimestamp } = opts;
-
+  const { contextName } = await getScope(client);
-  let contextName = null;
-
-  try {
-    ({ contextName } = await getScope(client));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   if (typeof nextTimestamp !== undefined && Number.isNaN(nextTimestamp)) {
     output.error('Please provide a number for flag --next');

packages/cli/src/commands/alias/rm.ts

@@ -23,19 +23,7 @@ export default async function rm(
   args: string[]
 ) {
   const { output } = client;
-
+  const { contextName } = await getScope(client);
-  let contextName = null;
-
-  try {
-    ({ contextName } = await getScope(client));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   const [aliasOrId] = args;
 

packages/cli/src/commands/alias/set.ts

@@ -15,10 +15,9 @@ import { isValidName } from '../../util/is-valid-name';
 import handleCertError from '../../util/certs/handle-cert-error';
 import isWildcardAlias from '../../util/alias/is-wildcard-alias';
 import link from '../../util/output/link';
-import { User } from '../../types';
 import { getCommandName } from '../../util/pkg-name';
 import toHost from '../../util/to-host';
-import { VercelConfig } from '../../util/dev/types';
+import type { VercelConfig } from '@vercel/client';
 
 type Options = {
   '--debug': boolean;
@@ -30,23 +29,9 @@ export default async function set(
   opts: Partial<Options>,
   args: string[]
 ) {
-  const { output, localConfig } = client;
-
   const setStamp = stamp();
-
+  const { output, localConfig } = client;
-  let user: User;
+  const { contextName, user } = await getScope(client);
-  let contextName: string | null = null;
-
-  try {
-    ({ contextName, user } = await getScope(client));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   // If there are more than two args we have to error
   if (args.length > 2) {

packages/cli/src/commands/build.ts

@@ -66,7 +66,7 @@ interface SerializedBuilder extends Builder {
 /**
  * Contents of the `builds.json` file.
  */
-interface BuildsManifest {
+export interface BuildsManifest {
   '//': string;
   target: string;
   argv: string[];
@@ -189,20 +189,6 @@ export default async function main(client: Client): Promise<number> {
     project = await readProjectSettings(join(cwd, VERCEL_DIR));
   }
 
-  // TODO: load env vars from the API, fall back to local files if that fails
-  const envPath = await checkExists([
-    join(cwd, VERCEL_DIR, `.env.${target}.local`),
-    join(cwd, `.env`),
-  ]);
-  if (envPath) {
-    dotenv.config({ path: envPath, debug: client.output.isDebugEnabled() });
-    output.log(`Loaded env from "${relative(cwd, envPath)}"`);
-  }
-
-  // Some build processes use these env vars to platform detect Vercel
-  process.env.VERCEL = '1';
-  process.env.NOW_BUILDER = '1';
-
   // Delete output directory from potential previous build
   const outputDir = argv['--output']
     ? resolve(argv['--output'])
@@ -215,7 +201,36 @@ export default async function main(client: Client): Promise<number> {
     argv: process.argv,
   };
 
+  const envToUnset = new Set<string>(['VERCEL', 'NOW_BUILDER']);
+
   try {
+    const envPath = join(cwd, VERCEL_DIR, `.env.${target}.local`);
+    // TODO (maybe?): load env vars from the API, fall back to the local file if that fails
+    const dotenvResult = dotenv.config({
+      path: envPath,
+      debug: client.output.isDebugEnabled(),
+    });
+    if (dotenvResult.error) {
+      output.debug(
+        `Failed loading environment variables: ${dotenvResult.error}`
+      );
+    } else if (dotenvResult.parsed) {
+      for (const key of Object.keys(dotenvResult.parsed)) {
+        envToUnset.add(key);
+      }
+      output.debug(`Loaded environment variables from "${envPath}"`);
+    }
+
+    // For Vercel Analytics support
+    if (project.settings.analyticsId) {
+      envToUnset.add('VERCEL_ANALYTICS_ID');
+      process.env.VERCEL_ANALYTICS_ID = project.settings.analyticsId;
+    }
+
+    // Some build processes use these env vars to platform detect Vercel
+    process.env.VERCEL = '1';
+    process.env.NOW_BUILDER = '1';
+
     return await doBuild(client, project, buildsJson, cwd, outputDir);
   } catch (err: any) {
     output.prettyError(err);
@@ -230,6 +245,12 @@ export default async function main(client: Client): Promise<number> {
     await fs.writeJSON(configJsonPath, { version: 3 }, { spaces: 2 });
 
     return 1;
+  } finally {
+    // Unset environment variables that were added by dotenv
+    // (this is mostly for the unit tests)
+    for (const key of envToUnset) {
+      delete process.env[key];
+    }
   }
 }
 
@@ -278,6 +299,7 @@ async function doBuild(
 
   let builds = vercelConfig?.builds || [];
   let zeroConfigRoutes: Route[] = [];
+  let isZeroConfig = false;
 
   if (builds.length > 0) {
     output.warn(
@@ -286,6 +308,7 @@ async function doBuild(
     builds = builds.map(b => expandBuild(files, b)).flat();
   } else {
     // Zero config
+    isZeroConfig = true;
 
     // Detect the Vercel Builders that will need to be invoked
     const detectedBuilders = await detectBuilders(files, pkg, {
@@ -400,16 +423,18 @@ async function doBuild(
     try {
       const { builder, pkg: builderPkg } = builderWithPkg;
 
-      const buildConfig: Config = {
+      const buildConfig: Config = isZeroConfig
-        outputDirectory: project.settings.outputDirectory ?? undefined,
+        ? {
-        ...build.config,
+            outputDirectory: project.settings.outputDirectory ?? undefined,
-        projectSettings: project.settings,
+            ...build.config,
-        installCommand: project.settings.installCommand ?? undefined,
+            projectSettings: project.settings,
-        devCommand: project.settings.devCommand ?? undefined,
+            installCommand: project.settings.installCommand ?? undefined,
-        buildCommand: project.settings.buildCommand ?? undefined,
+            devCommand: project.settings.devCommand ?? undefined,
-        framework: project.settings.framework,
+            buildCommand: project.settings.buildCommand ?? undefined,
-        nodeVersion: project.settings.nodeVersion,
+            framework: project.settings.framework,
-      };
+            nodeVersion: project.settings.nodeVersion,
+          }
+        : build.config || {};
       const buildOptions: BuildOptions = {
         files: filesMap,
         entrypoint: build.src,
@@ -435,7 +460,7 @@ async function doBuild(
           build,
           builder,
           builderPkg,
-          vercelConfig?.cleanUrls
+          vercelConfig
         ).then(
           override => {
             if (override) overrides.push(override);
@@ -596,7 +621,7 @@ function mergeImages(
   let images: BuildResultV2Typical['images'] = undefined;
   for (const result of buildResults) {
     if ('images' in result && result.images) {
-      images = Object.assign({} || images, result.images);
+      images = Object.assign({}, images, result.images);
     }
   }
   return images;
@@ -614,14 +639,3 @@ function mergeWildcard(
   }
   return wildcard;
 }
-
-async function checkExists(paths: Iterable<string>) {
-  for (const path of paths) {
-    try {
-      await fs.stat(path);
-      return path;
-    } catch (err: any) {
-      if (err.code !== 'ENOENT') throw err;
-    }
-  }
-}

packages/cli/src/commands/certs/add.ts

@@ -5,6 +5,7 @@ import stamp from '../../util/output/stamp';
 import createCertFromFile from '../../util/certs/create-cert-from-file';
 import createCertForCns from '../../util/certs/create-cert-for-cns';
 import { getCommandName } from '../../util/pkg-name';
+import { Cert } from '../../types';
 
 interface Options {
   '--overwrite'?: boolean;
@@ -21,7 +22,7 @@ async function add(
   const { output } = client;
   const addStamp = stamp();
 
-  let cert;
+  let cert: Cert | Error;
 
   const {
     '--overwrite': overwite,
@@ -30,18 +31,7 @@ async function add(
     '--ca': caPath,
   } = opts;
 
-  let contextName = null;
+  const { contextName } = await getScope(client);
-
-  try {
-    ({ contextName } = await getScope(client));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   if (overwite) {
     output.error('Overwrite option is deprecated');

packages/cli/src/commands/certs/issue.ts

@@ -39,18 +39,7 @@ export default async function issue(
     '--ca': caPath,
   } = opts;
 
-  let contextName = null;
+  const { contextName } = await getScope(client);
-
-  try {
-    ({ contextName } = await getScope(client));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   if (overwite) {
     output.error('Overwrite option is deprecated');

packages/cli/src/commands/certs/ls.ts

@@ -21,18 +21,8 @@ async function ls(
 ): Promise<number> {
   const { output } = client;
   const { '--next': nextTimestamp } = opts;
-  let contextName = null;
+  const { contextName } = await getScope(client);
 
-  try {
-    ({ contextName } = await getScope(client));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
   if (typeof nextTimestamp !== 'undefined' && Number.isNaN(nextTimestamp)) {
     output.error('Please provide a number for flag --next');
     return 1;

packages/cli/src/commands/certs/rm.ts

@@ -17,21 +17,9 @@ import { getCommandName } from '../../util/pkg-name';
 type Options = {};
 
 async function rm(client: Client, opts: Options, args: string[]) {
-  const { output } = client;
   const rmStamp = stamp();
-
+  const { output } = client;
-  let contextName = null;
+  const { contextName } = await getScope(client);
-
-  try {
-    ({ contextName } = await getScope(client));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   if (args.length !== 1) {
     output.error(

packages/cli/src/commands/deploy/index.ts

@@ -3,7 +3,7 @@ import fs from 'fs-extra';
 import bytes from 'bytes';
 import chalk from 'chalk';
 import { join, resolve, basename } from 'path';
-import { Dictionary, fileNameSymbol, VercelConfig } from '@vercel/client';
+import { fileNameSymbol, VercelConfig } from '@vercel/client';
 import code from '../../util/output/code';
 import highlight from '../../util/output/highlight';
 import { readLocalConfig } from '../../util/config/files';
@@ -38,6 +38,7 @@ import {
   ConflictingPathSegment,
   BuildError,
   NotDomainOwner,
+  isAPIError,
 } from '../../util/errors-ts';
 import { SchemaValidationFailed } from '../../util/errors';
 import purchaseDomainIfAvailable from '../../util/domains/purchase-domain-if-available';
@@ -65,6 +66,8 @@ import { getDeploymentChecks } from '../../util/deploy/get-deployment-checks';
 import parseTarget from '../../util/deploy/parse-target';
 import getPrebuiltJson from '../../util/deploy/get-prebuilt-json';
 import { createGitMeta } from '../../util/create-git-meta';
+import { parseEnv } from '../../util/parse-env';
+import { errorToString, isErrnoException, isError } from '../../util/is-error';
 
 export default async (client: Client) => {
   const { output } = client;
@@ -216,6 +219,22 @@ export default async (client: Client) => {
     }
 
     const prebuiltBuild = await getPrebuiltJson(path);
+
+    // Ensure that there was not a build error
+    const prebuiltError =
+      prebuiltBuild?.error ||
+      prebuiltBuild?.builds?.find(build => 'error' in build)?.error;
+    if (prebuiltError) {
+      output.log(
+        `Prebuilt deployment cannot be created because ${getCommandName(
+          'build'
+        )} failed with error:\n`
+      );
+      prettyError(prebuiltError);
+      return 1;
+    }
+
+    // Ensure that the deploy target matches the build target
     const assumedTarget = target || 'preview';
     if (prebuiltBuild?.target && prebuiltBuild.target !== assumedTarget) {
       let specifyTarget = '';
@@ -268,8 +287,11 @@ export default async (client: Client) => {
         'Which scope do you want to deploy to?',
         autoConfirm
       );
-    } catch (err) {
+    } catch (err: unknown) {
-      if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
+      if (
+        isErrnoException(err) &&
+        (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED')
+      ) {
         output.error(err.message);
         return 1;
       }
@@ -448,8 +470,8 @@ export default async (client: Client) => {
   try {
     await addProcessEnv(log, deploymentEnv);
     await addProcessEnv(log, deploymentBuildEnv);
-  } catch (err) {
+  } catch (err: unknown) {
-    error(err.message);
+    error(errorToString(err));
     return 1;
   }
 
@@ -610,8 +632,10 @@ export default async (client: Client) => {
       error('Uploading failed. Please try again.');
       return 1;
     }
-  } catch (err) {
+  } catch (err: unknown) {
-    debug(`Error: ${err}\n${err.stack}`);
+    if (isError(err)) {
+      debug(`Error: ${err}\n${err.stack}`);
+    }
 
     if (err instanceof NotDomainOwner) {
       output.error(err.message);
@@ -678,13 +702,7 @@ export default async (client: Client) => {
       return 1;
     }
 
-    if (err.keyword === 'additionalProperties' && err.dataPath === '.scale') {
+    if (isAPIError(err) && err.code === 'size_limit_exceeded') {
-      const { additionalProperty = '' } = err.params || {};
-      const message = `Invalid DC name for the scale option: ${additionalProperty}`;
-      error(message);
-    }
-
-    if (err.code === 'size_limit_exceeded') {
       const { sizeLimit = 0 } = err;
       const message = `File size limit exceeded (${bytes(sizeLimit)})`;
       error(message);
@@ -894,36 +912,3 @@ const printDeploymentStatus = async (
     output.print(message + link);
   }
 };
-
-// Converts `env` Arrays, Strings and Objects into env Objects.
-const parseEnv = (env?: string[] | Dictionary<string>) => {
-  if (!env) {
-    return {};
-  }
-
-  if (typeof env === 'string') {
-    // a single `--env` arg comes in as a String
-    env = [env];
-  }
-
-  if (Array.isArray(env)) {
-    return env.reduce((o, e) => {
-      let key;
-      let value;
-      const equalsSign = e.indexOf('=');
-
-      if (equalsSign === -1) {
-        key = e;
-      } else {
-        key = e.slice(0, equalsSign);
-        value = e.slice(equalsSign + 1);
-      }
-
-      o[key] = value;
-      return o;
-    }, {} as Dictionary<string | undefined>);
-  }
-
-  // assume it's already an Object
-  return env;
-};

packages/cli/src/commands/dev/index.ts

@@ -15,6 +15,7 @@ import readConfig from '../../util/config/read-config';
 import readJSONFile from '../../util/read-json-file';
 import { getPkgName, getCommandName } from '../../util/pkg-name';
 import { CantParseJSONFile } from '../../util/errors-ts';
+import { isErrnoException } from '../../util/is-error';
 
 const COMMAND_CONFIG = {
   dev: ['dev'],
@@ -136,7 +137,7 @@ export default async function main(client: Client) {
   try {
     return await dev(client, argv, args);
   } catch (err) {
-    if (err.code === 'ENOTFOUND') {
+    if (isErrnoException(err) && err.code === 'ENOTFOUND') {
       // Error message will look like the following:
       // "request to https://api.vercel.com/v2/user failed, reason: getaddrinfo ENOTFOUND api.vercel.com"
       const matches = /getaddrinfo ENOTFOUND (.*)$/.exec(err.message || '');
@@ -148,7 +149,9 @@ export default async function main(client: Client) {
           )} could not be resolved. Please verify your internet connectivity and DNS configuration.`
         );
       }
-      output.debug(err.stack);
+      if (typeof err.stack === 'string') {
+        output.debug(err.stack);
+      }
       return 1;
     }
     output.prettyError(err);

packages/cli/src/commands/dns/add.ts

@@ -21,18 +21,7 @@ export default async function add(
   args: string[]
 ) {
   const { output } = client;
-  let contextName = null;
+  const { contextName } = await getScope(client);
-
-  try {
-    ({ contextName } = await getScope(client));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   const parsedParams = parseAddDNSRecordArgs(args);
   if (!parsedParams) {

packages/cli/src/commands/dns/import.ts

@@ -14,18 +14,7 @@ export default async function add(
   args: string[]
 ) {
   const { output } = client;
-  let contextName = null;
+  const { contextName } = await getScope(client);
-
-  try {
-    ({ contextName } = await getScope(client));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   if (args.length !== 2) {
     output.error(

packages/cli/src/commands/dns/ls.ts

@@ -24,18 +24,7 @@ export default async function ls(
 ) {
   const { output } = client;
   const { '--next': nextTimestamp } = opts;
-  let contextName = null;
+  const { contextName } = await getScope(client);
-
-  try {
-    ({ contextName } = await getScope(client));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   const [domainName] = args;
   const lsStamp = stamp();

packages/cli/src/commands/dns/rm.ts

@@ -14,21 +14,11 @@ type Options = {};
 
 export default async function rm(
   client: Client,
-  opts: Options,
+  _opts: Options,
   args: string[]
 ) {
   const { output } = client;
-
+  await getScope(client);
-  try {
-    await getScope(client);
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   const [recordId] = args;
   if (args.length !== 1) {

packages/cli/src/commands/domains/add.ts

@@ -26,18 +26,7 @@ export default async function add(
 ) {
   const { output } = client;
   const force = opts['--force'];
-  let contextName = null;
+  const { contextName } = await getScope(client);
-
-  try {
-    ({ contextName } = await getScope(client));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   const project = await getLinkedProject(client).then(result => {
     if (result.status === 'linked') {

packages/cli/src/commands/domains/buy.ts

@@ -11,6 +11,7 @@ import promptBool from '../../util/input/prompt-bool';
 import purchaseDomain from '../../util/domains/purchase-domain';
 import stamp from '../../util/output/stamp';
 import { getCommandName } from '../../util/pkg-name';
+import { errorToString } from '../../util/is-error';
 
 type Options = {};
 
@@ -20,18 +21,7 @@ export default async function buy(
   args: string[]
 ) {
   const { output } = client;
-  let contextName = null;
+  const { contextName } = await getScope(client);
-
-  try {
-    ({ contextName } = await getScope(client));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   const [domainName] = args;
   if (!domainName) {
@@ -68,6 +58,11 @@ export default async function buy(
     return 1;
   }
 
+  if (renewalPrice instanceof Error) {
+    output.prettyError(renewalPrice);
+    return 1;
+  }
+
   if (!(await getDomainStatus(client, domainName)).available) {
     output.error(
       `The domain ${param(domainName)} is ${chalk.underline(
@@ -109,11 +104,11 @@ export default async function buy(
 
   try {
     buyResult = await purchaseDomain(client, domainName, price, autoRenew);
-  } catch (err) {
+  } catch (err: unknown) {
     output.error(
       'An unexpected error occurred while purchasing your domain. Please try again later.'
     );
-    output.debug(`Server response: ${err.message}`);
+    output.debug(`Server response: ${errorToString(err)}`);
     return 1;
   }
 

packages/cli/src/commands/domains/inspect.ts

@@ -23,19 +23,7 @@ export default async function inspect(
   args: string[]
 ) {
   const { output } = client;
-
+  const { contextName } = await getScope(client);
-  let contextName = null;
-
-  try {
-    ({ contextName } = await getScope(client));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   const [domainName] = args;
   const inspectStamp = stamp();

packages/cli/src/commands/domains/ls.ts

@@ -25,23 +25,13 @@ export default async function ls(
 ) {
   const { output } = client;
   const { '--next': nextTimestamp } = opts;
-  let contextName = null;
 
   if (typeof nextTimestamp !== undefined && Number.isNaN(nextTimestamp)) {
     output.error('Please provide a number for flag --next');
     return 1;
   }
 
-  try {
+  const { contextName } = await getScope(client);
-    ({ contextName } = await getScope(client));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   const lsStamp = stamp();
 

packages/cli/src/commands/domains/move.ts

@@ -25,20 +25,7 @@ export default async function move(
   args: string[]
 ) {
   const { output } = client;
-  let contextName = null;
+  const { contextName, user } = await getScope(client);
-  let user = null;
-
-  try {
-    ({ contextName, user } = await getScope(client));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
-
   const { domainName, destination } = await getArgs(args);
   if (!isRootDomain(domainName)) {
     output.error(

packages/cli/src/commands/domains/rm.ts

@@ -29,18 +29,7 @@ export default async function rm(
 ) {
   const { output } = client;
   const [domainName] = args;
-  let contextName = null;
+  const { contextName } = await getScope(client);
-
-  try {
-    ({ contextName } = await getScope(client));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   if (!domainName) {
     output.error(
@@ -122,10 +111,10 @@ async function removeDomain(
     output.debug(`Removing alias ${id}`);
     try {
       await removeAliasById(client, id);
-    } catch (error) {
+    } catch (err: unknown) {
       // Ignore if the alias does not exist anymore
-      if (error.status !== 404) {
+      if (!ERRORS.isAPIError(err) || err.status !== 404) {
-        throw error;
+        throw err;
       }
     }
   }
@@ -134,10 +123,10 @@ async function removeDomain(
     output.debug(`Removing cert ${id}`);
     try {
       await deleteCertById(output, client, id);
-    } catch (error) {
+    } catch (err: unknown) {
       // Ignore if the cert does not exist anymore
-      if (error.status !== 404) {
+      if (!ERRORS.isAPIError(err) || err.status !== 404) {
-        throw error;
+        throw err;
       }
     }
   }

packages/cli/src/commands/domains/transfer-in.ts

@@ -23,18 +23,7 @@ export default async function transferIn(
   args: string[]
 ) {
   const { output } = client;
-  let contextName = null;
+  const { contextName } = await getScope(client);
-
-  try {
-    ({ contextName } = await getScope(client));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   const [domainName] = args;
   if (!domainName) {

packages/cli/src/commands/env/add.ts

@@ -1,5 +1,4 @@
 import chalk from 'chalk';
-import inquirer from 'inquirer';
 import { ProjectEnvTarget, Project, ProjectEnvType } from '../../types';
 import { Output } from '../../util/output';
 import Client from '../../util/client';
@@ -16,6 +15,7 @@ import param from '../../util/output/param';
 import { emoji, prependEmoji } from '../../util/emoji';
 import { isKnownError } from '../../util/env/known-error';
 import { getCommandName } from '../../util/pkg-name';
+import { isAPIError } from '../../util/errors-ts';
 
 type Options = {
   '--debug': boolean;
@@ -66,7 +66,7 @@ export default async function add(
   }
 
   while (!envName) {
-    const { inputName } = await inquirer.prompt({
+    const { inputName } = await client.prompt({
       type: 'input',
       name: 'inputName',
       message: `What’s the name of the variable?`,
@@ -106,7 +106,7 @@ export default async function add(
   if (stdInput) {
     envValue = stdInput;
   } else {
-    const { inputValue } = await inquirer.prompt({
+    const { inputValue } = await client.prompt({
       type: 'input',
       name: 'inputValue',
       message: `What’s the value of ${envName}?`,
@@ -116,7 +116,7 @@ export default async function add(
   }
 
   while (envTargets.length === 0) {
-    const { inputTargets } = await inquirer.prompt({
+    const { inputTargets } = await client.prompt({
       name: 'inputTargets',
       type: 'checkbox',
       message: `Add ${envName} to which Environments (select multiple)?`,
@@ -136,7 +136,7 @@ export default async function add(
     envTargets.length === 1 &&
     envTargets[0] === ProjectEnvTarget.Preview
   ) {
-    const { inputValue } = await inquirer.prompt({
+    const { inputValue } = await client.prompt({
       type: 'input',
       name: 'inputValue',
       message: `Add ${envName} to which Git branch? (leave empty for all Preview branches)?`,
@@ -157,12 +157,12 @@ export default async function add(
       envTargets,
       envGitBranch
     );
-  } catch (error) {
+  } catch (err: unknown) {
-    if (isKnownError(error) && error.serverMessage) {
+    if (isAPIError(err) && isKnownError(err)) {
-      output.error(error.serverMessage);
+      output.error(err.serverMessage);
       return 1;
     }
-    throw error;
+    throw err;
   }
 
   output.print(

packages/cli/src/commands/env/pull.ts

@@ -14,6 +14,11 @@ import param from '../../util/output/param';
 import stamp from '../../util/output/stamp';
 import { getCommandName } from '../../util/pkg-name';
 import { EnvRecordsSource } from '../../util/env/get-env-records';
+import {
+  buildDeltaString,
+  createEnvObject,
+} from '../../util/env/diff-env-files';
+import { isErrnoException } from '../../util/is-error';
 
 const CONTENTS_PREFIX = '# Created by Vercel CLI\n';
 
@@ -36,8 +41,8 @@ function readHeadSync(path: string, length: number) {
 function tryReadHeadSync(path: string, length: number) {
   try {
     return readHeadSync(path, length);
-  } catch (err) {
+  } catch (err: unknown) {
-    if (err.code !== 'ENOENT') {
+    if (!isErrnoException(err) || err.code !== 'ENOENT') {
       throw err;
     }
   }
@@ -69,7 +74,7 @@ export default async function pull(
   const exists = typeof head !== 'undefined';
 
   if (head === CONTENTS_PREFIX) {
-    output.print(`Overwriting existing ${chalk.bold(filename)} file\n`);
+    output.log(`Overwriting existing ${chalk.bold(filename)} file`);
   } else if (
     exists &&
     !skipConfirmation &&
@@ -83,10 +88,10 @@ export default async function pull(
     return 0;
   }
 
-  output.print(
+  output.log(
-    `Downloading "${environment}" Environment Variables for Project ${chalk.bold(
+    `Downloading \`${chalk.cyan(
-      project.name
+      environment
-    )}\n`
+    )}\` Environment Variables for Project ${chalk.bold(project.name)}`
   );
 
   const pullStamp = stamp();
@@ -107,6 +112,15 @@ export default async function pull(
     environment
   );
 
+  let deltaString = '';
+  let oldEnv;
+  if (exists) {
+    oldEnv = await createEnvObject(fullPath, output);
+    if (oldEnv) {
+      deltaString = buildDeltaString(oldEnv, records);
+    }
+  }
+
   const contents =
     CONTENTS_PREFIX +
     Object.entries(records)
@@ -125,6 +139,13 @@ export default async function pull(
     )}\n`
   );
 
+  output.print('\n');
+  if (deltaString) {
+    output.print(deltaString);
+  } else if (oldEnv && exists) {
+    output.log('No changes found.');
+  }
+
   return 0;
 }
 

packages/cli/src/commands/env/rm.ts

@@ -16,6 +16,7 @@ import param from '../../util/output/param';
 import { emoji, prependEmoji } from '../../util/emoji';
 import { isKnownError } from '../../util/env/known-error';
 import { getCommandName } from '../../util/pkg-name';
+import { isAPIError } from '../../util/errors-ts';
 
 type Options = {
   '--debug': boolean;
@@ -120,12 +121,12 @@ export default async function rm(
   try {
     output.spinner('Removing');
     await removeEnvRecord(output, client, project.id, env);
-  } catch (error) {
+  } catch (err: unknown) {
-    if (isKnownError(error) && error.serverMessage) {
+    if (isAPIError(err) && isKnownError(err)) {
-      output.error(error.serverMessage);
+      output.error(err.serverMessage);
       return 1;
     }
-    throw error;
+    throw err;
   }
 
   output.print(

packages/cli/src/commands/init/index.ts

@@ -7,6 +7,7 @@ import handleError from '../../util/handle-error';
 import logo from '../../util/output/logo';
 import init from './init';
 import { getPkgName } from '../../util/pkg-name';
+import { isError } from '../../util/is-error';
 
 const COMMAND_CONFIG = {
   init: ['init'],
@@ -70,9 +71,11 @@ export default async function main(client: Client) {
 
   try {
     return await init(client, argv, args);
-  } catch (err) {
+  } catch (err: unknown) {
     output.prettyError(err);
-    output.debug(err.stack);
+    if (isError(err) && typeof err.stack === 'string') {
+      output.debug(err.stack);
+    }
     return 1;
   }
 }

packages/cli/src/commands/inspect.ts

@@ -12,6 +12,9 @@ import Client from '../util/client';
 import { getDeployment } from '../util/get-deployment';
 import { Deployment } from '@vercel/client';
 import { Build } from '../types';
+import title from 'title';
+import { isErrnoException } from '../util/is-error';
+import { isAPIError } from '../util/errors-ts';
 
 const help = () => {
   console.log(`
@@ -75,8 +78,11 @@ export default async function main(client: Client) {
 
   try {
     ({ contextName } = await getScope(client));
-  } catch (err) {
+  } catch (err: unknown) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
+    if (
+      isErrnoException(err) &&
+      (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED')
+    ) {
       error(err.message);
       return 1;
     }
@@ -92,28 +98,38 @@ export default async function main(client: Client) {
 
   try {
     deployment = await getDeployment(client, deploymentIdOrHost);
-  } catch (err) {
+  } catch (err: unknown) {
-    if (err.status === 404) {
+    if (isAPIError(err)) {
-      error(
+      if (err.status === 404) {
-        `Failed to find deployment "${deploymentIdOrHost}" in ${chalk.bold(
+        error(
-          contextName
+          `Failed to find deployment "${deploymentIdOrHost}" in ${chalk.bold(
-        )}`
+            contextName
-      );
+          )}`
-      return 1;
+        );
-    }
+        return 1;
-    if (err.status === 403) {
+      }
-      error(
+      if (err.status === 403) {
-        `No permission to access deployment "${deploymentIdOrHost}" in ${chalk.bold(
+        error(
-          contextName
+          `No permission to access deployment "${deploymentIdOrHost}" in ${chalk.bold(
-        )}`
+            contextName
-      );
+          )}`
-      return 1;
+        );
+        return 1;
+      }
     }
     // unexpected
     throw err;
   }
 
-  const { id, name, url, createdAt, routes, readyState } = deployment;
+  const {
+    id,
+    name,
+    url,
+    createdAt,
+    routes,
+    readyState,
+    alias: aliases,
+  } = deployment;
 
   const { builds } =
     deployment.version === 2
@@ -121,20 +137,20 @@ export default async function main(client: Client) {
       : { builds: [] };
 
   log(
-    `Fetched deployment "${url}" in ${chalk.bold(contextName)} ${elapsed(
+    `Fetched deployment ${chalk.bold(url)} in ${chalk.bold(
-      Date.now() - depFetchStart
+      contextName
-    )}`
+    )} ${elapsed(Date.now() - depFetchStart)}`
   );
 
   print('\n');
   print(chalk.bold('  General\n\n'));
   print(`    ${chalk.cyan('id')}\t\t${id}\n`);
   print(`    ${chalk.cyan('name')}\t${name}\n`);
-  print(`    ${chalk.cyan('readyState')}\t${stateString(readyState)}\n`);
+  print(`    ${chalk.cyan('status')}\t${stateString(readyState)}\n`);
-  print(`    ${chalk.cyan('url')}\t\t${url}\n`);
+  print(`    ${chalk.cyan('url')}\t\thttps://${url}\n`);
   if (createdAt) {
     print(
-      `    ${chalk.cyan('createdAt')}\t${new Date(createdAt)} ${elapsed(
+      `    ${chalk.cyan('created')}\t${new Date(createdAt)} ${elapsed(
         Date.now() - createdAt,
         true
       )}\n`
@@ -142,6 +158,16 @@ export default async function main(client: Client) {
   }
   print('\n\n');
 
+  if (aliases.length > 0) {
+    print(chalk.bold('  Aliases\n\n'));
+    let aliasList = '';
+    for (const alias of aliases) {
+      aliasList += `${chalk.gray('╶')} https://${alias}\n`;
+    }
+    print(indent(aliasList, 4));
+    print('\n\n');
+  }
+
   if (builds.length > 0) {
     const times: { [id: string]: string | null } = {};
 
@@ -165,19 +191,24 @@ export default async function main(client: Client) {
   return 0;
 }
 
-// renders the state string
 function stateString(s: Deployment['readyState']) {
+  const CIRCLE = '● ';
+  const sTitle = s && title(s);
   switch (s) {
     case 'INITIALIZING':
-      return chalk.yellow(s);
+    case 'BUILDING':
-
+    case 'DEPLOYING':
+    case 'ANALYZING':
+      return chalk.yellow(CIRCLE) + sTitle;
     case 'ERROR':
-      return chalk.red(s);
+      return chalk.red(CIRCLE) + sTitle;
-
     case 'READY':
-      return s;
+      return chalk.green(CIRCLE) + sTitle;
-
+    case 'QUEUED':
+      return chalk.gray(CIRCLE) + sTitle;
+    case 'CANCELED':
+      return chalk.gray(CIRCLE) + sTitle;
     default:
-      return chalk.gray(s || 'UNKNOWN');
+      return chalk.gray('UNKNOWN');
   }
 }

packages/cli/src/commands/list.ts

@@ -19,6 +19,7 @@ import validatePaths from '../util/validate-paths';
 import { getLinkedProject } from '../util/projects/link';
 import { ensureLink } from '../util/ensure-link';
 import getScope from '../util/get-scope';
+import { isAPIError } from '../util/errors-ts';
 
 const help = () => {
   console.log(`
@@ -152,16 +153,7 @@ export default async function main(client: Client) {
 
   const { currentTeam } = config;
 
-  try {
+  ({ contextName } = await getScope(client));
-    ({ contextName } = await getScope(client));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   const nextTimestamp = argv['--next'];
 
@@ -228,8 +220,8 @@ export default async function main(client: Client) {
 
     try {
       await now.findDeployment(app);
-    } catch (err) {
+    } catch (err: unknown) {
-      if (err.status === 404) {
+      if (isAPIError(err) && err.status === 404) {
         debug('Ignore findDeployment 404');
       } else {
         throw err;

packages/cli/src/commands/logout.ts

@@ -5,6 +5,8 @@ import { writeToConfigFile, writeToAuthConfigFile } from '../util/config/files';
 import getArgs from '../util/get-args';
 import Client from '../util/client';
 import { getCommandName, getPkgName } from '../util/pkg-name';
+import { isAPIError } from '../util/errors-ts';
+import { errorToString } from '../util/is-error';
 
 const help = () => {
   console.log(`
@@ -63,12 +65,14 @@ export default async function main(client: Client): Promise<number> {
       method: 'DELETE',
       useCurrentTeam: false,
     });
-  } catch (err) {
+  } catch (err: unknown) {
-    if (err.status === 403) {
+    if (isAPIError(err)) {
-      output.debug('Token is invalid so it cannot be revoked');
+      if (err.status === 403) {
-    } else if (err.status !== 200) {
+        output.debug('Token is invalid so it cannot be revoked');
-      output.debug(err?.message ?? '');
+      } else if (err.status !== 200) {
-      exitCode = 1;
+        output.debug(err?.message ?? '');
+        exitCode = 1;
+      }
     }
   }
 
@@ -86,8 +90,8 @@ export default async function main(client: Client): Promise<number> {
     writeToConfigFile(config);
     writeToAuthConfigFile(authConfig);
     output.debug('Configuration has been deleted');
-  } catch (err) {
+  } catch (err: unknown) {
-    output.debug(err?.message ?? '');
+    output.debug(errorToString(err));
     exitCode = 1;
   }
 

packages/cli/src/commands/logs.ts

@@ -8,6 +8,7 @@ import { getPkgName } from '../util/pkg-name';
 import getArgs from '../util/get-args';
 import Client from '../util/client';
 import { getDeployment } from '../util/get-deployment';
+import { isAPIError } from '../util/errors-ts';
 
 const help = () => {
   console.log(`
@@ -125,22 +126,24 @@ export default async function main(client: Client) {
   let deployment;
   try {
     deployment = await getDeployment(client, id);
-  } catch (err) {
+  } catch (err: unknown) {
     output.stopSpinner();
 
-    if (err.status === 404) {
+    if (isAPIError(err)) {
-      output.error(
+      if (err.status === 404) {
-        `Failed to find deployment "${id}" in ${chalk.bold(contextName)}`
+        output.error(
-      );
+          `Failed to find deployment "${id}" in ${chalk.bold(contextName)}`
-      return 1;
+        );
-    }
+        return 1;
-    if (err.status === 403) {
+      }
-      output.error(
+      if (err.status === 403) {
-        `No permission to access deployment "${id}" in ${chalk.bold(
+        output.error(
-          contextName
+          `No permission to access deployment "${id}" in ${chalk.bold(
-        )}`
+            contextName
-      );
+          )}`
-      return 1;
+        );
+        return 1;
+      }
     }
     // unexpected
     throw err;

packages/cli/src/commands/project/add.ts

@@ -1,6 +1,7 @@
 import chalk from 'chalk';
 import ms from 'ms';
 import Client from '../../util/client';
+import { isAPIError } from '../../util/errors-ts';
 import { getCommandName } from '../../util/pkg-name';
 
 export default async function add(
@@ -36,12 +37,12 @@ export default async function add(
       method: 'POST',
       body: { name },
     });
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.status === 409) {
+    if (isAPIError(err) && err.status === 409) {
       // project already exists, so we can
       // show a success message
     } else {
-      throw error;
+      throw err;
     }
   }
   const elapsed = ms(Date.now() - start);

packages/cli/src/commands/project/index.ts

@@ -72,18 +72,7 @@ export default async function main(client: Client) {
   subcommand = argv._[0] || 'list';
   const args = argv._.slice(1);
   const { output } = client;
-
+  const { contextName } = await getScope(client);
-  let contextName = '';
-
-  try {
-    ({ contextName } = await getScope(client));
-  } catch (error) {
-    if (error.code === 'NOT_AUTHORIZED' || error.code === 'TEAM_DELETED') {
-      output.error(error.message);
-      return 1;
-    }
-    throw error;
-  }
 
   switch (subcommand) {
     case 'ls':

packages/cli/src/commands/project/rm.ts

@@ -2,6 +2,7 @@ import chalk from 'chalk';
 import ms from 'ms';
 import Client from '../../util/client';
 import { emoji, prependEmoji } from '../../util/emoji';
+import { isAPIError } from '../../util/errors-ts';
 import confirm from '../../util/input/confirm';
 import { getCommandName } from '../../util/pkg-name';
 
@@ -32,8 +33,8 @@ export default async function rm(client: Client, args: string[]) {
     await client.fetch(`/v2/projects/${e(name)}`, {
       method: 'DELETE',
     });
-  } catch (err) {
+  } catch (err: unknown) {
-    if (err.status === 404) {
+    if (isAPIError(err) && err.status === 404) {
       client.output.error('No such project exists');
       return 1;
     }

packages/cli/src/commands/pull.ts

@@ -179,6 +179,8 @@ export default async function main(client: Client) {
     return pullResultCode;
   }
 
+  client.output.print('\n');
+  client.output.log('Downloading project settings');
   await writeProjectSettings(cwd, project, org);
 
   const settingsStamp = stamp();

packages/cli/src/commands/remove.ts

@@ -114,18 +114,7 @@ export default async function main(client: Client) {
     return 1;
   }
 
-  let contextName: string | null = null;
+  const { contextName } = await getScope(client);
-
-  try {
-    ({ contextName } = await getScope(client));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   output.spinner(
     `Fetching deployment(s) ${ids

packages/cli/src/commands/teams/add.ts

@@ -11,6 +11,7 @@ import { getPkgName, getCommandName } from '../../util/pkg-name';
 import Client from '../../util/client';
 import createTeam from '../../util/teams/create-team';
 import patchTeam from '../../util/teams/patch-team';
+import { errorToString, isError } from '../../util/is-error';
 
 const validateSlugKeypress = (data: string, value: string) =>
   // TODO: the `value` here should contain the current value + the keypress
@@ -56,8 +57,8 @@ export default async function add(client: Client): Promise<number> {
         valid: team,
         forceLowerCase: true,
       });
-    } catch (err) {
+    } catch (err: unknown) {
-      if (err.message === 'USER_ABORT') {
+      if (isError(err) && err.message === 'USER_ABORT') {
         output.log('Aborted');
         return 0;
       }
@@ -71,10 +72,10 @@ export default async function add(client: Client): Promise<number> {
     try {
       // eslint-disable-next-line no-await-in-loop
       team = await createTeam(client, { slug });
-    } catch (err) {
+    } catch (err: unknown) {
       output.stopSpinner();
       output.print(eraseLines(2));
-      output.error(err.message);
+      output.error(errorToString(err));
     }
   } while (!team);
 
@@ -92,8 +93,8 @@ export default async function add(client: Client): Promise<number> {
       label: `- ${teamNamePrefix}`,
       validateKeypress: validateNameKeypress,
     });
-  } catch (err) {
+  } catch (err: unknown) {
-    if (err.message === 'USER_ABORT') {
+    if (isError(err) && err.message === 'USER_ABORT') {
       console.log(info('No name specified'));
       return gracefulExit();
     }

packages/cli/src/commands/teams/invite.ts

@@ -11,6 +11,8 @@ import { getCommandName } from '../../util/pkg-name';
 import { email as regexEmail } from '../../util/input/regexes';
 import getTeams from '../../util/teams/get-teams';
 import inviteUserToTeam from '../../util/teams/invite-user-to-team';
+import { isAPIError } from '../../util/errors-ts';
+import { errorToString, isError } from '../../util/is-error';
 
 const validateEmail = (data: string) =>
   regexEmail.test(data.trim()) || data.length === 0;
@@ -67,17 +69,7 @@ export default async function invite(
   const currentTeam = teams.find(team => team.id === currentTeamId);
 
   output.spinner('Fetching user information');
-  let user;
+  const user = await getUser(client);
-  try {
-    user = await getUser(client);
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   domains.push(user.email.split('@')[1]);
 
@@ -107,8 +99,8 @@ export default async function invite(
           // eslint-disable-next-line no-await-in-loop
           const res = await inviteUserToTeam(client, currentTeam.id, email);
           userInfo = res.username;
-        } catch (err) {
+        } catch (err: unknown) {
-          if (err.code === 'user_not_found') {
+          if (isAPIError(err) && err.code === 'user_not_found') {
             output.error(`No user exists with the email address "${email}".`);
             return 1;
           }
@@ -141,8 +133,8 @@ export default async function invite(
         validateValue: validateEmail,
         autoComplete: value => emailAutoComplete(value, currentTeam.slug),
       });
-    } catch (err) {
+    } catch (err: unknown) {
-      if (err.message !== 'USER_ABORT') {
+      if (!isError(err) || err.message !== 'USER_ABORT') {
         throw err;
       }
     }
@@ -174,7 +166,7 @@ export default async function invite(
       } catch (err) {
         output.stopSpinner();
         process.stderr.write(eraseLines(emails.length + 2));
-        output.error(err.message);
+        output.error(errorToString(err));
         hasError = true;
         for (const email of emails) {
           output.log(`${chalk.cyan(chars.tick)} ${sentEmailPrefix}${email}`);

packages/cli/src/commands/teams/list.ts

@@ -43,17 +43,7 @@ export default async function list(client: Client): Promise<number> {
   const accountIsCurrent = !currentTeam;
 
   output.spinner('Fetching user information');
-  let user;
+  const user = await getUser(client);
-  try {
-    user = await getUser(client);
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   if (accountIsCurrent) {
     currentTeam = user.id;

packages/cli/src/commands/whoami.ts

@@ -41,18 +41,7 @@ export default async (client: Client): Promise<number> => {
     return 2;
   }
 
-  let contextName = null;
+  const { contextName } = await getScope(client, { getTeam: false });
-
-  try {
-    ({ contextName } = await getScope(client, { getTeam: false }));
-  } catch (err) {
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
-      output.error(err.message);
-      return 1;
-    }
-
-    throw err;
-  }
 
   if (client.stdout.isTTY) {
     output.log(contextName);

packages/cli/src/index.ts

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
+import { isErrnoException, isError, errorToString } from './util/is-error';
 
 try {
   // Test to see if cwd has been deleted before
   // importing 3rd party packages that might need cwd.
   process.cwd();
-} catch (e) {
+} catch (err) {
-  if (e && e.message && e.message.includes('uv_cwd')) {
+  if (isError(err) && err.message.includes('uv_cwd')) {
     console.error('Error! The current working directory does not exist.');
     process.exit(1);
   }
@@ -103,7 +104,7 @@ const main = async () => {
       },
       { permissive: true }
     );
-  } catch (err) {
+  } catch (err: unknown) {
     handleError(err);
     return 1;
   }
@@ -201,14 +202,11 @@ const main = async () => {
   // Ensure that the Vercel global configuration directory exists
   try {
     await mkdirp(VERCEL_DIR);
-  } catch (err) {
+  } catch (err: unknown) {
-    console.error(
+    output.error(
-      error(
+      `An unexpected error occurred while trying to create the global directory "${hp(
-        `${
+        VERCEL_DIR
-          'An unexpected error occurred while trying to create the ' +
+      )}" ${errorToString(err)}`
-          `global directory "${hp(VERCEL_DIR)}" `
-        }${err.message}`
-      )
     );
   }
 
@@ -217,13 +215,13 @@ const main = async () => {
 
   try {
     configExists = existsSync(VERCEL_CONFIG_PATH);
-  } catch (err) {
+  } catch (err: unknown) {
     console.error(
       error(
         `${
           'An unexpected error occurred while trying to find the ' +
           `config file "${hp(VERCEL_CONFIG_PATH)}" `
-        }${err.message}`
+        }${errorToString(err)}`
       )
     );
 
@@ -241,7 +239,7 @@ const main = async () => {
           `${
             'An unexpected error occurred while trying to read the ' +
             `config in "${hp(VERCEL_CONFIG_PATH)}" `
-          }${err.message}`
+          }${errorToString(err)}`
         )
       );
 
@@ -272,13 +270,13 @@ const main = async () => {
 
     try {
       configFiles.writeToConfigFile(config);
-    } catch (err) {
+    } catch (err: unknown) {
       console.error(
         error(
           `${
             'An unexpected error occurred while trying to write the ' +
             `default config to "${hp(VERCEL_CONFIG_PATH)}" `
-          }${err.message}`
+          }${errorToString(err)}`
         )
       );
 
@@ -290,13 +288,13 @@ const main = async () => {
 
   try {
     authConfigExists = existsSync(VERCEL_AUTH_CONFIG_PATH);
-  } catch (err) {
+  } catch (err: unknown) {
     console.error(
       error(
         `${
           'An unexpected error occurred while trying to find the ' +
           `auth file "${hp(VERCEL_AUTH_CONFIG_PATH)}" `
-        }${err.message}`
+        }${errorToString(err)}`
       )
     );
 
@@ -317,13 +315,13 @@ const main = async () => {
   if (authConfigExists) {
     try {
       authConfig = configFiles.readAuthConfigFile();
-    } catch (err) {
+    } catch (err: unknown) {
       console.error(
         error(
           `${
             'An unexpected error occurred while trying to read the ' +
             `auth config in "${hp(VERCEL_AUTH_CONFIG_PATH)}" `
-          }${err.message}`
+          }${errorToString(err)}`
         )
       );
 
@@ -345,13 +343,13 @@ const main = async () => {
 
     try {
       configFiles.writeToAuthConfigFile(authConfig);
-    } catch (err) {
+    } catch (err: unknown) {
       console.error(
         error(
           `${
             'An unexpected error occurred while trying to write the ' +
             `default config to "${hp(VERCEL_AUTH_CONFIG_PATH)}" `
-          }${err.message}`
+          }${errorToString(err)}`
         )
       );
       return 1;
@@ -543,8 +541,8 @@ const main = async () => {
 
     try {
       user = await getUser(client);
-    } catch (err) {
+    } catch (err: unknown) {
-      if (err.code === 'NOT_AUTHORIZED') {
+      if (isErrnoException(err) && err.code === 'NOT_AUTHORIZED') {
         output.prettyError({
           message: `You do not have access to the specified account`,
           link: 'https://err.sh/vercel/scope-not-accessible',
@@ -564,8 +562,8 @@ const main = async () => {
 
       try {
         teams = await getTeams(client);
-      } catch (err) {
+      } catch (err: unknown) {
-        if (err.code === 'not_authorized') {
+        if (isErrnoException(err) && err.code === 'not_authorized') {
           output.prettyError({
             message: `You do not have access to the specified team`,
             link: 'https://err.sh/vercel/scope-not-accessible',
@@ -594,8 +592,8 @@ const main = async () => {
     }
   }
 
-  const metric = metrics();
   let exitCode;
+  let metric: ReturnType<typeof metrics> | undefined;
   const eventCategory = 'Exit Code';
 
   try {
@@ -698,13 +696,14 @@ const main = async () => {
     if (shouldCollectMetrics) {
       const category = 'Command Invocation';
 
+      if (!metric) metric = metrics();
       metric
         .timing(category, targetCommand, end, pkg.version)
         .event(category, targetCommand, pkg.version)
         .send();
     }
-  } catch (err) {
+  } catch (err: unknown) {
-    if (err.code === 'ENOTFOUND') {
+    if (isErrnoException(err) && err.code === 'ENOTFOUND') {
       // Error message will look like the following:
       // "request to https://api.vercel.com/v2/user failed, reason: getaddrinfo ENOTFOUND api.vercel.com"
       const matches = /getaddrinfo ENOTFOUND (.*)$/.exec(err.message || '');
@@ -716,11 +715,16 @@ const main = async () => {
           )} could not be resolved. Please verify your internet connectivity and DNS configuration.`
         );
       }
-      output.debug(err.stack);
+      if (typeof err.stack === 'string') {
+        output.debug(err.stack);
+      }
       return 1;
     }
 
-    if (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED') {
+    if (
+      isErrnoException(err) &&
+      (err.code === 'NOT_AUTHORIZED' || err.code === 'TEAM_DELETED')
+    ) {
       output.prettyError(err);
       return 1;
     }
@@ -732,9 +736,10 @@ const main = async () => {
     }
 
     if (shouldCollectMetrics) {
+      if (!metric) metric = metrics();
       metric
         .event(eventCategory, '1', pkg.version)
-        .exception(err.message)
+        .exception(errorToString(err))
         .send();
     }
 
@@ -742,8 +747,10 @@ const main = async () => {
     // but instead show the message. Any error that is handled by this should
     // actually be handled in the sub command instead. Please make sure
     // that happens for anything that lands here. It should NOT bubble up to here.
-    if (err.code) {
+    if (isErrnoException(err)) {
-      output.debug(err.stack);
+      if (typeof err.stack === 'string') {
+        output.debug(err.stack);
+      }
       output.prettyError(err);
     } else {
       await reportError(Sentry, client, err);
@@ -757,6 +764,7 @@ const main = async () => {
   }
 
   if (shouldCollectMetrics) {
+    if (!metric) metric = metrics();
     metric.event(eventCategory, `${exitCode}`, pkg.version).send();
   }
 

packages/cli/src/types.ts

@@ -271,6 +271,12 @@ export interface ProjectLinkData {
 
 export interface Project extends ProjectSettings {
   id: string;
+  analytics?: {
+    id: string;
+    enabledAt?: number;
+    disabledAt?: number;
+    canceledAt?: number | null;
+  };
   name: string;
   accountId: string;
   updatedAt: number;

packages/cli/src/util/alias/create-alias.ts

@@ -68,37 +68,39 @@ async function performCreateAlias(
         body: { alias },
       }
     );
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.code === 'cert_missing' || error.code === 'cert_expired') {
+    if (ERRORS.isAPIError(err)) {
-      return new ERRORS.CertMissing(alias);
+      if (err.code === 'cert_missing' || err.code === 'cert_expired') {
-    }
+        return new ERRORS.CertMissing(alias);
-    if (error.status === 409) {
-      return { uid: error.uid, alias: error.alias } as AliasRecord;
-    }
-    if (error.code === 'deployment_not_found') {
-      return new ERRORS.DeploymentNotFound({
-        context: contextName,
-        id: deployment.uid,
-      });
-    }
-    if (error.code === 'gone') {
-      return new ERRORS.DeploymentFailedAliasImpossible();
-    }
-    if (error.code === 'invalid_alias') {
-      return new ERRORS.InvalidAlias(alias);
-    }
-    if (error.status === 403) {
-      if (error.code === 'alias_in_use') {
-        return new ERRORS.AliasInUse(alias);
       }
-      if (error.code === 'forbidden') {
+      if (err.status === 409) {
-        return new ERRORS.DomainPermissionDenied(alias, contextName);
+        return { uid: err.uid, alias: err.alias } as AliasRecord;
+      }
+      if (err.code === 'deployment_not_found') {
+        return new ERRORS.DeploymentNotFound({
+          context: contextName,
+          id: deployment.uid,
+        });
+      }
+      if (err.code === 'gone') {
+        return new ERRORS.DeploymentFailedAliasImpossible();
+      }
+      if (err.code === 'invalid_alias') {
+        return new ERRORS.InvalidAlias(alias);
+      }
+      if (err.status === 403) {
+        if (err.code === 'alias_in_use') {
+          return new ERRORS.AliasInUse(alias);
+        }
+        if (err.code === 'forbidden') {
+          return new ERRORS.DomainPermissionDenied(alias, contextName);
+        }
+      }
+      if (err.status === 400) {
+        return new ERRORS.DeploymentNotReady({ url: deployment.url });
       }
-    }
-    if (error.status === 400) {
-      return new ERRORS.DeploymentNotReady({ url: deployment.url });
     }
 
-    throw error;
+    throw err;
   }
 }

packages/cli/src/util/build/write-build-result.ts

@@ -23,31 +23,47 @@ import {
   download,
   EdgeFunction,
   BuildResultBuildOutput,
+  getLambdaOptionsFromFunction,
+  normalizePath,
 } from '@vercel/build-utils';
 import pipe from 'promisepipe';
 import { unzip } from './unzip';
 import { VERCEL_DIR } from '../projects/link';
+import { VercelConfig } from '@vercel/client';
 
 const { normalize } = posix;
 export const OUTPUT_DIR = join(VERCEL_DIR, 'output');
 
+/**
+ * An entry in the "functions" object in `vercel.json`.
+ */
+interface FunctionConfiguration {
+  memory?: number;
+  maxDuration?: number;
+}
+
 export async function writeBuildResult(
   outputDir: string,
   buildResult: BuildResultV2 | BuildResultV3,
   build: Builder,
   builder: BuilderV2 | BuilderV3,
   builderPkg: PackageJson,
-  cleanUrls?: boolean
+  vercelConfig: VercelConfig | null
 ) {
   const { version } = builder;
   if (typeof version !== 'number' || version === 2) {
     return writeBuildResultV2(
       outputDir,
       buildResult as BuildResultV2,
-      cleanUrls
+      vercelConfig
     );
   } else if (version === 3) {
-    return writeBuildResultV3(outputDir, buildResult as BuildResultV3, build);
+    return writeBuildResultV3(
+      outputDir,
+      buildResult as BuildResultV3,
+      build,
+      vercelConfig
+    );
   }
   throw new Error(
     `Unsupported Builder version \`${version}\` from "${builderPkg.name}"`
@@ -90,7 +106,7 @@ function stripDuplicateSlashes(path: string): string {
 async function writeBuildResultV2(
   outputDir: string,
   buildResult: BuildResultV2,
-  cleanUrls?: boolean
+  vercelConfig: VercelConfig | null
 ) {
   if ('buildOutputPath' in buildResult) {
     await mergeBuilderOutput(outputDir, buildResult);
@@ -102,9 +118,15 @@ async function writeBuildResultV2(
   for (const [path, output] of Object.entries(buildResult.output)) {
     const normalizedPath = stripDuplicateSlashes(path);
     if (isLambda(output)) {
-      await writeLambda(outputDir, output, normalizedPath, lambdas);
+      await writeLambda(outputDir, output, normalizedPath, undefined, lambdas);
     } else if (isPrerender(output)) {
-      await writeLambda(outputDir, output.lambda, normalizedPath, lambdas);
+      await writeLambda(
+        outputDir,
+        output.lambda,
+        normalizedPath,
+        undefined,
+        lambdas
+      );
 
       // Write the fallback file alongside the Lambda directory
       let fallback = output.fallback;
@@ -140,7 +162,7 @@ async function writeBuildResultV2(
         output,
         normalizedPath,
         overrides,
-        cleanUrls
+        vercelConfig?.cleanUrls
       );
     } else if (isEdgeFunction(output)) {
       await writeEdgeFunction(outputDir, output, normalizedPath);
@@ -162,19 +184,28 @@ async function writeBuildResultV2(
 async function writeBuildResultV3(
   outputDir: string,
   buildResult: BuildResultV3,
-  build: Builder
+  build: Builder,
+  vercelConfig: VercelConfig | null
 ) {
   const { output } = buildResult;
   const src = build.src;
   if (typeof src !== 'string') {
     throw new Error(`Expected "build.src" to be a string`);
   }
+
+  const functionConfiguration = vercelConfig
+    ? await getLambdaOptionsFromFunction({
+        sourceFile: src,
+        config: vercelConfig,
+      })
+    : {};
+
   const ext = extname(src);
   const path = stripDuplicateSlashes(
     build.config?.zeroConfig ? src.substring(0, src.length - ext.length) : src
   );
   if (isLambda(output)) {
-    await writeLambda(outputDir, output, path);
+    await writeLambda(outputDir, output, path, functionConfiguration);
   } else if (isEdgeFunction(output)) {
     await writeEdgeFunction(outputDir, output, path);
   } else {
@@ -260,6 +291,7 @@ async function writeEdgeFunction(
   const config = {
     runtime: 'edge',
     ...edgeFunction,
+    entrypoint: normalizePath(edgeFunction.entrypoint),
     files: undefined,
     type: undefined,
   };
@@ -283,6 +315,7 @@ async function writeLambda(
   outputDir: string,
   lambda: Lambda,
   path: string,
+  functionConfiguration?: FunctionConfiguration,
   lambdas?: Map<Lambda, string>
 ) {
   const dest = join(outputDir, 'functions', `${path}.func`);
@@ -317,8 +350,14 @@ async function writeLambda(
     throw new Error('Malformed `Lambda` - no "files" present');
   }
 
+  const memory = functionConfiguration?.memory ?? lambda.memory;
+  const maxDuration = functionConfiguration?.maxDuration ?? lambda.maxDuration;
+
   const config = {
     ...lambda,
+    handler: normalizePath(lambda.handler),
+    memory,
+    maxDuration,
     type: undefined,
     files: undefined,
     zipBuffer: undefined,

packages/cli/src/util/certs/create-cert-for-cns.ts

@@ -15,17 +15,19 @@ export default async function createCertForCns(
   try {
     const certificate = await issueCert(client, cns);
     return certificate;
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.code === 'forbidden') {
+    if (ERRORS.isAPIError(err)) {
-      return new ERRORS.DomainPermissionDenied(error.domain, context);
+      if (err.code === 'forbidden') {
+        return new ERRORS.DomainPermissionDenied(err.domain, context);
+      }
+
+      const mappedError = mapCertError(err, cns);
+      if (mappedError) {
+        return mappedError;
+      }
     }
 
-    const mappedError = mapCertError(error, cns);
+    throw err;
-    if (mappedError) {
-      return mappedError;
-    }
-
-    throw error;
   } finally {
     output.stopSpinner();
   }

packages/cli/src/util/certs/create-cert-from-file.ts

@@ -2,6 +2,8 @@ import { readFileSync } from 'fs';
 import { resolve } from 'path';
 import Client from '../client';
 import { Cert } from '../../types';
+import { isErrnoException } from '../is-error';
+import { isAPIError } from '../errors-ts';
 
 export default async function createCertFromFile(
   client: Client,
@@ -25,15 +27,15 @@ export default async function createCertFromFile(
       },
     });
     return certificate;
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.code === 'ENOENT') {
+    if (isErrnoException(err) && err.code === 'ENOENT') {
-      return new Error(`The specified file "${error.path}" doesn't exist.`);
+      return new Error(`The specified file "${err.path}" doesn't exist.`);
     }
 
-    if (error.status < 500) {
+    if (isAPIError(err) && err.status < 500) {
-      return error;
+      return err;
     }
 
-    throw error;
+    throw err;
   }
 }

packages/cli/src/util/certs/finish-cert-order.ts

@@ -22,16 +22,18 @@ export default async function startCertOrder(
       },
     });
     return cert;
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.code === 'cert_order_not_found') {
+    if (ERRORS.isAPIError(err)) {
-      return new ERRORS.CertOrderNotFound(cns);
+      if (err.code === 'cert_order_not_found') {
+        return new ERRORS.CertOrderNotFound(cns);
+      }
+
+      const mappedError = mapCertError(err, cns);
+      if (mappedError) {
+        return mappedError;
+      }
     }
 
-    const mappedError = mapCertError(error, cns);
+    throw err;
-    if (mappedError) {
-      return mappedError;
-    }
-
-    throw error;
   }
 }

packages/cli/src/util/certs/get-cert-by-id.ts

@@ -5,10 +5,10 @@ import * as ERRORS from '../errors-ts';
 export default async function getCertById(client: Client, id: string) {
   try {
     return await client.fetch<Cert>(`/v6/now/certs/${id}`);
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.code === 'cert_not_found') {
+    if (ERRORS.isAPIError(err) && err.code === 'cert_not_found') {
       return new ERRORS.CertNotFound(id);
     }
-    throw error;
+    throw err;
   }
 }

packages/cli/src/util/certs/get-custom-certs-for-domain.ts

@@ -17,10 +17,10 @@ export async function getCustomCertsForDomain(
       `/v5/now/certs?${stringify({ domain, custom: true })}`
     );
     return certs;
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.code === 'forbidden') {
+    if (ERRORS.isAPIError(err) && err.code === 'forbidden') {
       return new ERRORS.CertsPermissionDenied(context, domain);
     }
-    throw error;
+    throw err;
   }
 }

packages/cli/src/util/certs/issue-cert.ts

@@ -1,6 +1,8 @@
 import retry from 'async-retry';
 import { Cert } from '../../types';
 import Client from '../client';
+import { isAPIError } from '../errors-ts';
+import { isError } from '../is-error';
 
 // When it's a configuration error we should retry because of the DNS propagation
 // otherwise we bail to handle the error in the upper level
@@ -10,13 +12,15 @@ export default async function issueCert(client: Client, cns: string[]) {
       try {
         return await client.fetch<Cert>('/v3/now/certs', {
           method: 'POST',
-          body: { domains: cns }
+          body: { domains: cns },
         });
-      } catch (error) {
+      } catch (err: unknown) {
-        if (error.code === 'configuration_error') {
+        if (isAPIError(err) && err.code === 'configuration_error') {
-          throw error;
+          throw err;
+        } else if (isError(err)) {
+          bail(err);
         } else {
-          bail(error);
+          throw err;
         }
       }
     },

packages/cli/src/util/certs/map-cert-error.ts

@@ -1,9 +1,11 @@
 import * as ERRORS from '../errors-ts';
 
-export default function mapCertError(error: any, cns?: string[]) {
+export default function mapCertError(error: ERRORS.APIError, cns?: string[]) {
   const errorCode: string = error.code;
   if (errorCode === 'too_many_requests') {
-    return new ERRORS.TooManyRequests('certificates', error.retryAfter);
+    const retryAfter =
+      typeof error.retryAfter === 'number' ? error.retryAfter : 0;
+    return new ERRORS.TooManyRequests('certificates', retryAfter);
   }
   if (errorCode === 'not_found') {
     return new ERRORS.DomainNotFound(error.domain);

packages/cli/src/util/config/files.ts

@@ -10,6 +10,7 @@ import error from '../output/error';
 import highlight from '../output/highlight';
 import { VercelConfig } from '../dev/types';
 import { AuthConfig, GlobalConfig } from '../../types';
+import { isErrnoException, isError } from '../is-error';
 
 const VERCEL_DIR = getGlobalPathConfig();
 const CONFIG_FILE_PATH = join(VERCEL_DIR, 'config.json');
@@ -25,25 +26,27 @@ export const readConfigFile = (): GlobalConfig => {
 export const writeToConfigFile = (stuff: GlobalConfig): void => {
   try {
     return writeJSON.sync(CONFIG_FILE_PATH, stuff, { indent: 2 });
-  } catch (err) {
+  } catch (err: unknown) {
-    if (err.code === 'EPERM') {
+    if (isErrnoException(err)) {
-      console.error(
+      if (isErrnoException(err) && err.code === 'EPERM') {
-        error(
+        console.error(
-          `Not able to create ${highlight(
+          error(
-            CONFIG_FILE_PATH
+            `Not able to create ${highlight(
-          )} (operation not permitted).`
+              CONFIG_FILE_PATH
-        )
+            )} (operation not permitted).`
-      );
+          )
-      process.exit(1);
+        );
-    } else if (err.code === 'EBADF') {
+        process.exit(1);
-      console.error(
+      } else if (err.code === 'EBADF') {
-        error(
+        console.error(
-          `Not able to create ${highlight(
+          error(
-            CONFIG_FILE_PATH
+            `Not able to create ${highlight(
-          )} (bad file descriptor).`
+              CONFIG_FILE_PATH
-        )
+            )} (bad file descriptor).`
-      );
+          )
-      process.exit(1);
+        );
+        process.exit(1);
+      }
     }
 
     throw err;
@@ -65,25 +68,27 @@ export const writeToAuthConfigFile = (authConfig: AuthConfig) => {
       indent: 2,
       mode: 0o600,
     });
-  } catch (err) {
+  } catch (err: unknown) {
-    if (err.code === 'EPERM') {
+    if (isErrnoException(err)) {
-      console.error(
+      if (err.code === 'EPERM') {
-        error(
+        console.error(
-          `Not able to create ${highlight(
+          error(
-            AUTH_CONFIG_FILE_PATH
+            `Not able to create ${highlight(
-          )} (operation not permitted).`
+              AUTH_CONFIG_FILE_PATH
-        )
+            )} (operation not permitted).`
-      );
+          )
-      process.exit(1);
+        );
-    } else if (err.code === 'EBADF') {
+        process.exit(1);
-      console.error(
+      } else if (err.code === 'EBADF') {
-        error(
+        console.error(
-          `Not able to create ${highlight(
+          error(
-            AUTH_CONFIG_FILE_PATH
+            `Not able to create ${highlight(
-          )} (bad file descriptor).`
+              AUTH_CONFIG_FILE_PATH
-        )
+            )} (bad file descriptor).`
-      );
+          )
-      process.exit(1);
+        );
+        process.exit(1);
+      }
     }
 
     throw err;
@@ -123,12 +128,14 @@ export function readLocalConfig(
     if (existsSync(target)) {
       config = loadJSON.sync(target);
     }
-  } catch (err) {
+  } catch (err: unknown) {
-    if (err.name === 'JSONError') {
+    if (isError(err) && err.name === 'JSONError') {
       console.error(error(err.message));
-    } else {
+    } else if (isErrnoException(err)) {
       const code = err.code ? ` (${err.code})` : '';
       console.error(error(`Failed to read config file: ${target}${code}`));
+    } else {
+      console.error(err);
     }
     process.exit(1);
   }

packages/cli/src/util/create-git-meta.ts

@@ -5,6 +5,7 @@ import git from 'git-last-commit';
 import { exec } from 'child_process';
 import { GitMetadata, Project } from '../types';
 import { Output } from './output';
+import { errorToString } from './is-error';
 
 export async function createGitMeta(
   directory: string,
@@ -93,8 +94,8 @@ export function isDirty(directory: string, output: Output): Promise<boolean> {
 export async function parseGitConfig(configPath: string, output: Output) {
   try {
     return ini.parse(await fs.readFile(configPath, 'utf-8'));
-  } catch (error) {
+  } catch (err: unknown) {
-    output.debug(`Error while parsing repo data: ${error.message}`);
+    output.debug(`Error while parsing repo data: ${errorToString(err)}`);
   }
 }
 

packages/cli/src/util/deploy/create-deploy.ts

@@ -20,103 +20,105 @@ export default async function createDeploy(
 ): Promise<any | DeploymentError> {
   try {
     return await now.create(paths, createArgs, org, isSettingUpProject, cwd);
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.code === 'rate_limited') {
+    if (ERRORS_TS.isAPIError(err)) {
-      throw new ERRORS_TS.DeploymentsRateLimited(error.message);
+      if (err.code === 'rate_limited') {
-    }
+        throw new ERRORS_TS.DeploymentsRateLimited(err.message);
-
-    // Means that the domain used as a suffix no longer exists
-    if (error.code === 'domain_missing') {
-      throw new ERRORS_TS.DomainNotFound(error.value);
-    }
-
-    if (error.code === 'domain_not_found' && error.domain) {
-      throw new ERRORS_TS.DomainNotFound(error.domain);
-    }
-
-    // This error occures when a domain used in the `alias`
-    // is not yet verified
-    if (error.code === 'domain_not_verified' && error.domain) {
-      throw new ERRORS_TS.DomainNotVerified(error.domain);
-    }
-
-    // If the domain used as a suffix is not verified, we fail
-    if (error.code === 'domain_not_verified' && error.value) {
-      throw new ERRORS_TS.DomainVerificationFailed(error.value);
-    }
-
-    // If the domain isn't owned by the user
-    if (error.code === 'not_domain_owner') {
-      throw new ERRORS_TS.NotDomainOwner(error.message);
-    }
-
-    if (error.code === 'builds_rate_limited') {
-      throw new ERRORS_TS.BuildsRateLimited(error.message);
-    }
-
-    // If the user doesn't have permissions over the domain used as a suffix we fail
-    if (error.code === 'forbidden') {
-      throw new ERRORS_TS.DomainPermissionDenied(error.value, contextName);
-    }
-
-    if (error.code === 'bad_request' && error.keyword) {
-      throw new ERRORS.SchemaValidationFailed(
-        error.message,
-        error.keyword,
-        error.dataPath,
-        error.params
-      );
-    }
-
-    if (error.code === 'domain_configured') {
-      throw new ERRORS_TS.AliasDomainConfigured(error);
-    }
-
-    if (error.code === 'missing_build_script') {
-      throw new ERRORS_TS.MissingBuildScript(error);
-    }
-
-    if (error.code === 'conflicting_file_path') {
-      throw new ERRORS_TS.ConflictingFilePath(error);
-    }
-
-    if (error.code === 'conflicting_path_segment') {
-      throw new ERRORS_TS.ConflictingPathSegment(error);
-    }
-
-    // If the cert is missing we try to generate a new one and the retry
-    if (error.code === 'cert_missing') {
-      const result = await generateCertForDeploy(
-        client,
-        contextName,
-        error.value
-      );
-
-      if (result instanceof NowError) {
-        return result;
       }
 
-      return createDeploy(
+      // Means that the domain used as a suffix no longer exists
-        client,
+      if (err.code === 'domain_missing') {
-        now,
+        throw new ERRORS_TS.DomainNotFound(err.value);
-        contextName,
+      }
-        paths,
-        createArgs,
-        org,
-        isSettingUpProject
-      );
-    }
 
-    if (error.code === 'not_found') {
+      if (err.code === 'domain_not_found' && err.domain) {
-      throw new ERRORS_TS.DeploymentNotFound({ context: contextName });
+        throw new ERRORS_TS.DomainNotFound(err.domain);
-    }
+      }
 
-    const certError = mapCertError(error);
+      // This error occures when a domain used in the `alias`
-    if (certError) {
+      // is not yet verified
-      return certError;
+      if (err.code === 'domain_not_verified' && err.domain) {
+        throw new ERRORS_TS.DomainNotVerified(err.domain);
+      }
+
+      // If the domain used as a suffix is not verified, we fail
+      if (err.code === 'domain_not_verified' && err.value) {
+        throw new ERRORS_TS.DomainVerificationFailed(err.value);
+      }
+
+      // If the domain isn't owned by the user
+      if (err.code === 'not_domain_owner') {
+        throw new ERRORS_TS.NotDomainOwner(err.message);
+      }
+
+      if (err.code === 'builds_rate_limited') {
+        throw new ERRORS_TS.BuildsRateLimited(err.message);
+      }
+
+      // If the user doesn't have permissions over the domain used as a suffix we fail
+      if (err.code === 'forbidden') {
+        throw new ERRORS_TS.DomainPermissionDenied(err.value, contextName);
+      }
+
+      if (err.code === 'bad_request' && err.keyword) {
+        throw new ERRORS.SchemaValidationFailed(
+          err.message,
+          err.keyword,
+          err.dataPath,
+          err.params
+        );
+      }
+
+      if (err.code === 'domain_configured') {
+        throw new ERRORS_TS.AliasDomainConfigured(err);
+      }
+
+      if (err.code === 'missing_build_script') {
+        throw new ERRORS_TS.MissingBuildScript(err);
+      }
+
+      if (err.code === 'conflicting_file_path') {
+        throw new ERRORS_TS.ConflictingFilePath(err);
+      }
+
+      if (err.code === 'conflicting_path_segment') {
+        throw new ERRORS_TS.ConflictingPathSegment(err);
+      }
+
+      // If the cert is missing we try to generate a new one and the retry
+      if (err.code === 'cert_missing') {
+        const result = await generateCertForDeploy(
+          client,
+          contextName,
+          err.value
+        );
+
+        if (result instanceof NowError) {
+          return result;
+        }
+
+        return createDeploy(
+          client,
+          now,
+          contextName,
+          paths,
+          createArgs,
+          org,
+          isSettingUpProject
+        );
+      }
+
+      if (err.code === 'not_found') {
+        throw new ERRORS_TS.DeploymentNotFound({ context: contextName });
+      }
+
+      const certError = mapCertError(err);
+      if (certError) {
+        return certError;
+      }
     }
 
     // If the error is unknown, we just throw
-    throw error;
+    throw err;
   }
 }

packages/cli/src/util/deploy/get-deployment-by-id-or-host.ts

@@ -5,6 +5,7 @@ import {
   DeploymentNotFound,
   DeploymentPermissionDenied,
   InvalidDeploymentId,
+  isAPIError,
 } from '../errors-ts';
 import mapCertError from '../certs/map-cert-error';
 
@@ -26,23 +27,25 @@ export default async function getDeploymentByIdOrHost(
           )
         : await getDeploymentById(client, idOrHost, apiVersion);
     return deployment;
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.status === 404) {
+    if (isAPIError(err)) {
-      return new DeploymentNotFound({ id: idOrHost, context: contextName });
+      if (err.status === 404) {
-    }
+        return new DeploymentNotFound({ id: idOrHost, context: contextName });
-    if (error.status === 403) {
+      }
-      return new DeploymentPermissionDenied(idOrHost, contextName);
+      if (err.status === 403) {
-    }
+        return new DeploymentPermissionDenied(idOrHost, contextName);
-    if (error.status === 400 && error.message.includes('`id`')) {
+      }
-      return new InvalidDeploymentId(idOrHost);
+      if (err.status === 400 && err.message.includes('`id`')) {
+        return new InvalidDeploymentId(idOrHost);
+      }
+
+      const certError = mapCertError(err);
+      if (certError) {
+        return certError;
+      }
     }
 
-    const certError = mapCertError(error);
+    throw err;
-    if (certError) {
-      return certError;
-    }
-
-    throw error;
   }
 }
 

packages/cli/src/util/deploy/get-prebuilt-json.ts

@@ -1,7 +1,10 @@
 import fs from 'fs-extra';
 import { join } from 'path';
+import { BuildsManifest } from '../../commands/build';
 
-export default async function getPrebuiltJson(directory: string) {
+export default async function getPrebuiltJson(
+  directory: string
+): Promise<BuildsManifest | null> {
   try {
     return await fs.readJSON(join(directory, '.vercel/output/builds.json'));
   } catch (error) {

packages/cli/src/util/dev/builder-cache.ts

@@ -15,6 +15,7 @@ import { NoBuilderCacheError } from '../errors-ts';
 
 import * as staticBuilder from './static-builder';
 import { BuilderWithPackage } from './types';
+import { isErrnoException } from '../is-error';
 
 const require_: typeof require = eval('require');
 
@@ -60,8 +61,8 @@ export async function prepareBuilderDir() {
   try {
     const buildersPkg = join(builderDir, 'package.json');
     await writeJSON(buildersPkg, { private: true }, { flag: 'wx' });
-  } catch (err) {
+  } catch (err: unknown) {
-    if (err.code !== 'EEXIST') {
+    if (!isErrnoException(err) || err.code !== 'EEXIST') {
       throw err;
     }
   }
@@ -331,8 +332,12 @@ export async function getBuilder(
         builder: Object.freeze(mod),
         package: Object.freeze(pkg),
       };
-    } catch (err) {
+    } catch (err: unknown) {
-      if (err.code === 'MODULE_NOT_FOUND' && !isRetry) {
+      if (
+        isErrnoException(err) &&
+        err.code === 'MODULE_NOT_FOUND' &&
+        !isRetry
+      ) {
         output.debug(
           `Attempted to require ${requirePath}, but it is not installed`
         );

packages/cli/src/util/dev/server.ts

@@ -94,6 +94,12 @@ import { ProjectEnvVariable, ProjectSettings } from '../../types';
 import exposeSystemEnvs from './expose-system-envs';
 import { treeKill } from '../tree-kill';
 import { nodeHeadersToFetchHeaders } from './headers';
+import {
+  errorToString,
+  isErrnoException,
+  isError,
+  isSpawnError,
+} from '../is-error';
 
 const frontendRuntimeSet = new Set(
   frameworkList.map(f => f.useRuntime?.use || '@vercel/static-build')
@@ -340,8 +346,8 @@ export default class DevServer {
       }
       fileChanged(name, changed, removed);
       this.output.debug(`File created: ${name}`);
-    } catch (err) {
+    } catch (err: unknown) {
-      if (err.code === 'ENOENT') {
+      if (isErrnoException(err) && err.code === 'ENOENT') {
         this.output.debug(`File created, but has since been deleted: ${name}`);
         fileRemoved(name, this.files, changed, removed);
       } else {
@@ -375,8 +381,8 @@ export default class DevServer {
       this.files[name] = await FileFsRef.fromFsPath({ fsPath });
       fileChanged(name, changed, removed);
       this.output.debug(`File modified: ${name}`);
-    } catch (err) {
+    } catch (err: unknown) {
-      if (err.code === 'ENOENT') {
+      if (isErrnoException(err) && err.code === 'ENOENT') {
         this.output.debug(`File modified, but has since been deleted: ${name}`);
         fileRemoved(name, this.files, changed, removed);
       } else {
@@ -507,8 +513,8 @@ export default class DevServer {
       this.output.debug(`Using local env: ${filePath}`);
       env = parseDotenv(dotenv);
       env = this.injectSystemValuesInDotenv(env);
-    } catch (err) {
+    } catch (err: unknown) {
-      if (err.code !== 'ENOENT') {
+      if (!isErrnoException(err) || err.code !== 'ENOENT') {
         throw err;
       }
     }
@@ -719,13 +725,15 @@ export default class DevServer {
       const parsed: WithFileNameSymbol<T> = JSON.parse(raw);
       parsed[fileNameSymbol] = rel;
       return parsed;
-    } catch (err) {
+    } catch (err: unknown) {
-      if (err.code === 'ENOENT') {
+      if (isError(err)) {
-        this.output.debug(`No \`${rel}\` file present`);
+        if (isErrnoException(err) && err.code === 'ENOENT') {
-      } else if (err.name === 'SyntaxError') {
+          this.output.debug(`No \`${rel}\` file present`);
-        this.output.warn(
+        } else if (err.name === 'SyntaxError') {
-          `There is a syntax error in the \`${rel}\` file: ${err.message}`
+          this.output.warn(
-        );
+            `There is a syntax error in the \`${rel}\` file: ${err.message}`
+          );
+        }
       } else {
         throw err;
       }
@@ -851,22 +859,26 @@ export default class DevServer {
     while (typeof address !== 'string') {
       try {
         address = await listen(this.server, ...listenSpec);
-      } catch (err) {
+      } catch (err: unknown) {
-        this.output.debug(`Got listen error: ${err.code}`);
+        if (isErrnoException(err)) {
-        if (err.code === 'EADDRINUSE') {
+          this.output.debug(`Got listen error: ${err.code}`);
-          if (typeof listenSpec[0] === 'number') {
+          if (err.code === 'EADDRINUSE') {
-            // Increase port and try again
+            if (typeof listenSpec[0] === 'number') {
-            this.output.note(
+              // Increase port and try again
-              `Requested port ${chalk.yellow(
+              this.output.note(
-                String(listenSpec[0])
+                `Requested port ${chalk.yellow(
-              )} is already in use`
+                  String(listenSpec[0])
-            );
+                )} is already in use`
-            listenSpec[0]++;
+              );
-          } else {
+              listenSpec[0]++;
-            this.output.error(
+            } else {
-              `Requested socket ${chalk.cyan(listenSpec[0])} is already in use`
+              this.output.error(
-            );
+                `Requested socket ${chalk.cyan(
-            process.exit(1);
+                  listenSpec[0]
+                )} is already in use`
+              );
+              process.exit(1);
+            }
           }
         } else {
           throw err;
@@ -1028,12 +1040,8 @@ export default class DevServer {
 
     try {
       await Promise.all(ops);
-    } catch (err) {
+    } catch (err: unknown) {
-      // Node 8 doesn't have a code for that error
+      if (isErrnoException(err) && err.code === 'ERR_SERVER_NOT_RUNNING') {
-      if (
-        err.code === 'ERR_SERVER_NOT_RUNNING' ||
-        err.message === 'Not running'
-      ) {
         process.exit(exitCode || 0);
       } else {
         throw err;
@@ -1303,13 +1311,16 @@ export default class DevServer {
     try {
       const vercelConfig = await this.getVercelConfig();
       await this.serveProjectAsNowV2(req, res, requestId, vercelConfig);
-    } catch (err) {
+    } catch (err: unknown) {
       console.error(err);
-      this.output.debug(err.stack);
+
+      if (isError(err) && typeof err.stack === 'string') {
+        this.output.debug(err.stack);
+      }
 
       if (!res.finished) {
         res.statusCode = 500;
-        res.end(err.message);
+        res.end(errorToString(err));
       }
     }
   };
@@ -1533,16 +1544,16 @@ export default class DevServer {
             );
           }
         }
-      } catch (err) {
+      } catch (err: unknown) {
         // `startDevServer()` threw an error. Most likely this means the dev
         // server process exited before sending the port information message
         // (missing dependency at runtime, for example).
-        if (err.code === 'ENOENT') {
+        if (isSpawnError(err) && err.code === 'ENOENT') {
           err.message = `Command not found: ${chalk.cyan(
             err.path,
             ...err.spawnargs
-          )}\nPlease ensure that ${cmd(err.path)} is properly installed`;
+          )}\nPlease ensure that ${cmd(err.path!)} is properly installed`;
-          err.link = 'https://vercel.link/command-not-found';
+          (err as any).link = 'https://vercel.link/command-not-found';
         }
 
         await this.sendError(
@@ -1845,16 +1856,16 @@ export default class DevServer {
             buildEnv: { ...envConfigs.buildEnv },
           },
         });
-      } catch (err) {
+      } catch (err: unknown) {
         // `startDevServer()` threw an error. Most likely this means the dev
         // server process exited before sending the port information message
         // (missing dependency at runtime, for example).
-        if (err.code === 'ENOENT') {
+        if (isSpawnError(err) && err.code === 'ENOENT') {
           err.message = `Command not found: ${chalk.cyan(
             err.path,
             ...err.spawnargs
-          )}\nPlease ensure that ${cmd(err.path)} is properly installed`;
+          )}\nPlease ensure that ${cmd(err.path!)} is properly installed`;
-          err.link = 'https://vercel.link/command-not-found';
+          (err as any).link = 'https://vercel.link/command-not-found';
         }
 
         this.output.prettyError(err);

packages/cli/src/util/dns/add-dns-record.ts

@@ -5,6 +5,7 @@ import {
   DNSInvalidPort,
   DNSInvalidType,
   DNSConflictingRecord,
+  isAPIError,
 } from '../errors-ts';
 import { DNSRecordData } from '../../types';
 
@@ -26,32 +27,34 @@ export default async function addDNSRecord(
       }
     );
     return record;
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.status === 400 && error.code === 'invalid_type') {
+    if (isAPIError(err)) {
-      return new DNSInvalidType(recordData.type);
+      if (err.status === 400 && err.code === 'invalid_type') {
+        return new DNSInvalidType(recordData.type);
+      }
+
+      if (err.status === 400 && err.message.includes('port')) {
+        return new DNSInvalidPort();
+      }
+
+      if (err.status === 400) {
+        return err;
+      }
+
+      if (err.status === 403) {
+        return new DNSPermissionDenied(domain);
+      }
+
+      if (err.status === 404) {
+        return new DomainNotFound(domain);
+      }
+
+      if (err.status === 409) {
+        const { oldId = '' } = err;
+        return new DNSConflictingRecord(oldId);
+      }
     }
 
-    if (error.status === 400 && error.message.includes('port')) {
+    throw err;
-      return new DNSInvalidPort();
-    }
-
-    if (error.status === 400) {
-      return error;
-    }
-
-    if (error.status === 403) {
-      return new DNSPermissionDenied(domain);
-    }
-
-    if (error.status === 404) {
-      return new DomainNotFound(domain);
-    }
-
-    if (error.status === 409) {
-      const { oldId = '' } = error;
-      return new DNSConflictingRecord(oldId);
-    }
-
-    throw error;
   }
 }

packages/cli/src/util/dns/get-domain-dns-records.ts

@@ -1,5 +1,5 @@
 import { DNSRecord, PaginationOptions } from '../../types';
-import { DomainNotFound } from '../errors-ts';
+import { DomainNotFound, isAPIError } from '../errors-ts';
 import { Output } from '../output';
 import Client from '../client';
 
@@ -27,10 +27,10 @@ export default async function getDomainDNSRecords(
 
     const data = await client.fetch<Response>(url);
     return data;
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.code === 'not_found') {
+    if (isAPIError(err) && err.code === 'not_found') {
       return new DomainNotFound(domain);
     }
-    throw error;
+    throw err;
   }
 }

packages/cli/src/util/dns/import-zonefile.ts

@@ -2,7 +2,7 @@ import chalk from 'chalk';
 import { readFileSync } from 'fs';
 import { resolve } from 'path';
 import { Response } from 'node-fetch';
-import { DomainNotFound, InvalidDomain } from '../errors-ts';
+import { DomainNotFound, InvalidDomain, isAPIError } from '../errors-ts';
 import Client from '../client';
 
 type JSONResponse = {
@@ -33,15 +33,17 @@ export default async function importZonefile(
 
     const { recordIds } = (await res.json()) as JSONResponse;
     return recordIds;
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.code === 'not_found') {
+    if (isAPIError(err)) {
-      return new DomainNotFound(domain, contextName);
+      if (err.code === 'not_found') {
+        return new DomainNotFound(domain, contextName);
+      }
+
+      if (err.code === 'invalid_domain') {
+        return new InvalidDomain(domain);
+      }
     }
 
-    if (error.code === 'invalid_domain') {
+    throw err;
-      return new InvalidDomain(domain);
-    }
-
-    throw error;
   }
 }

packages/cli/src/util/domains/add-domain.ts

@@ -1,6 +1,6 @@
 import chalk from 'chalk';
 import retry from 'async-retry';
-import { DomainAlreadyExists, InvalidDomain } from '../errors-ts';
+import { DomainAlreadyExists, InvalidDomain, isAPIError } from '../errors-ts';
 import { Domain } from '../../types';
 import Client from '../client';
 
@@ -29,16 +29,18 @@ async function performAddRequest(client: Client, domainName: string) {
           method: 'POST',
         });
         return domain;
-      } catch (error) {
+      } catch (err: unknown) {
-        if (error.code === 'invalid_name') {
+        if (isAPIError(err)) {
-          return new InvalidDomain(domainName);
+          if (err.code === 'invalid_name') {
+            return new InvalidDomain(domainName);
+          }
+
+          if (err.code === 'domain_already_exists') {
+            return new DomainAlreadyExists(domainName);
+          }
         }
 
-        if (error.code === 'domain_already_exists') {
+        throw err;
-          return new DomainAlreadyExists(domainName);
-        }
-
-        throw error;
       }
     },
     { retries: 5, maxTimeout: 8000 }

packages/cli/src/util/domains/get-domain-by-name.ts

@@ -1,7 +1,11 @@
 import chalk from 'chalk';
 import Client from '../client';
 import { Domain } from '../../types';
-import { DomainPermissionDenied, DomainNotFound } from '../errors-ts';
+import {
+  DomainPermissionDenied,
+  DomainNotFound,
+  isAPIError,
+} from '../errors-ts';
 
 type Response = {
   domain: Domain;
@@ -25,15 +29,17 @@ export default async function getDomainByName(
       `/v4/domains/${encodeURIComponent(domainName)}`
     );
     return domain;
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.status === 404) {
+    if (isAPIError(err)) {
-      return new DomainNotFound(domainName, contextName);
+      if (err.status === 404) {
+        return new DomainNotFound(domainName, contextName);
+      }
+
+      if (err.status === 403) {
+        return new DomainPermissionDenied(domainName, contextName);
+      }
     }
 
-    if (error.status === 403) {
+    throw err;
-      return new DomainPermissionDenied(domainName, contextName);
-    }
-
-    throw error;
   }
 }

packages/cli/src/util/domains/get-domain-config.ts

@@ -1,5 +1,6 @@
 import Client from '../client';
 import { DomainConfig } from '../../types';
+import { isAPIError } from '../errors-ts';
 
 export async function getDomainConfig(client: Client, domainName: string) {
   try {
@@ -8,11 +9,11 @@ export async function getDomainConfig(client: Client, domainName: string) {
     );
 
     return config;
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.status < 500) {
+    if (isAPIError(err) && err.status < 500) {
-      return error;
+      return err;
     }
 
-    throw error;
+    throw err;
   }
 }

packages/cli/src/util/domains/get-domain-price.ts

@@ -1,5 +1,5 @@
 import { stringify } from 'querystring';
-import { UnsupportedTLD } from '../errors-ts';
+import { isAPIError, UnsupportedTLD } from '../errors-ts';
 import Client from '../client';
 
 type Response = {
@@ -15,15 +15,17 @@ export default async function getDomainPrice(
   try {
     const querystr = type ? stringify({ name, type }) : stringify({ name });
     return await client.fetch<Response>(`/v3/domains/price?${querystr}`);
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.code === 'unsupported_tld') {
+    if (isAPIError(err)) {
-      return new UnsupportedTLD(name);
+      if (err.code === 'unsupported_tld') {
+        return new UnsupportedTLD(name);
+      }
+
+      if (err.status < 500) {
+        return err;
+      }
     }
 
-    if (error.status < 500) {
+    throw err;
-      return error;
-    }
-
-    throw error;
   }
 }

packages/cli/src/util/domains/get-domain.ts

@@ -1,6 +1,7 @@
 import chalk from 'chalk';
 import Client from '../client';
 import { Domain } from '../../types';
+import { isAPIError } from '../errors-ts';
 
 type Response = {
   domain: Domain;
@@ -20,11 +21,11 @@ export async function getDomain(
     );
 
     return domain;
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.status < 500) {
+    if (isAPIError(err) && err.status < 500) {
-      return error;
+      return err;
     }
 
-    throw error;
+    throw err;
   }
 }

packages/cli/src/util/domains/move-out-domain.ts

@@ -20,25 +20,27 @@ export default async function moveOutDomain(
         method: 'PATCH',
       }
     );
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.code === 'forbidden') {
+    if (ERRORS.isAPIError(err)) {
-      return new ERRORS.DomainPermissionDenied(name, contextName);
+      if (err.code === 'forbidden') {
+        return new ERRORS.DomainPermissionDenied(name, contextName);
+      }
+      if (err.code === 'not_found') {
+        return new ERRORS.DomainNotFound(name);
+      }
+      if (err.code === 'invalid_move_destination') {
+        return new ERRORS.InvalidMoveDestination(destination);
+      }
+      if (err.code === 'domain_move_conflict') {
+        const { pendingAsyncPurchase, resolvable, suffix, message } = err;
+        return new ERRORS.DomainMoveConflict({
+          message,
+          pendingAsyncPurchase,
+          resolvable,
+          suffix,
+        });
+      }
     }
-    if (error.code === 'not_found') {
+    throw err;
-      return new ERRORS.DomainNotFound(name);
-    }
-    if (error.code === 'invalid_move_destination') {
-      return new ERRORS.InvalidMoveDestination(destination);
-    }
-    if (error.code === 'domain_move_conflict') {
-      const { pendingAsyncPurchase, resolvable, suffix, message } = error;
-      return new ERRORS.DomainMoveConflict({
-        message,
-        pendingAsyncPurchase,
-        resolvable,
-        suffix,
-      });
-    }
-    throw error;
   }
 }

packages/cli/src/util/domains/purchase-domain.ts

@@ -20,28 +20,30 @@ export default async function purchaseDomain(
       body: { name, expectedPrice, renew },
       method: 'POST',
     });
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.code === 'invalid_domain') {
+    if (ERRORS.isAPIError(err)) {
-      return new ERRORS.InvalidDomain(name);
+      if (err.code === 'invalid_domain') {
+        return new ERRORS.InvalidDomain(name);
+      }
+      if (err.code === 'not_available') {
+        return new ERRORS.DomainNotAvailable(name);
+      }
+      if (err.code === 'service_unavailabe') {
+        return new ERRORS.DomainServiceNotAvailable(name);
+      }
+      if (err.code === 'unexpected_error') {
+        return new ERRORS.UnexpectedDomainPurchaseError(name);
+      }
+      if (err.code === 'source_not_found') {
+        return new ERRORS.SourceNotFound();
+      }
+      if (err.code === 'payment_error') {
+        return new ERRORS.DomainPaymentError();
+      }
+      if (err.code === 'unsupported_tld') {
+        return new ERRORS.UnsupportedTLD(name);
+      }
     }
-    if (error.code === 'not_available') {
+    throw err;
-      return new ERRORS.DomainNotAvailable(name);
-    }
-    if (error.code === 'service_unavailabe') {
-      return new ERRORS.DomainServiceNotAvailable(name);
-    }
-    if (error.code === 'unexpected_error') {
-      return new ERRORS.UnexpectedDomainPurchaseError(name);
-    }
-    if (error.code === 'source_not_found') {
-      return new ERRORS.SourceNotFound();
-    }
-    if (error.code === 'payment_error') {
-      return new ERRORS.DomainPaymentError();
-    }
-    if (error.code === 'unsupported_tld') {
-      return new ERRORS.UnsupportedTLD(name);
-    }
-    throw error;
   }
 }

packages/cli/src/util/domains/remove-domain-by-name.ts

@@ -10,24 +10,26 @@ export default async function removeDomainByName(
     return await now.fetch(`/v3/domains/${encodeURIComponent(domain)}`, {
       method: 'DELETE',
     });
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.code === 'not_found') {
+    if (ERRORS.isAPIError(err)) {
-      return new ERRORS.DomainNotFound(domain);
+      if (err.code === 'not_found') {
+        return new ERRORS.DomainNotFound(domain);
+      }
+      if (err.code === 'forbidden') {
+        return new ERRORS.DomainPermissionDenied(domain, contextName);
+      }
+      if (err.code === 'domain_removal_conflict') {
+        return new ERRORS.DomainRemovalConflict({
+          aliases: err.aliases,
+          certs: err.certs,
+          message: err.message,
+          pendingAsyncPurchase: err.pendingAsyncPurchase,
+          resolvable: err.resolvable,
+          suffix: err.suffix,
+          transferring: err.transferring,
+        });
+      }
     }
-    if (error.code === 'forbidden') {
+    throw err;
-      return new ERRORS.DomainPermissionDenied(domain, contextName);
-    }
-    if (error.code === 'domain_removal_conflict') {
-      return new ERRORS.DomainRemovalConflict({
-        aliases: error.aliases,
-        certs: error.certs,
-        message: error.message,
-        pendingAsyncPurchase: error.pendingAsyncPurchase,
-        resolvable: error.resolvable,
-        suffix: error.suffix,
-        transferring: error.transferring,
-      });
-    }
-    throw error;
   }
 }

packages/cli/src/util/domains/set-custom-suffix.ts

@@ -14,25 +14,27 @@ export default async function setCustomSuffix(
         suffix,
       },
     });
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.code === 'forbidden') {
+    if (ERRORS.isAPIError(err)) {
-      return new ERRORS.DomainPermissionDenied(domain, contextName);
+      if (err.code === 'forbidden') {
+        return new ERRORS.DomainPermissionDenied(domain, contextName);
+      }
+      if (err.code === 'domain_external') {
+        return new ERRORS.DomainExternal(domain);
+      }
+      if (err.code === 'domain_invalid') {
+        return new ERRORS.InvalidDomain(domain);
+      }
+      if (err.code === 'domain_not_found') {
+        return new ERRORS.DomainNotFound(domain);
+      }
+      if (err.code === 'domain_not_verified') {
+        return new ERRORS.DomainNotVerified(domain);
+      }
+      if (err.code === 'domain_permission_denied') {
+        return new ERRORS.DomainPermissionDenied(domain, contextName);
+      }
     }
-    if (error.code === 'domain_external') {
+    throw err;
-      return new ERRORS.DomainExternal(domain);
-    }
-    if (error.code === 'domain_invalid') {
-      return new ERRORS.InvalidDomain(domain);
-    }
-    if (error.code === 'domain_not_found') {
-      return new ERRORS.DomainNotFound(domain);
-    }
-    if (error.code === 'domain_not_verified') {
-      return new ERRORS.DomainNotVerified(domain);
-    }
-    if (error.code === 'domain_permission_denied') {
-      return new ERRORS.DomainPermissionDenied(domain, contextName);
-    }
-    throw error;
   }
 }

packages/cli/src/util/domains/transfer-in-domain.ts

@@ -17,25 +17,27 @@ export default async function transferInDomain(
       body: { method: 'transfer-in', name, authCode, expectedPrice },
       method: 'POST',
     });
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.code === 'invalid_name') {
+    if (ERRORS.isAPIError(err)) {
-      return new ERRORS.InvalidDomain(name);
+      if (err.code === 'invalid_name') {
+        return new ERRORS.InvalidDomain(name);
+      }
+      if (err.code === 'domain_already_exists') {
+        return new ERRORS.DomainNotAvailable(name);
+      }
+      if (err.code === 'not_transferable') {
+        return new ERRORS.DomainNotTransferable(name);
+      }
+      if (err.code === 'invalid_auth_code') {
+        return new ERRORS.InvalidTransferAuthCode(name, authCode);
+      }
+      if (err.code === 'source_not_found') {
+        return new ERRORS.SourceNotFound();
+      }
+      if (err.code === 'registration_failed') {
+        return new ERRORS.DomainRegistrationFailed(name, err.message);
+      }
     }
-    if (error.code === 'domain_already_exists') {
+    throw err;
-      return new ERRORS.DomainNotAvailable(name);
-    }
-    if (error.code === 'not_transferable') {
-      return new ERRORS.DomainNotTransferable(name);
-    }
-    if (error.code === 'invalid_auth_code') {
-      return new ERRORS.InvalidTransferAuthCode(name, authCode);
-    }
-    if (error.code === 'source_not_found') {
-      return new ERRORS.SourceNotFound();
-    }
-    if (error.code === 'registration_failed') {
-      return new ERRORS.DomainRegistrationFailed(name, error.message);
-    }
-    throw error;
   }
 }

packages/cli/src/util/env/add-env-record.ts

@@ -29,6 +29,6 @@ export default async function addEnvRecord(
   const url = `/v8/projects/${projectId}/env`;
   await client.fetch(url, {
     method: 'POST',
-    body: JSON.stringify(body),
+    body,
   });
 }

packages/cli/src/util/env/diff-env-files.ts

@@ -0,0 +1,80 @@
+import { Output } from '../output';
+import { Dictionary } from '@vercel/client';
+import { readFile } from 'fs-extra';
+import { parseEnv } from '../parse-env';
+import chalk from 'chalk';
+
+export async function createEnvObject(
+  envPath: string,
+  output: Output
+): Promise<Dictionary<string | undefined> | undefined> {
+  // Originally authored by Tyler Waters under MIT License: https://github.com/tswaters/env-file-parser/blob/f17c009b39da599380e069ee72728d1cafdb56b8/lib/parse.js
+  // https://github.com/tswaters/env-file-parser/blob/f17c009b39da599380e069ee72728d1cafdb56b8/LICENSE
+  const envArr = (await readFile(envPath, 'utf-8'))
+    // remove double quotes
+    .replace(/"/g, '')
+    // split on new line
+    .split(/\r?\n|\r/)
+    // filter comments
+    .filter(line => /^[^#]/.test(line))
+    // needs equal sign
+    .filter(line => /=/i.test(line));
+
+  const parsedEnv = parseEnv(envArr);
+  if (Object.keys(parsedEnv).length === 0) {
+    output.debug('Failed to parse env file.');
+    return;
+  }
+  return parsedEnv;
+}
+
+function findChanges(
+  oldEnv: Dictionary<string | undefined>,
+  newEnv: Dictionary<string | undefined>
+): {
+  added: string[];
+  changed: string[];
+  removed: string[];
+} {
+  const added = [];
+  const changed = [];
+
+  for (const key of Object.keys(newEnv)) {
+    if (oldEnv[key] === undefined) {
+      added.push(key);
+    } else if (oldEnv[key] !== newEnv[key]) {
+      changed.push(key);
+    }
+    delete oldEnv[key];
+  }
+  const removed = Object.keys(oldEnv);
+
+  return {
+    added,
+    changed,
+    removed,
+  };
+}
+
+export function buildDeltaString(
+  oldEnv: Dictionary<string | undefined>,
+  newEnv: Dictionary<string | undefined>
+): string {
+  const { added, changed, removed } = findChanges(oldEnv, newEnv);
+
+  let deltaString = '';
+  deltaString += chalk.green(addDeltaSection('+', added));
+  deltaString += chalk.yellow(addDeltaSection('~', changed));
+  deltaString += chalk.red(addDeltaSection('-', removed));
+
+  return deltaString ? chalk.gray('Changes:\n') + deltaString : deltaString;
+}
+
+function addDeltaSection(prefix: string, arr: string[]): string {
+  return (
+    arr
+      .sort()
+      .map(item => `${prefix} ${item}`)
+      .join('\n') + '\n'
+  );
+}

packages/cli/src/util/env/known-error.ts

@@ -1,3 +1,5 @@
+import { isErrnoException } from '../is-error';
+
 const knownErrorsCodes = new Set([
   'PAYMENT_REQUIRED',
   'BAD_REQUEST',
@@ -7,7 +9,8 @@ const knownErrorsCodes = new Set([
   'ENV_SHOULD_BE_A_SECRET',
 ]);
 
-export function isKnownError(error: { code?: string }) {
+export function isKnownError(error: unknown) {
-  const code = error && typeof error.code === 'string' ? error.code : '';
+  const code = isErrnoException(error) ? error.code : null;
+  if (!code) return false;
   return knownErrorsCodes.has(code.toUpperCase());
 }

packages/cli/src/util/errors-ts.ts

@@ -5,6 +5,7 @@ import { NowError } from './now-error';
 import code from './output/code';
 import { getCommandName } from './pkg-name';
 import chalk from 'chalk';
+import { isError } from './is-error';
 
 /**
  * This error is thrown when there is an API error with a payload. The error
@@ -45,6 +46,10 @@ export class APIError extends Error {
   }
 }
 
+export function isAPIError(v: unknown): v is APIError {
+  return isError(v) && 'status' in v;
+}
+
 /**
  * When you're fetching information for the current team but the client can't
  * retrieve information. This means that the team was probably deleted or the

packages/cli/src/util/events.ts

@@ -81,21 +81,21 @@ async function printEvents(
                     return;
                   }
                   poller = startPoller();
-                } catch (error) {
+                } catch (err: unknown) {
                   stream.end();
-                  finish(error);
+                  finish(err);
                 }
               }, 5000);
             })();
           }
 
           let finishCalled = false;
-          function finish(error?: Error) {
+          function finish(err?: unknown) {
             if (finishCalled) return;
             finishCalled = true;
             clearTimeout(poller);
-            if (error) {
+            if (err) {
-              reject(error);
+              reject(err);
             } else {
               resolve();
             }

packages/cli/src/util/get-config.ts

@@ -10,6 +10,7 @@ import humanizePath from './humanize-path';
 import readJSONFile from './read-json-file';
 import { VercelConfig } from './dev/types';
 import { Output } from './output';
+import { isErrnoException } from './is-error';
 
 let config: VercelConfig;
 
@@ -25,8 +26,8 @@ export default async function getConfig(
   let localPath: string;
   try {
     localPath = process.cwd();
-  } catch (err) {
+  } catch (err: unknown) {
-    if (err.code === 'ENOENT') {
+    if (isErrnoException(err) && err.code === 'ENOENT') {
       return new WorkingDirectoryDoesNotExist();
     }
     throw err;

packages/cli/src/util/get-decrypted-env-records.ts

@@ -7,6 +7,7 @@ import {
   Secret,
 } from '../types';
 import getEnvRecords, { EnvRecordsSource } from './env/get-env-records';
+import { isAPIError } from './errors-ts';
 
 export default async function getDecryptedEnvRecords(
   output: Output,
@@ -39,12 +40,12 @@ export default async function getDecryptedEnvRecords(
           );
 
           return { id, type, key, value: secret.value, found: true };
-        } catch (error) {
+        } catch (err: unknown) {
-          if (error && error.status === 404) {
+          if (isAPIError(err) && err.status === 404) {
             return { id, type, key, value: '', found: false };
           }
 
-          throw error;
+          throw err;
         }
       }
 

packages/cli/src/util/handle-error.ts

@@ -4,10 +4,7 @@ import errorOutput from './output/error';
 import { APIError } from './errors-ts';
 import { getCommandName } from './pkg-name';
 
-export default function handleError(
+export default function handleError(error: unknown, { debug = false } = {}) {
-  error: string | Error | APIError,
-  { debug = false } = {}
-) {
   // Coerce Strings to Error instances
   if (typeof error === 'string') {
     error = new Error(error);

packages/cli/src/util/is-error.ts

@@ -0,0 +1,82 @@
+export interface SpawnError extends NodeJS.ErrnoException {
+  spawnargs: string[];
+}
+
+/**
+ * A simple type guard for objects.
+ *
+ * @param obj - A possible object
+ */
+export const isObject = (obj: unknown): obj is Record<string, unknown> =>
+  typeof obj === 'object' && obj !== null;
+
+/**
+ * A type guard for `try...catch` errors.
+ *
+ * This function is based on:
+ * https://github.com/stdlib-js/assert-is-error
+ */
+export const isError = (error: unknown): error is Error => {
+  if (!isObject(error)) return false;
+
+  // Check for `Error` objects instantiated within the current global context.
+  if (error instanceof Error) return true;
+
+  // Walk the prototype tree until we find a matching object.
+  while (error) {
+    if (Object.prototype.toString.call(error) === '[object Error]') return true;
+    // eslint-disable-next-line no-param-reassign -- TODO: Fix eslint error following @vercel/style-guide migration
+    error = Object.getPrototypeOf(error);
+  }
+
+  return false;
+};
+
+export const isErrnoException = (
+  error: unknown
+): error is NodeJS.ErrnoException => {
+  return isError(error) && 'code' in error;
+};
+
+interface ErrorLike {
+  message: string;
+  name?: string;
+  stack?: string;
+}
+
+/**
+ * A type guard for error-like objects.
+ */
+export const isErrorLike = (error: unknown): error is ErrorLike =>
+  isObject(error) && 'message' in error;
+
+/**
+ * Parses errors to string, useful for getting the error message in a
+ * `try...catch` statement.
+ */
+export const errorToString = (error: unknown, fallback?: string): string => {
+  if (isError(error) || isErrorLike(error)) return error.message;
+
+  if (typeof error === 'string') return error;
+
+  return fallback ?? 'An unknown error has ocurred.';
+};
+
+/**
+ * Normalizes unknown errors to the Error type, useful for working with errors
+ * in a `try...catch` statement.
+ */
+export const normalizeError = (error: unknown): Error => {
+  if (isError(error)) return error;
+
+  const errorMessage = errorToString(error);
+
+  // Copy over additional properties if the object is error-like.
+  return isErrorLike(error)
+    ? Object.assign(new Error(errorMessage), error)
+    : new Error(errorMessage);
+};
+
+export function isSpawnError(v: unknown): v is SpawnError {
+  return isErrnoException(v) && 'spawnargs' in v;
+}

packages/cli/src/util/link/setup-and-link.ts

@@ -27,6 +27,7 @@ import stamp from '../output/stamp';
 import { EmojiLabel } from '../emoji';
 import createDeploy from '../deploy/create-deploy';
 import Now, { CreateOptions } from '../index';
+import { isAPIError } from '../errors-ts';
 
 export interface SetupAndLinkOptions {
   forceDelete?: boolean;
@@ -96,15 +97,17 @@ export default async function setupAndLink(
       'Which scope should contain your project?',
       autoConfirm
     );
-  } catch (err) {
+  } catch (err: unknown) {
-    if (err.code === 'NOT_AUTHORIZED') {
+    if (isAPIError(err)) {
-      output.prettyError(err);
+      if (err.code === 'NOT_AUTHORIZED') {
-      return { status: 'error', exitCode: 1, reason: 'NOT_AUTHORIZED' };
+        output.prettyError(err);
-    }
+        return { status: 'error', exitCode: 1, reason: 'NOT_AUTHORIZED' };
+      }
 
-    if (err.code === 'TEAM_DELETED') {
+      if (err.code === 'TEAM_DELETED') {
-      output.prettyError(err);
+        output.prettyError(err);
-      return { status: 'error', exitCode: 1, reason: 'TEAM_DELETED' };
+        return { status: 'error', exitCode: 1, reason: 'TEAM_DELETED' };
+      }
     }
 
     throw err;

packages/cli/src/util/login/email.ts

@@ -6,6 +6,8 @@ import verify from './verify';
 import executeLogin from './login';
 import Client from '../client';
 import { LoginResult } from './types';
+import { isAPIError } from '../errors-ts';
+import { errorToString } from '../is-error';
 
 export default async function doEmailLogin(
   client: Client,
@@ -22,8 +24,8 @@ export default async function doEmailLogin(
     const data = await executeLogin(client, email);
     verificationToken = data.token;
     securityCode = data.securityCode;
-  } catch (err) {
+  } catch (err: unknown) {
-    output.error(err.message);
+    output.error(errorToString(err));
     return 1;
   }
 
@@ -51,9 +53,9 @@ export default async function doEmailLogin(
         'Email',
         ssoUserId
       );
-    } catch (err) {
+    } catch (err: unknown) {
-      if (err.serverMessage !== 'Confirmation incomplete') {
+      if (!isAPIError(err) || err.serverMessage !== 'Confirmation incomplete') {
-        output.error(err.message);
+        output.error(errorToString(err));
         return 1;
       }
     }

packages/cli/src/util/login/login.ts

@@ -1,5 +1,6 @@
 import Client from '../client';
-import { InvalidEmail, AccountNotFound } from '../errors-ts';
+import { InvalidEmail, AccountNotFound, isAPIError } from '../errors-ts';
+import { errorToString } from '../is-error';
 import { LoginData } from './types';
 
 export default async function login(
@@ -11,18 +12,20 @@ export default async function login(
       method: 'POST',
       body: { email },
     });
-  } catch (err) {
+  } catch (err: unknown) {
-    if (err.code === 'not_exists') {
+    if (isAPIError(err)) {
-      throw new AccountNotFound(
+      if (err.code === 'not_exists') {
-        email,
+        throw new AccountNotFound(
-        `Please sign up: https://vercel.com/signup`
+          email,
-      );
+          `Please sign up: https://vercel.com/signup`
+        );
+      }
+
+      if (err.code === 'invalid_email') {
+        throw new InvalidEmail(email, err.message);
+      }
     }
 
-    if (err.code === 'invalid_email') {
+    throw new Error(`Unexpected error: ${errorToString(err)}`);
-      throw new InvalidEmail(email, err.message);
-    }
-
-    throw new Error(`Unexpected error: ${err.message}`);
   }
 }

packages/cli/src/util/login/prompt.ts

@@ -68,7 +68,7 @@ export async function readInput(
         message,
       });
       input = val;
-    } catch (err) {
+    } catch (err: any) {
       console.log(); // \n
 
       if (err.isTtyError) {

packages/cli/src/util/output/builds.ts

@@ -1,5 +1,4 @@
 import chalk from 'chalk';
-import title from 'title';
 import bytes from 'bytes';
 import { isReady, isFailed } from '../build-state';
 import { Build, BuildOutput } from '../../types';
@@ -8,9 +7,6 @@ export interface Times {
   [id: string]: string | null;
 }
 
-// That's how long the word "Initializing" is
-const longestState = 12;
-
 // That's the spacing between the source, state and time
 const padding = 8;
 
@@ -18,8 +14,6 @@ const padding = 8;
 const MAX_BUILD_GROUPS = 5;
 const MAX_OUTPUTS_PER_GROUP = 5;
 
-const prepareState = (state: string) => title(state.replace('_', ' '));
-
 const hasOutput = (b: Build) => Array.isArray(b.output) && b.output.length > 0;
 
 // Get the common path out of multiple builds
@@ -47,24 +41,19 @@ const getCommonPath = (buildGroup: Build[]) => {
 };
 
 const styleBuild = (build: Build, times: Times, longestSource: number) => {
-  const { entrypoint, readyState, id } = build;
+  const { entrypoint, id } = build;
-  const state = prepareState(readyState).padEnd(longestState + padding);
   const time = typeof times[id] === 'string' ? times[id] : '';
 
-  let stateColor = chalk.grey;
   let pathColor = chalk.cyan;
 
-  if (isReady(build)) {
+  if (isFailed(build)) {
-    stateColor = chalk;
-  } else if (isFailed(build)) {
-    stateColor = chalk.red;
     pathColor = chalk.red;
   }
 
   const entry = entrypoint.padEnd(longestSource + padding);
   const prefix = hasOutput(build) ? '┌' : '╶';
 
-  return `${chalk.grey(prefix)} ${pathColor(entry)}${stateColor(state)}${time}`;
+  return `${chalk.grey(prefix)} ${pathColor(entry)}${time}`;
 };
 
 const styleHiddenBuilds = (
@@ -79,43 +68,9 @@ const styleHiddenBuilds = (
   const time = typeof times[id] === 'string' ? times[id] : '';
   const prefix = isHidden === false && buildGroup.some(hasOutput) ? '┌' : '╶';
 
-  // Set the defaults so that they will be sorted
-  const stateMap: { [readyState: string]: number } = {
-    READY: 0,
-    ERROR: 0,
-    BUILDING: 0,
-  };
-
-  for (const { readyState } of buildGroup) {
-    stateMap[readyState]++;
-  }
-
-  let state = Object.keys(stateMap)
-    .map(readyState => {
-      const counter = stateMap[readyState];
-      const name = prepareState(readyState);
-
-      if (!counter) {
-        return null;
-      }
-
-      return `${counter > 9 ? '9+' : counter} ${name}`;
-    })
-    .filter(s => s)
-    .join(', ');
-
-  // Since the longestState might still be shorter
-  // than multiple states we still want to ensure
-  // a space between the states and the time
-  state = `${state} `.padEnd(longestState + padding);
-
   let pathColor = chalk.cyan;
-  let stateColor = chalk.grey;
 
-  if (buildGroup.every(isReady)) {
+  if (buildGroup.every(isFailed)) {
-    stateColor = chalk;
-  } else if (buildGroup.every(isFailed)) {
-    stateColor = chalk.red;
     pathColor = chalk.red;
   }
 
@@ -123,7 +78,7 @@ const styleHiddenBuilds = (
     pathColor = chalk.grey;
   }
 
-  return `${chalk.grey(prefix)} ${pathColor(entry)}${stateColor(state)}${time}`;
+  return `${chalk.grey(prefix)} ${pathColor(entry)}${time}`;
 };
 
 const styleOutput = (

packages/cli/src/util/output/create-output.ts

@@ -2,6 +2,7 @@ import chalk from 'chalk';
 import renderLink from './link';
 import wait, { StopSpinner } from './wait';
 import type { WritableTTY } from '../../types';
+import { errorToString } from '../is-error';
 
 export interface OutputOptions {
   debug?: boolean;
@@ -79,10 +80,13 @@ export class Output {
     }
   };
 
-  prettyError = (
+  prettyError = (err: unknown) => {
-    err: Pick<Error, 'message'> & { link?: string; action?: string }
+    return this.error(
-  ) => {
+      errorToString(err),
-    return this.error(err.message, undefined, err.link, err.action);
+      undefined,
+      (err as any).link,
+      (err as any).action
+    );
   };
 
   ready = (str: string) => {

packages/cli/src/util/output/error.ts

@@ -3,7 +3,7 @@ import { metrics, shouldCollectMetrics } from '../metrics';
 import { APIError } from '../errors-ts';
 import renderLink from './link';
 
-const metric = metrics();
+let metric: ReturnType<typeof metrics>;
 
 export default function error(
   ...input: string[] | [Pick<APIError, 'slug' | 'message' | 'link' | 'action'>]
@@ -19,6 +19,7 @@ export default function error(
   }
 
   if (shouldCollectMetrics) {
+    if (!metric) metric = metrics();
     metric.exception(messages.join('\n')).send();
   }
 

packages/cli/src/util/parse-env.ts

@@ -0,0 +1,34 @@
+import type { Dictionary } from '@vercel/client';
+
+// Converts `env` Arrays, Strings and Objects into env Objects.
+export const parseEnv = (env?: string | string[] | Dictionary<string>) => {
+  if (!env) {
+    return {};
+  }
+
+  if (typeof env === 'string') {
+    // a single `--env` arg comes in as a String
+    env = [env];
+  }
+
+  if (Array.isArray(env)) {
+    return env.reduce((o, e) => {
+      let key;
+      let value;
+      const equalsSign = e.indexOf('=');
+
+      if (equalsSign === -1) {
+        key = e;
+      } else {
+        key = e.slice(0, equalsSign);
+        value = e.slice(equalsSign + 1);
+      }
+
+      o[key] = value;
+      return o;
+    }, {} as Dictionary<string | undefined>);
+  }
+
+  // assume it's already an Object
+  return env;
+};

packages/cli/src/util/projects/add-domain-to-project.ts

@@ -1,6 +1,7 @@
 import chalk from 'chalk';
 import Client from '../client';
 import { ProjectAliasTarget } from '../../types';
+import { isAPIError } from '../errors-ts';
 
 export async function addDomainToProject(
   client: Client,
@@ -33,8 +34,8 @@ export async function addDomainToProject(
     }
 
     return aliasTarget;
-  } catch (err) {
+  } catch (err: unknown) {
-    if (err.status < 500) {
+    if (isAPIError(err) && err.status < 500) {
       return err;
     }
 

packages/cli/src/util/projects/connect-git-provider.ts

@@ -3,6 +3,7 @@ import { stringify } from 'qs';
 import { Org } from '../../types';
 import chalk from 'chalk';
 import link from '../output/link';
+import { isAPIError } from '../errors-ts';
 
 export async function disconnectGitProvider(
   client: Client,
@@ -41,21 +42,23 @@ export async function connectGitProvider(
         repo,
       }),
     });
-  } catch (err) {
+  } catch (err: unknown) {
-    if (
+    if (isAPIError(err)) {
-      err.meta?.action === 'Install GitHub App' ||
+      if (
-      err.code === 'repo_not_found'
+        err.meta?.action === 'Install GitHub App' ||
-    ) {
+        err.code === 'repo_not_found'
-      client.output.error(
+      ) {
-        `Failed to link ${chalk.cyan(
+        client.output.error(
-          repo
+          `Failed to link ${chalk.cyan(
-        )}. Make sure there aren't any typos and that you have access to the repository if it's private.`
+            repo
-      );
+          )}. Make sure there aren't any typos and that you have access to the repository if it's private.`
-    } else if (err.action === 'Add a Login Connection') {
+        );
-      client.output.error(
+      } else if (err.action === 'Add a Login Connection') {
-        err.message.replace(repo, chalk.cyan(repo)) +
+        client.output.error(
-          `\nVisit ${link(err.link)} for more information.`
+          err.message.replace(repo, chalk.cyan(repo)) +
-      );
+            `\nVisit ${link(err.link)} for more information.`
+        );
+      }
     } else {
       client.output.error(
         `Failed to connect the ${formatProvider(

packages/cli/src/util/projects/find-projects-for-domain.ts

@@ -1,6 +1,7 @@
 import Client from '../client';
 import { Project } from '../../types';
 import { URLSearchParams } from 'url';
+import { isAPIError } from '../errors-ts';
 
 export async function findProjectsForDomain(
   client: Client,
@@ -29,8 +30,8 @@ export async function findProjectsForDomain(
     }
 
     return result;
-  } catch (err) {
+  } catch (err: unknown) {
-    if (err.status < 500) {
+    if (isAPIError(err) && err.status < 500) {
       return err;
     }
 

packages/cli/src/util/projects/get-project-by-id-or-name.ts

@@ -1,6 +1,6 @@
 import Client from '../client';
 import { Project } from '../../types';
-import { ProjectNotFound } from '../errors-ts';
+import { isAPIError, ProjectNotFound } from '../errors-ts';
 
 export default async function getProjectByNameOrId(
   client: Client,
@@ -13,11 +13,11 @@ export default async function getProjectByNameOrId(
       { accountId }
     );
     return project;
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.status === 404) {
+    if (isAPIError(err) && err.status === 404) {
       return new ProjectNotFound(projectNameOrId);
     }
 
-    throw error;
+    throw err;
   }
 }

packages/cli/src/util/projects/link.ts

@@ -8,7 +8,7 @@ import { promisify } from 'util';
 
 import getProjectByIdOrName from '../projects/get-project-by-id-or-name';
 import Client from '../client';
-import { InvalidToken, ProjectNotFound } from '../errors-ts';
+import { InvalidToken, isAPIError, ProjectNotFound } from '../errors-ts';
 import getUser from '../get-user';
 import getTeamById from '../teams/get-team-by-id';
 import { Output } from '../output';
@@ -18,6 +18,7 @@ import { prependEmoji, emoji, EmojiLabel } from '../emoji';
 import { isDirectory } from '../config/global-path';
 import { NowBuildError, getPlatformEnv } from '@vercel/build-utils';
 import outputCode from '../output/code';
+import { isErrnoException, isError } from '../is-error';
 
 const readFile = promisify(fs.readFile);
 const writeFile = promisify(fs.writeFile);
@@ -83,20 +84,24 @@ export async function getLinkFromDir<T = ProjectLink>(
     }
 
     return link;
-  } catch (error) {
+  } catch (err: unknown) {
     // link file does not exists, project is not linked
-    if (['ENOENT', 'ENOTDIR'].includes(error.code)) {
+    if (
+      isErrnoException(err) &&
+      err.code &&
+      ['ENOENT', 'ENOTDIR'].includes(err.code)
+    ) {
       return null;
     }
 
     // link file can't be read
-    if (error.name === 'SyntaxError') {
+    if (isError(err) && err.name === 'SyntaxError') {
       throw new Error(
         `Project Settings could not be retrieved. To link your project again, remove the ${dir} directory.`
       );
     }
 
-    throw error;
+    throw err;
   }
 }
 
@@ -149,8 +154,8 @@ export async function getLinkedProject(
       getOrgById(client, link.orgId),
       getProjectByIdOrName(client, link.projectId, link.orgId),
     ]);
-  } catch (err) {
+  } catch (err: unknown) {
-    if (err && err.status === 403) {
+    if (isAPIError(err) && err.status === 403) {
       output.stopSpinner();
 
       if (err.missingToken) {
@@ -224,13 +229,13 @@ export async function linkFolderToProject(
 
   try {
     await ensureDir(join(path, VERCEL_DIR));
-  } catch (error) {
+  } catch (err: unknown) {
-    if (error.code === 'ENOTDIR') {
+    if (isErrnoException(err) && err.code === 'ENOTDIR') {
       // folder couldn't be created because
       // we're deploying a static file
       return;
     }
-    throw error;
+    throw err;
   }
 
   await writeFile(

packages/cli/src/util/projects/project-settings.ts

@@ -14,6 +14,7 @@ export type ProjectLinkAndSettings = ProjectLink & {
     rootDirectory: Project['rootDirectory'];
     framework: Project['framework'];
     nodeVersion: Project['nodeVersion'];
+    analyticsId?: string;
   };
 };
 
@@ -38,6 +39,7 @@ export async function writeProjectSettings(
       rootDirectory: project.rootDirectory,
       directoryListing: project.directoryListing,
       nodeVersion: project.nodeVersion,
+      analyticsId: project.analytics?.id,
     },
   };
   const path = join(cwd, VERCEL_DIR, VERCEL_DIR_PROJECT);

packages/cli/src/util/projects/remove-domain-from-project.ts

@@ -1,6 +1,7 @@
 import chalk from 'chalk';
 import Client from '../client';
 import { ProjectAliasTarget } from '../../types';
+import { isAPIError } from '../errors-ts';
 
 export async function removeDomainFromProject(
   client: Client,
@@ -21,8 +22,8 @@ export async function removeDomainFromProject(
     );
 
     return response;
-  } catch (err) {
+  } catch (err: unknown) {
-    if (err.status < 500) {
+    if (isAPIError(err) && err.status < 500) {
       return err;
     }