@vercel/microfrontends 0.9.0 → 0.10.1

package/dist/v2/microfrontends/server.js

@@ -1,6 +1,6 @@
 // src/config-v2/microfrontends/server/index.ts
-import fs from "node:fs";
-import { dirname } from "node:path";
+import fs2 from "node:fs";
+import { dirname as dirname2, join } from "node:path";
 
 // src/config-v2/overrides/constants.ts
 var OVERRIDES_COOKIE_PREFIX = "vercel-microfrontends-override";
@@ -37,14 +37,14 @@ function parseOverrides(cookies) {
 }
 
 // src/config-v2/errors.ts
-var MicroFrontendError = class extends Error {
+var MicrofrontendError = class extends Error {
   constructor(message, opts) {
     super(message);
-    this.name = "MicroFrontendsError";
-    this.source = (opts == null ? void 0 : opts.source) ?? "@vercel/micro-frontends";
+    this.name = "MicrofrontendsError";
+    this.source = (opts == null ? void 0 : opts.source) ?? "@vercel/microfrontends";
     this.type = (opts == null ? void 0 : opts.type) ?? "unknown";
     this.subtype = opts == null ? void 0 : opts.subtype;
-    Error.captureStackTrace(this, MicroFrontendError);
+    Error.captureStackTrace(this, MicrofrontendError);
   }
   isKnown() {
     return this.type !== "unknown";
@@ -53,13 +53,13 @@ var MicroFrontendError = class extends Error {
     return !this.isKnown();
   }
   /**
-   * Converts an error to a MicroFrontendsError.
+   * Converts an error to a MicrofrontendsError.
    * @param original - The original error to convert.
-   * @returns The converted MicroFrontendsError.
+   * @returns The converted MicrofrontendsError.
    */
   static convert(original, opts) {
     if (opts == null ? void 0 : opts.fileName) {
-      const err = MicroFrontendError.convertFSError(original, opts.fileName);
+      const err = MicrofrontendError.convertFSError(original, opts.fileName);
       if (err) {
         return err;
       }
@@ -67,25 +67,25 @@ var MicroFrontendError = class extends Error {
     if (original.message.includes(
       "Code generation from strings disallowed for this context"
     )) {
-      return new MicroFrontendError(original.message, {
+      return new MicrofrontendError(original.message, {
         type: "config",
         subtype: "unsupported_validation_env",
         source: "ajv"
       });
     }
-    return new MicroFrontendError(original.message);
+    return new MicrofrontendError(original.message);
   }
   static convertFSError(original, fileName) {
     if (original instanceof Error && "code" in original) {
       if (original.code === "ENOENT") {
-        return new MicroFrontendError(`Could not find "${fileName}"`, {
+        return new MicrofrontendError(`Could not find "${fileName}"`, {
           type: "config",
           subtype: "unable_to_read_file",
           source: "fs"
         });
       }
       if (original.code === "EACCES") {
-        return new MicroFrontendError(
+        return new MicrofrontendError(
           `Permission denied while accessing "${fileName}"`,
           {
             type: "config",
@@ -96,7 +96,7 @@ var MicroFrontendError = class extends Error {
       }
     }
     if (original instanceof SyntaxError) {
-      return new MicroFrontendError(
+      return new MicrofrontendError(
         `Failed to parse "${fileName}": Invalid JSON format.`,
         {
           type: "config",
@@ -108,23 +108,23 @@ var MicroFrontendError = class extends Error {
     return null;
   }
   /**
-   * Handles an unknown error and returns a MicroFrontendsError instance.
+   * Handles an unknown error and returns a MicrofrontendsError instance.
    * @param err - The error to handle.
-   * @returns A MicroFrontendsError instance.
+   * @returns A MicrofrontendsError instance.
    */
   static handle(err, opts) {
-    if (err instanceof MicroFrontendError) {
+    if (err instanceof MicrofrontendError) {
       return err;
     }
     if (err instanceof Error) {
-      return MicroFrontendError.convert(err, opts);
+      return MicrofrontendError.convert(err, opts);
     }
     if (typeof err === "object" && err !== null) {
       if ("message" in err && typeof err.message === "string") {
-        return MicroFrontendError.convert(new Error(err.message), opts);
+        return MicrofrontendError.convert(new Error(err.message), opts);
       }
     }
-    return new MicroFrontendError("An unknown error occurred");
+    return new MicrofrontendError("An unknown error occurred");
   }
 };
 
@@ -132,7 +132,7 @@ var MicroFrontendError = class extends Error {
 function getConfigStringFromEnv() {
   const config = process.env.MFE_CONFIG;
   if (!config) {
-    throw new MicroFrontendError(`Missing "MFE_CONFIG" in environment.`, {
+    throw new MicrofrontendError(`Missing "MFE_CONFIG" in environment.`, {
       type: "config",
       subtype: "not_found_in_env"
     });
@@ -155,7 +155,7 @@ function isDefaultApp(a) {
 
 // src/config-v2/microfrontends-config/client/index.ts
 import { pathToRegexp } from "path-to-regexp";
-var MicroFrontendConfigClient = class {
+var MicrofrontendConfigClient = class {
   constructor(config, opts) {
     this.pathCache = {};
     this.serialized = config;
@@ -169,14 +169,14 @@ var MicroFrontendConfigClient = class {
     this.applications = config.applications;
   }
   /**
-   * Create a new `MicroFrontendConfigClient` from a JSON string.
+   * Create a new `MicrofrontendConfigClient` from a JSON string.
    * Config must be passed in to remain framework agnostic
    */
   static fromEnv(config, opts) {
     if (!config) {
-      throw new Error("No micro-frontends configuration found");
+      throw new Error("No microfrontends configuration found");
     }
-    return new MicroFrontendConfigClient(
+    return new MicrofrontendConfigClient(
       JSON.parse(config),
       opts
     );
@@ -184,21 +184,21 @@ var MicroFrontendConfigClient = class {
   isEqual(other) {
     return JSON.stringify(this.applications) === JSON.stringify(other.applications);
   }
-  getApplicationNameForPath(path2) {
-    if (!path2.startsWith("/")) {
+  getApplicationNameForPath(path3) {
+    if (!path3.startsWith("/")) {
       throw new Error(`Path must start with a /`);
     }
-    if (this.pathCache[path2]) {
-      return this.pathCache[path2];
+    if (this.pathCache[path3]) {
+      return this.pathCache[path3];
     }
-    const pathname = new URL(path2, "https://example.com").pathname;
+    const pathname = new URL(path3, "https://example.com").pathname;
     for (const [name, application] of Object.entries(this.applications)) {
       if (application.routing) {
         for (const group of application.routing) {
           for (const childPath of group.paths) {
             const regexp = pathToRegexp(childPath);
             if (regexp.test(pathname)) {
-              this.pathCache[path2] = name;
+              this.pathCache[path3] = name;
               return name;
             }
           }
@@ -211,7 +211,7 @@ var MicroFrontendConfigClient = class {
     if (!defaultApplication) {
       return null;
     }
-    this.pathCache[path2] = defaultApplication[0];
+    this.pathCache[path3] = defaultApplication[0];
     return defaultApplication[0];
   }
   serialize() {
@@ -224,7 +224,7 @@ import { pathToRegexp as pathToRegexp2, parse as parsePathRegexp } from "path-to
 var SUPPORTED_VERSIONS = ["2"];
 var validateConfigVersion = (version) => {
   if (!SUPPORTED_VERSIONS.includes(version)) {
-    throw new MicroFrontendError(
+    throw new MicrofrontendError(
       `Unsupported version: ${version}. Supported versions are: ${SUPPORTED_VERSIONS.join(
         ", "
       )}`,
@@ -243,22 +243,22 @@ var validateConfigPaths = (applicationConfigsById) => {
       continue;
     }
     for (const pathMatch of app.routing) {
-      for (const path2 of pathMatch.paths) {
-        const tokens = parsePathRegexp(path2);
+      for (const path3 of pathMatch.paths) {
+        const tokens = parsePathRegexp(path3);
         for (const token of tokens.slice(0, -1)) {
           if (typeof token !== "string") {
             errors.push(
-              `Path ${path2} may only have a :wildcard in the last path component`
+              `Path ${path3} may only have a :wildcard in the last path component`
             );
           }
         }
-        const existing = pathsByApplicationId.get(path2);
+        const existing = pathsByApplicationId.get(path3);
         if (existing) {
           existing.applications.push(id);
         } else {
-          pathsByApplicationId.set(path2, {
+          pathsByApplicationId.set(path3, {
             applications: [id],
-            matcher: pathToRegexp2(path2),
+            matcher: pathToRegexp2(path3),
             applicationId: id
           });
         }
@@ -266,10 +266,10 @@ var validateConfigPaths = (applicationConfigsById) => {
     }
   }
   const entries = Array.from(pathsByApplicationId.entries());
-  entries.forEach(([path2, { applications: ids, matcher, applicationId }]) => {
+  entries.forEach(([path3, { applications: ids, matcher, applicationId }]) => {
     if (ids.length > 1) {
       errors.push(
-        `Duplicate path "${path2}" for applications "${ids.join(", ")}"`
+        `Duplicate path "${path3}" for applications "${ids.join(", ")}"`
       );
     }
     entries.forEach(
@@ -277,14 +277,14 @@ var validateConfigPaths = (applicationConfigsById) => {
         matchPath,
         { applications: matchIds, applicationId: matchApplicationId }
       ]) => {
-        if (path2 === matchPath) {
+        if (path3 === matchPath) {
           return;
         }
         if (applicationId === matchApplicationId) {
           return;
         }
         if (matcher.test(matchPath)) {
-          const source = `"${path2}" of application${ids.length > 0 ? "s" : ""} ${ids.join(", ")}`;
+          const source = `"${path3}" of application${ids.length > 0 ? "s" : ""} ${ids.join(", ")}`;
           const destination = `"${matchPath}" of application${matchIds.length > 0 ? "s" : ""} ${matchIds.join(", ")}`;
           errors.push(
             `Overlapping path detected between ${source} and ${destination}`
@@ -294,7 +294,7 @@ var validateConfigPaths = (applicationConfigsById) => {
     );
   });
   if (errors.length) {
-    throw new MicroFrontendError(`Invalid paths: ${errors.join(", ")}`, {
+    throw new MicrofrontendError(`Invalid paths: ${errors.join(", ")}`, {
       type: "config",
       subtype: "conflicting_paths"
     });
@@ -307,13 +307,13 @@ var validateAppPaths = (name, app) => {
         continue;
       }
       if (p.endsWith("/")) {
-        throw new MicroFrontendError(
+        throw new MicrofrontendError(
           `Invalid path for application "${name}". ${p} must not end with a slash.`,
           { type: "application", subtype: "invalid_path" }
         );
       }
       if (!p.startsWith("/")) {
-        throw new MicroFrontendError(
+        throw new MicrofrontendError(
           `Invalid path for application "${name}". ${p} must start with a slash.`,
           { type: "application", subtype: "invalid_path" }
         );
@@ -335,13 +335,13 @@ var validateConfigDefaultApplication = (applicationConfigsById) => {
   const numApplicationsWithRouting = applicationsWithRoutingNames.length;
   const numApplicationsWithoutRouting = numApplications - numApplicationsWithRouting;
   if (numApplicationsWithoutRouting === 0) {
-    throw new MicroFrontendError(
+    throw new MicrofrontendError(
       `No default application found. At least one application needs to be the default by omitting routing.`,
       { type: "config", subtype: "no_default_application" }
     );
   }
   if (numApplicationsWithoutRouting > 1) {
-    throw new MicroFrontendError(
+    throw new MicrofrontendError(
       `Only one application can omit "routing". Found ${applicationsWithRoutingNames.length - Object.keys(applicationConfigsById).length > 1}.`,
       { type: "config", subtype: "multiple_default_applications" }
     );
@@ -353,7 +353,7 @@ var validateConfigOptions = (options) => {
     if (!/^[a-zA-Z]{2,}\.[a-zA-Z]{2,}$/.test(
       options.vercel.previewDeploymentSuffix
     )) {
-      throw new MicroFrontendError(
+      throw new MicrofrontendError(
         `Invalid preview deployment suffix: ${options.vercel.previewDeploymentSuffix}. Should have be formatted like "vercel.app".`,
         { type: "config", subtype: "invalid_preview_deployment_suffix" }
       );
@@ -512,7 +512,7 @@ var ChildApplication = class extends Application {
 var DEFAULT_LOCAL_PROXY_PORT = 3024;
 
 // src/config-v2/microfrontends-config/isomorphic/index.ts
-var MicroFrontendConfigIsomorphic = class {
+var MicrofrontendConfigIsomorphic = class {
   constructor({
     config,
     overrides,
@@ -520,7 +520,7 @@ var MicroFrontendConfigIsomorphic = class {
   }) {
     this.childApplications = {};
     var _a, _b, _c, _d;
-    MicroFrontendConfigIsomorphic.validate(config);
+    MicrofrontendConfigIsomorphic.validate(config);
     const disableOverrides = ((_b = (_a = config.options) == null ? void 0 : _a.vercel) == null ? void 0 : _b.disableOverrides) ?? false;
     this.overrides = overrides && !disableOverrides ? overrides : void 0;
     this.isMainConfig = isMainConfig(config);
@@ -552,7 +552,7 @@ var MicroFrontendConfigIsomorphic = class {
       );
     }
     if (isMainConfig(config) && !this.defaultApplication) {
-      throw new MicroFrontendError(
+      throw new MicrofrontendError(
         `Could not find default application in microfrontends configuration`,
         {
           type: "application",
@@ -582,7 +582,7 @@ var MicroFrontendConfigIsomorphic = class {
     meta,
     cookies
   }) {
-    return new MicroFrontendConfigIsomorphic({
+    return new MicrofrontendConfigIsomorphic({
       config: parse(getConfigStringFromEnv()),
       overrides: parseOverrides(cookies ?? []),
       meta
@@ -617,7 +617,7 @@ var MicroFrontendConfigIsomorphic = class {
     }
     const app = this.childApplications[name];
     if (!app) {
-      throw new MicroFrontendError(
+      throw new MicrofrontendError(
         `Could not find microfrontends configuration for application "${name}"`,
         {
           type: "application",
@@ -645,7 +645,7 @@ var MicroFrontendConfigIsomorphic = class {
    */
   getDefaultApplication() {
     if (!this.defaultApplication) {
-      throw new MicroFrontendError(
+      throw new MicrofrontendError(
         `Could not find default application in microfrontends configuration`,
         {
           type: "application",
@@ -685,7 +685,7 @@ var MicroFrontendConfigIsomorphic = class {
         default: true
       };
     }
-    return new MicroFrontendConfigClient({
+    return new MicrofrontendConfigClient({
       applications
     });
   }
@@ -695,7 +695,7 @@ var MicroFrontendConfigIsomorphic = class {
 };
 
 // src/config-v2/microfrontends-config/isomorphic/child.ts
-var MicroFrontendChildConfig = class extends MicroFrontendConfigIsomorphic {
+var MicrofrontendChildConfig = class extends MicrofrontendConfigIsomorphic {
   constructor({
     config,
     overrides,
@@ -708,7 +708,7 @@ var MicroFrontendChildConfig = class extends MicroFrontendConfigIsomorphic {
 };
 
 // src/config-v2/microfrontends-config/isomorphic/main.ts
-var MicroFrontendMainConfig = class extends MicroFrontendConfigIsomorphic {
+var MicrofrontendMainConfig = class extends MicrofrontendConfigIsomorphic {
   constructor({
     config,
     overrides,
@@ -735,7 +735,7 @@ var MicroFrontendMainConfig = class extends MicroFrontendConfigIsomorphic {
       }
     }
     if (!defaultApplication) {
-      throw new MicroFrontendError(
+      throw new MicrofrontendError(
         `Could not find default application in microfrontends configuration`,
         {
           type: "application",
@@ -755,19 +755,19 @@ var Microfrontends = class {
     meta
   }) {
     if (isMainConfig(config)) {
-      this.config = new MicroFrontendMainConfig({ config, overrides, meta });
+      this.config = new MicrofrontendMainConfig({ config, overrides, meta });
     } else {
-      this.config = new MicroFrontendChildConfig({ config, overrides, meta });
+      this.config = new MicrofrontendChildConfig({ config, overrides, meta });
     }
   }
   isChildConfig() {
-    return this.config instanceof MicroFrontendChildConfig;
+    return this.config instanceof MicrofrontendChildConfig;
   }
   static fromEnv({
     cookies,
     meta
   }) {
-    const config = MicroFrontendConfigIsomorphic.fromEnv({
+    const config = MicrofrontendConfigIsomorphic.fromEnv({
       cookies,
       meta
     });
@@ -775,8 +775,82 @@ var Microfrontends = class {
   }
 };
 
-// src/config-v2/microfrontends/server/utils/get-output-file-path.ts
+// src/config-v2/microfrontends/utils/find-repository-root.ts
+import fs from "node:fs";
 import path from "node:path";
+var GIT_DIRECTORY = ".git";
+function findRepositoryRoot(startDir) {
+  let currentDir = startDir || process.cwd();
+  while (currentDir !== path.parse(currentDir).root) {
+    const gitPath = path.join(currentDir, GIT_DIRECTORY);
+    if (fs.existsSync(gitPath) && fs.statSync(gitPath).isDirectory()) {
+      return currentDir;
+    }
+    currentDir = path.dirname(currentDir);
+  }
+  throw new Error(
+    "Repository root not found. Specify the root of the repository with the `repository.root` option."
+  );
+}
+
+// src/config-v2/microfrontends/utils/find-package-path.ts
+import { dirname } from "node:path";
+import { readFileSync } from "node:fs";
+import fg from "fast-glob";
+var configCache = {};
+function findPackagePathWithGlob({
+  repositoryRoot,
+  name
+}) {
+  try {
+    const packageJsonPaths = fg.globSync("**/package.json", {
+      cwd: repositoryRoot,
+      absolute: true,
+      onlyFiles: true,
+      followSymbolicLinks: false,
+      ignore: ["**/node_modules/**", "**/.git/**"]
+    });
+    const matchingPaths = [];
+    for (const packageJsonPath2 of packageJsonPaths) {
+      const packageJsonContent = readFileSync(packageJsonPath2, "utf-8");
+      const packageJson = JSON.parse(packageJsonContent);
+      if (packageJson.name === name) {
+        matchingPaths.push(packageJsonPath2);
+      }
+    }
+    if (matchingPaths.length > 1) {
+      throw new Error(
+        `Found multiple packages with the name "${name}" in the repository: ${matchingPaths.join(", ")}`
+      );
+    }
+    if (matchingPaths.length === 0) {
+      throw new Error(
+        `Could not find package with the name "${name}" in the repository`
+      );
+    }
+    const [packageJsonPath] = matchingPaths;
+    return dirname(packageJsonPath);
+  } catch (error) {
+    return null;
+  }
+}
+function findPackagePath(opts) {
+  const cacheKey = `${opts.repositoryRoot}-${opts.name}`;
+  if (configCache[cacheKey]) {
+    return configCache[cacheKey];
+  }
+  const result = findPackagePathWithGlob(opts);
+  if (!result) {
+    throw new Error(
+      `Could not find package with the name "${opts.name}" in the repository`
+    );
+  }
+  configCache[cacheKey] = result;
+  return result;
+}
+
+// src/config-v2/microfrontends/server/utils/get-output-file-path.ts
+import path2 from "node:path";
 
 // src/config-v2/microfrontends/server/constants.ts
 var MFE_CONFIG_DEFAULT_FILE_PATH = "microfrontends";
@@ -790,13 +864,13 @@ function isVercel() {
 // src/config-v2/microfrontends/server/utils/get-output-file-path.ts
 function getOutputFilePath() {
   if (isVercel()) {
-    return path.join(
+    return path2.join(
       ".vercel",
       MFE_CONFIG_DEFAULT_FILE_PATH,
       MFE_CONFIG_DEFAULT_FILE_NAME
     );
   }
-  return path.join(MFE_CONFIG_DEFAULT_FILE_PATH, MFE_CONFIG_DEFAULT_FILE_NAME);
+  return path2.join(MFE_CONFIG_DEFAULT_FILE_PATH, MFE_CONFIG_DEFAULT_FILE_NAME);
 }
 
 // src/config-v2/microfrontends/server/validation.ts
@@ -804,14 +878,14 @@ import { parse as parse2 } from "jsonc-parser";
 import { Ajv } from "ajv";
 
 // src/config/errors.ts
-var MicroFrontendError2 = class extends Error {
+var MicrofrontendError2 = class extends Error {
   constructor(message, opts) {
     super(message);
-    this.name = "MicroFrontendsError";
-    this.source = (opts == null ? void 0 : opts.source) ?? "@vercel/micro-frontends";
+    this.name = "MicrofrontendsError";
+    this.source = (opts == null ? void 0 : opts.source) ?? "@vercel/microfrontends";
     this.type = (opts == null ? void 0 : opts.type) ?? "unknown";
     this.subtype = opts == null ? void 0 : opts.subtype;
-    Error.captureStackTrace(this, MicroFrontendError2);
+    Error.captureStackTrace(this, MicrofrontendError2);
   }
   isKnown() {
     return this.type !== "unknown";
@@ -820,13 +894,13 @@ var MicroFrontendError2 = class extends Error {
     return !this.isKnown();
   }
   /**
-   * Converts an error to a MicroFrontendsError.
+   * Converts an error to a MicrofrontendsError.
    * @param original - The original error to convert.
-   * @returns The converted MicroFrontendsError.
+   * @returns The converted MicrofrontendsError.
    */
   static convert(original, opts) {
     if (opts == null ? void 0 : opts.fileName) {
-      const err = MicroFrontendError2.convertFSError(original, opts.fileName);
+      const err = MicrofrontendError2.convertFSError(original, opts.fileName);
       if (err) {
         return err;
       }
@@ -834,25 +908,25 @@ var MicroFrontendError2 = class extends Error {
     if (original.message.includes(
       "Code generation from strings disallowed for this context"
     )) {
-      return new MicroFrontendError2(original.message, {
+      return new MicrofrontendError2(original.message, {
         type: "config",
         subtype: "unsupported_validation_env",
         source: "ajv"
       });
     }
-    return new MicroFrontendError2(original.message);
+    return new MicrofrontendError2(original.message);
   }
   static convertFSError(original, fileName) {
     if (original instanceof Error && "code" in original) {
       if (original.code === "ENOENT") {
-        return new MicroFrontendError2(`Could not find "${fileName}"`, {
+        return new MicrofrontendError2(`Could not find "${fileName}"`, {
           type: "config",
           subtype: "unable_to_read_file",
           source: "fs"
         });
       }
       if (original.code === "EACCES") {
-        return new MicroFrontendError2(
+        return new MicrofrontendError2(
           `Permission denied while accessing "${fileName}"`,
           {
             type: "config",
@@ -863,7 +937,7 @@ var MicroFrontendError2 = class extends Error {
       }
     }
     if (original instanceof SyntaxError) {
-      return new MicroFrontendError2(
+      return new MicrofrontendError2(
         `Failed to parse "${fileName}": Invalid JSON format.`,
         {
           type: "config",
@@ -875,23 +949,23 @@ var MicroFrontendError2 = class extends Error {
     return null;
   }
   /**
-   * Handles an unknown error and returns a MicroFrontendsError instance.
+   * Handles an unknown error and returns a MicrofrontendsError instance.
    * @param err - The error to handle.
-   * @returns A MicroFrontendsError instance.
+   * @returns A MicrofrontendsError instance.
    */
   static handle(err, opts) {
-    if (err instanceof MicroFrontendError2) {
+    if (err instanceof MicrofrontendError2) {
       return err;
     }
     if (err instanceof Error) {
-      return MicroFrontendError2.convert(err, opts);
+      return MicrofrontendError2.convert(err, opts);
     }
     if (typeof err === "object" && err !== null) {
       if ("message" in err && typeof err.message === "string") {
-        return MicroFrontendError2.convert(new Error(err.message), opts);
+        return MicrofrontendError2.convert(new Error(err.message), opts);
       }
     }
-    return new MicroFrontendError2("An unknown error occurred");
+    return new MicrofrontendError2("An unknown error occurred");
   }
 };
 
@@ -1106,10 +1180,6 @@ var schema_v2_default = {
           type: "string",
           description: "flag name that can be used to enable/disable all paths in the group"
         },
-        routeToDefaultApplication: {
-          type: "boolean",
-          description: "True to route the request to the default application for this micro-frontends set-up. This must be `true` when using `flag` or when you want to use custom logic to make the routing decision for this group of paths."
-        },
         paths: {
           type: "array",
           items: {
@@ -1169,7 +1239,7 @@ function validateSchema(configString) {
   const validate = ajv.compile(SCHEMA);
   const isValid = validate(parsedConfig);
   if (!isValid) {
-    throw new MicroFrontendError2(
+    throw new MicrofrontendError2(
       `Invalid config: ${ajv.errorsText(validate.errors)}`,
       { type: "config", subtype: "does_not_match_schema" }
     );
@@ -1186,8 +1256,8 @@ var MicrofrontendsServer = class extends Microfrontends {
     pretty: true
   }) {
     const outputPath = getOutputFilePath();
-    fs.mkdirSync(dirname(outputPath), { recursive: true });
-    fs.writeFileSync(
+    fs2.mkdirSync(dirname2(outputPath), { recursive: true });
+    fs2.writeFileSync(
       outputPath,
       JSON.stringify(
         this.config.toSchemaJson(),
@@ -1220,7 +1290,7 @@ var MicrofrontendsServer = class extends Microfrontends {
         meta
       });
     }
-    throw new MicroFrontendError(
+    throw new MicrofrontendError(
       "Invalid config: must be a string or an object",
       { type: "config", subtype: "does_not_match_schema" }
     );
@@ -1255,17 +1325,74 @@ var MicrofrontendsServer = class extends Microfrontends {
   static fromFile({
     filePath,
     cookies,
-    meta
+    meta,
+    options
   }) {
     try {
-      const config = fs.readFileSync(filePath, "utf-8");
+      const configJson = fs2.readFileSync(filePath, "utf-8");
+      const config = MicrofrontendsServer.validate(configJson);
+      if (!isMainConfig(config) && (options == null ? void 0 : options.resolveMainConfig)) {
+        const repositoryRoot = findRepositoryRoot();
+        const packagePath = findPackagePath({
+          repositoryRoot,
+          name: config.partOf
+        });
+        if (!packagePath) {
+          throw new MicrofrontendError(
+            `Could not find default application "${config.partOf}" in the repository`,
+            { type: "config", subtype: "not_found" }
+          );
+        }
+        const mainConfigPath = join(packagePath, "microfrontends.json");
+        return MicrofrontendsServer.fromMainConfigFile({
+          filePath: mainConfigPath,
+          overrides: cookies ? parseOverrides(cookies) : void 0
+        });
+      }
       return new MicrofrontendsServer({
-        config: MicrofrontendsServer.validate(config),
+        config,
         overrides: cookies ? parseOverrides(cookies) : void 0,
         meta
       });
     } catch (e) {
-      throw MicroFrontendError.handle(e, {
+      throw MicrofrontendError.handle(e, {
+        fileName: filePath
+      });
+    }
+  }
+  /*
+   * Generates a MicrofrontendMainConfig instance from a file.
+   */
+  static fromMainConfigFile({
+    filePath,
+    overrides
+  }) {
+    try {
+      const config = fs2.readFileSync(filePath, "utf-8");
+      const validatedConfig = MicrofrontendsServer.validate(config);
+      if (!isMainConfig(validatedConfig)) {
+        throw new MicrofrontendError(
+          `${filePath} is not a main microfrontend config`,
+          {
+            type: "config",
+            subtype: "invalid_main_path"
+          }
+        );
+      }
+      const [defaultApplication] = Object.entries(validatedConfig.applications).filter(([, app]) => isDefaultApp(app)).map(([name]) => name);
+      if (!defaultApplication) {
+        throw new MicrofrontendError(
+          `No default application found. At least one application needs to be the default by omitting routing.`,
+          { type: "config", subtype: "no_default_application" }
+        );
+      }
+      return new MicrofrontendsServer({
+        config: validatedConfig,
+        overrides,
+        meta: { fromApp: defaultApplication }
+      });
+    } catch (e) {
+      throw MicrofrontendError.handle(e, {
         fileName: filePath
       });
     }