@microsoft/agents-hosting-storage-blob 1.9.0-beta.3.gb2d23c1c44 → 1.9.1

package/README.md

@@ -2,15 +2,23 @@
 
 ## Overview
 
-This package allows to configure Azure Blob Storage as the backend for Agents conversation State
+This package allows to configure Azure Blob Storage as the backend for Agents conversation State
+
+`BlobsStorage` retains the legacy `Storage` contract. Use `BlobsStorageV2` for
+the separate `StorageV2` contract; V2 calls return keyed operation results with
+`value`, `status`, and `version`.
 
 ## Usage with connectionStrings
 
 ```ts
 const blobStorage = new BlobsStorage(process.env.BLOB_CONTAINER_ID!, process.env.BLOB_STORAGE_CONNECTION_STRING!)
 const conversationState = new ConversationState(blobStorage)
-const userState = new UserState(blobStorage)
-```
+const userState = new UserState(blobStorage)
+```
+
+```ts
+const blobStorageV2 = new BlobsStorageV2(containerName, connectionString)
+```
 
 
 ## Usage with EntraID authentication
@@ -18,9 +26,19 @@ const userState = new UserState(blobStorage)
 >note: you must assign RBAC permissions to your storage account
 
 ```ts
-const echo = new AgentApplication<TurnState>({
-  storage: new BlobsStorage('', undefined, undefined,
-    'https://agentsstate.blob.core.windows.net/nodejs-conversations',
-    new MsalTokenCredential(loadAuthConfigFromEnv()))
-})
+const echo = new AgentApplication<TurnState>({
+  storage: new BlobsStorage('', undefined, undefined,
+    'https://agentsstate.blob.core.windows.net/nodejs-conversations',
+    new MsalTokenCredential(loadAuthConfigFromEnv()))
+})
+```
+
+## TTL writes
+
+`BlobsStorage` supports the shared storage TTL option:
+
+```ts
+await blobStorage.write({ 'session/123': { value: 'temporary' } }, { ttl: 3600 })
 ```
+
+Expired blobs are omitted from reads and deleted on a best-effort basis when encountered. Physical auto-eviction still depends on Azure Blob lifecycle policies.

package/dist/package.json

@@ -1,7 +1,7 @@
 {
     "$schema": "https://json.schemastore.org/package.json",
     "name": "@microsoft/agents-hosting-storage-blob",
-    "version": "1.9.0-beta.3.gb2d23c1c44",
+    "version": "1.9.1",
     "homepage": "https://github.com/microsoft/Agents-for-js",
     "repository": {
         "type": "git",
@@ -18,9 +18,9 @@
     "dependencies": {
         "@azure/core-auth": "1.10.1",
         "@azure/storage-blob": "12.31.0",
-        "@microsoft/agents-hosting": "1.9.0-beta.3.gb2d23c1c44",
-        "@microsoft/agents-activity": "1.9.0-beta.3.gb2d23c1c44",
-        "@microsoft/agents-telemetry": "1.9.0-beta.3.gb2d23c1c44",
+        "@microsoft/agents-hosting": "1.9.1",
+        "@microsoft/agents-activity": "1.9.1",
+        "@microsoft/agents-telemetry": "1.9.1",
         "zod": "3.25.75"
     },
     "license": "MIT",

package/dist/src/blobsStorage.d.ts

@@ -1,57 +1,89 @@
 import { TokenCredential } from '@azure/core-auth';
-import { AnonymousCredential, StoragePipelineOptions, StorageSharedKeyCredential } from '@azure/storage-blob';
-import { Storage, StoreItems } from '@microsoft/agents-hosting';
-/**
- * Options for configuring the BlobsStorage.
- */
+import { AnonymousCredential, ContainerClient, StoragePipelineOptions, StorageSharedKeyCredential } from '@azure/storage-blob';
+import { StorageDeleteOptions, StorageDeleteResults, StorageReadResults, StorageWriteOptions, StorageWriteResults, Storage, StorageV2, StoreItems } from '@microsoft/agents-hosting';
+/** Options for configuring Blob storage. */
 export interface BlobsStorageOptions {
+    /** Optional Azure Storage pipeline options to customize request behavior. */
+    storagePipelineOptions?: StoragePipelineOptions;
+}
+/** Shared Blob client setup and raw Blob primitives. */
+declare class BlobsStorageInternals {
+    readonly _containerClient: ContainerClient;
+    private readonly _concurrency;
+    private _initializePromise?;
+    constructor(containerName: string, connectionString?: string, options?: BlobsStorageOptions, url?: string, credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential);
+    _initialize(): Promise<unknown>;
+    getVersion(key: string): Promise<string | undefined>;
+}
+/** A legacy Azure Blob storage provider. */
+export declare class BlobsStorage extends BlobsStorageInternals implements Storage {
+    constructor(containerName: string, connectionString?: string, options?: BlobsStorageOptions, url?: string, credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential);
     /**
-     * Optional Azure Storage pipeline options to customize request behavior
+     * Reads legacy items from Azure Blob Storage.
+     *
+     * @param keys The keys to read.
+     * @returns Existing items keyed by storage key. Missing blobs are omitted and returned items
+     * include the Blob ETag as their legacy `eTag`.
      */
-    storagePipelineOptions?: StoragePipelineOptions;
+    read(keys: string[]): Promise<StoreItems>;
+    /**
+     * Writes legacy items to Azure Blob Storage.
+     *
+     * @param changes The items to write, keyed by storage key.
+     * @throws If the input is invalid, Blob Storage cannot complete the write, or a legacy `eTag`
+     * condition fails.
+     */
+    write(changes: StoreItems): Promise<void>;
+    /**
+     * Deletes legacy items from Azure Blob Storage.
+     *
+     * @param keys The keys to delete. Missing blobs are ignored.
+     */
+    delete(keys: string[]): Promise<void>;
 }
 /**
- * A class that implements the Storage interface using Azure Blob Storage.
- * Provides persistence for bot state data using Azure's Blob Storage service.
+ * An Azure Blob Storage provider for the structured {@link StorageV2} contract.
+ *
+ * This is the V2 counterpart to {@link BlobsStorage} and accepts the same connection settings.
+ * It returns a result for every requested key and exposes the Azure Blob ETag as the separate
+ * storage `version`, preserving any `eTag` property in an application value. Writes support
+ * create-only, replace, and expected-version conditions to detect concurrent updates.
  */
-export declare class BlobsStorage implements Storage {
-    private readonly _containerClient;
-    private readonly _concurrency;
-    private _initializePromise?;
+export declare class BlobsStorageV2 extends StorageV2 {
+    private readonly internals;
     /**
-     * Creates a new instance of the BlobsStorage class.
+     * Creates a V2 Azure Blob Storage provider.
      *
-     * @param containerName The name of the Blob container to use
-     * @param connectionString Optional, The Azure Storage connection string
-     * @param options Optional configuration settings for the storage provider
-     * @param url Optional URL to the blob service (used instead of connectionString if provided)
-     * @param credential Optional credential for authentication (used with url if provided)
+     * @param containerName The Blob container name when using a connection string.
+     * @param connectionString The Azure Storage connection string.
+     * @param options Optional Azure Storage pipeline options.
+     * @param url The Blob service or container URL when using a credential.
+     * @param credential The credential used with `url`.
      */
     constructor(containerName: string, connectionString?: string, options?: BlobsStorageOptions, url?: string, credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential);
-    private toJSON;
-    private _initialize;
     /**
-     * Reads storage items from blob storage.
+     * Reads Blob values and ETag versions.
      *
-     * @param keys Array of item keys to read
-     * @returns A promise that resolves to a StoreItems object containing the retrieved items
-     * @throws Will throw if keys parameter is invalid or if there's an error reading from storage
+     * @param keys The keys to read. Empty batches are valid.
+     * @returns A result for every key, with `notFound` for missing blobs and the Blob ETag as the
+     * version for successful reads.
      */
-    read(keys: string[]): Promise<StoreItems>;
+    read<T extends object = Record<string, unknown>>(keys: string[]): Promise<StorageReadResults<T>>;
     /**
-     * Writes storage items to blob storage.
+     * Writes Blob values with optional concurrency conditions.
      *
-     * @param changes The items to write to storage
-     * @returns A promise that resolves when the write operation is complete
-     * @throws Will throw if there's a validation error, eTag conflict, or other storage error
+     * @param changes The values to write, keyed by storage key.
+     * @param options Create-only, replace, or expected-version conditions.
+     * @returns A result for every supplied key, including Blob concurrency-condition outcomes.
      */
-    write(changes: StoreItems): Promise<void>;
+    write<T extends object = Record<string, unknown>>(changes: Record<string, T>, options?: StorageWriteOptions): Promise<StorageWriteResults>;
     /**
-     * Deletes storage items from blob storage.
+     * Deletes Blob values with an optional ETag version condition.
      *
-     * @param keys Array of item keys to delete
-     * @returns A promise that resolves when the delete operation is complete
-     * @throws Will throw if keys parameter is invalid
+     * @param keys The keys to delete. Empty batches are valid.
+     * @param options An optional expected Blob ETag version.
+     * @returns A result for every supplied key.
      */
-    delete(keys: string[]): Promise<void>;
+    delete(keys: string[], options?: StorageDeleteOptions): Promise<StorageDeleteResults>;
 }
+export {};

package/dist/src/blobsStorage.js

@@ -36,11 +36,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BlobsStorage = void 0;
+exports.BlobsStorageV2 = exports.BlobsStorage = void 0;
 const z = __importStar(require("zod"));
 const consumers_1 = __importDefault(require("stream/consumers"));
 const core_auth_1 = require("@azure/core-auth");
 const storage_blob_1 = require("@azure/storage-blob");
+const agents_hosting_1 = require("@microsoft/agents-hosting");
 const agents_activity_1 = require("@microsoft/agents-activity");
 const errorHelper_1 = require("./errorHelper");
 const blobsTranscriptStore_1 = require("./blobsTranscriptStore");
@@ -48,40 +49,22 @@ const ignoreError_1 = require("./ignoreError");
 const agents_telemetry_1 = require("@microsoft/agents-telemetry");
 const observability_1 = require("./observability");
 const logger = (0, agents_telemetry_1.debug)('agents:blob-storage');
-/**
- * A class that implements the Storage interface using Azure Blob Storage.
- * Provides persistence for bot state data using Azure's Blob Storage service.
- */
-class BlobsStorage {
-    /**
-     * Creates a new instance of the BlobsStorage class.
-     *
-     * @param containerName The name of the Blob container to use
-     * @param connectionString Optional, The Azure Storage connection string
-     * @param options Optional configuration settings for the storage provider
-     * @param url Optional URL to the blob service (used instead of connectionString if provided)
-     * @param credential Optional credential for authentication (used with url if provided)
-     */
+const expirationMetadataKey = 'agentsstorageexpiresat';
+/** Shared Blob client setup and raw Blob primitives. */
+class BlobsStorageInternals {
     constructor(containerName, connectionString, options, url = '', credential) {
         this._concurrency = Infinity;
         if (url.trim() !== '') {
-            z.object({ url: z.string() }).parse({
-                url,
-            });
+            z.object({ url: z.string() }).parse({ url });
             this._containerClient = new storage_blob_1.ContainerClient(url, credential, options === null || options === void 0 ? void 0 : options.storagePipelineOptions);
-            if (url.trim() === 'UseDevelopmentStorage=true;') {
+            if (url.trim() === 'UseDevelopmentStorage=true;')
                 this._concurrency = 1;
-            }
         }
         else {
-            z.object({ connectionString: z.string(), containerName: z.string() }).parse({
-                connectionString,
-                containerName,
-            });
+            z.object({ connectionString: z.string(), containerName: z.string() }).parse({ connectionString, containerName });
             this._containerClient = new storage_blob_1.ContainerClient(connectionString, containerName, options === null || options === void 0 ? void 0 : options.storagePipelineOptions);
-            if (connectionString.trim() === 'UseDevelopmentStorage=true;') {
+            if (connectionString.trim() === 'UseDevelopmentStorage=true;')
                 this._concurrency = 1;
-            }
         }
         logger.info('BlobsStorage settings loaded', {
             container: containerName,
@@ -92,21 +75,33 @@ class BlobsStorage {
             pipeline: (options === null || options === void 0 ? void 0 : options.storagePipelineOptions) !== undefined ? 'custom' : 'default',
         });
     }
-    toJSON() {
-        return { name: 'BlobsStorage' };
-    }
     _initialize() {
-        if (!this._initializePromise) {
+        if (!this._initializePromise)
             this._initializePromise = this._containerClient.createIfNotExists();
-        }
         return this._initializePromise;
     }
+    async getVersion(key) {
+        try {
+            return (await this._containerClient.getBlobClient((0, blobsTranscriptStore_1.sanitizeBlobKey)(key)).getProperties()).etag;
+        }
+        catch (err) {
+            if ((0, ignoreError_1.isStatusCodeError)(404)(err))
+                return undefined;
+            throwStorageOperationError('read version', key, err);
+        }
+    }
+}
+/** A legacy Azure Blob storage provider. */
+class BlobsStorage extends BlobsStorageInternals {
+    constructor(containerName, connectionString, options, url = '', credential) {
+        super(containerName, connectionString, options, url, credential);
+    }
     /**
-     * Reads storage items from blob storage.
+     * Reads legacy items from Azure Blob Storage.
      *
-     * @param keys Array of item keys to read
-     * @returns A promise that resolves to a StoreItems object containing the retrieved items
-     * @throws Will throw if keys parameter is invalid or if there's an error reading from storage
+     * @param keys The keys to read.
+     * @returns Existing items keyed by storage key. Missing blobs are omitted and returned items
+     * include the Blob ETag as their legacy `eTag`.
      */
     async read(keys) {
         return (0, agents_telemetry_1.trace)(observability_1.BlobsStorageTraceDefinitions.read, async ({ record }) => {
@@ -117,60 +112,54 @@ class BlobsStorage {
             const results = await Promise.all(keys.map(async (key) => {
                 const result = { key, value: undefined };
                 const blob = await (0, ignoreError_1.ignoreError)(this._containerClient.getBlobClient((0, blobsTranscriptStore_1.sanitizeBlobKey)(key)).download(), (0, ignoreError_1.isStatusCodeError)(404));
-                if (!blob) {
-                    return result;
-                }
-                const { etag: eTag, readableStreamBody } = blob;
-                if (!readableStreamBody) {
+                if (!(blob === null || blob === void 0 ? void 0 : blob.readableStreamBody))
                     return result;
-                }
-                const parsed = (await consumers_1.default.json(readableStreamBody));
-                result.value = { ...parsed, eTag };
-                logger.debug(`Read blob: ${key}, eTag: ${eTag}`);
+                const parsed = await consumers_1.default.json(blob.readableStreamBody);
+                result.value = { ...parsed, eTag: blob.etag };
+                logger.debug(`Read blob: ${key}, eTag: ${blob.etag}`);
                 return result;
             }));
-            return results.reduce((acc, { key, value }) => (value ? { ...acc, [key]: value } : acc), {});
+            return results.reduce((items, { key, value }) => value ? { ...items, [key]: value } : items, {});
         });
     }
     /**
-     * Writes storage items to blob storage.
+     * Writes legacy items to Azure Blob Storage.
      *
-     * @param changes The items to write to storage
-     * @returns A promise that resolves when the write operation is complete
-     * @throws Will throw if there's a validation error, eTag conflict, or other storage error
+     * @param changes The items to write, keyed by storage key.
+     * @throws If the input is invalid, Blob Storage cannot complete the write, or a legacy `eTag`
+     * condition fails.
      */
     async write(changes) {
         return (0, agents_telemetry_1.trace)(observability_1.BlobsStorageTraceDefinitions.write, async ({ record }) => {
+            record({ keyCount: changes ? Object.keys(changes).length : 0 });
             z.record(z.unknown()).parse(changes);
-            record({ keyCount: Object.keys(changes).length });
             await this._initialize();
             await Promise.all(Object.entries(changes).map(async ([key, { eTag = '', ...change }]) => {
                 try {
                     const blob = this._containerClient.getBlockBlobClient((0, blobsTranscriptStore_1.sanitizeBlobKey)(key));
                     const serialized = JSON.stringify(change);
                     logger.debug(`Writing blob: ${key}, eTag: ${eTag}, size: ${serialized.length}`);
-                    return await blob.upload(serialized, serialized.length, {
-                        conditions: typeof eTag === 'string' && eTag !== '*' ? { ifMatch: eTag } : {},
+                    const conditions = typeof eTag === 'string' && eTag !== '*'
+                        ? { ifMatch: eTag }
+                        : {};
+                    await blob.upload(serialized, serialized.length, {
+                        conditions,
                         blobHTTPHeaders: { blobContentType: 'application/json' },
                     });
                 }
                 catch (err) {
                     if (err.statusCode === 412) {
-                        throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.ETagConflict);
-                    }
-                    else {
-                        throw err;
+                        throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.ETagConflict, undefined, { key });
                     }
+                    throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.StorageWriteFailed, err, { key });
                 }
             }));
         });
     }
     /**
-     * Deletes storage items from blob storage.
+     * Deletes legacy items from Azure Blob Storage.
      *
-     * @param keys Array of item keys to delete
-     * @returns A promise that resolves when the delete operation is complete
-     * @throws Will throw if keys parameter is invalid
+     * @param keys The keys to delete. Missing blobs are ignored.
      */
     async delete(keys) {
         return (0, agents_telemetry_1.trace)(observability_1.BlobsStorageTraceDefinitions.delete, async ({ record }) => {
@@ -178,9 +167,245 @@ class BlobsStorage {
             record({ keyCount: (_a = keys === null || keys === void 0 ? void 0 : keys.length) !== null && _a !== void 0 ? _a : 0 });
             z.object({ keys: z.array(z.string()) }).parse({ keys });
             await this._initialize();
-            await Promise.all(keys.map((key) => (0, ignoreError_1.ignoreError)(this._containerClient.deleteBlob((0, blobsTranscriptStore_1.sanitizeBlobKey)(key)), (0, ignoreError_1.isStatusCodeError)(404))));
+            await Promise.all(keys.map(key => (0, ignoreError_1.ignoreError)(this._containerClient.deleteBlob((0, blobsTranscriptStore_1.sanitizeBlobKey)(key)), (0, ignoreError_1.isStatusCodeError)(404))));
         });
     }
 }
 exports.BlobsStorage = BlobsStorage;
+/**
+ * An Azure Blob Storage provider for the structured {@link StorageV2} contract.
+ *
+ * This is the V2 counterpart to {@link BlobsStorage} and accepts the same connection settings.
+ * It returns a result for every requested key and exposes the Azure Blob ETag as the separate
+ * storage `version`, preserving any `eTag` property in an application value. Writes support
+ * create-only, replace, and expected-version conditions to detect concurrent updates.
+ */
+class BlobsStorageV2 extends agents_hosting_1.StorageV2 {
+    /**
+     * Creates a V2 Azure Blob Storage provider.
+     *
+     * @param containerName The Blob container name when using a connection string.
+     * @param connectionString The Azure Storage connection string.
+     * @param options Optional Azure Storage pipeline options.
+     * @param url The Blob service or container URL when using a credential.
+     * @param credential The credential used with `url`.
+     */
+    constructor(containerName, connectionString, options, url = '', credential) {
+        super();
+        this.internals = new BlobsStorageInternals(containerName, connectionString, options, url, credential);
+    }
+    /**
+     * Reads Blob values and ETag versions.
+     *
+     * @param keys The keys to read. Empty batches are valid.
+     * @returns A result for every key, with `notFound` for missing blobs and the Blob ETag as the
+     * version for successful reads.
+     */
+    async read(keys) {
+        return (0, agents_telemetry_1.trace)(observability_1.BlobsStorageTraceDefinitions.read, async ({ record }) => {
+            var _a;
+            record({ keyCount: (_a = keys === null || keys === void 0 ? void 0 : keys.length) !== null && _a !== void 0 ? _a : 0 });
+            validateV2Keys(keys);
+            if (keys.length === 0)
+                return {};
+            await this.internals._initialize();
+            const results = {};
+            await Promise.all(keys.map(async (key) => {
+                try {
+                    const { etag: version, metadata, readableStreamBody } = await this.internals._containerClient.getBlobClient((0, blobsTranscriptStore_1.sanitizeBlobKey)(key)).download();
+                    if (!readableStreamBody) {
+                        results[key] = { key, status: agents_hosting_1.StorageOperationStatus.NotFound };
+                        return;
+                    }
+                    if (isExpired(metadata === null || metadata === void 0 ? void 0 : metadata[expirationMetadataKey])) {
+                        readableStreamBody.destroy();
+                        logger.info('Blob expired, deleting from storage', {
+                            key: (0, agents_telemetry_1.redactString)(key, true),
+                            eTag: (0, agents_telemetry_1.redactString)(version, true),
+                            expiresAt: metadata === null || metadata === void 0 ? void 0 : metadata[expirationMetadataKey],
+                        });
+                        await (0, ignoreError_1.ignoreError)(this.internals._containerClient.deleteBlob((0, blobsTranscriptStore_1.sanitizeBlobKey)(key), { conditions: { ifMatch: version } }), (0, ignoreError_1.isStatusCodeError)(404, 412));
+                        results[key] = { key, status: agents_hosting_1.StorageOperationStatus.NotFound };
+                        return;
+                    }
+                    const value = await consumers_1.default.json(readableStreamBody);
+                    results[key] = { key, status: agents_hosting_1.StorageOperationStatus.Succeeded, value, version };
+                    logger.debug(`Read blob: ${key}, eTag: ${version}`);
+                }
+                catch (err) {
+                    if ((0, ignoreError_1.isStatusCodeError)(404)(err)) {
+                        results[key] = { key, status: agents_hosting_1.StorageOperationStatus.NotFound };
+                        return;
+                    }
+                    throwStorageOperationError('read', key, err);
+                }
+            }));
+            return results;
+        });
+    }
+    /**
+     * Writes Blob values with optional concurrency conditions.
+     *
+     * @param changes The values to write, keyed by storage key.
+     * @param options Create-only, replace, or expected-version conditions.
+     * @returns A result for every supplied key, including Blob concurrency-condition outcomes.
+     */
+    async write(changes, options) {
+        return (0, agents_telemetry_1.trace)(observability_1.BlobsStorageTraceDefinitions.write, async ({ record }) => {
+            var _a;
+            record({ keyCount: changes ? Object.keys(changes).length : 0 });
+            validateExpectedVersion(options === null || options === void 0 ? void 0 : options.expectedVersion);
+            validateV2Changes(changes);
+            const mode = (_a = options === null || options === void 0 ? void 0 : options.mode) !== null && _a !== void 0 ? _a : agents_hosting_1.StorageWriteMode.Upsert;
+            validateWriteMode(mode);
+            if (Object.keys(changes).length === 0)
+                return {};
+            await this.internals._initialize();
+            const results = {};
+            const expiresAt = (0, agents_hosting_1.getStorageWriteExpiry)(options);
+            await Promise.all(Object.entries(changes).map(async ([key, change]) => {
+                const blob = this.internals._containerClient.getBlockBlobClient((0, blobsTranscriptStore_1.sanitizeBlobKey)(key));
+                const needsCurrentVersion = mode !== agents_hosting_1.StorageWriteMode.Upsert || (options === null || options === void 0 ? void 0 : options.expectedVersion) !== undefined;
+                const currentVersion = needsCurrentVersion
+                    ? await this.internals.getVersion(key)
+                    : undefined;
+                if (mode === agents_hosting_1.StorageWriteMode.CreateOnly && currentVersion !== undefined) {
+                    results[key] = { key, status: agents_hosting_1.StorageOperationStatus.Conflict, version: currentVersion };
+                    return;
+                }
+                if (mode === agents_hosting_1.StorageWriteMode.Replace && currentVersion === undefined) {
+                    results[key] = { key, status: agents_hosting_1.StorageOperationStatus.NotFound };
+                    return;
+                }
+                if ((options === null || options === void 0 ? void 0 : options.expectedVersion) !== undefined && options.expectedVersion !== currentVersion) {
+                    results[key] = { key, status: agents_hosting_1.StorageOperationStatus.ConditionNotMet, version: currentVersion };
+                    return;
+                }
+                const serialized = JSON.stringify(change);
+                const conditions = mode === agents_hosting_1.StorageWriteMode.CreateOnly
+                    ? { ifNoneMatch: '*' }
+                    : (options === null || options === void 0 ? void 0 : options.expectedVersion) !== undefined
+                        ? { ifMatch: options.expectedVersion }
+                        : mode === agents_hosting_1.StorageWriteMode.Replace && currentVersion !== undefined
+                            ? { ifMatch: currentVersion }
+                            : undefined;
+                try {
+                    const response = await blob.upload(serialized, serialized.length, {
+                        conditions,
+                        blobHTTPHeaders: { blobContentType: 'application/json' },
+                        metadata: expiresAt === undefined ? {} : { [expirationMetadataKey]: expiresAt.toString() },
+                    });
+                    results[key] = { key, status: agents_hosting_1.StorageOperationStatus.Succeeded, version: response.etag };
+                }
+                catch (err) {
+                    const statusCode = err.statusCode;
+                    if (mode === agents_hosting_1.StorageWriteMode.CreateOnly && (statusCode === 409 || statusCode === 412)) {
+                        results[key] = { key, status: agents_hosting_1.StorageOperationStatus.Conflict, version: currentVersion };
+                        return;
+                    }
+                    if (statusCode === 412) {
+                        results[key] = { key, status: agents_hosting_1.StorageOperationStatus.ConditionNotMet, version: currentVersion };
+                        return;
+                    }
+                    if (statusCode === 404) {
+                        results[key] = { key, status: agents_hosting_1.StorageOperationStatus.NotFound };
+                        return;
+                    }
+                    throwStorageOperationError('write', key, err);
+                }
+            }));
+            return results;
+        });
+    }
+    /**
+     * Deletes Blob values with an optional ETag version condition.
+     *
+     * @param keys The keys to delete. Empty batches are valid.
+     * @param options An optional expected Blob ETag version.
+     * @returns A result for every supplied key.
+     */
+    async delete(keys, options) {
+        return (0, agents_telemetry_1.trace)(observability_1.BlobsStorageTraceDefinitions.delete, async ({ record }) => {
+            var _a;
+            record({ keyCount: (_a = keys === null || keys === void 0 ? void 0 : keys.length) !== null && _a !== void 0 ? _a : 0 });
+            validateExpectedVersion(options === null || options === void 0 ? void 0 : options.expectedVersion);
+            validateV2Keys(keys);
+            if (keys.length === 0)
+                return {};
+            await this.internals._initialize();
+            const results = {};
+            await Promise.all(keys.map(async (key) => {
+                let currentVersion;
+                if ((options === null || options === void 0 ? void 0 : options.expectedVersion) !== undefined) {
+                    currentVersion = await this.internals.getVersion(key);
+                    if (currentVersion === undefined) {
+                        results[key] = { key, status: agents_hosting_1.StorageOperationStatus.NotFound };
+                        return;
+                    }
+                    if (options.expectedVersion !== currentVersion) {
+                        results[key] = { key, status: agents_hosting_1.StorageOperationStatus.ConditionNotMet, version: currentVersion };
+                        return;
+                    }
+                }
+                try {
+                    const deleteOptions = (options === null || options === void 0 ? void 0 : options.expectedVersion) === undefined
+                        ? undefined
+                        : { conditions: { ifMatch: options.expectedVersion } };
+                    await this.internals._containerClient.deleteBlob((0, blobsTranscriptStore_1.sanitizeBlobKey)(key), deleteOptions);
+                    results[key] = { key, status: agents_hosting_1.StorageOperationStatus.Succeeded, version: currentVersion };
+                }
+                catch (err) {
+                    const statusCode = err.statusCode;
+                    if (statusCode === 412) {
+                        results[key] = { key, status: agents_hosting_1.StorageOperationStatus.ConditionNotMet, version: currentVersion };
+                        return;
+                    }
+                    if (statusCode === 404) {
+                        results[key] = { key, status: agents_hosting_1.StorageOperationStatus.NotFound };
+                        return;
+                    }
+                    throwStorageOperationError('delete', key, err);
+                }
+            }));
+            return results;
+        });
+    }
+}
+exports.BlobsStorageV2 = BlobsStorageV2;
+function validateExpectedVersion(expectedVersion) {
+    if (expectedVersion === '')
+        throw agents_activity_1.ExceptionHelper.generateException(RangeError, errorHelper_1.Errors.StorageV2ExpectedVersionEmpty);
+}
+function validateWriteMode(mode) {
+    if (!Object.values(agents_hosting_1.StorageWriteMode).includes(mode)) {
+        throw agents_activity_1.ExceptionHelper.generateException(RangeError, errorHelper_1.Errors.StorageV2WriteModeUnsupported, undefined, { mode: String(mode) });
+    }
+}
+function validateV2Changes(changes) {
+    if (changes === null || typeof changes !== 'object' || Array.isArray(changes)) {
+        throw agents_activity_1.ExceptionHelper.generateException(ReferenceError, errorHelper_1.Errors.StorageV2ChangesRequired);
+    }
+    if (Object.keys(changes).some(key => key.trim() === '')) {
+        throw agents_activity_1.ExceptionHelper.generateException(ReferenceError, errorHelper_1.Errors.StorageV2KeyRequired);
+    }
+    if (Object.values(changes).some(value => value === null || typeof value !== 'object' || Array.isArray(value))) {
+        throw agents_activity_1.ExceptionHelper.generateException(TypeError, errorHelper_1.Errors.StorageV2ValueRequired);
+    }
+}
+function validateV2Keys(keys) {
+    if (!Array.isArray(keys))
+        throw agents_activity_1.ExceptionHelper.generateException(ReferenceError, errorHelper_1.Errors.StorageV2KeysRequired);
+    if (keys.some(key => typeof key !== 'string' || key.trim() === '')) {
+        throw agents_activity_1.ExceptionHelper.generateException(ReferenceError, errorHelper_1.Errors.StorageV2KeyRequired);
+    }
+}
+function throwStorageOperationError(operation, key, error) {
+    throw agents_activity_1.ExceptionHelper.generateException(Error, errorHelper_1.Errors.StorageV2OperationFailed, error instanceof Error ? error : undefined, { operation, key });
+}
+function isExpired(expiresAt) {
+    if (expiresAt === undefined)
+        return false;
+    const timestamp = Number(expiresAt);
+    return Number.isFinite(timestamp) && timestamp <= Date.now();
+}
 //# sourceMappingURL=blobsStorage.js.map