@backstage/frontend-test-utils 0.1.12-next.1 → 0.1.12-next.3

package/CHANGELOG.md

@@ -1,5 +1,66 @@
 # @backstage/frontend-test-utils
 
+## 0.1.12-next.3
+
+### Patch Changes
+
+- 2d21599: Added support for being able to override extension definitions.
+
+  ```tsx
+  const TestCard = EntityCardBlueprint.make({
+    ...
+  });
+
+  TestCard.override({
+    // override attachment points
+    attachTo: { id: 'something-else', input: 'overridden' },
+    // extend the config schema
+    config: {
+      schema: {
+        newConfig: z => z.string().optional(),
+      }
+    },
+    // override factory
+    *factory(originalFactory, { inputs, config }){
+      const originalOutput = originalFactory();
+
+      yield coreExentsionData.reactElement(
+        <Wrapping>
+          {originalOutput.get(coreExentsionData.reactElement)}
+        </Wrapping>
+      );
+    }
+  });
+
+  ```
+
+- 264e10f: Deprecate existing `ExtensionCreators` in favour of their new Blueprint counterparts.
+- 264e10f: Refactor `.make` method on Blueprints into two different methods, `.make` and `.makeWithOverrides`.
+
+  When using `createExtensionBlueprint` you can define parameters for the factory function, if you wish to take advantage of these parameters you should use `.make` when creating an extension instance of a Blueprint. If you wish to override more things other than the standard `attachTo`, `name`, `namespace` then you should use `.makeWithOverrides` instead.
+
+  `.make` is reserved for simple creation of extension instances from Blueprints using higher level parameters, whereas `.makeWithOverrides` is lower level and you have more control over the final extension.
+
+- Updated dependencies
+  - @backstage/frontend-plugin-api@0.7.0-next.3
+  - @backstage/frontend-app-api@0.7.5-next.3
+  - @backstage/config@1.2.0
+  - @backstage/test-utils@1.5.10-next.2
+  - @backstage/types@1.1.1
+
+## 0.1.12-next.2
+
+### Patch Changes
+
+- 8209449: Added new APIs for testing extensions
+- 72754db: Updated usage of `useRouteRef`, which can now always return `undefined`.
+- Updated dependencies
+  - @backstage/frontend-plugin-api@0.7.0-next.2
+  - @backstage/frontend-app-api@0.7.5-next.2
+  - @backstage/test-utils@1.5.10-next.2
+  - @backstage/config@1.2.0
+  - @backstage/types@1.1.1
+
 ## 0.1.12-next.1
 
 ### Patch Changes

package/dist/app/createExtensionTester.esm.js

@@ -3,14 +3,21 @@ import { Link, MemoryRouter } from 'react-router-dom';
 import { render } from '@testing-library/react';
 import { createSpecializedApp } from '@backstage/frontend-app-api';
 import { createExtension, createExtensionInput, createNavItemExtension, coreExtensionData, useRouteRef, createExtensionOverrides, createRouterExtension } from '@backstage/frontend-plugin-api';
-import { MockConfigApi } from '@backstage/test-utils';
+import { ConfigReader } from '@backstage/config';
 import { resolveExtensionDefinition } from '../frontend-plugin-api/src/wiring/resolveExtensionDefinition.esm.js';
 import { toInternalExtensionDefinition } from '../frontend-plugin-api/src/wiring/createExtension.esm.js';
+import { resolveAppTree } from '../frontend-app-api/src/tree/resolveAppTree.esm.js';
+import { resolveAppNodeSpecs } from '../frontend-app-api/src/tree/resolveAppNodeSpecs.esm.js';
+import { instantiateAppNodeTree } from '../frontend-app-api/src/tree/instantiateAppNodeTree.esm.js';
+import { readAppExtensionsConfig } from '../frontend-app-api/src/tree/readAppExtensionsConfig.esm.js';
 
 const NavItem = (props) => {
   const { routeRef, title, icon: Icon } = props;
-  const to = useRouteRef(routeRef)();
-  return /* @__PURE__ */ React.createElement("li", null, /* @__PURE__ */ React.createElement(Link, { to }, /* @__PURE__ */ React.createElement(Icon, null), " ", title));
+  const link = useRouteRef(routeRef);
+  if (!link) {
+    return null;
+  }
+  return /* @__PURE__ */ React.createElement("li", null, /* @__PURE__ */ React.createElement(Link, { to: link() }, /* @__PURE__ */ React.createElement(Icon, null), " ", title));
 };
 const TestAppNavExtension = createExtension({
   namespace: "app",
@@ -38,6 +45,27 @@ const TestAppNavExtension = createExtension({
     };
   }
 });
