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

package/dist/types/commands/identityResolve.d.ts

@@ -15,8 +15,10 @@ export declare function getCommandDefinitionIdentityResolve(commandDefinitions:
  * @param envVars The environment variables for the node.
  * @param params The parameters for the command.
  * @param params.identity The DID to resolve.
+ * @param params.outputJson The output .json file to store the resolved DID document.
  * @returns The resolved DID document.
  */
 export declare function identityResolve(engineCore: IEngineCore, envVars: IEnvironmentVariables, params: {
     identity?: string;
+    outputJson?: string;
 }): Promise<IDidDocument>;

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

@@ -47,4 +47,8 @@ export interface ICliCommandDefinition {
      * @default true
      */
     requiresOrgIdentity?: boolean;
+    /**
+     * Indicates whether this command is only available in single-tenant mode.
+     */
+    singleTenantOnly?: boolean;
 }

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

@@ -289,7 +289,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;
     /**
@@ -304,6 +304,22 @@ export interface IEngineEnvironmentVariables {
      * 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 +444,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 +468,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 +552,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,14 @@
 # Changelog
 
+## [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

@@ -575,7 +575,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.
 
 ***
 
@@ -603,6 +603,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 +883,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 +931,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 +1099,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-next.9",
 	"description": "TWIN Node Core for serving APIs using the specified configuration",
 	"repository": {
 		"type": "git",
@@ -32,7 +32,6 @@
 		"@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",