@twin.org/document-management-models 0.0.3-next.11 → 0.0.3-next.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (28) hide show
  1. package/README.md +1 -1
  2. package/dist/es/dataTypes/documentManagementDataTypes.js.map +1 -1
  3. package/dist/es/models/IDocument.js.map +1 -1
  4. package/dist/es/models/IDocumentAttestation.js.map +1 -1
  5. package/dist/es/models/IDocumentList.js.map +1 -1
  6. package/dist/es/schemas/Document.json +20 -23
  7. package/dist/types/models/IDocument.d.ts +16 -16
  8. package/dist/types/models/IDocumentAttestation.d.ts +5 -5
  9. package/dist/types/models/IDocumentList.d.ts +2 -2
  10. package/docs/changelog.md +98 -84
  11. package/docs/examples.md +23 -1
  12. package/docs/reference/classes/DocumentManagementDataTypes.md +1 -1
  13. package/docs/reference/interfaces/IDocument.md +29 -45
  14. package/docs/reference/interfaces/IDocumentAttestation.md +7 -12
  15. package/docs/reference/interfaces/IDocumentList.md +5 -7
  16. package/docs/reference/interfaces/IDocumentManagementComponent.md +8 -8
  17. package/docs/reference/interfaces/IDocumentManagementCreateRequest.md +6 -6
  18. package/docs/reference/interfaces/IDocumentManagementGetRequest.md +13 -13
  19. package/docs/reference/interfaces/IDocumentManagementGetResponse.md +4 -4
  20. package/docs/reference/interfaces/IDocumentManagementGetRevisionRequest.md +10 -10
  21. package/docs/reference/interfaces/IDocumentManagementGetRevisionResponse.md +3 -3
  22. package/docs/reference/interfaces/IDocumentManagementQueryRequest.md +5 -5
  23. package/docs/reference/interfaces/IDocumentManagementQueryResponse.md +4 -4
  24. package/docs/reference/interfaces/IDocumentManagementRemoveRequest.md +1 -1
  25. package/docs/reference/interfaces/IDocumentManagementUpdateRequest.md +5 -5
  26. package/docs/reference/variables/DocumentContexts.md +6 -6
  27. package/docs/reference/variables/DocumentTypes.md +2 -2
  28. package/package.json +4 -4
@@ -4,7 +4,7 @@ Interface describing a document attestation.
4
4
 
5
5
  ## Properties
6
6
 
7
- ### @context
7
+ ### @context {#context}
8
8
 
9
9
  > **@context**: \[`"https://schema.org"`, `"https://schema.twindev.org/documents/"`, `"https://schema.twindev.org/common/"`\]
10
10
 
@@ -12,7 +12,7 @@ JSON-LD Context.
12
12
 
13
13
  ***
14
14
 
15
- ### type
15
+ ### type {#type}
16
16
 
17
17
  > **type**: `"DocumentAttestation"`
18
18
 
@@ -20,45 +20,40 @@ JSON-LD Type.
20
20
 
21
21
  ***
22
22
 
23
- ### documentId
23
+ ### documentId {#documentid}
24
24
 
25
25
  > **documentId**: `string`
26
26
 
27
27
  The id of the document.
28
- json-ld type:schema:identifier
29
28
 
30
29
  ***
31
30
 
32
- ### documentCode
31
+ ### documentCode {#documentcode}
33
32
 
34
33
  > **documentCode**: `UneceDocumentCodeList`
35
34
 
36
35
  The code for the document type.
37
- json-ld type:schema:identifier
38
36
 
39
37
  ***
40
38
 
41
- ### documentRevision
39
+ ### documentRevision {#documentrevision}
42
40
 
43
41
  > **documentRevision**: `number`
44
42
 
45
43
  The revision of the document as a 0 based index.
46
- json-ld type:schema:Integer
47
44
 
48
45
  ***
49
46
 
50
- ### dateCreated
47
+ ### dateCreated {#datecreated}
51
48
 
52
49
  > **dateCreated**: `string`
53
50
 
54
51
  The date/time of when the document was created.
55
- json-ld namespace:schema
56
52
 
57
53
  ***
58
54
 
59
- ### integrity
55
+ ### integrity {#integrity}
60
56
 
