@kronos-integration/service 11.0.0 → 11.2.0

package/README.md

@@ -14,6 +14,30 @@
 
 Base service implementation
 
+# Service states
+
+```mermaid
+stateDiagram-v2
+    stopped --> starting [1]
+    starting --> failed: [2]
+    starting --> running: [3]
+    running --> stopping: [4]
+    running --> failed: [5]
+    stopping --> failed: [6]
+    stopping --> stopped: [7]
+```
+
+The transitions are:
+| Number | From | To | Condition |
+| ------ | ---- | -- | --------- |
+| 1 | `~stopped~` | `~starting~` | |
+| 2 | `~starting~` | `~failed~` | |
+| 3 | `~starting~` | `~running~` | |
+| 4 | `~running~` | `~stopping~` | |
+| 5 | `~running~` | `~failed~` | |
+| 6 | `~stopping~` | `~failed~` | |
+| 7 | `~stopping~` | `~stopped~` | |
+
 # API
 
 <!-- Generated by documentation.js. Update this documentation by updating the source code. -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kronos-integration/service",
-  "version": "11.0.0",
+  "version": "11.2.0",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -36,7 +36,7 @@
     "lint:typescript": "tsc --allowJs --checkJs --noEmit --resolveJsonModule -t esnext -m esnext --module nodenext --moduleResolution nodenext ./src**/*.mjs"
   },
   "dependencies": {
-    "@kronos-integration/endpoint": "^9.5.4",
+    "@kronos-integration/endpoint": "^9.5.5",
     "@kronos-integration/interceptor": "^10.3.0",
     "loglevel-mixin": "^7.2.2",
     "model-attributes": "^4.2.2",
@@ -45,13 +45,13 @@
   },
   "devDependencies": {
     "ava": "^6.1.3",
-    "c8": "^9.1.0",
+    "c8": "^10.1.2",
     "documentation": "^14.0.3",
-    "semantic-release": "^23.1.1",
-    "typescript": "^5.4.5"
+    "semantic-release": "^24.1.1",
+    "typescript": "^5.6.2"
   },
   "engines": {
-    "node": ">=22.2.0"
+    "node": ">=22.9.0"
   },
   "repository": {
     "type": "git",

package/src/initialization-context.mjs

@@ -232,7 +232,7 @@ export const InitializationContext = LogLevelMixin(
      * @param {string} name service name
      * @return {Promise<Service|undefined>}
      */
-    async declareService(config, name) {      
+    async declareService(config={}, name) {      
       const sp = this.serviceProvider;
       let service = sp.getService(name);
 

package/src/service-provider-mixin.mjs

@@ -89,15 +89,20 @@ export function ServiceProviderMixin(
     /**
      * Register service or interceptor factories.
      *
-     * @param {Function[]} factories
+     * @param {[Function|string]} factories
      */
-    registerFactories(factories) {
-      for (const f of factories) {
-        const p = f.prototype;
-        if (p instanceof Interceptor) {
-          this.registerInterceptorFactory(f);
-        } else if (p instanceof Service) {
-          this.registerServiceFactory(f);
+    async registerFactories(factories) {
+      for (let factory of factories) {
+        if(typeof factory === 'string') {
+          const module = await import(factory);
+          factory = new module.default();
+        }
+
+        const prototype = factory.prototype;
+        if (prototype instanceof Interceptor) {
+          this.registerInterceptorFactory(factory);
+        } else if (prototype instanceof Service) {
+          this.registerServiceFactory(factory);
         }
       }
     }

package/types/service-provider-mixin.d.mts

@@ -6,7 +6,7 @@
  * @param {new(Object,InitializationContext) => serviceLoggerClass} serviceLoggerClass where the logging houtd go
  * @param {new(Object,InitializationContext) => serviceConfigClass} serviceConfigClass where the config comes from
  */
-export function ServiceProviderMixin(superclass: any, serviceLoggerClass?: new (Object, InitializationContext) => new (Object: any, InitializationContext: any) => any, serviceConfigClass?: new (Object, InitializationContext) => new (Object: any, InitializationContext: any) => any): {
+export function ServiceProviderMixin(superclass: any, serviceLoggerClass?: new (Object: any, InitializationContext: any) => new (Object: any, InitializationContext: any) => any, serviceConfigClass?: new (Object: any, InitializationContext: any) => new (Object: any, InitializationContext: any) => any): {
     new (config: any, ic?: any): {
         [x: string]: any;
         listeners: {};
@@ -30,9 +30,9 @@ export function ServiceProviderMixin(superclass: any, serviceLoggerClass?: new (
         /**
          * Register service or interceptor factories.
          *
-         * @param {Function[]} factories
+         * @param {[Function|string]} factories
          */
-        registerFactories(factories: Function[]): void;
+        registerFactories(factories: [Function | string]): Promise<void>;
         /**
          * Registers a interceptor factory for later use by
          * @see {instantiateInterceptor}.

package/types/standalone-service-provider.d.mts

@@ -11,8 +11,8 @@ declare const StandaloneServiceProvider_base: {
         removeListener(name: any, listener: any): void;
         readonly owner: any;
         readonly isServiceProvider: boolean;
-        registerFactories(factories: Function[]): void;
-        registerInterceptorFactory(factory: new () => any): new () => new () => any;
+        registerFactories(factories: [Function | string]): Promise<void>;
+        registerInterceptorFactory(factory: new () => new () => any): new () => new () => any;
         unregisterInterceptorFactory(factory: any): void;
         instantiateInterceptor(definition: any): import("@kronos-integration/interceptor").Interceptor;
         serviceStateChanged(service: any, oldState: any, newState: any): void;
@@ -23,7 +23,7 @@ declare const StandaloneServiceProvider_base: {
         readonly serviceNames: string[];
         getService(name: any): any;
         declareService(config: any): Promise<any>;
-        declareServices(configs: any): Promise<any>;
+        declareServices(configs: object): Promise<any>;
         _start(): Promise<any[]>;
         _stop(): Promise<any>;
     };