@twin.org/auditable-item-stream-service 0.0.1-next.8 → 0.0.1

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 (29) hide show
  1. package/dist/cjs/index.cjs +510 -305
  2. package/dist/esm/index.mjs +512 -308
  3. package/dist/types/auditableItemStreamRoutes.d.ts +9 -1
  4. package/dist/types/auditableItemStreamService.d.ts +45 -38
  5. package/dist/types/entities/auditableItemStream.d.ts +1 -1
  6. package/dist/types/index.d.ts +2 -1
  7. package/dist/types/models/IAuditableItemStreamServiceConstructorOptions.d.ts +29 -0
  8. package/docs/changelog.md +199 -1
  9. package/docs/open-api/spec.json +2272 -2123
  10. package/docs/reference/classes/AuditableItemStream.md +5 -5
  11. package/docs/reference/classes/AuditableItemStreamEntry.md +3 -3
  12. package/docs/reference/classes/AuditableItemStreamService.md +233 -95
  13. package/docs/reference/functions/auditableItemStreamCreate.md +9 -3
  14. package/docs/reference/functions/auditableItemStreamCreateEntry.md +9 -3
  15. package/docs/reference/functions/auditableItemStreamDelete.md +31 -0
  16. package/docs/reference/functions/auditableItemStreamDeleteEntry.md +9 -3
  17. package/docs/reference/functions/auditableItemStreamGet.md +9 -3
  18. package/docs/reference/functions/auditableItemStreamGetEntry.md +9 -3
  19. package/docs/reference/functions/auditableItemStreamGetEntryObject.md +9 -3
  20. package/docs/reference/functions/auditableItemStreamList.md +9 -3
  21. package/docs/reference/functions/auditableItemStreamListEntries.md +9 -3
  22. package/docs/reference/functions/auditableItemStreamListEntryObjects.md +9 -3
  23. package/docs/reference/functions/auditableItemStreamUpdate.md +9 -3
  24. package/docs/reference/functions/auditableItemStreamUpdateEntry.md +9 -3
  25. package/docs/reference/functions/generateRestRoutesAuditableItemStream.md +8 -4
  26. package/docs/reference/index.md +2 -0
  27. package/docs/reference/interfaces/IAuditableItemStreamServiceConstructorOptions.md +61 -0
  28. package/locales/en.json +3 -1
  29. package/package.json +59 -18
@@ -4,13 +4,13 @@ Class describing the auditable item stream.
4
4
 
5
5
  ## Constructors
6
6
 
7
- ### new AuditableItemStream()
7
+ ### Constructor
8
8
 
9
- > **new AuditableItemStream**(): [`AuditableItemStream`](AuditableItemStream.md)
9
+ > **new AuditableItemStream**(): `AuditableItemStream`
10
10
 
11
11
  #### Returns
12
12
 
13
- [`AuditableItemStream`](AuditableItemStream.md)
13
+ `AuditableItemStream`
14
14
 
15
15
  ## Properties
16
16
 
@@ -54,9 +54,9 @@ The identity of the user which created the stream.
54
54
 
55
55
  ***
56
56
 
57
- ### streamObject?
57
+ ### annotationObject?
58
58
 
59
- > `optional` **streamObject**: `IJsonLdNodeObject`
59
+ > `optional` **annotationObject**: `IJsonLdNodeObject`
60
60
 
61
61
  Object to associate with the stream as JSON-LD.
62
62
 
@@ -4,13 +4,13 @@ Class describing the auditable item stream entry.
4
4
 
5
5
  ## Constructors
6
6
 
7
- ### new AuditableItemStreamEntry()
7
+ ### Constructor
8
8
 
9
- > **new AuditableItemStreamEntry**(): [`AuditableItemStreamEntry`](AuditableItemStreamEntry.md)
9
+ > **new AuditableItemStreamEntry**(): `AuditableItemStreamEntry`
10
10
 
11
11
  #### Returns
12
12
 
13
- [`AuditableItemStreamEntry`](AuditableItemStreamEntry.md)
13
+ `AuditableItemStreamEntry`
14
14
 
15
15
  ## Properties
16
16
 
