@automattic/vip 3.18.0 → 3.19.1

package/dist/bin/vip-app.js

@@ -43,9 +43,13 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
   await (0, _tracker.trackEvent)('app_command_success');
 
   // Clone the read-only response object so we can modify it
-  const clonedResponse = Object.assign({}, res);
+  const clonedResponse = {
+    ...res
+  };
   clonedResponse.environments = clonedResponse.environments.map(env => {
-    const clonedEnv = Object.assign({}, env);
+    const clonedEnv = {
+      ...env
+    };
     clonedEnv.name = (0, _command.getEnvIdentifier)(env);
 
     // Use the short version of git commit hash

package/dist/bin/vip-import-media.js

@@ -67,7 +67,7 @@ function isSupportedUrl(urlToTest) {
   let url;
   try {
     url = new URL(urlToTest);
-  } catch (err) {
+  } catch {
     return false;
   }
   return url.protocol === 'http:' || url.protocol === 'https:';

package/dist/bin/vip-import-sql.js

@@ -103,8 +103,8 @@ function isValidMd5(md5) {
 }
 
 /**
- * @param {AppForImport} app
- * @param {EnvForImport} env
+ * @param {import('../lib/site-import/db-file-import').AppForImport} app
+ * @param {import('../lib/site-import/db-file-import').EnvForImport} env
  * @param {string} fileNameOrURL
  * @param {boolean} isUrl
  * @param {string|null} md5
@@ -147,7 +147,7 @@ async function gates(app, env, fileNameOrURL, isUrl = false, md5 = null) {
     }
     try {
       await (0, _clientFileUploader.checkFileAccess)(fileName);
-    } catch (err) {
+    } catch {
       await track('import_sql_command_error', {
         error_type: 'sqlfile-unreadable'
       });
@@ -367,7 +367,7 @@ const displayPlaybook = ({
     }
   }
 };
-void (0, _command.default)({
+(0, _command.default)({
   appContext: true,
   appQuery,
   envContext: true,

package/dist/bin/vip-import-validate-files.js

@@ -8,7 +8,6 @@
 exports.__esModule = true;
 exports.vipImportValidateFilesCmd = vipImportValidateFilesCmd;
 var _chalk = _interopRequireDefault(require("chalk"));
-var _url = _interopRequireDefault(require("url"));
 var _command = _interopRequireDefault(require("../lib/cli/command"));
 var _config = require("../lib/media-import/config");
 var _tracker = require("../lib/tracker");
@@ -24,9 +23,7 @@ async function vipImportValidateFilesCmd(arg = []) {
    *
    * Manipulating the file path/name to extract the folder name
    */
-  const folder = arg.join(); // File comes in as an array as part of the args- turn it into a string
-  arg = _url.default.parse(folder); // Then parse the file to its URL parts
-  const filePath = arg.path; // Extract the path of the file
+  const filePath = arg.join(); // File comes in as an array as part of the args- turn it into a string
 
   if (!(await (0, _vipImportValidateFiles.isDirectory)(filePath))) {
     console.error(_chalk.default.red('✕ Error:'), 'The given path is not a directory. Provide a valid directory path.');

package/dist/bin/vip-wp.js

@@ -103,7 +103,6 @@ const bindStreamEvents = ({
     if (!isSubShell) {
       subShellRl.close();
       process.exit();
-      return;
     }
     subShellRl.resume();
     subShellRl.prompt();
@@ -131,6 +130,14 @@ const getTokenForCommand = async (appId, envId, command) => {
     }
   });
 };
+
+/**
+ * Returns the error so it can be caught by the `socket.on('error')`.
+ *
+ * @param {Error} err
+ * @returns {Error}
+ */
+const onSocketError = err => err;
 const launchCommandAndGetStreams = async ({
   socket,
   guid,
@@ -162,10 +169,7 @@ const launchCommandAndGetStreams = async ({
     socket.close();
     exit.withError(`Cancel received from server: ${message}`);
   });
-  (0, _socket2.default)(socket).on('error', err => {
-    // This returns the error so it can be catched by the socket.on('error')
-    return err;
-  });
+  (0, _socket2.default)(socket).off('error', onSocketError).on('error', onSocketError);
   socket.on('error', err => {
     if (err === 'Rate limit exceeded') {
       console.log(_chalk.default.red('\nError:'), 'Rate limit exceeded: Please wait a moment and try again.');
@@ -262,10 +266,17 @@ const bindReconnectEvents = ({
 
     // create a new input stream so that we can still catch things like SIGINT while reconnecting
     if (currentJob.stdinStream) {
-      process.stdin.unpipe(currentJob.stdinStream);
+      unpipeStreamsFromProcess({
+        stdin: currentJob.stdinStream,
+        stdout: currentJob.stdoutStream
+      });
     }
-    process.stdin.pipe(_socket2.default.createStream());
+    currentJob.stdinStream = _socket2.default.createStream();
     currentJob.stdoutStream = _socket2.default.createStream();
+    pipeStreamsToProcess({
+      stdin: currentJob.stdinStream,
+      stdout: currentJob.stdoutStream
+    });
     bindStreamEvents({
       subShellRl,
       isSubShell,

package/dist/bin/vip.js

@@ -21,7 +21,7 @@ const tokenURL = 'https://dashboard.wpvip.com/me/cli/token';
 const customDeployToken = process.env.WPVIP_DEPLOY_TOKEN;
 const runCmd = async function () {
   const cmd = (0, _command.default)();
-  cmd.command('logout', 'Log out the current authenticated VIP-CLI user.').command('app', 'Interact with applications that the current authenticated VIP-CLI user has permission to access.').command('backup', 'Generate a backup of an environment.').command('cache', 'Manage page cache for an environment.').command('config', 'Manage environment configurations.').command('dev-env', 'Create and manage VIP Local Development Environments.').command('export', 'Export a copy of data associated with an environment.').command('import', 'Import media or SQL database files to an environment.').command('logs', 'Retrieve Runtime Logs from an environment.').command('search-replace', 'Search for a string in a local SQL file and replace it with a new string.').command('slowlogs', 'Retrieve MySQL slow query logs from an environment.').command('db', "Access an environment's database.").command('sync', 'Sync the database from production to a non-production environment.').command('whoami', 'Retrieve details about the current authenticated VIP-CLI user.').command('validate', 'Scan a Node.js codebase for issues that could prevent building or deploying.').command('wp', 'Execute a WP-CLI command against an environment.');
+  cmd.command('logout', 'Log out the current authenticated VIP-CLI user.').command('app', 'Interact with applications that the current authenticated VIP-CLI user has permission to access.').command('backup', 'Generate a backup of an environment.').command('cache', 'Manage page cache for an environment.').command('config', 'Manage environment configurations.').command('dev-env', 'Create and manage VIP Local Development Environments.').command('export', 'Export a copy of data associated with an environment.').command('import', 'Import media or SQL database files to an environment.').command('logs', 'Retrieve Runtime Logs from an environment.').command('search-replace', 'Search for a string in a local SQL file and replace it with a new string.').command('slowlogs', 'Retrieve MySQL slow query logs from an environment.').command('db', "Access an environment's database.").command('sync', 'Sync the database from production to a non-production environment.').command('whoami', 'Retrieve details about the current authenticated VIP-CLI user.').command('wp', 'Execute a WP-CLI command against an environment.');
   cmd.argv(process.argv);
 };
 

package/dist/commands/backup-db.js

@@ -80,8 +80,6 @@ async function createBackupJob(appId, envId) {
 
 // Library for a possible command in the future: vip backup db @app.env
 class BackupDBCommand {
-  app;
-  env;
   job;
   jobStatus;
   jobAge;
@@ -91,11 +89,11 @@ class BackupDBCommand {
     PREPARE: 'prepare',
     GENERATE: 'generate'
   };
-  track;
   progressTracker;
-  constructor(app, env, trackerFn = async () => {}) {
+  constructor(app, env, track = async () => {}) {
     this.app = app;
     this.env = env;
+    this.track = track;
     this.progressTracker = new _progress.ProgressTracker([{
       id: this.steps.PREPARE,
       name: 'Preparing for backup generation'
@@ -103,7 +101,6 @@ class BackupDBCommand {
       id: this.steps.GENERATE,
       name: 'Generating backup'
     }]);
-    this.track = trackerFn;
   }
   log(msg) {
     if (this.silent) {

package/dist/commands/dev-env-sync-sql.js

@@ -3,8 +3,10 @@
 
 exports.__esModule = true;
 exports.DevEnvSyncSQLCommand = void 0;
+exports.findSiteHomeUrl = findSiteHomeUrl;
 var _vipSearchReplace = require("@automattic/vip-search-replace");
 var _chalk = _interopRequireDefault(require("chalk"));
+var _debug = _interopRequireDefault(require("debug"));
 var _fs = _interopRequireDefault(require("fs"));
 var _promises = require("node:stream/promises");
 var _devEnvImportSql = require("./dev-env-import-sql");
@@ -17,6 +19,8 @@ var _utils = require("../lib/utils");
 var _lineByLine = require("../lib/validations/line-by-line");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const debug = (0, _debug.default)('@automattic/vip:bin:dev-environment');
+
 /**
  * Replaces the domain in the given URL
  *
@@ -44,11 +48,11 @@ function stripProtocol(url) {
  * @return Site home url. null if not found
  */
 function findSiteHomeUrl(sql) {
-  const regex = `['"](siteurl|home)['"],\\s?['"](.*?)['"]`;
-  const url = sql.match(regex)?.[2] || '';
+  const regex = /(['"])(?:siteurl|home)\1,\s*\1([Hh][Tt][Tt][Pp][Ss]?:\/\/.+?)\1/;
+  const url = regex.exec(sql)?.[2] ?? '';
   try {
-    new URL(url);
-    return url;
+    const parsed = new URL(url);
+    return parsed.hostname ? url : null;
   } catch {
     return null;
   }
@@ -174,6 +178,10 @@ class DevEnvSyncSQLCommand {
     if (!networkSites) return;
     const primaryUrl = networkSites.find(site => site?.blogId === 1)?.homeUrl;
     const primaryDomain = primaryUrl ? new URL(primaryUrl).hostname : '';
+    debug('Network sites: %j, primary URL: %s, primary domain: %s', networkSites.map(site => ({
+      blogId: site?.blogId,
+      homeUrl: site?.homeUrl
+    })), primaryUrl, primaryDomain);
     for (const site of networkSites) {
       if (!site?.blogId || site.blogId === 1) continue;
       const url = site?.homeUrl;
@@ -285,6 +293,7 @@ DROP PROCEDURE vip_sync_update_blog_domains;
     try {
       console.log('Extracting site urls from the SQL file...');
       this.siteUrls = await extractSiteUrls(this.sqlFile);
+      debug('Extracted site URLs: %j', this.siteUrls);
     } catch (err) {
       const error = err;
       await this.track('error', {

package/dist/commands/phpmyadmin.js

@@ -106,19 +106,16 @@ async function getPhpMyAdminStatus(appId, envId) {
   return resp?.data?.app?.environments?.[0]?.phpMyAdminStatus?.status;
 }
 class PhpMyAdminCommand {
-  app;
-  env;
   silent;
-  track;
   steps = {
     ENABLE: 'enable',
     GENERATE: 'generate'
   };
   progressTracker;
-  constructor(app, env, trackerFn = async () => {}) {
+  constructor(app, env, track = async () => {}) {
     this.app = app;
     this.env = env;
-    this.track = trackerFn;
+    this.track = track;
     this.progressTracker = new _progress.ProgressTracker([{
       id: this.steps.ENABLE,
       name: 'Enabling PHPMyAdmin for this environment'
@@ -141,12 +138,12 @@ class PhpMyAdminCommand {
     const {
       default: open
     } = await import('open');
-    void open(url, {
+    return open(url, {
       wait: false
     });
   }
   async getStatus() {
-    return await getPhpMyAdminStatus(this.app.id, this.env.id);
+    return getPhpMyAdminStatus(this.app.id, this.env.id);
   }
   async maybeEnablePhpMyAdmin() {
     const status = await this.getStatus();

package/dist/commands/wp-ssh.js

@@ -49,15 +49,13 @@ class NonZeroExitCodeError extends Error {
 }
 exports.NonZeroExitCodeError = NonZeroExitCodeError;
 class WPCliCommandOverSSH {
-  app;
-  env;
   track;
   constructor(app, env) {
     this.app = app;
     this.env = env;
     this.track = (0, _tracker.makeCommandTracker)('wp', {
-      app: this.app.id,
-      env: this.env.id,
+      app: app.id,
+      env: env.id,
       execution_type: 'ssh'
     });
   }
@@ -188,7 +186,7 @@ class WPCliCommandOverSSH {
   async getSSHAuthForCommand(command, extraTrackingInfo) {
     const api = (0, _api.default)();
     try {
-      return api.mutate({
+      return await api.mutate({
         mutation: TRIGGER_WP_CLI_COMMAND_MUTATION,
         variables: {
           input: {

package/dist/lib/analytics/clients/tracks.js

@@ -18,7 +18,6 @@ const validEventOrPropNamePattern = /^[a-z_][a-z0-9_]*$/;
 // TODO: add batch support (can include multiples in `events` array)
 
 class Tracks {
-  eventPrefix;
   userAgent;
   baseParams;
   static ENDPOINT = 'https://public-api.wordpress.com/rest/v1.1/tracks/record';

package/dist/lib/analytics/index.js

@@ -17,7 +17,6 @@ const client_info = {
 /* eslint-enable camelcase */
 
 class Analytics {
-  clients;
   constructor(clients) {
     this.clients = clients;
   }

package/dist/lib/backup-storage-availability/backup-storage-availability.js

@@ -13,7 +13,6 @@ var _format = require("../cli/format");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const oneGiBInBytes = 1024 * 1024 * 1024;
 class BackupStorageAvailability {
-  archiveSize;
   constructor(archiveSize) {
     this.archiveSize = archiveSize;
   }

package/dist/lib/cli/command.js

@@ -316,21 +316,19 @@ _args.default.argv = async function (argv, cb) {
   }
 
   // Negotiate flag values
-  switch (_opts.module) {
-    case 'import-media':
-      if ([true, 'true', 'yes'].includes(options.saveErrorLog)) {
-        options.saveErrorLog = 'true';
-      } else if ([false, 'false', 'no'].includes(options.saveErrorLog)) {
-        options.saveErrorLog = 'false';
-      } else {
-        options.saveErrorLog = 'prompt';
-      }
-      break;
+  if (_opts.module === 'import-media') {
+    if ([true, 'true', 'yes'].includes(options.saveErrorLog)) {
+      options.saveErrorLog = 'true';
+    } else if ([false, 'false', 'no'].includes(options.saveErrorLog)) {
+      options.saveErrorLog = 'false';
+    } else {
+      options.saveErrorLog = 'prompt';
+    }
   }
 
   // Prompt for confirmation if necessary
   if (_opts.requireConfirm && !options.force) {
-    /** @type {Tuple[]} */
+    /** @type {import('./format').Tuple[]} */
     const info = [];
     if (options.app) {
       info.push({

package/dist/lib/cli/config.js

@@ -2,19 +2,38 @@
 
 exports.__esModule = true;
 exports.default = void 0;
+exports.loadConfigFile = loadConfigFile;
 var _debug = _interopRequireDefault(require("debug"));
+var _nodeFs = require("node:fs");
+var _nodePath = _interopRequireDefault(require("node:path"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// I don't like using synchronous versions, but until we migrate to ESM, we have to.
+
 const debug = (0, _debug.default)('@automattic/vip:lib:cli:config');
-let configFromFile;
-try {
+function loadConfigFile() {
+  const paths = [
   // Get `local` config first; this will only exist in dev as it's npmignore-d.
-  // eslint-disable-next-line @typescript-eslint/no-var-requires
-  configFromFile = require('../../../config/config.local.json');
-  debug('Loaded config data from config.local.json');
-} catch {
-  // Fall back to `publish` config file.
-  // eslint-disable-next-line @typescript-eslint/no-var-requires
-  configFromFile = require('../../../config/config.publish.json');
-  debug('Loaded config data from config.publish.json');
+  _nodePath.default.join(__dirname, '../../../config/config.local.json'), _nodePath.default.join(__dirname, '../../../config/config.publish.json')];
+  for (const filePath of paths) {
+    try {
+      const data = (0, _nodeFs.readFileSync)(filePath, 'utf-8');
+      debug(`Found config file at ${filePath}`);
+      return JSON.parse(data);
+    } catch (err) {
+      if (!(err instanceof Error) || !('code' in err) || err.code !== 'ENOENT') {
+        debug(`Error reading config file at ${filePath}:`, err);
+      }
+    }
+  }
+  return null;
+}
+const configFromFile = loadConfigFile();
+if (null === configFromFile) {
+  // This should not happen because `config/config.publish.json` is always present.
+  console.error('FATAL ERROR: Could not find a valid configuration file');
+  process.exit(1);
 }
-var _default = exports.default = configFromFile;
+
+// Without this, TypeScript will export `configFromFile` as `Config | null`
+const exportedConfig = configFromFile;
+var _default = exports.default = exportedConfig;

package/dist/lib/cli/format.js

@@ -91,14 +91,10 @@ function keyValue(values) {
     value
   } of values) {
     let formattedValue;
-    switch (key.toLowerCase() // NOSONAR
-    ) {
-      case 'environment':
-        formattedValue = formatEnvironment(value);
-        break;
-      default:
-        formattedValue = value;
-        break;
+    if (key.toLowerCase() === 'environment') {
+      formattedValue = formatEnvironment(value);
+    } else {
+      formattedValue = value;
     }
     lines.push(`+ ${key}: ${formattedValue}`);
   }

package/dist/lib/config/software.js

@@ -315,7 +315,8 @@ const formatSoftwareSettings = (softwareSetting, includes, format) => {
   if (includes.includes('available_versions')) {
     result.available_versions = _optionsForVersion(softwareSetting).filter(option => !option.deprecated).map(option => option.value);
     if (format !== 'json') {
-      result.available_versions = result.available_versions.sort().join(',');
+      result.available_versions.sort((lhs, rhs) => lhs.localeCompare(rhs));
+      result.available_versions = result.available_versions.join(',');
     }
   }
   return result;

package/dist/lib/custom-deploy/custom-deploy.js

@@ -48,7 +48,7 @@ async function validateCustomDeployKey(app, env) {
       throw new Error('Not found');
     }
     return result.data?.validateCustomDeployAccess;
-  } catch (error) {
+  } catch {
     exit.withError(`Unauthorized: Invalid or non-existent custom deploy key for environment.`);
   }
 }
@@ -93,7 +93,7 @@ async function validateFile(appId, envId, fileMeta) {
   }
   try {
     await (0, _clientFileUploader.checkFileAccess)(fileName);
-  } catch (err) {
+  } catch {
     await track('deploy_app_command_error', {
       error_type: 'appfile-unreadable'
     });

package/dist/lib/database.js

@@ -28,15 +28,15 @@ const getSqlDumpDetails = async filePath => {
     crlfDelay: Infinity
   });
   let isMyDumper = false;
-  let sourceDB = '';
+  let sourceDB;
   let currentLineNumber = 0;
   for await (const line of readLine) {
     if (line === '') {
       continue;
     }
-    const metadataMatch = line.match(/^-- metadata.header /);
-    const sourceDBMatch = line.match(/^-- (.*)-schema-create.sql/) ?? [];
-    const sourceDBName = sourceDBMatch[1];
+    const metadataMatch = /^-- metadata.header /.exec(line);
+    const sourceDBMatch = /^-- (.*)-schema-create.sql/.exec(line);
+    const sourceDBName = sourceDBMatch?.[1];
     if (metadataMatch && !isMyDumper) {
       isMyDumper = true;
     }
@@ -87,13 +87,13 @@ const getSqlFileStreamFromCompressedFile = async filePath => {
   throw new Error('Not a supported compressed file');
 };
 const fixMyDumperTransform = () => {
+  const regex = /^-- ([^ ]+) \d+$/;
   return new _nodeStream.Transform({
     transform(chunk, _encoding, callback) {
       const chunkString = chunk.toString();
       const lineEnding = chunkString.includes('\r\n') ? '\r\n' : '\n';
-      const regex = /^-- ([^ ]+) [0-9]+$/;
       const lines = chunk.toString().split(lineEnding).map(line => {
-        const match = line.match(regex);
+        const match = regex.exec(line);
         if (!match) {
           return line;
         }

package/dist/lib/dev-environment/dev-environment-cli.js

@@ -300,11 +300,13 @@ async function processWordPress(preselectedValue, defaultValue) {
   if (versions.length) {
     versions.sort((before, after) => before.tag < after.tag ? 1 : -1);
     const match = versions.find(({
+      prerelease,
       tag
-    }) => tag === result.tag);
-    if (typeof match === 'undefined') {
+    }) => result.tag === 'latest' ? !prerelease : tag === result.tag);
+    if (match === undefined) {
       throw new _userError.default(`Unknown or unsupported WordPress version: ${result.tag}.`);
     }
+    result.tag = match.tag;
   }
   debug(result);
   return result;
@@ -677,7 +679,7 @@ function processVersionOption(value) {
 const phpVersionsSupported = Object.keys(_devEnvironment.DEV_ENVIRONMENT_PHP_VERSIONS).join(', ');
 function addDevEnvConfigurationOptions(command) {
   // We leave the third parameter to undefined on some because the defaults are handled in preProcessInstanceData()
-  return command.option('wordpress', 'Manage the version of WordPress. Accepts a string value for major versions (6.x). Defaults to the most recent version of WordPress.', undefined, processVersionOption).option(['u', 'mu-plugins'], 'Manage the source for VIP MU plugins. Accepts "demo" (default) for a read-only image of the staging branch, or a path to a built copy of VIP MU plugins on the local machine.').option('app-code', 'Manage the source for application code. Accepts "demo" (default) for a read-only image of WordPress VIP skeleton application code, or a path to a VIP formatted application repo on the local machine.').option('phpmyadmin', 'Enable or disable phpMyAdmin, disabled by default. Accepts "y" (default value) to enable or "n" to disable. When enabled, refer to the value of "PHPMYADMIN URLS" in the information output for a local environment for the URL to access phpMyAdmin.', undefined, processBooleanOption).option('xdebug', 'Enable or disable XDebug, disabled by default. Accepts "y" (default value) to enable or "n" to disable.', undefined, processBooleanOption).option('xdebug_config', 'Override some default configuration settings for Xdebug. Accepts a string value that is assigned to the XDEBUG_CONFIG environment variable.').option('elasticsearch', 'Enable or disable Elasticsearch (required by Enterprise Search), disabled by default. Accepts "y" (default value) to enable or "n" to disable.', undefined, processBooleanOption).option(['r', 'media-redirect-domain'], 'Configure media files to be proxied from a VIP Platform environment. Accepts a string value for the primary domain of the VIP Platform environment or "n" to disable the media proxy.', undefined, processMediaRedirectDomainOption).option('php', `Manage the version of PHP. Accepts a string value for minor versions: ${phpVersionsSupported}`, undefined, processVersionOption).option('cron', 'Enable or disable cron, disabled by default. Accepts "y" (default value) to enable or "n" to disable.', undefined, processBooleanOption).option(['A', 'mailpit'], 'Enable or disable Mailpit, disabled by default. Accepts "y" (default value) to enable or "n" to disable.', undefined, processBooleanOption).option(['H', 'photon'], 'Enable or disable Photon, disabled by default. Accepts "y" (default value) to enable or "n" to disable.', undefined, processBooleanOption);
+  return command.option('wordpress', 'Manage the version of WordPress. Accepts a string value for major versions (6.x) or "latest". Defaults to the recommended version of WordPress for development.', undefined, processVersionOption).option(['u', 'mu-plugins'], 'Manage the source for VIP MU plugins. Accepts "demo" (default) for a read-only image of the staging branch, or a path to a built copy of VIP MU plugins on the local machine.').option('app-code', 'Manage the source for application code. Accepts "demo" (default) for a read-only image of WordPress VIP skeleton application code, or a path to a VIP formatted application repo on the local machine.').option('phpmyadmin', 'Enable or disable phpMyAdmin, disabled by default. Accepts "y" (default value) to enable or "n" to disable. When enabled, refer to the value of "PHPMYADMIN URLS" in the information output for a local environment for the URL to access phpMyAdmin.', undefined, processBooleanOption).option('xdebug', 'Enable or disable XDebug, disabled by default. Accepts "y" (default value) to enable or "n" to disable.', undefined, processBooleanOption).option('xdebug_config', 'Override some default configuration settings for Xdebug. Accepts a string value that is assigned to the XDEBUG_CONFIG environment variable.').option('elasticsearch', 'Enable or disable Elasticsearch (required by Enterprise Search), disabled by default. Accepts "y" (default value) to enable or "n" to disable.', undefined, processBooleanOption).option(['r', 'media-redirect-domain'], 'Configure media files to be proxied from a VIP Platform environment. Accepts a string value for the primary domain of the VIP Platform environment or "n" to disable the media proxy.', undefined, processMediaRedirectDomainOption).option('php', `Manage the version of PHP. Accepts a string value for minor versions: ${phpVersionsSupported}`, undefined, processVersionOption).option('cron', 'Enable or disable cron, disabled by default. Accepts "y" (default value) to enable or "n" to disable.', undefined, processBooleanOption).option(['A', 'mailpit'], 'Enable or disable Mailpit, disabled by default. Accepts "y" (default value) to enable or "n" to disable.', undefined, processBooleanOption).option(['H', 'photon'], 'Enable or disable Photon, disabled by default. Accepts "y" (default value) to enable or "n" to disable.', undefined, processBooleanOption);
 }
 
 /**

package/dist/lib/dev-environment/dev-environment-core.js

@@ -155,8 +155,6 @@ function preProcessInstanceData(instanceData) {
     // We need to make sure the redirect is an absolute path
     newInstanceData.mediaRedirectDomain = `https://${instanceData.mediaRedirectDomain}`;
   }
-
-  // isNaN supports only number in TypeScript, actually, because isNaN('123') returns false despite being a string
   if (isNaN(instanceData.wordpress.tag)) {
     newInstanceData.wordpress.tag = 'trunk';
   }
@@ -712,7 +710,8 @@ async function isVersionListExpired(cacheFile, ttl) {
     } = await _nodeFs.default.promises.stat(cacheFile);
     expire.setSeconds(expire.getSeconds() + ttl);
     return Number(new Date()) > Number(expire);
-  } catch (err) {
+  } catch (error) {
+    debug(`Error checking version list expiration for cache file ${cacheFile}:`, error);
     return true;
   }
 }
@@ -844,7 +843,6 @@ function getVSCodeWorkspacePath(slug) {
 function generatePHPStormWorkspace(slug) {
   debug('Generating PHPStorm Workspace');
   const location = getEnvironmentPath(slug);
-  // const location = location;
   const instanceData = readEnvironmentData(slug);
   const pathMappings = generatePathMappings(location, instanceData);
 

package/dist/lib/dev-environment/dev-environment-database.js

@@ -2,8 +2,11 @@
 
 exports.__esModule = true;
 exports.reIndexSearch = exports.generatePassword = exports.flushCache = exports.executeQuery = exports.dataCleanup = exports.addAdminUser = void 0;
+var _debug = _interopRequireDefault(require("debug"));
 var _nodeCrypto = require("node:crypto");
 var _devEnvironmentCore = require("./dev-environment-core");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const debug = (0, _debug.default)('@automattic/vip:bin:dev-environment');
 const generatePassword = () => {
   const chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_';
   const passwordLength = 12;
@@ -36,6 +39,7 @@ const dataCleanup = async (lando, slug, quiet) => {
   } catch (error) {
     // This must not be a fatal error
     console.log('WARNING: data cleanup failed.');
+    debug('Error during data cleanup:', error);
   }
 };
 exports.dataCleanup = dataCleanup;

package/dist/lib/dev-environment/dev-environment-lando.js

@@ -112,7 +112,8 @@ async function regenerateLandofile(lando, instancePath) {
     const backup = `${landoFile}.${now}`;
     await (0, _promises2.rename)(landoFile, backup);
     console.warn(_chalk.default.yellow('Backed up %s to %s'), landoFile, backup);
-  } catch (err) {
+  } catch (error) {
+    debug(`Failed to backup lando file ${landoFile}:`, error);
     // Rename failed - possibly the file does not exist. Silently ignoring.
   }
   const slug = _nodePath.default.basename(instancePath);
@@ -409,7 +410,7 @@ async function tryResolveDomains(urls) {
   const domains = [...new Set(urls.filter(url => url.toLowerCase().startsWith('http')).map(url => {
     try {
       return new URL(url).hostname;
-    } catch (err) {
+    } catch {
       return undefined;
     }
   }).filter(domain => domain !== undefined))];

package/dist/lib/keychain/insecure.js

@@ -5,7 +5,6 @@ exports.default = void 0;
 var _configstore = _interopRequireDefault(require("configstore"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 class Insecure {
-  file;
   configstore;
   constructor(file) {
     this.file = file;

package/dist/lib/keychain.js

@@ -5,17 +5,18 @@ exports.default = void 0;
 var _debug = _interopRequireDefault(require("debug"));
 var _insecure = _interopRequireDefault(require("./keychain/insecure"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-let exportValue;
+let keychain;
 const debug = (0, _debug.default)('@automattic/vip:keychain');
 try {
   // Try using Secure keychain ("keytar") first
   // eslint-disable-next-line @typescript-eslint/no-var-requires
   const Secure = require('./keychain/secure');
-  exportValue = new Secure();
+  keychain = new Secure();
 } catch (error) {
   debug('Cannot use Secure keychain; falling back to Insecure keychain (Details: %o)', error);
 
   // Fallback to Insecure keychain if we can't
-  exportValue = new _insecure.default('vip-go-cli');
+  keychain = new _insecure.default('vip-go-cli');
 }
-var _default = exports.default = exportValue;
+const exportedKeychain = keychain;
+var _default = exports.default = exportedKeychain;

package/dist/lib/media-import/config.js

@@ -21,5 +21,5 @@ async function getMediaImportConfig() {
     variables: {},
     fetchPolicy: 'network-only'
   });
-  return response?.data?.mediaImportConfig;
+  return response?.data?.mediaImportConfig ?? null;
 }