@twin.org/node 0.0.3-next.36 → 0.0.3-next.39

package/dist/locales/en.json

@@ -42,7 +42,11 @@
 		},
 		"userCreate": {
 			"passwordTooShort": "The password provided is too short, it must be at least {minLength} characters long.",
-			"userAlreadyExists": "The user with ID already exists and overwriteMode is set to \"error\"."
+			"userAlreadyExists": "The user with ID already exists and overwriteMode is set to \"error\".",
+			"tenantIdRequired": "The tenant ID is required when multi-tenancy is enabled."
+		},
+		"userUpdate": {
+			"tenantIdRequired": "The tenant ID is required when multi-tenancy is enabled."
 		},
 		"vaultKeyCreate": {
 			"vaultKeyAlreadyExists": "The vault key with ID already exists and overwriteMode is set to \"error\"."
@@ -291,6 +295,10 @@
 		"contextIdStore": {
 			"asyncHooksNotAvailable": "Async Hooks are not available in this environment, please ensure you are running in Node.js"
 		},
+		"entitySchemaDiffHelper": {
+			"duplicateOldProperty": "The oldProperties array contains a duplicate property key \"{property}\"",
+			"duplicateNewProperty": "The newProperties array contains a duplicate property key \"{property}\""
+		},
 		"entitySchemaHelper": {
 			"noIsPrimary": "Property \"entitySchema.properties\" must contain a value with isPrimary set",
 			"multipleIsPrimary": "Property \"entitySchema.properties\" contains more than one property with isPrimary set",
@@ -299,6 +307,11 @@
 			"invalidOptional": "The entity property \"{property}\" of type \"{type}\" is not optional, but no value has been provided",
 			"invalidEntityKeys": "The entity had additional properties that are not in the schema, \"{keys}\""
 		},
+		"migrationHelper": {
+			"migrationFailed": "Migration failed.",
+			"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"
+		},
 		"vaultConnectorHelper": {
 			"invalidSignature": "The JSON Web token signature could not be verified"
 		},
@@ -400,6 +413,9 @@
 			"verificationMethodNotFound": "The verification method \"{methodName}\" of type \"{methodType}\" could not be found",
 			"verificationMethodJwkNotFound": "The verification method \"{methodName}\" of type \"{methodType}\" is missing the JWK"
 		},
