@vercel/microfrontends/dist/next/config.cjs.map

Defines configuration and utilities for microfrontends development

{"version":3,"sources":["../../src/next/config/index.ts","../../src/bin/local-proxy-is-running.ts","../../src/bin/logger.ts","../../src/bin/check-proxy.ts","../../src/config/microfrontends/server/index.ts","../../src/config/overrides/constants.ts","../../src/config/overrides/is-override-cookie.ts","../../src/config/overrides/get-override-from-cookie.ts","../../src/config/overrides/parse-overrides.ts","../../src/config/errors.ts","../../src/config/microfrontends-config/utils/get-config-from-env.ts","../../src/config/schema/utils/is-default-app.ts","../../src/config/microfrontends/utils/find-repository-root.ts","../../src/config/microfrontends/utils/infer-microfrontends-location.ts","../../src/config/microfrontends/utils/get-config-file-name.ts","../../src/config/microfrontends/utils/is-monorepo.ts","../../src/config/microfrontends/utils/find-package-root.ts","../../src/config/microfrontends/utils/find-config.ts","../../src/config/microfrontends-config/isomorphic/index.ts","../../src/config/microfrontends-config/client/index.ts","../../src/config/microfrontends-config/isomorphic/validation.ts","../../src/config/microfrontends-config/isomorphic/utils/hash-application-name.ts","../../src/config/microfrontends-config/isomorphic/utils/generate-asset-prefix.ts","../../src/config/microfrontends-config/isomorphic/utils/generate-port.ts","../../src/config/microfrontends-config/isomorphic/host.ts","../../src/config/microfrontends-config/isomorphic/utils/generate-automation-bypass-env-var-name.ts","../../src/config/microfrontends-config/isomorphic/application.ts","../../src/config/microfrontends-config/isomorphic/constants.ts","../../src/config/microfrontends/utils/get-application-context.ts","../../src/config/microfrontends/server/utils/get-output-file-path.ts","../../src/config/microfrontends/server/constants.ts","../../src/config/microfrontends/server/validation.ts","../../schema/schema.json","../../src/config/schema/utils/load.ts","../../src/next/config/transforms/asset-prefix.ts","../../src/next/config/transforms/build-id.ts","../../src/next/config/transforms/draft-mode.ts","../../src/next/config/transforms/redirects.ts","../../src/next/config/transforms/transpile-packages.ts","../../src/next/config/transforms/rewrites.ts","../../src/next/config/transforms/webpack.ts","../../src/next/config/plugins/sort-chunks.ts","../../src/next/config/transforms/index.ts","../../src/next/config/env.ts"],"sourcesContent":["import type { NextConfig } from 'next';\nimport { displayLocalProxyInfo } from '../../bin/check-proxy';\nimport { MicrofrontendsServer } from '../../config/microfrontends/server';\nimport { getApplicationContext } from '../../config/microfrontends/utils/get-application-context';\nimport { logger } from '../../bin/logger';\nimport { transforms } from './transforms';\nimport { setEnvironment } from './env';\nimport type { WithMicrofrontendsOptions } from './types';\n\nfunction typedEntries<T extends Record<string, unknown>>(\n  obj: T,\n): [keyof T, T[keyof T]][] {\n  return Object.entries(obj) as [keyof T, T[keyof T]][];\n}\n\n/**\n * Automatically configures your Next.js application to work with microfrontends.\n *\n * This function should wrap your Next.js config object before it is exported. It\n * will automatically set up the necessary fields and environment variables for\n * microfrontends to work.\n *\n * See the [Getting Started](https://vercel.com/docs/microfrontends/quickstart) guide for more information.\n *\n * @example Wrapping your Next.js config\n * ```js\n * import { withMicrofrontends } from '@vercel/microfrontends/next/config';\n *\n * const nextConfig = { ... };\n *\n * export default withMicrofrontends(nextConfig);\n * ```\n */\nexport function withMicrofrontends(\n  nextConfig: NextConfig,\n  opts?: WithMicrofrontendsOptions,\n): NextConfig {\n  if (opts?.debug) {\n    process.env.MFE_DEBUG = 'true';\n  }\n  const { name: fromApp } = getApplicationContext(opts);\n  const microfrontends = MicrofrontendsServer.infer({\n    appName: fromApp,\n    filePath: opts?.configPath,\n  });\n\n  // fetch the config for the current app\n  const app = microfrontends.config.getApplication(fromApp);\n\n  // configure the environment\n  setEnvironment({ app, microfrontends });\n\n  let next = { ...nextConfig };\n\n  for (const [key, transform] of typedEntries(transforms)) {\n    if (opts?.skipTransforms?.includes(key)) {\n      logger.info(`Skipping ${key} transform`);\n      continue;\n    }\n\n    try {\n      const transformedConfig = transform({\n        app,\n        next,\n        microfrontend: microfrontends.config,\n        opts: {\n          supportPagesRouter: opts?.supportPagesRouter,\n        },\n      });\n      next = transformedConfig.next;\n    } catch (e) {\n      logger.error('Error transforming next config', e);\n      // Fail the build\n      throw e;\n    }\n  }\n\n  const localProxyPort = microfrontends.config.getLocalProxyPort();\n  if (typeof localProxyPort === 'number') {\n    // save the local proxy port to an environment variable for easy access\n    process.env.MFE_LOCAL_PROXY_PORT = localProxyPort.toString();\n  }\n\n  displayLocalProxyInfo(localProxyPort);\n  return next;\n}\n","export function localProxyIsRunning(): boolean {\n  return process.env.TURBO_TASK_HAS_MFE_PROXY === 'true';\n}\n","/* eslint-disable no-console */\n\nfunction debug(...args: unknown[]): void {\n  if (process.env.MFE_DEBUG) {\n    console.log(...args);\n  }\n}\n\nfunction info(...args: unknown[]): void {\n  console.log(...args);\n}\n\nfunction warn(...args: unknown[]): void {\n  console.warn(...args);\n}\n\nfunction error(...args: unknown[]): void {\n  console.error(...args);\n}\n\nexport const logger = {\n  debug,\n  info,\n  warn,\n  error,\n};\n","import { localProxyIsRunning } from './local-proxy-is-running';\nimport { logger } from './logger';\n\nexport function displayLocalProxyInfo(port: number): void {\n  // TODO(olszewski): this is really icky, but since withMicroFrontends is called by two separate processes\n  // we can't rely on some shared state so we instead use env to store state\n  if (\n    localProxyIsRunning() &&\n    process.env.MFE_PROXY_MESSAGE_PRINTED !== 'true'\n  ) {\n    process.env.MFE_PROXY_MESSAGE_PRINTED = 'true';\n    logger.info(`Microfrontends Proxy running on http://localhost:${port}`);\n  }\n}\n","import fs from 'node:fs';\nimport { dirname, join, resolve } from 'node:path';\nimport type { Config } from '../../schema/types';\nimport { parseOverrides } from '../../overrides';\nimport type { OverridesConfig } from '../../overrides';\nimport { getConfigStringFromEnv } from '../../microfrontends-config/utils/get-config-from-env';\nimport { MicrofrontendError } from '../../errors';\nimport { isDefaultApp } from '../../schema/utils/is-default-app';\nimport { findRepositoryRoot } from '../utils/find-repository-root';\nimport { inferMicrofrontendsLocation } from '../utils/infer-microfrontends-location';\nimport { isMonorepo as isRepositoryMonorepo } from '../utils/is-monorepo';\nimport { findPackageRoot } from '../utils/find-package-root';\nimport { findConfig } from '../utils/find-config';\nimport { MicrofrontendConfigIsomorphic } from '../../microfrontends-config/isomorphic';\nimport { getApplicationContext } from '../utils/get-application-context';\nimport { logger } from '../../../bin/logger';\nimport { getOutputFilePath } from './utils/get-output-file-path';\nimport { validateSchema } from './validation';\n\nclass MicrofrontendsServer {\n  config: MicrofrontendConfigIsomorphic;\n\n  constructor({\n    config,\n    overrides,\n  }: {\n    config: Config;\n    overrides?: OverridesConfig;\n  }) {\n    this.config = new MicrofrontendConfigIsomorphic({ config, overrides });\n  }\n\n  /**\n   * Writes the configuration to a file.\n   */\n  writeConfig(\n    opts: {\n      pretty?: boolean;\n    } = {\n      pretty: true,\n    },\n  ): void {\n    const outputPath = getOutputFilePath();\n\n    // ensure the directory exists\n    fs.mkdirSync(dirname(outputPath), { recursive: true });\n    fs.writeFileSync(\n      outputPath,\n      JSON.stringify(\n        this.config.toSchemaJson(),\n        null,\n        (opts.pretty ?? true) ? 2 : undefined,\n      ),\n    );\n  }\n\n  // --------- Static Methods ---------\n\n  /**\n   * Generates a MicrofrontendsServer instance from an unknown object.\n   */\n  static fromUnknown({\n    config,\n    cookies,\n  }: {\n    config: unknown;\n    cookies?: { name: string; value: string }[];\n  }): MicrofrontendsServer {\n    const overrides = cookies ? parseOverrides(cookies) : undefined;\n    if (typeof config === 'string') {\n      return new MicrofrontendsServer({\n        config: MicrofrontendsServer.validate(config),\n        overrides,\n      });\n    }\n    if (typeof config === 'object') {\n      return new MicrofrontendsServer({\n        config: config as Config,\n        overrides,\n      });\n    }\n\n    throw new MicrofrontendError(\n      'Invalid config: must be a string or an object',\n      { type: 'config', subtype: 'does_not_match_schema' },\n    );\n  }\n\n  /**\n   * Generates a MicrofrontendsServer instance from the environment.\n   * Uses additional validation that is only available when in a node runtime\n   */\n  static fromEnv({\n    cookies,\n  }: {\n    cookies: { name: string; value: string }[];\n  }): MicrofrontendsServer {\n    return new MicrofrontendsServer({\n      config: MicrofrontendsServer.validate(getConfigStringFromEnv()),\n      overrides: parseOverrides(cookies),\n    });\n  }\n\n  /**\n   * Validates the configuration against the JSON schema\n   */\n  static validate(config: string | Config): Config {\n    if (typeof config === 'string') {\n      const c = validateSchema(config);\n      return c;\n    }\n    return config;\n  }\n\n  /**\n   * Looks up the configuration by inferring the package root and looking for a microfrontends config file. If a file is not found,\n   * it will look for a package in the repository with a microfrontends file that contains the current application\n   * and use that configuration.\n   *\n   * This can return either a Child or Main configuration.\n   */\n  static infer({\n    appName,\n    directory,\n    filePath,\n    cookies,\n  }: {\n    appName?: string;\n    directory?: string;\n    filePath?: string;\n    cookies?: { name: string; value: string }[];\n  } = {}): MicrofrontendsServer {\n    logger.debug('[MFE Config] Starting config inference', {\n      appName,\n      directory: directory || process.cwd(),\n      filePath,\n    });\n\n    if (filePath) {\n      logger.debug('[MFE Config] Using explicit filePath:', filePath);\n      return MicrofrontendsServer.fromFile({\n        filePath,\n        cookies,\n      });\n    }\n\n    try {\n      const packageRoot = findPackageRoot(directory);\n      logger.debug('[MFE Config] Package root:', packageRoot);\n\n      const applicationContext = getApplicationContext({\n        appName,\n        packageRoot,\n      });\n      logger.debug('[MFE Config] Application context:', applicationContext);\n\n      const customConfigFilename =\n        process.env.VC_MICROFRONTENDS_CONFIG_FILE_NAME;\n\n      if (customConfigFilename) {\n        logger.debug(\n          '[MFE Config] Custom config filename from VC_MICROFRONTENDS_CONFIG_FILE_NAME:',\n          customConfigFilename,\n        );\n      }\n\n      // see if we have a config file at the package root\n      const maybeConfig = findConfig({\n        dir: packageRoot,\n        customConfigFilename,\n      });\n      if (maybeConfig) {\n        logger.debug('[MFE Config] Config found at package root:', maybeConfig);\n        return MicrofrontendsServer.fromFile({\n          filePath: maybeConfig,\n          cookies,\n        });\n      }\n\n      // if we don't have a microfrontends configuration file, see if we have another package in the repo that references this one\n      const repositoryRoot = findRepositoryRoot();\n      const isMonorepo = isRepositoryMonorepo({ repositoryRoot });\n      logger.debug(\n        '[MFE Config] Repository root:',\n        repositoryRoot,\n        'Is monorepo:',\n        isMonorepo,\n      );\n\n      const configFromEnv = process.env.VC_MICROFRONTENDS_CONFIG;\n      // the environment variable, if specified, takes precedence over other inference methods\n      if (typeof configFromEnv === 'string') {\n        logger.debug(\n          '[MFE Config] Checking VC_MICROFRONTENDS_CONFIG:',\n          configFromEnv,\n        );\n        const maybeConfigFromEnv = resolve(packageRoot, configFromEnv);\n        if (maybeConfigFromEnv) {\n          logger.debug(\n            '[MFE Config] Config loaded from VC_MICROFRONTENDS_CONFIG:',\n            maybeConfigFromEnv,\n          );\n          return MicrofrontendsServer.fromFile({\n            filePath: maybeConfigFromEnv,\n            cookies,\n          });\n        }\n      } else {\n        // when the VC_MICROFRONTENDS_CONFIG environment variable is not set, try to find the config in the .vercel directory first\n        const vercelDir = join(packageRoot, '.vercel');\n        logger.debug(\n          '[MFE Config] Searching for config in .vercel directory:',\n          vercelDir,\n        );\n        const maybeConfigFromVercel = findConfig({\n          dir: vercelDir,\n          customConfigFilename,\n        });\n        if (maybeConfigFromVercel) {\n          logger.debug(\n            '[MFE Config] Config found in .vercel directory:',\n            maybeConfigFromVercel,\n          );\n          return MicrofrontendsServer.fromFile({\n            filePath: maybeConfigFromVercel,\n            cookies,\n          });\n        }\n\n        if (isMonorepo) {\n          logger.debug(\n            '[MFE Config] Inferring microfrontends location in monorepo for application:',\n            applicationContext.name,\n          );\n          // find the default package\n          const defaultPackage = inferMicrofrontendsLocation({\n            repositoryRoot,\n            applicationContext,\n            customConfigFilename,\n          });\n          logger.debug(\n            '[MFE Config] Inferred package location:',\n            defaultPackage,\n          );\n\n          // see if we have a config file at the package root\n          const maybeConfigFromDefault = findConfig({\n            dir: defaultPackage,\n            customConfigFilename,\n          });\n          if (maybeConfigFromDefault) {\n            logger.debug(\n              '[MFE Config] Config found in inferred package:',\n              maybeConfigFromDefault,\n            );\n            return MicrofrontendsServer.fromFile({\n              filePath: maybeConfigFromDefault,\n              cookies,\n            });\n          }\n          logger.debug('[MFE Config] No config found in inferred package');\n        }\n      }\n      // will be caught below\n      throw new MicrofrontendError(\n        'Unable to automatically infer the location of the `microfrontends.json` file. 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 you suspect this is thrown in error, please reach out to the Vercel team.',\n        { type: 'config', subtype: 'inference_failed' },\n      );\n    } catch (e) {\n      if (e instanceof MicrofrontendError) {\n        throw e;\n      }\n      const errorMessage = e instanceof Error ? e.message : String(e);\n      // we were unable to infer\n      throw new MicrofrontendError(\n        `Unable to locate and parse the \\`microfrontends.json\\` configuration file. Original error message: ${errorMessage}`,\n        { cause: e, type: 'config', subtype: 'inference_failed' },\n      );\n    }\n  }\n\n  /*\n   * Generates a MicrofrontendsServer instance from a file.\n   */\n  static fromFile({\n    filePath,\n    cookies,\n  }: {\n    filePath: string;\n    cookies?: { name: string; value: string }[];\n  }): MicrofrontendsServer {\n    try {\n      logger.debug('[MFE Config] Reading config from file:', filePath);\n      const configJson = fs.readFileSync(filePath, 'utf-8');\n      const config = MicrofrontendsServer.validate(configJson);\n      logger.debug(\n        '[MFE Config] Config loaded with applications:',\n        Object.keys(config.applications),\n      );\n\n      return new MicrofrontendsServer({\n        config,\n        overrides: cookies ? parseOverrides(cookies) : undefined,\n      });\n    } catch (e) {\n      throw MicrofrontendError.handle(e, {\n        fileName: filePath,\n      });\n    }\n  }\n\n  /*\n   * Generates a MicrofrontendsServer instance from a file.\n   */\n  static fromMainConfigFile({\n    filePath,\n    overrides,\n  }: {\n    filePath: string;\n    overrides?: OverridesConfig;\n  }): MicrofrontendsServer {\n    try {\n      const config = fs.readFileSync(filePath, 'utf-8');\n      const validatedConfig = MicrofrontendsServer.validate(config);\n      const [defaultApplication] = Object.entries(validatedConfig.applications)\n        .filter(([, app]) => isDefaultApp(app))\n        .map(([name]) => name);\n      // This should never get hit as MicrofrontendsServer.validate checks this if we're given a main config\n      if (!defaultApplication) {\n        throw new MicrofrontendError(\n          'No default application found. At least one application needs to be the default by omitting routing.',\n          { type: 'config', subtype: 'no_default_application' },\n        );\n      }\n      return new MicrofrontendsServer({\n        config: validatedConfig,\n        overrides,\n      });\n    } catch (e) {\n      throw MicrofrontendError.handle(e, {\n        fileName: filePath,\n      });\n    }\n  }\n}\n\nexport { MicrofrontendsServer, getApplicationContext };\n","// cookie name needs to match proxy\n// https://github.com/vercel/proxy/blob/fb00d723136ad539a194e4a851dd272010527c35/lib/routing/micro_frontends_overrides.lua#L7\nexport const OVERRIDES_COOKIE_PREFIX = 'vercel-micro-frontends-override';\nexport const OVERRIDES_ENV_COOKIE_PREFIX = `${OVERRIDES_COOKIE_PREFIX}:env:`;\n","import { OVERRIDES_COOKIE_PREFIX } from './constants';\n\nexport function isOverrideCookie(cookie: { name?: string }): boolean {\n  return Boolean(cookie.name?.startsWith(OVERRIDES_COOKIE_PREFIX));\n}\n","import { isOverrideCookie } from './is-override-cookie';\nimport { OVERRIDES_ENV_COOKIE_PREFIX } from './constants';\n\nexport function getOverrideFromCookie(cookie: {\n  name: string;\n  value?: string | null;\n}): { application: string; host: string } | undefined {\n  if (!isOverrideCookie(cookie) || !cookie.value) return;\n  return {\n    application: cookie.name.replace(OVERRIDES_ENV_COOKIE_PREFIX, ''),\n    host: cookie.value,\n  };\n}\n","import type { OverridesConfig } from './types';\nimport { getOverrideFromCookie } from './get-override-from-cookie';\n\nexport function parseOverrides(\n  cookies: { name: string; value?: string | null }[],\n): OverridesConfig {\n  const overridesConfig: OverridesConfig = { applications: {} };\n\n  cookies.forEach((cookie) => {\n    const override = getOverrideFromCookie(cookie);\n    if (!override) return;\n    overridesConfig.applications[override.application] = {\n      environment: { host: override.host },\n    };\n  });\n\n  return overridesConfig;\n}\n","export type MicrofrontendErrorType =\n  | 'config'\n  | 'packageJson'\n  | 'vercelJson'\n  | 'application'\n  | 'unknown';\n\nexport type MicrofrontendErrorSubtype =\n  | 'not_found'\n  | 'inference_failed'\n  | 'not_found_in_env'\n  | 'invalid_asset_prefix'\n  | 'invalid_main_path'\n  | 'does_not_match_schema'\n  | 'unable_to_read_file'\n  | 'unsupported_validation_env'\n  | 'unsupported_version'\n  | 'invalid_path'\n  | 'invalid_permissions'\n  | 'invalid_syntax'\n  | 'missing_microfrontend_config_path'\n  | 'unsupported_operation';\n\n// A mapping of error types to their subtypes.\ninterface TypeToSubtype {\n  application:\n    | 'invalid_asset_prefix'\n    | 'invalid_path'\n    | 'multiple_package_managers'\n    | 'not_found';\n  config:\n    | 'conflicting_paths'\n    | 'depcrecated_field'\n    | 'does_not_match_schema'\n    | 'invalid_main_path'\n    | 'invalid_preview_deployment_suffix'\n    | 'multiple_default_applications'\n    | 'no_default_application'\n    | 'not_found_in_env'\n    | 'not_found'\n    | 'inference_failed'\n    | 'unable_to_read_file'\n    | 'invalid_syntax'\n    | 'invalid_permissions'\n    | 'unsupported_operation'\n    | 'unsupported_validation_env'\n    | 'unsupported_version';\n  packageJson:\n    | 'missing_field_name'\n    | 'unable_to_read_file'\n    | 'invalid_permissions'\n    | 'invalid_syntax';\n  vercelJson:\n    | 'missing_field_microfrontend_config_path'\n    | 'unable_to_read_file'\n    | 'invalid_permissions'\n    | 'invalid_syntax';\n  unknown: never;\n}\n\nexport type MicrofrontendErrorSource =\n  | '@vercel/microfrontends'\n  | '@vercel/microfrontends/next'\n  | 'fs'\n  | 'ajv';\n\nexport interface MicrofrontendErrorOptions<T extends MicrofrontendErrorType> {\n  cause?: unknown;\n  source?: MicrofrontendErrorSource;\n  type?: T;\n  subtype?: TypeToSubtype[T];\n}\n\ninterface HandleOptions {\n  fileName?: string;\n}\n\nexport class MicrofrontendError<\n  T extends MicrofrontendErrorType = 'unknown',\n> extends Error {\n  public source: MicrofrontendErrorSource;\n  public type: T;\n  public subtype?: TypeToSubtype[T];\n\n  constructor(message: string, opts?: MicrofrontendErrorOptions<T>) {\n    super(message, { cause: opts?.cause });\n    this.name = 'MicrofrontendsError';\n    this.source = opts?.source ?? '@vercel/microfrontends';\n    this.type = opts?.type ?? ('unknown' as T);\n    this.subtype = opts?.subtype;\n    Error.captureStackTrace(this, MicrofrontendError);\n  }\n\n  isKnown(): boolean {\n    return this.type !== 'unknown';\n  }\n\n  isUnknown(): boolean {\n    return !this.isKnown();\n  }\n\n  /**\n   * Converts an error to a MicrofrontendsError.\n   * @param original - The original error to convert.\n   * @returns The converted MicrofrontendsError.\n   */\n  static convert(\n    original: Error,\n    opts?: HandleOptions,\n  ): MicrofrontendError<MicrofrontendErrorType> {\n    if (opts?.fileName) {\n      const err = MicrofrontendError.convertFSError(original, opts.fileName);\n      if (err) {\n        return err;\n      }\n    }\n\n    if (\n      original.message.includes(\n        'Code generation from strings disallowed for this context',\n      )\n    ) {\n      return new MicrofrontendError(original.message, {\n        type: 'config',\n        subtype: 'unsupported_validation_env',\n        source: 'ajv',\n      });\n    }\n\n    // unknown catch-all\n    return new MicrofrontendError(original.message);\n  }\n\n  static convertFSError(\n    original: Error,\n    fileName: string,\n  ): MicrofrontendError<MicrofrontendErrorType> | null {\n    if (original instanceof Error && 'code' in original) {\n      if (original.code === 'ENOENT') {\n        return new MicrofrontendError(`Could not find \"${fileName}\"`, {\n          type: 'config',\n          subtype: 'unable_to_read_file',\n          source: 'fs',\n        });\n      }\n      if (original.code === 'EACCES') {\n        return new MicrofrontendError(\n          `Permission denied while accessing \"${fileName}\"`,\n          {\n            type: 'config',\n            subtype: 'invalid_permissions',\n            source: 'fs',\n          },\n        );\n      }\n    }\n\n    if (original instanceof SyntaxError) {\n      return new MicrofrontendError(\n        `Failed to parse \"${fileName}\": Invalid JSON format.`,\n        {\n          type: 'config',\n          subtype: 'invalid_syntax',\n          source: 'fs',\n        },\n      );\n    }\n\n    return null;\n  }\n\n  /**\n   * Handles an unknown error and returns a MicrofrontendsError instance.\n   * @param err - The error to handle.\n   * @returns A MicrofrontendsError instance.\n   */\n  static handle(\n    err: unknown,\n    opts?: HandleOptions,\n  ): MicrofrontendError<MicrofrontendErrorType> {\n    if (err instanceof MicrofrontendError) {\n      return err as MicrofrontendError<MicrofrontendErrorType>;\n    }\n\n    // handle Error instances\n    if (err instanceof Error) {\n      return MicrofrontendError.convert(err, opts);\n    }\n\n    // handle object errors\n    if (typeof err === 'object' && err !== null) {\n      if ('message' in err && typeof err.message === 'string') {\n        return MicrofrontendError.convert(new Error(err.message), opts);\n      }\n    }\n\n    return new MicrofrontendError('An unknown error occurred');\n  }\n}\n","import { MicrofrontendError } from '../../errors';\n\n/**\n * Utility to fetch the microfrontend configuration string from the environment.\n */\nexport function getConfigStringFromEnv(): string {\n  const config = process.env.MFE_CONFIG;\n  if (!config) {\n    throw new MicrofrontendError(`Missing \"MFE_CONFIG\" in environment.`, {\n      type: 'config',\n      subtype: 'not_found_in_env',\n    });\n  }\n  return config;\n}\n","import type { Application, DefaultApplication } from '../types';\n\nexport function isDefaultApp(a: Application): a is DefaultApplication {\n  return !('routing' in a);\n}\n","import fs from 'node:fs';\nimport path from 'node:path';\n\nconst GIT_DIRECTORY = '.git';\n\nfunction hasGitDirectory(dir: string): boolean {\n  const gitPath = path.join(dir, GIT_DIRECTORY);\n\n  // Check for a .git directory (not a file)\n  return fs.existsSync(gitPath) && fs.statSync(gitPath).isDirectory();\n}\n\nfunction hasPnpmWorkspaces(dir: string): boolean {\n  return fs.existsSync(path.join(dir, 'pnpm-workspace.yaml'));\n}\n\nfunction hasPackageJson(dir: string): boolean {\n  return fs.existsSync(path.join(dir, 'package.json'));\n}\n\n/**\n * Find the root of the repository by looking for a `.git` directory or pnpm workspace.\n * If neither is found, falls back to the topmost directory containing a package.json file.\n * This should work with submodules as well as it verifies that the `.git` directory is a\n * directory and not a file.\n */\nexport function findRepositoryRoot(startDir?: string): string {\n  if (process.env.NX_WORKSPACE_ROOT) {\n    // Trust NX's workspace root here so we don't have to rely on finding a .git\n    // directory. There are some places (like the `vercel deploy` CLI command)\n    // where the .git directory doesn't exist.\n    return process.env.NX_WORKSPACE_ROOT;\n  }\n\n  let currentDir = startDir || process.cwd();\n  let lastPackageJsonDir: string | null = null;\n\n  while (currentDir !== path.parse(currentDir).root) {\n    if (hasGitDirectory(currentDir) || hasPnpmWorkspaces(currentDir)) {\n      return currentDir;\n    }\n\n    if (hasPackageJson(currentDir)) {\n      lastPackageJsonDir = currentDir;\n    }\n\n    currentDir = path.dirname(currentDir);\n  }\n\n  // If we found a package.json directory, use that as the root\n  if (lastPackageJsonDir) {\n    return lastPackageJsonDir;\n  }\n\n  throw new Error(\n    `Could not find the root of the repository for ${startDir}. Please ensure that the directory is part of a Git repository. If you suspect that this should work, please file an issue to the Vercel team.`,\n  );\n}\n","import { dirname } from 'node:path';\nimport { readFileSync } from 'node:fs';\nimport { parse } from 'jsonc-parser';\nimport fg from 'fast-glob';\nimport type { Config } from '../../schema/types';\nimport { MicrofrontendError } from '../../errors';\nimport { logger } from '../../../bin/logger';\nimport { getPossibleConfigurationFilenames } from './get-config-file-name';\nimport type { ApplicationContext } from './get-application-context';\n\n// cache the path to default configuration to avoid having to walk the file system multiple times\nconst configCache: Record<string, string> = {};\n\ninterface FindDefaultMicrofrontendPackageArgs {\n  repositoryRoot: string;\n  applicationContext: ApplicationContext;\n  customConfigFilename: string | undefined;\n}\n\n/**\n * Given a repository root and a package name, find the path to the package.json file with the\n * given name.\n *\n * This method uses globby to find all package.json files and then reads them in parallel\n */\nfunction findPackageWithMicrofrontendsConfig({\n  repositoryRoot,\n  applicationContext,\n  customConfigFilename,\n}: FindDefaultMicrofrontendPackageArgs): string | null {\n  const applicationName = applicationContext.name;\n  logger.debug(\n    '[MFE Config] Searching repository for configs containing application:',\n    applicationName,\n  );\n\n  try {\n    // eslint-disable-next-line import/no-named-as-default-member\n    const microfrontendsJsonPaths = fg.globSync(\n      `**/{${getPossibleConfigurationFilenames({ customConfigFilename }).join(',')}}`,\n      {\n        cwd: repositoryRoot,\n        absolute: true,\n        onlyFiles: true,\n        followSymbolicLinks: false,\n        ignore: ['**/node_modules/**', '**/.git/**'],\n      },\n    );\n\n    logger.debug(\n      '[MFE Config] Found',\n      microfrontendsJsonPaths.length,\n      'config file(s) in repository',\n    );\n\n    const matchingPaths: string[] = [];\n    for (const microfrontendsJsonPath of microfrontendsJsonPaths) {\n      try {\n        const microfrontendsJsonContent = readFileSync(\n          microfrontendsJsonPath,\n          'utf-8',\n        );\n        const microfrontendsJson = parse(microfrontendsJsonContent) as Config;\n\n        if (microfrontendsJson.applications[applicationName]) {\n          logger.debug(\n            '[MFE Config] Found application in config:',\n            microfrontendsJsonPath,\n          );\n          matchingPaths.push(microfrontendsJsonPath);\n        } else {\n          for (const [_, app] of Object.entries(\n            microfrontendsJson.applications,\n          )) {\n            if (app.packageName === applicationName) {\n              logger.debug(\n                '[MFE Config] Found application via packageName in config:',\n                microfrontendsJsonPath,\n              );\n              matchingPaths.push(microfrontendsJsonPath);\n            }\n          }\n        }\n      } catch (error) {\n        // malformed json most likely, skip this file\n      }\n    }\n\n    logger.debug(\n      '[MFE Config] Total matching config files:',\n      matchingPaths.length,\n    );\n\n    if (matchingPaths.length > 1) {\n      throw new MicrofrontendError(\n        `Found multiple \\`microfrontends.json\\` files in the repository referencing the application \"${applicationName}\", but only one is allowed.\\n${matchingPaths.join('\\n  • ')}`,\n        { type: 'config', subtype: 'inference_failed' },\n      );\n    }\n\n    if (matchingPaths.length === 0) {\n      let additionalErrorMessage = '';\n      if (microfrontendsJsonPaths.length > 0) {\n        if (!applicationContext.projectName) {\n          additionalErrorMessage = `\\n\\nIf 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.`;\n        } else {\n          additionalErrorMessage = `\\n\\nNames of applications in \\`microfrontends.json\\` must match the Vercel Project name (${applicationContext.projectName}).`;\n        }\n      }\n      throw new MicrofrontendError(\n        `Could not find a \\`microfrontends.json\\` file in the repository that contains the \"${applicationName}\" application.${additionalErrorMessage}\\n\\n` +\n          `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.\\n\\n` +\n          `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.\\n\\n` +\n          `If you suspect this is thrown in error, please reach out to the Vercel team.`,\n        { type: 'config', subtype: 'inference_failed' },\n      );\n    }\n\n    const [packageJsonPath] = matchingPaths as [string];\n    return dirname(packageJsonPath);\n  } catch (error) {\n    if (error instanceof MicrofrontendError) {\n      throw error;\n    }\n    return null;\n  }\n}\n\n/**\n * Given a repository root and a package name, find the path to the package directory with\n * a microfrontends config that contains the given name in its applications.\n */\nexport function inferMicrofrontendsLocation(\n  opts: FindDefaultMicrofrontendPackageArgs,\n): string {\n  // cache this with name to support multiple configurations in the same repository\n  const cacheKey = `${opts.repositoryRoot}-${opts.applicationContext.name}${opts.customConfigFilename ? `-${opts.customConfigFilename}` : ''}`;\n\n  // Check if we have a cached result\n  if (configCache[cacheKey]) {\n    return configCache[cacheKey];\n  }\n\n  const result = findPackageWithMicrofrontendsConfig(opts);\n\n  if (!result) {\n    throw new MicrofrontendError(\n      `Could not infer the location of the \\`microfrontends.json\\` file for application \"${opts.applicationContext.name}\" starting in directory \"${opts.repositoryRoot}\".`,\n      { type: 'config', subtype: 'inference_failed' },\n    );\n  }\n\n  // Cache the result\n  configCache[cacheKey] = result;\n  return result;\n}\n","// ordered by most likely to be the correct one\nconst DEFAULT_CONFIGURATION_FILENAMES = [\n  'microfrontends.json',\n  'microfrontends.jsonc',\n] as const;\n\nexport function getPossibleConfigurationFilenames({\n  customConfigFilename,\n}: {\n  // from env\n  customConfigFilename: string | undefined;\n}) {\n  if (customConfigFilename) {\n    if (\n      !customConfigFilename.endsWith('.json') &&\n      !customConfigFilename.endsWith('.jsonc')\n    ) {\n      throw new Error(\n        `Found VC_MICROFRONTENDS_CONFIG_FILE_NAME but the name is invalid. Received: ${customConfigFilename}.` +\n          ` The file name must end with '.json' or '.jsonc'.` +\n          ` It's also possible for the env var to include the path, eg microfrontends-dev.json or /path/to/microfrontends-dev.json.`,\n      );\n    }\n    return Array.from(\n      new Set([customConfigFilename, ...DEFAULT_CONFIGURATION_FILENAMES]),\n    );\n  }\n  return DEFAULT_CONFIGURATION_FILENAMES;\n}\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport { logger } from '../../../bin/logger';\n\n/**\n * Given a repository root, determine if the repository is using the workspace feature of any package manager.\n *\n * Supports npm, yarn, pnpm, bun, and vlt\n */\nexport function isMonorepo({\n  repositoryRoot,\n}: {\n  repositoryRoot: string;\n}): boolean {\n  try {\n    // pnpm can be validated just by the existence of the pnpm-workspace.yaml file\n    if (fs.existsSync(path.join(repositoryRoot, 'pnpm-workspace.yaml'))) {\n      return true;\n    }\n\n    // vlt can be validated just by the existence of the vlt-workspaces.json file\n    if (fs.existsSync(path.join(repositoryRoot, 'vlt-workspaces.json'))) {\n      return true;\n    }\n\n    // NX can be validated by checking the environment variable.\n    if (process.env.NX_WORKSPACE_ROOT === path.resolve(repositoryRoot)) {\n      return true;\n    }\n\n    // all the rest need packages defined in root package.json\n    const packageJsonPath = path.join(repositoryRoot, 'package.json');\n    if (!fs.existsSync(packageJsonPath)) {\n      return false;\n    }\n\n    const packageJson = JSON.parse(\n      fs.readFileSync(packageJsonPath, 'utf-8'),\n    ) as {\n      workspaces?: string[] | Record<string, string>;\n    };\n\n    return packageJson.workspaces !== undefined;\n  } catch (error) {\n    logger.error('Error determining if repository is a monorepo', error);\n    return false;\n  }\n}\n","import fs from 'node:fs';\nimport path from 'node:path';\n\nconst PACKAGE_JSON = 'package.json';\n\n/**\n * Find the package root by looking for the closest package.json.\n *\n */\nexport function findPackageRoot(startDir?: string): string {\n  let currentDir = startDir || process.cwd();\n\n  while (currentDir !== path.parse(currentDir).root) {\n    const pkgJsonPath = path.join(currentDir, PACKAGE_JSON);\n\n    // Check for a .git directory (not a file)\n    if (fs.existsSync(pkgJsonPath)) {\n      return currentDir;\n    }\n\n    currentDir = path.dirname(currentDir);\n  }\n\n  throw new Error(\n    `The root of the package that contains the \\`package.json\\` file for the \\`${startDir}\\` directory could not be found.`,\n  );\n}\n","import fs from 'node:fs';\nimport { join } from 'node:path';\nimport { getPossibleConfigurationFilenames } from './get-config-file-name';\n\nexport function findConfig({\n  dir,\n  customConfigFilename,\n}: {\n  dir: string;\n  customConfigFilename: string | undefined;\n}): string | null {\n  for (const filename of getPossibleConfigurationFilenames({\n    customConfigFilename,\n  })) {\n    const maybeConfig = join(dir, filename);\n    if (fs.existsSync(maybeConfig)) {\n      return maybeConfig;\n    }\n  }\n\n  return null;\n}\n","import { parse } from 'jsonc-parser';\nimport { getConfigStringFromEnv } from '../utils/get-config-from-env';\nimport { isDefaultApp } from '../../schema/utils/is-default-app';\nimport type { Config } from '../../schema/types';\nimport { MicrofrontendError } from '../../errors';\nimport { type OverridesConfig, parseOverrides } from '../../overrides';\nimport type { ClientConfig } from '../client/types';\nimport { MicrofrontendConfigClient } from '../client';\nimport { DefaultApplication, ChildApplication } from './application';\nimport { DEFAULT_LOCAL_PROXY_PORT } from './constants';\nimport {\n  validateConfigDefaultApplication,\n  validateConfigPaths,\n} from './validation';\nimport { hashApplicationName } from './utils/hash-application-name';\n\n/**\n * A class to manage the microfrontends configuration.\n */\nexport class MicrofrontendConfigIsomorphic {\n  config: Config;\n  defaultApplication: DefaultApplication;\n  childApplications: Record<string, ChildApplication> = {};\n  overrides?: OverridesConfig;\n  options?: Config['options'];\n\n  private readonly serialized: {\n    config: Config;\n    overrides?: OverridesConfig;\n  };\n\n  constructor({\n    config,\n    overrides,\n  }: {\n    config: Config;\n    overrides?: OverridesConfig;\n  }) {\n    // run validation on init\n    MicrofrontendConfigIsomorphic.validate(config);\n\n    const disableOverrides = config.options?.disableOverrides ?? false;\n    this.overrides = overrides && !disableOverrides ? overrides : undefined;\n\n    let defaultApplication: DefaultApplication | undefined;\n    // create applications\n    for (const [appId, appConfig] of Object.entries(config.applications)) {\n      const appOverrides = !disableOverrides\n        ? this.overrides?.applications[appId]\n        : undefined;\n\n      if (isDefaultApp(appConfig)) {\n        defaultApplication = new DefaultApplication(appId, {\n          app: appConfig,\n          overrides: appOverrides,\n        });\n      } else {\n        this.childApplications[appId] = new ChildApplication(appId, {\n          app: appConfig,\n          overrides: appOverrides,\n        });\n      }\n    }\n\n    // validate that this.defaultApplication is defined\n    if (!defaultApplication) {\n      throw new MicrofrontendError(\n        'Could not find default application in microfrontends configuration',\n        {\n          type: 'application',\n          subtype: 'not_found',\n        },\n      );\n    }\n    this.defaultApplication = defaultApplication;\n\n    this.config = config;\n    this.options = config.options;\n    this.serialized = {\n      config,\n      overrides,\n    };\n  }\n\n  static validate(config: string | Config): Config {\n    // let this throw if it's not valid JSON\n    const c = typeof config === 'string' ? (parse(config) as Config) : config;\n\n    validateConfigPaths(c.applications);\n    validateConfigDefaultApplication(c.applications);\n\n    return c;\n  }\n\n  static fromEnv({\n    cookies,\n  }: {\n    cookies?: { name: string; value: string }[];\n  }): MicrofrontendConfigIsomorphic {\n    return new MicrofrontendConfigIsomorphic({\n      config: parse(getConfigStringFromEnv()) as Config,\n      overrides: parseOverrides(cookies ?? []),\n    });\n  }\n\n  isOverridesDisabled(): boolean {\n    return this.options?.disableOverrides ?? false;\n  }\n\n  getConfig(): Config {\n    return this.config;\n  }\n\n  getApplicationsByType(): {\n    defaultApplication?: DefaultApplication;\n    applications: ChildApplication[];\n  } {\n    return {\n      defaultApplication: this.defaultApplication,\n      applications: Object.values(this.childApplications),\n    };\n  }\n\n  getChildApplications(): ChildApplication[] {\n    return Object.values(this.childApplications);\n  }\n\n  getAllApplications(): (DefaultApplication | ChildApplication)[] {\n    return [\n      this.defaultApplication,\n      ...Object.values(this.childApplications),\n    ].filter(Boolean);\n  }\n\n  getApplication(name: string): DefaultApplication | ChildApplication {\n    // check the default\n    if (\n      this.defaultApplication.name === name ||\n      this.defaultApplication.packageName === name\n    ) {\n      return this.defaultApplication;\n    }\n    const app =\n      this.childApplications[name] ||\n      Object.values(this.childApplications).find(\n        (child) => child.packageName === name,\n      );\n    if (!app) {\n      throw new MicrofrontendError(\n        `Could not find microfrontends configuration for application \"${name}\". If the name in package.json 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.`,\n        {\n          type: 'application',\n          subtype: 'not_found',\n        },\n      );\n    }\n\n    return app;\n  }\n\n  hasApplication(name: string): boolean {\n    try {\n      this.getApplication(name);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  getApplicationByProjectName(\n    projectName: string,\n  ): DefaultApplication | ChildApplication | undefined {\n    // check the default\n    if (this.defaultApplication.name === projectName) {\n      return this.defaultApplication;\n    }\n\n    return Object.values(this.childApplications).find(\n      (app) => app.name === projectName,\n    );\n  }\n\n  /**\n   * Returns the default application.\n   */\n  getDefaultApplication(): DefaultApplication {\n    return this.defaultApplication;\n  }\n\n  /**\n   * Returns the configured port for the local proxy\n   */\n  getLocalProxyPort(): number {\n    return this.config.options?.localProxyPort ?? DEFAULT_LOCAL_PROXY_PORT;\n  }\n\n  toClientConfig(options?: {\n    removeFlaggedPaths?: boolean;\n  }): MicrofrontendConfigClient {\n    const applications: ClientConfig['applications'] = Object.fromEntries(\n      Object.entries(this.childApplications).map(([name, application]) => [\n        hashApplicationName(name),\n        {\n          default: false,\n          routing: application.routing,\n        },\n      ]),\n    );\n\n    applications[hashApplicationName(this.defaultApplication.name)] = {\n      default: true,\n    };\n\n    return new MicrofrontendConfigClient(\n      {\n        applications,\n      },\n      {\n        removeFlaggedPaths: options?.removeFlaggedPaths,\n      },\n    );\n  }\n\n  /**\n   * Serializes the class back to the Schema type.\n   *\n   * NOTE: This is used when writing the config to disk and must always match the input Schema\n   */\n  toSchemaJson(): Config {\n    return this.serialized.config;\n  }\n\n  serialize(): {\n    config: Config;\n    overrides?: OverridesConfig;\n  } {\n    return this.serialized;\n  }\n}\n","import { pathToRegexp } from 'path-to-regexp';\nimport type { ClientConfig } from './types';\n\nexport interface MicrofrontendConfigClientOptions {\n  removeFlaggedPaths?: boolean;\n}\n\nconst regexpCache = new Map<string, RegExp>();\nconst getRegexp = (path: string): RegExp => {\n  const existing = regexpCache.get(path);\n  if (existing) {\n    return existing;\n  }\n\n  const regexp = pathToRegexp(path);\n  regexpCache.set(path, regexp);\n  return regexp;\n};\n\nexport class MicrofrontendConfigClient {\n  applications: ClientConfig['applications'];\n  hasFlaggedPaths: boolean;\n  pathCache: Record<string, string> = {};\n  private readonly serialized: ClientConfig;\n\n  constructor(config: ClientConfig, opts?: MicrofrontendConfigClientOptions) {\n    this.hasFlaggedPaths = config.hasFlaggedPaths ?? false;\n    for (const app of Object.values(config.applications)) {\n      if (app.routing) {\n        if (app.routing.some((match) => match.flag)) {\n          this.hasFlaggedPaths = true;\n        }\n        const newRouting = [];\n        const pathsWithoutFlags = [];\n        for (const group of app.routing) {\n          if (group.flag) {\n            if (opts?.removeFlaggedPaths) {\n              continue;\n            }\n            if (group.group) {\n              delete group.group;\n            }\n            newRouting.push(group);\n          } else {\n            pathsWithoutFlags.push(...group.paths);\n          }\n        }\n        if (pathsWithoutFlags.length > 0) {\n          newRouting.push({ paths: pathsWithoutFlags });\n        }\n        app.routing = newRouting;\n      }\n    }\n    this.serialized = config;\n    if (this.hasFlaggedPaths) {\n      this.serialized.hasFlaggedPaths = this.hasFlaggedPaths;\n    }\n    this.applications = config.applications;\n  }\n\n  /**\n   * Create a new `MicrofrontendConfigClient` from a JSON string.\n   * Config must be passed in to remain framework agnostic\n   */\n  static fromEnv(config: string | undefined): MicrofrontendConfigClient {\n    if (!config) {\n      throw new Error(\n        'Could not construct MicrofrontendConfigClient: configuration is empty or undefined. Did you set up your application with `withMicrofrontends`? Is the local proxy running and this application is being accessed via the proxy port? See https://vercel.com/docs/microfrontends/local-development#setting-up-microfrontends-proxy',\n      );\n    }\n    return new MicrofrontendConfigClient(JSON.parse(config) as ClientConfig);\n  }\n\n  isEqual(other: MicrofrontendConfigClient): boolean {\n    return (\n      this === other ||\n      JSON.stringify(this.applications) === JSON.stringify(other.applications)\n    );\n  }\n\n  getApplicationNameForPath(path: string): string | null {\n    if (!path.startsWith('/')) {\n      throw new Error(`Path must start with a /`);\n    }\n\n    if (this.pathCache[path]) {\n      return this.pathCache[path];\n    }\n\n    const pathname = new URL(path, 'https://example.com').pathname;\n    for (const [name, application] of Object.entries(this.applications)) {\n      if (application.routing) {\n        for (const group of application.routing) {\n          for (const childPath of group.paths) {\n            const regexp = getRegexp(childPath);\n            if (regexp.test(pathname)) {\n              this.pathCache[path] = name;\n              return name;\n            }\n          }\n        }\n      }\n    }\n    const defaultApplication = Object.entries(this.applications).find(\n      ([, application]) => application.default,\n    );\n    if (!defaultApplication) {\n      return null;\n    }\n\n    this.pathCache[path] = defaultApplication[0];\n    return defaultApplication[0];\n  }\n\n  serialize(): ClientConfig {\n    return this.serialized;\n  }\n}\n","import { pathToRegexp, parse as parsePathRegexp } from 'path-to-regexp';\nimport type {\n  ApplicationId,\n  PathGroup,\n  ApplicationRouting,\n  ChildApplication as ChildApplicationConfig,\n} from '../../schema/types';\nimport { MicrofrontendError } from '../../errors';\nimport { isDefaultApp } from '../../schema/utils/is-default-app';\n\nconst LIST_FORMATTER = new Intl.ListFormat('en', {\n  style: 'long',\n  type: 'conjunction',\n});\n\nconst VALID_ASSET_PREFIX_REGEXP = /^[a-z](?:[a-z0-9-]*[a-z0-9])?$/;\n\n/**\n * Validate all paths in a configuration - ensures paths do not overlap\n */\nexport const validateConfigPaths = (\n  applicationConfigsById?: ApplicationRouting,\n): void => {\n  if (!applicationConfigsById) {\n    return;\n  }\n\n  const pathsByApplicationId = new Map<\n    PathGroup['paths'][number],\n    {\n      applications: ApplicationId[];\n      matcher: RegExp;\n      applicationId?: ApplicationId;\n    }\n  >();\n  const errors: string[] = [];\n\n  for (const [id, app] of Object.entries(applicationConfigsById)) {\n    if (isDefaultApp(app)) {\n      // default applications do not have routing\n      continue;\n    }\n\n    for (const pathMatch of app.routing) {\n      for (const path of pathMatch.paths) {\n        const maybeError = validatePathExpression(path);\n        if (maybeError) {\n          errors.push(maybeError);\n        } else {\n          const existing = pathsByApplicationId.get(path);\n          if (existing) {\n            existing.applications.push(id);\n          } else {\n            pathsByApplicationId.set(path, {\n              applications: [id],\n              matcher: pathToRegexp(path),\n              applicationId: id,\n            });\n          }\n        }\n      }\n    }\n  }\n  const entries = Array.from(pathsByApplicationId.entries());\n\n  for (const [path, { applications: ids, matcher, applicationId }] of entries)