@twin.org/engine-core 0.0.2-next.7 → 0.0.2-next.9

package/dist/cjs/index.cjs

@@ -1,5 +1,6 @@
 'use strict';
 
+var node_worker_threads = require('node:worker_threads');
 var core = require('@twin.org/core');
 var entity = require('@twin.org/entity');
 var loggingConnectorConsole = require('@twin.org/logging-connector-console');
@@ -117,6 +118,11 @@ class EngineCore {
      * @internal
      */
     _isStarted;
+    /**
+     * Is the engine a clone.
+     * @internal
+     */
+    _isClone;
     /**
      * Add type initialisers to the engine.
      * @internal
@@ -151,6 +157,7 @@ class EngineCore {
         };
         this._stateStorage = options.stateStorage;
         this._isStarted = false;
+        this._isClone = false;
         if (core.Is.function(this._populateTypeInitialisers)) {
             this._populateTypeInitialisers(this, this._context);
         }
@@ -244,6 +251,27 @@ class EngineCore {
         this.logInfo(core.I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.componentsStopped`));
         this.logInfo(core.I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.stopped`));
     }
+    /**
+     * Is the engine started.
+     * @returns True if the engine is started.
+     */
+    isStarted() {
+        return this._isStarted;
+    }
+    /**
+     * Is this the primary engine instance.
+     * @returns True if the engine is the primary instance.
+     */
+    isPrimary() {
+        return node_worker_threads.isMainThread && !this._isClone;
+    }
+    /**
+     * Is this engine instance a clone.
+     * @returns True if the engine instance is a clone.
+     */
+    isClone() {
+        return this._isClone;
+    }
     /**
      * Log info.
      * @param message The message to log.
@@ -364,6 +392,7 @@ class EngineCore {
         core.Guards.array(EngineCore._CLASS_NAME, "cloneData.typeInitialisers", cloneData.typeInitialisers);
         this._loggerTypeName = cloneData.loggerTypeName;
         this._skipBootstrap = true;
+        this._isClone = true;
         if (silent ?? false) {
             cloneData.config.silent = true;
         }

package/dist/esm/index.mjs

@@ -1,3 +1,4 @@
+import { isMainThread } from 'node:worker_threads';
 import { I18n, StringHelper, Is, BaseError, GeneralError, ErrorHelper, Guards, ComponentFactory } from '@twin.org/core';
 import { EntitySchemaFactory } from '@twin.org/entity';
 import { ConsoleLoggingConnector } from '@twin.org/logging-connector-console';
@@ -115,6 +116,11 @@ class EngineCore {
      * @internal
      */
     _isStarted;
+    /**
+     * Is the engine a clone.
+     * @internal
+     */
+    _isClone;
     /**
      * Add type initialisers to the engine.
      * @internal
@@ -149,6 +155,7 @@ class EngineCore {
         };
         this._stateStorage = options.stateStorage;
         this._isStarted = false;
+        this._isClone = false;
         if (Is.function(this._populateTypeInitialisers)) {
             this._populateTypeInitialisers(this, this._context);
         }
@@ -242,6 +249,27 @@ class EngineCore {
         this.logInfo(I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.componentsStopped`));
         this.logInfo(I18n.formatMessage(`${EngineCore._CLASS_NAME_CAMEL_CASE}.stopped`));
     }
+    /**
+     * Is the engine started.
+     * @returns True if the engine is started.
+     */
+    isStarted() {
+        return this._isStarted;
+    }
+    /**
+     * Is this the primary engine instance.
+     * @returns True if the engine is the primary instance.
+     */
+    isPrimary() {
+        return isMainThread && !this._isClone;
+    }
+    /**
+     * Is this engine instance a clone.
+     * @returns True if the engine instance is a clone.
+     */
+    isClone() {
+        return this._isClone;
+    }
     /**
      * Log info.
      * @param message The message to log.
@@ -362,6 +390,7 @@ class EngineCore {
         Guards.array(EngineCore._CLASS_NAME, "cloneData.typeInitialisers", cloneData.typeInitialisers);
         this._loggerTypeName = cloneData.loggerTypeName;
         this._skipBootstrap = true;
+        this._isClone = true;
         if (silent ?? false) {
             cloneData.config.silent = true;
         }

package/dist/types/engineCore.d.ts

@@ -36,6 +36,21 @@ export declare class EngineCore<C extends IEngineCoreConfig = IEngineCoreConfig,
      * @returns Nothing.
      */
     stop(): Promise<void>;
+    /**
+     * Is the engine started.
+     * @returns True if the engine is started.
+     */
+    isStarted(): boolean;
+    /**
+     * Is this the primary engine instance.
+     * @returns True if the engine is the primary instance.
+     */
+    isPrimary(): boolean;
+    /**
+     * Is this engine instance a clone.
+     * @returns True if the engine instance is a clone.
+     */
+    isClone(): boolean;
     /**
      * Log info.
      * @param message The message to log.

package/docs/changelog.md

@@ -1,5 +1,33 @@
 # @twin.org/engine-core - Changelog
 
+## [0.0.2-next.9](https://github.com/twinfoundation/engine/compare/engine-core-v0.0.2-next.8...engine-core-v0.0.2-next.9) (2025-08-25)
+
+
+### Features
+
+* add isPrimary and isClone methods ([a7c63e9](https://github.com/twinfoundation/engine/commit/a7c63e97f54c95b104cc81e66d3fa42c6607bdc1))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/engine-models bumped from 0.0.2-next.8 to 0.0.2-next.9
+
+## [0.0.2-next.8](https://github.com/twinfoundation/engine/compare/engine-core-v0.0.2-next.7...engine-core-v0.0.2-next.8) (2025-08-22)
+
+
+### Miscellaneous Chores
+
+* **engine-core:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/engine-models bumped from 0.0.2-next.7 to 0.0.2-next.8
+
 ## [0.0.2-next.7](https://github.com/twinfoundation/engine/compare/engine-core-v0.0.2-next.6...engine-core-v0.0.2-next.7) (2025-08-22)
 
 

package/docs/reference/classes/EngineCore.md

@@ -132,6 +132,60 @@ Nothing.
 
 ***
 
+### isStarted()
+
+> **isStarted**(): `boolean`
+
+Is the engine started.
+
+#### Returns
+
+`boolean`
+
+True if the engine is started.
+
+#### Implementation of
+
+`IEngineCore.isStarted`
+
+***
+
+### isPrimary()
+
+> **isPrimary**(): `boolean`
+
+Is this the primary engine instance.
+
+#### Returns
+
+`boolean`
+
+True if the engine is the primary instance.
+
+#### Implementation of
+
+`IEngineCore.isPrimary`
+
+***
+
+### isClone()
+
+> **isClone**(): `boolean`
+
+Is this engine instance a clone.
+
+#### Returns
+
+`boolean`
+
+True if the engine instance is a clone.
+
+#### Implementation of
+
+`IEngineCore.isClone`
+
+***
+
 ### logInfo()
 
 > **logInfo**(`message`): `void`

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/engine-core",
-	"version": "0.0.2-next.7",
+	"version": "0.0.2-next.9",
 	"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.7",
+		"@twin.org/engine-models": "0.0.2-next.9",
 		"@twin.org/entity": "next",
 		"@twin.org/logging-connector-console": "next",
 		"@twin.org/logging-models": "next",