@twin.org/engine-core 0.0.2-next.3 → 0.0.2-next.5

package/dist/cjs/index.cjs

@@ -4,6 +4,7 @@ var core = require('@twin.org/core');
 var entity = require('@twin.org/entity');
 var loggingConnectorConsole = require('@twin.org/logging-connector-console');
 var loggingModels = require('@twin.org/logging-models');
+var loggingService = require('@twin.org/logging-service');
 var modules = require('@twin.org/modules');
 var promises = require('node:fs/promises');
 var path = require('node:path');
@@ -72,10 +73,16 @@ class EngineCore {
      * Name for the engine logger.
      */
     static LOGGER_TYPE_NAME = "engine";
+    /**
+     * Runtime name for the class in camel case.
+     * @internal
+     */
+    static _CLASS_NAME_CAMEL_CASE = core.StringHelper.camelCase("EngineCore");
     /**
      * Runtime name for the class.
+     * @internal
      */
-    CLASS_NAME = "EngineCore";
+    static _CLASS_NAME = "EngineCore";
     /**
      * The core context.
      */
@@ -137,7 +144,7 @@ class EngineCore {
         this._typeInitialisers = [];
         this._context = {
             config: options.config,
-            defaultTypes: {},
+            registeredInstances: {},
             componentInstances: [],
             state: { componentStates: {} },
             stateDirty: false
@@ -174,9 +181,9 @@ class EngineCore {
             return false;
         }
         this.setupEngineLogger();
-        this.logInfo(core.I18n.formatMessage("engineCore.starting"));
+        this.logInfo(core.I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.starting`));
         if (this._context.config.debug) {
-            this.logInfo(core.I18n.formatMessage("engineCore.debuggingEnabled"));
+            this.logInfo(core.I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.debuggingEnabled`));
         }
         let canContinue;
         try {
@@ -186,11 +193,11 @@ class EngineCore {
                     await this.initialiseTypeConfig(type, typeConfig, module, method);
                 }
                 await this.bootstrap();
-                this.logInfo(core.I18n.formatMessage("engineCore.componentsStarting"));
+                this.logInfo(core.I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.componentsStarting`));
                 for (const instance of this._context.componentInstances) {
                     if (core.Is.function(instance.component.start)) {
                         const instanceName = this.getInstanceName(instance);
-                        this.logInfo(core.I18n.formatMessage("engineCore.componentStarting", {
+                        this.logInfo(core.I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.componentStarting`, {
                             element: instance.instanceType
                         }));
                         const componentState = this._context.state.componentStates[instanceName] ?? {};
@@ -202,9 +209,9 @@ class EngineCore {
                         }
                     }
                 }
