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

package/docs/reference/interfaces/IEngineEnvironmentVariables.md

@@ -268,7 +268,7 @@ MySQL host.
 
 ### mySqlPort? {#mysqlport}
 
-> `optional` **mySqlPort?**: `number`
+> `optional` **mySqlPort?**: `string`
 
 MySQL port.
 
@@ -308,7 +308,7 @@ MongoDB host.
 
 ### mongoDbPort? {#mongodbport}
 
-> `optional` **mongoDbPort?**: `number`
+> `optional` **mongoDbPort?**: `string`
 
 MongoDB port.
 
@@ -348,7 +348,7 @@ PostgreSQl host.
 
 ### postgreSqlPort? {#postgresqlport}
 
-> `optional` **postgreSqlPort?**: `number`
+> `optional` **postgreSqlPort?**: `string`
 
 PostgreSQl port.
 
@@ -583,7 +583,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.
 
 ***
 
@@ -903,6 +903,54 @@ 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`
@@ -1081,7 +1129,7 @@ The identity verification method id to use with immutable proofs.
 
 ### immutableProofTaskRetryCount? {#immutableprooftaskretrycount}
 
-> `optional` **immutableProofTaskRetryCount?**: `number`
+> `optional` **immutableProofTaskRetryCount?**: `string`
 
 The number of times to retry a proof task when it fails, 0 to disable retries.
 
@@ -1095,7 +1143,7 @@ The number of times to retry a proof task when it fails, 0 to disable retries.
 
 ### immutableProofTaskRetryInterval? {#immutableprooftaskretryinterval}
 
-> `optional` **immutableProofTaskRetryInterval?**: `number`
+> `optional` **immutableProofTaskRetryInterval?**: `string`
 
 The interval in seconds to wait between proof task retries.
 
@@ -1109,7 +1157,7 @@ The interval in seconds to wait between proof task retries.
 
 ### immutableProofTaskFailureRetainFor? {#immutableprooftaskfailureretainfor}
 
-> `optional` **immutableProofTaskFailureRetainFor?**: `number`
+> `optional` **immutableProofTaskFailureRetainFor?**: `string`
 
 The time in minutes to retain the record of a failed proof task.
 Set to -1 to retain failures forever.
@@ -1122,6 +1170,84 @@ Set to -1 to retain failures forever.
 
 ***
 
+### 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`
@@ -1392,7 +1518,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.
@@ -1446,6 +1572,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`
@@ -1487,6 +1629,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`
@@ -1544,19 +1694,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/locales/en.json

@@ -14,6 +14,7 @@
 			"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."
 		},
 		"bootstrapDev": {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/node-core",
-	"version": "0.9.2-next.5",
+	"version": "0.9.2-next.7",
 	"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"
 	},