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

package/docs/reference/interfaces/IDocumentManagementComponent.md

@@ -8,22 +8,16 @@ Interface describing an document management contract.
 
 ## 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.
+Create 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`
@@ -54,6 +48,12 @@ The data to create the document with.
 
 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.
@@ -64,17 +64,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?
 
@@ -92,29 +92,77 @@ 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.
 
 ***
 
-### get()
+### update()
 
-> **get**(`auditableItemGraphId`, `identifier`, `options`?, `revisionCursor`?, `userIdentity`?, `nodeIdentity`?): `Promise`\<[`IDocument`](IDocument.md)\>
+> **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 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 auditable item graph vertex id to get the document from.
+The node identity to use for vault operations.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Nothing.
+
+***
+
+### get()
+
+> **get**(`auditableItemGraphDocumentId`, `options?`, `cursor?`, `pageSize?`, `userIdentity?`, `nodeIdentity?`): `Promise`\<[`IDocumentList`](IDocumentList.md)\>
+
+Get a document using it's auditable item graph vertex id and optional revision.
+
+#### Parameters
 
-##### identifier
+##### auditableItemGraphDocumentId
 
 `string`
 
-The identifier of the document to get.
+The auditable item graph vertex id which contains the document.
 
 ##### options?
 
@@ -144,18 +192,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.
+
+###### extractMimeType?
 
-Max number of revisions to return, defaults to 0.
+`string`
+
+By default extraction will auto detect the mime type of the document, this can be used to override the detection.
 
-##### revisionCursor?
+##### 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`
@@ -170,42 +230,65 @@ The node identity to use for vault operations.
 
 #### Returns
 
-`Promise`\<[`IDocument`](IDocument.md)\>
+`Promise`\<[`IDocumentList`](IDocumentList.md)\>
 
 The documents and revisions if requested, ordered by revision descending, cursor is set if there are more document revisions.
 
 ***
 
-### remove()
+### getRevision()
 
-> **remove**(`auditableItemGraphId`, `identifier`, `options`?, `userIdentity`?, `nodeIdentity`?): `Promise`\<`void`\>
+> **getRevision**(`auditableItemGraphDocumentId`, `revision`, `options?`, `userIdentity?`, `nodeIdentity?`): `Promise`\<[`IDocument`](IDocument.md)\>
 
-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 of the document to get.
 
 ##### options?
 
-Additional options for the remove operation.
+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.
 
-###### removeAllRevisions?
+###### includeAttestation?
 
 `boolean`
 
-Flag to remove all revisions of the document, defaults to false.
+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?
 
@@ -221,47 +304,66 @@ The node identity to use for vault operations.
 
 #### Returns
 
-`Promise`\<`void`\>
+`Promise`\<[`IDocument`](IDocument.md)\>
 
-Nothing.
+The documents and revisions if requested, ordered by revision descending, cursor is set if there are more document revisions.
 
 ***
 
-### query()
+### removeRevision()
 
-> **query**(`auditableItemGraphId`, `documentCodes`?, `options`?, `cursor`?, `userIdentity`?, `nodeIdentity`?): `Promise`\<[`IDocumentList`](IDocumentList.md)\>
+> **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.
+
+***
+
+### 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?
 
@@ -269,6 +371,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`
@@ -283,6 +391,6 @@ The node identity to use for vault operations.
 
 #### Returns
 
-`Promise`\<[`IDocumentList`](IDocumentList.md)\>
+`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.

package/docs/reference/interfaces/{IDocumentManagementSetRequest.md → IDocumentManagementCreateRequest.md}

@@ -1,23 +1,9 @@
-# Interface: IDocumentManagementSetRequest
+# Interface: IDocumentManagementCreateRequest
 
-Request to set a document in an auditable item graph vertex.
+Request to create a document as an auditable item graph vertex.
 
 ## Properties
 
-### pathParams
-
-> **pathParams**: `object`
-
-The path parameters.
-
-#### auditableItemGraphId
-
-> **auditableItemGraphId**: `string`
-
-The id of the auditable item graph vertex to store the document on.
-
-***
-
 ### body
 
 > **body**: `object`
@@ -54,20 +40,26 @@ The data to create the document with, in base64.
 
 Additional information to associate with the document.
 
+#### auditableItemGraphEdges?
+
+> `optional` **auditableItemGraphEdges**: `object`[]
+
+The auditable item graph vertices to connect the document to.
+
 #### createAttestation?
 
 > `optional` **createAttestation**: `boolean`
 
-Flag to create an attestation for the document, defaults to false
+Flag to create an attestation for the document, defaults to false.
 
-#### includeIdAsAlias?
+#### addAlias?
 
-> `optional` **includeIdAsAlias**: `boolean`
+> `optional` **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?
 
 > `optional` **aliasAnnotationObject**: `IJsonLdNodeObject`
 
-Additional information to associate with the alias.
+Annotation object for the alias.

package/docs/reference/interfaces/IDocumentManagementGetRequest.md

@@ -22,15 +22,9 @@ The headers which can be used to determine the response data type.
 
 The path parameters.
 
