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

package/dist/cjs/index.cjs

@@ -1,13 +1,18 @@
 'use strict';
 
+var apiModels = require('@twin.org/api-models');
+var blobStorageModels = require('@twin.org/blob-storage-models');
 var core = require('@twin.org/core');
+var standardsSchemaOrg = require('@twin.org/standards-schema-org');
 var web = require('@twin.org/web');
-var blobStorageModels = require('@twin.org/blob-storage-models');
+var crypto = require('@twin.org/crypto');
 var dataJsonLd = require('@twin.org/data-json-ld');
 var entity = require('@twin.org/entity');
 var entityStorageModels = require('@twin.org/entity-storage-models');
 var vaultModels = require('@twin.org/vault-models');
 
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
 /**
  * The source used when communicating about these routes.
  */
@@ -50,7 +55,7 @@ function generateRestRoutesBlobStorage(baseRouteName, componentName, options) {
                         body: {
                             blob: "VGhlIHF1aWNrIGJyb3duIGZveCBqdW1wcyBvdmVyIHRoZSBsYXp5IGRvZw==",
                             metadata: {
-                                "@context": "http://schema.org/",
+                                "@context": "https://schema.org",
                                 "@type": "DigitalDocument",
                                 name: "myfile.pdf"
                             }
@@ -93,7 +98,7 @@ function generateRestRoutesBlobStorage(baseRouteName, componentName, options) {
                             id: "blob-memory:c57d94b088f4c6d2cb32ded014813d0c786aa00134c8ee22f84b1e2545602a70"
                         },
                         query: {
-                            includeContent: true
+                            includeContent: "true"
                         }
                     }
                 }
