@azure/storage-blob 12.28.0-beta.2 → 12.28.1-alpha.20250724.2

package/dist/esm/BlobServiceClient.js

@@ -1,4 +1,3 @@
-import { __asyncDelegator, __asyncGenerator, __asyncValues, __await } from "tslib";
 import { isTokenCredential } from "@azure/core-auth";
 import { getDefaultProxySettings } from "@azure/core-rest-pipeline";
 import { isNodeLike } from "@azure/core-util";
@@ -19,6 +18,10 @@ import { AccountSASServices } from "./sas/AccountSASServices.js";
  * to manipulate blob containers.
  */
 export class BlobServiceClient extends StorageClient {
+    /**
+     * serviceContext provided by protocol layer.
+     */
+    serviceContext;
     /**
      *
      * Creates an instance of BlobServiceClient from connection string.
@@ -103,7 +106,7 @@ export class BlobServiceClient extends StorageClient {
         return new ContainerClient(appendToURLPath(this.url, encodeURIComponent(containerName)), this.pipeline);
     }
     /**
-     * Create a Blob container. @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-container
+     * Create a Blob container. @see https://learn.microsoft.com/rest/api/storageservices/create-container
      *
      * @param containerName - Name of the container to create.
      * @param options - Options to configure Container Create operation.
@@ -157,7 +160,7 @@ export class BlobServiceClient extends StorageClient {
     /**
      * Gets the properties of a storage account’s Blob service, including properties
      * for Storage Analytics and CORS (Cross-Origin Resource Sharing) rules.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-blob-service-properties
+     * @see https://learn.microsoft.com/rest/api/storageservices/get-blob-service-properties
      *
      * @param options - Options to the Service Get Properties operation.
      * @returns Response data for the Service Get Properties operation.
@@ -173,7 +176,7 @@ export class BlobServiceClient extends StorageClient {
     /**
      * Sets properties for a storage account’s Blob service endpoint, including properties
      * for Storage Analytics, CORS (Cross-Origin Resource Sharing) rules and soft delete settings.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-blob-service-properties
+     * @see https://learn.microsoft.com/rest/api/storageservices/set-blob-service-properties
      *
      * @param properties -
      * @param options - Options to the Service Set Properties operation.
@@ -191,7 +194,7 @@ export class BlobServiceClient extends StorageClient {
      * Retrieves statistics related to replication for the Blob service. It is only
      * available on the secondary location endpoint when read-access geo-redundant
      * replication is enabled for the storage account.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-blob-service-stats
+     * @see https://learn.microsoft.com/rest/api/storageservices/get-blob-service-stats
      *
      * @param options - Options to the Service Get Statistics operation.
      * @returns Response data for the Service Get Statistics operation.
@@ -209,7 +212,7 @@ export class BlobServiceClient extends StorageClient {
      * for the specified account.
      * The Get Account Information operation is available on service versions beginning
      * with version 2018-03-28.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-account-information
+     * @see https://learn.microsoft.com/rest/api/storageservices/get-account-information
      *
      * @param options - Options to the Service Get Account Info operation.
      * @returns Response data for the Service Get Account Info operation.
@@ -224,7 +227,7 @@ export class BlobServiceClient extends StorageClient {
     }
     /**
      * Returns a list of the containers under the specified account.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/list-containers2
+     * @see https://learn.microsoft.com/rest/api/storageservices/list-containers2
      *
      * @param marker - A string value that identifies the portion of
      *                        the list of containers to be returned with the next listing operation. The
@@ -238,7 +241,13 @@ export class BlobServiceClient extends StorageClient {
      */
     async listContainersSegment(marker, options = {}) {
         return tracingClient.withSpan("BlobServiceClient-listContainersSegment", options, async (updatedOptions) => {
-            return assertResponse(await this.serviceContext.listContainersSegment(Object.assign(Object.assign({ abortSignal: options.abortSignal, marker }, options), { include: typeof options.include === "string" ? [options.include] : options.include, tracingOptions: updatedOptions.tracingOptions })));
+            return assertResponse(await this.serviceContext.listContainersSegment({
+                abortSignal: options.abortSignal,
+                marker,
+                ...options,
+                include: typeof options.include === "string" ? [options.include] : options.include,
+                tracingOptions: updatedOptions.tracingOptions,
+            }));
         });
     }
     /**
@@ -268,14 +277,17 @@ export class BlobServiceClient extends StorageClient {
                 maxPageSize: options.maxPageSize,
                 tracingOptions: updatedOptions.tracingOptions,
             }));
-            const wrappedResponse = Object.assign(Object.assign({}, response), { _response: response._response, blobs: response.blobs.map((blob) => {
-                    var _a;
+            const wrappedResponse = {
+                ...response,
+                _response: response._response, // _response is made non-enumerable
+                blobs: response.blobs.map((blob) => {
                     let tagValue = "";
-                    if (((_a = blob.tags) === null || _a === void 0 ? void 0 : _a.blobTagSet.length) === 1) {
+                    if (blob.tags?.blobTagSet.length === 1) {
                         tagValue = blob.tags.blobTagSet[0].value;
                     }
-                    return Object.assign(Object.assign({}, blob), { tags: toTags(blob.tags), tagValue });
-                }) });
+                    return { ...blob, tags: toTags(blob.tags), tagValue };
+                }),
+            };
             return wrappedResponse;
         });
     }
@@ -295,18 +307,16 @@ export class BlobServiceClient extends StorageClient {
      *                          items. The marker value is opaque to the client.
      * @param options - Options to find blobs by tags.
      */
-    findBlobsByTagsSegments(tagFilterSqlExpression_1, marker_1) {
-        return __asyncGenerator(this, arguments, function* findBlobsByTagsSegments_1(tagFilterSqlExpression, marker, options = {}) {
-            let response;
-            if (!!marker || marker === undefined) {
-                do {
-                    response = yield __await(this.findBlobsByTagsSegment(tagFilterSqlExpression, marker, options));
-                    response.blobs = response.blobs || [];
-                    marker = response.continuationToken;
-                    yield yield __await(response);
-                } while (marker);
-            }
-        });
+    async *findBlobsByTagsSegments(tagFilterSqlExpression, marker, options = {}) {
+        let response;
+        if (!!marker || marker === undefined) {
+            do {
+                response = await this.findBlobsByTagsSegment(tagFilterSqlExpression, marker, options);
+                response.blobs = response.blobs || [];
+                marker = response.continuationToken;
+                yield response;
+            } while (marker);
+        }
     }
     /**
      * Returns an AsyncIterableIterator for blobs.
@@ -317,26 +327,11 @@ export class BlobServiceClient extends StorageClient {
      *                                         however, only a subset of the OData filter syntax is supported in the Blob service.
      * @param options - Options to findBlobsByTagsItems.
      */
-    findBlobsByTagsItems(tagFilterSqlExpression_1) {
-        return __asyncGenerator(this, arguments, function* findBlobsByTagsItems_1(tagFilterSqlExpression, options = {}) {
-            var _a, e_1, _b, _c;
-            let marker;
-            try {
-                for (var _d = true, _e = __asyncValues(this.findBlobsByTagsSegments(tagFilterSqlExpression, marker, options)), _f; _f = yield __await(_e.next()), _a = _f.done, !_a; _d = true) {
-                    _c = _f.value;
-                    _d = false;
-                    const segment = _c;
-                    yield __await(yield* __asyncDelegator(__asyncValues(segment.blobs)));
-                }
-            }
-            catch (e_1_1) { e_1 = { error: e_1_1 }; }
-            finally {
-                try {
-                    if (!_d && !_a && (_b = _e.return)) yield __await(_b.call(_e));
-                }
-                finally { if (e_1) throw e_1.error; }
-            }
-        });
+    async *findBlobsByTagsItems(tagFilterSqlExpression, options = {}) {
+        let marker;
+        for await (const segment of this.findBlobsByTagsSegments(tagFilterSqlExpression, marker, options)) {
+            yield* segment.blobs;
+        }
     }
     /**
      * Returns an async iterable iterator to find all blobs with specified tag
@@ -344,7 +339,7 @@ export class BlobServiceClient extends StorageClient {
      *
      * .byPage() returns an async iterable iterator to list the blobs in pages.
      *
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-blob-service-properties
+     * @see https://learn.microsoft.com/rest/api/storageservices/get-blob-service-properties
      *
      * ```ts snippet:BlobServiceClientFindBlobsByTags
      * import { BlobServiceClient } from "@azure/storage-blob";
@@ -415,7 +410,9 @@ export class BlobServiceClient extends StorageClient {
      */
     findBlobsByTags(tagFilterSqlExpression, options = {}) {
         // AsyncIterableIterator to iterate over blobs
-        const listSegmentOptions = Object.assign({}, options);
+        const listSegmentOptions = {
+            ...options,
+        };
         const iter = this.findBlobsByTagsItems(tagFilterSqlExpression, listSegmentOptions);
         return {
             /**
@@ -434,7 +431,10 @@ export class BlobServiceClient extends StorageClient {
              * Return an AsyncIterableIterator that works a page at a time
              */
             byPage: (settings = {}) => {
-                return this.findBlobsByTagsSegments(tagFilterSqlExpression, settings.continuationToken, Object.assign({ maxPageSize: settings.maxPageSize }, listSegmentOptions));
+                return this.findBlobsByTagsSegments(tagFilterSqlExpression, settings.continuationToken, {
+                    maxPageSize: settings.maxPageSize,
+                    ...listSegmentOptions,
+                });
             },
         };
     }
@@ -450,45 +450,28 @@ export class BlobServiceClient extends StorageClient {
      *                        items. The marker value is opaque to the client.
      * @param options - Options to list containers operation.
      */
-    listSegments(marker_1) {
-        return __asyncGenerator(this, arguments, function* listSegments_1(marker, options = {}) {
-            let listContainersSegmentResponse;
-            if (!!marker || marker === undefined) {
-                do {
-                    listContainersSegmentResponse = yield __await(this.listContainersSegment(marker, options));
-                    listContainersSegmentResponse.containerItems =
-                        listContainersSegmentResponse.containerItems || [];
-                    marker = listContainersSegmentResponse.continuationToken;
-                    yield yield __await(yield __await(listContainersSegmentResponse));
-                } while (marker);
-            }
-        });
+    async *listSegments(marker, options = {}) {
+        let listContainersSegmentResponse;
+        if (!!marker || marker === undefined) {
+            do {
+                listContainersSegmentResponse = await this.listContainersSegment(marker, options);
+                listContainersSegmentResponse.containerItems =
+                    listContainersSegmentResponse.containerItems || [];
+                marker = listContainersSegmentResponse.continuationToken;
+                yield await listContainersSegmentResponse;
+            } while (marker);
+        }
     }
     /**
      * Returns an AsyncIterableIterator for Container Items
      *
      * @param options - Options to list containers operation.
      */
-    listItems() {
-        return __asyncGenerator(this, arguments, function* listItems_1(options = {}) {
-            var _a, e_2, _b, _c;
-            let marker;
-            try {
-                for (var _d = true, _e = __asyncValues(this.listSegments(marker, options)), _f; _f = yield __await(_e.next()), _a = _f.done, !_a; _d = true) {
-                    _c = _f.value;
-                    _d = false;
-                    const segment = _c;
-                    yield __await(yield* __asyncDelegator(__asyncValues(segment.containerItems)));
-                }
-            }
-            catch (e_2_1) { e_2 = { error: e_2_1 }; }
-            finally {
-                try {
-                    if (!_d && !_a && (_b = _e.return)) yield __await(_b.call(_e));
-                }
-                finally { if (e_2) throw e_2.error; }
-            }
-        });
+    async *listItems(options = {}) {
+        let marker;
+        for await (const segment of this.listSegments(marker, options)) {
+            yield* segment.containerItems;
+        }
     }
     /**
      * Returns an async iterable iterator to list all the containers
@@ -575,7 +558,10 @@ export class BlobServiceClient extends StorageClient {
             include.push("system");
         }
         // AsyncIterableIterator to iterate over containers
-        const listSegmentOptions = Object.assign(Object.assign({}, options), (include.length > 0 ? { include } : {}));
+        const listSegmentOptions = {
+            ...options,
+            ...(include.length > 0 ? { include } : {}),
+        };
         const iter = this.listItems(listSegmentOptions);
         return {
             /**
@@ -594,7 +580,10 @@ export class BlobServiceClient extends StorageClient {
              * Return an AsyncIterableIterator that works a page at a time
              */
             byPage: (settings = {}) => {
-                return this.listSegments(settings.continuationToken, Object.assign({ maxPageSize: settings.maxPageSize }, listSegmentOptions));
+                return this.listSegments(settings.continuationToken, {
+                    maxPageSize: settings.maxPageSize,
+                    ...listSegmentOptions,
+                });
             },
         };
     }
@@ -604,7 +593,7 @@ export class BlobServiceClient extends StorageClient {
      * Retrieves a user delegation key for the Blob service. This is only a valid operation when using
      * bearer token authentication.
      *
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-user-delegation-key
+     * @see https://learn.microsoft.com/rest/api/storageservices/get-user-delegation-key
      *
      * @param startsOn -      The start time for the user delegation SAS. Must be within 7 days of the current time
      * @param expiresOn -     The end time for the user delegation SAS. Must be within 7 days of the current time
@@ -627,14 +616,22 @@ export class BlobServiceClient extends StorageClient {
                 signedVersion: response.signedVersion,
                 value: response.value,
             };
-            const res = Object.assign({ _response: response._response, requestId: response.requestId, clientRequestId: response.clientRequestId, version: response.version, date: response.date, errorCode: response.errorCode }, userDelegationKey);
+            const res = {
+                _response: response._response,
+                requestId: response.requestId,
+                clientRequestId: response.clientRequestId,
+                version: response.version,
+                date: response.date,
+                errorCode: response.errorCode,
+                ...userDelegationKey,
+            };
             return res;
         });
     }
     /**
      * Creates a BlobBatchClient object to conduct batch operations.
      *
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/blob-batch
+     * @see https://learn.microsoft.com/rest/api/storageservices/blob-batch
      *
      * @returns A new BlobBatchClient object for this service.
      */
@@ -647,7 +644,7 @@ export class BlobServiceClient extends StorageClient {
      * Generates a Blob account Shared Access Signature (SAS) URI based on the client properties
      * and parameters passed in. The SAS is signed by the shared key credential of the client.
      *
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-account-sas
+     * @see https://learn.microsoft.com/rest/api/storageservices/create-account-sas
      *
      * @param expiresOn - Optional. The time at which the shared access signature becomes invalid. Default to an hour later if not provided.
      * @param permissions - Specifies the list of permissions to be associated with the SAS.
@@ -663,9 +660,13 @@ export class BlobServiceClient extends StorageClient {
             const now = new Date();
             expiresOn = new Date(now.getTime() + 3600 * 1000);
         }
-        const sas = generateAccountSASQueryParameters(Object.assign({ permissions,
+        const sas = generateAccountSASQueryParameters({
+            permissions,
             expiresOn,
-            resourceTypes, services: AccountSASServices.parse("b").toString() }, options), this.credential).toString();
+            resourceTypes,
+            services: AccountSASServices.parse("b").toString(),
+            ...options,
+        }, this.credential).toString();
         return appendToURLQuery(this.url, sas);
     }
     /**
@@ -674,7 +675,7 @@ export class BlobServiceClient extends StorageClient {
      * Generates string to sign for a Blob account Shared Access Signature (SAS) URI based on
      * the client properties and parameters passed in. The SAS is signed by the shared key credential of the client.
      *
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-account-sas
+     * @see https://learn.microsoft.com/rest/api/storageservices/create-account-sas
      *
      * @param expiresOn - Optional. The time at which the shared access signature becomes invalid. Default to an hour later if not provided.
      * @param permissions - Specifies the list of permissions to be associated with the SAS.
@@ -690,9 +691,13 @@ export class BlobServiceClient extends StorageClient {
             const now = new Date();
             expiresOn = new Date(now.getTime() + 3600 * 1000);
         }
-        return generateAccountSASQueryParametersInternal(Object.assign({ permissions,
+        return generateAccountSASQueryParametersInternal({
+            permissions,
             expiresOn,
-            resourceTypes, services: AccountSASServices.parse("b").toString() }, options), this.credential).stringToSign;
+            resourceTypes,
+            services: AccountSASServices.parse("b").toString(),
+            ...options,
+        }, this.credential).stringToSign;
     }
 }
 //# sourceMappingURL=BlobServiceClient.js.map