@backstage/frontend-app-api 0.16.8 → 0.16.9-next.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/dist/catalog-model/src/entity/constants.esm.js.map +1 -1
  3. package/dist/catalog-model/src/entity/ref.esm.js.map +1 -1
  4. package/dist/core-app-api/src/apis/implementations/IdentityApi/AppIdentityProxy.esm.js.map +1 -1
  5. package/dist/core-app-api/src/apis/implementations/IdentityApi/startCookieAuthRefresh.esm.js.map +1 -1
  6. package/dist/extensions/Root.esm.js.map +1 -1
  7. package/dist/frontend-internal/src/apis/OpaqueApiRef.esm.js.map +1 -1
  8. package/dist/frontend-internal/src/routing/OpaqueExternalRouteRef.esm.js.map +1 -1
  9. package/dist/frontend-internal/src/routing/OpaqueRouteRef.esm.js.map +1 -1
  10. package/dist/frontend-internal/src/routing/OpaqueSubRouteRef.esm.js.map +1 -1
  11. package/dist/frontend-internal/src/wiring/InternalExtensionDefinition.esm.js.map +1 -1
  12. package/dist/frontend-internal/src/wiring/InternalExtensionInput.esm.js.map +1 -1
  13. package/dist/frontend-internal/src/wiring/InternalFrontendPlugin.esm.js.map +1 -1
  14. package/dist/frontend-internal/src/wiring/createExtensionDataContainer.esm.js.map +1 -1
  15. package/dist/frontend-plugin-api/src/wiring/createFrontendModule.esm.js.map +1 -1
  16. package/dist/frontend-plugin-api/src/wiring/resolveExtensionDefinition.esm.js.map +1 -1
  17. package/dist/opaque-internal/src/OpaqueType.esm.js.map +1 -1
  18. package/dist/routing/RouteAliasResolver.esm.js.map +1 -1
  19. package/dist/routing/RouteResolver.esm.js.map +1 -1
  20. package/dist/routing/collectRouteIds.esm.js.map +1 -1
  21. package/dist/routing/extractRouteInfoFromAppNode.esm.js.map +1 -1
  22. package/dist/routing/getBasePath.esm.js.map +1 -1
  23. package/dist/routing/joinPaths.esm.js.map +1 -1
  24. package/dist/routing/resolveRouteBindings.esm.js.map +1 -1
  25. package/dist/tree/instantiateAppNodeTree.esm.js.map +1 -1
  26. package/dist/tree/readAppExtensionsConfig.esm.js.map +1 -1
  27. package/dist/tree/resolveAppNodeSpecs.esm.js.map +1 -1
  28. package/dist/tree/resolveAppTree.esm.js.map +1 -1
  29. package/dist/wiring/FrontendApiRegistry.esm.js.map +1 -1
  30. package/dist/wiring/apiFactories.esm.js.map +1 -1
  31. package/dist/wiring/createErrorCollector.esm.js.map +1 -1
  32. package/dist/wiring/createPluginInfoAttacher.esm.js.map +1 -1
  33. package/dist/wiring/createSpecializedApp.esm.js.map +1 -1
  34. package/dist/wiring/phaseApis.esm.js.map +1 -1
  35. package/dist/wiring/predicates.esm.js.map +1 -1
  36. package/dist/wiring/prepareSpecializedApp.esm.js.map +1 -1
  37. package/dist/wiring/treeLifecycle.esm.js.map +1 -1
  38. package/package.json +15 -15