+		"silentTelemetryConnector": {
+			"notSupported": "The method \"{methodName}\" is not supported on silent telemetry connector."
+		},
 		"attestationService": {
 			"noConnectors": "There are no connectors registered with the attestation factory",
 			"attestFailed": "The attestation of the data failed",
@@ -415,6 +431,9 @@
 			"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",
 			"getFailed": "Getting the Auditable Item Graph vertex failed",
+			"getVersionFailed": "Getting the Auditable Item Graph vertex version failed",
+			"getVersionsFailed": "Getting the Auditable Item Graph vertex versions failed",
+			"versionNotFound": "The version with the Id \"{notFoundId}\" was not found",
 			"updatingFailed": "Updating the Auditable Item Graph vertex failed",
 			"queryingFailed": "Querying the Auditable Item Graph failed",
 			"removeVerifiableFailed": "Removing the verifiable data the Auditable Item Graph vertex failed",
@@ -653,11 +672,13 @@
 			"containerCreateFailed": "The container couldn't be created \"{containerId}\"",
 			"databaseCreateFailed": "Unable to create database \"{databaseId}\"",
 			"containerDoesNotExist": "Container \"{containerId}\" does not exist",
+			"getPartitionContextIdsFailed": "Unable to get partition context ids",
 			"setBatchFailed": "Unable to set batch of entities",
 			"countFailed": "Unable to count entities",
 			"emptyFailed": "Unable to empty entity storage",
 			"removeBatchFailed": "Unable to remove batch of entities",
-			"teardownFailed": "Unable to teardown entity storage"
+			"teardownFailed": "Unable to teardown entity storage",
+			"finalizeMigrationFailedBootstrap": "Finalizing migration failed during bootstrap phase"
 		},
 		"dynamoDbEntityStorageConnector": {
 			"tableCreateFailed": "Creating table \"{tableName}\" failed",
@@ -671,11 +692,13 @@
 			"sortSingle": "You can only sort by a single property",
 			"sortNotIndexed": "The property \"{property}\" is not indexed and cannot be used for sorting",
 			"propertyNotFound": "The property \"{property}\" was not found on the entity schema",
+			"getPartitionContextIdsFailed": "Unable to get partition context ids",
 			"setBatchFailed": "Unable to set batch of entities",
 			"removeBatchFailed": "Unable to remove batch of entities",
 			"emptyFailed": "Unable to empty entity storage",
 			"countFailed": "Unable to count entities",
-			"teardownFailed": "Unable to teardown entity storage"
+			"teardownFailed": "Unable to teardown entity storage",
+			"finalizeMigrationFailedBootstrap": "Finalizing migration failed during bootstrap phase"
 		},
 		"fileEntityStorageConnector": {
 			"directoryCreateFailed": "Creating directory \"{directory}\" failed",
@@ -685,6 +708,7 @@
 		},
 		"firestoreEntityStorageConnector": {
 			"firestoreCreationFailed": "Failed to connect to Firestore",
+			"getPartitionContextIdsFailed": "Unable to get partition context ids",
 			"setEntityFailed": "Failed to set entity \"{id}\"",
 			"getEntityFailed": "Failed to get entity \"{id}\"",
 			"removeEntityFailed": "Failed to remove entity \"{id}\"",
@@ -694,7 +718,8 @@
 			"countFailed": "Unable to count entities",
 			"emptyFailed": "Failed to empty entity storage",
 			"removeBatchFailed": "Unable to remove batch of entities",
-			"teardownFailed": "Unable to teardown entity storage"
+			"teardownFailed": "Unable to teardown entity storage",
+			"finalizeMigrationFailedBootstrap": "Finalizing migration failed during bootstrap phase"
 		},
 		"mongoDbEntityStorageConnector": {
 			"setFailed": "Unable to set entity \"{id}\"",
@@ -706,7 +731,9 @@
 			"removeBatchFailed": "Unable to remove batch of entities",
 			"emptyFailed": "Unable to empty entity storage",
 			"countFailed": "Unable to count entities",
-			"teardownFailed": "Unable to teardown entity storage"
+			"teardownFailed": "Unable to teardown entity storage",
+			"getPartitionContextIdsFailed": "Unable to get partition context ids",
+			"finalizeMigrationFailedBootstrap": "Finalizing migration failed during bootstrap phase"
 		},
 		"mySqlEntityStorageConnector": {
 			"setFailed": "Unable to set entity \"{id}\"",
@@ -721,7 +748,9 @@
 			"countFailed": "Unable to count entities",
 			"emptyFailed": "Unable to empty entity storage",
 			"removeBatchFailed": "Unable to remove batch of entities",
-			"teardownFailed": "Unable to teardown entity storage"
+			"teardownFailed": "Unable to teardown entity storage",
+			"getPartitionContextIdsFailed": "Unable to get partition context ids",
+			"finalizeMigrationFailedBootstrap": "Finalizing migration failed during bootstrap phase"
 		},
 		"postgreSqlEntityStorageConnector": {
 			"databaseCreateFailed": "Unable to create database \"{databaseName}\"",
@@ -736,7 +765,9 @@
 			"countFailed": "Unable to count entities",
 			"emptyFailed": "Unable to empty entity storage",
 			"removeBatchFailed": "Unable to remove batch of entities",
-			"teardownFailed": "Unable to teardown entity storage"
+			"teardownFailed": "Unable to teardown entity storage",
+			"getPartitionContextIdsFailed": "Unable to get partition context ids",
+			"finalizeMigrationFailedBootstrap": "Finalizing migration failed during bootstrap phase"
 		},
 		"scyllaDBTableConnector": {
 			"tableCreateFailed": "Creating table \"{table}\" failed",
@@ -745,7 +776,9 @@
 			"setBatchFailed": "Setting batch of items failed",
 			"emptyFailed": "Emptying entity storage failed",
 			"removeBatchFailed": "Remove batch of entities failed",
-			"teardownFailed": "Teardown entity storage failed"
+			"teardownFailed": "Teardown entity storage failed",
+			"getPartitionContextIdsFailed": "Unable to get partition context ids",
+			"finalizeMigrationFailedBootstrap": "Finalizing migration failed during bootstrap phase"
 		},
 		"scyllaDBViewConnector": {
 			"viewCreateFailed": "Creating view \"{view}\" failed",
@@ -756,6 +789,9 @@
 			"findFailed": "Error while querying data on  \"{table}\"",
 			"parseJSONFailed": "Parsing JSON failed for field \"{name}\" with value \"{value}\"",
 			"comparisonNotSupported": "Dot-notation nested property path \"{property}\" is not supported in CQL queries",
+			"notEqualsNotSupported": "The NotEquals operator is not supported in CQL queries for property \"{property}\"",
+			"notIncludesNotSupported": "The NotIncludes operator is not supported in CQL queries for property \"{property}\"",
+			"orConditionNotSupported": "OR logical operators are not supported in CQL queries",
 			"countFailed": "Unable to count entities"
 		},
 		"synchronisedEntityStorageConnector": {
@@ -1186,12 +1222,12 @@
 			"gaugeNoIncDec": "A gauge can not be incremented or decremented",
 			"maxHistoryMustBePositiveInteger": "The maxHistory option must be a positive integer"
 		},
