@automattic/vip 2.29.0-dev1 → 2.29.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 ## Changelog
 
+### 2.29.1
+
+- #1372 fix(export): Make vip-export-sql.js executable
+
+### 2.29.0
+
+- #1362	feature(dev-env): Add vip export sql command
+- #1357	chore(deps): Update semver from 7.5.0 to 7.5.1
+- #1360	chore(dev-deps): Update flow-bin from 0.205.1 to 0.206.0
+- #1365	chore(deps): Fix CVE-2023-32695
+- #1356	fix(dev-env): Handle `--media-redirect-domain` in `vip dev-env update`
+- #1361	chore(dev-deps): Update packages related to linting
+- #1364	fix(dev-env): Fix "Cannot read properties of undefined" in `preProcessInstanceData()`
+- #1363	fix(dev-env): Add error handling to readEnvironmentData()
+- #1317	Auto-login support
+
 ### 2.28.3
 
 - #1352 chore(deps): Update node-fetch from 2.6.9 to 2.6.11

package/assets/dev-env.lando.template.yml.ejs

@@ -53,6 +53,9 @@ services:
         XDEBUG: <%= xdebug ? 'enable' : 'disable' %>
 <% if ( xdebugConfig ) { %>
         XDEBUG_CONFIG: "<%= xdebugConfig %>"
+<% } %>
+<% if ( autologinKey ) { %>
+        VIP_DEV_AUTOLOGIN_KEY: "<%= autologinKey %>"
 <% } %>
         LANDO_NO_USER_PERMS: 'enable'
         LANDO_NEEDS_EXEC: 1

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

@@ -16,10 +16,14 @@
 
 var _command = _interopRequireDefault(require("../lib/cli/command"));
 var _exportSql = require("../commands/export-sql");
+var _tracker = require("../lib/tracker");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 const examples = [{
-  usage: 'vip export sql @mysite.develop --output=/home/user/export.sql.gz',
-  description: 'Export SQL file from your site and save it to the specified location'
+  usage: 'vip export sql @mysite.develop',
+  description: 'Export SQL file from your site and save it to the current directory'
+}, {
+  usage: 'vip export sql @mysite.develop --output=~/Desktop/export.sql.gz',
+  description: 'The output file can be specified with the --output flag'
 }];
 const appQuery = `
   id,
@@ -46,6 +50,12 @@ const appQuery = `
   env,
   output
 }) => {
-  const exportCommand = new _exportSql.ExportSQLCommand(app, env, output);
+  const trackerFn = (0, _tracker.makeCommandTracker)('export_sql', {
+    app: app.id,
+    env: env.uniqueLabel
+  });
+  await trackerFn('execute');
+  const exportCommand = new _exportSql.ExportSQLCommand(app, env, output, trackerFn);
   await exportCommand.run();
+  await trackerFn('success');
 });

package/dist/bin/vip-export.js