@@ -1 +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 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;;;;"}
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 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;;"}
@@ -1 +1 @@
1
- {"version":3,"file":"createPluginInfoAttacher.esm.js","sources":["../../src/wiring/createPluginInfoAttacher.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 { ConfigApi } from '@backstage/frontend-plugin-api';\nimport {\n FrontendFeature,\n FrontendPluginInfo,\n} from '@backstage/frontend-plugin-api';\nimport { OpaqueFrontendPlugin } from '@internal/frontend';\nimport { JsonObject, JsonValue } from '@backstage/types';\nimport once from 'lodash/once';\n// Avoid full dependency on catalog-model\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport {\n parseEntityRef,\n stringifyEntityRef,\n} from '../../../catalog-model/src/entity/ref';\n\n/**\n * A function that resolves plugin info from a plugin manifest and package.json.\n *\n * @public\n */\nexport type FrontendPluginInfoResolver = (ctx: {\n packageJson(): Promise<JsonObject | undefined>;\n manifest(): Promise<JsonObject | undefined>;\n defaultResolver(sources: {\n packageJson: JsonObject | undefined;\n manifest: JsonObject | undefined;\n }): Promise<{ info: FrontendPluginInfo }>;\n}) => Promise<{ info: FrontendPluginInfo }>;\n\nexport function createPluginInfoAttacher(\n config: ConfigApi,\n infoResolver: FrontendPluginInfoResolver = async ctx =>\n ctx.defaultResolver({\n packageJson: await ctx.packageJson(),\n manifest: await ctx.manifest(),\n }),\n): (feature: FrontendFeature) => FrontendFeature {\n const applyInfoOverrides = createPluginInfoOverrider(config);\n\n return (feature: FrontendFeature) => {\n if (!OpaqueFrontendPlugin.isType(feature)) {\n return feature;\n }\n\n const plugin = OpaqueFrontendPlugin.toInternal(feature);\n\n return {\n ...plugin,\n info: once(async () => {\n const manifestLoader = plugin.infoOptions?.manifest;\n const packageJsonLoader = plugin.infoOptions?.packageJson;\n\n const { info: resolvedInfo } = await infoResolver({\n manifest: async () => manifestLoader?.(),\n packageJson: async () => packageJsonLoader?.(),\n defaultResolver: async sources => ({\n info: {\n ...resolvePackageInfo(sources.packageJson),\n ...resolveManifestInfo(sources.manifest),\n },\n }),\n });\n\n const infoWithOverrides = applyInfoOverrides(\n plugin.pluginId,\n resolvedInfo,\n );\n return normalizePluginInfo(infoWithOverrides);\n }),\n };\n };\n}\n\nfunction normalizePluginInfo(info: FrontendPluginInfo) {\n return {\n ...info,\n ownerEntityRefs: info.ownerEntityRefs?.map(ref =>\n stringifyEntityRef(\n parseEntityRef(ref, {\n defaultKind: 'Group',\n }),\n ),\n ),\n };\n}\n\nfunction createPluginInfoOverrider(config: ConfigApi) {\n const overrideConfigs =\n config.getOptionalConfigArray('app.pluginOverrides') ?? [];\n\n const overrideMatchers = overrideConfigs.map(overrideConfig => {\n const pluginIdMatcher = makeStringMatcher(\n overrideConfig.getOptionalString('match.pluginId'),\n );\n const packageNameMatcher = makeStringMatcher(\n overrideConfig.getOptionalString('match.packageName'),\n );\n const description = overrideConfig.getOptionalString('info.description');\n const ownerEntityRefs = overrideConfig.getOptionalStringArray(\n 'info.ownerEntityRefs',\n );\n const links = overrideConfig\n .getOptionalConfigArray('info.links')\n ?.map(linkConfig => ({\n title: linkConfig.getString('title'),\n url: linkConfig.getString('url'),\n }));\n\n return {\n test(pluginId: string, packageName?: string) {\n return packageNameMatcher(packageName) && pluginIdMatcher(pluginId);\n },\n info: {\n description,\n ownerEntityRefs,\n links,\n },\n };\n });\n\n return (pluginId: string, info: FrontendPluginInfo) => {\n const { packageName } = info;\n for (const matcher of overrideMatchers) {\n if (matcher.test(pluginId, packageName)) {\n if (matcher.info.description) {\n info.description = matcher.info.description;\n }\n if (matcher.info.ownerEntityRefs) {\n info.ownerEntityRefs = matcher.info.ownerEntityRefs;\n }\n if (matcher.info.links) {\n info.links = matcher.info.links;\n }\n }\n }\n return info;\n };\n}\n\nfunction resolveManifestInfo(manifest?: JsonValue) {\n if (!isJsonObject(manifest) || !isJsonObject(manifest.metadata)) {\n return undefined;\n }\n\n const info: FrontendPluginInfo = {};\n\n if (isJsonObject(manifest.spec) && typeof manifest.spec.owner === 'string') {\n info.ownerEntityRefs = [\n stringifyEntityRef(\n parseEntityRef(manifest.spec.owner, {\n defaultKind: 'Group',\n defaultNamespace: manifest.metadata.namespace?.toString(),\n }),\n ),\n ];\n }\n\n if (Array.isArray(manifest.metadata.links)) {\n info.links = manifest.metadata.links.filter(isJsonObject).map(link => ({\n title: String(link.title),\n url: String(link.url),\n }));\n }\n\n return info;\n}\n\nfunction resolvePackageInfo(packageJson?: JsonObject) {\n if (!packageJson) {\n return undefined;\n }\n\n const info: FrontendPluginInfo = {\n packageName: packageJson?.name?.toString(),\n version: packageJson?.version?.toString(),\n description: packageJson?.description?.toString(),\n };\n\n const links: { title: string; url: string }[] = [];\n\n if (typeof packageJson.homepage === 'string') {\n links.push({\n title: 'Homepage',\n url: packageJson.homepage,\n });\n }\n\n if (\n isJsonObject(packageJson.repository) &&\n typeof packageJson.repository?.url === 'string'\n ) {\n try {\n const url = new URL(packageJson.repository?.url);\n if (url.protocol === 'http:' || url.protocol === 'https:') {\n // TODO(Rugvip): Support more variants\n if (\n url.hostname === 'github.com' &&\n typeof packageJson.repository.directory === 'string'\n ) {\n const path = `${url.pathname}/tree/-/${packageJson.repository.directory}`;\n url.pathname = path.replaceAll('//', '/');\n }\n\n links.push({\n title: 'Repository',\n url: url.toString(),\n });\n }\n } catch {\n /* ignored */\n }\n }\n\n if (links.length > 0) {\n info.links = links;\n }\n return info;\n}\n\nfunction makeStringMatcher(pattern: string | undefined) {\n if (!pattern) {\n return () => true;\n }\n if (pattern.startsWith('/') && pattern.endsWith('/') && pattern.length > 2) {\n const regex = new RegExp(pattern.slice(1, -1));\n return (str?: string) => (str ? regex.test(str) : false);\n }\n\n return (str?: string) => str === pattern;\n}\n\nfunction isJsonObject(value?: JsonValue): value is JsonObject {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"createPluginInfoAttacher.esm.js","sources":["../../src/wiring/createPluginInfoAttacher.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 { ConfigApi } from '@backstage/frontend-plugin-api';\nimport {\n FrontendFeature,\n FrontendPluginInfo,\n} from '@backstage/frontend-plugin-api';\nimport { OpaqueFrontendPlugin } from '@internal/frontend';\nimport { JsonObject, JsonValue } from '@backstage/types';\nimport once from 'lodash/once';\n// Avoid full dependency on catalog-model\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport {\n parseEntityRef,\n stringifyEntityRef,\n} from '../../../catalog-model/src/entity/ref';\n\n/**\n * A function that resolves plugin info from a plugin manifest and package.json.\n *\n * @public\n */\nexport type FrontendPluginInfoResolver = (ctx: {\n packageJson(): Promise<JsonObject | undefined>;\n manifest(): Promise<JsonObject | undefined>;\n defaultResolver(sources: {\n packageJson: JsonObject | undefined;\n manifest: JsonObject | undefined;\n }): Promise<{ info: FrontendPluginInfo }>;\n}) => Promise<{ info: FrontendPluginInfo }>;\n\nexport function createPluginInfoAttacher(\n config: ConfigApi,\n infoResolver: FrontendPluginInfoResolver = async ctx =>\n ctx.defaultResolver({\n packageJson: await ctx.packageJson(),\n manifest: await ctx.manifest(),\n }),\n): (feature: FrontendFeature) => FrontendFeature {\n const applyInfoOverrides = createPluginInfoOverrider(config);\n\n return (feature: FrontendFeature) => {\n if (!OpaqueFrontendPlugin.isType(feature)) {\n return feature;\n }\n\n const plugin = OpaqueFrontendPlugin.toInternal(feature);\n\n return {\n ...plugin,\n info: once(async () => {\n const manifestLoader = plugin.infoOptions?.manifest;\n const packageJsonLoader = plugin.infoOptions?.packageJson;\n\n const { info: resolvedInfo } = await infoResolver({\n manifest: async () => manifestLoader?.(),\n packageJson: async () => packageJsonLoader?.(),\n defaultResolver: async sources => ({\n info: {\n ...resolvePackageInfo(sources.packageJson),\n ...resolveManifestInfo(sources.manifest),\n },\n }),\n });\n\n const infoWithOverrides = applyInfoOverrides(\n plugin.pluginId,\n resolvedInfo,\n );\n return normalizePluginInfo(infoWithOverrides);\n }),\n };\n };\n}\n\nfunction normalizePluginInfo(info: FrontendPluginInfo) {\n return {\n ...info,\n ownerEntityRefs: info.ownerEntityRefs?.map(ref =>\n stringifyEntityRef(\n parseEntityRef(ref, {\n defaultKind: 'Group',\n }),\n ),\n ),\n };\n}\n\nfunction createPluginInfoOverrider(config: ConfigApi) {\n const overrideConfigs =\n config.getOptionalConfigArray('app.pluginOverrides') ?? [];\n\n const overrideMatchers = overrideConfigs.map(overrideConfig => {\n const pluginIdMatcher = makeStringMatcher(\n overrideConfig.getOptionalString('match.pluginId'),\n );\n const packageNameMatcher = makeStringMatcher(\n overrideConfig.getOptionalString('match.packageName'),\n );\n const description = overrideConfig.getOptionalString('info.description');\n const ownerEntityRefs = overrideConfig.getOptionalStringArray(\n 'info.ownerEntityRefs',\n );\n const links = overrideConfig\n .getOptionalConfigArray('info.links')\n ?.map(linkConfig => ({\n title: linkConfig.getString('title'),\n url: linkConfig.getString('url'),\n }));\n\n return {\n test(pluginId: string, packageName?: string) {\n return packageNameMatcher(packageName) && pluginIdMatcher(pluginId);\n },\n info: {\n description,\n ownerEntityRefs,\n links,\n },\n };\n });\n\n return (pluginId: string, info: FrontendPluginInfo) => {\n const { packageName } = info;\n for (const matcher of overrideMatchers) {\n if (matcher.test(pluginId, packageName)) {\n if (matcher.info.description) {\n info.description = matcher.info.description;\n }\n if (matcher.info.ownerEntityRefs) {\n info.ownerEntityRefs = matcher.info.ownerEntityRefs;\n }\n if (matcher.info.links) {\n info.links = matcher.info.links;\n }\n }\n }\n return info;\n };\n}\n\nfunction resolveManifestInfo(manifest?: JsonValue) {\n if (!isJsonObject(manifest) || !isJsonObject(manifest.metadata)) {\n return undefined;\n }\n\n const info: FrontendPluginInfo = {};\n\n if (isJsonObject(manifest.spec) && typeof manifest.spec.owner === 'string') {\n info.ownerEntityRefs = [\n stringifyEntityRef(\n parseEntityRef(manifest.spec.owner, {\n defaultKind: 'Group',\n defaultNamespace: manifest.metadata.namespace?.toString(),\n }),\n ),\n ];\n }\n\n if (Array.isArray(manifest.metadata.links)) {\n info.links = manifest.metadata.links.filter(isJsonObject).map(link => ({\n title: String(link.title),\n url: String(link.url),\n }));\n }\n\n return info;\n}\n\nfunction resolvePackageInfo(packageJson?: JsonObject) {\n if (!packageJson) {\n return undefined;\n }\n\n const info: FrontendPluginInfo = {\n packageName: packageJson?.name?.toString(),\n version: packageJson?.version?.toString(),\n description: packageJson?.description?.toString(),\n };\n\n const links: { title: string; url: string }[] = [];\n\n if (typeof packageJson.homepage === 'string') {\n links.push({\n title: 'Homepage',\n url: packageJson.homepage,\n });\n }\n\n if (\n isJsonObject(packageJson.repository) &&\n typeof packageJson.repository?.url === 'string'\n ) {\n try {\n const url = new URL(packageJson.repository?.url);\n if (url.protocol === 'http:' || url.protocol === 'https:') {\n // TODO(Rugvip): Support more variants\n if (\n url.hostname === 'github.com' &&\n typeof packageJson.repository.directory === 'string'\n ) {\n const path = `${url.pathname}/tree/-/${packageJson.repository.directory}`;\n url.pathname = path.replaceAll('//', '/');\n }\n\n links.push({\n title: 'Repository',\n url: url.toString(),\n });\n }\n } catch {\n /* ignored */\n }\n }\n\n if (links.length > 0) {\n info.links = links;\n }\n return info;\n}\n\nfunction makeStringMatcher(pattern: string | undefined) {\n if (!pattern) {\n return () => true;\n }\n if (pattern.startsWith('/') && pattern.endsWith('/') && pattern.length > 2) {\n const regex = new RegExp(pattern.slice(1, -1));\n return (str?: string) => (str ? regex.test(str) : false);\n }\n\n return (str?: string) => str === pattern;\n}\n\nfunction isJsonObject(value?: JsonValue): value is JsonObject {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"createSpecializedApp.esm.js","sources":["../../src/wiring/createSpecializedApp.tsx"],"sourcesContent":["/*\n * Copyright 2023 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n ApiHolder,\n ConfigApi,\n ExtensionFactoryMiddleware,\n FrontendFeature,\n} from '@backstage/frontend-plugin-api';\nimport { CreateAppRouteBinder } from '../routing';\nimport { FrontendPluginInfoResolver } from './createPluginInfoAttacher';\nimport {\n createSessionStateFromApis,\n CreateSpecializedAppInternalOptions,\n FinalizedSpecializedApp,\n prepareSpecializedApp,\n} from './prepareSpecializedApp';\n\nexport type { CreateSpecializedAppInternalOptions };\n\n/**\n * Options for {@link createSpecializedApp}.\n *\n * @deprecated Use `PrepareSpecializedAppOptions` with `prepareSpecializedApp` instead.\n *\n * @public\n */\nexport type CreateSpecializedAppOptions = {\n /**\n * The list of features to load.\n */\n features?: FrontendFeature[];\n\n /**\n * The config API implementation to use. For most normal apps, this should be\n * specified.\n *\n * If none is given, a new _empty_ config will be used during startup. In\n * later stages of the app lifecycle, the config API in the API holder will be\n * used.\n */\n config?: ConfigApi;\n\n /**\n * Allows for the binding of plugins' external route refs within the app.\n */\n bindRoutes?(context: { bind: CreateAppRouteBinder }): void;\n\n /**\n * Advanced, more rarely used options.\n */\n advanced?: {\n /**\n * APIs to expose to the app during startup.\n */\n apis?: ApiHolder;\n\n /**\n * Applies one or more middleware on every extension, as they are added to\n * the application.\n *\n * This is an advanced use case for modifying extension data on the fly as\n * it gets emitted by extensions being instantiated.\n */\n extensionFactoryMiddleware?:\n | ExtensionFactoryMiddleware\n | ExtensionFactoryMiddleware[];\n\n /**\n * Allows for customizing how plugin info is retrieved.\n */\n pluginInfoResolver?: FrontendPluginInfoResolver;\n };\n};\n\n/**\n * Creates an empty app without any default features. This is a low-level API is\n * intended for use in tests or specialized setups. Typically you want to use\n * `createApp` from `@backstage/frontend-defaults` instead.\n *\n * @deprecated Use `prepareSpecializedApp` instead.\n *\n * @public\n */\nexport function createSpecializedApp(\n options?: CreateSpecializedAppOptions,\n): FinalizedSpecializedApp {\n const sessionState = options?.advanced?.apis\n ? createSessionStateFromApis(options.advanced.apis)\n : undefined;\n\n return prepareSpecializedApp({\n features: options?.features,\n config: options?.config,\n bindRoutes: options?.bindRoutes,\n advanced: {\n ...options?.advanced,\n sessionState,\n },\n }).finalize();\n}\n"],"names":[],"mappings":";;AAiGO,SAAS,qBACd,OAAA,EACyB;AACzB,EAAA,MAAM,YAAA,GAAe,SAAS,QAAA,EAAU,IAAA,GACpC,2BAA2B,OAAA,CAAQ,QAAA,CAAS,IAAI,CAAA,GAChD,MAAA;AAEJ,EAAA,OAAO,qBAAA,CAAsB;AAAA,IAC3B,UAAU,OAAA,EAAS,QAAA;AAAA,IACnB,QAAQ,OAAA,EAAS,MAAA;AAAA,IACjB,YAAY,OAAA,EAAS,UAAA;AAAA,IACrB,QAAA,EAAU;AAAA,MACR,GAAG,OAAA,EAAS,QAAA;AAAA,MACZ;AAAA;AACF,GACD,EAAE,QAAA,EAAS;AACd;;;;"}
1
+ {"version":3,"file":"createSpecializedApp.esm.js","sources":["../../src/wiring/createSpecializedApp.tsx"],"sourcesContent":["/*\n * Copyright 2023 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n ApiHolder,\n ConfigApi,\n ExtensionFactoryMiddleware,\n FrontendFeature,\n} from '@backstage/frontend-plugin-api';\nimport { CreateAppRouteBinder } from '../routing';\nimport { FrontendPluginInfoResolver } from './createPluginInfoAttacher';\nimport {\n createSessionStateFromApis,\n CreateSpecializedAppInternalOptions,\n FinalizedSpecializedApp,\n prepareSpecializedApp,\n} from './prepareSpecializedApp';\n\nexport type { CreateSpecializedAppInternalOptions };\n\n/**\n * Options for {@link createSpecializedApp}.\n *\n * @deprecated Use `PrepareSpecializedAppOptions` with `prepareSpecializedApp` instead.\n *\n * @public\n */\nexport type CreateSpecializedAppOptions = {\n /**\n * The list of features to load.\n */\n features?: FrontendFeature[];\n\n /**\n * The config API implementation to use. For most normal apps, this should be\n * specified.\n *\n * If none is given, a new _empty_ config will be used during startup. In\n * later stages of the app lifecycle, the config API in the API holder will be\n * used.\n */\n config?: ConfigApi;\n\n /**\n * Allows for the binding of plugins' external route refs within the app.\n */\n bindRoutes?(context: { bind: CreateAppRouteBinder }): void;\n\n /**\n * Advanced, more rarely used options.\n */\n advanced?: {\n /**\n * APIs to expose to the app during startup.\n */\n apis?: ApiHolder;\n\n /**\n * Applies one or more middleware on every extension, as they are added to\n * the application.\n *\n * This is an advanced use case for modifying extension data on the fly as\n * it gets emitted by extensions being instantiated.\n */\n extensionFactoryMiddleware?:\n | ExtensionFactoryMiddleware\n | ExtensionFactoryMiddleware[];\n\n /**\n * Allows for customizing how plugin info is retrieved.\n */\n pluginInfoResolver?: FrontendPluginInfoResolver;\n };\n};\n\n/**\n * Creates an empty app without any default features. This is a low-level API is\n * intended for use in tests or specialized setups. Typically you want to use\n * `createApp` from `@backstage/frontend-defaults` instead.\n *\n * @deprecated Use `prepareSpecializedApp` instead.\n *\n * @public\n */\nexport function createSpecializedApp(\n options?: CreateSpecializedAppOptions,\n): FinalizedSpecializedApp {\n const sessionState = options?.advanced?.apis\n ? createSessionStateFromApis(options.advanced.apis)\n : undefined;\n\n return prepareSpecializedApp({\n features: options?.features,\n config: options?.config,\n bindRoutes: options?.bindRoutes,\n advanced: {\n ...options?.advanced,\n sessionState,\n },\n }).finalize();\n}\n"],"names":[],"mappings":";;AAiGO,SAAS,qBACd,OAAA,EACyB;AACzB,EAAA,MAAM,YAAA,GAAe,SAAS,QAAA,EAAU,IAAA,GACpC,2BAA2B,OAAA,CAAQ,QAAA,CAAS,IAAI,CAAA,GAChD,MAAA;AAEJ,EAAA,OAAO,qBAAA,CAAsB;AAAA,IAC3B,UAAU,OAAA,EAAS,QAAA;AAAA,IACnB,QAAQ,OAAA,EAAS,MAAA;AAAA,IACjB,YAAY,OAAA,EAAS,UAAA;AAAA,IACrB,QAAA,EAAU;AAAA,MACR,GAAG,OAAA,EAAS,QAAA;AAAA,MACZ;AAAA;AACF,GACD,EAAE,QAAA,EAAS;AACd;;"}
@@ -1 +1 @@
1
- {"version":3,"file":"phaseApis.esm.js","sources":["../../src/wiring/phaseApis.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 {\n AnyApiFactory,\n ApiHolder,\n AppTree,\n AppTreeApi,\n appTreeApiRef,\n ConfigApi,\n configApiRef,\n createApiFactory,\n ExternalRouteRef,\n identityApiRef,\n RouteFunc,\n RouteRef,\n RouteResolutionApi,\n routeResolutionApiRef,\n SubRouteRef,\n type AnyRouteRefParams,\n type AppNode,\n type ExtensionFactoryMiddleware,\n type IdentityApi,\n} from '@backstage/frontend-plugin-api';\nimport { matchRoutes } from 'react-router-dom';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { AppIdentityProxy } from '../../../core-app-api/src/apis/implementations/IdentityApi/AppIdentityProxy';\nimport { createRouteAliasResolver } from '../routing/RouteAliasResolver';\nimport { RouteResolver } from '../routing/RouteResolver';\nimport { collectRouteIds } from '../routing/collectRouteIds';\nimport {\n extractRouteInfoFromAppNode,\n type RouteInfo,\n} from '../routing/extractRouteInfoFromAppNode';\nimport { type BackstageRouteObject } from '../routing/types';\nimport { instantiateAppNodeTree } from '../tree/instantiateAppNodeTree';\nimport {\n FrontendApiRegistry,\n FrontendApiResolver,\n} from './FrontendApiRegistry';\nimport { type ExtensionPredicateContext } from './predicates';\nimport { type ErrorCollector } from './createErrorCollector';\n\n// Helps delay callers from reaching out to the API before the app tree has been materialized\nexport class AppTreeApiProxy implements AppTreeApi {\n #routeInfo?: RouteInfo;\n private readonly tree: AppTree;\n private readonly appBasePath: string;\n\n constructor(tree: AppTree, appBasePath: string) {\n this.tree = tree;\n this.appBasePath = appBasePath;\n }\n\n private checkIfInitialized() {\n if (!this.#routeInfo) {\n throw new Error(\n `You can't access the AppTreeApi during initialization of the app tree. Please move occurrences of this out of the initialization of the factory`,\n );\n }\n }\n\n getTree() {\n this.checkIfInitialized();\n\n return { tree: this.tree };\n }\n\n getNodesByRoutePath(routePath: string): { nodes: AppNode[] } {\n this.checkIfInitialized();\n const routeInfo = this.#routeInfo;\n if (!routeInfo) {\n throw new Error(\n `You can't access the AppTreeApi during initialization of the app tree. Please move occurrences of this out of the initialization of the factory`,\n );\n }\n\n let path = routePath;\n if (path.startsWith(this.appBasePath)) {\n path = path.slice(this.appBasePath.length);\n }\n\n const matchedRoutes = matchRoutes(routeInfo.routeObjects, path);\n\n const matchedAppNodes =\n matchedRoutes?.flatMap(routeObj => {\n const appNode = routeObj.route.appNode;\n return appNode ? [appNode] : [];\n }) || [];\n\n return { nodes: matchedAppNodes };\n }\n\n initialize(routeInfo: RouteInfo) {\n this.#routeInfo = routeInfo;\n }\n}\n\n// Helps delay callers from reaching out to the API before the app tree has been materialized\nexport class RouteResolutionApiProxy implements RouteResolutionApi {\n #delegate: RouteResolutionApi | undefined;\n #routeObjects: BackstageRouteObject[] | undefined;\n\n private readonly routeBindings: Map<ExternalRouteRef, RouteRef | SubRouteRef>;\n private readonly appBasePath: string;\n\n constructor(\n routeBindings: Map<ExternalRouteRef, RouteRef | SubRouteRef>,\n appBasePath: string,\n ) {\n this.routeBindings = routeBindings;\n this.appBasePath = appBasePath;\n }\n\n resolve<TParams extends AnyRouteRefParams>(\n anyRouteRef:\n | RouteRef<TParams>\n | SubRouteRef<TParams>\n | ExternalRouteRef<TParams>,\n options?: { sourcePath?: string },\n ): RouteFunc<TParams> | undefined {\n if (!this.#delegate) {\n throw new Error(\n `You can't access the RouteResolver during initialization of the app tree. Please move occurrences of this out of the initialization of the factory`,\n );\n }\n\n return this.#delegate.resolve(anyRouteRef, options);\n }\n\n initialize(\n routeInfo: RouteInfo,\n routeRefsById: Map<string, RouteRef | SubRouteRef>,\n ) {\n this.#delegate = new RouteResolver(\n routeInfo.routePaths,\n routeInfo.routeParents,\n routeInfo.routeObjects,\n this.routeBindings,\n this.appBasePath,\n routeInfo.routeAliasResolver,\n routeRefsById,\n );\n this.#routeObjects = routeInfo.routeObjects;\n\n return routeInfo;\n }\n\n getRouteObjects() {\n return this.#routeObjects;\n }\n}\n\nexport class PreparedAppIdentityProxy extends AppIdentityProxy {\n #onTargetSet?:\n | ((identityApi: Parameters<AppIdentityProxy['setTarget']>[0]) => void)\n | undefined;\n\n setTargetHandlers(options: {\n onTargetSet?(\n identityApi: Parameters<AppIdentityProxy['setTarget']>[0],\n ): void;\n }) {\n this.#onTargetSet = options.onTargetSet;\n }\n\n clearTargetHandlers() {\n this.#onTargetSet = undefined;\n }\n\n override setTarget(\n identityApi: Parameters<AppIdentityProxy['setTarget']>[0],\n targetOptions: Parameters<AppIdentityProxy['setTarget']>[1],\n ) {\n super.setTarget(identityApi, targetOptions);\n\n const onTargetSet = this.#onTargetSet;\n if (!onTargetSet) {\n return;\n }\n\n this.clearTargetHandlers();\n onTargetSet(identityApi);\n }\n}\n\nexport function createPhaseApis(options: {\n tree: AppTree;\n config: ConfigApi;\n appApiRegistry: FrontendApiRegistry;\n fallbackApis?: ApiHolder;\n includeConfigApi: boolean;\n appBasePath: string;\n routeBindings: Map<ExternalRouteRef, RouteRef | SubRouteRef>;\n staticFactories: AnyApiFactory[];\n}) {\n const appTreeApi = new AppTreeApiProxy(options.tree, options.appBasePath);\n const routeResolutionApi = new RouteResolutionApiProxy(\n options.routeBindings,\n options.appBasePath,\n );\n const identityProxy = new PreparedAppIdentityProxy();\n const phaseApiRegistry = new FrontendApiRegistry();\n phaseApiRegistry.registerAll([\n createApiFactory(appTreeApiRef, appTreeApi),\n ...(options.includeConfigApi\n ? [createApiFactory(configApiRef, options.config)]\n : []),\n createApiFactory(routeResolutionApiRef, routeResolutionApi),\n createApiFactory(identityApiRef, identityProxy),\n ...options.staticFactories,\n ]);\n\n const apis = new FrontendApiResolver({\n primaryRegistry: phaseApiRegistry,\n secondaryRegistry: options.appApiRegistry,\n fallbackApis: options.fallbackApis,\n });\n\n return {\n apis,\n routeResolutionApi,\n appTreeApi,\n identityApiProxy: identityProxy,\n };\n}\n\nexport function instantiateAndInitializePhaseTree(options: {\n tree: AppTree;\n apis: ApiHolder;\n collector: ErrorCollector;\n extensionFactoryMiddleware?: ExtensionFactoryMiddleware;\n routeResolutionApi: RouteResolutionApiProxy;\n appTreeApi: AppTreeApiProxy;\n routeRefsById: ReturnType<typeof collectRouteIds>;\n skipChild?(ctx: { node: AppNode; input: string; child: AppNode }): boolean;\n onMissingApi?(ctx: { node: AppNode; apiRefId: string }): void;\n predicateContext?: ExtensionPredicateContext;\n stopAtAttachment?(ctx: { node: AppNode; input: string }): boolean;\n}) {\n instantiateAppNodeTree(\n options.tree.root,\n options.apis,\n options.collector,\n options.extensionFactoryMiddleware,\n {\n ...(options.stopAtAttachment\n ? { stopAtAttachment: options.stopAtAttachment }\n : {}),\n skipChild: options.skipChild,\n onMissingApi: options.onMissingApi,\n predicateContext: options.predicateContext,\n },\n );\n\n const routeInfo = extractRouteInfoFromAppNode(\n options.tree.root,\n createRouteAliasResolver(options.routeRefsById),\n );\n\n options.routeResolutionApi.initialize(\n routeInfo,\n options.routeRefsById.routes,\n );\n options.appTreeApi.initialize(routeInfo);\n}\n\nexport function setIdentityApiTarget(options: {\n identityApiProxy: AppIdentityProxy;\n identityApi: IdentityApi;\n signOutTargetUrl: string;\n}) {\n options.identityApiProxy.setTarget(options.identityApi, {\n signOutTargetUrl: options.signOutTargetUrl,\n });\n}\n"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"phaseApis.esm.js","sources":["../../src/wiring/phaseApis.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 {\n AnyApiFactory,\n ApiHolder,\n AppTree,\n AppTreeApi,\n appTreeApiRef,\n ConfigApi,\n configApiRef,\n createApiFactory,\n ExternalRouteRef,\n identityApiRef,\n RouteFunc,\n RouteRef,\n RouteResolutionApi,\n routeResolutionApiRef,\n SubRouteRef,\n type AnyRouteRefParams,\n type AppNode,\n type ExtensionFactoryMiddleware,\n type IdentityApi,\n} from '@backstage/frontend-plugin-api';\nimport { matchRoutes } from 'react-router-dom';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { AppIdentityProxy } from '../../../core-app-api/src/apis/implementations/IdentityApi/AppIdentityProxy';\nimport { createRouteAliasResolver } from '../routing/RouteAliasResolver';\nimport { RouteResolver } from '../routing/RouteResolver';\nimport { collectRouteIds } from '../routing/collectRouteIds';\nimport {\n extractRouteInfoFromAppNode,\n type RouteInfo,\n} from '../routing/extractRouteInfoFromAppNode';\nimport { type BackstageRouteObject } from '../routing/types';\nimport { instantiateAppNodeTree } from '../tree/instantiateAppNodeTree';\nimport {\n FrontendApiRegistry,\n FrontendApiResolver,\n} from './FrontendApiRegistry';\nimport { type ExtensionPredicateContext } from './predicates';\nimport { type ErrorCollector } from './createErrorCollector';\n\n// Helps delay callers from reaching out to the API before the app tree has been materialized\nexport class AppTreeApiProxy implements AppTreeApi {\n #routeInfo?: RouteInfo;\n private readonly tree: AppTree;\n private readonly appBasePath: string;\n\n constructor(tree: AppTree, appBasePath: string) {\n this.tree = tree;\n this.appBasePath = appBasePath;\n }\n\n private checkIfInitialized() {\n if (!this.#routeInfo) {\n throw new Error(\n `You can't access the AppTreeApi during initialization of the app tree. Please move occurrences of this out of the initialization of the factory`,\n );\n }\n }\n\n getTree() {\n this.checkIfInitialized();\n\n return { tree: this.tree };\n }\n\n getNodesByRoutePath(routePath: string): { nodes: AppNode[] } {\n this.checkIfInitialized();\n const routeInfo = this.#routeInfo;\n if (!routeInfo) {\n throw new Error(\n `You can't access the AppTreeApi during initialization of the app tree. Please move occurrences of this out of the initialization of the factory`,\n );\n }\n\n let path = routePath;\n if (path.startsWith(this.appBasePath)) {\n path = path.slice(this.appBasePath.length);\n }\n\n const matchedRoutes = matchRoutes(routeInfo.routeObjects, path);\n\n const matchedAppNodes =\n matchedRoutes?.flatMap(routeObj => {\n const appNode = routeObj.route.appNode;\n return appNode ? [appNode] : [];\n }) || [];\n\n return { nodes: matchedAppNodes };\n }\n\n initialize(routeInfo: RouteInfo) {\n this.#routeInfo = routeInfo;\n }\n}\n\n// Helps delay callers from reaching out to the API before the app tree has been materialized\nexport class RouteResolutionApiProxy implements RouteResolutionApi {\n #delegate: RouteResolutionApi | undefined;\n #routeObjects: BackstageRouteObject[] | undefined;\n\n private readonly routeBindings: Map<ExternalRouteRef, RouteRef | SubRouteRef>;\n private readonly appBasePath: string;\n\n constructor(\n routeBindings: Map<ExternalRouteRef, RouteRef | SubRouteRef>,\n appBasePath: string,\n ) {\n this.routeBindings = routeBindings;\n this.appBasePath = appBasePath;\n }\n\n resolve<TParams extends AnyRouteRefParams>(\n anyRouteRef:\n | RouteRef<TParams>\n | SubRouteRef<TParams>\n | ExternalRouteRef<TParams>,\n options?: { sourcePath?: string },\n ): RouteFunc<TParams> | undefined {\n if (!this.#delegate) {\n throw new Error(\n `You can't access the RouteResolver during initialization of the app tree. Please move occurrences of this out of the initialization of the factory`,\n );\n }\n\n return this.#delegate.resolve(anyRouteRef, options);\n }\n\n initialize(\n routeInfo: RouteInfo,\n routeRefsById: Map<string, RouteRef | SubRouteRef>,\n ) {\n this.#delegate = new RouteResolver(\n routeInfo.routePaths,\n routeInfo.routeParents,\n routeInfo.routeObjects,\n this.routeBindings,\n this.appBasePath,\n routeInfo.routeAliasResolver,\n routeRefsById,\n );\n this.#routeObjects = routeInfo.routeObjects;\n\n return routeInfo;\n }\n\n getRouteObjects() {\n return this.#routeObjects;\n }\n}\n\nexport class PreparedAppIdentityProxy extends AppIdentityProxy {\n #onTargetSet?:\n | ((identityApi: Parameters<AppIdentityProxy['setTarget']>[0]) => void)\n | undefined;\n\n setTargetHandlers(options: {\n onTargetSet?(\n identityApi: Parameters<AppIdentityProxy['setTarget']>[0],\n ): void;\n }) {\n this.#onTargetSet = options.onTargetSet;\n }\n\n clearTargetHandlers() {\n this.#onTargetSet = undefined;\n }\n\n override setTarget(\n identityApi: Parameters<AppIdentityProxy['setTarget']>[0],\n targetOptions: Parameters<AppIdentityProxy['setTarget']>[1],\n ) {\n super.setTarget(identityApi, targetOptions);\n\n const onTargetSet = this.#onTargetSet;\n if (!onTargetSet) {\n return;\n }\n\n this.clearTargetHandlers();\n onTargetSet(identityApi);\n }\n}\n\nexport function createPhaseApis(options: {\n tree: AppTree;\n config: ConfigApi;\n appApiRegistry: FrontendApiRegistry;\n fallbackApis?: ApiHolder;\n includeConfigApi: boolean;\n appBasePath: string;\n routeBindings: Map<ExternalRouteRef, RouteRef | SubRouteRef>;\n staticFactories: AnyApiFactory[];\n}) {\n const appTreeApi = new AppTreeApiProxy(options.tree, options.appBasePath);\n const routeResolutionApi = new RouteResolutionApiProxy(\n options.routeBindings,\n options.appBasePath,\n );\n const identityProxy = new PreparedAppIdentityProxy();\n const phaseApiRegistry = new FrontendApiRegistry();\n phaseApiRegistry.registerAll([\n createApiFactory(appTreeApiRef, appTreeApi),\n ...(options.includeConfigApi\n ? [createApiFactory(configApiRef, options.config)]\n : []),\n createApiFactory(routeResolutionApiRef, routeResolutionApi),\n createApiFactory(identityApiRef, identityProxy),\n ...options.staticFactories,\n ]);\n\n const apis = new FrontendApiResolver({\n primaryRegistry: phaseApiRegistry,\n secondaryRegistry: options.appApiRegistry,\n fallbackApis: options.fallbackApis,\n });\n\n return {\n apis,\n routeResolutionApi,\n appTreeApi,\n identityApiProxy: identityProxy,\n };\n}\n\nexport function instantiateAndInitializePhaseTree(options: {\n tree: AppTree;\n apis: ApiHolder;\n collector: ErrorCollector;\n extensionFactoryMiddleware?: ExtensionFactoryMiddleware;\n routeResolutionApi: RouteResolutionApiProxy;\n appTreeApi: AppTreeApiProxy;\n routeRefsById: ReturnType<typeof collectRouteIds>;\n skipChild?(ctx: { node: AppNode; input: string; child: AppNode }): boolean;\n onMissingApi?(ctx: { node: AppNode; apiRefId: string }): void;\n predicateContext?: ExtensionPredicateContext;\n stopAtAttachment?(ctx: { node: AppNode; input: string }): boolean;\n}) {\n instantiateAppNodeTree(\n options.tree.root,\n options.apis,\n options.collector,\n options.extensionFactoryMiddleware,\n {\n ...(options.stopAtAttachment\n ? { stopAtAttachment: options.stopAtAttachment }\n : {}),\n skipChild: options.skipChild,\n onMissingApi: options.onMissingApi,\n predicateContext: options.predicateContext,\n },\n );\n\n const routeInfo = extractRouteInfoFromAppNode(\n options.tree.root,\n createRouteAliasResolver(options.routeRefsById),\n );\n\n options.routeResolutionApi.initialize(\n routeInfo,\n options.routeRefsById.routes,\n );\n options.appTreeApi.initialize(routeInfo);\n}\n\nexport function setIdentityApiTarget(options: {\n identityApiProxy: AppIdentityProxy;\n identityApi: IdentityApi;\n signOutTargetUrl: string;\n}) {\n options.identityApiProxy.setTarget(options.identityApi, {\n signOutTargetUrl: options.signOutTargetUrl,\n });\n}\n"],"names":[],"mappings":";;;;;;;;;AAyDO,MAAM,eAAA,CAAsC;AAAA,EACjD,UAAA;AAAA,EACiB,IAAA;AAAA,EACA,WAAA;AAAA,EAEjB,WAAA,CAAY,MAAe,WAAA,EAAqB;AAC9C,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AACZ,IAAA,IAAA,CAAK,WAAA,GAAc,WAAA;AAAA,EACrB;AAAA,EAEQ,kBAAA,GAAqB;AAC3B,IAAA,IAAI,CAAC,KAAK,UAAA,EAAY;AACpB,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,CAAA,+IAAA;AAAA,OACF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,OAAA,GAAU;AACR,IAAA,IAAA,CAAK,kBAAA,EAAmB;AAExB,IAAA,OAAO,EAAE,IAAA,EAAM,IAAA,CAAK,IAAA,EAAK;AAAA,EAC3B;AAAA,EAEA,oBAAoB,SAAA,EAAyC;AAC3D,IAAA,IAAA,CAAK,kBAAA,EAAmB;AACxB,IAAA,MAAM,YAAY,IAAA,CAAK,UAAA;AACvB,IAAA,IAAI,CAAC,SAAA,EAAW;AACd,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,CAAA,+IAAA;AAAA,OACF;AAAA,IACF;AAEA,IAAA,IAAI,IAAA,GAAO,SAAA;AACX,IAAA,IAAI,IAAA,CAAK,UAAA,CAAW,IAAA,CAAK,WAAW,CAAA,EAAG;AACrC,MAAA,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,WAAA,CAAY,MAAM,CAAA;AAAA,IAC3C;AAEA,IAAA,MAAM,aAAA,GAAgB,WAAA,CAAY,SAAA,CAAU,YAAA,EAAc,IAAI,CAAA;AAE9D,IAAA,MAAM,eAAA,GACJ,aAAA,EAAe,OAAA,CAAQ,CAAA,QAAA,KAAY;AACjC,MAAA,MAAM,OAAA,GAAU,SAAS,KAAA,CAAM,OAAA;AAC/B,MAAA,OAAO,OAAA,GAAU,CAAC,OAAO,CAAA,GAAI,EAAC;AAAA,IAChC,CAAC,KAAK,EAAC;AAET,IAAA,OAAO,EAAE,OAAO,eAAA,EAAgB;AAAA,EAClC;AAAA,EAEA,WAAW,SAAA,EAAsB;AAC/B,IAAA,IAAA,CAAK,UAAA,GAAa,SAAA;AAAA,EACpB;AACF;AAGO,MAAM,uBAAA,CAAsD;AAAA,EACjE,SAAA;AAAA,EACA,aAAA;AAAA,EAEiB,aAAA;AAAA,EACA,WAAA;AAAA,EAEjB,WAAA,CACE,eACA,WAAA,EACA;AACA,IAAA,IAAA,CAAK,aAAA,GAAgB,aAAA;AACrB,IAAA,IAAA,CAAK,WAAA,GAAc,WAAA;AAAA,EACrB;AAAA,EAEA,OAAA,CACE,aAIA,OAAA,EACgC;AAChC,IAAA,IAAI,CAAC,KAAK,SAAA,EAAW;AACnB,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,CAAA,kJAAA;AAAA,OACF;AAAA,IACF;AAEA,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,OAAA,CAAQ,WAAA,EAAa,OAAO,CAAA;AAAA,EACpD;AAAA,EAEA,UAAA,CACE,WACA,aAAA,EACA;AACA,IAAA,IAAA,CAAK,YAAY,IAAI,aAAA;AAAA,MACnB,SAAA,CAAU,UAAA;AAAA,MACV,SAAA,CAAU,YAAA;AAAA,MACV,SAAA,CAAU,YAAA;AAAA,MACV,IAAA,CAAK,aAAA;AAAA,MACL,IAAA,CAAK,WAAA;AAAA,MACL,SAAA,CAAU,kBAAA;AAAA,MACV;AAAA,KACF;AACA,IAAA,IAAA,CAAK,gBAAgB,SAAA,CAAU,YAAA;AAE/B,IAAA,OAAO,SAAA;AAAA,EACT;AAAA,EAEA,eAAA,GAAkB;AAChB,IAAA,OAAO,IAAA,CAAK,aAAA;AAAA,EACd;AACF;AAEO,MAAM,iCAAiC,gBAAA,CAAiB;AAAA,EAC7D,YAAA;AAAA,EAIA,kBAAkB,OAAA,EAIf;AACD,IAAA,IAAA,CAAK,eAAe,OAAA,CAAQ,WAAA;AAAA,EAC9B;AAAA,EAEA,mBAAA,GAAsB;AACpB,IAAA,IAAA,CAAK,YAAA,GAAe,MAAA;AAAA,EACtB;AAAA,EAES,SAAA,CACP,aACA,aAAA,EACA;AACA,IAAA,KAAA,CAAM,SAAA,CAAU,aAAa,aAAa,CAAA;AAE1C,IAAA,MAAM,cAAc,IAAA,CAAK,YAAA;AACzB,IAAA,IAAI,CAAC,WAAA,EAAa;AAChB,MAAA;AAAA,IACF;AAEA,IAAA,IAAA,CAAK,mBAAA,EAAoB;AACzB,IAAA,WAAA,CAAY,WAAW,CAAA;AAAA,EACzB;AACF;AAEO,SAAS,gBAAgB,OAAA,EAS7B;AACD,EAAA,MAAM,aAAa,IAAI,eAAA,CAAgB,OAAA,CAAQ,IAAA,EAAM,QAAQ,WAAW,CAAA;AACxE,EAAA,MAAM,qBAAqB,IAAI,uBAAA;AAAA,IAC7B,OAAA,CAAQ,aAAA;AAAA,IACR,OAAA,CAAQ;AAAA,GACV;AACA,EAAA,MAAM,aAAA,GAAgB,IAAI,wBAAA,EAAyB;AACnD,EAAA,MAAM,gBAAA,GAAmB,IAAI,mBAAA,EAAoB;AACjD,EAAA,gBAAA,CAAiB,WAAA,CAAY;AAAA,IAC3B,gBAAA,CAAiB,eAAe,UAAU,CAAA;AAAA,IAC1C,GAAI,OAAA,CAAQ,gBAAA,GACR,CAAC,gBAAA,CAAiB,cAAc,OAAA,CAAQ,MAAM,CAAC,CAAA,GAC/C,EAAC;AAAA,IACL,gBAAA,CAAiB,uBAAuB,kBAAkB,CAAA;AAAA,IAC1D,gBAAA,CAAiB,gBAAgB,aAAa,CAAA;AAAA,IAC9C,GAAG,OAAA,CAAQ;AAAA,GACZ,CAAA;AAED,EAAA,MAAM,IAAA,GAAO,IAAI,mBAAA,CAAoB;AAAA,IACnC,eAAA,EAAiB,gBAAA;AAAA,IACjB,mBAAmB,OAAA,CAAQ,cAAA;AAAA,IAC3B,cAAc,OAAA,CAAQ;AAAA,GACvB,CAAA;AAED,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,kBAAA;AAAA,IACA,UAAA;AAAA,IACA,gBAAA,EAAkB;AAAA,GACpB;AACF;AAEO,SAAS,kCAAkC,OAAA,EAY/C;AACD,EAAA,sBAAA;AAAA,IACE,QAAQ,IAAA,CAAK,IAAA;AAAA,IACb,OAAA,CAAQ,IAAA;AAAA,IACR,OAAA,CAAQ,SAAA;AAAA,IACR,OAAA,CAAQ,0BAAA;AAAA,IACR;AAAA,MACE,GAAI,QAAQ,gBAAA,GACR,EAAE,kBAAkB,OAAA,CAAQ,gBAAA,KAC5B,EAAC;AAAA,MACL,WAAW,OAAA,CAAQ,SAAA;AAAA,MACnB,cAAc,OAAA,CAAQ,YAAA;AAAA,MACtB,kBAAkB,OAAA,CAAQ;AAAA;AAC5B,GACF;AAEA,EAAA,MAAM,SAAA,GAAY,2BAAA;AAAA,IAChB,QAAQ,IAAA,CAAK,IAAA;AAAA,IACb,wBAAA,CAAyB,QAAQ,aAAa;AAAA,GAChD;AAEA,EAAA,OAAA,CAAQ,kBAAA,CAAmB,UAAA;AAAA,IACzB,SAAA;AAAA,IACA,QAAQ,aAAA,CAAc;AAAA,GACxB;AACA,EAAA,OAAA,CAAQ,UAAA,CAAW,WAAW,SAAS,CAAA;AACzC;AAEO,SAAS,qBAAqB,OAAA,EAIlC;AACD,EAAA,OAAA,CAAQ,gBAAA,CAAiB,SAAA,CAAU,OAAA,CAAQ,WAAA,EAAa;AAAA,IACtD,kBAAkB,OAAA,CAAQ;AAAA,GAC3B,CAAA;AACH;;"}
@@ -1 +1 @@
1
- {"version":3,"file":"predicates.esm.js","sources":["../../src/wiring/predicates.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 ApiHolder,\n createApiRef,\n featureFlagsApiRef,\n} from '@backstage/frontend-plugin-api';\nimport { FilterPredicate } from '@backstage/filter-predicates';\nimport type {\n EvaluatePermissionRequest,\n EvaluatePermissionResponse,\n} from '@backstage/plugin-permission-common';\nimport { ForwardedError } from '@backstage/errors';\n\nexport type ExtensionPredicateContext = {\n featureFlags: string[];\n permissions: string[];\n};\n\nexport const EMPTY_PREDICATE_CONTEXT: ExtensionPredicateContext = {\n featureFlags: [],\n permissions: [],\n};\n\n// Minimal local permission API interface to avoid a dependency on @backstage/plugin-permission-react\ntype MinimalPermissionApi = {\n authorize(\n request: EvaluatePermissionRequest,\n ): Promise<EvaluatePermissionResponse>;\n};\n\nfunction parsePermissionName(permissionName: string) {\n const parts = permissionName.split('#');\n const [name, action, ...rest] = parts;\n\n if (rest.length > 0 || !name || (parts.length === 2 && !action)) {\n throw new Error(\n `Invalid permission name: ${permissionName}. Permission names must be in the format \"permissionName\" or \"permissionName#action\" (both parts must be non-empty).`,\n );\n }\n\n if (action === undefined) {\n return { name };\n }\n\n return {\n name,\n attributes: {\n action,\n },\n };\n}\n\nexport const localPermissionApiRef = createApiRef<MinimalPermissionApi>({\n id: 'plugin.permission.api',\n});\n\nexport function createPredicateContextLoader(options: {\n apis: ApiHolder;\n predicateReferences: ExtensionPredicateContext;\n}) {\n function getActiveFeatureFlags() {\n const featureFlagsApi = options.apis.get(featureFlagsApiRef);\n if (!featureFlagsApi) {\n return [];\n }\n\n return options.predicateReferences.featureFlags.filter(name =>\n featureFlagsApi.isActive(name),\n );\n }\n\n function getImmediate(): ExtensionPredicateContext | undefined {\n if (options.predicateReferences.permissions.length > 0) {\n const permissionApi = options.apis.get(localPermissionApiRef);\n if (permissionApi) {\n return undefined;\n }\n }\n\n return {\n featureFlags: getActiveFeatureFlags(),\n permissions: [],\n };\n }\n\n async function load() {\n const immediatePredicateContext = getImmediate();\n if (immediatePredicateContext) {\n return immediatePredicateContext;\n }\n\n let allowedPermissions: string[] = [];\n const permissionApi = options.apis.get(localPermissionApiRef);\n if (permissionApi) {\n try {\n const permissionNames = options.predicateReferences.permissions;\n const hydratedPermissions = permissionNames.map(name => {\n const { name: permissionName, attributes } =\n parsePermissionName(name);\n const permission = {\n name: permissionName,\n type: 'basic',\n attributes: attributes || {},\n } as const;\n return permission;\n });\n const responses = await Promise.all(\n hydratedPermissions.map(permission =>\n permissionApi.authorize({\n permission,\n }),\n ),\n );\n allowedPermissions = permissionNames.filter(\n (_, i) => responses[i].result === 'ALLOW',\n );\n } catch (error) {\n throw new ForwardedError(\n 'Failed to authorize extension permissions',\n error,\n );\n }\n }\n\n return {\n featureFlags: getActiveFeatureFlags(),\n permissions: allowedPermissions,\n };\n }\n\n return {\n getImmediate,\n load,\n };\n}\n\nexport function collectPredicateReferences(\n nodes: Iterable<{ spec: { if?: FilterPredicate } }>,\n): ExtensionPredicateContext {\n const featureFlags = new Set<string>();\n const permissions = new Set<string>();\n\n for (const node of nodes) {\n if (node.spec.if === undefined) {\n continue;\n }\n\n for (const name of extractFeatureFlagNames(node.spec.if)) {\n featureFlags.add(name);\n }\n for (const name of extractPermissionNames(node.spec.if)) {\n permissions.add(name);\n }\n }\n\n return {\n featureFlags: Array.from(featureFlags),\n permissions: Array.from(permissions),\n };\n}\n\n/**\n * Recursively walks a FilterPredicate and returns all string values referenced\n * by `featureFlags: { $contains: '...' }` expressions. This lets us call\n * `isActive()` only for the flags that are actually used in predicates rather\n * than fetching the full registered-flag list.\n */\nfunction extractFeatureFlagNames(predicate: FilterPredicate): string[] {\n return extractPredicateKeyNames(predicate, 'featureFlags');\n}\n\n/**\n * Recursively walks a FilterPredicate and returns all string values referenced\n * by `permissions: { $contains: '...' }` expressions. This lets us issue a\n * single batched authorize call for only the permissions actually referenced.\n */\nfunction extractPermissionNames(predicate: FilterPredicate): string[] {\n return extractPredicateKeyNames(predicate, 'permissions');\n}\n\nfunction extractPredicateKeyNames(\n predicate: FilterPredicate,\n key: string,\n): string[] {\n if (typeof predicate !== 'object' || predicate === null) {\n return [];\n }\n const obj = predicate as Record<string, unknown>;\n if (Array.isArray(obj.$all)) {\n return (obj.$all as FilterPredicate[]).flatMap(p =>\n extractPredicateKeyNames(p, key),\n );\n }\n if (Array.isArray(obj.$any)) {\n return (obj.$any as FilterPredicate[]).flatMap(p =>\n extractPredicateKeyNames(p, key),\n );\n }\n if (obj.$not !== undefined) {\n return extractPredicateKeyNames(obj.$not as FilterPredicate, key);\n }\n const value = obj[key];\n if (typeof value === 'object' && value !== null && !Array.isArray(value)) {\n const contains = (value as Record<string, unknown>).$contains;\n if (typeof contains === 'string') {\n return [contains];\n }\n }\n return [];\n}\n"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"predicates.esm.js","sources":["../../src/wiring/predicates.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 ApiHolder,\n createApiRef,\n featureFlagsApiRef,\n} from '@backstage/frontend-plugin-api';\nimport { FilterPredicate } from '@backstage/filter-predicates';\nimport type {\n EvaluatePermissionRequest,\n EvaluatePermissionResponse,\n} from '@backstage/plugin-permission-common';\nimport { ForwardedError } from '@backstage/errors';\n\nexport type ExtensionPredicateContext = {\n featureFlags: string[];\n permissions: string[];\n};\n\nexport const EMPTY_PREDICATE_CONTEXT: ExtensionPredicateContext = {\n featureFlags: [],\n permissions: [],\n};\n\n// Minimal local permission API interface to avoid a dependency on @backstage/plugin-permission-react\ntype MinimalPermissionApi = {\n authorize(\n request: EvaluatePermissionRequest,\n ): Promise<EvaluatePermissionResponse>;\n};\n\nfunction parsePermissionName(permissionName: string) {\n const parts = permissionName.split('#');\n const [name, action, ...rest] = parts;\n\n if (rest.length > 0 || !name || (parts.length === 2 && !action)) {\n throw new Error(\n `Invalid permission name: ${permissionName}. Permission names must be in the format \"permissionName\" or \"permissionName#action\" (both parts must be non-empty).`,\n );\n }\n\n if (action === undefined) {\n return { name };\n }\n\n return {\n name,\n attributes: {\n action,\n },\n };\n}\n\nexport const localPermissionApiRef = createApiRef<MinimalPermissionApi>({\n id: 'plugin.permission.api',\n});\n\nexport function createPredicateContextLoader(options: {\n apis: ApiHolder;\n predicateReferences: ExtensionPredicateContext;\n}) {\n function getActiveFeatureFlags() {\n const featureFlagsApi = options.apis.get(featureFlagsApiRef);\n if (!featureFlagsApi) {\n return [];\n }\n\n return options.predicateReferences.featureFlags.filter(name =>\n featureFlagsApi.isActive(name),\n );\n }\n\n function getImmediate(): ExtensionPredicateContext | undefined {\n if (options.predicateReferences.permissions.length > 0) {\n const permissionApi = options.apis.get(localPermissionApiRef);\n if (permissionApi) {\n return undefined;\n }\n }\n\n return {\n featureFlags: getActiveFeatureFlags(),\n permissions: [],\n };\n }\n\n async function load() {\n const immediatePredicateContext = getImmediate();\n if (immediatePredicateContext) {\n return immediatePredicateContext;\n }\n\n let allowedPermissions: string[] = [];\n const permissionApi = options.apis.get(localPermissionApiRef);\n if (permissionApi) {\n try {\n const permissionNames = options.predicateReferences.permissions;\n const hydratedPermissions = permissionNames.map(name => {\n const { name: permissionName, attributes } =\n parsePermissionName(name);\n const permission = {\n name: permissionName,\n type: 'basic',\n attributes: attributes || {},\n } as const;\n return permission;\n });\n const responses = await Promise.all(\n hydratedPermissions.map(permission =>\n permissionApi.authorize({\n permission,\n }),\n ),\n );\n allowedPermissions = permissionNames.filter(\n (_, i) => responses[i].result === 'ALLOW',\n );\n } catch (error) {\n throw new ForwardedError(\n 'Failed to authorize extension permissions',\n error,\n );\n }\n }\n\n return {\n featureFlags: getActiveFeatureFlags(),\n permissions: allowedPermissions,\n };\n }\n\n return {\n getImmediate,\n load,\n };\n}\n\nexport function collectPredicateReferences(\n nodes: Iterable<{ spec: { if?: FilterPredicate } }>,\n): ExtensionPredicateContext {\n const featureFlags = new Set<string>();\n const permissions = new Set<string>();\n\n for (const node of nodes) {\n if (node.spec.if === undefined) {\n continue;\n }\n\n for (const name of extractFeatureFlagNames(node.spec.if)) {\n featureFlags.add(name);\n }\n for (const name of extractPermissionNames(node.spec.if)) {\n permissions.add(name);\n }\n }\n\n return {\n featureFlags: Array.from(featureFlags),\n permissions: Array.from(permissions),\n };\n}\n\n/**\n * Recursively walks a FilterPredicate and returns all string values referenced\n * by `featureFlags: { $contains: '...' }` expressions. This lets us call\n * `isActive()` only for the flags that are actually used in predicates rather\n * than fetching the full registered-flag list.\n */\nfunction extractFeatureFlagNames(predicate: FilterPredicate): string[] {\n return extractPredicateKeyNames(predicate, 'featureFlags');\n}\n\n/**\n * Recursively walks a FilterPredicate and returns all string values referenced\n * by `permissions: { $contains: '...' }` expressions. This lets us issue a\n * single batched authorize call for only the permissions actually referenced.\n */\nfunction extractPermissionNames(predicate: FilterPredicate): string[] {\n return extractPredicateKeyNames(predicate, 'permissions');\n}\n\nfunction extractPredicateKeyNames(\n predicate: FilterPredicate,\n key: string,\n): string[] {\n if (typeof predicate !== 'object' || predicate === null) {\n return [];\n }\n const obj = predicate as Record<string, unknown>;\n if (Array.isArray(obj.$all)) {\n return (obj.$all as FilterPredicate[]).flatMap(p =>\n extractPredicateKeyNames(p, key),\n );\n }\n if (Array.isArray(obj.$any)) {\n return (obj.$any as FilterPredicate[]).flatMap(p =>\n extractPredicateKeyNames(p, key),\n );\n }\n if (obj.$not !== undefined) {\n return extractPredicateKeyNames(obj.$not as FilterPredicate, key);\n }\n const value = obj[key];\n if (typeof value === 'object' && value !== null && !Array.isArray(value)) {\n const contains = (value as Record<string, unknown>).$contains;\n if (typeof contains === 'string') {\n return [contains];\n }\n }\n return [];\n}\n"],"names":[],"mappings":"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"}
@@ -1 +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, 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\n let finalized: FinalizedSpecializedApp | undefined;\n let bootstrapApp: BootstrapSpecializedApp | undefined;\n const signInRuntime: SignInRuntime = { requiresSignIn: false };\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 if (!providedSessionState) {\n phase.identityApiProxy.setTargetHandlers({\n onTargetSet(identityApi) {\n signInRuntime.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\n if (result.requiresSignIn) {\n signInRuntime.requiresSignIn = true;\n } else {\n phase.identityApiProxy.clearTargetHandlers();\n }\n\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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"}
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, 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\n let finalized: FinalizedSpecializedApp | undefined;\n let bootstrapApp: BootstrapSpecializedApp | undefined;\n const signInRuntime: SignInRuntime = { requiresSignIn: false };\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 if (!providedSessionState) {\n phase.identityApiProxy.setTargetHandlers({\n onTargetSet(identityApi) {\n signInRuntime.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\n if (result.requiresSignIn) {\n signInRuntime.requiresSignIn = true;\n } else {\n phase.identityApiProxy.clearTargetHandlers();\n }\n\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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"}
@@ -1 +1 @@
1
- {"version":3,"file":"treeLifecycle.esm.js","sources":["../../src/wiring/treeLifecycle.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 {\n ApiHolder,\n AppNode,\n AppNodeInstance,\n AppTree,\n coreExtensionData,\n ExtensionDataRef,\n ExtensionFactoryMiddleware,\n} from '@backstage/frontend-plugin-api';\nimport { FilterPredicate } from '@backstage/filter-predicates';\nimport { collectRouteIds } from '../routing/collectRouteIds';\nimport { ErrorCollector } from './createErrorCollector';\nimport {\n AppTreeApiProxy,\n instantiateAndInitializePhaseTree,\n RouteResolutionApiProxy,\n} from './phaseApis';\n\nexport type BootstrapClassification = {\n deferredApiRoots: Set<AppNode>;\n deferredElementRoots: Set<AppNode>;\n deferredRoots: Set<AppNode>;\n};\n\n/**\n * Instantiates the bootstrap-visible portion of the app tree and returns the\n * element that should be rendered while the prepared app is still incomplete.\n *\n * The bootstrap tree deliberately stops at the session boundary so sign-in and\n * other deferred content can be handled separately during finalization.\n */\nexport function createBootstrapApp(options: {\n tree: AppTree;\n apis: ApiHolder;\n collector: ErrorCollector;\n routeRefsById: ReturnType<typeof collectRouteIds>;\n routeResolutionApi: RouteResolutionApiProxy;\n appTreeApi: AppTreeApiProxy;\n extensionFactoryMiddleware?: ExtensionFactoryMiddleware;\n disableSignIn?: boolean;\n skipBootstrapChild?(ctx: {\n node: AppNode;\n input: string;\n child: AppNode;\n }): boolean;\n onMissingApi?(ctx: { node: AppNode; apiRefId: string }): void;\n hasSignInPage(node?: AppNode): boolean;\n}): {\n bootstrapApp: { element: JSX.Element; tree: AppTree };\n requiresSignIn: boolean;\n} {\n const signInPageNode = getAppRootNode(options.tree)?.edges.attachments.get(\n 'signInPage',\n )?.[0];\n\n instantiateAndInitializePhaseTree({\n tree: options.tree,\n apis: options.apis,\n collector: options.collector,\n extensionFactoryMiddleware: options.extensionFactoryMiddleware,\n routeResolutionApi: options.routeResolutionApi,\n appTreeApi: options.appTreeApi,\n routeRefsById: options.routeRefsById,\n stopAtAttachment: ({ node, input }) =>\n isSessionBoundaryAttachment(node, input),\n skipChild: options.skipBootstrapChild,\n onMissingApi: options.onMissingApi,\n });\n\n const element = options.tree.root.instance?.getData(\n coreExtensionData.reactElement,\n );\n if (!element) {\n throw new Error('Expected bootstrap tree to expose a root element');\n }\n\n return {\n bootstrapApp: {\n element,\n tree: options.tree,\n },\n requiresSignIn:\n !options.disableSignIn && options.hasSignInPage(signInPageNode),\n };\n}\n\n/**\n * Splits the app tree into bootstrap-visible and deferred regions.\n *\n * Predicate-gated roots are deferred to finalization, while any predicate that\n * still leaks into the bootstrap-visible region is reported and ignored.\n */\nexport function classifyBootstrapTree(options: {\n tree: AppTree;\n collector: ErrorCollector;\n}): BootstrapClassification {\n const apiNodes = options.tree.root.edges.attachments.get('apis') ?? [];\n const deferredApiRoots = new Set(\n apiNodes.filter(apiNode => subtreeContainsPredicate(apiNode)),\n );\n const appRootElementNodes =\n getAppRootNode(options.tree)?.edges.attachments.get('elements') ?? [];\n const deferredElementRoots = new Set(\n appRootElementNodes.filter(elementNode =>\n subtreeContainsPredicate(elementNode),\n ),\n );\n const deferredRoots = new Set<AppNode>([\n ...deferredApiRoots,\n ...deferredElementRoots,\n ]);\n const bootstrapNodes = collectBootstrapVisibleNodes(options.tree, {\n deferredRoots,\n });\n\n for (const node of bootstrapNodes) {\n if (node.spec.if === undefined) {\n continue;\n }\n\n options.collector.report({\n code: 'EXTENSION_BOOTSTRAP_PREDICATE_IGNORED',\n message:\n `Extension '${node.spec.id}' uses 'if' during bootstrap, so the predicate was ignored. ` +\n \"Move it behind 'app/root.children', onto a deferred 'app/root.elements' subtree, or into an API subtree.\",\n context: {\n node,\n },\n });\n (node.spec as typeof node.spec & { if?: FilterPredicate }).if = undefined;\n }\n\n return {\n deferredApiRoots,\n deferredElementRoots,\n deferredRoots,\n };\n}\n\n/**\n * Prepares the app tree for finalization by removing the bootstrap-only\n * sign-in attachment from the app root boundary.\n */\nexport function prepareFinalizedTree(options: { tree: AppTree }) {\n for (const appRootNode of getFinalizationBoundaryNodes(options.tree)) {\n const attachments = appRootNode.edges.attachments as Map<string, AppNode[]>;\n attachments.delete('signInPage');\n }\n}\n\n/**\n * Clears instances inside the finalization boundary so those nodes can be\n * re-instantiated with finalized predicate context and API availability.\n */\nexport function clearFinalizationBoundaryInstances(tree: AppTree) {\n clearNodeInstance(tree.root);\n\n const visited = new Set<AppNode>();\n function visit(node: AppNode) {\n if (visited.has(node)) {\n return;\n }\n visited.add(node);\n clearNodeInstance(node);\n\n for (const [input, children] of node.edges.attachments) {\n // app/root.elements is allowed to keep its bootstrap instances so we only\n // re-run the parts of the boundary that actually change at finalization.\n if (node.spec.id === 'app/root' && input === 'elements') {\n continue;\n }\n\n for (const child of children) {\n visit(child);\n }\n }\n }\n\n for (const appRootNode of getFinalizationBoundaryNodes(tree)) {\n visit(appRootNode);\n }\n}\n\n/**\n * Identifies the attachment that separates bootstrap rendering from the\n * children that are deferred until finalization.\n */\nexport function isSessionBoundaryAttachment(node: AppNode, input: string) {\n return node.spec.id === 'app/root' && input === 'children';\n}\n\n/**\n * Injects a synthetic finalization child that throws the captured bootstrap\n * error when rendered.\n *\n * This lets the finalized tree reuse the normal app root error boundary rather\n * than introducing a separate error rendering path.\n */\nexport function attachThrowingFinalizationChild(tree: AppTree, error: Error) {\n const bootstrapChildNode =\n getAppRootNode(tree)?.edges.attachments.get('children')?.[0];\n if (!bootstrapChildNode) {\n throw error;\n }\n\n function ThrowBootstrapError(): never {\n throw error;\n }\n\n // This synthetic child gives the finalized tree a stable place to rethrow\n // bootstrap failures through the normal extension boundary stack.\n (bootstrapChildNode as AppNode & { instance?: AppNodeInstance }).instance = {\n getDataRefs() {\n return [coreExtensionData.reactElement];\n },\n getData<TValue>(dataRef: ExtensionDataRef<TValue>) {\n if (dataRef.id === coreExtensionData.reactElement.id) {\n return (<ThrowBootstrapError />) as TValue;\n }\n return undefined;\n },\n };\n}\n\nfunction getAppRootNode(tree: AppTree) {\n return tree.nodes.get('app/root');\n}\n\nfunction getFinalizationBoundaryNodes(tree: AppTree): AppNode[] {\n const nodes = new Set<AppNode>();\n const appRootNode = getAppRootNode(tree);\n if (appRootNode) {\n nodes.add(appRootNode);\n }\n const attachedAppRootNode = tree.root.edges.attachments.get('app')?.[0];\n if (attachedAppRootNode) {\n nodes.add(attachedAppRootNode);\n }\n return Array.from(nodes);\n}\n\nfunction clearNodeInstance(node: AppNode) {\n (node as AppNode & { instance?: AppNodeInstance }).instance = undefined;\n}\n\nfunction collectBootstrapVisibleNodes(\n tree: AppTree,\n options?: { deferredRoots?: Set<AppNode> },\n) {\n const visibleNodes = new Set<AppNode>();\n\n function visit(node: AppNode) {\n if (visibleNodes.has(node)) {\n return;\n }\n visibleNodes.add(node);\n\n for (const [input, children] of node.edges.attachments) {\n if (isSessionBoundaryAttachment(node, input)) {\n continue;\n }\n\n for (const child of children) {\n if (options?.deferredRoots?.has(child)) {\n continue;\n }\n visit(child);\n }\n }\n }\n\n visit(tree.root);\n\n return visibleNodes;\n}\n\nfunction subtreeContainsPredicate(root: AppNode) {\n const visited = new Set<AppNode>();\n\n function visit(node: AppNode): boolean {\n if (visited.has(node)) {\n return false;\n }\n visited.add(node);\n\n if (node.spec.if !== undefined) {\n return true;\n }\n\n for (const children of node.edges.attachments.values()) {\n for (const child of children) {\n if (visit(child)) {\n return true;\n }\n }\n }\n\n return false;\n }\n\n return visit(root);\n}\n"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"treeLifecycle.esm.js","sources":["../../src/wiring/treeLifecycle.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 {\n ApiHolder,\n AppNode,\n AppNodeInstance,\n AppTree,\n coreExtensionData,\n ExtensionDataRef,\n ExtensionFactoryMiddleware,\n} from '@backstage/frontend-plugin-api';\nimport { FilterPredicate } from '@backstage/filter-predicates';\nimport { collectRouteIds } from '../routing/collectRouteIds';\nimport { ErrorCollector } from './createErrorCollector';\nimport {\n AppTreeApiProxy,\n instantiateAndInitializePhaseTree,\n RouteResolutionApiProxy,\n} from './phaseApis';\n\nexport type BootstrapClassification = {\n deferredApiRoots: Set<AppNode>;\n deferredElementRoots: Set<AppNode>;\n deferredRoots: Set<AppNode>;\n};\n\n/**\n * Instantiates the bootstrap-visible portion of the app tree and returns the\n * element that should be rendered while the prepared app is still incomplete.\n *\n * The bootstrap tree deliberately stops at the session boundary so sign-in and\n * other deferred content can be handled separately during finalization.\n */\nexport function createBootstrapApp(options: {\n tree: AppTree;\n apis: ApiHolder;\n collector: ErrorCollector;\n routeRefsById: ReturnType<typeof collectRouteIds>;\n routeResolutionApi: RouteResolutionApiProxy;\n appTreeApi: AppTreeApiProxy;\n extensionFactoryMiddleware?: ExtensionFactoryMiddleware;\n disableSignIn?: boolean;\n skipBootstrapChild?(ctx: {\n node: AppNode;\n input: string;\n child: AppNode;\n }): boolean;\n onMissingApi?(ctx: { node: AppNode; apiRefId: string }): void;\n hasSignInPage(node?: AppNode): boolean;\n}): {\n bootstrapApp: { element: JSX.Element; tree: AppTree };\n requiresSignIn: boolean;\n} {\n const signInPageNode = getAppRootNode(options.tree)?.edges.attachments.get(\n 'signInPage',\n )?.[0];\n\n instantiateAndInitializePhaseTree({\n tree: options.tree,\n apis: options.apis,\n collector: options.collector,\n extensionFactoryMiddleware: options.extensionFactoryMiddleware,\n routeResolutionApi: options.routeResolutionApi,\n appTreeApi: options.appTreeApi,\n routeRefsById: options.routeRefsById,\n stopAtAttachment: ({ node, input }) =>\n isSessionBoundaryAttachment(node, input),\n skipChild: options.skipBootstrapChild,\n onMissingApi: options.onMissingApi,\n });\n\n const element = options.tree.root.instance?.getData(\n coreExtensionData.reactElement,\n );\n if (!element) {\n throw new Error('Expected bootstrap tree to expose a root element');\n }\n\n return {\n bootstrapApp: {\n element,\n tree: options.tree,\n },\n requiresSignIn:\n !options.disableSignIn && options.hasSignInPage(signInPageNode),\n };\n}\n\n/**\n * Splits the app tree into bootstrap-visible and deferred regions.\n *\n * Predicate-gated roots are deferred to finalization, while any predicate that\n * still leaks into the bootstrap-visible region is reported and ignored.\n */\nexport function classifyBootstrapTree(options: {\n tree: AppTree;\n collector: ErrorCollector;\n}): BootstrapClassification {\n const apiNodes = options.tree.root.edges.attachments.get('apis') ?? [];\n const deferredApiRoots = new Set(\n apiNodes.filter(apiNode => subtreeContainsPredicate(apiNode)),\n );\n const appRootElementNodes =\n getAppRootNode(options.tree)?.edges.attachments.get('elements') ?? [];\n const deferredElementRoots = new Set(\n appRootElementNodes.filter(elementNode =>\n subtreeContainsPredicate(elementNode),\n ),\n );\n const deferredRoots = new Set<AppNode>([\n ...deferredApiRoots,\n ...deferredElementRoots,\n ]);\n const bootstrapNodes = collectBootstrapVisibleNodes(options.tree, {\n deferredRoots,\n });\n\n for (const node of bootstrapNodes) {\n if (node.spec.if === undefined) {\n continue;\n }\n\n options.collector.report({\n code: 'EXTENSION_BOOTSTRAP_PREDICATE_IGNORED',\n message:\n `Extension '${node.spec.id}' uses 'if' during bootstrap, so the predicate was ignored. ` +\n \"Move it behind 'app/root.children', onto a deferred 'app/root.elements' subtree, or into an API subtree.\",\n context: {\n node,\n },\n });\n (node.spec as typeof node.spec & { if?: FilterPredicate }).if = undefined;\n }\n\n return {\n deferredApiRoots,\n deferredElementRoots,\n deferredRoots,\n };\n}\n\n/**\n * Prepares the app tree for finalization by removing the bootstrap-only\n * sign-in attachment from the app root boundary.\n */\nexport function prepareFinalizedTree(options: { tree: AppTree }) {\n for (const appRootNode of getFinalizationBoundaryNodes(options.tree)) {\n const attachments = appRootNode.edges.attachments as Map<string, AppNode[]>;\n attachments.delete('signInPage');\n }\n}\n\n/**\n * Clears instances inside the finalization boundary so those nodes can be\n * re-instantiated with finalized predicate context and API availability.\n */\nexport function clearFinalizationBoundaryInstances(tree: AppTree) {\n clearNodeInstance(tree.root);\n\n const visited = new Set<AppNode>();\n function visit(node: AppNode) {\n if (visited.has(node)) {\n return;\n }\n visited.add(node);\n clearNodeInstance(node);\n\n for (const [input, children] of node.edges.attachments) {\n // app/root.elements is allowed to keep its bootstrap instances so we only\n // re-run the parts of the boundary that actually change at finalization.\n if (node.spec.id === 'app/root' && input === 'elements') {\n continue;\n }\n\n for (const child of children) {\n visit(child);\n }\n }\n }\n\n for (const appRootNode of getFinalizationBoundaryNodes(tree)) {\n visit(appRootNode);\n }\n}\n\n/**\n * Identifies the attachment that separates bootstrap rendering from the\n * children that are deferred until finalization.\n */\nexport function isSessionBoundaryAttachment(node: AppNode, input: string) {\n return node.spec.id === 'app/root' && input === 'children';\n}\n\n/**\n * Injects a synthetic finalization child that throws the captured bootstrap\n * error when rendered.\n *\n * This lets the finalized tree reuse the normal app root error boundary rather\n * than introducing a separate error rendering path.\n */\nexport function attachThrowingFinalizationChild(tree: AppTree, error: Error) {\n const bootstrapChildNode =\n getAppRootNode(tree)?.edges.attachments.get('children')?.[0];\n if (!bootstrapChildNode) {\n throw error;\n }\n\n function ThrowBootstrapError(): never {\n throw error;\n }\n\n // This synthetic child gives the finalized tree a stable place to rethrow\n // bootstrap failures through the normal extension boundary stack.\n (bootstrapChildNode as AppNode & { instance?: AppNodeInstance }).instance = {\n getDataRefs() {\n return [coreExtensionData.reactElement];\n },\n getData<TValue>(dataRef: ExtensionDataRef<TValue>) {\n if (dataRef.id === coreExtensionData.reactElement.id) {\n return (<ThrowBootstrapError />) as TValue;\n }\n return undefined;\n },\n };\n}\n\nfunction getAppRootNode(tree: AppTree) {\n return tree.nodes.get('app/root');\n}\n\nfunction getFinalizationBoundaryNodes(tree: AppTree): AppNode[] {\n const nodes = new Set<AppNode>();\n const appRootNode = getAppRootNode(tree);\n if (appRootNode) {\n nodes.add(appRootNode);\n }\n const attachedAppRootNode = tree.root.edges.attachments.get('app')?.[0];\n if (attachedAppRootNode) {\n nodes.add(attachedAppRootNode);\n }\n return Array.from(nodes);\n}\n\nfunction clearNodeInstance(node: AppNode) {\n (node as AppNode & { instance?: AppNodeInstance }).instance = undefined;\n}\n\nfunction collectBootstrapVisibleNodes(\n tree: AppTree,\n options?: { deferredRoots?: Set<AppNode> },\n) {\n const visibleNodes = new Set<AppNode>();\n\n function visit(node: AppNode) {\n if (visibleNodes.has(node)) {\n return;\n }\n visibleNodes.add(node);\n\n for (const [input, children] of node.edges.attachments) {\n if (isSessionBoundaryAttachment(node, input)) {\n continue;\n }\n\n for (const child of children) {\n if (options?.deferredRoots?.has(child)) {\n continue;\n }\n visit(child);\n }\n }\n }\n\n visit(tree.root);\n\n return visibleNodes;\n}\n\nfunction subtreeContainsPredicate(root: AppNode) {\n const visited = new Set<AppNode>();\n\n function visit(node: AppNode): boolean {\n if (visited.has(node)) {\n return false;\n }\n visited.add(node);\n\n if (node.spec.if !== undefined) {\n return true;\n }\n\n for (const children of node.edges.attachments.values()) {\n for (const child of children) {\n if (visit(child)) {\n return true;\n }\n }\n }\n\n return false;\n }\n\n return visit(root);\n}\n"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@backstage/frontend-app-api",
3
- "version": "0.16.8",
3
+ "version": "0.16.9-next.0",
4
4
  "backstage": {
5
5
  "role": "web-library"
6
6
  },
@@ -32,23 +32,23 @@
32
32
  "test": "backstage-cli package test"
33
33
  },
34
34
  "dependencies": {
35
- "@backstage/config": "^1.3.9",
36
- "@backstage/core-app-api": "^1.20.5",
37
- "@backstage/core-plugin-api": "^1.12.10",
38
- "@backstage/errors": "^1.3.1",
39
- "@backstage/filter-predicates": "^0.1.5",
40
- "@backstage/frontend-defaults": "^0.5.6",
41
- "@backstage/frontend-plugin-api": "^0.18.1",
42
- "@backstage/types": "^1.2.2",
43
- "@backstage/version-bridge": "^1.0.12",
35
+ "@backstage/config": "1.3.10-next.0",
36
+ "@backstage/core-app-api": "1.20.6-next.0",
37
+ "@backstage/core-plugin-api": "1.12.11-next.0",
38
+ "@backstage/errors": "1.3.2-next.0",
39
+ "@backstage/filter-predicates": "0.1.6-next.0",
40
+ "@backstage/frontend-defaults": "0.5.7-next.0",
41
+ "@backstage/frontend-plugin-api": "0.18.2-next.0",
42
+ "@backstage/types": "1.2.2",
43
+ "@backstage/version-bridge": "1.0.12",
44
44
  "lodash": "^4.17.21"
45
45
  },
46
46
  "devDependencies": {
47
- "@backstage/cli": "^0.36.6",
48
- "@backstage/frontend-test-utils": "^0.6.4",
49
- "@backstage/plugin-app": "^0.5.3",
50
- "@backstage/plugin-permission-common": "^0.9.11",
51
- "@backstage/test-utils": "^1.7.22",
47
+ "@backstage/cli": "0.36.7-next.0",
48
+ "@backstage/frontend-test-utils": "0.6.5-next.0",
49
+ "@backstage/plugin-app": "0.5.4-next.0",
50
+ "@backstage/plugin-permission-common": "0.9.12-next.0",
51
+ "@backstage/test-utils": "1.7.23-next.0",
52
52
  "@testing-library/dom": "^10.0.0",
53
53
  "@testing-library/jest-dom": "^6.0.0",
54
54
  "@testing-library/react": "^16.0.0",