61
57
  > **integrity**: `string`
62
58
 
63
59
  The integrity of the document being attested.
64
- json-ld namespace:twin-common
@@ -4,7 +4,7 @@ Interface describing a list of document entries.
4
4
 
5
5
  ## Properties
6
6
 
7
- ### @context
7
+ ### @context {#context}
8
8
 
9
9
  > **@context**: \[`"https://schema.org"`, `"https://schema.twindev.org/documents/"`, `"https://schema.twindev.org/common/"`, `...IJsonLdContextDefinitionElement[]`\]
10
10
 
@@ -12,7 +12,7 @@ JSON-LD Context.
12
12
 
13
13
  ***
14
14
 
15
- ### type
15
+ ### type {#type}
16
16
 
17
17
  > **type**: `"ItemList"`
18
18
 
@@ -20,18 +20,16 @@ JSON-LD Type.
20
20
 
21
21
  ***
22
22
 
23
- ### itemListElement
23
+ ### itemListElement {#itemlistelement}
24
24
 
25
25
  > **itemListElement**: [`IDocument`](IDocument.md)[]
26
26
 
27
27
  The list of documents.
28
- json-ld namespace:schema
29
28
 
30
29
  ***
31
30
 
32
- ### edges?
31
+ ### edges? {#edges}
33
32
 
34
- > `optional` **edges**: `string`[]
33
+ > `optional` **edges?**: `string`[]
35
34
 
36
35
  The ids of the other vertices which are connected to the document.
37
- json-ld container:set
@@ -8,7 +8,7 @@ Interface describing an document management contract.
8
8
 
9
9
  ## Methods
10
10
 
11
- ### create()
11
+ ### create() {#create}
12
12
 
13
13
  > **create**(`documentId`, `documentIdFormat`, `documentCode`, `blob`, `annotationObject?`, `auditableItemGraphEdges?`, `options?`): `Promise`\<`string`\>
14
14
 
@@ -26,9 +26,9 @@ The document id to create.
26
26
 
27
27
  ##### documentIdFormat
28
28
 
29
- The format of the document identifier.
29
+ `string` \| `undefined`
30
30
 
31
- `string` | `undefined`
31
+ The format of the document identifier.
32
32
 
33
33
  ##### documentCode
34
34
 
@@ -84,7 +84,7 @@ The auditable item graph vertex created for the document including its revision.
84
84
 
85
85
  ***
86
86
 
87
- ### update()
87
+ ### update() {#update}
88
88
 
89
89
  > **update**(`auditableItemGraphDocumentId`, `blob?`, `annotationObject?`, `auditableItemGraphEdges?`): `Promise`\<`void`\>
90
90
 
@@ -126,7 +126,7 @@ Nothing.
126
126
 
127
127
  ***
128
128
 
129
- ### get()
129
+ ### get() {#get}
130
130
 
131
131
  > **get**(`auditableItemGraphDocumentId`, `options?`, `cursor?`, `limit?`): `Promise`\<\{ `entries`: [`IDocumentList`](IDocumentList.md); `cursor?`: `string`; \}\>
132
132
 
@@ -200,7 +200,7 @@ The documents and revisions if requested, ordered by revision descending, cursor
200
200
 
201
201
  ***
202
202
 
203
- ### getRevision()
203
+ ### getRevision() {#getrevision}
204
204
 
205
205
  > **getRevision**(`auditableItemGraphDocumentId`, `revision`, `options?`): `Promise`\<[`IDocument`](IDocument.md)\>
206
206
 
@@ -262,7 +262,7 @@ The documents and revisions if requested, ordered by revision descending, cursor
262
262
 
263
263
  ***
264
264
 
265
- ### removeRevision()
265
+ ### removeRevision() {#removerevision}
266
266
 
267
267
  > **removeRevision**(`auditableItemGraphDocumentId`, `revision`): `Promise`\<`void`\>
268
268
 
@@ -291,7 +291,7 @@ Nothing.
291
291
 
292
292
  ***
293
293
 
294
- ### query()
294
+ ### query() {#query}
295
295
 
