@twin.org/document-management-service 0.0.1-next.10

package/docs/reference/classes/DocumentManagementService.md

@@ -0,0 +1,370 @@
+# Class: DocumentManagementService
+
+Service for performing document management operations.
+
+## Implements
+
+- `IDocumentManagementComponent`
+
+## Constructors
+
+### Constructor
+
+> **new DocumentManagementService**(`options?`): `DocumentManagementService`
+
+Create a new instance of DocumentManagementService.
+
+#### Parameters
+
+##### options?
+
+[`IDocumentManagementServiceConstructorOptions`](../interfaces/IDocumentManagementServiceConstructorOptions.md)
+
+The options for the service.
+
+#### Returns
+
+`DocumentManagementService`
+
+## Properties
+
+### NAMESPACE
+
+> `readonly` `static` **NAMESPACE**: `string` = `"documents"`
+
+The namespace supported by the document management service.
+
+***
+
+### CLASS\_NAME
+
+> `readonly` **CLASS\_NAME**: `string`
+
+Runtime name for the class.
+
+#### Implementation of
+
+`IDocumentManagementComponent.CLASS_NAME`
+
+## Methods
+
+### create()
+
+> **create**(`documentId`, `documentIdFormat`, `documentCode`, `blob`, `annotationObject?`, `auditableItemGraphEdges?`, `options?`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`string`\>
+
+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
+
+##### documentId
+
+`string`
+
+The document id to create.
+
+##### documentIdFormat
+
+The format of the document identifier.
+
+`undefined` | `string`
+
+##### documentCode
+
+`string`
+
+The code for the document type.
+
+##### blob
+
+`Uint8Array`
+
+The data to create the document with.
+
+##### annotationObject?
+
+`IJsonLdNodeObject`
+
+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.
+
+###### createAttestation?
+
+`boolean`
+
+Flag to create an attestation for the document, defaults to false.
+
+###### addAlias?
+
+`boolean`
+
+Flag to add the document id as an alias to the aig vertex, defaults to true.
+
+###### aliasAnnotationObject?
+
+`IJsonLdNodeObject`
+
+Annotation object for the alias.
+
+##### userIdentity?
+
+`string`
+
+The identity to perform the auditable item graph operation with.
+
+##### nodeIdentity?
+
+`string`
+
+The node identity to use for vault operations.
+
+#### Returns
+
+`Promise`\<`string`\>
+
+The auditable item graph vertex created for the document including its revision.
+
+#### Implementation of
+
+`IDocumentManagementComponent.create`
+
+***
+
+### update()
+
+> **update**(`auditableItemGraphDocumentId`, `blob?`, `annotationObject?`, `auditableItemGraphEdges?`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`void`\>
+
+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
+
+##### auditableItemGraphDocumentId
+
+`string`
+
+The auditable item graph vertex id which contains the document.
+
+##### 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 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?
+
+Additional options for the get operation.
+
+###### includeBlobStorageMetadata?
+
+`boolean`
+
+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.
+
+###### includeRemoved?
+
+`boolean`
+
+Flag to include deleted documents, defaults to false.
+
+##### 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`
+
+The identity to perform the auditable item graph operation with.
+
+##### nodeIdentity?
+
+`string`
+
+The node identity to use for vault operations.
+
+#### Returns
+
+`Promise`\<`IDocumentList`\>
+
+The documents and revisions if requested, ordered by revision descending, cursor is set if there are more document revisions.
+
+#### Implementation of
+
+`IDocumentManagementComponent.get`
+
+***
+
+### removeRevision()
+
+> **removeRevision**(`auditableItemGraphDocumentId`, `revision`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`void`\>
+
+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
+
+##### auditableItemGraphDocumentId
+
+`string`
+
+The auditable item graph vertex id which contains the document.
+
+##### revision
+
+`number`
+
+The revision of the document to remove.
+
+##### userIdentity?
+
+`string`
+
+The identity to perform the auditable item graph operation with.
+
+##### nodeIdentity?
+
+`string`
+
+The node identity to use for vault operations.
+
+#### Returns
+
+`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?
+
+`string`
+
+The cursor to get the next chunk of documents.
+
+##### pageSize?
+
+`number`
+
+The page size to get the next chunk of documents.
+
+##### userIdentity?
+
+`string`
+
+The identity to perform the auditable item graph operation with.
+
+##### nodeIdentity?
+
+`string`
+
+The node identity to use for vault operations.
+
+#### Returns
+
+`Promise`\<`IAuditableItemGraphVertexList`\>
+
+The graph vertices that contain documents referencing the specified document id.
+
+#### Implementation of
+
+`IDocumentManagementComponent.query`

package/docs/reference/functions/documentManagementCreate.md

@@ -0,0 +1,31 @@
+# Function: documentManagementCreate()
+
+> **documentManagementCreate**(`httpRequestContext`, `componentName`, `request`): `Promise`\<`ICreatedResponse`\>
+
+Create a document as an 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
+
+`IDocumentManagementCreateRequest`
+
+The request.
+
+## Returns
+
+`Promise`\<`ICreatedResponse`\>
+
+The response object with additional http response properties.

package/docs/reference/functions/documentManagementGet.md

@@ -0,0 +1,31 @@
+# Function: documentManagementGet()
+
+> **documentManagementGet**(`httpRequestContext`, `componentName`, `request`): `Promise`\<`IDocumentManagementGetResponse`\>
+
+Get 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
+
+`IDocumentManagementGetRequest`
+
+The request.
+
+## Returns
+
+`Promise`\<`IDocumentManagementGetResponse`\>
+
+The response object with additional http response properties.

package/docs/reference/functions/documentManagementQuery.md

@@ -0,0 +1,31 @@
+# Function: documentManagementQuery()
+
+> **documentManagementQuery**(`httpRequestContext`, `componentName`, `request`): `Promise`\<`IDocumentManagementQueryResponse`\>
+
+Query the documents from an 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
+
+`IDocumentManagementQueryRequest`
+
+The request.
+
+## Returns
+
+`Promise`\<`IDocumentManagementQueryResponse`\>
+
+The response object with additional http response properties.

package/docs/reference/functions/documentManagementRemove.md

@@ -0,0 +1,31 @@
+# Function: documentManagementRemove()
+
+> **documentManagementRemove**(`httpRequestContext`, `componentName`, `request`): `Promise`\<`INoContentResponse`\>
+
+Remove 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
+
+`IDocumentManagementRemoveRequest`
+
+The request.
+
+## Returns
+
+`Promise`\<`INoContentResponse`\>
+
+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/functions/generateRestRoutesDocumentManagement.md

@@ -0,0 +1,25 @@
+# Function: generateRestRoutesDocumentManagement()
+
+> **generateRestRoutesDocumentManagement**(`baseRouteName`, `componentName`): `IRestRoute`\<`any`, `any`\>[]
+
+The REST routes for document management.
+
+## Parameters
+
+### baseRouteName
+
+`string`
+
+Prefix to prepend to the paths.
+
+### componentName
+
+`string`
+
+The name of the component to use in the routes stored in the ComponentFactory.
+
+## Returns
+
+`IRestRoute`\<`any`, `any`\>[]
+
+The generated routes.

package/docs/reference/index.md

@@ -0,0 +1,24 @@
+# @twin.org/document-management-service
+
+## Classes
+
+- [DocumentManagementService](classes/DocumentManagementService.md)
+
+## Interfaces
+
+- [IDocumentManagementServiceConfig](interfaces/IDocumentManagementServiceConfig.md)
+- [IDocumentManagementServiceConstructorOptions](interfaces/IDocumentManagementServiceConstructorOptions.md)
+
+## Variables
+
+- [tagsDocumentManagement](variables/tagsDocumentManagement.md)
+- [restEntryPoints](variables/restEntryPoints.md)
+
+## Functions
+
+- [generateRestRoutesDocumentManagement](functions/generateRestRoutesDocumentManagement.md)
+- [documentManagementCreate](functions/documentManagementCreate.md)
+- [documentManagementGet](functions/documentManagementGet.md)
+- [documentManagementUpdate](functions/documentManagementUpdate.md)
+- [documentManagementRemove](functions/documentManagementRemove.md)
+- [documentManagementQuery](functions/documentManagementQuery.md)

package/docs/reference/interfaces/IDocumentManagementServiceConfig.md

@@ -0,0 +1,3 @@
+# Interface: IDocumentManagementServiceConfig
+
+Configuration for the document management service.

package/docs/reference/interfaces/IDocumentManagementServiceConstructorOptions.md

@@ -0,0 +1,53 @@
+# Interface: IDocumentManagementServiceConstructorOptions
+
+Options for the document management Service constructor.
+
+## Properties
+
+### auditableItemGraphComponentType?
+
+> `optional` **auditableItemGraphComponentType**: `string`
+
+The type of the auditable item graph component.
+
+#### Default
+
+```ts
+auditable-item-graph
+```
+
+***
+
+### blobStorageComponentType?
+
+> `optional` **blobStorageComponentType**: `string`
+
+The type of the blob storage component.
+
+#### Default
+
+```ts
+blob-storage
+```
+
+***
+
+### attestationComponentType?
+
+> `optional` **attestationComponentType**: `string`
+
+The type of the attestation component.
+
+#### Default
+
+```ts
+attestation
+```
+
+***
+
+### config?
+
+> `optional` **config**: [`IDocumentManagementServiceConfig`](IDocumentManagementServiceConfig.md)
+
+The configuration for the service.

package/docs/reference/variables/restEntryPoints.md

@@ -0,0 +1,3 @@
+# Variable: restEntryPoints
+
+> `const` **restEntryPoints**: `IRestRouteEntryPoint`[]

package/docs/reference/variables/tagsDocumentManagement.md

@@ -0,0 +1,5 @@
+# Variable: tagsDocumentManagement
+
+> `const` **tagsDocumentManagement**: `ITag`[]
+
+The tag to associate with the routes.

package/locales/en.json

@@ -0,0 +1,14 @@
+{
+	"error": {
+		"documentManagementService": {
+			"createFailed": "Failed to create document",
+			"updateFailed": "Failed to update document",
+			"getFailed": "Failed to get document",
+			"removeRevision": "Failed to remove document revision",
+			"queryFailed": "Failed to query document",
+			"documentRevisionNone": "There are no revisions in the document",
+			"documentRevisionNotFound": "There is no revision number \"{revision}\" in the document",
+			"namespaceMismatch": "The namespace in the urn \"{id}\" does not match the namespace of the Document Management component \"{namespace}\""
+		}
+	}
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+	"name": "@twin.org/document-management-service",
+	"version": "0.0.1-next.10",
+	"description": "Document management contract implementation and REST endpoint definitions",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/twinfoundation/document-management.git",
+		"directory": "packages/document-management-service"
+	},
+	"author": "martyn.janes@iota.org",
+	"license": "Apache-2.0",
+	"type": "module",
+	"engines": {
+		"node": ">=20.0.0"
+	},
+	"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.10",
+		"@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"
+	},
+	"main": "./dist/cjs/index.cjs",
+	"module": "./dist/esm/index.mjs",
+	"types": "./dist/types/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/types/index.d.ts",
+			"require": "./dist/cjs/index.cjs",
+			"import": "./dist/esm/index.mjs"
+		},
+		"./locales/*.json": "./locales/*.json"
+	},
+	"files": [
+		"dist/cjs",
+		"dist/esm",
+		"dist/types",
+		"locales",
+		"docs"
+	]
+}