@twin.org/document-management-service 0.0.1-next.8 → 0.0.1

package/docs/reference/classes/DocumentManagementService.md

@@ -8,9 +8,9 @@ Service for performing document management operations.
 
 ## Constructors
 
-### new DocumentManagementService()
+### Constructor
 
-> **new DocumentManagementService**(`options`?): [`DocumentManagementService`](DocumentManagementService.md)
+> **new DocumentManagementService**(`options?`): `DocumentManagementService`
 
 Create a new instance of DocumentManagementService.
 
@@ -24,7 +24,7 @@ The options for the service.
 
 #### Returns
 
-[`DocumentManagementService`](DocumentManagementService.md)
+`DocumentManagementService`
 
 ## Properties
 
@@ -48,22 +48,16 @@ Runtime name for the class.
 
 ## Methods
 
-### set()
+### create()
 
-> **set**(`auditableItemGraphId`, `documentId`, `documentIdFormat`, `documentCode`, `blob`, `annotationObject`?, `options`?, `userIdentity`?, `nodeIdentity`?): `Promise`\<`string`\>
+> **create**(`documentId`, `documentIdFormat`, `documentCode`, `blob`, `annotationObject?`, `auditableItemGraphEdges?`, `options?`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`string`\>
 
-Store a document in an auditable item graph vertex and add its content to blob storage.
+Store a document as an auditable item graph vertex and add its content to blob storage.
 If the document id already exists and the blob data is different a new revision will be created.
 For any other changes the current revision will be updated.
 
 #### Parameters
 
-##### auditableItemGraphId
-
-`string`
-
-The auditable item graph vertex id to create the document on.
-
 ##### documentId
 
 `string`
@@ -86,7 +80,7 @@ The code for the document type.
 
 `Uint8Array`
 
-The data to create the document.
+The data to create the document with.
 
 ##### annotationObject?
 
@@ -94,6 +88,12 @@ The data to create the document.
 
 Additional information to associate with the document.
 
+##### auditableItemGraphEdges?
+
+`object`[]
+
+The auditable item graph vertices to connect the document to.
+
 ##### options?
 
 Additional options for the set operation.
@@ -104,17 +104,17 @@ Additional options for the set operation.
 
 Flag to create an attestation for the document, defaults to false.
 
-###### includeIdAsAlias?
+###### addAlias?
 
 `boolean`
 
-Include the document id as an alias to the aig vertex, defaults to false.
+Flag to add the document id as an alias to the aig vertex, defaults to true.
 
 ###### aliasAnnotationObject?
 
 `IJsonLdNodeObject`
 
-Additional information to associate with the alias.
+Annotation object for the alias.
 
 ##### userIdentity?
 
@@ -132,33 +132,85 @@ The node identity to use for vault operations.
 
 `Promise`\<`string`\>
 
-The identifier for the document which includes the auditable item graph identifier.
+The auditable item graph vertex created for the document including its revision.
 
 #### Implementation of
 
-`IDocumentManagementComponent.set`
+`IDocumentManagementComponent.create`
 
 ***
 
-### get()
+### update()
 
-> **get**(`auditableItemGraphId`, `identifier`, `options`?, `revisionCursor`?, `userIdentity`?, `nodeIdentity`?): `Promise`\<`IDocument`\>
+> **update**(`auditableItemGraphDocumentId`, `blob?`, `annotationObject?`, `auditableItemGraphEdges?`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`void`\>
 
-Get a specific document from an auditable item graph vertex.
+Update a document as an auditable item graph vertex and add its content to blob storage.
+If the blob data is different a new revision will be created.
+For any other changes the current revision will be updated.
 
 #### Parameters
 
-##### auditableItemGraphId
+##### auditableItemGraphDocumentId
 
 `string`
 
-The auditable item graph vertex id to get the document from.
+The auditable item graph vertex id which contains the document.
 
-##### identifier
+##### blob?
+
+`Uint8Array`\<`ArrayBufferLike`\>
+
+The data to update the document with.
+
+##### annotationObject?
+
+`IJsonLdNodeObject`
+
+Additional information to associate with the document.
+
+##### auditableItemGraphEdges?
+
+`object`[]
+
+The auditable item graph vertices to connect the document to, if undefined retains current connections.
+
+##### userIdentity?
+
+`string`
+
+The identity to perform the auditable item graph operation with.
+
+##### nodeIdentity?
 
 `string`
 
-The identifier of the document to get.
+The node identity to use for vault operations.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Nothing.
+
+#### Implementation of
+
+`IDocumentManagementComponent.update`
+
+***
+
+### get()
+
+> **get**(`auditableItemGraphDocumentId`, `options?`, `cursor?`, `pageSize?`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`IDocumentList`\>
+
+Get a document using it's auditable item graph vertex id and optional revision.
+
+#### Parameters
+
+##### auditableItemGraphDocumentId
+
+`string`
+
+The auditable item graph vertex id which contains the document.
 
 ##### options?
 
@@ -188,18 +240,30 @@ Flag to include the attestation information for the document, defaults to false.
 
 Flag to include deleted documents, defaults to false.
 
-###### maxRevisionCount?
+###### extractRuleGroupId?
 
-`number`
+`string`
+
+If provided will extract data from the document using the specified rule group id.
 
-Max number of revisions to return, defaults to 0.
+###### extractMimeType?
 
-##### revisionCursor?
+`string`
+
+By default extraction will auto detect the mime type of the document, this can be used to override the detection.
+
+##### cursor?
 
 `string`
 
 The cursor to get the next chunk of revisions.
 
+##### pageSize?
+
+`number`
+
+Page size of items to return, defaults to 1 so only most recent is returned.
+
 ##### userIdentity?
 
 `string`
@@ -214,7 +278,7 @@ The node identity to use for vault operations.
 
 #### Returns
 
-`Promise`\<`IDocument`\>
+`Promise`\<`IDocumentList`\>
 
 The documents and revisions if requested, ordered by revision descending, cursor is set if there are more document revisions.
 
@@ -224,36 +288,59 @@ The documents and revisions if requested, ordered by revision descending, cursor
 
 ***
 
-### remove()
+### getRevision()
 
-> **remove**(`auditableItemGraphId`, `identifier`, `options`?, `userIdentity`?, `nodeIdentity`?): `Promise`\<`void`\>
+> **getRevision**(`auditableItemGraphDocumentId`, `revision`, `options?`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`IDocument`\>
 
-Remove a specific document from an auditable item graph vertex.
-The documents dateDeleted will be set, but can still be queried with the includeRemoved flag.
+Get a document revision using it's auditable item graph vertex id.
 
 #### Parameters
 
-##### auditableItemGraphId
+##### auditableItemGraphDocumentId
 
 `string`
 
-The auditable item graph vertex id to remove the document from.
+The auditable item graph vertex id which contains the document.
 
-##### identifier
+##### revision
 
-`string`
+`number`
 
-The identifier of the document to remove.
+The revision id for the document.
 
 ##### options?
 
-Additional options for the remove operation.
+Additional options for the get operation.
 
-###### removeAllRevisions?
+###### includeBlobStorageMetadata?
 
 `boolean`
 
-Flag to remove all revisions of the document, defaults to false.
+Flag to include the blob storage metadata for the document, defaults to false.
+
+###### includeBlobStorageData?
+
+`boolean`
+
+Flag to include the blob storage data for the document, defaults to false.
+
+###### includeAttestation?
+
+`boolean`
+
+Flag to include the attestation information for the document, defaults to false.
+
+###### extractRuleGroupId?
+
+`string`
+
+If provided will extract data from the document using the specified rule group id.
+
+###### extractMimeType?
+
+`string`
+
+By default extraction will auto detect the mime type of the document, this can be used to override the detection.
 
 ##### userIdentity?
 
@@ -269,51 +356,74 @@ The node identity to use for vault operations.
 
 #### Returns
 
-`Promise`\<`void`\>
+`Promise`\<`IDocument`\>
 
-Nothing.
+The documents and revisions if requested, ordered by revision descending, cursor is set if there are more document revisions.
 
 #### Implementation of
 
-`IDocumentManagementComponent.remove`
+`IDocumentManagementComponent.getRevision`
 
 ***
 
-### query()
+### removeRevision()
 
-> **query**(`auditableItemGraphId`, `documentCodes`?, `options`?, `cursor`?, `userIdentity`?, `nodeIdentity`?): `Promise`\<`IDocumentList`\>
+> **removeRevision**(`auditableItemGraphDocumentId`, `revision`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`void`\>
 
-Query an auditable item graph vertex for documents.
+Remove an auditable item graph vertex using it's id.
+The document dateDeleted will be set, but can still be queried with the includeRemoved flag.
 
 #### Parameters
 
-##### auditableItemGraphId
+##### auditableItemGraphDocumentId
 
 `string`
 
-The auditable item graph vertex to get the documents from.
+The auditable item graph vertex id which contains the document.
 
-##### documentCodes?
+##### revision
 
-`string`[]
+`number`
 
-The document codes to query for, if undefined gets all document codes.
+The revision of the document to remove.
 
-##### options?
+##### userIdentity?
 
-Additional options for the query operation.
+`string`
 
-###### includeMostRecentRevisions?
+The identity to perform the auditable item graph operation with.
 
-`boolean`
+##### nodeIdentity?
 
-Include the most recent 5 revisions, use the individual get to retrieve more.
+`string`
 
-###### includeRemoved?
+The node identity to use for vault operations.
 
-`boolean`
+#### Returns
 
-Flag to include deleted documents, defaults to false.
+`Promise`\<`void`\>
+
+Nothing.
+
+#### Implementation of
+
+`IDocumentManagementComponent.removeRevision`
+
+***
+
+### query()
+
+> **query**(`documentId`, `cursor?`, `pageSize?`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`IAuditableItemGraphVertexList`\>
+
+Find all the document with a specific id.
+
+#### Parameters
+
+##### documentId
+
+`string`
+
+The document id to find in the graph.
 
 ##### cursor?
 
@@ -321,6 +431,12 @@ Flag to include deleted documents, defaults to false.
 
 The cursor to get the next chunk of documents.
 
+##### pageSize?
+
+`number`
+
+The page size to get the next chunk of documents.
+
 ##### userIdentity?
 
 `string`
@@ -335,9 +451,9 @@ The node identity to use for vault operations.
 
 #### Returns
 
-`Promise`\<`IDocumentList`\>
+`Promise`\<`IAuditableItemGraphVertexList`\>
 
-The most recent revisions of each document, cursor is set if there are more documents.
+The graph vertices that contain documents referencing the specified document id.
 
 #### Implementation of
 

package/docs/reference/functions/{documentManagementSet.md → documentManagementCreate.md}

@@ -1,8 +1,8 @@
-# Function: documentManagementSet()
+# Function: documentManagementCreate()
 
-> **documentManagementSet**(`httpRequestContext`, `componentName`, `request`): `Promise`\<`ICreatedResponse`\>
+> **documentManagementCreate**(`httpRequestContext`, `componentName`, `request`): `Promise`\<`ICreatedResponse`\>
 
-Set a document in to an auditable item graph vertex.
+Create a document as an auditable item graph vertex.
 
 ## Parameters
 
@@ -20,7 +20,7 @@ The name of the component to use in the routes.
 
 ### request
 
-`IDocumentManagementSetRequest`
+`IDocumentManagementCreateRequest`
 
 The request.
 

package/docs/reference/functions/documentManagementGetRevision.md

@@ -0,0 +1,31 @@
+# Function: documentManagementGetRevision()
+
+> **documentManagementGetRevision**(`httpRequestContext`, `componentName`, `request`): `Promise`\<`IDocumentManagementGetRevisionResponse`\>
+
+Get the document revision from the auditable item graph vertex.
+
+## Parameters
+
+### httpRequestContext
+
+`IHttpRequestContext`
+
+The request context for the API.
+
+### componentName
+
+`string`
+
+The name of the component to use in the routes.
+
+### request
+
+`IDocumentManagementGetRevisionRequest`
+
+The request.
+
+## Returns
+
+`Promise`\<`IDocumentManagementGetRevisionResponse`\>
+
+The response object with additional http response properties.

package/docs/reference/functions/documentManagementUpdate.md

@@ -0,0 +1,31 @@
+# Function: documentManagementUpdate()
+
+> **documentManagementUpdate**(`httpRequestContext`, `componentName`, `request`): `Promise`\<`INoContentResponse`\>
+
+Update the document from the auditable item graph vertex.
+
+## Parameters
+
+### httpRequestContext
+
+`IHttpRequestContext`
+
+The request context for the API.
+
+### componentName
+
+`string`
+
+The name of the component to use in the routes.
+
+### request
+
+`IDocumentManagementUpdateRequest`
+
+The request.
+
+## Returns
+
+`Promise`\<`INoContentResponse`\>
+
+The response object with additional http response properties.

package/docs/reference/index.md

@@ -17,7 +17,9 @@
 ## Functions
 
 - [generateRestRoutesDocumentManagement](functions/generateRestRoutesDocumentManagement.md)
-- [documentManagementSet](functions/documentManagementSet.md)
+- [documentManagementCreate](functions/documentManagementCreate.md)
 - [documentManagementGet](functions/documentManagementGet.md)
+- [documentManagementGetRevision](functions/documentManagementGetRevision.md)
+- [documentManagementUpdate](functions/documentManagementUpdate.md)
 - [documentManagementRemove](functions/documentManagementRemove.md)
 - [documentManagementQuery](functions/documentManagementQuery.md)

package/docs/reference/interfaces/IDocumentManagementServiceConstructorOptions.md

@@ -46,6 +46,20 @@ attestation
 
 ***
 
+### dataProcessingComponentType?
+
+> `optional` **dataProcessingComponentType**: `string`
+
+The type of the data processing component.
+
+#### Default
+
+```ts
+data-processing
+```
+
+***
+
 ### config?
 
 > `optional` **config**: [`IDocumentManagementServiceConfig`](IDocumentManagementServiceConfig.md)

package/locales/en.json

@@ -1,13 +1,14 @@
 {
 	"error": {
 		"documentManagementService": {
-			"setFailed": "Failed to set document",
+			"createFailed": "Failed to create document",
+			"updateFailed": "Failed to update document",
 			"getFailed": "Failed to get document",
-			"removeFailed": "Failed to remove document",
+			"getRevisionFailed": "Failed to get document revision",
+			"removeRevision": "Failed to remove document revision",
 			"queryFailed": "Failed to query document",
-			"invalidDocumentId": "The document id not in the correct format, it is \"{identifier}\"",
-			"invalidDocumentCode": "The document code does not follow the format unece:DocumentCodeList#1, it is \"{documentCode}\"",
-			"documentRevisionNotFound": "The document revision was not found \"{identifier}\"",
+			"documentRevisionNone": "There are no revisions in the document",
+			"documentRevisionNotFound": "There is no revision number \"{notFoundId}\" in the document",
 			"namespaceMismatch": "The namespace in the urn \"{id}\" does not match the namespace of the Document Management component \"{namespace}\""
 		}
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/document-management-service",
-	"version": "0.0.1-next.8",
+	"version": "0.0.1",
 	"description": "Document management contract implementation and REST endpoint definitions",
 	"repository": {
 		"type": "git",
@@ -13,21 +13,79 @@
 	"engines": {
 		"node": ">=20.0.0"
 	},
+	"scripts": {
+		"clean": "rimraf dist coverage docs/reference",
+		"build": "tsc",
+		"dev": "nodemon --watch src --ext ts --exec \"npm run build && npm run bundle:esm\"",
+		"test": "vitest --run --config ./vitest.config.ts --no-cache",
+		"coverage": "vitest --run --coverage --config ./vitest.config.ts --no-cache",
+		"bundle:esm": "rollup --config rollup.config.mjs --environment MODULE:esm",
+		"bundle:cjs": "rollup --config rollup.config.mjs --environment MODULE:cjs",
+		"bundle": "npm run bundle:esm && npm run bundle:cjs",
+		"docs:clean": "rimraf docs/reference",
+		"docs:generate": "typedoc",
+		"docs:api": "ts-to-openapi ./ts-to-openapi.json ./docs/open-api/spec.json",
+		"docs": "npm run docs:clean && npm run docs:generate && npm run docs:api",
+		"dist": "npm run clean && npm run build && npm run test && npm run bundle && npm run docs",
+		"dist:no-test": "npm run clean && npm run build && npm run bundle && npm run docs",
+		"prepare": "ts-patch install -s"
+	},
 	"dependencies": {
-		"@twin.org/api-models": "next",
-		"@twin.org/attestation-models": "next",
-		"@twin.org/auditable-item-graph-models": "next",
-		"@twin.org/blob-storage-models": "next",
-		"@twin.org/core": "next",
-		"@twin.org/crypto": "next",
-		"@twin.org/data-json-ld": "next",
-		"@twin.org/document-management-models": "0.0.1-next.8",
-		"@twin.org/entity": "next",
-		"@twin.org/entity-storage-models": "next",
-		"@twin.org/nameof": "next",
-		"@twin.org/standards-schema-org": "next",
-		"@twin.org/standards-unece": "next",
-		"@twin.org/web": "next"
+		"@twin.org/api-models": "^0.0.2-next.1",
+		"@twin.org/attestation-models": "^0.0.1",
+		"@twin.org/auditable-item-graph-models": "^0.0.1",
+		"@twin.org/blob-storage-models": "^0.0.1",
+		"@twin.org/data-processing-models": "^0.0.1",
+		"@twin.org/document-management-models": "^0.0.1",
+		"@twin.org/core": "^0.0.1",
+		"@twin.org/crypto": "^0.0.1",
+		"@twin.org/data-json-ld": "^0.0.1",
+		"@twin.org/entity": "^0.0.1",
+		"@twin.org/entity-storage-models": "^0.0.1",
+		"@twin.org/nameof": "^0.0.1",
+		"@twin.org/standards-schema-org": "^0.0.1",
+		"@twin.org/standards-unece": "^0.0.1",
+		"@twin.org/web": "^0.0.1"
+	},
+	"devDependencies": {
+		"@twin.org/attestation-connector-nft": "^0.0.1",
+		"@twin.org/attestation-service": "^0.0.1",
+		"@twin.org/auditable-item-graph-service": "^0.0.1",
+		"@twin.org/background-task-models": "^0.0.2-next.2",
+		"@twin.org/background-task-connector-entity-storage": "^0.0.2-next.2",
+		"@twin.org/blob-storage-connector-memory": "^0.0.1",
+		"@twin.org/blob-storage-service": "^0.0.1",
+		"@twin.org/data-processing-converters": "^0.0.1",
+		"@twin.org/data-processing-extractors": "^0.0.1",
+		"@twin.org/data-processing-service": "^0.0.1",
+		"@twin.org/entity-storage-connector-memory": "^0.0.1",
+		"@twin.org/identity-connector-entity-storage": "^0.0.1",
+		"@twin.org/identity-models": "^0.0.1",
+		"@twin.org/immutable-proof-models": "^0.0.1",
+		"@twin.org/immutable-proof-service": "^0.0.1",
+		"@twin.org/modules": "^0.0.1",
+		"@twin.org/nft-connector-entity-storage": "^0.0.1",
+		"@twin.org/nft-models": "^0.0.1",
+		"@twin.org/nameof-transformer": "^0.0.1",
+		"@twin.org/nameof-vitest-plugin": "^0.0.1",
+		"@twin.org/ts-to-openapi": "^0.0.1",
+		"@twin.org/vault-models": "^0.0.1",
+		"@twin.org/vault-connector-entity-storage": "^0.0.1",
+		"@twin.org/verifiable-storage-models": "^0.0.1",
+		"@twin.org/verifiable-storage-connector-entity-storage": "^0.0.1",
+		"@twin.org/wallet-models": "^0.0.1",
+		"@twin.org/wallet-connector-entity-storage": "^0.0.1",
+		"@types/node": "24.0.1",
+		"@vitest/coverage-v8": "3.2.3",
+		"copyfiles": "2.4.1",
+		"nodemon": "3.1.10",
+		"rimraf": "6.0.1",
+		"rollup": "4.43.0",
+		"ts-patch": "3.3.0",
+		"typedoc": "0.28.5",
+		"typedoc-plugin-markdown": "4.6.4",
+		"typescript": "5.8.3",
+		"vitest": "3.2.3"
 	},
 	"main": "./dist/cjs/index.cjs",
 	"module": "./dist/esm/index.mjs",