@@ -12,6 +12,6 @@
 var _command = _interopRequireDefault(require("../lib/cli/command"));
 var _tracker = require("../lib/tracker");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-(0, _command.default)().command('sql', 'Import SQL to your database from a file').example('vip export sql @mysite.develop', 'Export SQL file from your site').argv(process.argv, async () => {
+(0, _command.default)().command('sql', 'Export the contents of your database to an SQL file').example('vip export sql @mysite.develop', 'Export the contents of your database to an SQL file').argv(process.argv, async () => {
   await (0, _tracker.trackEvent)('vip_export_command_execute');
 });

package/dist/commands/export-sql.js

@@ -8,7 +8,7 @@ var _graphqlTag = _interopRequireDefault(require("graphql-tag"));
 var _fs = _interopRequireDefault(require("fs"));
 var _https = _interopRequireDefault(require("https"));
 var _path = _interopRequireDefault(require("path"));
-var _api = _interopRequireDefault(require("../lib/api"));
+var _api = _interopRequireWildcard(require("../lib/api"));
 var _format = require("../lib/cli/format");
 var _progress = require("../lib/cli/progress");
 var exit = _interopRequireWildcard(require("../lib/cli/exit"));
@@ -162,8 +162,10 @@ async function generateDownloadLink(appId, envId, backupId) {
  * @throws {Error} Throws an error if the job creation fails
  */
 async function createExportJob(appId, envId, backupId) {
+  // Disable global error handling so that we can handle errors ourselves
+  (0, _api.disableGlobalGraphQLErrorHandling)();
   const api = await (0, _api.default)();
-  const response = await api.mutate({
+  await api.mutate({
     mutation: CREATE_EXPORT_JOB_MUTATION,
     variables: {
       input: {
@@ -173,16 +175,9 @@ async function createExportJob(appId, envId, backupId) {
       }
     }
   });
-  const {
-    data: {
-      startDBBackupCopy: {
-        success
-      }
-    }
-  } = response;
-  if (!success) {
-    throw new Error();
-  }
+
+  // Re-enable global error handling
+  (0, _api.enableGlobalGraphQLErrorHandling)();
 }
 
 /**
@@ -195,18 +190,18 @@ class ExportSQLCommand {
     DOWNLOAD_LINK: 'downloadLink',
     DOWNLOAD: 'download'
   };
-
   /**
    * Creates an instance of SQLExportCommand
    *
-   * @param {any}    app        The application object
-   * @param {any}    env        The environment object
-   * @param {string} outputFile The output file path
+   * @param {any}      app        The application object
+   * @param {any}      env        The environment object
+   * @param {string}   outputFile The output file path
+   * @param {Function} trackerFn  The progress tracker function
    */
-  constructor(app, env, outputFile) {
+  constructor(app, env, outputFile, trackerFn = () => {}) {
     this.app = app;
     this.env = env;
-    this.outputFile = outputFile;
+    this.outputFile = typeof outputFile === 'string' ? (0, _utils.getAbsolutePath)(outputFile) : null;
     this.progressTracker = new _progress.ProgressTracker([{
       id: this.steps.PREPARE,
       name: 'Preparing'
@@ -220,6 +215,7 @@ class ExportSQLCommand {
       id: this.steps.DOWNLOAD,
       name: 'Downloading file'
     }]);
+    this.track = trackerFn;
   }
 
   /**
@@ -264,6 +260,8 @@ class ExportSQLCommand {
     return new Promise((resolve, reject) => {
       _https.default.get(url, response => {
         response.pipe(file);
+        const total = parseInt(response.headers['content-length'], 10);
+        let current = 0;
         file.on('finish', () => {
           file.close();
           resolve(_path.default.resolve(file.path));
@@ -272,6 +270,10 @@ class ExportSQLCommand {
           _fs.default.unlink(filename);
           reject(err);
         });
+        response.on('data', chunk => {
+          current += chunk.length;
+          this.progressTracker.setProgress(`- ${(100 * current / total).toFixed(2)}% (${(0, _format.formatBytes)(current)}/${(0, _format.formatBytes)(total)})`);
+        });
       });
     });
   }
@@ -314,26 +316,44 @@ class ExportSQLCommand {
    * @return {Promise} A promise which resolves to void
    */
   async run() {
+    if (this.outputFile) {
+      try {
+        _fs.default.accessSync(_path.default.parse(this.outputFile).dir, _fs.default.constants.W_OK);
+      } catch (err) {
+        await this.track('cannot_write_to_path', {
+          errorMessage: `Cannot write to the specified path: ${err === null || err === void 0 ? void 0 : err.message}`
+        });
+        exit.withError(`Cannot write to the specified path: ${err === null || err === void 0 ? void 0 : err.message}`);
+      }
+    }
     console.log(`Fetching the latest backup for ${this.app.name}`);
     const {
       latestBackup
     } = await fetchLatestBackupAndJobStatus(this.app.id, this.env.id);
     if (!latestBackup) {
+      await this.track('no_backup_found_error', {
+        errorMessage: 'No backup found for the site'
+      });
       exit.withError(`No backup found for site ${this.app.name}`);
     } else {
       console.log(`${(0, _format.getGlyphForStatus)('success')} Latest backup found with timestamp ${latestBackup.createdAt}`);
     }
-
-    // See if there is an existing export job for the latest backup
-    if (!(await this.getExportJob())) {
+    if (await this.getExportJob()) {
+      console.log(`Attaching to an existing export for the backup with timestamp ${latestBackup.createdAt}`);
+    } else {
       console.log(`Creating a new export for the backup with timestamp ${latestBackup.createdAt}`);
       try {
         await createExportJob(this.app.id, this.env.id, latestBackup.id);
       } catch (err) {
+        // Todo: match error code instead of message substring
+        if (err !== null && err !== void 0 && err.message.includes('Backup Copy already in progress')) {
+          await this.track('export_job_already_running_error', {
+            errorMessage: err === null || err === void 0 ? void 0 : err.message
+          });
+          exit.withError('There is an export job already running for this site: ' + `https://dashboard.wpvip.com/apps/${this.app.id}/${this.env.uniqueLabel}/data/database/backups\n` + 'Currently, we allow only one export job at a time, per site. Please try again later.');
+        }
         exit.withError(`Error creating export job: ${err === null || err === void 0 ? void 0 : err.message}`);
       }
-    } else {
-      console.log(`Attaching to an existing export for the backup with timestamp ${latestBackup.createdAt}`);
     }
     this.progressTracker.stepRunning(this.steps.PREPARE);
     this.progressTracker.startPrinting();
@@ -353,6 +373,9 @@ class ExportSQLCommand {
     } catch (err) {
       this.progressTracker.stepFailed(this.steps.DOWNLOAD);
       this.stopProgressTracker();
+      await this.track('download_failed_error', {
+        errorMessage: err === null || err === void 0 ? void 0 : err.message
+      });
       exit.withError(`Error downloading exported file: ${err === null || err === void 0 ? void 0 : err.message}`);
     }
   }

package/dist/lib/cli/format.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.RunningSprite = exports.RUNNING_SPRITE_GLYPHS = void 0;
 exports.capitalize = capitalize;
+exports.formatBytes = void 0;
 exports.formatData = formatData;
 exports.formatEnvironment = formatEnvironment;
 exports.formatSearchReplaceValues = void 0;
@@ -182,4 +183,17 @@ const formatSearchReplaceValues = (values, message) => {
   });
   return formattedOutput;
 };
-exports.formatSearchReplaceValues = formatSearchReplaceValues;
+
+// Format bytes into kilobytes, megabytes, etc based on the size
+exports.formatSearchReplaceValues = formatSearchReplaceValues;
+const formatBytes = (bytes, decimals = 2) => {
+  if (0 === bytes) {
+    return '0 Bytes';
+  }
+  const kk = 1024;
+  const dm = decimals < 0 ? 0 : decimals;
+  const sizes = ['bytes', 'KB', 'MB', 'GB', 'TB'];
+  const idx = Math.floor(Math.log(bytes) / Math.log(kk));
+  return parseFloat((bytes / Math.pow(kk, idx)).toFixed(dm)) + ' ' + sizes[idx];
+};
+exports.formatBytes = formatBytes;

package/dist/lib/cli/progress.js

@@ -59,6 +59,16 @@ class ProgressTracker {
       percentage
     });
   }
+  setProgress(progress) {
+    const step = this.getCurrentStep();
+    if (!step) {
+      return;
+    }
+    this.stepsFromCaller.set(step.id, {
+      ...step,
+      progress
+    });
+  }
   setStepsFromServer(steps) {
     const formattedSteps = steps.map(({
       name,
@@ -90,6 +100,15 @@ class ProgressTracker {
       status
     }) => status === 'pending');
   }
+  getCurrentStep() {
+    if (this.allStepsSucceeded()) {
+      return undefined;
+    }
+    const steps = [...this.getSteps().values()];
+    return steps.find(({
+      status
+    }) => status === 'running');
+  }
   stepRunning(stepId) {
     this.setStatusForStepId(stepId, 'running');
   }
@@ -152,7 +171,8 @@ class ProgressTracker {
       name,
       id,
       percentage,
-      status
+      status,
+      progress
     }) => {
       const statusIcon = (0, _format.getGlyphForStatus)(status, this.runningSprite);
       let suffix = '';
@@ -160,6 +180,8 @@ class ProgressTracker {
         if (status === 'running' && percentage) {
           suffix = percentage;
         }
+      } else if (progress) {
+        suffix = progress;
       }
       return `${accumulator}${statusIcon} ${name} ${suffix}\n`;
     }, '');

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

@@ -29,11 +29,11 @@ exports.DEV_ENVIRONMENT_WORDPRESS_CACHE_KEY = DEV_ENVIRONMENT_WORDPRESS_CACHE_KE
 const DEV_ENVIRONMENT_WORDPRESS_VERSION_TTL = 86400; // once per day
 exports.DEV_ENVIRONMENT_WORDPRESS_VERSION_TTL = DEV_ENVIRONMENT_WORDPRESS_VERSION_TTL;
 const DEV_ENVIRONMENT_PHP_VERSIONS = {
+  '8.0': 'ghcr.io/automattic/vip-container-images/php-fpm:8.0',
   // eslint-disable-next-line quote-props
   '8.2': 'ghcr.io/automattic/vip-container-images/php-fpm:8.2',
   // eslint-disable-next-line quote-props
   '8.1': 'ghcr.io/automattic/vip-container-images/php-fpm:8.1',
-  '8.0': 'ghcr.io/automattic/vip-container-images/php-fpm:8.0',
   // eslint-disable-next-line quote-props -- flow does not support non-string keys
   '7.4': 'ghcr.io/automattic/vip-container-images/php-fpm:7.4'
 };

package/dist/lib/dev-environment/dev-environment-configuration-file.js

@@ -67,7 +67,8 @@ async function sanitizeConfiguration(configuration) {
   const genericConfigurationError = `Configuration file ${_chalk.default.grey(CONFIGURATION_FILE_NAME)} is available but ` + `couldn't be loaded. Ensure there is a ${_chalk.default.cyan('configuration-version')} and ${_chalk.default.cyan('slug')} ` + `configured. For example:\n\n${_chalk.default.grey(getConfigurationFileExample())}`;
   if (Array.isArray(configuration) || typeof configuration !== 'object') {
     throw new Error(genericConfigurationError);
-  } else if (configuration['configuration-version'] === undefined || configuration.slug === undefined) {
+  }
+  if (configuration['configuration-version'] === undefined || configuration.slug === undefined) {
     throw new Error(genericConfigurationError);
   }
   const validVersions = getAllConfigurationFileVersions().map(version => _chalk.default.cyan(version)).join(', ');
@@ -92,7 +93,8 @@ async function sanitizeConfiguration(configuration) {
     elasticsearch: stringToBooleanIfDefined(configuration.elasticsearch),
     phpmyadmin: stringToBooleanIfDefined(configuration.phpmyadmin),
     xdebug: stringToBooleanIfDefined(configuration.xdebug),
-    mailpit: stringToBooleanIfDefined((_configuration$mailpi = configuration.mailpit) !== null && _configuration$mailpi !== void 0 ? _configuration$mailpi : configuration.mailhog)
+    mailpit: stringToBooleanIfDefined((_configuration$mailpi = configuration.mailpit) !== null && _configuration$mailpi !== void 0 ? _configuration$mailpi : configuration.mailhog),
+    'media-redirect-domain': configuration['media-redirect-domain']
   };
 
   // Remove undefined values
@@ -116,7 +118,8 @@ function mergeConfigurationFileOptions(preselectedOptions, configurationFileOpti
     phpmyadmin: configurationFileOptions.phpmyadmin,
     xdebug: configurationFileOptions.xdebug,
     xdebugConfig: configurationFileOptions['xdebug-config'],
-    mailpit: (_configurationFileOpt = configurationFileOptions.mailpit) !== null && _configurationFileOpt !== void 0 ? _configurationFileOpt : configurationFileOptions.mailhog
+    mailpit: (_configurationFileOpt = configurationFileOptions.mailpit) !== null && _configurationFileOpt !== void 0 ? _configurationFileOpt : configurationFileOptions.mailhog,
+    mediaRedirectDomain: configurationFileOptions['media-redirect-domain']
   };
   const mergedOptions = {};
   Object.keys(configurationFileInstanceOptions).forEach(key => {

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

@@ -34,6 +34,7 @@ var _path = _interopRequireDefault(require("path"));
 var _chalk = _interopRequireDefault(require("chalk"));
 var _enquirer = require("enquirer");
 var _copyDir = _interopRequireDefault(require("copy-dir"));
+var _uuid = require("uuid");
 var _devEnvironmentLando = require("./dev-environment-lando");
 var _searchAndReplace = require("../search-and-replace");
 var _devEnvironmentCli = require("./dev-environment-cli");
@@ -129,7 +130,7 @@ function preProcessInstanceData(instanceData) {
     newInstanceData.mediaRedirectDomain = `https://${instanceData.mediaRedirectDomain}`;
   }
   newInstanceData.elasticsearch = instanceData.elasticsearch || false;
-  newInstanceData.php = instanceData.php || _devEnvironment.DEV_ENVIRONMENT_PHP_VERSIONS.default;
+  newInstanceData.php = instanceData.php || _devEnvironment.DEV_ENVIRONMENT_PHP_VERSIONS[Object.keys(_devEnvironment.DEV_ENVIRONMENT_PHP_VERSIONS)[0]];
   if (newInstanceData.php.startsWith('image:')) {
     newInstanceData.php = newInstanceData.php.slice('image:'.length);
   }
@@ -156,6 +157,9 @@ function preProcessInstanceData(instanceData) {
   if (!newInstanceData.mariadb) {
     newInstanceData.mariadb = undefined;
   }
+
+  // newInstanceData
+  newInstanceData.autologinKey = (0, _uuid.v4)();
   return newInstanceData;
 }
 async function destroyEnvironment(lando, slug, removeFiles) {
@@ -224,9 +228,12 @@ async function printEnvironmentInfo(lando, slug, options) {
   if (!environmentExists) {
     throw new _userError.default(_devEnvironment.DEV_ENVIRONMENT_NOT_FOUND);
   }
-  const appInfo = await (0, _devEnvironmentLando.landoInfo)(lando, instancePath, !!options.suppressWarnings);
+  const environmentData = readEnvironmentData(slug);
+  const appInfo = await (0, _devEnvironmentLando.landoInfo)(lando, instancePath, {
+    suppressWarnings: !!options.suppressWarnings,
+    autologinKey: environmentData.autologinKey
+  });
   if (options.extended) {
-    const environmentData = readEnvironmentData(slug);
     appInfo.title = environmentData.wpTitle;
     appInfo.multisite = !!environmentData.multisite;
     appInfo.php = environmentData.php.split(':')[1];
@@ -260,8 +267,18 @@ function readEnvironmentData(slug) {
   debug('Will try to get instance data for environment', slug);
   const instancePath = getEnvironmentPath(slug);
   const instanceDataTargetPath = _path.default.join(instancePath, instanceDataFileName);
-  const instanceDataString = _fs.default.readFileSync(instanceDataTargetPath, 'utf8');
-  const instanceData = JSON.parse(instanceDataString);
+  let instanceDataString;
+  let instanceData;
+  try {
+    instanceDataString = _fs.default.readFileSync(instanceDataTargetPath, 'utf8');
+  } catch (err) {
+    throw new _userError.default(`There was an error reading file "${instanceDataTargetPath}": ${err.message}.`);
+  }
+  try {
+    instanceData = JSON.parse(instanceDataString);
+  } catch (err) {
+    throw new _userError.default(`There was an error parsing file "${instanceDataTargetPath}": ${err.message}. You may need to recreate the environment.`);
+  }
 
   /**
    ***********************************

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

@@ -222,6 +222,7 @@ async function landoRebuild(lando, instancePath) {
   try {
     debug('Will rebuild lando app on path:', instancePath);
     const app = await getLandoApplication(lando, instancePath);
+    app.events.on('post-uninstall', async () => removeDevToolsVolumes(lando, app));
     await ensureNoOrphantProxyContainer(lando);
     await app.rebuild();
   } finally {
@@ -279,7 +280,7 @@ async function landoDestroy(lando, instancePath) {
     debug('landoDestroy() took %d ms', duration);
   }
 }
-async function landoInfo(lando, instancePath, suppressWarnings) {
+async function landoInfo(lando, instancePath, options = {}) {
   const started = new Date();
   try {
     var _app$info$find;
@@ -308,12 +309,15 @@ async function landoInfo(lando, instancePath, suppressWarnings) {
 
     // Add login information
     if (frontEndUrl) {
-      const loginUrl = `${frontEndUrl}wp-admin/`;
+      let loginUrl = `${frontEndUrl}wp-admin/`;
+      if (options.autologinKey) {
+        loginUrl += `?vip-dev-autologin=${options.autologinKey}`;
+      }
       appInfo['Login URL'] = loginUrl;
       appInfo['Default username'] = 'vipgo';
       appInfo['Default password'] = 'password';
     }
-    if (!suppressWarnings && hasWarnings) {
+    if (!options.suppressWarnings && hasWarnings) {
       let message = _chalk.default.bold.yellow('The following services have failed health checks:\n');
       Object.keys(health).forEach(service => {
         if (!health[service]) {
@@ -455,6 +459,44 @@ async function landoShell(lando, instancePath, service, user, command) {
   });
 }
 
+/**
+ * Dev-tools volumes can get stale and is not updated when the new version of dev-tools
+ * image is installed. Removing it during rebuild ensures the content is freshly populated
+ * on startup.
+ *
+ * @param {Lando} lando
+ * @param {App}   app
+ */
+async function removeDevToolsVolumes(lando, app) {
+  debug('Attempting to removing dev-tools volumes');
+  const scanResult = await lando.engine.docker.listVolumes();
+  const devToolsVolumeNames = ((scanResult === null || scanResult === void 0 ? void 0 : scanResult.Volumes) || []).map(volume => volume.Name).filter(volumeName => new RegExp(`${app.project}.*devtools`).test(volumeName));
+  debug('Will remove', devToolsVolumeNames);
+  const removalPromises = devToolsVolumeNames.map(volumeName => removeVolume(lando, volumeName));
+  await Promise.all(removalPromises);
+}
+
+/**
+ * Remove volume
+ *
+ * @param {Lando}  lando
+ * @param {string} volumeName
+ */
+async function removeVolume(lando, volumeName) {
+  debug(`Removing devtools volume ${volumeName}`);
+  const devToolsVolume = await lando.engine.docker.getVolume(volumeName);
+  if (!devToolsVolume) {
+    debug(`Volume ${volumeName} not found`);
+    return;
+  }
+  try {
+    await devToolsVolume.remove();
+    debug(`${volumeName} volume removed`);
+  } catch (err) {
+    debug(`Failed to remove volume ${volumeName}`, err);
+  }
+}
+
 /**
  * Sometimes the proxy network seems to disapper leaving only orphant stopped proxy container.
  * It seems to happen while restarting/powering off computer. This container would then failed

package/dist/lib/tracker.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.aliasUser = aliasUser;
+exports.makeCommandTracker = makeCommandTracker;
 exports.trackEvent = trackEvent;
 exports.trackEventWithEnv = trackEventWithEnv;
 var _index = _interopRequireDefault(require("./analytics/index"));
@@ -77,4 +78,13 @@ async function trackEventWithEnv(appId, envId, eventName, eventProps = {}) {
     app_id: appId,
     env_id: envId
   });
+}
+function makeCommandTracker(command, trackingInfo = {}) {
+  const trackerFn = async (type, data = {}) => {
+    await trackEvent(`${command}_command_${type}`, {
+      ...trackingInfo,
+      ...data
+    });
+  };
+  return trackerFn;
 }

package/dist/lib/utils.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.getAbsolutePath = getAbsolutePath;
 exports.makeTempDir = makeTempDir;
 exports.pollUntil = pollUntil;
 var _fs = _interopRequireDefault(require("fs"));
@@ -66,4 +67,21 @@ function makeTempDir(prefix = 'vip-cli') {
     debug(`Removed temporary directory: ${tempDir}`);
   });
   return tempDir;
+}
+
+/**
+ * Get absolute path to a file
+ * 
+ * @param {string} filePath Path to the file
+ * 
+ * @return {string} Absolute path to the file
+ */
+function getAbsolutePath(filePath) {
+  if (filePath.startsWith('/')) {
+    return filePath;
+  }
+  if (filePath.startsWith('~')) {
+    return filePath.replace('~', _os.default.homedir());
+  }
+  return _path.default.join(process.cwd(), filePath);
 }

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@automattic/vip",
-  "version": "2.29.0-dev1",
+  "version": "2.29.1",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "@automattic/vip",
-      "version": "2.28.3",
+      "version": "2.29.1",
       "hasInstallScript": true,
       "license": "MIT",
       "dependencies": {
@@ -34,7 +34,7 @@
         "opn": "5.5.0",
         "proxy-from-env": "^1.1.0",
         "rollbar": "2.22.0",
-        "semver": "7.5.0",
+        "semver": "7.5.1",
         "shelljs": "^0.8.5",
         "single-line-log": "1.1.2",
         "socket.io-client": "^4.5.3",
@@ -108,7 +108,7 @@
         "dockerode": "^3.3.4",
         "eslint": "^8.35.0",
         "eslint-plugin-flowtype": "^8.0.3",
-        "flow-bin": "^0.205.1",
+        "flow-bin": "^0.206.0",
         "jest": "^29.5.0",
         "jest-environment-jsdom": "^29.5.0",
         "nock": "13.3.1",
@@ -171,9 +171,9 @@
       }
     },
     "node_modules/@automattic/eslint-plugin-wpvip": {
-      "version": "0.5.3",
-      "resolved": "https://registry.npmjs.org/@automattic/eslint-plugin-wpvip/-/eslint-plugin-wpvip-0.5.3.tgz",
-      "integrity": "sha512-BPsuN6LqZMpShuuOyyiaxl7DLjlyk41XBs5wqhD1qeULNnWctGkTa8SiX9Ev88NRMtR/evApIAFIDMTQzxXV8Q==",
+      "version": "0.5.5",
+      "resolved": "https://registry.npmjs.org/@automattic/eslint-plugin-wpvip/-/eslint-plugin-wpvip-0.5.5.tgz",
+      "integrity": "sha512-smvN/Ce+d4nt29pYI9aS5+W297zPDLtmT/jZLIrXPPY09YJrXhzLXMmMLHjURGosJBHVMWLzux1TaOXQbaoyHQ==",
       "dev": true,
       "dependencies": {
         "@babel/eslint-parser": "7.21.3",
@@ -2399,9 +2399,9 @@
       }
     },
     "node_modules/@eslint/js": {
-      "version": "8.40.0",
-      "resolved": "https://registry.npmjs.org/@eslint/js/-/js-8.40.0.tgz",
-      "integrity": "sha512-ElyB54bJIhXQYVKjDSvCkPO1iU1tSAeVQJbllWJq1XQSmmA4dgFk8CbiBGpiOPxleE48vDogxCtmMYku4HSVLA==",
+      "version": "8.41.0",
+      "resolved": "https://registry.npmjs.org/@eslint/js/-/js-8.41.0.tgz",
+      "integrity": "sha512-LxcyMGxwmTh2lY9FwHPGWOHmYFCZvbrFCBZL4FzSSsxsRPuhrYUg/49/0KDfW8tnIEaEHtfmn6+NPN+1DqaNmA==",
       "dev": true,
       "engines": {
         "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
@@ -3309,9 +3309,9 @@
       }
     },
     "node_modules/@pkgr/utils/node_modules/tslib": {
-      "version": "2.5.0",
-      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.5.0.tgz",
-      "integrity": "sha512-336iVw3rtn2BUK7ORdIAHTyxHGRIHVReokCR3XjbckJMK7ms8FysBfhLR8IXnAgy7T0PTPNBWKiH514FOW/WSg==",
+      "version": "2.5.2",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.5.2.tgz",
+      "integrity": "sha512-5svOrSA2w3iGFDs1HibEVBGbDrAY82bFQ3HZ3ixB+88nsbsWQoKqDRb5UBYAUPEzbBn6dAp5gRNXglySbx1MlA==",
       "dev": true
     },
     "node_modules/@rushstack/eslint-patch": {
@@ -6607,15 +6607,15 @@
       }
     },
     "node_modules/eslint": {
-      "version": "8.40.0",
-      "resolved": "https://registry.npmjs.org/eslint/-/eslint-8.40.0.tgz",
-      "integrity": "sha512-bvR+TsP9EHL3TqNtj9sCNJVAFK3fBN8Q7g5waghxyRsPLIMwL73XSKnZFK0hk/O2ANC+iAoq6PWMQ+IfBAJIiQ==",
+      "version": "8.41.0",
+      "resolved": "https://registry.npmjs.org/eslint/-/eslint-8.41.0.tgz",
+      "integrity": "sha512-WQDQpzGBOP5IrXPo4Hc0814r4/v2rrIsB0rhT7jtunIalgg6gYXWhRMOejVO8yH21T/FGaxjmFjBMNqcIlmH1Q==",
       "dev": true,
       "dependencies": {
         "@eslint-community/eslint-utils": "^4.2.0",
         "@eslint-community/regexpp": "^4.4.0",
         "@eslint/eslintrc": "^2.0.3",
-        "@eslint/js": "8.40.0",
+        "@eslint/js": "8.41.0",
         "@humanwhocodes/config-array": "^0.11.8",
         "@humanwhocodes/module-importer": "^1.0.1",
         "@nodelib/fs.walk": "^1.2.8",
@@ -6635,13 +6635,12 @@
         "find-up": "^5.0.0",
         "glob-parent": "^6.0.2",
         "globals": "^13.19.0",
-        "grapheme-splitter": "^1.0.4",
+        "graphemer": "^1.4.0",
         "ignore": "^5.2.0",
         "import-fresh": "^3.0.0",
         "imurmurhash": "^0.1.4",
         "is-glob": "^4.0.0",
         "is-path-inside": "^3.0.3",
-        "js-sdsl": "^4.1.4",
         "js-yaml": "^4.1.0",
         "json-stable-stringify-without-jsonify": "^1.0.1",
         "levn": "^0.4.1",
@@ -7920,9 +7919,9 @@
       "dev": true
     },
     "node_modules/flow-bin": {
-      "version": "0.205.1",
-      "resolved": "https://registry.npmjs.org/flow-bin/-/flow-bin-0.205.1.tgz",
-      "integrity": "sha512-pGQ/ZFr9hnbhRmc+K3K1Ui9BwDivlesNEd2mZbm5pCnxEUvbbj9nXHlTD4s4qO0k+LBKYLMZzQwBVYyRUE380g==",
+      "version": "0.206.0",
+      "resolved": "https://registry.npmjs.org/flow-bin/-/flow-bin-0.206.0.tgz",
+      "integrity": "sha512-cZTEs/OEWcbxfvb8BP+Fw0Cep5wrEyEzQHGpXyjVpQXrAraRA5wZUXvTf1C5YHufQaAYY9YkKY5WAr461JvmOA==",
       "dev": true,
       "bin": {
         "flow": "cli.js"
@@ -8371,6 +8370,12 @@
       "integrity": "sha512-bzh50DW9kTPM00T8y4o8vQg89Di9oLJVLW/KaOGIXJWP/iqCN6WKYkbNOF04vFLJhwcpYUh9ydh/+5vpOqV4YQ==",
       "dev": true
     },
+    "node_modules/graphemer": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/graphemer/-/graphemer-1.4.0.tgz",
+      "integrity": "sha512-EtKwoO6kxCL9WO5xipiHTZlSzBm7WLT627TqC/uVRd0HKmq8NXyebnNYxDoBi7wt8eTWrUrKXCOVaFq9x1kgag==",
+      "dev": true
+    },
     "node_modules/graphql": {
       "version": "15.5.1",
       "resolved": "https://registry.npmjs.org/graphql/-/graphql-15.5.1.tgz",
@@ -8394,9 +8399,9 @@
       }
     },
     "node_modules/graphql-tag/node_modules/tslib": {
-      "version": "2.5.0",
-      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.5.0.tgz",
-      "integrity": "sha512-336iVw3rtn2BUK7ORdIAHTyxHGRIHVReokCR3XjbckJMK7ms8FysBfhLR8IXnAgy7T0PTPNBWKiH514FOW/WSg=="
+      "version": "2.5.2",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.5.2.tgz",
+      "integrity": "sha512-5svOrSA2w3iGFDs1HibEVBGbDrAY82bFQ3HZ3ixB+88nsbsWQoKqDRb5UBYAUPEzbBn6dAp5gRNXglySbx1MlA=="
     },
     "node_modules/has": {
       "version": "1.0.3",
@@ -10682,16 +10687,6 @@
       "resolved": "https://registry.npmjs.org/js-base64/-/js-base64-2.6.4.tgz",
       "integrity": "sha512-pZe//GGmwJndub7ZghVHz7vjb2LgC1m8B07Au3eYqeqv9emhESByMXxaEgkUkEqJe87oBbSniGYoQNIBklc7IQ=="
     },
-    "node_modules/js-sdsl": {
-      "version": "4.2.0",
-      "resolved": "https://registry.npmjs.org/js-sdsl/-/js-sdsl-4.2.0.tgz",
-      "integrity": "sha512-dyBIzQBDkCqCu+0upx25Y2jGdbTGxE9fshMsCdK0ViOongpV+n5tXRcZY9v7CaVQ79AGS9KA1KHtojxiM7aXSQ==",
-      "dev": true,
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/js-sdsl"
-      }
-    },
     "node_modules/js-tokens": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
@@ -13312,9 +13307,9 @@
       }
     },
     "node_modules/semver": {
-      "version": "7.5.0",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.5.0.tgz",
-      "integrity": "sha512-+XC0AD/R7Q2mPSRuy2Id0+CGTZ98+8f+KvwirxOKIEyid+XSx6HbC63p+O4IndTHuX5Z+JxQ0TghCkO5Cg/2HA==",
+      "version": "7.5.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.5.1.tgz",
+      "integrity": "sha512-Wvss5ivl8TMRZXXESstBA4uR5iXgEN/VC5/sOcuXdVLzcdkz4HWetIoRfG5gb5X+ij/G9rw9YoGn3QoQ8OCSpw==",
       "dependencies": {
         "lru-cache": "^6.0.0"
       },
@@ -13674,9 +13669,9 @@
       }
     },
     "node_modules/socket.io-parser": {
-      "version": "4.2.1",
-      "resolved": "https://registry.npmjs.org/socket.io-parser/-/socket.io-parser-4.2.1.tgz",
-      "integrity": "sha512-V4GrkLy+HeF1F/en3SpUaM+7XxYXpuMUWLGde1kSSh5nQMN4hLrbPIkD+otwh6q9R6NOQBN4AMaOZ2zVjui82g==",
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/socket.io-parser/-/socket.io-parser-4.2.3.tgz",
+      "integrity": "sha512-JMafRntWVO2DCJimKsRTh/wnqVvO4hrfwOqtO7f+uzwsQMuxO6VwImtYxaQ+ieoyshWOTJyV0fA21lccEXRPpQ==",
       "dependencies": {
         "@socket.io/component-emitter": "~3.1.0",
         "debug": "~4.3.1"
@@ -14136,9 +14131,9 @@
       }
     },
     "node_modules/synckit/node_modules/tslib": {
-      "version": "2.5.0",
-      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.5.0.tgz",
-      "integrity": "sha512-336iVw3rtn2BUK7ORdIAHTyxHGRIHVReokCR3XjbckJMK7ms8FysBfhLR8IXnAgy7T0PTPNBWKiH514FOW/WSg==",
+      "version": "2.5.2",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.5.2.tgz",
+      "integrity": "sha512-5svOrSA2w3iGFDs1HibEVBGbDrAY82bFQ3HZ3ixB+88nsbsWQoKqDRb5UBYAUPEzbBn6dAp5gRNXglySbx1MlA==",
       "dev": true
     },
     "node_modules/table-layout": {
@@ -15496,9 +15491,9 @@
       }
     },
     "@automattic/eslint-plugin-wpvip": {
-      "version": "0.5.3",
-      "resolved": "https://registry.npmjs.org/@automattic/eslint-plugin-wpvip/-/eslint-plugin-wpvip-0.5.3.tgz",
-      "integrity": "sha512-BPsuN6LqZMpShuuOyyiaxl7DLjlyk41XBs5wqhD1qeULNnWctGkTa8SiX9Ev88NRMtR/evApIAFIDMTQzxXV8Q==",
+      "version": "0.5.5",
+      "resolved": "https://registry.npmjs.org/@automattic/eslint-plugin-wpvip/-/eslint-plugin-wpvip-0.5.5.tgz",
+      "integrity": "sha512-smvN/Ce+d4nt29pYI9aS5+W297zPDLtmT/jZLIrXPPY09YJrXhzLXMmMLHjURGosJBHVMWLzux1TaOXQbaoyHQ==",
       "dev": true,
       "requires": {
         "@babel/eslint-parser": "7.21.3",
@@ -17052,9 +17047,9 @@
       }
     },
     "@eslint/js": {
-      "version": "8.40.0",
-      "resolved": "https://registry.npmjs.org/@eslint/js/-/js-8.40.0.tgz",
-      "integrity": "sha512-ElyB54bJIhXQYVKjDSvCkPO1iU1tSAeVQJbllWJq1XQSmmA4dgFk8CbiBGpiOPxleE48vDogxCtmMYku4HSVLA==",
+      "version": "8.41.0",
+      "resolved": "https://registry.npmjs.org/@eslint/js/-/js-8.41.0.tgz",
+      "integrity": "sha512-LxcyMGxwmTh2lY9FwHPGWOHmYFCZvbrFCBZL4FzSSsxsRPuhrYUg/49/0KDfW8tnIEaEHtfmn6+NPN+1DqaNmA==",
       "dev": true
     },
     "@graphql-typed-document-node/core": {
@@ -17757,9 +17752,9 @@
           "dev": true
         },
         "tslib": {
-          "version": "2.5.0",
-          "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.5.0.tgz",
-          "integrity": "sha512-336iVw3rtn2BUK7ORdIAHTyxHGRIHVReokCR3XjbckJMK7ms8FysBfhLR8IXnAgy7T0PTPNBWKiH514FOW/WSg==",
+          "version": "2.5.2",
+          "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.5.2.tgz",
+          "integrity": "sha512-5svOrSA2w3iGFDs1HibEVBGbDrAY82bFQ3HZ3ixB+88nsbsWQoKqDRb5UBYAUPEzbBn6dAp5gRNXglySbx1MlA==",
           "dev": true
         }
       }
@@ -20295,15 +20290,15 @@
       }
     },
     "eslint": {
-      "version": "8.40.0",
-      "resolved": "https://registry.npmjs.org/eslint/-/eslint-8.40.0.tgz",
-      "integrity": "sha512-bvR+TsP9EHL3TqNtj9sCNJVAFK3fBN8Q7g5waghxyRsPLIMwL73XSKnZFK0hk/O2ANC+iAoq6PWMQ+IfBAJIiQ==",
+      "version": "8.41.0",
+      "resolved": "https://registry.npmjs.org/eslint/-/eslint-8.41.0.tgz",
+      "integrity": "sha512-WQDQpzGBOP5IrXPo4Hc0814r4/v2rrIsB0rhT7jtunIalgg6gYXWhRMOejVO8yH21T/FGaxjmFjBMNqcIlmH1Q==",
       "dev": true,
       "requires": {
         "@eslint-community/eslint-utils": "^4.2.0",
         "@eslint-community/regexpp": "^4.4.0",
         "@eslint/eslintrc": "^2.0.3",
-        "@eslint/js": "8.40.0",
+        "@eslint/js": "8.41.0",
         "@humanwhocodes/config-array": "^0.11.8",
         "@humanwhocodes/module-importer": "^1.0.1",
         "@nodelib/fs.walk": "^1.2.8",
@@ -20323,13 +20318,12 @@
         "find-up": "^5.0.0",
         "glob-parent": "^6.0.2",
         "globals": "^13.19.0",
-        "grapheme-splitter": "^1.0.4",
+        "graphemer": "^1.4.0",
         "ignore": "^5.2.0",
         "import-fresh": "^3.0.0",
         "imurmurhash": "^0.1.4",
         "is-glob": "^4.0.0",
         "is-path-inside": "^3.0.3",
-        "js-sdsl": "^4.1.4",
         "js-yaml": "^4.1.0",
         "json-stable-stringify-without-jsonify": "^1.0.1",
         "levn": "^0.4.1",
@@ -21287,9 +21281,9 @@
       "dev": true
     },
     "flow-bin": {
-      "version": "0.205.1",
-      "resolved": "https://registry.npmjs.org/flow-bin/-/flow-bin-0.205.1.tgz",
-      "integrity": "sha512-pGQ/ZFr9hnbhRmc+K3K1Ui9BwDivlesNEd2mZbm5pCnxEUvbbj9nXHlTD4s4qO0k+LBKYLMZzQwBVYyRUE380g==",
+      "version": "0.206.0",
+      "resolved": "https://registry.npmjs.org/flow-bin/-/flow-bin-0.206.0.tgz",
+      "integrity": "sha512-cZTEs/OEWcbxfvb8BP+Fw0Cep5wrEyEzQHGpXyjVpQXrAraRA5wZUXvTf1C5YHufQaAYY9YkKY5WAr461JvmOA==",
       "dev": true
     },
     "follow-redirects": {
@@ -21624,6 +21618,12 @@
       "integrity": "sha512-bzh50DW9kTPM00T8y4o8vQg89Di9oLJVLW/KaOGIXJWP/iqCN6WKYkbNOF04vFLJhwcpYUh9ydh/+5vpOqV4YQ==",
       "dev": true
     },
+    "graphemer": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/graphemer/-/graphemer-1.4.0.tgz",
+      "integrity": "sha512-EtKwoO6kxCL9WO5xipiHTZlSzBm7WLT627TqC/uVRd0HKmq8NXyebnNYxDoBi7wt8eTWrUrKXCOVaFq9x1kgag==",
+      "dev": true
+    },
     "graphql": {
       "version": "15.5.1",
       "resolved": "https://registry.npmjs.org/graphql/-/graphql-15.5.1.tgz",
@@ -21638,9 +21638,9 @@
       },
       "dependencies": {
         "tslib": {
-          "version": "2.5.0",
-          "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.5.0.tgz",
-          "integrity": "sha512-336iVw3rtn2BUK7ORdIAHTyxHGRIHVReokCR3XjbckJMK7ms8FysBfhLR8IXnAgy7T0PTPNBWKiH514FOW/WSg=="
+          "version": "2.5.2",
+          "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.5.2.tgz",
+          "integrity": "sha512-5svOrSA2w3iGFDs1HibEVBGbDrAY82bFQ3HZ3ixB+88nsbsWQoKqDRb5UBYAUPEzbBn6dAp5gRNXglySbx1MlA=="
         }
       }
     },
