@twin.org/blob-storage-models 0.0.3-next.7 → 0.0.3-next.9

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 (25) hide show
  1. package/README.md +1 -1
  2. package/dist/es/models/IBlobStorageEntry.js.map +1 -1
  3. package/dist/es/schemas/BlobStorageCompressionType.json +10 -4
  4. package/dist/es/schemas/BlobStorageEntry.json +14 -16
  5. package/dist/types/models/IBlobStorageEntry.d.ts +10 -10
  6. package/docs/changelog.md +105 -66
  7. package/docs/examples.md +23 -1
  8. package/docs/reference/classes/BlobStorageDataTypes.md +1 -1
  9. package/docs/reference/interfaces/IBlobStorageComponent.md +7 -7
  10. package/docs/reference/interfaces/IBlobStorageConnector.md +3 -3
  11. package/docs/reference/interfaces/IBlobStorageCreateRequest.md +8 -8
  12. package/docs/reference/interfaces/IBlobStorageEntry.md +20 -30
  13. package/docs/reference/interfaces/IBlobStorageEntryList.md +3 -3
  14. package/docs/reference/interfaces/IBlobStorageGetContentRequest.md +7 -7
  15. package/docs/reference/interfaces/IBlobStorageGetContentResponse.md +1 -1
  16. package/docs/reference/interfaces/IBlobStorageGetRequest.md +8 -8
  17. package/docs/reference/interfaces/IBlobStorageGetResponse.md +3 -3
  18. package/docs/reference/interfaces/IBlobStorageListRequest.md +9 -9
  19. package/docs/reference/interfaces/IBlobStorageListResponse.md +4 -4
  20. package/docs/reference/interfaces/IBlobStorageRemoveRequest.md +1 -1
  21. package/docs/reference/interfaces/IBlobStorageUpdateRequest.md +5 -5
  22. package/docs/reference/variables/BlobStorageCompressionType.md +2 -2
  23. package/docs/reference/variables/BlobStorageContexts.md +6 -6
  24. package/docs/reference/variables/BlobStorageTypes.md +2 -2
  25. package/package.json +4 -4
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # TWIN Blob Storage Models
2
2
 
3
- Models which define the structure of the blob storage contracts and connectors.
3
+ This package defines shared models, contracts, and schemas for blob identifiers, metadata, and storage operations. It provides the common language used by service, client, and connector packages so integrations remain consistent across environments.
4
4
 
5
5
  ## Installation
6
6
 
@@ -1 +1 @@
1
- {"version":3,"file":"IBlobStorageEntry.js","sourceRoot":"","sources":["../../../src/models/IBlobStorageEntry.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IJsonLdContextDefinitionElement, IJsonLdNodeObject } from \"@twin.org/data-json-ld\";\nimport type { BlobStorageCompressionType } from \"./blobStorageCompressionType.js\";\nimport type { BlobStorageContexts } from \"./blobStorageContexts.js\";\nimport type { BlobStorageTypes } from \"./blobStorageTypes.js\";\n\n/**\n * Interface describing a blob storage entry.\n */\nexport interface IBlobStorageEntry {\n\t/**\n\t * JSON-LD Context.\n\t */\n\t\"@context\": [\n\t\ttypeof BlobStorageContexts.Context,\n\t\ttypeof BlobStorageContexts.ContextCommon,\n\t\t...IJsonLdContextDefinitionElement[]\n\t];\n\n\t/**\n\t * JSON-LD Type.\n\t */\n\ttype: typeof BlobStorageTypes.Entry;\n\n\t/**\n\t * The id for the blob.\n\t */\n\tid: string;\n\n\t/**\n\t * The date/time when the entry was created.\n\t * json-ld namespace:schema\n\t */\n\tdateCreated: string;\n\n\t/**\n\t * The date/time when the entry was modified.\n\t * json-ld namespace:schema\n\t */\n\tdateModified?: string;\n\n\t/**\n\t * The size of the data in the blob.\n\t * json-ld type:schema:Integer\n\t */\n\tblobSize: number;\n\n\t/**\n\t * The integrity of the data in the blob.\n\t * json-ld namespace:twin-common\n\t */\n\tintegrity: string;\n\n\t/**\n\t * The mime type for the blob.\n\t * json-ld namespace:schema\n\t */\n\tencodingFormat?: string;\n\n\t/**\n\t * Indicates if the blob is encrypted.\n\t * json-ld type:schema:Boolean\n\t */\n\tisEncrypted?: boolean;\n\n\t/**\n\t * The type of compression used for the blob, if not set it is not stored with compression.\n\t * json-ld type:schema:Text\n\t */\n\tcompression?: BlobStorageCompressionType;\n\n\t/**\n\t * The extension.\n\t * json-ld type:schema:Text\n\t */\n\tfileExtension?: string;\n\n\t/**\n\t * The metadata for the blob as JSON-LD.\n\t * json-ld id\n\t */\n\tmetadata?: IJsonLdNodeObject;\n\n\t/**\n\t * The blob in base64 format, included if the includeContent flag was set in the request.\n\t * json-ld type:schema:Text\n\t */\n\tblob?: string;\n}\n"]}
1
+ {"version":3,"file":"IBlobStorageEntry.js","sourceRoot":"","sources":["../../../src/models/IBlobStorageEntry.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IJsonLdContextDefinitionElement, IJsonLdNodeObject } from \"@twin.org/data-json-ld\";\nimport type { BlobStorageCompressionType } from \"./blobStorageCompressionType.js\";\nimport type { BlobStorageContexts } from \"./blobStorageContexts.js\";\nimport type { BlobStorageTypes } from \"./blobStorageTypes.js\";\n\n/**\n * Interface describing a blob storage entry.\n */\nexport interface IBlobStorageEntry {\n\t/**\n\t * JSON-LD Context.\n\t */\n\t\"@context\": [\n\t\ttypeof BlobStorageContexts.Context,\n\t\ttypeof BlobStorageContexts.ContextCommon,\n\t\t...IJsonLdContextDefinitionElement[]\n\t];\n\n\t/**\n\t * JSON-LD Type.\n\t */\n\ttype: typeof BlobStorageTypes.Entry;\n\n\t/**\n\t * The id for the blob.\n\t */\n\tid: string;\n\n\t/**\n\t * The date/time when the entry was created.\n\t * @json-ld namespace:schema\n\t */\n\tdateCreated: string;\n\n\t/**\n\t * The date/time when the entry was modified.\n\t * @json-ld namespace:schema\n\t */\n\tdateModified?: string;\n\n\t/**\n\t * The size of the data in the blob.\n\t * @json-ld type:schema:Integer\n\t */\n\tblobSize: number;\n\n\t/**\n\t * The integrity of the data in the blob.\n\t * @json-ld namespace:twin-common\n\t */\n\tintegrity: string;\n\n\t/**\n\t * The mime type for the blob.\n\t * @json-ld namespace:schema\n\t */\n\tencodingFormat?: string;\n\n\t/**\n\t * Indicates if the blob is encrypted.\n\t * @json-ld type:schema:Boolean\n\t */\n\tisEncrypted?: boolean;\n\n\t/**\n\t * The type of compression used for the blob, if not set it is not stored with compression.\n\t * @json-ld type:schema:Text\n\t */\n\tcompression?: BlobStorageCompressionType;\n\n\t/**\n\t * The extension.\n\t * @json-ld type:schema:Text\n\t */\n\tfileExtension?: string;\n\n\t/**\n\t * The metadata for the blob as JSON-LD.\n\t * @json-ld id\n\t */\n\tmetadata?: IJsonLdNodeObject;\n\n\t/**\n\t * The blob in base64 format, included if the includeContent flag was set in the request.\n\t * @json-ld type:schema:Text\n\t */\n\tblob?: string;\n}\n"]}
@@ -1,10 +1,16 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
3
  "$id": "https://schema.twindev.org/blob-storage/BlobStorageCompressionType",
4
+ "title": "BlobStorageCompressionType",
4
5
  "description": "The types of compression for blob storage data.",
