@automattic/vip 2.32.1 → 2.32.3

package/dist/lib/site-import/status.js

@@ -218,7 +218,7 @@ ${maybeExitPrompt}
   progressTracker.startPrinting(setSuffixAndPrint);
   const getResults = () => new Promise((resolve, reject) => {
     const checkStatus = async () => {
-      var _importJob$progress$s, _importJob$progress, _importJob$progress$s2, _importJob$progress2;
+      var _importJob$progress, _importJob$progress2;
       let status;
       try {
         status = await getStatus(api, app.id, env.id);
@@ -242,7 +242,7 @@ ${maybeExitPrompt}
         if (!importJob) {
           var _importStatus$progres, _importStatus$progres2;
           importJob = {};
-          const statusSteps = importStatus === null || importStatus === void 0 ? void 0 : (_importStatus$progres = importStatus.progress) === null || _importStatus$progres === void 0 ? void 0 : _importStatus$progres.steps;
+          const statusSteps = importStatus === null || importStatus === void 0 || (_importStatus$progres = importStatus.progress) === null || _importStatus$progres === void 0 ? void 0 : _importStatus$progres.steps;
 
           // if the progress meta isn't filled out yet, wait until it is.
           if (!statusSteps) {
@@ -280,8 +280,8 @@ ${maybeExitPrompt}
       } else if (!importJob) {
         return resolve('No import job found');
       }
-      jobStatus = (_importJob$progress$s = (_importJob$progress = importJob.progress) === null || _importJob$progress === void 0 ? void 0 : _importJob$progress.status) !== null && _importJob$progress$s !== void 0 ? _importJob$progress$s : 'unknown';
-      jobSteps = (_importJob$progress$s2 = (_importJob$progress2 = importJob.progress) === null || _importJob$progress2 === void 0 ? void 0 : _importJob$progress2.steps) !== null && _importJob$progress$s2 !== void 0 ? _importJob$progress$s2 : [];
+      jobStatus = ((_importJob$progress = importJob.progress) === null || _importJob$progress === void 0 ? void 0 : _importJob$progress.status) ?? 'unknown';
+      jobSteps = ((_importJob$progress2 = importJob.progress) === null || _importJob$progress2 === void 0 ? void 0 : _importJob$progress2.steps) ?? [];
       createdAt = importJob.createdAt;
       completedAt = importJob.completedAt;
       const {
@@ -361,7 +361,7 @@ ${maybeExitPrompt}
       overallStatus = results;
     } else {
       var _results$progress;
-      overallStatus = (results === null || results === void 0 ? void 0 : (_results$progress = results.progress) === null || _results$progress === void 0 ? void 0 : _results$progress.status) || 'unknown';
+      overallStatus = (results === null || results === void 0 || (_results$progress = results.progress) === null || _results$progress === void 0 ? void 0 : _results$progress.status) || 'unknown';
       // This shouldn't be 'unknown'...what should we do here?
     }
 

package/dist/lib/token.js

@@ -62,12 +62,10 @@ class Token {
     return now > this.exp;
   }
   get id() {
-    var _this$_id;
-    return (_this$_id = this._id) !== null && _this$_id !== void 0 ? _this$_id : NaN;
+    return this._id ?? NaN;
   }
   get raw() {
-    var _this$_raw;
-    return (_this$_raw = this._raw) !== null && _this$_raw !== void 0 ? _this$_raw : '';
+    return this._raw ?? '';
   }
   static async uuid() {
     const service = Token.getServiceName('-uuid');
@@ -87,9 +85,8 @@ class Token {
     return _keychain.default.setPassword(service, token);
   }
   static async get() {
-    var _await$keychain$getPa;
     const service = Token.getServiceName();
-    const token = (_await$keychain$getPa = await _keychain.default.getPassword(service)) !== null && _await$keychain$getPa !== void 0 ? _await$keychain$getPa : '';
+    const token = (await _keychain.default.getPassword(service)) ?? '';
     return new Token(token);
   }
   static purge() {

package/dist/lib/types/graphql/rate-limit-exceeded-error.js

@@ -0,0 +1 @@
+"use strict";

package/dist/lib/validations/is-multi-site-sql-dump.js

@@ -4,7 +4,6 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.sqlDumpLineIsMultiSite = sqlDumpLineIsMultiSite;
-// @format
 const SQL_CREATE_TABLE_IS_MULTISITE_REGEX = /^CREATE TABLE `?(wp_\d+_[a-z0-9_]*|wp_blogs)/i;
 const SQL_CONTAINS_MULTISITE_WP_USERS_REGEX = /`spam` tinyint\(2\)|`deleted` tinyint\(2\)/i;
 function sqlDumpLineIsMultiSite(line) {

package/dist/lib/validations/is-multi-site.js

@@ -11,11 +11,6 @@ var exit = _interopRequireWildcard(require("../../lib/cli/exit"));
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-/**
- * 
- * @format
- */
-
 /**
  * External dependencies
  */
@@ -26,10 +21,16 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
 
 const isMultiSite = new WeakMap();
 async function isMultiSiteInSiteMeta(appId, envId) {
-  var _res, _res$data, _res$data$app;
+  var _res$data$app;
+  const args = {
+    0: appId,
+    1: envId
+  };
+
   // if we've already been through this, avoid doing it again within the same process
-  if (isMultiSite.has(arguments) && 'boolean' === typeof isMultiSite.get(arguments)) {
-    return Boolean(isMultiSite.get(arguments));
+  const ret = isMultiSite.get(args);
+  if ('boolean' === typeof ret) {
+    return ret;
   }
   const api = await (0, _api.default)();
   let res;
@@ -63,18 +64,19 @@ async function isMultiSiteInSiteMeta(appId, envId) {
       error_type: 'GraphQL-MultiSite-Check-failed',
       gql_err: GraphQlError
     });
+    // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
     exit.withError(`StartImport call failed: ${GraphQlError}`);
   }
-  if (Array.isArray((_res = res) === null || _res === void 0 ? void 0 : (_res$data = _res.data) === null || _res$data === void 0 ? void 0 : (_res$data$app = _res$data.app) === null || _res$data$app === void 0 ? void 0 : _res$data$app.environments)) {
+  if (Array.isArray((_res$data$app = res.data.app) === null || _res$data$app === void 0 ? void 0 : _res$data$app.environments)) {
     const environments = res.data.app.environments;
     if (!environments.length) {
-      isMultiSite.set(arguments, false);
+      isMultiSite.set(args, false);
       return false;
     }
     // we asked for one result with one appId and one envId, so...
     const thisEnv = environments[0];
-    if (thisEnv.isMultiSite || thisEnv.isSubdirectoryMultisite) {
-      isMultiSite.set(arguments, true);
+    if (thisEnv.isMultisite || thisEnv.isSubdirectoryMultisite) {
+      isMultiSite.set(args, true);
       return true;
     }
   }

package/dist/lib/validations/is-multisite-domain-mapped.js

@@ -13,11 +13,6 @@ var exit = _interopRequireWildcard(require("../../lib/cli/exit"));
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-/**
- * 
- * @format
- */
-
 /**
  * External dependencies
  */
@@ -52,11 +47,10 @@ const getPrimaryDomainFromSQL = statements => {
 exports.getPrimaryDomainFromSQL = getPrimaryDomainFromSQL;
 const maybeSearchReplacePrimaryDomain = function (domain, searchReplace) {
   if (searchReplace) {
-    var _primaryDomainReplace;
     const pairs = Array.isArray(searchReplace) ? searchReplace : [searchReplace];
     const domainReplacements = pairs.map(pair => pair.split(','));
     const primaryDomainReplacement = domainReplacements.find(pair => pair[0] === domain);
-    return (_primaryDomainReplace = primaryDomainReplacement === null || primaryDomainReplacement === void 0 ? void 0 : primaryDomainReplacement[1]) !== null && _primaryDomainReplace !== void 0 ? _primaryDomainReplace : domain;
+    return (primaryDomainReplacement === null || primaryDomainReplacement === void 0 ? void 0 : primaryDomainReplacement[1]) ?? domain;
   }
   return domain;
 };
@@ -84,7 +78,7 @@ const getPrimaryDomain = function (statements, searchReplace) {
  */
 exports.getPrimaryDomain = getPrimaryDomain;
 async function isMultisitePrimaryDomainMapped(appId, envId, primaryDomain) {
-  var _res, _res$data, _res$data$app, _environments$, _environments$$domain, _environments$$domain2;
+  var _res$data$app, _environments$;
   const track = _tracker.trackEventWithEnv.bind(null, appId, envId);
   const api = await (0, _api.default)();
   let res;
@@ -118,15 +112,16 @@ async function isMultisitePrimaryDomainMapped(appId, envId, primaryDomain) {
       error_type: 'GraphQL-MappedDomain-Check-failed',
       gql_err: GraphQlError
     });
+    // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
     exit.withError(`StartImport call failed: ${GraphQlError}`);
   }
-  if (!Array.isArray((_res = res) === null || _res === void 0 ? void 0 : (_res$data = _res.data) === null || _res$data === void 0 ? void 0 : (_res$data$app = _res$data.app) === null || _res$data$app === void 0 ? void 0 : _res$data$app.environments)) {
+  if (!Array.isArray((_res$data$app = res.data.app) === null || _res$data$app === void 0 ? void 0 : _res$data$app.environments)) {
     return false;
   }
   const environments = res.data.app.environments;
   if (!environments.length) {
     return false;
   }
-  const mappedDomains = (_environments$ = environments[0]) === null || _environments$ === void 0 ? void 0 : (_environments$$domain = _environments$.domains) === null || _environments$$domain === void 0 ? void 0 : (_environments$$domain2 = _environments$$domain.nodes) === null || _environments$$domain2 === void 0 ? void 0 : _environments$$domain2.map(domain => domain.name);
+  const mappedDomains = ((_environments$ = environments[0]) === null || _environments$ === void 0 || (_environments$ = _environments$.domains) === null || _environments$ === void 0 || (_environments$ = _environments$.nodes) === null || _environments$ === void 0 ? void 0 : _environments$.map(domain => domain === null || domain === void 0 ? void 0 : domain.name)) ?? [];
   return mappedDomains.includes(primaryDomain);
 }

package/dist/lib/validations/line-by-line.js

@@ -5,18 +5,14 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.fileLineValidations = fileLineValidations;
 exports.getReadInterface = getReadInterface;
-var _readline = _interopRequireDefault(require("readline"));
-var _fs = _interopRequireDefault(require("fs"));
+var _nodeReadline = require("node:readline");
+var _nodeFs = require("node:fs");
+var _promises = require("node:fs/promises");
 var _debug = _interopRequireDefault(require("debug"));
 var exit = _interopRequireWildcard(require("../../lib/cli/exit"));
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-/**
- * 
- * @format
- */
-
 /**
  * External dependencies
  */
@@ -29,16 +25,15 @@ const debug = (0, _debug.default)('vip:validations:line-by-line');
 async function getReadInterface(filename) {
   let fd;
   try {
-    fd = await _fs.default.promises.open(filename);
+    fd = await (0, _promises.open)(filename);
   } catch (err) {
     exit.withError('The file at the provided path is either missing or not readable. Please check the input and try again.');
   }
-  return _readline.default.createInterface({
-    input: _fs.default.createReadStream('', {
+  return (0, _nodeReadline.createInterface)({
+    input: (0, _nodeFs.createReadStream)('', {
       fd
     }),
-    output: null,
-    console: false
+    output: undefined
   });
 }
 async function fileLineValidations(appId, envId, fileName, validations, searchReplace) {
@@ -57,7 +52,7 @@ async function fileLineValidations(appId, envId, fileName, validations, searchRe
   // Block until the processing completes
   await new Promise(resolve => readInterface.on('close', resolve));
   readInterface.close();
-  return Promise.all(validations.map(async validation => {
+  return Promise.all(validations.map(validation => {
     if (Object.prototype.hasOwnProperty.call(validation, 'postLineExecutionProcessing') && typeof validation.postLineExecutionProcessing === 'function') {
       return validation.postLineExecutionProcessing({
         fileName,
@@ -67,5 +62,6 @@ async function fileLineValidations(appId, envId, fileName, validations, searchRe
         searchReplace
       });
     }
+    return Promise.resolve();
   }));
 }

package/dist/lib/validations/site-type.js

@@ -11,11 +11,6 @@ var _isMultiSite = require("../../lib/validations/is-multi-site");
 var _isMultisiteDomainMapped = require("../../lib/validations/is-multisite-domain-mapped");
 var _utils = require("../../lib/validations/utils");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-/**
- * 
- * @format
- */
-
 /**
  * External dependencies
  */
@@ -41,7 +36,7 @@ const siteTypeValidations = {
     envId,
     searchReplace
   }) => {
-    const isMultiSite = await (0, _isMultiSite.isMultiSiteInSiteMeta)(appId, envId);
+    const isMultiSite = await (0, _isMultiSite.isMultiSiteInSiteMeta)(appId ?? 0, envId ?? 0);
     const track = _tracker.trackEventWithEnv.bind(null, appId, envId);
     debug(`\nAppId: ${appId} is ${isMultiSite ? 'a multisite.' : 'not a multisite'}`);
     debug(`The SQL dump provided is ${isMultiSiteSqlDump ? 'from a multisite.' : 'not from a multisite'}\n`);
@@ -67,7 +62,7 @@ const siteTypeValidations = {
     // Check if primary domain is mapped only if it exists
     // Also saves on a call to Parker by checking ahead
     if (primaryDomainExists) {
-      const isPrimaryDomainMapped = await (0, _isMultisiteDomainMapped.isMultisitePrimaryDomainMapped)(appId, envId, primaryDomainFromSQL);
+      const isPrimaryDomainMapped = await (0, _isMultisiteDomainMapped.isMultisitePrimaryDomainMapped)(appId ?? 0, envId ?? 0, primaryDomainFromSQL);
 
       // If site is multisite AND the primary domain is exists AND the primary is unmapped
       // then throw an error

package/dist/lib/validations/sql.js

@@ -12,11 +12,6 @@ var _lineByLine = require("../../lib/validations/line-by-line");
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-/**
- * 
- * @format
- */
-
 /**
  * External dependencies
  */
@@ -25,8 +20,6 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { de
  * Internal dependencies
  */
 
-// eslint-disable-next-line no-duplicate-imports
-
 let problemsFound = 0;
 let lineNum = 1;
 const tableNames = [];
@@ -48,16 +41,16 @@ const generalCheckFormatter = check => {
       problemsFound += 1;
     }
     for (const problem of validProblems) {
-      const text = `${problem.text || check.message} on line ${problem.lineNumber || ''}.`;
+      const text = `${problem.text ?? check.message} on line ${problem.lineNumber ?? ''}.`;
       if (problem.warning) {
         errors.push({
           warning: formatWarning(text),
-          recommendation: formatRecommendation(problem.recomendation || check.recommendation)
+          recommendation: formatRecommendation(problem.recomendation ?? check.recommendation)
         });
       } else {
         errors.push({
           error: formatError(text),
-          recommendation: formatRecommendation(problem.recomendation || check.recommendation)
+          recommendation: formatRecommendation(problem.recomendation ?? check.recommendation)
         });
       }
     }
@@ -112,7 +105,9 @@ const requiredCheckFormatter = (check, type, isImport) => {
 const infoCheckFormatter = check => {
   const infos = [];
   check.results.forEach(item => {
-    infos.push(item.text);
+    if (item.text) {
+      infos.push(item.text);
+    }
   });
   return {
     errors: [],
@@ -124,8 +119,8 @@ function checkTablePrefixes(results, errors, infos) {
   const notWPTables = [];
   const wpMultisiteTables = [];
   results.forEach(result => {
-    const tableName = result.text || '';
-    if (RegExp(/^wp_(\d+_)/).exec(tableName)) {
+    const tableName = result.text ?? '';
+    if (/^wp_(\d+_)/.exec(tableName)) {
       wpMultisiteTables.push(tableName);
     } else if (tableName.startsWith('wp_')) {
       wpTables.push(tableName);
@@ -287,7 +282,7 @@ const checks = {
     recommendation: "Use search-replace to change environment's domain"
   },
   engineInnoDB: {
-    matcher: / ENGINE=(?!(InnoDB))/i,
+    matcher: /\sENGINE\s?=(?!(\s?InnoDB))/i,
     matchHandler: lineNumber => ({
       lineNumber
     }),
@@ -325,7 +320,7 @@ const postValidation = async options => {
   for (const [type, check] of checkEntries) {
     const formattedOutput = check.outputFormatter(check, type, options.isImport);
     for (const error of formattedOutput.errors) {
-      if (error.warning) {
+      if ('warning' in error) {
         formattedWarnings.push(error);
       } else {
         formattedErrors.push(error);
@@ -391,7 +386,7 @@ const getTableNames = () => {
 };
 exports.getTableNames = getTableNames;
 const checkForTableName = line => {
-  const matches = line.match(/(?<=^CREATE\sTABLE\s)`?(?:(wp_[\d+_]?\w+))`?/);
+  const matches = /(?<=^CREATE\sTABLE\s)`?(?:(wp_[\d+_]?\w+))`?/.exec(line);
   if (matches) {
     const tableName = matches[1];
     // we should only have one match if we have any since we're looking at the start of the string
@@ -411,7 +406,7 @@ const perLineValidations = (line, options = DEFAULT_VALIDATION_OPTIONS) => {
   const checkKeys = Object.keys(checks).filter(checkItem => !options.skipChecks.includes(checkItem));
   for (const checkKey of checkKeys) {
     const check = checks[checkKey];
-    const results = line.match(check.matcher);
+    const results = line.match(check.matcher); // NOSONAR
     const extraCheckParams = options.extraCheckParams[checkKey];
     if (results) {
       check.results.push(check.matchHandler(lineNum, results, extraCheckParams));
@@ -424,8 +419,8 @@ const postLineExecutionProcessing = async ({
   skipChecks
 }) => {
   await postValidation({
-    isImport: isImport || false,
-    skipChecks: skipChecks || DEV_ENV_SPECIFIC_CHECKS,
+    isImport: isImport ?? false,
+    skipChecks: skipChecks ?? DEV_ENV_SPECIFIC_CHECKS,
     extraCheckParams: {}
   });
 };

package/dist/lib/validations/utils.js

@@ -23,7 +23,7 @@ function getMultilineStatement(statementRegex) {
    */
   return line => {
     const shouldStartCapture = statementRegex.test(line);
-    const shouldEndCapture = (shouldStartCapture || isCapturing) && /;$/.test(line);
+    const shouldEndCapture = (shouldStartCapture || isCapturing) && line.endsWith(';');
     if (shouldStartCapture) {
       isCapturing = true;
       matchingStatements[index] = [];

package/helpers/generate-docs.js

@@ -0,0 +1,151 @@
+const { spawn } = require( 'child_process' );
+const { once } = require( 'events' );
+
+async function runCommand( subcommands ) {
+	const childProcess = spawn( 'vip', subcommands );
+
+	let output = '';
+
+	for await ( const data of childProcess.stdout ) {
+		output += data.toString();
+	}
+	for await ( const data of childProcess.stderr ) {
+		output += data.toString();
+	}
+
+	const [ exitCode ] = await once( childProcess, 'exit' );
+
+	if ( exitCode !== 0 ) {
+		console.log( 'o', output );
+		throw new Error( `Script exited with code ${ exitCode }` );
+	}
+
+	return output.trim();
+}
+
+const USAGE_REGEXP = /Usage: (.*)/;
+const COMMAND_REGEXP = /(\S+)\s+(.*)/;
+const OPTION_REGEXP = /(-\S, --\S+)\s+(.*)/;
+
+const SECTION_COMMAND = 'commands';
+const SECTION_OPTIONS = 'options';
+const SECTION_EXAMPLES = 'examples';
+
+const parseOutput = output => {
+	const result = {};
+
+	const lines = output.split( '\n' );
+	let currentSection = '';
+
+	for ( let lineIx = 0; lineIx < lines.length; lineIx++ ) {
+		const line = lines[ lineIx ].trim();
+		if ( ! line ) {
+			continue;
+		}
+		if ( line.startsWith( 'Usage:' ) ) {
+			result.usage = line.match( USAGE_REGEXP )[ 1 ];
+			continue;
+		}
+
+		if ( line.startsWith( 'Commands:' ) ) {
+			result.commands = [];
+			currentSection = SECTION_COMMAND;
+			continue;
+		}
+		if ( line.startsWith( 'Options:' ) ) {
+			result.options = [];
+			currentSection = SECTION_OPTIONS;
+			continue;
+		}
+		if ( line.startsWith( 'Examples:' ) ) {
+			result.examples = [];
+			result.examplesRaw = '';
+			currentSection = SECTION_EXAMPLES;
+			continue;
+		}
+
+		if ( currentSection === SECTION_COMMAND ) {
+			const [ , command, description ] = line.match( COMMAND_REGEXP );
+			result.commands.push( {
+				command,
+				description,
+			} );
+			continue;
+		}
+		if ( currentSection === SECTION_OPTIONS ) {
+			if ( line.match( OPTION_REGEXP ) ) {
+				const [ , option, description ] = line.match( OPTION_REGEXP );
+				result.options.push( {
+					option,
+					description,
+				} );
+			} else {
+				console.log( 'Unknown option', line );
+			}
+			continue;
+		}
+		if ( currentSection === SECTION_EXAMPLES ) {
+			let description = '';
+			while ( ! lines[ lineIx ].trim().startsWith( '$' ) ) {
+				const descriptionLine = lines[ lineIx ].trim();
+				if ( description ) {
+					description += '\n';
+				}
+				if ( result.examplesRaw ) {
+					result.examplesRaw += '\n';
+				}
+				result.examplesRaw += descriptionLine;
+				description += descriptionLine;
+				lineIx++;
+			}
+			const usage = lines[ lineIx ] && lines[ lineIx ].trim();
+			result.examplesRaw += '\n' + usage;
+			result.examples.push( {
+				description,
+				usage,
+			} );
+		}
+	}
+
+	return result;
+};
+
+const processCommand = async subcommands => {
+	const fullCommand = subcommands.join( ' ' );
+	console.error( 'Processing', fullCommand, '...' );
+
+	const output = await runCommand( subcommands.concat( [ '--help' ] ) );
+	const parsedOutput = parseOutput( output );
+
+	const commandCount = parsedOutput.commands?.length || 0;
+	const commandOutputs = [];
+	for ( let commandIx = 0; commandIx < commandCount; commandIx++ ) {
+		const element = parsedOutput.commands[ commandIx ];
+		// otherwise the parallel run will randomly fail on too many requests
+		// eslint-disable-next-line no-await-in-loop
+		commandOutputs.push( await processCommand( subcommands.concat( [ element.command ] ) ) );
+	}
+	console.error( `Processed ${ fullCommand } -> ${ commandOutputs.length } subcommands` );
+	for ( let commandIx = 0; commandIx < commandCount; commandIx++ ) {
+		const element = parsedOutput.commands[ commandIx ];
+		const commandOutput = commandOutputs[ commandIx ];
+		commandOutput.name = element.command;
+		commandOutput.description = element.description;
+		parsedOutput.commands[ commandIx ] = commandOutput;
+	}
+
+	return parsedOutput;
+};
+
+const main = async () => {
+	const version = await runCommand( [ '--version' ] );
+
+	console.error( 'triggering command processing...' );
+	const result = await processCommand( [] );
+	console.error( 'command processing done' );
+	result.version = version;
+
+	console.log( JSON.stringify( result, null, 2 ) );
+};
+
+main();