-#### auditableItemGraphId
+#### auditableItemGraphDocumentId
 
-> **auditableItemGraphId**: `string`
-
-The id of the auditable item graph vertex to store the document on.
-
-#### documentId
-
-> **documentId**: `string`
+> **auditableItemGraphDocumentId**: `string`
 
 The full id of the document to get.
 
@@ -44,7 +38,7 @@ The query parameters.
 
 #### includeBlobStorageMetadata?
 
-> `optional` **includeBlobStorageMetadata**: `boolean`
+> `optional` **includeBlobStorageMetadata**: `string` \| `boolean`
 
 Include the blob storage metadata in the response.
 
@@ -56,7 +50,7 @@ false
 
 #### includeBlobStorageData?
 
-> `optional` **includeBlobStorageData**: `boolean`
+> `optional` **includeBlobStorageData**: `string` \| `boolean`
 
 Include the blob storage data in the response.
 
@@ -68,7 +62,7 @@ false
 
 #### includeAttestation?
 
-> `optional` **includeAttestation**: `boolean`
+> `optional` **includeAttestation**: `string` \| `boolean`
 
 Include the attestation information in the response.
 
@@ -80,7 +74,7 @@ false
 
 #### includeRemoved?
 
-> `optional` **includeRemoved**: `boolean`
+> `optional` **includeRemoved**: `string` \| `boolean`
 
 Include deleted documents in the response.
 
@@ -90,20 +84,32 @@ Include deleted documents in the response.
 false
 ```
 
-#### maxRevisionCount?
+#### extractRuleGroupId?
+
+> `optional` **extractRuleGroupId**: `string`
+
+If provided will extract data from the document using the specified rule group id.
+
+#### extractMimeType?
+
+> `optional` **extractMimeType**: `string`
+
+By default extraction will auto detect the mime type of the document, this can be used to override the detection.
+
+#### pageSize?
 
-> `optional` **maxRevisionCount**: `number`
+> `optional` **pageSize**: `string` \| `number`
 
-Max number of revisions to return.
+Page size of items to return, defaults to 1 so only most recent is returned.
 
 ##### Default
 
 ```ts
-0
+1
 ```
 
-#### revisionCursor?
+#### cursor?
 
-> `optional` **revisionCursor**: `string`
+> `optional` **cursor**: `string`
 
 The cursor to get the next chunk of revisions.

package/docs/reference/interfaces/IDocumentManagementGetResponse.md

@@ -18,6 +18,6 @@ The headers which can be used to determine the response data type.
 
 ### body
 
-> **body**: [`IDocument`](IDocument.md)
+> **body**: [`IDocumentList`](IDocumentList.md)
 
 The body parameters.

package/docs/reference/interfaces/IDocumentManagementGetRevisionRequest.md

@@ -0,0 +1,91 @@
+# Interface: IDocumentManagementGetRevisionRequest
+
+Request to get a document revision from an auditable item graph vertex.
+
+## Properties
+
+### headers?
+
+> `optional` **headers**: `object`
+
+The headers which can be used to determine the response data type.
+
+#### accept
+
+> **accept**: `"application/json"` \| `"application/ld+json"`
+
+***
+
+### pathParams
+
+> **pathParams**: `object`
+
+The path parameters.
+
+#### auditableItemGraphDocumentId
+
+> **auditableItemGraphDocumentId**: `string`
+
+The full id of the document to get.
+
+#### revision
+
+> **revision**: `string`
+
+The revision of the document to get.
+
+***
+
+### query?
+
+> `optional` **query**: `object`
+
+The query parameters.
+
+#### includeBlobStorageMetadata?
+
+> `optional` **includeBlobStorageMetadata**: `string` \| `boolean`
+
+Include the blob storage metadata in the response.
+
+##### Default
+
+```ts
+false
+```
+
+#### includeBlobStorageData?
+
+> `optional` **includeBlobStorageData**: `string` \| `boolean`
+
+Include the blob storage data in the response.
+
+##### Default
+
+```ts
+false
+```
+
+#### includeAttestation?
+
+> `optional` **includeAttestation**: `string` \| `boolean`
+
+Include the attestation information in the response.
+
+##### Default
+
+```ts
+false
+```
+
+#### extractRuleGroupId?
+
+> `optional` **extractRuleGroupId**: `string`
+
+If provided will extract data from the document using the specified rule group id.
+
+#### extractMimeType?
+
+> `optional` **extractMimeType**: `string`
+
+By default extraction will auto detect the mime type of the document, this can be used to override the detection.

package/docs/reference/interfaces/IDocumentManagementGetRevisionResponse.md

@@ -0,0 +1,23 @@
+# Interface: IDocumentManagementGetRevisionResponse
+
+Response to get a document revision from an auditable item graph vertex.
+
+## Properties
+
+### headers?
+
+> `optional` **headers**: `object`
+
+The headers which can be used to determine the response data type.
+
+#### content-type
+
+> **content-type**: `"application/json"` \| `"application/ld+json"`
+
+***
+
+### body
+
+> **body**: [`IDocument`](IDocument.md)
+
+The body parameters.