296
296
  > **query**(`documentId`, `cursor?`, `limit?`): `Promise`\<\{ `entries`: `IAuditableItemGraphVertexList`; `cursor?`: `string`; \}\>
297
297
 
@@ -4,7 +4,7 @@ Request to create a document as an auditable item graph vertex.
4
4
 
5
5
  ## Properties
6
6
 
7
- ### body
7
+ ### body {#body}
8
8
 
9
9
  > **body**: `object`
10
10
 
@@ -36,30 +36,30 @@ The data to create the document with, in base64.
36
36
 
37
37
  #### annotationObject?
38
38
 
39
- > `optional` **annotationObject**: `IJsonLdNodeObject`
39
+ > `optional` **annotationObject?**: `IJsonLdNodeObject`
40
40
 
41
41
  Additional information to associate with the document.
42
42
 
43
43
  #### auditableItemGraphEdges?
44
44
 
45
- > `optional` **auditableItemGraphEdges**: `object`[]
45
+ > `optional` **auditableItemGraphEdges?**: `object`[]
46
46
 
47
47
  The auditable item graph vertices to connect the document to.
48
48
 
49
49
  #### createAttestation?
50
50
 
51
- > `optional` **createAttestation**: `boolean`
51
+ > `optional` **createAttestation?**: `boolean`
52
52
 
53
53
  Flag to create an attestation for the document, defaults to false.
54
54
 
55
55
  #### addAlias?
56
56
 
57
- > `optional` **addAlias**: `boolean`
57
+ > `optional` **addAlias?**: `boolean`
58
58
 
59
59
  Flag to add the document id as an alias to the aig vertex, defaults to true.
60
60
 
61
61
  #### aliasAnnotationObject?
62
62
 
63
- > `optional` **aliasAnnotationObject**: `IJsonLdNodeObject`
63
+ > `optional` **aliasAnnotationObject?**: `IJsonLdNodeObject`
64
64
 
65
65
  Annotation object for the alias.
@@ -4,9 +4,9 @@ Request to get a document from an auditable item graph vertex.
4
4
 
5
5
  ## Properties
6
6
 
7
- ### headers?
7
+ ### headers? {#headers}
8
8
 
9
- > `optional` **headers**: `object`
9
+ > `optional` **headers?**: `object`
10
10
 
11
11
  The headers which can be used to determine the response data type.
12
12
 
@@ -16,7 +16,7 @@ The headers which can be used to determine the response data type.
16
16
 
17
17
  ***
18
18
 
19
- ### pathParams
19
+ ### pathParams {#pathparams}
20
20
 
21
21
  > **pathParams**: `object`
22
22
 
@@ -30,15 +30,15 @@ The full id of the document to get.
30
30
 
31
31
  ***
32
32
 
33
- ### query?
33
+ ### query? {#query}
34
34
 
35
- > `optional` **query**: `object`
35
+ > `optional` **query?**: `object`
36
36
 
37
37
  The query parameters.
38
38
 
39
39
  #### includeBlobStorageMetadata?
40
40
 
41
- > `optional` **includeBlobStorageMetadata**: `string`
41
+ > `optional` **includeBlobStorageMetadata?**: `string`
42
42
 
43
43
  Include the blob storage metadata in the response.
44
44
 
@@ -50,7 +50,7 @@ false
50
50
 
51
51
  #### includeBlobStorageData?
52
52
 
53
- > `optional` **includeBlobStorageData**: `string`
53
+ > `optional` **includeBlobStorageData?**: `string`
54
54
 
55
55
  Include the blob storage data in the response.
56
56
 
@@ -62,7 +62,7 @@ false
62
62
 
63
63
  #### includeAttestation?
64
64
 
65
- > `optional` **includeAttestation**: `string`
65
+ > `optional` **includeAttestation?**: `string`
66
66
 
67
67
  Include the attestation information in the response.
68
68
 
@@ -74,7 +74,7 @@ false
74
74
 
75
75
  #### includeRemoved?
76
76
 
77
- > `optional` **includeRemoved**: `string`
77
+ > `optional` **includeRemoved?**: `string`
78
78
 
79
79
  Include deleted documents in the response.
80
80
 
@@ -86,19 +86,19 @@ false
86
86
 
87
87
  #### extractRuleGroupId?