+class ExtensionQuery {
+  #node;
+  constructor(node) {
+    this.#node = node;
+  }
+  get node() {
+    return this.#node;
+  }
+  get instance() {
+    const instance = this.#node.instance;
+    if (!instance) {
+      throw new Error(
+        `Unable to access the instance of extension with ID '${this.#node.spec.id}'`
+      );
+    }
+    return instance;
+  }
+  data(ref) {
+    return this.instance.getData(ref);
+  }
+}
 class ExtensionTester {
   /** @internal */
   static forSubject(subject, options) {
@@ -79,50 +107,56 @@ class ExtensionTester {
     }
     return tester;
   }
+  #tree;
   #extensions = new Array();
   add(extension, options) {
+    if (this.#tree) {
+      throw new Error(
+        "Cannot add more extensions accessing the extension tree"
+      );
+    }
     const { name, namespace } = extension;
     const definition = {
       ...extension,
       // setting name "test" as fallback
       name: !namespace && !name ? "test" : name
     };
-    const { id } = resolveExtensionDefinition(definition);
+    const resolvedExtension = resolveExtensionDefinition(definition);
     this.#extensions.push({
-      id,
+      id: resolvedExtension.id,
+      extension: resolvedExtension,
       definition,
       config: options?.config
     });
     return this;
   }
+  data(ref) {
+    const tree = this.#resolveTree();
+    return new ExtensionQuery(tree.root).data(ref);
+  }
+  query(id) {
+    const tree = this.#resolveTree();
+    const actualId = typeof id === "string" ? id : resolveExtensionDefinition(id).id;
+    const node = tree.nodes.get(actualId);
+    if (!node) {
+      throw new Error(
+        `Extension with ID '${actualId}' not found, please make sure it's added to the tester.`
+      );
+    } else if (!node.instance) {
+      throw new Error(
+        `Extension with ID '${actualId}' has not been instantiated, because it is not part of the test subject's extension tree.`
+      );
+    }
+    return new ExtensionQuery(node);
+  }
   render(options) {
     const { config = {} } = options ?? {};
-    const [subject, ...rest] = this.#extensions;
+    const [subject] = this.#extensions;
     if (!subject) {
       throw new Error(
         "No subject found. At least one extension should be added to the tester."
       );
     }
-    const extensionsConfig = [
-      ...rest.map((extension) => ({
-        [extension.id]: {
-          config: extension.config
-        }
-      })),
-      {
-        [subject.id]: {
-          config: subject.config,
-          disabled: false
-        }
-      }
-    ];
-    const finalConfig = {
-      ...config,
-      app: {
-        ...typeof config.app === "object" ? config.app : void 0,
-        extensions: extensionsConfig
-      }
-    };
     const app = createSpecializedApp({
       features: [
         createExtensionOverrides({
@@ -136,14 +170,63 @@ class ExtensionTester {
           ]
         })
       ],
-      config: new MockConfigApi(finalConfig)
+      config: this.#getConfig(config)
     });
     return render(app.createRoot());
   }
+  #resolveTree() {
+    if (this.#tree) {
+      return this.#tree;
+    }
+    const [subject] = this.#extensions;
+    if (!subject) {
+      throw new Error(
+        "No subject found. At least one extension should be added to the tester."
+      );
+    }
+    const tree = resolveAppTree(
+      subject.id,
+      resolveAppNodeSpecs({
+        features: [],
+        builtinExtensions: this.#extensions.map((_) => _.extension),
+        parameters: readAppExtensionsConfig(this.#getConfig())
+      })
+    );
+    instantiateAppNodeTree(tree.root);
+    this.#tree = tree;
+    return tree;
+  }
+  #getConfig(additionalConfig) {
+    const [subject, ...rest] = this.#extensions;
+    const extensionsConfig = [
+      ...rest.map((extension) => ({
+        [extension.id]: {
+          config: extension.config
+        }
+      })),
+      {
+        [subject.id]: {
+          config: subject.config,
+          disabled: false
+        }
+      }
+    ];
+    return ConfigReader.fromConfigs([
+      { context: "render-config", data: additionalConfig ?? {} },
+      {
+        context: "test",
+        data: {
+          app: {
+            extensions: extensionsConfig
+          }
+        }
+      }
+    ]);
+  }
 }
 function createExtensionTester(subject, options) {
   return ExtensionTester.forSubject(subject, options);
 }
 
