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

package/README.md

@@ -13,7 +13,7 @@ npm install @twin.org/blob-storage-connector-azure
 The tests developed are functional tests and need an instance of Azure up and running. To run Azure locally using azurite as microsoft container:
 
 ```shell
-docker run -p 10000:10000 --name twin-blob-azure -d -e AZURITE_ACCOUNTS=testAccount:testKey mcr.microsoft.com/azure-storage/azurite azurite-blob --blobHost 0.0.0.0
+docker run -p 20610:10000 --name twin-blob-azure -d -e AZURITE_ACCOUNTS=testAccount:testKey mcr.microsoft.com/azure-storage/azurite azurite-blob --blobHost 0.0.0.0
 ```
 
 Afterwards you can run the tests as follows:

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

@@ -1,14 +1,14 @@
-import { BlobServiceClient, StorageSharedKeyCredential } from '@azure/storage-blob';
-import { Guards, ComponentFactory, BaseError, Converter, Urn, GeneralError } from '@twin.org/core';
-import { Sha256 } from '@twin.org/crypto';
-
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
+import { BlobServiceClient, StorageSharedKeyCredential } from "@azure/storage-blob";
+import { ContextIdHelper, ContextIdStore } from "@twin.org/context";
+import { BaseError, ComponentFactory, Converter, GeneralError, Guards, Is, Urn } from "@twin.org/core";
+import { Sha256 } from "@twin.org/crypto";
 /**
  * Class for performing blob storage operations on Azure.
  * See https://learn.microsoft.com/en-us/azure/storage/common/storage-samples-javascript?toc=%2Fazure%2Fstorage%2Fblobs%2Ftoc.json for more information.
  */