@@ -23306,12 +23306,6 @@
       "resolved": "https://registry.npmjs.org/js-base64/-/js-base64-2.6.4.tgz",
       "integrity": "sha512-pZe//GGmwJndub7ZghVHz7vjb2LgC1m8B07Au3eYqeqv9emhESByMXxaEgkUkEqJe87oBbSniGYoQNIBklc7IQ=="
     },
-    "js-sdsl": {
-      "version": "4.2.0",
-      "resolved": "https://registry.npmjs.org/js-sdsl/-/js-sdsl-4.2.0.tgz",
-      "integrity": "sha512-dyBIzQBDkCqCu+0upx25Y2jGdbTGxE9fshMsCdK0ViOongpV+n5tXRcZY9v7CaVQ79AGS9KA1KHtojxiM7aXSQ==",
-      "dev": true
-    },
     "js-tokens": {
       "version": "4.0.0",
       "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz",
@@ -25333,9 +25327,9 @@
       }
     },
     "semver": {
-      "version": "7.5.0",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.5.0.tgz",
-      "integrity": "sha512-+XC0AD/R7Q2mPSRuy2Id0+CGTZ98+8f+KvwirxOKIEyid+XSx6HbC63p+O4IndTHuX5Z+JxQ0TghCkO5Cg/2HA==",
+      "version": "7.5.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.5.1.tgz",
+      "integrity": "sha512-Wvss5ivl8TMRZXXESstBA4uR5iXgEN/VC5/sOcuXdVLzcdkz4HWetIoRfG5gb5X+ij/G9rw9YoGn3QoQ8OCSpw==",
       "requires": {
         "lru-cache": "^6.0.0"
       },
@@ -25614,9 +25608,9 @@
       }
     },
     "socket.io-parser": {
-      "version": "4.2.1",
-      "resolved": "https://registry.npmjs.org/socket.io-parser/-/socket.io-parser-4.2.1.tgz",
-      "integrity": "sha512-V4GrkLy+HeF1F/en3SpUaM+7XxYXpuMUWLGde1kSSh5nQMN4hLrbPIkD+otwh6q9R6NOQBN4AMaOZ2zVjui82g==",
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/socket.io-parser/-/socket.io-parser-4.2.3.tgz",
+      "integrity": "sha512-JMafRntWVO2DCJimKsRTh/wnqVvO4hrfwOqtO7f+uzwsQMuxO6VwImtYxaQ+ieoyshWOTJyV0fA21lccEXRPpQ==",
       "requires": {
         "@socket.io/component-emitter": "~3.1.0",
         "debug": "~4.3.1"
@@ -25975,9 +25969,9 @@
       },
       "dependencies": {
         "tslib": {
-          "version": "2.5.0",
-          "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.5.0.tgz",
-          "integrity": "sha512-336iVw3rtn2BUK7ORdIAHTyxHGRIHVReokCR3XjbckJMK7ms8FysBfhLR8IXnAgy7T0PTPNBWKiH514FOW/WSg==",
+          "version": "2.5.2",
+          "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.5.2.tgz",
+          "integrity": "sha512-5svOrSA2w3iGFDs1HibEVBGbDrAY82bFQ3HZ3ixB+88nsbsWQoKqDRb5UBYAUPEzbBn6dAp5gRNXglySbx1MlA==",
           "dev": true
         }
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automattic/vip",
-  "version": "2.29.0-dev1",
+  "version": "2.29.1",
   "description": "The VIP Javascript library & CLI",
   "main": "index.js",
   "bin": {
@@ -104,7 +104,7 @@
     "dockerode": "^3.3.4",
     "eslint": "^8.35.0",
     "eslint-plugin-flowtype": "^8.0.3",
-    "flow-bin": "^0.205.1",
+    "flow-bin": "^0.206.0",
     "jest": "^29.5.0",
     "jest-environment-jsdom": "^29.5.0",
     "nock": "13.3.1",
@@ -137,7 +137,7 @@
     "opn": "5.5.0",
     "proxy-from-env": "^1.1.0",
     "rollbar": "2.22.0",
-    "semver": "7.5.0",
+    "semver": "7.5.1",
     "shelljs": "^0.8.5",
     "single-line-log": "1.1.2",
     "socket.io-client": "^4.5.3",