@backstage/frontend-test-utils 0.1.11 → 0.1.12-next.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,13 +1,39 @@
1
1
  # @backstage/frontend-test-utils
2
2
 
3
- ## 0.1.11
3
+ ## 0.1.12-next.2
4
4
 
5
5
  ### Patch Changes
6
6
 
7
+ - 8209449: Added new APIs for testing extensions
8
+ - 72754db: Updated usage of `useRouteRef`, which can now always return `undefined`.
7
9
  - Updated dependencies
8
- - @backstage/frontend-app-api@0.7.4
9
- - @backstage/test-utils@1.5.9
10
- - @backstage/frontend-plugin-api@0.6.7
10
+ - @backstage/frontend-plugin-api@0.7.0-next.2
11
+ - @backstage/frontend-app-api@0.7.5-next.2
12
+ - @backstage/test-utils@1.5.10-next.2
13
+ - @backstage/config@1.2.0
14
+ - @backstage/types@1.1.1
15
+
16
+ ## 0.1.12-next.1
17
+
18
+ ### Patch Changes
19
+
20
+ - 3be9aeb: Added support for v2 extensions, which declare their inputs and outputs without using a data map.
21
+ - 6349099: Added config input type to the extensions
22
+ - Updated dependencies
23
+ - @backstage/frontend-app-api@0.7.5-next.1
24
+ - @backstage/frontend-plugin-api@0.6.8-next.1
25
+ - @backstage/test-utils@1.5.10-next.1
26
+ - @backstage/types@1.1.1
27
+
28
+ ## 0.1.11-next.0
29
+
30
+ ### Patch Changes
31
+
32
+ - Updated dependencies
33
+ - @backstage/frontend-plugin-api@0.6.8-next.0
34
+ - @backstage/frontend-app-api@0.7.4-next.0
35
+ - @backstage/test-utils@1.5.9-next.0
36
+ - @backstage/types@1.1.1
11
37
 
12
38
  ## 0.1.10
13
39
 
@@ -3,14 +3,21 @@ import { Link, MemoryRouter } from 'react-router-dom';
3
3
  import { render } from '@testing-library/react';
4
4
  import { createSpecializedApp } from '@backstage/frontend-app-api';
5
5
  import { createExtension, createExtensionInput, createNavItemExtension, coreExtensionData, useRouteRef, createExtensionOverrides, createRouterExtension } from '@backstage/frontend-plugin-api';
6
- import { MockConfigApi } from '@backstage/test-utils';
6
+ import { ConfigReader } from '@backstage/config';
7
7
  import { resolveExtensionDefinition } from '../frontend-plugin-api/src/wiring/resolveExtensionDefinition.esm.js';
8
8
  import { toInternalExtensionDefinition } from '../frontend-plugin-api/src/wiring/createExtension.esm.js';
9
+ import { resolveAppTree } from '../frontend-app-api/src/tree/resolveAppTree.esm.js';
10
+ import { resolveAppNodeSpecs } from '../frontend-app-api/src/tree/resolveAppNodeSpecs.esm.js';
11
+ import { instantiateAppNodeTree } from '../frontend-app-api/src/tree/instantiateAppNodeTree.esm.js';
12
+ import { readAppExtensionsConfig } from '../frontend-app-api/src/tree/readAppExtensionsConfig.esm.js';
9
13
 
10
14
  const NavItem = (props) => {
11
15
  const { routeRef, title, icon: Icon } = props;
12
- const to = useRouteRef(routeRef)();
13
- return /* @__PURE__ */ React.createElement("li", null, /* @__PURE__ */ React.createElement(Link, { to }, /* @__PURE__ */ React.createElement(Icon, null), " ", title));
16
+ const link = useRouteRef(routeRef);
17
+ if (!link) {
18
+ return null;
19
+ }
20
+ return /* @__PURE__ */ React.createElement("li", null, /* @__PURE__ */ React.createElement(Link, { to: link() }, /* @__PURE__ */ React.createElement(Icon, null), " ", title));
14
21
  };
15
22
  const TestAppNavExtension = createExtension({
16
23
  namespace: "app",
@@ -38,70 +45,118 @@ const TestAppNavExtension = createExtension({
38
45
  };
39
46
  }
40
47
  });
