@kronos-integration/service 11.1.0 → 11.2.1

package/LICENSE

@@ -1,24 +1,12 @@
-Copyright (c) 2015-2024 darlenya & arlac77
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
-
-* Redistributions of source code must retain the above copyright notice, this
-  list of conditions and the following disclaimer.
-
-* Redistributions in binary form must reproduce the above copyright notice,
-  this list of conditions and the following disclaimer in the documentation
-  and/or other materials provided with the distribution.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
+Copyright (C) 2015-2025 by darlenya & arlac77
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -1,8 +1,5 @@
-[![npm](https://img.shields.io/npm/v/@kronos-integration/service.svg)](https://www.npmjs.com/package/@kronos-integration/service)
-[![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
+[![License](https://img.shields.io/badge/License-0BSD-blue.svg)](https://spdx.org/licenses/0BSD.html)
 [![Typed with TypeScript](https://flat.badgen.net/badge/icon/Typed?icon=typescript\&label\&labelColor=blue\&color=555555)](https://typescriptlang.org)
-[![bundlejs](https://deno.bundlejs.com/?q=@kronos-integration/service\&badge=detailed)](https://bundlejs.com/?q=@kronos-integration/service)
-[![downloads](http://img.shields.io/npm/dm/@kronos-integration/service.svg?style=flat-square)](https://npmjs.org/package/@kronos-integration/service)
 [![GitHub Issues](https://img.shields.io/github/issues/Kronos-Integration/service.svg?style=flat-square)](https://github.com/Kronos-Integration/service/issues)
 [![Build Status](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2FKronos-Integration%2Fservice%2Fbadge\&style=flat)](https://actions-badge.atrox.dev/Kronos-Integration/service/goto)
 [![Styled with prettier](https://img.shields.io/badge/styled_with-prettier-ff69b4.svg)](https://github.com/prettier/prettier)
@@ -67,18 +64,16 @@ The transitions are:
     *   [autostart](#autostart-1)
     *   [name](#name-1)
     *   [endpoints](#endpoints-1)
-*   [ServiceProviderMixin](#serviceprovidermixin)
-    *   [Parameters](#parameters-7)
 *   [Service](#service)
-    *   [Parameters](#parameters-8)
+    *   [Parameters](#parameters-7)
     *   [Properties](#properties-1)
     *   [extendetName](#extendetname)
     *   [stateChanged](#statechanged)
-        *   [Parameters](#parameters-9)
+        *   [Parameters](#parameters-8)
     *   [rejectWrongState](#rejectwrongstate)
-        *   [Parameters](#parameters-10)
+        *   [Parameters](#parameters-9)
     *   [timeoutForTransition](#timeoutfortransition)
-        *   [Parameters](#parameters-11)
+        *   [Parameters](#parameters-10)
     *   [\_start](#_start)
     *   [\_stop](#_stop)
     *   [\_restart](#_restart)
@@ -87,15 +82,15 @@ The transitions are:
     *   [isServiceProvider](#isserviceprovider)
     *   [toString](#tostring)
     *   [toJSONWithOptions](#tojsonwithoptions)
-        *   [Parameters](#parameters-12)
+        *   [Parameters](#parameters-11)
     *   [name](#name-2)
     *   [autostart](#autostart-2)
     *   [\_configure](#_configure)
-        *   [Parameters](#parameters-13)
+        *   [Parameters](#parameters-12)
     *   [configure](#configure-1)
-        *   [Parameters](#parameters-14)
+        *   [Parameters](#parameters-13)
     *   [log](#log)
-        *   [Parameters](#parameters-15)
+        *   [Parameters](#parameters-14)
     *   [configurationAttributes](#configurationattributes)
     *   [endpoints](#endpoints-2)
 *   [StandaloneServiceProvider](#standaloneserviceprovider)
@@ -215,18 +210,6 @@ Adds a log input endpoint to the set of Service endpoints.
 
 Returns **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** predefined endpoints
 
-## ServiceProviderMixin
-
-Provide services and hold service configuration.
-By default a service provider has two build in services
-'logger' and 'config'.
-
-### Parameters
-
-*   `superclass`  
-*   `serviceLoggerClass`   (optional, default `ServiceLogger`)
-*   `serviceConfigClass`   (optional, default `ServiceConfig`)
-
 ## Service
 
 **Extends EndpointsMixin(StateTransitionMixin(LogLevelMixin(class {}), prepareActions({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kronos-integration/service",
-  "version": "11.1.0",
+  "version": "11.2.1",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -25,19 +25,19 @@
   ],
   "license": "BSD-2-Clause",
   "scripts": {
-    "prepare": "npm run prepare:typescript",
-    "prepare:typescript": "tsc --allowJs --declaration --emitDeclarationOnly --declarationDir types --resolveJsonModule -t esnext -m esnext --module nodenext --moduleResolution nodenext --rootDir src ./src**/*.mjs",
-    "test": "npm run test:ava",
+    "prepare": "node --run prepare:typescript",
+    "prepare:typescript": "tsc --allowJs --declaration --emitDeclarationOnly --declarationDir types --resolveJsonModule --target es2024 --lib es2024 -m esnext --module nodenext --moduleResolution nodenext --rootDir src ./src**/*.mjs",
+    "test": "node --run test:ava",
     "test:ava": "ava --timeout 4m tests/*-ava.mjs tests/*-ava-node.mjs",
     "cover": "c8 -x 'tests/**/*' --temp-directory build/tmp ava --timeout 4m tests/*-ava.mjs tests/*-ava-node.mjs && c8 report -r lcov -o build/coverage --temp-directory build/tmp",
     "docs": "documentation readme --section=API ./src/**/*.mjs",
-    "lint": "npm run lint:docs && npm run lint:typescript",
+    "lint": "node --run lint:docs && node --run lint:typescript",
     "lint:docs": "documentation lint ./src/**/*.mjs",
-    "lint:typescript": "tsc --allowJs --checkJs --noEmit --resolveJsonModule -t esnext -m esnext --module nodenext --moduleResolution nodenext ./src**/*.mjs"
+    "lint:typescript": "tsc --allowJs --checkJs --noEmit --resolveJsonModule --target es2024 --lib es2024 -m esnext --module nodenext --moduleResolution nodenext ./src**/*.mjs"
   },
   "dependencies": {
-    "@kronos-integration/endpoint": "^9.5.5",
-    "@kronos-integration/interceptor": "^10.3.0",
+    "@kronos-integration/endpoint": "^9.5.6",
+    "@kronos-integration/interceptor": "^10.3.2",
     "loglevel-mixin": "^7.2.2",
     "model-attributes": "^4.2.2",
     "remove-sensible-values": "^1.3.1",
@@ -47,11 +47,11 @@
     "ava": "^6.1.3",
     "c8": "^10.1.2",
     "documentation": "^14.0.3",
-    "semantic-release": "^24.1.1",
-    "typescript": "^5.6.2"
+    "semantic-release": "^24.1.2",
+    "typescript": "^5.7.0-beta"
   },
   "engines": {
-    "node": ">=22.9.0"
+    "node": ">=22.11.0"
   },
   "repository": {
     "type": "git",

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/endpoints-mixin.d.mts

@@ -4,4 +4,4 @@
  * @param {new() => superclass} superclass class to be extended
  * @return {new() => superclass} extended class
  */
-export function EndpointsMixin(superclass: new () => new () => any): new () => new () => any;
+export function EndpointsMixin(superclass: new () => new () => /*elided*/ any): new () => new () => /*elided*/ any;

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: any, InitializationContext: any) => new (Object: any, InitializationContext: any) => any, serviceConfigClass?: new (Object: any, InitializationContext: any) => new (Object: any, InitializationContext: any) => any): {
+export function ServiceProviderMixin(superclass: any, serviceLoggerClass?: new (Object: any, InitializationContext: any) => new (Object: any, InitializationContext: any) => /*elided*/ any, serviceConfigClass?: new (Object: any, InitializationContext: any) => new (Object: any, InitializationContext: any) => /*elided*/ any): {
     new (config: any, ic?: any): {
         [x: string]: any;
         listeners: {};
@@ -21,7 +21,7 @@ export function ServiceProviderMixin(superclass: any, serviceLoggerClass?: new (
          * By default be our own owner.
          * @return this
          */
-        readonly owner: any;
+        readonly owner: /*elided*/ any;
         /**
          * We are the service provider.
          * @return {boolean} true
@@ -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}.
@@ -40,7 +40,7 @@ export function ServiceProviderMixin(superclass: any, serviceLoggerClass?: new (
          * @param {new() => factory} factory
          * @returns {new() => factory} factory
          */
-        registerInterceptorFactory(factory: new () => new () => any): new () => new () => any;
+        registerInterceptorFactory(factory: new () => new () => /*elided*/ any): new () => new () => /*elided*/ any;
         unregisterInterceptorFactory(factory: any): void;
         /**
          * Instanciates an interceptor from its definition data.

package/types/service.d.mts

@@ -1,4 +1,4 @@
-declare const Service_base: new () => new () => any;
+declare const Service_base: new () => new () => /*elided*/ any;
 /**
  * Service
  * The initial state is 'stopped'.

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

@@ -9,10 +9,10 @@ declare const StandaloneServiceProvider_base: {
         emit(name: any, ...args: any[]): void;
         addListener(name: any, listener: any): void;
         removeListener(name: any, listener: any): void;
-        readonly owner: any;
+        readonly owner: /*elided*/ any;
         readonly isServiceProvider: boolean;
-        registerFactories(factories: Function[]): void;
-        registerInterceptorFactory(factory: new () => new () => any): new () => new () => any;
+        registerFactories(factories: [Function | string]): Promise<void>;
+        registerInterceptorFactory(factory: new () => new () => /*elided*/ any): new () => new () => /*elided*/ any;
         unregisterInterceptorFactory(factory: any): void;
         instantiateInterceptor(definition: any): import("@kronos-integration/interceptor").Interceptor;
         serviceStateChanged(service: any, oldState: any, newState: any): void;