@vercel/microfrontends 2.3.0 → 2.3.2

package/dist/utils/mfe-port.js

@@ -121,7 +121,16 @@ var MicrofrontendError = class extends Error {
 };
 
 // src/config/microfrontends-config/isomorphic/index.ts
-import { parse } from "jsonc-parser";
+import { parse as parse2 } from "jsonc-parser";
+
+// src/config/microfrontends/utils/hash-application-name.ts
+import md5 from "md5";
+function hashApplicationName(name) {
+  if (!name) {
+    throw new Error("Application name is required to generate hash");
+  }
+  return md5(name).substring(0, 6).padStart(6, "0");
+}
 
 // src/config/overrides/constants.ts
 var OVERRIDES_COOKIE_PREFIX = "vercel-micro-frontends-override";
@@ -271,6 +280,231 @@ function getConfigStringFromEnv() {
   return config;
 }
 
+// src/config/microfrontends/utils/find-config.ts
+import fs from "node:fs";
+import { join } from "node: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 = join(dir, filename);
+    if (fs.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
+import { readFileSync, statSync } from "node:fs";
+import { dirname, join as join2 } from "node:path";
+import fg from "fast-glob";
+import { parse } from "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 = fg.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 = join2(
+          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 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 {
+    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 = join2(
+    repositoryRoot,
+    ".vercel",
+    customConfigFilename || "microfrontends.json"
+  );
+  return existsSync(misplacedConfigPath) && doesApplicationExistInConfig(misplacedConfigPath, applicationName);
+}
+function doesApplicationExistInConfig(microfrontendsJsonPath, applicationName) {
+  try {
+    const microfrontendsJsonContent = readFileSync(
+      microfrontendsJsonPath,
+      "utf-8"
+    );
+    const microfrontendsJson = 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";
@@ -409,26 +643,6 @@ var LocalHost = class extends Host {
   }
 };
 
-// src/config/microfrontends-config/isomorphic/utils/hash-application-name.ts
-import md5 from "md5";
-function hashApplicationName(name) {
-  if (!name) {
-    throw new Error("Application name is required to generate hash");
-  }
-  return md5(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
@@ -646,7 +860,7 @@ var Application = class {
     return this.default;
   }
   getAssetPrefix() {
-    const generatedAssetPrefix = generateAssetPrefixFromName({
+    const generatedAssetPrefix = generateDefaultAssetPrefixFromName({
       name: this.name
     });
     if ("assetPrefix" in this.serialized) {
@@ -654,6 +868,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 });
   }
@@ -740,7 +955,7 @@ var MicrofrontendConfigIsomorphic = class {
     };
   }
   static validate(config) {
-    const c = typeof config === "string" ? parse(config) : config;
+    const c = typeof config === "string" ? parse2(config) : config;
     validateConfigPaths(c.applications);
     validateConfigDefaultApplication(c.applications);
     return c;
@@ -749,7 +964,7 @@ var MicrofrontendConfigIsomorphic = class {
     cookies
   }) {
     return new MicrofrontendConfigIsomorphic({
-      config: parse(getConfigStringFromEnv()),
+      config: parse2(getConfigStringFromEnv()),
       overrides: parseOverrides(cookies ?? [])
     });
   }
@@ -863,47 +1078,6 @@ var MicrofrontendConfigIsomorphic = class {
   }
 };
 
-// src/config/microfrontends/utils/find-config.ts
-import fs from "node:fs";
-import { join } from "node: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 = join(dir, filename);
-    if (fs.existsSync(maybeConfig)) {
-      return maybeConfig;
-    }
-  }
-  return null;
-}
-
 // src/config/microfrontends/utils/find-package-root.ts
 import fs2 from "node:fs";
 import path from "node:path";
@@ -1036,179 +1210,6 @@ function getApplicationContext(opts) {
   }
 }
 
-// src/config/microfrontends/utils/infer-microfrontends-location.ts
-import { readFileSync, statSync } from "node:fs";
-import { dirname, join as join2 } from "node:path";
-import fg from "fast-glob";
-import { parse as parse2 } from "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 = fg.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 = join2(
-          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 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 {
-    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 = join2(
-    repositoryRoot,
-    ".vercel",
-    customConfigFilename || "microfrontends.json"
-  );
-  return existsSync(misplacedConfigPath) && doesApplicationExistInConfig(misplacedConfigPath, applicationName);
-}
-function doesApplicationExistInConfig(microfrontendsJsonPath, applicationName) {
-  try {
-    const microfrontendsJsonContent = readFileSync(
-      microfrontendsJsonPath,
-      "utf-8"
-    );
-    const microfrontendsJson = parse2(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
 import fs5 from "node:fs";
 import path4 from "node:path";