48
+ class ExtensionQuery {
49
+ #node;
50
+ constructor(node) {
51
+ this.#node = node;
52
+ }
53
+ get node() {
54
+ return this.#node;
55
+ }
56
+ get instance() {
57
+ const instance = this.#node.instance;
58
+ if (!instance) {
59
+ throw new Error(
60
+ `Unable to access the instance of extension with ID '${this.#node.spec.id}'`
61
+ );
62
+ }
63
+ return instance;
64
+ }
65
+ data(ref) {
66
+ return this.instance.getData(ref);
67
+ }
68
+ }
41
69
  class ExtensionTester {
42
70
  /** @internal */
43
71
  static forSubject(subject, options) {
44
72
  const tester = new ExtensionTester();
45
- const { output, factory, ...rest } = toInternalExtensionDefinition(subject);
46
- const extension = createExtension({
47
- ...rest,
48
- attachTo: { id: "app/routes", input: "routes" },
49
- output: {
50
- ...output,
51
- path: coreExtensionData.routePath
52
- },
53
- factory: (params) => ({
54
- ...factory(params),
55
- path: "/"
56
- })
57
- });
58
- tester.add(extension, options);
73
+ const internal = toInternalExtensionDefinition(subject);
74
+ if (internal.version === "v1") {
75
+ tester.add(
76
+ createExtension({
77
+ ...internal,
78
+ attachTo: { id: "app/routes", input: "routes" },
79
+ output: {
80
+ ...internal.output,
81
+ path: coreExtensionData.routePath
82
+ },
83
+ factory: (params) => ({
84
+ ...internal.factory(params),
85
+ path: "/"
86
+ })
87
+ }),
88
+ options
89
+ );
90
+ } else if (internal.version === "v2") {
91
+ tester.add(
92
+ createExtension({
93
+ ...internal,
94
+ attachTo: { id: "app/routes", input: "routes" },
95
+ output: internal.output.find(
96
+ (ref) => ref.id === coreExtensionData.routePath.id
97
+ ) ? internal.output : [...internal.output, coreExtensionData.routePath],
98
+ factory: (params) => {
99
+ const parentOutput = Array.from(
100
+ internal.factory(params)
101
+ ).filter((val) => val.id !== coreExtensionData.routePath.id);
102
+ return [...parentOutput, coreExtensionData.routePath("/")];
103
+ }
104
+ }),
105
+ options
106
+ );
107
+ }
59
108
  return tester;
60
109
  }
110
+ #tree;
61
111
  #extensions = new Array();
62
112
  add(extension, options) {
113
+ if (this.#tree) {
114
+ throw new Error(
115
+ "Cannot add more extensions accessing the extension tree"
116
+ );
117
+ }
63
118
  const { name, namespace } = extension;
64
119
  const definition = {
65
120
  ...extension,
66
121
  // setting name "test" as fallback
67
122
  name: !namespace && !name ? "test" : name
68
123
  };
69
- const { id } = resolveExtensionDefinition(definition);
124
+ const resolvedExtension = resolveExtensionDefinition(definition);
70
125
  this.#extensions.push({
71
- id,
126
+ id: resolvedExtension.id,
127
+ extension: resolvedExtension,
72
128
  definition,
73
129
  config: options?.config
74
130
  });
75
131
  return this;
76
132
  }
133
+ data(ref) {
134
+ const tree = this.#resolveTree();
135
+ return new ExtensionQuery(tree.root).data(ref);
136
+ }
137
+ query(id) {
138
+ const tree = this.#resolveTree();
139
+ const actualId = typeof id === "string" ? id : resolveExtensionDefinition(id).id;
140
+ const node = tree.nodes.get(actualId);
141
+ if (!node) {
142
+ throw new Error(
143
+ `Extension with ID '${actualId}' not found, please make sure it's added to the tester.`
144
+ );
145
+ } else if (!node.instance) {
146
+ throw new Error(
147
+ `Extension with ID '${actualId}' has not been instantiated, because it is not part of the test subject's extension tree.`
148
+ );
149
+ }
150
+ return new ExtensionQuery(node);
151
+ }
77
152
  render(options) {
78
153
  const { config = {} } = options ?? {};
79
- const [subject, ...rest] = this.#extensions;
154
+ const [subject] = this.#extensions;
80
155
  if (!subject) {
81
156
  throw new Error(
82
157
  "No subject found. At least one extension should be added to the tester."
83
158
  );
84
159
  }
85
- const extensionsConfig = [
86
- ...rest.map((extension) => ({
87
- [extension.id]: {
88
- config: extension.config
89
- }
90
- })),
91
- {
92
- [subject.id]: {
93
- config: subject.config,
94
- disabled: false
95
- }
96
- }
97
- ];
98
- const finalConfig = {
99
- ...config,
100
- app: {
101
- ...typeof config.app === "object" ? config.app : void 0,
102
- extensions: extensionsConfig
103
- }
104
- };
105
160
  const app = createSpecializedApp({
106
161
  features: [
107
162
  createExtensionOverrides({
@@ -115,14 +170,63 @@ class ExtensionTester {
115
170
  ]
116
171
  })
117
172
  ],
118
- config: new MockConfigApi(finalConfig)
173
+ config: this.#getConfig(config)
119
174
  });
120
175
  return render(app.createRoot());
121
176
  }
