@twin.org/engine-core 0.0.3-next.3 → 0.0.3-next.31

package/docs/reference/classes/EngineCore.md

@@ -38,7 +38,7 @@ The options for the engine.
 
 ## Properties
 
-### LOGGING\_COMPONENT\_TYPE\_NAME
+### LOGGING\_COMPONENT\_TYPE\_NAME {#logging_component_type_name}
 
 > `readonly` `static` **LOGGING\_COMPONENT\_TYPE\_NAME**: `string` = `"engine-logging-service"`
 
@@ -46,7 +46,7 @@ Name for the engine logger component, used for direct console logging.
 
 ***
 
-### LOGGING\_CONNECTOR\_TYPE\_NAME
+### LOGGING\_CONNECTOR\_TYPE\_NAME {#logging_connector_type_name}
 
 > `readonly` `static` **LOGGING\_CONNECTOR\_TYPE\_NAME**: `string` = `"engine-logging-connector"`
 
@@ -54,7 +54,7 @@ Name for the engine logger connector, used for direct console logging.
 
 ***
 
-### CLASS\_NAME
+### CLASS\_NAME {#class_name}
 
 > `readonly` `static` **CLASS\_NAME**: `string`
 
@@ -62,7 +62,7 @@ Runtime name for the class.
 
 ***
 
-### \_context
+### \_context {#_context}
 
 > `protected` **\_context**: `IEngineCoreContext`\<`C`, `S`\>
 
@@ -70,23 +70,31 @@ The core context.
 
 ***
 
-### \_contextIdKeys
+### \_contextIdKeys {#_contextidkeys}
 
-> `protected` `readonly` **\_contextIdKeys**: `string`[]
+> `protected` `readonly` **\_contextIdKeys**: `object`[]
 
 The context ID keys.
 
+#### key
+
+> **key**: `string`
+
+#### componentFeatures
+
+> **componentFeatures**: `string`[]
+
 ***
 
-### \_contextIds?
+### \_contextIds? {#_contextids}
 
-> `protected` `optional` **\_contextIds**: `IContextIds`
+> `protected` `optional` **\_contextIds?**: `IContextIds`
 
 The context IDs.
 
 ## Methods
 
-### addTypeInitialiser()
+### addTypeInitialiser() {#addtypeinitialiser}
 
 > **addTypeInitialiser**(`type`, `module`, `method`): `void`
 
@@ -122,9 +130,9 @@ The name of the method to call.
 
 ***
 
-### getTypeConfig()
+### getTypeConfig() {#gettypeconfig}
 
-> **getTypeConfig**(`type`): `undefined` \| `IEngineCoreTypeConfig`[]
+> **getTypeConfig**(`type`): `IEngineCoreTypeConfig`[] \| `undefined`
 
 Get the type config for a specific type.
 
@@ -138,7 +146,7 @@ The type to get the config for.
 
 #### Returns
 
-`undefined` \| `IEngineCoreTypeConfig`[]
+`IEngineCoreTypeConfig`[] \| `undefined`
 
 The type config or undefined if not found.
 
@@ -148,9 +156,9 @@ The type config or undefined if not found.
 
 ***
 
-### addContextIdKey()
+### addContextIdKey() {#addcontextidkey}
 
-> **addContextIdKey**(`key`): `void`
+> **addContextIdKey**(`key`, `componentFeatures`): `void`
 
 Add a context ID key to the engine.
 
@@ -162,6 +170,12 @@ Add a context ID key to the engine.
 
 The context ID key.
 
+##### componentFeatures
+
+`string`[]
+
+The component features for the context ID handler.
+
 #### Returns
 
 `void`
@@ -172,7 +186,7 @@ The context ID key.
 
 ***
 
-### getContextIdKeys()
+### getContextIdKeys() {#getcontextidkeys}
 
 > **getContextIdKeys**(): `string`[]
 
@@ -190,7 +204,7 @@ The context IDs keys.
 
 ***
 
-### addContextId()
+### addContextId() {#addcontextid}
 
 > **addContextId**(`key`, `value`): `void`
 