@@ -8,37 +8,23 @@ Class for performing auditable item stream operations.
8
8
 
9
9
  ## Constructors
10
10
 
11
- ### new AuditableItemStreamService()
11
+ ### Constructor
12
12
 
13
- > **new AuditableItemStreamService**(`options`?): [`AuditableItemStreamService`](AuditableItemStreamService.md)
13
+ > **new AuditableItemStreamService**(`options?`): `AuditableItemStreamService`
14
14
 
15
15
  Create a new instance of AuditableItemStreamService.
16
16
 
17
17
  #### Parameters
18
18
 
19
- **options?**
19
+ ##### options?
20
20
 
21
- The dependencies for the auditable item stream connector.
22
-
23
- • **options.immutableProofComponentType?**: `string`
24
-
25
- The immutable proof component type, defaults to "immutable-proof".
26
-
27
- • **options.streamEntityStorageType?**: `string`
28
-
29
- The entity storage for stream, defaults to "auditable-item-stream".
30
-
31
- • **options.streamEntryEntityStorageType?**: `string`
21
+ [`IAuditableItemStreamServiceConstructorOptions`](../interfaces/IAuditableItemStreamServiceConstructorOptions.md)
32
22
 
33
- The entity storage for stream entries, defaults to "auditable-item-stream-entry".
34
-
35
- • **options.config?**: [`IAuditableItemStreamServiceConfig`](../interfaces/IAuditableItemStreamServiceConfig.md)
36
-
37
- The configuration for the connector.
23
+ The dependencies for the auditable item stream connector.
38
24
 
39
25
  #### Returns
40
26
 
41
- [`AuditableItemStreamService`](AuditableItemStreamService.md)
27
+ `AuditableItemStreamService`
42
28
 
43
29
  ## Properties
44
30
 
@@ -64,34 +50,48 @@ Runtime name for the class.
64
50
 
65
51
  ### create()
66
52
 
