@automattic/vip 3.25.2-dev.0 → 3.25.3-dev.0

package/AGENTS.md

@@ -72,12 +72,6 @@ Guide for future agents working on this codebase. Focus on traps, cross-cutting
 - `prepare` runs `npm run clean && npm run build`; npm package bins point to `dist/**`. Always rebuild before publishing so dist matches src.
 - `helpers/prepublishOnly.js` enforces branch `trunk` for `npm publish --tag latest` and optionally reruns `npm test`. Release flows expect a clean node version that satisfies `engines.node`.
 
-## Standalone SEA Packaging
-
-- Canonical runbook for standalone executable build/signing is in `docs/SEA-BUILD-SIGNING.md`. Use it for macOS, Linux, Windows native, and WSL-mediated Windows builds.
-- SEA builds are Node 22 only (enforced in `helpers/build-sea.js`); always verify `node -v` before `npm run build:sea`.
-- The executable is self-contained for Node runtime + JS deps, but `dev-env` commands still require host Docker/Compose availability.
-
 ## Common Pitfalls Checklist
 
 - Running CLI without a token opens a browser (`open`) and waits for interactive input—pass `--help` or set `WPVIP_DEPLOY_TOKEN` in automation.

package/CLAUDE.md

@@ -1,4 +1,3 @@
 # CLAUDE
 
 For guidance on working in this repo, traps, and migration notes, see `AGENTS.md`.
-For standalone SEA build/signing by platform, see `docs/SEA-BUILD-SIGNING.md`.

package/dist/bin/vip-db-phpmyadmin.js

