@twin.org/node-core 0.9.2-next.7 → 0.9.2-next.9

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

@@ -131,6 +131,14 @@ export interface IEngineEnvironmentVariables {
      * ScyllaDB port.
      */
     scylladbPort?: string;
+    /**
+     * ScyllaDB connection pool: number of connections per local host.
+     */
+    scylladbPoolCoreConnectionsPerHost?: string;
+    /**
+     * ScyllaDB connection pool: maximum requests per connection.
+     */
+    scylladbPoolMaxRequestsPerConnection?: string;
     /**
      * MySQL host.
      */
@@ -151,6 +159,30 @@ export interface IEngineEnvironmentVariables {
      * MySQL Database.
      */
     mySqlDatabase?: string;
+    /**
+     * MySQL connection pool: maximum number of connections.
+     */
+    mySqlPoolConnectionLimit?: string;
+    /**
+     * MySQL connection pool: maximum number of idle connections.
+     */
+    mySqlPoolMaxIdle?: string;
+    /**
+     * MySQL connection pool: milliseconds before an idle connection is removed.
+     */
+    mySqlPoolIdleTimeout?: string;
+    /**
+     * MySQL connection pool: enable TCP keep-alive.
+     */
+    mySqlPoolEnableKeepAlive?: string;
+    /**
+     * MySQL connection pool: wait for a connection when pool is full.
+     */
+    mySqlPoolWaitForConnections?: string;
+    /**
+     * MySQL connection pool: maximum queued requests (0 = unlimited).
+     */
+    mySqlPoolQueueLimit?: string;
     /**
      * MongoDB host.
      */
@@ -171,6 +203,22 @@ export interface IEngineEnvironmentVariables {
      * MongoDB Database.
      */
     mongoDbDatabase?: string;
+    /**
+     * MongoDB connection pool: maximum number of connections.
+     */
+    mongoDbPoolMaxPoolSize?: string;
+    /**
+     * MongoDB connection pool: minimum number of connections to maintain.
+     */
+    mongoDbPoolMinPoolSize?: string;
+    /**
+     * MongoDB connection pool: milliseconds a connection can remain idle before removal.
+     */
+    mongoDbPoolMaxIdleTime?: string;
+    /**
+     * MongoDB connection pool: milliseconds to wait for a connection before throwing.
+     */
+    mongoDbPoolWaitQueueTimeout?: string;
     /**
      * PostgreSQl host.
      */
@@ -191,6 +239,22 @@ export interface IEngineEnvironmentVariables {
      * PostgreSQl Database.
      */
     postgreSqlDatabase?: string;
+    /**
+     * PostgreSQL connection pool: maximum number of connections.
+     */
+    postgreSqlPoolMax?: string;
+    /**
+     * PostgreSQL connection pool: seconds a connection can remain idle before being closed.
+     */
+    postgreSqlPoolIdleTimeout?: string;
+    /**
+     * PostgreSQL connection pool: seconds to wait when establishing a connection.
+     */
+    postgreSqlPoolConnectTimeout?: string;
+    /**
+     * PostgreSQL connection pool: maximum seconds a connection can remain open.
+     */
+    postgreSqlPoolMaxLifetime?: string;
     /**
      * The security token for accessing IPFS API.
      */
@@ -503,7 +567,15 @@ export interface IEngineEnvironmentVariables {
     /**
      * The TTL in milliseconds for caching resolved DIDs when using the IOTA identity connector. Omit to use the connector default.
      */
-    identityDidResolutionCacheTtlMs?: string;
+    identityDidResolutionCacheTtl?: string;
+    /**
+     * The maximum number of DID documents to hold in the resolution cache. Only used when using the IOTA identity connector and caching is enabled.
+     */
+    identityDidResolutionCacheCapacity?: string;
+    /**
+     * The mutex timeout in milliseconds for the DID resolution cache. Only used when using the IOTA identity connector and caching is enabled.
+     */
+    identityDidResolutionCacheMutexTimeout?: string;
     /**
      * The type of identity resolver connector: entity-storage, iota.
      */
@@ -736,6 +808,34 @@ export interface IEngineEnvironmentVariables {
      * @default 3600
      */
     dataspaceActivityLogsCleanupInterval?: string;
+    /**
+     * The TTL in milliseconds for the dataspace agreement cache.
+     */
+    dataspaceAgreementCacheTtl?: string;
+    /**
+     * The mutex timeout in milliseconds for the dataspace agreement cache.
+     */
+    dataspaceAgreementCacheMutexTimeout?: string;
+    /**
+     * The number of times to retry failed data plane tasks.
+     */
+    dataspaceRetryCount?: string;
+    /**
+     * Maximum HTTP retry attempts per push delivery task execution.
+     */
+    dataspacePushRetryCount?: string;
+    /**
+     * Base delay in milliseconds for exponential backoff between push HTTP retries.
+     */
+    dataspacePushRetryBaseDelay?: string;
+    /**
+     * Timeout in milliseconds for each push delivery HTTP POST request.
+     */
+    dataspacePushTimeout?: string;
+    /**
+     * Interval in milliseconds between orphaned push subscription cleanup scans.
+     */
+    dataspacePushSubscriptionCleanupInterval?: string;
     /**
      * Base route path for the data plane service (path only, not full URL).
      * Combined with the public origin to form the `dataAddress.endpoint` sent to PULL consumers
@@ -808,7 +908,7 @@ export interface IEngineEnvironmentVariables {
     /**
      * The default mutex timeout in milliseconds, used when no component-specific timeout is set, defaults to 5000 if omitted.
      */
-    mutexTimeoutMsDefault?: string;
+    mutexTimeoutDefault?: string;
     /**
      * The mutex timeout in milliseconds for the auditable item graph component.
      */

package/docs/changelog.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.9.2-next.9](https://github.com/iotaledger/twin-node/compare/node-core-v0.9.2-next.8...node-core-v0.9.2-next.9) (2026-08-12)
+
+
+### Features
+
+* pool env vars ([#331](https://github.com/iotaledger/twin-node/issues/331)) ([338ea61](https://github.com/iotaledger/twin-node/commit/338ea612b37aa4d15971c8a09def47bee9395d0c))
+
+## [0.9.2-next.8](https://github.com/iotaledger/twin-node/compare/node-core-v0.9.2-next.7...node-core-v0.9.2-next.8) (2026-08-11)
+
+
+### Features
+
+* add additional env vars ([#328](https://github.com/iotaledger/twin-node/issues/328)) ([6ca8718](https://github.com/iotaledger/twin-node/commit/6ca87184bc4d78829c957ea055d3c281aca6cf9f))
+
 ## [0.9.2-next.7](https://github.com/iotaledger/twin-node/compare/node-core-v0.9.2-next.6...node-core-v0.9.2-next.7) (2026-08-10)
 
 

package/docs/reference/interfaces/IEngineEnvironmentVariables.md

@@ -258,6 +258,22 @@ ScyllaDB port.
 
 ***
 
+### scylladbPoolCoreConnectionsPerHost? {#scylladbpoolcoreconnectionsperhost}
+
+> `optional` **scylladbPoolCoreConnectionsPerHost?**: `string`
+
+ScyllaDB connection pool: number of connections per local host.
+
+***
+
+### scylladbPoolMaxRequestsPerConnection? {#scylladbpoolmaxrequestsperconnection}
+
+> `optional` **scylladbPoolMaxRequestsPerConnection?**: `string`
+
+ScyllaDB connection pool: maximum requests per connection.
+
+***
+
 ### mySqlHost? {#mysqlhost}
 
 > `optional` **mySqlHost?**: `string`
@@ -298,6 +314,54 @@ MySQL Database.
 
 ***
 
+### mySqlPoolConnectionLimit? {#mysqlpoolconnectionlimit}
+
+> `optional` **mySqlPoolConnectionLimit?**: `string`
+
+MySQL connection pool: maximum number of connections.
+
+***
+
+### mySqlPoolMaxIdle? {#mysqlpoolmaxidle}
+
+> `optional` **mySqlPoolMaxIdle?**: `string`
+
+MySQL connection pool: maximum number of idle connections.
+
+***
+
+### mySqlPoolIdleTimeout? {#mysqlpoolidletimeout}
+
+> `optional` **mySqlPoolIdleTimeout?**: `string`
+
+MySQL connection pool: milliseconds before an idle connection is removed.
+
+***
+
+### mySqlPoolEnableKeepAlive? {#mysqlpoolenablekeepalive}
+
+> `optional` **mySqlPoolEnableKeepAlive?**: `string`
+
+MySQL connection pool: enable TCP keep-alive.
+
+***
+
+### mySqlPoolWaitForConnections? {#mysqlpoolwaitforconnections}
+
+> `optional` **mySqlPoolWaitForConnections?**: `string`
+
+MySQL connection pool: wait for a connection when pool is full.
+
+***
+
+### mySqlPoolQueueLimit? {#mysqlpoolqueuelimit}
+
+> `optional` **mySqlPoolQueueLimit?**: `string`
+
+MySQL connection pool: maximum queued requests (0 = unlimited).
+
+***
+
 ### mongoDbHost? {#mongodbhost}
 
 > `optional` **mongoDbHost?**: `string`
@@ -338,6 +402,38 @@ MongoDB Database.
 
 ***
 
+### mongoDbPoolMaxPoolSize? {#mongodbpoolmaxpoolsize}
+
+> `optional` **mongoDbPoolMaxPoolSize?**: `string`
+
+MongoDB connection pool: maximum number of connections.
+
+***
+
+### mongoDbPoolMinPoolSize? {#mongodbpoolminpoolsize}
+
+> `optional` **mongoDbPoolMinPoolSize?**: `string`
+
+MongoDB connection pool: minimum number of connections to maintain.
+
+***
+
+### mongoDbPoolMaxIdleTime? {#mongodbpoolmaxidletime}
+
+> `optional` **mongoDbPoolMaxIdleTime?**: `string`
+
+MongoDB connection pool: milliseconds a connection can remain idle before removal.
+
+***
+
+### mongoDbPoolWaitQueueTimeout? {#mongodbpoolwaitqueuetimeout}
+
+> `optional` **mongoDbPoolWaitQueueTimeout?**: `string`
+
+MongoDB connection pool: milliseconds to wait for a connection before throwing.
+
+***
+
 ### postgreSqlHost? {#postgresqlhost}
 
 > `optional` **postgreSqlHost?**: `string`
@@ -378,6 +474,38 @@ PostgreSQl Database.
 
 ***
 
+### postgreSqlPoolMax? {#postgresqlpoolmax}
+
+> `optional` **postgreSqlPoolMax?**: `string`
+
+PostgreSQL connection pool: maximum number of connections.
+
+***
+
+### postgreSqlPoolIdleTimeout? {#postgresqlpoolidletimeout}
+
+> `optional` **postgreSqlPoolIdleTimeout?**: `string`
+
+PostgreSQL connection pool: seconds a connection can remain idle before being closed.
+
+***
+
+### postgreSqlPoolConnectTimeout? {#postgresqlpoolconnecttimeout}
+
+> `optional` **postgreSqlPoolConnectTimeout?**: `string`
+
+PostgreSQL connection pool: seconds to wait when establishing a connection.
+
+***
+
+### postgreSqlPoolMaxLifetime? {#postgresqlpoolmaxlifetime}
+
+> `optional` **postgreSqlPoolMaxLifetime?**: `string`
+
+PostgreSQL connection pool: maximum seconds a connection can remain open.
+
+***
+
 ### ipfsBearerToken? {#ipfsbearertoken}
 
 > `optional` **ipfsBearerToken?**: `string`
@@ -1007,14 +1135,30 @@ The index of the wallet address to use, defaults to 0.
 
 ***
 
-### identityDidResolutionCacheTtlMs? {#identitydidresolutioncachettlms}
+### identityDidResolutionCacheTtl? {#identitydidresolutioncachettl}
 
-> `optional` **identityDidResolutionCacheTtlMs?**: `string`
+> `optional` **identityDidResolutionCacheTtl?**: `string`
 
 The TTL in milliseconds for caching resolved DIDs when using the IOTA identity connector. Omit to use the connector default.
 
 ***
 
+### identityDidResolutionCacheCapacity? {#identitydidresolutioncachecapacity}
+
+> `optional` **identityDidResolutionCacheCapacity?**: `string`
+
+The maximum number of DID documents to hold in the resolution cache. Only used when using the IOTA identity connector and caching is enabled.
+
+***
+
+### identityDidResolutionCacheMutexTimeout? {#identitydidresolutioncachemutextimeout}
+
+> `optional` **identityDidResolutionCacheMutexTimeout?**: `string`
+
+The mutex timeout in milliseconds for the DID resolution cache. Only used when using the IOTA identity connector and caching is enabled.
+
+***
+
 ### identityResolverConnector? {#identityresolverconnector}
 
 > `optional` **identityResolverConnector?**: `string`
@@ -1509,6 +1653,62 @@ The interval in seconds for cleaning up the activity logs.
 
 ***
 
+### dataspaceAgreementCacheTtl? {#dataspaceagreementcachettl}
+
+> `optional` **dataspaceAgreementCacheTtl?**: `string`
+
+The TTL in milliseconds for the dataspace agreement cache.
+
+***
+
+### dataspaceAgreementCacheMutexTimeout? {#dataspaceagreementcachemutextimeout}
+
+> `optional` **dataspaceAgreementCacheMutexTimeout?**: `string`
+
+The mutex timeout in milliseconds for the dataspace agreement cache.
+
+***
+
+### dataspaceRetryCount? {#dataspaceretrycount}
+
+> `optional` **dataspaceRetryCount?**: `string`
+
+The number of times to retry failed data plane tasks.
+
+***
+
+### dataspacePushRetryCount? {#dataspacepushretrycount}
+
+> `optional` **dataspacePushRetryCount?**: `string`
+
+Maximum HTTP retry attempts per push delivery task execution.
+
+***
+
+### dataspacePushRetryBaseDelay? {#dataspacepushretrybasedelay}
+
+> `optional` **dataspacePushRetryBaseDelay?**: `string`
+
+Base delay in milliseconds for exponential backoff between push HTTP retries.
+
+***
+
+### dataspacePushTimeout? {#dataspacepushtimeout}
+
+> `optional` **dataspacePushTimeout?**: `string`
+
+Timeout in milliseconds for each push delivery HTTP POST request.
+
+***
+
+### dataspacePushSubscriptionCleanupInterval? {#dataspacepushsubscriptioncleanupinterval}
+
+> `optional` **dataspacePushSubscriptionCleanupInterval?**: `string`
+
+Interval in milliseconds between orphaned push subscription cleanup scans.
+
+***
+
 ### dataspaceDataPlanePath? {#dataspacedataplanepath}
 
 > `optional` **dataspaceDataPlanePath?**: `string`
@@ -1646,9 +1846,9 @@ values: fetch
 
 ***
 
-### mutexTimeoutMsDefault? {#mutextimeoutmsdefault}
+### mutexTimeoutDefault? {#mutextimeoutdefault}
 
-> `optional` **mutexTimeoutMsDefault?**: `string`
+> `optional` **mutexTimeoutDefault?**: `string`
 
 The default mutex timeout in milliseconds, used when no component-specific timeout is set, defaults to 5000 if omitted.
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/node-core",
-	"version": "0.9.2-next.7",
+	"version": "0.9.2-next.9",
 	"description": "TWIN Node Core for serving APIs using the specified configuration",
 	"repository": {
 		"type": "git",