-                this.logInfo(core.I18n.formatMessage("engineCore.componentsComplete"));
+                this.logInfo(core.I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.componentsComplete`));
             }
-            this.logInfo(core.I18n.formatMessage("engineCore.started"));
+            this.logInfo(core.I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.started`));
             this._isStarted = true;
         }
         catch (err) {
@@ -223,14 +230,16 @@ class EngineCore {
      * @returns Nothing.
      */
     async stop() {
-        this.logInfo(core.I18n.formatMessage("engineCore.stopping"));
-        this.logInfo(core.I18n.formatMessage("engineCore.componentsStopping"));
+        this.logInfo(core.I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.stopping`));
+        this.logInfo(core.I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.componentsStopping`));
         for (const instance of this._context.componentInstances) {
             if (core.Is.function(instance.component.stop)) {
                 const instanceName = this.getInstanceName(instance);
                 const componentState = this._context.state.componentStates[instanceName] ?? {};
                 const lastState = core.ObjectHelper.clone(componentState);
-                this.logInfo(core.I18n.formatMessage("engineCore.componentStopping", { element: instance.instanceType }));
+                this.logInfo(core.I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.componentStopping`, {
+                    element: instance.instanceType
+                }));
                 try {
                     await instance.component.stop(this._context.state.nodeIdentity, this._loggerTypeName, componentState);
                     if (!core.ObjectHelper.equal(lastState, componentState)) {
@@ -239,15 +248,15 @@ class EngineCore {
                     }
                 }
                 catch (err) {
-                    this.logError(new core.GeneralError(this.CLASS_NAME, "componentStopFailed", {
+                    this.logError(new core.GeneralError(EngineCore._CLASS_NAME, "componentStopFailed", {
                         component: instance.instanceType
                     }, core.BaseError.fromError(err)));
                 }
             }
         }
         await this.stateSave();
-        this.logInfo(core.I18n.formatMessage("engineCore.componentsStopped"));
-        this.logInfo(core.I18n.formatMessage("engineCore.stopped"));
+        this.logInfo(core.I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.componentsStopped`));
+        this.logInfo(core.I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.stopped`));
     }
     /**
      * Log info.
@@ -255,7 +264,7 @@ class EngineCore {
      */
     logInfo(message) {
         this._engineLoggingConnector?.log({
-            source: this.CLASS_NAME,
+            source: EngineCore._CLASS_NAME,
             level: "info",
             message
         });
@@ -274,7 +283,7 @@ class EngineCore {
                 message += `\n${formattedError.stack}`;
             }
             this._engineLoggingConnector?.log({
-                source: this.CLASS_NAME,
+                source: EngineCore._CLASS_NAME,
                 level: "error",
                 message
             });
@@ -295,11 +304,48 @@ class EngineCore {
         return this._context.state;
     }
     /**
-     * Get the types for the component.
-     * @returns The default types.
+     * Get all the registered instances.
+     * @returns The registered instances.
      */
-    getDefaultTypes() {
-        return this._context.defaultTypes;
+    getRegisteredInstances() {
+        return this._context.registeredInstances;
+    }
+    /**
+     * Get the registered instance type for the component/connector.
+     * @param componentConnectorType The type of the component/connector.
+     * @param features The requested features of the component, if not specified the default entry will be retrieved.
+     * @returns The instance type matching the criteria if one is registered.
+     * @throws If a matching instance was not found.
+     */
+    getRegisteredInstanceType(componentConnectorType, features) {
+        core.Guards.stringValue(EngineCore._CLASS_NAME, "componentConnectorType", componentConnectorType);
+        const registeredType = this.getRegisteredInstanceTypeOptional(componentConnectorType, features);
+        if (!core.Is.stringValue(registeredType)) {
+            throw new core.GeneralError(EngineCore._CLASS_NAME, "instanceTypeNotFound", {
+                type: componentConnectorType,
+                features: (features ?? ["default"]).join(",")
+            });
+        }
+        return registeredType;
+    }
+    /**
+     * Get the registered instance type for the component/connector if it exists.
+     * @param componentConnectorType The type of the component/connector.
+     * @param features The requested features of the component, if not specified the default entry will be retrieved.
+     * @returns The instance type matching the criteria if one is registered.
+     */
+    getRegisteredInstanceTypeOptional(componentConnectorType, features) {
+        let registeredType;
+        const registeredTypes = this._context.registeredInstances[componentConnectorType];
+        if (core.Is.arrayValue(registeredTypes)) {
+            if (core.Is.arrayValue(features)) {
+                registeredType = registeredTypes.find(t => t.features?.every(f => features.includes(f)))?.type;
+            }
+            else {
+                registeredType = registeredTypes[0]?.type;
+            }
+        }
+        return registeredType;
     }
     /**
      * Get the data required to create a clone of the engine.
@@ -326,10 +372,10 @@ class EngineCore {
      * @param silent Should the clone be silent.
      */
     populateClone(cloneData, silent) {
-        core.Guards.object(this.CLASS_NAME, "cloneData", cloneData);
-        core.Guards.object(this.CLASS_NAME, "cloneData.config", cloneData.config);
-        core.Guards.object(this.CLASS_NAME, "cloneData.state", cloneData.state);
-        core.Guards.array(this.CLASS_NAME, "cloneData.typeInitialisers", cloneData.typeInitialisers);
+        core.Guards.object(EngineCore._CLASS_NAME, "cloneData", cloneData);
+        core.Guards.object(EngineCore._CLASS_NAME, "cloneData.config", cloneData.config);
+        core.Guards.object(EngineCore._CLASS_NAME, "cloneData.state", cloneData.state);
+        core.Guards.array(EngineCore._CLASS_NAME, "cloneData.typeInitialisers", cloneData.typeInitialisers);
         this._loggerTypeName = cloneData.loggerTypeName;
         this._skipBootstrap = true;
         if (silent ?? false) {
@@ -337,7 +383,7 @@ class EngineCore {
         }
         this._context = {
             config: cloneData.config,
-            defaultTypes: {},
+            registeredInstances: {},
             componentInstances: [],
             state: { componentStates: {} },
             stateDirty: false
@@ -360,9 +406,20 @@ class EngineCore {
             const instanceMethod = await modules.ModuleHelper.getModuleEntry(module, method);
             for (let i = 0; i < typeConfig.length; i++) {
                 const instanceType = instanceMethod(this, this._context, typeConfig[i], typeConfig[i].overrideInstanceType);
-                if (core.Is.stringValue(instanceType) &&
-                    (core.Is.empty(this._context.defaultTypes[typeKey]) || typeConfig[i].isDefault)) {
-                    this._context.defaultTypes[typeKey] = instanceType;
+                if (core.Is.stringValue(instanceType)) {
+                    this._context.registeredInstances[typeKey] ??= [];
+                    if (typeConfig[i].isDefault ?? false) {
+                        this._context.registeredInstances[typeKey].unshift({
+                            type: instanceType,
+                            features: typeConfig[i].features
+                        });
+                    }
+                    else {
+                        this._context.registeredInstances[typeKey].push({
+                            type: instanceType,
+                            features: typeConfig[i].features
+                        });
+                    }
                 }
             }
         }
@@ -373,7 +430,7 @@ class EngineCore {
      */
     setupEngineLogger() {
         const silent = this._context.config.silent ?? false;
-        const engineLogger = silent
+        const engineLoggerConnector = silent
             ? new loggingModels.SilentLoggingConnector()
             : new loggingConnectorConsole.ConsoleLoggingConnector({
                 config: {
@@ -383,11 +440,24 @@ class EngineCore {
             });
         this._context.componentInstances.push({
             instanceType: this._loggerTypeName,
-            component: engineLogger
+            component: engineLoggerConnector
         });
-        loggingModels.LoggingConnectorFactory.register(this._loggerTypeName, () => engineLogger);
-        this._engineLoggingConnector = engineLogger;
-        this._context.defaultTypes.loggingConnector = this._loggerTypeName;
+        loggingModels.LoggingConnectorFactory.register(this._loggerTypeName, () => engineLoggerConnector);
+        this._engineLoggingConnector = engineLoggerConnector;
+        this._context.registeredInstances.loggingConnector = [
+            {
+                type: this._loggerTypeName
+            }
+        ];
+        const engineLoggerComponent = new loggingService.LoggingService({
+            loggingConnectorType: this._loggerTypeName
+        });
+        core.ComponentFactory.register("logging-service", () => engineLoggerComponent);
+        this._context.registeredInstances.loggingComponent = [
+            {
+                type: "logging-service"
+            }
+        ];
     }
     /**
      * Load the state.
@@ -436,12 +506,12 @@ class EngineCore {
      */
     async bootstrap() {
         if (!this._skipBootstrap) {
-            this.logInfo(core.I18n.formatMessage("engineCore.bootstrapStarted"));
+            this.logInfo(core.I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.bootstrapStarted`));
             // First bootstrap the components.
             for (const instance of this._context.componentInstances) {
                 if (core.Is.function(instance.component.bootstrap)) {
                     const instanceName = this.getInstanceName(instance);
-                    this.logInfo(core.I18n.formatMessage("engineCore.bootstrapping", {
+                    this.logInfo(core.I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.bootstrapping`, {
                         element: instanceName
                     }));
                     const componentState = this._context.state.componentStates[instanceName] ?? {};
@@ -449,7 +519,7 @@ class EngineCore {
                     const bootstrapSuccess = await instance.component.bootstrap(this._loggerTypeName, componentState);
                     // If the bootstrap method failed then throw an error
                     if (!bootstrapSuccess) {
-                        throw new core.GeneralError(this.CLASS_NAME, "bootstrapFailed", {
+                        throw new core.GeneralError(EngineCore._CLASS_NAME, "bootstrapFailed", {
                             component: `${instance.component.CLASS_NAME}:${instance.instanceType}`
                         });
                     }
@@ -463,7 +533,7 @@ class EngineCore {
             if (core.Is.function(this._customBootstrap)) {
                 await this._customBootstrap(this, this._context);
             }
-            this.logInfo(core.I18n.formatMessage("engineCore.bootstrapComplete"));
+            this.logInfo(core.I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.bootstrapComplete`));
         }
     }
     /**

package/dist/esm/index.mjs

@@ -1,7 +1,8 @@
-import { I18n, StringHelper, Is, ObjectHelper, BaseError, GeneralError, ErrorHelper, Guards } from '@twin.org/core';
+import { I18n, StringHelper, Is, ObjectHelper, BaseError, GeneralError, ErrorHelper, Guards, ComponentFactory } from '@twin.org/core';
 import { EntitySchemaFactory } from '@twin.org/entity';
 import { ConsoleLoggingConnector } from '@twin.org/logging-connector-console';
 import { SilentLoggingConnector, LoggingConnectorFactory } from '@twin.org/logging-models';
+import { LoggingService } from '@twin.org/logging-service';
 import { ModuleHelper } from '@twin.org/modules';
 import { readFile, mkdir, writeFile, stat } from 'node:fs/promises';
 import path from 'node:path';
@@ -70,10 +71,16 @@ class EngineCore {
      * Name for the engine logger.
      */
     static LOGGER_TYPE_NAME = "engine";
+    /**
+     * Runtime name for the class in camel case.
+     * @internal
+     */
+    static _CLASS_NAME_CAMEL_CASE = StringHelper.camelCase("EngineCore");
     /**
      * Runtime name for the class.
+     * @internal
      */
-    CLASS_NAME = "EngineCore";
+    static _CLASS_NAME = "EngineCore";
     /**
      * The core context.
      */
@@ -135,7 +142,7 @@ class EngineCore {
         this._typeInitialisers = [];
         this._context = {
             config: options.config,
-            defaultTypes: {},
+            registeredInstances: {},
             componentInstances: [],
             state: { componentStates: {} },
             stateDirty: false
@@ -172,9 +179,9 @@ class EngineCore {
             return false;
         }
         this.setupEngineLogger();
-        this.logInfo(I18n.formatMessage("engineCore.starting"));
+        this.logInfo(I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.starting`));
         if (this._context.config.debug) {
-            this.logInfo(I18n.formatMessage("engineCore.debuggingEnabled"));
+            this.logInfo(I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.debuggingEnabled`));
         }
         let canContinue;
         try {
@@ -184,11 +191,11 @@ class EngineCore {
                     await this.initialiseTypeConfig(type, typeConfig, module, method);
                 }
                 await this.bootstrap();
-                this.logInfo(I18n.formatMessage("engineCore.componentsStarting"));
+                this.logInfo(I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.componentsStarting`));
                 for (const instance of this._context.componentInstances) {
                     if (Is.function(instance.component.start)) {
                         const instanceName = this.getInstanceName(instance);
-                        this.logInfo(I18n.formatMessage("engineCore.componentStarting", {
+                        this.logInfo(I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.componentStarting`, {
                             element: instance.instanceType
                         }));
                         const componentState = this._context.state.componentStates[instanceName] ?? {};
@@ -200,9 +207,9 @@ class EngineCore {
                         }
                     }
                 }
-                this.logInfo(I18n.formatMessage("engineCore.componentsComplete"));
+                this.logInfo(I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.componentsComplete`));
             }
-            this.logInfo(I18n.formatMessage("engineCore.started"));
+            this.logInfo(I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.started`));
             this._isStarted = true;
         }
         catch (err) {
@@ -221,14 +228,16 @@ class EngineCore {
      * @returns Nothing.
      */
     async stop() {
-        this.logInfo(I18n.formatMessage("engineCore.stopping"));
-        this.logInfo(I18n.formatMessage("engineCore.componentsStopping"));
+        this.logInfo(I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.stopping`));
+        this.logInfo(I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.componentsStopping`));
         for (const instance of this._context.componentInstances) {
             if (Is.function(instance.component.stop)) {
                 const instanceName = this.getInstanceName(instance);
                 const componentState = this._context.state.componentStates[instanceName] ?? {};
                 const lastState = ObjectHelper.clone(componentState);
-                this.logInfo(I18n.formatMessage("engineCore.componentStopping", { element: instance.instanceType }));
+                this.logInfo(I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.componentStopping`, {
+                    element: instance.instanceType
+                }));
                 try {
                     await instance.component.stop(this._context.state.nodeIdentity, this._loggerTypeName, componentState);
                     if (!ObjectHelper.equal(lastState, componentState)) {
@@ -237,15 +246,15 @@ class EngineCore {
                     }
                 }
                 catch (err) {
-                    this.logError(new GeneralError(this.CLASS_NAME, "componentStopFailed", {
+                    this.logError(new GeneralError(EngineCore._CLASS_NAME, "componentStopFailed", {
                         component: instance.instanceType
                     }, BaseError.fromError(err)));
                 }
             }
         }
         await this.stateSave();
-        this.logInfo(I18n.formatMessage("engineCore.componentsStopped"));
-        this.logInfo(I18n.formatMessage("engineCore.stopped"));
+        this.logInfo(I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.componentsStopped`));
+        this.logInfo(I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.stopped`));
     }
     /**
      * Log info.
@@ -253,7 +262,7 @@ class EngineCore {
      */
     logInfo(message) {
         this._engineLoggingConnector?.log({
-            source: this.CLASS_NAME,
+            source: EngineCore._CLASS_NAME,
             level: "info",
             message
         });
@@ -272,7 +281,7 @@ class EngineCore {
                 message += `\n${formattedError.stack}`;
             }
             this._engineLoggingConnector?.log({
-                source: this.CLASS_NAME,
+                source: EngineCore._CLASS_NAME,
                 level: "error",
                 message
             });
@@ -293,11 +302,48 @@ class EngineCore {
         return this._context.state;
     }
     /**
-     * Get the types for the component.
-     * @returns The default types.
+     * Get all the registered instances.
+     * @returns The registered instances.
      */
-    getDefaultTypes() {
-        return this._context.defaultTypes;
+    getRegisteredInstances() {
+        return this._context.registeredInstances;
+    }
+    /**
+     * Get the registered instance type for the component/connector.
+     * @param componentConnectorType The type of the component/connector.
+     * @param features The requested features of the component, if not specified the default entry will be retrieved.
+     * @returns The instance type matching the criteria if one is registered.
+     * @throws If a matching instance was not found.
+     */
+    getRegisteredInstanceType(componentConnectorType, features) {
+        Guards.stringValue(EngineCore._CLASS_NAME, "componentConnectorType", componentConnectorType);
+        const registeredType = this.getRegisteredInstanceTypeOptional(componentConnectorType, features);
+        if (!Is.stringValue(registeredType)) {
+            throw new GeneralError(EngineCore._CLASS_NAME, "instanceTypeNotFound", {
+                type: componentConnectorType,
+                features: (features ?? ["default"]).join(",")
+            });
+        }
+        return registeredType;
+    }
+    /**
+     * Get the registered instance type for the component/connector if it exists.
+     * @param componentConnectorType The type of the component/connector.
+     * @param features The requested features of the component, if not specified the default entry will be retrieved.
+     * @returns The instance type matching the criteria if one is registered.
+     */
+    getRegisteredInstanceTypeOptional(componentConnectorType, features) {
+        let registeredType;
+        const registeredTypes = this._context.registeredInstances[componentConnectorType];
+        if (Is.arrayValue(registeredTypes)) {
+            if (Is.arrayValue(features)) {
+                registeredType = registeredTypes.find(t => t.features?.every(f => features.includes(f)))?.type;
+            }
+            else {
+                registeredType = registeredTypes[0]?.type;
+            }
+        }
+        return registeredType;
     }
     /**
      * Get the data required to create a clone of the engine.
@@ -324,10 +370,10 @@ class EngineCore {
      * @param silent Should the clone be silent.
      */
     populateClone(cloneData, silent) {
-        Guards.object(this.CLASS_NAME, "cloneData", cloneData);
-        Guards.object(this.CLASS_NAME, "cloneData.config", cloneData.config);
-        Guards.object(this.CLASS_NAME, "cloneData.state", cloneData.state);
-        Guards.array(this.CLASS_NAME, "cloneData.typeInitialisers", cloneData.typeInitialisers);
+        Guards.object(EngineCore._CLASS_NAME, "cloneData", cloneData);
+        Guards.object(EngineCore._CLASS_NAME, "cloneData.config", cloneData.config);
+        Guards.object(EngineCore._CLASS_NAME, "cloneData.state", cloneData.state);
+        Guards.array(EngineCore._CLASS_NAME, "cloneData.typeInitialisers", cloneData.typeInitialisers);
         this._loggerTypeName = cloneData.loggerTypeName;
         this._skipBootstrap = true;
         if (silent ?? false) {
@@ -335,7 +381,7 @@ class EngineCore {
         }
         this._context = {
             config: cloneData.config,
-            defaultTypes: {},
+            registeredInstances: {},
             componentInstances: [],
             state: { componentStates: {} },
             stateDirty: false
@@ -358,9 +404,20 @@ class EngineCore {
             const instanceMethod = await ModuleHelper.getModuleEntry(module, method);
             for (let i = 0; i < typeConfig.length; i++) {
                 const instanceType = instanceMethod(this, this._context, typeConfig[i], typeConfig[i].overrideInstanceType);
-                if (Is.stringValue(instanceType) &&
-                    (Is.empty(this._context.defaultTypes[typeKey]) || typeConfig[i].isDefault)) {
-                    this._context.defaultTypes[typeKey] = instanceType;
+                if (Is.stringValue(instanceType)) {
+                    this._context.registeredInstances[typeKey] ??= [];
+                    if (typeConfig[i].isDefault ?? false) {
+                        this._context.registeredInstances[typeKey].unshift({
+                            type: instanceType,
+                            features: typeConfig[i].features
+                        });
+                    }
+                    else {
+                        this._context.registeredInstances[typeKey].push({
+                            type: instanceType,
+                            features: typeConfig[i].features
+                        });
+                    }
                 }
             }
         }
@@ -371,7 +428,7 @@ class EngineCore {
      */
     setupEngineLogger() {
         const silent = this._context.config.silent ?? false;
-        const engineLogger = silent
+        const engineLoggerConnector = silent
             ? new SilentLoggingConnector()
             : new ConsoleLoggingConnector({
                 config: {
@@ -381,11 +438,24 @@ class EngineCore {
             });
         this._context.componentInstances.push({
             instanceType: this._loggerTypeName,
-            component: engineLogger
+            component: engineLoggerConnector
         });
-        LoggingConnectorFactory.register(this._loggerTypeName, () => engineLogger);
-        this._engineLoggingConnector = engineLogger;
-        this._context.defaultTypes.loggingConnector = this._loggerTypeName;
+        LoggingConnectorFactory.register(this._loggerTypeName, () => engineLoggerConnector);
+        this._engineLoggingConnector = engineLoggerConnector;
+        this._context.registeredInstances.loggingConnector = [
+            {
+                type: this._loggerTypeName
+            }
+        ];
+        const engineLoggerComponent = new LoggingService({
+            loggingConnectorType: this._loggerTypeName
+        });
+        ComponentFactory.register("logging-service", () => engineLoggerComponent);
+        this._context.registeredInstances.loggingComponent = [
+            {
+                type: "logging-service"
+            }
+        ];
     }
     /**
      * Load the state.
@@ -434,12 +504,12 @@ class EngineCore {
      */
     async bootstrap() {
         if (!this._skipBootstrap) {
-            this.logInfo(I18n.formatMessage("engineCore.bootstrapStarted"));
+            this.logInfo(I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.bootstrapStarted`));
             // First bootstrap the components.
             for (const instance of this._context.componentInstances) {
                 if (Is.function(instance.component.bootstrap)) {
                     const instanceName = this.getInstanceName(instance);
-                    this.logInfo(I18n.formatMessage("engineCore.bootstrapping", {
+                    this.logInfo(I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.bootstrapping`, {
                         element: instanceName
                     }));
                     const componentState = this._context.state.componentStates[instanceName] ?? {};
@@ -447,7 +517,7 @@ class EngineCore {
                     const bootstrapSuccess = await instance.component.bootstrap(this._loggerTypeName, componentState);
                     // If the bootstrap method failed then throw an error
                     if (!bootstrapSuccess) {
-                        throw new GeneralError(this.CLASS_NAME, "bootstrapFailed", {
+                        throw new GeneralError(EngineCore._CLASS_NAME, "bootstrapFailed", {
                             component: `${instance.component.CLASS_NAME}:${instance.instanceType}`
                         });
                     }
@@ -461,7 +531,7 @@ class EngineCore {
             if (Is.function(this._customBootstrap)) {
                 await this._customBootstrap(this, this._context);
             }
-            this.logInfo(I18n.formatMessage("engineCore.bootstrapComplete"));
+            this.logInfo(I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.bootstrapComplete`));
         }
     }
     /**

package/dist/types/engineCore.d.ts

@@ -9,10 +9,6 @@ export declare class EngineCore<C extends IEngineCoreConfig = IEngineCoreConfig,
      * Name for the engine logger.
      */
     static readonly LOGGER_TYPE_NAME: string;
-    /**
-     * Runtime name for the class.
-     */
-    readonly CLASS_NAME: string;
     /**
      * The core context.
      */
@@ -61,12 +57,30 @@ export declare class EngineCore<C extends IEngineCoreConfig = IEngineCoreConfig,
      */
     getState(): S;
     /**
-     * Get the types for the component.
-     * @returns The default types.
+     * Get all the registered instances.
+     * @returns The registered instances.
      */
-    getDefaultTypes(): {
-        [type: string]: string;
+    getRegisteredInstances(): {
+        [name: string]: {
+            type: string;
+            features?: string[];
+        }[];
     };
+    /**
+     * Get the registered instance type for the component/connector.
+     * @param componentConnectorType The type of the component/connector.
+     * @param features The requested features of the component, if not specified the default entry will be retrieved.
+     * @returns The instance type matching the criteria if one is registered.
+     * @throws If a matching instance was not found.
+     */
+    getRegisteredInstanceType(componentConnectorType: string, features?: string[]): string;
+    /**
+     * Get the registered instance type for the component/connector if it exists.
+     * @param componentConnectorType The type of the component/connector.
+     * @param features The requested features of the component, if not specified the default entry will be retrieved.
+     * @returns The instance type matching the criteria if one is registered.
+     */
+    getRegisteredInstanceTypeOptional(componentConnectorType: string, features?: string[]): string | undefined;
     /**
      * Get the data required to create a clone of the engine.
      * @returns The clone data.

package/docs/changelog.md

@@ -1,5 +1,33 @@
 # @twin.org/engine-core - Changelog
 
+## [0.0.2-next.5](https://github.com/twinfoundation/engine/compare/engine-core-v0.0.2-next.4...engine-core-v0.0.2-next.5) (2025-08-14)
+
+
+### Features
+
+* add synchronised storage support ([5142e34](https://github.com/twinfoundation/engine/commit/5142e3488f09195cf9f48a9c6c6d1014231a4c2c))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/engine-models bumped from 0.0.2-next.4 to 0.0.2-next.5
+
+## [0.0.2-next.4](https://github.com/twinfoundation/engine/compare/engine-core-v0.0.2-next.3...engine-core-v0.0.2-next.4) (2025-07-25)
+
+
+### Features
+
+* add default logging component for web server ([8ad94f0](https://github.com/twinfoundation/engine/commit/8ad94f0d2d9a5241a8854b1e59fb9a55ce310142))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/engine-models bumped from 0.0.2-next.3 to 0.0.2-next.4
+
 ## [0.0.2-next.3](https://github.com/twinfoundation/engine/compare/engine-core-v0.0.2-next.2...engine-core-v0.0.2-next.3) (2025-07-24)
 
 

package/docs/reference/classes/EngineCore.md

@@ -46,14 +46,6 @@ Name for the engine logger.
 
 ***
 
-### CLASS\_NAME
-
-> `readonly` **CLASS\_NAME**: `string`
-
-Runtime name for the class.
-
-***
-
 ### \_context
 
 > `protected` **\_context**: `IEngineCoreContext`\<`C`, `S`\>
@@ -224,21 +216,89 @@ The state of the engine.
 
 ***
 
-### getDefaultTypes()
+### getRegisteredInstances()
 
-> **getDefaultTypes**(): `object`
+> **getRegisteredInstances**(): `object`
 
-Get the types for the component.
+Get all the registered instances.
 
 #### Returns
 
 `object`
 
-The default types.
+The registered instances.
+
+#### Implementation of
+
+`IEngineCore.getRegisteredInstances`
+
+***
+
+### getRegisteredInstanceType()
+
+> **getRegisteredInstanceType**(`componentConnectorType`, `features?`): `string`
+
+Get the registered instance type for the component/connector.
+
+#### Parameters
+
+##### componentConnectorType
+
+`string`
+
+The type of the component/connector.
+
+##### features?
+
+`string`[]
+
+The requested features of the component, if not specified the default entry will be retrieved.
+
+#### Returns
+
+`string`
+
+The instance type matching the criteria if one is registered.
+
+#### Throws
+
+If a matching instance was not found.
+
+#### Implementation of
+
+`IEngineCore.getRegisteredInstanceType`
+
+***
+
+### getRegisteredInstanceTypeOptional()
+
+> **getRegisteredInstanceTypeOptional**(`componentConnectorType`, `features?`): `undefined` \| `string`
+
+Get the registered instance type for the component/connector if it exists.
+
+#### Parameters
+
+##### componentConnectorType
+
+`string`
+
+The type of the component/connector.
+
+##### features?
+
+`string`[]
+
+The requested features of the component, if not specified the default entry will be retrieved.
+
+#### Returns
+
+`undefined` \| `string`
+
+The instance type matching the criteria if one is registered.
 
 #### Implementation of
 
-`IEngineCore.getDefaultTypes`
+`IEngineCore.getRegisteredInstanceTypeOptional`
 
 ***
 

package/locales/en.json

@@ -6,7 +6,8 @@
 			"entityStorageCustomMissing": "Entity storage custom \"{typeCustom}\" missing for component \"{storageName}\"",
 			"entityStorageMissing": "Entity storage configuration missing for component \"{storageName}\"",
 			"bootstrapFailed": "Bootstrap failed for component \"{component}\", please check the logs for more information",
-			"componentStopFailed": "Failed to stop component \"{component}\""
+			"componentStopFailed": "Failed to stop component \"{component}\"",
+			"instanceTypeNotFound": "Instance type not found for \"{type}\" with features \"{features}\""
 		},
 		"fileStateStorage": {
 			"failedLoading": "Failed to load file state storage from \"{filename}\"",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/engine-core",
-	"version": "0.0.2-next.3",
+	"version": "0.0.2-next.5",
 	"description": "Engine core.",
 	"repository": {
 		"type": "git",
@@ -17,10 +17,11 @@
 		"@twin.org/core": "next",
 		"@twin.org/crypto": "next",
 		"@twin.org/data-core": "next",
-		"@twin.org/engine-models": "0.0.2-next.3",
+		"@twin.org/engine-models": "0.0.2-next.5",
 		"@twin.org/entity": "next",
 		"@twin.org/logging-connector-console": "next",
 		"@twin.org/logging-models": "next",
+		"@twin.org/logging-service": "next",
 		"@twin.org/modules": "next",
 		"@twin.org/nameof": "next"
 	},