177
+ #resolveTree() {
178
+ if (this.#tree) {
179
+ return this.#tree;
180
+ }
181
+ const [subject] = this.#extensions;
182
+ if (!subject) {
183
+ throw new Error(
184
+ "No subject found. At least one extension should be added to the tester."
185
+ );
186
+ }
187
+ const tree = resolveAppTree(
188
+ subject.id,
189
+ resolveAppNodeSpecs({
190
+ features: [],
191
+ builtinExtensions: this.#extensions.map((_) => _.extension),
192
+ parameters: readAppExtensionsConfig(this.#getConfig())
193
+ })
194
+ );
195
+ instantiateAppNodeTree(tree.root);
196
+ this.#tree = tree;
197
+ return tree;
198
+ }
199
+ #getConfig(additionalConfig) {
200
+ const [subject, ...rest] = this.#extensions;
201
+ const extensionsConfig = [
202
+ ...rest.map((extension) => ({
203
+ [extension.id]: {
204
+ config: extension.config
205
+ }
206
+ })),
207
+ {
208
+ [subject.id]: {
209
+ config: subject.config,
210
+ disabled: false
211
+ }
212
+ }
213
+ ];
214
+ return ConfigReader.fromConfigs([
215
+ { context: "render-config", data: additionalConfig ?? {} },
216
+ {
217
+ context: "test",
218
+ data: {
219
+ app: {
220
+ extensions: extensionsConfig
221
+ }
222
+ }
223
+ }
224
+ ]);
225
+ }
122
226
  }
123
227
  function createExtensionTester(subject, options) {
124
228
  return ExtensionTester.forSubject(subject, options);
125
229
  }
126
230
 
127
- export { ExtensionTester, createExtensionTester };
231
+ export { ExtensionQuery, ExtensionTester, createExtensionTester };
128
232
  //# sourceMappingURL=createExtensionTester.esm.js.map
