@vercel/microfrontends 2.3.0 → 2.3.2

package/dist/bin/cli.cjs

@@ -30,7 +30,7 @@ var import_commander = require("commander");
 // package.json
 var package_default = {
   name: "@vercel/microfrontends",
-  version: "2.3.0",
+  version: "2.3.2",
   private: false,
   description: "Defines configuration and utilities for microfrontends development",
   keywords: [
@@ -369,7 +369,16 @@ var MicrofrontendError = class extends Error {
 };
 
 // src/config/microfrontends-config/isomorphic/index.ts
-var import_jsonc_parser = require("jsonc-parser");
+var import_jsonc_parser2 = require("jsonc-parser");
+
+// src/config/microfrontends/utils/hash-application-name.ts
+var import_md5 = __toESM(require("md5"), 1);
+function hashApplicationName(name) {
+  if (!name) {
+    throw new Error("Application name is required to generate hash");
+  }
+  return (0, import_md5.default)(name).substring(0, 6).padStart(6, "0");
+}
 
 // src/config/overrides/constants.ts
 var OVERRIDES_COOKIE_PREFIX = "vercel-micro-frontends-override";
@@ -524,6 +533,231 @@ function getConfigStringFromEnv() {
   return config;
 }
 
+// src/config/microfrontends/utils/find-config.ts
+var import_node_fs = __toESM(require("fs"), 1);
+var import_node_path = require("path");
+
+// src/config/microfrontends/utils/get-config-file-name.ts
+var DEFAULT_CONFIGURATION_FILENAMES = [
+  "microfrontends.json",
+  "microfrontends.jsonc"
+];
+function getPossibleConfigurationFilenames({
+  customConfigFilename
+}) {
+  if (customConfigFilename) {
+    if (!customConfigFilename.endsWith(".json") && !customConfigFilename.endsWith(".jsonc")) {
+      throw new Error(
+        `Found VC_MICROFRONTENDS_CONFIG_FILE_NAME but the name is invalid. Received: ${customConfigFilename}. The file name must end with '.json' or '.jsonc'. It's also possible for the env var to include the path, eg microfrontends-dev.json or /path/to/microfrontends-dev.json.`
+      );
+    }
+    return Array.from(
+      /* @__PURE__ */ new Set([customConfigFilename, ...DEFAULT_CONFIGURATION_FILENAMES])
+    );
+  }
+  return DEFAULT_CONFIGURATION_FILENAMES;
+}
+
+// src/config/microfrontends/utils/find-config.ts
+function findConfig({
+  dir,
+  customConfigFilename
+}) {
+  for (const filename of getPossibleConfigurationFilenames({
+    customConfigFilename
+  })) {
+    const maybeConfig = (0, import_node_path.join)(dir, filename);
+    if (import_node_fs.default.existsSync(maybeConfig)) {
+      return maybeConfig;
+    }
+  }
+  return null;
+}
+
+// src/config/microfrontends/utils/generate-default-asset-prefix.ts
+var PREFIX = "vc-ap";
+function generateDefaultAssetPrefixFromName({
+  name
+}) {
+  if (!name) {
+    throw new Error("Name is required to generate an asset prefix");
+  }
+  return `${PREFIX}-${hashApplicationName(name)}`;
+}
+
+// src/config/microfrontends/utils/infer-microfrontends-location.ts
+var import_node_fs2 = require("fs");
+var import_node_path2 = require("path");
+var import_fast_glob = __toESM(require("fast-glob"), 1);
+var import_jsonc_parser = require("jsonc-parser");
+var configCache = {};
+function findPackageWithMicrofrontendsConfig({
+  repositoryRoot,
+  applicationContext,
+  customConfigFilename
+}) {
+  const applicationName = applicationContext.name;
+  logger.debug(
+    "[MFE Config] Searching repository for configs containing application:",
+    applicationName
+  );
+  try {
+    const microfrontendsJsonPaths = import_fast_glob.default.globSync(
+      `**/{${getPossibleConfigurationFilenames({ customConfigFilename }).join(",")}}`,
+      {
+        cwd: repositoryRoot,
+        absolute: true,
+        onlyFiles: true,
+        followSymbolicLinks: false,
+        ignore: ["**/node_modules/**", "**/.git/**"]
+      }
+    );
+    logger.debug(
+      "[MFE Config] Found",
+      microfrontendsJsonPaths.length,
+      "config file(s) in repository"
+    );
+    const matchingPaths = [];
+    for (const microfrontendsJsonPath of microfrontendsJsonPaths) {
+      if (doesApplicationExistInConfig(microfrontendsJsonPath, applicationName)) {
+        matchingPaths.push(microfrontendsJsonPath);
+      }
+    }
+    logger.debug(
+      "[MFE Config] Total matching config files:",
+      matchingPaths.length
+    );
+    if (matchingPaths.length > 1) {
+      throw new MicrofrontendError(
+        `Found multiple \`microfrontends.json\` files in the repository referencing the application "${applicationName}", but only one is allowed.
+${matchingPaths.join("\n  \u2022 ")}`,
+        { type: "config", subtype: "inference_failed" }
+      );
+    }
+    if (matchingPaths.length === 0) {
+      if (repositoryRoot && doesMisplacedConfigExist(
+        repositoryRoot,
+        applicationName,
+        customConfigFilename
+      )) {
+        logger.debug(
+          "[MFE Config] Found misplaced config in wrong .vercel directory in repository"
+        );
+        const misplacedConfigPath = (0, import_node_path2.join)(
+          repositoryRoot,
+          ".vercel",
+          customConfigFilename || "microfrontends.json"
+        );
+        throw new MicrofrontendError(
+          `Unable to automatically infer the location of the \`microfrontends.json\` file.
+
+A microfrontends config was found in the \`.vercel\` directory at the repository root: ${misplacedConfigPath}
+However, in a monorepo, the config file should be placed in the \`.vercel\` directory in your application directory instead.
+
+To fix this:
+1. If using \`vercel link\`, run it with \`vercel link --repo\` to handle monorepos, or run \`vercel microfrontends pull --cwd=<application-directory>\` to make sure it pulls the \`microfrontends.json\` file to the correct location
+2. If manually defined, move the config file to the \`.vercel\` directory in your application
+3. Alternatively, set the VC_MICROFRONTENDS_CONFIG environment variable to the correct path
+
+For more information, see: https://vercel.com/docs/cli/project-linking`,
+          { type: "config", subtype: "inference_failed" }
+        );
+      }
+      let additionalErrorMessage = "";
+      if (microfrontendsJsonPaths.length > 0) {
+        if (!applicationContext.projectName) {
+          additionalErrorMessage = `
+
+If the name in package.json (${applicationContext.packageJsonName}) differs from your Vercel Project name, set the \`packageName\` field for the application in \`microfrontends.json\` to ensure that the configuration can be found locally.`;
+        } else {
+          additionalErrorMessage = `
+
+Names of applications in \`microfrontends.json\` must match the Vercel Project name (${applicationContext.projectName}).`;
+        }
+      }
+      throw new MicrofrontendError(
+        `Could not find a \`microfrontends.json\` file in the repository that contains the "${applicationName}" application.${additionalErrorMessage}
+
+If your Vercel Microfrontends configuration is not in this repository, you can use the Vercel CLI to pull the Vercel Microfrontends configuration using the "vercel microfrontends pull" command, or you can specify the path manually using the VC_MICROFRONTENDS_CONFIG environment variable.
+
+If your Vercel Microfrontends configuration has a custom name, ensure the VC_MICROFRONTENDS_CONFIG_FILE_NAME environment variable is set, you can pull the vercel project environment variables using the "vercel env pull" command.
+
+If you suspect this is thrown in error, please reach out to the Vercel team.`,
+        { type: "config", subtype: "inference_failed" }
+      );
+    }
+    const [packageJsonPath] = matchingPaths;
+    return (0, import_node_path2.dirname)(packageJsonPath);
+  } catch (error2) {
+    if (error2 instanceof MicrofrontendError) {
+      throw error2;
+    }
+    return null;
+  }
+}
+function inferMicrofrontendsLocation(opts) {
+  const cacheKey = `${opts.repositoryRoot}-${opts.applicationContext.name}${opts.customConfigFilename ? `-${opts.customConfigFilename}` : ""}`;
+  if (configCache[cacheKey]) {
+    return configCache[cacheKey];
+  }
+  const result = findPackageWithMicrofrontendsConfig(opts);
+  if (!result) {
+    throw new MicrofrontendError(
+      `Could not infer the location of the \`microfrontends.json\` file for application "${opts.applicationContext.name}" starting in directory "${opts.repositoryRoot}".`,
+      { type: "config", subtype: "inference_failed" }
+    );
+  }
+  configCache[cacheKey] = result;
+  return result;
+}
+function existsSync(path7) {
+  try {
+    (0, import_node_fs2.statSync)(path7);
+    return true;
+  } catch (_) {
+    return false;
+  }
+}
+function doesMisplacedConfigExist(repositoryRoot, applicationName, customConfigFilename) {
+  logger.debug(
+    "[MFE Config] Looking for misplaced config in wrong .vercel directory"
+  );
+  const misplacedConfigPath = (0, import_node_path2.join)(
+    repositoryRoot,
+    ".vercel",
+    customConfigFilename || "microfrontends.json"
+  );
+  return existsSync(misplacedConfigPath) && doesApplicationExistInConfig(misplacedConfigPath, applicationName);
+}
+function doesApplicationExistInConfig(microfrontendsJsonPath, applicationName) {
+  try {
+    const microfrontendsJsonContent = (0, import_node_fs2.readFileSync)(
+      microfrontendsJsonPath,
+      "utf-8"
+    );
+    const microfrontendsJson = (0, import_jsonc_parser.parse)(microfrontendsJsonContent);
+    if (microfrontendsJson.applications[applicationName]) {
+      logger.debug(
+        "[MFE Config] Found application in config:",
+        microfrontendsJsonPath
+      );
+      return true;
+    }
+    for (const [_, app] of Object.entries(microfrontendsJson.applications)) {
+      if (app.packageName === applicationName) {
+        logger.debug(
+          "[MFE Config] Found application via packageName in config:",
+          microfrontendsJsonPath
+        );
+        return true;
+      }
+    }
+  } catch (error2) {
+    logger.debug("[MFE Config] Error checking application in config:", error2);
+  }
+  return false;
+}
+
 // src/config/microfrontends-config/isomorphic/constants.ts
 var DEFAULT_LOCAL_PROXY_PORT = 3024;
 var MFE_APP_PORT_ENV = "MFE_APP_PORT";
@@ -662,26 +896,6 @@ var LocalHost = class extends Host {
   }
 };
 
-// src/config/microfrontends-config/isomorphic/utils/hash-application-name.ts
-var import_md5 = __toESM(require("md5"), 1);
-function hashApplicationName(name) {
-  if (!name) {
-    throw new Error("Application name is required to generate hash");
-  }
-  return (0, import_md5.default)(name).substring(0, 6).padStart(6, "0");
-}
-
-// src/config/microfrontends-config/isomorphic/utils/generate-asset-prefix.ts
-var PREFIX = "vc-ap";
-function generateAssetPrefixFromName({
-  name
-}) {
-  if (!name) {
-    throw new Error("Name is required to generate an asset prefix");
-  }
-  return `${PREFIX}-${hashApplicationName(name)}`;
-}
-
 // src/config/microfrontends-config/isomorphic/utils/generate-automation-bypass-env-var-name.ts
 function generateAutomationBypassEnvVarName({
   name
@@ -899,7 +1113,7 @@ var Application = class {
     return this.default;
   }
   getAssetPrefix() {
-    const generatedAssetPrefix = generateAssetPrefixFromName({
+    const generatedAssetPrefix = generateDefaultAssetPrefixFromName({
       name: this.name
     });
     if ("assetPrefix" in this.serialized) {
@@ -907,6 +1121,7 @@ var Application = class {
     }
     return generatedAssetPrefix;
   }
+  /** @deprecated Prefer `VERCEL_AUTOMATION_BYPASS_SECRET`. Use this only if each project needs its own distinct bypass secret. */
   getAutomationBypassEnvVarName() {
     return generateAutomationBypassEnvVarName({ name: this.name });
   }
@@ -993,7 +1208,7 @@ var MicrofrontendConfigIsomorphic = class {
     };
   }
   static validate(config) {
-    const c = typeof config === "string" ? (0, import_jsonc_parser.parse)(config) : config;
+    const c = typeof config === "string" ? (0, import_jsonc_parser2.parse)(config) : config;
     validateConfigPaths(c.applications);
     validateConfigDefaultApplication(c.applications);
     return c;
@@ -1002,7 +1217,7 @@ var MicrofrontendConfigIsomorphic = class {
     cookies
   }) {
     return new MicrofrontendConfigIsomorphic({
-      config: (0, import_jsonc_parser.parse)(getConfigStringFromEnv()),
+      config: (0, import_jsonc_parser2.parse)(getConfigStringFromEnv()),
       overrides: parseOverrides(cookies ?? [])
     });
   }
@@ -1116,59 +1331,18 @@ var MicrofrontendConfigIsomorphic = class {
   }
 };
 
-// src/config/microfrontends/utils/find-config.ts
-var import_node_fs = __toESM(require("fs"), 1);
-var import_node_path = require("path");
-
-// src/config/microfrontends/utils/get-config-file-name.ts
-var DEFAULT_CONFIGURATION_FILENAMES = [
-  "microfrontends.json",
-  "microfrontends.jsonc"
-];
-function getPossibleConfigurationFilenames({
-  customConfigFilename
-}) {
-  if (customConfigFilename) {
-    if (!customConfigFilename.endsWith(".json") && !customConfigFilename.endsWith(".jsonc")) {
-      throw new Error(
-        `Found VC_MICROFRONTENDS_CONFIG_FILE_NAME but the name is invalid. Received: ${customConfigFilename}. The file name must end with '.json' or '.jsonc'. It's also possible for the env var to include the path, eg microfrontends-dev.json or /path/to/microfrontends-dev.json.`
-      );
-    }
-    return Array.from(
-      /* @__PURE__ */ new Set([customConfigFilename, ...DEFAULT_CONFIGURATION_FILENAMES])
-    );
-  }
-  return DEFAULT_CONFIGURATION_FILENAMES;
-}
-
-// src/config/microfrontends/utils/find-config.ts
-function findConfig({
-  dir,
-  customConfigFilename
-}) {
-  for (const filename of getPossibleConfigurationFilenames({
-    customConfigFilename
-  })) {
-    const maybeConfig = (0, import_node_path.join)(dir, filename);
-    if (import_node_fs.default.existsSync(maybeConfig)) {
-      return maybeConfig;
-    }
-  }
-  return null;
-}
-
 // src/config/microfrontends/utils/find-package-root.ts
-var import_node_fs2 = __toESM(require("fs"), 1);
-var import_node_path2 = __toESM(require("path"), 1);
+var import_node_fs3 = __toESM(require("fs"), 1);
+var import_node_path3 = __toESM(require("path"), 1);
 var PACKAGE_JSON = "package.json";
 function findPackageRoot(startDir) {
   let currentDir = startDir || process.cwd();
-  while (currentDir !== import_node_path2.default.parse(currentDir).root) {
-    const pkgJsonPath = import_node_path2.default.join(currentDir, PACKAGE_JSON);
-    if (import_node_fs2.default.existsSync(pkgJsonPath)) {
+  while (currentDir !== import_node_path3.default.parse(currentDir).root) {
+    const pkgJsonPath = import_node_path3.default.join(currentDir, PACKAGE_JSON);
+    if (import_node_fs3.default.existsSync(pkgJsonPath)) {
       return currentDir;
     }
-    currentDir = import_node_path2.default.dirname(currentDir);
+    currentDir = import_node_path3.default.dirname(currentDir);
   }
   throw new Error(
     `The root of the package that contains the \`package.json\` file for the \`${startDir}\` directory could not be found.`
@@ -1176,18 +1350,18 @@ function findPackageRoot(startDir) {
 }
 
 // src/config/microfrontends/utils/find-repository-root.ts
-var import_node_fs3 = __toESM(require("fs"), 1);
-var import_node_path3 = __toESM(require("path"), 1);
+var import_node_fs4 = __toESM(require("fs"), 1);
+var import_node_path4 = __toESM(require("path"), 1);
 var GIT_DIRECTORY = ".git";
 function hasGitDirectory(dir) {
-  const gitPath = import_node_path3.default.join(dir, GIT_DIRECTORY);
-  return import_node_fs3.default.existsSync(gitPath) && import_node_fs3.default.statSync(gitPath).isDirectory();
+  const gitPath = import_node_path4.default.join(dir, GIT_DIRECTORY);
+  return import_node_fs4.default.existsSync(gitPath) && import_node_fs4.default.statSync(gitPath).isDirectory();
 }
 function hasPnpmWorkspaces(dir) {
-  return import_node_fs3.default.existsSync(import_node_path3.default.join(dir, "pnpm-workspace.yaml"));
+  return import_node_fs4.default.existsSync(import_node_path4.default.join(dir, "pnpm-workspace.yaml"));
 }
 function hasPackageJson(dir) {
-  return import_node_fs3.default.existsSync(import_node_path3.default.join(dir, "package.json"));
+  return import_node_fs4.default.existsSync(import_node_path4.default.join(dir, "package.json"));
 }
 function findRepositoryRoot(startDir) {
   if (process.env.NX_WORKSPACE_ROOT) {
@@ -1195,14 +1369,14 @@ function findRepositoryRoot(startDir) {
   }
   let currentDir = startDir || process.cwd();
   let lastPackageJsonDir = null;
-  while (currentDir !== import_node_path3.default.parse(currentDir).root) {
+  while (currentDir !== import_node_path4.default.parse(currentDir).root) {
     if (hasGitDirectory(currentDir) || hasPnpmWorkspaces(currentDir)) {
       return currentDir;
     }
     if (hasPackageJson(currentDir)) {
       lastPackageJsonDir = currentDir;
     }
-    currentDir = import_node_path3.default.dirname(currentDir);
+    currentDir = import_node_path4.default.dirname(currentDir);
   }
   if (lastPackageJsonDir) {
     return lastPackageJsonDir;
@@ -1213,8 +1387,8 @@ function findRepositoryRoot(startDir) {
 }
 
 // src/config/microfrontends/utils/get-application-context.ts
-var import_node_fs4 = __toESM(require("fs"), 1);
-var import_node_path4 = __toESM(require("path"), 1);
+var import_node_fs5 = __toESM(require("fs"), 1);
+var import_node_path5 = __toESM(require("path"), 1);
 function getApplicationContext(opts) {
   if (opts?.appName) {
     logger.debug(
@@ -1244,8 +1418,8 @@ function getApplicationContext(opts) {
     };
   }
   try {
-    const vercelProjectJsonPath = import_node_fs4.default.readFileSync(
-      import_node_path4.default.join(opts?.packageRoot || ".", ".vercel", "project.json"),
+    const vercelProjectJsonPath = import_node_fs5.default.readFileSync(
+      import_node_path5.default.join(opts?.packageRoot || ".", ".vercel", "project.json"),
       "utf-8"
     );
     const projectJson = JSON.parse(vercelProjectJsonPath);
@@ -1262,8 +1436,8 @@ function getApplicationContext(opts) {
   } catch (_) {
   }
   try {
-    const packageJsonString = import_node_fs4.default.readFileSync(
-      import_node_path4.default.join(opts?.packageRoot || ".", "package.json"),
+    const packageJsonString = import_node_fs5.default.readFileSync(
+      import_node_path5.default.join(opts?.packageRoot || ".", "package.json"),
       "utf-8"
     );
     const packageJson = JSON.parse(packageJsonString);
@@ -1289,179 +1463,6 @@ function getApplicationContext(opts) {
   }
 }
 
-// src/config/microfrontends/utils/infer-microfrontends-location.ts
-var import_node_fs5 = require("fs");
-var import_node_path5 = require("path");
-var import_fast_glob = __toESM(require("fast-glob"), 1);
-var import_jsonc_parser2 = require("jsonc-parser");
-var configCache = {};
-function findPackageWithMicrofrontendsConfig({
-  repositoryRoot,
-  applicationContext,
-  customConfigFilename
-}) {
-  const applicationName = applicationContext.name;
-  logger.debug(
-    "[MFE Config] Searching repository for configs containing application:",
-    applicationName
-  );
-  try {
-    const microfrontendsJsonPaths = import_fast_glob.default.globSync(
-      `**/{${getPossibleConfigurationFilenames({ customConfigFilename }).join(",")}}`,
-      {
-        cwd: repositoryRoot,
-        absolute: true,
-        onlyFiles: true,
-        followSymbolicLinks: false,
-        ignore: ["**/node_modules/**", "**/.git/**"]
-      }
-    );
-    logger.debug(
-      "[MFE Config] Found",
-      microfrontendsJsonPaths.length,
-      "config file(s) in repository"
-    );
-    const matchingPaths = [];
-    for (const microfrontendsJsonPath of microfrontendsJsonPaths) {
-      if (doesApplicationExistInConfig(microfrontendsJsonPath, applicationName)) {
-        matchingPaths.push(microfrontendsJsonPath);
-      }
-    }
-    logger.debug(
-      "[MFE Config] Total matching config files:",
-      matchingPaths.length
-    );
-    if (matchingPaths.length > 1) {
-      throw new MicrofrontendError(
-        `Found multiple \`microfrontends.json\` files in the repository referencing the application "${applicationName}", but only one is allowed.
-${matchingPaths.join("\n  \u2022 ")}`,
-        { type: "config", subtype: "inference_failed" }
-      );
-    }
-    if (matchingPaths.length === 0) {
-      if (repositoryRoot && doesMisplacedConfigExist(
-        repositoryRoot,
-        applicationName,
-        customConfigFilename
-      )) {
-        logger.debug(
-          "[MFE Config] Found misplaced config in wrong .vercel directory in repository"
-        );
-        const misplacedConfigPath = (0, import_node_path5.join)(
-          repositoryRoot,
-          ".vercel",
-          customConfigFilename || "microfrontends.json"
-        );
-        throw new MicrofrontendError(
-          `Unable to automatically infer the location of the \`microfrontends.json\` file.
-
-A microfrontends config was found in the \`.vercel\` directory at the repository root: ${misplacedConfigPath}
-However, in a monorepo, the config file should be placed in the \`.vercel\` directory in your application directory instead.
-
-To fix this:
-1. If using \`vercel link\`, run it with \`vercel link --repo\` to handle monorepos, or run \`vercel microfrontends pull --cwd=<application-directory>\` to make sure it pulls the \`microfrontends.json\` file to the correct location
-2. If manually defined, move the config file to the \`.vercel\` directory in your application
-3. Alternatively, set the VC_MICROFRONTENDS_CONFIG environment variable to the correct path
-
-For more information, see: https://vercel.com/docs/cli/project-linking`,
-          { type: "config", subtype: "inference_failed" }
-        );
-      }
-      let additionalErrorMessage = "";
-      if (microfrontendsJsonPaths.length > 0) {
-        if (!applicationContext.projectName) {
-          additionalErrorMessage = `
-
-If the name in package.json (${applicationContext.packageJsonName}) differs from your Vercel Project name, set the \`packageName\` field for the application in \`microfrontends.json\` to ensure that the configuration can be found locally.`;
-        } else {
-          additionalErrorMessage = `
-
-Names of applications in \`microfrontends.json\` must match the Vercel Project name (${applicationContext.projectName}).`;
-        }
-      }
-      throw new MicrofrontendError(
-        `Could not find a \`microfrontends.json\` file in the repository that contains the "${applicationName}" application.${additionalErrorMessage}
-
-If your Vercel Microfrontends configuration is not in this repository, you can use the Vercel CLI to pull the Vercel Microfrontends configuration using the "vercel microfrontends pull" command, or you can specify the path manually using the VC_MICROFRONTENDS_CONFIG environment variable.
-
-If your Vercel Microfrontends configuration has a custom name, ensure the VC_MICROFRONTENDS_CONFIG_FILE_NAME environment variable is set, you can pull the vercel project environment variables using the "vercel env pull" command.
-
-If you suspect this is thrown in error, please reach out to the Vercel team.`,
-        { type: "config", subtype: "inference_failed" }
-      );
-    }
-    const [packageJsonPath] = matchingPaths;
-    return (0, import_node_path5.dirname)(packageJsonPath);
-  } catch (error2) {
-    if (error2 instanceof MicrofrontendError) {
-      throw error2;
-    }
-    return null;
-  }
-}
-function inferMicrofrontendsLocation(opts) {
-  const cacheKey = `${opts.repositoryRoot}-${opts.applicationContext.name}${opts.customConfigFilename ? `-${opts.customConfigFilename}` : ""}`;
-  if (configCache[cacheKey]) {
-    return configCache[cacheKey];
-  }
-  const result = findPackageWithMicrofrontendsConfig(opts);
-  if (!result) {
-    throw new MicrofrontendError(
-      `Could not infer the location of the \`microfrontends.json\` file for application "${opts.applicationContext.name}" starting in directory "${opts.repositoryRoot}".`,
-      { type: "config", subtype: "inference_failed" }
-    );
-  }
-  configCache[cacheKey] = result;
-  return result;
-}
-function existsSync(path7) {
-  try {
-    (0, import_node_fs5.statSync)(path7);
-    return true;
-  } catch (_) {
-    return false;
-  }
-}
-function doesMisplacedConfigExist(repositoryRoot, applicationName, customConfigFilename) {
-  logger.debug(
-    "[MFE Config] Looking for misplaced config in wrong .vercel directory"
-  );
-  const misplacedConfigPath = (0, import_node_path5.join)(
-    repositoryRoot,
-    ".vercel",
-    customConfigFilename || "microfrontends.json"
-  );
-  return existsSync(misplacedConfigPath) && doesApplicationExistInConfig(misplacedConfigPath, applicationName);
-}
-function doesApplicationExistInConfig(microfrontendsJsonPath, applicationName) {
-  try {
-    const microfrontendsJsonContent = (0, import_node_fs5.readFileSync)(
-      microfrontendsJsonPath,
-      "utf-8"
-    );
-    const microfrontendsJson = (0, import_jsonc_parser2.parse)(microfrontendsJsonContent);
-    if (microfrontendsJson.applications[applicationName]) {
-      logger.debug(
-        "[MFE Config] Found application in config:",
-        microfrontendsJsonPath
-      );
-      return true;
-    }
-    for (const [_, app] of Object.entries(microfrontendsJson.applications)) {
-      if (app.packageName === applicationName) {
-        logger.debug(
-          "[MFE Config] Found application via packageName in config:",
-          microfrontendsJsonPath
-        );
-        return true;
-      }
-    }
-  } catch (error2) {
-    logger.debug("[MFE Config] Error checking application in config:", error2);
-  }
-  return false;
-}
-
 // src/config/microfrontends/utils/is-monorepo.ts
 var import_node_fs6 = __toESM(require("fs"), 1);
 var import_node_path6 = __toESM(require("path"), 1);
@@ -2032,7 +2033,13 @@ var localAuthHtml = ({
   override
 }) => {
   const intro = override ? `<b><code>${app}</code></b> is overriding to a protected deployment <a target="_blank" href="https://${override}">${override}</a>.` : `<b><code>${app}</code></b> is falling back to a protected deployment <a target="_blank" href="https://${hostname}">${hostname}</a>.`;
-  const content = automationBypass ? `<b><code>${automationBypassEnvVarName}</code></b> is set with the value <b><code>${automationBypass}</code></b>, please verify this value equals the <a href="https://vercel.com/docs/deployment-protection/methods-to-bypass-deployment-protection/protection-bypass-automation">Protection Bypass for Automation</a> for the Vercel project hosting the deployment.` : `To access, set a local environment variable <b><code>${automationBypassEnvVarName}</code></b> with the value of the <a href="https://vercel.com/docs/deployment-protection/methods-to-bypass-deployment-protection/protection-bypass-automation">Protection Bypass for Automation</a> for the Vercel project hosting the deployment.`;
+  const bypassDocsLink = `<a href="https://vercel.com/docs/deployment-protection/methods-to-bypass-deployment-protection/protection-bypass-automation">Protection Bypass for Automation</a>`;
+  const content = automationBypass ? `<span><b><code>${automationBypassEnvVarName}</code></b> is set with the value <b><code>${automationBypass}</code></b>, please verify this value is also configured as a ${bypassDocsLink} secret in the <b><code>${app}</code></b> Vercel project.</span>` : `To access, follow these steps:
+        <ol>
+          <li>In the <b><code>${defaultApp}</code></b> Vercel project, go to Settings \u2192 Deployment Protection \u2192 ensure ${bypassDocsLink} is enabled and a secret exists (add one if not). Copy the secret.</li>
+          <li>In the <b><code>${app}</code></b> Vercel project, go to Settings \u2192 Deployment Protection \u2192 add a new secret with the copied secret from <b><code>${defaultApp}</code></b>.</li>
+          <li>Add <b><code>${automationBypassEnvVarName}=&lt;secret&gt;</code></b> to the <b><code>${defaultApp}</code></b> local environment file (e.g. <b><code>.env.local</code></b>).</li>
+        </ol>`;
   const action = override ? `<buttton onClick="clearOverride()" class="button">Clear Override</button>` : "";
   return `<!DOCTYPE html>
 	<html lang="en">
@@ -2344,13 +2351,11 @@ var localAuthHtml = ({
 	  <body>
 		<div class="container">
 		  <main>
-			<p class="devinfo-container">
+			<div class="devinfo-container">
 			  	<span>${intro}</span>
 				<br/>
-				<span>${content}</span>
-				<br/>
-				<span>The environment variable should be set in the default app <b><code>${defaultApp}</code></b>, where the local proxy is running.</span>
-			</p>
+				<div>${content}</div>
+			</div>
 		
 			<a href="https://vercel.com/docs/microfrontends/local-development#falling-back-to-protected-deployments"><div class="note">Click here to learn more about setting up the environment variable.</div></a>
 		
@@ -2793,7 +2798,9 @@ var LocalProxy = class {
     if (target.protocol === "https") {
       const { hostname, port, path: path7 } = target;
       const app = this.router.config.getApplication(target.application);
-      const automationBypass = process.env[app.getAutomationBypassEnvVarName()];
+      const perAppEnvVarName = app.getAutomationBypassEnvVarName();
+      const automationBypass = process.env[perAppEnvVarName] ?? process.env.VERCEL_AUTOMATION_BYPASS_SECRET;
+      const automationBypassEnvVarName = process.env[perAppEnvVarName] !== void 0 ? perAppEnvVarName : "VERCEL_AUTOMATION_BYPASS_SECRET";
       const cookies = (0, import_cookie.parse)(req.headers.cookie || "");
       const overrideCookieName = getAppEnvOverrideCookieName(
         target.application
@@ -2829,7 +2836,7 @@ var LocalProxy = class {
               app: target.application,
               hostname,
               defaultApp: defaultApp.packageName || defaultApp.name,
-              automationBypassEnvVarName: app.getAutomationBypassEnvVarName(),
+              automationBypassEnvVarName,
               automationBypass,
               override: cookies[overrideCookieName]
             })
@@ -3082,7 +3089,7 @@ function main() {
     []
   ).addOption(new import_commander.Option("--names <names...>").hideHelp()).option("--port <port>", "Port proxy will use", (value) => {
     const parsedValue = Number.parseInt(value, 10);
-    if (isNaN(parsedValue) || parsedValue <= 0) {
+    if (Number.isNaN(parsedValue) || parsedValue <= 0) {
       throw new Error(
         "The value passed in to --port must be a positive number."
       );