@twin.org/blob-storage-models 0.0.1-next.35 → 0.0.1-next.36

package/dist/cjs/index.cjs

@@ -30,7 +30,26 @@ const BlobStorageTypes = {
     /**
      * Represents blob storage entry.
      */
-    Entry: "BlobStorageEntry"
+    Entry: "BlobStorageEntry",
+    /**
+     * Represents blob storage entry compression.
+     */
+    CompressionType: "BlobStorageCompressionType"
+};
+
+var $schema$1 = "https://json-schema.org/draft/2020-12/schema";
+var $id$1 = "https://schema.twindev.org/blob-storage/BlobStorageCompressionType";
+var description$1 = "The types of compression for blob storage data.";
+var type$1 = "string";
+var BlobStorageCompressionTypeSchema = {
+	$schema: $schema$1,
+	$id: $id$1,
+	description: description$1,
+	type: type$1,
+	"enum": [
+	"gzip",
+	"deflate"
+]
 };
 
 var $schema = "https://json-schema.org/draft/2020-12/schema";
@@ -89,6 +108,10 @@ var properties = {
 		type: "boolean",
 		description: "Indicates if the blob is encrypted."
 	},
+	compression: {
+		$ref: "https://schema.twindev.org/blob-storage/BlobStorageCompressionType",
+		description: "The type of compression used for the blob, if not set it is not stored with compression."
+	},
 	fileExtension: {
 		type: "string",
 		description: "The extension."
@@ -137,6 +160,12 @@ class BlobStorageDataTypes {
             defaultValue: {},
             jsonSchema: async () => BlobStorageEntrySchema
         }));
+        dataCore.DataTypeHandlerFactory.register(`${BlobStorageContexts.ContextRoot}${BlobStorageTypes.CompressionType}`, () => ({
+            context: BlobStorageContexts.ContextRoot,
+            type: BlobStorageTypes.CompressionType,
+            defaultValue: {},
+            jsonSchema: async () => BlobStorageCompressionTypeSchema
+        }));
     }
 }
 
@@ -148,6 +177,24 @@ class BlobStorageDataTypes {
 // eslint-disable-next-line @typescript-eslint/naming-convention
 const BlobStorageConnectorFactory = core.Factory.createFactory("blob-storage");
 
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * The types of compression for blob storage data.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const BlobStorageCompressionType = {
+    /**
+     * Gzip.
+     */
+    Gzip: "gzip",
+    /**
+     * Deflate.
+     */
+    Deflate: "deflate"
+};
+
+exports.BlobStorageCompressionType = BlobStorageCompressionType;
 exports.BlobStorageConnectorFactory = BlobStorageConnectorFactory;
 exports.BlobStorageContexts = BlobStorageContexts;
 exports.BlobStorageDataTypes = BlobStorageDataTypes;

package/dist/esm/index.mjs

@@ -28,7 +28,26 @@ const BlobStorageTypes = {
     /**
      * Represents blob storage entry.
      */
-    Entry: "BlobStorageEntry"
+    Entry: "BlobStorageEntry",
+    /**
+     * Represents blob storage entry compression.
+     */
+    CompressionType: "BlobStorageCompressionType"
+};
+
+var $schema$1 = "https://json-schema.org/draft/2020-12/schema";
+var $id$1 = "https://schema.twindev.org/blob-storage/BlobStorageCompressionType";
+var description$1 = "The types of compression for blob storage data.";
+var type$1 = "string";
+var BlobStorageCompressionTypeSchema = {
+	$schema: $schema$1,
+	$id: $id$1,
+	description: description$1,
+	type: type$1,
+	"enum": [
+	"gzip",
+	"deflate"
+]
 };
 
 var $schema = "https://json-schema.org/draft/2020-12/schema";
@@ -87,6 +106,10 @@ var properties = {
 		type: "boolean",
 		description: "Indicates if the blob is encrypted."
 	},
+	compression: {
+		$ref: "https://schema.twindev.org/blob-storage/BlobStorageCompressionType",
+		description: "The type of compression used for the blob, if not set it is not stored with compression."
+	},
 	fileExtension: {
 		type: "string",
 		description: "The extension."
@@ -135,6 +158,12 @@ class BlobStorageDataTypes {
             defaultValue: {},
             jsonSchema: async () => BlobStorageEntrySchema
         }));
+        DataTypeHandlerFactory.register(`${BlobStorageContexts.ContextRoot}${BlobStorageTypes.CompressionType}`, () => ({
+            context: BlobStorageContexts.ContextRoot,
+            type: BlobStorageTypes.CompressionType,
+            defaultValue: {},
+            jsonSchema: async () => BlobStorageCompressionTypeSchema
+        }));
     }
 }
 
