@backstage/frontend-app-api 0.6.4 → 0.6.5-next.1

package/dist/tree/instantiateAppNodeTree.esm.js

@@ -0,0 +1,146 @@
+import mapValues from 'lodash/mapValues';
+import { toInternalExtension } from '../frontend-plugin-api/src/wiring/resolveExtensionDefinition.esm.js';
+
+function resolveInputData(dataMap, attachment, inputName) {
+  return mapValues(dataMap, (ref) => {
+    var _a, _b, _c;
+    const value = (_a = attachment.instance) == null ? void 0 : _a.getData(ref);
+    if (value === void 0 && !ref.config.optional) {
+      const expected = Object.values(dataMap).filter((r) => !r.config.optional).map((r) => `'${r.id}'`).join(", ");
+      const provided = [...(_c = (_b = attachment.instance) == null ? void 0 : _b.getDataRefs()) != null ? _c : []].map((r) => `'${r.id}'`).join(", ");
+      throw new Error(
+        `extension '${attachment.spec.id}' could not be attached because its output data (${provided}) does not match what the input '${inputName}' requires (${expected})`
+      );
+    }
+    return value;
+  });
+}
+function resolveInputs(id, inputMap, attachments) {
+  const undeclaredAttachments = Array.from(attachments.entries()).filter(
+    ([inputName]) => inputMap[inputName] === void 0
+  );
+  if (process.env.NODE_ENV !== "production") {
+    const inputNames = Object.keys(inputMap);
+    for (const [name, nodes] of undeclaredAttachments) {
+      const pl = nodes.length > 1;
+      console.warn(
+        [
+          `The extension${pl ? "s" : ""} '${nodes.map((n) => n.spec.id).join("', '")}' ${pl ? "are" : "is"}`,
+          `attached to the input '${name}' of the extension '${id}', but it`,
+          inputNames.length === 0 ? "has no inputs" : `has no such input (candidates are '${inputNames.join("', '")}')`
+        ].join(" ")
+      );
+    }
+  }
+  return mapValues(inputMap, (input, inputName) => {
+    var _a;
+    const attachedNodes = (_a = attachments.get(inputName)) != null ? _a : [];
+    if (input.config.singleton) {
+      if (attachedNodes.length > 1) {
+        const attachedNodeIds = attachedNodes.map((e) => e.spec.id);
+        throw Error(
+          `expected ${input.config.optional ? "at most" : "exactly"} one '${inputName}' input but received multiple: '${attachedNodeIds.join(
+            "', '"
+          )}'`
+        );
+      } else if (attachedNodes.length === 0) {
+        if (input.config.optional) {
+          return void 0;
+        }
+        throw Error(`input '${inputName}' is required but was not received`);
+      }
+      return {
+        node: attachedNodes[0],
+        output: resolveInputData(
+          input.extensionData,
+          attachedNodes[0],
+          inputName
+        )
+      };
+    }
+    return attachedNodes.map((attachment) => ({
+      node: attachment,
+      output: resolveInputData(input.extensionData, attachment, inputName)
+    }));
+  });
+}
+function createAppNodeInstance(options) {
+  var _a;
+  const { node, attachments } = options;
+  const { id, extension, config } = node.spec;
+  const extensionData = /* @__PURE__ */ new Map();
+  const extensionDataRefs = /* @__PURE__ */ new Set();
+  let parsedConfig;
+  try {
+    parsedConfig = (_a = extension.configSchema) == null ? void 0 : _a.parse(config != null ? config : {});
+  } catch (e) {
+    throw new Error(
+      `Invalid configuration for extension '${id}'; caused by ${e}`
+    );
+  }
+  try {
+    const internalExtension = toInternalExtension(extension);
+    const namedOutputs = internalExtension.factory({
+      node,
+      config: parsedConfig,
+      inputs: resolveInputs(id, internalExtension.inputs, attachments)
+    });
+    for (const [name, output] of Object.entries(namedOutputs)) {
+      const ref = internalExtension.output[name];
+      if (!ref) {
+        throw new Error(`unknown output provided via '${name}'`);
+      }
+      if (extensionData.has(ref.id)) {
+        throw new Error(
+          `duplicate extension data '${ref.id}' received via output '${name}'`
+        );
+      }
+      extensionData.set(ref.id, output);
+      extensionDataRefs.add(ref);
+    }
+  } catch (e) {
+    throw new Error(
+      `Failed to instantiate extension '${id}'${e.name === "Error" ? `, ${e.message}` : `; caused by ${e.stack}`}`
+    );
+  }
+  return {
+    getDataRefs() {
+      return extensionDataRefs.values();
+    },
+    getData(ref) {
+      return extensionData.get(ref.id);
+    }
+  };
+}
+function instantiateAppNodeTree(rootNode) {
+  function createInstance(node) {
+    if (node.instance) {
+      return node.instance;
+    }
+    if (node.spec.disabled) {
+      return void 0;
+    }
+    const instantiatedAttachments = /* @__PURE__ */ new Map();
+    for (const [input, children] of node.edges.attachments) {
+      const instantiatedChildren = children.flatMap((child) => {
+        const childInstance = createInstance(child);
+        if (!childInstance) {
+          return [];
+        }
+        return [child];
+      });
+      if (instantiatedChildren.length > 0) {
+        instantiatedAttachments.set(input, instantiatedChildren);
+      }
+    }
+    node.instance = createAppNodeInstance({
+      node,
+      attachments: instantiatedAttachments
+    });
+    return node.instance;
+  }
+  createInstance(rootNode);
+}
+
+export { createAppNodeInstance, instantiateAppNodeTree };
+//# sourceMappingURL=instantiateAppNodeTree.esm.js.map