@@ -220,15 +234,15 @@ The context ID value.
 
 ***
 
-### getContextIds()
+### getContextIds() {#getcontextids}
 
-> **getContextIds**(): `undefined` \| `IContextIds`
+> **getContextIds**(): `IContextIds` \| `undefined`
 
 Get the context IDs for the engine.
 
 #### Returns
 
-`undefined` \| `IContextIds`
+`IContextIds` \| `undefined`
 
 The context IDs or undefined if none are set.
 
@@ -238,17 +252,25 @@ The context IDs or undefined if none are set.
 
 ***
 
-### start()
+### start() {#start}
 
-> **start**(): `Promise`\<`boolean`\>
+> **start**(`skipComponentStart?`): `Promise`\<`void`\>
 
 Start the engine core.
 
+#### Parameters
+
+##### skipComponentStart?
+
+`boolean`
+
+Should the component start be skipped.
+
 #### Returns
 
-`Promise`\<`boolean`\>
+`Promise`\<`void`\>
 
-True if the start was successful.
+Nothing.
 
 #### Implementation of
 
@@ -256,7 +278,7 @@ True if the start was successful.
 
 ***
 
-### stop()
+### stop() {#stop}
 
 > **stop**(): `Promise`\<`void`\>
 
@@ -274,7 +296,7 @@ Nothing.
 
 ***
 
-### isStarted()
+### isStarted() {#isstarted}
 
 > **isStarted**(): `boolean`
 
@@ -292,7 +314,7 @@ True if the engine is started.
 
 ***
 
-### isPrimary()
+### isPrimary() {#isprimary}
 
 > **isPrimary**(): `boolean`
 
@@ -310,7 +332,7 @@ True if the engine is the primary instance.
 
 ***
 
-### isClone()
+### isClone() {#isclone}
 
 > **isClone**(): `boolean`
 
@@ -328,7 +350,7 @@ True if the engine instance is a clone.
 
 ***
 
-### logInfo()
+### logInfo() {#loginfo}
 
 > **logInfo**(`message`): `Promise`\<`void`\>
 
@@ -352,7 +374,7 @@ The message to log.
 
 ***
 
-### logError()
+### logError() {#logerror}
 
 > **logError**(`error`): `Promise`\<`void`\>
 
@@ -376,7 +398,7 @@ The error to log.
 
 ***
 
-### getConfig()
+### getConfig() {#getconfig}
 
 > **getConfig**(): `C`
 
@@ -394,7 +416,7 @@ The config for the engine.
 
 ***
 
-### getState()
+### getState() {#getstate}
 
 > **getState**(): `S`
 
@@ -412,7 +434,23 @@ The state of the engine.
 
 ***
 
-### getRegisteredInstances()
+### setStateDirty() {#setstatedirty}
+
+> **setStateDirty**(): `void`
+
+Set the state to dirty so it gets saved.
+
+#### Returns
+
+`void`
+
+#### Implementation of
+
+`IEngineCore.setStateDirty`
+
+***
+
+### getRegisteredInstances() {#getregisteredinstances}
 
 > **getRegisteredInstances**(): `object`
 
@@ -430,7 +468,7 @@ The registered instances.
 
 ***
 
-### getRegisteredInstanceType()
+### getRegisteredInstanceType() {#getregisteredinstancetype}
 
 > **getRegisteredInstanceType**(`componentConnectorType`, `features?`): `string`
 
@@ -466,9 +504,9 @@ If a matching instance was not found.
 
 ***
 
-### getRegisteredInstanceTypeOptional()
+### getRegisteredInstanceTypeOptional() {#getregisteredinstancetypeoptional}
 
-> **getRegisteredInstanceTypeOptional**(`componentConnectorType`, `features?`): `undefined` \| `string`
+> **getRegisteredInstanceTypeOptional**(`componentConnectorType`, `features?`): `string` \| `undefined`
 
 Get the registered instance type for the component/connector if it exists.
 
@@ -488,7 +526,7 @@ The requested features of the component, if not specified the default entry will
 
 #### Returns
 
