@twin.org/engine-core 0.0.2-next.4 → 0.0.2-next.6

package/dist/cjs/index.cjs

@@ -73,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.
      */
@@ -87,10 +93,10 @@ class EngineCore {
      */
     _stateStorage;
     /**
-     * The logging connector for the engine.
+     * The logging component for the engine.
      * @internal
      */
-    _engineLoggingConnector;
+    _engineLoggingComponent;
     /**
      * Skip the bootstrap process.
      * @internal
@@ -138,7 +144,7 @@ class EngineCore {
         this._typeInitialisers = [];
         this._context = {
             config: options.config,
-            defaultTypes: {},
+            registeredInstances: {},
             componentInstances: [],
             state: { componentStates: {} },
             stateDirty: false
@@ -175,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 {
@@ -187,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] ?? {};
@@ -203,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) {
@@ -224,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)) {
@@ -240,23 +248,23 @@ 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.
      * @param message The message to log.
      */
     logInfo(message) {
-        this._engineLoggingConnector?.log({
-            source: this.CLASS_NAME,
+        this._engineLoggingComponent?.log({
+            source: EngineCore._CLASS_NAME,
             level: "info",
             message
         });
@@ -274,8 +282,8 @@ class EngineCore {
             if (this._context.config.debug && core.Is.stringValue(formattedError.stack)) {
                 message += `\n${formattedError.stack}`;
             }
-            this._engineLoggingConnector?.log({
-                source: this.CLASS_NAME,
+            this._engineLoggingComponent?.log({
+                source: EngineCore._CLASS_NAME,
                 level: "error",
                 message
             });
@@ -296,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.
@@ -327,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) {
@@ -338,7 +383,7 @@ class EngineCore {
         }
         this._context = {
             config: cloneData.config,
-            defaultTypes: {},
+            registeredInstances: {},
             componentInstances: [],
             state: { componentStates: {} },
             stateDirty: false
@@ -361,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
+                        });
+                    }
                 }
             }
         }
@@ -387,13 +443,21 @@ class EngineCore {
             component: engineLoggerConnector
         });
         loggingModels.LoggingConnectorFactory.register(this._loggerTypeName, () => engineLoggerConnector);
-        this._engineLoggingConnector = engineLoggerConnector;
-        this._context.defaultTypes.loggingConnector = this._loggerTypeName;
+        this._context.registeredInstances.loggingConnector = [
+            {
+                type: this._loggerTypeName
+            }
+        ];
         const engineLoggerComponent = new loggingService.LoggingService({
             loggingConnectorType: this._loggerTypeName
         });
+        this._engineLoggingComponent = engineLoggerComponent;
         core.ComponentFactory.register("logging-service", () => engineLoggerComponent);
-        this._context.defaultTypes.loggingComponent = "logging-service";
+        this._context.registeredInstances.loggingComponent = [
+            {
+                type: "logging-service"
+            }
+        ];
     }
     /**
      * Load the state.
@@ -442,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] ?? {};
@@ -455,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}`
                         });
                     }
@@ -469,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

@@ -71,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.
      */
@@ -85,10 +91,10 @@ class EngineCore {
      */
     _stateStorage;
     /**
-     * The logging connector for the engine.
+     * The logging component for the engine.
      * @internal
      */
-    _engineLoggingConnector;
+    _engineLoggingComponent;
     /**
      * Skip the bootstrap process.
      * @internal
@@ -136,7 +142,7 @@ class EngineCore {
         this._typeInitialisers = [];
         this._context = {
             config: options.config,
-            defaultTypes: {},
+            registeredInstances: {},
             componentInstances: [],
             state: { componentStates: {} },
             stateDirty: false
@@ -173,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 {
@@ -185,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] ?? {};
@@ -201,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) {
@@ -222,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)) {
@@ -238,23 +246,23 @@ 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.
      * @param message The message to log.
      */
     logInfo(message) {
-        this._engineLoggingConnector?.log({
-            source: this.CLASS_NAME,
+        this._engineLoggingComponent?.log({
+            source: EngineCore._CLASS_NAME,
             level: "info",
             message
         });
@@ -272,8 +280,8 @@ class EngineCore {
             if (this._context.config.debug && Is.stringValue(formattedError.stack)) {
                 message += `\n${formattedError.stack}`;
             }
-            this._engineLoggingConnector?.log({
-                source: this.CLASS_NAME,
+            this._engineLoggingComponent?.log({
+                source: EngineCore._CLASS_NAME,
                 level: "error",
                 message
             });
@@ -294,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.
@@ -325,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) {
@@ -336,7 +381,7 @@ class EngineCore {
         }
         this._context = {
             config: cloneData.config,
-            defaultTypes: {},
+            registeredInstances: {},
             componentInstances: [],
             state: { componentStates: {} },
             stateDirty: false
@@ -359,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
+                        });
+                    }
                 }
             }
         }
@@ -385,13 +441,21 @@ class EngineCore {
             component: engineLoggerConnector
         });
         LoggingConnectorFactory.register(this._loggerTypeName, () => engineLoggerConnector);
-        this._engineLoggingConnector = engineLoggerConnector;
-        this._context.defaultTypes.loggingConnector = this._loggerTypeName;
+        this._context.registeredInstances.loggingConnector = [
+            {
+                type: this._loggerTypeName
+            }
+        ];
         const engineLoggerComponent = new LoggingService({
             loggingConnectorType: this._loggerTypeName
         });
+        this._engineLoggingComponent = engineLoggerComponent;
         ComponentFactory.register("logging-service", () => engineLoggerComponent);
-        this._context.defaultTypes.loggingComponent = "logging-service";
+        this._context.registeredInstances.loggingComponent = [
+            {
+                type: "logging-service"
+            }
+        ];
     }
     /**
      * Load the state.
@@ -440,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] ?? {};
@@ -453,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}`
                         });
                     }
@@ -467,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.6](https://github.com/twinfoundation/engine/compare/engine-core-v0.0.2-next.5...engine-core-v0.0.2-next.6) (2025-08-21)
+
+
+### Features
+
+* update framework core ([acc0f8d](https://github.com/twinfoundation/engine/commit/acc0f8d455a4b8ec47f1da643139fa0f07775fa6))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/engine-models bumped from 0.0.2-next.5 to 0.0.2-next.6
+
+## [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)
 
 

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.4",
+	"version": "0.0.2-next.6",
 	"description": "Engine core.",
 	"repository": {
 		"type": "git",
@@ -17,7 +17,7 @@
 		"@twin.org/core": "next",
 		"@twin.org/crypto": "next",
 		"@twin.org/data-core": "next",
-		"@twin.org/engine-models": "0.0.2-next.4",
+		"@twin.org/engine-models": "0.0.2-next.6",
 		"@twin.org/entity": "next",
 		"@twin.org/logging-connector-console": "next",
 		"@twin.org/logging-models": "next",