5
- "type": "string",
6
- "enum": [
7
- "gzip",
8
- "deflate"
6
+ "oneOf": [
7
+ {
8
+ "const": "gzip",
9
+ "description": "Gzip."
10
+ },
11
+ {
12
+ "const": "deflate",
13
+ "description": "Deflate."
14
+ }
9
15
  ]
10
16
  }
@@ -1,29 +1,27 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
3
  "$id": "https://schema.twindev.org/blob-storage/BlobStorageEntry",
4
+ "title": "BlobStorageEntry",
4
5
  "description": "Interface describing a blob storage entry.",
5
6
  "type": "object",
6
7
  "properties": {
7
8
  "@context": {
8
9
  "type": "array",
9
- "minItems": 2,
10
- "description": "JSON-LD Context.",
11
10
  "prefixItems": [
12
11
  {
13
- "type": "string",
14
12
  "const": "https://schema.twindev.org/blob-storage/"
15
13
  },
16
14
  {
17
- "type": "string",
18
15
  "const": "https://schema.twindev.org/common/"
19
16
  }
20
17
  ],
21
18
  "items": {
22
19
  "$ref": "https://schema.twindev.org/json-ld/JsonLdContextDefinitionElement"
23
- }
20
+ },
21
+ "minItems": 2,
22
+ "description": "JSON-LD Context."
24
23
  },
25
24
  "type": {
26
- "type": "string",
27
25
  "const": "BlobStorageEntry",
28
26
  "description": "JSON-LD Type."
29
27
  },
@@ -33,43 +31,43 @@
33
31
  },
34
32
  "dateCreated": {
35
33
  "type": "string",
36
- "description": "The date/time when the entry was created. json-ld namespace:schema"
34
+ "description": "The date/time when the entry was created."
37
35
  },
38
36
  "dateModified": {
39
37
  "type": "string",
40
- "description": "The date/time when the entry was modified. json-ld namespace:schema"
38
+ "description": "The date/time when the entry was modified."
41
39
  },
42
40
  "blobSize": {
43
41
  "type": "number",
44
- "description": "The size of the data in the blob. json-ld type:schema:Integer"
42
+ "description": "The size of the data in the blob."
45
43
  },
46
44
  "integrity": {
47
45
  "type": "string",
48
- "description": "The integrity of the data in the blob. json-ld namespace:twin-common"
46
+ "description": "The integrity of the data in the blob."
49
47
  },
50
48
  "encodingFormat": {
51
49
  "type": "string",
52
- "description": "The mime type for the blob. json-ld namespace:schema"
50
+ "description": "The mime type for the blob."
53
51
  },
54
52
  "isEncrypted": {
55
53
  "type": "boolean",
56
- "description": "Indicates if the blob is encrypted. json-ld type:schema:Boolean"
54
+ "description": "Indicates if the blob is encrypted."
57
55
  },
58
56
  "compression": {
59
57
  "$ref": "https://schema.twindev.org/blob-storage/BlobStorageCompressionType",
60
- "description": "The type of compression used for the blob, if not set it is not stored with compression. json-ld type:schema:Text"
58
+ "description": "The type of compression used for the blob, if not set it is not stored with compression."
61
59
  },
62
60
  "fileExtension": {
63
61
  "type": "string",
64
- "description": "The extension. json-ld type:schema:Text"
62
+ "description": "The extension."
65
63
  },
66
64
  "metadata": {
67
65
  "$ref": "https://schema.twindev.org/json-ld/JsonLdNodeObject",
68
- "description": "The metadata for the blob as JSON-LD. json-ld id"
66
+ "description": "The metadata for the blob as JSON-LD."
69
67
  },
70
68
  "blob": {
71
69
  "type": "string",
72
- "description": "The blob in base64 format, included if the includeContent flag was set in the request. json-ld type:schema:Text"
70
+ "description": "The blob in base64 format, included if the includeContent flag was set in the request."
73
71
  }
74
72
  },
