@twin.org/node 0.9.4-next.1 → 0.9.4-next.3

package/dist/locales/en.json

@@ -394,7 +394,9 @@
 		"migrationHelper": {
 			"migrateSchemaFailed": "Migration failed for schema \"{schemaName}\".",
 			"transformRequiredForProperty": "A transformation function is required to migrate property \"{from}\" to \"{to}\" of type \"{type}\"",
-			"coercionProducedUndefined": "Coercion of property \"{property}\" to type \"{type}\" produced undefined but the property is not optional"
+			"coercionProducedUndefined": "Coercion of property \"{property}\" to type \"{type}\" produced undefined but the property is not optional",
+			"connectorBootstrapFailed": "Connector \"{className}\" failed to bootstrap storage for schema \"{schemaName}\"",
+			"maxIdentifierLengthTooSmall": "The maximum identifier length {maxIdentifierLength} must be at least {minimum} to fit the migration name suffix"
 		},
 		"vaultConnectorHelper": {
 			"invalidSignature": "The JSON Web token signature could not be verified"
@@ -556,6 +558,10 @@
 		"spanHelper": {
 			"traceFlagsOutOfRange": "The trace flags value \"{traceFlags}\" is outside the valid range 0 to 255"
 		},
+		"tracingHelper": {
+			"startSpanFailed": "The span \"{name}\" could not be started, so the operation was not traced",
+			"endSpanFailed": "The span \"{name}\" could not be ended"
+		},
 		"auditableItemGraphService": {
 			"namespaceMismatch": "The namespace in the urn \"{id}\" does not match the namespace of the Auditable Item Graph service \"{namespace}\"",
 			"createFailed": "Creating the Auditable Item Graph vertex failed",
@@ -940,6 +946,7 @@
 			"conditionalNotSupported": "Conditional operator \"{operator}\" is not supported",
 			"entitySchemaPropertiesUndefined": "The entity schema properties are undefined",
 			"databaseCreateFailed": "Unable to create database \"{databaseName}\"",
+			"tableCreateFailed": "Unable to create table \"{tableName}\"",
 			"setBatchFailed": "Unable to set batch of entities",
 			"countFailed": "Unable to count entities",
 			"emptyFailed": "Unable to empty entity storage",
@@ -952,6 +959,7 @@
 			"optimisticLockFailed": "The entity \"{conflictId}\" could not be written because the optimistic lock check failed",
 			"conditionFailed": "The entity \"{conflictId}\" could not be updated because the supplied conditions did not match the stored state",
 			"databaseCreateFailed": "Unable to create database \"{databaseName}\"",
+			"tableCreateFailed": "Unable to create table \"{tableName}\"",
 			"setFailed": "Unable to set entity \"{id}\"",
 			"getFailed": "Unable to get entity \"{id}\"",
 			"removeFailed": "Unable to remove entity \"{id}\"",
@@ -1418,7 +1426,18 @@
 			"upDownCounterIncOrDecOnly": "An up/down counter metric can only be incremented, decremented or adjusted with an integer",
 			"gaugeNoIncDec": "A gauge can not be incremented or decremented",
 			"maxHistoryMustBePositiveInteger": "The maxHistory option must be a positive integer",
-			"flushFailed": "Failed to flush metric values to storage"
+			"metricValueTaskFailed": "The metric value background task failed \"{taskId}\"",
+			"backgroundTaskComponentMissing": "The metric values cannot be written as no background task component is available",
+			"metricValueThreadStalled": "No metric value background task has completed for \"{stalledForMs}\" ms, with task \"{taskId}\" outstanding of \"{taskCount}\", so the background thread is being replaced",
+			"metricValueThreadRestartFailed": "The stalled metric value background thread could not be replaced, so no further metric values can be written",
+			"stopFlushFailed": "The final metric value write failed while stopping, so the values the background thread was holding may not have been persisted",
+			"metricValueThreadCheckFailed": "The check for a stalled metric value background thread failed"
+		},
+		"metricValueWriter": {
+			"flushFailed": "Failed to flush metric values to storage",
+			"invalidMetricOperation": "The operation \"{operation}\" is not valid for metric \"{id}\" of type \"{type}\"",
+			"trimFailed": "Failed to trim the metric history to its retention cap",
+			"intervalWriteFailed": "The interval write of the pending metric values failed"
 		},
 		"openTelemetryTelemetryConnector": {
 			"metricNotFound": "The metric could not be found \"{notFoundId}\"",
@@ -1426,7 +1445,9 @@
 			"gaugeNoIncDec": "A gauge can not be incremented or decremented"
 		},
 		"metricsCollectorService": {
-			"producerCollectionFailed": "Failed to collect metrics from producer \"{producer}\""
+			"producerCollectionFailed": "Failed to collect metrics from producer \"{producer}\"",
+			"metricRecordFailed": "Failed to record the collected metric values",
+			"collectionCycleFailed": "Failed to run the metrics collection cycle"
 		},
 		"entityStorageTracingConnector": {
 			"spanNotFound": "The span could not be found \"{notFoundId}\"",
@@ -1533,7 +1554,9 @@
 	},
 	"warn": {
 		"node": {
-			"unknownEnvVars": "Unknown environment variable properties [{keys}], they will be ignored. Check for typos in variable names, for custom variables use the {prefix}ENV_ALLOW_LIST."
+			"unknownEnvVars": "Unknown environment variable properties [{keys}], they will be ignored. Check for typos in variable names, for custom variables use the {prefix}ENV_ALLOW_LIST.",
+			"deprecatedEnvVar": "The environment variable \"{key}\" is deprecated and no longer has any effect, please use {replacements} instead. This variable will be removed in a future release.",
+			"deprecatedEnvVarNoReplacement": "The environment variable \"{key}\" is deprecated and no longer has any effect. This variable will be removed in a future release."
 		},
 		"common": {
 			"devOnlyTool": "This tool is intended to be used for development purposes, it is not recommended for use in production scenarios."
@@ -1611,6 +1634,11 @@
 			"terminatedCallbackFailed": "Failed to notify requester via terminated() for negotiation id: \"{negotiationId}\"",
 			"callbackDeliveryFailed": "Failed to deliver the negotiation callback to \"{callbackAddress}\" for negotiation id: \"{negotiationId}\" in state \"{state}\"; the negotiation is unchanged and remains discoverable by polling",
 			"sendTerminateFailed": "Failed to send terminate to consumer for negotiation id: \"{id}\", correlation id: \"{correlationId}\""
+		},
+		"entityStorageTelemetryConnector": {
+			"flushTimeout": "The background thread did not confirm the flush within \"{timeoutMs}\" ms for task \"{taskId}\", with \"{taskCount}\" tasks outstanding",
+			"metricValueThreadRestarted": "The stalled metric value background thread was replaced, and the tasks it was given will be processed by the new one",
+			"metricValueTaskStateMissed": "The completion of the metric value background task \"{taskId}\" was never reported, its state is now \"{status}\", so the background thread is treated as working rather than replaced"
 		}
 	},
 	"node": {
@@ -2774,7 +2802,9 @@
 			"metricCreated": "The metric was created \"{id}\" with type \"type\" and label \"{label}\"",
 			"metricUpdated": "The metric was updated \"{id}\" with type \"type\" and label \"{label}\"",
 			"metricRemoved": "The metric was removed \"{id}\"",
-			"metricValueCreated": "The metric value was created for \"{id}\" with value \"{value}\""
+			"metricValueCreated": "The metric value was queued for \"{id}\"",
+			"metricValuesCreated": "\"{count}\" metric values were queued",
+			"metricsCreated": "\"{count}\" metrics were created"
 		},
 		"openTelemetryTelemetryConnector": {
 			"connectorStarted": "The connector was started with \"{readerCount}\" metric reader(s)",

package/docs/changelog.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## [0.9.4-next.3](https://github.com/iotaledger/twin-node/compare/node-v0.9.4-next.2...node-v0.9.4-next.3) (2026-09-09)
+
+
+### Miscellaneous Chores
+
+* **node:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/node-core bumped from 0.9.4-next.2 to 0.9.4-next.3
+
+## [0.9.4-next.2](https://github.com/iotaledger/twin-node/compare/node-v0.9.4-next.1...node-v0.9.4-next.2) (2026-09-08)
+
+
+### Miscellaneous Chores
+
+* **node:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/node-core bumped from 0.9.4-next.1 to 0.9.4-next.2
+
 ## [0.9.4-next.1](https://github.com/iotaledger/twin-node/compare/node-v0.9.4-next.0...node-v0.9.4-next.1) (2026-09-07)
 
 

package/docs/open-api/spec.json

@@ -6986,7 +6986,7 @@
 		"/telemetry/metric": {
 			"post": {
 				"operationId": "telemetryCreateMetric",
-				"summary": "Create a telemetry metric",
+				"summary": "Create one or more telemetry metrics",
 				"tags": [
 					"Telemetry"
 				],
@@ -6996,12 +6996,12 @@
 					}
 				],
 				"requestBody": {
-					"description": "Create a new telemetry metric.",
+					"description": "Create one or more telemetry metrics.",
 					"required": true,
 					"content": {
 						"application/json": {
 							"schema": {
-								"$ref": "#/components/schemas/TelemetryMetric"
+								"$ref": "#/components/schemas/TelemetryCreateMetricRequest"
 							},
 							"examples": {
 								"telemetryCreateMetricRequestExample": {
@@ -7010,8 +7010,24 @@
 										"label": "My Counter",
 										"description": "This is my counter",
 										"type": 0,
-										"unit": "KG"
+										"unit": "KG",
+										"maxHistory": 1000
 									}
+								},
+								"telemetryCreateMetricsRequestExample": {
+									"value": [
+										{
+											"id": "my-counter",
+											"label": "My Counter",
+											"type": 0,
+											"maxHistory": 1000
+										},
+										{
+											"id": "my-gauge",
+											"label": "My Gauge",
+											"type": 2
+										}
+									]
 								}
 							}
 						}
@@ -24543,6 +24559,20 @@
 				],
 				"description": "The data to be used in the update."
 			},
+			"TelemetryCreateMetricRequest": {
+				"anyOf": [
+					{
+						"$ref": "#/components/schemas/TelemetryMetric"
+					},
+					{
+						"type": "array",
+						"items": {
+							"$ref": "#/components/schemas/TelemetryMetric"
+						}
+					}
+				],
+				"description": "The data to be used in the create. A single metric fails if it already exists; an array\ndeclares the set that should exist, creating the ones that are missing."
+			},
 			"TelemetryGetMetricResponse": {
 				"type": "object",
 				"properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/node",
-	"version": "0.9.4-next.1",
+	"version": "0.9.4-next.3",
 	"description": "TWIN Node serving APIs using the specified configuration",
 	"repository": {
 		"type": "git",
@@ -14,7 +14,7 @@
 		"node": ">=24.0.0"
 	},
 	"dependencies": {
-		"@twin.org/node-core": "0.9.4-next.1"
+		"@twin.org/node-core": "0.9.4-next.3"
 	},
 	"bugs": {
 		"url": "git+https://github.com/iotaledger/twin-node/issues"