@twin.org/blob-storage-connector-gcp 0.0.2-next.4 → 0.0.3-next.1

package/dist/{esm/index.mjs → es/gcpBlobStorageConnector.js}

@@ -1,15 +1,15 @@
-import { Storage } from '@google-cloud/storage';
-import { Guards, Is, ObjectHelper, Converter, ComponentFactory, BaseError, Urn, GeneralError } from '@twin.org/core';
-import { Sha256 } from '@twin.org/crypto';
-import { MimeTypes } from '@twin.org/web';
-
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
+import { Storage } from "@google-cloud/storage";
+import { ContextIdHelper, ContextIdStore } from "@twin.org/context";
+import { BaseError, ComponentFactory, Converter, GeneralError, Guards, Is, ObjectHelper, Urn } from "@twin.org/core";
+import { Sha256 } from "@twin.org/crypto";
+import { MimeTypes } from "@twin.org/web";
 /**
  * Class for performing blob storage operations on GCP Storage.
  * See https://cloud.google.com/storage/docs/reference/libraries for more information.
  */
-class GcpBlobStorageConnector {
+export class GcpBlobStorageConnector {
     /**
      * The namespace for the items.
      */
@@ -17,12 +17,17 @@ class GcpBlobStorageConnector {
     /**
      * Runtime name for the class.
      */
-    CLASS_NAME = "GcpBlobStorageConnector";
+    static CLASS_NAME = "GcpBlobStorageConnector";
     /**
      * The configuration for the connector.
      * @internal
      */
     _config;
+    /**
+     * The keys to use from the context ids to create partitions.
+     * @internal
+     */
+    _partitionContextIds;
     /**
      * The GCP Storage client.
      * @internal
@@ -33,22 +38,30 @@ class GcpBlobStorageConnector {
      * @param options The options for the connector.
      */
     constructor(options) {
-        Guards.object(this.CLASS_NAME, "options", options);
-        Guards.object(this.CLASS_NAME, "options.config", options.config);
-        Guards.stringValue(this.CLASS_NAME, "options.config.projectId", options.config.projectId);
+        Guards.object(GcpBlobStorageConnector.CLASS_NAME, "options", options);
+        Guards.object(GcpBlobStorageConnector.CLASS_NAME, "options.config", options.config);
+        Guards.stringValue(GcpBlobStorageConnector.CLASS_NAME, "options.config.projectId", options.config.projectId);
         let credentials;
         if (!Is.empty(options.config.credentials)) {
-            Guards.stringBase64(this.CLASS_NAME, "options.config.credentials", options.config.credentials);
+            Guards.stringBase64(GcpBlobStorageConnector.CLASS_NAME, "options.config.credentials", options.config.credentials);
             credentials = ObjectHelper.fromBytes(Converter.base64ToBytes(options.config.credentials));
         }
-        Guards.stringValue(this.CLASS_NAME, "options.config.bucketName", options.config.bucketName);
+        Guards.stringValue(GcpBlobStorageConnector.CLASS_NAME, "options.config.bucketName", options.config.bucketName);
         this._config = options.config;
+        this._partitionContextIds = options.partitionContextIds;
         this._storage = new Storage({
             projectId: this._config.projectId,
             apiEndpoint: this._config.apiEndpoint,
             credentials
         });
     }
+    /**
+     * Returns the class name of the component.
+     * @returns The class name of the component.
+     */
+    className() {
+        return GcpBlobStorageConnector.CLASS_NAME;
+    }
     /**
      * Bootstrap the component by creating and initializing any resources it needs.
      * @param nodeLoggingComponentType The node logging component type.
@@ -57,20 +70,12 @@ class GcpBlobStorageConnector {
     async bootstrap(nodeLoggingComponentType) {
         const nodeLogging = ComponentFactory.getIfExists(nodeLoggingComponentType);
         try {
-            await nodeLogging?.log({
-                level: "info",
-                source: this.CLASS_NAME,
-                message: "bucketCreating",
-                data: {
-                    bucket: this._config.bucketName
-                }
-            });
             const [buckets] = await this._storage.getBuckets();
             const bucketExists = buckets.some(bucket => bucket.name === this._config.bucketName);
             if (bucketExists) {
                 await nodeLogging?.log({
                     level: "info",
-                    source: this.CLASS_NAME,
+                    source: GcpBlobStorageConnector.CLASS_NAME,
                     message: "bucketExists",
                     data: {
                         bucket: this._config.bucketName
@@ -78,21 +83,21 @@ class GcpBlobStorageConnector {
                 });
             }
             else {
-                await this._storage.createBucket(this._config.bucketName);
                 await nodeLogging?.log({
                     level: "info",
-                    source: this.CLASS_NAME,
-                    message: "bucketCreated",
+                    source: GcpBlobStorageConnector.CLASS_NAME,
+                    message: "bucketCreating",
                     data: {
                         bucket: this._config.bucketName
                     }
                 });
+                await this._storage.createBucket(this._config.bucketName);
             }
         }
         catch (err) {
             await nodeLogging?.log({
                 level: "error",
-                source: this.CLASS_NAME,
+                source: GcpBlobStorageConnector.CLASS_NAME,
                 message: "bucketCreateFailed",
                 data: {
                     bucket: this._config.bucketName
@@ -109,18 +114,20 @@ class GcpBlobStorageConnector {
      * @returns The id of the stored blob in urn format.
      */
     async set(blob) {
-        Guards.uint8Array(this.CLASS_NAME, "blob", blob);
+        Guards.uint8Array(GcpBlobStorageConnector.CLASS_NAME, "blob", blob);
+        const contextIds = await ContextIdStore.getContextIds();
+        const partitionKey = ContextIdHelper.combinedContextKey(contextIds, this._partitionContextIds);
         try {
             const id = Converter.bytesToHex(Sha256.sum256(blob));
             const bucket = this._storage.bucket(this._config.bucketName);
-            const file = bucket.file(id);
+            const file = bucket.file(`${partitionKey ?? "root"}/${id}`);
             await file.save(blob, {
                 contentType: MimeTypes.OctetStream
             });
             return `blob:${new Urn(GcpBlobStorageConnector.NAMESPACE, id).toString()}`;
         }
         catch (err) {
-            throw new GeneralError(this.CLASS_NAME, "setBlobFailed", undefined, err);
+            throw new GeneralError(GcpBlobStorageConnector.CLASS_NAME, "setBlobFailed", undefined, err);
         }
     }
     /**
@@ -129,10 +136,12 @@ class GcpBlobStorageConnector {
      * @returns The data for the blob if it can be found or undefined.
      */
     async get(id) {
-        Urn.guard(this.CLASS_NAME, "id", id);
+        Urn.guard(GcpBlobStorageConnector.CLASS_NAME, "id", id);
+        const contextIds = await ContextIdStore.getContextIds();
+        const partitionKey = ContextIdHelper.combinedContextKey(contextIds, this._partitionContextIds);
         const urnParsed = Urn.fromValidString(id);
         if (urnParsed.namespaceMethod() !== GcpBlobStorageConnector.NAMESPACE) {
-            throw new GeneralError(this.CLASS_NAME, "namespaceMismatch", {
+            throw new GeneralError(GcpBlobStorageConnector.CLASS_NAME, "namespaceMismatch", {
                 namespace: GcpBlobStorageConnector.NAMESPACE,
                 id
             });
@@ -140,7 +149,7 @@ class GcpBlobStorageConnector {
         try {
             const key = urnParsed.namespaceSpecific(1);
             const bucket = this._storage.bucket(this._config.bucketName);
-            const file = bucket.file(key);
+            const file = bucket.file(`${partitionKey ?? "root"}/${key}`);
             const [exists] = await file.exists();
             if (!exists) {
                 return undefined;
@@ -149,7 +158,7 @@ class GcpBlobStorageConnector {
             return new Uint8Array(contents);
         }
         catch (err) {
-            throw new GeneralError(this.CLASS_NAME, "getBlobFailed", { id }, err);
+            throw new GeneralError(GcpBlobStorageConnector.CLASS_NAME, "getBlobFailed", { id }, err);
         }
     }
     /**
@@ -158,10 +167,12 @@ class GcpBlobStorageConnector {
      * @returns True if the blob was found.
      */
     async remove(id) {
-        Urn.guard(this.CLASS_NAME, "id", id);
+        Urn.guard(GcpBlobStorageConnector.CLASS_NAME, "id", id);
+        const contextIds = await ContextIdStore.getContextIds();
+        const partitionKey = ContextIdHelper.combinedContextKey(contextIds, this._partitionContextIds);
         const urnParsed = Urn.fromValidString(id);
         if (urnParsed.namespaceMethod() !== GcpBlobStorageConnector.NAMESPACE) {
-            throw new GeneralError(this.CLASS_NAME, "namespaceMismatch", {
+            throw new GeneralError(GcpBlobStorageConnector.CLASS_NAME, "namespaceMismatch", {
                 namespace: GcpBlobStorageConnector.NAMESPACE,
                 id
             });
@@ -169,7 +180,7 @@ class GcpBlobStorageConnector {
         try {
             const key = urnParsed.namespaceSpecific(1);
             const bucket = this._storage.bucket(this._config.bucketName);
-            const file = bucket.file(key);
+            const file = bucket.file(`${partitionKey ?? "root"}/${key}`);
             const [exists] = await file.exists();
             if (!exists) {
                 return false;
@@ -178,9 +189,8 @@ class GcpBlobStorageConnector {
             return true;
         }
         catch (err) {
-            throw new GeneralError(this.CLASS_NAME, "removeBlobFailed", { id }, err);
+            throw new GeneralError(GcpBlobStorageConnector.CLASS_NAME, "removeBlobFailed", { id }, err);
         }
     }
 }
-
-export { GcpBlobStorageConnector };
+//# sourceMappingURL=gcpBlobStorageConnector.js.map

package/dist/es/gcpBlobStorageConnector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gcpBlobStorageConnector.js","sourceRoot":"","sources":["../../src/gcpBlobStorageConnector.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { Storage } from \"@google-cloud/storage\";\nimport type { IBlobStorageConnector } from \"@twin.org/blob-storage-models\";\nimport { ContextIdHelper, ContextIdStore } from \"@twin.org/context\";\nimport {\n\tBaseError,\n\tComponentFactory,\n\tConverter,\n\tGeneralError,\n\tGuards,\n\tIs,\n\tObjectHelper,\n\tUrn\n} from \"@twin.org/core\";\nimport { Sha256 } from \"@twin.org/crypto\";\nimport type { ILoggingComponent } from \"@twin.org/logging-models\";\nimport { nameof } from \"@twin.org/nameof\";\nimport { MimeTypes } from \"@twin.org/web\";\nimport type { JWTInput } from \"google-auth-library\";\nimport type { IGcpBlobStorageConnectorConfig } from \"./models/IGcpBlobStorageConnectorConfig.js\";\nimport type { IGcpBlobStorageConnectorConstructorOptions } from \"./models/IGcpBlobStorageConnectorConstructorOptions.js\";\n\n/**\n * Class for performing blob storage operations on GCP Storage.\n * See https://cloud.google.com/storage/docs/reference/libraries for more information.\n */\nexport class GcpBlobStorageConnector implements IBlobStorageConnector {\n\t/**\n\t * The namespace for the items.\n\t */\n\tpublic static readonly NAMESPACE: string = \"gcp\";\n\n\t/**\n\t * Runtime name for the class.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<GcpBlobStorageConnector>();\n\n\t/**\n\t * The configuration for the connector.\n\t * @internal\n\t */\n\tprivate readonly _config: IGcpBlobStorageConnectorConfig;\n\n\t/**\n\t * The keys to use from the context ids to create partitions.\n\t * @internal\n\t */\n\tprivate readonly _partitionContextIds?: string[];\n\n\t/**\n\t * The GCP Storage client.\n\t * @internal\n\t */\n\tprivate readonly _storage: Storage;\n\n\t/**\n\t * Create a new instance of GcpBlobStorageConnector.\n\t * @param options The options for the connector.\n\t */\n\tconstructor(options: IGcpBlobStorageConnectorConstructorOptions) {\n\t\tGuards.object(GcpBlobStorageConnector.CLASS_NAME, nameof(options), options);\n\t\tGuards.object<IGcpBlobStorageConnectorConfig>(\n\t\t\tGcpBlobStorageConnector.CLASS_NAME,\n\t\t\tnameof(options.config),\n\t\t\toptions.config\n\t\t);\n\t\tGuards.stringValue(\n\t\t\tGcpBlobStorageConnector.CLASS_NAME,\n\t\t\tnameof(options.config.projectId),\n\t\t\toptions.config.projectId\n\t\t);\n\n\t\tlet credentials: JWTInput | undefined;\n\t\tif (!Is.empty(options.config.credentials)) {\n\t\t\tGuards.stringBase64(\n\t\t\t\tGcpBlobStorageConnector.CLASS_NAME,\n\t\t\t\tnameof(options.config.credentials),\n\t\t\t\toptions.config.credentials\n\t\t\t);\n\t\t\tcredentials = ObjectHelper.fromBytes<JWTInput>(\n\t\t\t\tConverter.base64ToBytes(options.config.credentials)\n\t\t\t);\n\t\t}\n\n\t\tGuards.stringValue(\n\t\t\tGcpBlobStorageConnector.CLASS_NAME,\n\t\t\tnameof(options.config.bucketName),\n\t\t\toptions.config.bucketName\n\t\t);\n\n\t\tthis._config = options.config;\n\t\tthis._partitionContextIds = options.partitionContextIds;\n\t\tthis._storage = new Storage({\n\t\t\tprojectId: this._config.projectId,\n\t\t\tapiEndpoint: this._config.apiEndpoint,\n\t\t\tcredentials\n\t\t});\n\t}\n\n\t/**\n\t * Returns the class name of the component.\n\t * @returns The class name of the component.\n\t */\n\tpublic className(): string {\n\t\treturn GcpBlobStorageConnector.CLASS_NAME;\n\t}\n\n\t/**\n\t * Bootstrap the component by creating and initializing any resources it needs.\n\t * @param nodeLoggingComponentType The node logging component type.\n\t * @returns True if the bootstrapping process was successful.\n\t */\n\tpublic async bootstrap(nodeLoggingComponentType?: string): Promise<boolean> {\n\t\tconst nodeLogging = ComponentFactory.getIfExists<ILoggingComponent>(nodeLoggingComponentType);\n\n\t\ttry {\n\t\t\tconst [buckets] = await this._storage.getBuckets();\n\t\t\tconst bucketExists = buckets.some(bucket => bucket.name === this._config.bucketName);\n\n\t\t\tif (bucketExists) {\n\t\t\t\tawait nodeLogging?.log({\n\t\t\t\t\tlevel: \"info\",\n\t\t\t\t\tsource: GcpBlobStorageConnector.CLASS_NAME,\n\t\t\t\t\tmessage: \"bucketExists\",\n\t\t\t\t\tdata: {\n\t\t\t\t\t\tbucket: this._config.bucketName\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t} else {\n\t\t\t\tawait nodeLogging?.log({\n\t\t\t\t\tlevel: \"info\",\n\t\t\t\t\tsource: GcpBlobStorageConnector.CLASS_NAME,\n\t\t\t\t\tmessage: \"bucketCreating\",\n\t\t\t\t\tdata: {\n\t\t\t\t\t\tbucket: this._config.bucketName\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t\tawait this._storage.createBucket(this._config.bucketName);\n\t\t\t}\n\t\t} catch (err) {\n\t\t\tawait nodeLogging?.log({\n\t\t\t\tlevel: \"error\",\n\t\t\t\tsource: GcpBlobStorageConnector.CLASS_NAME,\n\t\t\t\tmessage: \"bucketCreateFailed\",\n\t\t\t\tdata: {\n\t\t\t\t\tbucket: this._config.bucketName\n\t\t\t\t},\n\t\t\t\terror: BaseError.fromError(err)\n\t\t\t});\n\n\t\t\treturn false;\n\t\t}\n\n\t\treturn true;\n\t}\n\n\t/**\n\t * Set the blob.\n\t * @param blob The data for the blob.\n\t * @returns The id of the stored blob in urn format.\n\t */\n\tpublic async set(blob: Uint8Array): Promise<string> {\n\t\tGuards.uint8Array(GcpBlobStorageConnector.CLASS_NAME, nameof(blob), blob);\n\n\t\tconst contextIds = await ContextIdStore.getContextIds();\n\t\tconst partitionKey = ContextIdHelper.combinedContextKey(contextIds, this._partitionContextIds);\n\n\t\ttry {\n\t\t\tconst id = Converter.bytesToHex(Sha256.sum256(blob));\n\t\t\tconst bucket = this._storage.bucket(this._config.bucketName);\n\t\t\tconst file = bucket.file(`${partitionKey ?? \"root\"}/${id}`);\n\n\t\t\tawait file.save(blob, {\n\t\t\t\tcontentType: MimeTypes.OctetStream\n\t\t\t});\n\n\t\t\treturn `blob:${new Urn(GcpBlobStorageConnector.NAMESPACE, id).toString()}`;\n\t\t} catch (err) {\n\t\t\tthrow new GeneralError(GcpBlobStorageConnector.CLASS_NAME, \"setBlobFailed\", undefined, err);\n\t\t}\n\t}\n\n\t/**\n\t * Get the blob.\n\t * @param id The id of the blob to get in urn format.\n\t * @returns The data for the blob if it can be found or undefined.\n\t */\n\tpublic async get(id: string): Promise<Uint8Array | undefined> {\n\t\tUrn.guard(GcpBlobStorageConnector.CLASS_NAME, nameof(id), id);\n\n\t\tconst contextIds = await ContextIdStore.getContextIds();\n\t\tconst partitionKey = ContextIdHelper.combinedContextKey(contextIds, this._partitionContextIds);\n\n\t\tconst urnParsed = Urn.fromValidString(id);\n\n\t\tif (urnParsed.namespaceMethod() !== GcpBlobStorageConnector.NAMESPACE) {\n\t\t\tthrow new GeneralError(GcpBlobStorageConnector.CLASS_NAME, \"namespaceMismatch\", {\n\t\t\t\tnamespace: GcpBlobStorageConnector.NAMESPACE,\n\t\t\t\tid\n\t\t\t});\n\t\t}\n\n\t\ttry {\n\t\t\tconst key = urnParsed.namespaceSpecific(1);\n\t\t\tconst bucket = this._storage.bucket(this._config.bucketName);\n\t\t\tconst file = bucket.file(`${partitionKey ?? \"root\"}/${key}`);\n\n\t\t\tconst [exists] = await file.exists();\n\t\t\tif (!exists) {\n\t\t\t\treturn undefined;\n\t\t\t}\n\n\t\t\tconst [contents] = await file.download();\n\t\t\treturn new Uint8Array(contents);\n\t\t} catch (err) {\n\t\t\tthrow new GeneralError(GcpBlobStorageConnector.CLASS_NAME, \"getBlobFailed\", { id }, err);\n\t\t}\n\t}\n\n\t/**\n\t * Remove the blob.\n\t * @param id The id of the blob to remove in urn format.\n\t * @returns True if the blob was found.\n\t */\n\tpublic async remove(id: string): Promise<boolean> {\n\t\tUrn.guard(GcpBlobStorageConnector.CLASS_NAME, nameof(id), id);\n\n\t\tconst contextIds = await ContextIdStore.getContextIds();\n\t\tconst partitionKey = ContextIdHelper.combinedContextKey(contextIds, this._partitionContextIds);\n\n\t\tconst urnParsed = Urn.fromValidString(id);\n\n\t\tif (urnParsed.namespaceMethod() !== GcpBlobStorageConnector.NAMESPACE) {\n\t\t\tthrow new GeneralError(GcpBlobStorageConnector.CLASS_NAME, \"namespaceMismatch\", {\n\t\t\t\tnamespace: GcpBlobStorageConnector.NAMESPACE,\n\t\t\t\tid\n\t\t\t});\n\t\t}\n\n\t\ttry {\n\t\t\tconst key = urnParsed.namespaceSpecific(1);\n\t\t\tconst bucket = this._storage.bucket(this._config.bucketName);\n\t\t\tconst file = bucket.file(`${partitionKey ?? \"root\"}/${key}`);\n\n\t\t\tconst [exists] = await file.exists();\n\t\t\tif (!exists) {\n\t\t\t\treturn false;\n\t\t\t}\n\n\t\t\tawait file.delete();\n\t\t\treturn true;\n\t\t} catch (err) {\n\t\t\tthrow new GeneralError(GcpBlobStorageConnector.CLASS_NAME, \"removeBlobFailed\", { id }, err);\n\t\t}\n\t}\n}\n"]}

package/dist/es/index.js

@@ -0,0 +1,6 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+export * from "./gcpBlobStorageConnector.js";
+export * from "./models/IGcpBlobStorageConnectorConfig.js";
+export * from "./models/IGcpBlobStorageConnectorConstructorOptions.js";
+//# sourceMappingURL=index.js.map

package/dist/es/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wDAAwD,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nexport * from \"./gcpBlobStorageConnector.js\";\nexport * from \"./models/IGcpBlobStorageConnectorConfig.js\";\nexport * from \"./models/IGcpBlobStorageConnectorConstructorOptions.js\";\n"]}

package/dist/es/models/IGcpBlobStorageConnectorConfig.js

@@ -0,0 +1,4 @@
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+export {};
+//# sourceMappingURL=IGcpBlobStorageConnectorConfig.js.map

package/dist/es/models/IGcpBlobStorageConnectorConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IGcpBlobStorageConnectorConfig.js","sourceRoot":"","sources":["../../../src/models/IGcpBlobStorageConnectorConfig.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n/**\n * Configuration for the GCP Blob Storage Connector.\n */\nexport interface IGcpBlobStorageConnectorConfig {\n\t/**\n\t * The GCP project ID.\n\t */\n\tprojectId: string;\n\n\t/**\n\t * The GCP credentials, a base64 encoded version of the JWTInput data type.\n\t */\n\tcredentials?: string;\n\n\t/**\n\t * The GCP bucket name.\n\t */\n\tbucketName: string;\n\n\t/**\n\t * Optional endpoint for GCP Storage emulator.\n\t */\n\tapiEndpoint?: string;\n}\n"]}

package/dist/es/models/IGcpBlobStorageConnectorConstructorOptions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IGcpBlobStorageConnectorConstructorOptions.js.map

package/dist/es/models/IGcpBlobStorageConnectorConstructorOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IGcpBlobStorageConnectorConstructorOptions.js","sourceRoot":"","sources":["../../../src/models/IGcpBlobStorageConnectorConstructorOptions.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IGcpBlobStorageConnectorConfig } from \"./IGcpBlobStorageConnectorConfig.js\";\n\n/**\n * Options for the GCP Blob Storage Connector constructor.\n */\nexport interface IGcpBlobStorageConnectorConstructorOptions {\n\t/**\n\t * The keys to use from the context ids to create partitions.\n\t */\n\tpartitionContextIds?: string[];\n\n\t/**\n\t * The configuration for the connector.\n\t */\n\tconfig: IGcpBlobStorageConnectorConfig;\n}\n"]}

package/dist/types/gcpBlobStorageConnector.d.ts

@@ -1,5 +1,5 @@
 import type { IBlobStorageConnector } from "@twin.org/blob-storage-models";
-import type { IGcpBlobStorageConnectorConstructorOptions } from "./models/IGcpBlobStorageConnectorConstructorOptions";
+import type { IGcpBlobStorageConnectorConstructorOptions } from "./models/IGcpBlobStorageConnectorConstructorOptions.js";
 /**
  * Class for performing blob storage operations on GCP Storage.
  * See https://cloud.google.com/storage/docs/reference/libraries for more information.
@@ -12,12 +12,17 @@ export declare class GcpBlobStorageConnector implements IBlobStorageConnector {
     /**
      * Runtime name for the class.
      */
-    readonly CLASS_NAME: string;
+    static readonly CLASS_NAME: string;
     /**
      * Create a new instance of GcpBlobStorageConnector.
      * @param options The options for the connector.
      */
     constructor(options: IGcpBlobStorageConnectorConstructorOptions);
+    /**
+     * Returns the class name of the component.
+     * @returns The class name of the component.
+     */
+    className(): string;
     /**
      * Bootstrap the component by creating and initializing any resources it needs.
      * @param nodeLoggingComponentType The node logging component type.

package/dist/types/index.d.ts

@@ -1,3 +1,3 @@
-export * from "./gcpBlobStorageConnector";
-export * from "./models/IGcpBlobStorageConnectorConfig";
-export * from "./models/IGcpBlobStorageConnectorConstructorOptions";
+export * from "./gcpBlobStorageConnector.js";
+export * from "./models/IGcpBlobStorageConnectorConfig.js";
+export * from "./models/IGcpBlobStorageConnectorConstructorOptions.js";

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

@@ -1,8 +1,12 @@
-import type { IGcpBlobStorageConnectorConfig } from "./IGcpBlobStorageConnectorConfig";
+import type { IGcpBlobStorageConnectorConfig } from "./IGcpBlobStorageConnectorConfig.js";
 /**
  * Options for the GCP Blob Storage Connector constructor.
  */
 export interface IGcpBlobStorageConnectorConstructorOptions {
+    /**
+     * The keys to use from the context ids to create partitions.
+     */
+    partitionContextIds?: string[];
     /**
      * The configuration for the connector.
      */

package/docs/changelog.md

@@ -1,5 +1,39 @@
 # @twin.org/blob-storage-connector-gcp - Changelog
 
+## [0.0.3-next.1](https://github.com/twinfoundation/blob-storage/compare/blob-storage-connector-gcp-v0.0.3-next.0...blob-storage-connector-gcp-v0.0.3-next.1) (2025-11-11)
+
+
+### Features
+
+* add context id features ([#30](https://github.com/twinfoundation/blob-storage/issues/30)) ([fbf1c92](https://github.com/twinfoundation/blob-storage/commit/fbf1c9276424c841ef5ef3f4de8469ab3fba7e9c))
+* Add GCP blob storage connector ([#8](https://github.com/twinfoundation/blob-storage/issues/8)) ([4f6d579](https://github.com/twinfoundation/blob-storage/commit/4f6d579c01b3ae13ebcd9029b279da62e4fde859))
+* add validate-locales ([f20fcec](https://github.com/twinfoundation/blob-storage/commit/f20fceced91e39a0c9edb770b2e43ce944c92f3c))
+* eslint migration to flat config ([e4239dd](https://github.com/twinfoundation/blob-storage/commit/e4239dd1c721955cff7f0357255d2bba15319972))
+* update dependencies ([56f0094](https://github.com/twinfoundation/blob-storage/commit/56f0094b68d8bd22864cd899ac1b61d95540f719))
+* update framework core ([ff339fe](https://github.com/twinfoundation/blob-storage/commit/ff339fe7e3f09ddff429907834bdf43617e9c05e))
+* 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.3-next.0 to 0.0.3-next.1
+
+## [0.0.2-next.5](https://github.com/twinfoundation/blob-storage/compare/blob-storage-connector-gcp-v0.0.2-next.4...blob-storage-connector-gcp-v0.0.2-next.5) (2025-10-09)
+
+
+### Features
+
+* add validate-locales ([f20fcec](https://github.com/twinfoundation/blob-storage/commit/f20fceced91e39a0c9edb770b2e43ce944c92f3c))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/blob-storage-models bumped from 0.0.2-next.4 to 0.0.2-next.5
+
 ## [0.0.2-next.4](https://github.com/twinfoundation/blob-storage/compare/blob-storage-connector-gcp-v0.0.2-next.3...blob-storage-connector-gcp-v0.0.2-next.4) (2025-10-02)
 
 

package/docs/reference/classes/GcpBlobStorageConnector.md

@@ -39,15 +39,29 @@ The namespace for the items.
 
 ### CLASS\_NAME
 
-> `readonly` **CLASS\_NAME**: `string`
+> `readonly` `static` **CLASS\_NAME**: `string`
 
 Runtime name for the class.
 
+## Methods
+
+### className()
+
+> **className**(): `string`
+
+Returns the class name of the component.
+
+#### Returns
+
+`string`
+
+The class name of the component.
+
 #### Implementation of
 
-`IBlobStorageConnector.CLASS_NAME`
+`IBlobStorageConnector.className`
 
-## Methods
+***
 
 ### bootstrap()
 
@@ -103,7 +117,7 @@ The id of the stored blob in urn format.
 
 ### get()
 
-> **get**(`id`): `Promise`\<`undefined` \| `Uint8Array`\<`ArrayBufferLike`\>\>
+> **get**(`id`): `Promise`\<`Uint8Array`\<`ArrayBufferLike`\> \| `undefined`\>
 
 Get the blob.
 
@@ -117,7 +131,7 @@ The id of the blob to get in urn format.
 
 #### Returns
 
-`Promise`\<`undefined` \| `Uint8Array`\<`ArrayBufferLike`\>\>
+`Promise`\<`Uint8Array`\<`ArrayBufferLike`\> \| `undefined`\>
 
 The data for the blob if it can be found or undefined.
 

package/docs/reference/interfaces/IGcpBlobStorageConnectorConstructorOptions.md

@@ -4,6 +4,14 @@ Options for the GCP Blob Storage Connector constructor.
 
 ## Properties
 
+### partitionContextIds?
+
+> `optional` **partitionContextIds**: `string`[]
+
+The keys to use from the context ids to create partitions.
+
+***
+
 ### config
 
 > **config**: [`IGcpBlobStorageConnectorConfig`](IGcpBlobStorageConnectorConfig.md)

package/locales/en.json

@@ -2,7 +2,6 @@
 	"info": {
 		"gcpBlobStorageConnector": {
 			"bucketCreating": "Creating bucket \"{bucket}\"",
-			"bucketCreated": "Created bucket \"{bucket}\"",
 			"bucketExists": "Skipping create bucket \"{bucket}\" as it already exists"
 		}
 	},

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/blob-storage-connector-gcp",
-	"version": "0.0.2-next.4",
+	"version": "0.0.3-next.1",
 	"description": "Blob Storage connector implementation using Google Cloud Storage",
 	"repository": {
 		"type": "git",
@@ -14,28 +14,27 @@
 		"node": ">=20.0.0"
 	},
 	"dependencies": {
-		"@google-cloud/storage": "7.17.1",
-		"@twin.org/blob-storage-models": "0.0.2-next.4",
+		"@google-cloud/storage": "7.17.3",
+		"@twin.org/blob-storage-models": "0.0.3-next.1",
+		"@twin.org/context": "next",
 		"@twin.org/core": "next",
 		"@twin.org/crypto": "next",
 		"@twin.org/logging-models": "next",
 		"@twin.org/nameof": "next",
 		"@twin.org/web": "next"
 	},
-	"main": "./dist/cjs/index.cjs",
-	"module": "./dist/esm/index.mjs",
+	"main": "./dist/es/index.js",
 	"types": "./dist/types/index.d.ts",
 	"exports": {
 		".": {
 			"types": "./dist/types/index.d.ts",
-			"require": "./dist/cjs/index.cjs",
-			"import": "./dist/esm/index.mjs"
+			"import": "./dist/es/index.js",
+			"default": "./dist/es/index.js"
 		},
 		"./locales/*.json": "./locales/*.json"
 	},
 	"files": [
-		"dist/cjs",
-		"dist/esm",
+		"dist/es",
 		"dist/types",
 		"locales",
 		"docs"
@@ -54,5 +53,9 @@
 		"connector",
 		"adapter",
 		"integration"
-	]
+	],
+	"bugs": {
+		"url": "git+https://github.com/twinfoundation/blob-storage/issues"
+	},
+	"homepage": "https://twindev.org"
 }

package/dist/cjs/index.cjs

@@ -1,188 +0,0 @@
-'use strict';
-
-var storage = require('@google-cloud/storage');
-var core = require('@twin.org/core');
-var crypto = require('@twin.org/crypto');
-var web = require('@twin.org/web');
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Class for performing blob storage operations on GCP Storage.
- * See https://cloud.google.com/storage/docs/reference/libraries for more information.
- */
-class GcpBlobStorageConnector {
-    /**
-     * The namespace for the items.
-     */
-    static NAMESPACE = "gcp";
-    /**
-     * Runtime name for the class.
-     */
-    CLASS_NAME = "GcpBlobStorageConnector";
-    /**
-     * The configuration for the connector.
-     * @internal
-     */
-    _config;
-    /**
-     * The GCP Storage client.
-     * @internal
-     */
-    _storage;
-    /**
-     * Create a new instance of GcpBlobStorageConnector.
-     * @param options The options for the connector.
-     */
-    constructor(options) {
-        core.Guards.object(this.CLASS_NAME, "options", options);
-        core.Guards.object(this.CLASS_NAME, "options.config", options.config);
-        core.Guards.stringValue(this.CLASS_NAME, "options.config.projectId", options.config.projectId);
-        let credentials;
-        if (!core.Is.empty(options.config.credentials)) {
-            core.Guards.stringBase64(this.CLASS_NAME, "options.config.credentials", options.config.credentials);
-            credentials = core.ObjectHelper.fromBytes(core.Converter.base64ToBytes(options.config.credentials));
-        }
-        core.Guards.stringValue(this.CLASS_NAME, "options.config.bucketName", options.config.bucketName);
-        this._config = options.config;
-        this._storage = new storage.Storage({
-            projectId: this._config.projectId,
-            apiEndpoint: this._config.apiEndpoint,
-            credentials
-        });
-    }
-    /**
-     * Bootstrap the component by creating and initializing any resources it needs.
-     * @param nodeLoggingComponentType The node logging component type.
-     * @returns True if the bootstrapping process was successful.
-     */
-    async bootstrap(nodeLoggingComponentType) {
-        const nodeLogging = core.ComponentFactory.getIfExists(nodeLoggingComponentType);
-        try {
-            await nodeLogging?.log({
-                level: "info",
-                source: this.CLASS_NAME,
-                message: "bucketCreating",
-                data: {
-                    bucket: this._config.bucketName
-                }
-            });
-            const [buckets] = await this._storage.getBuckets();
-            const bucketExists = buckets.some(bucket => bucket.name === this._config.bucketName);
-            if (bucketExists) {
-                await nodeLogging?.log({
-                    level: "info",
-                    source: this.CLASS_NAME,
-                    message: "bucketExists",
-                    data: {
-                        bucket: this._config.bucketName
-                    }
-                });
-            }
-            else {
-                await this._storage.createBucket(this._config.bucketName);
-                await nodeLogging?.log({
-                    level: "info",
-                    source: this.CLASS_NAME,
-                    message: "bucketCreated",
-                    data: {
-                        bucket: this._config.bucketName
-                    }
-                });
-            }
-        }
-        catch (err) {
-            await nodeLogging?.log({
-                level: "error",
-                source: this.CLASS_NAME,
-                message: "bucketCreateFailed",
-                data: {
-                    bucket: this._config.bucketName
-                },
-                error: core.BaseError.fromError(err)
-            });
-            return false;
-        }
-        return true;
-    }
-    /**
-     * Set the blob.
-     * @param blob The data for the blob.
-     * @returns The id of the stored blob in urn format.
-     */
-    async set(blob) {
-        core.Guards.uint8Array(this.CLASS_NAME, "blob", blob);
-        try {
-            const id = core.Converter.bytesToHex(crypto.Sha256.sum256(blob));
-            const bucket = this._storage.bucket(this._config.bucketName);
-            const file = bucket.file(id);
-            await file.save(blob, {
-                contentType: web.MimeTypes.OctetStream
-            });
-            return `blob:${new core.Urn(GcpBlobStorageConnector.NAMESPACE, id).toString()}`;
-        }
-        catch (err) {
-            throw new core.GeneralError(this.CLASS_NAME, "setBlobFailed", undefined, err);
-        }
-    }
-    /**
-     * Get the blob.
-     * @param id The id of the blob to get in urn format.
-     * @returns The data for the blob if it can be found or undefined.
-     */
-    async get(id) {
-        core.Urn.guard(this.CLASS_NAME, "id", id);
-        const urnParsed = core.Urn.fromValidString(id);
-        if (urnParsed.namespaceMethod() !== GcpBlobStorageConnector.NAMESPACE) {
-            throw new core.GeneralError(this.CLASS_NAME, "namespaceMismatch", {
-                namespace: GcpBlobStorageConnector.NAMESPACE,
-                id
-            });
-        }
-        try {
-            const key = urnParsed.namespaceSpecific(1);
-            const bucket = this._storage.bucket(this._config.bucketName);
-            const file = bucket.file(key);
-            const [exists] = await file.exists();
-            if (!exists) {
-                return undefined;
-            }
-            const [contents] = await file.download();
-            return new Uint8Array(contents);
-        }
-        catch (err) {
-            throw new core.GeneralError(this.CLASS_NAME, "getBlobFailed", { id }, err);
-        }
-    }
-    /**
-     * Remove the blob.
-     * @param id The id of the blob to remove in urn format.
-     * @returns True if the blob was found.
-     */
-    async remove(id) {
-        core.Urn.guard(this.CLASS_NAME, "id", id);
-        const urnParsed = core.Urn.fromValidString(id);
-        if (urnParsed.namespaceMethod() !== GcpBlobStorageConnector.NAMESPACE) {
-            throw new core.GeneralError(this.CLASS_NAME, "namespaceMismatch", {
-                namespace: GcpBlobStorageConnector.NAMESPACE,
-                id
-            });
-        }
-        try {
-            const key = urnParsed.namespaceSpecific(1);
-            const bucket = this._storage.bucket(this._config.bucketName);
-            const file = bucket.file(key);
-            const [exists] = await file.exists();
-            if (!exists) {
-                return false;
-            }
-            await file.delete();
-            return true;
-        }
-        catch (err) {
-            throw new core.GeneralError(this.CLASS_NAME, "removeBlobFailed", { id }, err);
-        }
-    }
-}
-
-exports.GcpBlobStorageConnector = GcpBlobStorageConnector;