@backstage/frontend-app-api 0.16.2 → 0.16.3-next.1

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @backstage/frontend-app-api
 
+## 0.16.3-next.1
+
+### Patch Changes
+
+- b6ca666: Invalid feature flag declarations no longer crash the app during bootstrap. They are now reported through the error collector and skipped, letting the rest of the app load normally.
+- Updated dependencies
+  - @backstage/frontend-defaults@0.5.2-next.1
+  - @backstage/frontend-plugin-api@0.17.0-next.1
+  - @backstage/core-plugin-api@1.12.6-next.1
+
+## 0.16.3-next.0
+
+### Patch Changes
+
+- f79eaf2: Internal cleanup of routing utilities.
+- Updated dependencies
+  - @backstage/errors@1.3.1-next.0
+  - @backstage/frontend-plugin-api@0.17.0-next.0
+  - @backstage/frontend-defaults@0.5.2-next.0
+  - @backstage/core-app-api@1.20.1-next.0
+  - @backstage/config@1.3.8-next.0
+  - @backstage/core-plugin-api@1.12.6-next.0
+  - @backstage/filter-predicates@0.1.3-next.0
+  - @backstage/types@1.2.2
+  - @backstage/version-bridge@1.0.12
+
 ## 0.16.2
 
 ### Patch Changes

package/dist/index.d.ts

@@ -176,6 +176,13 @@ type AppErrorTypes = {
             bootstrapPluginId: string;
         };
     };