-		"silentTelemetryConnector": {
-			"notSupported": "The method \"{methodName}\" is not supported on silent telemetry connector."
-		},
 		"openTelemetryTelemetryConnector": {
 			"unknownReaderType": "The reader type \"{type}\" is not supported, valid values are: prometheus"
 		},
+		"metricsCollectorService": {
+			"producerCollectionFailed": "Failed to collect metrics from producer \"{producer}\""
+		},
 		"trustService": {
 			"notVerified": "Payload verification failed",
 			"noGeneratorsRegistered": "No trust generators are registered in the factory",
@@ -1717,6 +1753,9 @@
 						"organization-identity": {
 							"description": "The organization DID to associate the user with."
 						},
+						"tenant-id": {
+							"description": "The tenant ID to associate the user with."
+						},
 						"email": {
 							"description": "The email address of the user."
 						},
@@ -1772,6 +1811,9 @@
 						"organization-identity": {
 							"description": "The organization DID to associate the user with."
 						},
+						"tenant-id": {
+							"description": "The tenant ID to associate the user with."
+						},
 						"email": {
 							"description": "The email address of the user."
 						},

package/docs/changelog.md

@@ -1,5 +1,115 @@
 # Changelog
 
+## [0.0.3-next.39](https://github.com/iotaledger/twin-node/compare/node-v0.0.3-next.38...node-v0.0.3-next.39) (2026-05-21)
+
+
+### Miscellaneous Chores
+
+* **node:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/node-core bumped from 0.0.3-next.38 to 0.0.3-next.39
+
+## [0.0.3-next.38](https://github.com/iotaledger/twin-node/compare/node-v0.0.3-next.37...node-v0.0.3-next.38) (2026-05-20)
+
+
+### Features
+
+* add auth admin component ([1661e57](https://github.com/iotaledger/twin-node/commit/1661e57a699d5cf9ebde333e3cbc3aaea89d7c9c))
+* add automation ([cfc63b4](https://github.com/iotaledger/twin-node/commit/cfc63b465c139280f696877df21d54dc6a065a7e))
+* add CLI commands and remove automated bootstrap code ([#69](https://github.com/iotaledger/twin-node/issues/69)) ([6e40933](https://github.com/iotaledger/twin-node/commit/6e40933d8bb820b380e1074fc88feeedca0ef7d9))
+* add context id features ([#53](https://github.com/iotaledger/twin-node/issues/53)) ([827adf5](https://github.com/iotaledger/twin-node/commit/827adf52cb87fca53cec52b27e67f7a9dba2c088))
+* add data space connector ([157e8b0](https://github.com/iotaledger/twin-node/commit/157e8b0a76e3a8a63c1991924f7f963eb83e27ae))
+* add extend engine and server methods ([ec09c7e](https://github.com/iotaledger/twin-node/commit/ec09c7eb882d9f5797f2fd372e96cad1a3716f59))
+* add extend engine and server methods ([0136a6f](https://github.com/iotaledger/twin-node/commit/0136a6f3f4e1a82b1427ee9618b8a17c79bc7fda))
+* add extensions support ([476d5a8](https://github.com/iotaledger/twin-node/commit/476d5a864026a2f78e5b02bc9eb81359777a4a45))
+* add fedcat to openapi ([eac69bd](https://github.com/iotaledger/twin-node/commit/eac69bdf94a22c35fe58e7523d9cf78bdc72eb7b))
+* add missing export ([e8eb621](https://github.com/iotaledger/twin-node/commit/e8eb6213937a202520b164a9970a891004122b61))
+* add notarization ([#121](https://github.com/iotaledger/twin-node/issues/121)) ([b2a11df](https://github.com/iotaledger/twin-node/commit/b2a11df92c7b5026f73f08a018c0586ebe008e92))
+* add obligation enforcers and multi instance support ([#89](https://github.com/iotaledger/twin-node/issues/89)) ([d81af99](https://github.com/iotaledger/twin-node/commit/d81af99b8c4db6e9a1370b7065bf6d9d222c71ed))
+* add rights management components ([0fc6293](https://github.com/iotaledger/twin-node/commit/0fc629332db24494bd73003625c7bf3f939a2597))
+* add support for dynamodb connection timeout ([63051b0](https://github.com/iotaledger/twin-node/commit/63051b0d22138079115dfac921e7f0c45eaad34e))
+* add synchronised storage config ([e315869](https://github.com/iotaledger/twin-node/commit/e315869adbffcd7fe5d3ce151dd35f662f6134a9))
+* add trust and rights management plugin support ([cdeb504](https://github.com/iotaledger/twin-node/commit/cdeb504ee5986a347466162b9afa781645b4a54c))
+* add trust ttl ([#73](https://github.com/iotaledger/twin-node/issues/73)) ([911cee7](https://github.com/iotaledger/twin-node/commit/911cee771bba490143bb1574ca8360f7cf8baa1a))
+* add updated config vars ([ebe8178](https://github.com/iotaledger/twin-node/commit/ebe81788ce53ddf3d6925a5f2f6dac381f84f06c))
+* add validate-locales ([1a19dcb](https://github.com/iotaledger/twin-node/commit/1a19dcb005c2f0e3103e290db28c48a3464094cb))
+* add vault prefix configuration ([#75](https://github.com/iotaledger/twin-node/issues/75)) ([1d4afb1](https://github.com/iotaledger/twin-node/commit/1d4afb1b1a8aa60795898eeb9e7f5153c279527d))
+* adding npm and https protocols to load extensions ([#45](https://github.com/iotaledger/twin-node/issues/45)) ([33940b7](https://github.com/iotaledger/twin-node/commit/33940b7e771a0c5af32c18d442deb26a8631fd02))
+* additional options for enabling components ([e13d772](https://github.com/iotaledger/twin-node/commit/e13d7721a0dd7143d456fff246622cbe63dbd0f1))
+* additional route logging env vars ([7152c88](https://github.com/iotaledger/twin-node/commit/7152c887c3ba76778e2d9e68ba57198b8d81d802))
+* align node module with dataspace rename and control plane integ… ([#95](https://github.com/iotaledger/twin-node/issues/95)) ([8129868](https://github.com/iotaledger/twin-node/commit/812986886fb5d779dd380956c4e6cc47c2d73530))
+* custom REST paths ([#99](https://github.com/iotaledger/twin-node/issues/99)) ([dcab1b2](https://github.com/iotaledger/twin-node/commit/dcab1b2b23c13b4c9f39c3c1c67284f56e732bd1))
+* enable N2N dataspace protocol with synchronized storage ([#98](https://github.com/iotaledger/twin-node/issues/98)) ([f67e366](https://github.com/iotaledger/twin-node/commit/f67e366c5ed3c829955a62b19c420361f035a578))
+* env var simplification ([460b0f2](https://github.com/iotaledger/twin-node/commit/460b0f20a73cb482f7443af502f261d5f9d01759))
+* env-prefix option and user-update cli command ([#83](https://github.com/iotaledger/twin-node/issues/83)) ([fc48efa](https://github.com/iotaledger/twin-node/commit/fc48efa7ad72173def048170c3afb5eeb9f1b292))
+* eslint migration to flat config ([080db74](https://github.com/iotaledger/twin-node/commit/080db746390230f78725d214bc957da2efee9eb1))
+* exclude unece codes from open api spec ([16b72f3](https://github.com/iotaledger/twin-node/commit/16b72f37af0d5aa107e5007741690a3fc043153a))
+* first metrics in the core and app for testing ([#139](https://github.com/iotaledger/twin-node/issues/139)) ([abe17bb](https://github.com/iotaledger/twin-node/commit/abe17bb9a6261dcb7fd46253221182fbb1dc2259))
+* health and url transformer ([#131](https://github.com/iotaledger/twin-node/issues/131)) ([3658903](https://github.com/iotaledger/twin-node/commit/36589036b9bea120880fc395b0d123a89032cf40))
+* improve bootstrapping and shutdown behaviour ([#66](https://github.com/iotaledger/twin-node/issues/66)) ([65b3452](https://github.com/iotaledger/twin-node/commit/65b345240334bfff48b52e136cc486cd7ac7f290))
+* improve default options and spec ([b538721](https://github.com/iotaledger/twin-node/commit/b538721902e7f65021d2715148ba59409ccce035))
+* improve node logging ([c25b9c6](https://github.com/iotaledger/twin-node/commit/c25b9c6779bdb76f341df072c39b4c2fae4565a3))
+* initial commit ([522f1e5](https://github.com/iotaledger/twin-node/commit/522f1e515348f9b1dd1eeb3170b1249e2b0b5371))
+* migrate env config from engine to node ([5da29b8](https://github.com/iotaledger/twin-node/commit/5da29b8d714495308320d237a68e84355bba2b47))
+* multi-tenant env wiring, trust auto-enable, tenant-token vault key, engine-driven callbackPath ([#128](https://github.com/iotaledger/twin-node/issues/128)) ([0de4d35](https://github.com/iotaledger/twin-node/commit/0de4d356fb2f825afae5469005d475700f510ee4))
+* node app use JavaScript ([14fe08c](https://github.com/iotaledger/twin-node/commit/14fe08cb760dd885a5dac9056a4d5dbc3d61df64))
+* remove dap and darp ([36c3ffb](https://github.com/iotaledger/twin-node/commit/36c3ffb31af65a0e3025859dab675efeee043155))
+* separate script directory from exec directory ([f6bb4db](https://github.com/iotaledger/twin-node/commit/f6bb4dbea1f1e200e0640fa154c6997ef99c99b4))
+* support multiple entity and blob storage connectors ([a489f79](https://github.com/iotaledger/twin-node/commit/a489f7907544aef5708d5111e9f72985e1377bae))
+* support public origin and hosting service ([#77](https://github.com/iotaledger/twin-node/issues/77)) ([3b9039f](https://github.com/iotaledger/twin-node/commit/3b9039fcba7f7038c06f8fd6a5ccc9fdbbf535b3))
+* typescript 6 update ([ce2e3ca](https://github.com/iotaledger/twin-node/commit/ce2e3ca5219587709f7b9cf6c65909b48fba11b5))
+* update background tasks and add fedcat filters ([1fd297e](https://github.com/iotaledger/twin-node/commit/1fd297e29f60b5bb3909638b68e326c5b0e2d77d))
+* update dependencies ([aab05b5](https://github.com/iotaledger/twin-node/commit/aab05b552152a208a504fb9a080603f1990d4f79))
+* update dependencies ([6cb3d3a](https://github.com/iotaledger/twin-node/commit/6cb3d3a63f7b976f80074ddecfba034b7e92f919))
+* update dependencies ([351f777](https://github.com/iotaledger/twin-node/commit/351f777e001bf4183762657fc565b133a317600a))
+* update dependencies ([9d25f16](https://github.com/iotaledger/twin-node/commit/9d25f16f1d554cd38f3bec28fdf7f8fff892ceaf))
+* update docs ([409126a](https://github.com/iotaledger/twin-node/commit/409126a1325998face4634426b71682944c6a504))
+* update engine ([a40b377](https://github.com/iotaledger/twin-node/commit/a40b37726c3b61c6bb40265ec0006d1071ffac7e))
+* update engine ([4b438e2](https://github.com/iotaledger/twin-node/commit/4b438e22c27d784ee6cc964b7cb4401e9699ab16))
+* update for livez endpoint ([9fc2e6a](https://github.com/iotaledger/twin-node/commit/9fc2e6ade38b3ec9591399a633d02b1e5fe07910))
+* update framework components ([4bee2b9](https://github.com/iotaledger/twin-node/commit/4bee2b9d3651df09b8550a9ed226be1b46031854))
+* update framework core ([8bd769a](https://github.com/iotaledger/twin-node/commit/8bd769a4451f5f1f6be3f115a5e94eeb05bce7f1))
+* update rights management ([5c992c6](https://github.com/iotaledger/twin-node/commit/5c992c6b0d72f3eeaa39ee267e096d9a3f477f4e))
+* update rights management components ([176a0d6](https://github.com/iotaledger/twin-node/commit/176a0d611f88360fc845ae233b26ee0b43d7cb23))
+* update spec generation config ([cff633a](https://github.com/iotaledger/twin-node/commit/cff633a0ffb73ad652d5f1bae653fa91e82dc8ab))
+* update to latest engine ([00d4974](https://github.com/iotaledger/twin-node/commit/00d4974f9cfb02bf48505cfb4af4a7aba1df4b3d))
+* update twindev schemas ([b7bb6ba](https://github.com/iotaledger/twin-node/commit/b7bb6ba308eaf10b66d349ada8f3880f15b31e0f))
+* updated context id features ([ef7be07](https://github.com/iotaledger/twin-node/commit/ef7be07d44dccdeacf10f90cb4ffde0303faa6fa))
+
+
+### Bug Fixes
+
+* adding a condition to verify if the password exists when bootstrapping ([6030a42](https://github.com/iotaledger/twin-node/commit/6030a42bdaf581678d96932fd0b809396bf7b8b0))
+* adding a condition to verify if the password exists when bootstrapping ([c66f396](https://github.com/iotaledger/twin-node/commit/c66f396717394161a7647d1f08b3d87729d96e96))
+* broken docs ([61479fd](https://github.com/iotaledger/twin-node/commit/61479fd618f766d22c5aafec5277e1a89e22b453))
+* improve calculation of execution directory ([106d65d](https://github.com/iotaledger/twin-node/commit/106d65d7ad5524e2e147b681d68f9476c024cfaa))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/node-core bumped from 0.0.3-next.37 to 0.0.3-next.38
+
+## [0.0.3-next.37](https://github.com/iotaledger/twin-node/compare/node-v0.0.3-next.36...node-v0.0.3-next.37) (2026-05-19)
+
+
+### Miscellaneous Chores
+
+* **node:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/node-core bumped from 0.0.3-next.36 to 0.0.3-next.37
+
 ## [0.0.3-next.36](https://github.com/iotaledger/twin-node/compare/node-v0.0.3-next.35...node-v0.0.3-next.36) (2026-05-12)
 
 

package/docs/open-api/spec.json

@@ -1224,7 +1224,7 @@
 						"content": {
 							"application/json": {
 								"schema": {
-									"$ref": "#/components/schemas/AdminUserGetResponse"
+									"$ref": "#/components/schemas/AuthenticationUser"
 								},
 								"examples": {
 									"getUserResponseExample": {
@@ -1529,7 +1529,7 @@
 						"content": {
 							"application/json": {
 								"schema": {
-									"$ref": "#/components/schemas/AdminUserGetResponse"
+									"$ref": "#/components/schemas/AuthenticationUser"
 								},
 								"examples": {
 									"getUserResponseExample": {
@@ -12253,6 +12253,282 @@
 				}
 			}
 		},
+		"/aig/{id}/versions/{versionId}": {
+			"get": {
+				"operationId": "auditableItemGraphVersionGet",
+				"summary": "Get a graph vertex at a specific version",
+				"tags": [
+					"Auditable Item Graph"
+				],
+				"parameters": [
+					{
+						"name": "id",
+						"description": "The id of the vertex.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "aig:1234567890"
+					},
+					{
+						"name": "versionId",
+						"description": "The id of the version (changeset id) to get.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "changeset:1234567890"
+					},
+					{
+						"name": "accept",
+						"in": "header",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "application/json"
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"responses": {
+					"200": {
+						"description": "Response to getting an auditable item graph vertex at a specific version.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "https://schema.twindev.org/aig/AuditableItemGraphVertex"
+								},
+								"examples": {
+									"auditableItemGraphVersionGetResponseExample": {
+										"value": {
+											"@context": [
+												"https://schema.twindev.org/aig/",
+												"https://schema.twindev.org/common/",
+												"https://schema.org"
+											],
+											"type": "AuditableItemGraphVertex",
+											"id": "aig:1234567890",
+											"dateCreated": "2024-08-22T11:55:16.271Z",
+											"version": 1
+										}
+									}
+								}
+							}
+						}
+					},
+					"400": {
+						"description": "The server cannot process the request, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "GeneralError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
+					"500": {
+						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "InternalServerError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+		},
+		"/aig/{id}/versions": {
+			"get": {
+				"operationId": "auditableItemGraphVersionList",
+				"summary": "Get all versions of a graph vertex",
+				"tags": [
+					"Auditable Item Graph"
+				],
+				"parameters": [
+					{
+						"name": "id",
+						"description": "The id of the vertex.",
+						"in": "path",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "aig:1234567890"
+					},
+					{
+						"name": "after",
+						"description": "Only return versions created after this ISO 8601 timestamp (exclusive).",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "before",
+						"description": "Only return versions created before this ISO 8601 timestamp (exclusive).",
+						"in": "query",
+						"required": false,
+						"schema": {
+							"type": "string"
+						}
+					},
+					{
+						"name": "accept",
+						"in": "header",
+						"required": true,
+						"schema": {
+							"type": "string"
+						},
+						"style": "simple",
+						"example": "application/json"
+					}
+				],
+				"security": [
+					{
+						"jwtBearerAuthScheme": []
+					}
+				],
+				"responses": {
+					"200": {
+						"description": "Response to getting all versions of an auditable item graph vertex.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "https://schema.twindev.org/aig/AuditableItemGraphVertexVersionList"
+								},
+								"examples": {
+									"auditableItemGraphVersionListResponseExample": {
+										"value": {
+											"@context": [
+												"https://schema.org",
+												"https://schema.twindev.org/aig/",
+												"https://schema.twindev.org/common/"
+											],
+											"type": [
+												"ItemList",
+												"AuditableItemGraphVertexVersionList"
+											],
+											"itemListElement": [
+												0,
+												1,
+												2
+											]
+										}
+									}
+								}
+							}
+						}
+					},
+					"400": {
+						"description": "The server cannot process the request, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "GeneralError",
+											"message": "errorMessage",
+											"properties": {
+												"foo": "bar"
+											}
+										}
+									}
+								}
+							}
+						}
+					},
+					"401": {
+						"description": "You are not authorized to use the API or no credentials were supplied, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "UnauthorizedError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					},
+					"500": {
+						"description": "The server has encountered a situation it does not know how to handle, see the content for more details.",
+						"content": {
+							"application/json": {
+								"schema": {
+									"$ref": "#/components/schemas/Error"
+								},
+								"examples": {
+									"exampleResponse": {
+										"value": {
+											"name": "InternalServerError",
+											"message": "errorMessage"
+										}
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+		},
 		"/aig/{id}/changesets/{changesetId}": {
 			"get": {
 				"operationId": "auditableItemGraphChangesetGet",
@@ -20082,71 +20358,21 @@
 				]
 			},
 			"AdminUserCreateRequest": {
-				"description": "The body of the request.",
 				"type": "object",
 				"properties": {
-					"email": {
-						"type": "string",
-						"description": "The user e-mail address."
-					},
 					"password": {
-						"type": "string",
-						"description": "The encrypted password for the user."
-					},
-					"userIdentity": {
-						"type": "string",
-						"description": "The user identity."
-					},
-					"organizationIdentity": {
-						"type": "string",
-						"description": "The users organization."
-					},
-					"scope": {
-						"type": "array",
-						"items": {
-							"type": "string"
-						},
-						"description": "The scope assigned to the user, comma separated."
+						"type": "string"
 					}
 				},
 				"required": [
-					"email",
-					"password",
-					"userIdentity",
-					"organizationIdentity",
-					"scope"
-				]
-			},
-			"AdminUserGetResponse": {
-				"description": "The body of the request.",
-				"type": "object",
-				"properties": {
-					"email": {
-						"type": "string",
-						"description": "The user e-mail address."
-					},
-					"userIdentity": {
-						"type": "string",
-						"description": "The user identity."
-					},
-					"organizationIdentity": {
-						"type": "string",
-						"description": "The users organization."
-					},
-					"scope": {
-						"type": "array",
-						"items": {
-							"type": "string"
-						},
-						"description": "The scope assigned to the user, comma separated."
+					"password"
+				],
+				"allOf": [
+					{
+						"$ref": "#/components/schemas/AuthenticationUser"
 					}
-				},
-				"required": [
-					"email",
-					"userIdentity",
-					"organizationIdentity",
-					"scope"
-				]
+				],
+				"description": "The body of the request."
 			},
 			"AdminUserUpdatePasswordRequest": {
 				"type": "object",
@@ -20420,6 +20646,10 @@
 					"verified": {
 						"type": "boolean",
 						"description": "Is the vertex verified, will only be populated when verification is requested."
+					},
+					"version": {
+						"type": "number",
+						"description": "The version of the vertex, populated only when getting a specific version.\nMaps to https://schema.org/version."
 					}
 				},
 				"required": [
@@ -20494,6 +20724,10 @@
 					"verified": {
 						"type": "boolean",
 						"description": "Is the vertex verified, will only be populated when verification is requested."
+					},
+					"version": {
+						"type": "number",
+						"description": "The version of the vertex, populated only when getting a specific version.\nMaps to https://schema.org/version."
 					}
 				},
 				"required": [
@@ -20670,6 +20904,37 @@
 					"dateCreated"
 				]
 			},
+			"AuthenticationUser": {
+				"description": "Contract definition for authentication user.",
+				"type": "object",
+				"properties": {
+					"email": {
+						"type": "string",
+						"description": "The user e-mail address."
+					},
+					"userIdentity": {
+						"type": "string",
+						"description": "The user identity."
+					},
+					"organizationIdentity": {
+						"type": "string",
+						"description": "The users organization."
+					},
+					"scope": {
+						"type": "array",
+						"items": {
+							"type": "string"
+						},
+						"description": "The scope assigned to the user, comma separated."
+					}
+				},
+				"required": [
+					"email",
+					"userIdentity",
+					"organizationIdentity",
+					"scope"
+				]
+			},
 			"AutomationActionCreateRequest": {
 				"description": "The body parameters for the request.",
 				"type": "object",
@@ -21460,6 +21725,20 @@
 					"expirationDate": {
 						"type": "string",
 						"description": "The date the verifiable credential is valid until."
+					},
+					"jwtHeaderFields": {
+						"type": "object",
+						"additionalProperties": {
+							"type": "string"
+						},
+						"description": "Additional fields to include in the JWT when creating the verifiable credential in jwt format."
+					},
+					"jwtPayloadFields": {
+						"type": "object",
+						"additionalProperties": {
+							"type": "string"
+						},
+						"description": "Additional fields to include in the JWT payload when creating the verifiable credential in jwt format."
 					}
 				},
 				"required": [
@@ -21541,6 +21820,20 @@
 					"expirationDate": {
 						"type": "string",
 						"description": "The expiration date/time for the presentation."
+					},
+					"jwtHeaderFields": {
+						"type": "object",
+						"additionalProperties": {
+							"type": "string"
+						},
+						"description": "Additional fields to include in the JWT header when creating the verifiable presentation in jwt format."
+					},
+					"jwtPayloadFields": {
+						"type": "object",
+						"additionalProperties": {
+							"type": "string"
+						},
+						"description": "Additional fields to include in the JWT payload when creating the verifiable presentation in jwt format."
 					}
 				},
 				"required": [
@@ -21736,6 +22029,19 @@
 				},
 				"description": "The logout token details."
 			},
+			"MetricCounterOperation": {
+				"description": "The types of metric counter operations.",
+				"anyOf": [
+					{
+						"const": "inc",
+						"description": "Increment Counter."
+					},
+					{
+						"const": "dec",
+						"description": "Decrement Counter."
+					}
+				]
+			},
 			"MetricType": {
 				"description": "The types of metrics.",
 				"anyOf": [
@@ -22581,7 +22887,10 @@
 					},
 					"target": {
 						"type": "string",
-						"description": "The target path of where to store the extracted data.\nSupports simple dotted path notation, and numeric index notation."
+						"description": "The target path of where to store the extracted data.\nSupports simple dotted path notation, and numeric index notation.",
+						"examples": [
+							"\"path.to.data\" or \"path.to.data.0\""
+						]
 					},
 					"retainPathDepth": {
 						"type": "number",
@@ -22842,10 +23151,7 @@
 					"value": {
 						"anyOf": [
 							{
-								"const": "inc"
-							},
-							{
-								"const": "dec"
+								"$ref": "#/components/schemas/MetricCounterOperation"
 							},
 							{
 								"type": "number"

package/package.json

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