@twin.org/node-core 0.9.1-next.8 → 0.9.1

package/dist/types/models/IEngineEnvironmentVariables.d.ts

@@ -38,6 +38,10 @@ export interface IEngineEnvironmentVariables {
      * Is multi-tenant support enabled, defaults to false.
      */
     tenantEnabled?: string;
+    /**
+     * Enable schema migration, defaults to true.
+     */
+    schemaMigrationEnabled?: string;
     /**
      * The type of the entity storage to create, comma separate for more than one connector.
      * values: file, memory, aws-dynamodb, azure-cosmosdb, gcp-firestoredb, scylladb, mysql, mongodb, postgresql
@@ -289,7 +293,7 @@ export interface IEngineEnvironmentVariables {
      */
     hashicorpVaultEndpoint?: string;
     /**
-     * The type of logging task connector, can be a comma separated list: console, entity-storage.
+     * The type of logging task connector, can be a comma separated list: console, entity-storage, otel, file.
      */
     loggingConnector?: string;
     /**
@@ -300,10 +304,50 @@ export interface IEngineEnvironmentVariables {
      * The batch flush interval in seconds for the logging task, how often to flush the logs when using batching, defaults to 5 seconds.
      */
     loggingBatchFlushInterval?: string;
+    /**
+     * Delete log entries older than this many minutes for the entity-storage logging connector.
+     * Set to 0 to disable age-based retention.
+     * @default 2880 (2 days)
+     */
+    loggingRetainFor?: string;
+    /**
+     * Keep at most this many log entries for the entity-storage logging connector.
+     * Set to 0 to disable count-based retention.
+     * @default 10000
+     */
+    loggingMaxEntries?: string;
+    /**
+     * How often the retention cleanup task runs in minutes for the entity-storage logging connector.
+     * Set to 0 to disable periodic cleanup.
+     * @default 5
+     */
+    loggingRetentionInterval?: string;
+    /**
+     * Maximum number of entries deleted per cleanup batch for the entity-storage logging connector.
+     * Keeping this value smaller helps avoid spikes in database load.
+     * @default 1000
+     */
+    loggingRetentionBatchSize?: string;
     /**
      * A list of components to exclude from logging, can be a comma separated list of component Class names e.g. "ComponentA,ComponentB".
      */
     loggingSilentComponents?: string;
+    /**
+     * The directory to write log files into when using the file logging connector. Required when TWIN_LOGGING_CONNECTOR includes "file".
+     */
+    loggingFileDirectory?: string;
+    /**
+     * The log filename when using the file logging connector, defaults to "app.log".
+     */
+    loggingFileFilename?: string;
+    /**
+     * The maximum log file size in bytes before rotation when using the file logging connector, defaults to 10485760 (10 MB). Set to 0 or negative to disable rotation.
+     */
+    loggingFileMaxFileSizeBytes?: string;
+    /**
+     * The number of rotated log files to retain when using the file logging connector, defaults to 5. Set to 0 or negative to keep all rotated files.
+     */
+    loggingFileMaxRetainedFiles?: string;
     /**
      * The name of the OpenTelemetry logger, only required if using open-telemetry as logging connector, defaults to twin-logging.
      */
@@ -428,6 +472,10 @@ export interface IEngineEnvironmentVariables {
      * The index of the wallet address to use, defaults to 0.
      */
     identityWalletAddressIndex?: string;
+    /**
+     * The TTL in milliseconds for caching resolved DIDs when using the IOTA identity connector. Omit to use the connector default.
+     */
+    identityDidResolutionCacheTtlMs?: string;
     /**
      * The type of identity resolver connector: entity-storage, iota.
      */
@@ -448,6 +496,14 @@ export interface IEngineEnvironmentVariables {
      * IOTA coin type.
      */
     iotaCoinType?: string;
+    /**
+     * IOTA gas budget, in nanos.
+     */
+    iotaGasBudget?: string;
+    /**
+     * IOTA gas reservation duration, in seconds.
+     */
+    iotaGasReservationDuration?: string;
     /**
      * IOTA Explorer Endpoint.
      */
@@ -524,6 +580,10 @@ export interface IEngineEnvironmentVariables {
      * Federated catalog remote endpoint, if set will use a REST client instead of local service.
      */
     federatedCatalogueRemoteEndpoint?: string;
+    /**
+     * The path prefix used by the federated catalogue REST client when forwarding requests to the remote endpoint, defaults to "federated-catalogue".
+     */
+    federatedCatalogueRestClientPathPrefix?: string;
     /**
      * The trust generators to add to the factory, comma separated list.
      */

package/docs/changelog.md

@@ -1,5 +1,65 @@
 # Changelog
 
+## [0.9.1](https://github.com/iotaledger/twin-node/compare/node-core-v0.9.1...node-core-v0.9.1) (2026-07-27)
+
+
+### Features
+
+* add auth admin component ([1661e57](https://github.com/iotaledger/twin-node/commit/1661e57a699d5cf9ebde333e3cbc3aaea89d7c9c))
+* add extend engine and server methods ([ec09c7e](https://github.com/iotaledger/twin-node/commit/ec09c7eb882d9f5797f2fd372e96cad1a3716f59))
+* add extend engine and server methods ([0136a6f](https://github.com/iotaledger/twin-node/commit/0136a6f3f4e1a82b1427ee9618b8a17c79bc7fda))
+* additional run options ([c35e5bb](https://github.com/iotaledger/twin-node/commit/c35e5bbb8a80fe6a36628d41f64585b3723d9ad7))
+* additional startup logging ([0740293](https://github.com/iotaledger/twin-node/commit/0740293b366032f2907046603abf587c9c324aff))
+* improve default options and spec ([b538721](https://github.com/iotaledger/twin-node/commit/b538721902e7f65021d2715148ba59409ccce035))
+* improve error reporting ([fcd39a1](https://github.com/iotaledger/twin-node/commit/fcd39a18da2a6ce33965a99ca5f2f36f4aba712f))
+* initial commit ([522f1e5](https://github.com/iotaledger/twin-node/commit/522f1e515348f9b1dd1eeb3170b1249e2b0b5371))
+* migrate env config from engine to node ([5da29b8](https://github.com/iotaledger/twin-node/commit/5da29b8d714495308320d237a68e84355bba2b47))
+* node app use JavaScript ([14fe08c](https://github.com/iotaledger/twin-node/commit/14fe08cb760dd885a5dac9056a4d5dbc3d61df64))
+* release to production ([6319a38](https://github.com/iotaledger/twin-node/commit/6319a38490a2c2809622f8acd170cb92bfa06942))
+* release to production ([4f44403](https://github.com/iotaledger/twin-node/commit/4f444039832edce8fae562baa7c900ccdc2181da))
+* release to production ([2d96e37](https://github.com/iotaledger/twin-node/commit/2d96e3737bd9663bc0d1171c2ff2c7f8b2ab01bb))
+* release to production ([#253](https://github.com/iotaledger/twin-node/issues/253)) ([230efd0](https://github.com/iotaledger/twin-node/commit/230efd0f99af6114e707999b4c1a83a391cc1741))
+* release to production ([#300](https://github.com/iotaledger/twin-node/issues/300)) ([4d2b09f](https://github.com/iotaledger/twin-node/commit/4d2b09f92c7815ad3fe48d54eca0972fefc782f7))
+* update dependencies ([9d25f16](https://github.com/iotaledger/twin-node/commit/9d25f16f1d554cd38f3bec28fdf7f8fff892ceaf))
+
+
+### Bug Fixes
+
+* adding a condition to verify if the password exists when bootstrapping ([6030a42](https://github.com/iotaledger/twin-node/commit/6030a42bdaf581678d96932fd0b809396bf7b8b0))
+* adding a condition to verify if the password exists when bootstrapping ([c66f396](https://github.com/iotaledger/twin-node/commit/c66f396717394161a7647d1f08b3d87729d96e96))
+* broken docs ([61479fd](https://github.com/iotaledger/twin-node/commit/61479fd618f766d22c5aafec5277e1a89e22b453))
+* pr comments [#1](https://github.com/iotaledger/twin-node/issues/1) ([66e795b](https://github.com/iotaledger/twin-node/commit/66e795b16c372ab131ec1de30085aee90e4dbbd0))
+
+## [0.9.1-next.12](https://github.com/iotaledger/twin-node/compare/node-core-v0.9.1-next.11...node-core-v0.9.1-next.12) (2026-07-27)
+
+
+### Features
+
+* update logging retention units in config ([0b9bb69](https://github.com/iotaledger/twin-node/commit/0b9bb696db0722f6b33e37e1ebd1f4d6ffbcf7cc))
+
+## [0.9.1-next.11](https://github.com/iotaledger/twin-node/compare/node-core-v0.9.1-next.10...node-core-v0.9.1-next.11) (2026-07-24)
+
+
+### Features
+
+* migration options ([#293](https://github.com/iotaledger/twin-node/issues/293)) ([91acc88](https://github.com/iotaledger/twin-node/commit/91acc881f665be0177b2e895e2810dd4d6145105))
+
+## [0.9.1-next.10](https://github.com/iotaledger/twin-node/compare/node-core-v0.9.1-next.9...node-core-v0.9.1-next.10) (2026-07-21)
+
+
+### Features
+
+* update dependencies ([64c8ea8](https://github.com/iotaledger/twin-node/commit/64c8ea8c8b5e918f7ad419c4e3b8d08faf5e3fdd))
+
+## [0.9.1-next.9](https://github.com/iotaledger/twin-node/compare/node-core-v0.9.1-next.8...node-core-v0.9.1-next.9) (2026-07-21)
+
+
+### Features
+
+* enhanced cli commands ([#288](https://github.com/iotaledger/twin-node/issues/288)) ([479fb34](https://github.com/iotaledger/twin-node/commit/479fb3448c493a134aee35b69ae39458e493a4ad))
+* expose gasBudget and gasReservationDuration as configurable env vars ([#286](https://github.com/iotaledger/twin-node/issues/286)) ([d678b27](https://github.com/iotaledger/twin-node/commit/d678b27d629930a6ce85eeab9caf89d1187c3461))
+* file logging config ([#287](https://github.com/iotaledger/twin-node/issues/287)) ([a567b25](https://github.com/iotaledger/twin-node/commit/a567b253cbb8b9af872bb0e494c013212f4f55a2))
+
 ## [0.9.1-next.8](https://github.com/iotaledger/twin-node/compare/node-core-v0.9.1-next.7...node-core-v0.9.1-next.8) (2026-07-10)
 
 

package/docs/reference/interfaces/ICliCommandDefinition.md

@@ -107,3 +107,11 @@ Indicates whether the engine needs the organization identity to be set.
 ```ts
 true
 ```
+
+***
+
+### singleTenantOnly? {#singletenantonly}
+
+> `optional` **singleTenantOnly?**: `boolean`
+
+Indicates whether this command is only available in single-tenant mode.

package/docs/reference/interfaces/IEngineEnvironmentVariables.md

@@ -73,6 +73,14 @@ Is multi-tenant support enabled, defaults to false.
 
 ***
 
+### schemaMigrationEnabled? {#schemamigrationenabled}
+
+> `optional` **schemaMigrationEnabled?**: `string`
+
+Enable schema migration, defaults to true.
+
+***
+
 ### entityStorageConnectorType? {#entitystorageconnectortype}
 
 > `optional` **entityStorageConnectorType?**: `string`
@@ -575,7 +583,7 @@ Hashicorp Vault endpoint.
 
 > `optional` **loggingConnector?**: `string`
 
-The type of logging task connector, can be a comma separated list: console, entity-storage.
+The type of logging task connector, can be a comma separated list: console, entity-storage, otel, file.
 
 ***
 
@@ -595,6 +603,66 @@ The batch flush interval in seconds for the logging task, how often to flush the
 
 ***
 
+### loggingRetainFor? {#loggingretainfor}
+
+> `optional` **loggingRetainFor?**: `string`
+
+Delete log entries older than this many minutes for the entity-storage logging connector.
+Set to 0 to disable age-based retention.
+
+#### Default
+
+```ts
+2880 (2 days)
+```
+
+***
+
+### loggingMaxEntries? {#loggingmaxentries}
+
+> `optional` **loggingMaxEntries?**: `string`
+
+Keep at most this many log entries for the entity-storage logging connector.
+Set to 0 to disable count-based retention.
+
+#### Default
+
+```ts
+10000
+```
+
+***
+
+### loggingRetentionInterval? {#loggingretentioninterval}
+
+> `optional` **loggingRetentionInterval?**: `string`
+
+How often the retention cleanup task runs in minutes for the entity-storage logging connector.
+Set to 0 to disable periodic cleanup.
+
+#### Default
+
+```ts
+5
+```
+
+***
+
+### loggingRetentionBatchSize? {#loggingretentionbatchsize}
+
+> `optional` **loggingRetentionBatchSize?**: `string`
+
+Maximum number of entries deleted per cleanup batch for the entity-storage logging connector.
+Keeping this value smaller helps avoid spikes in database load.
+
+#### Default
+
+```ts
+1000
+```
+
+***
+
 ### loggingSilentComponents? {#loggingsilentcomponents}
 
 > `optional` **loggingSilentComponents?**: `string`
@@ -603,6 +671,38 @@ A list of components to exclude from logging, can be a comma separated list of c
 
 ***
 
+### loggingFileDirectory? {#loggingfiledirectory}
+
+> `optional` **loggingFileDirectory?**: `string`
+
+The directory to write log files into when using the file logging connector. Required when TWIN_LOGGING_CONNECTOR includes "file".
+
+***
+
+### loggingFileFilename? {#loggingfilefilename}
+
+> `optional` **loggingFileFilename?**: `string`
+
+The log filename when using the file logging connector, defaults to "app.log".
+
+***
+
+### loggingFileMaxFileSizeBytes? {#loggingfilemaxfilesizebytes}
+
+> `optional` **loggingFileMaxFileSizeBytes?**: `string`
+
+The maximum log file size in bytes before rotation when using the file logging connector, defaults to 10485760 (10 MB). Set to 0 or negative to disable rotation.
+
+***
+
+### loggingFileMaxRetainedFiles? {#loggingfilemaxretainedfiles}
+
+> `optional` **loggingFileMaxRetainedFiles?**: `string`
+
+The number of rotated log files to retain when using the file logging connector, defaults to 5. Set to 0 or negative to keep all rotated files.
+
+***
+
 ### openTelemetryLoggingLoggerName? {#opentelemetryloggingloggername}
 
 > `optional` **openTelemetryLoggingLoggerName?**: `string`
@@ -851,6 +951,14 @@ The index of the wallet address to use, defaults to 0.
 
 ***
 
+### identityDidResolutionCacheTtlMs? {#identitydidresolutioncachettlms}
+
+> `optional` **identityDidResolutionCacheTtlMs?**: `string`
+
+The TTL in milliseconds for caching resolved DIDs when using the IOTA identity connector. Omit to use the connector default.
+
+***
+
 ### identityResolverConnector? {#identityresolverconnector}
 
 > `optional` **identityResolverConnector?**: `string`
@@ -891,6 +999,22 @@ IOTA coin type.
 
 ***
 
+### iotaGasBudget? {#iotagasbudget}
+
+> `optional` **iotaGasBudget?**: `string`
+
+IOTA gas budget, in nanos.
+
+***
+
+### iotaGasReservationDuration? {#iotagasreservationduration}
+
+> `optional` **iotaGasReservationDuration?**: `string`
+
+IOTA gas reservation duration, in seconds.
+
+***
+
 ### iotaExplorerEndpoint? {#iotaexplorerendpoint}
 
 > `optional` **iotaExplorerEndpoint?**: `string`
@@ -1043,6 +1167,14 @@ Federated catalog remote endpoint, if set will use a REST client instead of loca
 
 ***
 
+### federatedCatalogueRestClientPathPrefix? {#federatedcataloguerestclientpathprefix}
+
+> `optional` **federatedCatalogueRestClientPathPrefix?**: `string`
+
+The path prefix used by the federated catalogue REST client when forwarding requests to the remote endpoint, defaults to "federated-catalogue".
+
+***
+
 ### trustGenerators? {#trustgenerators}
 
 > `optional` **trustGenerators?**: `string`

package/locales/en.json

@@ -125,7 +125,8 @@
 						"optional": "optional",
 						"required": "required",
 						"default": "default",
-						"options": "options"
+						"options": "options",
+						"singleTenantOnly": "single-tenant only"
 					}
 				},
 				"bootstrap-legacy": {
@@ -880,12 +881,14 @@
 						},
 						"load-env": {
 							"description": "Comma separated list of paths to .env files to read input parameters from."
+						},
+						"output-json": {
+							"description": "Path to a .json file to store the resolved DID document."
 						}
 					},
 					"labels": {
 						"resolving": "Resolving identity",
-						"did": "DID",
-						"verificationMethods": "Verification Methods"
+						"did": "DID"
 					}
 				},
 				"org-users-list": {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/node-core",
-	"version": "0.9.1-next.8",
+	"version": "0.9.1",
 	"description": "TWIN Node Core for serving APIs using the specified configuration",
 	"repository": {
 		"type": "git",
@@ -11,35 +11,34 @@
 	"license": "Apache-2.0",
 	"type": "module",
 	"engines": {
-		"node": ">=20.0.0"
+		"node": ">=24.0.0"
 	},
 	"dependencies": {
-		"@twin.org/api-auth-entity-storage-service": "next",
-		"@twin.org/api-tenant-processor": "next",
-		"@twin.org/cli-core": "next",
-		"@twin.org/context": "next",
-		"@twin.org/core": "next",
-		"@twin.org/crypto": "next",
-		"@twin.org/dataspace-models": "next",
-		"@twin.org/engine": "next",
-		"@twin.org/engine-core": "next",
-		"@twin.org/engine-models": "next",
-		"@twin.org/engine-server": "next",
-		"@twin.org/engine-server-types": "next",
-		"@twin.org/engine-types": "next",
-		"@twin.org/entity": "next",
-		"@twin.org/entity-storage-models": "next",
-		"@twin.org/identity-models": "next",
-		"@twin.org/logging-connector-opentelemetry": "next",
-		"@twin.org/modules": "next",
-		"@twin.org/rights-management-rest-client": "next",
-		"@twin.org/standards-w3c-did": "next",
-		"@twin.org/standards-w3c-odrl": "next",
-		"@twin.org/telemetry-connector-opentelemetry": "next",
-		"@twin.org/telemetry-models": "next",
-		"@twin.org/trust-models": "next",
-		"@twin.org/vault-models": "next",
-		"@twin.org/wallet-models": "next",
+		"@twin.org/api-auth-entity-storage-service": "^0.9.1",
+		"@twin.org/api-tenant-processor": "^0.9.1",
+		"@twin.org/cli-core": "^0.9.1",
+		"@twin.org/context": "^0.9.1",
+		"@twin.org/core": "^0.9.1",
+		"@twin.org/crypto": "^0.9.1",
+		"@twin.org/dataspace-models": "^0.9.1",
+		"@twin.org/engine": "^0.9.1",
+		"@twin.org/engine-core": "^0.9.1",
+		"@twin.org/engine-models": "^0.9.1",
+		"@twin.org/engine-server": "^0.9.1",
+		"@twin.org/engine-server-types": "^0.9.1",
+		"@twin.org/engine-types": "^0.9.1",
+		"@twin.org/entity": "^0.9.1",
+		"@twin.org/entity-storage-models": "^0.9.1",
+		"@twin.org/identity-models": "^0.9.1",
+		"@twin.org/logging-connector-opentelemetry": "^0.9.1",
+		"@twin.org/modules": "^0.9.1",
+		"@twin.org/standards-w3c-did": "^0.9.1",
+		"@twin.org/standards-w3c-odrl": "^0.9.1",
+		"@twin.org/telemetry-connector-opentelemetry": "^0.9.1",
+		"@twin.org/telemetry-models": "^0.9.1",
+		"@twin.org/trust-models": "^0.9.1",
+		"@twin.org/vault-models": "^0.9.1",
+		"@twin.org/wallet-models": "^0.9.1",
 		"dotenv": "17.4.2",
 		"schema-dts": "2.0.0"
 	},