-export { ExtensionTester, createExtensionTester };
+export { ExtensionQuery, ExtensionTester, createExtensionTester };
 //# sourceMappingURL=createExtensionTester.esm.js.map

package/dist/app/createExtensionTester.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"createExtensionTester.esm.js","sources":["../../src/app/createExtensionTester.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 React from 'react';\nimport { MemoryRouter, Link } from 'react-router-dom';\nimport { RenderResult, render } from '@testing-library/react';\nimport { createSpecializedApp } from '@backstage/frontend-app-api';\nimport {\n  ExtensionDataValue,\n  ExtensionDefinition,\n  IconComponent,\n  RouteRef,\n  coreExtensionData,\n  createExtension,\n  createExtensionInput,\n  createExtensionOverrides,\n  createNavItemExtension,\n  createRouterExtension,\n  useRouteRef,\n} from '@backstage/frontend-plugin-api';\nimport { MockConfigApi } from '@backstage/test-utils';\nimport { JsonArray, JsonObject, JsonValue } from '@backstage/types';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { resolveExtensionDefinition } from '../../../frontend-plugin-api/src/wiring/resolveExtensionDefinition';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { toInternalExtensionDefinition } from '../../../frontend-plugin-api/src/wiring/createExtension';\n\nconst NavItem = (props: {\n  routeRef: RouteRef<undefined>;\n  title: string;\n  icon: IconComponent;\n}) => {\n  const { routeRef, title, icon: Icon } = props;\n  const to = useRouteRef(routeRef)();\n  return (\n    <li>\n      <Link to={to}>\n        <Icon /> {title}\n      </Link>\n    </li>\n  );\n};\n\nconst TestAppNavExtension = createExtension({\n  namespace: 'app',\n  name: 'nav',\n  attachTo: { id: 'app/layout', input: 'nav' },\n  inputs: {\n    items: createExtensionInput({\n      target: createNavItemExtension.targetDataRef,\n    }),\n  },\n  output: {\n    element: coreExtensionData.reactElement,\n  },\n  factory({ inputs }) {\n    return {\n      element: (\n        <nav>\n          <ul>\n            {inputs.items.map((item, index) => (\n              <NavItem\n                key={index}\n                icon={item.output.target.icon}\n                title={item.output.target.title}\n                routeRef={item.output.target.routeRef}\n              />\n            ))}\n          </ul>\n        </nav>\n      ),\n    };\n  },\n});\n\n/** @public */\nexport class ExtensionTester {\n  /** @internal */\n  static forSubject<TConfig, TConfigInput>(\n    subject: ExtensionDefinition<TConfig, TConfigInput>,\n    options?: { config?: TConfigInput },\n  ): ExtensionTester {\n    const tester = new ExtensionTester();\n    const internal = toInternalExtensionDefinition(subject);\n\n    // attaching to app/routes to render as index route\n    if (internal.version === 'v1') {\n      tester.add(\n        createExtension({\n          ...internal,\n          attachTo: { id: 'app/routes', input: 'routes' },\n          output: {\n            ...internal.output,\n            path: coreExtensionData.routePath,\n          },\n          factory: params => ({\n            ...internal.factory(params as any),\n            path: '/',\n          }),\n        }),\n        options as TConfigInput & {},\n      );\n    } else if (internal.version === 'v2') {\n      tester.add(\n        createExtension({\n          ...internal,\n          attachTo: { id: 'app/routes', input: 'routes' },\n          output: internal.output.find(\n            ref => ref.id === coreExtensionData.routePath.id,\n          )\n            ? internal.output\n            : [...internal.output, coreExtensionData.routePath],\n          factory: params => {\n            const parentOutput = Array.from(\n              internal.factory(params) as Iterable<\n                ExtensionDataValue<any, any>\n              >,\n            ).filter(val => val.id !== coreExtensionData.routePath.id);\n\n            return [...parentOutput, coreExtensionData.routePath('/')];\n          },\n        }),\n        options as TConfigInput & {},\n      );\n    }\n    return tester;\n  }\n\n  readonly #extensions = new Array<{\n    id: string;\n    definition: ExtensionDefinition<any>;\n    config?: JsonValue;\n  }>();\n\n  add<TConfig, TConfigInput>(\n    extension: ExtensionDefinition<TConfig, TConfigInput>,\n    options?: { config?: TConfigInput },\n  ): ExtensionTester {\n    const { name, namespace } = extension;\n\n    const definition = {\n      ...extension,\n      // setting name \"test\" as fallback\n      name: !namespace && !name ? 'test' : name,\n    };\n\n    const { id } = resolveExtensionDefinition(definition);\n\n    this.#extensions.push({\n      id,\n      definition,\n      config: options?.config as JsonValue,\n    });\n\n    return this;\n  }\n\n  render(options?: { config?: JsonObject }): RenderResult {\n    const { config = {} } = options ?? {};\n\n    const [subject, ...rest] = this.#extensions;\n    if (!subject) {\n      throw new Error(\n        'No subject found. At least one extension should be added to the tester.',\n      );\n    }\n\n    const extensionsConfig: JsonArray = [\n      ...rest.map(extension => ({\n        [extension.id]: {\n          config: extension.config,\n        },\n      })),\n      {\n        [subject.id]: {\n          config: subject.config,\n          disabled: false,\n        },\n      },\n    ];\n\n    const finalConfig = {\n      ...config,\n      app: {\n        ...(typeof config.app === 'object' ? config.app : undefined),\n        extensions: extensionsConfig,\n      },\n    };\n\n    const app = createSpecializedApp({\n      features: [\n        createExtensionOverrides({\n          extensions: [\n            ...this.#extensions.map(extension => extension.definition),\n            TestAppNavExtension,\n            createRouterExtension({\n              namespace: 'test',\n              Component: ({ children }) => (\n                <MemoryRouter>{children}</MemoryRouter>\n              ),\n            }),\n          ],\n        }),\n      ],\n      config: new MockConfigApi(finalConfig),\n    });\n\n    return render(app.createRoot());\n  }\n}\n\n/** @public */\nexport function createExtensionTester<TConfig>(\n  subject: ExtensionDefinition<TConfig>,\n  options?: { config?: TConfig },\n): ExtensionTester {\n  return ExtensionTester.forSubject(subject, options);\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"createExtensionTester.esm.js","sources":["../../src/app/createExtensionTester.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 React from 'react';\nimport { MemoryRouter, Link } from 'react-router-dom';\nimport { RenderResult, render } from '@testing-library/react';\nimport { createSpecializedApp } from '@backstage/frontend-app-api';\nimport {\n  AppNode,\n  AppTree,\n  Extension,\n  ExtensionDataRef,\n  ExtensionDefinition,\n  IconComponent,\n  RouteRef,\n  coreExtensionData,\n  createExtension,\n  createExtensionInput,\n  createExtensionOverrides,\n  createNavItemExtension,\n  createRouterExtension,\n  useRouteRef,\n} from '@backstage/frontend-plugin-api';\nimport { Config, ConfigReader } from '@backstage/config';\nimport { JsonArray, JsonObject, JsonValue } from '@backstage/types';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { resolveExtensionDefinition } from '../../../frontend-plugin-api/src/wiring/resolveExtensionDefinition';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { toInternalExtensionDefinition } from '../../../frontend-plugin-api/src/wiring/createExtension';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { resolveAppTree } from '../../../frontend-app-api/src/tree/resolveAppTree';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { resolveAppNodeSpecs } from '../../../frontend-app-api/src/tree/resolveAppNodeSpecs';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { instantiateAppNodeTree } from '../../../frontend-app-api/src/tree/instantiateAppNodeTree';\n// eslint-disable-next-line @backstage/no-relative-monorepo-imports\nimport { readAppExtensionsConfig } from '../../../frontend-app-api/src/tree/readAppExtensionsConfig';\n\nconst NavItem = (props: {\n  routeRef: RouteRef<undefined>;\n  title: string;\n  icon: IconComponent;\n}) => {\n  const { routeRef, title, icon: Icon } = props;\n  const link = useRouteRef(routeRef);\n  if (!link) {\n    return null;\n  }\n  return (\n    <li>\n      <Link to={link()}>\n        <Icon /> {title}\n      </Link>\n    </li>\n  );\n};\n\nconst TestAppNavExtension = createExtension({\n  namespace: 'app',\n  name: 'nav',\n  attachTo: { id: 'app/layout', input: 'nav' },\n  inputs: {\n    items: createExtensionInput({\n      target: createNavItemExtension.targetDataRef,\n    }),\n  },\n  output: {\n    element: coreExtensionData.reactElement,\n  },\n  factory({ inputs }) {\n    return {\n      element: (\n        <nav>\n          <ul>\n            {inputs.items.map((item, index) => (\n              <NavItem\n                key={index}\n                icon={item.output.target.icon}\n                title={item.output.target.title}\n                routeRef={item.output.target.routeRef}\n              />\n            ))}\n          </ul>\n        </nav>\n      ),\n    };\n  },\n});\n\n/** @public */\nexport class ExtensionQuery {\n  #node: AppNode;\n\n  constructor(node: AppNode) {\n    this.#node = node;\n  }\n\n  get node() {\n    return this.#node;\n  }\n\n  get instance() {\n    const instance = this.#node.instance;\n    if (!instance) {\n      throw new Error(\n        `Unable to access the instance of extension with ID '${\n          this.#node.spec.id\n        }'`,\n      );\n    }\n    return instance;\n  }\n\n  data<T>(ref: ExtensionDataRef<T>): T | undefined {\n    return this.instance.getData(ref);\n  }\n}\n\n/** @public */\nexport class ExtensionTester {\n  /** @internal */\n  static forSubject<TConfig, TConfigInput>(\n    subject: ExtensionDefinition<TConfig, TConfigInput>,\n    options?: { config?: TConfigInput },\n  ): ExtensionTester {\n    const tester = new ExtensionTester();\n    const internal = toInternalExtensionDefinition(subject);\n\n    // attaching to app/routes to render as index route\n    if (internal.version === 'v1') {\n      tester.add(\n        createExtension({\n          ...internal,\n          attachTo: { id: 'app/routes', input: 'routes' },\n          output: {\n            ...internal.output,\n            path: coreExtensionData.routePath,\n          },\n          factory: params => ({\n            ...internal.factory(params as any),\n            path: '/',\n          }),\n        }),\n        options as TConfigInput & {},\n      );\n    } else if (internal.version === 'v2') {\n      tester.add(\n        createExtension({\n          ...internal,\n          attachTo: { id: 'app/routes', input: 'routes' },\n          output: internal.output.find(\n            ref => ref.id === coreExtensionData.routePath.id,\n          )\n            ? internal.output\n            : [...internal.output, coreExtensionData.routePath],\n          factory: params => {\n            const parentOutput = Array.from(\n              internal.factory(params as any),\n            ).filter(val => val.id !== coreExtensionData.routePath.id);\n\n            return [...parentOutput, coreExtensionData.routePath('/')];\n          },\n        }),\n        options as TConfigInput & {},\n      );\n    }\n    return tester;\n  }\n\n  #tree?: AppTree;\n\n  readonly #extensions = new Array<{\n    id: string;\n    extension: Extension<any>;\n    definition: ExtensionDefinition<any>;\n    config?: JsonValue;\n  }>();\n\n  add<TConfig, TConfigInput>(\n    extension: ExtensionDefinition<TConfig, TConfigInput>,\n    options?: { config?: TConfigInput },\n  ): ExtensionTester {\n    if (this.#tree) {\n      throw new Error(\n        'Cannot add more extensions accessing the extension tree',\n      );\n    }\n\n    const { name, namespace } = extension;\n\n    const definition = {\n      ...extension,\n      // setting name \"test\" as fallback\n      name: !namespace && !name ? 'test' : name,\n    };\n\n    const resolvedExtension = resolveExtensionDefinition(definition);\n\n    this.#extensions.push({\n      id: resolvedExtension.id,\n      extension: resolvedExtension,\n      definition,\n      config: options?.config as JsonValue,\n    });\n\n    return this;\n  }\n\n  data<T>(ref: ExtensionDataRef<T>): T | undefined {\n    const tree = this.#resolveTree();\n\n    return new ExtensionQuery(tree.root).data(ref);\n  }\n\n  query(id: string | ExtensionDefinition<any, any>): ExtensionQuery {\n    const tree = this.#resolveTree();\n\n    const actualId =\n      typeof id === 'string' ? id : resolveExtensionDefinition(id).id;\n\n    const node = tree.nodes.get(actualId);\n\n    if (!node) {\n      throw new Error(\n        `Extension with ID '${actualId}' not found, please make sure it's added to the tester.`,\n      );\n    } else if (!node.instance) {\n      throw new Error(\n        `Extension with ID '${actualId}' has not been instantiated, because it is not part of the test subject's extension tree.`,\n      );\n    }\n    return new ExtensionQuery(node);\n  }\n\n  render(options?: { config?: JsonObject }): RenderResult {\n    const { config = {} } = options ?? {};\n\n    const [subject] = this.#extensions;\n    if (!subject) {\n      throw new Error(\n        'No subject found. At least one extension should be added to the tester.',\n      );\n    }\n\n    const app = createSpecializedApp({\n      features: [\n        createExtensionOverrides({\n          extensions: [\n            ...this.#extensions.map(extension => extension.definition),\n            TestAppNavExtension,\n            createRouterExtension({\n              namespace: 'test',\n              Component: ({ children }) => (\n                <MemoryRouter>{children}</MemoryRouter>\n              ),\n            }),\n          ],\n        }),\n      ],\n      config: this.#getConfig(config),\n    });\n\n    return render(app.createRoot());\n  }\n\n  #resolveTree() {\n    if (this.#tree) {\n      return this.#tree;\n    }\n\n    const [subject] = this.#extensions;\n    if (!subject) {\n      throw new Error(\n        'No subject found. At least one extension should be added to the tester.',\n      );\n    }\n\n    const tree = resolveAppTree(\n      subject.id,\n      resolveAppNodeSpecs({\n        features: [],\n        builtinExtensions: this.#extensions.map(_ => _.extension),\n        parameters: readAppExtensionsConfig(this.#getConfig()),\n      }),\n    );\n\n    instantiateAppNodeTree(tree.root);\n\n    this.#tree = tree;\n\n    return tree;\n  }\n\n  #getConfig(additionalConfig?: JsonObject): Config {\n    const [subject, ...rest] = this.#extensions;\n\n    const extensionsConfig: JsonArray = [\n      ...rest.map(extension => ({\n        [extension.id]: {\n          config: extension.config,\n        },\n      })),\n      {\n        [subject.id]: {\n          config: subject.config,\n          disabled: false,\n        },\n      },\n    ];\n\n    return ConfigReader.fromConfigs([\n      { context: 'render-config', data: additionalConfig ?? {} },\n      {\n        context: 'test',\n        data: {\n          app: {\n            extensions: extensionsConfig,\n          },\n        },\n      },\n    ]);\n  }\n}\n\n/** @public */\nexport function createExtensionTester<TConfig>(\n  subject: ExtensionDefinition<TConfig>,\n  options?: { config?: TConfig },\n): ExtensionTester {\n  return ExtensionTester.forSubject(subject, options);\n}\n"],"names":[],"mappings":"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"}

package/dist/frontend-app-api/src/tree/instantiateAppNodeTree.esm.js

@@ -0,0 +1,246 @@
+import mapValues from 'lodash/mapValues';
+import { toInternalExtension } from '../../../frontend-plugin-api/src/wiring/resolveExtensionDefinition.esm.js';
+
+function resolveInputDataMap(dataMap, attachment, inputName) {
+  return mapValues(dataMap, (ref) => {
+    const value = attachment.instance?.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 = [...attachment.instance?.getDataRefs() ?? []].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 resolveInputDataContainer(extensionData, attachment, inputName) {
+  const dataMap = /* @__PURE__ */ new Map();
+  for (const ref of extensionData) {
+    if (dataMap.has(ref.id)) {
+      throw new Error(`Unexpected duplicate input data '${ref.id}'`);
+    }
+    const value = attachment.instance?.getData(ref);
+    if (value === void 0 && !ref.config.optional) {
+      const expected = extensionData.filter((r) => !r.config.optional).map((r) => `'${r.id}'`).join(", ");
+      const provided = [...attachment.instance?.getDataRefs() ?? []].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})`
+      );
+    }
+    dataMap.set(ref.id, value);
+  }
+  return {
+    node: attachment,
+    get(ref) {
+      return dataMap.get(ref.id);
+    },
+    *[Symbol.iterator]() {
+      for (const [id, value] of dataMap) {
+        yield {
+          $$type: "@backstage/ExtensionDataValue",
+          id,
+          value
+        };
+      }
+    }
+  };
+}
+function reportUndeclaredAttachments(id, inputMap, attachments) {
+  const undeclaredAttachments = Array.from(attachments.entries()).filter(
+    ([inputName]) => inputMap[inputName] === void 0
+  );
+  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(" ")
+    );
+  }
+}
+function resolveV1Inputs(inputMap, attachments) {
+  return mapValues(inputMap, (input, inputName) => {
+    const attachedNodes = attachments.get(inputName) ?? [];
+    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: resolveInputDataMap(
+          input.extensionData,
+          attachedNodes[0],
+          inputName
+        )
+      };
+    }
+    return attachedNodes.map((attachment) => ({
+      node: attachment,
+      output: resolveInputDataMap(input.extensionData, attachment, inputName)
+    }));
+  });
+}
+function resolveV2Inputs(inputMap, attachments) {
+  return mapValues(inputMap, (input, inputName) => {
+    const attachedNodes = attachments.get(inputName) ?? [];
+    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 resolveInputDataContainer(
+        input.extensionData,
+        attachedNodes[0],
+        inputName
+      );
+    }
+    return attachedNodes.map(
+      (attachment) => resolveInputDataContainer(input.extensionData, attachment, inputName)
+    );
+  });
+}
+function createAppNodeInstance(options) {
+  const { node, attachments } = options;
+  const { id, extension, config } = node.spec;
+  const extensionData = /* @__PURE__ */ new Map();
+  const extensionDataRefs = /* @__PURE__ */ new Set();
+  let parsedConfig;
+  try {
+    parsedConfig = extension.configSchema?.parse(config ?? {});
+  } catch (e) {
+    throw new Error(
+      `Invalid configuration for extension '${id}'; caused by ${e}`
+    );
+  }
+  try {
+    const internalExtension = toInternalExtension(extension);
+    if (process.env.NODE_ENV !== "production") {
+      reportUndeclaredAttachments(id, internalExtension.inputs, attachments);
+    }
+    if (internalExtension.version === "v1") {
+      const namedOutputs = internalExtension.factory({
+        node,
+        config: parsedConfig,
+        inputs: resolveV1Inputs(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);
+      }
+    } else if (internalExtension.version === "v2") {
+      const outputDataValues = internalExtension.factory({
+        node,
+        config: parsedConfig,
+        inputs: resolveV2Inputs(internalExtension.inputs, attachments)
+      });
+      const outputDataMap = /* @__PURE__ */ new Map();
+      for (const value of outputDataValues) {
+        if (outputDataMap.has(value.id)) {
+          throw new Error(`duplicate extension data output '${value.id}'`);
+        }
+        outputDataMap.set(value.id, value.value);
+      }
+      for (const ref of internalExtension.output) {
+        const value = outputDataMap.get(ref.id);
+        outputDataMap.delete(ref.id);
+        if (value === void 0) {
+          if (!ref.config.optional) {
+            throw new Error(
+              `missing required extension data output '${ref.id}'`
+            );
+          }
+        } else {
+          extensionData.set(ref.id, value);
+          extensionDataRefs.add(ref);
+        }
+      }
+      if (outputDataMap.size > 0) {
+        throw new Error(
+          `unexpected output '${Array.from(outputDataMap.keys()).join(
+            "', '"
+          )}'`
+        );
+      }
+    } else {
+      throw new Error(
+        `unexpected extension version '${internalExtension.version}'`
+      );
+    }
+  } 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/frontend-app-api/src/tree/instantiateAppNodeTree.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instantiateAppNodeTree.esm.js","sources":["../../../../../frontend-app-api/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  AnyExtensionDataRef,\n  AnyExtensionInputMap,\n  ExtensionDataContainer,\n  ExtensionDataRef,\n  ExtensionInput,\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 resolveInputDataMap(\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 resolveInputDataContainer(\n  extensionData: Array<AnyExtensionDataRef>,\n  attachment: AppNode,\n  inputName: string,\n): { node: AppNode } & ExtensionDataContainer<AnyExtensionDataRef> {\n  const dataMap = new Map<string, unknown>();\n\n  for (const ref of extensionData) {\n    if (dataMap.has(ref.id)) {\n      throw new Error(`Unexpected duplicate input data '${ref.id}'`);\n    }\n    const value = attachment.instance?.getData(ref);\n    if (value === undefined && !ref.config.optional) {\n      const expected = extensionData\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\n    dataMap.set(ref.id, value);\n  }\n\n  return {\n    node: attachment,\n    get(ref) {\n      return dataMap.get(ref.id);\n    },\n    *[Symbol.iterator]() {\n      for (const [id, value] of dataMap) {\n        // TODO: Would be better to be able to create a new instance using the ref here instead\n        yield {\n          $$type: '@backstage/ExtensionDataValue',\n          id,\n          value,\n        };\n      }\n    },\n  } as { node: AppNode } & ExtensionDataContainer<AnyExtensionDataRef>;\n}\n\nfunction reportUndeclaredAttachments(\n  id: string,\n  inputMap: { [name in string]: unknown },\n  attachments: ReadonlyMap<string, AppNode[]>,\n) {\n  const undeclaredAttachments = Array.from(attachments.entries()).filter(\n    ([inputName]) => inputMap[inputName] === undefined,\n  );\n\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\nfunction resolveV1Inputs(\n  inputMap: AnyExtensionInputMap,\n  attachments: ReadonlyMap<string, AppNode[]>,\n): ResolvedExtensionInputs<AnyExtensionInputMap> {\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: resolveInputDataMap(\n          input.extensionData,\n          attachedNodes[0],\n          inputName,\n        ),\n      };\n    }\n\n    return attachedNodes.map(attachment => ({\n      node: attachment,\n      output: resolveInputDataMap(input.extensionData, attachment, inputName),\n    }));\n  }) as ResolvedExtensionInputs<AnyExtensionInputMap>;\n}\n\nfunction resolveV2Inputs(\n  inputMap: {\n    [inputName in string]: ExtensionInput<\n      AnyExtensionDataRef,\n      { optional: boolean; singleton: boolean }\n    >;\n  },\n  attachments: ReadonlyMap<string, AppNode[]>,\n): ResolvedExtensionInputs<{\n  [inputName in string]: ExtensionInput<\n    AnyExtensionDataRef,\n    { optional: boolean; singleton: boolean }\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 resolveInputDataContainer(\n        input.extensionData,\n        attachedNodes[0],\n        inputName,\n      );\n    }\n\n    return attachedNodes.map(attachment =>\n      resolveInputDataContainer(input.extensionData, attachment, inputName),\n    );\n  }) as ResolvedExtensionInputs<{\n    [inputName in string]: ExtensionInput<\n      AnyExtensionDataRef,\n      { optional: boolean; singleton: boolean }\n    >;\n  }>;\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    if (process.env.NODE_ENV !== 'production') {\n      reportUndeclaredAttachments(id, internalExtension.inputs, attachments);\n    }\n\n    if (internalExtension.version === 'v1') {\n      const namedOutputs = internalExtension.factory({\n        node,\n        config: parsedConfig,\n        inputs: resolveV1Inputs(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    } else if (internalExtension.version === 'v2') {\n      const outputDataValues = internalExtension.factory({\n        node,\n        config: parsedConfig,\n        inputs: resolveV2Inputs(internalExtension.inputs, attachments),\n      });\n\n      const outputDataMap = new Map<string, unknown>();\n      for (const value of outputDataValues) {\n        if (outputDataMap.has(value.id)) {\n          throw new Error(`duplicate extension data output '${value.id}'`);\n        }\n        outputDataMap.set(value.id, value.value);\n      }\n\n      for (const ref of internalExtension.output) {\n        const value = outputDataMap.get(ref.id);\n        outputDataMap.delete(ref.id);\n        if (value === undefined) {\n          if (!ref.config.optional) {\n            throw new Error(\n              `missing required extension data output '${ref.id}'`,\n            );\n          }\n        } else {\n          extensionData.set(ref.id, value);\n          extensionDataRefs.add(ref);\n        }\n      }\n\n      if (outputDataMap.size > 0) {\n        throw new Error(\n          `unexpected output '${Array.from(outputDataMap.keys()).join(\n            \"', '\",\n          )}'`,\n        );\n      }\n    } else {\n      throw new Error(\n        `unexpected extension version '${(internalExtension as any).version}'`,\n      );\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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"}