@vercel/microfrontends 2.2.1 → 2.2.2

package/dist/next/middleware.cjs

@@ -39,45 +39,33 @@ module.exports = __toCommonJS(middleware_exports);
 var import_server = require("next/server");
 var import_path_to_regexp3 = require("path-to-regexp");
 
-// src/config/well-known/endpoints.ts
-async function getWellKnownClientData(config, flagValues = {}) {
-  const clientConfig = config.toClientConfig();
-  for (const [applicationName, application] of Object.entries(
-    clientConfig.applications
-  )) {
-    if (!application.routing) {
-      continue;
-    }
-    const allPaths = [];
-    for (const pathGroup of application.routing) {
-      if (pathGroup.flag) {
-        const flagName = pathGroup.flag;
-        const flagFn = flagValues[flagName];
-        if (!flagFn) {
-          throw new Error(
-            `Flag "${flagName}" was specified to control routing for path group "${pathGroup.group}" in application ${applicationName} but not found in provided flag values.`
-          );
-        }
-        const flagEnabled = await flagFn();
-        if (flagEnabled) {
-          allPaths.push(...pathGroup.paths);
-        }
-      } else {
-        allPaths.push(...pathGroup.paths);
-      }
-    }
-    application.routing = allPaths.length > 0 ? [{ paths: allPaths }] : [];
-  }
-  return {
-    config: clientConfig.serialize()
-  };
-}
-
 // src/bin/local-proxy-is-running.ts
 function localProxyIsRunning() {
   return process.env.TURBO_TASK_HAS_MFE_PROXY === "true";
 }
 
+// src/bin/logger.ts
+function debug(...args) {
+  if (process.env.MFE_DEBUG) {
+    console.log(...args);
+  }
+}
+function info(...args) {
+  console.log(...args);
+}
+function warn(...args) {
+  console.warn(...args);
+}
+function error(...args) {
+  console.error(...args);
+}
+var logger = {
+  debug,
+  info,
+  warn,
+  error
+};
+
 // src/config/microfrontends-config/isomorphic/index.ts
 var import_jsonc_parser = require("jsonc-parser");
 
@@ -173,23 +161,6 @@ var MicrofrontendError = class extends Error {
   }
 };
 
-// src/config/microfrontends-config/utils/get-config-from-env.ts
-function getConfigStringFromEnv() {
-  const config = process.env.MFE_CONFIG;
-  if (!config) {
-    throw new MicrofrontendError(`Missing "MFE_CONFIG" in environment.`, {
-      type: "config",
-      subtype: "not_found_in_env"
-    });
-  }
-  return config;
-}
-
-// src/config/schema/utils/is-default-app.ts
-function isDefaultApp(a) {
-  return !("routing" in a);
-}
-
 // src/config/overrides/constants.ts
 var OVERRIDES_COOKIE_PREFIX = "vercel-micro-frontends-override";
 var OVERRIDES_ENV_COOKIE_PREFIX = `${OVERRIDES_COOKIE_PREFIX}:env:`;
@@ -223,6 +194,11 @@ function parseOverrides(cookies) {
   return overridesConfig;
 }
 
+// src/config/schema/utils/is-default-app.ts
+function isDefaultApp(a) {
+  return !("routing" in a);
+}
+
 // src/config/microfrontends-config/client/index.ts
 var import_path_to_regexp = require("path-to-regexp");
 var regexpCache = /* @__PURE__ */ new Map();
@@ -321,6 +297,183 @@ var MicrofrontendConfigClient = class {
   }
 };
 