-class AzureBlobStorageConnector {
+export class AzureBlobStorageConnector {
     /**
      * The namespace for the items.
      */
@@ -16,12 +16,17 @@ class AzureBlobStorageConnector {
     /**
      * Runtime name for the class.
      */
-    CLASS_NAME = "AzureBlobStorageConnector";
+    static CLASS_NAME = "AzureBlobStorageConnector";
     /**
      * The configuration for the connector.
      * @internal
      */
     _config;
+    /**
+     * The keys to use from the context ids to create partitions.
+     * @internal
+     */
+    _partitionContextIds;
     /**
      * The Azure Service client.
      * @internal
@@ -37,15 +42,23 @@ class AzureBlobStorageConnector {
      * @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.accountName", options.config.accountName);
-        Guards.stringValue(this.CLASS_NAME, "options.config.accountKey", options.config.accountKey);
-        Guards.stringValue(this.CLASS_NAME, "options.config.containerName", options.config.containerName);
+        Guards.object(AzureBlobStorageConnector.CLASS_NAME, "options", options);
+        Guards.object(AzureBlobStorageConnector.CLASS_NAME, "options.config", options.config);
+        Guards.stringValue(AzureBlobStorageConnector.CLASS_NAME, "options.config.accountName", options.config.accountName);
+        Guards.stringValue(AzureBlobStorageConnector.CLASS_NAME, "options.config.accountKey", options.config.accountKey);
+        Guards.stringValue(AzureBlobStorageConnector.CLASS_NAME, "options.config.containerName", options.config.containerName);
         this._config = options.config;
+        this._partitionContextIds = options.partitionContextIds;
         this._azureBlobServiceClient = new BlobServiceClient((options.config.endpoint ?? "https://{accountName}.blob.core.windows.net/").replace("{accountName}", options.config.accountName), new StorageSharedKeyCredential(options.config.accountName, options.config.accountKey));
         this._azureContainerClient = this._azureBlobServiceClient.getContainerClient(options.config.containerName);
     }
+    /**
+     * Returns the class name of the component.
+     * @returns The class name of the component.
+     */
+    className() {
+        return AzureBlobStorageConnector.CLASS_NAME;
+    }
     /**
      * Bootstrap the component by creating and initializing any resources it needs.
      * @param nodeLoggingComponentType The node logging component type.
@@ -54,19 +67,11 @@ class AzureBlobStorageConnector {
     async bootstrap(nodeLoggingComponentType) {
         const nodeLogging = ComponentFactory.getIfExists(nodeLoggingComponentType);
         try {
-            await nodeLogging?.log({
-                level: "info",
-                source: this.CLASS_NAME,
-                message: "containerCreating",
-                data: {
-                    container: this._config.containerName
-                }
-            });
             const exists = await this._azureContainerClient.exists();
             if (exists) {
                 await nodeLogging?.log({
                     level: "info",
-                    source: this.CLASS_NAME,
+                    source: AzureBlobStorageConnector.CLASS_NAME,
                     message: "containerExists",
                     data: {
                         container: this._config.containerName
@@ -74,21 +79,21 @@ class AzureBlobStorageConnector {
                 });
             }
             else {
-                await this._azureContainerClient.create();
                 await nodeLogging?.log({
                     level: "info",
-                    source: this.CLASS_NAME,
-                    message: "containerCreated",
+                    source: AzureBlobStorageConnector.CLASS_NAME,
+                    message: "containerCreating",
                     data: {
                         container: this._config.containerName
                     }
                 });
+                await this._azureContainerClient.create();
             }
         }
         catch (err) {
             await nodeLogging?.log({
                 level: "error",
-                source: this.CLASS_NAME,
+                source: AzureBlobStorageConnector.CLASS_NAME,
                 message: "containerCreateFailed",
                 data: {
                     container: this._config.containerName
@@ -105,15 +110,17 @@ class AzureBlobStorageConnector {
      * @returns The id of the stored blob in urn format.
      */
     async set(blob) {
-        Guards.uint8Array(this.CLASS_NAME, "blob", blob);
+        Guards.uint8Array(AzureBlobStorageConnector.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 blockBlobClient = this._azureContainerClient.getBlockBlobClient(id);
+            const blockBlobClient = this._azureContainerClient.getBlockBlobClient(`${partitionKey ?? "root"}/${id}`);
             await blockBlobClient.uploadData(blob);
             return `blob:${new Urn(AzureBlobStorageConnector.NAMESPACE, id).toString()}`;
         }
         catch (err) {
-            throw new GeneralError(this.CLASS_NAME, "setBlobFailed", undefined, err);
+            throw new GeneralError(AzureBlobStorageConnector.CLASS_NAME, "setBlobFailed", undefined, err);
         }
     }
     /**
@@ -122,22 +129,27 @@ class AzureBlobStorageConnector {
      * @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(AzureBlobStorageConnector.CLASS_NAME, "id", id);
         const urnParsed = Urn.fromValidString(id);
+        const contextIds = await ContextIdStore.getContextIds();
+        const partitionKey = ContextIdHelper.combinedContextKey(contextIds, this._partitionContextIds);
         if (urnParsed.namespaceMethod() !== AzureBlobStorageConnector.NAMESPACE) {
-            throw new GeneralError(this.CLASS_NAME, "namespaceMismatch", {
+            throw new GeneralError(AzureBlobStorageConnector.CLASS_NAME, "namespaceMismatch", {
                 namespace: AzureBlobStorageConnector.NAMESPACE,
                 id
             });
         }
         try {
             const key = urnParsed.namespaceSpecific(1);
-            const blobClient = this._azureContainerClient.getBlobClient(key);
+            const blobClient = this._azureContainerClient.getBlobClient(`${partitionKey ?? "root"}/${key}`);
             const buffer = await blobClient.downloadToBuffer();
             return new Uint8Array(buffer);
         }
         catch (err) {
-            throw new GeneralError(this.CLASS_NAME, "getBlobFailed", {
+            if (Is.object(err) && err.statusCode === 404) {
+                return;
+            }
+            throw new GeneralError(AzureBlobStorageConnector.CLASS_NAME, "getBlobFailed", {
                 id,
                 namespace: AzureBlobStorageConnector.NAMESPACE
             }, err);
@@ -149,17 +161,19 @@ class AzureBlobStorageConnector {
      * @returns True if the blob was found.
      */
     async remove(id) {
-        Urn.guard(this.CLASS_NAME, "id", id);
+        Urn.guard(AzureBlobStorageConnector.CLASS_NAME, "id", id);
         const urnParsed = Urn.fromValidString(id);
+        const contextIds = await ContextIdStore.getContextIds();
+        const partitionKey = ContextIdHelper.combinedContextKey(contextIds, this._partitionContextIds);
         if (urnParsed.namespaceMethod() !== AzureBlobStorageConnector.NAMESPACE) {
-            throw new GeneralError(this.CLASS_NAME, "namespaceMismatch", {
+            throw new GeneralError(AzureBlobStorageConnector.CLASS_NAME, "namespaceMismatch", {
                 namespace: AzureBlobStorageConnector.NAMESPACE,
                 id
             });
         }
         try {
             const key = urnParsed.namespaceSpecific(1);
-            const blockBlobClient = await this._azureContainerClient.getBlockBlobClient(key);
+            const blockBlobClient = this._azureContainerClient.getBlockBlobClient(`${partitionKey ?? "root"}/${key}`);
             const options = {
                 deleteSnapshots: "include"
             };
@@ -170,12 +184,11 @@ class AzureBlobStorageConnector {
             return false;
         }
         catch (err) {
-            if (err instanceof Error && "statusCode" in err && err.statusCode === 404) {
+            if (Is.object(err) && err.statusCode === 404) {
                 return false;
             }
-            throw new GeneralError(this.CLASS_NAME, "removeBlobFailed", { id }, err);
+            throw new GeneralError(AzureBlobStorageConnector.CLASS_NAME, "removeBlobFailed", { id }, err);
         }
     }
 }
-
-export { AzureBlobStorageConnector };
+//# sourceMappingURL=azureBlobStorageConnector.js.map

package/dist/es/azureBlobStorageConnector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"azureBlobStorageConnector.js","sourceRoot":"","sources":["../../src/azureBlobStorageConnector.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport {\n\ttype BlobClient,\n\ttype BlobDeleteOptions,\n\ttype BlobDeleteResponse,\n\tBlobServiceClient,\n\ttype BlockBlobClient,\n\ttype ContainerClient,\n\tStorageSharedKeyCredential\n} from \"@azure/storage-blob\";\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\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 type { IAzureBlobStorageConnectorConfig } from \"./models/IAzureBlobStorageConnectorConfig.js\";\nimport type { IAzureBlobStorageConnectorConstructorOptions } from \"./models/IAzureBlobStorageConnectorConstructorOptions.js\";\n\n/**\n * Class for performing blob storage operations on Azure.\n * See https://learn.microsoft.com/en-us/azure/storage/common/storage-samples-javascript?toc=%2Fazure%2Fstorage%2Fblobs%2Ftoc.json for more information.\n */\nexport class AzureBlobStorageConnector implements IBlobStorageConnector {\n\t/**\n\t * The namespace for the items.\n\t */\n\tpublic static readonly NAMESPACE: string = \"azure\";\n\n\t/**\n\t * Runtime name for the class.\n\t */\n\tpublic static readonly CLASS_NAME: string = nameof<AzureBlobStorageConnector>();\n\n\t/**\n\t * The configuration for the connector.\n\t * @internal\n\t */\n\tprivate readonly _config: IAzureBlobStorageConnectorConfig;\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 Azure Service client.\n\t * @internal\n\t */\n\tprivate readonly _azureBlobServiceClient: BlobServiceClient;\n\n\t/**\n\t * The Azure Container client.\n\t * @internal\n\t */\n\tprivate readonly _azureContainerClient: ContainerClient;\n\n\t/**\n\t * Create a new instance of AzureBlobStorageConnector.\n\t * @param options The options for the connector.\n\t */\n\tconstructor(options: IAzureBlobStorageConnectorConstructorOptions) {\n\t\tGuards.object(AzureBlobStorageConnector.CLASS_NAME, nameof(options), options);\n\t\tGuards.object<IAzureBlobStorageConnectorConfig>(\n\t\t\tAzureBlobStorageConnector.CLASS_NAME,\n\t\t\tnameof(options.config),\n\t\t\toptions.config\n\t\t);\n\t\tGuards.stringValue(\n\t\t\tAzureBlobStorageConnector.CLASS_NAME,\n\t\t\tnameof(options.config.accountName),\n\t\t\toptions.config.accountName\n\t\t);\n\t\tGuards.stringValue(\n\t\t\tAzureBlobStorageConnector.CLASS_NAME,\n\t\t\tnameof(options.config.accountKey),\n\t\t\toptions.config.accountKey\n\t\t);\n\t\tGuards.stringValue(\n\t\t\tAzureBlobStorageConnector.CLASS_NAME,\n\t\t\tnameof(options.config.containerName),\n\t\t\toptions.config.containerName\n\t\t);\n\n\t\tthis._config = options.config;\n\t\tthis._partitionContextIds = options.partitionContextIds;\n\n\t\tthis._azureBlobServiceClient = new BlobServiceClient(\n\t\t\t(options.config.endpoint ?? \"https://{accountName}.blob.core.windows.net/\").replace(\n\t\t\t\t\"{accountName}\",\n\t\t\t\toptions.config.accountName\n\t\t\t),\n\t\t\tnew StorageSharedKeyCredential(options.config.accountName, options.config.accountKey)\n\t\t);\n\n\t\tthis._azureContainerClient = this._azureBlobServiceClient.getContainerClient(\n\t\t\toptions.config.containerName\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 AzureBlobStorageConnector.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 exists = await this._azureContainerClient.exists();\n\n\t\t\tif (exists) {\n\t\t\t\tawait nodeLogging?.log({\n\t\t\t\t\tlevel: \"info\",\n\t\t\t\t\tsource: AzureBlobStorageConnector.CLASS_NAME,\n\t\t\t\t\tmessage: \"containerExists\",\n\t\t\t\t\tdata: {\n\t\t\t\t\t\tcontainer: this._config.containerName\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: AzureBlobStorageConnector.CLASS_NAME,\n\t\t\t\t\tmessage: \"containerCreating\",\n\t\t\t\t\tdata: {\n\t\t\t\t\t\tcontainer: this._config.containerName\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t\tawait this._azureContainerClient.create();\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: AzureBlobStorageConnector.CLASS_NAME,\n\t\t\t\tmessage: \"containerCreateFailed\",\n\t\t\t\tdata: {\n\t\t\t\t\tcontainer: this._config.containerName\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(AzureBlobStorageConnector.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 blockBlobClient: BlockBlobClient = this._azureContainerClient.getBlockBlobClient(\n\t\t\t\t`${partitionKey ?? \"root\"}/${id}`\n\t\t\t);\n\t\t\tawait blockBlobClient.uploadData(blob);\n\n\t\t\treturn `blob:${new Urn(AzureBlobStorageConnector.NAMESPACE, id).toString()}`;\n\t\t} catch (err) {\n\t\t\tthrow new GeneralError(AzureBlobStorageConnector.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(AzureBlobStorageConnector.CLASS_NAME, nameof(id), id);\n\t\tconst urnParsed = Urn.fromValidString(id);\n\n\t\tconst contextIds = await ContextIdStore.getContextIds();\n\t\tconst partitionKey = ContextIdHelper.combinedContextKey(contextIds, this._partitionContextIds);\n\n\t\tif (urnParsed.namespaceMethod() !== AzureBlobStorageConnector.NAMESPACE) {\n\t\t\tthrow new GeneralError(AzureBlobStorageConnector.CLASS_NAME, \"namespaceMismatch\", {\n\t\t\t\tnamespace: AzureBlobStorageConnector.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 blobClient: BlobClient = this._azureContainerClient.getBlobClient(\n\t\t\t\t`${partitionKey ?? \"root\"}/${key}`\n\t\t\t);\n\t\t\tconst buffer = await blobClient.downloadToBuffer();\n\t\t\treturn new Uint8Array(buffer);\n\t\t} catch (err) {\n\t\t\tif (Is.object<{ statusCode: number }>(err) && err.statusCode === 404) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tthrow new GeneralError(\n\t\t\t\tAzureBlobStorageConnector.CLASS_NAME,\n\t\t\t\t\"getBlobFailed\",\n\t\t\t\t{\n\t\t\t\t\tid,\n\t\t\t\t\tnamespace: AzureBlobStorageConnector.NAMESPACE\n\t\t\t\t},\n\t\t\t\terr\n\t\t\t);\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(AzureBlobStorageConnector.CLASS_NAME, nameof(id), id);\n\t\tconst urnParsed = Urn.fromValidString(id);\n\n\t\tconst contextIds = await ContextIdStore.getContextIds();\n\t\tconst partitionKey = ContextIdHelper.combinedContextKey(contextIds, this._partitionContextIds);\n\n\t\tif (urnParsed.namespaceMethod() !== AzureBlobStorageConnector.NAMESPACE) {\n\t\t\tthrow new GeneralError(AzureBlobStorageConnector.CLASS_NAME, \"namespaceMismatch\", {\n\t\t\t\tnamespace: AzureBlobStorageConnector.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\n\t\t\tconst blockBlobClient: BlockBlobClient = this._azureContainerClient.getBlockBlobClient(\n\t\t\t\t`${partitionKey ?? \"root\"}/${key}`\n\t\t\t);\n\n\t\t\tconst options: BlobDeleteOptions = {\n\t\t\t\tdeleteSnapshots: \"include\"\n\t\t\t};\n\t\t\tconst blobDeleteResponse: BlobDeleteResponse = await blockBlobClient.delete(options);\n\n\t\t\tif (!blobDeleteResponse.errorCode) {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t\treturn false;\n\t\t} catch (err) {\n\t\t\tif (Is.object<{ statusCode: number }>(err) && err.statusCode === 404) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tthrow new GeneralError(AzureBlobStorageConnector.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 "./azureBlobStorageConnector.js";
+export * from "./models/IAzureBlobStorageConnectorConfig.js";
+export * from "./models/IAzureBlobStorageConnectorConstructorOptions.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,gCAAgC,CAAC;AAC/C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0DAA0D,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nexport * from \"./azureBlobStorageConnector.js\";\nexport * from \"./models/IAzureBlobStorageConnectorConfig.js\";\nexport * from \"./models/IAzureBlobStorageConnectorConstructorOptions.js\";\n"]}

package/dist/es/models/IAzureBlobStorageConnectorConfig.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"IAzureBlobStorageConnectorConfig.js","sourceRoot":"","sources":["../../../src/models/IAzureBlobStorageConnectorConfig.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 Azure Blob Storage Connector.\n */\nexport interface IAzureBlobStorageConnectorConfig {\n\t/**\n\t * Storage account name.\n\t */\n\taccountName: string;\n\n\t/**\n\t * Account key.\n\t */\n\taccountKey: string;\n\n\t/**\n\t * The Azure container name.\n\t */\n\tcontainerName: string;\n\n\t/**\n\t * Endpoint defaults to `https://{accountName}.blob.core.windows.net/` where accountName will be\n\t * substituted.\n\t */\n\tendpoint?: string;\n}\n"]}

package/dist/es/models/IAzureBlobStorageConnectorConstructorOptions.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"IAzureBlobStorageConnectorConstructorOptions.js","sourceRoot":"","sources":["../../../src/models/IAzureBlobStorageConnectorConstructorOptions.ts"],"names":[],"mappings":"","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport type { IAzureBlobStorageConnectorConfig } from \"./IAzureBlobStorageConnectorConfig.js\";\n\n/**\n * Options for the Azure Blob Storage Connector constructor.\n */\nexport interface IAzureBlobStorageConnectorConstructorOptions {\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: IAzureBlobStorageConnectorConfig;\n}\n"]}

package/dist/types/azureBlobStorageConnector.d.ts

@@ -1,5 +1,5 @@
 import type { IBlobStorageConnector } from "@twin.org/blob-storage-models";
-import type { IAzureBlobStorageConnectorConstructorOptions } from "./models/IAzureBlobStorageConnectorConstructorOptions";
+import type { IAzureBlobStorageConnectorConstructorOptions } from "./models/IAzureBlobStorageConnectorConstructorOptions.js";
 /**
  * Class for performing blob storage operations on Azure.
  * See https://learn.microsoft.com/en-us/azure/storage/common/storage-samples-javascript?toc=%2Fazure%2Fstorage%2Fblobs%2Ftoc.json for more information.
@@ -12,12 +12,17 @@ export declare class AzureBlobStorageConnector implements IBlobStorageConnector
     /**
      * Runtime name for the class.
      */
-    readonly CLASS_NAME: string;
+    static readonly CLASS_NAME: string;
     /**
      * Create a new instance of AzureBlobStorageConnector.
      * @param options The options for the connector.
      */
     constructor(options: IAzureBlobStorageConnectorConstructorOptions);
+    /**
+     * 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 "./azureBlobStorageConnector";
-export * from "./models/IAzureBlobStorageConnectorConfig";
-export * from "./models/IAzureBlobStorageConnectorConstructorOptions";
+export * from "./azureBlobStorageConnector.js";
+export * from "./models/IAzureBlobStorageConnectorConfig.js";
+export * from "./models/IAzureBlobStorageConnectorConstructorOptions.js";

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

@@ -1,8 +1,12 @@
-import type { IAzureBlobStorageConnectorConfig } from "./IAzureBlobStorageConnectorConfig";
+import type { IAzureBlobStorageConnectorConfig } from "./IAzureBlobStorageConnectorConfig.js";
 /**
  * Options for the Azure Blob Storage Connector constructor.
  */
 export interface IAzureBlobStorageConnectorConstructorOptions {
+    /**
+     * 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,38 @@
 # @twin.org/blob-storage-connector-azure - Changelog
 
+## [0.0.3-next.1](https://github.com/twinfoundation/blob-storage/compare/blob-storage-connector-azure-v0.0.3-next.0...blob-storage-connector-azure-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 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-azure-v0.0.2-next.4...blob-storage-connector-azure-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-azure-v0.0.2-next.3...blob-storage-connector-azure-v0.0.2-next.4) (2025-10-02)
 
 

package/docs/reference/classes/AzureBlobStorageConnector.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/IAzureBlobStorageConnectorConstructorOptions.md

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

package/locales/en.json

@@ -2,7 +2,6 @@
 	"info": {
 		"azureBlobStorageConnector": {
 			"containerCreating": "Creating container \"{container}\"",
-			"containerCreated": "Created container \"{container}\"",
 			"containerExists": "Skipping create container \"{container}\" as it already exists"
 		}
 	},

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/blob-storage-connector-azure",
-	"version": "0.0.2-next.4",
+	"version": "0.0.3-next.1",
 	"description": "Blob Storage connector implementation using Azure",
 	"repository": {
 		"type": "git",
@@ -14,27 +14,26 @@
 		"node": ">=20.0.0"
 	},
 	"dependencies": {
-		"@azure/storage-blob": "12.28.0",
-		"@twin.org/blob-storage-models": "0.0.2-next.4",
+		"@azure/storage-blob": "12.29.1",
+		"@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"
 	},
-	"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"
@@ -53,5 +52,9 @@
 		"connector",
 		"adapter",
 		"integration"
-	]
+	],
+	"bugs": {
+		"url": "git+https://github.com/twinfoundation/blob-storage/issues"
+	},
+	"homepage": "https://twindev.org"
 }

package/dist/cjs/index.cjs

@@ -1,183 +0,0 @@
-'use strict';
-
-var storageBlob = require('@azure/storage-blob');
-var core = require('@twin.org/core');
-var crypto = require('@twin.org/crypto');
-
-// Copyright 2024 IOTA Stiftung.
-// SPDX-License-Identifier: Apache-2.0.
-/**
- * Class for performing blob storage operations on Azure.
- * See https://learn.microsoft.com/en-us/azure/storage/common/storage-samples-javascript?toc=%2Fazure%2Fstorage%2Fblobs%2Ftoc.json for more information.
- */
-class AzureBlobStorageConnector {
-    /**
-     * The namespace for the items.
-     */
-    static NAMESPACE = "azure";
-    /**
-     * Runtime name for the class.
-     */
-    CLASS_NAME = "AzureBlobStorageConnector";
-    /**
-     * The configuration for the connector.
-     * @internal
-     */
-    _config;
-    /**
-     * The Azure Service client.
-     * @internal
-     */
-    _azureBlobServiceClient;
-    /**
-     * The Azure Container client.
-     * @internal
-     */
-    _azureContainerClient;
-    /**
-     * Create a new instance of AzureBlobStorageConnector.
-     * @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.accountName", options.config.accountName);
-        core.Guards.stringValue(this.CLASS_NAME, "options.config.accountKey", options.config.accountKey);
-        core.Guards.stringValue(this.CLASS_NAME, "options.config.containerName", options.config.containerName);
-        this._config = options.config;
-        this._azureBlobServiceClient = new storageBlob.BlobServiceClient((options.config.endpoint ?? "https://{accountName}.blob.core.windows.net/").replace("{accountName}", options.config.accountName), new storageBlob.StorageSharedKeyCredential(options.config.accountName, options.config.accountKey));
-        this._azureContainerClient = this._azureBlobServiceClient.getContainerClient(options.config.containerName);
-    }
-    /**
-     * 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: "containerCreating",
-                data: {
-                    container: this._config.containerName
-                }
-            });
-            const exists = await this._azureContainerClient.exists();
-            if (exists) {
-                await nodeLogging?.log({
-                    level: "info",
-                    source: this.CLASS_NAME,
-                    message: "containerExists",
-                    data: {
-                        container: this._config.containerName
-                    }
-                });
-            }
-            else {
-                await this._azureContainerClient.create();
-                await nodeLogging?.log({
-                    level: "info",
-                    source: this.CLASS_NAME,
-                    message: "containerCreated",
-                    data: {
-                        container: this._config.containerName
-                    }
-                });
-            }
-        }
-        catch (err) {
-            await nodeLogging?.log({
-                level: "error",
-                source: this.CLASS_NAME,
-                message: "containerCreateFailed",
-                data: {
-                    container: this._config.containerName
-                },
-                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 blockBlobClient = this._azureContainerClient.getBlockBlobClient(id);
-            await blockBlobClient.uploadData(blob);
-            return `blob:${new core.Urn(AzureBlobStorageConnector.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() !== AzureBlobStorageConnector.NAMESPACE) {
-            throw new core.GeneralError(this.CLASS_NAME, "namespaceMismatch", {
-                namespace: AzureBlobStorageConnector.NAMESPACE,
-                id
-            });
-        }
-        try {
-            const key = urnParsed.namespaceSpecific(1);
-            const blobClient = this._azureContainerClient.getBlobClient(key);
-            const buffer = await blobClient.downloadToBuffer();
-            return new Uint8Array(buffer);
-        }
-        catch (err) {
-            throw new core.GeneralError(this.CLASS_NAME, "getBlobFailed", {
-                id,
-                namespace: AzureBlobStorageConnector.NAMESPACE
-            }, 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() !== AzureBlobStorageConnector.NAMESPACE) {
-            throw new core.GeneralError(this.CLASS_NAME, "namespaceMismatch", {
-                namespace: AzureBlobStorageConnector.NAMESPACE,
-                id
-            });
-        }
-        try {
-            const key = urnParsed.namespaceSpecific(1);
-            const blockBlobClient = await this._azureContainerClient.getBlockBlobClient(key);
-            const options = {
-                deleteSnapshots: "include"
-            };
-            const blobDeleteResponse = await blockBlobClient.delete(options);
-            if (!blobDeleteResponse.errorCode) {
-                return true;
-            }
-            return false;
-        }
-        catch (err) {
-            if (err instanceof Error && "statusCode" in err && err.statusCode === 404) {
-                return false;
-            }
-            throw new core.GeneralError(this.CLASS_NAME, "removeBlobFailed", { id }, err);
-        }
-    }
-}
-
-exports.AzureBlobStorageConnector = AzureBlobStorageConnector;