@twin.org/node-core 0.9.2-next.1 → 0.9.2-next.11

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`
@@ -268,7 +284,7 @@ MySQL host.
 
 ### mySqlPort? {#mysqlport}
 
-> `optional` **mySqlPort?**: `number`
+> `optional` **mySqlPort?**: `string`
 
 MySQL port.
 
@@ -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`
@@ -308,7 +372,7 @@ MongoDB host.
 
 ### mongoDbPort? {#mongodbport}
 
-> `optional` **mongoDbPort?**: `number`
+> `optional` **mongoDbPort?**: `string`
 
 MongoDB port.
 
@@ -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`
@@ -348,7 +444,7 @@ PostgreSQl host.
 
 ### postgreSqlPort? {#postgresqlport}
 
-> `optional` **postgreSqlPort?**: `number`
+> `optional` **postgreSqlPort?**: `string`
 
 PostgreSQl port.
 
@@ -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`
@@ -583,7 +711,7 @@ Hashicorp Vault endpoint.
 
 > `optional` **loggingConnector?**: `string`
 
-The type of logging task connector, can be a comma separated list: console, entity-storage, otel, file.
+The type of logging task connector, can be a comma separated list: console, entity-storage, open-telemetry, file.
 
 ***
 
@@ -895,6 +1023,62 @@ Maximum number of values retained per telemetry metric (count-based history cap)
 
 ***
 
+### telemetryMutexTimeout? {#telemetrymutextimeout}
+
+> `optional` **telemetryMutexTimeout?**: `string`
+
+The mutex timeout in milliseconds for the telemetry connector.
+
+***
+
+### tracingConnector? {#tracingconnector}
+
+> `optional` **tracingConnector?**: `string`
+
+The type of tracing connector: entity-storage, open-telemetry.
+
+***
+
+### openTelemetryTracingTracerName? {#opentelemetrytracingtracername}
+
+> `optional` **openTelemetryTracingTracerName?**: `string`
+
+The name of the Open Telemetry tracer to use, only required if using open-telemetry as tracing connector, defaults to twin-node.
+
+***
+
+### openTelemetryTracingTracerVersion? {#opentelemetrytracingtracerversion}
+
+> `optional` **openTelemetryTracingTracerVersion?**: `string`
+
+The version of the Open Telemetry tracing specification to use, only required if using open-telemetry as tracing connector, defaults to 1.0.0.
+
+***
+
+### openTelemetryTracingEndpoint? {#opentelemetrytracingendpoint}
+
+> `optional` **openTelemetryTracingEndpoint?**: `string`
+
+The OTLP HTTP endpoint to push spans to, e.g. http://localhost:4318/v1/traces. Required when using open-telemetry as tracing connector.
+
+***
+
+### openTelemetryTracingProcessor? {#opentelemetrytracingprocessor}
+
+> `optional` **openTelemetryTracingProcessor?**: `string`
+
+The span processor: batch (default) or simple. Only used when TWIN_TRACING_CONNECTOR=open-telemetry.
+
+***
+
+### tracingMutexTimeout? {#tracingmutextimeout}
+
+> `optional` **tracingMutexTimeout?**: `string`
+
+The mutex timeout in milliseconds for the tracing connector.
+
+***
+
 ### faucetConnector? {#faucetconnector}
 
 > `optional` **faucetConnector?**: `string`
@@ -951,14 +1135,46 @@ 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.
+
+***
+
+### identityDidResolutionRetries? {#identitydidresolutionretries}
+
+> `optional` **identityDidResolutionRetries?**: `string`
+
+The number of times to retry resolving a DID after a write operation (create, update, or delete) to confirm propagation. Only used when using the IOTA identity connector.
+
+***
+
+### identityDidResolutionRetryDelay? {#identitydidresolutionretrydelay}
+
+> `optional` **identityDidResolutionRetryDelay?**: `string`
+
+The delay in milliseconds between DID resolution retries after a write operation. Only used when using the IOTA identity connector.
+
+***
+
 ### identityResolverConnector? {#identityresolverconnector}
 
 > `optional` **identityResolverConnector?**: `string`
@@ -1071,6 +1287,127 @@ The identity verification method id to use with immutable proofs.
 
 ***
 
