@twin.org/blob-storage-service 0.0.1-next.9 → 0.0.1

package/dist/types/blobStorageRoutes.d.ts

@@ -1,5 +1,5 @@
-import type { ICreatedResponse, IHttpRequestContext, INoContentResponse, IRestRoute, IRestRouteResponseOptions, ITag } from "@twin.org/api-models";
-import type { IBlobStorageCreateRequest, IBlobStorageGetContentRequest, IBlobStorageGetContentResponse, IBlobStorageGetRequest, IBlobStorageGetResponse, IBlobStorageRemoveRequest, IBlobStorageUpdateRequest } from "@twin.org/blob-storage-models";
+import { type ICreatedResponse, type IHttpRequestContext, type INoContentResponse, type IRestRoute, type IRestRouteResponseOptions, type ITag } from "@twin.org/api-models";
+import { type IBlobStorageCreateRequest, type IBlobStorageGetContentRequest, type IBlobStorageGetContentResponse, type IBlobStorageGetRequest, type IBlobStorageGetResponse, type IBlobStorageListRequest, type IBlobStorageListResponse, type IBlobStorageRemoveRequest, type IBlobStorageUpdateRequest } from "@twin.org/blob-storage-models";
 /**
  * The tag to associate with the routes.
  */
@@ -57,3 +57,11 @@ export declare function blobStorageUpdate(httpRequestContext: IHttpRequestContex
  * @returns The response object with additional http response properties.
  */
 export declare function blobStorageRemove(httpRequestContext: IHttpRequestContext, componentName: string, request: IBlobStorageRemoveRequest): Promise<INoContentResponse>;
+/**
+ * List the entries from blob storage.
+ * @param httpRequestContext The request context for the API.
+ * @param componentName The name of the component to use in the routes.
+ * @param request The request.
+ * @returns The response object with additional http response properties.
+ */
+export declare function blobStorageList(httpRequestContext: IHttpRequestContext, componentName: string, request: IBlobStorageListRequest): Promise<IBlobStorageListResponse>;

package/dist/types/blobStorageService.d.ts

@@ -1,6 +1,7 @@
-import { type IBlobStorageComponent } from "@twin.org/blob-storage-models";
+import { type BlobStorageCompressionType, type IBlobStorageComponent, type IBlobStorageEntry, type IBlobStorageEntryList } from "@twin.org/blob-storage-models";
 import { type IJsonLdNodeObject } from "@twin.org/data-json-ld";
-import type { IBlobStorageServiceConfig } from "./models/IBlobStorageServiceConfig";
+import { SortDirection, type EntityCondition } from "@twin.org/entity";
+import type { IBlobStorageServiceConstructorOptions } from "./models/IBlobStorageServiceConstructorOptions";
 /**
  * Service for performing blob storage operations to a connector.
  */
@@ -15,55 +16,59 @@ export declare class BlobStorageService implements IBlobStorageComponent {
     readonly CLASS_NAME: string;
     /**
      * Create a new instance of BlobStorageService.
-     * @param options The dependencies for the service.
-     * @param options.metadataEntityStorageType The type of the storage connector for the metadata, defaults to "blob-metadata".
-     * @param options.vaultConnectorType The type of the vault connector for encryption, if undefined no encryption will be performed.
-     * @param options.config The configuration for the service.
+     * @param options The options for the service.
      */
-    constructor(options?: {
-        metadataEntityStorageType?: string;
-        vaultConnectorType?: string;
-        config?: IBlobStorageServiceConfig;
-    });
+    constructor(options?: IBlobStorageServiceConstructorOptions);
     /**
      * Create the blob with some metadata.
      * @param blob The data for the blob in base64 format.
-     * @param mimeType Mime type for the blob, will be detected if left undefined.
-     * @param extension Extension for the blob, will be detected if left undefined.
+     * @param encodingFormat Mime type for the blob, will be detected if left undefined.
+     * @param fileExtension Extension for the blob, will be detected if left undefined.
      * @param metadata Data for the custom metadata as JSON-LD.
-     * @param namespace The namespace to use for storing, defaults to component configured namespace.
+     * @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.
      * @returns The id of the stored blob in urn format.
      */
-    create(blob: string, mimeType?: string, extension?: string, metadata?: IJsonLdNodeObject, namespace?: string, userIdentity?: string, nodeIdentity?: string): Promise<string>;
+    create(blob: string, encodingFormat?: string, fileExtension?: string, metadata?: IJsonLdNodeObject, options?: {
+        disableEncryption?: boolean;
+        overrideVaultKeyId?: string;
+        compress?: BlobStorageCompressionType;
+        namespace?: string;
+    }, userIdentity?: string, nodeIdentity?: string): Promise<string>;
     /**
-     * Get the blob and metadata.
+     * Get the blob entry.
      * @param id The id of the blob to get in urn format.
-     * @param includeContent Include the content, or just get the metadata.
+     * @param options Optional options for the retrieval of the blob.
+     * @param options.includeContent Include the content, or just get the metadata.
+     * @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 metadata and data for the blob if it can be found.
+     * @returns The entry and data for the blob if it can be found.
      * @throws Not found error if the blob cannot be found.
      */
-    get(id: string, includeContent: boolean, userIdentity?: string, nodeIdentity?: string): Promise<{
-        blob?: string;
-        mimeType?: string;
-        extension?: string;
-        metadata?: IJsonLdNodeObject;
-    }>;
+    get(id: string, options?: {
+        includeContent?: boolean;
+        decompress?: boolean;
+        overrideVaultKeyId?: string;
+    }, userIdentity?: string, nodeIdentity?: string): Promise<IBlobStorageEntry>;
     /**
      * Update the blob with metadata.
-     * @param id The id of the blob metadata to update.
-     * @param mimeType Mime type for the blob, will be detected if left undefined.
-     * @param extension Extension for the blob, will be detected if left undefined.
+     * @param id The id of the blob entry to update.
+     * @param encodingFormat Mime type for the blob, will be detected if left undefined.
+     * @param fileExtension Extension for the blob, will be detected if left undefined.
      * @param metadata Data for the custom metadata as JSON-LD.
      * @param userIdentity The user identity to use with storage operations.
      * @param nodeIdentity The node identity to use with storage operations.
      * @returns Nothing.
      * @throws Not found error if the blob cannot be found.
      */
-    update(id: string, mimeType?: string, extension?: string, metadata?: IJsonLdNodeObject, userIdentity?: string, nodeIdentity?: string): Promise<void>;
+    update(id: string, encodingFormat?: string, fileExtension?: string, metadata?: IJsonLdNodeObject, userIdentity?: string, nodeIdentity?: string): Promise<void>;
     /**
      * Remove the blob.
      * @param id The id of the blob to remove in urn format.
@@ -72,4 +77,17 @@ export declare class BlobStorageService implements IBlobStorageComponent {
      * @returns Nothing.
      */
     remove(id: string, userIdentity?: string, nodeIdentity?: string): Promise<void>;
+    /**
+     * Query all the blob storage entries which match the conditions.
+     * @param conditions The conditions to match for the entries.
+     * @param orderBy The order for the results, defaults to created.
+     * @param orderByDirection The direction for the order, defaults to descending.
+     * @param cursor The cursor to request the next page of entries.
+     * @param pageSize The suggested number of entries to return in each chunk, in some scenarios can return a different amount.
+     * @param userIdentity The user identity to use with storage operations.
+     * @param nodeIdentity The node identity to use with storage operations.
+     * @returns All the entries for the storage matching the conditions,
+     * and a cursor which can be used to request more entities.
+     */
+    query(conditions?: EntityCondition<IBlobStorageEntry>, orderBy?: keyof Pick<IBlobStorageEntry, "dateCreated" | "dateModified">, orderByDirection?: SortDirection, cursor?: string, pageSize?: number, userIdentity?: string, nodeIdentity?: string): Promise<IBlobStorageEntryList>;
 }

package/dist/types/entities/blobStorageEntry.d.ts

@@ -0,0 +1,55 @@
+import type { BlobStorageCompressionType } from "@twin.org/blob-storage-models";
+import type { IJsonLdNodeObject } from "@twin.org/data-json-ld";
+/**
+ * Class representing entry for the blob storage.
+ */
+export declare class BlobStorageEntry {
+    /**
+     * The id for the blob.
+     */
+    id: string;
+    /**
+     * The date/time when the entry was created.
+     */
+    dateCreated: string;
+    /**
+     * The date/time when the entry was modified.
+     */
+    dateModified?: string;
+    /**
+     * The length of the data in the blob.
+     */
+    blobSize: number;
+    /**
+     * The hash of the data in the blob.
+     */
+    blobHash: string;
+    /**
+     * The mime type for the blob.
+     */
+    encodingFormat?: string;
+    /**
+     * The extension.
+     */
+    fileExtension?: string;
+    /**
+     * The metadata for the blob as JSON-LD.
+     */
+    metadata?: IJsonLdNodeObject;
+    /**
+     * Is the entry encrypted.
+     */
+    isEncrypted: boolean;
+    /**
+     * Is the entry compressed.
+     */
+    compression?: BlobStorageCompressionType;
+    /**
+     * The user identity that created the blob.
+     */
+    userIdentity?: string;
+    /**
+     * The node identity that created the blob.
+     */
+    nodeIdentity?: string;
+}

package/dist/types/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./blobStorageRoutes";
 export * from "./blobStorageService";
-export * from "./entities/blobMetadata";
+export * from "./entities/blobStorageEntry";
 export * from "./models/IBlobStorageServiceConfig";
+export * from "./models/IBlobStorageServiceConstructorOptions";
 export * from "./restEntryPoints";
 export * from "./schema";

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

@@ -3,8 +3,7 @@
  */
 export interface IBlobStorageServiceConfig {
     /**
-     * The name of the vault key to use for encryption if the service has a vault connector configured.
-     * @default blob-storage.
+     * The name of the vault key to use for encryption, if not configured no encryption will happen.
      */
     vaultKeyId?: string;
     /**

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

@@ -0,0 +1,19 @@
+import type { IBlobStorageServiceConfig } from "./IBlobStorageServiceConfig";
+/**
+ * Options for the Blob Storage Service constructor.
+ */
+export interface IBlobStorageServiceConstructorOptions {
+    /**
+     * The type of the storage connector for the metadata.
+     * @default blob-storage-entry
+     */
+    entryEntityStorageType?: string;
+    /**
+     * The type of the vault connector for encryption.
+     */
+    vaultConnectorType?: string;
+    /**
+     * The configuration for the service.
+     */
+    config?: IBlobStorageServiceConfig;
+}

package/docs/changelog.md

@@ -1,5 +1,165 @@
 # @twin.org/blob-storage-service - Changelog
 
-## v0.0.1-next.9
+## 0.0.1 (2025-07-04)
+
+
+### Features
+
+* release to production ([eacfe75](https://github.com/twinfoundation/blob-storage/commit/eacfe754a0dcd9243d9e13d86422327d0a605164))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/blob-storage-models bumped from ^0.0.0 to ^0.0.1
+  * devDependencies
+    * @twin.org/blob-storage-connector-memory bumped from ^0.0.0 to ^0.0.1
+
+## [0.0.1-next.37](https://github.com/twinfoundation/blob-storage/compare/blob-storage-service-v0.0.1-next.36...blob-storage-service-v0.0.1-next.37) (2025-06-20)
+
+
+### Bug Fixes
+
+* query params force coercion ([a5e547a](https://github.com/twinfoundation/blob-storage/commit/a5e547a775f8997cb04780938c7a9561ddb048d1))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/blob-storage-models bumped from 0.0.1-next.36 to 0.0.1-next.37
+  * devDependencies
+    * @twin.org/blob-storage-connector-memory bumped from 0.0.1-next.36 to 0.0.1-next.37
+
+## [0.0.1-next.36](https://github.com/twinfoundation/blob-storage/compare/blob-storage-service-v0.0.1-next.35...blob-storage-service-v0.0.1-next.36) (2025-06-19)
+
+
+### Features
+
+* add compression support ([67d239b](https://github.com/twinfoundation/blob-storage/commit/67d239bca8321bd90bf4ff93167c564130309730))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/blob-storage-models bumped from 0.0.1-next.35 to 0.0.1-next.36
+  * devDependencies
+    * @twin.org/blob-storage-connector-memory bumped from 0.0.1-next.35 to 0.0.1-next.36
+
+## [0.0.1-next.35](https://github.com/twinfoundation/blob-storage/compare/blob-storage-service-v0.0.1-next.34...blob-storage-service-v0.0.1-next.35) (2025-06-17)
+
+
+### Features
+
+* additional encryption options on per item basis ([4b95a65](https://github.com/twinfoundation/blob-storage/commit/4b95a656d19e3b571cea905e36f29b679b13e1e8))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/blob-storage-models bumped from 0.0.1-next.34 to 0.0.1-next.35
+  * devDependencies
+    * @twin.org/blob-storage-connector-memory bumped from 0.0.1-next.34 to 0.0.1-next.35
+
+## [0.0.1-next.34](https://github.com/twinfoundation/blob-storage/compare/blob-storage-service-v0.0.1-next.33...blob-storage-service-v0.0.1-next.34) (2025-06-12)
+
+
+### Features
+
+* update dependencies ([56f0094](https://github.com/twinfoundation/blob-storage/commit/56f0094b68d8bd22864cd899ac1b61d95540f719))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/blob-storage-models bumped from 0.0.1-next.33 to 0.0.1-next.34
+  * devDependencies
+    * @twin.org/blob-storage-connector-memory bumped from 0.0.1-next.33 to 0.0.1-next.34
+
+## [0.0.1-next.33](https://github.com/twinfoundation/blob-storage/compare/blob-storage-service-v0.0.1-next.32...blob-storage-service-v0.0.1-next.33) (2025-06-03)
+
+
+### Miscellaneous Chores
+
+* **blob-storage-service:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/blob-storage-models bumped from 0.0.1-next.32 to 0.0.1-next.33
+  * devDependencies
+    * @twin.org/blob-storage-connector-memory bumped from 0.0.1-next.32 to 0.0.1-next.33
+
+## [0.0.1-next.32](https://github.com/twinfoundation/blob-storage/compare/blob-storage-service-v0.0.1-next.31...blob-storage-service-v0.0.1-next.32) (2025-05-28)
+
+
+### Features
+
+* update to support fully qualified data type names ([3297d69](https://github.com/twinfoundation/blob-storage/commit/3297d69d332058b0f0141002087f56ba230620e1))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/blob-storage-models bumped from 0.0.1-next.31 to 0.0.1-next.32
+  * devDependencies
+    * @twin.org/blob-storage-connector-memory bumped from 0.0.1-next.31 to 0.0.1-next.32
+
+## [0.0.1-next.31](https://github.com/twinfoundation/blob-storage/compare/blob-storage-service-v0.0.1-next.30...blob-storage-service-v0.0.1-next.31) (2025-05-08)
+
+
+### Features
+
+* use standard list json ld types ([d6bdfd6](https://github.com/twinfoundation/blob-storage/commit/d6bdfd68af47f70f3cc53658b4a12543497e1f48))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/blob-storage-models bumped from 0.0.1-next.30 to 0.0.1-next.31
+  * devDependencies
+    * @twin.org/blob-storage-connector-memory bumped from 0.0.1-next.30 to 0.0.1-next.31
+
+## [0.0.1-next.30](https://github.com/twinfoundation/blob-storage/compare/blob-storage-service-v0.0.1-next.29...blob-storage-service-v0.0.1-next.30) (2025-04-17)
+
+
+### Features
+
+* use shared store mechanism ([#12](https://github.com/twinfoundation/blob-storage/issues/12)) ([cae8110](https://github.com/twinfoundation/blob-storage/commit/cae8110681847a1ac4fcac968b8196694e49c320))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/blob-storage-models bumped from 0.0.1-next.29 to 0.0.1-next.30
+  * devDependencies
+    * @twin.org/blob-storage-connector-memory bumped from 0.0.1-next.29 to 0.0.1-next.30
+
+## [0.0.1-next.29](https://github.com/twinfoundation/blob-storage/compare/blob-storage-service-v0.0.1-next.28...blob-storage-service-v0.0.1-next.29) (2025-03-28)
+
+
+### Bug Fixes
+
+* 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))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/blob-storage-models bumped from 0.0.1-next.28 to 0.0.1-next.29
+  * devDependencies
+    * @twin.org/blob-storage-connector-memory bumped from 0.0.1-next.28 to 0.0.1-next.29
+
+## v0.0.1-next.28
 
 - Initial Release