@@ -1 +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 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>(\n subject: ExtensionDefinition<TConfig>,\n options?: { config?: TConfig },\n ): ExtensionTester {\n const tester = new ExtensionTester();\n const { output, factory, ...rest } = toInternalExtensionDefinition(subject);\n // attaching to app/routes to render as index route\n const extension = createExtension({\n ...rest,\n attachTo: { id: 'app/routes', input: 'routes' },\n output: {\n ...output,\n path: coreExtensionData.routePath,\n },\n factory: params => ({\n ...factory(params),\n path: '/',\n }),\n });\n tester.add(extension, options);\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>(\n extension: ExtensionDefinition<TConfig>,\n options?: { config?: TConfig },\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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"}
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 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 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 #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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"}
@@ -0,0 +1,237 @@
1
+ import mapValues from 'lodash/mapValues';
2
+ import { toInternalExtension } from '../../../frontend-plugin-api/src/wiring/resolveExtensionDefinition.esm.js';
3
+
4
+ function resolveInputDataMap(dataMap, attachment, inputName) {
5
+ return mapValues(dataMap, (ref) => {
6
+ const value = attachment.instance?.getData(ref);
7
+ if (value === void 0 && !ref.config.optional) {
8
+ const expected = Object.values(dataMap).filter((r) => !r.config.optional).map((r) => `'${r.id}'`).join(", ");
9
+ const provided = [...attachment.instance?.getDataRefs() ?? []].map((r) => `'${r.id}'`).join(", ");
10
+ throw new Error(
11
+ `extension '${attachment.spec.id}' could not be attached because its output data (${provided}) does not match what the input '${inputName}' requires (${expected})`
12
+ );
13
+ }
14
+ return value;
15
+ });
16
+ }
17
+ function resolveInputDataContainer(extensionData, attachment, inputName) {
18
+ const dataMap = /* @__PURE__ */ new Map();
19
+ for (const ref of extensionData) {
20
+ if (dataMap.has(ref.id)) {
21
+ throw new Error(`Unexpected duplicate input data '${ref.id}'`);
22
+ }
23
+ const value = attachment.instance?.getData(ref);
24
+ if (value === void 0 && !ref.config.optional) {
25
+ const expected = extensionData.filter((r) => !r.config.optional).map((r) => `'${r.id}'`).join(", ");
26
+ const provided = [...attachment.instance?.getDataRefs() ?? []].map((r) => `'${r.id}'`).join(", ");
27
+ throw new Error(
28
+ `extension '${attachment.spec.id}' could not be attached because its output data (${provided}) does not match what the input '${inputName}' requires (${expected})`
29
+ );
30
+ }
31
+ dataMap.set(ref.id, value);
32
+ }
33
+ return {
34
+ node: attachment,
35
+ get(ref) {
36
+ return dataMap.get(ref.id);
37
+ }
38
+ };
39
+ }
40
+ function reportUndeclaredAttachments(id, inputMap, attachments) {
41
+ const undeclaredAttachments = Array.from(attachments.entries()).filter(
42
+ ([inputName]) => inputMap[inputName] === void 0
43
+ );
44
+ const inputNames = Object.keys(inputMap);
45
+ for (const [name, nodes] of undeclaredAttachments) {
46
+ const pl = nodes.length > 1;
47
+ console.warn(
48
+ [
49
+ `The extension${pl ? "s" : ""} '${nodes.map((n) => n.spec.id).join("', '")}' ${pl ? "are" : "is"}`,
50
+ `attached to the input '${name}' of the extension '${id}', but it`,
51
+ inputNames.length === 0 ? "has no inputs" : `has no such input (candidates are '${inputNames.join("', '")}')`
52
+ ].join(" ")
53
+ );
54
+ }
55
+ }
56
+ function resolveV1Inputs(inputMap, attachments) {
57
+ return mapValues(inputMap, (input, inputName) => {
58
+ const attachedNodes = attachments.get(inputName) ?? [];
59
+ if (input.config.singleton) {
60
+ if (attachedNodes.length > 1) {
61
+ const attachedNodeIds = attachedNodes.map((e) => e.spec.id);
62
+ throw Error(
63
+ `expected ${input.config.optional ? "at most" : "exactly"} one '${inputName}' input but received multiple: '${attachedNodeIds.join(
64
+ "', '"
65
+ )}'`
66
+ );
67
+ } else if (attachedNodes.length === 0) {
68
+ if (input.config.optional) {
69
+ return void 0;
70
+ }
71
+ throw Error(`input '${inputName}' is required but was not received`);
72
+ }
73
+ return {
74
+ node: attachedNodes[0],
75
+ output: resolveInputDataMap(
76
+ input.extensionData,
77
+ attachedNodes[0],
78
+ inputName
79
+ )
80
+ };
81
+ }
82
+ return attachedNodes.map((attachment) => ({
83
+ node: attachment,
84
+ output: resolveInputDataMap(input.extensionData, attachment, inputName)
85
+ }));
86
+ });
87
+ }
88
+ function resolveV2Inputs(inputMap, attachments) {
89
+ return mapValues(inputMap, (input, inputName) => {
90
+ const attachedNodes = attachments.get(inputName) ?? [];
91
+ if (input.config.singleton) {
92
+ if (attachedNodes.length > 1) {
93
+ const attachedNodeIds = attachedNodes.map((e) => e.spec.id);
94
+ throw Error(
95
+ `expected ${input.config.optional ? "at most" : "exactly"} one '${inputName}' input but received multiple: '${attachedNodeIds.join(
96
+ "', '"
97
+ )}'`
98
+ );
99
+ } else if (attachedNodes.length === 0) {
100
+ if (input.config.optional) {
101
+ return void 0;
102
+ }
103
+ throw Error(`input '${inputName}' is required but was not received`);
104
+ }
105
+ return resolveInputDataContainer(
106
+ input.extensionData,
107
+ attachedNodes[0],
108
+ inputName
109
+ );
110
+ }
111
+ return attachedNodes.map(
112
+ (attachment) => resolveInputDataContainer(input.extensionData, attachment, inputName)
113
+ );
114
+ });
115
+ }
116
+ function createAppNodeInstance(options) {
117
+ const { node, attachments } = options;
118
+ const { id, extension, config } = node.spec;
119
+ const extensionData = /* @__PURE__ */ new Map();
120
+ const extensionDataRefs = /* @__PURE__ */ new Set();
121
+ let parsedConfig;
122
+ try {
123
+ parsedConfig = extension.configSchema?.parse(config ?? {});
124
+ } catch (e) {
125
+ throw new Error(
126
+ `Invalid configuration for extension '${id}'; caused by ${e}`
127
+ );
128
+ }
129
+ try {
130
+ const internalExtension = toInternalExtension(extension);
131
+ if (process.env.NODE_ENV !== "production") {
132
+ reportUndeclaredAttachments(id, internalExtension.inputs, attachments);
133
+ }
134
+ if (internalExtension.version === "v1") {
135
+ const namedOutputs = internalExtension.factory({
136
+ node,
137
+ config: parsedConfig,
138
+ inputs: resolveV1Inputs(internalExtension.inputs, attachments)
139
+ });
140
+ for (const [name, output] of Object.entries(namedOutputs)) {
141
+ const ref = internalExtension.output[name];
142
+ if (!ref) {
143
+ throw new Error(`unknown output provided via '${name}'`);
144
+ }
145
+ if (extensionData.has(ref.id)) {
146
+ throw new Error(
147
+ `duplicate extension data '${ref.id}' received via output '${name}'`
148
+ );
149
+ }
150
+ extensionData.set(ref.id, output);
151
+ extensionDataRefs.add(ref);
152
+ }
153
+ } else if (internalExtension.version === "v2") {
154
+ const outputDataValues = internalExtension.factory({
155
+ node,
156
+ config: parsedConfig,
157
+ inputs: resolveV2Inputs(internalExtension.inputs, attachments)
158
+ });
159
+ const outputDataMap = /* @__PURE__ */ new Map();
160
+ for (const value of outputDataValues) {
161
+ if (outputDataMap.has(value.id)) {
162
+ throw new Error(`duplicate extension data output '${value.id}'`);
163
+ }
164
+ outputDataMap.set(value.id, value.value);
165
+ }
166
+ for (const ref of internalExtension.output) {
167
+ const value = outputDataMap.get(ref.id);
168
+ outputDataMap.delete(ref.id);
169
+ if (value === void 0) {
170
+ if (!ref.config.optional) {
171
+ throw new Error(
172
+ `missing required extension data output '${ref.id}'`
173
+ );
174
+ }
175
+ } else {
176
+ extensionData.set(ref.id, value);
177
+ extensionDataRefs.add(ref);
178
+ }
179
+ }
180
+ if (outputDataMap.size > 0) {
181
+ throw new Error(
182
+ `unexpected output '${Array.from(outputDataMap.keys()).join(
183
+ "', '"
184
+ )}'`
185
+ );
186
+ }
187
+ } else {
188
+ throw new Error(
189
+ `unexpected extension version '${internalExtension.version}'`
190
+ );
191
+ }
192
+ } catch (e) {
193
+ throw new Error(
194
+ `Failed to instantiate extension '${id}'${e.name === "Error" ? `, ${e.message}` : `; caused by ${e.stack}`}`
195
+ );
196
+ }
197
+ return {
198
+ getDataRefs() {
199
+ return extensionDataRefs.values();
200
+ },
201
+ getData(ref) {
202
+ return extensionData.get(ref.id);
203
+ }
204
+ };
205
+ }
206
+ function instantiateAppNodeTree(rootNode) {
207
+ function createInstance(node) {
208
+ if (node.instance) {
209
+ return node.instance;
210
+ }
211
+ if (node.spec.disabled) {
212
+ return void 0;
213
+ }
214
+ const instantiatedAttachments = /* @__PURE__ */ new Map();
215
+ for (const [input, children] of node.edges.attachments) {
216
+ const instantiatedChildren = children.flatMap((child) => {
217
+ const childInstance = createInstance(child);
218
+ if (!childInstance) {
219
+ return [];
220
+ }
221
+ return [child];
222
+ });
223
+ if (instantiatedChildren.length > 0) {
224
+ instantiatedAttachments.set(input, instantiatedChildren);
225
+ }
226
+ }
227
+ node.instance = createAppNodeInstance({
228
+ node,
229
+ attachments: instantiatedAttachments
230
+ });
231
+ return node.instance;
232
+ }
233
+ createInstance(rootNode);
234
+ }
235
+
236
+ export { createAppNodeInstance, instantiateAppNodeTree };
237
+ //# sourceMappingURL=instantiateAppNodeTree.esm.js.map
@@ -0,0 +1 @@
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 } 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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"}