-`undefined` \| `string`
+`string` \| `undefined`
 
 The instance type matching the criteria if one is registered.
 
@@ -498,7 +536,7 @@ The instance type matching the criteria if one is registered.
 
 ***
 
-### getCloneData()
+### getCloneData() {#getclonedata}
 
 > **getCloneData**(): `IEngineCoreClone`\<`C`, `S`\>
 
@@ -516,9 +554,9 @@ The clone data.
 
 ***
 
-### populateClone()
+### populateClone() {#populateclone}
 
-> **populateClone**(`cloneData`, `silent?`): `void`
+> **populateClone**(`cloneData`, `contextIds?`, `silent?`): `void`
 
 Populate the engine from the clone data.
 
@@ -530,6 +568,12 @@ Populate the engine from the clone data.
 
 The clone data to populate from.
 
+##### contextIds?
+
+`IContextIds`
+
+The context IDs to use for the clone.
+
 ##### silent?
 
 `boolean`

package/docs/reference/classes/EngineModuleHelper.md

@@ -14,7 +14,7 @@ Helper class for engine modules.
 
 ## Properties
 
-### CLASS\_NAME
+### CLASS\_NAME {#class_name}
 
 > `readonly` `static` **CLASS\_NAME**: `string`
 
@@ -22,7 +22,7 @@ Runtime name for the class.
 
 ## Methods
 
-### loadComponent()
+### loadComponent() {#loadcomponent}
 
 > `static` **loadComponent**\<`T`\>(`engineCore`, `engineModuleConfig`): `Promise`\<`T`\>
 

package/docs/reference/classes/FileStateStorage.md

@@ -16,7 +16,7 @@ Store state in a file.
 
 ### Constructor
 
-> **new FileStateStorage**\<`S`\>(`filename`, `readonlyMode`): `FileStateStorage`\<`S`\>
+> **new FileStateStorage**\<`S`\>(`filename`, `readonlyMode?`): `FileStateStorage`\<`S`\>
 
 Create a new instance of FileStateStorage.
 
@@ -28,7 +28,7 @@ Create a new instance of FileStateStorage.
 
 The filename to store the state.
 
-##### readonlyMode
+##### readonlyMode?
 
 `boolean` = `false`
 
@@ -40,7 +40,7 @@ Whether the file is in read-only mode.
 
 ## Properties
 
-### CLASS\_NAME
+### CLASS\_NAME {#class_name}
 
 > `readonly` `static` **CLASS\_NAME**: `string`
 
@@ -48,9 +48,9 @@ Runtime name for the class.
 
 ## Methods
 
-### load()
+### load() {#load}
 
-> **load**(`engineCore`): `Promise`\<`undefined` \| `S`\>
+> **load**(`engineCore`): `Promise`\<`S` \| `undefined`\>
 
 Method for loading the state.
 
@@ -64,7 +64,7 @@ The engine core to load the state for.
 
 #### Returns
 
-`Promise`\<`undefined` \| `S`\>
+`Promise`\<`S` \| `undefined`\>
 
 The state of the engine or undefined if it doesn't exist.
 
@@ -74,7 +74,7 @@ The state of the engine or undefined if it doesn't exist.
 
 ***
 
-### save()
+### save() {#save}
 
 > **save**(`engineCore`, `state`): `Promise`\<`void`\>
 

package/docs/reference/classes/MemoryStateStorage.md

@@ -16,13 +16,13 @@ Store state in memory.
 
 ### Constructor
 
-> **new MemoryStateStorage**\<`S`\>(`readonlyMode`, `state?`): `MemoryStateStorage`\<`S`\>
+> **new MemoryStateStorage**\<`S`\>(`readonlyMode?`, `state?`): `MemoryStateStorage`\<`S`\>
 
 Create a new instance of MemoryStateStorage.
 
 #### Parameters
 
-##### readonlyMode
+##### readonlyMode?
 
 `boolean` = `false`
 
@@ -40,7 +40,7 @@ The initial state.
 
 ## Properties
 
-### CLASS\_NAME
+### CLASS\_NAME {#class_name}
 
 > `readonly` `static` **CLASS\_NAME**: `string`
 
