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

package/dist/cjs/index.cjs

@@ -5,6 +5,7 @@ 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 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');
@@ -53,7 +54,7 @@ function generateRestRoutesBlobStorage(baseRouteName, componentName, options) {
                     request: {
                         body: {
                             blob: "VGhlIHF1aWNrIGJyb3duIGZveCBqdW1wcyBvdmVyIHRoZSBsYXp5IGRvZw==",
-                            metadata: {
+                            annotationObject: {
                                 "@context": "https://schema.org",
                                 "@type": "DigitalDocument",
                                 name: "myfile.pdf"
@@ -82,7 +83,7 @@ function generateRestRoutesBlobStorage(baseRouteName, componentName, options) {
     };
     const blobStorageGetRoute = {
         operationId: `${camelTypeName}Get`,
-        summary: `Get the metadata for an item from ${lowerName}`,
+        summary: `Get the annotation for an item from ${lowerName}`,
         tag: options?.tagName ?? tagsBlobStorage[0].name,
         method: "GET",
         path: `${baseRouteName}/:id`,
@@ -111,14 +112,19 @@ function generateRestRoutesBlobStorage(baseRouteName, componentName, options) {
                         id: `${camelTypeName}GetResponseExample`,
                         response: {
                             body: {
-                                "@context": [blobStorageModels.BlobStorageTypes.ContextRoot, standardsSchemaOrg.SchemaOrgTypes.ContextRoot],
+                                "@context": [
+                                    blobStorageModels.BlobStorageTypes.ContextRoot,
+                                    blobStorageModels.BlobStorageTypes.ContextRootCommon,
+                                    standardsSchemaOrg.SchemaOrgTypes.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: {
+                                annotationObject: {
                                     "@context": "https://schema.org",
                                     "@type": "DigitalDocument",
                                     name: "myfile.pdf"
@@ -137,14 +143,19 @@ function generateRestRoutesBlobStorage(baseRouteName, componentName, options) {
                         id: `${camelTypeName}GetResponseJsonLdExample`,
                         response: {
                             body: {
-                                "@context": [blobStorageModels.BlobStorageTypes.ContextRoot, standardsSchemaOrg.SchemaOrgTypes.ContextRoot],
+                                "@context": [
+                                    blobStorageModels.BlobStorageTypes.ContextRoot,
+                                    blobStorageModels.BlobStorageTypes.ContextRootCommon,
+                                    standardsSchemaOrg.SchemaOrgTypes.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: {
+                                annotationObject: {
                                     "@context": "https://schema.org",
                                     "@type": "DigitalDocument",
                                     name: "myfile.pdf"
@@ -205,7 +216,7 @@ function generateRestRoutesBlobStorage(baseRouteName, componentName, options) {
     };
     const blobStorageUpdateRoute = {
         operationId: `${camelTypeName}Update`,
-        summary: `Update the metadata for an item in ${lowerName}`,
+        summary: `Update the annotation for an item in ${lowerName}`,
         tag: options?.tagName ?? tagsBlobStorage[0].name,
         method: "PUT",
         path: `${baseRouteName}/:id`,
@@ -220,7 +231,7 @@ function generateRestRoutesBlobStorage(baseRouteName, componentName, options) {
                             id: "blob-memory:c57d94b088f4c6d2cb32ded014813d0c786aa00134c8ee22f84b1e2545602a70"
                         },
                         body: {
-                            metadata: {
+                            annotationObject: {
                                 "@context": "https://schema.org",
                                 "@type": "DigitalDocument",
                                 name: "myfile.pdf"
@@ -289,18 +300,23 @@ function generateRestRoutesBlobStorage(baseRouteName, componentName, options) {
                         id: `${camelTypeName}ListResponseExample`,
                         response: {
                             body: {
-                                "@context": [blobStorageModels.BlobStorageTypes.ContextRoot],
+                                "@context": [blobStorageModels.BlobStorageTypes.ContextRoot, blobStorageModels.BlobStorageTypes.ContextRootCommon],
                                 type: blobStorageModels.BlobStorageTypes.EntryList,
                                 entries: [
                                     {
-                                        "@context": [blobStorageModels.BlobStorageTypes.ContextRoot, standardsSchemaOrg.SchemaOrgTypes.ContextRoot],
+                                        "@context": [
+                                            blobStorageModels.BlobStorageTypes.ContextRoot,
+                                            blobStorageModels.BlobStorageTypes.ContextRootCommon,
+                                            standardsSchemaOrg.SchemaOrgTypes.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: {
+                                        annotationObject: {
                                             "@context": "https://schema.org",
                                             "@type": "DigitalDocument",
                                             name: "myfile.pdf"
@@ -321,18 +337,23 @@ function generateRestRoutesBlobStorage(baseRouteName, componentName, options) {
                         id: `${camelTypeName}ListResponseJsonLdExample`,
                         response: {
                             body: {
-                                "@context": [blobStorageModels.BlobStorageTypes.ContextRoot],
+                                "@context": [blobStorageModels.BlobStorageTypes.ContextRoot, blobStorageModels.BlobStorageTypes.ContextRootCommon],
                                 type: blobStorageModels.BlobStorageTypes.EntryList,
                                 entries: [
                                     {
-                                        "@context": [blobStorageModels.BlobStorageTypes.ContextRoot, standardsSchemaOrg.SchemaOrgTypes.ContextRoot],
+                                        "@context": [
+                                            blobStorageModels.BlobStorageTypes.ContextRoot,
+                                            blobStorageModels.BlobStorageTypes.ContextRootCommon,
+                                            standardsSchemaOrg.SchemaOrgTypes.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: {
+                                        annotationObject: {
                                             "@context": "https://schema.org",
                                             "@type": "DigitalDocument",
                                             name: "myfile.pdf"
@@ -371,7 +392,7 @@ 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.encodingFormat, request.body.fileExtension, request.body.metadata, request.body.namespace, httpRequestContext.userIdentity, httpRequestContext.nodeIdentity);
+    const id = await component.create(request.body.blob, request.body.encodingFormat, request.body.fileExtension, request.body.annotationObject, request.body.namespace, httpRequestContext.userIdentity, httpRequestContext.nodeIdentity);
     return {
         statusCode: web.HttpStatusCode.created,
         headers: {
@@ -428,7 +449,7 @@ async function blobStorageGetContent(httpRequestContext, componentName, request)
     };
 }
 /**
- * Update the blob storage metadata.
+ * Update the blob storage annotation.
  * @param httpRequestContext The request context for the API.
  * @param componentName The name of the component to use in the routes.
  * @param request The request.
@@ -439,7 +460,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.encodingFormat, request.body.fileExtension, request.body.metadata, httpRequestContext.userIdentity, httpRequestContext.nodeIdentity);
+    await component.update(request.pathParams.id, request.body.encodingFormat, request.body.fileExtension, request.body.annotationObject, httpRequestContext.userIdentity, httpRequestContext.nodeIdentity);
     return {
         statusCode: web.HttpStatusCode.noContent
     };
@@ -502,7 +523,7 @@ class BlobStorageService {
      */
     _defaultNamespace;
     /**
-     * The storage connector for the metadata.
+     * The storage connector for the annotation.
      * @internal
      */
     _entryEntityStorage;
@@ -546,17 +567,17 @@ class BlobStorageService {
         standardsSchemaOrg.SchemaOrgDataTypes.registerRedirects();
     }
     /**
-     * Create the blob with some metadata.
+     * Create the blob with some annotation.
      * @param blob The data for the blob in base64 format.
      * @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 annotationObject Data for the custom annotation as JSON-LD.
      * @param 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, encodingFormat, fileExtension, metadata, namespace, userIdentity, nodeIdentity) {
+    async create(blob, encodingFormat, fileExtension, annotationObject, namespace, userIdentity, nodeIdentity) {
         core.Guards.stringBase64(this.CLASS_NAME, "blob", blob);
         if (this._includeUserIdentity) {
             core.Guards.stringValue(this.CLASS_NAME, "userIdentity", userIdentity);
@@ -579,11 +600,12 @@ class BlobStorageService {
             if (!core.Is.stringValue(fileExtension) && core.Is.stringValue(encodingFormat)) {
                 fileExtension = await web.MimeTypeHelper.defaultExtension(encodingFormat);
             }
-            if (core.Is.object(metadata)) {
+            if (core.Is.object(annotationObject)) {
                 const validationFailures = [];
-                dataJsonLd.JsonLdHelper.validate(metadata, validationFailures);
-                core.Validation.asValidationError(this.CLASS_NAME, "metadata", validationFailures);
+                dataJsonLd.JsonLdHelper.validate(annotationObject, validationFailures);
+                core.Validation.asValidationError(this.CLASS_NAME, "annotationObject", validationFailures);
             }
+            const blobHash = `sha256:${core.Converter.bytesToBase64(crypto.Sha256.sum256(storeBlob))}`;
             // 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);
@@ -595,9 +617,10 @@ class BlobStorageService {
                 id: blobId,
                 dateCreated: new Date(Date.now()).toISOString(),
                 blobSize,
+                blobHash,
                 encodingFormat,
                 fileExtension,
-                metadata
+                annotationObject
             };
             const conditions = [];
             if (this._includeUserIdentity) {
@@ -618,7 +641,7 @@ class BlobStorageService {
     /**
      * 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 includeContent Include the content, or just get the annotation.
      * @param userIdentity The user identity to use with storage operations.
      * @param nodeIdentity The node identity to use with storage operations.
      * @returns The entry and data for the blob if it can be found.
@@ -658,25 +681,24 @@ class BlobStorageService {
                 }
             }
             const jsonLd = this.entryToJsonLd(blobEntry, returnBlob);
-            const compacted = await dataJsonLd.JsonLdProcessor.compact(jsonLd, jsonLd["@context"]);
-            return compacted;
+            return dataJsonLd.JsonLdProcessor.compact(jsonLd, jsonLd["@context"]);
         }
         catch (error) {
             throw new core.GeneralError(this.CLASS_NAME, "getFailed", undefined, error);
         }
     }
     /**
-     * Update the blob with metadata.
+     * Update the blob with annotation.
      * @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 annotationObject Data for the custom annotation 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, encodingFormat, fileExtension, metadata, userIdentity, nodeIdentity) {
+    async update(id, encodingFormat, fileExtension, annotationObject, userIdentity, nodeIdentity) {
         core.Urn.guard(this.CLASS_NAME, "id", id);
         if (this._includeUserIdentity) {
             core.Guards.stringValue(this.CLASS_NAME, "userIdentity", userIdentity);
@@ -689,10 +711,10 @@ class BlobStorageService {
             if (core.Is.undefined(blobEntry)) {
                 throw new core.NotFoundError(this.CLASS_NAME, "blobNotFound", id);
             }
-            if (core.Is.object(metadata)) {
+            if (core.Is.object(annotationObject)) {
                 const validationFailures = [];
-                await dataJsonLd.JsonLdHelper.validate(metadata, validationFailures);
-                core.Validation.asValidationError(this.CLASS_NAME, "metadata", validationFailures);
+                await dataJsonLd.JsonLdHelper.validate(annotationObject, validationFailures);
+                core.Validation.asValidationError(this.CLASS_NAME, "annotationObject", validationFailures);
             }
             // Now store the entry in entity storage
             const updatedBlobEntry = {
@@ -700,9 +722,10 @@ class BlobStorageService {
                 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
+                annotationObject: annotationObject ?? blobEntry.annotationObject
             };
             const conditions = [];
             if (this._includeUserIdentity) {
@@ -802,14 +825,17 @@ class BlobStorageService {
             core.ObjectHelper.propertyDelete(entity, "userIdentity");
         }
         const jsonLd = {
-            "@context": [blobStorageModels.BlobStorageTypes.ContextRoot, standardsSchemaOrg.SchemaOrgTypes.ContextRoot],
+            "@context": [
+                blobStorageModels.BlobStorageTypes.ContextRoot,
+                blobStorageModels.BlobStorageTypes.ContextRootCommon,
+                standardsSchemaOrg.SchemaOrgTypes.ContextRoot
+            ],
             type: blobStorageModels.BlobStorageTypes.EntryList,
             // The entries are never Partial as we don't allow custom property requests.
             entries: result.entities.map(entry => this.entryToJsonLd(entry)),
             cursor: result.cursor
         };
-        const compacted = await dataJsonLd.JsonLdProcessor.compact(jsonLd, jsonLd["@context"]);
-        return compacted;
+        return dataJsonLd.JsonLdProcessor.compact(jsonLd, jsonLd["@context"]);
     }
     /**
      * Get the connector from the uri.
@@ -888,15 +914,20 @@ class BlobStorageService {
      */
     entryToJsonLd(entry, blob) {
         return {
-            "@context": [blobStorageModels.BlobStorageTypes.ContextRoot, standardsSchemaOrg.SchemaOrgTypes.ContextRoot],
+            "@context": [
+                blobStorageModels.BlobStorageTypes.ContextRoot,
+                blobStorageModels.BlobStorageTypes.ContextRootCommon,
+                standardsSchemaOrg.SchemaOrgTypes.ContextRoot
+            ],
             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,
+            annotationObject: entry?.annotationObject,
             blob: core.Is.uint8Array(blob) ? core.Converter.bytesToBase64(blob) : undefined
         };
     }
@@ -922,6 +953,10 @@ exports.BlobStorageEntry = class BlobStorageEntry {
      * The length of the data in the blob.
      */
     blobSize;
+    /**
+     * The hash of the data in the blob.
+     */
+    blobHash;
     /**
      * The mime type for the blob.
      */
@@ -931,9 +966,9 @@ exports.BlobStorageEntry = class BlobStorageEntry {
      */
     fileExtension;
     /**
-     * The metadata for the blob as JSON-LD.
+     * The annotation object for the blob as JSON-LD.
      */
-    metadata;
+    annotationObject;
     /**
      * The user identity that created the blob.
      */
@@ -959,6 +994,10 @@ __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.BlobStorageEntry.prototype, "blobHash", void 0);
 __decorate([
     entity.property({ type: "string" }),
     __metadata("design:type", String)
@@ -970,7 +1009,7 @@ __decorate([
 __decorate([
     entity.property({ type: "object", itemTypeRef: "IJsonLdNodeObject" }),
     __metadata("design:type", Object)
-], exports.BlobStorageEntry.prototype, "metadata", void 0);
+], exports.BlobStorageEntry.prototype, "annotationObject", void 0);
 __decorate([
     entity.property({ type: "string" }),
     __metadata("design:type", String)