@@ -146,4 +175,21 @@ class BlobStorageDataTypes {
 // eslint-disable-next-line @typescript-eslint/naming-convention
 const BlobStorageConnectorFactory = Factory.createFactory("blob-storage");
 
-export { BlobStorageConnectorFactory, BlobStorageContexts, BlobStorageDataTypes, BlobStorageTypes };
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * The types of compression for blob storage data.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const BlobStorageCompressionType = {
+    /**
+     * Gzip.
+     */
+    Gzip: "gzip",
+    /**
+     * Deflate.
+     */
+    Deflate: "deflate"
+};
+
+export { BlobStorageCompressionType, BlobStorageConnectorFactory, BlobStorageContexts, BlobStorageDataTypes, BlobStorageTypes };

package/dist/types/index.d.ts

@@ -9,6 +9,7 @@ export * from "./models/api/IBlobStorageListRequest";
 export * from "./models/api/IBlobStorageListResponse";
 export * from "./models/api/IBlobStorageRemoveRequest";
 export * from "./models/api/IBlobStorageUpdateRequest";
+export * from "./models/blobStorageCompressionType";
 export * from "./models/blobStorageContexts";
 export * from "./models/blobStorageTypes";
 export * from "./models/IBlobStorageComponent";

package/dist/types/models/IBlobStorageComponent.d.ts

@@ -1,6 +1,7 @@
 import type { IComponent } from "@twin.org/core";
 import type { IJsonLdNodeObject } from "@twin.org/data-json-ld";
 import type { EntityCondition, SortDirection } from "@twin.org/entity";
+import type { BlobStorageCompressionType } from "./blobStorageCompressionType";
 import type { IBlobStorageEntry } from "./IBlobStorageEntry";
 import type { IBlobStorageEntryList } from "./IBlobStorageEntryList";
 /**
@@ -16,6 +17,7 @@ export interface IBlobStorageComponent extends IComponent {
      * @param options Optional options for the creation of the blob.
      * @param options.disableEncryption Disables encryption if enabled by default.
      * @param options.overrideVaultKeyId Use a different vault key id for encryption, if not provided the default vault key id will be used.
+     * @param options.compress Optional compression type to use for the blob, defaults to no compression.
      * @param options.namespace The namespace to use for storing, defaults to component configured namespace.
      * @param userIdentity The user identity to use with storage operations.
      * @param nodeIdentity The node identity to use with storage operations.
@@ -24,6 +26,7 @@ export interface IBlobStorageComponent extends IComponent {
     create(blob: string, encodingFormat?: string, fileExtension?: string, metadata?: IJsonLdNodeObject, options?: {
         disableEncryption?: boolean;
         overrideVaultKeyId?: string;
+        compress?: BlobStorageCompressionType;
         namespace?: string;
     }, userIdentity?: string, nodeIdentity?: string): Promise<string>;
     /**
@@ -31,8 +34,8 @@ export interface IBlobStorageComponent extends IComponent {
      * @param id The id of the blob to get in urn format.
      * @param options Optional options for the retrieval of the blob.
      * @param options.includeContent Include the content, or just get the metadata.
-     * @param options.disableDecryption Disables decryption if enabled by default.
      * @param options.overrideVaultKeyId Use a different vault key id for decryption, if not provided the default vault key id will be used.
+     * @param options.decompress If the content should be decompressed, if it was compressed when stored, defaults to true.
      * @param userIdentity The user identity to use with storage operations.
      * @param nodeIdentity The node identity to use with storage operations.
      * @returns The data and metadata for the blob if it can be found.
@@ -40,7 +43,7 @@ export interface IBlobStorageComponent extends IComponent {
      */
     get(id: string, options?: {
         includeContent?: boolean;
-        disableDecryption?: boolean;
+        decompress?: boolean;
         overrideVaultKeyId?: string;
     }, userIdentity?: string, nodeIdentity?: string): Promise<IBlobStorageEntry>;
     /**

package/dist/types/models/IBlobStorageEntry.d.ts

@@ -1,4 +1,5 @@
 import type { IJsonLdContextDefinitionElement, IJsonLdNodeObject } from "@twin.org/data-json-ld";
+import type { BlobStorageCompressionType } from "./blobStorageCompressionType";
 import type { BlobStorageContexts } from "./blobStorageContexts";
 import type { BlobStorageTypes } from "./blobStorageTypes";
 /**
@@ -45,6 +46,10 @@ export interface IBlobStorageEntry {
      * Indicates if the blob is encrypted.
      */
     isEncrypted?: boolean;
+    /**
+     * The type of compression used for the blob, if not set it is not stored with compression.
+     */
+    compression?: BlobStorageCompressionType;
     /**
      * The extension.
      */

package/dist/types/models/api/IBlobStorageCreateRequest.d.ts

@@ -1,4 +1,5 @@
 import type { IJsonLdNodeObject } from "@twin.org/data-json-ld";
+import type { BlobStorageCompressionType } from "../blobStorageCompressionType";
 /**
  * Request to create an entry in blob storage.
  */
@@ -28,6 +29,10 @@ export interface IBlobStorageCreateRequest {
          * @default false
          */
         disableEncryption?: boolean;
+        /**
+         * Optional compression type to use for the blob, defaults to no compression.
+         */
+        compress?: BlobStorageCompressionType;
         /**
          * Use a different vault key id for encryption, if not provided the default vault key id will be used.
          * @default undefined

package/dist/types/models/api/IBlobStorageGetContentRequest.d.ts

@@ -16,10 +16,10 @@ export interface IBlobStorageGetContentRequest {
      */
     query?: {
         /**
-         * Disables decryption if enabled by default.
-         * @default false
+         * If the content should be decompressed, if it was compressed when stored, defaults to true.
+         * @default true
          */
-        disableDecryption?: string;
+        decompress?: string;
         /**
          * Use a different vault key id for decryption, if not provided the default vault key id will be used.
          * @default undefined

package/dist/types/models/api/IBlobStorageGetRequest.d.ts

@@ -28,10 +28,10 @@ export interface IBlobStorageGetRequest {
          */
         includeContent?: string;
         /**
-         * Disables decryption if enabled by default.
-         * @default false
+         * If the content should be decompressed, if it was compressed when stored, defaults to true.
+         * @default true
          */
-        disableDecryption?: string;
+        decompress?: string;
         /**
          * Use a different vault key id for decryption, if not provided the default vault key id will be used.
          * @default undefined

package/dist/types/models/api/IBlobStorageUpdateRequest.d.ts

@@ -28,15 +28,5 @@ export interface IBlobStorageUpdateRequest {
          * Custom metadata to associate with the blob as JSON-LD.
          */
         metadata?: IJsonLdNodeObject;
-        /**
-         * Disables encryption if enabled by default.
-         * @default false
-         */
-        disableEncryption?: boolean;
-        /**
-         * Use a different vault key id for encryption, if not provided the default vault key id will be used.
-         * @default undefined
-         */
-        overrideVaultKeyId?: string;
     };
 }

package/dist/types/models/blobStorageCompressionType.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The types of compression for blob storage data.
+ */
+export declare const BlobStorageCompressionType: {
+    /**
+     * Gzip.
+     */
+    readonly Gzip: "gzip";
+    /**
+     * Deflate.
+     */
+    readonly Deflate: "deflate";
+};
+/**
+ * The types of compression for blob storage data.
+ */
+export type BlobStorageCompressionType = (typeof BlobStorageCompressionType)[keyof typeof BlobStorageCompressionType];

package/dist/types/models/blobStorageTypes.d.ts

@@ -6,6 +6,10 @@ export declare const BlobStorageTypes: {
      * Represents blob storage entry.
      */
     readonly Entry: "BlobStorageEntry";
+    /**
+     * Represents blob storage entry compression.
+     */
+    readonly CompressionType: "BlobStorageCompressionType";
 };
 /**
  * The types of blob storage data.

package/docs/changelog.md

@@ -1,5 +1,12 @@
 # @twin.org/blob-storage-models - Changelog
 
+## [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)
+
+
+### Features
+
+* add compression support ([67d239b](https://github.com/twinfoundation/blob-storage/commit/67d239bca8321bd90bf4ff93167c564130309730))
+
 ## [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)
 
 

package/docs/reference/index.md

@@ -22,11 +22,13 @@
 
 ## Type Aliases
 
+- [BlobStorageCompressionType](type-aliases/BlobStorageCompressionType.md)
 - [BlobStorageContexts](type-aliases/BlobStorageContexts.md)
 - [BlobStorageTypes](type-aliases/BlobStorageTypes.md)
 
 ## Variables
 
 - [BlobStorageConnectorFactory](variables/BlobStorageConnectorFactory.md)
+- [BlobStorageCompressionType](variables/BlobStorageCompressionType.md)
 - [BlobStorageContexts](variables/BlobStorageContexts.md)
 - [BlobStorageTypes](variables/BlobStorageTypes.md)

package/docs/reference/interfaces/IBlobStorageComponent.md

@@ -56,6 +56,12 @@ Disables encryption if enabled by default.
 
 Use a different vault key id for encryption, if not provided the default vault key id will be used.
 
+###### compress?
+
+[`BlobStorageCompressionType`](../type-aliases/BlobStorageCompressionType.md)
+
+Optional compression type to use for the blob, defaults to no compression.
+
 ###### namespace?
 
 `string`
@@ -106,11 +112,11 @@ Optional options for the retrieval of the blob.
 
 Include the content, or just get the metadata.
 
-###### disableDecryption?
+###### decompress?
 
 `boolean`
 
-Disables decryption if enabled by default.
+If the content should be decompressed, if it was compressed when stored, defaults to true.
 
 ###### overrideVaultKeyId?
 

package/docs/reference/interfaces/IBlobStorageCreateRequest.md

@@ -46,6 +46,12 @@ Disables encryption if enabled by default.
 false
 ```
 
+#### compress?
+
+> `optional` **compress**: [`BlobStorageCompressionType`](../type-aliases/BlobStorageCompressionType.md)
+
+Optional compression type to use for the blob, defaults to no compression.
+
 #### overrideVaultKeyId?
 
 > `optional` **overrideVaultKeyId**: `string`

package/docs/reference/interfaces/IBlobStorageEntry.md

@@ -76,6 +76,14 @@ Indicates if the blob is encrypted.
 
 ***
 
+### compression?
+
+> `optional` **compression**: [`BlobStorageCompressionType`](../type-aliases/BlobStorageCompressionType.md)
+
+The type of compression used for the blob, if not set it is not stored with compression.
+
+***
+
 ### fileExtension?
 
 > `optional` **fileExtension**: `string`

package/docs/reference/interfaces/IBlobStorageGetContentRequest.md

@@ -24,16 +24,16 @@ The id of the blob to get in urn format.
 
 The query parameters.
 
-#### disableDecryption?
+#### decompress?
 
-> `optional` **disableDecryption**: `string`
+> `optional` **decompress**: `string`
 
-Disables decryption if enabled by default.
+If the content should be decompressed, if it was compressed when stored, defaults to true.
 
 ##### Default
 
 ```ts
-false
+true
 ```
 
 #### overrideVaultKeyId?

package/docs/reference/interfaces/IBlobStorageGetRequest.md

@@ -48,16 +48,16 @@ Include the content in the response, otherwise only metadata is returned.
 false
 ```
 
-#### disableDecryption?
+#### decompress?
 
-> `optional` **disableDecryption**: `string`
+> `optional` **decompress**: `string`
 
-Disables decryption if enabled by default.
+If the content should be decompressed, if it was compressed when stored, defaults to true.
 
 ##### Default
 
 ```ts
-false
+true
 ```
 
 #### overrideVaultKeyId?

package/docs/reference/interfaces/IBlobStorageUpdateRequest.md

@@ -41,27 +41,3 @@ The extension of the blob, will be detected if left undefined.
 > `optional` **metadata**: `IJsonLdNodeObject`
 
 Custom metadata to associate with the blob as JSON-LD.
-
-#### disableEncryption?
-
-> `optional` **disableEncryption**: `boolean`
-
-Disables encryption if enabled by default.
-
-##### Default
-
-```ts
-false
-```
-
-#### overrideVaultKeyId?
-
-> `optional` **overrideVaultKeyId**: `string`
-
-Use a different vault key id for encryption, if not provided the default vault key id will be used.
-
-##### Default
-
-```ts
-undefined
-```

package/docs/reference/type-aliases/BlobStorageCompressionType.md

@@ -0,0 +1,5 @@
+# Type Alias: BlobStorageCompressionType
+
+> **BlobStorageCompressionType** = *typeof* [`BlobStorageCompressionType`](../variables/BlobStorageCompressionType.md)\[keyof *typeof* [`BlobStorageCompressionType`](../variables/BlobStorageCompressionType.md)\]
+
+The types of compression for blob storage data.

package/docs/reference/variables/BlobStorageCompressionType.md

@@ -0,0 +1,19 @@
+# Variable: BlobStorageCompressionType
+
+> `const` **BlobStorageCompressionType**: `object`
+
+The types of compression for blob storage data.
+
+## Type declaration
+
+### Gzip
+
+> `readonly` **Gzip**: `"gzip"` = `"gzip"`
+
+Gzip.
+
+### Deflate
+
+> `readonly` **Deflate**: `"deflate"` = `"deflate"`
+
+Deflate.

package/docs/reference/variables/BlobStorageTypes.md

@@ -11,3 +11,9 @@ The types of blob storage data.
 > `readonly` **Entry**: `"BlobStorageEntry"` = `"BlobStorageEntry"`
 
 Represents blob storage entry.
+
+### CompressionType
+
+> `readonly` **CompressionType**: `"BlobStorageCompressionType"` = `"BlobStorageCompressionType"`
+
+Represents blob storage entry compression.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/blob-storage-models",
-	"version": "0.0.1-next.35",
+	"version": "0.0.1-next.36",
 	"description": "Models which define the structure of the blob storage contracts and connectors",
 	"repository": {
 		"type": "git",