@@ -16,6 +16,9 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
 const examples = [{
   usage: 'vip @example-app.develop db phpmyadmin',
   description: "Generate access to a read-only phpMyAdmin web interface for the environment's database."
+}, {
+  usage: 'vip @example-app.develop db phpmyadmin --print',
+  description: 'Print the phpMyAdmin URL to stdout instead of opening it in a browser.'
 }];
 const appQuery = `
 	id,
@@ -35,16 +38,20 @@ void (0, _command.default)({
   module: 'phpmyadmin',
   requiredArgs: 0,
   usage: 'vip db phpmyadmin'
-}).examples(examples).argv(process.argv, async (arg, {
+}).option('print', 'Print the phpMyAdmin URL to stdout instead of opening it in a browser.').option('silent', 'Do not print any output to the console.').examples(examples).argv(process.argv, async (arg, {
   app,
-  env
+  env,
+  print: printUrl,
+  silent
 }) => {
   const trackerFn = (0, _tracker.makeCommandTracker)('phpmyadmin', {
     app: app.id,
     env: env.uniqueLabel
   });
   await trackerFn('execute');
-  const cmd = new _phpmyadmin.PhpMyAdminCommand(app, env, trackerFn);
-  await cmd.run();
+  const cmd = new _phpmyadmin.PhpMyAdminCommand(app, env, trackerFn, silent);
+  await cmd.run({
+    print: printUrl
+  });
   await trackerFn('success');
 });

package/dist/bin/vip-dev-env-exec.js

@@ -10,23 +10,6 @@ var _userError = _interopRequireDefault(require("../lib/user-error"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const exampleUsage = 'vip dev-env exec';
 const usage = 'vip dev-env exec';
-const ENV_UP_CHECK_ATTEMPTS = 5;
-const ENV_UP_CHECK_DELAY_MS = 1500;
-const sleep = ms => new Promise(resolve => setTimeout(resolve, ms));
-async function waitForEnvironmentReadiness(lando, slug) {
-  const instancePath = (0, _devEnvironmentCore.getEnvironmentPath)(slug);
-  return pollEnvironmentReadiness(lando, instancePath, 1);
-}
-async function pollEnvironmentReadiness(lando, instancePath, attempt) {
-  if (await (0, _devEnvironmentLando.isEnvUp)(lando, instancePath)) {
-    return true;
-  }
-  if (attempt >= ENV_UP_CHECK_ATTEMPTS) {
-    return false;
-  }
-  await sleep(ENV_UP_CHECK_DELAY_MS);
-  return pollEnvironmentReadiness(lando, instancePath, attempt + 1);
-}
 const examples = [{
   usage: `${exampleUsage} --slug=example-site -- wp post list`,
   description: 'Run a WP-CLI command against a local environment named "example-site".\n' + '      * A double dash ("--") must separate the arguments of "vip" from those of the "wp" command.'
@@ -63,7 +46,7 @@ const examples = [{
       arg = process.argv.slice(argSplitterIx + 1);
     }
     if (!opt.force) {
-      const isUp = await waitForEnvironmentReadiness(lando, slug);
+      const isUp = await (0, _devEnvironmentLando.isEnvUp)(lando, (0, _devEnvironmentCore.getEnvironmentPath)(slug));
       if (!isUp) {
         throw new _userError.default('A WP-CLI command can only be executed on a running local environment.');
       }

package/dist/bin/vip-dev-env-start.js

@@ -30,9 +30,13 @@ const examples = [{
   usage: `${exampleUsage} --editor=phpstorm --slug=example-site`,
   description: 'Start a local environment and generate a Workspace file for developing in PhpStorm.'
 }];
-(0, _command.default)({
+const cmd = (0, _command.default)({
   usage
-}).option('slug', 'A unique name for a local environment. Default is "vip-local".', undefined, _devEnvironmentCli.processSlug).option('skip-rebuild', 'Only start services that are not in a running state.').option(['w', 'skip-wp-versions-check'], 'Skip the prompt to update WordPress; occurs if the last major release version is not configured.').option('vscode', 'Generate a Visual Studio Code Workspace file (deprecated, use --editor=vscode instead).').option('editor', 'Generate a workspace file for the specified editor (supports: vscode, cursor, windsurf, phpstorm).').examples(examples).argv(process.argv, async (arg, opt) => {
+}).option('slug', 'A unique name for a local environment. Default is "vip-local".', undefined, _devEnvironmentCli.processSlug).option('skip-rebuild', 'Only start services that are not in a running state.').option(['w', 'skip-wp-versions-check'], 'Skip the prompt to update WordPress; occurs if the last major release version is not configured.').option('vscode', 'Generate a Visual Studio Code Workspace file (deprecated, use --editor=vscode instead).').option('editor', 'Generate a workspace file for the specified editor (supports: vscode, cursor, windsurf, phpstorm).');
+if (process.platform !== 'win32') {
+  cmd.option('autofix-domain-resolution', 'Automatically fix domain resolution issues by updating the hosts file [UNSAFE].');
+}
+cmd.examples(examples).argv(process.argv, async (arg, opt) => {
   const slug = await (0, _devEnvironmentCli.getEnvironmentName)(opt);
   const lando = await (0, _devEnvironmentLando.bootstrapLando)({
     logFile: (0, _devEnvironmentCli.getDevEnvLogFile)(slug)
@@ -49,7 +53,8 @@ const examples = [{
   debug('Args: ', arg, 'Options: ', opt);
   const options = {
     skipRebuild: Boolean(opt.skipRebuild),
-    skipWpVersionsCheck: Boolean(opt.skipWpVersionsCheck)
+    skipWpVersionsCheck: Boolean(opt.skipWpVersionsCheck),
+    autofixDomains: Boolean(opt.autofixDomainResolution)
   };
   try {
     await (0, _devEnvironmentCore.startEnvironment)(lando, slug, options);

package/dist/bin/vip.js

@@ -7,8 +7,6 @@ var _debug = _interopRequireDefault(require("debug"));
 var _enquirer = require("enquirer");
 var _command = _interopRequireWildcard(require("../lib/cli/command"));
 var _config = _interopRequireDefault(require("../lib/cli/config"));
-var _internalBinLoader = require("../lib/cli/internal-bin-loader");
-var _seaDispatch = require("../lib/cli/sea-dispatch");
 var _token = _interopRequireDefault(require("../lib/token"));
 var _tracker = require("../lib/tracker");
 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); }
@@ -22,28 +20,10 @@ if (_config.default && _config.default.environment !== 'production') {
 // Config
 const tokenURL = 'https://dashboard.wpvip.com/me/cli/token';
 const customDeployToken = process.env.WPVIP_DEPLOY_TOKEN;
-async function maybeExecuteSeaTargetCommand() {
-  const targetBin = process.env.VIP_CLI_TARGET_BIN;
-  if (!(0, _seaDispatch.isSeaRuntime)() || !targetBin || targetBin === 'vip') {
-    return false;
-  }
-  const start = Number(process.env.VIP_CLI_TARGET_START ?? '0');
-  const length = Number(process.env.VIP_CLI_TARGET_LENGTH ?? '0');
-  const resolution = {
-    start: Number.isInteger(start) ? start : 0,
-    length: Number.isInteger(length) ? length : 0
-  };
-  process.argv = (0, _seaDispatch.rewriteArgvForInternalBin)(process.argv, resolution);
-  const loaded = await (0, _internalBinLoader.loadInternalBin)(targetBin);
-  if (!loaded) {
-    throw new Error(`Unable to load SEA command target "${targetBin}"`);
-  }
-  return true;
-}
 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('wp', 'Execute a WP-CLI command against an environment.');
-  await cmd.argv(process.argv);
+  cmd.argv(process.argv);
 };
 
 /**
@@ -54,89 +34,7 @@ const runCmd = async function () {
 function doesArgvHaveAtLeastOneParam(argv, params) {
   return argv.some(arg => params.includes(arg));
 }
-async function runLoginFlow() {
-  console.log();
-  console.log('   _    __ ________         ________    ____');
-  console.log('  | |  / //  _/ __        / ____/ /   /  _/');
-  console.log('  | | / / / // /_/ /______/ /   / /    / /  ');
-  console.log('  | |/ /_/ // ____//_____/ /___/ /____/ /   ');
-  console.log('  |___//___/_/           ____/_____/___/   ');
-  console.log();
-  console.log('  VIP-CLI is your tool for interacting with and managing your VIP applications.');
-  console.log();
-  console.log('  Authenticate your installation of VIP-CLI with your Personal Access Token. This URL will be opened in your web browser automatically so that you can retrieve your token: ' + tokenURL);
-  console.log();
-  await (0, _tracker.trackEvent)('login_command_execute');
-  const answer = await (0, _enquirer.prompt)({
-    type: 'confirm',
-    name: 'continue',
-    message: 'Ready to authenticate?'
-  });
-  if (!answer.continue) {
-    await (0, _tracker.trackEvent)('login_command_browser_cancelled');
-    return null;
-  }
-  const {
-    default: open
-  } = await import('open');
-  open(tokenURL, {
-    wait: false
-  });
-  await (0, _tracker.trackEvent)('login_command_browser_opened');
-  const {
-    token: tokenInput
-  } = await (0, _enquirer.prompt)({
-    type: 'password',
-    name: 'token',
-    message: 'Access Token:'
-  });
-  let token;
-  try {
-    token = new _token.default(tokenInput);
-  } catch (err) {
-    console.log('The token provided is malformed. Please check the token and try again.');
-    await (0, _tracker.trackEvent)('login_command_token_submit_error', {
-      error: err.message
-    });
-    return null;
-  }
-  if (token.expired()) {
-    console.log('The token provided is expired. Please log in again to refresh the token.');
-    await (0, _tracker.trackEvent)('login_command_token_submit_error', {
-      error: 'expired'
-    });
-    return null;
-  }
-  if (!token.valid()) {
-    console.log('The provided token is not valid. Please log in again to refresh the token.');
-    await (0, _tracker.trackEvent)('login_command_token_submit_error', {
-      error: 'invalid'
-    });
-    return null;
-  }
-  try {
-    await _token.default.set(token.raw);
-  } catch (err) {
-    await (0, _tracker.trackEvent)('login_command_token_submit_error', {
-      error: err.message
-    });
-    throw err;
-  }
-
-  // De-anonymize user for tracking
-  await (0, _tracker.aliasUser)(token.id);
-  await (0, _tracker.trackEvent)('login_command_token_submit_success');
-  return token;
-}
 const rootCmd = async function () {
-  if ((0, _seaDispatch.isSeaRuntime)() && !process.env.VIP_CLI_TARGET_BIN) {
-    const resolution = (0, _seaDispatch.resolveInternalBinFromArgv)(process.argv);
-    if (resolution.bin !== 'vip') {
-      process.env.VIP_CLI_TARGET_BIN = resolution.bin;
-      process.env.VIP_CLI_TARGET_START = String(resolution.start);
-      process.env.VIP_CLI_TARGET_LENGTH = String(resolution.length);
-    }
-  }
   let token = await _token.default.get();
   const isHelpCommand = doesArgvHaveAtLeastOneParam(process.argv, ['help', '-h', '--help']);
   const isVersionCommand = doesArgvHaveAtLeastOneParam(process.argv, ['-v', '--version']);
@@ -146,22 +44,82 @@ const rootCmd = async function () {
   const isCustomDeployCmdWithKey = doesArgvHaveAtLeastOneParam(process.argv, ['deploy']) && Boolean(customDeployToken);
   debug('Argv:', process.argv);
   if (!isLoginCommand && (isLogoutCommand || isHelpCommand || isVersionCommand || isDevEnvCommandWithoutEnv || token?.valid() || isCustomDeployCmdWithKey)) {
-    if (await maybeExecuteSeaTargetCommand()) {
-      return;
-    }
     await runCmd();
   } else {
-    token = await runLoginFlow();
-    if (!token) {
+    console.log();
+    console.log('   _    __ ________         ________    ____');
+    console.log('  | |  / //  _/ __        / ____/ /   /  _/');
+    console.log('  | | / / / // /_/ /______/ /   / /    / /  ');
+    console.log('  | |/ /_/ // ____//_____/ /___/ /____/ /   ');
+    console.log('  |___//___/_/           ____/_____/___/   ');
+    console.log();
+    console.log('  VIP-CLI is your tool for interacting with and managing your VIP applications.');
+    console.log();
+    console.log('  Authenticate your installation of VIP-CLI with your Personal Access Token. This URL will be opened in your web browser automatically so that you can retrieve your token: ' + tokenURL);
+    console.log();
+    await (0, _tracker.trackEvent)('login_command_execute');
+    const answer = await (0, _enquirer.prompt)({
+      type: 'confirm',
+      name: 'continue',
+      message: 'Ready to authenticate?'
+    });
+    if (!answer.continue) {
+      await (0, _tracker.trackEvent)('login_command_browser_cancelled');
+      return;
+    }
+    const {
+      default: open
+    } = await import('open');
+    open(tokenURL, {
+      wait: false
+    });
+    await (0, _tracker.trackEvent)('login_command_browser_opened');
+    const {
+      token: tokenInput
+    } = await (0, _enquirer.prompt)({
+      type: 'password',
+      name: 'token',
+      message: 'Access Token:'
+    });
+    try {
+      token = new _token.default(tokenInput);
+    } catch (err) {
+      console.log('The token provided is malformed. Please check the token and try again.');
+      await (0, _tracker.trackEvent)('login_command_token_submit_error', {
+        error: err.message
+      });
       return;
     }
+    if (token.expired()) {
+      console.log('The token provided is expired. Please log in again to refresh the token.');
+      await (0, _tracker.trackEvent)('login_command_token_submit_error', {
+        error: 'expired'
+      });
+      return;
+    }
+    if (!token.valid()) {
+      console.log('The provided token is not valid. Please log in again to refresh the token.');
+      await (0, _tracker.trackEvent)('login_command_token_submit_error', {
+        error: 'invalid'
+      });
+      return;
+    }
+    try {
+      await _token.default.set(token.raw);
+    } catch (err) {
+      await (0, _tracker.trackEvent)('login_command_token_submit_error', {
+        error: err.message
+      });
+      throw err;
+    }
+
+    // De-anonymize user for tracking
+    await (0, _tracker.aliasUser)(token.id);
+    await (0, _tracker.trackEvent)('login_command_token_submit_success');
     if (isLoginCommand) {
       console.log('You are now logged in - see `vip -h` for a list of available commands.');
       process.exit();
     }
-    if (await maybeExecuteSeaTargetCommand()) {
-      return;
-    }
     await runCmd();
   }
 };

package/dist/commands/phpmyadmin.js

@@ -4,6 +4,7 @@ exports.__esModule = true;
 exports.PhpMyAdminCommand = exports.GET_PHP_MY_ADMIN_STATUS_QUERY = exports.GENERATE_PHP_MY_ADMIN_URL_MUTATION = exports.ENABLE_PHP_MY_ADMIN_MUTATION = void 0;
 var _chalk = _interopRequireDefault(require("chalk"));
 var _graphqlTag = _interopRequireDefault(require("graphql-tag"));
+var _promises = require("node:timers/promises");
 var _api = _interopRequireWildcard(require("../lib/api"));
 var exit = _interopRequireWildcard(require("../lib/cli/exit"));
 var _progress = require("../lib/cli/progress");
@@ -94,6 +95,45 @@ async function getPhpMyAdminStatus(appId, envId) {
   (0, _api.enableGlobalGraphQLErrorHandling)();
   return resp.data?.app?.environments?.[0]?.phpMyAdminStatus?.status ?? '';
 }
+class MyProgressTracker extends _progress.ProgressTracker {
+  constructor(steps, silent) {
+    super(steps);
+    this.silent = silent;
+  }
+  setSilent(silent) {
+    this.silent = silent;
+  }
+  print() {
+    if (!this.silent) {
+      super.print();
+    }
+  }
+  startPrinting(prePrintCallback) {
+    if (!this.silent) {
+      super.startPrinting(prePrintCallback);
+    }
+  }
+  stopPrinting() {
+    if (!this.silent) {
+      super.stopPrinting();
+    }
+  }
+  stepRunning(stepId, additionalInfo) {
+    if (!this.silent) {
+      super.stepRunning(stepId, additionalInfo);
+    }
+  }
+  stepSuccess(stepId, additionalInfo) {
+    if (!this.silent) {
+      super.stepSuccess(stepId, additionalInfo);
+    }
+  }
+  stepFailed(stepId, additionalInfo) {
+    if (!this.silent) {
+      super.stepFailed(stepId, additionalInfo);
+    }
+  }
+}
 class PhpMyAdminCommand {
   silent;
   steps = {
@@ -101,23 +141,23 @@ class PhpMyAdminCommand {
     GENERATE: 'generate'
   };
   progressTracker;
-  constructor(app, env, track = async () => {}) {
+  constructor(app, env, track = async () => {}, silent = false) {
     this.app = app;
     this.env = env;
     this.track = track;
-    this.progressTracker = new _progress.ProgressTracker([{
+    this.silent = silent;
+    this.progressTracker = new MyProgressTracker([{
       id: this.steps.ENABLE,
-      name: 'Enabling PHPMyAdmin for this environment'
+      name: 'Enabling phpMyAdmin for this environment'
     }, {
       id: this.steps.GENERATE,
       name: 'Generating access link'
-    }]);
+    }], silent);
   }
   log(msg) {
-    if (this.silent) {
-      return;
+    if (!this.silent) {
+      console.log(msg);
     }
-    console.log(msg);
   }
   stopProgressTracker() {
     this.progressTracker.print();
@@ -141,19 +181,22 @@ class PhpMyAdminCommand {
       await (0, _utils.pollUntil)(this.getStatus.bind(this), 1000, sts => sts === 'running');
 
       // Additional 30s for LB routing to be updated
-      await new Promise(resolve => setTimeout(resolve, 30000));
+      await (0, _promises.setTimeout)(30_000);
     }
   }
-  async run(silent = false) {
-    this.silent = silent;
+  async run({
+    print = false
+  } = {}) {
     if (!this.app.id) {
       exit.withError('No app was specified');
     }
     if (!this.env.id) {
       exit.withError('No environment was specified');
     }
-    const message = 'Note: PHPMyAdmin sessions are read-only. If you run a query that writes to DB, it will fail.';
-    console.log(_chalk.default.yellow(message));
+    if (!this.silent) {
+      const message = 'Note: PHPMyAdmin sessions are read-only. If you run a query that writes to DB, it will fail.';
+      console.log(_chalk.default.yellow(message));
+    }
     this.progressTracker.startPrinting();
     try {
       this.progressTracker.stepRunning(this.steps.ENABLE);
@@ -171,7 +214,7 @@ class PhpMyAdminCommand {
       if (error.graphQLErrors?.find(gqlError => gqlError.message === 'Unauthorized')) {
         exit.withError('You do not have sufficient permission to access phpMyAdmin for this environment.');
       }
-      exit.withError('Failed to enable PhpMyAdmin. Please try again. If the problem persists, please contact support.');
+      exit.withError('Failed to enable phpMyAdmin. Please try again. If the problem persists, please contact support.');
     }
     let url;
     try {
@@ -187,11 +230,16 @@ class PhpMyAdminCommand {
         stack: error.stack
       });
       this.stopProgressTracker();
-      exit.withError(`Failed to generate PhpMyAdmin URL: ${error.message}`);
+      exit.withError(`Failed to generate phpMyAdmin URL: ${error.message}`);
     }
-    void this.openUrl(url);
     this.stopProgressTracker();
-    this.log('PhpMyAdmin is opened in your default browser.');
+    if (print) {
+      // Output only the URL to stdout for scripting/automation use
+      console.log(url);
+    } else {
+      void this.openUrl(url);
+      this.log('phpMyAdmin is opened in your default browser.');
+    }
   }
 }
 exports.PhpMyAdminCommand = PhpMyAdminCommand;