67
- > **create**(`streamObject`?, `entries`?, `options`?, `userIdentity`?, `nodeIdentity`?): `Promise`\<`string`\>
53
+ > **create**(`stream`, `options?`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`string`\>
68
54
 
69
55
  Create a new stream.
70
56
 
71
57
  #### Parameters
72
58
 
73
- **streamObject?**: `IJsonLdNodeObject`
59
+ ##### stream
60
+
61
+ The stream to create.
62
+
63
+ ###### annotationObject?
64
+
65
+ `IJsonLdNodeObject`
74
66
 
75
67
  The object for the stream as JSON-LD.
76
68
 
77
- **entries?**: `object`[]
69
+ ###### entries?
70
+
71
+ `object`[]
78
72
 
79
73
  Entries to store in the stream.
80
74
 
81
- **options?**
75
+ ##### options?
82
76
 
83
77
  Options for creating the stream.
84
78
 
85
- **options.immutableInterval?**: `number`
79
+ ###### immutableInterval?
80
+
81
+ `number`
86
82
 
87
83
  After how many entries do we add immutable checks, defaults to service configured value.
88
84
  A value of 0 will disable integrity checks, 1 will be every item, or any other integer for an interval.
89
85
 
90
- **userIdentity?**: `string`
86
+ ##### userIdentity?
87
+
88
+ `string`
91
89
 
92
90
  The identity to create the auditable item stream operation with.
93
91
 
94
- **nodeIdentity?**: `string`
92
+ ##### nodeIdentity?
93
+
94
+ `string`
95
95
 
96
96
  The node identity to use for vault operations.
97
97
 
@@ -109,33 +109,43 @@ The id of the new stream item.
109
109
 
110
110
  ### get()
111
111
 
112
- > **get**(`id`, `options`?): `Promise`\<`IAuditableItemStream`\>
112
+ > **get**(`id`, `options?`): `Promise`\<`IAuditableItemStream`\>
113
113
 
114
114
  Get a stream header without the entries.
115
115
 
116
116
  #### Parameters
117
117
 
118
- **id**: `string`
118
+ ##### id
119
+
120
+ `string`
119
121
 
120
122
  The id of the stream to get.
121
123
 
122
- **options?**
124
+ ##### options?
123
125
 
124
126
  Additional options for the get operation.
125
127
 
126
- **options.includeEntries?**: `boolean`
128
+ ###### includeEntries?
129
+
130
+ `boolean`
127
131
 
128
132
  Whether to include the entries, defaults to false.
129
133
 
130
- **options.includeDeleted?**: `boolean`
134
+ ###### includeDeleted?
135
+
136
+ `boolean`
131
137
 
132
138
  Whether to include deleted entries, defaults to false.
133
139
 
134
- **options.verifyStream?**: `boolean`
140
+ ###### verifyStream?
141
+
142
+ `boolean`
135
143
 
136
144
  Should the stream be verified, defaults to false.
137
145
 
138
- **options.verifyEntries?**: `boolean`
146
+ ###### verifyEntries?
147
+
148
+ `boolean`
139
149
 
140
150
  Should the entries be verified, defaults to false.
141
151
 
@@ -157,25 +167,37 @@ NotFoundError if the stream is not found
157
167
 
158
168
  ### update()
159
169
 
160
- > **update**(`id`, `streamObject`?, `userIdentity`?, `nodeIdentity`?): `Promise`\<`void`\>
170
+ > **update**(`stream`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`void`\>
161
171
 
162
172
  Update a stream.
163
173
 
164
174
  #### Parameters
165
175
 
166
- **id**: `string`
176
+ ##### stream
177
+
178
+ The stream to update.
179
+
180
+ ###### id
181
+
182
+ `string`
167
183
 
168
184
  The id of the stream to update.
169
185
 
170
- **streamObject?**: `IJsonLdNodeObject`
186
+ ###### annotationObject?
187
+
188
+ `IJsonLdNodeObject`
171
189
 
172
190
  The object for the stream as JSON-LD.
173
191
 
174
- **userIdentity?**: `string`
192
+ ##### userIdentity?
193
+
194
+ `string`
175
195
 
176
196
  The identity to create the auditable item stream operation with.
177
197
 
178
- **nodeIdentity?**: `string`
198
+ ##### nodeIdentity?
199
+
200
+ `string`
179
201
 
180
202
  The node identity to use for vault operations.
181
203
 
@@ -191,35 +213,85 @@ Nothing.
191
213
 
192
214
  ***
193
215
 
216
+ ### remove()
217
+
218
+ > **remove**(`id`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`void`\>
219
+
220
+ Delete the stream.
221
+
222
+ #### Parameters
223
+
224
+ ##### id
225
+
226
+ `string`
227
+
228
+ The id of the stream to remove.
229
+
230
+ ##### userIdentity?
231
+
232
+ `string`
233
+
234
+ The identity to create the auditable item stream operation with.
235
+
236
+ ##### nodeIdentity?
237
+
238
+ `string`
239
+
240
+ The node identity to use for vault operations.
241
+
242
+ #### Returns
243
+
244
+ `Promise`\<`void`\>
245
+
246
+ Nothing.
247
+
248
+ #### Implementation of
249
+
250
+ `IAuditableItemStreamComponent.remove`
251
+
252
+ ***
253
+
194
254
  ### query()
195
255
 
196
- > **query**(`conditions`?, `orderBy`?, `orderByDirection`?, `properties`?, `cursor`?, `pageSize`?): `Promise`\<`IAuditableItemStreamList`\>
256
+ > **query**(`conditions?`, `orderBy?`, `orderByDirection?`, `properties?`, `cursor?`, `pageSize?`): `Promise`\<`IAuditableItemStreamList`\>
197
257
 
198
258
  Query all the streams, will not return entries.
199
259
 
200
260
  #### Parameters
201
261
 
202
- **conditions?**: `IComparator`[]
262
+ ##### conditions?
263
+
264
+ `IComparator`[]
203
265
 
204
266
  Conditions to use in the query.
205
267
 
206
- **orderBy?**: `"dateCreated"` \| `"dateModified"`
268
+ ##### orderBy?
207
269
 
208
270
  The order for the results, defaults to created.
209
271
 
210
- **orderByDirection?**: `SortDirection`
272
+ `"dateCreated"` | `"dateModified"`
273
+
274
+ ##### orderByDirection?
275
+
276
+ `SortDirection`
211
277
 
212
278
  The direction for the order, defaults to descending.
213
279
 
214
- **properties?**: keyof `IAuditableItemStream`[]
280
+ ##### properties?
281
+
282
+ keyof `IAuditableItemStream`[]
215
283
 
216
284
  The properties to return, if not provided defaults to id, created and object.
217
285
 
218
- **cursor?**: `string`
286
+ ##### cursor?
287
+
288
+ `string`
219
289
 
220
290
  The cursor to request the next page of entities.
221
291
 
222
- **pageSize?**: `number`
292
+ ##### pageSize?
293
+
294
+ `number`
223
295
 
224
296
  The maximum number of entities in a page.
225
297
 
@@ -237,25 +309,33 @@ The entities, which can be partial if a limited keys list was provided.
237
309
 
238
310
  ### createEntry()
239
311
 
240
- > **createEntry**(`id`, `entryObject`, `userIdentity`?, `nodeIdentity`?): `Promise`\<`string`\>
312
+ > **createEntry**(`streamId`, `entryObject`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`string`\>
241
313
 
242
314
  Create an entry in the stream.
243
315
 
244
316
  #### Parameters
245
317
 
246
- **id**: `string`
318
+ ##### streamId
319
+
320
+ `string`
247
321
 
248
322
  The id of the stream to update.
249
323
 
250
- **entryObject**: `IJsonLdNodeObject`
324
+ ##### entryObject
325
+
326
+ `IJsonLdNodeObject`
251
327
 
252
328
  The object for the stream as JSON-LD.
253
329
 
254
- **userIdentity?**: `string`
330
+ ##### userIdentity?
331
+
332
+ `string`
255
333
 
256
334
  The identity to create the auditable item stream operation with.
257
335
 
258
- **nodeIdentity?**: `string`
336
+ ##### nodeIdentity?
337
+
338
+ `string`
259
339
 
260
340
  The node identity to use for vault operations.
261
341
 
@@ -273,25 +353,31 @@ The id of the created entry, if not provided.
273
353
 
274
354
  ### getEntry()
275
355
 
276
- > **getEntry**(`id`, `entryId`, `options`?): `Promise`\<`IAuditableItemStreamEntry`\>
356
+ > **getEntry**(`streamId`, `entryId`, `options?`): `Promise`\<`IAuditableItemStreamEntry`\>
277
357
 
278
358
  Get the entry from the stream.
279
359
 
280
360
  #### Parameters
281
361
 
282
- **id**: `string`
362
+ ##### streamId
363
+
364
+ `string`
283
365
 
284
366
  The id of the stream to get.
285
367
 
286
- **entryId**: `string`
368
+ ##### entryId
369
+
370
+ `string`
287
371
 
288
372
  The id of the stream entry to get.
289
373
 
290
- **options?**
374
+ ##### options?
291
375
 
292
376
  Additional options for the get operation.
293
377
 
294
- **options.verifyEntry?**: `boolean`
378
+ ###### verifyEntry?
379
+
380
+ `boolean`
295
381
 
296
382
  Should the entry be verified, defaults to false.
297
383
 
@@ -313,17 +399,21 @@ NotFoundError if the stream is not found.
313
399
 
314
400
  ### getEntryObject()
315
401
 
316
- > **getEntryObject**(`id`, `entryId`): `Promise`\<`IJsonLdNodeObject`\>
402
+ > **getEntryObject**(`streamId`, `entryId`): `Promise`\<`IJsonLdNodeObject`\>
317
403
 
318
404
  Get the entry object from the stream.
319
405
 
320
406
  #### Parameters
321
407
 
322
- **id**: `string`
408
+ ##### streamId
409
+
410
+ `string`
323
411
 
324
412
  The id of the stream to get.
325
413
 
326
- **entryId**: `string`
414
+ ##### entryId
415
+
416
+ `string`
327
417
 
328
418
  The id of the stream entry to get.
329
419
 
@@ -345,29 +435,39 @@ NotFoundError if the stream is not found.
345
435
 
346
436
  ### updateEntry()
347
437
 
348
- > **updateEntry**(`id`, `entryId`, `entryObject`, `userIdentity`?, `nodeIdentity`?): `Promise`\<`void`\>
438
+ > **updateEntry**(`streamId`, `entryId`, `entryObject`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`void`\>
349
439
 
350
440
  Update an entry in the stream.
351
441
 
352
442
  #### Parameters
353
443
 
354
- **id**: `string`
444
+ ##### streamId
445
+
446
+ `string`
355
447
 
356
448
  The id of the stream to update.
357
449
 
358
- **entryId**: `string`
450
+ ##### entryId
451
+
452
+ `string`
359
453
 
360
454
  The id of the entry to update.
361
455
 
362
- **entryObject**: `IJsonLdNodeObject`
456
+ ##### entryObject
457
+
458
+ `IJsonLdNodeObject`
363
459
 
364
460
  The object for the entry as JSON-LD.
365
461
 
366
- **userIdentity?**: `string`
462
+ ##### userIdentity?
463
+
464
+ `string`
367
465
 
368
466
  The identity to create the auditable item stream operation with.
369
467
 
370
- **nodeIdentity?**: `string`
468
+ ##### nodeIdentity?
469
+
470
+ `string`
371
471
 
372
472
  The node identity to use for vault operations.
373
473
 
@@ -385,25 +485,33 @@ Nothing.
385
485
 
386
486
  ### removeEntry()
387
487
 
388
- > **removeEntry**(`id`, `entryId`, `userIdentity`?, `nodeIdentity`?): `Promise`\<`void`\>
488
+ > **removeEntry**(`streamId`, `entryId`, `userIdentity?`, `nodeIdentity?`): `Promise`\<`void`\>
389
489
 
390
490
  Delete from the stream.
391
491
 
392
492
  #### Parameters
393
493
 
394
- **id**: `string`
494
+ ##### streamId
395
495
 
396
- The id of the stream to update.
496
+ `string`
497
+
498
+ The id of the stream to remove from.
499
+
500
+ ##### entryId
397
501
 
398
- • **entryId**: `string`
502
+ `string`
399
503
 
400
- The id of the entry to delete.
504
+ The id of the entry to remove.
401
505
 
402
- **userIdentity?**: `string`
506
+ ##### userIdentity?
507
+
508
+ `string`
403
509
 
404
510
  The identity to create the auditable item stream operation with.
405
511
 
406
- **nodeIdentity?**: `string`
512
+ ##### nodeIdentity?
513
+
514
+ `string`
407
515
 
408
516
  The node identity to use for vault operations.
409
517
 
@@ -421,41 +529,55 @@ Nothing.
421
529
 
422
530
  ### getEntries()
423
531
 
424
- > **getEntries**(`id`, `options`?): `Promise`\<`IAuditableItemStreamEntryList`\>
532
+ > **getEntries**(`streamId`, `options?`): `Promise`\<`IAuditableItemStreamEntryList`\>
425
533
 
426
534
  Get the entries for the stream.
427
535
 
428
536
  #### Parameters
429
537
 
430
- **id**: `string`
538
+ ##### streamId
539
+
540
+ `string`
431
541
 
432
542
  The id of the stream to get.
433
543
 
434
- **options?**
544
+ ##### options?
435
545
 
436
546
  Additional options for the get operation.
437
547
 
438
- **options.conditions?**: `IComparator`[]
548
+ ###### conditions?
549
+
550
+ `IComparator`[]
439
551
 
440
552
  The conditions to filter the stream.
441
553
 
442
- **options.includeDeleted?**: `boolean`
554
+ ###### includeDeleted?
555
+
556
+ `boolean`
443
557
 
444
558
  Whether to include deleted entries, defaults to false.
445
559
 
446
- **options.verifyEntries?**: `boolean`
560
+ ###### verifyEntries?
561
+
562
+ `boolean`
447
563
 
448
564
  Should the entries be verified, defaults to false.
449
565
 
450
- **options.pageSize?**: `number`
566
+ ###### pageSize?
567
+
568
+ `number`
451
569
 
452
570
  How many entries to return.
453
571
 
454
- **options.cursor?**: `string`
572
+ ###### cursor?
573
+
574
+ `string`
455
575
 
456
576
  Cursor to use for next chunk of data.
457
577
 
458
- **options.order?**: `SortDirection`
578
+ ###### order?
579
+
580
+ `SortDirection`
459
581
 
460
582
  Retrieve the entries in ascending/descending time order, defaults to Ascending.
461
583
 
@@ -477,37 +599,49 @@ NotFoundError if the stream is not found.
477
599
 
478
600
  ### getEntryObjects()
479
601
 
480
- > **getEntryObjects**(`id`, `options`?): `Promise`\<`IAuditableItemStreamEntryObjectList`\>
602
+ > **getEntryObjects**(`streamId`, `options?`): `Promise`\<`IAuditableItemStreamEntryObjectList`\>
481
603
 
482
604
  Get the entry objects for the stream.
483
605
 
484
606
  #### Parameters
485
607
 
486
- **id**: `string`
608
+ ##### streamId
609
+
610
+ `string`
487
611
 
488
612
  The id of the stream to get.
489
613
 
490
- **options?**
614
+ ##### options?
491
615
 
492
616
  Additional options for the get operation.
493
617
 
494
- **options.conditions?**: `IComparator`[]
618
+ ###### conditions?
619
+
620
+ `IComparator`[]
495
621
 
496
622
  The conditions to filter the stream.
497
623
 
498
- **options.includeDeleted?**: `boolean`
624
+ ###### includeDeleted?
625
+
626
+ `boolean`
499
627
 
500
628
  Whether to include deleted entries, defaults to false.
501
629
 
502
- **options.pageSize?**: `number`
630
+ ###### pageSize?
631
+
632
+ `number`
503
633
 
504
634
  How many entries to return.
505
635
 
506
- **options.cursor?**: `string`
636
+ ###### cursor?
637
+
638
+ `string`
507
639
 
508
640
  Cursor to use for next chunk of data.
509
641
 
510
- **options.order?**: `SortDirection`
642
+ ###### order?
643
+
644
+ `SortDirection`
511
645
 
512
646
  Retrieve the entries in ascending/descending time order, defaults to Ascending.
513
647
 
@@ -527,19 +661,23 @@ NotFoundError if the stream is not found.
527
661
 
528
662
  ***
529
663
 
530
- ### removeImmutable()
664
+ ### removeVerifiable()
531
665
 
532
- > **removeImmutable**(`id`, `nodeIdentity`?): `Promise`\<`void`\>
666
+ > **removeVerifiable**(`streamId`, `nodeIdentity?`): `Promise`\<`void`\>
533
667
 
534
- Remove the immutable storage for the stream and entries.
668
+ Remove the verifiable storage for the stream and entries.
535
669
 
536
670
  #### Parameters
537
671
 
538
- **id**: `string`
672
+ ##### streamId
673
+
674
+ `string`
539
675
 
540
676
  The id of the stream to remove the storage from.
541
677
 
542
- **nodeIdentity?**: `string`
678
+ ##### nodeIdentity?
679
+
680
+ `string`
543
681
 
544
682
  The node identity to use for vault operations.
545
683
 
@@ -555,4 +693,4 @@ NotFoundError if the vertex is not found.
555
693
 
556
694
  #### Implementation of
557
695
 
558
- `IAuditableItemStreamComponent.removeImmutable`
696
+ `IAuditableItemStreamComponent.removeVerifiable`
@@ -6,15 +6,21 @@ Create the stream.
6
6
 
7
7
  ## Parameters
8
8
 
9
- **httpRequestContext**: `IHttpRequestContext`
9
+ ### httpRequestContext
10
+
11
+ `IHttpRequestContext`
10
12
 
11
13
  The request context for the API.
12
14
 
13
- **componentName**: `string`
15
+ ### componentName
16
+
17
+ `string`
14
18
 
15
19
  The name of the component to use in the routes.
16
20
 
17
- **request**: `IAuditableItemStreamCreateRequest`
21
+ ### request
22
+
23
+ `IAuditableItemStreamCreateRequest`
18
24
 
19
25
  The request.
20
26