@@ -107,8 +112,51 @@ function generateRestRoutesBlobStorage(baseRouteName, componentName, options) {
                         id: `${camelTypeName}GetResponseExample`,
                         response: {
                             body: {
+                                "@context": [
+                                    blobStorageModels.BlobStorageContexts.ContextRoot,
+                                    blobStorageModels.BlobStorageContexts.ContextRootCommon,
+                                    standardsSchemaOrg.SchemaOrgContexts.ContextRoot
+                                ],
+                                type: blobStorageModels.BlobStorageTypes.Entry,
+                                id: "blob-memory:c57d94b088f4c6d2cb32ded014813d0c786aa00134c8ee22f84b1e2545602a70",
+                                dateCreated: "2024-01-01T00:00:00Z",
+                                encodingFormat: web.MimeTypes.Pdf,
+                                blobSize: 42,
+                                blobHash: "sha256:c57d94b088f4c6d2cb32ded014813d0c786aa00134c8ee22f84b1e2545602a70",
+                                fileExtension: "pdf",
                                 metadata: {
-                                    "@context": "http://schema.org/",
+                                    "@context": "https://schema.org",
+                                    "@type": "DigitalDocument",
+                                    name: "myfile.pdf"
+                                },
+                                blob: "VGhlIHF1aWNrIGJyb3duIGZveCBqdW1wcyBvdmVyIHRoZSBsYXp5IGRvZw=="
+                            }
+                        }
+                    }
+                ]
+            },
+            {
+                type: "IBlobStorageGetResponse",
+                mimeType: web.MimeTypes.JsonLd,
+                examples: [
+                    {
+                        id: `${camelTypeName}GetResponseJsonLdExample`,
+                        response: {
+                            body: {
+                                "@context": [
+                                    blobStorageModels.BlobStorageContexts.ContextRoot,
+                                    blobStorageModels.BlobStorageContexts.ContextRootCommon,
+                                    standardsSchemaOrg.SchemaOrgContexts.ContextRoot
+                                ],
+                                type: blobStorageModels.BlobStorageTypes.Entry,
+                                id: "blob-memory:c57d94b088f4c6d2cb32ded014813d0c786aa00134c8ee22f84b1e2545602a70",
+                                dateCreated: "2024-01-01T00:00:00Z",
+                                encodingFormat: web.MimeTypes.Pdf,
+                                blobSize: 42,
+                                blobHash: "sha256:c57d94b088f4c6d2cb32ded014813d0c786aa00134c8ee22f84b1e2545602a70",
+                                fileExtension: "pdf",
+                                metadata: {
+                                    "@context": "https://schema.org",
                                     "@type": "DigitalDocument",
                                     name: "myfile.pdf"
                                 },
@@ -140,7 +188,7 @@ function generateRestRoutesBlobStorage(baseRouteName, componentName, options) {
                             id: "blob-memory:c57d94b088f4c6d2cb32ded014813d0c786aa00134c8ee22f84b1e2545602a70"
                         },
                         query: {
-                            download: true,
+                            download: "true",
                             filename: "my-file.pdf"
                         }
                     }
@@ -154,7 +202,7 @@ function generateRestRoutesBlobStorage(baseRouteName, componentName, options) {
                 examples: [
                     {
                         id: `${camelTypeName}GetContentResponseExample`,
-                        description: `The content of the blob, which will be a specific mime type if one can be detected from the content (or set as mimeType in the metadata), or defaults to ${web.MimeTypes.OctetStream}.`,
+                        description: `The content of the blob, which will be a specific mime type if one can be detected from the content (or set as encodingFormat in the entry), or defaults to ${web.MimeTypes.OctetStream}.`,
                         response: {
                             body: new Uint8Array()
                         }
@@ -184,7 +232,7 @@ function generateRestRoutesBlobStorage(baseRouteName, componentName, options) {
                         },
                         body: {
                             metadata: {
-                                "@context": "http://schema.org/",
+                                "@context": "https://schema.org",
                                 "@type": "DigitalDocument",
                                 name: "myfile.pdf"
                             }
@@ -228,12 +276,116 @@ function generateRestRoutesBlobStorage(baseRouteName, componentName, options) {
             }
         ]
     };
+    const blobStorageListRoute = {
+        operationId: `${camelTypeName}Query`,
+        summary: `Query the items from ${lowerName}`,
+        tag: options?.tagName ?? tagsBlobStorage[0].name,
+        method: "GET",
+        path: `${baseRouteName}/`,
+        handler: async (httpRequestContext, request) => blobStorageList(httpRequestContext, componentName, request),
+        requestType: {
+            type: "IBlobStorageListRequest",
+            examples: [
+                {
+                    id: `${camelTypeName}ListRequestExample`,
+                    request: {}
+                }
+            ]
+        },
+        responseType: [
+            {
+                type: "IBlobStorageListResponse",
+                examples: [
+                    {
+                        id: `${camelTypeName}ListResponseExample`,
+                        response: {
+                            body: {
+                                "@context": [
+                                    standardsSchemaOrg.SchemaOrgContexts.ContextRoot,
+                                    blobStorageModels.BlobStorageContexts.ContextRoot,
+                                    blobStorageModels.BlobStorageContexts.ContextRootCommon
+                                ],
+                                type: standardsSchemaOrg.SchemaOrgTypes.ItemList,
+                                [standardsSchemaOrg.SchemaOrgTypes.ItemListElement]: [
+                                    {
+                                        "@context": [
+                                            blobStorageModels.BlobStorageContexts.ContextRoot,
+                                            blobStorageModels.BlobStorageContexts.ContextRootCommon,
+                                            standardsSchemaOrg.SchemaOrgContexts.ContextRoot
+                                        ],
+                                        type: blobStorageModels.BlobStorageTypes.Entry,
+                                        id: "blob-memory:c57d94b088f4c6d2cb32ded014813d0c786aa00134c8ee22f84b1e2545602a70",
+                                        dateCreated: "2024-01-01T00:00:00Z",
+                                        encodingFormat: web.MimeTypes.Pdf,
+                                        blobSize: 42,
+                                        blobHash: "sha256:c57d94b088f4c6d2cb32ded014813d0c786aa00134c8ee22f84b1e2545602a70",
+                                        fileExtension: "pdf",
+                                        metadata: {
+                                            "@context": "https://schema.org",
+                                            "@type": "DigitalDocument",
+                                            name: "myfile.pdf"
+                                        },
+                                        blob: "VGhlIHF1aWNrIGJyb3duIGZveCBqdW1wcyBvdmVyIHRoZSBsYXp5IGRvZw=="
+                                    }
+                                ]
+                            }
+                        }
+                    }
+                ]
+            },
+            {
+                type: "IBlobStorageListResponse",
+                mimeType: web.MimeTypes.JsonLd,
+                examples: [
+                    {
+                        id: `${camelTypeName}ListResponseJsonLdExample`,
+                        response: {
+                            body: {
+                                "@context": [
+                                    standardsSchemaOrg.SchemaOrgContexts.ContextRoot,
+                                    blobStorageModels.BlobStorageContexts.ContextRoot,
+                                    blobStorageModels.BlobStorageContexts.ContextRootCommon
+                                ],
+                                type: standardsSchemaOrg.SchemaOrgTypes.ItemList,
+                                [standardsSchemaOrg.SchemaOrgTypes.ItemListElement]: [
+                                    {
+                                        "@context": [
+                                            blobStorageModels.BlobStorageContexts.ContextRoot,
+                                            blobStorageModels.BlobStorageContexts.ContextRootCommon,
+                                            standardsSchemaOrg.SchemaOrgContexts.ContextRoot
+                                        ],
+                                        type: blobStorageModels.BlobStorageTypes.Entry,
+                                        id: "blob-memory:c57d94b088f4c6d2cb32ded014813d0c786aa00134c8ee22f84b1e2545602a70",
+                                        dateCreated: "2024-01-01T00:00:00Z",
+                                        encodingFormat: web.MimeTypes.Pdf,
+                                        blobSize: 42,
+                                        blobHash: "sha256:c57d94b088f4c6d2cb32ded014813d0c786aa00134c8ee22f84b1e2545602a70",
+                                        fileExtension: "pdf",
+                                        metadata: {
+                                            "@context": "https://schema.org",
+                                            "@type": "DigitalDocument",
+                                            name: "myfile.pdf"
+                                        },
+                                        blob: "VGhlIHF1aWNrIGJyb3duIGZveCBqdW1wcyBvdmVyIHRoZSBsYXp5IGRvZw=="
+                                    }
+                                ]
+                            }
+                        }
+                    }
+                ]
+            },
+            {
+                type: "INotFoundResponse"
+            }
+        ]
+    };
     return [
         blobStorageCreateRoute,
         blobStorageGetRoute,
         blobStorageGetContentRoute,
         blobStorageUpdateRoute,
-        blobStorageRemoveRoute
+        blobStorageRemoveRoute,
+        blobStorageListRoute
     ];
 }
 /**
@@ -248,7 +400,11 @@ async function blobStorageCreate(httpRequestContext, componentName, request) {
     core.Guards.object(ROUTES_SOURCE, "request.body", request.body);
     core.Guards.stringBase64(ROUTES_SOURCE, "request.body.blob", request.body.blob);
     const component = core.ComponentFactory.get(componentName);
-    const id = await component.create(request.body.blob, request.body.mimeType, request.body.extension, request.body.metadata, request.body.namespace, httpRequestContext.nodeIdentity);
+    const id = await component.create(request.body.blob, request.body.encodingFormat, request.body.fileExtension, request.body.metadata, {
+        disableEncryption: request.body.disableEncryption,
+        overrideVaultKeyId: request.body.overrideVaultKeyId,
+        namespace: request.body.namespace
+    }, httpRequestContext.userIdentity, httpRequestContext.nodeIdentity);
     return {
         statusCode: web.HttpStatusCode.created,
         headers: {
@@ -267,9 +423,17 @@ async function blobStorageGet(httpRequestContext, componentName, request) {
     core.Guards.object(ROUTES_SOURCE, "request", request);
     core.Guards.object(ROUTES_SOURCE, "request.pathParams", request.pathParams);
     core.Guards.stringValue(ROUTES_SOURCE, "request.pathParams.id", request.pathParams.id);
+    const mimeType = request.headers?.[web.HeaderTypes.Accept] === web.MimeTypes.JsonLd ? "jsonld" : "json";
     const component = core.ComponentFactory.get(componentName);
-    const result = await component.get(request.pathParams.id, request.query?.includeContent ?? false, httpRequestContext.userIdentity, httpRequestContext.nodeIdentity);
+    const result = await component.get(request.pathParams.id, {
+        includeContent: core.Coerce.boolean(request.query?.includeContent),
+        decompress: core.Coerce.boolean(request.query?.decompress),
+        overrideVaultKeyId: request.query?.overrideVaultKeyId
+    }, httpRequestContext.userIdentity, httpRequestContext.nodeIdentity);
     return {
+        headers: {
+            [web.HeaderTypes.ContentType]: mimeType === "json" ? web.MimeTypes.Json : web.MimeTypes.JsonLd
+        },
         body: result
     };
 }
@@ -285,18 +449,34 @@ async function blobStorageGetContent(httpRequestContext, componentName, request)
     core.Guards.object(ROUTES_SOURCE, "request.pathParams", request.pathParams);
     core.Guards.stringValue(ROUTES_SOURCE, "request.pathParams.id", request.pathParams.id);
     const component = core.ComponentFactory.get(componentName);
-    const result = await component.get(request.pathParams.id, true, httpRequestContext.userIdentity, httpRequestContext.nodeIdentity);
-    const mimeType = result?.mimeType ?? web.MimeTypes.OctetStream;
+    const decompress = core.Coerce.boolean(request.query?.decompress);
+    const download = core.Coerce.boolean(request.query?.download) ?? false;
+    const result = await component.get(request.pathParams.id, {
+        includeContent: true,
+        decompress,
+        overrideVaultKeyId: request.query?.overrideVaultKeyId
+    }, httpRequestContext.userIdentity, httpRequestContext.nodeIdentity);
+    const encodingFormat = result?.encodingFormat ?? web.MimeTypes.OctetStream;
+    let compressedEncodingFormat;
+    let compressedExtension = "";
+    // If the entry is compressed and we are not decompressing
+    // we need to override the encoding format to the compressed type
+    // and append an additional extension to the filename.
+    if (result.compression && !decompress) {
+        compressedEncodingFormat =
+            result.compression === blobStorageModels.BlobStorageCompressionType.Gzip ? web.MimeTypes.Gzip : web.MimeTypes.Zlib;
+        compressedExtension = `.${web.MimeTypeHelper.defaultExtension(compressedEncodingFormat)}`;
+    }
     let filename = request.query?.filename;
     if (!core.Is.stringValue(filename)) {
-        filename = `file.${result.extension ?? web.MimeTypeHelper.defaultExtension(mimeType)}`;
+        filename = `file.${result.fileExtension ?? web.MimeTypeHelper.defaultExtension(encodingFormat)}${compressedExtension}`;
     }
     return {
         body: core.Is.stringBase64(result.blob) ? core.Converter.base64ToBytes(result.blob) : new Uint8Array(),
         attachment: {
-            mimeType,
+            mimeType: compressedEncodingFormat ?? encodingFormat,
             filename,
-            inline: !(request.query?.download ?? false)
+            inline: !download
         }
     };
 }
@@ -312,7 +492,7 @@ async function blobStorageUpdate(httpRequestContext, componentName, request) {
     core.Guards.object(ROUTES_SOURCE, "request.pathParams", request.pathParams);
     core.Guards.stringValue(ROUTES_SOURCE, "request.pathParams.id", request.pathParams.id);
     const component = core.ComponentFactory.get(componentName);
-    await component.update(request.pathParams.id, request.body.mimeType, request.body.extension, request.body.metadata, httpRequestContext.userIdentity, httpRequestContext.nodeIdentity);
+    await component.update(request.pathParams.id, request.body.encodingFormat, request.body.fileExtension, request.body.metadata, httpRequestContext.userIdentity, httpRequestContext.nodeIdentity);
     return {
         statusCode: web.HttpStatusCode.noContent
     };
@@ -334,6 +514,25 @@ async function blobStorageRemove(httpRequestContext, componentName, request) {
         statusCode: web.HttpStatusCode.noContent
     };
 }
+/**
+ * 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.
+ */
+async function blobStorageList(httpRequestContext, componentName, request) {
+    core.Guards.object(ROUTES_SOURCE, "request", request);
+    const mimeType = request.headers?.[web.HeaderTypes.Accept] === web.MimeTypes.JsonLd ? "jsonld" : "json";
+    const component = core.ComponentFactory.get(componentName);
+    const result = await component.query(apiModels.HttpParameterHelper.objectFromString(request.query?.conditions), request.query?.orderBy, request.query?.orderByDirection, request.query?.cursor, core.Coerce.number(request.query?.pageSize), httpRequestContext.userIdentity, httpRequestContext.nodeIdentity);
+    return {
+        headers: {
+            [web.HeaderTypes.ContentType]: mimeType === "json" ? web.MimeTypes.Json : web.MimeTypes.JsonLd
+        },
+        body: result
+    };
+}
 
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
@@ -359,7 +558,7 @@ class BlobStorageService {
      * The storage connector for the metadata.
      * @internal
      */
-    _metadataEntityStorage;
+    _entryEntityStorage;
     /**
      * The vault connector for the encryption, can be undefined if no encryption required.
      * @internal
@@ -382,86 +581,104 @@ class BlobStorageService {
     _includeUserIdentity;
     /**
      * 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) {
         const names = blobStorageModels.BlobStorageConnectorFactory.names();
         if (names.length === 0) {
             throw new core.GeneralError(this.CLASS_NAME, "noConnectors");
         }
-        this._metadataEntityStorage = entityStorageModels.EntityStorageConnectorFactory.get(options?.metadataEntityStorageType ?? "blob-metadata");
+        this._entryEntityStorage = entityStorageModels.EntityStorageConnectorFactory.get(options?.entryEntityStorageType ?? "blob-storage-entry");
         if (core.Is.stringValue(options?.vaultConnectorType)) {
-            this._vaultConnector = vaultModels.VaultConnectorFactory.getIfExists(options.vaultConnectorType);
+            this._vaultConnector = vaultModels.VaultConnectorFactory.get(options.vaultConnectorType);
         }
         this._defaultNamespace = options?.config?.defaultNamespace ?? names[0];
-        this._vaultKeyId = options?.config?.vaultKeyId ?? "blob-storage";
+        this._vaultKeyId = options?.config?.vaultKeyId;
         this._includeNodeIdentity = options?.config?.includeNodeIdentity ?? true;
         this._includeUserIdentity = options?.config?.includeUserIdentity ?? true;
+        standardsSchemaOrg.SchemaOrgDataTypes.registerRedirects();
     }
     /**
      * 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.
      */
-    async create(blob, mimeType, extension, metadata, namespace, userIdentity, nodeIdentity) {
+    async create(blob, encodingFormat, fileExtension, metadata, options, userIdentity, nodeIdentity) {
         core.Guards.stringBase64(this.CLASS_NAME, "blob", blob);
         if (this._includeUserIdentity) {
             core.Guards.stringValue(this.CLASS_NAME, "userIdentity", userIdentity);
         }
-        if (this._includeNodeIdentity || core.Is.notEmpty(this._vaultConnector)) {
+        const disableEncryption = options?.disableEncryption ?? false;
+        const vaultKeyId = options?.overrideVaultKeyId ?? this._vaultKeyId;
+        const encryptionEnabled = !disableEncryption && core.Is.stringValue(vaultKeyId);
+        if (this._includeNodeIdentity || encryptionEnabled) {
             core.Guards.stringValue(this.CLASS_NAME, "nodeIdentity", nodeIdentity);
         }
         try {
-            const connectorNamespace = namespace ?? this._defaultNamespace;
+            const connectorNamespace = options?.namespace ?? this._defaultNamespace;
             const blobStorageConnector = blobStorageModels.BlobStorageConnectorFactory.get(connectorNamespace);
             // Convert the base64 data into bytes
             let storeBlob = core.Converter.base64ToBytes(blob);
+            const blobSize = storeBlob.length;
             // See if we can detect the mime type and default extension for the data.
             // If not already supplied by the caller. We have to perform this operation
             // on the unencrypted data.
-            if (!core.Is.stringValue(mimeType)) {
-                mimeType = await web.MimeTypeHelper.detect(storeBlob);
+            if (!core.Is.stringValue(encodingFormat)) {
+                encodingFormat = await web.MimeTypeHelper.detect(storeBlob);
             }
-            if (!core.Is.stringValue(extension) && core.Is.stringValue(mimeType)) {
-                extension = await web.MimeTypeHelper.defaultExtension(mimeType);
+            if (!core.Is.stringValue(fileExtension) && core.Is.stringValue(encodingFormat)) {
+                fileExtension = await web.MimeTypeHelper.defaultExtension(encodingFormat);
             }
             if (core.Is.object(metadata)) {
                 const validationFailures = [];
                 dataJsonLd.JsonLdHelper.validate(metadata, validationFailures);
                 core.Validation.asValidationError(this.CLASS_NAME, "metadata", validationFailures);
             }
+            const blobHash = `sha256:${core.Converter.bytesToBase64(crypto.Sha256.sum256(storeBlob))}`;
+            if (!core.Is.empty(options?.compress)) {
+                storeBlob = await core.Compression.compress(storeBlob, options.compress);
+            }
             // If we have a vault connector then encrypt the data.
-            if (this._vaultConnector) {
-                storeBlob = await this._vaultConnector.encrypt(`${nodeIdentity}/${this._vaultKeyId}`, vaultModels.VaultEncryptionType.ChaCha20Poly1305, storeBlob);
+            if (encryptionEnabled) {
+                if (core.Is.empty(this._vaultConnector)) {
+                    throw new core.GeneralError(this.CLASS_NAME, "vaultConnectorNotConfigured");
+                }
+                storeBlob = await this._vaultConnector.encrypt(`${nodeIdentity}/${vaultKeyId}`, vaultModels.VaultEncryptionType.ChaCha20Poly1305, storeBlob);
             }
             // Set the blob in the storage connector, which may now be encrypted
             const blobId = await blobStorageConnector.set(storeBlob);
-            // Now store the metadata in entity storage
-            const blobMetadata = {
+            // Now store the entry in entity storage
+            const blobEntry = {
                 id: blobId,
-                mimeType,
-                extension,
-                metadata
+                dateCreated: new Date(Date.now()).toISOString(),
+                blobSize,
+                blobHash,
+                encodingFormat,
+                fileExtension,
+                metadata,
+                isEncrypted: encryptionEnabled,
+                compression: options?.compress
             };
             const conditions = [];
             if (this._includeUserIdentity) {
-                core.ObjectHelper.propertySet(blobMetadata, "userIdentity", userIdentity);
+                core.ObjectHelper.propertySet(blobEntry, "userIdentity", userIdentity);
                 conditions.push({ property: "userIdentity", value: userIdentity });
             }
             if (this._includeNodeIdentity) {
-                core.ObjectHelper.propertySet(blobMetadata, "nodeIdentity", nodeIdentity);
+                core.ObjectHelper.propertySet(blobEntry, "nodeIdentity", nodeIdentity);
                 conditions.push({ property: "nodeIdentity", value: nodeIdentity });
             }
-            await this._metadataEntityStorage.set(blobMetadata, conditions);
+            await this._entryEntityStorage.set(blobEntry, conditions);
             return blobId;
         }
         catch (error) {
@@ -469,16 +686,21 @@ class BlobStorageService {
         }
     }
     /**
-     * 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.
      */
-    async get(id, includeContent, userIdentity, nodeIdentity) {
+    async get(id, options, userIdentity, nodeIdentity) {
         core.Urn.guard(this.CLASS_NAME, "id", id);
+        const includeContent = options?.includeContent ?? false;
+        const vaultKeyId = options?.overrideVaultKeyId ?? this._vaultKeyId;
         const conditions = [];
         if (this._includeUserIdentity) {
             core.Guards.stringValue(this.CLASS_NAME, "userIdentity", userIdentity);
@@ -497,7 +719,7 @@ class BlobStorageService {
             });
         }
         try {
-            const blobMetadata = await this.internalGet(id, userIdentity, nodeIdentity);
+            const blobEntry = await this.internalGet(id, userIdentity, nodeIdentity);
             let returnBlob;
             if (includeContent) {
                 const blobStorageConnector = this.getConnector(id);
@@ -505,17 +727,20 @@ class BlobStorageService {
                 if (core.Is.undefined(returnBlob)) {
                     throw new core.NotFoundError(this.CLASS_NAME, "blobNotFound", id);
                 }
-                // If we have a vault connector then decrypt the data.
-                if (this._vaultConnector) {
-                    returnBlob = await this._vaultConnector.decrypt(`${nodeIdentity}/${this._vaultKeyId}`, vaultModels.VaultEncryptionType.ChaCha20Poly1305, returnBlob);
+                // If the data is encrypted then decrypt it.
+                const decryptionEnabled = blobEntry.isEncrypted && core.Is.stringValue(vaultKeyId);
+                if (decryptionEnabled) {
+                    if (core.Is.empty(this._vaultConnector)) {
+                        throw new core.GeneralError(this.CLASS_NAME, "vaultConnectorNotConfigured");
+                    }
+                    returnBlob = await this._vaultConnector.decrypt(`${nodeIdentity}/${vaultKeyId}`, vaultModels.VaultEncryptionType.ChaCha20Poly1305, returnBlob);
+                }
+                if (!core.Is.empty(blobEntry.compression) && (options?.decompress ?? true)) {
+                    returnBlob = await core.Compression.decompress(returnBlob, blobEntry.compression);
                 }
             }
-            return {
-                blob: core.Is.uint8Array(returnBlob) ? core.Converter.bytesToBase64(returnBlob) : undefined,
-                mimeType: blobMetadata?.mimeType,
-                extension: blobMetadata?.extension,
-                metadata: blobMetadata?.metadata
-            };
+            const jsonLd = this.entryToJsonLd(blobEntry, returnBlob);
+            return dataJsonLd.JsonLdProcessor.compact(jsonLd, jsonLd["@context"]);
         }
         catch (error) {
             throw new core.GeneralError(this.CLASS_NAME, "getFailed", undefined, error);
@@ -523,16 +748,16 @@ class BlobStorageService {
     }
     /**
      * 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.
      */
-    async update(id, mimeType, extension, metadata, userIdentity, nodeIdentity) {
+    async update(id, encodingFormat, fileExtension, metadata, userIdentity, nodeIdentity) {
         core.Urn.guard(this.CLASS_NAME, "id", id);
         if (this._includeUserIdentity) {
             core.Guards.stringValue(this.CLASS_NAME, "userIdentity", userIdentity);
@@ -541,8 +766,8 @@ class BlobStorageService {
             core.Guards.stringValue(this.CLASS_NAME, "nodeIdentity", nodeIdentity);
         }
         try {
-            const blobMetadata = await this._metadataEntityStorage.get(id);
-            if (core.Is.undefined(blobMetadata)) {
+            const blobEntry = await this._entryEntityStorage.get(id);
+            if (core.Is.undefined(blobEntry)) {
                 throw new core.NotFoundError(this.CLASS_NAME, "blobNotFound", id);
             }
             if (core.Is.object(metadata)) {
@@ -550,23 +775,29 @@ class BlobStorageService {
                 await dataJsonLd.JsonLdHelper.validate(metadata, validationFailures);
                 core.Validation.asValidationError(this.CLASS_NAME, "metadata", validationFailures);
             }
-            // Now store the metadata in entity storage
-            const updatedBlobMetadata = {
-                id: blobMetadata.id,
-                mimeType: mimeType ?? blobMetadata.mimeType,
-                extension: extension ?? blobMetadata.extension,
-                metadata: metadata ?? blobMetadata.metadata
+            // Now store the entry in entity storage
+            const updatedBlobEntry = {
+                id: blobEntry.id,
+                dateCreated: blobEntry.dateCreated,
+                dateModified: new Date(Date.now()).toISOString(),
+                blobSize: blobEntry.blobSize,
+                blobHash: blobEntry.blobHash,
+                encodingFormat: encodingFormat ?? blobEntry.encodingFormat,
+                fileExtension: fileExtension ?? blobEntry.fileExtension,
+                metadata: metadata ?? blobEntry.metadata,
+                isEncrypted: blobEntry.isEncrypted,
+                compression: blobEntry.compression
             };
             const conditions = [];
             if (this._includeUserIdentity) {
-                core.ObjectHelper.propertySet(updatedBlobMetadata, "userIdentity", userIdentity);
+                core.ObjectHelper.propertySet(updatedBlobEntry, "userIdentity", userIdentity);
                 conditions.push({ property: "userIdentity", value: userIdentity });
             }
             if (this._includeNodeIdentity) {
-                core.ObjectHelper.propertySet(updatedBlobMetadata, "nodeIdentity", nodeIdentity);
+                core.ObjectHelper.propertySet(updatedBlobEntry, "nodeIdentity", nodeIdentity);
                 conditions.push({ property: "nodeIdentity", value: nodeIdentity });
             }
-            await this._metadataEntityStorage.set(updatedBlobMetadata, conditions);
+            await this._entryEntityStorage.set(updatedBlobEntry, conditions);
         }
         catch (error) {
             throw new core.GeneralError(this.CLASS_NAME, "updateFailed", undefined, error);
@@ -596,7 +827,7 @@ class BlobStorageService {
             if (this._includeNodeIdentity) {
                 conditions.push({ property: "nodeIdentity", value: nodeIdentity });
             }
-            await this._metadataEntityStorage.remove(id, conditions);
+            await this._entryEntityStorage.remove(id, conditions);
             const removed = await blobStorageConnector.remove(id);
             if (!removed) {
                 throw new core.NotFoundError(this.CLASS_NAME, "blobNotFound", id);
@@ -606,6 +837,69 @@ class BlobStorageService {
             throw new core.GeneralError(this.CLASS_NAME, "removeFailed", undefined, error);
         }
     }
+    /**
+     * 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.
+     */
+    async query(conditions, orderBy, orderByDirection, cursor, pageSize, userIdentity, nodeIdentity) {
+        const finalConditions = {
+            conditions: [],
+            logicalOperator: entity.LogicalOperator.And
+        };
+        if (this._includeNodeIdentity) {
+            core.Guards.stringValue(this.CLASS_NAME, "nodeIdentity", nodeIdentity);
+            finalConditions.conditions.push({
+                property: "nodeIdentity",
+                comparison: entity.ComparisonOperator.Equals,
+                value: nodeIdentity
+            });
+        }
+        if (this._includeUserIdentity) {
+            core.Guards.stringValue(this.CLASS_NAME, "userIdentity", userIdentity);
+            finalConditions.conditions.push({
+                property: "userIdentity",
+                comparison: entity.ComparisonOperator.Equals,
+                value: userIdentity
+            });
+        }
+        if (!core.Is.empty(conditions)) {
+            finalConditions.conditions.push(conditions);
+        }
+        const orderProperty = orderBy ?? "dateCreated";
+        const orderDirection = orderByDirection ?? entity.SortDirection.Descending;
+        const result = await this._entryEntityStorage.query(finalConditions.conditions.length > 0 ? finalConditions : undefined, [
+            {
+                property: orderProperty,
+                sortDirection: orderDirection
+            }
+        ], undefined, cursor, pageSize);
+        let context = [
+            standardsSchemaOrg.SchemaOrgContexts.ContextRoot,
+            blobStorageModels.BlobStorageContexts.ContextRoot,
+            blobStorageModels.BlobStorageContexts.ContextRootCommon
+        ];
+        const entriesJsonLd = [];
+        for (const entry of result.entities) {
+            // The entries are never Partial as we don't allow custom property requests.
+            entriesJsonLd.push(this.entryToJsonLd(entry));
+            context = dataJsonLd.JsonLdProcessor.combineContexts(context, entry.metadata?.["@context"]);
+        }
+        const jsonLd = {
+            "@context": context,
+            type: standardsSchemaOrg.SchemaOrgTypes.ItemList,
+            [standardsSchemaOrg.SchemaOrgTypes.ItemListElement]: entriesJsonLd,
+            [standardsSchemaOrg.SchemaOrgTypes.NextItem]: result.cursor
+        };
+        return dataJsonLd.JsonLdProcessor.compact(jsonLd, jsonLd["@context"]);
+    }
     /**
      * Get the connector from the uri.
      * @param id The id of the blob storage item in urn format.
@@ -651,17 +945,17 @@ class BlobStorageService {
         }
         let entity$1;
         if (conditions.length === 0) {
-            entity$1 = await this._metadataEntityStorage.get(id);
+            entity$1 = await this._entryEntityStorage.get(id);
         }
         else {
-            const schema = this._metadataEntityStorage.getSchema();
+            const schema = this._entryEntityStorage.getSchema();
             const primaryKey = entity.EntitySchemaHelper.getPrimaryKey(schema);
             conditions.unshift({
                 property: primaryKey.property,
                 comparison: entity.ComparisonOperator.Equals,
                 value: id
             });
-            const results = await this._metadataEntityStorage.query({
+            const results = await this._entryEntityStorage.query({
                 conditions,
                 logicalOperator: entity.LogicalOperator.And
             }, undefined, undefined, undefined, 1);
@@ -670,32 +964,83 @@ class BlobStorageService {
         if (core.Is.empty(entity$1)) {
             throw new core.NotFoundError(this.CLASS_NAME, "entityNotFound", id);
         }
-        core.ObjectHelper.propertyDelete(entity$1, "nodeIdentity");
-        core.ObjectHelper.propertyDelete(entity$1, "userIdentity");
-        return entity$1;
+        return core.ObjectHelper.omit(entity$1, ["nodeIdentity", "userIdentity"]);
+    }
+    /**
+     * Convert the entry to JSON-LD.
+     * @param entry The entry to convert.
+     * @param blob The optional blob to return.
+     * @returns The JSON-LD representation of the entry.
+     * @internal
+     */
+    entryToJsonLd(entry, blob) {
+        const jsonLd = {
+            "@context": dataJsonLd.JsonLdProcessor.combineContexts([
+                blobStorageModels.BlobStorageContexts.ContextRoot,
+                blobStorageModels.BlobStorageContexts.ContextRootCommon,
+                standardsSchemaOrg.SchemaOrgContexts.ContextRoot
+            ], entry?.metadata?.["@context"]),
+            id: entry.id,
+            type: blobStorageModels.BlobStorageTypes.Entry,
+            dateCreated: entry.dateCreated,
+            dateModified: entry.dateModified,
+            blobSize: entry.blobSize,
+            blobHash: entry.blobHash,
+            encodingFormat: entry?.encodingFormat,
+            fileExtension: entry?.fileExtension,
+            metadata: entry?.metadata,
+            blob: core.Is.uint8Array(blob) ? core.Converter.bytesToBase64(blob) : undefined,
+            isEncrypted: entry.isEncrypted,
+            compression: entry.compression
+        };
+        return jsonLd;
     }
 }
 
 /**
- * Class representing metadata for the blob storage.
+ * Class representing entry for the blob storage.
  */
-exports.BlobMetadata = class BlobMetadata {
+exports.BlobStorageEntry = class BlobStorageEntry {
     /**
      * The id for the blob.
      */
     id;
+    /**
+     * The date/time when the entry was created.
+     */
+    dateCreated;
+    /**
+     * The date/time when the entry was modified.
+     */
+    dateModified;
+    /**
+     * The length of the data in the blob.
+     */
+    blobSize;
+    /**
+     * The hash of the data in the blob.
+     */
+    blobHash;
     /**
      * The mime type for the blob.
      */
-    mimeType;
+    encodingFormat;
     /**
      * The extension.
      */
-    extension;
+    fileExtension;
     /**
      * The metadata for the blob as JSON-LD.
      */
     metadata;
+    /**
+     * Is the entry encrypted.
+     */
+    isEncrypted;
+    /**
+     * Is the entry compressed.
+     */
+    compression;
     /**
      * The user identity that created the blob.
      */
@@ -708,30 +1053,59 @@ exports.BlobMetadata = class BlobMetadata {
 __decorate([
     entity.property({ type: "string", isPrimary: true }),
     __metadata("design:type", String)
-], exports.BlobMetadata.prototype, "id", void 0);
+], exports.BlobStorageEntry.prototype, "id", void 0);
 __decorate([
-    entity.property({ type: "string" }),
+    entity.property({ type: "string", format: "date-time", sortDirection: entity.SortDirection.Descending }),
     __metadata("design:type", String)
-], exports.BlobMetadata.prototype, "mimeType", void 0);
+], exports.BlobStorageEntry.prototype, "dateCreated", void 0);
+__decorate([
+    entity.property({
+        type: "string",
+        format: "date-time",
+        sortDirection: entity.SortDirection.Descending,
+        optional: true
+    }),
+    __metadata("design:type", String)
+], exports.BlobStorageEntry.prototype, "dateModified", void 0);
+__decorate([
+    entity.property({ type: "number" }),
+    __metadata("design:type", Number)
+], exports.BlobStorageEntry.prototype, "blobSize", void 0);
 __decorate([
     entity.property({ type: "string" }),
     __metadata("design:type", String)
-], exports.BlobMetadata.prototype, "extension", void 0);
+], exports.BlobStorageEntry.prototype, "blobHash", void 0);
+__decorate([
+    entity.property({ type: "string", optional: true }),
+    __metadata("design:type", String)
+], exports.BlobStorageEntry.prototype, "encodingFormat", void 0);
+__decorate([
+    entity.property({ type: "string", optional: true }),
+    __metadata("design:type", String)
+], exports.BlobStorageEntry.prototype, "fileExtension", void 0);
 __decorate([
-    entity.property({ type: "object", itemTypeRef: "IJsonLdNodeObject" }),
+    entity.property({ type: "object", itemTypeRef: "IJsonLdNodeObject", optional: true }),
     __metadata("design:type", Object)
-], exports.BlobMetadata.prototype, "metadata", void 0);
+], exports.BlobStorageEntry.prototype, "metadata", void 0);
 __decorate([
-    entity.property({ type: "string" }),
+    entity.property({ type: "boolean" }),
+    __metadata("design:type", Boolean)
+], exports.BlobStorageEntry.prototype, "isEncrypted", void 0);
+__decorate([
+    entity.property({ type: "string", optional: true }),
     __metadata("design:type", String)
-], exports.BlobMetadata.prototype, "userIdentity", void 0);
+], exports.BlobStorageEntry.prototype, "compression", void 0);
 __decorate([
-    entity.property({ type: "string" }),
+    entity.property({ type: "string", optional: true }),
+    __metadata("design:type", String)
+], exports.BlobStorageEntry.prototype, "userIdentity", void 0);
+__decorate([
+    entity.property({ type: "string", optional: true }),
     __metadata("design:type", String)
-], exports.BlobMetadata.prototype, "nodeIdentity", void 0);
-exports.BlobMetadata = __decorate([
+], exports.BlobStorageEntry.prototype, "nodeIdentity", void 0);
+exports.BlobStorageEntry = __decorate([
     entity.entity()
-], exports.BlobMetadata);
+], exports.BlobStorageEntry);
 
 /**
  * These are dummy entry points for the blob storage service.
@@ -753,13 +1127,14 @@ const restEntryPoints = [
  * Initialize the schema for the blob storage entities.
  */
 function initSchema() {
-    entity.EntitySchemaFactory.register("BlobMetadata", () => entity.EntitySchemaHelper.getSchema(exports.BlobMetadata));
+    entity.EntitySchemaFactory.register("BlobStorageEntry", () => entity.EntitySchemaHelper.getSchema(exports.BlobStorageEntry));
 }
 
 exports.BlobStorageService = BlobStorageService;
 exports.blobStorageCreate = blobStorageCreate;
 exports.blobStorageGet = blobStorageGet;
 exports.blobStorageGetContent = blobStorageGetContent;
+exports.blobStorageList = blobStorageList;
 exports.blobStorageRemove = blobStorageRemove;
 exports.blobStorageUpdate = blobStorageUpdate;
 exports.generateRestRoutesBlobStorage = generateRestRoutesBlobStorage;