+// src/config/microfrontends-config/utils/get-config-from-env.ts
+function getConfigStringFromEnv() {
+  const config = process.env.MFE_CONFIG;
+  if (!config) {
+    throw new MicrofrontendError(`Missing "MFE_CONFIG" in environment.`, {
+      type: "config",
+      subtype: "not_found_in_env"
+    });
+  }
+  return config;
+}
+
+// src/config/microfrontends-config/isomorphic/constants.ts
+var DEFAULT_LOCAL_PROXY_PORT = 3024;
+var MFE_APP_PORT_ENV = "MFE_APP_PORT";
+var MFE_LOCAL_PROXY_PORT_ENV = "MFE_LOCAL_PROXY_PORT";
+
+// src/config/microfrontends-config/isomorphic/utils/generate-port.ts
+function generatePortFromName({
+  name,
+  minPort = 3e3,
+  maxPort = 8e3
+}) {
+  if (!name) {
+    throw new Error("Name is required to generate a port");
+  }
+  let hash = 0;
+  for (let i = 0; i < name.length; i++) {
+    hash = (hash << 5) - hash + name.charCodeAt(i);
+    hash |= 0;
+  }
+  hash = Math.abs(hash);
+  const range = maxPort - minPort;
+  const port = minPort + hash % range;
+  return port;
+}
+
+// src/config/microfrontends-config/isomorphic/host.ts
+var Host = class {
+  constructor(hostConfig, options) {
+    if (typeof hostConfig === "string") {
+      ({
+        protocol: this.protocol,
+        host: this.host,
+        port: this.port
+      } = Host.parseUrl(hostConfig));
+    } else {
+      const { protocol = "https", host, port } = hostConfig;
+      this.protocol = protocol;
+      this.host = host;
+      this.port = port;
+    }
+    this.local = options?.isLocal;
+  }
+  static parseUrl(url, defaultProtocol = "https") {
+    let hostToParse = url;
+    if (!/^https?:\/\//.exec(hostToParse)) {
+      hostToParse = `${defaultProtocol}://${hostToParse}`;
+    }
+    const parsed = new URL(hostToParse);
+    if (!parsed.hostname) {
+      throw new Error(Host.getMicrofrontendsError(url, "requires a host"));
+    }
+    if (parsed.hash) {
+      throw new Error(
+        Host.getMicrofrontendsError(url, "cannot have a fragment")
+      );
+    }
+    if (parsed.username || parsed.password) {
+      throw new Error(
+        Host.getMicrofrontendsError(
+          url,
+          "cannot have authentication credentials (username and/or password)"
+        )
+      );
+    }
+    if (parsed.pathname !== "/") {
+      throw new Error(Host.getMicrofrontendsError(url, "cannot have a path"));
+    }
+    if (parsed.search) {
+      throw new Error(
+        Host.getMicrofrontendsError(url, "cannot have query parameters")
+      );
+    }
+    const protocol = parsed.protocol.slice(0, -1);
+    return {
+      protocol,
+      host: parsed.hostname,
+      port: parsed.port ? Number.parseInt(parsed.port, 10) : void 0
+    };
+  }
+  static getMicrofrontendsError(url, message) {
+    return `Microfrontends configuration error: the URL ${url} in your microfrontends.json ${message}.`;
+  }
+  isLocal() {
+    return this.local || this.host === "localhost" || this.host === "127.0.0.1";
+  }
+  toString() {
+    const url = this.toUrl();
+    return url.toString().replace(/\/$/, "");
+  }
+  toUrl() {
+    const url = `${this.protocol}://${this.host}${this.port ? `:${this.port}` : ""}`;
+    return new URL(url);
+  }
+};
+var LocalHost = class extends Host {
+  constructor({
+    appName,
+    local
+  }) {
+    const portOverride = process.env[MFE_APP_PORT_ENV];
+    if (portOverride) {
+      const overridePort = Number.parseInt(portOverride, 10);
+      if (!Number.isNaN(overridePort) && overridePort > 0 && overridePort < 65536) {
+        super({
+          protocol: "http",
+          host: "localhost",
+          port: overridePort
+        });
+        return;
+      }
+    }
+    let protocol;
+    let host;
+    let port;
+    if (typeof local === "number") {
+      port = local;
+    } else if (typeof local === "string") {
+      if (/^\d+$/.test(local)) {
+        port = Number.parseInt(local, 10);
+      } else {
+        const parsed = Host.parseUrl(local, "http");
+        protocol = parsed.protocol;
+        host = parsed.host;
+        port = parsed.port;
+      }
+    } else if (local) {
+      protocol = local.protocol;
+      host = local.host;
+      port = local.port;
+    }
+    super({
+      protocol: protocol ?? "http",
+      host: host ?? "localhost",
+      port: port ?? generatePortFromName({ name: appName })
+    });
+  }
+};
+
+// 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
+}) {
+  return `AUTOMATION_BYPASS_${name.toUpperCase().replace(/[^a-zA-Z0-9]/g, "_")}`;
+}
+
 // src/config/microfrontends-config/isomorphic/validation.ts
 var import_path_to_regexp2 = require("path-to-regexp");
 var LIST_FORMATTER = new Intl.ListFormat("en", {
@@ -502,154 +655,6 @@ var validateConfigDefaultApplication = (applicationConfigsById) => {
   }
 };
 
-// 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-port.ts
-function generatePortFromName({
-  name,
-  minPort = 3e3,
-  maxPort = 8e3
-}) {
-  if (!name) {
-    throw new Error("Name is required to generate a port");
-  }
-  let hash = 0;
-  for (let i = 0; i < name.length; i++) {
-    hash = (hash << 5) - hash + name.charCodeAt(i);
-    hash |= 0;
-  }
-  hash = Math.abs(hash);
-  const range = maxPort - minPort;
-  const port = minPort + hash % range;
-  return port;
-}
-
-// src/config/microfrontends-config/isomorphic/host.ts
-var Host = class {
-  constructor(hostConfig, options) {
-    if (typeof hostConfig === "string") {
-      ({
-        protocol: this.protocol,
-        host: this.host,
-        port: this.port
-      } = Host.parseUrl(hostConfig));
-    } else {
-      const { protocol = "https", host, port } = hostConfig;
-      this.protocol = protocol;
-      this.host = host;
-      this.port = port;
-    }
-    this.local = options?.isLocal;
-  }
-  static parseUrl(url, defaultProtocol = "https") {
-    let hostToParse = url;
-    if (!/^https?:\/\//.exec(hostToParse)) {
-      hostToParse = `${defaultProtocol}://${hostToParse}`;
-    }
-    const parsed = new URL(hostToParse);
-    if (!parsed.hostname) {
-      throw new Error(Host.getMicrofrontendsError(url, "requires a host"));
-    }
-    if (parsed.hash) {
-      throw new Error(
-        Host.getMicrofrontendsError(url, "cannot have a fragment")
-      );
-    }
-    if (parsed.username || parsed.password) {
-      throw new Error(
-        Host.getMicrofrontendsError(
-          url,
-          "cannot have authentication credentials (username and/or password)"
-        )
-      );
-    }
-    if (parsed.pathname !== "/") {
-      throw new Error(Host.getMicrofrontendsError(url, "cannot have a path"));
-    }
-    if (parsed.search) {
-      throw new Error(
-        Host.getMicrofrontendsError(url, "cannot have query parameters")
-      );
-    }
-    const protocol = parsed.protocol.slice(0, -1);
-    return {
-      protocol,
-      host: parsed.hostname,
-      port: parsed.port ? Number.parseInt(parsed.port) : void 0
-    };
-  }
-  static getMicrofrontendsError(url, message) {
-    return `Microfrontends configuration error: the URL ${url} in your microfrontends.json ${message}.`;
-  }
-  isLocal() {
-    return this.local || this.host === "localhost" || this.host === "127.0.0.1";
-  }
-  toString() {
-    const url = this.toUrl();
-    return url.toString().replace(/\/$/, "");
-  }
-  toUrl() {
-    const url = `${this.protocol}://${this.host}${this.port ? `:${this.port}` : ""}`;
-    return new URL(url);
-  }
-};
-var LocalHost = class extends Host {
-  constructor({
-    appName,
-    local
-  }) {
-    let protocol;
-    let host;
-    let port;
-    if (typeof local === "number") {
-      port = local;
-    } else if (typeof local === "string") {
-      if (/^\d+$/.test(local)) {
-        port = Number.parseInt(local);
-      } else {
-        const parsed = Host.parseUrl(local, "http");
-        protocol = parsed.protocol;
-        host = parsed.host;
-        port = parsed.port;
-      }
-    } else if (local) {
-      protocol = local.protocol;
-      host = local.host;
-      port = local.port;
-    }
-    super({
-      protocol: protocol ?? "http",
-      host: host ?? "localhost",
-      port: port ?? generatePortFromName({ name: appName })
-    });
-  }
-};
-
-// src/config/microfrontends-config/isomorphic/utils/generate-automation-bypass-env-var-name.ts
-function generateAutomationBypassEnvVarName({
-  name
-}) {
-  return `AUTOMATION_BYPASS_${name.toUpperCase().replace(/[^a-zA-Z0-9]/g, "_")}`;
-}
-
 // src/config/microfrontends-config/isomorphic/application.ts
 var Application = class {
   constructor(name, {
@@ -730,9 +735,6 @@ var ChildApplication = class extends Application {
   }
 };
 
-// src/config/microfrontends-config/isomorphic/constants.ts
-var DEFAULT_LOCAL_PROXY_PORT = 3024;
-
 // src/config/microfrontends-config/isomorphic/index.ts
 var MicrofrontendConfigIsomorphic = class {
   constructor({
@@ -851,9 +853,17 @@ var MicrofrontendConfigIsomorphic = class {
     return this.defaultApplication;
   }
   /**
-   * Returns the configured port for the local proxy
+   * Returns the configured port for the local proxy.
+   * Can be overridden via MFE_LOCAL_PROXY_PORT environment variable.
    */
   getLocalProxyPort() {
+    const portOverride = process.env[MFE_LOCAL_PROXY_PORT_ENV];
+    if (portOverride) {
+      const port = Number.parseInt(portOverride, 10);
+      if (!Number.isNaN(port) && port > 0 && port < 65536) {
+        return port;
+      }
+    }
     return this.config.options?.localProxyPort ?? DEFAULT_LOCAL_PROXY_PORT;
   }
   toClientConfig(options) {
@@ -891,27 +901,39 @@ var MicrofrontendConfigIsomorphic = class {
   }
 };
 
-// src/bin/logger.ts
-function debug(...args) {
-  if (process.env.MFE_DEBUG) {
-    console.log(...args);
+// src/config/well-known/endpoints.ts
+async function getWellKnownClientData(config, flagValues = {}) {
+  const clientConfig = config.toClientConfig();
+  for (const [applicationName, application] of Object.entries(
+    clientConfig.applications
+  )) {
+    if (!application.routing) {
+      continue;
+    }
+    const allPaths = [];
+    for (const pathGroup of application.routing) {
+      if (pathGroup.flag) {
+        const flagName = pathGroup.flag;
+        const flagFn = flagValues[flagName];
+        if (!flagFn) {
+          throw new Error(
+            `Flag "${flagName}" was specified to control routing for path group "${pathGroup.group}" in application ${applicationName} but not found in provided flag values.`
+          );
+        }
+        const flagEnabled = await flagFn();
+        if (flagEnabled) {
+          allPaths.push(...pathGroup.paths);
+        }
+      } else {
+        allPaths.push(...pathGroup.paths);
+      }
+    }
+    application.routing = allPaths.length > 0 ? [{ paths: allPaths }] : [];
   }
+  return {
+    config: clientConfig.serialize()
+  };
 }
-function info(...args) {
-  console.log(...args);
-}
-function warn(...args) {
-  console.warn(...args);
-}
-function error(...args) {
-  console.error(...args);
-}
-var logger = {
-  debug,
-  info,
-  warn,
-  error
-};
 
 // src/next/middleware/middleware.ts
 function getMfeFlagHeader(req) {