88
88
 
89
- > `optional` **extractRuleGroupId**: `string`
89
+ > `optional` **extractRuleGroupId?**: `string`
90
90
 
91
91
  If provided will extract data from the document using the specified rule group id.
92
92
 
93
93
  #### extractMimeType?
94
94
 
95
- > `optional` **extractMimeType**: `string`
95
+ > `optional` **extractMimeType?**: `string`
96
96
 
97
97
  By default extraction will auto detect the mime type of the document, this can be used to override the detection.
98
98
 
99
99
  #### limit?
100
100
 
101
- > `optional` **limit**: `string`
101
+ > `optional` **limit?**: `string`
102
102
 
103
103
  PLimit the number of items to return, defaults to 1 so only most recent is returned.
104
104
 
@@ -110,6 +110,6 @@ PLimit the number of items to return, defaults to 1 so only most recent is retur
110
110
 
111
111
  #### cursor?
112
112
 
113
- > `optional` **cursor**: `string`
113
+ > `optional` **cursor?**: `string`
114
114
 
115
115
  The cursor to get the next chunk of revisions.
@@ -4,9 +4,9 @@ Response to get a document and optionally revisions from an auditable item graph
4
4
 
5
5
  ## Properties
6
6
 
7
- ### headers?
7
+ ### headers? {#headers}
8
8
 
9
- > `optional` **headers**: `object`
9
+ > `optional` **headers?**: `object`
10
10
 
11
11
  The headers which can be used to determine the response data type.
12
12
 
@@ -16,11 +16,11 @@ The headers which can be used to determine the response data type.
16
16
 
17
17
  #### link?
18
18
 
19
- > `optional` **link**: `string` \| `string`[]
19
+ > `optional` **link?**: `string` \| `string`[]
20
20
 
21
21
  ***
22
22
 
23
- ### body
23
+ ### body {#body}
24
24
 
25
25
  > **body**: [`IDocumentList`](IDocumentList.md)
26
26
 
@@ -4,9 +4,9 @@ Request to get a document revision from an auditable item graph vertex.
4
4
 
5
5
  ## Properties
6
6
 
7
- ### headers?
7
+ ### headers? {#headers}
8
8
 
9
- > `optional` **headers**: `object`
9
+ > `optional` **headers?**: `object`
10
10
 
11
11
  The headers which can be used to determine the response data type.
12
12
 
@@ -16,7 +16,7 @@ The headers which can be used to determine the response data type.
16
16
 
17
17
  ***
18
18
 
19
- ### pathParams
19
+ ### pathParams {#pathparams}
20
20
 
21
21
  > **pathParams**: `object`
22
22
 
@@ -36,15 +36,15 @@ The revision of the document to get.
36
36
 
37
37
  ***
38
38
 
39
- ### query?
39
+ ### query? {#query}
40
40
 
41
- > `optional` **query**: `object`
41
+ > `optional` **query?**: `object`
42
42
 
43
43
  The query parameters.
44
44
 
45
45
  #### includeBlobStorageMetadata?
46
46
 
47
- > `optional` **includeBlobStorageMetadata**: `string`
47
+ > `optional` **includeBlobStorageMetadata?**: `string`
48
48
 
49
49
  Include the blob storage metadata in the response.
50
50
 
@@ -56,7 +56,7 @@ false
56
56
 
57
57
  #### includeBlobStorageData?
58
58
 
59
- > `optional` **includeBlobStorageData**: `string`
59
+ > `optional` **includeBlobStorageData?**: `string`
60
60
 
61
61
  Include the blob storage data in the response.
62
62
 
@@ -68,7 +68,7 @@ false
68
68
 
69
69
  #### includeAttestation?
70
70
 
71
- > `optional` **includeAttestation**: `string`
71
+ > `optional` **includeAttestation?**: `string`
72
72
 
73
73
  Include the attestation information in the response.
74
74
 
@@ -80,12 +80,12 @@ false
80
80
 
81
81
  #### extractRuleGroupId?
82
82
 
83
- > `optional` **extractRuleGroupId**: `string`
83
+ > `optional` **extractRuleGroupId?**: `string`
84
84
 
85
85
  If provided will extract data from the document using the specified rule group id.
