@twin.org/blob-storage-service 0.0.3-next.7 → 0.0.3-next.8
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.
- package/README.md +1 -1
- package/docs/changelog.md +83 -67
- package/docs/examples.md +109 -1
- package/docs/open-api/spec.json +29 -64
- package/docs/reference/classes/BlobStorageEntry.md +15 -15
- package/docs/reference/classes/BlobStorageService.md +9 -9
- package/docs/reference/interfaces/IBlobStorageServiceConfig.md +4 -4
- package/docs/reference/interfaces/IBlobStorageServiceConstructorOptions.md +6 -6
- package/package.json +5 -5
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# TWIN Blob Storage Service
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
This package exposes service-side components and endpoint definitions for blob upload, retrieval, and management operations. It bridges shared blob models with application service layers so APIs can be published with consistent behaviour.
|
|
4
4
|
|
|
5
5
|
## Installation
|
|
6
6
|
|
package/docs/changelog.md
CHANGED
|
@@ -1,11 +1,27 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Changelog
|
|
2
2
|
|
|
3
|
-
## [0.0.3-next.
|
|
3
|
+
## [0.0.3-next.8](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.3-next.7...blob-storage-service-v0.0.3-next.8) (2026-05-07)
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
### Miscellaneous Chores
|
|
7
|
+
|
|
8
|
+
* **blob-storage-service:** Synchronize repo versions
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
### Dependencies
|
|
12
|
+
|
|
13
|
+
* The following workspace dependencies were updated
|
|
14
|
+
* dependencies
|
|
15
|
+
* @twin.org/blob-storage-models bumped from 0.0.3-next.7 to 0.0.3-next.8
|
|
16
|
+
* devDependencies
|
|
17
|
+
* @twin.org/blob-storage-connector-memory bumped from 0.0.3-next.7 to 0.0.3-next.8
|
|
18
|
+
|
|
19
|
+
## [0.0.3-next.7](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.3-next.6...blob-storage-service-v0.0.3-next.7) (2026-02-25)
|
|
4
20
|
|
|
5
21
|
|
|
6
22
|
### Features
|
|
7
23
|
|
|
8
|
-
* update schemas ([6fe6571](https://github.com/
|
|
24
|
+
* update schemas ([6fe6571](https://github.com/iotaledger/twin-blob-storage/commit/6fe65714e23209cdd760ecd5aa8e18762044e4b3))
|
|
9
25
|
|
|
10
26
|
|
|
11
27
|
### Dependencies
|
|
@@ -16,14 +32,14 @@
|
|
|
16
32
|
* devDependencies
|
|
17
33
|
* @twin.org/blob-storage-connector-memory bumped from 0.0.3-next.6 to 0.0.3-next.7
|
|
18
34
|
|
|
19
|
-
## [0.0.3-next.6](https://github.com/
|
|
35
|
+
## [0.0.3-next.6](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.3-next.5...blob-storage-service-v0.0.3-next.6) (2026-02-09)
|
|
20
36
|
|
|
21
37
|
|
|
22
38
|
### Features
|
|
23
39
|
|
|
24
|
-
* add ts-to-jsonld-context tool ([2fd217f](https://github.com/
|
|
25
|
-
* blobHash changed to integrity ([#41](https://github.com/
|
|
26
|
-
* update naming ([19d160f](https://github.com/
|
|
40
|
+
* add ts-to-jsonld-context tool ([2fd217f](https://github.com/iotaledger/twin-blob-storage/commit/2fd217f50dfaf6ac068091876237f5a101a7995e))
|
|
41
|
+
* blobHash changed to integrity ([#41](https://github.com/iotaledger/twin-blob-storage/issues/41)) ([c06a55f](https://github.com/iotaledger/twin-blob-storage/commit/c06a55f0eed3f7cad5d19c4084abd8ef0cdbfb60))
|
|
42
|
+
* update naming ([19d160f](https://github.com/iotaledger/twin-blob-storage/commit/19d160f6c2b155a1a19b85f4d676cbc15c0f0869))
|
|
27
43
|
|
|
28
44
|
|
|
29
45
|
### Dependencies
|
|
@@ -34,12 +50,12 @@
|
|
|
34
50
|
* devDependencies
|
|
35
51
|
* @twin.org/blob-storage-connector-memory bumped from 0.0.3-next.5 to 0.0.3-next.6
|
|
36
52
|
|
|
37
|
-
## [0.0.3-next.5](https://github.com/
|
|
53
|
+
## [0.0.3-next.5](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.3-next.4...blob-storage-service-v0.0.3-next.5) (2026-01-26)
|
|
38
54
|
|
|
39
55
|
|
|
40
56
|
### Features
|
|
41
57
|
|
|
42
|
-
* use new hosting url for cursor links ([6844126](https://github.com/
|
|
58
|
+
* use new hosting url for cursor links ([6844126](https://github.com/iotaledger/twin-blob-storage/commit/6844126e1c431448de51225392daa3559776fdf3))
|
|
43
59
|
|
|
44
60
|
|
|
45
61
|
### Dependencies
|
|
@@ -50,12 +66,12 @@
|
|
|
50
66
|
* devDependencies
|
|
51
67
|
* @twin.org/blob-storage-connector-memory bumped from 0.0.3-next.4 to 0.0.3-next.5
|
|
52
68
|
|
|
53
|
-
## [0.0.3-next.4](https://github.com/
|
|
69
|
+
## [0.0.3-next.4](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.3-next.3...blob-storage-service-v0.0.3-next.4) (2026-01-23)
|
|
54
70
|
|
|
55
71
|
|
|
56
72
|
### Features
|
|
57
73
|
|
|
58
|
-
* replace nextItem property with Link header ([#37](https://github.com/
|
|
74
|
+
* replace nextItem property with Link header ([#37](https://github.com/iotaledger/twin-blob-storage/issues/37)) ([0b68da5](https://github.com/iotaledger/twin-blob-storage/commit/0b68da58549c9e52eb2313ea5a868573840d5ca6))
|
|
59
75
|
|
|
60
76
|
|
|
61
77
|
### Dependencies
|
|
@@ -66,12 +82,12 @@
|
|
|
66
82
|
* devDependencies
|
|
67
83
|
* @twin.org/blob-storage-connector-memory bumped from 0.0.3-next.3 to 0.0.3-next.4
|
|
68
84
|
|
|
69
|
-
## [0.0.3-next.3](https://github.com/
|
|
85
|
+
## [0.0.3-next.3](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.3-next.2...blob-storage-service-v0.0.3-next.3) (2026-01-21)
|
|
70
86
|
|
|
71
87
|
|
|
72
88
|
### Features
|
|
73
89
|
|
|
74
|
-
* update contexts ([#34](https://github.com/
|
|
90
|
+
* update contexts ([#34](https://github.com/iotaledger/twin-blob-storage/issues/34)) ([b9e432c](https://github.com/iotaledger/twin-blob-storage/commit/b9e432c26025e4bfdf5ba837516dfdbf40f45a61))
|
|
75
91
|
|
|
76
92
|
|
|
77
93
|
### Dependencies
|
|
@@ -82,17 +98,17 @@
|
|
|
82
98
|
* devDependencies
|
|
83
99
|
* @twin.org/blob-storage-connector-memory bumped from 0.0.3-next.2 to 0.0.3-next.3
|
|
84
100
|
|
|
85
|
-
## [0.0.3-next.2](https://github.com/
|
|
101
|
+
## [0.0.3-next.2](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.3-next.1...blob-storage-service-v0.0.3-next.2) (2026-01-14)
|
|
86
102
|
|
|
87
103
|
|
|
88
104
|
### Features
|
|
89
105
|
|
|
90
|
-
* update contexts and namespaces ([#32](https://github.com/
|
|
106
|
+
* update contexts and namespaces ([#32](https://github.com/iotaledger/twin-blob-storage/issues/32)) ([187ed36](https://github.com/iotaledger/twin-blob-storage/commit/187ed36a7d83062665f70689ec5e2b2f553a592e))
|
|
91
107
|
|
|
92
108
|
|
|
93
109
|
### Bug Fixes
|
|
94
110
|
|
|
95
|
-
* api docs ([0f5d3ad](https://github.com/
|
|
111
|
+
* api docs ([0f5d3ad](https://github.com/iotaledger/twin-blob-storage/commit/0f5d3ad88c4c048495ffd64886d00ceb25a976d6))
|
|
96
112
|
|
|
97
113
|
|
|
98
114
|
### Dependencies
|
|
@@ -103,29 +119,29 @@
|
|
|
103
119
|
* devDependencies
|
|
104
120
|
* @twin.org/blob-storage-connector-memory bumped from 0.0.3-next.1 to 0.0.3-next.2
|
|
105
121
|
|
|
106
|
-
## [0.0.3-next.1](https://github.com/
|
|
122
|
+
## [0.0.3-next.1](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.3-next.0...blob-storage-service-v0.0.3-next.1) (2025-11-11)
|
|
107
123
|
|
|
108
124
|
|
|
109
125
|
### Features
|
|
110
126
|
|
|
111
|
-
* add compression support ([67d239b](https://github.com/
|
|
112
|
-
* add context id features ([#30](https://github.com/
|
|
113
|
-
* add validate-locales ([f20fcec](https://github.com/
|
|
114
|
-
* additional encryption options on per item basis ([4b95a65](https://github.com/
|
|
115
|
-
* eslint migration to flat config ([e4239dd](https://github.com/
|
|
116
|
-
* remove includeNodeIdentity flag ([13bc334](https://github.com/
|
|
117
|
-
* remove unused namespace ([6376433](https://github.com/
|
|
118
|
-
* update dependencies ([56f0094](https://github.com/
|
|
119
|
-
* update framework core ([ff339fe](https://github.com/
|
|
120
|
-
* update to support fully qualified data type names ([3297d69](https://github.com/
|
|
121
|
-
* use shared store mechanism ([#12](https://github.com/
|
|
122
|
-
* use standard list json ld types ([d6bdfd6](https://github.com/
|
|
127
|
+
* add compression support ([67d239b](https://github.com/iotaledger/twin-blob-storage/commit/67d239bca8321bd90bf4ff93167c564130309730))
|
|
128
|
+
* add context id features ([#30](https://github.com/iotaledger/twin-blob-storage/issues/30)) ([fbf1c92](https://github.com/iotaledger/twin-blob-storage/commit/fbf1c9276424c841ef5ef3f4de8469ab3fba7e9c))
|
|
129
|
+
* add validate-locales ([f20fcec](https://github.com/iotaledger/twin-blob-storage/commit/f20fceced91e39a0c9edb770b2e43ce944c92f3c))
|
|
130
|
+
* additional encryption options on per item basis ([4b95a65](https://github.com/iotaledger/twin-blob-storage/commit/4b95a656d19e3b571cea905e36f29b679b13e1e8))
|
|
131
|
+
* eslint migration to flat config ([e4239dd](https://github.com/iotaledger/twin-blob-storage/commit/e4239dd1c721955cff7f0357255d2bba15319972))
|
|
132
|
+
* remove includeNodeIdentity flag ([13bc334](https://github.com/iotaledger/twin-blob-storage/commit/13bc33445b179879688af3c98e8be8a5609d3f46))
|
|
133
|
+
* remove unused namespace ([6376433](https://github.com/iotaledger/twin-blob-storage/commit/637643399ffa42dbf6af07e7579e82e392ac90c9))
|
|
134
|
+
* update dependencies ([56f0094](https://github.com/iotaledger/twin-blob-storage/commit/56f0094b68d8bd22864cd899ac1b61d95540f719))
|
|
135
|
+
* update framework core ([ff339fe](https://github.com/iotaledger/twin-blob-storage/commit/ff339fe7e3f09ddff429907834bdf43617e9c05e))
|
|
136
|
+
* update to support fully qualified data type names ([3297d69](https://github.com/iotaledger/twin-blob-storage/commit/3297d69d332058b0f0141002087f56ba230620e1))
|
|
137
|
+
* use shared store mechanism ([#12](https://github.com/iotaledger/twin-blob-storage/issues/12)) ([cae8110](https://github.com/iotaledger/twin-blob-storage/commit/cae8110681847a1ac4fcac968b8196694e49c320))
|
|
138
|
+
* use standard list json ld types ([d6bdfd6](https://github.com/iotaledger/twin-blob-storage/commit/d6bdfd68af47f70f3cc53658b4a12543497e1f48))
|
|
123
139
|
|
|
124
140
|
|
|
125
141
|
### Bug Fixes
|
|
126
142
|
|
|
127
|
-
* Adding the optional flag to the entity ([#10](https://github.com/
|
|
128
|
-
* query params force coercion ([a5e547a](https://github.com/
|
|
143
|
+
* Adding the optional flag to the entity ([#10](https://github.com/iotaledger/twin-blob-storage/issues/10)) ([626677e](https://github.com/iotaledger/twin-blob-storage/commit/626677e5730d23535a0eb1f36f8394d941ff2447))
|
|
144
|
+
* query params force coercion ([a5e547a](https://github.com/iotaledger/twin-blob-storage/commit/a5e547a775f8997cb04780938c7a9561ddb048d1))
|
|
129
145
|
|
|
130
146
|
|
|
131
147
|
### Dependencies
|
|
@@ -136,12 +152,12 @@
|
|
|
136
152
|
* devDependencies
|
|
137
153
|
* @twin.org/blob-storage-connector-memory bumped from 0.0.3-next.0 to 0.0.3-next.1
|
|
138
154
|
|
|
139
|
-
## [0.0.2-next.5](https://github.com/
|
|
155
|
+
## [0.0.2-next.5](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.2-next.4...blob-storage-service-v0.0.2-next.5) (2025-10-09)
|
|
140
156
|
|
|
141
157
|
|
|
142
158
|
### Features
|
|
143
159
|
|
|
144
|
-
* add validate-locales ([f20fcec](https://github.com/
|
|
160
|
+
* add validate-locales ([f20fcec](https://github.com/iotaledger/twin-blob-storage/commit/f20fceced91e39a0c9edb770b2e43ce944c92f3c))
|
|
145
161
|
|
|
146
162
|
|
|
147
163
|
### Dependencies
|
|
@@ -152,7 +168,7 @@
|
|
|
152
168
|
* devDependencies
|
|
153
169
|
* @twin.org/blob-storage-connector-memory bumped from 0.0.2-next.4 to 0.0.2-next.5
|
|
154
170
|
|
|
155
|
-
## [0.0.2-next.4](https://github.com/
|
|
171
|
+
## [0.0.2-next.4](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.2-next.3...blob-storage-service-v0.0.2-next.4) (2025-10-02)
|
|
156
172
|
|
|
157
173
|
|
|
158
174
|
### Miscellaneous Chores
|
|
@@ -168,12 +184,12 @@
|
|
|
168
184
|
* devDependencies
|
|
169
185
|
* @twin.org/blob-storage-connector-memory bumped from 0.0.2-next.3 to 0.0.2-next.4
|
|
170
186
|
|
|
171
|
-
## [0.0.2-next.3](https://github.com/
|
|
187
|
+
## [0.0.2-next.3](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.2-next.2...blob-storage-service-v0.0.2-next.3) (2025-08-29)
|
|
172
188
|
|
|
173
189
|
|
|
174
190
|
### Features
|
|
175
191
|
|
|
176
|
-
* eslint migration to flat config ([e4239dd](https://github.com/
|
|
192
|
+
* eslint migration to flat config ([e4239dd](https://github.com/iotaledger/twin-blob-storage/commit/e4239dd1c721955cff7f0357255d2bba15319972))
|
|
177
193
|
|
|
178
194
|
|
|
179
195
|
### Dependencies
|
|
@@ -184,12 +200,12 @@
|
|
|
184
200
|
* devDependencies
|
|
185
201
|
* @twin.org/blob-storage-connector-memory bumped from 0.0.2-next.2 to 0.0.2-next.3
|
|
186
202
|
|
|
187
|
-
## [0.0.2-next.2](https://github.com/
|
|
203
|
+
## [0.0.2-next.2](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.2-next.1...blob-storage-service-v0.0.2-next.2) (2025-08-20)
|
|
188
204
|
|
|
189
205
|
|
|
190
206
|
### Features
|
|
191
207
|
|
|
192
|
-
* update framework core ([ff339fe](https://github.com/
|
|
208
|
+
* update framework core ([ff339fe](https://github.com/iotaledger/twin-blob-storage/commit/ff339fe7e3f09ddff429907834bdf43617e9c05e))
|
|
193
209
|
|
|
194
210
|
|
|
195
211
|
### Dependencies
|
|
@@ -200,25 +216,25 @@
|
|
|
200
216
|
* devDependencies
|
|
201
217
|
* @twin.org/blob-storage-connector-memory bumped from 0.0.2-next.1 to 0.0.2-next.2
|
|
202
218
|
|
|
203
|
-
## [0.0.2-next.1](https://github.com/
|
|
219
|
+
## [0.0.2-next.1](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.2-next.0...blob-storage-service-v0.0.2-next.1) (2025-07-24)
|
|
204
220
|
|
|
205
221
|
|
|
206
222
|
### Features
|
|
207
223
|
|
|
208
|
-
* add compression support ([67d239b](https://github.com/
|
|
209
|
-
* additional encryption options on per item basis ([4b95a65](https://github.com/
|
|
210
|
-
* remove includeNodeIdentity flag ([13bc334](https://github.com/
|
|
211
|
-
* remove unused namespace ([6376433](https://github.com/
|
|
212
|
-
* update dependencies ([56f0094](https://github.com/
|
|
213
|
-
* update to support fully qualified data type names ([3297d69](https://github.com/
|
|
214
|
-
* use shared store mechanism ([#12](https://github.com/
|
|
215
|
-
* use standard list json ld types ([d6bdfd6](https://github.com/
|
|
224
|
+
* add compression support ([67d239b](https://github.com/iotaledger/twin-blob-storage/commit/67d239bca8321bd90bf4ff93167c564130309730))
|
|
225
|
+
* additional encryption options on per item basis ([4b95a65](https://github.com/iotaledger/twin-blob-storage/commit/4b95a656d19e3b571cea905e36f29b679b13e1e8))
|
|
226
|
+
* remove includeNodeIdentity flag ([13bc334](https://github.com/iotaledger/twin-blob-storage/commit/13bc33445b179879688af3c98e8be8a5609d3f46))
|
|
227
|
+
* remove unused namespace ([6376433](https://github.com/iotaledger/twin-blob-storage/commit/637643399ffa42dbf6af07e7579e82e392ac90c9))
|
|
228
|
+
* update dependencies ([56f0094](https://github.com/iotaledger/twin-blob-storage/commit/56f0094b68d8bd22864cd899ac1b61d95540f719))
|
|
229
|
+
* update to support fully qualified data type names ([3297d69](https://github.com/iotaledger/twin-blob-storage/commit/3297d69d332058b0f0141002087f56ba230620e1))
|
|
230
|
+
* use shared store mechanism ([#12](https://github.com/iotaledger/twin-blob-storage/issues/12)) ([cae8110](https://github.com/iotaledger/twin-blob-storage/commit/cae8110681847a1ac4fcac968b8196694e49c320))
|
|
231
|
+
* use standard list json ld types ([d6bdfd6](https://github.com/iotaledger/twin-blob-storage/commit/d6bdfd68af47f70f3cc53658b4a12543497e1f48))
|
|
216
232
|
|
|
217
233
|
|
|
218
234
|
### Bug Fixes
|
|
219
235
|
|
|
220
|
-
* Adding the optional flag to the entity ([#10](https://github.com/
|
|
221
|
-
* query params force coercion ([a5e547a](https://github.com/
|
|
236
|
+
* Adding the optional flag to the entity ([#10](https://github.com/iotaledger/twin-blob-storage/issues/10)) ([626677e](https://github.com/iotaledger/twin-blob-storage/commit/626677e5730d23535a0eb1f36f8394d941ff2447))
|
|
237
|
+
* query params force coercion ([a5e547a](https://github.com/iotaledger/twin-blob-storage/commit/a5e547a775f8997cb04780938c7a9561ddb048d1))
|
|
222
238
|
|
|
223
239
|
|
|
224
240
|
### Dependencies
|
|
@@ -234,7 +250,7 @@
|
|
|
234
250
|
|
|
235
251
|
### Features
|
|
236
252
|
|
|
237
|
-
* release to production ([eacfe75](https://github.com/
|
|
253
|
+
* release to production ([eacfe75](https://github.com/iotaledger/twin-blob-storage/commit/eacfe754a0dcd9243d9e13d86422327d0a605164))
|
|
238
254
|
|
|
239
255
|
|
|
240
256
|
### Dependencies
|
|
@@ -245,12 +261,12 @@
|
|
|
245
261
|
* devDependencies
|
|
246
262
|
* @twin.org/blob-storage-connector-memory bumped from ^0.0.0 to ^0.0.1
|
|
247
263
|
|
|
248
|
-
## [0.0.1-next.37](https://github.com/
|
|
264
|
+
## [0.0.1-next.37](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.1-next.36...blob-storage-service-v0.0.1-next.37) (2025-06-20)
|
|
249
265
|
|
|
250
266
|
|
|
251
267
|
### Bug Fixes
|
|
252
268
|
|
|
253
|
-
* query params force coercion ([a5e547a](https://github.com/
|
|
269
|
+
* query params force coercion ([a5e547a](https://github.com/iotaledger/twin-blob-storage/commit/a5e547a775f8997cb04780938c7a9561ddb048d1))
|
|
254
270
|
|
|
255
271
|
|
|
256
272
|
### Dependencies
|
|
@@ -261,12 +277,12 @@
|
|
|
261
277
|
* devDependencies
|
|
262
278
|
* @twin.org/blob-storage-connector-memory bumped from 0.0.1-next.36 to 0.0.1-next.37
|
|
263
279
|
|
|
264
|
-
## [0.0.1-next.36](https://github.com/
|
|
280
|
+
## [0.0.1-next.36](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.1-next.35...blob-storage-service-v0.0.1-next.36) (2025-06-19)
|
|
265
281
|
|
|
266
282
|
|
|
267
283
|
### Features
|
|
268
284
|
|
|
269
|
-
* add compression support ([67d239b](https://github.com/
|
|
285
|
+
* add compression support ([67d239b](https://github.com/iotaledger/twin-blob-storage/commit/67d239bca8321bd90bf4ff93167c564130309730))
|
|
270
286
|
|
|
271
287
|
|
|
272
288
|
### Dependencies
|
|
@@ -277,12 +293,12 @@
|
|
|
277
293
|
* devDependencies
|
|
278
294
|
* @twin.org/blob-storage-connector-memory bumped from 0.0.1-next.35 to 0.0.1-next.36
|
|
279
295
|
|
|
280
|
-
## [0.0.1-next.35](https://github.com/
|
|
296
|
+
## [0.0.1-next.35](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.1-next.34...blob-storage-service-v0.0.1-next.35) (2025-06-17)
|
|
281
297
|
|
|
282
298
|
|
|
283
299
|
### Features
|
|
284
300
|
|
|
285
|
-
* additional encryption options on per item basis ([4b95a65](https://github.com/
|
|
301
|
+
* additional encryption options on per item basis ([4b95a65](https://github.com/iotaledger/twin-blob-storage/commit/4b95a656d19e3b571cea905e36f29b679b13e1e8))
|
|
286
302
|
|
|
287
303
|
|
|
288
304
|
### Dependencies
|
|
@@ -293,12 +309,12 @@
|
|
|
293
309
|
* devDependencies
|
|
294
310
|
* @twin.org/blob-storage-connector-memory bumped from 0.0.1-next.34 to 0.0.1-next.35
|
|
295
311
|
|
|
296
|
-
## [0.0.1-next.34](https://github.com/
|
|
312
|
+
## [0.0.1-next.34](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.1-next.33...blob-storage-service-v0.0.1-next.34) (2025-06-12)
|
|
297
313
|
|
|
298
314
|
|
|
299
315
|
### Features
|
|
300
316
|
|
|
301
|
-
* update dependencies ([56f0094](https://github.com/
|
|
317
|
+
* update dependencies ([56f0094](https://github.com/iotaledger/twin-blob-storage/commit/56f0094b68d8bd22864cd899ac1b61d95540f719))
|
|
302
318
|
|
|
303
319
|
|
|
304
320
|
### Dependencies
|
|
@@ -309,7 +325,7 @@
|
|
|
309
325
|
* devDependencies
|
|
310
326
|
* @twin.org/blob-storage-connector-memory bumped from 0.0.1-next.33 to 0.0.1-next.34
|
|
311
327
|
|
|
312
|
-
## [0.0.1-next.33](https://github.com/
|
|
328
|
+
## [0.0.1-next.33](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.1-next.32...blob-storage-service-v0.0.1-next.33) (2025-06-03)
|
|
313
329
|
|
|
314
330
|
|
|
315
331
|
### Miscellaneous Chores
|
|
@@ -325,12 +341,12 @@
|
|
|
325
341
|
* devDependencies
|
|
326
342
|
* @twin.org/blob-storage-connector-memory bumped from 0.0.1-next.32 to 0.0.1-next.33
|
|
327
343
|
|
|
328
|
-
## [0.0.1-next.32](https://github.com/
|
|
344
|
+
## [0.0.1-next.32](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.1-next.31...blob-storage-service-v0.0.1-next.32) (2025-05-28)
|
|
329
345
|
|
|
330
346
|
|
|
331
347
|
### Features
|
|
332
348
|
|
|
333
|
-
* update to support fully qualified data type names ([3297d69](https://github.com/
|
|
349
|
+
* update to support fully qualified data type names ([3297d69](https://github.com/iotaledger/twin-blob-storage/commit/3297d69d332058b0f0141002087f56ba230620e1))
|
|
334
350
|
|
|
335
351
|
|
|
336
352
|
### Dependencies
|
|
@@ -341,12 +357,12 @@
|
|
|
341
357
|
* devDependencies
|
|
342
358
|
* @twin.org/blob-storage-connector-memory bumped from 0.0.1-next.31 to 0.0.1-next.32
|
|
343
359
|
|
|
344
|
-
## [0.0.1-next.31](https://github.com/
|
|
360
|
+
## [0.0.1-next.31](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.1-next.30...blob-storage-service-v0.0.1-next.31) (2025-05-08)
|
|
345
361
|
|
|
346
362
|
|
|
347
363
|
### Features
|
|
348
364
|
|
|
349
|
-
* use standard list json ld types ([d6bdfd6](https://github.com/
|
|
365
|
+
* use standard list json ld types ([d6bdfd6](https://github.com/iotaledger/twin-blob-storage/commit/d6bdfd68af47f70f3cc53658b4a12543497e1f48))
|
|
350
366
|
|
|
351
367
|
|
|
352
368
|
### Dependencies
|
|
@@ -357,12 +373,12 @@
|
|
|
357
373
|
* devDependencies
|
|
358
374
|
* @twin.org/blob-storage-connector-memory bumped from 0.0.1-next.30 to 0.0.1-next.31
|
|
359
375
|
|
|
360
|
-
## [0.0.1-next.30](https://github.com/
|
|
376
|
+
## [0.0.1-next.30](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.1-next.29...blob-storage-service-v0.0.1-next.30) (2025-04-17)
|
|
361
377
|
|
|
362
378
|
|
|
363
379
|
### Features
|
|
364
380
|
|
|
365
|
-
* use shared store mechanism ([#12](https://github.com/
|
|
381
|
+
* use shared store mechanism ([#12](https://github.com/iotaledger/twin-blob-storage/issues/12)) ([cae8110](https://github.com/iotaledger/twin-blob-storage/commit/cae8110681847a1ac4fcac968b8196694e49c320))
|
|
366
382
|
|
|
367
383
|
|
|
368
384
|
### Dependencies
|
|
@@ -373,12 +389,12 @@
|
|
|
373
389
|
* devDependencies
|
|
374
390
|
* @twin.org/blob-storage-connector-memory bumped from 0.0.1-next.29 to 0.0.1-next.30
|
|
375
391
|
|
|
376
|
-
## [0.0.1-next.29](https://github.com/
|
|
392
|
+
## [0.0.1-next.29](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-service-v0.0.1-next.28...blob-storage-service-v0.0.1-next.29) (2025-03-28)
|
|
377
393
|
|
|
378
394
|
|
|
379
395
|
### Bug Fixes
|
|
380
396
|
|
|
381
|
-
* Adding the optional flag to the entity ([#10](https://github.com/
|
|
397
|
+
* Adding the optional flag to the entity ([#10](https://github.com/iotaledger/twin-blob-storage/issues/10)) ([626677e](https://github.com/iotaledger/twin-blob-storage/commit/626677e5730d23535a0eb1f36f8394d941ff2447))
|
|
382
398
|
|
|
383
399
|
|
|
384
400
|
### Dependencies
|
package/docs/examples.md
CHANGED
|
@@ -1 +1,109 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Service Examples
|
|
2
|
+
|
|
3
|
+
Use these snippets to create metadata-rich entries, retrieve stored content, and keep catalogue data consistent over time.
|
|
4
|
+
|
|
5
|
+
## BlobStorageService
|
|
6
|
+
|
|
7
|
+
```typescript
|
|
8
|
+
import { BlobStorageService } from '@twin.org/blob-storage-service';
|
|
9
|
+
|
|
10
|
+
const service = new BlobStorageService({
|
|
11
|
+
config: {
|
|
12
|
+
defaultNamespace: 'memory',
|
|
13
|
+
vaultKeyId: 'tenant-main'
|
|
14
|
+
}
|
|
15
|
+
});
|
|
16
|
+
|
|
17
|
+
console.log(service.className()); // BlobStorageService
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
```typescript
|
|
21
|
+
import { BlobStorageService } from '@twin.org/blob-storage-service';
|
|
22
|
+
|
|
23
|
+
const service = new BlobStorageService({
|
|
24
|
+
config: {
|
|
25
|
+
defaultNamespace: 'memory'
|
|
26
|
+
}
|
|
27
|
+
});
|
|
28
|
+
|
|
29
|
+
const blobId = await service.create(
|
|
30
|
+
'SGVsbG8gVFdJTiE=',
|
|
31
|
+
'text/plain',
|
|
32
|
+
'txt',
|
|
33
|
+
{
|
|
34
|
+
'@context': 'https://schema.org',
|
|
35
|
+
type: 'DigitalDocument',
|
|
36
|
+
name: 'welcome-note'
|
|
37
|
+
},
|
|
38
|
+
{
|
|
39
|
+
disableEncryption: true,
|
|
40
|
+
namespace: 'memory'
|
|
41
|
+
}
|
|
42
|
+
);
|
|
43
|
+
console.log(blobId); // blob:urn:blob:memory:...
|
|
44
|
+
|
|
45
|
+
const blobEntry = await service.get(blobId, { includeContent: true, decompress: true });
|
|
46
|
+
console.log(blobEntry.blobSize); // 11
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
```typescript
|
|
50
|
+
import { BlobStorageService } from '@twin.org/blob-storage-service';
|
|
51
|
+
|
|
52
|
+
const service = new BlobStorageService({
|
|
53
|
+
config: {
|
|
54
|
+
defaultNamespace: 'memory'
|
|
55
|
+
}
|
|
56
|
+
});
|
|
57
|
+
|
|
58
|
+
const blobId = 'blob:urn:blob:memory:7f83b1657ff1fc53';
|
|
59
|
+
await service.update(blobId, 'text/markdown', 'md', {
|
|
60
|
+
'@context': 'https://schema.org',
|
|
61
|
+
type: 'DigitalDocument',
|
|
62
|
+
name: 'release-notes'
|
|
63
|
+
});
|
|
64
|
+
console.log(blobId); // blob:urn:blob:memory:7f83b1657ff1fc53
|
|
65
|
+
|
|
66
|
+
const result = await service.query(
|
|
67
|
+
{
|
|
68
|
+
logicalOperator: 'and',
|
|
69
|
+
conditions: [
|
|
70
|
+
{
|
|
71
|
+
property: 'encodingFormat',
|
|
72
|
+
comparison: 'equals',
|
|
73
|
+
value: 'text/markdown'
|
|
74
|
+
}
|
|
75
|
+
]
|
|
76
|
+
},
|
|
77
|
+
'dateCreated',
|
|
78
|
+
'descending',
|
|
79
|
+
'eyJwYWdlIjoyfQ==',
|
|
80
|
+
10
|
|
81
|
+
);
|
|
82
|
+
console.log(result.entries.itemListElement.length); // 1
|
|
83
|
+
|
|
84
|
+
await service.remove(blobId);
|
|
85
|
+
console.log(blobId); // blob:urn:blob:memory:7f83b1657ff1fc53
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
## BlobStorageEntry
|
|
89
|
+
|
|
90
|
+
```typescript
|
|
91
|
+
import type { BlobStorageEntry } from '@twin.org/blob-storage-service';
|
|
92
|
+
|
|
93
|
+
const entry: BlobStorageEntry = {
|
|
94
|
+
id: 'blob:urn:blob:memory:7f83b1657ff1fc53',
|
|
95
|
+
dateCreated: '2026-03-09T12:00:00.000Z',
|
|
96
|
+
blobSize: 2048,
|
|
97
|
+
integrity: 'sha256:ab45f3f0c2b13496',
|
|
98
|
+
encodingFormat: 'application/pdf',
|
|
99
|
+
fileExtension: 'pdf',
|
|
100
|
+
metadata: {
|
|
101
|
+
'@context': 'https://schema.org',
|
|
102
|
+
type: 'DigitalDocument',
|
|
103
|
+
name: 'invoice-2026-03'
|
|
104
|
+
},
|
|
105
|
+
isEncrypted: false
|
|
106
|
+
};
|
|
107
|
+
|
|
108
|
+
console.log(entry.encodingFormat); // application/pdf
|
|
109
|
+
```
|
package/docs/open-api/spec.json
CHANGED
|
@@ -149,7 +149,6 @@
|
|
|
149
149
|
"in": "query",
|
|
150
150
|
"required": false,
|
|
151
151
|
"schema": {
|
|
152
|
-
"type": "string",
|
|
153
152
|
"enum": [
|
|
154
153
|
"dateCreated",
|
|
155
154
|
"dateModified"
|
|
@@ -915,19 +914,17 @@
|
|
|
915
914
|
"components": {
|
|
916
915
|
"schemas": {
|
|
917
916
|
"BlobStorageCompressionType": {
|
|
917
|
+
"description": "The types of compression for blob storage data.",
|
|
918
918
|
"anyOf": [
|
|
919
919
|
{
|
|
920
|
-
"type": "string",
|
|
921
920
|
"const": "gzip",
|
|
922
921
|
"description": "Gzip."
|
|
923
922
|
},
|
|
924
923
|
{
|
|
925
|
-
"type": "string",
|
|
926
924
|
"const": "deflate",
|
|
927
925
|
"description": "Deflate."
|
|
928
926
|
}
|
|
929
|
-
]
|
|
930
|
-
"description": "The types of compression for blob storage data."
|
|
927
|
+
]
|
|
931
928
|
},
|
|
932
929
|
"BlobStorageCreateRequest": {
|
|
933
930
|
"type": "object",
|
|
@@ -971,28 +968,26 @@
|
|
|
971
968
|
"description": "The body parameters."
|
|
972
969
|
},
|
|
973
970
|
"BlobStorageEntry": {
|
|
971
|
+
"description": "Interface describing a blob storage entry.",
|
|
974
972
|
"type": "object",
|
|
975
973
|
"properties": {
|
|
976
974
|
"@context": {
|
|
977
975
|
"type": "array",
|
|
978
|
-
"minItems": 2,
|
|
979
|
-
"description": "JSON-LD Context.",
|
|
980
976
|
"prefixItems": [
|
|
981
977
|
{
|
|
982
|
-
"type": "string",
|
|
983
978
|
"const": "https://schema.twindev.org/blob-storage/"
|
|
984
979
|
},
|
|
985
980
|
{
|
|
986
|
-
"type": "string",
|
|
987
981
|
"const": "https://schema.twindev.org/common/"
|
|
988
982
|
}
|
|
989
983
|
],
|
|
990
984
|
"items": {
|
|
991
985
|
"$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionElement"
|
|
992
|
-
}
|
|
986
|
+
},
|
|
987
|
+
"minItems": 2,
|
|
988
|
+
"description": "JSON-LD Context."
|
|
993
989
|
},
|
|
994
990
|
"type": {
|
|
995
|
-
"type": "string",
|
|
996
991
|
"const": "BlobStorageEntry",
|
|
997
992
|
"description": "JSON-LD Type."
|
|
998
993
|
},
|
|
@@ -1002,41 +997,41 @@
|
|
|
1002
997
|
},
|
|
1003
998
|
"dateCreated": {
|
|
1004
999
|
"type": "string",
|
|
1005
|
-
"description": "The date/time when the entry was created.
|
|
1000
|
+
"description": "The date/time when the entry was created."
|
|
1006
1001
|
},
|
|
1007
1002
|
"dateModified": {
|
|
1008
1003
|
"type": "string",
|
|
1009
|
-
"description": "The date/time when the entry was modified.
|
|
1004
|
+
"description": "The date/time when the entry was modified."
|
|
1010
1005
|
},
|
|
1011
1006
|
"blobSize": {
|
|
1012
1007
|
"type": "number",
|
|
1013
|
-
"description": "The size of the data in the blob.
|
|
1008
|
+
"description": "The size of the data in the blob."
|
|
1014
1009
|
},
|
|
1015
1010
|
"integrity": {
|
|
1016
1011
|
"type": "string",
|
|
1017
|
-
"description": "The integrity of the data in the blob.
|
|
1012
|
+
"description": "The integrity of the data in the blob."
|
|
1018
1013
|
},
|
|
1019
1014
|
"encodingFormat": {
|
|
1020
1015
|
"type": "string",
|
|
1021
|
-
"description": "The mime type for the blob.
|
|
1016
|
+
"description": "The mime type for the blob."
|
|
1022
1017
|
},
|
|
1023
1018
|
"isEncrypted": {
|
|
1024
1019
|
"type": "boolean",
|
|
1025
|
-
"description": "Indicates if the blob is encrypted.
|
|
1020
|
+
"description": "Indicates if the blob is encrypted."
|
|
1026
1021
|
},
|
|
1027
1022
|
"compression": {
|
|
1028
1023
|
"$ref": "#/components/schemas/BlobStorageCompressionType"
|
|
1029
1024
|
},
|
|
1030
1025
|
"fileExtension": {
|
|
1031
1026
|
"type": "string",
|
|
1032
|
-
"description": "The extension.
|
|
1027
|
+
"description": "The extension."
|
|
1033
1028
|
},
|
|
1034
1029
|
"metadata": {
|
|
1035
1030
|
"$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject"
|
|
1036
1031
|
},
|
|
1037
1032
|
"blob": {
|
|
1038
1033
|
"type": "string",
|
|
1039
|
-
"description": "The blob in base64 format, included if the includeContent flag was set in the request.
|
|
1034
|
+
"description": "The blob in base64 format, included if the includeContent flag was set in the request."
|
|
1040
1035
|
}
|
|
1041
1036
|
},
|
|
1042
1037
|
"required": [
|
|
@@ -1046,36 +1041,32 @@
|
|
|
1046
1041
|
"dateCreated",
|
|
1047
1042
|
"blobSize",
|
|
1048
1043
|
"integrity"
|
|
1049
|
-
]
|
|
1050
|
-
"description": "Interface describing a blob storage entry."
|
|
1044
|
+
]
|
|
1051
1045
|
},
|
|
1052
1046
|
"BlobStorageEntryList": {
|
|
1047
|
+
"description": "Interface describing an blob storage entry list.",
|
|
1053
1048
|
"type": "object",
|
|
1054
1049
|
"properties": {
|
|
1055
1050
|
"@context": {
|
|
1056
1051
|
"type": "array",
|
|
1057
|
-
"minItems": 3,
|
|
1058
|
-
"description": "JSON-LD Context.",
|
|
1059
1052
|
"prefixItems": [
|
|
1060
1053
|
{
|
|
1061
|
-
"type": "string",
|
|
1062
1054
|
"const": "https://schema.org"
|
|
1063
1055
|
},
|
|
1064
1056
|
{
|
|
1065
|
-
"type": "string",
|
|
1066
1057
|
"const": "https://schema.twindev.org/blob-storage/"
|
|
1067
1058
|
},
|
|
1068
1059
|
{
|
|
1069
|
-
"type": "string",
|
|
1070
1060
|
"const": "https://schema.twindev.org/common/"
|
|
1071
1061
|
}
|
|
1072
1062
|
],
|
|
1073
1063
|
"items": {
|
|
1074
1064
|
"$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionElement"
|
|
1075
|
-
}
|
|
1065
|
+
},
|
|
1066
|
+
"minItems": 3,
|
|
1067
|
+
"description": "JSON-LD Context."
|
|
1076
1068
|
},
|
|
1077
1069
|
"type": {
|
|
1078
|
-
"type": "string",
|
|
1079
1070
|
"const": "ItemList",
|
|
1080
1071
|
"description": "JSON-LD Type."
|
|
1081
1072
|
},
|
|
@@ -1091,8 +1082,7 @@
|
|
|
1091
1082
|
"@context",
|
|
1092
1083
|
"type",
|
|
1093
1084
|
"itemListElement"
|
|
1094
|
-
]
|
|
1095
|
-
"description": "Interface describing an blob storage entry list."
|
|
1085
|
+
]
|
|
1096
1086
|
},
|
|
1097
1087
|
"BlobStorageUpdateRequest": {
|
|
1098
1088
|
"type": "object",
|
|
@@ -1112,6 +1102,7 @@
|
|
|
1112
1102
|
"description": "The body parameters."
|
|
1113
1103
|
},
|
|
1114
1104
|
"Error": {
|
|
1105
|
+
"description": "Model to describe serialized error.",
|
|
1115
1106
|
"type": "object",
|
|
1116
1107
|
"properties": {
|
|
1117
1108
|
"name": {
|
|
@@ -1120,7 +1111,7 @@
|
|
|
1120
1111
|
},
|
|
1121
1112
|
"message": {
|
|
1122
1113
|
"type": "string",
|
|
1123
|
-
"description": "The message for the error."
|
|
1114
|
+
"description": "The message for the error as an i18n key."
|
|
1124
1115
|
},
|
|
1125
1116
|
"source": {
|
|
1126
1117
|
"type": "string",
|
|
@@ -1142,8 +1133,7 @@
|
|
|
1142
1133
|
"required": [
|
|
1143
1134
|
"name",
|
|
1144
1135
|
"message"
|
|
1145
|
-
]
|
|
1146
|
-
"description": "Model to describe serialized error."
|
|
1136
|
+
]
|
|
1147
1137
|
},
|
|
1148
1138
|
"NotFoundResponse": {
|
|
1149
1139
|
"type": "object",
|
|
@@ -1151,52 +1141,27 @@
|
|
|
1151
1141
|
"notFoundId": {
|
|
1152
1142
|
"type": "string",
|
|
1153
1143
|
"description": "The id if the item that was not found."
|
|
1154
|
-
},
|
|
1155
|
-
"name": {
|
|
1156
|
-
"type": "string",
|
|
1157
|
-
"description": "The name for the error."
|
|
1158
|
-
},
|
|
1159
|
-
"message": {
|
|
1160
|
-
"type": "string",
|
|
1161
|
-
"description": "The message for the error."
|
|
1162
|
-
},
|
|
1163
|
-
"source": {
|
|
1164
|
-
"type": "string",
|
|
1165
|
-
"description": "The source of the error."
|
|
1166
|
-
},
|
|
1167
|
-
"properties": {
|
|
1168
|
-
"type": "object",
|
|
1169
|
-
"additionalProperties": {},
|
|
1170
|
-
"description": "Any additional information for the error."
|
|
1171
|
-
},
|
|
1172
|
-
"stack": {
|
|
1173
|
-
"type": "string",
|
|
1174
|
-
"description": "The stack trace for the error."
|
|
1175
|
-
},
|
|
1176
|
-
"cause": {
|
|
1177
|
-
"$ref": "#/components/schemas/Error"
|
|
1178
1144
|
}
|
|
1179
1145
|
},
|
|
1180
|
-
"
|
|
1181
|
-
|
|
1182
|
-
|
|
1146
|
+
"allOf": [
|
|
1147
|
+
{
|
|
1148
|
+
"$ref": "#/components/schemas/Error"
|
|
1149
|
+
}
|
|
1183
1150
|
],
|
|
1184
1151
|
"description": "The body which contains the error."
|
|
1185
1152
|
},
|
|
1186
1153
|
"SortDirection": {
|
|
1154
|
+
"description": "The sort directions.",
|
|
1187
1155
|
"anyOf": [
|
|
1188
1156
|
{
|
|
1189
|
-
"type": "string",
|
|
1190
1157
|
"const": "asc",
|
|
1191
1158
|
"description": "Ascending."
|
|
1192
1159
|
},
|
|
1193
1160
|
{
|
|
1194
|
-
"type": "string",
|
|
1195
1161
|
"const": "desc",
|
|
1196
1162
|
"description": "Descending."
|
|
1197
1163
|
}
|
|
1198
|
-
]
|
|
1199
|
-
"description": "The sort directions."
|
|
1164
|
+
]
|
|
1200
1165
|
}
|
|
1201
1166
|
},
|
|
1202
1167
|
"securitySchemes": {
|
|
@@ -14,7 +14,7 @@ Class representing entry for the blob storage.
|
|
|
14
14
|
|
|
15
15
|
## Properties
|
|
16
16
|
|
|
17
|
-
### id
|
|
17
|
+
### id {#id}
|
|
18
18
|
|
|
19
19
|
> **id**: `string`
|
|
20
20
|
|
|
@@ -22,7 +22,7 @@ The id for the blob.
|
|
|
22
22
|
|
|
23
23
|
***
|
|
24
24
|
|
|
25
|
-
### dateCreated
|
|
25
|
+
### dateCreated {#datecreated}
|
|
26
26
|
|
|
27
27
|
> **dateCreated**: `string`
|
|
28
28
|
|
|
@@ -30,15 +30,15 @@ The date/time when the entry was created.
|
|
|
30
30
|
|
|
31
31
|
***
|
|
32
32
|
|
|
33
|
-
### dateModified?
|
|
33
|
+
### dateModified? {#datemodified}
|
|
34
34
|
|
|
35
|
-
> `optional` **dateModified
|
|
35
|
+
> `optional` **dateModified?**: `string`
|
|
36
36
|
|
|
37
37
|
The date/time when the entry was modified.
|
|
38
38
|
|
|
39
39
|
***
|
|
40
40
|
|
|
41
|
-
### blobSize
|
|
41
|
+
### blobSize {#blobsize}
|
|
42
42
|
|
|
43
43
|
> **blobSize**: `number`
|
|
44
44
|
|
|
@@ -46,7 +46,7 @@ The length of the data in the blob.
|
|
|
46
46
|
|
|
47
47
|
***
|
|
48
48
|
|
|
49
|
-
### integrity
|
|
49
|
+
### integrity {#integrity}
|
|
50
50
|
|
|
51
51
|
> **integrity**: `string`
|
|
52
52
|
|
|
@@ -54,31 +54,31 @@ The integrity of the data in the blob.
|
|
|
54
54
|
|
|
55
55
|
***
|
|
56
56
|
|
|
57
|
-
### encodingFormat?
|
|
57
|
+
### encodingFormat? {#encodingformat}
|
|
58
58
|
|
|
59
|
-
> `optional` **encodingFormat
|
|
59
|
+
> `optional` **encodingFormat?**: `string`
|
|
60
60
|
|
|
61
61
|
The mime type for the blob.
|
|
62
62
|
|
|
63
63
|
***
|
|
64
64
|
|
|
65
|
-
### fileExtension?
|
|
65
|
+
### fileExtension? {#fileextension}
|
|
66
66
|
|
|
67
|
-
> `optional` **fileExtension
|
|
67
|
+
> `optional` **fileExtension?**: `string`
|
|
68
68
|
|
|
69
69
|
The extension.
|
|
70
70
|
|
|
71
71
|
***
|
|
72
72
|
|
|
73
|
-
### metadata?
|
|
73
|
+
### metadata? {#metadata}
|
|
74
74
|
|
|
75
|
-
> `optional` **metadata
|
|
75
|
+
> `optional` **metadata?**: `IJsonLdNodeObject`
|
|
76
76
|
|
|
77
77
|
The metadata for the blob as JSON-LD.
|
|
78
78
|
|
|
79
79
|
***
|
|
80
80
|
|
|
81
|
-
### isEncrypted
|
|
81
|
+
### isEncrypted {#isencrypted}
|
|
82
82
|
|
|
83
83
|
> **isEncrypted**: `boolean`
|
|
84
84
|
|
|
@@ -86,8 +86,8 @@ Is the entry encrypted.
|
|
|
86
86
|
|
|
87
87
|
***
|
|
88
88
|
|
|
89
|
-
### compression?
|
|
89
|
+
### compression? {#compression}
|
|
90
90
|
|
|
91
|
-
> `optional` **compression
|
|
91
|
+
> `optional` **compression?**: `BlobStorageCompressionType`
|
|
92
92
|
|
|
93
93
|
Is the entry compressed.
|
|
@@ -28,7 +28,7 @@ The options for the service.
|
|
|
28
28
|
|
|
29
29
|
## Properties
|
|
30
30
|
|
|
31
|
-
### CLASS\_NAME
|
|
31
|
+
### CLASS\_NAME {#class_name}
|
|
32
32
|
|
|
33
33
|
> `readonly` `static` **CLASS\_NAME**: `string`
|
|
34
34
|
|
|
@@ -36,7 +36,7 @@ Runtime name for the class.
|
|
|
36
36
|
|
|
37
37
|
## Methods
|
|
38
38
|
|
|
39
|
-
### className()
|
|
39
|
+
### className() {#classname}
|
|
40
40
|
|
|
41
41
|
> **className**(): `string`
|
|
42
42
|
|
|
@@ -54,7 +54,7 @@ The class name of the component.
|
|
|
54
54
|
|
|
55
55
|
***
|
|
56
56
|
|
|
57
|
-
### create()
|
|
57
|
+
### create() {#create}
|
|
58
58
|
|
|
59
59
|
> **create**(`blob`, `encodingFormat?`, `fileExtension?`, `metadata?`, `options?`): `Promise`\<`string`\>
|
|
60
60
|
|
|
@@ -126,7 +126,7 @@ The id of the stored blob in urn format.
|
|
|
126
126
|
|
|
127
127
|
***
|
|
128
128
|
|
|
129
|
-
### get()
|
|
129
|
+
### get() {#get}
|
|
130
130
|
|
|
131
131
|
> **get**(`id`, `options?`): `Promise`\<`IBlobStorageEntry`\>
|
|
132
132
|
|
|
@@ -178,7 +178,7 @@ Not found error if the blob cannot be found.
|
|
|
178
178
|
|
|
179
179
|
***
|
|
180
180
|
|
|
181
|
-
### update()
|
|
181
|
+
### update() {#update}
|
|
182
182
|
|
|
183
183
|
> **update**(`id`, `encodingFormat?`, `fileExtension?`, `metadata?`): `Promise`\<`void`\>
|
|
184
184
|
|
|
@@ -226,7 +226,7 @@ Not found error if the blob cannot be found.
|
|
|
226
226
|
|
|
227
227
|
***
|
|
228
228
|
|
|
229
|
-
### remove()
|
|
229
|
+
### remove() {#remove}
|
|
230
230
|
|
|
231
231
|
> **remove**(`id`): `Promise`\<`void`\>
|
|
232
232
|
|
|
@@ -252,7 +252,7 @@ Nothing.
|
|
|
252
252
|
|
|
253
253
|
***
|
|
254
254
|
|
|
255
|
-
### query()
|
|
255
|
+
### query() {#query}
|
|
256
256
|
|
|
257
257
|
> **query**(`conditions?`, `orderBy?`, `orderByDirection?`, `cursor?`, `limit?`): `Promise`\<\{ `entries`: `IBlobStorageEntryList`; `cursor?`: `string`; \}\>
|
|
258
258
|
|
|
@@ -268,9 +268,9 @@ The conditions to match for the entries.
|
|
|
268
268
|
|
|
269
269
|
##### orderBy?
|
|
270
270
|
|
|
271
|
-
|
|
271
|
+
`"dateCreated"` \| `"dateModified"`
|
|
272
272
|
|
|
273
|
-
|
|
273
|
+
The order for the results, defaults to created.
|
|
274
274
|
|
|
275
275
|
##### orderByDirection?
|
|
276
276
|
|
|
@@ -4,17 +4,17 @@ Configuration for the blob storage service.
|
|
|
4
4
|
|
|
5
5
|
## Properties
|
|
6
6
|
|
|
7
|
-
### vaultKeyId?
|
|
7
|
+
### vaultKeyId? {#vaultkeyid}
|
|
8
8
|
|
|
9
|
-
> `optional` **vaultKeyId
|
|
9
|
+
> `optional` **vaultKeyId?**: `string`
|
|
10
10
|
|
|
11
11
|
The name of the vault key to use for encryption, if not configured no encryption will happen.
|
|
12
12
|
|
|
13
13
|
***
|
|
14
14
|
|
|
15
|
-
### defaultNamespace?
|
|
15
|
+
### defaultNamespace? {#defaultnamespace}
|
|
16
16
|
|
|
17
|
-
> `optional` **defaultNamespace
|
|
17
|
+
> `optional` **defaultNamespace?**: `string`
|
|
18
18
|
|
|
19
19
|
The namespace of the default storage connector to use.
|
|
20
20
|
Defaults to the first entry in the factory if not provided.
|
|
@@ -4,9 +4,9 @@ Options for the Blob Storage Service constructor.
|
|
|
4
4
|
|
|
5
5
|
## Properties
|
|
6
6
|
|
|
7
|
-
### entryEntityStorageType?
|
|
7
|
+
### entryEntityStorageType? {#entryentitystoragetype}
|
|
8
8
|
|
|
9
|
-
> `optional` **entryEntityStorageType
|
|
9
|
+
> `optional` **entryEntityStorageType?**: `string`
|
|
10
10
|
|
|
11
11
|
The type of the storage connector for the metadata.
|
|
12
12
|
|
|
@@ -18,16 +18,16 @@ blob-storage-entry
|
|
|
18
18
|
|
|
19
19
|
***
|
|
20
20
|
|
|
21
|
-
### vaultConnectorType?
|
|
21
|
+
### vaultConnectorType? {#vaultconnectortype}
|
|
22
22
|
|
|
23
|
-
> `optional` **vaultConnectorType
|
|
23
|
+
> `optional` **vaultConnectorType?**: `string`
|
|
24
24
|
|
|
25
25
|
The type of the vault connector for encryption.
|
|
26
26
|
|
|
27
27
|
***
|
|
28
28
|
|
|
29
|
-
### config?
|
|
29
|
+
### config? {#config}
|
|
30
30
|
|
|
31
|
-
> `optional` **config
|
|
31
|
+
> `optional` **config?**: [`IBlobStorageServiceConfig`](IBlobStorageServiceConfig.md)
|
|
32
32
|
|
|
33
33
|
The configuration for the service.
|
package/package.json
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@twin.org/blob-storage-service",
|
|
3
|
-
"version": "0.0.3-next.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.0.3-next.8",
|
|
4
|
+
"description": "Exposes blob operations through service components and HTTP route definitions.",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
7
|
-
"url": "git+https://github.com/
|
|
7
|
+
"url": "git+https://github.com/iotaledger/blob-storage.git",
|
|
8
8
|
"directory": "packages/blob-storage-service"
|
|
9
9
|
},
|
|
10
10
|
"author": "martyn.janes@iota.org",
|
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
},
|
|
16
16
|
"dependencies": {
|
|
17
17
|
"@twin.org/api-models": "next",
|
|
18
|
-
"@twin.org/blob-storage-models": "0.0.3-next.
|
|
18
|
+
"@twin.org/blob-storage-models": "0.0.3-next.8",
|
|
19
19
|
"@twin.org/context": "next",
|
|
20
20
|
"@twin.org/core": "next",
|
|
21
21
|
"@twin.org/crypto": "next",
|
|
@@ -59,7 +59,7 @@
|
|
|
59
59
|
"business-logic"
|
|
60
60
|
],
|
|
61
61
|
"bugs": {
|
|
62
|
-
"url": "git+https://github.com/
|
|
62
|
+
"url": "git+https://github.com/iotaledger/blob-storage/issues"
|
|
63
63
|
},
|
|
64
64
|
"homepage": "https://twindev.org"
|
|
65
65
|
}
|