@open-pioneer/runtime 2.1.5 → 2.1.7

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,5 +1,29 @@
1
1
  # @open-pioneer/runtime
2
2
 
3
+ ## 2.1.7
4
+
5
+ ### Patch Changes
6
+
7
+ - 58ce24f: Export `DECLARE_SERVICE_INTERFACE` as a value instead of a type only.
8
+ It was previously necessary to import this symbol via `import type` to avoid errors during development.
9
+ The `type` keyword can now be omitted.
10
+ - e0b2fae: Update dependencies
11
+ - 6cc7fcd: Allow synchronous `getApiMethods()` when implementing an `ApiExtension`.
12
+ - Updated dependencies [5c62522]
13
+ - Updated dependencies [50550d3]
14
+ - Updated dependencies [e0b2fae]
15
+ - @open-pioneer/chakra-integration@1.1.4
16
+ - @open-pioneer/core@1.3.0
17
+ - @open-pioneer/base-theme@0.3.3
18
+ - @open-pioneer/runtime-react-support@1.0.2
19
+
20
+ ## 2.1.6
21
+
22
+ ### Patch Changes
23
+
24
+ - e945264: Improve error message when metadata is missing (#55)
25
+ - @open-pioneer/runtime-react-support@1.0.2
26
+
3
27
  ## 2.1.5
4
28
 
5
29
  ### Patch Changes
@@ -57,7 +57,7 @@ export interface DeclaredService<InterfaceName extends string> {
57
57
  * ```
58
58
  */
59
59
  declare const DECLARE_SERVICE_INTERFACE: unique symbol;
60
- export { type DECLARE_SERVICE_INTERFACE };
60
+ export { DECLARE_SERVICE_INTERFACE };
61
61
  /**
62
62
  * Given a type implementing {@link DeclaredService} or using {@link DECLARE_SERVICE_INTERFACE},
63
63
  * this type will produce the interface name associated with the service type.
@@ -0,0 +1,4 @@
1
+ const DECLARE_SERVICE_INTERFACE = Symbol("runtime.DECLARE_SERVICE_INTERFACE");
2
+
3
+ export { DECLARE_SERVICE_INTERFACE };
4
+ //# sourceMappingURL=DeclaredService.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"DeclaredService.js","sources":["DeclaredService.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\ndeclare const INTERNAL_ASSOCIATED_SERVICE_METADATA: unique symbol;\ndeclare const ERROR: unique symbol;\n\n/**\n * Base interface for services that are associated with a well known interface name.\n *\n * By using this base interface, you can ensure that users of your interface use the correct interface name.\n *\n * Note that this interface is a type level marker only.\n * It has no real associated methods or properties and it is not necessary to implement anything\n * to use this interface in a class.\n *\n * @example\n * ```ts\n * // MyLogger should be referenced via \"my-package.Logger\"\n * export interface MyLogger extends DeclaredService<\"my-package.Logger\"> {\n * log(message: string): void;\n * }\n * ```\n *\n * > Note: TypeScript may list the `INTERNAL_ASSOCIATED_SERVICE_METADATA` property\n * > when generating the implementation for an interface extending this type.\n * > You can simply remove the offending line; it is not required (and not possible)\n * > to implement that attribute - it only exists for the compiler.\n */\nexport interface DeclaredService<InterfaceName extends string> {\n /**\n * Internal type-level service metadata.\n *\n * Note: there is no need to implement this symbol attribute.\n * It is optional and only exists for the compiler, never at runtime.\n *\n * @internal\n */\n [INTERNAL_ASSOCIATED_SERVICE_METADATA]?: ServiceMetadata<InterfaceName>;\n}\n\n/**\n * Helper symbol to declare a service's interface name when not using a separate interface.\n *\n * > NOTE: This symbol does not exist at runtime. Declaring a service interface is compile time only!\n * > It should therefore be imported via `import type` (see example below).\n *\n * @example\n *\n * ```ts\n * import { type DECLARE_SERVICE_INTERFACE} from \"@open-pioneer/runtime\";\n *\n * class MyServiceImpl {\n * // Add this line to your class.\n * // It declares (at compile time) that the service class must be used via the given interface name.\n * // Note that the property is not really present at runtime.\n * declare [DECLARE_SERVICE_INTERFACE]: \"my-package.MyInterface\";\n *\n * method(): void {\n * throw new Error(\"Method not implemented.\");\n * }\n * }\n * ```\n */\nconst DECLARE_SERVICE_INTERFACE = Symbol(\"runtime.DECLARE_SERVICE_INTERFACE\");\nexport { DECLARE_SERVICE_INTERFACE };\n\n/**\n * Given a type implementing {@link DeclaredService} or using {@link DECLARE_SERVICE_INTERFACE},\n * this type will produce the interface name associated with the service type.\n */\nexport type AssociatedInterfaceName<T> =\n T extends DeclaredService<infer InterfaceName>\n ? InterfaceName\n : T extends { [DECLARE_SERVICE_INTERFACE]: string & infer InterfaceName }\n ? InterfaceName\n : never;\n\n/**\n * This helper type produces the expected `interfaceName` (a string parameter) for the given service type.\n *\n * 1. If `ServiceType` is `unknown`, it will produce `string` to allow arbitrary parameters.\n * 2. If `ServiceType` implements {@link DeclaredService}, it will enforce the associated interface name.\n * 3. Otherwise, a compile time error is generated.\n */\nexport type InterfaceNameForServiceType<ServiceType> =\n IsUnknown<ServiceType> extends true\n ? string\n : AssociatedInterfaceName<ServiceType> extends never\n ? {\n [ERROR]: \"TypeScript integration was not set up properly for this service. Make sure the service's TypeScript interface extends 'DeclaredService'.\";\n }\n : AssociatedInterfaceName<ServiceType>;\n\n/**\n * @internal\n */\ninterface ServiceMetadata<InterfaceName> {\n interfaceName: InterfaceName;\n}\n\ntype IsUnknown<T> = unknown extends T ? ([T] extends [null] ? false : true) : false;\n"],"names":[],"mappings":"AA8DM,MAAA,yBAAA,GAA4B,OAAO,mCAAmC;;;;"}
package/api.d.ts CHANGED
@@ -11,7 +11,7 @@ export interface ApiExtension {
11
11
  /**
12
12
  * Returns a set of methods that will be added to the web component's API.
13
13
  */
14
- getApiMethods(): Promise<ApiMethods>;
14
+ getApiMethods(): Promise<ApiMethods> | ApiMethods;
15
15
  }
16
16
  /**
17
17
  * A service provided by the system.
@@ -1 +1 @@
1
- {"version":3,"file":"ApplicationContextImpl.js","sources":["ApplicationContextImpl.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { ApplicationContext } from \"../api\";\nimport { ServiceOptions } from \"../Service\";\n\nexport interface ApplicationContextProperties {\n host: HTMLElement;\n shadowRoot: ShadowRoot;\n container: HTMLElement;\n locale: string;\n supportedLocales: string[];\n\n /** A callback to change the application's locale is injected by the runtime. */\n changeLocale(locale: string): void;\n}\n\nexport class ApplicationContextImpl implements ApplicationContext {\n #host: HTMLElement;\n #shadowRoot: ShadowRoot;\n #container: HTMLElement;\n #locale: string;\n #supportedLocales: readonly string[];\n #changeLocale: (locale: string) => void;\n\n constructor(options: ServiceOptions, properties: ApplicationContextProperties) {\n this.#host = properties.host;\n this.#shadowRoot = properties.shadowRoot;\n this.#container = properties.container;\n this.#locale = properties.locale;\n this.#supportedLocales = Object.freeze(Array.from(properties.supportedLocales));\n this.#changeLocale = properties.changeLocale;\n }\n\n getHostElement(): HTMLElement {\n return this.#host;\n }\n\n getShadowRoot(): ShadowRoot {\n return this.#shadowRoot;\n }\n\n getApplicationContainer(): HTMLElement {\n return this.#container;\n }\n\n getLocale(): string {\n return this.#locale;\n }\n\n setLocale(locale: string): void {\n this.#changeLocale(locale);\n }\n\n getSupportedLocales(): readonly string[] {\n return this.#supportedLocales;\n }\n}\n"],"names":[],"mappings":"AAgBO,MAAM,sBAAqD,CAAA;AAAA,EAC9D,KAAA,CAAA;AAAA,EACA,WAAA,CAAA;AAAA,EACA,UAAA,CAAA;AAAA,EACA,OAAA,CAAA;AAAA,EACA,iBAAA,CAAA;AAAA,EACA,aAAA,CAAA;AAAA,EAEA,WAAA,CAAY,SAAyB,UAA0C,EAAA;AAC3E,IAAA,IAAA,CAAK,QAAQ,UAAW,CAAA,IAAA,CAAA;AACxB,IAAA,IAAA,CAAK,cAAc,UAAW,CAAA,UAAA,CAAA;AAC9B,IAAA,IAAA,CAAK,aAAa,UAAW,CAAA,SAAA,CAAA;AAC7B,IAAA,IAAA,CAAK,UAAU,UAAW,CAAA,MAAA,CAAA;AAC1B,IAAA,IAAA,CAAK,oBAAoB,MAAO,CAAA,MAAA,CAAO,MAAM,IAAK,CAAA,UAAA,CAAW,gBAAgB,CAAC,CAAA,CAAA;AAC9E,IAAA,IAAA,CAAK,gBAAgB,UAAW,CAAA,YAAA,CAAA;AAAA,GACpC;AAAA,EAEA,cAA8B,GAAA;AAC1B,IAAA,OAAO,IAAK,CAAA,KAAA,CAAA;AAAA,GAChB;AAAA,EAEA,aAA4B,GAAA;AACxB,IAAA,OAAO,IAAK,CAAA,WAAA,CAAA;AAAA,GAChB;AAAA,EAEA,uBAAuC,GAAA;AACnC,IAAA,OAAO,IAAK,CAAA,UAAA,CAAA;AAAA,GAChB;AAAA,EAEA,SAAoB,GAAA;AAChB,IAAA,OAAO,IAAK,CAAA,OAAA,CAAA;AAAA,GAChB;AAAA,EAEA,UAAU,MAAsB,EAAA;AAC5B,IAAA,IAAA,CAAK,cAAc,MAAM,CAAA,CAAA;AAAA,GAC7B;AAAA,EAEA,mBAAyC,GAAA;AACrC,IAAA,OAAO,IAAK,CAAA,iBAAA,CAAA;AAAA,GAChB;AACJ;;;;"}
1
+ {"version":3,"file":"ApplicationContextImpl.js","sources":["ApplicationContextImpl.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { ApplicationContext } from \"../api\";\nimport { ServiceOptions } from \"../Service\";\n\nexport interface ApplicationContextProperties {\n host: HTMLElement;\n shadowRoot: ShadowRoot;\n container: HTMLElement;\n locale: string;\n supportedLocales: string[];\n\n /** A callback to change the application's locale is injected by the runtime. */\n changeLocale(locale: string): void;\n}\n\nexport class ApplicationContextImpl implements ApplicationContext {\n #host: HTMLElement;\n #shadowRoot: ShadowRoot;\n #container: HTMLElement;\n #locale: string;\n #supportedLocales: readonly string[];\n #changeLocale: (locale: string) => void;\n\n constructor(options: ServiceOptions, properties: ApplicationContextProperties) {\n this.#host = properties.host;\n this.#shadowRoot = properties.shadowRoot;\n this.#container = properties.container;\n this.#locale = properties.locale;\n this.#supportedLocales = Object.freeze(Array.from(properties.supportedLocales));\n this.#changeLocale = properties.changeLocale;\n }\n\n getHostElement(): HTMLElement {\n return this.#host;\n }\n\n getShadowRoot(): ShadowRoot {\n return this.#shadowRoot;\n }\n\n getApplicationContainer(): HTMLElement {\n return this.#container;\n }\n\n getLocale(): string {\n return this.#locale;\n }\n\n setLocale(locale: string): void {\n // This restarts the application at the moment, so this.locale will _not_ be updated.\n // Instead, we get a new application with a new application context.\n this.#changeLocale(locale);\n }\n\n getSupportedLocales(): readonly string[] {\n return this.#supportedLocales;\n }\n}\n"],"names":[],"mappings":"AAgBO,MAAM,sBAAqD,CAAA;AAAA,EAC9D,KAAA,CAAA;AAAA,EACA,WAAA,CAAA;AAAA,EACA,UAAA,CAAA;AAAA,EACA,OAAA,CAAA;AAAA,EACA,iBAAA,CAAA;AAAA,EACA,aAAA,CAAA;AAAA,EAEA,WAAA,CAAY,SAAyB,UAA0C,EAAA;AAC3E,IAAA,IAAA,CAAK,QAAQ,UAAW,CAAA,IAAA,CAAA;AACxB,IAAA,IAAA,CAAK,cAAc,UAAW,CAAA,UAAA,CAAA;AAC9B,IAAA,IAAA,CAAK,aAAa,UAAW,CAAA,SAAA,CAAA;AAC7B,IAAA,IAAA,CAAK,UAAU,UAAW,CAAA,MAAA,CAAA;AAC1B,IAAA,IAAA,CAAK,oBAAoB,MAAO,CAAA,MAAA,CAAO,MAAM,IAAK,CAAA,UAAA,CAAW,gBAAgB,CAAC,CAAA,CAAA;AAC9E,IAAA,IAAA,CAAK,gBAAgB,UAAW,CAAA,YAAA,CAAA;AAAA,GACpC;AAAA,EAEA,cAA8B,GAAA;AAC1B,IAAA,OAAO,IAAK,CAAA,KAAA,CAAA;AAAA,GAChB;AAAA,EAEA,aAA4B,GAAA;AACxB,IAAA,OAAO,IAAK,CAAA,WAAA,CAAA;AAAA,GAChB;AAAA,EAEA,uBAAuC,GAAA;AACnC,IAAA,OAAO,IAAK,CAAA,UAAA,CAAA;AAAA,GAChB;AAAA,EAEA,SAAoB,GAAA;AAChB,IAAA,OAAO,IAAK,CAAA,OAAA,CAAA;AAAA,GAChB;AAAA,EAEA,UAAU,MAAsB,EAAA;AAG5B,IAAA,IAAA,CAAK,cAAc,MAAM,CAAA,CAAA;AAAA,GAC7B;AAAA,EAEA,mBAAyC,GAAA;AACrC,IAAA,OAAO,IAAK,CAAA,iBAAA,CAAA;AAAA,GAChB;AACJ;;;;"}
package/errors.d.ts CHANGED
@@ -8,6 +8,7 @@ export declare enum ErrorId {
8
8
  INTERFACE_NOT_FOUND = "runtime:interface-not-found",
9
9
  AMBIGUOUS_DEPENDENCY = "runtime:ambiguous-dependency",
10
10
  UNDECLARED_DEPENDENCY = "runtime:undeclared-dependency",
11
+ MISSING_PACKAGE = "runtime:missing-package",
11
12
  SERVICE_CONSTRUCTION_FAILED = "runtime:service-construction-failed",
12
13
  SERVICE_DESTRUCTION_FAILED = "runtime:service-destruction-failed",
13
14
  DUPLICATE_INTERFACE = "runtime:duplicate-interface",
package/errors.js CHANGED
@@ -8,6 +8,7 @@ var ErrorId = /* @__PURE__ */ ((ErrorId2) => {
8
8
  ErrorId2["INTERFACE_NOT_FOUND"] = "runtime:interface-not-found";
9
9
  ErrorId2["AMBIGUOUS_DEPENDENCY"] = "runtime:ambiguous-dependency";
10
10
  ErrorId2["UNDECLARED_DEPENDENCY"] = "runtime:undeclared-dependency";
11
+ ErrorId2["MISSING_PACKAGE"] = "runtime:missing-package";
11
12
  ErrorId2["SERVICE_CONSTRUCTION_FAILED"] = "runtime:service-construction-failed";
12
13
  ErrorId2["SERVICE_DESTRUCTION_FAILED"] = "runtime:service-destruction-failed";
13
14
  ErrorId2["DUPLICATE_INTERFACE"] = "runtime:duplicate-interface";
package/errors.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"errors.js","sources":["errors.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nexport enum ErrorId {\n // Problems with application metadata\n INVALID_METADATA = \"runtime:invalid-metadata\",\n INVALID_PROPERTY_NAME = \"runtime:invalid-property-name\",\n REQUIRED_PROPERTY = \"runtime:required-property\",\n\n // Application lifecycle\n NOT_MOUNTED = \"runtime:element-not-mounted\",\n UNSUPPORTED_LOCALE = \"runtime:unsupported-locale\",\n CONFIG_RESOLUTION_FAILED = \"runtime:config-resolution-failed\",\n\n // Service layer\n INTERFACE_NOT_FOUND = \"runtime:interface-not-found\",\n AMBIGUOUS_DEPENDENCY = \"runtime:ambiguous-dependency\",\n UNDECLARED_DEPENDENCY = \"runtime:undeclared-dependency\",\n SERVICE_CONSTRUCTION_FAILED = \"runtime:service-construction-failed\",\n SERVICE_DESTRUCTION_FAILED = \"runtime:service-destruction-failed\",\n DUPLICATE_INTERFACE = \"runtime:duplicate-interface\",\n DEPENDENCY_CYCLE = \"runtime:dependency-cycle\",\n\n // Web component API\n DUPLICATE_API_METHODS = \"runtime:duplicate-api-methods\",\n\n // Internal\n INTERNAL = \"runtime:internal-error\"\n}\n"],"names":["ErrorId"],"mappings":"AAEY,IAAA,OAAA,qBAAAA,QAAL,KAAA;AAEH,EAAAA,SAAA,kBAAmB,CAAA,GAAA,0BAAA,CAAA;AACnB,EAAAA,SAAA,uBAAwB,CAAA,GAAA,+BAAA,CAAA;AACxB,EAAAA,SAAA,mBAAoB,CAAA,GAAA,2BAAA,CAAA;AAGpB,EAAAA,SAAA,aAAc,CAAA,GAAA,6BAAA,CAAA;AACd,EAAAA,SAAA,oBAAqB,CAAA,GAAA,4BAAA,CAAA;AACrB,EAAAA,SAAA,0BAA2B,CAAA,GAAA,kCAAA,CAAA;AAG3B,EAAAA,SAAA,qBAAsB,CAAA,GAAA,6BAAA,CAAA;AACtB,EAAAA,SAAA,sBAAuB,CAAA,GAAA,8BAAA,CAAA;AACvB,EAAAA,SAAA,uBAAwB,CAAA,GAAA,+BAAA,CAAA;AACxB,EAAAA,SAAA,6BAA8B,CAAA,GAAA,qCAAA,CAAA;AAC9B,EAAAA,SAAA,4BAA6B,CAAA,GAAA,oCAAA,CAAA;AAC7B,EAAAA,SAAA,qBAAsB,CAAA,GAAA,6BAAA,CAAA;AACtB,EAAAA,SAAA,kBAAmB,CAAA,GAAA,0BAAA,CAAA;AAGnB,EAAAA,SAAA,uBAAwB,CAAA,GAAA,+BAAA,CAAA;AAGxB,EAAAA,SAAA,UAAW,CAAA,GAAA,wBAAA,CAAA;AAxBH,EAAAA,OAAAA,QAAAA,CAAAA;AAAA,CAAA,EAAA,OAAA,IAAA,EAAA;;;;"}
1
+ {"version":3,"file":"errors.js","sources":["errors.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nexport enum ErrorId {\n // Problems with application metadata\n INVALID_METADATA = \"runtime:invalid-metadata\",\n INVALID_PROPERTY_NAME = \"runtime:invalid-property-name\",\n REQUIRED_PROPERTY = \"runtime:required-property\",\n\n // Application lifecycle\n NOT_MOUNTED = \"runtime:element-not-mounted\",\n UNSUPPORTED_LOCALE = \"runtime:unsupported-locale\",\n CONFIG_RESOLUTION_FAILED = \"runtime:config-resolution-failed\",\n\n // Service layer\n INTERFACE_NOT_FOUND = \"runtime:interface-not-found\",\n AMBIGUOUS_DEPENDENCY = \"runtime:ambiguous-dependency\",\n UNDECLARED_DEPENDENCY = \"runtime:undeclared-dependency\",\n MISSING_PACKAGE = \"runtime:missing-package\",\n SERVICE_CONSTRUCTION_FAILED = \"runtime:service-construction-failed\",\n SERVICE_DESTRUCTION_FAILED = \"runtime:service-destruction-failed\",\n DUPLICATE_INTERFACE = \"runtime:duplicate-interface\",\n DEPENDENCY_CYCLE = \"runtime:dependency-cycle\",\n\n // Web component API\n DUPLICATE_API_METHODS = \"runtime:duplicate-api-methods\",\n\n // Internal\n INTERNAL = \"runtime:internal-error\"\n}\n"],"names":["ErrorId"],"mappings":"AAEY,IAAA,OAAA,qBAAAA,QAAL,KAAA;AAEH,EAAAA,SAAA,kBAAmB,CAAA,GAAA,0BAAA,CAAA;AACnB,EAAAA,SAAA,uBAAwB,CAAA,GAAA,+BAAA,CAAA;AACxB,EAAAA,SAAA,mBAAoB,CAAA,GAAA,2BAAA,CAAA;AAGpB,EAAAA,SAAA,aAAc,CAAA,GAAA,6BAAA,CAAA;AACd,EAAAA,SAAA,oBAAqB,CAAA,GAAA,4BAAA,CAAA;AACrB,EAAAA,SAAA,0BAA2B,CAAA,GAAA,kCAAA,CAAA;AAG3B,EAAAA,SAAA,qBAAsB,CAAA,GAAA,6BAAA,CAAA;AACtB,EAAAA,SAAA,sBAAuB,CAAA,GAAA,8BAAA,CAAA;AACvB,EAAAA,SAAA,uBAAwB,CAAA,GAAA,+BAAA,CAAA;AACxB,EAAAA,SAAA,iBAAkB,CAAA,GAAA,yBAAA,CAAA;AAClB,EAAAA,SAAA,6BAA8B,CAAA,GAAA,qCAAA,CAAA;AAC9B,EAAAA,SAAA,4BAA6B,CAAA,GAAA,oCAAA,CAAA;AAC7B,EAAAA,SAAA,qBAAsB,CAAA,GAAA,6BAAA,CAAA;AACtB,EAAAA,SAAA,kBAAmB,CAAA,GAAA,0BAAA,CAAA;AAGnB,EAAAA,SAAA,uBAAwB,CAAA,GAAA,+BAAA,CAAA;AAGxB,EAAAA,SAAA,UAAW,CAAA,GAAA,wBAAA,CAAA;AAzBH,EAAAA,OAAAA,QAAAA,CAAAA;AAAA,CAAA,EAAA,OAAA,IAAA,EAAA;;;;"}
package/index.d.ts CHANGED
@@ -2,4 +2,4 @@ export * from "./api";
2
2
  export { type PackageIntl } from "./i18n";
3
3
  export { type ApplicationElement, type ApplicationElementConstructor, type ApplicationProperties, type ApplicationConfig, type CustomElementOptions, type ConfigContext, createCustomElement } from "./CustomElement";
4
4
  export * from "./Service";
5
- export { type DeclaredService, type AssociatedInterfaceName, type InterfaceNameForServiceType, type DECLARE_SERVICE_INTERFACE } from "./DeclaredService";
5
+ export { type DeclaredService, type AssociatedInterfaceName, type InterfaceNameForServiceType, DECLARE_SERVICE_INTERFACE } from "./DeclaredService";
package/index.js CHANGED
@@ -1,2 +1,3 @@
1
1
  export { createCustomElement } from './CustomElement.js';
2
+ export { DECLARE_SERVICE_INTERFACE } from './DeclaredService.js';
2
3
  //# sourceMappingURL=index.js.map
package/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}
1
+ {"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "type": "module",
3
3
  "name": "@open-pioneer/runtime",
4
- "version": "2.1.5",
4
+ "version": "2.1.7",
5
5
  "description": "Implements the runtime environment for Open Pioneer Trails apps.",
6
6
  "keywords": [
7
7
  "open-pioneer-trails"
@@ -14,13 +14,13 @@
14
14
  "directory": "src/packages/runtime"
15
15
  },
16
16
  "peerDependencies": {
17
- "@formatjs/intl": "^2.9.9",
17
+ "@formatjs/intl": "^2.10.4",
18
18
  "react": "^18.3.1",
19
- "react-dom": "^18.2.0",
20
- "@open-pioneer/base-theme": "^0.3.2",
19
+ "react-dom": "^18.3.1",
20
+ "@open-pioneer/base-theme": "^0.3.3",
21
+ "@open-pioneer/core": "^1.3.0",
21
22
  "@open-pioneer/runtime-react-support": "^1.0.2",
22
- "@open-pioneer/core": "^1.2.3",
23
- "@open-pioneer/chakra-integration": "^1.1.3"
23
+ "@open-pioneer/chakra-integration": "^1.1.4"
24
24
  },
25
25
  "exports": {
26
26
  "./package.json": "./package.json",
@@ -48,6 +48,11 @@ class ReactIntegration {
48
48
  `The UI of package '${packageName}' requires the ambiguous interface ${renderedSpec}. Possible choices are: ${renderedChoices}.`
49
49
  );
50
50
  }
51
+ case "unknown-package":
52
+ throw new Error(
53
+ ErrorId.MISSING_PACKAGE,
54
+ missingPackageMessage(packageName, interfaceName)
55
+ );
51
56
  }
52
57
  },
53
58
  getServices: (packageName, interfaceName) => {
@@ -61,6 +66,11 @@ class ReactIntegration {
61
66
  ErrorId.UNDECLARED_DEPENDENCY,
62
67
  `Package '${packageName}' did not declare an UI dependency on all services implementing interface '${interfaceName}'. Add the dependency ("all": true) to the package configuration or remove the usage.`
63
68
  );
69
+ case "unknown-package":
70
+ throw new Error(
71
+ ErrorId.MISSING_PACKAGE,
72
+ missingPackageMessage(packageName, interfaceName)
73
+ );
64
74
  }
65
75
  },
66
76
  getProperties: (packageName) => {
@@ -98,6 +108,9 @@ class ReactIntegration {
98
108
  return pkg;
99
109
  }
100
110
  }
111
+ function missingPackageMessage(packageName, interfaceName) {
112
+ return `Package '${packageName}' was not found in the application's metadata while it attempted to reference the interface '${interfaceName}'. Check that the dependency is declared correctly in the packages that use '${packageName}'.`;
113
+ }
101
114
 
102
115
  export { ReactIntegration };
103
116
  //# sourceMappingURL=ReactIntegration.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"ReactIntegration.js","sources":["ReactIntegration.tsx"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { ComponentType, StrictMode } from \"react\";\nimport { createRoot, Root } from \"react-dom/client\";\nimport { Error } from \"@open-pioneer/core\";\nimport { ErrorId } from \"../errors\";\nimport { ServiceLayer } from \"../service-layer/ServiceLayer\";\nimport { PackageContext, PackageContextMethods } from \"@open-pioneer/runtime-react-support\";\nimport { PackageRepr } from \"../service-layer/PackageRepr\";\nimport { InterfaceSpec, renderInterfaceSpec } from \"../service-layer/InterfaceSpec\";\nimport { renderAmbiguousServiceChoices } from \"../service-layer/ServiceLookup\";\nimport { CustomChakraProvider } from \"@open-pioneer/chakra-integration\";\nimport { theme as defaultTrailsTheme } from \"@open-pioneer/base-theme\";\n\nexport interface ReactIntegrationOptions {\n packages: Map<string, PackageRepr>;\n serviceLayer: ServiceLayer;\n rootNode: HTMLDivElement;\n container: Node;\n theme: Record<string, unknown> | undefined;\n}\n\nexport class ReactIntegration {\n private containerNode: Node;\n private theme: Record<string, unknown> | undefined;\n private packages: Map<string, PackageRepr>;\n private serviceLayer: ServiceLayer;\n private root: Root;\n private packageContext: PackageContextMethods;\n\n constructor(options: ReactIntegrationOptions) {\n this.containerNode = options.container;\n this.theme = options.theme;\n this.packages = options.packages;\n this.serviceLayer = options.serviceLayer;\n this.root = createRoot(options.rootNode);\n this.packageContext = {\n getService: (packageName, interfaceName, options) => {\n const spec: InterfaceSpec = { interfaceName, ...options };\n const result = this.serviceLayer.getService(packageName, spec);\n if (result.type === \"found\") {\n return result.value.getInstanceOrThrow();\n }\n\n const renderedSpec = renderInterfaceSpec(spec);\n switch (result.type) {\n case \"unimplemented\":\n throw new Error(\n ErrorId.INTERFACE_NOT_FOUND,\n `The UI of package '${packageName}' requested the unimplemented interface ${renderedSpec}.`\n );\n case \"undeclared\":\n throw new Error(\n ErrorId.UNDECLARED_DEPENDENCY,\n `Package '${packageName}' did not declare an UI dependency on interface ${renderedSpec}.` +\n ` Add the dependency to the package configuration or remove the usage.`\n );\n case \"ambiguous\": {\n const renderedChoices = renderAmbiguousServiceChoices(result.choices);\n throw new Error(\n ErrorId.AMBIGUOUS_DEPENDENCY,\n `The UI of package '${packageName}' requires the ambiguous interface ${renderedSpec}.` +\n ` Possible choices are: ${renderedChoices}.`\n );\n }\n }\n },\n getServices: (packageName, interfaceName) => {\n const result = this.serviceLayer.getServices(packageName, interfaceName);\n if (result.type === \"found\") {\n return result.value.map((serviceRepr) => serviceRepr.getInstanceOrThrow());\n }\n\n switch (result.type) {\n case \"undeclared\":\n throw new Error(\n ErrorId.UNDECLARED_DEPENDENCY,\n `Package '${packageName}' did not declare an UI dependency on all services implementing interface '${interfaceName}'.` +\n ` Add the dependency (\"all\": true) to the package configuration or remove the usage.`\n );\n }\n },\n getProperties: (packageName) => {\n return this.getPackage(packageName).properties;\n },\n getIntl: (packageName) => {\n return this.getPackage(packageName).intl;\n }\n };\n }\n\n render(Component: ComponentType) {\n this.root.render(\n <StrictMode>\n <CustomChakraProvider\n container={this.containerNode}\n colorMode=\"light\"\n theme={this.theme ?? defaultTrailsTheme}\n >\n <PackageContext.Provider value={this.packageContext}>\n <Component />\n </PackageContext.Provider>\n </CustomChakraProvider>\n </StrictMode>\n );\n }\n\n destroy() {\n this.root.unmount();\n }\n\n private getPackage(packageName: string): PackageRepr {\n const pkg = this.packages.get(packageName);\n if (!pkg) {\n throw new Error(\n ErrorId.INTERNAL,\n `Package '${packageName}' was not found in application.`\n );\n }\n return pkg;\n }\n}\n"],"names":["options","defaultTrailsTheme"],"mappings":";;;;;;;;;;;AAsBO,MAAM,gBAAiB,CAAA;AAAA,EAClB,aAAA,CAAA;AAAA,EACA,KAAA,CAAA;AAAA,EACA,QAAA,CAAA;AAAA,EACA,YAAA,CAAA;AAAA,EACA,IAAA,CAAA;AAAA,EACA,cAAA,CAAA;AAAA,EAER,YAAY,OAAkC,EAAA;AAC1C,IAAA,IAAA,CAAK,gBAAgB,OAAQ,CAAA,SAAA,CAAA;AAC7B,IAAA,IAAA,CAAK,QAAQ,OAAQ,CAAA,KAAA,CAAA;AACrB,IAAA,IAAA,CAAK,WAAW,OAAQ,CAAA,QAAA,CAAA;AACxB,IAAA,IAAA,CAAK,eAAe,OAAQ,CAAA,YAAA,CAAA;AAC5B,IAAK,IAAA,CAAA,IAAA,GAAO,UAAW,CAAA,OAAA,CAAQ,QAAQ,CAAA,CAAA;AACvC,IAAA,IAAA,CAAK,cAAiB,GAAA;AAAA,MAClB,UAAY,EAAA,CAAC,WAAa,EAAA,aAAA,EAAeA,QAAY,KAAA;AACjD,QAAA,MAAM,IAAsB,GAAA,EAAE,aAAe,EAAA,GAAGA,QAAQ,EAAA,CAAA;AACxD,QAAA,MAAM,MAAS,GAAA,IAAA,CAAK,YAAa,CAAA,UAAA,CAAW,aAAa,IAAI,CAAA,CAAA;AAC7D,QAAI,IAAA,MAAA,CAAO,SAAS,OAAS,EAAA;AACzB,UAAO,OAAA,MAAA,CAAO,MAAM,kBAAmB,EAAA,CAAA;AAAA,SAC3C;AAEA,QAAM,MAAA,YAAA,GAAe,oBAAoB,IAAI,CAAA,CAAA;AAC7C,QAAA,QAAQ,OAAO,IAAM;AAAA,UACjB,KAAK,eAAA;AACD,YAAA,MAAM,IAAI,KAAA;AAAA,cACN,OAAQ,CAAA,mBAAA;AAAA,cACR,CAAA,mBAAA,EAAsB,WAAW,CAAA,wCAAA,EAA2C,YAAY,CAAA,CAAA,CAAA;AAAA,aAC5F,CAAA;AAAA,UACJ,KAAK,YAAA;AACD,YAAA,MAAM,IAAI,KAAA;AAAA,cACN,OAAQ,CAAA,qBAAA;AAAA,cACR,CAAA,SAAA,EAAY,WAAW,CAAA,gDAAA,EAAmD,YAAY,CAAA,sEAAA,CAAA;AAAA,aAE1F,CAAA;AAAA,UACJ,KAAK,WAAa,EAAA;AACd,YAAM,MAAA,eAAA,GAAkB,6BAA8B,CAAA,MAAA,CAAO,OAAO,CAAA,CAAA;AACpE,YAAA,MAAM,IAAI,KAAA;AAAA,cACN,OAAQ,CAAA,oBAAA;AAAA,cACR,CAAsB,mBAAA,EAAA,WAAW,CAAsC,mCAAA,EAAA,YAAY,2BACrD,eAAe,CAAA,CAAA,CAAA;AAAA,aACjD,CAAA;AAAA,WACJ;AAAA,SACJ;AAAA,OACJ;AAAA,MACA,WAAA,EAAa,CAAC,WAAA,EAAa,aAAkB,KAAA;AACzC,QAAA,MAAM,MAAS,GAAA,IAAA,CAAK,YAAa,CAAA,WAAA,CAAY,aAAa,aAAa,CAAA,CAAA;AACvE,QAAI,IAAA,MAAA,CAAO,SAAS,OAAS,EAAA;AACzB,UAAA,OAAO,OAAO,KAAM,CAAA,GAAA,CAAI,CAAC,WAAgB,KAAA,WAAA,CAAY,oBAAoB,CAAA,CAAA;AAAA,SAC7E;AAEA,QAAA,QAAQ,OAAO,IAAM;AAAA,UACjB,KAAK,YAAA;AACD,YAAA,MAAM,IAAI,KAAA;AAAA,cACN,OAAQ,CAAA,qBAAA;AAAA,cACR,CAAA,SAAA,EAAY,WAAW,CAAA,2EAAA,EAA8E,aAAa,CAAA,qFAAA,CAAA;AAAA,aAEtH,CAAA;AAAA,SACR;AAAA,OACJ;AAAA,MACA,aAAA,EAAe,CAAC,WAAgB,KAAA;AAC5B,QAAO,OAAA,IAAA,CAAK,UAAW,CAAA,WAAW,CAAE,CAAA,UAAA,CAAA;AAAA,OACxC;AAAA,MACA,OAAA,EAAS,CAAC,WAAgB,KAAA;AACtB,QAAO,OAAA,IAAA,CAAK,UAAW,CAAA,WAAW,CAAE,CAAA,IAAA,CAAA;AAAA,OACxC;AAAA,KACJ,CAAA;AAAA,GACJ;AAAA,EAEA,OAAO,SAA0B,EAAA;AAC7B,IAAA,IAAA,CAAK,IAAK,CAAA,MAAA;AAAA,0BACL,UACG,EAAA,EAAA,QAAA,kBAAA,GAAA;AAAA,QAAC,oBAAA;AAAA,QAAA;AAAA,UACG,WAAW,IAAK,CAAA,aAAA;AAAA,UAChB,SAAU,EAAA,OAAA;AAAA,UACV,KAAA,EAAO,KAAK,KAAS,IAAAC,KAAA;AAAA,UAErB,QAAA,kBAAA,GAAA,CAAC,eAAe,QAAf,EAAA,EAAwB,OAAO,IAAK,CAAA,cAAA,EACjC,QAAC,kBAAA,GAAA,CAAA,SAAA,EAAA,EAAU,CACf,EAAA,CAAA;AAAA,SAAA;AAAA,OAER,EAAA,CAAA;AAAA,KACJ,CAAA;AAAA,GACJ;AAAA,EAEA,OAAU,GAAA;AACN,IAAA,IAAA,CAAK,KAAK,OAAQ,EAAA,CAAA;AAAA,GACtB;AAAA,EAEQ,WAAW,WAAkC,EAAA;AACjD,IAAA,MAAM,GAAM,GAAA,IAAA,CAAK,QAAS,CAAA,GAAA,CAAI,WAAW,CAAA,CAAA;AACzC,IAAA,IAAI,CAAC,GAAK,EAAA;AACN,MAAA,MAAM,IAAI,KAAA;AAAA,QACN,OAAQ,CAAA,QAAA;AAAA,QACR,YAAY,WAAW,CAAA,+BAAA,CAAA;AAAA,OAC3B,CAAA;AAAA,KACJ;AACA,IAAO,OAAA,GAAA,CAAA;AAAA,GACX;AACJ;;;;"}
1
+ {"version":3,"file":"ReactIntegration.js","sources":["ReactIntegration.tsx"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { ComponentType, StrictMode } from \"react\";\nimport { createRoot, Root } from \"react-dom/client\";\nimport { Error } from \"@open-pioneer/core\";\nimport { ErrorId } from \"../errors\";\nimport { ServiceLayer } from \"../service-layer/ServiceLayer\";\nimport { PackageContext, PackageContextMethods } from \"@open-pioneer/runtime-react-support\";\nimport { PackageRepr } from \"../service-layer/PackageRepr\";\nimport { InterfaceSpec, renderInterfaceSpec } from \"../service-layer/InterfaceSpec\";\nimport { renderAmbiguousServiceChoices } from \"../service-layer/ServiceLookup\";\nimport { CustomChakraProvider } from \"@open-pioneer/chakra-integration\";\nimport { theme as defaultTrailsTheme } from \"@open-pioneer/base-theme\";\n\nexport interface ReactIntegrationOptions {\n packages: Map<string, PackageRepr>;\n serviceLayer: ServiceLayer;\n rootNode: HTMLDivElement;\n container: Node;\n theme: Record<string, unknown> | undefined;\n}\n\nexport class ReactIntegration {\n private containerNode: Node;\n private theme: Record<string, unknown> | undefined;\n private packages: Map<string, PackageRepr>;\n private serviceLayer: ServiceLayer;\n private root: Root;\n private packageContext: PackageContextMethods;\n\n constructor(options: ReactIntegrationOptions) {\n this.containerNode = options.container;\n this.theme = options.theme;\n this.packages = options.packages;\n this.serviceLayer = options.serviceLayer;\n this.root = createRoot(options.rootNode);\n this.packageContext = {\n getService: (packageName, interfaceName, options) => {\n const spec: InterfaceSpec = { interfaceName, ...options };\n const result = this.serviceLayer.getService(packageName, spec);\n if (result.type === \"found\") {\n return result.value.getInstanceOrThrow();\n }\n\n const renderedSpec = renderInterfaceSpec(spec);\n switch (result.type) {\n case \"unimplemented\":\n throw new Error(\n ErrorId.INTERFACE_NOT_FOUND,\n `The UI of package '${packageName}' requested the unimplemented interface ${renderedSpec}.`\n );\n case \"undeclared\":\n throw new Error(\n ErrorId.UNDECLARED_DEPENDENCY,\n `Package '${packageName}' did not declare an UI dependency on interface ${renderedSpec}.` +\n ` Add the dependency to the package configuration or remove the usage.`\n );\n case \"ambiguous\": {\n const renderedChoices = renderAmbiguousServiceChoices(result.choices);\n throw new Error(\n ErrorId.AMBIGUOUS_DEPENDENCY,\n `The UI of package '${packageName}' requires the ambiguous interface ${renderedSpec}.` +\n ` Possible choices are: ${renderedChoices}.`\n );\n }\n case \"unknown-package\":\n throw new Error(\n ErrorId.MISSING_PACKAGE,\n missingPackageMessage(packageName, interfaceName)\n );\n }\n },\n getServices: (packageName, interfaceName) => {\n const result = this.serviceLayer.getServices(packageName, interfaceName);\n if (result.type === \"found\") {\n return result.value.map((serviceRepr) => serviceRepr.getInstanceOrThrow());\n }\n\n switch (result.type) {\n case \"undeclared\":\n throw new Error(\n ErrorId.UNDECLARED_DEPENDENCY,\n `Package '${packageName}' did not declare an UI dependency on all services implementing interface '${interfaceName}'.` +\n ` Add the dependency (\"all\": true) to the package configuration or remove the usage.`\n );\n case \"unknown-package\":\n throw new Error(\n ErrorId.MISSING_PACKAGE,\n missingPackageMessage(packageName, interfaceName)\n );\n }\n },\n getProperties: (packageName) => {\n return this.getPackage(packageName).properties;\n },\n getIntl: (packageName) => {\n return this.getPackage(packageName).intl;\n }\n };\n }\n\n render(Component: ComponentType) {\n this.root.render(\n <StrictMode>\n <CustomChakraProvider\n container={this.containerNode}\n colorMode=\"light\"\n theme={this.theme ?? defaultTrailsTheme}\n >\n <PackageContext.Provider value={this.packageContext}>\n <Component />\n </PackageContext.Provider>\n </CustomChakraProvider>\n </StrictMode>\n );\n }\n\n destroy() {\n this.root.unmount();\n }\n\n private getPackage(packageName: string): PackageRepr {\n const pkg = this.packages.get(packageName);\n if (!pkg) {\n throw new Error(\n ErrorId.INTERNAL,\n `Package '${packageName}' was not found in application.`\n );\n }\n return pkg;\n }\n}\n\nfunction missingPackageMessage(packageName: string, interfaceName: string) {\n return (\n `Package '${packageName}' was not found in the application's metadata while it attempted to reference the interface '${interfaceName}'. ` +\n `Check that the dependency is declared correctly in the packages that use '${packageName}'.`\n );\n}\n"],"names":["options","defaultTrailsTheme"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"hooks.js","sources":["hooks.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { useContext, useMemo } from \"react\";\nimport { Error } from \"@open-pioneer/core\";\nimport {\n PackageContext as PackageContext,\n PackageContextMethods\n} from \"@open-pioneer/runtime-react-support\";\nimport { ErrorId } from \"../errors\";\nimport { PackageIntl } from \"../i18n\";\nimport { InterfaceNameForServiceType } from \"../DeclaredService\";\n\n/*\n\n IMPORTANT\n =========\n\n The functions in this file are part of the public API.\n They are imported by code generated during separate package generation via:\n\n import { hookName } from '@open-pioneer/runtime/react-integration'\n\n The matching exports are in the neighboring `index.ts`.\n The interfaces of these hooks must remain stable so that already published packages can continue to work in the future.\n\n See also the implementation of @open-pioneer/build-package.\n\n*/\n\nexport interface UseServiceOptions {\n /** An additional qualifier to disambiguate service instances that implement the same interface. */\n qualifier?: string;\n}\n\n/**\n * Returns a service that implements the given interface.\n * Receives the package name of the importing package as a string.\n *\n * This is an internal hook that is typically called indirectly via the hook\n * provided from `\"open-pioneer:react-hooks\"`.\n *\n * @private\n */\nexport function useServiceInternal<ServiceType = unknown>(\n packageName: string,\n interfaceName: InterfaceNameForServiceType<ServiceType>,\n options?: UseServiceOptions\n): ServiceType;\nexport function useServiceInternal(\n packageName: string,\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n interfaceName: any,\n options?: UseServiceOptions\n): unknown {\n const context = useContext(PackageContext);\n const service = useMemo(\n () =>\n checkContext(\"useService\", context).getService(\n packageName,\n interfaceName,\n options ?? {}\n ),\n [context, packageName, interfaceName, options]\n );\n return service;\n}\n\n/**\n * Returns all services that implement the given interface.\n * Receives the package name of the importing package as a string.\n *\n * This is an internal hook that is typically called indirectly via the hook\n * provided from `\"open-pioneer:react-hooks\"`.\n *\n * @private\n */\nexport function useServicesInternal<ServiceType = unknown>(\n packageName: string,\n interfaceName: InterfaceNameForServiceType<ServiceType>,\n options?: UseServiceOptions\n): ServiceType[];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function useServicesInternal(packageName: string, interfaceName: any): unknown[] {\n const context = useContext(PackageContext);\n const services = useMemo(\n () => checkContext(\"useServices\", context).getServices(packageName, interfaceName),\n [context, packageName, interfaceName]\n );\n return services;\n}\n\n/**\n * Returns the properties for the given package.\n *\n * This is an internal hook that is typically called indirectly via the hook\n * provided from `\"open-pioneer:react-hooks\"`.\n *\n * @private\n */\nexport function usePropertiesInternal(packageName: string): Readonly<Record<string, unknown>> {\n const context = useContext(PackageContext);\n return checkContext(\"useProperties\", context).getProperties(packageName);\n}\n\n/**\n * Returns the i18n object for the given package.\n *\n * This is an internal hook that is typically called indirectly via the hook\n * provided from `\"open-pioneer:react-hooks\"`.\n *\n * @private\n */\nexport function useIntlInternal(packageName: string): PackageIntl {\n const context = useContext(PackageContext);\n return checkContext(\"useIntl\", context).getIntl(packageName);\n}\n\nfunction checkContext(\n hookName: string,\n contextData: PackageContextMethods | null\n): PackageContextMethods {\n if (!contextData) {\n throw new Error(\n ErrorId.INTERNAL,\n `\"Failed to access package context from '${hookName}': react integration was not set up properly.`\n );\n }\n return contextData;\n}\n"],"names":[],"mappings":";;;;;AAgDgB,SAAA,kBAAA,CACZ,WAEA,EAAA,aAAA,EACA,OACO,EAAA;AACP,EAAM,MAAA,OAAA,GAAU,WAAW,cAAc,CAAA,CAAA;AACzC,EAAA,MAAM,OAAU,GAAA,OAAA;AAAA,IACZ,MACI,YAAA,CAAa,YAAc,EAAA,OAAO,CAAE,CAAA,UAAA;AAAA,MAChC,WAAA;AAAA,MACA,aAAA;AAAA,MACA,WAAW,EAAC;AAAA,KAChB;AAAA,IACJ,CAAC,OAAA,EAAS,WAAa,EAAA,aAAA,EAAe,OAAO,CAAA;AAAA,GACjD,CAAA;AACA,EAAO,OAAA,OAAA,CAAA;AACX,CAAA;AAiBgB,SAAA,mBAAA,CAAoB,aAAqB,aAA+B,EAAA;AACpF,EAAM,MAAA,OAAA,GAAU,WAAW,cAAc,CAAA,CAAA;AACzC,EAAA,MAAM,QAAW,GAAA,OAAA;AAAA,IACb,MAAM,YAAa,CAAA,aAAA,EAAe,OAAO,CAAE,CAAA,WAAA,CAAY,aAAa,aAAa,CAAA;AAAA,IACjF,CAAC,OAAS,EAAA,WAAA,EAAa,aAAa,CAAA;AAAA,GACxC,CAAA;AACA,EAAO,OAAA,QAAA,CAAA;AACX,CAAA;AAUO,SAAS,sBAAsB,WAAwD,EAAA;AAC1F,EAAM,MAAA,OAAA,GAAU,WAAW,cAAc,CAAA,CAAA;AACzC,EAAA,OAAO,YAAa,CAAA,eAAA,EAAiB,OAAO,CAAA,CAAE,cAAc,WAAW,CAAA,CAAA;AAC3E,CAAA;AAUO,SAAS,gBAAgB,WAAkC,EAAA;AAC9D,EAAM,MAAA,OAAA,GAAU,WAAW,cAAc,CAAA,CAAA;AACzC,EAAA,OAAO,YAAa,CAAA,SAAA,EAAW,OAAO,CAAA,CAAE,QAAQ,WAAW,CAAA,CAAA;AAC/D,CAAA;AAEA,SAAS,YAAA,CACL,UACA,WACqB,EAAA;AACrB,EAAA,IAAI,CAAC,WAAa,EAAA;AACd,IAAA,MAAM,IAAI,KAAA;AAAA,MACN,OAAQ,CAAA,QAAA;AAAA,MACR,2CAA2C,QAAQ,CAAA,6CAAA,CAAA;AAAA,KACvD,CAAA;AAAA,GACJ;AACA,EAAO,OAAA,WAAA,CAAA;AACX;;;;"}
1
+ {"version":3,"file":"hooks.js","sources":["hooks.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { useContext, useMemo } from \"react\";\nimport { Error } from \"@open-pioneer/core\";\nimport {\n PackageContext as PackageContext,\n PackageContextMethods\n} from \"@open-pioneer/runtime-react-support\";\nimport { ErrorId } from \"../errors\";\nimport { PackageIntl } from \"../i18n\";\nimport { InterfaceNameForServiceType } from \"../DeclaredService\";\n\n/*\n\n IMPORTANT\n =========\n\n The functions in this file are part of the public API, although they should not be called directly.\n They are imported by code generated during separate package compilation generation via:\n\n import { hookName } from '@open-pioneer/runtime/react-integration'\n\n They are also imported by the vite plugin during development and when building an application.\n\n The matching exports are in the neighboring `index.ts`.\n The interfaces of these hooks must remain stable so that already published packages can continue to work in the future.\n\n See also the implementation of @open-pioneer/build-package.\n\n*/\n\nexport interface UseServiceOptions {\n /** An additional qualifier to disambiguate service instances that implement the same interface. */\n qualifier?: string;\n}\n\n/**\n * Returns a service that implements the given interface.\n * Receives the package name of the importing package as a string.\n *\n * This is an internal hook that is typically called indirectly via the hook\n * provided from `\"open-pioneer:react-hooks\"`.\n *\n * @private\n */\nexport function useServiceInternal<ServiceType = unknown>(\n packageName: string,\n interfaceName: InterfaceNameForServiceType<ServiceType>,\n options?: UseServiceOptions\n): ServiceType;\nexport function useServiceInternal(\n packageName: string,\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n interfaceName: any,\n options?: UseServiceOptions\n): unknown {\n const context = useContext(PackageContext);\n const service = useMemo(\n () =>\n checkContext(\"useService\", context).getService(\n packageName,\n interfaceName,\n options ?? {}\n ),\n [context, packageName, interfaceName, options]\n );\n return service;\n}\n\n/**\n * Returns all services that implement the given interface.\n * Receives the package name of the importing package as a string.\n *\n * This is an internal hook that is typically called indirectly via the hook\n * provided from `\"open-pioneer:react-hooks\"`.\n *\n * @private\n */\nexport function useServicesInternal<ServiceType = unknown>(\n packageName: string,\n interfaceName: InterfaceNameForServiceType<ServiceType>,\n options?: UseServiceOptions\n): ServiceType[];\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function useServicesInternal(packageName: string, interfaceName: any): unknown[] {\n const context = useContext(PackageContext);\n const services = useMemo(\n () => checkContext(\"useServices\", context).getServices(packageName, interfaceName),\n [context, packageName, interfaceName]\n );\n return services;\n}\n\n/**\n * Returns the properties for the given package.\n *\n * This is an internal hook that is typically called indirectly via the hook\n * provided from `\"open-pioneer:react-hooks\"`.\n *\n * @private\n */\nexport function usePropertiesInternal(packageName: string): Readonly<Record<string, unknown>> {\n const context = useContext(PackageContext);\n return checkContext(\"useProperties\", context).getProperties(packageName);\n}\n\n/**\n * Returns the i18n object for the given package.\n *\n * This is an internal hook that is typically called indirectly via the hook\n * provided from `\"open-pioneer:react-hooks\"`.\n *\n * @private\n */\nexport function useIntlInternal(packageName: string): PackageIntl {\n const context = useContext(PackageContext);\n return checkContext(\"useIntl\", context).getIntl(packageName);\n}\n\nfunction checkContext(\n hookName: string,\n contextData: PackageContextMethods | null\n): PackageContextMethods {\n if (!contextData) {\n throw new Error(\n ErrorId.INTERNAL,\n `\"Failed to access package context from '${hookName}': react integration was not set up properly.`\n );\n }\n return contextData;\n}\n"],"names":[],"mappings":";;;;;AAkDgB,SAAA,kBAAA,CACZ,WAEA,EAAA,aAAA,EACA,OACO,EAAA;AACP,EAAM,MAAA,OAAA,GAAU,WAAW,cAAc,CAAA,CAAA;AACzC,EAAA,MAAM,OAAU,GAAA,OAAA;AAAA,IACZ,MACI,YAAA,CAAa,YAAc,EAAA,OAAO,CAAE,CAAA,UAAA;AAAA,MAChC,WAAA;AAAA,MACA,aAAA;AAAA,MACA,WAAW,EAAC;AAAA,KAChB;AAAA,IACJ,CAAC,OAAA,EAAS,WAAa,EAAA,aAAA,EAAe,OAAO,CAAA;AAAA,GACjD,CAAA;AACA,EAAO,OAAA,OAAA,CAAA;AACX,CAAA;AAiBgB,SAAA,mBAAA,CAAoB,aAAqB,aAA+B,EAAA;AACpF,EAAM,MAAA,OAAA,GAAU,WAAW,cAAc,CAAA,CAAA;AACzC,EAAA,MAAM,QAAW,GAAA,OAAA;AAAA,IACb,MAAM,YAAa,CAAA,aAAA,EAAe,OAAO,CAAE,CAAA,WAAA,CAAY,aAAa,aAAa,CAAA;AAAA,IACjF,CAAC,OAAS,EAAA,WAAA,EAAa,aAAa,CAAA;AAAA,GACxC,CAAA;AACA,EAAO,OAAA,QAAA,CAAA;AACX,CAAA;AAUO,SAAS,sBAAsB,WAAwD,EAAA;AAC1F,EAAM,MAAA,OAAA,GAAU,WAAW,cAAc,CAAA,CAAA;AACzC,EAAA,OAAO,YAAa,CAAA,eAAA,EAAiB,OAAO,CAAA,CAAE,cAAc,WAAW,CAAA,CAAA;AAC3E,CAAA;AAUO,SAAS,gBAAgB,WAAkC,EAAA;AAC9D,EAAM,MAAA,OAAA,GAAU,WAAW,cAAc,CAAA,CAAA;AACzC,EAAA,OAAO,YAAa,CAAA,SAAA,EAAW,OAAO,CAAA,CAAE,QAAQ,WAAW,CAAA,CAAA;AAC/D,CAAA;AAEA,SAAS,YAAA,CACL,UACA,WACqB,EAAA;AACrB,EAAA,IAAI,CAAC,WAAa,EAAA;AACd,IAAA,MAAM,IAAI,KAAA;AAAA,MACN,OAAQ,CAAA,QAAA;AAAA,MACR,2CAA2C,QAAQ,CAAA,6CAAA,CAAA;AAAA,KACvD,CAAA;AAAA,GACJ;AACA,EAAO,OAAA,WAAA,CAAA;AACX;;;;"}
@@ -2,9 +2,18 @@ import { PackageRepr } from "./PackageRepr";
2
2
  import { ServiceLookupResult, ServicesLookupResult } from "./ServiceLookup";
3
3
  import { InterfaceSpec, ReferenceSpec } from "./InterfaceSpec";
4
4
  export type DynamicLookupResult = ServiceLookupResult | UndeclaredDependency;
5
+ /**
6
+ * Returned when a dependency is not declared in the package's metadata.
7
+ */
5
8
  export interface UndeclaredDependency {
6
9
  type: "undeclared";
7
10
  }
11
+ /**
12
+ * Returned when a package is not found in the application's metadata.
13
+ */
14
+ export interface UnknownPackage {
15
+ type: "unknown-package";
16
+ }
8
17
  export declare class ServiceLayer {
9
18
  private allServices;
10
19
  private requiredServices;
@@ -34,7 +43,7 @@ export declare class ServiceLayer {
34
43
  */
35
44
  getService(packageName: string, spec: InterfaceSpec, options?: {
36
45
  ignoreDeclarationCheck?: boolean;
37
- }): ServiceLookupResult | UndeclaredDependency;
46
+ }): ServiceLookupResult | UndeclaredDependency | UnknownPackage;
38
47
  /**
39
48
  * Returns all services implementing the given interface.
40
49
  * Requires that the dependency on all implementations has been declared in the package.
@@ -44,7 +53,7 @@ export declare class ServiceLayer {
44
53
  *
45
54
  * @throws if the service layer is not in 'started'.
46
55
  */
47
- getServices(packageName: string, interfaceName: string): ServicesLookupResult | UndeclaredDependency;
56
+ getServices(packageName: string, interfaceName: string): ServicesLookupResult | UndeclaredDependency | UnknownPackage;
48
57
  /**
49
58
  * Initializes the given service and its dependencies.
50
59
  * Dependencies are initialized before the service that requires them.
@@ -55,7 +64,8 @@ export declare class ServiceLayer {
55
64
  * The dependencies are destroyed after the service.
56
65
  */
57
66
  private destroyService;
58
- private isDeclaredDependency;
67
+ /** Undefined -> everything is okay */
68
+ private checkDependency;
59
69
  private getReference;
60
70
  private getServiceDeps;
61
71
  }
@@ -5,6 +5,8 @@ import { isSingleImplementationSpec, renderInterfaceSpec, isAllImplementationsSp
5
5
  import { RUNTIME_PACKAGE_NAME } from '../builtin-services/index.js';
6
6
 
7
7
  const LOG = createLogger("runtime:ServiceLayer");
8
+ const UNDECLARED_DEPENDENCY = { type: "undeclared" };
9
+ const UNKNOWN_PACKAGE = { type: "unknown-package" };
8
10
  class ServiceLayer {
9
11
  // All services in the application.
10
12
  allServices;
@@ -91,8 +93,11 @@ class ServiceLayer {
91
93
  if (this.state !== "started") {
92
94
  throw new Error(ErrorId.INTERNAL, "Service layer is not started.");
93
95
  }
94
- if (!options?.ignoreDeclarationCheck && !this.isDeclaredDependency(packageName, spec)) {
95
- return { type: "undeclared" };
96
+ if (!options?.ignoreDeclarationCheck) {
97
+ const checkError = this.checkDependency(packageName, spec);
98
+ if (checkError) {
99
+ return checkError;
100
+ }
96
101
  }
97
102
  return this.serviceLookup.lookupOne(spec);
98
103
  }
@@ -109,8 +114,9 @@ class ServiceLayer {
109
114
  if (this.state !== "started") {
110
115
  throw new Error(ErrorId.INTERNAL, "Service layer is not started.");
111
116
  }
112
- if (!this.isDeclaredDependency(packageName, { interfaceName, all: true })) {
113
- return { type: "undeclared" };
117
+ const checkError = this.checkDependency(packageName, { interfaceName, all: true });
118
+ if (checkError) {
119
+ return checkError;
114
120
  }
115
121
  return this.serviceLookup.lookupAll(interfaceName);
116
122
  }
@@ -163,22 +169,23 @@ class ServiceLayer {
163
169
  }
164
170
  }
165
171
  }
166
- isDeclaredDependency(packageName, spec) {
172
+ /** Undefined -> everything is okay */
173
+ checkDependency(packageName, spec) {
167
174
  const packageEntry = this.declaredDependencies.get(packageName);
168
175
  if (!packageEntry) {
169
- return false;
176
+ return UNKNOWN_PACKAGE;
170
177
  }
171
178
  const interfaceEntry = packageEntry.get(spec.interfaceName);
172
179
  if (!interfaceEntry) {
173
- return false;
180
+ return UNDECLARED_DEPENDENCY;
174
181
  }
175
182
  if (isSingleImplementationSpec(spec)) {
176
183
  if (spec.qualifier == null) {
177
- return interfaceEntry.unqualified;
184
+ return interfaceEntry.unqualified ? void 0 : UNDECLARED_DEPENDENCY;
178
185
  }
179
- return interfaceEntry.qualifiers.has(spec.qualifier);
186
+ return interfaceEntry.qualifiers.has(spec.qualifier) ? void 0 : UNDECLARED_DEPENDENCY;
180
187
  } else {
181
- return interfaceEntry.all;
188
+ return interfaceEntry.all ? void 0 : UNDECLARED_DEPENDENCY;
182
189
  }
183
190
  }
184
191
  getReference(ref) {
@@ -1 +1 @@
1
- {"version":3,"file":"ServiceLayer.js","sources":["ServiceLayer.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { ServiceRepr } from \"./ServiceRepr\";\nimport { createLogger, Error } from \"@open-pioneer/core\";\nimport { ErrorId } from \"../errors\";\nimport {\n ComputedServiceDependencies,\n FrameworkDependency,\n UIDependency,\n verifyDependencies\n} from \"./verifyDependencies\";\nimport { PackageRepr } from \"./PackageRepr\";\nimport { ReadonlyServiceLookup, ServiceLookupResult, ServicesLookupResult } from \"./ServiceLookup\";\nimport {\n InterfaceSpec,\n isAllImplementationsSpec,\n isSingleImplementationSpec,\n ReferenceSpec,\n renderInterfaceSpec\n} from \"./InterfaceSpec\";\nimport { ReferenceMeta } from \"../Service\";\nimport { RUNTIME_PACKAGE_NAME } from \"../builtin-services\";\n\nconst LOG = createLogger(\"runtime:ServiceLayer\");\n\nexport type DynamicLookupResult = ServiceLookupResult | UndeclaredDependency;\n\nexport interface UndeclaredDependency {\n type: \"undeclared\";\n}\n\ninterface DependencyDeclarations {\n all: boolean;\n unqualified: boolean;\n qualifiers: Set<string>;\n}\n\nexport class ServiceLayer {\n // All services in the application.\n private allServices: ServiceRepr[];\n\n // Set of required services. These services and their dependencies will be started.\n private requiredServices: Set<ServiceRepr>;\n\n private serviceLookup: ReadonlyServiceLookup;\n\n // Service id --> Service dependencies\n private serviceDependencies: Map<string, ComputedServiceDependencies>;\n\n // Package name --> Interface name --> Declarations\n private declaredDependencies;\n private state: \"not-started\" | \"started\" | \"destroyed\" = \"not-started\";\n\n /**\n * Constructs a new service layer instance.\n * Requires the application's set of packages (from which services are taken)\n * and an optional set of forced references (interfaces whose implementing services will be started unconditionally).\n *\n * In its current form, the service layer will start only forced references and references needed by the UI (and their dependencies).\n */\n constructor(packages: readonly PackageRepr[], forcedReferences: ReferenceSpec[] = []) {\n const allServices = packages.map((pkg) => pkg.services).flat();\n const uiDependencies = packages\n .map((pkg) =>\n pkg.uiReferences.map<UIDependency>((dep) => {\n return {\n type: \"ui\",\n packageName: pkg.name,\n ...dep\n };\n })\n )\n .flat();\n const requiredReferences = [\n ...forcedReferences.map<FrameworkDependency>((r) => ({\n type: \"framework\",\n ...r\n })),\n ...uiDependencies\n ];\n const { serviceLookup, serviceDependencies } = verifyDependencies({\n services: allServices,\n requiredReferences: requiredReferences\n });\n\n this.allServices = allServices;\n this.requiredServices = getRequiredServices(requiredReferences, serviceLookup);\n this.serviceLookup = serviceLookup;\n this.serviceDependencies = serviceDependencies;\n this.declaredDependencies = buildDependencyIndex(packages);\n }\n\n destroy() {\n for (const service of this.requiredServices) {\n this.destroyService(service);\n }\n this.state = \"destroyed\";\n }\n\n start() {\n if (this.state !== \"not-started\") {\n throw new Error(ErrorId.INTERNAL, \"Service layer was already started.\");\n }\n\n for (const service of this.requiredServices) {\n this.createService(service);\n }\n this.state = \"started\";\n\n // Give warnings for unneeded services during development.\n if (import.meta.env.DEV) {\n const unneededServices = this.allServices\n .filter(\n (service) =>\n service.packageName !== RUNTIME_PACKAGE_NAME &&\n service.state === \"not-constructed\"\n )\n .map((service) => `'${service.id}'`);\n if (unneededServices.length) {\n const services = unneededServices.join(\", \");\n LOG.warn(\n `The following services are contained in the application but were not started: ${services}.`\n );\n }\n }\n }\n\n /**\n * Returns a service implementing the given interface.\n * Checks that the given package actually declared a dependency on that interface\n * to enforce coding guidelines.\n *\n * @param packageName the name of the package requesting the import\n * @param spec the interface specifier\n * @param options advanced options to customize lookup\n * @throws if the service layer is not in 'started' state or if no service implements the interface.\n */\n getService(\n packageName: string,\n spec: InterfaceSpec,\n options?: { ignoreDeclarationCheck?: boolean }\n ): ServiceLookupResult | UndeclaredDependency {\n if (this.state !== \"started\") {\n throw new Error(ErrorId.INTERNAL, \"Service layer is not started.\");\n }\n\n if (!options?.ignoreDeclarationCheck && !this.isDeclaredDependency(packageName, spec)) {\n return { type: \"undeclared\" };\n }\n\n return this.serviceLookup.lookupOne(spec);\n }\n\n /**\n * Returns all services implementing the given interface.\n * Requires that the dependency on all implementations has been declared in the package.\n *\n * @param packageName the name of the package requesting the import\n * @param interfaceName the interface name\n *\n * @throws if the service layer is not in 'started'.\n */\n getServices(\n packageName: string,\n interfaceName: string\n ): ServicesLookupResult | UndeclaredDependency {\n if (this.state !== \"started\") {\n throw new Error(ErrorId.INTERNAL, \"Service layer is not started.\");\n }\n\n if (!this.isDeclaredDependency(packageName, { interfaceName, all: true })) {\n return { type: \"undeclared\" };\n }\n\n return this.serviceLookup.lookupAll(interfaceName);\n }\n\n /**\n * Initializes the given service and its dependencies.\n * Dependencies are initialized before the service that requires them.\n */\n private createService(service: ServiceRepr) {\n if (service.state === \"constructed\") {\n const instance = service.getInstanceOrThrow();\n service.addRef();\n return instance;\n }\n if (service.state === \"constructing\") {\n throw new Error(ErrorId.INTERNAL, \"Cycle during service construction.\");\n }\n if (service.state !== \"not-constructed\") {\n throw new Error(ErrorId.INTERNAL, \"Invalid service state.\");\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const references: Record<string, any> = {};\n const referencesMeta: Record<string, ReferenceMeta | ReferenceMeta[]> = {};\n\n // Sets state to 'constructing' to detect cycles\n service.beforeCreate();\n\n // Initialize dependencies recursively before creating the current service.\n for (const [referenceName, serviceDeps] of Object.entries(this.getServiceDeps(service))) {\n const [referenceValue, referenceMeta] = this.getReference(serviceDeps);\n references[referenceName] = referenceValue;\n referencesMeta[referenceName] = referenceMeta;\n }\n\n // Sets state to 'constructed' to finish the state transition, useCount is 1.\n LOG.debug(`Creating service '${service.id}'.`);\n return service.create({ references, referencesMeta });\n }\n\n /**\n * Destroys the given service and its dependencies.\n * The dependencies are destroyed after the service.\n */\n private destroyService(service: ServiceRepr) {\n if (service.state === \"destroyed\") {\n return;\n }\n\n // Destroy the service before its dependencies (reverse order\n // compared to construction).\n if (service.removeRef() <= 0) {\n LOG.debug(`Destroying service '${service.id}'`);\n service.destroy();\n }\n\n for (const serviceDeps of Object.values(this.getServiceDeps(service))) {\n if (Array.isArray(serviceDeps)) {\n for (const dep of serviceDeps) {\n this.destroyService(dep);\n }\n } else {\n this.destroyService(serviceDeps);\n }\n }\n }\n\n private isDeclaredDependency(packageName: string, spec: ReferenceSpec) {\n const packageEntry = this.declaredDependencies.get(packageName);\n if (!packageEntry) {\n return false;\n }\n const interfaceEntry = packageEntry.get(spec.interfaceName);\n if (!interfaceEntry) {\n return false;\n }\n\n if (isSingleImplementationSpec(spec)) {\n if (spec.qualifier == null) {\n return interfaceEntry.unqualified;\n }\n return interfaceEntry.qualifiers.has(spec.qualifier);\n } else {\n return interfaceEntry.all;\n }\n }\n\n private getReference(ref: ServiceRepr): [unknown, ReferenceMeta];\n private getReference(ref: ServiceRepr[]): [unknown[], ReferenceMeta[]];\n private getReference(\n ref: ServiceRepr | ServiceRepr[]\n ): [unknown, ReferenceMeta] | [unknown[], ReferenceMeta[]];\n private getReference(\n ref: ServiceRepr | ServiceRepr[]\n ): [unknown, ReferenceMeta] | [unknown[], ReferenceMeta[]] {\n if (Array.isArray(ref)) {\n const referenceValues: unknown[] = [];\n const referenceMeta: ReferenceMeta[] = [];\n for (const d of ref) {\n const [value, meta] = this.getReference(d);\n referenceValues.push(value);\n referenceMeta.push(meta);\n }\n return [referenceValues, referenceMeta];\n }\n\n const referenceValue = this.createService(ref);\n const referenceMeta: ReferenceMeta = {\n serviceId: ref.id\n };\n return [referenceValue, referenceMeta];\n }\n\n private getServiceDeps(service: ServiceRepr) {\n const dependencies = this.serviceDependencies.get(service.id);\n if (!dependencies) {\n throw new Error(\n ErrorId.INTERNAL,\n `Failed to find precomputed service dependencies for '${service.id}'.`\n );\n }\n return dependencies;\n }\n}\n\nfunction getRequiredServices(\n requiredReferences: readonly ReferenceSpec[],\n serviceLookup: ReadonlyServiceLookup\n): Set<ServiceRepr> {\n const requiredServices = new Set<ServiceRepr>();\n for (const referenceSpec of requiredReferences) {\n const result = serviceLookup.lookup(referenceSpec);\n if (result.type !== \"found\") {\n // Should be caught by verifier\n throw new Error(\n ErrorId.INTERNAL,\n `Failed to find required reference to ${renderInterfaceSpec(referenceSpec)}.`\n );\n }\n if (Array.isArray(result.value)) {\n for (const service of result.value) {\n requiredServices.add(service);\n }\n } else {\n requiredServices.add(result.value);\n }\n }\n return requiredServices;\n}\n\nfunction buildDependencyIndex(packages: readonly PackageRepr[]) {\n // Register declared UI dependencies.\n // This is needed as a lookup structure to that dynamic service lookups\n // can be validated at runtime.\n const index = new Map<string, Map<string, DependencyDeclarations>>();\n for (const pkg of packages) {\n const packageName = pkg.name;\n const packageEntry = new Map<string, DependencyDeclarations>();\n for (const uiReference of pkg.uiReferences) {\n let interfaceEntry = packageEntry.get(uiReference.interfaceName);\n if (!interfaceEntry) {\n interfaceEntry = {\n all: false,\n unqualified: false,\n qualifiers: new Set<string>()\n };\n packageEntry.set(uiReference.interfaceName, interfaceEntry);\n }\n\n if (isAllImplementationsSpec(uiReference)) {\n interfaceEntry.all = true;\n } else if (isSingleImplementationSpec(uiReference)) {\n if (uiReference.qualifier == null) {\n interfaceEntry.unqualified = true;\n } else {\n interfaceEntry.qualifiers.add(uiReference.qualifier);\n }\n } else {\n throw new Error(ErrorId.INTERNAL, `Unexpected implementation spec.`);\n }\n }\n index.set(packageName, packageEntry);\n }\n return index;\n}\n"],"names":["referenceMeta"],"mappings":"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"}
1
+ {"version":3,"file":"ServiceLayer.js","sources":["ServiceLayer.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2023 Open Pioneer project (https://github.com/open-pioneer)\n// SPDX-License-Identifier: Apache-2.0\nimport { ServiceRepr } from \"./ServiceRepr\";\nimport { createLogger, Error } from \"@open-pioneer/core\";\nimport { ErrorId } from \"../errors\";\nimport {\n ComputedServiceDependencies,\n FrameworkDependency,\n UIDependency,\n verifyDependencies\n} from \"./verifyDependencies\";\nimport { PackageRepr } from \"./PackageRepr\";\nimport { ReadonlyServiceLookup, ServiceLookupResult, ServicesLookupResult } from \"./ServiceLookup\";\nimport {\n InterfaceSpec,\n isAllImplementationsSpec,\n isSingleImplementationSpec,\n ReferenceSpec,\n renderInterfaceSpec\n} from \"./InterfaceSpec\";\nimport { ReferenceMeta } from \"../Service\";\nimport { RUNTIME_PACKAGE_NAME } from \"../builtin-services\";\n\nconst LOG = createLogger(\"runtime:ServiceLayer\");\n\nexport type DynamicLookupResult = ServiceLookupResult | UndeclaredDependency;\n\n/**\n * Returned when a dependency is not declared in the package's metadata.\n */\nexport interface UndeclaredDependency {\n type: \"undeclared\";\n}\n\n/**\n * Returned when a package is not found in the application's metadata.\n */\nexport interface UnknownPackage {\n type: \"unknown-package\";\n}\n\nconst UNDECLARED_DEPENDENCY = { type: \"undeclared\" } satisfies UndeclaredDependency;\nconst UNKNOWN_PACKAGE = { type: \"unknown-package\" } satisfies UnknownPackage;\n\ninterface DependencyDeclarations {\n all: boolean;\n unqualified: boolean;\n qualifiers: Set<string>;\n}\n\nexport class ServiceLayer {\n // All services in the application.\n private allServices: ServiceRepr[];\n\n // Set of required services. These services and their dependencies will be started.\n private requiredServices: Set<ServiceRepr>;\n\n private serviceLookup: ReadonlyServiceLookup;\n\n // Service id --> Service dependencies\n private serviceDependencies: Map<string, ComputedServiceDependencies>;\n\n // Package name --> Interface name --> Declarations\n private declaredDependencies;\n private state: \"not-started\" | \"started\" | \"destroyed\" = \"not-started\";\n\n /**\n * Constructs a new service layer instance.\n * Requires the application's set of packages (from which services are taken)\n * and an optional set of forced references (interfaces whose implementing services will be started unconditionally).\n *\n * In its current form, the service layer will start only forced references and references needed by the UI (and their dependencies).\n */\n constructor(packages: readonly PackageRepr[], forcedReferences: ReferenceSpec[] = []) {\n const allServices = packages.map((pkg) => pkg.services).flat();\n const uiDependencies = packages\n .map((pkg) =>\n pkg.uiReferences.map<UIDependency>((dep) => {\n return {\n type: \"ui\",\n packageName: pkg.name,\n ...dep\n };\n })\n )\n .flat();\n const requiredReferences = [\n ...forcedReferences.map<FrameworkDependency>((r) => ({\n type: \"framework\",\n ...r\n })),\n ...uiDependencies\n ];\n const { serviceLookup, serviceDependencies } = verifyDependencies({\n services: allServices,\n requiredReferences: requiredReferences\n });\n\n this.allServices = allServices;\n this.requiredServices = getRequiredServices(requiredReferences, serviceLookup);\n this.serviceLookup = serviceLookup;\n this.serviceDependencies = serviceDependencies;\n this.declaredDependencies = buildDependencyIndex(packages);\n }\n\n destroy() {\n for (const service of this.requiredServices) {\n this.destroyService(service);\n }\n this.state = \"destroyed\";\n }\n\n start() {\n if (this.state !== \"not-started\") {\n throw new Error(ErrorId.INTERNAL, \"Service layer was already started.\");\n }\n\n for (const service of this.requiredServices) {\n this.createService(service);\n }\n this.state = \"started\";\n\n // Give warnings for unneeded services during development.\n if (import.meta.env.DEV) {\n const unneededServices = this.allServices\n .filter(\n (service) =>\n service.packageName !== RUNTIME_PACKAGE_NAME &&\n service.state === \"not-constructed\"\n )\n .map((service) => `'${service.id}'`);\n if (unneededServices.length) {\n const services = unneededServices.join(\", \");\n LOG.warn(\n `The following services are contained in the application but were not started: ${services}.`\n );\n }\n }\n }\n\n /**\n * Returns a service implementing the given interface.\n * Checks that the given package actually declared a dependency on that interface\n * to enforce coding guidelines.\n *\n * @param packageName the name of the package requesting the import\n * @param spec the interface specifier\n * @param options advanced options to customize lookup\n * @throws if the service layer is not in 'started' state or if no service implements the interface.\n */\n getService(\n packageName: string,\n spec: InterfaceSpec,\n options?: { ignoreDeclarationCheck?: boolean }\n ): ServiceLookupResult | UndeclaredDependency | UnknownPackage {\n if (this.state !== \"started\") {\n throw new Error(ErrorId.INTERNAL, \"Service layer is not started.\");\n }\n\n if (!options?.ignoreDeclarationCheck) {\n const checkError = this.checkDependency(packageName, spec);\n if (checkError) {\n return checkError;\n }\n }\n\n return this.serviceLookup.lookupOne(spec);\n }\n\n /**\n * Returns all services implementing the given interface.\n * Requires that the dependency on all implementations has been declared in the package.\n *\n * @param packageName the name of the package requesting the import\n * @param interfaceName the interface name\n *\n * @throws if the service layer is not in 'started'.\n */\n getServices(\n packageName: string,\n interfaceName: string\n ): ServicesLookupResult | UndeclaredDependency | UnknownPackage {\n if (this.state !== \"started\") {\n throw new Error(ErrorId.INTERNAL, \"Service layer is not started.\");\n }\n\n const checkError = this.checkDependency(packageName, { interfaceName, all: true });\n if (checkError) {\n return checkError;\n }\n return this.serviceLookup.lookupAll(interfaceName);\n }\n\n /**\n * Initializes the given service and its dependencies.\n * Dependencies are initialized before the service that requires them.\n */\n private createService(service: ServiceRepr) {\n if (service.state === \"constructed\") {\n const instance = service.getInstanceOrThrow();\n service.addRef();\n return instance;\n }\n if (service.state === \"constructing\") {\n throw new Error(ErrorId.INTERNAL, \"Cycle during service construction.\");\n }\n if (service.state !== \"not-constructed\") {\n throw new Error(ErrorId.INTERNAL, \"Invalid service state.\");\n }\n\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n const references: Record<string, any> = {};\n const referencesMeta: Record<string, ReferenceMeta | ReferenceMeta[]> = {};\n\n // Sets state to 'constructing' to detect cycles\n service.beforeCreate();\n\n // Initialize dependencies recursively before creating the current service.\n for (const [referenceName, serviceDeps] of Object.entries(this.getServiceDeps(service))) {\n const [referenceValue, referenceMeta] = this.getReference(serviceDeps);\n references[referenceName] = referenceValue;\n referencesMeta[referenceName] = referenceMeta;\n }\n\n // Sets state to 'constructed' to finish the state transition, useCount is 1.\n LOG.debug(`Creating service '${service.id}'.`);\n return service.create({ references, referencesMeta });\n }\n\n /**\n * Destroys the given service and its dependencies.\n * The dependencies are destroyed after the service.\n */\n private destroyService(service: ServiceRepr) {\n if (service.state === \"destroyed\") {\n return;\n }\n\n // Destroy the service before its dependencies (reverse order\n // compared to construction).\n if (service.removeRef() <= 0) {\n LOG.debug(`Destroying service '${service.id}'`);\n service.destroy();\n }\n\n for (const serviceDeps of Object.values(this.getServiceDeps(service))) {\n if (Array.isArray(serviceDeps)) {\n for (const dep of serviceDeps) {\n this.destroyService(dep);\n }\n } else {\n this.destroyService(serviceDeps);\n }\n }\n }\n\n /** Undefined -> everything is okay */\n private checkDependency(\n packageName: string,\n spec: ReferenceSpec\n ): UnknownPackage | UndeclaredDependency | undefined {\n const packageEntry = this.declaredDependencies.get(packageName);\n if (!packageEntry) {\n return UNKNOWN_PACKAGE;\n }\n\n const interfaceEntry = packageEntry.get(spec.interfaceName);\n if (!interfaceEntry) {\n return UNDECLARED_DEPENDENCY;\n }\n\n if (isSingleImplementationSpec(spec)) {\n if (spec.qualifier == null) {\n return interfaceEntry.unqualified ? undefined : UNDECLARED_DEPENDENCY;\n }\n return interfaceEntry.qualifiers.has(spec.qualifier)\n ? undefined\n : UNDECLARED_DEPENDENCY;\n } else {\n return interfaceEntry.all ? undefined : UNDECLARED_DEPENDENCY;\n }\n }\n\n private getReference(ref: ServiceRepr): [unknown, ReferenceMeta];\n private getReference(ref: ServiceRepr[]): [unknown[], ReferenceMeta[]];\n private getReference(\n ref: ServiceRepr | ServiceRepr[]\n ): [unknown, ReferenceMeta] | [unknown[], ReferenceMeta[]];\n private getReference(\n ref: ServiceRepr | ServiceRepr[]\n ): [unknown, ReferenceMeta] | [unknown[], ReferenceMeta[]] {\n if (Array.isArray(ref)) {\n const referenceValues: unknown[] = [];\n const referenceMeta: ReferenceMeta[] = [];\n for (const d of ref) {\n const [value, meta] = this.getReference(d);\n referenceValues.push(value);\n referenceMeta.push(meta);\n }\n return [referenceValues, referenceMeta];\n }\n\n const referenceValue = this.createService(ref);\n const referenceMeta: ReferenceMeta = {\n serviceId: ref.id\n };\n return [referenceValue, referenceMeta];\n }\n\n private getServiceDeps(service: ServiceRepr) {\n const dependencies = this.serviceDependencies.get(service.id);\n if (!dependencies) {\n throw new Error(\n ErrorId.INTERNAL,\n `Failed to find precomputed service dependencies for '${service.id}'.`\n );\n }\n return dependencies;\n }\n}\n\nfunction getRequiredServices(\n requiredReferences: readonly ReferenceSpec[],\n serviceLookup: ReadonlyServiceLookup\n): Set<ServiceRepr> {\n const requiredServices = new Set<ServiceRepr>();\n for (const referenceSpec of requiredReferences) {\n const result = serviceLookup.lookup(referenceSpec);\n if (result.type !== \"found\") {\n // Should be caught by verifier\n throw new Error(\n ErrorId.INTERNAL,\n `Failed to find required reference to ${renderInterfaceSpec(referenceSpec)}.`\n );\n }\n if (Array.isArray(result.value)) {\n for (const service of result.value) {\n requiredServices.add(service);\n }\n } else {\n requiredServices.add(result.value);\n }\n }\n return requiredServices;\n}\n\nfunction buildDependencyIndex(packages: readonly PackageRepr[]) {\n // Register declared UI dependencies.\n // This is needed as a lookup structure to that dynamic service lookups\n // can be validated at runtime.\n const index = new Map<string, Map<string, DependencyDeclarations>>();\n for (const pkg of packages) {\n const packageName = pkg.name;\n const packageEntry = new Map<string, DependencyDeclarations>();\n for (const uiReference of pkg.uiReferences) {\n let interfaceEntry = packageEntry.get(uiReference.interfaceName);\n if (!interfaceEntry) {\n interfaceEntry = {\n all: false,\n unqualified: false,\n qualifiers: new Set<string>()\n };\n packageEntry.set(uiReference.interfaceName, interfaceEntry);\n }\n\n if (isAllImplementationsSpec(uiReference)) {\n interfaceEntry.all = true;\n } else if (isSingleImplementationSpec(uiReference)) {\n if (uiReference.qualifier == null) {\n interfaceEntry.unqualified = true;\n } else {\n interfaceEntry.qualifiers.add(uiReference.qualifier);\n }\n } else {\n throw new Error(ErrorId.INTERNAL, `Unexpected implementation spec.`);\n }\n }\n index.set(packageName, packageEntry);\n }\n return index;\n}\n"],"names":["referenceMeta"],"mappings":"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"}