86
86
 
87
87
  #### extractMimeType?
88
88
 
89
- > `optional` **extractMimeType**: `string`
89
+ > `optional` **extractMimeType?**: `string`
90
90
 
91
91
  By default extraction will auto detect the mime type of the document, this can be used to override the detection.
@@ -4,9 +4,9 @@ Response to get a document revision from an auditable item graph vertex.
4
4
 
5
5
  ## Properties
6
6
 
7
- ### headers?
7
+ ### headers? {#headers}
8
8
 
9
- > `optional` **headers**: `object`
9
+ > `optional` **headers?**: `object`
10
10
 
11
11
  The headers which can be used to determine the response data type.
12
12
 
@@ -16,7 +16,7 @@ The headers which can be used to determine the response data type.
16
16
 
17
17
  ***
18
18
 
19
- ### body
19
+ ### body {#body}
20
20
 
21
21
  > **body**: [`IDocument`](IDocument.md)
22
22
 
@@ -4,9 +4,9 @@ Request to get a list of document from an auditable item graph vertex.
4
4
 
5
5
  ## Properties
6
6
 
7
- ### headers?
7
+ ### headers? {#headers}
8
8
 
9
- > `optional` **headers**: `object`
9
+ > `optional` **headers?**: `object`
10
10
 
11
11
  The headers which can be used to determine the response data type.
12
12
 
@@ -16,7 +16,7 @@ The headers which can be used to determine the response data type.
16
16
 
17
17
  ***
18
18
 
19
- ### query
19
+ ### query {#query}
20
20
 
21
21
  > **query**: `object`
22
22
 
@@ -30,12 +30,12 @@ The id of the document id we are trying to find.
30
30
 
31
31
  #### cursor?
32
32
 
33
- > `optional` **cursor**: `string`
33
+ > `optional` **cursor?**: `string`
34
34
 
35
35
  The cursor to get the next chunk of documents.
36
36
 
37
37
  #### limit?
38
38
 
39
- > `optional` **limit**: `string`
39
+ > `optional` **limit?**: `string`
40
40
 
41
41
  The number of documents to return.
@@ -4,9 +4,9 @@ Response to query the documents from an auditable item graph vertex.
4
4
 
5
5
  ## Properties
6
6
 
7
- ### headers?
7
+ ### headers? {#headers}
8
8
 
9
- > `optional` **headers**: `object`
9
+ > `optional` **headers?**: `object`
10
10
 
11
11
  The headers which can be used to determine the response data type.
12
12
 
@@ -16,11 +16,11 @@ The headers which can be used to determine the response data type.
16
16
 
17
17
  #### link?
18
18
 
19
- > `optional` **link**: `string` \| `string`[]
19
+ > `optional` **link?**: `string` \| `string`[]
20
20
 
21
21
  ***
22
22
 
23
- ### body
23
+ ### body {#body}
24
24
 
25
25
  > **body**: `IAuditableItemGraphVertexList`
26
26
 
@@ -4,7 +4,7 @@ Request to remove a document revision from an auditable item graph.
4
4
 
5
5
  ## Properties
6
6
 
7
- ### pathParams
7
+ ### pathParams {#pathparams}
8
8
 
9
9
  > **pathParams**: `object`
10
10
 
@@ -4,7 +4,7 @@ Request to update a document as an auditable item graph vertex.
4
4
 
5
5
  ## Properties
6
6
 
7
- ### pathParams
7
+ ### pathParams {#pathparams}
8
8
 
9
9
  > **pathParams**: `object`
10
10
 
@@ -18,7 +18,7 @@ The full id of the document to get.
18
18
 
19
19
  ***
20
20
 
21
- ### body
21
+ ### body {#body}
22
22
 
23
23
  > **body**: `object`
24
24
 
@@ -26,18 +26,18 @@ The body parameters.
26
26
 
27
27
  #### blob?
28
28
 
29
- > `optional` **blob**: `string`
29
+ > `optional` **blob?**: `string`
30
30
 
31
31
  The data to create the document with, in base64.
32
32
 
33
33
  #### annotationObject?
34
34
 
35
- > `optional` **annotationObject**: `IJsonLdNodeObject`
35
+ > `optional` **annotationObject?**: `IJsonLdNodeObject`
36
36
 
