@twin.org/node 0.0.3-next.62 → 0.0.3-next.63

package/docs/changelog.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.0.3-next.63](https://github.com/iotaledger/twin-node/compare/node-v0.0.3-next.62...node-v0.0.3-next.63) (2026-06-22)
+
+
+### Features
+
+* update document management components ([ed2c065](https://github.com/iotaledger/twin-node/commit/ed2c065a5030a7233f3623818d7325d85654ef0d))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/node-core bumped from 0.0.3-next.62 to 0.0.3-next.63
+
 ## [0.0.3-next.62](https://github.com/iotaledger/twin-node/compare/node-v0.0.3-next.61...node-v0.0.3-next.62) (2026-06-19)
 
 

package/docs/open-api/spec.json

@@ -10542,16 +10542,20 @@
 							"examples": {
 								"DocumentManagementCreateRequestExample": {
 									"value": {
-										"documentId": "2721000",
-										"documentIdFormat": "bol",
-										"documentCode": "unece:DocumentCodeList#705",
-										"blob": "SGVsbG8gV29ybGQ=",
-										"annotationObject": {
-											"@context": "https://schema.org",
-											"@type": "DigitalDocument",
-											"name": "myfile.pdf"
+										"document": {
+											"documentId": "2721000",
+											"documentIdFormat": "bol",
+											"documentCode": "unece:DocumentCodeList#705",
+											"annotationObject": {
+												"@context": "https://schema.org",
+												"@type": "DigitalDocument",
+												"name": "myfile.pdf"
+											}
 										},
-										"createAttestation": true
+										"blob": "SGVsbG8gV29ybGQ=",
+										"options": {
+											"includeAttestation": true
+										}
 									}
 								}
 							}
@@ -10811,12 +10815,14 @@
 							"examples": {
 								"DocumentManagementUpdatePartialRequestExample": {
 									"value": {
-										"blob": "SGVsbG8gV29ybGQ=",
-										"annotationObject": {
-											"@context": "https://schema.org",
-											"@type": "DigitalDocument",
-											"name": "myfile.pdf"
-										}
+										"document": {
+											"annotationObject": {
+												"@context": "https://schema.org",
+												"@type": "DigitalDocument",
+												"name": "myfile.pdf"
+											}
+										},
+										"blob": "SGVsbG8gV29ybGQ="
 									}
 								}
 							}
@@ -21717,23 +21723,12 @@
 			"DocumentManagementCreateRequest": {
 				"type": "object",
 				"properties": {
-					"documentId": {
-						"type": "string",
-						"description": "The document id to create."
-					},
-					"documentIdFormat": {
-						"type": "string",
-						"description": "The format of the document identifier."
-					},
-					"documentCode": {
-						"$ref": "https://schema.twindev.org/unece/UneceDocumentCodeList"
+					"document": {
+						"$ref": "https://schema.twindev.org/documents/DocumentBase"
 					},
 					"blob": {
 						"type": "string",
-						"description": "The data to create the document with, in base64."
-					},
-					"annotationObject": {
-						"$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+						"description": "The data to create the document with, either as base64-encoded content or an existing blob storage entry id."
 					},
 					"auditableItemGraphEdges": {
 						"type": "array",
@@ -21742,22 +21737,26 @@
 						},
 						"description": "The auditable item graph vertices to connect the document to."
 					},
-					"createAttestation": {
-						"type": "boolean",
-						"description": "Flag to create an attestation for the document, defaults to false."
-					},
-					"addAlias": {
-						"type": "boolean",
-						"description": "Flag to add the document id as an alias to the aig vertex, defaults to true."
-					},
-					"aliasAnnotationObject": {
-						"$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+					"options": {
+						"type": "object",
+						"properties": {
+							"includeAttestation": {
+								"type": "boolean",
+								"description": "Flag to create an attestation for the document, defaults to false."
+							},
+							"includeAlias": {
+								"type": "boolean",
+								"description": "Flag to add the document id as an alias to the aig vertex, defaults to true."
+							},
+							"aliasAnnotationObject": {
+								"$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+							}
+						},
+						"description": "Additional options for the create operation."
 					}
 				},
 				"required": [
-					"documentId",
-					"documentIdFormat",
-					"documentCode",
+					"document",
 					"blob"
 				],
 				"description": "The body parameters."
@@ -21765,12 +21764,25 @@
 			"DocumentManagementUpdatePartialRequest": {
 				"type": "object",
 				"properties": {
+					"document": {
+						"description": "The document base properties to update. annotationObject, documentIdFormat and documentCode are applied in-place to the current revision.",
+						"type": "object",
+						"properties": {
+							"documentIdFormat": {
+								"type": "string",
+								"description": "The format of the document id."
+							},
+							"documentCode": {
+								"$ref": "https://schema.twindev.org/unece/UneceDocumentCodeList"
+							},
+							"annotationObject": {
+								"$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+							}
+						}
+					},
 					"blob": {
 						"type": "string",
-						"description": "The data to update the document with, in base64."
-					},
-					"annotationObject": {
-						"$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+						"description": "The data to update the document with, either as base64-encoded content or an existing blob storage entry id."
 					},
 					"auditableItemGraphEdges": {
 						"type": "object",
@@ -21791,6 +21803,23 @@
 							}
 						},
 						"description": "Explicit edge delta to apply. Use `add` to create new connections and `remove` to\ndisconnect existing ones by their target vertex id."
+					},
+					"options": {
+						"type": "object",
+						"properties": {
+							"includeAttestation": {
+								"type": "boolean",
+								"description": "Set to true to start attesting the document (even if originally created without attestation), or false to remove the existing attestation. Omit to leave attestation state unchanged."
+							},
+							"includeAlias": {
+								"type": "boolean",
+								"description": "Set to true to add the document id as an alias on the aig vertex, or false to remove it. Omit to leave alias state unchanged."
+							},
+							"aliasAnnotationObject": {
+								"$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
+							}
+						},
+						"description": "Additional options for the update operation."
 					}
 				},
 				"description": "The body parameters."

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/node",
-	"version": "0.0.3-next.62",
+	"version": "0.0.3-next.63",
 	"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.62"
+		"@twin.org/node-core": "0.0.3-next.63"
 	},
 	"bugs": {
 		"url": "git+https://github.com/iotaledger/twin-node/issues"