+    FEATURE_FLAG_INVALID: {
+        context: {
+            pluginId: string;
+            flagName: string;
+            error: Error;
+        };
+    };
     ROUTE_DUPLICATE: {
         context: {
             routeId: string;

package/dist/routing/RouteResolver.esm.js

@@ -1,16 +1,10 @@
 import { generatePath, matchRoutes } from 'react-router-dom';
 import mapValues from 'lodash/mapValues';
+import { joinPaths } from './joinPaths.esm.js';
 import { OpaqueExternalRouteRef } from '../frontend-internal/src/routing/OpaqueExternalRouteRef.esm.js';
 import { OpaqueRouteRef } from '../frontend-internal/src/routing/OpaqueRouteRef.esm.js';
 import { OpaqueSubRouteRef } from '../frontend-internal/src/routing/OpaqueSubRouteRef.esm.js';
 
-function joinPaths(...paths) {
-  const normalized = paths.join("/").replace(/\/\/+/g, "/");
-  if (normalized !== "/" && normalized.endsWith("/")) {
-    return normalized.slice(0, -1);
-  }
-  return normalized;
-}
 function resolveTargetRef(targetRouteRef, routePaths, routeBindings, routeRefsById) {
   let ref = targetRouteRef;
   let path = "";
@@ -133,5 +127,5 @@ class RouteResolver {
   }
 }
 
-export { RouteResolver, joinPaths };
+export { RouteResolver };
 //# sourceMappingURL=RouteResolver.esm.js.map

package/dist/routing/RouteResolver.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"RouteResolver.esm.js","sources":["../../src/routing/RouteResolver.ts"],"sourcesContent":["/*\n * Copyright 2020 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 { generatePath, matchRoutes } from 'react-router-dom';\nimport {\n  RouteRef,\n  ExternalRouteRef,\n  SubRouteRef,\n  AnyRouteRefParams,\n  RouteFunc,\n  RouteResolutionApi,\n} from '@backstage/frontend-plugin-api';\nimport mapValues from 'lodash/mapValues';\nimport { AnyRouteRef, BackstageRouteObject } from './types';\nimport {\n  OpaqueRouteRef,\n  OpaqueExternalRouteRef,\n  OpaqueSubRouteRef,\n} from '@internal/frontend';\nimport { RouteAliasResolver } from './RouteAliasResolver';\n\n// Joins a list of paths together, avoiding trailing and duplicate slashes\nexport function joinPaths(...paths: string[]): string {\n  const normalized = paths.join('/').replace(/\\/\\/+/g, '/');\n  if (normalized !== '/' && normalized.endsWith('/')) {\n    return normalized.slice(0, -1);\n  }\n  return normalized;\n}\n\n/**\n * Resolves the absolute route ref that our target route ref is pointing pointing to, as well\n * as the relative target path.\n *\n * Returns an undefined target ref if one could not be fully resolved.\n */\nfunction resolveTargetRef(\n  targetRouteRef: AnyRouteRef,\n  routePaths: Map<RouteRef, string>,\n  routeBindings: Map<AnyRouteRef, AnyRouteRef | undefined>,\n  routeRefsById: Map<string, RouteRef | SubRouteRef>,\n): readonly [RouteRef | undefined, string] {\n  // First we figure out which absolute route ref we're dealing with, an if there was an sub route path to append.\n  // For sub routes it will be the parent path, while for external routes it will be the bound route.\n  let ref: AnyRouteRef = targetRouteRef;\n  let path = '';\n\n  if (OpaqueExternalRouteRef.isType(ref)) {\n    let resolvedRoute = routeBindings.get(ref);\n    if (!resolvedRoute) {\n      const internal = OpaqueExternalRouteRef.toInternal(ref);\n      const defaultTarget = internal.getDefaultTarget();\n      if (defaultTarget) {\n        resolvedRoute = routeRefsById.get(defaultTarget);\n      }\n    }\n    if (!resolvedRoute) {\n      return [undefined, ''];\n    }\n    ref = resolvedRoute;\n  }\n\n  if (OpaqueSubRouteRef.isType(ref)) {\n    const internal = OpaqueSubRouteRef.toInternal(ref);\n    path = ref.path;\n    ref = internal.getParent();\n  }\n\n  if (!OpaqueRouteRef.isType(ref)) {\n    throw new Error(\n      `Unexpectedly resolved ${targetRouteRef} to a non-route ref ${ref}`,\n    );\n  }\n\n  // Find the path that our target route is bound to\n  const resolvedPath = routePaths.get(ref);\n  if (resolvedPath === undefined) {\n    return [undefined, ''];\n  }\n\n  return [ref, path ? joinPaths(resolvedPath, path) : resolvedPath];\n}\n\n/**\n * Resolves the complete base path for navigating to the target RouteRef.\n */\nfunction resolveBasePath(\n  targetRef: RouteRef,\n  sourceLocation: Parameters<typeof matchRoutes>[1],\n  routePaths: Map<RouteRef, string>,\n  routeParents: Map<RouteRef, RouteRef | undefined>,\n  routeObjects: BackstageRouteObject[],\n) {\n  // While traversing the app element tree we build up the routeObjects structure\n  // used here. It is the same kind of structure that react-router creates, with the\n  // addition that associated route refs are stored throughout the tree. This lets\n  // us look up all route refs that can be reached from our source location.\n  // Because of the similar route object structure, we can use `matchRoutes` from\n  // react-router to do the lookup of our current location.\n  const match = matchRoutes(routeObjects, sourceLocation) ?? [];\n\n  // While we search for a common routing root between our current location and\n  // the target route, we build a list of all route refs we find that we need\n  // to traverse to reach the target.\n  const refDiffList = Array<RouteRef>();\n\n  let matchIndex = -1;\n  for (\n    let targetSearchRef: RouteRef | undefined = targetRef;\n    targetSearchRef;\n    targetSearchRef = routeParents.get(targetSearchRef)\n  ) {\n    // The match contains a list of all ancestral route refs present at our current location\n    // Starting at the desired target ref and traversing back through its parents, we search\n    // for a target ref that is present in the match for our current location. When a match\n    // is found it means we have found a common base to resolve the route from.\n    matchIndex = match.findIndex(m =>\n      (m.route as BackstageRouteObject).routeRefs.has(targetSearchRef!),\n    );\n    if (matchIndex !== -1) {\n      break;\n    }\n\n    // Every time we move a step up in the ancestry of the target ref, we add the current ref\n    // to the diff list, which ends up being the list of route refs to traverse form the common base\n    // in order to reach our target.\n    refDiffList.unshift(targetSearchRef);\n  }\n\n  // If our target route is present in the initial match we need to construct the final path\n  // from the parent of the matched route segment. That's to allow the caller of the route\n  // function to supply their own params.\n  if (refDiffList.length === 0) {\n    matchIndex -= 1;\n  }\n\n  // This is the part of the route tree that the target and source locations have in common.\n  // We re-use the existing pathname directly along with all params.\n  const parentPath = matchIndex === -1 ? '' : match[matchIndex].pathname;\n\n  // This constructs the mid section of the path using paths resolved from all route refs\n  // we need to traverse to reach our target except for the very last one. None of these\n  // paths are allowed to require any parameters, as the caller would have no way of knowing\n  // what parameters those are.\n  const diffPaths = refDiffList.slice(0, -1).map(ref => {\n    const path = routePaths.get(ref);\n    if (path === undefined) {\n      throw new Error(`No path for ${ref}`);\n    }\n    if (path.includes(':')) {\n      throw new Error(\n        `Cannot route to ${targetRef} with parent ${ref} as it has parameters`,\n      );\n    }\n    return path;\n  });\n\n  return `${joinPaths(parentPath, ...diffPaths)}/`;\n}\n\nexport class RouteResolver implements RouteResolutionApi {\n  private readonly routePaths: Map<RouteRef, string>;\n  private readonly routeParents: Map<RouteRef, RouteRef | undefined>;\n  private readonly routeObjects: BackstageRouteObject[];\n  private readonly routeBindings: Map<ExternalRouteRef, RouteRef | SubRouteRef>;\n  private readonly appBasePath: string; // base path without a trailing slash\n  private readonly routeAliasResolver: RouteAliasResolver;\n  private readonly routeRefsById: Map<string, RouteRef | SubRouteRef>;\n\n  constructor(\n    routePaths: Map<RouteRef, string>,\n    routeParents: Map<RouteRef, RouteRef | undefined>,\n    routeObjects: BackstageRouteObject[],\n    routeBindings: Map<ExternalRouteRef, RouteRef | SubRouteRef>,\n    appBasePath: string, // base path without a trailing slash\n    routeAliasResolver: RouteAliasResolver,\n    routeRefsById: Map<string, RouteRef | SubRouteRef>,\n  ) {\n    this.routePaths = routePaths;\n    this.routeParents = routeParents;\n    this.routeObjects = routeObjects;\n    this.routeBindings = routeBindings;\n    this.appBasePath = appBasePath;\n    this.routeAliasResolver = routeAliasResolver;\n    this.routeRefsById = routeRefsById;\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    // First figure out what our target absolute ref is, as well as our target path.\n    const [targetRef, targetPath] = resolveTargetRef(\n      anyRouteRef?.$$type === '@backstage/RouteRef'\n        ? this.routeAliasResolver(anyRouteRef)\n        : anyRouteRef,\n      this.routePaths,\n      this.routeBindings,\n      this.routeRefsById,\n    );\n    if (!targetRef) {\n      return undefined;\n    }\n\n    // The location that we get passed in uses the full path, so start by trimming off\n    // the app base path prefix in case we're running the app on a sub-path.\n    const relativeSourceLocation = this.trimPath(options?.sourcePath ?? '');\n\n    // Next we figure out the base path, which is the combination of the common parent path\n    // between our current location and our target location, as well as the additional path\n    // that is the difference between the parent path and the base of our target location.\n    const basePath = resolveBasePath(\n      targetRef,\n      relativeSourceLocation,\n      this.routePaths,\n      this.routeParents,\n      this.routeObjects,\n    );\n\n    const routeFunc: RouteFunc<TParams> = (...[params]) => {\n      // We selectively encode some some known-dangerous characters in the\n      // params. The reason that we don't perform a blanket `encodeURIComponent`\n      // here is that this encoding was added defensively long after the initial\n      // release of this code. There's likely to be many users of this code that\n      // already encode their parameters knowing that this code didn't do this\n      // for them in the past. Therefore, we are extra careful NOT to include\n      // the percent character in this set, even though that might seem like a\n      // bad idea.\n      const encodedParams =\n        params &&\n        mapValues(params, value => {\n          if (typeof value === 'string') {\n            return value.replaceAll(/[&?#;\\/]/g, c => encodeURIComponent(c));\n          }\n          return value;\n        });\n      return joinPaths(basePath, generatePath(targetPath, encodedParams));\n    };\n    return routeFunc;\n  }\n\n  private trimPath(targetPath: string) {\n    if (!targetPath) {\n      return targetPath;\n    }\n\n    if (targetPath.startsWith(this.appBasePath)) {\n      return targetPath.slice(this.appBasePath.length);\n    }\n    return targetPath;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"RouteResolver.esm.js","sources":["../../src/routing/RouteResolver.ts"],"sourcesContent":["/*\n * Copyright 2020 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 { generatePath, matchRoutes } from 'react-router-dom';\nimport {\n  RouteRef,\n  ExternalRouteRef,\n  SubRouteRef,\n  AnyRouteRefParams,\n  RouteFunc,\n  RouteResolutionApi,\n} from '@backstage/frontend-plugin-api';\nimport mapValues from 'lodash/mapValues';\nimport { AnyRouteRef, BackstageRouteObject } from './types';\nimport {\n  OpaqueRouteRef,\n  OpaqueExternalRouteRef,\n  OpaqueSubRouteRef,\n} from '@internal/frontend';\nimport { RouteAliasResolver } from './RouteAliasResolver';\nimport { joinPaths } from './joinPaths';\n\n/**\n * Resolves the absolute route ref that our target route ref is pointing pointing to, as well\n * as the relative target path.\n *\n * Returns an undefined target ref if one could not be fully resolved.\n */\nfunction resolveTargetRef(\n  targetRouteRef: AnyRouteRef,\n  routePaths: Map<RouteRef, string>,\n  routeBindings: Map<AnyRouteRef, AnyRouteRef | undefined>,\n  routeRefsById: Map<string, RouteRef | SubRouteRef>,\n): readonly [RouteRef | undefined, string] {\n  // First we figure out which absolute route ref we're dealing with, an if there was an sub route path to append.\n  // For sub routes it will be the parent path, while for external routes it will be the bound route.\n  let ref: AnyRouteRef = targetRouteRef;\n  let path = '';\n\n  if (OpaqueExternalRouteRef.isType(ref)) {\n    let resolvedRoute = routeBindings.get(ref);\n    if (!resolvedRoute) {\n      const internal = OpaqueExternalRouteRef.toInternal(ref);\n      const defaultTarget = internal.getDefaultTarget();\n      if (defaultTarget) {\n        resolvedRoute = routeRefsById.get(defaultTarget);\n      }\n    }\n    if (!resolvedRoute) {\n      return [undefined, ''];\n    }\n    ref = resolvedRoute;\n  }\n\n  if (OpaqueSubRouteRef.isType(ref)) {\n    const internal = OpaqueSubRouteRef.toInternal(ref);\n    path = ref.path;\n    ref = internal.getParent();\n  }\n\n  if (!OpaqueRouteRef.isType(ref)) {\n    throw new Error(\n      `Unexpectedly resolved ${targetRouteRef} to a non-route ref ${ref}`,\n    );\n  }\n\n  // Find the path that our target route is bound to\n  const resolvedPath = routePaths.get(ref);\n  if (resolvedPath === undefined) {\n    return [undefined, ''];\n  }\n\n  return [ref, path ? joinPaths(resolvedPath, path) : resolvedPath];\n}\n\n/**\n * Resolves the complete base path for navigating to the target RouteRef.\n */\nfunction resolveBasePath(\n  targetRef: RouteRef,\n  sourceLocation: Parameters<typeof matchRoutes>[1],\n  routePaths: Map<RouteRef, string>,\n  routeParents: Map<RouteRef, RouteRef | undefined>,\n  routeObjects: BackstageRouteObject[],\n) {\n  // While traversing the app element tree we build up the routeObjects structure\n  // used here. It is the same kind of structure that react-router creates, with the\n  // addition that associated route refs are stored throughout the tree. This lets\n  // us look up all route refs that can be reached from our source location.\n  // Because of the similar route object structure, we can use `matchRoutes` from\n  // react-router to do the lookup of our current location.\n  const match = matchRoutes(routeObjects, sourceLocation) ?? [];\n\n  // While we search for a common routing root between our current location and\n  // the target route, we build a list of all route refs we find that we need\n  // to traverse to reach the target.\n  const refDiffList = Array<RouteRef>();\n\n  let matchIndex = -1;\n  for (\n    let targetSearchRef: RouteRef | undefined = targetRef;\n    targetSearchRef;\n    targetSearchRef = routeParents.get(targetSearchRef)\n  ) {\n    // The match contains a list of all ancestral route refs present at our current location\n    // Starting at the desired target ref and traversing back through its parents, we search\n    // for a target ref that is present in the match for our current location. When a match\n    // is found it means we have found a common base to resolve the route from.\n    matchIndex = match.findIndex(m =>\n      (m.route as BackstageRouteObject).routeRefs.has(targetSearchRef!),\n    );\n    if (matchIndex !== -1) {\n      break;\n    }\n\n    // Every time we move a step up in the ancestry of the target ref, we add the current ref\n    // to the diff list, which ends up being the list of route refs to traverse form the common base\n    // in order to reach our target.\n    refDiffList.unshift(targetSearchRef);\n  }\n\n  // If our target route is present in the initial match we need to construct the final path\n  // from the parent of the matched route segment. That's to allow the caller of the route\n  // function to supply their own params.\n  if (refDiffList.length === 0) {\n    matchIndex -= 1;\n  }\n\n  // This is the part of the route tree that the target and source locations have in common.\n  // We re-use the existing pathname directly along with all params.\n  const parentPath = matchIndex === -1 ? '' : match[matchIndex].pathname;\n\n  // This constructs the mid section of the path using paths resolved from all route refs\n  // we need to traverse to reach our target except for the very last one. None of these\n  // paths are allowed to require any parameters, as the caller would have no way of knowing\n  // what parameters those are.\n  const diffPaths = refDiffList.slice(0, -1).map(ref => {\n    const path = routePaths.get(ref);\n    if (path === undefined) {\n      throw new Error(`No path for ${ref}`);\n    }\n    if (path.includes(':')) {\n      throw new Error(\n        `Cannot route to ${targetRef} with parent ${ref} as it has parameters`,\n      );\n    }\n    return path;\n  });\n\n  return `${joinPaths(parentPath, ...diffPaths)}/`;\n}\n\nexport class RouteResolver implements RouteResolutionApi {\n  private readonly routePaths: Map<RouteRef, string>;\n  private readonly routeParents: Map<RouteRef, RouteRef | undefined>;\n  private readonly routeObjects: BackstageRouteObject[];\n  private readonly routeBindings: Map<ExternalRouteRef, RouteRef | SubRouteRef>;\n  private readonly appBasePath: string; // base path without a trailing slash\n  private readonly routeAliasResolver: RouteAliasResolver;\n  private readonly routeRefsById: Map<string, RouteRef | SubRouteRef>;\n\n  constructor(\n    routePaths: Map<RouteRef, string>,\n    routeParents: Map<RouteRef, RouteRef | undefined>,\n    routeObjects: BackstageRouteObject[],\n    routeBindings: Map<ExternalRouteRef, RouteRef | SubRouteRef>,\n    appBasePath: string, // base path without a trailing slash\n    routeAliasResolver: RouteAliasResolver,\n    routeRefsById: Map<string, RouteRef | SubRouteRef>,\n  ) {\n    this.routePaths = routePaths;\n    this.routeParents = routeParents;\n    this.routeObjects = routeObjects;\n    this.routeBindings = routeBindings;\n    this.appBasePath = appBasePath;\n    this.routeAliasResolver = routeAliasResolver;\n    this.routeRefsById = routeRefsById;\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    // First figure out what our target absolute ref is, as well as our target path.\n    const [targetRef, targetPath] = resolveTargetRef(\n      anyRouteRef?.$$type === '@backstage/RouteRef'\n        ? this.routeAliasResolver(anyRouteRef)\n        : anyRouteRef,\n      this.routePaths,\n      this.routeBindings,\n      this.routeRefsById,\n    );\n    if (!targetRef) {\n      return undefined;\n    }\n\n    // The location that we get passed in uses the full path, so start by trimming off\n    // the app base path prefix in case we're running the app on a sub-path.\n    const relativeSourceLocation = this.trimPath(options?.sourcePath ?? '');\n\n    // Next we figure out the base path, which is the combination of the common parent path\n    // between our current location and our target location, as well as the additional path\n    // that is the difference between the parent path and the base of our target location.\n    const basePath = resolveBasePath(\n      targetRef,\n      relativeSourceLocation,\n      this.routePaths,\n      this.routeParents,\n      this.routeObjects,\n    );\n\n    const routeFunc: RouteFunc<TParams> = (...[params]) => {\n      // We selectively encode some some known-dangerous characters in the\n      // params. The reason that we don't perform a blanket `encodeURIComponent`\n      // here is that this encoding was added defensively long after the initial\n      // release of this code. There's likely to be many users of this code that\n      // already encode their parameters knowing that this code didn't do this\n      // for them in the past. Therefore, we are extra careful NOT to include\n      // the percent character in this set, even though that might seem like a\n      // bad idea.\n      const encodedParams =\n        params &&\n        mapValues(params, value => {\n          if (typeof value === 'string') {\n            return value.replaceAll(/[&?#;\\/]/g, c => encodeURIComponent(c));\n          }\n          return value;\n        });\n      return joinPaths(basePath, generatePath(targetPath, encodedParams));\n    };\n    return routeFunc;\n  }\n\n  private trimPath(targetPath: string) {\n    if (!targetPath) {\n      return targetPath;\n    }\n\n    if (targetPath.startsWith(this.appBasePath)) {\n      return targetPath.slice(this.appBasePath.length);\n    }\n    return targetPath;\n  }\n}\n"],"names":[],"mappings":";;;;;;;AAyCA,SAAS,gBAAA,CACP,cAAA,EACA,UAAA,EACA,aAAA,EACA,aAAA,EACyC;AAGzC,EAAA,IAAI,GAAA,GAAmB,cAAA;AACvB,EAAA,IAAI,IAAA,GAAO,EAAA;AAEX,EAAA,IAAI,sBAAA,CAAuB,MAAA,CAAO,GAAG,CAAA,EAAG;AACtC,IAAA,IAAI,aAAA,GAAgB,aAAA,CAAc,GAAA,CAAI,GAAG,CAAA;AACzC,IAAA,IAAI,CAAC,aAAA,EAAe;AAClB,MAAA,MAAM,QAAA,GAAW,sBAAA,CAAuB,UAAA,CAAW,GAAG,CAAA;AACtD,MAAA,MAAM,aAAA,GAAgB,SAAS,gBAAA,EAAiB;AAChD,MAAA,IAAI,aAAA,EAAe;AACjB,QAAA,aAAA,GAAgB,aAAA,CAAc,IAAI,aAAa,CAAA;AAAA,MACjD;AAAA,IACF;AACA,IAAA,IAAI,CAAC,aAAA,EAAe;AAClB,MAAA,OAAO,CAAC,QAAW,EAAE,CAAA;AAAA,IACvB;AACA,IAAA,GAAA,GAAM,aAAA;AAAA,EACR;AAEA,EAAA,IAAI,iBAAA,CAAkB,MAAA,CAAO,GAAG,CAAA,EAAG;AACjC,IAAA,MAAM,QAAA,GAAW,iBAAA,CAAkB,UAAA,CAAW,GAAG,CAAA;AACjD,IAAA,IAAA,GAAO,GAAA,CAAI,IAAA;AACX,IAAA,GAAA,GAAM,SAAS,SAAA,EAAU;AAAA,EAC3B;AAEA,EAAA,IAAI,CAAC,cAAA,CAAe,MAAA,CAAO,GAAG,CAAA,EAAG;AAC/B,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,sBAAA,EAAyB,cAAc,CAAA,oBAAA,EAAuB,GAAG,CAAA;AAAA,KACnE;AAAA,EACF;AAGA,EAAA,MAAM,YAAA,GAAe,UAAA,CAAW,GAAA,CAAI,GAAG,CAAA;AACvC,EAAA,IAAI,iBAAiB,MAAA,EAAW;AAC9B,IAAA,OAAO,CAAC,QAAW,EAAE,CAAA;AAAA,EACvB;AAEA,EAAA,OAAO,CAAC,GAAA,EAAK,IAAA,GAAO,UAAU,YAAA,EAAc,IAAI,IAAI,YAAY,CAAA;AAClE;AAKA,SAAS,eAAA,CACP,SAAA,EACA,cAAA,EACA,UAAA,EACA,cACA,YAAA,EACA;AAOA,EAAA,MAAM,KAAA,GAAQ,WAAA,CAAY,YAAA,EAAc,cAAc,KAAK,EAAC;AAK5D,EAAA,MAAM,cAAc,KAAA,EAAgB;AAEpC,EAAA,IAAI,UAAA,GAAa,EAAA;AACjB,EAAA,KAAA,IACM,kBAAwC,SAAA,EAC5C,eAAA,EACA,kBAAkB,YAAA,CAAa,GAAA,CAAI,eAAe,CAAA,EAClD;AAKA,IAAA,UAAA,GAAa,KAAA,CAAM,SAAA;AAAA,MAAU,CAAA,CAAA,KAC1B,CAAA,CAAE,KAAA,CAA+B,SAAA,CAAU,IAAI,eAAgB;AAAA,KAClE;AACA,IAAA,IAAI,eAAe,EAAA,EAAI;AACrB,MAAA;AAAA,IACF;AAKA,IAAA,WAAA,CAAY,QAAQ,eAAe,CAAA;AAAA,EACrC;AAKA,EAAA,IAAI,WAAA,CAAY,WAAW,CAAA,EAAG;AAC5B,IAAA,UAAA,IAAc,CAAA;AAAA,EAChB;AAIA,EAAA,MAAM,aAAa,UAAA,KAAe,EAAA,GAAK,EAAA,GAAK,KAAA,CAAM,UAAU,CAAA,CAAE,QAAA;AAM9D,EAAA,MAAM,YAAY,WAAA,CAAY,KAAA,CAAM,GAAG,EAAE,CAAA,CAAE,IAAI,CAAA,GAAA,KAAO;AACpD,IAAA,MAAM,IAAA,GAAO,UAAA,CAAW,GAAA,CAAI,GAAG,CAAA;AAC/B,IAAA,IAAI,SAAS,MAAA,EAAW;AACtB,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,YAAA,EAAe,GAAG,CAAA,CAAE,CAAA;AAAA,IACtC;AACA,IAAA,IAAI,IAAA,CAAK,QAAA,CAAS,GAAG,CAAA,EAAG;AACtB,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,CAAA,gBAAA,EAAmB,SAAS,CAAA,aAAA,EAAgB,GAAG,CAAA,qBAAA;AAAA,OACjD;AAAA,IACF;AACA,IAAA,OAAO,IAAA;AAAA,EACT,CAAC,CAAA;AAED,EAAA,OAAO,CAAA,EAAG,SAAA,CAAU,UAAA,EAAY,GAAG,SAAS,CAAC,CAAA,CAAA,CAAA;AAC/C;AAEO,MAAM,aAAA,CAA4C;AAAA,EACtC,UAAA;AAAA,EACA,YAAA;AAAA,EACA,YAAA;AAAA,EACA,aAAA;AAAA,EACA,WAAA;AAAA;AAAA,EACA,kBAAA;AAAA,EACA,aAAA;AAAA,EAEjB,YACE,UAAA,EACA,YAAA,EACA,cACA,aAAA,EACA,WAAA,EACA,oBACA,aAAA,EACA;AACA,IAAA,IAAA,CAAK,UAAA,GAAa,UAAA;AAClB,IAAA,IAAA,CAAK,YAAA,GAAe,YAAA;AACpB,IAAA,IAAA,CAAK,YAAA,GAAe,YAAA;AACpB,IAAA,IAAA,CAAK,aAAA,GAAgB,aAAA;AACrB,IAAA,IAAA,CAAK,WAAA,GAAc,WAAA;AACnB,IAAA,IAAA,CAAK,kBAAA,GAAqB,kBAAA;AAC1B,IAAA,IAAA,CAAK,aAAA,GAAgB,aAAA;AAAA,EACvB;AAAA,EAEA,OAAA,CACE,aAIA,OAAA,EACgC;AAEhC,IAAA,MAAM,CAAC,SAAA,EAAW,UAAU,CAAA,GAAI,gBAAA;AAAA,MAC9B,aAAa,MAAA,KAAW,qBAAA,GACpB,IAAA,CAAK,kBAAA,CAAmB,WAAW,CAAA,GACnC,WAAA;AAAA,MACJ,IAAA,CAAK,UAAA;AAAA,MACL,IAAA,CAAK,aAAA;AAAA,MACL,IAAA,CAAK;AAAA,KACP;AACA,IAAA,IAAI,CAAC,SAAA,EAAW;AACd,MAAA,OAAO,MAAA;AAAA,IACT;AAIA,IAAA,MAAM,sBAAA,GAAyB,IAAA,CAAK,QAAA,CAAS,OAAA,EAAS,cAAc,EAAE,CAAA;AAKtE,IAAA,MAAM,QAAA,GAAW,eAAA;AAAA,MACf,SAAA;AAAA,MACA,sBAAA;AAAA,MACA,IAAA,CAAK,UAAA;AAAA,MACL,IAAA,CAAK,YAAA;AAAA,MACL,IAAA,CAAK;AAAA,KACP;AAEA,IAAA,MAAM,SAAA,GAAgC,CAAA,GAAI,CAAC,MAAM,CAAA,KAAM;AASrD,MAAA,MAAM,aAAA,GACJ,MAAA,IACA,SAAA,CAAU,MAAA,EAAQ,CAAA,KAAA,KAAS;AACzB,QAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,UAAA,OAAO,MAAM,UAAA,CAAW,WAAA,EAAa,CAAA,CAAA,KAAK,kBAAA,CAAmB,CAAC,CAAC,CAAA;AAAA,QACjE;AACA,QAAA,OAAO,KAAA;AAAA,MACT,CAAC,CAAA;AACH,MAAA,OAAO,SAAA,CAAU,QAAA,EAAU,YAAA,CAAa,UAAA,EAAY,aAAa,CAAC,CAAA;AAAA,IACpE,CAAA;AACA,IAAA,OAAO,SAAA;AAAA,EACT;AAAA,EAEQ,SAAS,UAAA,EAAoB;AACnC,IAAA,IAAI,CAAC,UAAA,EAAY;AACf,MAAA,OAAO,UAAA;AAAA,IACT;AAEA,IAAA,IAAI,UAAA,CAAW,UAAA,CAAW,IAAA,CAAK,WAAW,CAAA,EAAG;AAC3C,MAAA,OAAO,UAAA,CAAW,KAAA,CAAM,IAAA,CAAK,WAAA,CAAY,MAAM,CAAA;AAAA,IACjD;AACA,IAAA,OAAO,UAAA;AAAA,EACT;AACF;;;;"}

package/dist/routing/extractRouteInfoFromAppNode.esm.js

@@ -1,5 +1,6 @@
 import { coreExtensionData } from '@backstage/frontend-plugin-api';
 import { createExactRouteAliasResolver } from './RouteAliasResolver.esm.js';
+import { joinPaths } from './joinPaths.esm.js';
 
 const MATCH_ALL_ROUTE = {
   caseSensitive: false,
@@ -8,13 +9,6 @@ const MATCH_ALL_ROUTE = {
   // These elements aren't used, so we add in a bit of debug information
   routeRefs: /* @__PURE__ */ new Set()
 };
-function joinPaths(...paths) {
-  const normalized = paths.join("/").replace(/\/\/+/g, "/");
-  if (normalized !== "/" && normalized.endsWith("/")) {
-    return normalized.slice(0, -1);
-  }
-  return normalized;
-}
 function extractRouteInfoFromAppNode(node, routeAliasResolver) {
   const routePaths = /* @__PURE__ */ new Map();
   const routeParents = /* @__PURE__ */ new Map();
@@ -85,5 +79,5 @@ function extractRouteInfoFromAppNode(node, routeAliasResolver) {
   };
 }
 
-export { MATCH_ALL_ROUTE, extractRouteInfoFromAppNode, joinPaths };
+export { MATCH_ALL_ROUTE, extractRouteInfoFromAppNode };
 //# sourceMappingURL=extractRouteInfoFromAppNode.esm.js.map

package/dist/routing/extractRouteInfoFromAppNode.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"extractRouteInfoFromAppNode.esm.js","sources":["../../src/routing/extractRouteInfoFromAppNode.ts"],"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 { RouteRef, coreExtensionData } from '@backstage/frontend-plugin-api';\nimport { BackstageRouteObject } from './types';\nimport { AppNode } from '@backstage/frontend-plugin-api';\nimport {\n  createExactRouteAliasResolver,\n  RouteAliasResolver,\n} from './RouteAliasResolver';\n\n/** @internal */\nexport type RouteInfo = {\n  routePaths: Map<RouteRef, string>;\n  routeParents: Map<RouteRef, RouteRef | undefined>;\n  routeObjects: BackstageRouteObject[];\n  routeAliasResolver: RouteAliasResolver;\n};\n\n// We always add a child that matches all subroutes but without any route refs. This makes\n// sure that we're always able to match each route no matter how deep the navigation goes.\n// The route resolver then takes care of selecting the most specific match in order to find\n// mount points that are as deep in the routing tree as possible.\nexport const MATCH_ALL_ROUTE: BackstageRouteObject = {\n  caseSensitive: false,\n  path: '*',\n  element: 'match-all', // These elements aren't used, so we add in a bit of debug information\n  routeRefs: new Set(),\n};\n\n// Joins a list of paths together, avoiding trailing and duplicate slashes\nexport function joinPaths(...paths: string[]): string {\n  const normalized = paths.join('/').replace(/\\/\\/+/g, '/');\n  if (normalized !== '/' && normalized.endsWith('/')) {\n    return normalized.slice(0, -1);\n  }\n  return normalized;\n}\n\nexport function extractRouteInfoFromAppNode(\n  node: AppNode,\n  routeAliasResolver: RouteAliasResolver,\n): RouteInfo {\n  // This tracks the route path for each route ref, the value is the route path relative to the parent ref\n  const routePaths = new Map<RouteRef, string>();\n  // This tracks the parents of each route ref. To find the full path of any route ref you traverse\n  // upwards in this tree and substitute each route ref for its route path along then way.\n  const routeParents = new Map<RouteRef, RouteRef | undefined>();\n  // This route object tree is passed to react-router in order to be able to look up the current route\n  // ref or extension/source based on our current location.\n  const routeObjects = new Array<BackstageRouteObject>();\n  // This tracks all resolved route aliases. By storing and re-using the resolutions here we make sure that it's not\n  // possible to pass an aliased route ref directly to the resolver, e.g. `useRouteRef(createRouteRef({ aliasFor: 'example.root' }))`\n  const routeAliases = new Map<RouteRef, RouteRef | undefined>();\n\n  function visit(\n    current: AppNode,\n    collectedPath?: string,\n    foundRefForCollectedPath: boolean = false,\n    parentRef?: RouteRef,\n    candidateParentRef?: RouteRef,\n    parentObj?: BackstageRouteObject,\n  ) {\n    const routePath = current.instance\n      ?.getData(coreExtensionData.routePath)\n      ?.replace(/^\\//, '');\n\n    const foundRouteRef = current.instance?.getData(coreExtensionData.routeRef);\n    const routeRef = routeAliasResolver(foundRouteRef, current.spec.plugin?.id);\n    if (foundRouteRef && routeRef !== foundRouteRef) {\n      routeAliases.set(foundRouteRef, routeRef);\n    }\n\n    const parentChildren = parentObj?.children ?? routeObjects;\n    let currentObj = parentObj;\n\n    let newCollectedPath = collectedPath;\n    let newFoundRefForCollectedPath = foundRefForCollectedPath;\n\n    let newParentRef = parentRef;\n    let newCandidateParentRef = candidateParentRef;\n\n    // Whenever a route path is encountered, a new node is created in the routing tree.\n    if (routePath !== undefined) {\n      currentObj = {\n        path: routePath,\n        element: 'mounted',\n        routeRefs: new Set<RouteRef>(),\n        caseSensitive: false,\n        children: [MATCH_ALL_ROUTE],\n        appNode: current,\n      };\n      parentChildren.push(currentObj);\n\n      // Each route path that we discover creates a new node in the routing tree, at that point\n      // we also switch out our candidate parent ref to be the active one.\n      newParentRef = candidateParentRef;\n      newCandidateParentRef = undefined;\n\n      // We need to collect and concatenate route paths until the path has been assigned a route ref:\n      // Once we find a route ref the collection starts over from an empty path, that way each route\n      // path assignment only contains the diff from the parent ref.\n      if (newFoundRefForCollectedPath) {\n        newCollectedPath = routePath;\n        newFoundRefForCollectedPath = false;\n      } else {\n        newCollectedPath = collectedPath\n          ? joinPaths(collectedPath, routePath)\n          : routePath;\n      }\n    }\n\n    // Whenever a route ref is encountered, we need to give it a route path and position in the ref tree.\n    if (routeRef) {\n      // The first route ref we find after encountering a route path is selected to be used as the\n      // parent ref further down the tree. We don't start using this candidate ref until we encounter\n      // another route path though, at which point we repeat the process and select another candidate.\n      if (!newCandidateParentRef) {\n        newCandidateParentRef = routeRef;\n      }\n\n      // Check if we've encountered any route paths since the closest route ref, in that case we assign\n      // that path to this and following route refs until we encounter another route path.\n      if (newCollectedPath !== undefined) {\n        routePaths.set(routeRef, newCollectedPath);\n        newFoundRefForCollectedPath = true;\n      }\n\n      routeParents.set(routeRef, newParentRef);\n      currentObj?.routeRefs.add(routeRef);\n    }\n\n    for (const children of current.edges.attachments.values()) {\n      for (const child of children) {\n        visit(\n          child,\n          newCollectedPath,\n          newFoundRefForCollectedPath,\n          newParentRef,\n          newCandidateParentRef,\n          currentObj,\n        );\n      }\n    }\n  }\n\n  visit(node);\n\n  return {\n    routePaths,\n    routeParents,\n    routeObjects,\n    routeAliasResolver: createExactRouteAliasResolver(routeAliases),\n  };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"extractRouteInfoFromAppNode.esm.js","sources":["../../src/routing/extractRouteInfoFromAppNode.ts"],"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 { RouteRef, coreExtensionData } from '@backstage/frontend-plugin-api';\nimport { BackstageRouteObject } from './types';\nimport { AppNode } from '@backstage/frontend-plugin-api';\nimport {\n  createExactRouteAliasResolver,\n  RouteAliasResolver,\n} from './RouteAliasResolver';\nimport { joinPaths } from './joinPaths';\n\n/** @internal */\nexport type RouteInfo = {\n  routePaths: Map<RouteRef, string>;\n  routeParents: Map<RouteRef, RouteRef | undefined>;\n  routeObjects: BackstageRouteObject[];\n  routeAliasResolver: RouteAliasResolver;\n};\n\n// We always add a child that matches all subroutes but without any route refs. This makes\n// sure that we're always able to match each route no matter how deep the navigation goes.\n// The route resolver then takes care of selecting the most specific match in order to find\n// mount points that are as deep in the routing tree as possible.\nexport const MATCH_ALL_ROUTE: BackstageRouteObject = {\n  caseSensitive: false,\n  path: '*',\n  element: 'match-all', // These elements aren't used, so we add in a bit of debug information\n  routeRefs: new Set(),\n};\n\nexport function extractRouteInfoFromAppNode(\n  node: AppNode,\n  routeAliasResolver: RouteAliasResolver,\n): RouteInfo {\n  // This tracks the route path for each route ref, the value is the route path relative to the parent ref\n  const routePaths = new Map<RouteRef, string>();\n  // This tracks the parents of each route ref. To find the full path of any route ref you traverse\n  // upwards in this tree and substitute each route ref for its route path along then way.\n  const routeParents = new Map<RouteRef, RouteRef | undefined>();\n  // This route object tree is passed to react-router in order to be able to look up the current route\n  // ref or extension/source based on our current location.\n  const routeObjects = new Array<BackstageRouteObject>();\n  // This tracks all resolved route aliases. By storing and re-using the resolutions here we make sure that it's not\n  // possible to pass an aliased route ref directly to the resolver, e.g. `useRouteRef(createRouteRef({ aliasFor: 'example.root' }))`\n  const routeAliases = new Map<RouteRef, RouteRef | undefined>();\n\n  function visit(\n    current: AppNode,\n    collectedPath?: string,\n    foundRefForCollectedPath: boolean = false,\n    parentRef?: RouteRef,\n    candidateParentRef?: RouteRef,\n    parentObj?: BackstageRouteObject,\n  ) {\n    const routePath = current.instance\n      ?.getData(coreExtensionData.routePath)\n      ?.replace(/^\\//, '');\n\n    const foundRouteRef = current.instance?.getData(coreExtensionData.routeRef);\n    const routeRef = routeAliasResolver(foundRouteRef, current.spec.plugin?.id);\n    if (foundRouteRef && routeRef !== foundRouteRef) {\n      routeAliases.set(foundRouteRef, routeRef);\n    }\n\n    const parentChildren = parentObj?.children ?? routeObjects;\n    let currentObj = parentObj;\n\n    let newCollectedPath = collectedPath;\n    let newFoundRefForCollectedPath = foundRefForCollectedPath;\n\n    let newParentRef = parentRef;\n    let newCandidateParentRef = candidateParentRef;\n\n    // Whenever a route path is encountered, a new node is created in the routing tree.\n    if (routePath !== undefined) {\n      currentObj = {\n        path: routePath,\n        element: 'mounted',\n        routeRefs: new Set<RouteRef>(),\n        caseSensitive: false,\n        children: [MATCH_ALL_ROUTE],\n        appNode: current,\n      };\n      parentChildren.push(currentObj);\n\n      // Each route path that we discover creates a new node in the routing tree, at that point\n      // we also switch out our candidate parent ref to be the active one.\n      newParentRef = candidateParentRef;\n      newCandidateParentRef = undefined;\n\n      // We need to collect and concatenate route paths until the path has been assigned a route ref:\n      // Once we find a route ref the collection starts over from an empty path, that way each route\n      // path assignment only contains the diff from the parent ref.\n      if (newFoundRefForCollectedPath) {\n        newCollectedPath = routePath;\n        newFoundRefForCollectedPath = false;\n      } else {\n        newCollectedPath = collectedPath\n          ? joinPaths(collectedPath, routePath)\n          : routePath;\n      }\n    }\n\n    // Whenever a route ref is encountered, we need to give it a route path and position in the ref tree.\n    if (routeRef) {\n      // The first route ref we find after encountering a route path is selected to be used as the\n      // parent ref further down the tree. We don't start using this candidate ref until we encounter\n      // another route path though, at which point we repeat the process and select another candidate.\n      if (!newCandidateParentRef) {\n        newCandidateParentRef = routeRef;\n      }\n\n      // Check if we've encountered any route paths since the closest route ref, in that case we assign\n      // that path to this and following route refs until we encounter another route path.\n      if (newCollectedPath !== undefined) {\n        routePaths.set(routeRef, newCollectedPath);\n        newFoundRefForCollectedPath = true;\n      }\n\n      routeParents.set(routeRef, newParentRef);\n      currentObj?.routeRefs.add(routeRef);\n    }\n\n    for (const children of current.edges.attachments.values()) {\n      for (const child of children) {\n        visit(\n          child,\n          newCollectedPath,\n          newFoundRefForCollectedPath,\n          newParentRef,\n          newCandidateParentRef,\n          currentObj,\n        );\n      }\n    }\n  }\n\n  visit(node);\n\n  return {\n    routePaths,\n    routeParents,\n    routeObjects,\n    routeAliasResolver: createExactRouteAliasResolver(routeAliases),\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/routing/joinPaths.esm.js

@@ -0,0 +1,10 @@
+function joinPaths(...paths) {
+  const normalized = paths.join("/").replace(/\/\/+/g, "/");
+  if (normalized !== "/" && normalized.endsWith("/")) {
+    return normalized.slice(0, -1);
+  }
+  return normalized;
+}
+
+export { joinPaths };
+//# sourceMappingURL=joinPaths.esm.js.map

package/dist/routing/joinPaths.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"joinPaths.esm.js","sources":["../../src/routing/joinPaths.ts"],"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\n// Joins a list of paths together, avoiding trailing and duplicate slashes\nexport function joinPaths(...paths: string[]): string {\n  const normalized = paths.join('/').replace(/\\/\\/+/g, '/');\n  if (normalized !== '/' && normalized.endsWith('/')) {\n    return normalized.slice(0, -1);\n  }\n  return normalized;\n}\n"],"names":[],"mappings":"AAiBO,SAAS,aAAa,KAAA,EAAyB;AACpD,EAAA,MAAM,aAAa,KAAA,CAAM,IAAA,CAAK,GAAG,CAAA,CAAE,OAAA,CAAQ,UAAU,GAAG,CAAA;AACxD,EAAA,IAAI,UAAA,KAAe,GAAA,IAAO,UAAA,CAAW,QAAA,CAAS,GAAG,CAAA,EAAG;AAClD,IAAA,OAAO,UAAA,CAAW,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA;AAAA,EAC/B;AACA,EAAA,OAAO,UAAA;AACT;;;;"}

package/dist/wiring/apiFactories.esm.js

@@ -6,13 +6,13 @@ import '../frontend-internal/src/wiring/InternalExtensionDefinition.esm.js';
 import '../frontend-internal/src/wiring/InternalExtensionInput.esm.js';
 import '../frontend-internal/src/wiring/InternalSwappableComponentRef.esm.js';
 
-function registerFeatureFlagDeclarationsInHolder(apis, features) {
+function registerFeatureFlagDeclarationsInHolder(apis, features, collector) {
   const featureFlagApi = apis.get(featureFlagsApiRef);
   if (featureFlagApi) {
-    registerFeatureFlagDeclarations(featureFlagApi, features);
+    registerFeatureFlagDeclarations(featureFlagApi, features, collector);
   }
 }
-function wrapFeatureFlagApiFactory(factory, features) {
+function wrapFeatureFlagApiFactory(factory, features, collector) {
   if (factory.api.id !== featureFlagsApiRef.id) {
     return factory;
   }
@@ -22,7 +22,7 @@ function wrapFeatureFlagApiFactory(factory, features) {
       const featureFlagApi = factory.factory(
         deps
       );
-      registerFeatureFlagDeclarations(featureFlagApi, features);
+      registerFeatureFlagDeclarations(featureFlagApi, features, collector);
       return featureFlagApi;
     }
   };
@@ -61,7 +61,11 @@ function syncFinalApiFactories(options) {
     return true;
   });
   const changedFactories = changedEntries.map(
-    (entry) => wrapFeatureFlagApiFactory(entry.factory, options.features)
+    (entry) => wrapFeatureFlagApiFactory(
+      entry.factory,
+      options.features,
+      options.collector
+    )
   );
   options.appApiRegistry.setAll(changedFactories);
   options.apiResolver.invalidate(
@@ -86,25 +90,36 @@ const EMPTY_API_HOLDER = {
     return void 0;
   }
 };
-function registerFeatureFlagDeclarations(featureFlagApi, features) {
+function registerFeatureFlagDeclarations(featureFlagApi, features, collector) {
   for (const feature of features) {
+    let pluginId;
+    let flags;
+    let source;
     if (OpaqueFrontendPlugin.isType(feature)) {
-      OpaqueFrontendPlugin.toInternal(feature).featureFlags.forEach(
-        (flag) => featureFlagApi.registerFlag({
-          name: flag.name,
-          description: flag.description,
-          pluginId: feature.id
-        })
-      );
+      pluginId = feature.id;
+      flags = OpaqueFrontendPlugin.toInternal(feature).featureFlags;
+      source = "Plugin";
+    } else if (isInternalFrontendModule(feature)) {
+      pluginId = feature.pluginId;
+      flags = toInternalFrontendModule(feature).featureFlags;
+      source = "Module for plugin";
     }
-    if (isInternalFrontendModule(feature)) {
-      toInternalFrontendModule(feature).featureFlags.forEach(
-        (flag) => featureFlagApi.registerFlag({
-          name: flag.name,
-          description: flag.description,
-          pluginId: feature.pluginId
-        })
-      );
+    if (pluginId && flags && source) {
+      for (const flag of flags) {
+        try {
+          featureFlagApi.registerFlag({
+            name: flag.name,
+            description: flag.description,
+            pluginId
+          });
+        } catch (error) {
+          collector.report({
+            code: "FEATURE_FLAG_INVALID",
+            message: `${source} '${pluginId}' declared invalid feature flag '${flag.name}': ${error}`,
+            context: { pluginId, flagName: flag.name, error }
+          });
+        }
+      }
     }
   }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"apiFactories.esm.js","sources":["../../src/wiring/apiFactories.ts"],"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 {\n  ApiBlueprint,\n  AnyApiFactory,\n  ApiHolder,\n  AppNode,\n  FrontendFeature,\n  featureFlagsApiRef,\n} from '@backstage/frontend-plugin-api';\nimport { OpaqueFrontendPlugin } from '@internal/frontend';\nimport { instantiateAppNodeSubtree } from '../tree/instantiateAppNodeTree';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport {\n  isInternalFrontendModule,\n  toInternalFrontendModule,\n} from '../../../frontend-plugin-api/src/wiring/createFrontendModule';\nimport { ErrorCollector } from './createErrorCollector';\nimport {\n  FrontendApiRegistry,\n  FrontendApiResolver,\n} from './FrontendApiRegistry';\nimport { type ExtensionPredicateContext } from './predicates';\n\nexport type ApiFactoryEntry = {\n  node: AppNode;\n  pluginId: string;\n  factory: AnyApiFactory;\n};\n\n/**\n * Registers feature flag declarations on an already prepared API holder.\n *\n * This is primarily used when bootstrap reuses APIs from a provided session\n * state rather than building a fresh registry from bootstrap-visible factories.\n */\nexport function registerFeatureFlagDeclarationsInHolder(\n  apis: ApiHolder,\n  features: FrontendFeature[],\n) {\n  const featureFlagApi = apis.get(featureFlagsApiRef);\n  if (featureFlagApi) {\n    registerFeatureFlagDeclarations(featureFlagApi, features);\n  }\n}\n\n/**\n * Decorates the feature flags API factory so plugin and module declarations are\n * registered whenever that API is instantiated.\n */\nexport function wrapFeatureFlagApiFactory(\n  factory: AnyApiFactory,\n  features: FrontendFeature[],\n) {\n  if (factory.api.id !== featureFlagsApiRef.id) {\n    return factory;\n  }\n\n  return {\n    ...factory,\n    factory(deps) {\n      const featureFlagApi = factory.factory(\n        deps,\n      ) as typeof featureFlagsApiRef.T;\n      registerFeatureFlagDeclarations(featureFlagApi, features);\n      return featureFlagApi;\n    },\n  } as AnyApiFactory;\n}\n\n/**\n * Reconciles deferred API factories into the finalized API registry.\n *\n * It preserves bootstrap-frozen APIs, allows safe deferred additions, and\n * reports cases where bootstrap-visible extensions relied on APIs that only\n * became available during finalization.\n */\nexport function syncFinalApiFactories(options: {\n  deferredApiNodes: Iterable<AppNode>;\n  appApiRegistry: FrontendApiRegistry;\n  apiResolver: FrontendApiResolver;\n  collector: ErrorCollector;\n  features: FrontendFeature[];\n  bootstrapApiFactoryEntries: ReadonlyMap<string, ApiFactoryEntry>;\n  bootstrapMissingApiAccesses: Map<string, { node: AppNode; apiRefId: string }>;\n  predicateContext: ExtensionPredicateContext;\n}) {\n  const finalApiEntries = collectApiFactoryEntries({\n    apiNodes: options.deferredApiNodes,\n    collector: options.collector,\n    predicateContext: options.predicateContext,\n    entries: new Map(options.bootstrapApiFactoryEntries),\n  });\n  // Only newly introduced or still-safe overrides are registered here. Any\n  // bootstrap-materialized API remains frozen for the lifetime of the app.\n  const changedEntries = Array.from(finalApiEntries.values()).filter(entry => {\n    const bootstrapEntry = options.bootstrapApiFactoryEntries.get(\n      entry.factory.api.id,\n    );\n    if (!bootstrapEntry) {\n      return true;\n    }\n    if (bootstrapEntry.factory === entry.factory) {\n      return false;\n    }\n    if (options.apiResolver.isMaterialized(entry.factory.api.id)) {\n      options.collector.report({\n        code: 'EXTENSION_BOOTSTRAP_API_OVERRIDE_IGNORED',\n        message:\n          `Extension '${entry.node.spec.id}' tried to override API ` +\n          `'${entry.factory.api.id}' after it had already been materialized during bootstrap. ` +\n          'The bootstrap implementation was kept and the deferred override was ignored.',\n        context: {\n          node: entry.node,\n          apiRefId: entry.factory.api.id,\n          bootstrapNode: bootstrapEntry.node,\n          pluginId: entry.pluginId,\n          bootstrapPluginId: bootstrapEntry.pluginId,\n        },\n      });\n      return false;\n    }\n    return true;\n  });\n  const changedFactories = changedEntries.map(entry =>\n    wrapFeatureFlagApiFactory(entry.factory, options.features),\n  );\n  options.appApiRegistry.setAll(changedFactories);\n  options.apiResolver.invalidate(\n    changedFactories.map(factory => factory.api.id),\n  );\n  for (const bootstrapAccess of options.bootstrapMissingApiAccesses.values()) {\n    if (\n      options.bootstrapApiFactoryEntries.has(bootstrapAccess.apiRefId) ||\n      !finalApiEntries.has(bootstrapAccess.apiRefId)\n    ) {\n      continue;\n    }\n\n    options.collector.report({\n      code: 'EXTENSION_BOOTSTRAP_API_UNAVAILABLE',\n      message:\n        `Extension '${bootstrapAccess.node.spec.id}' tried to access API ` +\n        `'${bootstrapAccess.apiRefId}' during bootstrap before it was available. ` +\n        'That API became available during finalization, so bootstrap-visible extensions must not depend on deferred APIs.',\n      context: {\n        node: bootstrapAccess.node,\n        apiRefId: bootstrapAccess.apiRefId,\n      },\n    });\n  }\n}\n\nconst EMPTY_API_HOLDER: ApiHolder = {\n  get() {\n    return undefined;\n  },\n};\n\nfunction registerFeatureFlagDeclarations(\n  featureFlagApi: typeof featureFlagsApiRef.T,\n  features: FrontendFeature[],\n) {\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          description: flag.description,\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          description: flag.description,\n          pluginId: feature.pluginId,\n        }),\n      );\n    }\n  }\n}\n\n/**\n * Instantiates API extension subtrees in isolation and extracts the factories\n * they provide without mutating the live app tree.\n *\n * The collected entries are later used both for bootstrap registration and for\n * the finalization-time reconciliation of deferred API roots.\n */\nexport function collectApiFactoryEntries(options: {\n  apiNodes: Iterable<AppNode>;\n  collector: ErrorCollector;\n  predicateContext?: ExtensionPredicateContext;\n  entries?: Map<string, ApiFactoryEntry>;\n}): Map<string, ApiFactoryEntry> {\n  const factoriesById = options.entries ?? new Map<string, ApiFactoryEntry>();\n  for (const apiNode of options.apiNodes) {\n    // API extensions are instantiated in isolation so we can inspect the\n    // produced factories without mutating the live app tree.\n    const detachedApiNode = instantiateAppNodeSubtree({\n      rootNode: apiNode,\n      apis: EMPTY_API_HOLDER,\n      collector: options.collector,\n      predicateContext: options.predicateContext,\n      writeNodeInstances: false,\n      reuseExistingInstances: false,\n    });\n    if (!detachedApiNode) {\n      continue;\n    }\n    const apiFactory = detachedApiNode.instance?.getData(\n      ApiBlueprint.dataRefs.factory,\n    );\n    if (apiFactory) {\n      const apiRefId = apiFactory.api.id;\n      const ownerId = getApiOwnerId(apiRefId);\n      const pluginId = apiNode.spec.plugin.pluginId ?? '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            node: apiNode,\n            factory: apiFactory,\n          });\n        }\n        continue;\n      }\n\n      factoriesById.set(apiRefId, {\n        pluginId,\n        node: apiNode,\n        factory: apiFactory,\n      });\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 factoriesById;\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"],"names":[],"mappings":"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"}
+{"version":3,"file":"apiFactories.esm.js","sources":["../../src/wiring/apiFactories.ts"],"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 {\n  ApiBlueprint,\n  AnyApiFactory,\n  ApiHolder,\n  AppNode,\n  FrontendFeature,\n  featureFlagsApiRef,\n} from '@backstage/frontend-plugin-api';\nimport { OpaqueFrontendPlugin } from '@internal/frontend';\nimport { instantiateAppNodeSubtree } from '../tree/instantiateAppNodeTree';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport {\n  isInternalFrontendModule,\n  toInternalFrontendModule,\n} from '../../../frontend-plugin-api/src/wiring/createFrontendModule';\nimport { ErrorCollector } from './createErrorCollector';\nimport {\n  FrontendApiRegistry,\n  FrontendApiResolver,\n} from './FrontendApiRegistry';\nimport { type ExtensionPredicateContext } from './predicates';\n\nexport type ApiFactoryEntry = {\n  node: AppNode;\n  pluginId: string;\n  factory: AnyApiFactory;\n};\n\n/**\n * Registers feature flag declarations on an already prepared API holder.\n *\n * This is primarily used when bootstrap reuses APIs from a provided session\n * state rather than building a fresh registry from bootstrap-visible factories.\n */\nexport function registerFeatureFlagDeclarationsInHolder(\n  apis: ApiHolder,\n  features: FrontendFeature[],\n  collector: ErrorCollector,\n) {\n  const featureFlagApi = apis.get(featureFlagsApiRef);\n  if (featureFlagApi) {\n    registerFeatureFlagDeclarations(featureFlagApi, features, collector);\n  }\n}\n\n/**\n * Decorates the feature flags API factory so plugin and module declarations are\n * registered whenever that API is instantiated.\n */\nexport function wrapFeatureFlagApiFactory(\n  factory: AnyApiFactory,\n  features: FrontendFeature[],\n  collector: ErrorCollector,\n) {\n  if (factory.api.id !== featureFlagsApiRef.id) {\n    return factory;\n  }\n\n  return {\n    ...factory,\n    factory(deps) {\n      const featureFlagApi = factory.factory(\n        deps,\n      ) as typeof featureFlagsApiRef.T;\n      registerFeatureFlagDeclarations(featureFlagApi, features, collector);\n      return featureFlagApi;\n    },\n  } as AnyApiFactory;\n}\n\n/**\n * Reconciles deferred API factories into the finalized API registry.\n *\n * It preserves bootstrap-frozen APIs, allows safe deferred additions, and\n * reports cases where bootstrap-visible extensions relied on APIs that only\n * became available during finalization.\n */\nexport function syncFinalApiFactories(options: {\n  deferredApiNodes: Iterable<AppNode>;\n  appApiRegistry: FrontendApiRegistry;\n  apiResolver: FrontendApiResolver;\n  collector: ErrorCollector;\n  features: FrontendFeature[];\n  bootstrapApiFactoryEntries: ReadonlyMap<string, ApiFactoryEntry>;\n  bootstrapMissingApiAccesses: Map<string, { node: AppNode; apiRefId: string }>;\n  predicateContext: ExtensionPredicateContext;\n}) {\n  const finalApiEntries = collectApiFactoryEntries({\n    apiNodes: options.deferredApiNodes,\n    collector: options.collector,\n    predicateContext: options.predicateContext,\n    entries: new Map(options.bootstrapApiFactoryEntries),\n  });\n  // Only newly introduced or still-safe overrides are registered here. Any\n  // bootstrap-materialized API remains frozen for the lifetime of the app.\n  const changedEntries = Array.from(finalApiEntries.values()).filter(entry => {\n    const bootstrapEntry = options.bootstrapApiFactoryEntries.get(\n      entry.factory.api.id,\n    );\n    if (!bootstrapEntry) {\n      return true;\n    }\n    if (bootstrapEntry.factory === entry.factory) {\n      return false;\n    }\n    if (options.apiResolver.isMaterialized(entry.factory.api.id)) {\n      options.collector.report({\n        code: 'EXTENSION_BOOTSTRAP_API_OVERRIDE_IGNORED',\n        message:\n          `Extension '${entry.node.spec.id}' tried to override API ` +\n          `'${entry.factory.api.id}' after it had already been materialized during bootstrap. ` +\n          'The bootstrap implementation was kept and the deferred override was ignored.',\n        context: {\n          node: entry.node,\n          apiRefId: entry.factory.api.id,\n          bootstrapNode: bootstrapEntry.node,\n          pluginId: entry.pluginId,\n          bootstrapPluginId: bootstrapEntry.pluginId,\n        },\n      });\n      return false;\n    }\n    return true;\n  });\n  const changedFactories = changedEntries.map(entry =>\n    wrapFeatureFlagApiFactory(\n      entry.factory,\n      options.features,\n      options.collector,\n    ),\n  );\n  options.appApiRegistry.setAll(changedFactories);\n  options.apiResolver.invalidate(\n    changedFactories.map(factory => factory.api.id),\n  );\n  for (const bootstrapAccess of options.bootstrapMissingApiAccesses.values()) {\n    if (\n      options.bootstrapApiFactoryEntries.has(bootstrapAccess.apiRefId) ||\n      !finalApiEntries.has(bootstrapAccess.apiRefId)\n    ) {\n      continue;\n    }\n\n    options.collector.report({\n      code: 'EXTENSION_BOOTSTRAP_API_UNAVAILABLE',\n      message:\n        `Extension '${bootstrapAccess.node.spec.id}' tried to access API ` +\n        `'${bootstrapAccess.apiRefId}' during bootstrap before it was available. ` +\n        'That API became available during finalization, so bootstrap-visible extensions must not depend on deferred APIs.',\n      context: {\n        node: bootstrapAccess.node,\n        apiRefId: bootstrapAccess.apiRefId,\n      },\n    });\n  }\n}\n\nconst EMPTY_API_HOLDER: ApiHolder = {\n  get() {\n    return undefined;\n  },\n};\n\nfunction registerFeatureFlagDeclarations(\n  featureFlagApi: typeof featureFlagsApiRef.T,\n  features: FrontendFeature[],\n  collector: ErrorCollector,\n) {\n  for (const feature of features) {\n    let pluginId: string | undefined;\n    let flags: Array<{ name: string; description?: string }> | undefined;\n    let source: string | undefined;\n\n    if (OpaqueFrontendPlugin.isType(feature)) {\n      pluginId = feature.id;\n      flags = OpaqueFrontendPlugin.toInternal(feature).featureFlags;\n      source = 'Plugin';\n    } else if (isInternalFrontendModule(feature)) {\n      pluginId = feature.pluginId;\n      flags = toInternalFrontendModule(feature).featureFlags;\n      source = 'Module for plugin';\n    }\n\n    if (pluginId && flags && source) {\n      for (const flag of flags) {\n        try {\n          featureFlagApi.registerFlag({\n            name: flag.name,\n            description: flag.description,\n            pluginId,\n          });\n        } catch (error) {\n          collector.report({\n            code: 'FEATURE_FLAG_INVALID',\n            message: `${source} '${pluginId}' declared invalid feature flag '${flag.name}': ${error}`,\n            context: { pluginId, flagName: flag.name, error: error as Error },\n          });\n        }\n      }\n    }\n  }\n}\n\n/**\n * Instantiates API extension subtrees in isolation and extracts the factories\n * they provide without mutating the live app tree.\n *\n * The collected entries are later used both for bootstrap registration and for\n * the finalization-time reconciliation of deferred API roots.\n */\nexport function collectApiFactoryEntries(options: {\n  apiNodes: Iterable<AppNode>;\n  collector: ErrorCollector;\n  predicateContext?: ExtensionPredicateContext;\n  entries?: Map<string, ApiFactoryEntry>;\n}): Map<string, ApiFactoryEntry> {\n  const factoriesById = options.entries ?? new Map<string, ApiFactoryEntry>();\n  for (const apiNode of options.apiNodes) {\n    // API extensions are instantiated in isolation so we can inspect the\n    // produced factories without mutating the live app tree.\n    const detachedApiNode = instantiateAppNodeSubtree({\n      rootNode: apiNode,\n      apis: EMPTY_API_HOLDER,\n      collector: options.collector,\n      predicateContext: options.predicateContext,\n      writeNodeInstances: false,\n      reuseExistingInstances: false,\n    });\n    if (!detachedApiNode) {\n      continue;\n    }\n    const apiFactory = detachedApiNode.instance?.getData(\n      ApiBlueprint.dataRefs.factory,\n    );\n    if (apiFactory) {\n      const apiRefId = apiFactory.api.id;\n      const ownerId = getApiOwnerId(apiRefId);\n      const pluginId = apiNode.spec.plugin.pluginId ?? '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            node: apiNode,\n            factory: apiFactory,\n          });\n        }\n        continue;\n      }\n\n      factoriesById.set(apiRefId, {\n        pluginId,\n        node: apiNode,\n        factory: apiFactory,\n      });\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 factoriesById;\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"],"names":[],"mappings":"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"}

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_INPUT_INTERNAL_IGNORED: {\n    context: {\n      node: AppNode;\n      inputName: string;\n      extensionId: string;\n      plugin: FrontendPlugin;\n    };\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  EXTENSION_BOOTSTRAP_PREDICATE_IGNORED: {\n    context: { node: AppNode };\n  };\n  EXTENSION_BOOTSTRAP_API_UNAVAILABLE: {\n    context: { node: AppNode; apiRefId: string };\n  };\n  EXTENSION_BOOTSTRAP_API_OVERRIDE_IGNORED: {\n    context: {\n      node: AppNode;\n      apiRefId: string;\n      bootstrapNode: AppNode;\n      pluginId: string;\n      bootstrapPluginId: 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":"AAuJO,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_INPUT_INTERNAL_IGNORED: {\n    context: {\n      node: AppNode;\n      inputName: string;\n      extensionId: string;\n      plugin: FrontendPlugin;\n    };\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  EXTENSION_BOOTSTRAP_PREDICATE_IGNORED: {\n    context: { node: AppNode };\n  };\n  EXTENSION_BOOTSTRAP_API_UNAVAILABLE: {\n    context: { node: AppNode; apiRefId: string };\n  };\n  EXTENSION_BOOTSTRAP_API_OVERRIDE_IGNORED: {\n    context: {\n      node: AppNode;\n      apiRefId: string;\n      bootstrapNode: AppNode;\n      pluginId: string;\n      bootstrapPluginId: string;\n    };\n  };\n  FEATURE_FLAG_INVALID: {\n    context: { pluginId: string; flagName: string; error: Error };\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":"AA0JO,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/prepareSpecializedApp.esm.js

@@ -94,7 +94,7 @@ function prepareSpecializedApp(options) {
   const bootstrapApiFactoryEntries = /* @__PURE__ */ new Map();
   const bootstrapMissingApiAccesses = /* @__PURE__ */ new Map();
   if (providedApis) {
-    registerFeatureFlagDeclarationsInHolder(providedApis, features);
+    registerFeatureFlagDeclarationsInHolder(providedApis, features, collector);
   } else {
     collectApiFactoryEntries({
       apiNodes: (tree.root.edges.attachments.get("apis") ?? []).filter(
@@ -105,7 +105,7 @@ function prepareSpecializedApp(options) {
     });
     const apiFactories = Array.from(
       bootstrapApiFactoryEntries.values(),
-      (entry) => wrapFeatureFlagApiFactory(entry.factory, features)
+      (entry) => wrapFeatureFlagApiFactory(entry.factory, features, collector)
     );
     appApiRegistry.registerAll(apiFactories);
   }

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

@@ -1 +1 @@
-{"version":3,"file":"prepareSpecializedApp.esm.js","sources":["../../src/wiring/prepareSpecializedApp.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 { isError } from '@backstage/errors';\nimport {\n  AnyApiFactory,\n  ApiHolder,\n  AppTree,\n  ConfigApi,\n  coreExtensionData,\n  AppNode,\n  ExtensionFactoryMiddleware,\n  FrontendFeature,\n  IdentityApi,\n  identityApiRef,\n  createExtensionDataRef,\n} from '@backstage/frontend-plugin-api';\nimport {\n  createExtensionDataContainer,\n  OpaqueFrontendPlugin,\n} from '@internal/frontend';\nimport { OpaqueType } from '@internal/opaque';\nimport { ComponentType, ReactNode } from 'react';\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 { CreateAppRouteBinder } from '../routing';\nimport { resolveRouteBindings } from '../routing/resolveRouteBindings';\nimport { collectRouteIds } from '../routing/collectRouteIds';\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 {\n  createPluginInfoAttacher,\n  FrontendPluginInfoResolver,\n} from './createPluginInfoAttacher';\nimport {\n  AppError,\n  createErrorCollector,\n  ErrorCollector,\n} from './createErrorCollector';\nimport {\n  createPhaseApis,\n  instantiateAndInitializePhaseTree,\n  setIdentityApiTarget,\n} from './phaseApis';\nimport {\n  collectPredicateReferences,\n  createPredicateContextLoader,\n  EMPTY_PREDICATE_CONTEXT,\n  type ExtensionPredicateContext,\n} from './predicates';\nimport { FrontendApiRegistry } from './FrontendApiRegistry';\nimport {\n  ApiFactoryEntry,\n  collectApiFactoryEntries,\n  registerFeatureFlagDeclarationsInHolder,\n  syncFinalApiFactories,\n  wrapFeatureFlagApiFactory,\n} from './apiFactories';\nimport {\n  attachThrowingFinalizationChild,\n  BootstrapClassification,\n  classifyBootstrapTree,\n  clearFinalizationBoundaryInstances,\n  createBootstrapApp,\n  prepareFinalizedTree,\n} from './treeLifecycle';\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\ntype SignInPageProps = {\n  onSignInSuccess(identityApi: IdentityApi): void;\n  children?: ReactNode;\n};\n\n/**\n * Result of bootstrapping a prepared specialized app.\n *\n * @public\n */\nexport type BootstrapSpecializedApp = {\n  apis: ApiHolder;\n  element: JSX.Element;\n  tree: AppTree;\n};\n\n/**\n * Result of finalizing a prepared specialized app.\n *\n * @public\n */\nexport type FinalizedSpecializedApp = {\n  apis: ApiHolder;\n  element: JSX.Element;\n  sessionState: SpecializedAppSessionState;\n  tree: AppTree;\n  errors?: AppError[];\n};\n\ntype SignInRuntime = {\n  readyIdentityApi?: IdentityApi;\n  requiresSignIn: boolean;\n};\n\ntype FinalizationState = {\n  started: boolean;\n  promise: Promise<FinalizedSpecializedApp>;\n  resolve(app: FinalizedSpecializedApp): void;\n  reject(error: unknown): void;\n};\n\ntype FinalizationMode = 'onFinalized' | 'finalize';\n\ntype InternalSpecializedAppSessionState = {\n  apis: ApiHolder;\n  identityApi?: IdentityApi;\n  predicateContext: ExtensionPredicateContext;\n};\n\n/**\n * Opaque reusable session state for specialized apps.\n *\n * @public\n */\nexport type SpecializedAppSessionState = {\n  $$type: '@backstage/SpecializedAppSessionState';\n};\n\nconst OpaqueSpecializedAppSessionState = OpaqueType.create<{\n  public: SpecializedAppSessionState;\n  versions: InternalSpecializedAppSessionState & {\n    version: 'v1';\n  };\n}>({\n  type: '@backstage/SpecializedAppSessionState',\n  versions: ['v1'],\n});\n\nconst signInPageComponentDataRef = createExtensionDataRef<\n  ComponentType<SignInPageProps>\n>().with({ id: 'core.sign-in-page.component' });\n\n/**\n * Options for {@link prepareSpecializedApp}.\n *\n * @public\n */\nexport type PrepareSpecializedAppOptions = {\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 reusable specialized app session state to use.\n     *\n     * This can be obtained from either the app passed to\n     * {@link PreparedSpecializedApp.onFinalized} or from\n     * {@link PreparedSpecializedApp.finalize}, and reused in a future app\n     * instance to skip sign-in and session preparation.\n     */\n    sessionState?: SpecializedAppSessionState;\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 * Result of {@link prepareSpecializedApp}.\n *\n * @public\n */\nexport type PreparedSpecializedApp = {\n  getBootstrapApp(): BootstrapSpecializedApp;\n  onFinalized(callback: (app: FinalizedSpecializedApp) => void): () => void;\n  finalize(): FinalizedSpecializedApp;\n};\n\n// Internal options type, not exported in the public API\nexport interface CreateSpecializedAppInternalOptions\n  extends PrepareSpecializedAppOptions {\n  __internal?: {\n    apiFactoryOverrides?: AnyApiFactory[];\n  };\n}\n\nexport function createSessionStateFromApis(\n  apis: ApiHolder,\n): SpecializedAppSessionState {\n  return OpaqueSpecializedAppSessionState.createInstance('v1', {\n    apis,\n    identityApi: apis.get(identityApiRef),\n    predicateContext: EMPTY_PREDICATE_CONTEXT,\n  });\n}\n\n/**\n * Prepares an app without instantiating the full extension tree.\n *\n * @remarks\n *\n * This is useful for split sign-in flows where the sign-in page should be\n * rendered first, and the full app finalized once an identity has been\n * captured.\n *\n * @public\n */\nexport function prepareSpecializedApp(\n  options?: PrepareSpecializedAppOptions,\n): PreparedSpecializedApp {\n  const internalOptions = options as CreateSpecializedAppInternalOptions;\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 appBasePath = getBasePath(config);\n  const routeRefsById = collectRouteIds(features, collector);\n  const routeBindings = resolveRouteBindings(\n    options?.bindRoutes,\n    config,\n    routeRefsById,\n    collector,\n  );\n\n  const mergedExtensionFactoryMiddleware = mergeExtensionFactoryMiddleware(\n    options?.advanced?.extensionFactoryMiddleware,\n  );\n  const providedSessionState = options?.advanced?.sessionState;\n  const providedSessionData = providedSessionState\n    ? OpaqueSpecializedAppSessionState.toInternal(providedSessionState)\n    : undefined;\n  const providedApis = providedSessionData?.apis;\n  // Bootstrap only renders the parts of the tree that are known to be safe\n  // before predicate context and sign-in have been resolved.\n  const bootstrapClassification = classifyBootstrapTree({\n    tree,\n    collector,\n  });\n  const predicateReferences = collectPredicateReferences(tree.nodes.values());\n  const appApiRegistry = new FrontendApiRegistry();\n  const internalStaticFactories =\n    internalOptions?.__internal?.apiFactoryOverrides ?? [];\n  const phaseStaticFactories = [...internalStaticFactories];\n  const bootstrapApiFactoryEntries = new Map<string, ApiFactoryEntry>();\n  const bootstrapMissingApiAccesses = new Map<\n    string,\n    { node: AppNode; apiRefId: string }\n  >();\n\n  if (providedApis) {\n    // Reused session state already carries a fully prepared API holder, so the\n    // bootstrap path only needs to register feature flag declarations on top.\n    registerFeatureFlagDeclarationsInHolder(providedApis, features);\n  } else {\n    // Bootstrap materializes only the immediately visible API factories. Any\n    // predicate-gated API roots are revisited during finalization.\n    collectApiFactoryEntries({\n      apiNodes: (tree.root.edges.attachments.get('apis') ?? []).filter(\n        apiNode => !bootstrapClassification.deferredApiRoots.has(apiNode),\n      ),\n      collector,\n      entries: bootstrapApiFactoryEntries,\n    });\n    const apiFactories = Array.from(\n      bootstrapApiFactoryEntries.values(),\n      entry => wrapFeatureFlagApiFactory(entry.factory, features),\n    );\n    appApiRegistry.registerAll(apiFactories);\n  }\n  const phase = createPhaseApis({\n    tree,\n    config,\n    appApiRegistry,\n    fallbackApis: providedApis,\n    includeConfigApi: !providedApis,\n    appBasePath,\n    routeBindings,\n    staticFactories: phaseStaticFactories,\n  });\n  const predicateContextLoader = createPredicateContextLoader({\n    apis: phase.apis,\n    predicateReferences,\n  });\n  let signInRuntime: SignInRuntime | undefined;\n  let finalized: FinalizedSpecializedApp | undefined;\n  let bootstrapApp: BootstrapSpecializedApp | undefined;\n\n  function updateIdentityApiTarget(identityApi?: IdentityApi) {\n    if (!identityApi) {\n      return;\n    }\n\n    setIdentityApiTarget({\n      identityApiProxy: phase.identityApiProxy,\n      identityApi,\n      signOutTargetUrl: appBasePath || '/',\n    });\n  }\n\n  function createSessionState(predicateContext: ExtensionPredicateContext) {\n    const identityApi =\n      signInRuntime?.readyIdentityApi ?? providedSessionData?.identityApi;\n    // As soon as a real identity is available we swap the phase proxy over so\n    // the finalized tree observes the same API instance.\n    updateIdentityApiTarget(identityApi);\n    const sessionState = OpaqueSpecializedAppSessionState.createInstance('v1', {\n      apis: phase.apis,\n      identityApi,\n      predicateContext,\n    });\n    return sessionState;\n  }\n\n  function getSynchronousSessionState() {\n    if (providedSessionState) {\n      return providedSessionState;\n    }\n    // The direct finalize() path is intentionally synchronous. If sign-in is\n    // still pending we refuse to guess and force the caller to wait.\n    if (signInRuntime?.requiresSignIn) {\n      return undefined;\n    }\n\n    const predicateContext = predicateContextLoader.getImmediate();\n    if (!predicateContext) {\n      return undefined;\n    }\n\n    return createSessionState(predicateContext);\n  }\n\n  function loadAsyncSessionState() {\n    if (providedSessionState) {\n      return Promise.resolve(providedSessionState);\n    }\n    if (signInRuntime?.requiresSignIn && !signInRuntime.readyIdentityApi) {\n      return Promise.reject(\n        new Error(\n          'prepareSpecializedApp requires waiting for the bootstrap app to be ready before calling finalize()',\n        ),\n      );\n    }\n\n    // For apps without sign-in we can sometimes finalize immediately from the\n    // already available predicate context, skipping the async loader.\n    if (!signInRuntime?.requiresSignIn) {\n      const immediateSessionState = getSynchronousSessionState();\n      if (immediateSessionState) {\n        return Promise.resolve(immediateSessionState);\n      }\n    }\n\n    return predicateContextLoader.load().then(createSessionState);\n  }\n\n  function finalizeWithSessionState(\n    finalizedSessionState: SpecializedAppSessionState,\n  ) {\n    return finalizeFromSessionState({\n      finalized,\n      finalizedSessionState,\n      tree,\n      collector,\n      phase,\n      extensionFactoryMiddleware: mergedExtensionFactoryMiddleware,\n      routeRefsById,\n      appBasePath,\n      providedApis,\n      features,\n      appApiRegistry,\n      bootstrapClassification,\n      bootstrapApiFactoryEntries,\n      bootstrapMissingApiAccesses,\n    });\n  }\n\n  function finalizeWithBootstrapError(\n    error: Error,\n    finalizedSessionState?: SpecializedAppSessionState,\n  ) {\n    return finalizeFromBootstrapError({\n      finalized,\n      error,\n      finalizedSessionState,\n      tree,\n      collector,\n      phase,\n      extensionFactoryMiddleware: mergedExtensionFactoryMiddleware,\n      routeRefsById,\n      signInRuntime,\n      providedSessionData,\n    });\n  }\n\n  const finalization = createFinalizationController({\n    getFinalized() {\n      return finalized;\n    },\n    setFinalized(finalizedApp) {\n      finalized = finalizedApp;\n    },\n    finalizeFromSessionState: finalizeWithSessionState,\n    finalizeFromBootstrapError: finalizeWithBootstrapError,\n  });\n\n  function getBootstrapApp() {\n    if (bootstrapApp) {\n      return bootstrapApp;\n    }\n\n    const runtime: SignInRuntime = {\n      requiresSignIn: false,\n    };\n    if (!providedSessionState) {\n      phase.identityApiProxy.setTargetHandlers({\n        onTargetSet(identityApi) {\n          runtime.readyIdentityApi = identityApi;\n          // Sign-in completion only auto-starts finalization for onFinalized().\n          // The direct finalize() path stays explicit and synchronous.\n          if (finalization.getMode() === 'onFinalized') {\n            finalization.start(loadAsyncSessionState);\n          }\n        },\n      });\n    }\n\n    const result = createBootstrapApp({\n      tree,\n      apis: phase.apis,\n      collector,\n      routeRefsById,\n      routeResolutionApi: phase.routeResolutionApi,\n      appTreeApi: phase.appTreeApi,\n      extensionFactoryMiddleware: mergedExtensionFactoryMiddleware,\n      disableSignIn: Boolean(providedSessionState),\n      skipBootstrapChild({ child }) {\n        return bootstrapClassification.deferredRoots.has(child);\n      },\n      onMissingApi({ node, apiRefId }) {\n        bootstrapMissingApiAccesses.set(`${node.spec.id}:${apiRefId}`, {\n          node,\n          apiRefId,\n        });\n      },\n      hasSignInPage(signInPageNode) {\n        return Boolean(\n          signInPageNode?.instance?.getData(signInPageComponentDataRef),\n        );\n      },\n    });\n    if (!result.requiresSignIn) {\n      phase.identityApiProxy.clearTargetHandlers();\n    }\n\n    runtime.requiresSignIn = result.requiresSignIn;\n    signInRuntime = runtime;\n    bootstrapApp = { ...result.bootstrapApp, apis: phase.apis };\n\n    return bootstrapApp;\n  }\n\n  return {\n    getBootstrapApp,\n    onFinalized(callback) {\n      finalization.selectMode('onFinalized');\n      // Subscribing to finalization also ensures the bootstrap tree exists,\n      // because sign-in may need to capture identity before finalization starts.\n      getBootstrapApp();\n\n      let subscribed = true;\n\n      if (finalized) {\n        const finalizedApp = finalized;\n        Promise.resolve().then(() => {\n          if (subscribed) {\n            callback(finalizedApp);\n          }\n        });\n        return () => {\n          subscribed = false;\n        };\n      }\n\n      // If sign-in is still in progress we wait for the shared promise created\n      // by the sign-in callback. Otherwise we can start finalization right away.\n      const finalizedAppPromise =\n        signInRuntime?.requiresSignIn && !signInRuntime.readyIdentityApi\n          ? finalization.getPromise()\n          : finalization.start(loadAsyncSessionState);\n      finalizedAppPromise\n        .then(finalizedApp => {\n          if (subscribed) {\n            callback(finalizedApp);\n          }\n        })\n        .catch(() => {});\n\n      return () => {\n        subscribed = false;\n      };\n    },\n    finalize() {\n      finalization.selectMode('finalize');\n      if (finalized) {\n        return finalized;\n      }\n      if (!providedSessionState) {\n        // finalize() still depends on bootstrap classification and sign-in\n        // discovery unless a reusable session was supplied up front, so we make\n        // sure the bootstrap tree has been prepared first.\n        getBootstrapApp();\n      }\n\n      // Direct finalization never waits for async session preparation. Callers\n      // must either provide sessionState during prepareSpecializedApp() or\n      // invoke finalize() only when the predicate context is already available\n      // synchronously.\n      const finalizedSessionState = signInRuntime?.requiresSignIn\n        ? undefined\n        : getSynchronousSessionState();\n      if (!finalizedSessionState) {\n        if (signInRuntime?.requiresSignIn) {\n          throw new Error(\n            'prepareSpecializedApp requires waiting for the bootstrap app to be ready before calling finalize()',\n          );\n        }\n        throw new Error(\n          'prepareSpecializedApp requires waiting for asynchronous finalization before calling finalize()',\n        );\n      }\n\n      finalized = finalizeWithSessionState(finalizedSessionState);\n      return finalized;\n    },\n  };\n}\n\n/**\n * Materializes the fully finalized app tree from a prepared session state.\n *\n * This is responsible for switching the identity proxy to the resolved target,\n * synchronizing any deferred API factories, and re-instantiating the parts of\n * the tree that are only valid once predicate context is available.\n */\nfunction finalizeFromSessionState(options: {\n  finalized?: FinalizedSpecializedApp;\n  finalizedSessionState: SpecializedAppSessionState;\n  tree: AppTree;\n  collector: ErrorCollector;\n  phase: ReturnType<typeof createPhaseApis>;\n  extensionFactoryMiddleware?: ExtensionFactoryMiddleware;\n  routeRefsById: ReturnType<typeof collectRouteIds>;\n  appBasePath: string;\n  providedApis?: ApiHolder;\n  features: FrontendFeature[];\n  appApiRegistry: FrontendApiRegistry;\n  bootstrapClassification: BootstrapClassification;\n  bootstrapApiFactoryEntries: Map<string, ApiFactoryEntry>;\n  bootstrapMissingApiAccesses: Map<string, { node: AppNode; apiRefId: string }>;\n}): FinalizedSpecializedApp {\n  if (options.finalized) {\n    return options.finalized;\n  }\n\n  const sessionStateData = OpaqueSpecializedAppSessionState.toInternal(\n    options.finalizedSessionState,\n  );\n  if (sessionStateData.identityApi) {\n    // Finalization retargets the identity proxy before any additional nodes are\n    // instantiated so the full tree observes the captured identity immediately.\n    setIdentityApiTarget({\n      identityApiProxy: options.phase.identityApiProxy,\n      identityApi: sessionStateData.identityApi,\n      signOutTargetUrl: options.appBasePath || '/',\n    });\n  }\n  if (!options.providedApis) {\n    // Deferred API roots are synchronized at finalization time, but bootstrap-\n    // materialized APIs stay frozen if they were already observed earlier.\n    syncFinalApiFactories({\n      deferredApiNodes: options.bootstrapClassification.deferredApiRoots,\n      appApiRegistry: options.appApiRegistry,\n      apiResolver: options.phase.apis,\n      collector: options.collector,\n      features: options.features,\n      bootstrapApiFactoryEntries: options.bootstrapApiFactoryEntries,\n      bootstrapMissingApiAccesses: options.bootstrapMissingApiAccesses,\n      predicateContext: sessionStateData.predicateContext,\n    });\n  }\n\n  prepareFinalizedTree({\n    tree: options.tree,\n  });\n  // Finalization re-instantiates the boundary subtree so predicate-gated app\n  // content can be re-evaluated without disturbing preserved bootstrap nodes.\n  clearFinalizationBoundaryInstances(options.tree);\n  instantiateAndInitializePhaseTree({\n    tree: options.tree,\n    apis: options.phase.apis,\n    collector: options.collector,\n    extensionFactoryMiddleware: options.extensionFactoryMiddleware,\n    routeResolutionApi: options.phase.routeResolutionApi,\n    appTreeApi: options.phase.appTreeApi,\n    routeRefsById: options.routeRefsById,\n    predicateContext: sessionStateData.predicateContext,\n  });\n\n  const element = options.tree.root.instance?.getData(\n    coreExtensionData.reactElement,\n  );\n  if (!element) {\n    throw new Error('Expected finalized app tree to expose a root element');\n  }\n\n  return {\n    apis: options.phase.apis,\n    element,\n    sessionState: options.finalizedSessionState,\n    tree: options.tree,\n    errors: options.collector.collectErrors(),\n  };\n}\n\n/**\n * Builds a finalized app that rethrows a bootstrap-time failure through the\n * normal app root boundary.\n *\n * This keeps the error handling path aligned with normal finalization while\n * preserving any session state that was already resolved before the failure.\n */\nfunction finalizeFromBootstrapError(options: {\n  finalized?: FinalizedSpecializedApp;\n  error: Error;\n  finalizedSessionState?: SpecializedAppSessionState;\n  tree: AppTree;\n  collector: ErrorCollector;\n  phase: ReturnType<typeof createPhaseApis>;\n  extensionFactoryMiddleware?: ExtensionFactoryMiddleware;\n  routeRefsById: ReturnType<typeof collectRouteIds>;\n  signInRuntime?: SignInRuntime;\n  providedSessionData?: InternalSpecializedAppSessionState;\n}): FinalizedSpecializedApp {\n  if (options.finalized) {\n    return options.finalized;\n  }\n\n  // If finalization fails after session state was already prepared, keep using\n  // it so the error app reflects the same identity and API view.\n  const finalizedSessionState =\n    options.finalizedSessionState ??\n    OpaqueSpecializedAppSessionState.createInstance('v1', {\n      apis: options.phase.apis,\n      identityApi:\n        options.signInRuntime?.readyIdentityApi ??\n        options.providedSessionData?.identityApi,\n      predicateContext: EMPTY_PREDICATE_CONTEXT,\n    });\n\n  prepareFinalizedTree({\n    tree: options.tree,\n  });\n  clearFinalizationBoundaryInstances(options.tree);\n  // The final app reports bootstrap failures through app/root.children so the\n  // normal app root boundary renders the error state for us.\n  attachThrowingFinalizationChild(options.tree, options.error);\n  instantiateAndInitializePhaseTree({\n    tree: options.tree,\n    apis: options.phase.apis,\n    collector: options.collector,\n    extensionFactoryMiddleware: options.extensionFactoryMiddleware,\n    routeResolutionApi: options.phase.routeResolutionApi,\n    appTreeApi: options.phase.appTreeApi,\n    routeRefsById: options.routeRefsById,\n  });\n\n  const element = options.tree.root.instance?.getData(\n    coreExtensionData.reactElement,\n  );\n  if (!element) {\n    throw new Error('Expected finalized app tree to expose a root element');\n  }\n\n  return {\n    apis: options.phase.apis,\n    element,\n    sessionState: finalizedSessionState,\n    tree: options.tree,\n  };\n}\n\n/**\n * Owns the callback-driven finalization lifecycle for a prepared app.\n *\n * The controller enforces the selected finalization mode, memoizes the shared\n * async finalization promise for `onFinalized()` subscribers, and funnels both\n * successful and failing async finalization through the same resolution path.\n */\nfunction createFinalizationController(options: {\n  getFinalized(): FinalizedSpecializedApp | undefined;\n  setFinalized(finalizedApp: FinalizedSpecializedApp): void;\n  finalizeFromSessionState(\n    finalizedSessionState: SpecializedAppSessionState,\n  ): FinalizedSpecializedApp;\n  finalizeFromBootstrapError(\n    error: Error,\n    finalizedSessionState?: SpecializedAppSessionState,\n  ): FinalizedSpecializedApp;\n}) {\n  let finalizationState: FinalizationState | undefined;\n  let finalizationMode: FinalizationMode | undefined;\n\n  function getState(): FinalizationState {\n    if (finalizationState) {\n      return finalizationState;\n    }\n\n    // onFinalized() subscribers all fan into the same promise so that the full\n    // finalization flow only ever runs once.\n    let resolve: ((app: FinalizedSpecializedApp) => void) | undefined;\n    let reject: ((error: unknown) => void) | undefined;\n    const promise = new Promise<FinalizedSpecializedApp>((res, rej) => {\n      resolve = res;\n      reject = rej;\n    });\n    if (!resolve || !reject) {\n      throw new Error('Failed to create finalization state');\n    }\n\n    finalizationState = {\n      started: false,\n      promise,\n      resolve,\n      reject,\n    };\n    return finalizationState;\n  }\n\n  return {\n    getMode() {\n      return finalizationMode;\n    },\n    getPromise() {\n      return getState().promise;\n    },\n    selectMode(mode: FinalizationMode) {\n      if (finalizationMode && finalizationMode !== mode) {\n        throw new Error(\n          `prepareSpecializedApp only supports using either onFinalized() or finalize(), not both`,\n        );\n      }\n\n      // A prepared app now has one owner: either the callback-driven path or\n      // the direct finalize() path, never both.\n      finalizationMode = mode;\n    },\n    start(loader: () => Promise<SpecializedAppSessionState>) {\n      const finalized = options.getFinalized();\n      if (finalized) {\n        return Promise.resolve(finalized);\n      }\n\n      const state = getState();\n      if (state.started) {\n        return state.promise;\n      }\n      state.started = true;\n\n      // If loading finishes but final tree materialization fails, we still\n      // want to preserve the resolved session state when building the error app.\n      let finalizedSessionState: SpecializedAppSessionState | undefined;\n      loader()\n        .then(sessionState => {\n          finalizedSessionState = sessionState;\n          const finalizedApp = options.finalizeFromSessionState(sessionState);\n          options.setFinalized(finalizedApp);\n          state.resolve(finalizedApp);\n        })\n        .catch(error => {\n          try {\n            const bootstrapFailure = isError(error)\n              ? error\n              : new Error(String(error));\n            const finalizedApp = options.finalizeFromBootstrapError(\n              bootstrapFailure,\n              finalizedSessionState,\n            );\n            options.setFinalized(finalizedApp);\n            state.resolve(finalizedApp);\n          } catch (finalizationError) {\n            finalizationState = undefined;\n            state.reject(finalizationError);\n          }\n        });\n\n      return state.promise;\n    },\n  };\n}\n\n/**\n * Combines one or more extension factory middlewares into a single middleware\n * invocation chain that preserves Backstage's extension data container shape.\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":"prepareSpecializedApp.esm.js","sources":["../../src/wiring/prepareSpecializedApp.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 { isError } from '@backstage/errors';\nimport {\n  AnyApiFactory,\n  ApiHolder,\n  AppTree,\n  ConfigApi,\n  coreExtensionData,\n  AppNode,\n  ExtensionFactoryMiddleware,\n  FrontendFeature,\n  IdentityApi,\n  identityApiRef,\n  createExtensionDataRef,\n} from '@backstage/frontend-plugin-api';\nimport {\n  createExtensionDataContainer,\n  OpaqueFrontendPlugin,\n} from '@internal/frontend';\nimport { OpaqueType } from '@internal/opaque';\nimport { ComponentType, ReactNode } from 'react';\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 { CreateAppRouteBinder } from '../routing';\nimport { resolveRouteBindings } from '../routing/resolveRouteBindings';\nimport { collectRouteIds } from '../routing/collectRouteIds';\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 {\n  createPluginInfoAttacher,\n  FrontendPluginInfoResolver,\n} from './createPluginInfoAttacher';\nimport {\n  AppError,\n  createErrorCollector,\n  ErrorCollector,\n} from './createErrorCollector';\nimport {\n  createPhaseApis,\n  instantiateAndInitializePhaseTree,\n  setIdentityApiTarget,\n} from './phaseApis';\nimport {\n  collectPredicateReferences,\n  createPredicateContextLoader,\n  EMPTY_PREDICATE_CONTEXT,\n  type ExtensionPredicateContext,\n} from './predicates';\nimport { FrontendApiRegistry } from './FrontendApiRegistry';\nimport {\n  ApiFactoryEntry,\n  collectApiFactoryEntries,\n  registerFeatureFlagDeclarationsInHolder,\n  syncFinalApiFactories,\n  wrapFeatureFlagApiFactory,\n} from './apiFactories';\nimport {\n  attachThrowingFinalizationChild,\n  BootstrapClassification,\n  classifyBootstrapTree,\n  clearFinalizationBoundaryInstances,\n  createBootstrapApp,\n  prepareFinalizedTree,\n} from './treeLifecycle';\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\ntype SignInPageProps = {\n  onSignInSuccess(identityApi: IdentityApi): void;\n  children?: ReactNode;\n};\n\n/**\n * Result of bootstrapping a prepared specialized app.\n *\n * @public\n */\nexport type BootstrapSpecializedApp = {\n  apis: ApiHolder;\n  element: JSX.Element;\n  tree: AppTree;\n};\n\n/**\n * Result of finalizing a prepared specialized app.\n *\n * @public\n */\nexport type FinalizedSpecializedApp = {\n  apis: ApiHolder;\n  element: JSX.Element;\n  sessionState: SpecializedAppSessionState;\n  tree: AppTree;\n  errors?: AppError[];\n};\n\ntype SignInRuntime = {\n  readyIdentityApi?: IdentityApi;\n  requiresSignIn: boolean;\n};\n\ntype FinalizationState = {\n  started: boolean;\n  promise: Promise<FinalizedSpecializedApp>;\n  resolve(app: FinalizedSpecializedApp): void;\n  reject(error: unknown): void;\n};\n\ntype FinalizationMode = 'onFinalized' | 'finalize';\n\ntype InternalSpecializedAppSessionState = {\n  apis: ApiHolder;\n  identityApi?: IdentityApi;\n  predicateContext: ExtensionPredicateContext;\n};\n\n/**\n * Opaque reusable session state for specialized apps.\n *\n * @public\n */\nexport type SpecializedAppSessionState = {\n  $$type: '@backstage/SpecializedAppSessionState';\n};\n\nconst OpaqueSpecializedAppSessionState = OpaqueType.create<{\n  public: SpecializedAppSessionState;\n  versions: InternalSpecializedAppSessionState & {\n    version: 'v1';\n  };\n}>({\n  type: '@backstage/SpecializedAppSessionState',\n  versions: ['v1'],\n});\n\nconst signInPageComponentDataRef = createExtensionDataRef<\n  ComponentType<SignInPageProps>\n>().with({ id: 'core.sign-in-page.component' });\n\n/**\n * Options for {@link prepareSpecializedApp}.\n *\n * @public\n */\nexport type PrepareSpecializedAppOptions = {\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 reusable specialized app session state to use.\n     *\n     * This can be obtained from either the app passed to\n     * {@link PreparedSpecializedApp.onFinalized} or from\n     * {@link PreparedSpecializedApp.finalize}, and reused in a future app\n     * instance to skip sign-in and session preparation.\n     */\n    sessionState?: SpecializedAppSessionState;\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 * Result of {@link prepareSpecializedApp}.\n *\n * @public\n */\nexport type PreparedSpecializedApp = {\n  getBootstrapApp(): BootstrapSpecializedApp;\n  onFinalized(callback: (app: FinalizedSpecializedApp) => void): () => void;\n  finalize(): FinalizedSpecializedApp;\n};\n\n// Internal options type, not exported in the public API\nexport interface CreateSpecializedAppInternalOptions\n  extends PrepareSpecializedAppOptions {\n  __internal?: {\n    apiFactoryOverrides?: AnyApiFactory[];\n  };\n}\n\nexport function createSessionStateFromApis(\n  apis: ApiHolder,\n): SpecializedAppSessionState {\n  return OpaqueSpecializedAppSessionState.createInstance('v1', {\n    apis,\n    identityApi: apis.get(identityApiRef),\n    predicateContext: EMPTY_PREDICATE_CONTEXT,\n  });\n}\n\n/**\n * Prepares an app without instantiating the full extension tree.\n *\n * @remarks\n *\n * This is useful for split sign-in flows where the sign-in page should be\n * rendered first, and the full app finalized once an identity has been\n * captured.\n *\n * @public\n */\nexport function prepareSpecializedApp(\n  options?: PrepareSpecializedAppOptions,\n): PreparedSpecializedApp {\n  const internalOptions = options as CreateSpecializedAppInternalOptions;\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 appBasePath = getBasePath(config);\n  const routeRefsById = collectRouteIds(features, collector);\n  const routeBindings = resolveRouteBindings(\n    options?.bindRoutes,\n    config,\n    routeRefsById,\n    collector,\n  );\n\n  const mergedExtensionFactoryMiddleware = mergeExtensionFactoryMiddleware(\n    options?.advanced?.extensionFactoryMiddleware,\n  );\n  const providedSessionState = options?.advanced?.sessionState;\n  const providedSessionData = providedSessionState\n    ? OpaqueSpecializedAppSessionState.toInternal(providedSessionState)\n    : undefined;\n  const providedApis = providedSessionData?.apis;\n  // Bootstrap only renders the parts of the tree that are known to be safe\n  // before predicate context and sign-in have been resolved.\n  const bootstrapClassification = classifyBootstrapTree({\n    tree,\n    collector,\n  });\n  const predicateReferences = collectPredicateReferences(tree.nodes.values());\n  const appApiRegistry = new FrontendApiRegistry();\n  const internalStaticFactories =\n    internalOptions?.__internal?.apiFactoryOverrides ?? [];\n  const phaseStaticFactories = [...internalStaticFactories];\n  const bootstrapApiFactoryEntries = new Map<string, ApiFactoryEntry>();\n  const bootstrapMissingApiAccesses = new Map<\n    string,\n    { node: AppNode; apiRefId: string }\n  >();\n\n  if (providedApis) {\n    // Reused session state already carries a fully prepared API holder, so the\n    // bootstrap path only needs to register feature flag declarations on top.\n    registerFeatureFlagDeclarationsInHolder(providedApis, features, collector);\n  } else {\n    // Bootstrap materializes only the immediately visible API factories. Any\n    // predicate-gated API roots are revisited during finalization.\n    collectApiFactoryEntries({\n      apiNodes: (tree.root.edges.attachments.get('apis') ?? []).filter(\n        apiNode => !bootstrapClassification.deferredApiRoots.has(apiNode),\n      ),\n      collector,\n      entries: bootstrapApiFactoryEntries,\n    });\n    const apiFactories = Array.from(\n      bootstrapApiFactoryEntries.values(),\n      entry => wrapFeatureFlagApiFactory(entry.factory, features, collector),\n    );\n    appApiRegistry.registerAll(apiFactories);\n  }\n  const phase = createPhaseApis({\n    tree,\n    config,\n    appApiRegistry,\n    fallbackApis: providedApis,\n    includeConfigApi: !providedApis,\n    appBasePath,\n    routeBindings,\n    staticFactories: phaseStaticFactories,\n  });\n  const predicateContextLoader = createPredicateContextLoader({\n    apis: phase.apis,\n    predicateReferences,\n  });\n  let signInRuntime: SignInRuntime | undefined;\n  let finalized: FinalizedSpecializedApp | undefined;\n  let bootstrapApp: BootstrapSpecializedApp | undefined;\n\n  function updateIdentityApiTarget(identityApi?: IdentityApi) {\n    if (!identityApi) {\n      return;\n    }\n\n    setIdentityApiTarget({\n      identityApiProxy: phase.identityApiProxy,\n      identityApi,\n      signOutTargetUrl: appBasePath || '/',\n    });\n  }\n\n  function createSessionState(predicateContext: ExtensionPredicateContext) {\n    const identityApi =\n      signInRuntime?.readyIdentityApi ?? providedSessionData?.identityApi;\n    // As soon as a real identity is available we swap the phase proxy over so\n    // the finalized tree observes the same API instance.\n    updateIdentityApiTarget(identityApi);\n    const sessionState = OpaqueSpecializedAppSessionState.createInstance('v1', {\n      apis: phase.apis,\n      identityApi,\n      predicateContext,\n    });\n    return sessionState;\n  }\n\n  function getSynchronousSessionState() {\n    if (providedSessionState) {\n      return providedSessionState;\n    }\n    // The direct finalize() path is intentionally synchronous. If sign-in is\n    // still pending we refuse to guess and force the caller to wait.\n    if (signInRuntime?.requiresSignIn) {\n      return undefined;\n    }\n\n    const predicateContext = predicateContextLoader.getImmediate();\n    if (!predicateContext) {\n      return undefined;\n    }\n\n    return createSessionState(predicateContext);\n  }\n\n  function loadAsyncSessionState() {\n    if (providedSessionState) {\n      return Promise.resolve(providedSessionState);\n    }\n    if (signInRuntime?.requiresSignIn && !signInRuntime.readyIdentityApi) {\n      return Promise.reject(\n        new Error(\n          'prepareSpecializedApp requires waiting for the bootstrap app to be ready before calling finalize()',\n        ),\n      );\n    }\n\n    // For apps without sign-in we can sometimes finalize immediately from the\n    // already available predicate context, skipping the async loader.\n    if (!signInRuntime?.requiresSignIn) {\n      const immediateSessionState = getSynchronousSessionState();\n      if (immediateSessionState) {\n        return Promise.resolve(immediateSessionState);\n      }\n    }\n\n    return predicateContextLoader.load().then(createSessionState);\n  }\n\n  function finalizeWithSessionState(\n    finalizedSessionState: SpecializedAppSessionState,\n  ) {\n    return finalizeFromSessionState({\n      finalized,\n      finalizedSessionState,\n      tree,\n      collector,\n      phase,\n      extensionFactoryMiddleware: mergedExtensionFactoryMiddleware,\n      routeRefsById,\n      appBasePath,\n      providedApis,\n      features,\n      appApiRegistry,\n      bootstrapClassification,\n      bootstrapApiFactoryEntries,\n      bootstrapMissingApiAccesses,\n    });\n  }\n\n  function finalizeWithBootstrapError(\n    error: Error,\n    finalizedSessionState?: SpecializedAppSessionState,\n  ) {\n    return finalizeFromBootstrapError({\n      finalized,\n      error,\n      finalizedSessionState,\n      tree,\n      collector,\n      phase,\n      extensionFactoryMiddleware: mergedExtensionFactoryMiddleware,\n      routeRefsById,\n      signInRuntime,\n      providedSessionData,\n    });\n  }\n\n  const finalization = createFinalizationController({\n    getFinalized() {\n      return finalized;\n    },\n    setFinalized(finalizedApp) {\n      finalized = finalizedApp;\n    },\n    finalizeFromSessionState: finalizeWithSessionState,\n    finalizeFromBootstrapError: finalizeWithBootstrapError,\n  });\n\n  function getBootstrapApp() {\n    if (bootstrapApp) {\n      return bootstrapApp;\n    }\n\n    const runtime: SignInRuntime = {\n      requiresSignIn: false,\n    };\n    if (!providedSessionState) {\n      phase.identityApiProxy.setTargetHandlers({\n        onTargetSet(identityApi) {\n          runtime.readyIdentityApi = identityApi;\n          // Sign-in completion only auto-starts finalization for onFinalized().\n          // The direct finalize() path stays explicit and synchronous.\n          if (finalization.getMode() === 'onFinalized') {\n            finalization.start(loadAsyncSessionState);\n          }\n        },\n      });\n    }\n\n    const result = createBootstrapApp({\n      tree,\n      apis: phase.apis,\n      collector,\n      routeRefsById,\n      routeResolutionApi: phase.routeResolutionApi,\n      appTreeApi: phase.appTreeApi,\n      extensionFactoryMiddleware: mergedExtensionFactoryMiddleware,\n      disableSignIn: Boolean(providedSessionState),\n      skipBootstrapChild({ child }) {\n        return bootstrapClassification.deferredRoots.has(child);\n      },\n      onMissingApi({ node, apiRefId }) {\n        bootstrapMissingApiAccesses.set(`${node.spec.id}:${apiRefId}`, {\n          node,\n          apiRefId,\n        });\n      },\n      hasSignInPage(signInPageNode) {\n        return Boolean(\n          signInPageNode?.instance?.getData(signInPageComponentDataRef),\n        );\n      },\n    });\n    if (!result.requiresSignIn) {\n      phase.identityApiProxy.clearTargetHandlers();\n    }\n\n    runtime.requiresSignIn = result.requiresSignIn;\n    signInRuntime = runtime;\n    bootstrapApp = { ...result.bootstrapApp, apis: phase.apis };\n\n    return bootstrapApp;\n  }\n\n  return {\n    getBootstrapApp,\n    onFinalized(callback) {\n      finalization.selectMode('onFinalized');\n      // Subscribing to finalization also ensures the bootstrap tree exists,\n      // because sign-in may need to capture identity before finalization starts.\n      getBootstrapApp();\n\n      let subscribed = true;\n\n      if (finalized) {\n        const finalizedApp = finalized;\n        Promise.resolve().then(() => {\n          if (subscribed) {\n            callback(finalizedApp);\n          }\n        });\n        return () => {\n          subscribed = false;\n        };\n      }\n\n      // If sign-in is still in progress we wait for the shared promise created\n      // by the sign-in callback. Otherwise we can start finalization right away.\n      const finalizedAppPromise =\n        signInRuntime?.requiresSignIn && !signInRuntime.readyIdentityApi\n          ? finalization.getPromise()\n          : finalization.start(loadAsyncSessionState);\n      finalizedAppPromise\n        .then(finalizedApp => {\n          if (subscribed) {\n            callback(finalizedApp);\n          }\n        })\n        .catch(() => {});\n\n      return () => {\n        subscribed = false;\n      };\n    },\n    finalize() {\n      finalization.selectMode('finalize');\n      if (finalized) {\n        return finalized;\n      }\n      if (!providedSessionState) {\n        // finalize() still depends on bootstrap classification and sign-in\n        // discovery unless a reusable session was supplied up front, so we make\n        // sure the bootstrap tree has been prepared first.\n        getBootstrapApp();\n      }\n\n      // Direct finalization never waits for async session preparation. Callers\n      // must either provide sessionState during prepareSpecializedApp() or\n      // invoke finalize() only when the predicate context is already available\n      // synchronously.\n      const finalizedSessionState = signInRuntime?.requiresSignIn\n        ? undefined\n        : getSynchronousSessionState();\n      if (!finalizedSessionState) {\n        if (signInRuntime?.requiresSignIn) {\n          throw new Error(\n            'prepareSpecializedApp requires waiting for the bootstrap app to be ready before calling finalize()',\n          );\n        }\n        throw new Error(\n          'prepareSpecializedApp requires waiting for asynchronous finalization before calling finalize()',\n        );\n      }\n\n      finalized = finalizeWithSessionState(finalizedSessionState);\n      return finalized;\n    },\n  };\n}\n\n/**\n * Materializes the fully finalized app tree from a prepared session state.\n *\n * This is responsible for switching the identity proxy to the resolved target,\n * synchronizing any deferred API factories, and re-instantiating the parts of\n * the tree that are only valid once predicate context is available.\n */\nfunction finalizeFromSessionState(options: {\n  finalized?: FinalizedSpecializedApp;\n  finalizedSessionState: SpecializedAppSessionState;\n  tree: AppTree;\n  collector: ErrorCollector;\n  phase: ReturnType<typeof createPhaseApis>;\n  extensionFactoryMiddleware?: ExtensionFactoryMiddleware;\n  routeRefsById: ReturnType<typeof collectRouteIds>;\n  appBasePath: string;\n  providedApis?: ApiHolder;\n  features: FrontendFeature[];\n  appApiRegistry: FrontendApiRegistry;\n  bootstrapClassification: BootstrapClassification;\n  bootstrapApiFactoryEntries: Map<string, ApiFactoryEntry>;\n  bootstrapMissingApiAccesses: Map<string, { node: AppNode; apiRefId: string }>;\n}): FinalizedSpecializedApp {\n  if (options.finalized) {\n    return options.finalized;\n  }\n\n  const sessionStateData = OpaqueSpecializedAppSessionState.toInternal(\n    options.finalizedSessionState,\n  );\n  if (sessionStateData.identityApi) {\n    // Finalization retargets the identity proxy before any additional nodes are\n    // instantiated so the full tree observes the captured identity immediately.\n    setIdentityApiTarget({\n      identityApiProxy: options.phase.identityApiProxy,\n      identityApi: sessionStateData.identityApi,\n      signOutTargetUrl: options.appBasePath || '/',\n    });\n  }\n  if (!options.providedApis) {\n    // Deferred API roots are synchronized at finalization time, but bootstrap-\n    // materialized APIs stay frozen if they were already observed earlier.\n    syncFinalApiFactories({\n      deferredApiNodes: options.bootstrapClassification.deferredApiRoots,\n      appApiRegistry: options.appApiRegistry,\n      apiResolver: options.phase.apis,\n      collector: options.collector,\n      features: options.features,\n      bootstrapApiFactoryEntries: options.bootstrapApiFactoryEntries,\n      bootstrapMissingApiAccesses: options.bootstrapMissingApiAccesses,\n      predicateContext: sessionStateData.predicateContext,\n    });\n  }\n\n  prepareFinalizedTree({\n    tree: options.tree,\n  });\n  // Finalization re-instantiates the boundary subtree so predicate-gated app\n  // content can be re-evaluated without disturbing preserved bootstrap nodes.\n  clearFinalizationBoundaryInstances(options.tree);\n  instantiateAndInitializePhaseTree({\n    tree: options.tree,\n    apis: options.phase.apis,\n    collector: options.collector,\n    extensionFactoryMiddleware: options.extensionFactoryMiddleware,\n    routeResolutionApi: options.phase.routeResolutionApi,\n    appTreeApi: options.phase.appTreeApi,\n    routeRefsById: options.routeRefsById,\n    predicateContext: sessionStateData.predicateContext,\n  });\n\n  const element = options.tree.root.instance?.getData(\n    coreExtensionData.reactElement,\n  );\n  if (!element) {\n    throw new Error('Expected finalized app tree to expose a root element');\n  }\n\n  return {\n    apis: options.phase.apis,\n    element,\n    sessionState: options.finalizedSessionState,\n    tree: options.tree,\n    errors: options.collector.collectErrors(),\n  };\n}\n\n/**\n * Builds a finalized app that rethrows a bootstrap-time failure through the\n * normal app root boundary.\n *\n * This keeps the error handling path aligned with normal finalization while\n * preserving any session state that was already resolved before the failure.\n */\nfunction finalizeFromBootstrapError(options: {\n  finalized?: FinalizedSpecializedApp;\n  error: Error;\n  finalizedSessionState?: SpecializedAppSessionState;\n  tree: AppTree;\n  collector: ErrorCollector;\n  phase: ReturnType<typeof createPhaseApis>;\n  extensionFactoryMiddleware?: ExtensionFactoryMiddleware;\n  routeRefsById: ReturnType<typeof collectRouteIds>;\n  signInRuntime?: SignInRuntime;\n  providedSessionData?: InternalSpecializedAppSessionState;\n}): FinalizedSpecializedApp {\n  if (options.finalized) {\n    return options.finalized;\n  }\n\n  // If finalization fails after session state was already prepared, keep using\n  // it so the error app reflects the same identity and API view.\n  const finalizedSessionState =\n    options.finalizedSessionState ??\n    OpaqueSpecializedAppSessionState.createInstance('v1', {\n      apis: options.phase.apis,\n      identityApi:\n        options.signInRuntime?.readyIdentityApi ??\n        options.providedSessionData?.identityApi,\n      predicateContext: EMPTY_PREDICATE_CONTEXT,\n    });\n\n  prepareFinalizedTree({\n    tree: options.tree,\n  });\n  clearFinalizationBoundaryInstances(options.tree);\n  // The final app reports bootstrap failures through app/root.children so the\n  // normal app root boundary renders the error state for us.\n  attachThrowingFinalizationChild(options.tree, options.error);\n  instantiateAndInitializePhaseTree({\n    tree: options.tree,\n    apis: options.phase.apis,\n    collector: options.collector,\n    extensionFactoryMiddleware: options.extensionFactoryMiddleware,\n    routeResolutionApi: options.phase.routeResolutionApi,\n    appTreeApi: options.phase.appTreeApi,\n    routeRefsById: options.routeRefsById,\n  });\n\n  const element = options.tree.root.instance?.getData(\n    coreExtensionData.reactElement,\n  );\n  if (!element) {\n    throw new Error('Expected finalized app tree to expose a root element');\n  }\n\n  return {\n    apis: options.phase.apis,\n    element,\n    sessionState: finalizedSessionState,\n    tree: options.tree,\n  };\n}\n\n/**\n * Owns the callback-driven finalization lifecycle for a prepared app.\n *\n * The controller enforces the selected finalization mode, memoizes the shared\n * async finalization promise for `onFinalized()` subscribers, and funnels both\n * successful and failing async finalization through the same resolution path.\n */\nfunction createFinalizationController(options: {\n  getFinalized(): FinalizedSpecializedApp | undefined;\n  setFinalized(finalizedApp: FinalizedSpecializedApp): void;\n  finalizeFromSessionState(\n    finalizedSessionState: SpecializedAppSessionState,\n  ): FinalizedSpecializedApp;\n  finalizeFromBootstrapError(\n    error: Error,\n    finalizedSessionState?: SpecializedAppSessionState,\n  ): FinalizedSpecializedApp;\n}) {\n  let finalizationState: FinalizationState | undefined;\n  let finalizationMode: FinalizationMode | undefined;\n\n  function getState(): FinalizationState {\n    if (finalizationState) {\n      return finalizationState;\n    }\n\n    // onFinalized() subscribers all fan into the same promise so that the full\n    // finalization flow only ever runs once.\n    let resolve: ((app: FinalizedSpecializedApp) => void) | undefined;\n    let reject: ((error: unknown) => void) | undefined;\n    const promise = new Promise<FinalizedSpecializedApp>((res, rej) => {\n      resolve = res;\n      reject = rej;\n    });\n    if (!resolve || !reject) {\n      throw new Error('Failed to create finalization state');\n    }\n\n    finalizationState = {\n      started: false,\n      promise,\n      resolve,\n      reject,\n    };\n    return finalizationState;\n  }\n\n  return {\n    getMode() {\n      return finalizationMode;\n    },\n    getPromise() {\n      return getState().promise;\n    },\n    selectMode(mode: FinalizationMode) {\n      if (finalizationMode && finalizationMode !== mode) {\n        throw new Error(\n          `prepareSpecializedApp only supports using either onFinalized() or finalize(), not both`,\n        );\n      }\n\n      // A prepared app now has one owner: either the callback-driven path or\n      // the direct finalize() path, never both.\n      finalizationMode = mode;\n    },\n    start(loader: () => Promise<SpecializedAppSessionState>) {\n      const finalized = options.getFinalized();\n      if (finalized) {\n        return Promise.resolve(finalized);\n      }\n\n      const state = getState();\n      if (state.started) {\n        return state.promise;\n      }\n      state.started = true;\n\n      // If loading finishes but final tree materialization fails, we still\n      // want to preserve the resolved session state when building the error app.\n      let finalizedSessionState: SpecializedAppSessionState | undefined;\n      loader()\n        .then(sessionState => {\n          finalizedSessionState = sessionState;\n          const finalizedApp = options.finalizeFromSessionState(sessionState);\n          options.setFinalized(finalizedApp);\n          state.resolve(finalizedApp);\n        })\n        .catch(error => {\n          try {\n            const bootstrapFailure = isError(error)\n              ? error\n              : new Error(String(error));\n            const finalizedApp = options.finalizeFromBootstrapError(\n              bootstrapFailure,\n              finalizedSessionState,\n            );\n            options.setFinalized(finalizedApp);\n            state.resolve(finalizedApp);\n          } catch (finalizationError) {\n            finalizationState = undefined;\n            state.reject(finalizationError);\n          }\n        });\n\n      return state.promise;\n    },\n  };\n}\n\n/**\n * Combines one or more extension factory middlewares into a single middleware\n * invocation chain that preserves Backstage's extension data container shape.\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.16.2",
+  "version": "0.16.3-next.1",
   "backstage": {
     "role": "web-library"
   },
@@ -32,24 +32,24 @@
     "test": "backstage-cli package test"
   },
   "dependencies": {
-    "@backstage/config": "^1.3.7",
-    "@backstage/core-app-api": "^1.20.0",
-    "@backstage/core-plugin-api": "^1.12.5",
-    "@backstage/errors": "^1.3.0",
-    "@backstage/filter-predicates": "^0.1.2",
-    "@backstage/frontend-defaults": "^0.5.1",
-    "@backstage/frontend-plugin-api": "^0.16.0",
-    "@backstage/types": "^1.2.2",
-    "@backstage/version-bridge": "^1.0.12",
+    "@backstage/config": "1.3.8-next.0",
+    "@backstage/core-app-api": "1.20.1-next.0",
+    "@backstage/core-plugin-api": "1.12.6-next.1",
+    "@backstage/errors": "1.3.1-next.0",
+    "@backstage/filter-predicates": "0.1.3-next.0",
+    "@backstage/frontend-defaults": "0.5.2-next.1",
+    "@backstage/frontend-plugin-api": "0.17.0-next.1",
+    "@backstage/types": "1.2.2",
+    "@backstage/version-bridge": "1.0.12",
     "lodash": "^4.17.21",
     "zod": "^3.25.76 || ^4.0.0"
   },
   "devDependencies": {
-    "@backstage/cli": "^0.36.1",
-    "@backstage/frontend-test-utils": "^0.5.2",
-    "@backstage/plugin-app": "^0.4.3",
-    "@backstage/plugin-permission-common": "^0.9.8",
-    "@backstage/test-utils": "^1.7.17",
+    "@backstage/cli": "0.36.2-next.1",
+    "@backstage/frontend-test-utils": "0.5.3-next.1",
+    "@backstage/plugin-app": "0.4.6-next.1",
+    "@backstage/plugin-permission-common": "0.9.9-next.1",
+    "@backstage/test-utils": "1.7.18-next.0",
     "@testing-library/jest-dom": "^6.0.0",
     "@testing-library/react": "^16.0.0",
     "@types/react": "^18.0.0",