+### immutableProofTaskRetryCount? {#immutableprooftaskretrycount}
+
+> `optional` **immutableProofTaskRetryCount?**: `string`
+
+The number of times to retry a proof task when it fails, 0 to disable retries.
+
+#### Default
+
+```ts
+5
+```
+
+***
+
+### immutableProofTaskRetryInterval? {#immutableprooftaskretryinterval}
+
+> `optional` **immutableProofTaskRetryInterval?**: `string`
+
+The interval in seconds to wait between proof task retries.
+
+#### Default
+
+```ts
+5
+```
+
+***
+
+### immutableProofTaskFailureRetainFor? {#immutableprooftaskfailureretainfor}
+
+> `optional` **immutableProofTaskFailureRetainFor?**: `string`
+
+The time in minutes to retain the record of a failed proof task.
+Set to -1 to retain failures forever.
+
+#### Default
+
+```ts
+10080
+```
+
+***
+
+### immutableProofSweepInterval? {#immutableproofsweepinterval}
+
+> `optional` **immutableProofSweepInterval?**: `string`
+
+How often in minutes the immutable proof reconciliation sweep runs.
+
+#### Default
+
+```ts
+30
+```
+
+***
+
+### immutableProofSweepStaleThreshold? {#immutableproofsweepstalethreshold}
+
+> `optional` **immutableProofSweepStaleThreshold?**: `string`
+
+The minimum age in minutes before a proof with no notarization is considered stuck.
+
+#### Default
+
+```ts
+180
+```
+
+***
+
+### immutableProofSweepMaxAttempts? {#immutableproofsweepmaxattempts}
+
+> `optional` **immutableProofSweepMaxAttempts?**: `string`
+
+The number of sweep attempts made before a proof is parked.
+
+#### Default
+
+```ts
+5
+```
+
+***
+
+### immutableProofSweepBatchLimit? {#immutableproofsweepbatchlimit}
+
+> `optional` **immutableProofSweepBatchLimit?**: `string`
+
+The maximum number of proofs to re-enqueue per tenant per sweep cycle.
+
+#### Default
+
+```ts
+10
+```
+
+***
+
+### immutableProofSweepBackoff? {#immutableproofsweepbackoff}
+
+> `optional` **immutableProofSweepBackoff?**: `string`
+
+The minimum time in minutes between sweep attempts for the same proof.
+
+#### Default
+
+```ts
+60
+```
+
+***
+
+### immutableProofSweepAssumeRetryableBefore? {#immutableproofsweepassumeretryablebefore}
+
+> `optional` **immutableProofSweepAssumeRetryableBefore?**: `string`
+
+ISO 8601 date-time used to treat older missing-task proofs as retryable.
+
+***
+
 ### attestationConnector? {#attestationconnector}
 
 > `optional` **attestationConnector?**: `string`