37
37
  Additional information to associate with the document.
38
38
 
39
39
  #### auditableItemGraphEdges?
40
40
 
41
- > `optional` **auditableItemGraphEdges**: `object`[]
41
+ > `optional` **auditableItemGraphEdges?**: `object`[]
42
42
 
43
43
  The auditable item graph vertices to connect the document to.
@@ -6,37 +6,37 @@ The contexts of document management objects.
6
6
 
7
7
  ## Type Declaration
8
8
 
9
- ### Namespace
9
+ ### Namespace {#namespace}
10
10
 
11
11
  > `readonly` **Namespace**: `"https://schema.twindev.org/documents/"` = `"https://schema.twindev.org/documents/"`
12
12
 
13
13
  The canonical RDF namespace URI for Document Management.
14
14
 
15
- ### Context
15
+ ### Context {#context}
16
16
 
17
17
  > `readonly` **Context**: `"https://schema.twindev.org/documents/"` = `"https://schema.twindev.org/documents/"`
18
18
 
19
19
  The value to use in context for Document Management.
20
20
 
21
- ### JsonLdContext
21
+ ### JsonLdContext {#jsonldcontext}
22
22
 
23
23
  > `readonly` **JsonLdContext**: `"https://schema.twindev.org/documents/types.jsonld"` = `"https://schema.twindev.org/documents/types.jsonld"`
24
24
 
25
25
  The JSON-LD Context URL for Document Management.
26
26
 
27
- ### NamespaceCommon
27
+ ### NamespaceCommon {#namespacecommon}
28
28
 
29
29
  > `readonly` **NamespaceCommon**: `"https://schema.twindev.org/common/"` = `"https://schema.twindev.org/common/"`
30
30
 
31
31
  The canonical RDF namespace URI for TWIN Common.
32
32
 
33
- ### ContextCommon
33
+ ### ContextCommon {#contextcommon}
34
34
 
35
35
  > `readonly` **ContextCommon**: `"https://schema.twindev.org/common/"` = `"https://schema.twindev.org/common/"`
36
36
 
37
37
  The value to use in JSON-LD context for TWIN Common.
38
38
 
39
- ### JsonLdContextCommon
39
+ ### JsonLdContextCommon {#jsonldcontextcommon}
40
40
 
41
41
  > `readonly` **JsonLdContextCommon**: `"https://schema.twindev.org/common/types.jsonld"` = `"https://schema.twindev.org/common/types.jsonld"`
42
42
 
@@ -6,13 +6,13 @@ The types of document management objects.
6
6
 
7
7
  ## Type Declaration
8
8
 
9
- ### Document
9
+ ### Document {#document}
10
10
 
11
11
  > `readonly` **Document**: `"Document"` = `"Document"`
12
12
 
13
13
  Represents a document.
14
14
 
15
- ### DocumentAttestation
15
+ ### DocumentAttestation {#documentattestation}
16
16
 
17
17
  > `readonly` **DocumentAttestation**: `"DocumentAttestation"` = `"DocumentAttestation"`
18
18
 
package/package.json CHANGED
@@ -1,10 +1,10 @@
1
1
  {
2
2
  "name": "@twin.org/document-management-models",
3
- "version": "0.0.3-next.11",
4
- "description": "Models which define the structure of the document management connectors and services",
3
+ "version": "0.0.3-next.13",
4
+ "description": "Shared data models, schemas, and context definitions for document lifecycle records.",
5
5
  "repository": {
6
6
  "type": "git",
7
- "url": "git+https://github.com/twinfoundation/document-management.git",
7
+ "url": "git+https://github.com/iotaledger/document-management.git",
8
8
  "directory": "packages/document-management-models"
9
9
  },
10
10
  "author": "martyn.janes@iota.org",
@@ -56,7 +56,7 @@
56
56
  "schemas"
57
57
  ],
58
58
  "bugs": {
59
- "url": "git+https://github.com/twinfoundation/document-management/issues"
59
+ "url": "git+https://github.com/iotaledger/document-management/issues"
60
60
  },
61
61
  "homepage": "https://twindev.org"
62
62
  }