@@ -48,9 +48,9 @@ Runtime name for the class.
 
 ## Methods
 
-### load()
+### load() {#load}
 
-> **load**(`engineCore`): `Promise`\<`undefined` \| `S`\>
+> **load**(`engineCore`): `Promise`\<`S` \| `undefined`\>
 
 Method for loading the state.
 
@@ -64,7 +64,7 @@ The engine core to load the state for.
 
 #### Returns
 
-`Promise`\<`undefined` \| `S`\>
+`Promise`\<`S` \| `undefined`\>
 
 The state of the engine or undefined if it doesn't exist.
 
@@ -74,7 +74,7 @@ The state of the engine or undefined if it doesn't exist.
 
 ***
 
-### save()
+### save() {#save}
 
 > **save**(`engineCore`, `state`): `Promise`\<`void`\>
 

package/docs/reference/interfaces/IEngineCoreOptions.md

@@ -14,33 +14,33 @@ The options for creating engine core.
 
 ## Properties
 
-### config?
+### config? {#config}
 
-> `optional` **config**: `C`
+> `optional` **config?**: `C`
 
 The engine core config.
 
 ***
 
-### stateStorage?
+### stateStorage? {#statestorage}
 
-> `optional` **stateStorage**: `IEngineStateStorage`\<`S`\>
+> `optional` **stateStorage?**: `IEngineStateStorage`\<`S`\>
 
 The state storage component.
 
 ***
 
-### skipBootstrap?
+### skipBootstrap? {#skipbootstrap}
 
-> `optional` **skipBootstrap**: `boolean`
+> `optional` **skipBootstrap?**: `boolean`
 
 Skip the bootstrap process, useful for additional engine instances.
 
 ***
 
-### populateTypeInitialisers()?
+### populateTypeInitialisers? {#populatetypeinitialisers}
 
-> `optional` **populateTypeInitialisers**: (`engineCore`, `context`) => `void`
+> `optional` **populateTypeInitialisers?**: (`engineCore`, `context`) => `void`
 
 Populate the type initialisers for the engine.
 
@@ -60,9 +60,9 @@ Populate the type initialisers for the engine.
 
 ***
 
-### customBootstrap()?
+### customBootstrap? {#custombootstrap}
 
-> `optional` **customBootstrap**: (`engineCore`, `context`) => `Promise`\<`void`\>
+> `optional` **customBootstrap?**: (`engineCore`, `context`) => `Promise`\<`void`\>
 
 Custom bootstrap method for the engine.
 

package/locales/en.json

@@ -5,7 +5,8 @@
 			"bootstrapFailed": "Failed to bootstrap component type \"{className}\" with instance type \"{instanceType}\"",
 			"componentStartFailed": "Failed to start component type \"{className}\" with instance type \"{instanceType}\"",
 			"componentStopFailed": "Failed to stop component type \"{className}\" with instance type \"{instanceType}\"",
-			"instanceTypeNotFound": "Instance type not found for \"{type}\" with features \"{features}\""
+			"instanceTypeNotFound": "Instance type not found for \"{type}\"",
+			"instanceTypeNotFoundWithFeatures": "Instance type not found for \"{type}\" with features \"{features}\""
 		},
 		"fileStateStorage": {
 			"failedLoading": "Failed to load file state storage from \"{filename}\"",

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@twin.org/engine-core",
-	"version": "0.0.3-next.3",
-	"description": "Engine core.",
+	"version": "0.0.3-next.31",
+	"description": "Core runtime lifecycle and state orchestration for engine instances.",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/twinfoundation/engine.git",
@@ -18,7 +18,7 @@
 		"@twin.org/core": "next",
 		"@twin.org/crypto": "next",
 		"@twin.org/data-core": "next",
-		"@twin.org/engine-models": "0.0.3-next.3",
+		"@twin.org/engine-models": "0.0.3-next.31",
 		"@twin.org/entity": "next",
 		"@twin.org/logging-connector-console": "next",
 		"@twin.org/logging-models": "next",