package/dist/tree/instantiateAppNodeTree.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instantiateAppNodeTree.esm.js","sources":["../../src/tree/instantiateAppNodeTree.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  AnyExtensionDataMap,\n  AnyExtensionInputMap,\n  ExtensionDataRef,\n  ResolvedExtensionInputs,\n} from '@backstage/frontend-plugin-api';\nimport mapValues from 'lodash/mapValues';\nimport { AppNode, AppNodeInstance } from '@backstage/frontend-plugin-api';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { toInternalExtension } from '../../../frontend-plugin-api/src/wiring/resolveExtensionDefinition';\n\ntype Mutable<T> = {\n  -readonly [P in keyof T]: T[P];\n};\n\nfunction resolveInputData(\n  dataMap: AnyExtensionDataMap,\n  attachment: AppNode,\n  inputName: string,\n) {\n  return mapValues(dataMap, ref => {\n    const value = attachment.instance?.getData(ref);\n    if (value === undefined && !ref.config.optional) {\n      const expected = Object.values(dataMap)\n        .filter(r => !r.config.optional)\n        .map(r => `'${r.id}'`)\n        .join(', ');\n\n      const provided = [...(attachment.instance?.getDataRefs() ?? [])]\n        .map(r => `'${r.id}'`)\n        .join(', ');\n\n      throw new Error(\n        `extension '${attachment.spec.id}' could not be attached because its output data (${provided}) does not match what the input '${inputName}' requires (${expected})`,\n      );\n    }\n    return value;\n  });\n}\n\nfunction resolveInputs(\n  id: string,\n  inputMap: AnyExtensionInputMap,\n  attachments: ReadonlyMap<string, AppNode[]>,\n): ResolvedExtensionInputs<AnyExtensionInputMap> {\n  const undeclaredAttachments = Array.from(attachments.entries()).filter(\n    ([inputName]) => inputMap[inputName] === undefined,\n  );\n\n  if (process.env.NODE_ENV !== 'production') {\n    const inputNames = Object.keys(inputMap);\n\n    for (const [name, nodes] of undeclaredAttachments) {\n      const pl = nodes.length > 1;\n      // eslint-disable-next-line no-console\n      console.warn(\n        [\n          `The extension${pl ? 's' : ''} '${nodes\n            .map(n => n.spec.id)\n            .join(\"', '\")}' ${pl ? 'are' : 'is'}`,\n          `attached to the input '${name}' of the extension '${id}', but it`,\n          inputNames.length === 0\n            ? 'has no inputs'\n            : `has no such input (candidates are '${inputNames.join(\"', '\")}')`,\n        ].join(' '),\n      );\n    }\n  }\n\n  return mapValues(inputMap, (input, inputName) => {\n    const attachedNodes = attachments.get(inputName) ?? [];\n\n    if (input.config.singleton) {\n      if (attachedNodes.length > 1) {\n        const attachedNodeIds = attachedNodes.map(e => e.spec.id);\n        throw Error(\n          `expected ${\n            input.config.optional ? 'at most' : 'exactly'\n          } one '${inputName}' input but received multiple: '${attachedNodeIds.join(\n            \"', '\",\n          )}'`,\n        );\n      } else if (attachedNodes.length === 0) {\n        if (input.config.optional) {\n          return undefined;\n        }\n        throw Error(`input '${inputName}' is required but was not received`);\n      }\n      return {\n        node: attachedNodes[0],\n        output: resolveInputData(\n          input.extensionData,\n          attachedNodes[0],\n          inputName,\n        ),\n      };\n    }\n\n    return attachedNodes.map(attachment => ({\n      node: attachment,\n      output: resolveInputData(input.extensionData, attachment, inputName),\n    }));\n  }) as ResolvedExtensionInputs<AnyExtensionInputMap>;\n}\n\n/** @internal */\nexport function createAppNodeInstance(options: {\n  node: AppNode;\n  attachments: ReadonlyMap<string, AppNode[]>;\n}): AppNodeInstance {\n  const { node, attachments } = options;\n  const { id, extension, config } = node.spec;\n  const extensionData = new Map<string, unknown>();\n  const extensionDataRefs = new Set<ExtensionDataRef<unknown>>();\n\n  let parsedConfig: unknown;\n  try {\n    parsedConfig = extension.configSchema?.parse(config ?? {});\n  } catch (e) {\n    throw new Error(\n      `Invalid configuration for extension '${id}'; caused by ${e}`,\n    );\n  }\n\n  try {\n    const internalExtension = toInternalExtension(extension);\n\n    const namedOutputs = internalExtension.factory({\n      node,\n      config: parsedConfig,\n      inputs: resolveInputs(id, internalExtension.inputs, attachments),\n    });\n\n    for (const [name, output] of Object.entries(namedOutputs)) {\n      const ref = internalExtension.output[name];\n      if (!ref) {\n        throw new Error(`unknown output provided via '${name}'`);\n      }\n      if (extensionData.has(ref.id)) {\n        throw new Error(\n          `duplicate extension data '${ref.id}' received via output '${name}'`,\n        );\n      }\n      extensionData.set(ref.id, output);\n      extensionDataRefs.add(ref);\n    }\n  } catch (e) {\n    throw new Error(\n      `Failed to instantiate extension '${id}'${\n        e.name === 'Error' ? `, ${e.message}` : `; caused by ${e.stack}`\n      }`,\n    );\n  }\n\n  return {\n    getDataRefs() {\n      return extensionDataRefs.values();\n    },\n    getData<T>(ref: ExtensionDataRef<T>): T | undefined {\n      return extensionData.get(ref.id) as T | undefined;\n    },\n  };\n}\n\n/**\n * Starting at the provided node, instantiate all reachable nodes in the tree that have not been disabled.\n * @internal\n */\nexport function instantiateAppNodeTree(rootNode: AppNode): void {\n  function createInstance(node: AppNode): AppNodeInstance | undefined {\n    if (node.instance) {\n      return node.instance;\n    }\n    if (node.spec.disabled) {\n      return undefined;\n    }\n\n    const instantiatedAttachments = new Map<string, AppNode[]>();\n\n    for (const [input, children] of node.edges.attachments) {\n      const instantiatedChildren = children.flatMap(child => {\n        const childInstance = createInstance(child);\n        if (!childInstance) {\n          return [];\n        }\n        return [child];\n      });\n      if (instantiatedChildren.length > 0) {\n        instantiatedAttachments.set(input, instantiatedChildren);\n      }\n    }\n\n    (node as Mutable<AppNode>).instance = createAppNodeInstance({\n      node,\n      attachments: instantiatedAttachments,\n    });\n\n    return node.instance;\n  }\n\n  createInstance(rootNode);\n}\n"],"names":[],"mappings":"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"}

package/dist/tree/readAppExtensionsConfig.esm.js

@@ -0,0 +1,106 @@
+const knownExtensionParameters = ["attachTo", "disabled", "config"];
+function readAppExtensionsConfig(rootConfig) {
+  const arr = rootConfig.getOptional("app.extensions");
+  if (!Array.isArray(arr)) {
+    if (arr === void 0) {
+      return [];
+    }
+    rootConfig.getConfigArray("app.extensions");
+    return [];
+  }
+  return arr.map(
+    (arrayEntry, arrayIndex) => expandShorthandExtensionParameters(arrayEntry, arrayIndex)
+  );
+}
+function expandShorthandExtensionParameters(arrayEntry, arrayIndex) {
+  function errorMsg(msg, key, prop) {
+    return `Invalid extension configuration at app.extensions[${arrayIndex}]${key ? `[${key}]` : ""}${prop ? `.${prop}` : ""}, ${msg}`;
+  }
+  function assertValidId(id2) {
+    if (!id2 || id2 !== id2.trim()) {
+      throw new Error(
+        errorMsg("extension ID must not be empty or contain whitespace")
+      );
+    }
+  }
+  if (typeof arrayEntry === "string") {
+    assertValidId(arrayEntry);
+    return {
+      id: arrayEntry,
+      disabled: false
+    };
+  }
+  if (typeof arrayEntry !== "object" || arrayEntry === null || Array.isArray(arrayEntry)) {
+    throw new Error(errorMsg("must be a string or an object"));
+  }
+  const keys = Object.keys(arrayEntry);
+  if (keys.length !== 1) {
+    const joinedKeys = keys.length ? `'${keys.join("', '")}'` : "none";
+    throw new Error(errorMsg(`must have exactly one key, got ${joinedKeys}`));
+  }
+  const id = String(keys[0]);
+  const value = arrayEntry[id];
+  assertValidId(id);
+  if (value === null) {
+    return {
+      id,
+      disabled: false
+    };
+  }
+  if (typeof value === "boolean") {
+    return {
+      id,
+      disabled: !value
+    };
+  }
+  if (typeof value !== "object" || Array.isArray(value)) {
+    throw new Error(errorMsg("value must be a boolean or object", id));
+  }
+  const attachTo = value.attachTo;
+  const disabled = value.disabled;
+  const config = value.config;
+  if (attachTo !== void 0) {
+    if (attachTo === null || typeof attachTo !== "object" || Array.isArray(attachTo)) {
+      throw new Error(errorMsg("must be an object", id, "attachTo"));
+    }
+    if (typeof attachTo.id !== "string" || attachTo.id === "") {
+      throw new Error(
+        errorMsg("must be a non-empty string", id, "attachTo.id")
+      );
+    }
+    if (typeof attachTo.input !== "string" || attachTo.input === "") {
+      throw new Error(
+        errorMsg("must be a non-empty string", id, "attachTo.input")
+      );
+    }
+  }
+  if (disabled !== void 0 && typeof disabled !== "boolean") {
+    throw new Error(errorMsg("must be a boolean", id, "disabled"));
+  }
+  if (config !== void 0 && (typeof config !== "object" || config === null || Array.isArray(config))) {
+    throw new Error(errorMsg("must be an object", id, "config"));
+  }
+  const unknownKeys = Object.keys(value).filter(
+    (k) => !knownExtensionParameters.includes(k)
+  );
+  if (unknownKeys.length > 0) {
+    throw new Error(
+      errorMsg(
+        `unknown parameter; expected one of '${knownExtensionParameters.join(
+          "', '"
+        )}'`,
+        id,
+        unknownKeys.join(", ")
+      )
+    );
+  }
+  return {
+    id,
+    attachTo,
+    disabled,
+    config
+  };
+}
+
+export { expandShorthandExtensionParameters, readAppExtensionsConfig };
+//# sourceMappingURL=readAppExtensionsConfig.esm.js.map

package/dist/tree/readAppExtensionsConfig.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readAppExtensionsConfig.esm.js","sources":["../../src/tree/readAppExtensionsConfig.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 { Config } from '@backstage/config';\nimport { JsonValue } from '@backstage/types';\n\nexport interface ExtensionParameters {\n  id: string;\n  attachTo?: { id: string; input: string };\n  disabled?: boolean;\n  config?: unknown;\n}\n\nconst knownExtensionParameters = ['attachTo', 'disabled', 'config'];\n\n// Since we'll never merge arrays in config the config reader context\n// isn't too much of a help. Fall back to manual config reading logic\n// as the Config interface makes it quite hard for us otherwise.\n/** @internal */\nexport function readAppExtensionsConfig(\n  rootConfig: Config,\n): ExtensionParameters[] {\n  const arr = rootConfig.getOptional('app.extensions');\n  if (!Array.isArray(arr)) {\n    if (arr === undefined) {\n      return [];\n    }\n    // This will throw, and show which part of config had the wrong type\n    rootConfig.getConfigArray('app.extensions');\n    return [];\n  }\n\n  return arr.map((arrayEntry, arrayIndex) =>\n    expandShorthandExtensionParameters(arrayEntry, arrayIndex),\n  );\n}\n\n/** @internal */\nexport function expandShorthandExtensionParameters(\n  arrayEntry: JsonValue,\n  arrayIndex: number,\n): ExtensionParameters {\n  function errorMsg(msg: string, key?: string, prop?: string) {\n    return `Invalid extension configuration at app.extensions[${arrayIndex}]${\n      key ? `[${key}]` : ''\n    }${prop ? `.${prop}` : ''}, ${msg}`;\n  }\n\n  // NOTE(freben): This check is intentionally not complete and doesn't check\n  // whether letters and digits are used, etc. It's not up to the config reading\n  // logic to decide what constitutes a valid extension ID; that should be\n  // decided by the logic that loads and instantiates the extensions. This check\n  // is just here to catch real mistakes or truly conceptually wrong input.\n  function assertValidId(id: string) {\n    if (!id || id !== id.trim()) {\n      throw new Error(\n        errorMsg('extension ID must not be empty or contain whitespace'),\n      );\n    }\n  }\n\n  // Example YAML:\n  // - entity.card.about\n  if (typeof arrayEntry === 'string') {\n    assertValidId(arrayEntry);\n    return {\n      id: arrayEntry,\n      disabled: false,\n    };\n  }\n\n  // All remaining cases are single-key objects\n  if (\n    typeof arrayEntry !== 'object' ||\n    arrayEntry === null ||\n    Array.isArray(arrayEntry)\n  ) {\n    throw new Error(errorMsg('must be a string or an object'));\n  }\n  const keys = Object.keys(arrayEntry);\n  if (keys.length !== 1) {\n    const joinedKeys = keys.length ? `'${keys.join(\"', '\")}'` : 'none';\n    throw new Error(errorMsg(`must have exactly one key, got ${joinedKeys}`));\n  }\n\n  const id = String(keys[0]);\n  const value = arrayEntry[id];\n  assertValidId(id);\n\n  // This example covers a potentially common mistake in the syntax\n  // Example YAML:\n  // - entity.card.about:\n  if (value === null) {\n    return {\n      id,\n      disabled: false,\n    };\n  }\n\n  // Example YAML:\n  // - catalog.page.cicd: false\n  if (typeof value === 'boolean') {\n    return {\n      id,\n      disabled: !value,\n    };\n  }\n\n  // The remaining case is the generic object. Example YAML:\n  //  - tech-radar.page:\n  //      at: core.router/routes\n  //      disabled: false\n  //      config:\n  //        path: /tech-radar\n  //        width: 1500\n  //        height: 800\n  if (typeof value !== 'object' || Array.isArray(value)) {\n    // We don't mention null here - we don't want people to explicitly enter\n    // - entity.card.about: null\n    throw new Error(errorMsg('value must be a boolean or object', id));\n  }\n\n  const attachTo = value.attachTo as { id: string; input: string } | undefined;\n  const disabled = value.disabled;\n  const config = value.config;\n\n  if (attachTo !== undefined) {\n    if (\n      attachTo === null ||\n      typeof attachTo !== 'object' ||\n      Array.isArray(attachTo)\n    ) {\n      throw new Error(errorMsg('must be an object', id, 'attachTo'));\n    }\n    if (typeof attachTo.id !== 'string' || attachTo.id === '') {\n      throw new Error(\n        errorMsg('must be a non-empty string', id, 'attachTo.id'),\n      );\n    }\n    if (typeof attachTo.input !== 'string' || attachTo.input === '') {\n      throw new Error(\n        errorMsg('must be a non-empty string', id, 'attachTo.input'),\n      );\n    }\n  }\n  if (disabled !== undefined && typeof disabled !== 'boolean') {\n    throw new Error(errorMsg('must be a boolean', id, 'disabled'));\n  }\n  if (\n    config !== undefined &&\n    (typeof config !== 'object' || config === null || Array.isArray(config))\n  ) {\n    throw new Error(errorMsg('must be an object', id, 'config'));\n  }\n\n  const unknownKeys = Object.keys(value).filter(\n    k => !knownExtensionParameters.includes(k),\n  );\n  if (unknownKeys.length > 0) {\n    throw new Error(\n      errorMsg(\n        `unknown parameter; expected one of '${knownExtensionParameters.join(\n          \"', '\",\n        )}'`,\n        id,\n        unknownKeys.join(', '),\n      ),\n    );\n  }\n\n  return {\n    id,\n    attachTo,\n    disabled,\n    config,\n  };\n}\n"],"names":["id"],"mappings":"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"}

package/dist/tree/resolveAppNodeSpecs.esm.js

@@ -0,0 +1,168 @@
+import { toInternalExtensionOverrides } from '../frontend-plugin-api/src/wiring/createExtensionOverrides.esm.js';
+import { toInternalBackstagePlugin } from '../frontend-plugin-api/src/wiring/createPlugin.esm.js';
+import { toInternalExtension } from '../frontend-plugin-api/src/wiring/resolveExtensionDefinition.esm.js';
+
+function resolveAppNodeSpecs(options) {
+  var _a;
+  const {
+    builtinExtensions = [],
+    parameters = [],
+    forbidden = /* @__PURE__ */ new Set(),
+    features = []
+  } = options;
+  const plugins = features.filter(
+    (f) => f.$$type === "@backstage/BackstagePlugin"
+  );
+  const overrides = features.filter(
+    (f) => f.$$type === "@backstage/ExtensionOverrides"
+  );
+  const pluginExtensions = plugins.flatMap((source) => {
+    return toInternalBackstagePlugin(source).extensions.map((extension) => ({
+      ...extension,
+      source
+    }));
+  });
+  const overrideExtensions = overrides.flatMap(
+    (override) => toInternalExtensionOverrides(override).extensions
+  );
+  if (pluginExtensions.some(({ id }) => forbidden.has(id))) {
+    const pluginsStr = pluginExtensions.filter(({ id }) => forbidden.has(id)).map(({ source }) => `'${source.id}'`).join(", ");
+    const forbiddenStr = [...forbidden].map((id) => `'${id}'`).join(", ");
+    throw new Error(
+      `It is forbidden to override the following extension(s): ${forbiddenStr}, which is done by the following plugin(s): ${pluginsStr}`
+    );
+  }
+  if (overrideExtensions.some(({ id }) => forbidden.has(id))) {
+    const forbiddenStr = [...forbidden].map((id) => `'${id}'`).join(", ");
+    throw new Error(
+      `It is forbidden to override the following extension(s): ${forbiddenStr}, which is done by one or more extension overrides`
+    );
+  }
+  const overrideExtensionIds = overrideExtensions.map(({ id }) => id);
+  if (overrideExtensionIds.length !== new Set(overrideExtensionIds).size) {
+    const counts = /* @__PURE__ */ new Map();
+    for (const id of overrideExtensionIds) {
+      counts.set(id, ((_a = counts.get(id)) != null ? _a : 0) + 1);
+    }
+    const duplicated = Array.from(counts.entries()).filter(([, count]) => count > 1).map(([id]) => id);
+    throw new Error(
+      `The following extensions had duplicate overrides: ${duplicated.join(
+        ", "
+      )}`
+    );
+  }
+  const configuredExtensions = [
+    ...pluginExtensions.map(({ source, ...extension }) => {
+      const internalExtension = toInternalExtension(extension);
+      return {
+        extension: internalExtension,
+        params: {
+          source,
+          attachTo: internalExtension.attachTo,
+          disabled: internalExtension.disabled,
+          config: void 0
+        }
+      };
+    }),
+    ...builtinExtensions.map((extension) => {
+      const internalExtension = toInternalExtension(extension);
+      return {
+        extension: internalExtension,
+        params: {
+          source: void 0,
+          attachTo: internalExtension.attachTo,
+          disabled: internalExtension.disabled,
+          config: void 0
+        }
+      };
+    })
+  ];
+  for (const extension of overrideExtensions) {
+    const internalExtension = toInternalExtension(extension);
+    const index = configuredExtensions.findIndex(
+      (e) => e.extension.id === extension.id
+    );
+    if (index !== -1) {
+      configuredExtensions[index].extension = internalExtension;
+      configuredExtensions[index].params.attachTo = internalExtension.attachTo;
+      configuredExtensions[index].params.disabled = internalExtension.disabled;
+    } else {
+      configuredExtensions.push({
+        extension: internalExtension,
+        params: {
+          source: void 0,
+          attachTo: internalExtension.attachTo,
+          disabled: internalExtension.disabled,
+          config: void 0
+        }
+      });
+    }
+  }
+  const duplicatedExtensionIds = /* @__PURE__ */ new Set();
+  const duplicatedExtensionData = configuredExtensions.reduce((data, { extension, params }) => {
+    var _a2, _b, _c;
+    const extensionId = extension.id;
+    const extensionData = data == null ? void 0 : data[extensionId];
+    if (extensionData)
+      duplicatedExtensionIds.add(extensionId);
+    const pluginId = (_b = (_a2 = params.source) == null ? void 0 : _a2.id) != null ? _b : "internal";
+    const pluginCount = (_c = extensionData == null ? void 0 : extensionData[pluginId]) != null ? _c : 0;
+    return {
+      ...data,
+      [extensionId]: { ...extensionData, [pluginId]: pluginCount + 1 }
+    };
+  }, {});
+  if (duplicatedExtensionIds.size > 0) {
+    throw new Error(
+      `The following extensions are duplicated: ${Array.from(
+        duplicatedExtensionIds
+      ).map(
+        (extensionId) => `The extension '${extensionId}' was provided ${Object.keys(
+          duplicatedExtensionData[extensionId]
+        ).map(
+          (pluginId) => `${duplicatedExtensionData[extensionId][pluginId]} time(s) by the plugin '${pluginId}'`
+        ).join(" and ")}`
+      ).join(", ")}`
+    );
+  }
+  for (const overrideParam of parameters) {
+    const extensionId = overrideParam.id;
+    if (forbidden.has(extensionId)) {
+      throw new Error(
+        `Configuration of the '${extensionId}' extension is forbidden`
+      );
+    }
+    const existingIndex = configuredExtensions.findIndex(
+      (e) => e.extension.id === extensionId
+    );
+    if (existingIndex !== -1) {
+      const existing = configuredExtensions[existingIndex];
+      if (overrideParam.attachTo) {
+        existing.params.attachTo = overrideParam.attachTo;
+      }
+      if (overrideParam.config) {
+        existing.params.config = overrideParam.config;
+      }
+      if (Boolean(existing.params.disabled) !== Boolean(overrideParam.disabled)) {
+        existing.params.disabled = Boolean(overrideParam.disabled);
+        if (!existing.params.disabled) {
+          configuredExtensions.splice(existingIndex, 1);
+          configuredExtensions.push(existing);
+        }
+      }
+    } else {
+      throw new Error(`Extension ${extensionId} does not exist`);
+    }
+  }
+  return configuredExtensions.map((param) => ({
+    id: param.extension.id,
+    attachTo: param.params.attachTo,
+    extension: param.extension,
+    disabled: param.params.disabled,
+    source: param.params.source,
+    config: param.params.config
+  }));
+}
+
+export { resolveAppNodeSpecs };
+//# sourceMappingURL=resolveAppNodeSpecs.esm.js.map

package/dist/tree/resolveAppNodeSpecs.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveAppNodeSpecs.esm.js","sources":["../../src/tree/resolveAppNodeSpecs.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  BackstagePlugin,\n  Extension,\n  ExtensionOverrides,\n  FrontendFeature,\n} from '@backstage/frontend-plugin-api';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { toInternalExtensionOverrides } from '../../../frontend-plugin-api/src/wiring/createExtensionOverrides';\nimport { ExtensionParameters } from './readAppExtensionsConfig';\nimport { AppNodeSpec } from '@backstage/frontend-plugin-api';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { toInternalBackstagePlugin } from '../../../frontend-plugin-api/src/wiring/createPlugin';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { toInternalExtension } from '../../../frontend-plugin-api/src/wiring/resolveExtensionDefinition';\n\n/** @internal */\nexport function resolveAppNodeSpecs(options: {\n  features?: FrontendFeature[];\n  builtinExtensions?: Extension<unknown>[];\n  parameters?: Array<ExtensionParameters>;\n  forbidden?: Set<string>;\n}): AppNodeSpec[] {\n  const {\n    builtinExtensions = [],\n    parameters = [],\n    forbidden = new Set(),\n    features = [],\n  } = options;\n\n  const plugins = features.filter(\n    (f): f is BackstagePlugin => f.$$type === '@backstage/BackstagePlugin',\n  );\n  const overrides = features.filter(\n    (f): f is ExtensionOverrides =>\n      f.$$type === '@backstage/ExtensionOverrides',\n  );\n\n  const pluginExtensions = plugins.flatMap(source => {\n    return toInternalBackstagePlugin(source).extensions.map(extension => ({\n      ...extension,\n      source,\n    }));\n  });\n  const overrideExtensions = overrides.flatMap(\n    override => toInternalExtensionOverrides(override).extensions,\n  );\n\n  // Prevent core override\n  if (pluginExtensions.some(({ id }) => forbidden.has(id))) {\n    const pluginsStr = pluginExtensions\n      .filter(({ id }) => forbidden.has(id))\n      .map(({ source }) => `'${source.id}'`)\n      .join(', ');\n    const forbiddenStr = [...forbidden].map(id => `'${id}'`).join(', ');\n    throw new Error(\n      `It is forbidden to override the following extension(s): ${forbiddenStr}, which is done by the following plugin(s): ${pluginsStr}`,\n    );\n  }\n\n  if (overrideExtensions.some(({ id }) => forbidden.has(id))) {\n    const forbiddenStr = [...forbidden].map(id => `'${id}'`).join(', ');\n    throw new Error(\n      `It is forbidden to override the following extension(s): ${forbiddenStr}, which is done by one or more extension overrides`,\n    );\n  }\n  const overrideExtensionIds = overrideExtensions.map(({ id }) => id);\n  if (overrideExtensionIds.length !== new Set(overrideExtensionIds).size) {\n    const counts = new Map<string, number>();\n    for (const id of overrideExtensionIds) {\n      counts.set(id, (counts.get(id) ?? 0) + 1);\n    }\n    const duplicated = Array.from(counts.entries())\n      .filter(([, count]) => count > 1)\n      .map(([id]) => id);\n    throw new Error(\n      `The following extensions had duplicate overrides: ${duplicated.join(\n        ', ',\n      )}`,\n    );\n  }\n\n  const configuredExtensions = [\n    ...pluginExtensions.map(({ source, ...extension }) => {\n      const internalExtension = toInternalExtension(extension);\n      return {\n        extension: internalExtension,\n        params: {\n          source,\n          attachTo: internalExtension.attachTo,\n          disabled: internalExtension.disabled,\n          config: undefined as unknown,\n        },\n      };\n    }),\n    ...builtinExtensions.map(extension => {\n      const internalExtension = toInternalExtension(extension);\n      return {\n        extension: internalExtension,\n        params: {\n          source: undefined,\n          attachTo: internalExtension.attachTo,\n          disabled: internalExtension.disabled,\n          config: undefined as unknown,\n        },\n      };\n    }),\n  ];\n\n  // Install all extension overrides\n  for (const extension of overrideExtensions) {\n    const internalExtension = toInternalExtension(extension);\n\n    // Check if our override is overriding an extension that already exists\n    const index = configuredExtensions.findIndex(\n      e => e.extension.id === extension.id,\n    );\n    if (index !== -1) {\n      // Only implementation, attachment point and default disabled status are overridden, the source is kept\n      configuredExtensions[index].extension = internalExtension;\n      configuredExtensions[index].params.attachTo = internalExtension.attachTo;\n      configuredExtensions[index].params.disabled = internalExtension.disabled;\n    } else {\n      // Add the extension as a new one when not overriding an existing one\n      configuredExtensions.push({\n        extension: internalExtension,\n        params: {\n          source: undefined,\n          attachTo: internalExtension.attachTo,\n          disabled: internalExtension.disabled,\n          config: undefined,\n        },\n      });\n    }\n  }\n\n  const duplicatedExtensionIds = new Set<string>();\n  const duplicatedExtensionData = configuredExtensions.reduce<\n    Record<string, Record<string, number>>\n  >((data, { extension, params }) => {\n    const extensionId = extension.id;\n    const extensionData = data?.[extensionId];\n    if (extensionData) duplicatedExtensionIds.add(extensionId);\n    const pluginId = params.source?.id ?? 'internal';\n    const pluginCount = extensionData?.[pluginId] ?? 0;\n    return {\n      ...data,\n      [extensionId]: { ...extensionData, [pluginId]: pluginCount + 1 },\n    };\n  }, {});\n\n  if (duplicatedExtensionIds.size > 0) {\n    throw new Error(\n      `The following extensions are duplicated: ${Array.from(\n        duplicatedExtensionIds,\n      )\n        .map(\n          extensionId =>\n            `The extension '${extensionId}' was provided ${Object.keys(\n              duplicatedExtensionData[extensionId],\n            )\n              .map(\n                pluginId =>\n                  `${duplicatedExtensionData[extensionId][pluginId]} time(s) by the plugin '${pluginId}'`,\n              )\n              .join(' and ')}`,\n        )\n        .join(', ')}`,\n    );\n  }\n\n  for (const overrideParam of parameters) {\n    const extensionId = overrideParam.id;\n\n    if (forbidden.has(extensionId)) {\n      throw new Error(\n        `Configuration of the '${extensionId}' extension is forbidden`,\n      );\n    }\n\n    const existingIndex = configuredExtensions.findIndex(\n      e => e.extension.id === extensionId,\n    );\n    if (existingIndex !== -1) {\n      const existing = configuredExtensions[existingIndex];\n      if (overrideParam.attachTo) {\n        existing.params.attachTo = overrideParam.attachTo;\n      }\n      if (overrideParam.config) {\n        // TODO: merge config?\n        existing.params.config = overrideParam.config;\n      }\n      if (\n        Boolean(existing.params.disabled) !== Boolean(overrideParam.disabled)\n      ) {\n        existing.params.disabled = Boolean(overrideParam.disabled);\n        if (!existing.params.disabled) {\n          // bump\n          configuredExtensions.splice(existingIndex, 1);\n          configuredExtensions.push(existing);\n        }\n      }\n    } else {\n      throw new Error(`Extension ${extensionId} does not exist`);\n    }\n  }\n\n  return configuredExtensions.map(param => ({\n    id: param.extension.id,\n    attachTo: param.params.attachTo,\n    extension: param.extension,\n    disabled: param.params.disabled,\n    source: param.params.source,\n    config: param.params.config,\n  }));\n}\n"],"names":["_a"],"mappings":"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"}

package/dist/tree/resolveAppTree.esm.js

@@ -0,0 +1,97 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+function indent(str) {
+  return str.replace(/^/gm, "  ");
+}
+class SerializableAppNode {
+  constructor(spec) {
+    __publicField(this, "spec");
+    __publicField(this, "edges", {
+      attachedTo: void 0,
+      attachments: /* @__PURE__ */ new Map()
+    });
+    __publicField(this, "instance");
+    this.spec = spec;
+  }
+  setParent(parent) {
+    const input = this.spec.attachTo.input;
+    this.edges.attachedTo = { node: parent, input };
+    const parentInputEdges = parent.edges.attachments.get(input);
+    if (parentInputEdges) {
+      parentInputEdges.push(this);
+    } else {
+      parent.edges.attachments.set(input, [this]);
+    }
+  }
+  toJSON() {
+    const dataRefs = this.instance && [...this.instance.getDataRefs()];
+    return {
+      id: this.spec.id,
+      output: dataRefs && dataRefs.length > 0 ? dataRefs.map((ref) => ref.id) : void 0,
+      attachments: this.edges.attachments.size > 0 ? Object.fromEntries(this.edges.attachments) : void 0
+    };
+  }
+  toString() {
+    const dataRefs = this.instance && [...this.instance.getDataRefs()];
+    const out = dataRefs && dataRefs.length > 0 ? ` out=[${[...dataRefs].map((r) => r.id).join(", ")}]` : "";
+    if (this.edges.attachments.size === 0) {
+      return `<${this.spec.id}${out} />`;
+    }
+    return [
+      `<${this.spec.id}${out}>`,
+      ...[...this.edges.attachments.entries()].map(
+        ([k, v]) => indent([`${k} [`, ...v.map((e) => indent(e.toString())), `]`].join("\n"))
+      ),
+      `</${this.spec.id}>`
+    ].join("\n");
+  }
+}
+function resolveAppTree(rootNodeId, specs) {
+  const nodes = /* @__PURE__ */ new Map();
+  let rootNode = void 0;
+  const orphansByParent = /* @__PURE__ */ new Map();
+  for (const spec of specs) {
+    if (nodes.has(spec.id)) {
+      throw new Error(`Unexpected duplicate extension id '${spec.id}'`);
+    }
+    const node = new SerializableAppNode(spec);
+    nodes.set(spec.id, node);
+    if (spec.id === rootNodeId) {
+      rootNode = node;
+    } else {
+      const parent = nodes.get(spec.attachTo.id);
+      if (parent) {
+        node.setParent(parent);
+      } else {
+        const orphanNodesForParent = orphansByParent.get(spec.attachTo.id);
+        if (orphanNodesForParent) {
+          orphanNodesForParent.push(node);
+        } else {
+          orphansByParent.set(spec.attachTo.id, [node]);
+        }
+      }
+    }
+    const orphanedChildren = orphansByParent.get(spec.id);
+    if (orphanedChildren) {
+      orphansByParent.delete(spec.id);
+      for (const orphan of orphanedChildren) {
+        orphan.setParent(node);
+      }
+    }
+  }
+  if (!rootNode) {
+    throw new Error(`No root node with id '${rootNodeId}' found in app tree`);
+  }
+  return {
+    root: rootNode,
+    nodes,
+    orphans: Array.from(orphansByParent.values()).flat()
+  };
+}
+
+export { resolveAppTree };
+//# sourceMappingURL=resolveAppTree.esm.js.map

package/dist/tree/resolveAppTree.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveAppTree.esm.js","sources":["../../src/tree/resolveAppTree.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  AppTree,\n  AppNode,\n  AppNodeInstance,\n  AppNodeSpec,\n} from '@backstage/frontend-plugin-api';\n\nfunction indent(str: string) {\n  return str.replace(/^/gm, '  ');\n}\n\n/** @internal */\nclass SerializableAppNode implements AppNode {\n  public readonly spec: AppNodeSpec;\n  public readonly edges = {\n    attachedTo: undefined as { node: AppNode; input: string } | undefined,\n    attachments: new Map<string, SerializableAppNode[]>(),\n  };\n  public readonly instance?: AppNodeInstance;\n\n  constructor(spec: AppNodeSpec) {\n    this.spec = spec;\n  }\n\n  setParent(parent: SerializableAppNode) {\n    const input = this.spec.attachTo.input;\n\n    this.edges.attachedTo = { node: parent, input };\n\n    const parentInputEdges = parent.edges.attachments.get(input);\n    if (parentInputEdges) {\n      parentInputEdges.push(this);\n    } else {\n      parent.edges.attachments.set(input, [this]);\n    }\n  }\n\n  toJSON() {\n    const dataRefs = this.instance && [...this.instance.getDataRefs()];\n    return {\n      id: this.spec.id,\n      output:\n        dataRefs && dataRefs.length > 0\n          ? dataRefs.map(ref => ref.id)\n          : undefined,\n      attachments:\n        this.edges.attachments.size > 0\n          ? Object.fromEntries(this.edges.attachments)\n          : undefined,\n    };\n  }\n\n  toString(): string {\n    const dataRefs = this.instance && [...this.instance.getDataRefs()];\n    const out =\n      dataRefs && dataRefs.length > 0\n        ? ` out=[${[...dataRefs].map(r => r.id).join(', ')}]`\n        : '';\n\n    if (this.edges.attachments.size === 0) {\n      return `<${this.spec.id}${out} />`;\n    }\n\n    return [\n      `<${this.spec.id}${out}>`,\n      ...[...this.edges.attachments.entries()].map(([k, v]) =>\n        indent([`${k} [`, ...v.map(e => indent(e.toString())), `]`].join('\\n')),\n      ),\n      `</${this.spec.id}>`,\n    ].join('\\n');\n  }\n}\n\n/**\n * Build the app tree by iterating through all node specs and constructing the app\n * tree with all attachments in the same order as they appear in the input specs array.\n * @internal\n */\nexport function resolveAppTree(\n  rootNodeId: string,\n  specs: AppNodeSpec[],\n): AppTree {\n  const nodes = new Map<string, SerializableAppNode>();\n\n  // A node with the provided rootNodeId must be found in the tree, and it must not be attached to anything\n  let rootNode: AppNode | undefined = undefined;\n\n  // While iterating through the inputs specs we keep track of all nodes that were created\n  // before their parent, and attach them later when the parent is created.\n  // As we find the parents and attach the children, we remove them from this map. This means\n  // that after iterating through all input specs, this will be a map for each root node.\n  const orphansByParent = new Map<\n    string /* parentId */,\n    SerializableAppNode[]\n  >();\n\n  for (const spec of specs) {\n    // The main check with a more helpful error message happens in resolveAppNodeSpecs\n    if (nodes.has(spec.id)) {\n      throw new Error(`Unexpected duplicate extension id '${spec.id}'`);\n    }\n\n    const node = new SerializableAppNode(spec);\n    nodes.set(spec.id, node);\n\n    // TODO: For now we simply ignore the attachTo spec of the root node, but it'd be cleaner if we could avoid defining it\n    if (spec.id === rootNodeId) {\n      rootNode = node;\n    } else {\n      const parent = nodes.get(spec.attachTo.id);\n      if (parent) {\n        node.setParent(parent);\n      } else {\n        const orphanNodesForParent = orphansByParent.get(spec.attachTo.id);\n        if (orphanNodesForParent) {\n          orphanNodesForParent.push(node);\n        } else {\n          orphansByParent.set(spec.attachTo.id, [node]);\n        }\n      }\n    }\n\n    const orphanedChildren = orphansByParent.get(spec.id);\n    if (orphanedChildren) {\n      orphansByParent.delete(spec.id);\n      for (const orphan of orphanedChildren) {\n        orphan.setParent(node);\n      }\n    }\n  }\n\n  if (!rootNode) {\n    throw new Error(`No root node with id '${rootNodeId}' found in app tree`);\n  }\n\n  return {\n    root: rootNode,\n    nodes,\n    orphans: Array.from(orphansByParent.values()).flat(),\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/wiring/InternalAppContext.esm.js

@@ -0,0 +1,6 @@
+import { createContext } from 'react';
+
+const InternalAppContext = createContext(void 0);
+
+export { InternalAppContext };
+//# sourceMappingURL=InternalAppContext.esm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InternalAppContext.esm.js","sources":["../../src/wiring/InternalAppContext.ts"],"sourcesContent":["/*\n * Copyright 2022 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 { createContext } from 'react';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { AppIdentityProxy } from '../../../core-app-api/src/apis/implementations/IdentityApi/AppIdentityProxy';\nimport { BackstageRouteObject } from '../routing/types';\n\nexport const InternalAppContext = createContext<\n  | undefined\n  | {\n      appIdentityProxy: AppIdentityProxy;\n      routeObjects: BackstageRouteObject[];\n    }\n>(undefined);\n"],"names":[],"mappings":";;AAqBa,MAAA,kBAAA,GAAqB,cAMhC,KAAS,CAAA;;;;"}