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

package/docs/reference/index.md

@@ -1,21 +1,31 @@
 # @twin.org/document-management-models
 
+## Classes
+
+- [DocumentManagementDataTypes](classes/DocumentManagementDataTypes.md)
+
 ## Interfaces
 
 - [IDocument](interfaces/IDocument.md)
+- [IDocumentAttestation](interfaces/IDocumentAttestation.md)
 - [IDocumentList](interfaces/IDocumentList.md)
 - [IDocumentManagementComponent](interfaces/IDocumentManagementComponent.md)
+- [IDocumentManagementCreateRequest](interfaces/IDocumentManagementCreateRequest.md)
 - [IDocumentManagementGetRequest](interfaces/IDocumentManagementGetRequest.md)
 - [IDocumentManagementGetResponse](interfaces/IDocumentManagementGetResponse.md)
+- [IDocumentManagementGetRevisionRequest](interfaces/IDocumentManagementGetRevisionRequest.md)
+- [IDocumentManagementGetRevisionResponse](interfaces/IDocumentManagementGetRevisionResponse.md)
 - [IDocumentManagementQueryRequest](interfaces/IDocumentManagementQueryRequest.md)
 - [IDocumentManagementQueryResponse](interfaces/IDocumentManagementQueryResponse.md)
 - [IDocumentManagementRemoveRequest](interfaces/IDocumentManagementRemoveRequest.md)
-- [IDocumentManagementSetRequest](interfaces/IDocumentManagementSetRequest.md)
+- [IDocumentManagementUpdateRequest](interfaces/IDocumentManagementUpdateRequest.md)
 
 ## Type Aliases
 
+- [DocumentContexts](type-aliases/DocumentContexts.md)
 - [DocumentTypes](type-aliases/DocumentTypes.md)
 
 ## Variables
 
+- [DocumentContexts](variables/DocumentContexts.md)
 - [DocumentTypes](variables/DocumentTypes.md)

package/docs/reference/interfaces/IDocument.md

@@ -92,6 +92,14 @@ The additional JSON-LD for blob storage if it was requested.
 
 ***
 
+### extractedData?
+
+> `optional` **extractedData**: `unknown`
+
+The data extracted from the document using data extraction services.
+
+***
+
 ### attestationId?
 
 > `optional` **attestationId**: `string`
@@ -132,16 +140,16 @@ The date/time of when the document was deleted, as we never actually remove item
 
 ***
 
-### revisions?
+### nodeIdentity
 
-> `optional` **revisions**: [`IDocument`](IDocument.md)[]
+> **nodeIdentity**: `string`
 
-The previous revisions of the document.
+The node which added the document to the graph.
 
 ***
 
-### revisionCursor?
+### userIdentity
 
-> `optional` **revisionCursor**: `string`
+> **userIdentity**: `string`
 
-The cursor to get the next chunk of revisions.
+The user who added the document to the graph.

package/docs/reference/interfaces/IDocumentAttestation.md

@@ -0,0 +1,59 @@
+# Interface: IDocumentAttestation
+
+Interface describing a document attestation.
+
+## Properties
+
+### @context
+
+> **@context**: \[`"https://schema.twindev.org/documents/"`, `"https://schema.twindev.org/common/"`, `"https://schema.org"`\]
+
+JSON-LD Context.
+
+***
+
+### type
+
+> **type**: `"DocumentAttestation"`
+
+JSON-LD Type.
+
+***
+
+### documentId
+
+> **documentId**: `string`
+
+The id of the document.
+
+***
+
+### documentCode
+
+> **documentCode**: `string`
+
+The code for the document type.
+
+***
+
+### documentRevision
+
+> **documentRevision**: `number`
+
+The revision of the document as a 0 based index.
+
+***
+
+### dateCreated
+
+> **dateCreated**: `string`
+
+The date/time of when the document was created.
+
+***
+
+### blobHash
+
+> **blobHash**: `string`
+
+The hash of the document being attested.

package/docs/reference/interfaces/IDocumentList.md

@@ -1,12 +1,12 @@
 # Interface: IDocumentList
 
-Interface describing a document entry list.
+Interface describing a list of document entries.
 
 ## Properties
 
 ### @context
 
-> **@context**: \[`"https://schema.twindev.org/documents/"`, `"https://schema.twindev.org/common/"`, `...IJsonLdContextDefinitionElement[]`\]
+> **@context**: \[`"https://schema.org"`, `"https://schema.twindev.org/documents/"`, `"https://schema.twindev.org/common/"`, `...IJsonLdContextDefinitionElement[]`\]
 
 JSON-LD Context.
 
@@ -14,22 +14,30 @@ JSON-LD Context.
 
 ### type
 
-> **type**: `"DocumentList"`
+> **type**: `"ItemList"`
 
 JSON-LD Type.
 
 ***
 
-### documents
+### itemListElement
 
-> **documents**: [`IDocument`](IDocument.md)[]
+> **itemListElement**: [`IDocument`](IDocument.md)[]
 
 The list of documents.
 
 ***
 
-### cursor?
+### edges?
 
-> `optional` **cursor**: `string`
+> `optional` **edges**: `string`[]
+
+The ids of the other vertices which are connected to the document.
+
+***
+
+### nextItem?
+
+> `optional` **nextItem**: `string`
 
 The cursor to get the next chunk of documents.

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`?, `createAttestation`?, `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,12 +48,34 @@ The data to create the document with.
 
 Additional information to associate with the document.
 
-##### createAttestation?
+##### 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`
@@ -76,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()
 
-##### identifier
+> **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
+
+##### auditableItemGraphDocumentId
 
 `string`
 
-The identifier of the document to get.
+The auditable item graph vertex id which contains the document.
 
 ##### options?
 
@@ -128,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`
 
-Max number of revisions to return, defaults to 0.
+If provided will extract data from the document using the specified rule group id.
 
-##### revisionCursor?
+###### extractMimeType?
+
+`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`
@@ -154,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?
 
@@ -205,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?
 
@@ -253,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`
@@ -267,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,8 +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.
+
+#### addAlias?
+
+> `optional` **addAlias**: `boolean`
+
+Flag to add the document id as an alias to the aig vertex, defaults to true.
+
+#### aliasAnnotationObject?
+
+> `optional` **aliasAnnotationObject**: `IJsonLdNodeObject`
+
+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.