@@ -1332,6 +1669,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`
@@ -1341,7 +1734,7 @@ Combined with the public origin to form the `dataAddress.endpoint` sent to PULL
 and the inbox URL sent to PUSH providers.
 
 This must be the mount-point prefix of the data plane routes, NOT a specific route path.
-Do NOT append sub-paths such as `/entities` or `/inbox` — those are appended automatically
+Do NOT append sub-paths such as `/entities` or `/inbox` - those are appended automatically
 by each transfer handler and by the data plane REST client.
 
 REQUIRED if PULL or PUSH transfers are supported.
@@ -1395,6 +1788,22 @@ progressing it before it is treated as timed out.
 
 ***
 
+### dataspaceProviderTransferIdleTimeout? {#dataspaceprovidertransferidletimeout}
+
+> `optional` **dataspaceProviderTransferIdleTimeout?**: `string`
+
+How long in seconds a provider transfer may stay idle before the idle policy marks it as stalled.
+
+***
+
+### dataspaceProviderTransferPolicySweepInterval? {#dataspaceprovidertransferpolicysweepinterval}
+
+> `optional` **dataspaceProviderTransferPolicySweepInterval?**: `string`
+
+How frequently in seconds the provider idle transfer policy sweep runs.
+
+***
+
 ### dataspaceCallbackPath? {#dataspacecallbackpath}
 
 > `optional` **dataspaceCallbackPath?**: `string`
@@ -1436,6 +1845,14 @@ This allows components that take a long time to initialize to be healthy before
 
 ***
 
+### healthApplicationInterval? {#healthapplicationinterval}
+
+> `optional` **healthApplicationInterval?**: `string`
+
+The interval in seconds for running the application health lifecycle (init, application, teardown), defaults to 300.
+
+***
+
 ### automationActionTypes? {#automationactiontypes}
 
 > `optional` **automationActionTypes?**: `string`
@@ -1445,9 +1862,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.
 
@@ -1493,19 +1910,11 @@ The mutex timeout in milliseconds for the logging component.
 
 ***
 
-### entityStorageMemoryMutexTimeout? {#entitystoragememorymutextimeout}
-
-> `optional` **entityStorageMemoryMutexTimeout?**: `string`
-
-The mutex timeout in milliseconds for the memory entity storage connector.
-
-***
-
-### entityStorageFileMutexTimeout? {#entitystoragefilemutextimeout}
+### entityStorageMutexTimeout? {#entitystoragemutextimeout}
 
-> `optional` **entityStorageFileMutexTimeout?**: `string`
+> `optional` **entityStorageMutexTimeout?**: `string`
 
-The mutex timeout in milliseconds for the file entity storage connector.
+The mutex timeout in milliseconds for the memory and file entity storage connectors.
 
 ***
 

package/docs/reference/type-aliases/IEnvironmentVariables.md

@@ -1,5 +1,5 @@
 # Type Alias: IEnvironmentVariables
 
-> **IEnvironmentVariables** = [`IBootstrapLegacyEnvironmentVariables`](../interfaces/IBootstrapLegacyEnvironmentVariables.md) & [`INodeEnvironmentVariables`](../interfaces/INodeEnvironmentVariables.md) & [`IEngineEnvironmentVariables`](../interfaces/IEngineEnvironmentVariables.md) & [`IEngineServerEnvironmentVariables`](../interfaces/IEngineServerEnvironmentVariables.md)
+> **IEnvironmentVariables** = [`IBootstrapDevEnvironmentVariables`](../interfaces/IBootstrapDevEnvironmentVariables.md) & [`INodeEnvironmentVariables`](../interfaces/INodeEnvironmentVariables.md) & [`IEngineEnvironmentVariables`](../interfaces/IEngineEnvironmentVariables.md) & [`IEngineServerEnvironmentVariables`](../interfaces/IEngineServerEnvironmentVariables.md)
 
 The environment variables.

package/locales/en.json

@@ -14,10 +14,11 @@
 			"cliCommandParamMissing": "Parameter \"{param}\" is required for command \"{command}\"",
 			"cliCommandParamExtra": "Parameter(s) \"{params}\" are not recognised for command \"{command}\"",
 			"cliEnvVarMissing": "Environment variable \"{envVar}\" does not exist",
+			"invalidEnvVarValue": "Environment variable \"{key}\" has an invalid value \"{value}\", expected {type} type",
 			"unknownEnvVars": "Unknown environment variable properties [{keys}]. Check for typos in variable names, for custom variables use the {prefix}ENV_ALLOW_LIST."
 		},
-		"bootstrapLegacy": {
-			"noFeaturesEnabled": "No features are enabled in legacy bootstrap mode, at least one feature must be enabled.",
+		"bootstrapDev": {
+			"noFeaturesEnabled": "No features are enabled, at least one feature must be enabled.",
 			"organizationNotSet": "The organisation identity has not been set. Run \"node-org-id-set\"."
 		},
 		"identityCreate": {
@@ -129,9 +130,9 @@
 						"singleTenantOnly": "single-tenant only"
 					}
 				},
-				"bootstrap-legacy": {
-					"description": "Bootstrap in legacy mode for backwards compatibility, **will be deprecated in future versions**",
-					"example": "bootstrap-legacy --load-env=\"./.env.bootstrap-legacy\"",
+				"bootstrap-dev": {
+					"description": "Bootstrap the development environment",
+					"example": "bootstrap-dev --load-env=\"./.env.bootstrap-dev\"",
 					"params": {
 						"env-prefix": {
 							"description": "Prefix to use for standard .env files e.g. TWIN_."

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/node-core",
-	"version": "0.9.2-next.1",
+	"version": "0.9.2-next.11",
 	"description": "TWIN Node Core for serving APIs using the specified configuration",
 	"repository": {
 		"type": "git",
@@ -14,13 +14,17 @@
 		"node": ">=24.0.0"
 	},
 	"dependencies": {
+		"@twin.org/api-auth-entity-storage-models": "next",
 		"@twin.org/api-auth-entity-storage-service": "next",
+		"@twin.org/api-models": "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/data-json-ld": "next",
+		"@twin.org/dlt-account": "next",
+		"@twin.org/dlt-iota": "next",
 		"@twin.org/engine": "next",
 		"@twin.org/engine-core": "next",
 		"@twin.org/engine-models": "next",
@@ -29,16 +33,19 @@
 		"@twin.org/engine-types": "next",
 		"@twin.org/entity": "next",
 		"@twin.org/entity-storage-models": "next",
+		"@twin.org/identity-connector-entity-storage": "next",
 		"@twin.org/identity-models": "next",
 		"@twin.org/logging-connector-opentelemetry": "next",
 		"@twin.org/modules": "next",
+		"@twin.org/nameof": "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/tracing-connector-opentelemetry": "next",
 		"@twin.org/vault-models": "next",
+		"@twin.org/wallet-connector-entity-storage": "next",
 		"@twin.org/wallet-models": "next",
+		"@twin.org/web": "next",
 		"dotenv": "17.4.2",
 		"schema-dts": "2.0.0"
 	},