@backstage/frontend-app-api 0.13.3 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @backstage/frontend-app-api
 
+## 0.14.0
+
+### Minor Changes
+
+- 3bd2a1a: BREAKING: The ability for plugins to override APIs has been restricted to only allow overrides of APIs within the same plugin. For example, a plugin can no longer override any of the core APIs provided by the `app` plugin, this must be done with an `app` module instead.
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/frontend-plugin-api@0.13.3
+  - @backstage/frontend-defaults@0.3.5
+
+## 0.13.4-next.0
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/frontend-defaults@0.3.5-next.0
+  - @backstage/frontend-plugin-api@0.13.2
+
 ## 0.13.3
 
 ### Patch Changes

package/dist/index.d.ts

@@ -141,6 +141,14 @@ type AppErrorTypes = {
             node: AppNode;
         };
     };
+    API_FACTORY_CONFLICT: {
+        context: {
+            node: AppNode;
+            apiRefId: string;
+            pluginId: string;
+            existingPluginId: string;
+        };
+    };
     ROUTE_DUPLICATE: {
         context: {
             routeId: string;

package/dist/wiring/createErrorCollector.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"createErrorCollector.esm.js","sources":["../../src/wiring/createErrorCollector.ts"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { AppNode, FrontendPlugin } from '@backstage/frontend-plugin-api';\n\n/**\n * @public\n */\nexport type AppErrorTypes = {\n  // resolveAppNodeSpecs\n  EXTENSION_IGNORED: {\n    context: { plugin: FrontendPlugin; extensionId: string };\n  };\n  INVALID_EXTENSION_CONFIG_KEY: {\n    context: { extensionId: string };\n  };\n  // resolveAppTree\n  EXTENSION_INPUT_REDIRECT_CONFLICT: {\n    context: { node: AppNode; inputName: string };\n  };\n  // instantiateAppNodeTree\n  EXTENSION_INPUT_DATA_IGNORED: {\n    context: { node: AppNode; inputName: string };\n  };\n  EXTENSION_INPUT_DATA_MISSING: {\n    context: { node: AppNode; inputName: string };\n  };\n  EXTENSION_ATTACHMENT_CONFLICT: {\n    context: { node: AppNode; inputName: string };\n  };\n  EXTENSION_ATTACHMENT_MISSING: {\n    context: { node: AppNode; inputName: string };\n  };\n  EXTENSION_CONFIGURATION_INVALID: {\n    context: { node: AppNode };\n  };\n  EXTENSION_INVALID: {\n    context: { node: AppNode };\n  };\n  EXTENSION_OUTPUT_CONFLICT: {\n    context: { node: AppNode; dataRefId: string };\n  };\n  EXTENSION_OUTPUT_MISSING: {\n    context: { node: AppNode; dataRefId: string };\n  };\n  EXTENSION_OUTPUT_IGNORED: {\n    context: { node: AppNode; dataRefId: string };\n  };\n  EXTENSION_FACTORY_ERROR: {\n    context: { node: AppNode };\n  };\n  // createSpecializedApp\n  API_EXTENSION_INVALID: {\n    context: { node: AppNode };\n  };\n  // routing\n  ROUTE_DUPLICATE: {\n    context: { routeId: string };\n  };\n  ROUTE_BINDING_INVALID_VALUE: {\n    context: { routeId: string };\n  };\n  ROUTE_NOT_FOUND: {\n    context: { routeId: string };\n  };\n};\n\n/**\n * @public\n */\nexport type AppError =\n  keyof AppErrorTypes extends infer ICode extends keyof AppErrorTypes\n    ? ICode extends any\n      ? {\n          code: ICode;\n          message: string;\n          context: AppErrorTypes[ICode]['context'];\n        }\n      : never\n    : never;\n\n/** @internal */\nexport interface ErrorCollector<TContext extends {} = {}> {\n  report<TCode extends keyof AppErrorTypes>(\n    report: Omit<\n      AppErrorTypes[TCode]['context'],\n      keyof TContext\n    > extends infer IContext extends {}\n      ? {} extends IContext\n        ? {\n            code: TCode;\n            message: string;\n          }\n        : {\n            code: TCode;\n            message: string;\n            context: IContext;\n          }\n      : never,\n  ): void;\n  child<TAdditionalContext extends {}>(\n    context: TAdditionalContext,\n  ): ErrorCollector<TContext & TAdditionalContext>;\n  collectErrors(): AppError[] | undefined;\n}\n\n/** @internal */\nexport function createErrorCollector(\n  context?: Partial<AppError['context']>,\n): ErrorCollector {\n  const errors: AppError[] = [];\n  const children: ErrorCollector[] = [];\n  return {\n    report(report: { code: string; message: string; context?: {} }) {\n      errors.push({\n        ...report,\n        context: { ...context, ...report.context },\n      } as AppError);\n    },\n    collectErrors() {\n      const allErrors = [\n        ...errors,\n        ...children.flatMap(child => child.collectErrors() ?? []),\n      ];\n      errors.length = 0;\n      if (allErrors.length === 0) {\n        return undefined;\n      }\n      return allErrors;\n    },\n    child(childContext) {\n      const child = createErrorCollector({ ...context, ...childContext });\n      children.push(child);\n      return child as ErrorCollector<any>;\n    },\n  };\n}\n"],"names":[],"mappings":"AAwHO,SAAS,qBACd,OAAA,EACgB;AAChB,EAAA,MAAM,SAAqB,EAAC;AAC5B,EAAA,MAAM,WAA6B,EAAC;AACpC,EAAA,OAAO;AAAA,IACL,OAAO,MAAA,EAAyD;AAC9D,MAAA,MAAA,CAAO,IAAA,CAAK;AAAA,QACV,GAAG,MAAA;AAAA,QACH,SAAS,EAAE,GAAG,OAAA,EAAS,GAAG,OAAO,OAAA;AAAQ,OAC9B,CAAA;AAAA,IACf,CAAA;AAAA,IACA,aAAA,GAAgB;AACd,MAAA,MAAM,SAAA,GAAY;AAAA,QAChB,GAAG,MAAA;AAAA,QACH,GAAG,SAAS,OAAA,CAAQ,CAAA,KAAA,KAAS,MAAM,aAAA,EAAc,IAAK,EAAE;AAAA,OAC1D;AACA,MAAA,MAAA,CAAO,MAAA,GAAS,CAAA;AAChB,MAAA,IAAI,SAAA,CAAU,WAAW,CAAA,EAAG;AAC1B,QAAA,OAAO,MAAA;AAAA,MACT;AACA,MAAA,OAAO,SAAA;AAAA,IACT,CAAA;AAAA,IACA,MAAM,YAAA,EAAc;AAClB,MAAA,MAAM,QAAQ,oBAAA,CAAqB,EAAE,GAAG,OAAA,EAAS,GAAG,cAAc,CAAA;AAClE,MAAA,QAAA,CAAS,KAAK,KAAK,CAAA;AACnB,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,GACF;AACF;;;;"}
+{"version":3,"file":"createErrorCollector.esm.js","sources":["../../src/wiring/createErrorCollector.ts"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { AppNode, FrontendPlugin } from '@backstage/frontend-plugin-api';\n\n/**\n * @public\n */\nexport type AppErrorTypes = {\n  // resolveAppNodeSpecs\n  EXTENSION_IGNORED: {\n    context: { plugin: FrontendPlugin; extensionId: string };\n  };\n  INVALID_EXTENSION_CONFIG_KEY: {\n    context: { extensionId: string };\n  };\n  // resolveAppTree\n  EXTENSION_INPUT_REDIRECT_CONFLICT: {\n    context: { node: AppNode; inputName: string };\n  };\n  // instantiateAppNodeTree\n  EXTENSION_INPUT_DATA_IGNORED: {\n    context: { node: AppNode; inputName: string };\n  };\n  EXTENSION_INPUT_DATA_MISSING: {\n    context: { node: AppNode; inputName: string };\n  };\n  EXTENSION_ATTACHMENT_CONFLICT: {\n    context: { node: AppNode; inputName: string };\n  };\n  EXTENSION_ATTACHMENT_MISSING: {\n    context: { node: AppNode; inputName: string };\n  };\n  EXTENSION_CONFIGURATION_INVALID: {\n    context: { node: AppNode };\n  };\n  EXTENSION_INVALID: {\n    context: { node: AppNode };\n  };\n  EXTENSION_OUTPUT_CONFLICT: {\n    context: { node: AppNode; dataRefId: string };\n  };\n  EXTENSION_OUTPUT_MISSING: {\n    context: { node: AppNode; dataRefId: string };\n  };\n  EXTENSION_OUTPUT_IGNORED: {\n    context: { node: AppNode; dataRefId: string };\n  };\n  EXTENSION_FACTORY_ERROR: {\n    context: { node: AppNode };\n  };\n  // createSpecializedApp\n  API_EXTENSION_INVALID: {\n    context: { node: AppNode };\n  };\n  API_FACTORY_CONFLICT: {\n    context: {\n      node: AppNode;\n      apiRefId: string;\n      pluginId: string;\n      existingPluginId: string;\n    };\n  };\n  // routing\n  ROUTE_DUPLICATE: {\n    context: { routeId: string };\n  };\n  ROUTE_BINDING_INVALID_VALUE: {\n    context: { routeId: string };\n  };\n  ROUTE_NOT_FOUND: {\n    context: { routeId: string };\n  };\n};\n\n/**\n * @public\n */\nexport type AppError =\n  keyof AppErrorTypes extends infer ICode extends keyof AppErrorTypes\n    ? ICode extends any\n      ? {\n          code: ICode;\n          message: string;\n          context: AppErrorTypes[ICode]['context'];\n        }\n      : never\n    : never;\n\n/** @internal */\nexport interface ErrorCollector<TContext extends {} = {}> {\n  report<TCode extends keyof AppErrorTypes>(\n    report: Omit<\n      AppErrorTypes[TCode]['context'],\n      keyof TContext\n    > extends infer IContext extends {}\n      ? {} extends IContext\n        ? {\n            code: TCode;\n            message: string;\n          }\n        : {\n            code: TCode;\n            message: string;\n            context: IContext;\n          }\n      : never,\n  ): void;\n  child<TAdditionalContext extends {}>(\n    context: TAdditionalContext,\n  ): ErrorCollector<TContext & TAdditionalContext>;\n  collectErrors(): AppError[] | undefined;\n}\n\n/** @internal */\nexport function createErrorCollector(\n  context?: Partial<AppError['context']>,\n): ErrorCollector {\n  const errors: AppError[] = [];\n  const children: ErrorCollector[] = [];\n  return {\n    report(report: { code: string; message: string; context?: {} }) {\n      errors.push({\n        ...report,\n        context: { ...context, ...report.context },\n      } as AppError);\n    },\n    collectErrors() {\n      const allErrors = [\n        ...errors,\n        ...children.flatMap(child => child.collectErrors() ?? []),\n      ];\n      errors.length = 0;\n      if (allErrors.length === 0) {\n        return undefined;\n      }\n      return allErrors;\n    },\n    child(childContext) {\n      const child = createErrorCollector({ ...context, ...childContext });\n      children.push(child);\n      return child as ErrorCollector<any>;\n    },\n  };\n}\n"],"names":[],"mappings":"AAgIO,SAAS,qBACd,OAAA,EACgB;AAChB,EAAA,MAAM,SAAqB,EAAC;AAC5B,EAAA,MAAM,WAA6B,EAAC;AACpC,EAAA,OAAO;AAAA,IACL,OAAO,MAAA,EAAyD;AAC9D,MAAA,MAAA,CAAO,IAAA,CAAK;AAAA,QACV,GAAG,MAAA;AAAA,QACH,SAAS,EAAE,GAAG,OAAA,EAAS,GAAG,OAAO,OAAA;AAAQ,OAC9B,CAAA;AAAA,IACf,CAAA;AAAA,IACA,aAAA,GAAgB;AACd,MAAA,MAAM,SAAA,GAAY;AAAA,QAChB,GAAG,MAAA;AAAA,QACH,GAAG,SAAS,OAAA,CAAQ,CAAA,KAAA,KAAS,MAAM,aAAA,EAAc,IAAK,EAAE;AAAA,OAC1D;AACA,MAAA,MAAA,CAAO,MAAA,GAAS,CAAA;AAChB,MAAA,IAAI,SAAA,CAAU,WAAW,CAAA,EAAG;AAC1B,QAAA,OAAO,MAAA;AAAA,MACT;AACA,MAAA,OAAO,SAAA;AAAA,IACT,CAAA;AAAA,IACA,MAAM,YAAA,EAAc;AAClB,MAAA,MAAM,QAAQ,oBAAA,CAAqB,EAAE,GAAG,OAAA,EAAS,GAAG,cAAc,CAAA;AAClE,MAAA,QAAA,CAAS,KAAK,KAAK,CAAA;AACnB,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,GACF;AACF;;;;"}

package/dist/wiring/createSpecializedApp.esm.js

@@ -180,14 +180,40 @@ function createSpecializedApp(options) {
 }
 function createApiFactories(options) {
   const emptyApiHolder = ApiRegistry.from([]);
-  const factories = new Array();
+  const factoriesById = /* @__PURE__ */ new Map();
   for (const apiNode of options.tree.root.edges.attachments.get("apis") ?? []) {
     if (!instantiateAppNodeTree(apiNode, emptyApiHolder, options.collector)) {
       continue;
     }
     const apiFactory = apiNode.instance?.getData(ApiBlueprint.dataRefs.factory);
     if (apiFactory) {
-      factories.push(apiFactory);
+      const apiRefId = apiFactory.api.id;
+      const ownerId = getApiOwnerId(apiRefId);
+      const pluginId = apiNode.spec.plugin.id ?? "app";
+      const existingFactory = factoriesById.get(apiRefId);
+      if (existingFactory && existingFactory.pluginId !== pluginId) {
+        const shouldReplace = ownerId === pluginId && existingFactory.pluginId !== ownerId;
+        const acceptedPluginId = shouldReplace ? pluginId : existingFactory.pluginId;
+        const rejectedPluginId = shouldReplace ? existingFactory.pluginId : pluginId;
+        options.collector.report({
+          code: "API_FACTORY_CONFLICT",
+          message: `API '${apiRefId}' is already provided by plugin '${acceptedPluginId}', cannot also be provided by '${rejectedPluginId}'.`,
+          context: {
+            node: apiNode,
+            apiRefId,
+            pluginId: rejectedPluginId,
+            existingPluginId: acceptedPluginId
+          }
+        });
+        if (shouldReplace) {
+          factoriesById.set(apiRefId, {
+            pluginId,
+            factory: apiFactory
+          });
+        }
+        continue;
+      }
+      factoriesById.set(apiRefId, { pluginId, factory: apiFactory });
     } else {
       options.collector.report({
         code: "API_EXTENSION_INVALID",
@@ -198,7 +224,20 @@ function createApiFactories(options) {
       });
     }
   }
-  return factories;
+  return Array.from(factoriesById.values(), (entry) => entry.factory);
+}
+function getApiOwnerId(apiRefId) {
+  const [prefix, ...rest] = apiRefId.split(".");
+  if (!prefix) {
+    return apiRefId;
+  }
+  if (prefix === "core") {
+    return "app";
+  }
+  if (prefix === "plugin" && rest[0]) {
+    return rest[0];
+  }
+  return prefix;
 }
 function createApiHolder(options) {
   const factoryRegistry = new ApiFactoryRegistry();

package/dist/wiring/createSpecializedApp.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"createSpecializedApp.esm.js","sources":["../../src/wiring/createSpecializedApp.tsx"],"sourcesContent":["/*\n * Copyright 2023 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ConfigReader } from '@backstage/config';\nimport {\n  ApiBlueprint,\n  AppTree,\n  AppTreeApi,\n  appTreeApiRef,\n  RouteRef,\n  ExternalRouteRef,\n  SubRouteRef,\n  AnyRouteRefParams,\n  RouteFunc,\n  RouteResolutionApi,\n  createApiFactory,\n  routeResolutionApiRef,\n  AppNode,\n  ExtensionFactoryMiddleware,\n  FrontendFeature,\n} from '@backstage/frontend-plugin-api';\nimport {\n  AnyApiFactory,\n  ApiHolder,\n  ConfigApi,\n  configApiRef,\n  featureFlagsApiRef,\n  identityApiRef,\n} from '@backstage/core-plugin-api';\nimport { ApiFactoryRegistry, ApiResolver } from '@backstage/core-app-api';\nimport {\n  createExtensionDataContainer,\n  OpaqueFrontendPlugin,\n} from '@internal/frontend';\n\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport {\n  resolveExtensionDefinition,\n  toInternalExtension,\n} from '../../../frontend-plugin-api/src/wiring/resolveExtensionDefinition';\n\nimport {\n  extractRouteInfoFromAppNode,\n  RouteInfo,\n} from '../routing/extractRouteInfoFromAppNode';\n\nimport { CreateAppRouteBinder } from '../routing';\nimport { RouteResolver } from '../routing/RouteResolver';\nimport { resolveRouteBindings } from '../routing/resolveRouteBindings';\nimport { collectRouteIds } from '../routing/collectRouteIds';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport {\n  toInternalFrontendModule,\n  isInternalFrontendModule,\n} from '../../../frontend-plugin-api/src/wiring/createFrontendModule';\nimport { getBasePath } from '../routing/getBasePath';\nimport { Root } from '../extensions/Root';\nimport { resolveAppTree } from '../tree/resolveAppTree';\nimport { resolveAppNodeSpecs } from '../tree/resolveAppNodeSpecs';\nimport { readAppExtensionsConfig } from '../tree/readAppExtensionsConfig';\nimport { instantiateAppNodeTree } from '../tree/instantiateAppNodeTree';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { ApiRegistry } from '../../../core-app-api/src/apis/system/ApiRegistry';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { AppIdentityProxy } from '../../../core-app-api/src/apis/implementations/IdentityApi/AppIdentityProxy';\nimport { BackstageRouteObject } from '../routing/types';\nimport { matchRoutes } from 'react-router-dom';\nimport {\n  createPluginInfoAttacher,\n  FrontendPluginInfoResolver,\n} from './createPluginInfoAttacher';\nimport { createRouteAliasResolver } from '../routing/RouteAliasResolver';\nimport {\n  AppError,\n  createErrorCollector,\n  ErrorCollector,\n} from './createErrorCollector';\n\nfunction deduplicateFeatures(\n  allFeatures: FrontendFeature[],\n): FrontendFeature[] {\n  // Start by removing duplicates by reference\n  const features = Array.from(new Set(allFeatures));\n\n  // Plugins are deduplicated by ID, last one wins\n  const seenIds = new Set<string>();\n  return features\n    .reverse()\n    .filter(feature => {\n      if (!OpaqueFrontendPlugin.isType(feature)) {\n        return true;\n      }\n      if (seenIds.has(feature.id)) {\n        return false;\n      }\n      seenIds.add(feature.id);\n      return true;\n    })\n    .reverse();\n}\n\n// Helps delay callers from reaching out to the API before the app tree has been materialized\nclass AppTreeApiProxy implements AppTreeApi {\n  #routeInfo?: RouteInfo;\n  private readonly tree: AppTree;\n  private readonly appBasePath: string;\n\n  constructor(tree: AppTree, appBasePath: string) {\n    this.tree = tree;\n    this.appBasePath = appBasePath;\n  }\n\n  private checkIfInitialized() {\n    if (!this.#routeInfo) {\n      throw new Error(\n        `You can't access the AppTreeApi during initialization of the app tree. Please move occurrences of this out of the initialization of the factory`,\n      );\n    }\n  }\n\n  getTree() {\n    this.checkIfInitialized();\n\n    return { tree: this.tree };\n  }\n\n  getNodesByRoutePath(routePath: string): { nodes: AppNode[] } {\n    this.checkIfInitialized();\n\n    let path = routePath;\n    if (path.startsWith(this.appBasePath)) {\n      path = path.slice(this.appBasePath.length);\n    }\n\n    const matchedRoutes = matchRoutes(this.#routeInfo!.routeObjects, path);\n\n    const matchedAppNodes =\n      matchedRoutes\n        ?.filter(routeObj => !!routeObj.route.appNode)\n        .map(routeObj => routeObj.route.appNode!) || [];\n\n    return { nodes: matchedAppNodes };\n  }\n\n  initialize(routeInfo: RouteInfo) {\n    this.#routeInfo = routeInfo;\n  }\n}\n\n// Helps delay callers from reaching out to the API before the app tree has been materialized\nclass RouteResolutionApiProxy implements RouteResolutionApi {\n  #delegate: RouteResolutionApi | undefined;\n  #routeObjects: BackstageRouteObject[] | undefined;\n\n  private readonly routeBindings: Map<ExternalRouteRef, RouteRef | SubRouteRef>;\n  private readonly appBasePath: string;\n\n  constructor(\n    routeBindings: Map<ExternalRouteRef, RouteRef | SubRouteRef>,\n    appBasePath: string,\n  ) {\n    this.routeBindings = routeBindings;\n    this.appBasePath = appBasePath;\n  }\n\n  resolve<TParams extends AnyRouteRefParams>(\n    anyRouteRef:\n      | RouteRef<TParams>\n      | SubRouteRef<TParams>\n      | ExternalRouteRef<TParams>,\n    options?: { sourcePath?: string },\n  ): RouteFunc<TParams> | undefined {\n    if (!this.#delegate) {\n      throw new Error(\n        `You can't access the RouteResolver during initialization of the app tree. Please move occurrences of this out of the initialization of the factory`,\n      );\n    }\n\n    return this.#delegate.resolve(anyRouteRef, options);\n  }\n\n  initialize(\n    routeInfo: RouteInfo,\n    routeRefsById: Map<string, RouteRef | SubRouteRef>,\n  ) {\n    this.#delegate = new RouteResolver(\n      routeInfo.routePaths,\n      routeInfo.routeParents,\n      routeInfo.routeObjects,\n      this.routeBindings,\n      this.appBasePath,\n      routeInfo.routeAliasResolver,\n      routeRefsById,\n    );\n    this.#routeObjects = routeInfo.routeObjects;\n\n    return routeInfo;\n  }\n\n  getRouteObjects() {\n    return this.#routeObjects;\n  }\n}\n\n/**\n * Options for {@link createSpecializedApp}.\n *\n * @public\n */\nexport type CreateSpecializedAppOptions = {\n  /**\n   * The list of features to load.\n   */\n  features?: FrontendFeature[];\n\n  /**\n   * The config API implementation to use. For most normal apps, this should be\n   * specified.\n   *\n   * If none is given, a new _empty_ config will be used during startup. In\n   * later stages of the app lifecycle, the config API in the API holder will be\n   * used.\n   */\n  config?: ConfigApi;\n\n  /**\n   * Allows for the binding of plugins' external route refs within the app.\n   */\n  bindRoutes?(context: { bind: CreateAppRouteBinder }): void;\n\n  /**\n   * Advanced, more rarely used options.\n   */\n  advanced?: {\n    /**\n     * A replacement API holder implementation to use.\n     *\n     * By default, a new API holder will be constructed automatically based on\n     * the other inputs. If you pass in a custom one here, none of that\n     * automation will take place - so you will have to take care to supply all\n     * those APIs yourself.\n     */\n    apis?: ApiHolder;\n\n    /**\n     * If set to true, the system will silently accept and move on if\n     * encountering config for extensions that do not exist. The default is to\n     * reject such config to help catch simple mistakes.\n     *\n     * This flag can be useful in some scenarios where you have a dynamic set of\n     * extensions enabled at different times, but also increases the risk of\n     * accidentally missing e.g. simple typos in your config.\n     */\n    allowUnknownExtensionConfig?: boolean;\n\n    /**\n     * Applies one or more middleware on every extension, as they are added to\n     * the application.\n     *\n     * This is an advanced use case for modifying extension data on the fly as\n     * it gets emitted by extensions being instantiated.\n     */\n    extensionFactoryMiddleware?:\n      | ExtensionFactoryMiddleware\n      | ExtensionFactoryMiddleware[];\n\n    /**\n     * Allows for customizing how plugin info is retrieved.\n     */\n    pluginInfoResolver?: FrontendPluginInfoResolver;\n  };\n};\n\n/**\n * Creates an empty app without any default features. This is a low-level API is\n * intended for use in tests or specialized setups. Typically you want to use\n * `createApp` from `@backstage/frontend-defaults` instead.\n *\n * @public\n */\nexport function createSpecializedApp(options?: CreateSpecializedAppOptions): {\n  apis: ApiHolder;\n  tree: AppTree;\n  errors?: AppError[];\n} {\n  const config = options?.config ?? new ConfigReader({}, 'empty-config');\n  const features = deduplicateFeatures(options?.features ?? []).map(\n    createPluginInfoAttacher(config, options?.advanced?.pluginInfoResolver),\n  );\n\n  const collector = createErrorCollector();\n\n  const tree = resolveAppTree(\n    'root',\n    resolveAppNodeSpecs({\n      features,\n      builtinExtensions: [\n        resolveExtensionDefinition(Root, { namespace: 'root' }),\n      ],\n      parameters: readAppExtensionsConfig(config),\n      forbidden: new Set(['root']),\n      collector,\n    }),\n    collector,\n  );\n\n  const factories = createApiFactories({ tree, collector });\n  const appBasePath = getBasePath(config);\n  const appTreeApi = new AppTreeApiProxy(tree, appBasePath);\n\n  const routeRefsById = collectRouteIds(features, collector);\n  const routeResolutionApi = new RouteResolutionApiProxy(\n    resolveRouteBindings(options?.bindRoutes, config, routeRefsById, collector),\n    appBasePath,\n  );\n\n  const appIdentityProxy = new AppIdentityProxy();\n  const apis =\n    options?.advanced?.apis ??\n    createApiHolder({\n      factories,\n      staticFactories: [\n        createApiFactory(appTreeApiRef, appTreeApi),\n        createApiFactory(configApiRef, config),\n        createApiFactory(routeResolutionApiRef, routeResolutionApi),\n        createApiFactory(identityApiRef, appIdentityProxy),\n      ],\n    });\n\n  const featureFlagApi = apis.get(featureFlagsApiRef);\n  if (featureFlagApi) {\n    for (const feature of features) {\n      if (OpaqueFrontendPlugin.isType(feature)) {\n        OpaqueFrontendPlugin.toInternal(feature).featureFlags.forEach(flag =>\n          featureFlagApi.registerFlag({\n            name: flag.name,\n            pluginId: feature.id,\n          }),\n        );\n      }\n      if (isInternalFrontendModule(feature)) {\n        toInternalFrontendModule(feature).featureFlags.forEach(flag =>\n          featureFlagApi.registerFlag({\n            name: flag.name,\n            pluginId: feature.pluginId,\n          }),\n        );\n      }\n    }\n  }\n\n  // Now instantiate the entire tree, which will skip anything that's already been instantiated\n  instantiateAppNodeTree(\n    tree.root,\n    apis,\n    collector,\n    mergeExtensionFactoryMiddleware(\n      options?.advanced?.extensionFactoryMiddleware,\n    ),\n  );\n\n  const routeInfo = extractRouteInfoFromAppNode(\n    tree.root,\n    createRouteAliasResolver(routeRefsById),\n  );\n\n  routeResolutionApi.initialize(routeInfo, routeRefsById.routes);\n  appTreeApi.initialize(routeInfo);\n\n  return { apis, tree, errors: collector.collectErrors() };\n}\n\nfunction createApiFactories(options: {\n  tree: AppTree;\n  collector: ErrorCollector;\n}): AnyApiFactory[] {\n  const emptyApiHolder = ApiRegistry.from([]);\n  const factories = new Array<AnyApiFactory>();\n\n  for (const apiNode of options.tree.root.edges.attachments.get('apis') ?? []) {\n    if (!instantiateAppNodeTree(apiNode, emptyApiHolder, options.collector)) {\n      continue;\n    }\n    const apiFactory = apiNode.instance?.getData(ApiBlueprint.dataRefs.factory);\n    if (apiFactory) {\n      factories.push(apiFactory);\n    } else {\n      options.collector.report({\n        code: 'API_EXTENSION_INVALID',\n        message: `API extension '${apiNode.spec.id}' did not output an API factory`,\n        context: {\n          node: apiNode,\n        },\n      });\n    }\n  }\n\n  return factories;\n}\n\nfunction createApiHolder(options: {\n  factories: AnyApiFactory[];\n  staticFactories: AnyApiFactory[];\n}): ApiHolder {\n  const factoryRegistry = new ApiFactoryRegistry();\n\n  for (const factory of options.factories.slice().reverse()) {\n    factoryRegistry.register('default', factory);\n  }\n\n  for (const factory of options.staticFactories) {\n    factoryRegistry.register('static', factory);\n  }\n\n  ApiResolver.validateFactories(factoryRegistry, factoryRegistry.getAllApis());\n\n  return new ApiResolver(factoryRegistry);\n}\n\nfunction mergeExtensionFactoryMiddleware(\n  middlewares?: ExtensionFactoryMiddleware | ExtensionFactoryMiddleware[],\n): ExtensionFactoryMiddleware | undefined {\n  if (!middlewares) {\n    return undefined;\n  }\n  if (!Array.isArray(middlewares)) {\n    return middlewares;\n  }\n  if (middlewares.length <= 1) {\n    return middlewares[0];\n  }\n  return middlewares.reduce((prev, next) => {\n    if (!prev || !next) {\n      return prev ?? next;\n    }\n    return (orig, ctx) => {\n      const internalExt = toInternalExtension(ctx.node.spec.extension);\n      if (internalExt.version !== 'v2') {\n        return orig();\n      }\n      return next(ctxOverrides => {\n        return createExtensionDataContainer(\n          prev(orig, {\n            node: ctx.node,\n            apis: ctx.apis,\n            config: ctxOverrides?.config ?? ctx.config,\n          }),\n          'extension factory middleware',\n        );\n      }, ctx);\n    };\n  });\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"createSpecializedApp.esm.js","sources":["../../src/wiring/createSpecializedApp.tsx"],"sourcesContent":["/*\n * Copyright 2023 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ConfigReader } from '@backstage/config';\nimport {\n  ApiBlueprint,\n  AppTree,\n  AppTreeApi,\n  appTreeApiRef,\n  RouteRef,\n  ExternalRouteRef,\n  SubRouteRef,\n  AnyRouteRefParams,\n  RouteFunc,\n  RouteResolutionApi,\n  createApiFactory,\n  routeResolutionApiRef,\n  AppNode,\n  ExtensionFactoryMiddleware,\n  FrontendFeature,\n} from '@backstage/frontend-plugin-api';\nimport {\n  AnyApiFactory,\n  ApiHolder,\n  ConfigApi,\n  configApiRef,\n  featureFlagsApiRef,\n  identityApiRef,\n} from '@backstage/core-plugin-api';\nimport { ApiFactoryRegistry, ApiResolver } from '@backstage/core-app-api';\nimport {\n  createExtensionDataContainer,\n  OpaqueFrontendPlugin,\n} from '@internal/frontend';\n\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport {\n  resolveExtensionDefinition,\n  toInternalExtension,\n} from '../../../frontend-plugin-api/src/wiring/resolveExtensionDefinition';\n\nimport {\n  extractRouteInfoFromAppNode,\n  RouteInfo,\n} from '../routing/extractRouteInfoFromAppNode';\n\nimport { CreateAppRouteBinder } from '../routing';\nimport { RouteResolver } from '../routing/RouteResolver';\nimport { resolveRouteBindings } from '../routing/resolveRouteBindings';\nimport { collectRouteIds } from '../routing/collectRouteIds';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport {\n  toInternalFrontendModule,\n  isInternalFrontendModule,\n} from '../../../frontend-plugin-api/src/wiring/createFrontendModule';\nimport { getBasePath } from '../routing/getBasePath';\nimport { Root } from '../extensions/Root';\nimport { resolveAppTree } from '../tree/resolveAppTree';\nimport { resolveAppNodeSpecs } from '../tree/resolveAppNodeSpecs';\nimport { readAppExtensionsConfig } from '../tree/readAppExtensionsConfig';\nimport { instantiateAppNodeTree } from '../tree/instantiateAppNodeTree';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { ApiRegistry } from '../../../core-app-api/src/apis/system/ApiRegistry';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { AppIdentityProxy } from '../../../core-app-api/src/apis/implementations/IdentityApi/AppIdentityProxy';\nimport { BackstageRouteObject } from '../routing/types';\nimport { matchRoutes } from 'react-router-dom';\nimport {\n  createPluginInfoAttacher,\n  FrontendPluginInfoResolver,\n} from './createPluginInfoAttacher';\nimport { createRouteAliasResolver } from '../routing/RouteAliasResolver';\nimport {\n  AppError,\n  createErrorCollector,\n  ErrorCollector,\n} from './createErrorCollector';\n\nfunction deduplicateFeatures(\n  allFeatures: FrontendFeature[],\n): FrontendFeature[] {\n  // Start by removing duplicates by reference\n  const features = Array.from(new Set(allFeatures));\n\n  // Plugins are deduplicated by ID, last one wins\n  const seenIds = new Set<string>();\n  return features\n    .reverse()\n    .filter(feature => {\n      if (!OpaqueFrontendPlugin.isType(feature)) {\n        return true;\n      }\n      if (seenIds.has(feature.id)) {\n        return false;\n      }\n      seenIds.add(feature.id);\n      return true;\n    })\n    .reverse();\n}\n\n// Helps delay callers from reaching out to the API before the app tree has been materialized\nclass AppTreeApiProxy implements AppTreeApi {\n  #routeInfo?: RouteInfo;\n  private readonly tree: AppTree;\n  private readonly appBasePath: string;\n\n  constructor(tree: AppTree, appBasePath: string) {\n    this.tree = tree;\n    this.appBasePath = appBasePath;\n  }\n\n  private checkIfInitialized() {\n    if (!this.#routeInfo) {\n      throw new Error(\n        `You can't access the AppTreeApi during initialization of the app tree. Please move occurrences of this out of the initialization of the factory`,\n      );\n    }\n  }\n\n  getTree() {\n    this.checkIfInitialized();\n\n    return { tree: this.tree };\n  }\n\n  getNodesByRoutePath(routePath: string): { nodes: AppNode[] } {\n    this.checkIfInitialized();\n\n    let path = routePath;\n    if (path.startsWith(this.appBasePath)) {\n      path = path.slice(this.appBasePath.length);\n    }\n\n    const matchedRoutes = matchRoutes(this.#routeInfo!.routeObjects, path);\n\n    const matchedAppNodes =\n      matchedRoutes\n        ?.filter(routeObj => !!routeObj.route.appNode)\n        .map(routeObj => routeObj.route.appNode!) || [];\n\n    return { nodes: matchedAppNodes };\n  }\n\n  initialize(routeInfo: RouteInfo) {\n    this.#routeInfo = routeInfo;\n  }\n}\n\n// Helps delay callers from reaching out to the API before the app tree has been materialized\nclass RouteResolutionApiProxy implements RouteResolutionApi {\n  #delegate: RouteResolutionApi | undefined;\n  #routeObjects: BackstageRouteObject[] | undefined;\n\n  private readonly routeBindings: Map<ExternalRouteRef, RouteRef | SubRouteRef>;\n  private readonly appBasePath: string;\n\n  constructor(\n    routeBindings: Map<ExternalRouteRef, RouteRef | SubRouteRef>,\n    appBasePath: string,\n  ) {\n    this.routeBindings = routeBindings;\n    this.appBasePath = appBasePath;\n  }\n\n  resolve<TParams extends AnyRouteRefParams>(\n    anyRouteRef:\n      | RouteRef<TParams>\n      | SubRouteRef<TParams>\n      | ExternalRouteRef<TParams>,\n    options?: { sourcePath?: string },\n  ): RouteFunc<TParams> | undefined {\n    if (!this.#delegate) {\n      throw new Error(\n        `You can't access the RouteResolver during initialization of the app tree. Please move occurrences of this out of the initialization of the factory`,\n      );\n    }\n\n    return this.#delegate.resolve(anyRouteRef, options);\n  }\n\n  initialize(\n    routeInfo: RouteInfo,\n    routeRefsById: Map<string, RouteRef | SubRouteRef>,\n  ) {\n    this.#delegate = new RouteResolver(\n      routeInfo.routePaths,\n      routeInfo.routeParents,\n      routeInfo.routeObjects,\n      this.routeBindings,\n      this.appBasePath,\n      routeInfo.routeAliasResolver,\n      routeRefsById,\n    );\n    this.#routeObjects = routeInfo.routeObjects;\n\n    return routeInfo;\n  }\n\n  getRouteObjects() {\n    return this.#routeObjects;\n  }\n}\n\n/**\n * Options for {@link createSpecializedApp}.\n *\n * @public\n */\nexport type CreateSpecializedAppOptions = {\n  /**\n   * The list of features to load.\n   */\n  features?: FrontendFeature[];\n\n  /**\n   * The config API implementation to use. For most normal apps, this should be\n   * specified.\n   *\n   * If none is given, a new _empty_ config will be used during startup. In\n   * later stages of the app lifecycle, the config API in the API holder will be\n   * used.\n   */\n  config?: ConfigApi;\n\n  /**\n   * Allows for the binding of plugins' external route refs within the app.\n   */\n  bindRoutes?(context: { bind: CreateAppRouteBinder }): void;\n\n  /**\n   * Advanced, more rarely used options.\n   */\n  advanced?: {\n    /**\n     * A replacement API holder implementation to use.\n     *\n     * By default, a new API holder will be constructed automatically based on\n     * the other inputs. If you pass in a custom one here, none of that\n     * automation will take place - so you will have to take care to supply all\n     * those APIs yourself.\n     */\n    apis?: ApiHolder;\n\n    /**\n     * If set to true, the system will silently accept and move on if\n     * encountering config for extensions that do not exist. The default is to\n     * reject such config to help catch simple mistakes.\n     *\n     * This flag can be useful in some scenarios where you have a dynamic set of\n     * extensions enabled at different times, but also increases the risk of\n     * accidentally missing e.g. simple typos in your config.\n     */\n    allowUnknownExtensionConfig?: boolean;\n\n    /**\n     * Applies one or more middleware on every extension, as they are added to\n     * the application.\n     *\n     * This is an advanced use case for modifying extension data on the fly as\n     * it gets emitted by extensions being instantiated.\n     */\n    extensionFactoryMiddleware?:\n      | ExtensionFactoryMiddleware\n      | ExtensionFactoryMiddleware[];\n\n    /**\n     * Allows for customizing how plugin info is retrieved.\n     */\n    pluginInfoResolver?: FrontendPluginInfoResolver;\n  };\n};\n\n/**\n * Creates an empty app without any default features. This is a low-level API is\n * intended for use in tests or specialized setups. Typically you want to use\n * `createApp` from `@backstage/frontend-defaults` instead.\n *\n * @public\n */\nexport function createSpecializedApp(options?: CreateSpecializedAppOptions): {\n  apis: ApiHolder;\n  tree: AppTree;\n  errors?: AppError[];\n} {\n  const config = options?.config ?? new ConfigReader({}, 'empty-config');\n  const features = deduplicateFeatures(options?.features ?? []).map(\n    createPluginInfoAttacher(config, options?.advanced?.pluginInfoResolver),\n  );\n\n  const collector = createErrorCollector();\n\n  const tree = resolveAppTree(\n    'root',\n    resolveAppNodeSpecs({\n      features,\n      builtinExtensions: [\n        resolveExtensionDefinition(Root, { namespace: 'root' }),\n      ],\n      parameters: readAppExtensionsConfig(config),\n      forbidden: new Set(['root']),\n      collector,\n    }),\n    collector,\n  );\n\n  const factories = createApiFactories({ tree, collector });\n  const appBasePath = getBasePath(config);\n  const appTreeApi = new AppTreeApiProxy(tree, appBasePath);\n\n  const routeRefsById = collectRouteIds(features, collector);\n  const routeResolutionApi = new RouteResolutionApiProxy(\n    resolveRouteBindings(options?.bindRoutes, config, routeRefsById, collector),\n    appBasePath,\n  );\n\n  const appIdentityProxy = new AppIdentityProxy();\n  const apis =\n    options?.advanced?.apis ??\n    createApiHolder({\n      factories,\n      staticFactories: [\n        createApiFactory(appTreeApiRef, appTreeApi),\n        createApiFactory(configApiRef, config),\n        createApiFactory(routeResolutionApiRef, routeResolutionApi),\n        createApiFactory(identityApiRef, appIdentityProxy),\n      ],\n    });\n\n  const featureFlagApi = apis.get(featureFlagsApiRef);\n  if (featureFlagApi) {\n    for (const feature of features) {\n      if (OpaqueFrontendPlugin.isType(feature)) {\n        OpaqueFrontendPlugin.toInternal(feature).featureFlags.forEach(flag =>\n          featureFlagApi.registerFlag({\n            name: flag.name,\n            pluginId: feature.id,\n          }),\n        );\n      }\n      if (isInternalFrontendModule(feature)) {\n        toInternalFrontendModule(feature).featureFlags.forEach(flag =>\n          featureFlagApi.registerFlag({\n            name: flag.name,\n            pluginId: feature.pluginId,\n          }),\n        );\n      }\n    }\n  }\n\n  // Now instantiate the entire tree, which will skip anything that's already been instantiated\n  instantiateAppNodeTree(\n    tree.root,\n    apis,\n    collector,\n    mergeExtensionFactoryMiddleware(\n      options?.advanced?.extensionFactoryMiddleware,\n    ),\n  );\n\n  const routeInfo = extractRouteInfoFromAppNode(\n    tree.root,\n    createRouteAliasResolver(routeRefsById),\n  );\n\n  routeResolutionApi.initialize(routeInfo, routeRefsById.routes);\n  appTreeApi.initialize(routeInfo);\n\n  return { apis, tree, errors: collector.collectErrors() };\n}\n\nfunction createApiFactories(options: {\n  tree: AppTree;\n  collector: ErrorCollector;\n}): AnyApiFactory[] {\n  const emptyApiHolder = ApiRegistry.from([]);\n  const factoriesById = new Map<\n    string,\n    { pluginId: string; factory: AnyApiFactory }\n  >();\n\n  for (const apiNode of options.tree.root.edges.attachments.get('apis') ?? []) {\n    if (!instantiateAppNodeTree(apiNode, emptyApiHolder, options.collector)) {\n      continue;\n    }\n    const apiFactory = apiNode.instance?.getData(ApiBlueprint.dataRefs.factory);\n    if (apiFactory) {\n      const apiRefId = apiFactory.api.id;\n      const ownerId = getApiOwnerId(apiRefId);\n      const pluginId = apiNode.spec.plugin.id ?? 'app';\n      const existingFactory = factoriesById.get(apiRefId);\n\n      // This allows modules to override factories provided by the plugin, but\n      // it rejects API overrides from other plugins. In the event of a\n      // conflict, the owning plugin is attempted to be inferred from the API\n      // reference ID.\n      if (existingFactory && existingFactory.pluginId !== pluginId) {\n        const shouldReplace =\n          ownerId === pluginId && existingFactory.pluginId !== ownerId;\n        const acceptedPluginId = shouldReplace\n          ? pluginId\n          : existingFactory.pluginId;\n        const rejectedPluginId = shouldReplace\n          ? existingFactory.pluginId\n          : pluginId;\n\n        options.collector.report({\n          code: 'API_FACTORY_CONFLICT',\n          message: `API '${apiRefId}' is already provided by plugin '${acceptedPluginId}', cannot also be provided by '${rejectedPluginId}'.`,\n          context: {\n            node: apiNode,\n            apiRefId,\n            pluginId: rejectedPluginId,\n            existingPluginId: acceptedPluginId,\n          },\n        });\n        if (shouldReplace) {\n          factoriesById.set(apiRefId, {\n            pluginId,\n            factory: apiFactory,\n          });\n        }\n        continue;\n      }\n\n      factoriesById.set(apiRefId, { pluginId, factory: apiFactory });\n    } else {\n      options.collector.report({\n        code: 'API_EXTENSION_INVALID',\n        message: `API extension '${apiNode.spec.id}' did not output an API factory`,\n        context: {\n          node: apiNode,\n        },\n      });\n    }\n  }\n\n  return Array.from(factoriesById.values(), entry => entry.factory);\n}\n\n// TODO(Rugvip): It would be good if this was more explicit, but I think that\n//               might need to wait for some future update for API factories.\nfunction getApiOwnerId(apiRefId: string): string {\n  const [prefix, ...rest] = apiRefId.split('.');\n  if (!prefix) {\n    return apiRefId;\n  }\n  if (prefix === 'core') {\n    return 'app';\n  }\n  if (prefix === 'plugin' && rest[0]) {\n    return rest[0];\n  }\n  return prefix;\n}\n\nfunction createApiHolder(options: {\n  factories: AnyApiFactory[];\n  staticFactories: AnyApiFactory[];\n}): ApiHolder {\n  const factoryRegistry = new ApiFactoryRegistry();\n\n  for (const factory of options.factories.slice().reverse()) {\n    factoryRegistry.register('default', factory);\n  }\n\n  for (const factory of options.staticFactories) {\n    factoryRegistry.register('static', factory);\n  }\n\n  ApiResolver.validateFactories(factoryRegistry, factoryRegistry.getAllApis());\n\n  return new ApiResolver(factoryRegistry);\n}\n\nfunction mergeExtensionFactoryMiddleware(\n  middlewares?: ExtensionFactoryMiddleware | ExtensionFactoryMiddleware[],\n): ExtensionFactoryMiddleware | undefined {\n  if (!middlewares) {\n    return undefined;\n  }\n  if (!Array.isArray(middlewares)) {\n    return middlewares;\n  }\n  if (middlewares.length <= 1) {\n    return middlewares[0];\n  }\n  return middlewares.reduce((prev, next) => {\n    if (!prev || !next) {\n      return prev ?? next;\n    }\n    return (orig, ctx) => {\n      const internalExt = toInternalExtension(ctx.node.spec.extension);\n      if (internalExt.version !== 'v2') {\n        return orig();\n      }\n      return next(ctxOverrides => {\n        return createExtensionDataContainer(\n          prev(orig, {\n            node: ctx.node,\n            apis: ctx.apis,\n            config: ctxOverrides?.config ?? ctx.config,\n          }),\n          'extension factory middleware',\n        );\n      }, ctx);\n    };\n  });\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/frontend-app-api",
-  "version": "0.13.3",
+  "version": "0.14.0",
   "backstage": {
     "role": "web-library"
   },
@@ -36,17 +36,17 @@
     "@backstage/core-app-api": "^1.19.3",
     "@backstage/core-plugin-api": "^1.12.1",
     "@backstage/errors": "^1.2.7",
-    "@backstage/frontend-defaults": "^0.3.4",
-    "@backstage/frontend-plugin-api": "^0.13.2",
+    "@backstage/frontend-defaults": "^0.3.5",
+    "@backstage/frontend-plugin-api": "^0.13.3",
     "@backstage/types": "^1.2.2",
     "@backstage/version-bridge": "^1.0.11",
     "lodash": "^4.17.21",
     "zod": "^3.22.4"
   },
   "devDependencies": {
-    "@backstage/cli": "^0.35.0",
-    "@backstage/frontend-test-utils": "^0.4.2",
-    "@backstage/plugin-app": "^0.3.3",
+    "@backstage/cli": "^0.35.2",
+    "@backstage/frontend-test-utils": "^0.4.3",
+    "@backstage/plugin-app": "^0.3.4",
     "@backstage/test-utils": "^1.7.14",
     "@testing-library/jest-dom": "^6.0.0",
     "@testing-library/react": "^16.0.0",