@twin.org/blob-storage-models 0.0.3-next.6 → 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.
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 +15 -18
  5. package/dist/types/models/IBlobStorageEntry.d.ts +10 -10
  6. package/docs/changelog.md +78 -64
  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": [
@@ -79,6 +77,5 @@
79
77
  "dateCreated",
80
78
  "blobSize",
81
79
  "integrity"
82
- ],
83
- "additionalProperties": false
80
+ ]
84
81
  }
@@ -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,183 +1,197 @@
1
- # @twin.org/blob-storage-models - Changelog
1
+ # Changelog
2
2
 
3
- ## [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)
3
+ ## [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)
4
+
5
+
6
+ ### Bug Fixes
7
+
8
+ * data validation tests ([556979a](https://github.com/iotaledger/twin-blob-storage/commit/556979a0c36a942f691c971a9bce3a5d72093f52))
9
+
10
+ ## [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)
11
+
12
+
13
+ ### Features
14
+
15
+ * update schemas ([6fe6571](https://github.com/iotaledger/twin-blob-storage/commit/6fe65714e23209cdd760ecd5aa8e18762044e4b3))
16
+
17
+ ## [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)
4
18
 
5
19
 
6
20
  ### Features
7
21
 
8
- * add missing namespace for JSON-LD context ([80b15cf](https://github.com/twinfoundation/blob-storage/commit/80b15cf34b580d9550affa66bcbc9b9ccb34ce21))
9
- * add ts-to-jsonld-context tool ([2fd217f](https://github.com/twinfoundation/blob-storage/commit/2fd217f50dfaf6ac068091876237f5a101a7995e))
10
- * blobHash changed to integrity ([#41](https://github.com/twinfoundation/blob-storage/issues/41)) ([c06a55f](https://github.com/twinfoundation/blob-storage/commit/c06a55f0eed3f7cad5d19c4084abd8ef0cdbfb60))
22
+ * add missing namespace for JSON-LD context ([80b15cf](https://github.com/iotaledger/twin-blob-storage/commit/80b15cf34b580d9550affa66bcbc9b9ccb34ce21))
23
+ * add ts-to-jsonld-context tool ([2fd217f](https://github.com/iotaledger/twin-blob-storage/commit/2fd217f50dfaf6ac068091876237f5a101a7995e))
24
+ * blobHash changed to integrity ([#41](https://github.com/iotaledger/twin-blob-storage/issues/41)) ([c06a55f](https://github.com/iotaledger/twin-blob-storage/commit/c06a55f0eed3f7cad5d19c4084abd8ef0cdbfb60))
11
25
 
12
- ## [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)
26
+ ## [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)
13
27
 
14
28
 
15
29
  ### Miscellaneous Chores
16
30
 
17
31
  * **blob-storage-models:** Synchronize repo versions
18
32
 
19
- ## [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)
33
+ ## [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)
20
34
 
21
35
 
22
36
  ### Features
23
37
 
24
- * replace nextItem property with Link header ([#37](https://github.com/twinfoundation/blob-storage/issues/37)) ([0b68da5](https://github.com/twinfoundation/blob-storage/commit/0b68da58549c9e52eb2313ea5a868573840d5ca6))
38
+ * 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))
25
39
 
26
- ## [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)
40
+ ## [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)
27
41
 
28
42
 
29
43
  ### Features
30
44
 
31
- * update contexts ([#34](https://github.com/twinfoundation/blob-storage/issues/34)) ([b9e432c](https://github.com/twinfoundation/blob-storage/commit/b9e432c26025e4bfdf5ba837516dfdbf40f45a61))
45
+ * update contexts ([#34](https://github.com/iotaledger/twin-blob-storage/issues/34)) ([b9e432c](https://github.com/iotaledger/twin-blob-storage/commit/b9e432c26025e4bfdf5ba837516dfdbf40f45a61))
32
46
 
33
- ## [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)
47
+ ## [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)
34
48
 
35
49
 
36
50
  ### Features
37
51
 
38
- * update contexts and namespaces ([#32](https://github.com/twinfoundation/blob-storage/issues/32)) ([187ed36](https://github.com/twinfoundation/blob-storage/commit/187ed36a7d83062665f70689ec5e2b2f553a592e))
52
+ * update contexts and namespaces ([#32](https://github.com/iotaledger/twin-blob-storage/issues/32)) ([187ed36](https://github.com/iotaledger/twin-blob-storage/commit/187ed36a7d83062665f70689ec5e2b2f553a592e))
39
53
 
40
- ## [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)
54
+ ## [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)
41
55
 
42
56
 
43
57
  ### Features
44
58
 
45
- * add compression support ([67d239b](https://github.com/twinfoundation/blob-storage/commit/67d239bca8321bd90bf4ff93167c564130309730))
46
- * add context id features ([#30](https://github.com/twinfoundation/blob-storage/issues/30)) ([fbf1c92](https://github.com/twinfoundation/blob-storage/commit/fbf1c9276424c841ef5ef3f4de8469ab3fba7e9c))
47
- * add validate-locales ([f20fcec](https://github.com/twinfoundation/blob-storage/commit/f20fceced91e39a0c9edb770b2e43ce944c92f3c))
48
- * additional encryption options on per item basis ([4b95a65](https://github.com/twinfoundation/blob-storage/commit/4b95a656d19e3b571cea905e36f29b679b13e1e8))
49
- * eslint migration to flat config ([e4239dd](https://github.com/twinfoundation/blob-storage/commit/e4239dd1c721955cff7f0357255d2bba15319972))
50
- * remove includeNodeIdentity flag ([13bc334](https://github.com/twinfoundation/blob-storage/commit/13bc33445b179879688af3c98e8be8a5609d3f46))
51
- * update dependencies ([56f0094](https://github.com/twinfoundation/blob-storage/commit/56f0094b68d8bd22864cd899ac1b61d95540f719))
52
- * update framework core ([ff339fe](https://github.com/twinfoundation/blob-storage/commit/ff339fe7e3f09ddff429907834bdf43617e9c05e))
53
- * update to support fully qualified data type names ([3297d69](https://github.com/twinfoundation/blob-storage/commit/3297d69d332058b0f0141002087f56ba230620e1))
54
- * update ts-to-schema generation ([03439c7](https://github.com/twinfoundation/blob-storage/commit/03439c726108bf645941290e41824c57a6a23de3))
55
- * use shared store mechanism ([#12](https://github.com/twinfoundation/blob-storage/issues/12)) ([cae8110](https://github.com/twinfoundation/blob-storage/commit/cae8110681847a1ac4fcac968b8196694e49c320))
56
- * use standard list json ld types ([d6bdfd6](https://github.com/twinfoundation/blob-storage/commit/d6bdfd68af47f70f3cc53658b4a12543497e1f48))
59
+ * add compression support ([67d239b](https://github.com/iotaledger/twin-blob-storage/commit/67d239bca8321bd90bf4ff93167c564130309730))
60
+ * add context id features ([#30](https://github.com/iotaledger/twin-blob-storage/issues/30)) ([fbf1c92](https://github.com/iotaledger/twin-blob-storage/commit/fbf1c9276424c841ef5ef3f4de8469ab3fba7e9c))
61
+ * add validate-locales ([f20fcec](https://github.com/iotaledger/twin-blob-storage/commit/f20fceced91e39a0c9edb770b2e43ce944c92f3c))
62
+ * additional encryption options on per item basis ([4b95a65](https://github.com/iotaledger/twin-blob-storage/commit/4b95a656d19e3b571cea905e36f29b679b13e1e8))
63
+ * eslint migration to flat config ([e4239dd](https://github.com/iotaledger/twin-blob-storage/commit/e4239dd1c721955cff7f0357255d2bba15319972))
64
+ * remove includeNodeIdentity flag ([13bc334](https://github.com/iotaledger/twin-blob-storage/commit/13bc33445b179879688af3c98e8be8a5609d3f46))
65
+ * update dependencies ([56f0094](https://github.com/iotaledger/twin-blob-storage/commit/56f0094b68d8bd22864cd899ac1b61d95540f719))
66
+ * update framework core ([ff339fe](https://github.com/iotaledger/twin-blob-storage/commit/ff339fe7e3f09ddff429907834bdf43617e9c05e))
67
+ * update to support fully qualified data type names ([3297d69](https://github.com/iotaledger/twin-blob-storage/commit/3297d69d332058b0f0141002087f56ba230620e1))
68
+ * update ts-to-schema generation ([03439c7](https://github.com/iotaledger/twin-blob-storage/commit/03439c726108bf645941290e41824c57a6a23de3))
69
+ * use shared store mechanism ([#12](https://github.com/iotaledger/twin-blob-storage/issues/12)) ([cae8110](https://github.com/iotaledger/twin-blob-storage/commit/cae8110681847a1ac4fcac968b8196694e49c320))
70
+ * use standard list json ld types ([d6bdfd6](https://github.com/iotaledger/twin-blob-storage/commit/d6bdfd68af47f70f3cc53658b4a12543497e1f48))
57
71
 
58
72
 
59
73
  ### Bug Fixes
60
74
 
61
- * 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))
62
- * query params force coercion ([a5e547a](https://github.com/twinfoundation/blob-storage/commit/a5e547a775f8997cb04780938c7a9561ddb048d1))
75
+ * 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))
76
+ * query params force coercion ([a5e547a](https://github.com/iotaledger/twin-blob-storage/commit/a5e547a775f8997cb04780938c7a9561ddb048d1))
63
77
 
64
- ## [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)
78
+ ## [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)
65
79
 
66
80
 
67
81
  ### Features
68
82
 
69
- * add validate-locales ([f20fcec](https://github.com/twinfoundation/blob-storage/commit/f20fceced91e39a0c9edb770b2e43ce944c92f3c))
83
+ * add validate-locales ([f20fcec](https://github.com/iotaledger/twin-blob-storage/commit/f20fceced91e39a0c9edb770b2e43ce944c92f3c))
70
84
 
71
- ## [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)
85
+ ## [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)
72
86
 
73
87
 
74
88
  ### Miscellaneous Chores
75
89
 
76
90
  * **blob-storage-models:** Synchronize repo versions
77
91
 
78
- ## [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)
92
+ ## [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)
79
93
 
80
94
 
81
95
  ### Features
82
96
 
83
- * eslint migration to flat config ([e4239dd](https://github.com/twinfoundation/blob-storage/commit/e4239dd1c721955cff7f0357255d2bba15319972))
97
+ * eslint migration to flat config ([e4239dd](https://github.com/iotaledger/twin-blob-storage/commit/e4239dd1c721955cff7f0357255d2bba15319972))
84
98
 
85
- ## [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)
99
+ ## [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)
86
100
 
87
101
 
88
102
  ### Features
89
103
 
90
- * update framework core ([ff339fe](https://github.com/twinfoundation/blob-storage/commit/ff339fe7e3f09ddff429907834bdf43617e9c05e))
104
+ * update framework core ([ff339fe](https://github.com/iotaledger/twin-blob-storage/commit/ff339fe7e3f09ddff429907834bdf43617e9c05e))
91
105
 
92
- ## [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)
106
+ ## [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)
93
107
 
94
108
 
95
109
  ### Features
96
110
 
97
- * add compression support ([67d239b](https://github.com/twinfoundation/blob-storage/commit/67d239bca8321bd90bf4ff93167c564130309730))
98
- * additional encryption options on per item basis ([4b95a65](https://github.com/twinfoundation/blob-storage/commit/4b95a656d19e3b571cea905e36f29b679b13e1e8))
99
- * remove includeNodeIdentity flag ([13bc334](https://github.com/twinfoundation/blob-storage/commit/13bc33445b179879688af3c98e8be8a5609d3f46))
100
- * update dependencies ([56f0094](https://github.com/twinfoundation/blob-storage/commit/56f0094b68d8bd22864cd899ac1b61d95540f719))
101
- * update to support fully qualified data type names ([3297d69](https://github.com/twinfoundation/blob-storage/commit/3297d69d332058b0f0141002087f56ba230620e1))
102
- * update ts-to-schema generation ([03439c7](https://github.com/twinfoundation/blob-storage/commit/03439c726108bf645941290e41824c57a6a23de3))
103
- * use shared store mechanism ([#12](https://github.com/twinfoundation/blob-storage/issues/12)) ([cae8110](https://github.com/twinfoundation/blob-storage/commit/cae8110681847a1ac4fcac968b8196694e49c320))
104
- * use standard list json ld types ([d6bdfd6](https://github.com/twinfoundation/blob-storage/commit/d6bdfd68af47f70f3cc53658b4a12543497e1f48))
111
+ * add compression support ([67d239b](https://github.com/iotaledger/twin-blob-storage/commit/67d239bca8321bd90bf4ff93167c564130309730))
112
+ * additional encryption options on per item basis ([4b95a65](https://github.com/iotaledger/twin-blob-storage/commit/4b95a656d19e3b571cea905e36f29b679b13e1e8))
113
+ * remove includeNodeIdentity flag ([13bc334](https://github.com/iotaledger/twin-blob-storage/commit/13bc33445b179879688af3c98e8be8a5609d3f46))
114
+ * update dependencies ([56f0094](https://github.com/iotaledger/twin-blob-storage/commit/56f0094b68d8bd22864cd899ac1b61d95540f719))
115
+ * update to support fully qualified data type names ([3297d69](https://github.com/iotaledger/twin-blob-storage/commit/3297d69d332058b0f0141002087f56ba230620e1))
116
+ * update ts-to-schema generation ([03439c7](https://github.com/iotaledger/twin-blob-storage/commit/03439c726108bf645941290e41824c57a6a23de3))
117
+ * use shared store mechanism ([#12](https://github.com/iotaledger/twin-blob-storage/issues/12)) ([cae8110](https://github.com/iotaledger/twin-blob-storage/commit/cae8110681847a1ac4fcac968b8196694e49c320))
118
+ * use standard list json ld types ([d6bdfd6](https://github.com/iotaledger/twin-blob-storage/commit/d6bdfd68af47f70f3cc53658b4a12543497e1f48))
105
119
 
106
120
 
107
121
  ### Bug Fixes
108
122
 
109
- * 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))
110
- * query params force coercion ([a5e547a](https://github.com/twinfoundation/blob-storage/commit/a5e547a775f8997cb04780938c7a9561ddb048d1))
123
+ * 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))
124
+ * query params force coercion ([a5e547a](https://github.com/iotaledger/twin-blob-storage/commit/a5e547a775f8997cb04780938c7a9561ddb048d1))
111
125
 
112
126
  ## 0.0.1 (2025-07-04)
113
127
 
114
128
 
115
129
  ### Features
116
130
 
117
- * release to production ([eacfe75](https://github.com/twinfoundation/blob-storage/commit/eacfe754a0dcd9243d9e13d86422327d0a605164))
131
+ * release to production ([eacfe75](https://github.com/iotaledger/twin-blob-storage/commit/eacfe754a0dcd9243d9e13d86422327d0a605164))
118
132
 
119
- ## [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)
133
+ ## [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)
120
134
 
121
135
 
122
136
  ### Bug Fixes
123
137
 
124
- * query params force coercion ([a5e547a](https://github.com/twinfoundation/blob-storage/commit/a5e547a775f8997cb04780938c7a9561ddb048d1))
138
+ * query params force coercion ([a5e547a](https://github.com/iotaledger/twin-blob-storage/commit/a5e547a775f8997cb04780938c7a9561ddb048d1))
125
139
 
126
- ## [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)
140
+ ## [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)
127
141
 
128
142
 
129
143
  ### Features
130
144
 
131
- * add compression support ([67d239b](https://github.com/twinfoundation/blob-storage/commit/67d239bca8321bd90bf4ff93167c564130309730))
145
+ * add compression support ([67d239b](https://github.com/iotaledger/twin-blob-storage/commit/67d239bca8321bd90bf4ff93167c564130309730))
132
146
 
133
- ## [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)
147
+ ## [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)
134
148
 
135
149
 
136
150
  ### Features
137
151
 
138
- * additional encryption options on per item basis ([4b95a65](https://github.com/twinfoundation/blob-storage/commit/4b95a656d19e3b571cea905e36f29b679b13e1e8))
152
+ * additional encryption options on per item basis ([4b95a65](https://github.com/iotaledger/twin-blob-storage/commit/4b95a656d19e3b571cea905e36f29b679b13e1e8))
139
153
 
140
- ## [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)
154
+ ## [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)
141
155
 
142
156
 
143
157
  ### Features
144
158
 
145
- * update dependencies ([56f0094](https://github.com/twinfoundation/blob-storage/commit/56f0094b68d8bd22864cd899ac1b61d95540f719))
159
+ * update dependencies ([56f0094](https://github.com/iotaledger/twin-blob-storage/commit/56f0094b68d8bd22864cd899ac1b61d95540f719))
146
160
 
147
- ## [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)
161
+ ## [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)
148
162
 
149
163
 
150
164
  ### Features
151
165
 
152
- * update ts-to-schema generation ([03439c7](https://github.com/twinfoundation/blob-storage/commit/03439c726108bf645941290e41824c57a6a23de3))
166
+ * update ts-to-schema generation ([03439c7](https://github.com/iotaledger/twin-blob-storage/commit/03439c726108bf645941290e41824c57a6a23de3))
153
167
 
154
- ## [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)
168
+ ## [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)
155
169
 
156
170
 
157
171
  ### Features
158
172
 
159
- * update to support fully qualified data type names ([3297d69](https://github.com/twinfoundation/blob-storage/commit/3297d69d332058b0f0141002087f56ba230620e1))
173
+ * update to support fully qualified data type names ([3297d69](https://github.com/iotaledger/twin-blob-storage/commit/3297d69d332058b0f0141002087f56ba230620e1))
160
174
 
161
- ## [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)
175
+ ## [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)
162
176
 
163
177
 
164
178
  ### Features
165
179
 
166
- * use standard list json ld types ([d6bdfd6](https://github.com/twinfoundation/blob-storage/commit/d6bdfd68af47f70f3cc53658b4a12543497e1f48))
180
+ * use standard list json ld types ([d6bdfd6](https://github.com/iotaledger/twin-blob-storage/commit/d6bdfd68af47f70f3cc53658b4a12543497e1f48))
167
181
 
168
- ## [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)
182
+ ## [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)
169
183
 
170
184
 
171
185
  ### Features
172
186
 
173
- * use shared store mechanism ([#12](https://github.com/twinfoundation/blob-storage/issues/12)) ([cae8110](https://github.com/twinfoundation/blob-storage/commit/cae8110681847a1ac4fcac968b8196694e49c320))
187
+ * use shared store mechanism ([#12](https://github.com/iotaledger/twin-blob-storage/issues/12)) ([cae8110](https://github.com/iotaledger/twin-blob-storage/commit/cae8110681847a1ac4fcac968b8196694e49c320))
174
188
 
175
- ## [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)
189
+ ## [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)
176
190
 
177
191
 
178
192
  ### Bug Fixes
179
193
 
180
- * 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))
194
+ * 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))
181
195
 
182
196
  ## v0.0.1-next.28
183
197
 
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.6",
4
- "description": "Models which define the structure of the blob storage contracts and connectors",
3
+ "version": "0.0.3-next.8",
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
  }