vercel 31.4.0 → 32.0.1

package/dist/index.js

@@ -14481,7 +14481,7 @@ function setup(fetch) {
 /***/ 31460:
 /***/ ((module, __unused_webpack_exports, __webpack_require__) => {
 
-const retry = __webpack_require__(69420);
+const retry = __webpack_require__(78100);
 const debug = __webpack_require__(94219)('fetch-retry');
 
 // retry settings
@@ -34008,23 +34008,22 @@ module.exports = retry;
 
 /***/ }),
 
-/***/ 69420:
+/***/ 78100:
 /***/ ((module, __unused_webpack_exports, __webpack_require__) => {
 
 // Packages
-var retrier = __webpack_require__(47671);
+var retrier = __webpack_require__(10684);
 
 function retry(fn, opts) {
   function run(resolve, reject) {
     var options = opts || {};
-    var op;
 
     // Default `randomize` to true
     if (!('randomize' in options)) {
       options.randomize = true;
     }
 
-    op = retrier.operation(options);
+    var op = retrier.operation(options);
 
     // We allow the user to abort retrying
     // this makes sense in the cases where
@@ -157229,289 +157228,6 @@ RetryOperation.prototype.mainError = function() {
 };
 
 
-/***/ }),
-
-/***/ 47671:
-/***/ ((module, __unused_webpack_exports, __webpack_require__) => {
-
-module.exports = __webpack_require__(98762);
-
-/***/ }),
-
-/***/ 98762:
-/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
-
-var RetryOperation = __webpack_require__(17526);
-
-exports.operation = function(options) {
-  var timeouts = exports.timeouts(options);
-  return new RetryOperation(timeouts, {
-      forever: options && (options.forever || options.retries === Infinity),
-      unref: options && options.unref,
-      maxRetryTime: options && options.maxRetryTime
-  });
-};
-
-exports.timeouts = function(options) {
-  if (options instanceof Array) {
-    return [].concat(options);
-  }
-
-  var opts = {
-    retries: 10,
-    factor: 2,
-    minTimeout: 1 * 1000,
-    maxTimeout: Infinity,
-    randomize: false
-  };
-  for (var key in options) {
-    opts[key] = options[key];
-  }
-
-  if (opts.minTimeout > opts.maxTimeout) {
-    throw new Error('minTimeout is greater than maxTimeout');
-  }
-
-  var timeouts = [];
-  for (var i = 0; i < opts.retries; i++) {
-    timeouts.push(this.createTimeout(i, opts));
-  }
-
-  if (options && options.forever && !timeouts.length) {
-    timeouts.push(this.createTimeout(i, opts));
-  }
-
-  // sort the array numerically ascending
-  timeouts.sort(function(a,b) {
-    return a - b;
-  });
-
-  return timeouts;
-};
-
-exports.createTimeout = function(attempt, opts) {
-  var random = (opts.randomize)
-    ? (Math.random() + 1)
-    : 1;
-
-  var timeout = Math.round(random * Math.max(opts.minTimeout, 1) * Math.pow(opts.factor, attempt));
-  timeout = Math.min(timeout, opts.maxTimeout);
-
-  return timeout;
-};
-
-exports.wrap = function(obj, options, methods) {
-  if (options instanceof Array) {
-    methods = options;
-    options = null;
-  }
-
-  if (!methods) {
-    methods = [];
-    for (var key in obj) {
-      if (typeof obj[key] === 'function') {
-        methods.push(key);
-      }
-    }
-  }
-
-  for (var i = 0; i < methods.length; i++) {
-    var method   = methods[i];
-    var original = obj[method];
-
-    obj[method] = function retryWrapper(original) {
-      var op       = exports.operation(options);
-      var args     = Array.prototype.slice.call(arguments, 1);
-      var callback = args.pop();
-
-      args.push(function(err) {
-        if (op.retry(err)) {
-          return;
-        }
-        if (err) {
-          arguments[0] = op.mainError();
-        }
-        callback.apply(this, arguments);
-      });
-
-      op.attempt(function() {
-        original.apply(obj, args);
-      });
-    }.bind(obj, original);
-    obj[method].options = options;
-  }
-};
-
-
-/***/ }),
-
-/***/ 17526:
-/***/ ((module) => {
-
-function RetryOperation(timeouts, options) {
-  // Compatibility for the old (timeouts, retryForever) signature
-  if (typeof options === 'boolean') {
-    options = { forever: options };
-  }
-
-  this._originalTimeouts = JSON.parse(JSON.stringify(timeouts));
-  this._timeouts = timeouts;
-  this._options = options || {};
-  this._maxRetryTime = options && options.maxRetryTime || Infinity;
-  this._fn = null;
-  this._errors = [];
-  this._attempts = 1;
-  this._operationTimeout = null;
-  this._operationTimeoutCb = null;
-  this._timeout = null;
-  this._operationStart = null;
-  this._timer = null;
-
-  if (this._options.forever) {
-    this._cachedTimeouts = this._timeouts.slice(0);
-  }
-}
-module.exports = RetryOperation;
-
-RetryOperation.prototype.reset = function() {
-  this._attempts = 1;
-  this._timeouts = this._originalTimeouts.slice(0);
-}
-
-RetryOperation.prototype.stop = function() {
-  if (this._timeout) {
-    clearTimeout(this._timeout);
-  }
-  if (this._timer) {
-    clearTimeout(this._timer);
-  }
-
-  this._timeouts       = [];
-  this._cachedTimeouts = null;
-};
-
-RetryOperation.prototype.retry = function(err) {
-  if (this._timeout) {
-    clearTimeout(this._timeout);
-  }
-
-  if (!err) {
-    return false;
-  }
-  var currentTime = new Date().getTime();
-  if (err && currentTime - this._operationStart >= this._maxRetryTime) {
-    this._errors.push(err);
-    this._errors.unshift(new Error('RetryOperation timeout occurred'));
-    return false;
-  }
-
-  this._errors.push(err);
-
-  var timeout = this._timeouts.shift();
-  if (timeout === undefined) {
-    if (this._cachedTimeouts) {
-      // retry forever, only keep last error
-      this._errors.splice(0, this._errors.length - 1);
-      timeout = this._cachedTimeouts.slice(-1);
-    } else {
-      return false;
-    }
-  }
-
-  var self = this;
-  this._timer = setTimeout(function() {
-    self._attempts++;
-
-    if (self._operationTimeoutCb) {
-      self._timeout = setTimeout(function() {
-        self._operationTimeoutCb(self._attempts);
-      }, self._operationTimeout);
-
-      if (self._options.unref) {
-          self._timeout.unref();
-      }
-    }
-
-    self._fn(self._attempts);
-  }, timeout);
-
-  if (this._options.unref) {
-      this._timer.unref();
-  }
-
-  return true;
-};
-
-RetryOperation.prototype.attempt = function(fn, timeoutOps) {
-  this._fn = fn;
-
-  if (timeoutOps) {
-    if (timeoutOps.timeout) {
-      this._operationTimeout = timeoutOps.timeout;
-    }
-    if (timeoutOps.cb) {
-      this._operationTimeoutCb = timeoutOps.cb;
-    }
-  }
-
-  var self = this;
-  if (this._operationTimeoutCb) {
-    this._timeout = setTimeout(function() {
-      self._operationTimeoutCb();
-    }, self._operationTimeout);
-  }
-
-  this._operationStart = new Date().getTime();
-
-  this._fn(this._attempts);
-};
-
-RetryOperation.prototype.try = function(fn) {
-  console.log('Using RetryOperation.try() is deprecated');
-  this.attempt(fn);
-};
-
-RetryOperation.prototype.start = function(fn) {
-  console.log('Using RetryOperation.start() is deprecated');
-  this.attempt(fn);
-};
-
-RetryOperation.prototype.start = RetryOperation.prototype.try;
-
-RetryOperation.prototype.errors = function() {
-  return this._errors;
-};
-
-RetryOperation.prototype.attempts = function() {
-  return this._attempts;
-};
-
-RetryOperation.prototype.mainError = function() {
-  if (this._errors.length === 0) {
-    return null;
-  }
-
-  var counts = {};
-  var mainError = null;
-  var mainErrorCount = 0;
-
-  for (var i = 0; i < this._errors.length; i++) {
-    var error = this._errors[i];
-    var message = error.message;
-    var count = (counts[message] || 0) + 1;
-
-    counts[message] = count;
-
-    if (count >= mainErrorCount) {
-      mainError = error;
-      mainErrorCount = count;
-    }
-  }
-
-  return mainError;
-};
-
-
 /***/ }),
 
 /***/ 20115:
@@ -214745,6 +214461,7 @@ exports.frameworks = [
         description: 'A new Remix app — the result of running `npx create-remix`.',
         website: 'https://remix.run',
         sort: 6,
+        supersedes: 'hydrogen',
         useRuntime: { src: 'package.json', use: '@vercel/remix-builder' },
         ignoreRuntimes: ['@vercel/node'],
         detectors: {
@@ -216203,6 +215920,7 @@ exports.frameworks = [
         tagline: 'React framework for headless commerce',
         description: 'React framework for headless commerce',
         website: 'https://hydrogen.shopify.dev',
+        supersedes: 'vite',
         useRuntime: { src: 'package.json', use: '@vercel/hydrogen' },
         envPrefix: 'PUBLIC_',
         detectors: {
@@ -217277,6 +216995,7 @@ function getRouteResult(apiRoutes, dynamicRoutes, outputDirectory, apiBuilders,
     const rewriteRoutes = [];
     const errorRoutes = [];
     const framework = frontendBuilder?.config?.framework || '';
+    const isGatsby = framework === 'gatsby';
     const isNextjs = framework === 'nextjs' || (0, is_official_runtime_1.isOfficialRuntime)('next', frontendBuilder?.use);
     const ignoreRuntimes = slugToFramework.get(framework)?.ignoreRuntimes;
     if (apiRoutes && apiRoutes.length > 0) {
@@ -217347,8 +217066,8 @@ function getRouteResult(apiRoutes, dynamicRoutes, outputDirectory, apiBuilders,
             dest: `/${outputDirectory}/$1`,
         });
     }
-    if (options.featHandleMiss && !isNextjs) {
-        // Exclude Next.js to avoid overriding custom error page
+    if (options.featHandleMiss && !isNextjs && !isGatsby) {
+        // Exclude Next.js (and Gatsby) to avoid overriding custom error page
         // https://nextjs.org/docs/advanced-features/custom-error-page
         errorRoutes.push({
             status: 404,
@@ -217572,7 +217291,7 @@ exports.detectFileSystemAPI = detectFileSystemAPI;
 "use strict";
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.detectFrameworkVersion = exports.detectFrameworkRecord = exports.detectFrameworks = exports.detectFramework = void 0;
+exports.detectFrameworkVersion = exports.detectFrameworkRecord = exports.detectFrameworks = exports.detectFramework = exports.removeSupersededFrameworks = void 0;
 const child_process_1 = __webpack_require__(63129);
 async function matches(fs, framework) {
     const { detectors } = framework;
@@ -217651,15 +217370,34 @@ async function matches(fs, framework) {
         detectedVersion,
     };
 }
+function removeSupersededFramework(matches, slug) {
+    const index = matches.findIndex(f => f?.slug === slug);
+    const framework = matches[index];
+    if (framework) {
+        if (framework.supersedes) {
+            removeSupersededFramework(matches, framework.supersedes);
+        }
+        matches.splice(index, 1);
+    }
+}
+function removeSupersededFrameworks(matches) {
+    for (const match of matches.slice()) {
+        if (match?.supersedes) {
+            removeSupersededFramework(matches, match.supersedes);
+        }
+    }
+}
+exports.removeSupersededFrameworks = removeSupersededFrameworks;
 // TODO: Deprecate and replace with `detectFrameworkRecord`
 async function detectFramework({ fs, frameworkList, }) {
     const result = await Promise.all(frameworkList.map(async (frameworkMatch) => {
         if (await matches(fs, frameworkMatch)) {
-            return frameworkMatch.slug;
+            return frameworkMatch;
         }
         return null;
     }));
-    return result.find(res => res !== null) ?? null;
+    removeSupersededFrameworks(result);
+    return result.find(res => res !== null)?.slug ?? null;
 }
 exports.detectFramework = detectFramework;
 /**
@@ -217672,6 +217410,7 @@ async function detectFrameworks({ fs, frameworkList, }) {
         }
         return null;
     }));
+    removeSupersededFrameworks(result);
     return result.filter(res => res !== null);
 }
 exports.detectFrameworks = detectFrameworks;
@@ -217687,8 +217426,8 @@ async function detectFrameworkRecord({ fs, frameworkList, }) {
         }
         return null;
     }));
-    const frameworkRecord = result.find(res => res !== null) ?? null;
-    return frameworkRecord;
+    removeSupersededFrameworks(result);
+    return result.find(res => res !== null) ?? null;
 }
 exports.detectFrameworkRecord = detectFrameworkRecord;
 function detectFrameworkVersion(frameworkRecord) {
@@ -219949,6 +219688,107 @@ const help = () => `
 exports.help = help;
 
 
+/***/ }),
+
+/***/ 92455:
+/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
+
+"use strict";
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.aliasCommand = void 0;
+const pkg_name_1 = __webpack_require__(79000);
+exports.aliasCommand = {
+    name: 'alias',
+    description: 'Interact with deployment aliases.',
+    arguments: [
+        {
+            name: 'command',
+            required: false,
+        },
+    ],
+    subcommands: [
+        {
+            name: 'ls',
+            description: 'Show all aliases.',
+            arguments: [],
+            options: [],
+            examples: [],
+        },
+        {
+            name: 'set',
+            description: 'Create a new alias',
+            arguments: [
+                {
+                    name: 'deployment',
+                    required: true,
+                },
+                {
+                    name: 'alias',
+                    required: true,
+                },
+            ],
+            options: [],
+            examples: [],
+        },
+        {
+            name: 'rm',
+            description: 'Remove an alias using its hostname.',
+            arguments: [
+                {
+                    name: 'alias',
+                    required: true,
+                },
+            ],
+            options: [],
+            examples: [],
+        },
+    ],
+    options: [
+        {
+            name: 'next',
+            description: 'Show next page of results',
+            argument: 'MS',
+            shorthand: 'n',
+            type: 'string',
+            deprecated: false,
+            multi: false,
+        },
+        {
+            name: 'yes',
+            description: 'Skip the confirmation prompt when removing an alias',
+            shorthand: 'y',
+            type: 'boolean',
+            deprecated: false,
+            multi: false,
+        },
+        {
+            name: 'limit',
+            shorthand: 'n',
+            description: 'Number of results to return per page (default: 20, max: 100)',
+            argument: 'NUMBER',
+            type: 'string',
+            deprecated: false,
+            multi: false,
+        },
+    ],
+    examples: [
+        {
+            name: 'Add a new alias to `my-api.vercel.app`',
+            value: `${pkg_name_1.packageName} alias set api-ownv3nc9f8.vercel.app my-api.vercel.app`,
+        },
+        {
+            name: 'Custom domains work as alias targets',
+            value: `${pkg_name_1.packageName} alias set api-ownv3nc9f8.vercel.app my-api.com`,
+        },
+        {
+            name: 'The subcommand `set` is the default and can be skipped. Protocols in the URLs are unneeded and ignored',
+            value: `${pkg_name_1.packageName} alias api-ownv3nc9f8.vercel.app my-api.com`,
+        },
+    ],
+};
+
+
 /***/ }),
 
 /***/ 57725:
@@ -219960,58 +219800,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-const chalk_1 = __importDefault(__webpack_require__(90877));
 const error_1 = __webpack_require__(4400);
 const get_args_1 = __importDefault(__webpack_require__(2505));
 const get_subcommand_1 = __importDefault(__webpack_require__(66167));
-const pkg_name_1 = __webpack_require__(79000);
+const help_1 = __webpack_require__(58219);
 const ls_1 = __importDefault(__webpack_require__(74021));
 const rm_1 = __importDefault(__webpack_require__(48863));
 const set_1 = __importDefault(__webpack_require__(80734));
-const help = () => {
-    console.log(`
-  ${chalk_1.default.bold(`${pkg_name_1.logo} ${pkg_name_1.packageName} alias`)} [options] <command>
-
-  ${chalk_1.default.dim('Commands:')}
-
-    ls                           Show all aliases
-    set   <deployment> <alias>   Create a new alias
-    rm    <alias>                Remove an alias using its hostname
-
-  ${chalk_1.default.dim('Options:')}
-
-    -h, --help                          Output usage information
-    -A ${chalk_1.default.bold.underline('FILE')}, --local-config=${chalk_1.default.bold.underline('FILE')}        Path to the local ${'`vercel.json`'} file
-    -Q ${chalk_1.default.bold.underline('DIR')}, --global-config=${chalk_1.default.bold.underline('DIR')}         Path to the global ${'`.vercel`'} directory
-    -d, --debug                         Debug mode [off]
-    --no-color                          No color mode [off]
-    -t ${chalk_1.default.bold.underline('TOKEN')}, --token=${chalk_1.default.bold.underline('TOKEN')}             Login token
-    -S, --scope                         Set a custom scope
-    -N, --next                          Show next page of results
-    -y, --yes                           Skip the confirmation prompt when removing an alias
-    --limit=${chalk_1.default.bold.underline('VALUE')}                       Number of results to return per page (default: 20, max: 100)
-
-  ${chalk_1.default.dim('Examples:')}
-
-  ${chalk_1.default.gray('–')} Add a new alias to ${chalk_1.default.underline('my-api.vercel.app')}
-
-      ${chalk_1.default.cyan(`$ ${pkg_name_1.packageName} alias set ${chalk_1.default.underline('api-ownv3nc9f8.vercel.app')} ${chalk_1.default.underline('my-api.vercel.app')}`)}
-
-      Custom domains work as alias targets
-
-      ${chalk_1.default.cyan(`$ ${pkg_name_1.packageName} alias set ${chalk_1.default.underline('api-ownv3nc9f8.vercel.app')} ${chalk_1.default.underline('my-api.com')}`)}
-
-      ${chalk_1.default.dim('–')} The subcommand ${chalk_1.default.dim('`set`')} is the default and can be skipped.
-      ${chalk_1.default.dim('–')} ${chalk_1.default.dim('Protocols')} in the URLs are unneeded and ignored.
-`);
-};
+const command_1 = __webpack_require__(92455);
 const COMMAND_CONFIG = {
     default: ['set'],
     ls: ['ls', 'list'],
     rm: ['rm', 'remove'],
     set: ['set'],
 };
-async function main(client) {
+async function alias(client) {
     let argv;
     try {
         argv = (0, get_args_1.default)(client.argv.slice(2), {
@@ -220028,7 +219831,7 @@ async function main(client) {
         return 1;
     }
     if (argv['--help']) {
-        help();
+        client.output.print((0, help_1.help)(command_1.aliasCommand, { columns: client.stderr.columns }));
         return 2;
     }
     const { subcommand, args } = (0, get_subcommand_1.default)(argv._.slice(1), COMMAND_CONFIG);
@@ -220041,7 +219844,7 @@ async function main(client) {
             return (0, set_1.default)(client, argv, args);
     }
 }
-exports.default = main;
+exports.default = alias;
 
 
 /***/ }),
@@ -221487,6 +221290,129 @@ async function add(client, opts, args) {
 exports.default = add;
 
 
+/***/ }),
+
+/***/ 19219:
+/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
+
+"use strict";
+
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.certsCommand = void 0;
+const pkg_name_1 = __webpack_require__(79000);
+exports.certsCommand = {
+    name: 'certs',
+    description: 'Interact with SSL certificates. This command is intended for advanced use only. By default, Vercel manages your certificates automatically.',
+    arguments: [
+        {
+            name: 'command',
+            required: false,
+        },
+    ],
+    subcommands: [
+        {
+            name: 'ls',
+            description: 'Show all available certificates',
+            arguments: [],
+            options: [],
+            examples: [],
+        },
+        {
+            name: 'issue',
+            description: ' Issue a new certificate for a domain',
+            arguments: [
+                {
+                    name: 'cn',
+                    required: true,
+                },
+            ],
+            options: [],
+            examples: [],
+        },
+        {
+            name: 'rm',
+            description: 'Remove a certificate by id',
+            arguments: [
+                {
+                    name: 'id',
+                    required: true,
+                },
+            ],
+            options: [],
+            examples: [],
+        },
+    ],
+    options: [
+        {
+            name: 'challenge-only',
+            description: 'Only show challenges needed to issue a cert',
+            shorthand: null,
+            type: 'string',
+            deprecated: false,
+            multi: false,
+        },
+        {
+            name: 'crt',
+            description: 'Certificate file',
+            argument: 'FILE',
+            shorthand: null,
+            type: 'string',
+            deprecated: false,
+            multi: false,
+        },
+        {
+            name: 'key',
+            description: 'Certificate key file',
+            argument: 'FILE',
+            shorthand: null,
+            type: 'string',
+            deprecated: false,
+            multi: false,
+        },
+        {
+            name: 'ca',
+            description: 'CA certificate chain file',
+            argument: 'FILE',
+            shorthand: null,
+            type: 'string',
+            deprecated: false,
+            multi: false,
+        },
+        {
+            name: 'limit',
+            description: 'Number of results to return per page (default: 20, max: 100)',
+            argument: 'VALUE',
+            shorthand: null,
+            type: 'string',
+            deprecated: false,
+            multi: false,
+        },
+        {
+            name: 'next',
+            description: 'Show next page of results',
+            shorthand: 'n',
+            type: 'string',
+            deprecated: false,
+            multi: false,
+        },
+    ],
+    examples: [
+        {
+            name: 'Generate a certificate with the cnames "acme.com" and "www.acme.com"`',
+            value: `${pkg_name_1.packageName} certs issue acme.com www.acme.com`,
+        },
+        {
+            name: 'Remove a certificate',
+            value: `${pkg_name_1.packageName} certs rm id`,
+        },
+        {
+            name: 'Paginate results, where `1584722256178` is the time in milliseconds since the UNIX epoch.',
+            value: `${pkg_name_1.packageName} certs ls --next 1584722256178`,
+        },
+    ],
+};
+
+
 /***/ }),
 
 /***/ 1165:
@@ -221498,7 +221424,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-const chalk_1 = __importDefault(__webpack_require__(90877));
 // @ts-ignore
 const error_1 = __webpack_require__(4400);
 const get_args_1 = __importDefault(__webpack_require__(2505));
@@ -221507,51 +221432,8 @@ const add_1 = __importDefault(__webpack_require__(30033));
 const issue_1 = __importDefault(__webpack_require__(14008));
 const ls_1 = __importDefault(__webpack_require__(15922));
 const rm_1 = __importDefault(__webpack_require__(55667));
-const pkg_name_1 = __webpack_require__(79000);
-const help = () => {
-    console.log(`
-  ${chalk_1.default.bold(`${pkg_name_1.logo} ${pkg_name_1.packageName} certs`)} [options] <command>
-
-  ${chalk_1.default.yellow('NOTE:')} This command is intended for advanced use only.
-  By default, Vercel manages your certificates automatically.
-
-  ${chalk_1.default.dim('Commands:')}
-
-    ls                        Show all available certificates
-    issue      <cn> [<cn>]    Issue a new certificate for a domain
-    rm         <id>           Remove a certificate by id
-
-  ${chalk_1.default.dim('Options:')}
-
-    -h, --help                     Output usage information
-    -A ${chalk_1.default.bold.underline('FILE')}, --local-config=${chalk_1.default.bold.underline('FILE')}   Path to the local ${'`vercel.json`'} file
-    -Q ${chalk_1.default.bold.underline('DIR')}, --global-config=${chalk_1.default.bold.underline('DIR')}    Path to the global ${'`.vercel`'} directory
-    -d, --debug                    Debug mode [off]
-    --no-color                     No color mode [off]
-    -t ${chalk_1.default.bold.underline('TOKEN')}, --token=${chalk_1.default.bold.underline('TOKEN')}        Login token
-    -S, --scope                    Set a custom scope
-    --challenge-only               Only show challenges needed to issue a cert
-    --crt ${chalk_1.default.bold.underline('FILE')}                     Certificate file
-    --key ${chalk_1.default.bold.underline('FILE')}                     Certificate key file
-    --ca ${chalk_1.default.bold.underline('FILE')}                      CA certificate chain file
-    -N, --next                     Show next page of results
-    --limit=${chalk_1.default.bold.underline('VALUE')}                  Number of results to return per page (default: 20, max: 100)
-
-  ${chalk_1.default.dim('Examples:')}
-
-  ${chalk_1.default.gray('–')} Generate a certificate with the cnames "acme.com" and "www.acme.com"
-
-      ${chalk_1.default.cyan(`$ ${pkg_name_1.packageName} certs issue acme.com www.acme.com`)}
-
-  ${chalk_1.default.gray('–')} Remove a certificate
-
-      ${chalk_1.default.cyan(`$ ${pkg_name_1.packageName} certs rm id`)}
-
-  ${chalk_1.default.gray('–')} Paginate results, where ${chalk_1.default.dim('`1584722256178`')} is the time in milliseconds since the UNIX epoch.
-
-      ${chalk_1.default.cyan(`$ ${pkg_name_1.packageName} certs ls --next 1584722256178`)}
-  `);
-};
+const command_1 = __webpack_require__(19219);
+const help_1 = __webpack_require__(58219);
 const COMMAND_CONFIG = {
     add: ['add'],
     issue: ['issue'],
@@ -221579,7 +221461,7 @@ async function main(client) {
         return 1;
     }
     if (argv['--help']) {
-        help();
+        client.output.print((0, help_1.help)(command_1.certsCommand, { columns: client.stderr.columns }));
         return 2;
     }
     const { output } = client;
@@ -221598,7 +221480,7 @@ async function main(client) {
             return 1;
         default:
             output.error('Please specify a valid subcommand: ls | issue | rm');
-            help();
+            client.output.print((0, help_1.help)(command_1.certsCommand, { columns: client.stderr.columns }));
             return 2;
     }
 }
@@ -225329,12 +225211,35 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.help = exports.buildHelpOutput = exports.buildCommandExampleLines = exports.buildCommandOptionLines = exports.buildCommandSynopsisLine = exports.outputArrayToString = exports.lineToString = void 0;
+exports.help = exports.buildHelpOutput = exports.buildCommandExampleLines = exports.buildSubcommandLines = exports.buildCommandOptionLines = exports.buildCommandSynopsisLine = exports.outputArrayToString = exports.lineToString = void 0;
 const chalk_1 = __importDefault(__webpack_require__(90877));
 const constants_1 = __webpack_require__(98551);
 const cli_table3_1 = __importDefault(__webpack_require__(47579));
 const INDENT = ' '.repeat(2);
 const NEWLINE = '\n';
+const tableOptions = {
+    chars: {
+        top: '',
+        'top-mid': '',
+        'top-left': '',
+        'top-right': '',
+        bottom: '',
+        'bottom-mid': '',
+        'bottom-left': '',
+        'bottom-right': '',
+        left: '',
+        'left-mid': '',
+        mid: '',
+        'mid-mid': '',
+        right: '',
+        'right-mid': '',
+        middle: '',
+    },
+    style: {
+        'padding-left': 0,
+        'padding-right': 0,
+    },
+};
 const globalCommandOptions = [
     {
         name: 'help',
@@ -225413,6 +225318,26 @@ const globalCommandOptions = [
         multi: false,
     },
 ];
+// Use the word wrapping ability of cli-table3
+// by creating a one row, one cell, one column table.
+// This allows us to avoid pulling in the word-wrap
+// package which ironically seems to do a worse job.
+function wordWrap(text, maxWidth) {
+    const _tableOptions = Object.assign({}, tableOptions, {
+        colWidths: [maxWidth],
+        style: {
+            'padding-left': INDENT.length,
+        },
+    });
+    const table = new cli_table3_1.default(_tableOptions);
+    table.push([
+        {
+            content: text,
+            wordWrap: true,
+        },
+    ]);
+    return table.toString();
+}
 // Insert spaces in between non-whitespace items only
 function lineToString(line) {
     let string = '';
@@ -225494,30 +225419,9 @@ function buildCommandOptionLines(commandOptions, options, sectionTitle) {
         ]);
     }
     const finalColumnWidth = options.columns - maxWidthOfUnwrappedColumns;
-    const table = new cli_table3_1.default({
-        chars: {
-            top: '',
-            'top-mid': '',
-            'top-left': '',
-            'top-right': '',
-            bottom: '',
-            'bottom-mid': '',
-            'bottom-left': '',
-            'bottom-right': '',
-            left: '',
-            'left-mid': '',
-            mid: '',
-            'mid-mid': '',
-            right: '',
-            'right-mid': '',
-            middle: '',
-        },
-        style: {
-            'padding-left': 0,
-            'padding-right': 0,
-        },
+    const table = new cli_table3_1.default(Object.assign({}, tableOptions, {
         colWidths: [null, null, finalColumnWidth],
-    });
+    }));
     table.push(...rows);
     return [
         `${INDENT}${chalk_1.default.dim(sectionTitle)}:`,
@@ -225529,6 +225433,50 @@ function buildCommandOptionLines(commandOptions, options, sectionTitle) {
     ].join('');
 }
 exports.buildCommandOptionLines = buildCommandOptionLines;
+function buildSubcommandLines(subcommands, options) {
+    if (!subcommands) {
+        return null;
+    }
+    // word wrapping requires the wrapped cell to have a fixed width.
+    // We need to track cell sizes to ensure the final column of cells is
+    // equal to the remainder of unused horizontal space.
+    let maxWidthOfUnwrappedColumns = 0;
+    const rows = [];
+    for (const command of subcommands) {
+        const nameCell = `${INDENT}${command.name}`;
+        let argsCell = INDENT;
+        argsCell += command.arguments
+            .map(arg => {
+            return arg.required ? arg.name : `[${arg.name}]`;
+        })
+            .join(' ');
+        argsCell += INDENT;
+        const widthOfUnwrappedColumns = nameCell.length + argsCell.length;
+        maxWidthOfUnwrappedColumns = Math.max(widthOfUnwrappedColumns, maxWidthOfUnwrappedColumns);
+        rows.push([
+            nameCell,
+            argsCell,
+            {
+                content: command.description,
+                wordWrap: true,
+            },
+        ]);
+    }
+    const finalColumnWidth = options.columns - maxWidthOfUnwrappedColumns;
+    const table = new cli_table3_1.default(Object.assign({}, tableOptions, {
+        colWidths: [null, null, finalColumnWidth],
+    }));
+    table.push(...rows);
+    return [
+        `${INDENT}${chalk_1.default.dim('Commands')}:`,
+        NEWLINE,
+        NEWLINE,
+        table.toString(),
+        NEWLINE,
+        NEWLINE,
+    ].join('');
+}
+exports.buildSubcommandLines = buildSubcommandLines;
 function buildCommandExampleLines(command) {
     const outputArray = [`${INDENT}${chalk_1.default.dim('Examples:')}`, ''];
     for (const example of command.examples) {
@@ -225553,15 +225501,16 @@ function buildCommandExampleLines(command) {
     return outputArrayToString(outputArray);
 }
 exports.buildCommandExampleLines = buildCommandExampleLines;
-function buildDescriptionLine(command) {
-    const line = [INDENT, command.description, NEWLINE];
-    return lineToString(line);
+function buildDescriptionLine(command, options) {
+    let wrapingText = wordWrap(command.description, options.columns);
+    return `${wrapingText}${NEWLINE}`;
 }
 function buildHelpOutput(command, options) {
     const outputArray = [
         '',
         buildCommandSynopsisLine(command),
-        buildDescriptionLine(command),
+        buildDescriptionLine(command, options),
+        buildSubcommandLines(command.subcommands, options),
         buildCommandOptionLines(command.options, options, 'Options'),
         buildCommandOptionLines(globalCommandOptions, options, 'Global Options'),
         buildCommandExampleLines(command),
@@ -227808,6 +227757,15 @@ exports.pullCommand = {
             deprecated: false,
             multi: false,
         },
+        {
+            name: 'git-branch',
+            description: 'Specify the Git branch to pull specific Environment Variables for',
+            argument: 'branch',
+            shorthand: null,
+            type: 'string',
+            deprecated: false,
+            multi: false,
+        },
         {
             name: 'yes',
             description: 'Skip questions when setting up new project using default scope and settings',
@@ -227830,6 +227788,10 @@ exports.pullCommand = {
             name: 'Pull for a specific environment',
             value: `${pkg_name_1.packageName} pull --environment=${(0, env_target_1.getEnvTargetPlaceholder)()}`,
         },
+        {
+            name: 'Pull for a preview feature branch',
+            value: `${pkg_name_1.packageName} pull --environment=preview --git-branch=feature-branch`,
+        },
         {
             name: 'If you want to download environment variables to a specific file, use `vercel env pull` instead',
             value: `${pkg_name_1.packageName} env pull`,
@@ -234267,7 +234229,7 @@ exports.getRoutesTypes = getRoutesTypes;
 async function devRouter(reqUrl = '/', reqMethod, routes, devServer, vercelConfig, previousHeaders, missRoutes, phase) {
     let result;
     let { pathname: reqPathname, search: reqSearch } = url_1.default.parse(reqUrl);
-    reqPathname ?? (reqPathname = '/');
+    reqPathname = reqPathname || '/';
     const reqQuery = (0, parse_query_string_1.parseQueryString)(reqSearch);
     const combinedHeaders = { ...previousHeaders };
     let status;
@@ -234326,7 +234288,7 @@ async function devRouter(reqUrl = '/', reqMethod, routes, devServer, vercelConfi
                     phase !== 'hit' &&
                     !isDestUrl) {
                     let { pathname } = url_1.default.parse(destPath);
-                    pathname ?? (pathname = '/');
+                    pathname = pathname || '/';
                     const hasDestFile = await devServer.hasFilesystem(pathname, vercelConfig);
                     if (!hasDestFile) {
                         if (routeConfig.status && phase !== 'miss') {
@@ -234373,7 +234335,7 @@ async function devRouter(reqUrl = '/', reqMethod, routes, devServer, vercelConfi
                         destPath = `/${destPath}`;
                     }
                     let { pathname: destPathname, search: destSearch } = url_1.default.parse(destPath);
-                    destPathname ?? (destPathname = '/');
+                    destPathname = destPathname || '/';
                     const destQuery = (0, parse_query_string_1.parseQueryString)(destSearch);
                     Object.assign(destQuery, reqQuery);
                     result = {
@@ -245913,7 +245875,7 @@ module.exports = JSON.parse("[[[0,44],\"disallowed_STD3_valid\"],[[45,46],\"vali
 /***/ ((module) => {
 
 "use strict";
-module.exports = JSON.parse("{\"name\":\"@vercel/client\",\"version\":\"12.6.6\",\"main\":\"dist/index.js\",\"typings\":\"dist/index.d.ts\",\"homepage\":\"https://vercel.com\",\"license\":\"Apache-2.0\",\"files\":[\"dist\"],\"repository\":{\"type\":\"git\",\"url\":\"https://github.com/vercel/vercel.git\",\"directory\":\"packages/client\"},\"scripts\":{\"build\":\"tsc\",\"test-e2e\":\"pnpm test tests/create-deployment.test.ts tests/create-legacy-deployment.test.ts tests/paths.test.ts\",\"test\":\"jest --env node --verbose --runInBand --bail\",\"test-unit\":\"pnpm test tests/unit.*test.*\"},\"engines\":{\"node\":\">= 14\"},\"devDependencies\":{\"@types/async-retry\":\"1.4.5\",\"@types/fs-extra\":\"7.0.0\",\"@types/jest\":\"27.4.1\",\"@types/minimatch\":\"3.0.5\",\"@types/ms\":\"0.7.30\",\"@types/node\":\"14.18.33\",\"@types/node-fetch\":\"2.5.4\",\"@types/recursive-readdir\":\"2.2.0\",\"@types/tar-fs\":\"1.16.1\",\"typescript\":\"4.9.5\"},\"dependencies\":{\"@vercel/build-utils\":\"6.8.3\",\"@vercel/routing-utils\":\"2.2.1\",\"@zeit/fetch\":\"5.2.0\",\"async-retry\":\"1.2.3\",\"async-sema\":\"3.0.0\",\"fs-extra\":\"8.0.1\",\"ignore\":\"4.0.6\",\"minimatch\":\"5.0.1\",\"ms\":\"2.1.2\",\"node-fetch\":\"2.6.7\",\"querystring\":\"^0.2.0\",\"sleep-promise\":\"8.0.1\",\"tar-fs\":\"1.16.3\"}}");
+module.exports = JSON.parse("{\"name\":\"@vercel/client\",\"version\":\"13.0.0\",\"main\":\"dist/index.js\",\"typings\":\"dist/index.d.ts\",\"homepage\":\"https://vercel.com\",\"license\":\"Apache-2.0\",\"files\":[\"dist\"],\"repository\":{\"type\":\"git\",\"url\":\"https://github.com/vercel/vercel.git\",\"directory\":\"packages/client\"},\"scripts\":{\"build\":\"tsc\",\"test-e2e\":\"pnpm test tests/create-deployment.test.ts tests/create-legacy-deployment.test.ts tests/paths.test.ts\",\"test\":\"jest --reporters=default --reporters=jest-junit --env node --verbose --runInBand --bail\",\"test-unit\":\"pnpm test tests/unit.*test.*\"},\"engines\":{\"node\":\">= 16\"},\"devDependencies\":{\"@types/async-retry\":\"1.4.5\",\"@types/fs-extra\":\"7.0.0\",\"@types/jest\":\"27.4.1\",\"@types/minimatch\":\"3.0.5\",\"@types/ms\":\"0.7.30\",\"@types/node\":\"14.18.33\",\"@types/node-fetch\":\"2.5.4\",\"@types/recursive-readdir\":\"2.2.0\",\"@types/tar-fs\":\"1.16.1\",\"jest-junit\":\"16.0.0\",\"typescript\":\"4.9.5\"},\"dependencies\":{\"@vercel/build-utils\":\"7.0.0\",\"@vercel/routing-utils\":\"3.0.0\",\"@zeit/fetch\":\"5.2.0\",\"async-retry\":\"1.2.3\",\"async-sema\":\"3.0.0\",\"fs-extra\":\"8.0.1\",\"ignore\":\"4.0.6\",\"minimatch\":\"5.0.1\",\"ms\":\"2.1.2\",\"node-fetch\":\"2.6.7\",\"querystring\":\"^0.2.0\",\"sleep-promise\":\"8.0.1\",\"tar-fs\":\"1.16.3\"}}");
 
 /***/ }),
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vercel",
-  "version": "31.4.0",
+  "version": "32.0.1",
   "preferGlobal": true,
   "license": "Apache-2.0",
   "description": "The command-line interface for Vercel",
@@ -19,19 +19,19 @@
     "scripts/preinstall.js"
   ],
   "engines": {
-    "node": ">= 14"
+    "node": ">= 16"
   },
   "dependencies": {
-    "@vercel/build-utils": "6.8.3",
-    "@vercel/go": "2.5.1",
-    "@vercel/hydrogen": "0.0.64",
-    "@vercel/next": "3.9.4",
-    "@vercel/node": "2.15.10",
-    "@vercel/python": "3.1.60",
-    "@vercel/redwood": "1.1.15",
-    "@vercel/remix-builder": "1.10.1",
-    "@vercel/ruby": "1.3.76",
-    "@vercel/static-build": "1.4.0"
+    "@vercel/build-utils": "7.0.0",
+    "@vercel/go": "3.0.0",
+    "@vercel/hydrogen": "1.0.0",
+    "@vercel/next": "4.0.0",
+    "@vercel/node": "3.0.1",
+    "@vercel/python": "4.0.0",
+    "@vercel/redwood": "2.0.0",
+    "@vercel/remix-builder": "2.0.0",
+    "@vercel/ruby": "2.0.0",
+    "@vercel/static-build": "2.0.1"
   },
   "devDependencies": {
     "@alex_neo/jest-expect-message": "1.0.5",
@@ -77,14 +77,14 @@
     "@types/yauzl-promise": "2.1.0",
     "@vercel-internals/constants": "1.0.4",
     "@vercel-internals/get-package-json": "1.0.0",
-    "@vercel-internals/types": "1.0.6",
-    "@vercel/client": "12.6.6",
-    "@vercel/error-utils": "1.0.10",
-    "@vercel/frameworks": "1.6.0",
-    "@vercel/fs-detectors": "4.1.3",
+    "@vercel-internals/types": "1.0.7",
+    "@vercel/client": "13.0.0",
+    "@vercel/error-utils": "2.0.1",
+    "@vercel/frameworks": "2.0.1",
+    "@vercel/fs-detectors": "5.0.1",
     "@vercel/fun": "1.0.4",
     "@vercel/ncc": "0.24.0",
-    "@vercel/routing-utils": "2.2.1",
+    "@vercel/routing-utils": "3.0.0",
     "@zeit/source-map-support": "0.6.2",
     "ajv": "6.12.2",
     "alpha-sort": "2.0.1",
@@ -125,6 +125,7 @@
     "is-port-reachable": "3.1.0",
     "is-url": "1.2.2",
     "jaro-winkler": "0.2.8",
+    "jest-junit": "16.0.0",
     "jest-matcher-utils": "29.3.1",
     "jsonlines": "0.1.1",
     "line-async-iterator": "3.0.0",
@@ -165,7 +166,7 @@
     "yauzl-promise": "2.1.3"
   },
   "scripts": {
-    "test": "jest --env node --verbose --bail",
+    "test": "jest --reporters=default --reporters=jest-junit --env node --verbose --bail",
     "test-unit": "pnpm test test/unit/",
     "test-e2e": "rimraf test/fixtures/integration && pnpm test test/integration-1.test.ts test/integration-2.test.ts test/integration-3.test.ts",
     "test-dev": "pnpm test test/dev/",