75
73
  "required": [
@@ -24,52 +24,52 @@ export interface IBlobStorageEntry {
24
24
  id: string;
25
25
  /**
26
26
  * The date/time when the entry was created.
27
- * json-ld namespace:schema
27
+ * @json-ld namespace:schema
28
28
  */
29
29
  dateCreated: string;
30
30
  /**
31
31
  * The date/time when the entry was modified.
32
- * json-ld namespace:schema
32
+ * @json-ld namespace:schema
33
33
  */
34
34
  dateModified?: string;
35
35
  /**
36
36
  * The size of the data in the blob.
37
- * json-ld type:schema:Integer
37
+ * @json-ld type:schema:Integer
38
38
  */
39
39
  blobSize: number;
40
40
  /**
41
41
  * The integrity of the data in the blob.
42
- * json-ld namespace:twin-common
42
+ * @json-ld namespace:twin-common
43
43
  */
44
44
  integrity: string;
45
45
  /**
46
46
  * The mime type for the blob.
47
- * json-ld namespace:schema
47
+ * @json-ld namespace:schema
48
48
  */
49
49
  encodingFormat?: string;
50
50
  /**
51
51
  * Indicates if the blob is encrypted.
52
- * json-ld type:schema:Boolean
52
+ * @json-ld type:schema:Boolean
53
53
  */
54
54
  isEncrypted?: boolean;
55
55
  /**
56
56
  * The type of compression used for the blob, if not set it is not stored with compression.
57
- * json-ld type:schema:Text
57
+ * @json-ld type:schema:Text
58
58
  */
59
59
  compression?: BlobStorageCompressionType;
60
60
  /**
61
61
  * The extension.
62
- * json-ld type:schema:Text
62
+ * @json-ld type:schema:Text
63
63
  */
64
64
  fileExtension?: string;
65
65
  /**
66
66
  * The metadata for the blob as JSON-LD.
67
- * json-ld id
67
+ * @json-ld id
68
68
  */
69
69
  metadata?: IJsonLdNodeObject;
70
70
  /**
71
71
  * The blob in base64 format, included if the includeContent flag was set in the request.
72
- * json-ld type:schema:Text
72
+ * @json-ld type:schema:Text
73
73
  */
74
74
  blob?: string;
75
75
  }
package/docs/changelog.md CHANGED
@@ -1,190 +1,229 @@
1
- # @twin.org/blob-storage-models - Changelog
1
+ # Changelog
2
2
 
3
- ## [0.0.3-next.7](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.3-next.6...blob-storage-models-v0.0.3-next.7) (2026-02-25)
3
+ ## [0.0.3-next.9](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.3-next.8...blob-storage-models-v0.0.3-next.9) (2026-05-07)
4
4
 
5
5
 
6
6
  ### Features
7
7
 
8
- * update schemas ([6fe6571](https://github.com/twinfoundation/blob-storage/commit/6fe65714e23209cdd760ecd5aa8e18762044e4b3))
8
+ * add compression support ([67d239b](https://github.com/iotaledger/twin-blob-storage/commit/67d239bca8321bd90bf4ff93167c564130309730))
9
+ * add context id features ([#30](https://github.com/iotaledger/twin-blob-storage/issues/30)) ([fbf1c92](https://github.com/iotaledger/twin-blob-storage/commit/fbf1c9276424c841ef5ef3f4de8469ab3fba7e9c))
10
+ * add missing namespace for JSON-LD context ([80b15cf](https://github.com/iotaledger/twin-blob-storage/commit/80b15cf34b580d9550affa66bcbc9b9ccb34ce21))
11
+ * add ts-to-jsonld-context tool ([2fd217f](https://github.com/iotaledger/twin-blob-storage/commit/2fd217f50dfaf6ac068091876237f5a101a7995e))
12
+ * add validate-locales ([f20fcec](https://github.com/iotaledger/twin-blob-storage/commit/f20fceced91e39a0c9edb770b2e43ce944c92f3c))
13
+ * additional encryption options on per item basis ([4b95a65](https://github.com/iotaledger/twin-blob-storage/commit/4b95a656d19e3b571cea905e36f29b679b13e1e8))
14
+ * blobHash changed to integrity ([#41](https://github.com/iotaledger/twin-blob-storage/issues/41)) ([c06a55f](https://github.com/iotaledger/twin-blob-storage/commit/c06a55f0eed3f7cad5d19c4084abd8ef0cdbfb60))
15
+ * eslint migration to flat config ([e4239dd](https://github.com/iotaledger/twin-blob-storage/commit/e4239dd1c721955cff7f0357255d2bba15319972))
16
+ * remove includeNodeIdentity flag ([13bc334](https://github.com/iotaledger/twin-blob-storage/commit/13bc33445b179879688af3c98e8be8a5609d3f46))
17
+ * 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))
18
+ * update contexts ([#34](https://github.com/iotaledger/twin-blob-storage/issues/34)) ([b9e432c](https://github.com/iotaledger/twin-blob-storage/commit/b9e432c26025e4bfdf5ba837516dfdbf40f45a61))
19
+ * update contexts and namespaces ([#32](https://github.com/iotaledger/twin-blob-storage/issues/32)) ([187ed36](https://github.com/iotaledger/twin-blob-storage/commit/187ed36a7d83062665f70689ec5e2b2f553a592e))
20
+ * update dependencies ([56f0094](https://github.com/iotaledger/twin-blob-storage/commit/56f0094b68d8bd22864cd899ac1b61d95540f719))
21
+ * update framework core ([ff339fe](https://github.com/iotaledger/twin-blob-storage/commit/ff339fe7e3f09ddff429907834bdf43617e9c05e))
22
+ * update schemas ([6fe6571](https://github.com/iotaledger/twin-blob-storage/commit/6fe65714e23209cdd760ecd5aa8e18762044e4b3))
23
+ * update to support fully qualified data type names ([3297d69](https://github.com/iotaledger/twin-blob-storage/commit/3297d69d332058b0f0141002087f56ba230620e1))
24
+ * update ts-to-schema generation ([03439c7](https://github.com/iotaledger/twin-blob-storage/commit/03439c726108bf645941290e41824c57a6a23de3))
25
+ * use shared store mechanism ([#12](https://github.com/iotaledger/twin-blob-storage/issues/12)) ([cae8110](https://github.com/iotaledger/twin-blob-storage/commit/cae8110681847a1ac4fcac968b8196694e49c320))
26
+ * use standard list json ld types ([d6bdfd6](https://github.com/iotaledger/twin-blob-storage/commit/d6bdfd68af47f70f3cc53658b4a12543497e1f48))
9
27
 
10
- ## [0.0.3-next.6](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.3-next.5...blob-storage-models-v0.0.3-next.6) (2026-02-09)
28
+
29
+ ### Bug Fixes
30
+
31
+ * 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))
32
+ * data validation tests ([556979a](https://github.com/iotaledger/twin-blob-storage/commit/556979a0c36a942f691c971a9bce3a5d72093f52))
33
+ * query params force coercion ([a5e547a](https://github.com/iotaledger/twin-blob-storage/commit/a5e547a775f8997cb04780938c7a9561ddb048d1))
34
+
35
+ ## [0.0.3-next.8](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.3-next.7...blob-storage-models-v0.0.3-next.8) (2026-05-07)
36
+
37
+
38
+ ### Bug Fixes
39
+
40
+ * data validation tests ([556979a](https://github.com/iotaledger/twin-blob-storage/commit/556979a0c36a942f691c971a9bce3a5d72093f52))
41
+
42
+ ## [0.0.3-next.7](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.3-next.6...blob-storage-models-v0.0.3-next.7) (2026-02-25)
43
+
44
+
45
+ ### Features
46
+
47
+ * update schemas ([6fe6571](https://github.com/iotaledger/twin-blob-storage/commit/6fe65714e23209cdd760ecd5aa8e18762044e4b3))
48
+
49
+ ## [0.0.3-next.6](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.3-next.5...blob-storage-models-v0.0.3-next.6) (2026-02-09)
11
50
 
12
51
 
13
52
  ### Features
14
53
 
15
- * add missing namespace for JSON-LD context ([80b15cf](https://github.com/twinfoundation/blob-storage/commit/80b15cf34b580d9550affa66bcbc9b9ccb34ce21))
16
- * add ts-to-jsonld-context tool ([2fd217f](https://github.com/twinfoundation/blob-storage/commit/2fd217f50dfaf6ac068091876237f5a101a7995e))
17
- * blobHash changed to integrity ([#41](https://github.com/twinfoundation/blob-storage/issues/41)) ([c06a55f](https://github.com/twinfoundation/blob-storage/commit/c06a55f0eed3f7cad5d19c4084abd8ef0cdbfb60))
54
+ * add missing namespace for JSON-LD context ([80b15cf](https://github.com/iotaledger/twin-blob-storage/commit/80b15cf34b580d9550affa66bcbc9b9ccb34ce21))
55
+ * add ts-to-jsonld-context tool ([2fd217f](https://github.com/iotaledger/twin-blob-storage/commit/2fd217f50dfaf6ac068091876237f5a101a7995e))
56
+ * blobHash changed to integrity ([#41](https://github.com/iotaledger/twin-blob-storage/issues/41)) ([c06a55f](https://github.com/iotaledger/twin-blob-storage/commit/c06a55f0eed3f7cad5d19c4084abd8ef0cdbfb60))
18
57
 
19
- ## [0.0.3-next.5](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.3-next.4...blob-storage-models-v0.0.3-next.5) (2026-01-26)
58
+ ## [0.0.3-next.5](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.3-next.4...blob-storage-models-v0.0.3-next.5) (2026-01-26)
20
59
 
21
60
 
22
61
  ### Miscellaneous Chores
23
62
 
24
63
  * **blob-storage-models:** Synchronize repo versions
25
64
 
26
- ## [0.0.3-next.4](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.3-next.3...blob-storage-models-v0.0.3-next.4) (2026-01-23)
65
+ ## [0.0.3-next.4](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.3-next.3...blob-storage-models-v0.0.3-next.4) (2026-01-23)
27
66
 
28
67
 
29
68
  ### Features
30
69
 
31
- * replace nextItem property with Link header ([#37](https://github.com/twinfoundation/blob-storage/issues/37)) ([0b68da5](https://github.com/twinfoundation/blob-storage/commit/0b68da58549c9e52eb2313ea5a868573840d5ca6))
70
+ * 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))
32
71
 
33
- ## [0.0.3-next.3](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.3-next.2...blob-storage-models-v0.0.3-next.3) (2026-01-21)
72
+ ## [0.0.3-next.3](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.3-next.2...blob-storage-models-v0.0.3-next.3) (2026-01-21)
34
73
 
35
74
 
36
75
  ### Features
37
76
 
38
- * update contexts ([#34](https://github.com/twinfoundation/blob-storage/issues/34)) ([b9e432c](https://github.com/twinfoundation/blob-storage/commit/b9e432c26025e4bfdf5ba837516dfdbf40f45a61))
77
+ * update contexts ([#34](https://github.com/iotaledger/twin-blob-storage/issues/34)) ([b9e432c](https://github.com/iotaledger/twin-blob-storage/commit/b9e432c26025e4bfdf5ba837516dfdbf40f45a61))
39
78
 
40
- ## [0.0.3-next.2](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.3-next.1...blob-storage-models-v0.0.3-next.2) (2026-01-14)
79
+ ## [0.0.3-next.2](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.3-next.1...blob-storage-models-v0.0.3-next.2) (2026-01-14)
41
80
 
42
81
 
43
82
  ### Features
44
83
 
45
- * update contexts and namespaces ([#32](https://github.com/twinfoundation/blob-storage/issues/32)) ([187ed36](https://github.com/twinfoundation/blob-storage/commit/187ed36a7d83062665f70689ec5e2b2f553a592e))
84
+ * update contexts and namespaces ([#32](https://github.com/iotaledger/twin-blob-storage/issues/32)) ([187ed36](https://github.com/iotaledger/twin-blob-storage/commit/187ed36a7d83062665f70689ec5e2b2f553a592e))
46
85
 
47
- ## [0.0.3-next.1](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.3-next.0...blob-storage-models-v0.0.3-next.1) (2025-11-11)
86
+ ## [0.0.3-next.1](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.3-next.0...blob-storage-models-v0.0.3-next.1) (2025-11-11)
48
87
 
49
88
 
50
89
  ### Features
51
90
 
52
- * add compression support ([67d239b](https://github.com/twinfoundation/blob-storage/commit/67d239bca8321bd90bf4ff93167c564130309730))
53
- * add context id features ([#30](https://github.com/twinfoundation/blob-storage/issues/30)) ([fbf1c92](https://github.com/twinfoundation/blob-storage/commit/fbf1c9276424c841ef5ef3f4de8469ab3fba7e9c))
54
- * add validate-locales ([f20fcec](https://github.com/twinfoundation/blob-storage/commit/f20fceced91e39a0c9edb770b2e43ce944c92f3c))
55
- * additional encryption options on per item basis ([4b95a65](https://github.com/twinfoundation/blob-storage/commit/4b95a656d19e3b571cea905e36f29b679b13e1e8))
56
- * eslint migration to flat config ([e4239dd](https://github.com/twinfoundation/blob-storage/commit/e4239dd1c721955cff7f0357255d2bba15319972))
57
- * remove includeNodeIdentity flag ([13bc334](https://github.com/twinfoundation/blob-storage/commit/13bc33445b179879688af3c98e8be8a5609d3f46))
58
- * update dependencies ([56f0094](https://github.com/twinfoundation/blob-storage/commit/56f0094b68d8bd22864cd899ac1b61d95540f719))
59
- * update framework core ([ff339fe](https://github.com/twinfoundation/blob-storage/commit/ff339fe7e3f09ddff429907834bdf43617e9c05e))
60
- * update to support fully qualified data type names ([3297d69](https://github.com/twinfoundation/blob-storage/commit/3297d69d332058b0f0141002087f56ba230620e1))
61
- * update ts-to-schema generation ([03439c7](https://github.com/twinfoundation/blob-storage/commit/03439c726108bf645941290e41824c57a6a23de3))
62
- * use shared store mechanism ([#12](https://github.com/twinfoundation/blob-storage/issues/12)) ([cae8110](https://github.com/twinfoundation/blob-storage/commit/cae8110681847a1ac4fcac968b8196694e49c320))
63
- * use standard list json ld types ([d6bdfd6](https://github.com/twinfoundation/blob-storage/commit/d6bdfd68af47f70f3cc53658b4a12543497e1f48))
91
+ * add compression support ([67d239b](https://github.com/iotaledger/twin-blob-storage/commit/67d239bca8321bd90bf4ff93167c564130309730))
92
+ * add context id features ([#30](https://github.com/iotaledger/twin-blob-storage/issues/30)) ([fbf1c92](https://github.com/iotaledger/twin-blob-storage/commit/fbf1c9276424c841ef5ef3f4de8469ab3fba7e9c))
93
+ * add validate-locales ([f20fcec](https://github.com/iotaledger/twin-blob-storage/commit/f20fceced91e39a0c9edb770b2e43ce944c92f3c))
94
+ * additional encryption options on per item basis ([4b95a65](https://github.com/iotaledger/twin-blob-storage/commit/4b95a656d19e3b571cea905e36f29b679b13e1e8))
95
+ * eslint migration to flat config ([e4239dd](https://github.com/iotaledger/twin-blob-storage/commit/e4239dd1c721955cff7f0357255d2bba15319972))
96
+ * remove includeNodeIdentity flag ([13bc334](https://github.com/iotaledger/twin-blob-storage/commit/13bc33445b179879688af3c98e8be8a5609d3f46))
97
+ * update dependencies ([56f0094](https://github.com/iotaledger/twin-blob-storage/commit/56f0094b68d8bd22864cd899ac1b61d95540f719))
98
+ * update framework core ([ff339fe](https://github.com/iotaledger/twin-blob-storage/commit/ff339fe7e3f09ddff429907834bdf43617e9c05e))
99
+ * update to support fully qualified data type names ([3297d69](https://github.com/iotaledger/twin-blob-storage/commit/3297d69d332058b0f0141002087f56ba230620e1))
100
+ * update ts-to-schema generation ([03439c7](https://github.com/iotaledger/twin-blob-storage/commit/03439c726108bf645941290e41824c57a6a23de3))
101
+ * use shared store mechanism ([#12](https://github.com/iotaledger/twin-blob-storage/issues/12)) ([cae8110](https://github.com/iotaledger/twin-blob-storage/commit/cae8110681847a1ac4fcac968b8196694e49c320))
102
+ * use standard list json ld types ([d6bdfd6](https://github.com/iotaledger/twin-blob-storage/commit/d6bdfd68af47f70f3cc53658b4a12543497e1f48))
64
103
 
65
104
 
66
105
  ### Bug Fixes
67
106
 
68
- * Adding the optional flag to the entity ([#10](https://github.com/twinfoundation/blob-storage/issues/10)) ([626677e](https://github.com/twinfoundation/blob-storage/commit/626677e5730d23535a0eb1f36f8394d941ff2447))
69
- * query params force coercion ([a5e547a](https://github.com/twinfoundation/blob-storage/commit/a5e547a775f8997cb04780938c7a9561ddb048d1))
107
+ * 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))
108
+ * query params force coercion ([a5e547a](https://github.com/iotaledger/twin-blob-storage/commit/a5e547a775f8997cb04780938c7a9561ddb048d1))
70
109
 
71
- ## [0.0.2-next.5](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.2-next.4...blob-storage-models-v0.0.2-next.5) (2025-10-09)
110
+ ## [0.0.2-next.5](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.2-next.4...blob-storage-models-v0.0.2-next.5) (2025-10-09)
72
111
 
73
112
 
74
113
  ### Features
75
114
 
76
- * add validate-locales ([f20fcec](https://github.com/twinfoundation/blob-storage/commit/f20fceced91e39a0c9edb770b2e43ce944c92f3c))
115
+ * add validate-locales ([f20fcec](https://github.com/iotaledger/twin-blob-storage/commit/f20fceced91e39a0c9edb770b2e43ce944c92f3c))
77
116
 
78
- ## [0.0.2-next.4](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.2-next.3...blob-storage-models-v0.0.2-next.4) (2025-10-02)
117
+ ## [0.0.2-next.4](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.2-next.3...blob-storage-models-v0.0.2-next.4) (2025-10-02)
79
118
 
80
119
 
81
120
  ### Miscellaneous Chores
82
121
 
83
122
  * **blob-storage-models:** Synchronize repo versions
84
123
 
85
- ## [0.0.2-next.3](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.2-next.2...blob-storage-models-v0.0.2-next.3) (2025-08-29)
124
+ ## [0.0.2-next.3](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.2-next.2...blob-storage-models-v0.0.2-next.3) (2025-08-29)
86
125
 
87
126
 
88
127
  ### Features
89
128
 
90
- * eslint migration to flat config ([e4239dd](https://github.com/twinfoundation/blob-storage/commit/e4239dd1c721955cff7f0357255d2bba15319972))
129
+ * eslint migration to flat config ([e4239dd](https://github.com/iotaledger/twin-blob-storage/commit/e4239dd1c721955cff7f0357255d2bba15319972))
91
130
 
92
- ## [0.0.2-next.2](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.2-next.1...blob-storage-models-v0.0.2-next.2) (2025-08-20)
131
+ ## [0.0.2-next.2](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.2-next.1...blob-storage-models-v0.0.2-next.2) (2025-08-20)
93
132
 
94
133
 
95
134
  ### Features
96
135
 
97
- * update framework core ([ff339fe](https://github.com/twinfoundation/blob-storage/commit/ff339fe7e3f09ddff429907834bdf43617e9c05e))
136
+ * update framework core ([ff339fe](https://github.com/iotaledger/twin-blob-storage/commit/ff339fe7e3f09ddff429907834bdf43617e9c05e))
98
137
 
99
- ## [0.0.2-next.1](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.2-next.0...blob-storage-models-v0.0.2-next.1) (2025-07-24)
138
+ ## [0.0.2-next.1](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.2-next.0...blob-storage-models-v0.0.2-next.1) (2025-07-24)
100
139
 
101
140
 
102
141
  ### Features
103
142
 
104
- * add compression support ([67d239b](https://github.com/twinfoundation/blob-storage/commit/67d239bca8321bd90bf4ff93167c564130309730))
105
- * additional encryption options on per item basis ([4b95a65](https://github.com/twinfoundation/blob-storage/commit/4b95a656d19e3b571cea905e36f29b679b13e1e8))
106
- * remove includeNodeIdentity flag ([13bc334](https://github.com/twinfoundation/blob-storage/commit/13bc33445b179879688af3c98e8be8a5609d3f46))
107
- * update dependencies ([56f0094](https://github.com/twinfoundation/blob-storage/commit/56f0094b68d8bd22864cd899ac1b61d95540f719))
108
- * update to support fully qualified data type names ([3297d69](https://github.com/twinfoundation/blob-storage/commit/3297d69d332058b0f0141002087f56ba230620e1))
109
- * update ts-to-schema generation ([03439c7](https://github.com/twinfoundation/blob-storage/commit/03439c726108bf645941290e41824c57a6a23de3))
110
- * use shared store mechanism ([#12](https://github.com/twinfoundation/blob-storage/issues/12)) ([cae8110](https://github.com/twinfoundation/blob-storage/commit/cae8110681847a1ac4fcac968b8196694e49c320))
111
- * use standard list json ld types ([d6bdfd6](https://github.com/twinfoundation/blob-storage/commit/d6bdfd68af47f70f3cc53658b4a12543497e1f48))
143
+ * add compression support ([67d239b](https://github.com/iotaledger/twin-blob-storage/commit/67d239bca8321bd90bf4ff93167c564130309730))
144
+ * additional encryption options on per item basis ([4b95a65](https://github.com/iotaledger/twin-blob-storage/commit/4b95a656d19e3b571cea905e36f29b679b13e1e8))
145
+ * remove includeNodeIdentity flag ([13bc334](https://github.com/iotaledger/twin-blob-storage/commit/13bc33445b179879688af3c98e8be8a5609d3f46))
146
+ * update dependencies ([56f0094](https://github.com/iotaledger/twin-blob-storage/commit/56f0094b68d8bd22864cd899ac1b61d95540f719))
147
+ * update to support fully qualified data type names ([3297d69](https://github.com/iotaledger/twin-blob-storage/commit/3297d69d332058b0f0141002087f56ba230620e1))
148
+ * update ts-to-schema generation ([03439c7](https://github.com/iotaledger/twin-blob-storage/commit/03439c726108bf645941290e41824c57a6a23de3))
149
+ * use shared store mechanism ([#12](https://github.com/iotaledger/twin-blob-storage/issues/12)) ([cae8110](https://github.com/iotaledger/twin-blob-storage/commit/cae8110681847a1ac4fcac968b8196694e49c320))
150
+ * use standard list json ld types ([d6bdfd6](https://github.com/iotaledger/twin-blob-storage/commit/d6bdfd68af47f70f3cc53658b4a12543497e1f48))
112
151
 
113
152
 
114
153
  ### Bug Fixes
115
154
 
116
- * Adding the optional flag to the entity ([#10](https://github.com/twinfoundation/blob-storage/issues/10)) ([626677e](https://github.com/twinfoundation/blob-storage/commit/626677e5730d23535a0eb1f36f8394d941ff2447))
117
- * query params force coercion ([a5e547a](https://github.com/twinfoundation/blob-storage/commit/a5e547a775f8997cb04780938c7a9561ddb048d1))
155
+ * 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))
156
+ * query params force coercion ([a5e547a](https://github.com/iotaledger/twin-blob-storage/commit/a5e547a775f8997cb04780938c7a9561ddb048d1))
118
157
 
119
158
  ## 0.0.1 (2025-07-04)
120
159
 
121
160
 
122
161
  ### Features
123
162
 
124
- * release to production ([eacfe75](https://github.com/twinfoundation/blob-storage/commit/eacfe754a0dcd9243d9e13d86422327d0a605164))
163
+ * release to production ([eacfe75](https://github.com/iotaledger/twin-blob-storage/commit/eacfe754a0dcd9243d9e13d86422327d0a605164))
125
164
 
126
- ## [0.0.1-next.37](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.1-next.36...blob-storage-models-v0.0.1-next.37) (2025-06-20)
165
+ ## [0.0.1-next.37](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.1-next.36...blob-storage-models-v0.0.1-next.37) (2025-06-20)
127
166
 
128
167
 
129
168
  ### Bug Fixes
130
169
 
131
- * query params force coercion ([a5e547a](https://github.com/twinfoundation/blob-storage/commit/a5e547a775f8997cb04780938c7a9561ddb048d1))
170
+ * query params force coercion ([a5e547a](https://github.com/iotaledger/twin-blob-storage/commit/a5e547a775f8997cb04780938c7a9561ddb048d1))
132
171
 
133
- ## [0.0.1-next.36](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.1-next.35...blob-storage-models-v0.0.1-next.36) (2025-06-19)
172
+ ## [0.0.1-next.36](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.1-next.35...blob-storage-models-v0.0.1-next.36) (2025-06-19)
134
173
 
135
174
 
136
175
  ### Features
137
176
 
138
- * add compression support ([67d239b](https://github.com/twinfoundation/blob-storage/commit/67d239bca8321bd90bf4ff93167c564130309730))
177
+ * add compression support ([67d239b](https://github.com/iotaledger/twin-blob-storage/commit/67d239bca8321bd90bf4ff93167c564130309730))
139
178
 
140
- ## [0.0.1-next.35](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.1-next.34...blob-storage-models-v0.0.1-next.35) (2025-06-17)
179
+ ## [0.0.1-next.35](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.1-next.34...blob-storage-models-v0.0.1-next.35) (2025-06-17)
141
180
 
142
181
 
143
182
  ### Features
144
183
 
145
- * additional encryption options on per item basis ([4b95a65](https://github.com/twinfoundation/blob-storage/commit/4b95a656d19e3b571cea905e36f29b679b13e1e8))
184
+ * additional encryption options on per item basis ([4b95a65](https://github.com/iotaledger/twin-blob-storage/commit/4b95a656d19e3b571cea905e36f29b679b13e1e8))
146
185
 
147
- ## [0.0.1-next.34](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.1-next.33...blob-storage-models-v0.0.1-next.34) (2025-06-12)
186
+ ## [0.0.1-next.34](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.1-next.33...blob-storage-models-v0.0.1-next.34) (2025-06-12)
148
187
 
149
188
 
150
189
  ### Features
151
190
 
152
- * update dependencies ([56f0094](https://github.com/twinfoundation/blob-storage/commit/56f0094b68d8bd22864cd899ac1b61d95540f719))
191
+ * update dependencies ([56f0094](https://github.com/iotaledger/twin-blob-storage/commit/56f0094b68d8bd22864cd899ac1b61d95540f719))
153
192
 
154
- ## [0.0.1-next.33](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.1-next.32...blob-storage-models-v0.0.1-next.33) (2025-06-03)
193
+ ## [0.0.1-next.33](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.1-next.32...blob-storage-models-v0.0.1-next.33) (2025-06-03)
155
194
 
156
195
 
157
196
  ### Features
158
197
 
159
- * update ts-to-schema generation ([03439c7](https://github.com/twinfoundation/blob-storage/commit/03439c726108bf645941290e41824c57a6a23de3))
198
+ * update ts-to-schema generation ([03439c7](https://github.com/iotaledger/twin-blob-storage/commit/03439c726108bf645941290e41824c57a6a23de3))
160
199
 
161
- ## [0.0.1-next.32](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.1-next.31...blob-storage-models-v0.0.1-next.32) (2025-05-28)
200
+ ## [0.0.1-next.32](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.1-next.31...blob-storage-models-v0.0.1-next.32) (2025-05-28)
162
201
 
163
202
 
164
203
  ### Features
165
204
 
166
- * update to support fully qualified data type names ([3297d69](https://github.com/twinfoundation/blob-storage/commit/3297d69d332058b0f0141002087f56ba230620e1))
205
+ * update to support fully qualified data type names ([3297d69](https://github.com/iotaledger/twin-blob-storage/commit/3297d69d332058b0f0141002087f56ba230620e1))
167
206
 
168
- ## [0.0.1-next.31](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.1-next.30...blob-storage-models-v0.0.1-next.31) (2025-05-08)
207
+ ## [0.0.1-next.31](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.1-next.30...blob-storage-models-v0.0.1-next.31) (2025-05-08)
169
208
 
170
209
 
171
210
  ### Features
172
211
 
173
- * use standard list json ld types ([d6bdfd6](https://github.com/twinfoundation/blob-storage/commit/d6bdfd68af47f70f3cc53658b4a12543497e1f48))
212
+ * use standard list json ld types ([d6bdfd6](https://github.com/iotaledger/twin-blob-storage/commit/d6bdfd68af47f70f3cc53658b4a12543497e1f48))
174
213
 
175
- ## [0.0.1-next.30](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.1-next.29...blob-storage-models-v0.0.1-next.30) (2025-04-17)
214
+ ## [0.0.1-next.30](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.1-next.29...blob-storage-models-v0.0.1-next.30) (2025-04-17)
176
215
 
177
216
 
178
217
  ### Features
179
218
 
180
- * use shared store mechanism ([#12](https://github.com/twinfoundation/blob-storage/issues/12)) ([cae8110](https://github.com/twinfoundation/blob-storage/commit/cae8110681847a1ac4fcac968b8196694e49c320))
219
+ * use shared store mechanism ([#12](https://github.com/iotaledger/twin-blob-storage/issues/12)) ([cae8110](https://github.com/iotaledger/twin-blob-storage/commit/cae8110681847a1ac4fcac968b8196694e49c320))
181
220
 
182
- ## [0.0.1-next.29](https://github.com/twinfoundation/blob-storage/compare/blob-storage-models-v0.0.1-next.28...blob-storage-models-v0.0.1-next.29) (2025-03-28)
221
+ ## [0.0.1-next.29](https://github.com/iotaledger/twin-blob-storage/compare/blob-storage-models-v0.0.1-next.28...blob-storage-models-v0.0.1-next.29) (2025-03-28)
183
222
 
184
223
 
185
224
  ### Bug Fixes
186
225
 
187
- * Adding the optional flag to the entity ([#10](https://github.com/twinfoundation/blob-storage/issues/10)) ([626677e](https://github.com/twinfoundation/blob-storage/commit/626677e5730d23535a0eb1f36f8394d941ff2447))
226
+ * 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))
188
227
 
189
228
  ## v0.0.1-next.28
190
229
 
package/docs/examples.md CHANGED
@@ -1 +1,23 @@
1
- # @twin.org/blob-storage-models - Examples
1
+ # Models Examples
2
+
3
+ Use these snippets to register data types and resolve connector instances by namespace when composing storage workflows.
4
+
5
+ ## BlobStorageDataTypes
6
+
7
+ ```typescript
8
+ import { BlobStorageDataTypes } from '@twin.org/blob-storage-models';
9
+
10
+ BlobStorageDataTypes.registerTypes();
11
+ ```
12
+
13
+ ## BlobStorageConnectorFactory
14
+
15
+ ```typescript
16
+ import { BlobStorageConnectorFactory } from '@twin.org/blob-storage-models';
17
+
18
+ const connectorNamespaces = BlobStorageConnectorFactory.names();
19
+ console.log(connectorNamespaces.length); // 2
20
+
21
+ const defaultConnector = BlobStorageConnectorFactory.get(connectorNamespaces[0]);
22
+ console.log(defaultConnector.className()); // MemoryBlobStorageConnector
23
+ ```
@@ -14,7 +14,7 @@ Handle all the data types for blob storage.
14
14
 
15
15
  ## Methods
16
16
 
17
- ### registerTypes()
17
+ ### registerTypes() {#registertypes}
18
18
 
19
19
  > `static` **registerTypes**(): `void`
20
20
 
@@ -8,7 +8,7 @@ Interface describing an blob storage component.
8
8
 
9
9
  ## Methods
10
10
 
11
- ### create()
11
+ ### create() {#create}
12
12
 
13
13
  > **create**(`blob`, `encodingFormat?`, `fileExtension?`, `metadata?`, `options?`): `Promise`\<`string`\>
14
14
 
@@ -76,7 +76,7 @@ The id of the stored blob in urn format.
76
76
 
77
77
  ***
78
78
 
79
- ### get()
79
+ ### get() {#get}
80
80
 
81
81
  > **get**(`id`, `options?`): `Promise`\<[`IBlobStorageEntry`](IBlobStorageEntry.md)\>
82
82
 
@@ -124,7 +124,7 @@ Not found error if the blob cannot be found.
124
124
 
125
125
  ***
126
126
 
127
- ### update()
127
+ ### update() {#update}
128
128
 
129
129
  > **update**(`id`, `encodingFormat?`, `fileExtension?`, `metadata?`): `Promise`\<`void`\>
130
130
 
@@ -168,7 +168,7 @@ Not found error if the blob cannot be found.
168
168
 
169
169
  ***
170
170
 
171
- ### remove()
171
+ ### remove() {#remove}
172
172
 
173
173
  > **remove**(`id`): `Promise`\<`void`\>
174
174
 
@@ -194,7 +194,7 @@ Not found error if the blob cannot be found.
194
194
 
195
195
  ***
196
196
 
197
- ### query()
197
+ ### query() {#query}
198
198
 
199
199
  > **query**(`conditions?`, `orderBy?`, `orderByDirection?`, `cursor?`, `limit?`): `Promise`\<\{ `entries`: [`IBlobStorageEntryList`](IBlobStorageEntryList.md); `cursor?`: `string`; \}\>
200
200
 
@@ -210,9 +210,9 @@ The conditions to match for the entries.
210
210
 
211
211
  ##### orderBy?
212
212
 
213
- The order for the results, defaults to created.
213
+ `"dateCreated"` \| `"dateModified"`
214
214
 
215
- `"dateCreated"` | `"dateModified"`
215
+ The order for the results, defaults to created.
216
216
 
217
217
  ##### orderByDirection?
218
218
 
@@ -8,7 +8,7 @@ Interface describing an blob storage connector.
8
8
 
9
9
  ## Methods
10
10
 
11
- ### set()
11
+ ### set() {#set}
12
12
 
13
13
  > **set**(`blob`): `Promise`\<`string`\>
14
14
 
@@ -30,7 +30,7 @@ The id of the stored blob in urn format.
30
30
 
31
31
  ***
32
32
 
33
- ### get()
33
+ ### get() {#get}
34
34
 
35
35
  > **get**(`id`): `Promise`\<`Uint8Array`\<`ArrayBufferLike`\> \| `undefined`\>
36
36
 
@@ -52,7 +52,7 @@ The data for the blob if it can be found or undefined.
52
52
 
53
53
  ***
54
54
 
55
- ### remove()
55
+ ### remove() {#remove}
56
56
 
57
57
  > **remove**(`id`): `Promise`\<`boolean`\>
58
58
 
@@ -4,7 +4,7 @@ Request to create an entry in blob storage.
4
4
 
5
5
  ## Properties
6
6
 
7
- ### body
7
+ ### body {#body}
8
8
 
9
9
  > **body**: `object`
10
10
 
@@ -18,25 +18,25 @@ The data to store in base64 encoding.
18
18
 
19
19
  #### encodingFormat?
20
20
 
21
- > `optional` **encodingFormat**: `string`
21
+ > `optional` **encodingFormat?**: `string`
22
22
 
23
23
  The mime type of the blob, will be detected if left undefined.
24
24
 
25
25
  #### fileExtension?
26
26
 
27
- > `optional` **fileExtension**: `string`
27
+ > `optional` **fileExtension?**: `string`
28
28
 
29
29
  The extension of the blob, will be detected if left undefined.
30
30
 
31
31
  #### metadata?
32
32
 
33
- > `optional` **metadata**: `IJsonLdNodeObject`
33
+ > `optional` **metadata?**: `IJsonLdNodeObject`
34
34
 
35
35
  Custom metadata to associate with the blob as JSON-LD.
36
36
 
37
37
  #### disableEncryption?
38
38
 
39
- > `optional` **disableEncryption**: `boolean`
39
+ > `optional` **disableEncryption?**: `boolean`
40
40
 
41
41
  Disables encryption if enabled by default.
42
42
 
@@ -48,13 +48,13 @@ false
48
48
 
49
49
  #### compress?
50
50
 
51
- > `optional` **compress**: [`BlobStorageCompressionType`](../type-aliases/BlobStorageCompressionType.md)
51
+ > `optional` **compress?**: [`BlobStorageCompressionType`](../type-aliases/BlobStorageCompressionType.md)
52
52
 
53
53
  Optional compression type to use for the blob, defaults to no compression.
54
54
 
55
55
  #### overrideVaultKeyId?
56
56
 
57
- > `optional` **overrideVaultKeyId**: `string`
57
+ > `optional` **overrideVaultKeyId?**: `string`
58
58
 
59
59
  Use a different vault key id for encryption, if not provided the default vault key id will be used.
60
60
 
@@ -66,6 +66,6 @@ undefined
66
66
 
67
67
  #### namespace?
68
68
 
69
- > `optional` **namespace**: `string`
69
+ > `optional` **namespace?**: `string`
70
70
 
71
71
  The namespace to store the data in, defaults to component configured namespace.
@@ -4,7 +4,7 @@ Interface describing a blob storage entry.
4
4
 
5
5
  ## Properties
6
6
 
7
- ### @context
7
+ ### @context {#context}
8
8
 
9
9
  > **@context**: \[`"https://schema.twindev.org/blob-storage/"`, `"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**: `"BlobStorageEntry"`
18
18
 
@@ -20,7 +20,7 @@ JSON-LD Type.
20
20
 
21
21
  ***
22
22
 
23
- ### id
23
+ ### id {#id}
24
24
 
25
25
  > **id**: `string`
26
26
 
@@ -28,90 +28,80 @@ The id for the blob.
28
28
 
29
29
  ***
30
30
 
31
- ### dateCreated
31
+ ### dateCreated {#datecreated}
32
32
 
33
33
  > **dateCreated**: `string`
34
34
 
35
35
  The date/time when the entry was created.
36
- json-ld namespace:schema
37
36
 
38
37
  ***
39
38
 
40
- ### dateModified?
39
+ ### dateModified? {#datemodified}
41
40
 
42
- > `optional` **dateModified**: `string`
41
+ > `optional` **dateModified?**: `string`
43
42
 
44
43
  The date/time when the entry was modified.
45
- json-ld namespace:schema
46
44
 
47
45
  ***
48
46
 
49
- ### blobSize
47
+ ### blobSize {#blobsize}
50
48
 
51
49
  > **blobSize**: `number`
52
50
 
53
51
  The size of the data in the blob.
54
- json-ld type:schema:Integer
55
52
 
56
53
  ***
57
54
 
58
- ### integrity
55
+ ### integrity {#integrity}
59
56
 
60
57
  > **integrity**: `string`
61
58
 
62
59
  The integrity of the data in the blob.
63
- json-ld namespace:twin-common
64
60
 
65
61
  ***
66
62
 
67
- ### encodingFormat?
63
+ ### encodingFormat? {#encodingformat}
68
64
 
69
- > `optional` **encodingFormat**: `string`
65
+ > `optional` **encodingFormat?**: `string`
70
66
 
71
67
  The mime type for the blob.
72
- json-ld namespace:schema
73
68
 
74
69
  ***
75
70
 
76
- ### isEncrypted?
71
+ ### isEncrypted? {#isencrypted}
77
72
 
78
- > `optional` **isEncrypted**: `boolean`
73
+ > `optional` **isEncrypted?**: `boolean`
79
74
 
80
75
  Indicates if the blob is encrypted.
81
- json-ld type:schema:Boolean
82
76
 
83
77
  ***
84
78
 
85
- ### compression?
79
+ ### compression? {#compression}
86
80
 
87
- > `optional` **compression**: [`BlobStorageCompressionType`](../type-aliases/BlobStorageCompressionType.md)
81
+ > `optional` **compression?**: [`BlobStorageCompressionType`](../type-aliases/BlobStorageCompressionType.md)
88
82
 
89
83
  The type of compression used for the blob, if not set it is not stored with compression.
90
- json-ld type:schema:Text
91
84
 
92
85
  ***
93
86
 
94
- ### fileExtension?
87
+ ### fileExtension? {#fileextension}
95
88
 
96
- > `optional` **fileExtension**: `string`
89
+ > `optional` **fileExtension?**: `string`
97
90
 
98
91
  The extension.
99
- json-ld type:schema:Text
100
92
 
101
93
  ***
102
94
 
103
- ### metadata?
95
+ ### metadata? {#metadata}
104
96
 
105
- > `optional` **metadata**: `IJsonLdNodeObject`
97
+ > `optional` **metadata?**: `IJsonLdNodeObject`
106
98
 
107
99
  The metadata for the blob as JSON-LD.
108
- json-ld id
109
100
 
110
101
  ***
111
102
 
112
- ### blob?
103
+ ### blob? {#blob}
113
104
 
114
- > `optional` **blob**: `string`
105
+ > `optional` **blob?**: `string`
115
106
 
116
107
  The blob in base64 format, included if the includeContent flag was set in the request.
117
- json-ld type:schema:Text
@@ -4,7 +4,7 @@ Interface describing an blob storage entry list.
4
4
 
5
5
  ## Properties
6
6
 
7
- ### @context
7
+ ### @context {#context}
8
8
 
9
9
  > **@context**: \[`"https://schema.org"`, `"https://schema.twindev.org/blob-storage/"`, `"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,7 +20,7 @@ JSON-LD Type.
20
20
 
21
21
  ***
22
22
 
23
- ### itemListElement
23
+ ### itemListElement {#itemlistelement}
24
24
 
25
25
  > **itemListElement**: [`IBlobStorageEntry`](IBlobStorageEntry.md)[]
26
26
 
@@ -4,7 +4,7 @@ Request to get the content from blob storage.
4
4
 
5
5
  ## Properties
6
6
 
7
- ### pathParams
7
+ ### pathParams {#pathparams}
8
8
 
9
9
  > **pathParams**: `object`
10
10
 
@@ -18,15 +18,15 @@ The id of the blob to get in urn format.
18
18
 
19
19
  ***
20
20
 
21
- ### query?
21
+ ### query? {#query}
22
22
 
23
- > `optional` **query**: `object`
23
+ > `optional` **query?**: `object`
24
24
 
25
25
  The query parameters.
26
26
 
27
27
  #### decompress?
28
28
 
29
- > `optional` **decompress**: `string`
29
+ > `optional` **decompress?**: `string`
30
30
 
31
31
  If the content should be decompressed, if it was compressed when stored, defaults to true.
32
32
 
@@ -38,7 +38,7 @@ true
38
38
 
39
39
  #### overrideVaultKeyId?
40
40
 
41
- > `optional` **overrideVaultKeyId**: `string`
41
+ > `optional` **overrideVaultKeyId?**: `string`
42
42
 
43
43
  Use a different vault key id for decryption, if not provided the default vault key id will be used.
44
44
 
@@ -50,7 +50,7 @@ undefined
50
50
 
51
51
  #### download?
52
52
 
53
- > `optional` **download**: `string`
53
+ > `optional` **download?**: `string`
54
54
 
55
55
  Set the download flag which should prompt the browser to save the file.
56
56
  Otherwise the browser should show the content inside the page.
@@ -63,7 +63,7 @@ false
63
63
 
64
64
  #### filename?
65
65
 
66
- > `optional` **filename**: `string`
66
+ > `optional` **filename?**: `string`
67
67
 
68
68
  Set the filename to use when a download is triggered.
69
69
  A filename will be generated if not provided.
@@ -4,7 +4,7 @@ Response to get an entry from blob storage.
4
4
 
5
5
  ## Properties
6
6
 
7
- ### body
7
+ ### body {#body}
8
8
 
9
9
  > **body**: `Uint8Array`
10
10
 
@@ -4,9 +4,9 @@ Request to get an entry from blob storage.
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 id of the blob to get in urn format.
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
  #### includeContent?
40
40
 
41
- > `optional` **includeContent**: `string`
41
+ > `optional` **includeContent?**: `string`
42
42
 
43
43
  Include the content in the response, otherwise only metadata is returned.
44
44
 
@@ -50,7 +50,7 @@ false
50
50
 
51
51
  #### decompress?
52
52
 
53
- > `optional` **decompress**: `string`
53
+ > `optional` **decompress?**: `string`
54
54
 
55
55
  If the content should be decompressed, if it was compressed when stored, defaults to true.
56
56
 
@@ -62,7 +62,7 @@ true
62
62
 
63
63
  #### overrideVaultKeyId?
64
64
 
65
- > `optional` **overrideVaultKeyId**: `string`
65
+ > `optional` **overrideVaultKeyId?**: `string`
66
66
 
67
67
  Use a different vault key id for decryption, if not provided the default vault key id will be used.
68
68
 
@@ -4,9 +4,9 @@ Response to get an entry from blob storage.
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**: [`IBlobStorageEntry`](IBlobStorageEntry.md)
22
22
 
@@ -4,9 +4,9 @@ Query the entries from blob storage.
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,38 +16,38 @@ 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
- > `optional` **query**: `object`
21
+ > `optional` **query?**: `object`
22
22
 
23
23
  The parameters from the query.
24
24
 
25
25
  #### conditions?
26
26
 
27
- > `optional` **conditions**: `string`
27
+ > `optional` **conditions?**: `string`
28
28
 
29
29
  The condition for the query as JSON version of EntityCondition type.
30
30
 
31
31
  #### orderBy?
32
32
 
33
- > `optional` **orderBy**: `"dateCreated"` \| `"dateModified"`
33
+ > `optional` **orderBy?**: `"dateCreated"` \| `"dateModified"`
34
34
 
35
35
  The order for the results, default to created.
36
36
 
37
37
  #### orderByDirection?
38
38
 
39
- > `optional` **orderByDirection**: `SortDirection`
39
+ > `optional` **orderByDirection?**: `SortDirection`
40
40
 
41
41
  The direction for the order, defaults to desc.
42
42
 
43
43
  #### limit?
44
44
 
45
- > `optional` **limit**: `string`
45
+ > `optional` **limit?**: `string`
46
46
 
47
47
  Limit the number of entities to return.
48
48
 
49
49
  #### cursor?
50
50
 
51
- > `optional` **cursor**: `string`
51
+ > `optional` **cursor?**: `string`
52
52
 
53
53
  The cursor to get next chunk of data, returned in previous response.
@@ -4,9 +4,9 @@ Response to getting the list of entries from a query.
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**: [`IBlobStorageEntryList`](IBlobStorageEntryList.md)
26
26
 
@@ -4,7 +4,7 @@ Request to remove an entry from blob storage.
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 blob entry.
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 id of the blob to get in urn format.
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
  #### encodingFormat?
28
28
 
29
- > `optional` **encodingFormat**: `string`
29
+ > `optional` **encodingFormat?**: `string`
30
30
 
31
31
  The mime type of the blob, will be detected if left undefined.
32
32
 
33
33
  #### fileExtension?
34
34
 
35
- > `optional` **fileExtension**: `string`
35
+ > `optional` **fileExtension?**: `string`
36
36
 
37
37
  The extension of the blob, will be detected if left undefined.
38
38
 
39
39
  #### metadata?
40
40
 
41
- > `optional` **metadata**: `IJsonLdNodeObject`
41
+ > `optional` **metadata?**: `IJsonLdNodeObject`
42
42
 
43
43
  Custom metadata to associate with the blob as JSON-LD.
@@ -6,13 +6,13 @@ The types of compression for blob storage data.
6
6
 
7
7
  ## Type Declaration
8
8
 
9
- ### Gzip
9
+ ### Gzip {#gzip}
10
10
 
11
11
  > `readonly` **Gzip**: `"gzip"` = `"gzip"`
12
12
 
13
13
  Gzip.
14
14
 
15
- ### Deflate
15
+ ### Deflate {#deflate}
16
16
 
17
17
  > `readonly` **Deflate**: `"deflate"` = `"deflate"`
18
18
 
@@ -6,37 +6,37 @@ The contexts of blob storage data.
6
6
 
7
7
  ## Type Declaration
8
8
 
9
- ### Namespace
9
+ ### Namespace {#namespace}
10
10
 
11
11
  > `readonly` **Namespace**: `"https://schema.twindev.org/blob-storage/"` = `"https://schema.twindev.org/blob-storage/"`
12
12
 
13
13
  The canonical RDF namespace URI for Blob Storage.
14
14
 
15
- ### Context
15
+ ### Context {#context}
16
16
 
17
17
  > `readonly` **Context**: `"https://schema.twindev.org/blob-storage/"` = `"https://schema.twindev.org/blob-storage/"`
18
18
 
19
19
  The value to use in JSON-LD context for Blob Storage.
20
20
 
21
- ### JsonLdContext
21
+ ### JsonLdContext {#jsonldcontext}
22
22
 
23
23
  > `readonly` **JsonLdContext**: `"https://schema.twindev.org/blob-storage/types.jsonld"` = `"https://schema.twindev.org/blob-storage/types.jsonld"`
24
24
 
25
25
  The JSON-LD Context URL.
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 blob storage data.
6
6
 
7
7
  ## Type Declaration
8
8
 
9
- ### Entry
9
+ ### Entry {#entry}
10
10
 
11
11
  > `readonly` **Entry**: `"BlobStorageEntry"` = `"BlobStorageEntry"`
12
12
 
13
13
  Represents blob storage entry.
14
14
 
15
- ### CompressionType
15
+ ### CompressionType {#compressiontype}
16
16
 
17
17
  > `readonly` **CompressionType**: `"BlobStorageCompressionType"` = `"BlobStorageCompressionType"`
18
18
 
package/package.json CHANGED
@@ -1,10 +1,10 @@
1
1
  {
2
2
  "name": "@twin.org/blob-storage-models",
3
- "version": "0.0.3-next.7",
4
- "description": "Models which define the structure of the blob storage contracts and connectors",
3
+ "version": "0.0.3-next.9",
4
+ "description": "Defines shared contracts, schemas, and interfaces for blob content, metadata, and connector behaviour.",
5
5
  "repository": {
6
6
  "type": "git",
7
- "url": "git+https://github.com/twinfoundation/blob-storage.git",
7
+ "url": "git+https://github.com/iotaledger/blob-storage.git",
8
8
  "directory": "packages/blob-storage-models"
9
9
  },
10
10
  "author": "martyn.janes@iota.org",
@@ -54,7 +54,7 @@
54
54
  "schemas"
55
55
  ],
56
56
  "bugs": {
57
- "url": "git+https://github.com/twinfoundation/blob-storage/issues"
57
+ "url": "git+https://github.com/iotaledger/blob-storage/issues"
58
58
  },
59
59
  "homepage": "https://twindev.org"
60
60
  }