@azure/storage-file-share 12.32.0 → 12.33.0

package/dist/commonjs/Clients.js

@@ -125,12 +125,17 @@ class ShareClient extends import_StorageClient.StorageClient {
    */
   async create(options = {}) {
     return import_tracing.tracingClient.withSpan("ShareClient-create", options, async (updatedOptions) => {
+      const { metadata, ...restOptions } = updatedOptions;
+      const metadataHeaders = (0, import_models2.metadataToRawHeaders)(metadata);
       return (0, import_utils_common.assertResponse)(
-        await this.context.create({
-          ...updatedOptions,
-          ...this.shareClientConfig,
-          enabledProtocols: (0, import_models2.toShareProtocolsString)(updatedOptions.protocols)
-        })
+        (0, import_utils_common.adjustResponse)(
+          await this.context.create({
+            ...restOptions,
+            ...this.shareClientConfig,
+            enabledProtocols: (0, import_models2.toShareProtocolsString)(updatedOptions.protocols),
+            requestOptions: { headers: metadataHeaders }
+          })
+        )
       );
     });
   }
@@ -156,6 +161,7 @@ class ShareClient extends import_StorageClient.StorageClient {
           if (e.details?.errorCode === "ShareAlreadyExists") {
             return {
               succeeded: false,
+              errorCode: e.details?.errorCode,
               ...e.response?.parsedHeaders,
               _response: e.response
             };
@@ -316,12 +322,26 @@ class ShareClient extends import_StorageClient.StorageClient {
    */
   async getProperties(options = {}) {
     return import_tracing.tracingClient.withSpan("ShareClient-getProperties", options, async (updatedOptions) => {
-      const res = (0, import_utils_common.assertResponse)(
-        await this.context.getProperties(updatedOptions)
+      const response = (0, import_utils_common.adjustResponse)(
+        await this.context.getProperties({
+          ...updatedOptions,
+          ...updatedOptions.leaseAccessConditions
+        })
       );
+      const wrappedRes = {
+        ...response,
+        _response: response._response,
+        // _response is made non-enumerable,
+        leaseDuration: response.leaseDuration ? response.leaseDuration : void 0,
+        leaseState: response.leaseState ? response.leaseState : void 0,
+        leaseStatus: response.leaseStatus ? response.leaseStatus : void 0,
+        rootSquash: response.rootSquash ? response.rootSquash : void 0
+      };
+      const res = (0, import_utils_common.assertResponse)(wrappedRes);
       return {
         ...res,
         ...this.shareClientConfig,
+        metadata: (0, import_models2.rawHeadersToMetadata)(res._response.headers.rawHeaders()),
         protocols: (0, import_models2.toShareProtocols)(res.enabledProtocols)
       };
     });
@@ -337,10 +357,13 @@ class ShareClient extends import_StorageClient.StorageClient {
   async delete(options = {}) {
     return import_tracing.tracingClient.withSpan("ShareClient-delete", options, async (updatedOptions) => {
       return (0, import_utils_common.assertResponse)(
-        await this.context.delete({
-          ...updatedOptions,
-          ...this.shareClientConfig
-        })
+        (0, import_utils_common.adjustResponse)(
+          await this.context.delete({
+            ...updatedOptions,
+            ...updatedOptions.leaseAccessConditions,
+            ...this.shareClientConfig
+          })
+        )
       );
     });
   }
@@ -363,6 +386,7 @@ class ShareClient extends import_StorageClient.StorageClient {
         if (e.details?.errorCode === "ShareNotFound" || e.details?.errorCode === "ShareSnapshotNotFound") {
           return {
             succeeded: false,
+            errorCode: e.details?.errorCode,
             ...e.response?.parsedHeaders,
             _response: e.response
           };
@@ -384,12 +408,16 @@ class ShareClient extends import_StorageClient.StorageClient {
    */
   async setMetadata(metadata, options = {}) {
     return import_tracing.tracingClient.withSpan("ShareClient-setMetadata", options, async (updatedOptions) => {
+      const metadataHeaders = (0, import_models2.metadataToRawHeaders)(metadata);
       return (0, import_utils_common.assertResponse)(
-        await this.context.setMetadata({
-          ...updatedOptions,
-          ...this.shareClientConfig,
-          metadata
-        })
+        (0, import_utils_common.adjustResponse)(
+          await this.context.setMetadata({
+            ...updatedOptions,
+            ...updatedOptions.leaseAccessConditions,
+            ...this.shareClientConfig,
+            requestOptions: { headers: metadataHeaders }
+          })
+        )
       );
     });
   }
@@ -411,10 +439,13 @@ class ShareClient extends import_StorageClient.StorageClient {
       options,
       async (updatedOptions) => {
         const response = (0, import_utils_common.assertResponse)(
-          await this.context.getAccessPolicy({
-            ...updatedOptions,
-            ...this.shareClientConfig
-          })
+          (0, import_utils_common.adjustResponse)(
+            await this.context.getAccessPolicy({
+              ...updatedOptions,
+              ...updatedOptions.leaseAccessConditions,
+              ...this.shareClientConfig
+            })
+          )
         );
         const res = {
           _response: response._response,
@@ -425,7 +456,7 @@ class ShareClient extends import_StorageClient.StorageClient {
           signedIdentifiers: [],
           version: response.version
         };
-        for (const identifier of response) {
+        for (const identifier of response.items) {
           let accessPolicy = void 0;
           if (identifier.accessPolicy) {
             accessPolicy = {
@@ -481,11 +512,14 @@ class ShareClient extends import_StorageClient.StorageClient {
           });
         }
         return (0, import_utils_common.assertResponse)(
-          await this.context.setAccessPolicy({
-            ...updatedOptions,
-            ...this.shareClientConfig,
-            shareAcl: acl
-          })
+          (0, import_utils_common.adjustResponse)(
+            await this.context.setAccessPolicy({
+              ...updatedOptions,
+              ...updatedOptions.leaseAccessConditions,
+              ...this.shareClientConfig,
+              shareAcl: { items: acl }
+            })
+          )
         );
       }
     );
@@ -498,11 +532,16 @@ class ShareClient extends import_StorageClient.StorageClient {
    */
   async createSnapshot(options = {}) {
     return import_tracing.tracingClient.withSpan("ShareClient-createSnapshot", options, async (updatedOptions) => {
+      const { metadata, ...restOptions } = updatedOptions;
+      const metadataHeaders = (0, import_models2.metadataToRawHeaders)(metadata);
       return (0, import_utils_common.assertResponse)(
-        await this.context.createSnapshot({
-          ...updatedOptions,
-          ...this.shareClientConfig
-        })
+        (0, import_utils_common.adjustResponse)(
+          await this.context.createSnapshot({
+            ...restOptions,
+            ...this.shareClientConfig,
+            requestOptions: { headers: metadataHeaders }
+          })
+        )
       );
     });
   }
@@ -518,11 +557,14 @@ class ShareClient extends import_StorageClient.StorageClient {
   async setQuota(quotaInGB, options = {}) {
     return import_tracing.tracingClient.withSpan("ShareClient-setQuota", options, async (updatedOptions) => {
       return (0, import_utils_common.assertResponse)(
-        await this.context.setProperties({
-          ...updatedOptions,
-          ...this.shareClientConfig,
-          quota: quotaInGB
-        })
+        (0, import_utils_common.adjustResponse)(
+          await this.context.setProperties({
+            ...updatedOptions,
+            ...updatedOptions.leaseAccessConditions,
+            ...this.shareClientConfig,
+            quota: quotaInGB
+          })
+        )
       );
     });
   }
@@ -535,12 +577,15 @@ class ShareClient extends import_StorageClient.StorageClient {
   async setProperties(options = {}) {
     return import_tracing.tracingClient.withSpan("ShareClient-setProperties", options, async (updatedOptions) => {
       return (0, import_utils_common.assertResponse)(
-        await this.context.setProperties({
-          ...options,
-          ...this.shareClientConfig,
-          quota: options.quotaInGB,
-          tracingOptions: updatedOptions.tracingOptions
-        })
+        (0, import_utils_common.adjustResponse)(
+          await this.context.setProperties({
+            ...options,
+            ...options.leaseAccessConditions,
+            ...this.shareClientConfig,
+            quota: options.quotaInGB,
+            tracingOptions: updatedOptions.tracingOptions
+          })
+        )
       );
     });
   }
@@ -553,10 +598,13 @@ class ShareClient extends import_StorageClient.StorageClient {
   async getStatistics(options = {}) {
     return import_tracing.tracingClient.withSpan("ShareClient-getStatistics", options, async (updatedOptions) => {
       const response = (0, import_utils_common.assertResponse)(
-        await this.context.getStatistics({
-          ...updatedOptions,
-          ...this.shareClientConfig
-        })
+        (0, import_utils_common.adjustResponse)(
+          await this.context.getStatistics({
+            ...updatedOptions,
+            ...updatedOptions.leaseAccessConditions,
+            ...this.shareClientConfig
+          })
+        )
       );
       const GBBytes = 1024 * 1024 * 1024;
       return { ...response, shareUsage: Math.ceil(response.shareUsageBytes / GBBytes) };
@@ -576,10 +624,12 @@ class ShareClient extends import_StorageClient.StorageClient {
       options,
       async (updatedOptions) => {
         return (0, import_utils_common.assertResponse)(
-          await this.context.createPermission((0, import_utils_common.asSharePermission)(filePermission), {
-            ...updatedOptions,
-            ...this.shareClientConfig
-          })
+          (0, import_utils_common.adjustResponse)(
+            await this.context.createPermission((0, import_utils_common.asSharePermission)(filePermission), {
+              ...updatedOptions,
+              ...this.shareClientConfig
+            })
+          )
         );
       }
     );
@@ -595,10 +645,12 @@ class ShareClient extends import_StorageClient.StorageClient {
   async getPermission(filePermissionKey, options = {}) {
     return import_tracing.tracingClient.withSpan("ShareClient-getPermission", options, async (updatedOptions) => {
       return (0, import_utils_common.assertResponse)(
-        await this.context.getPermission(filePermissionKey, {
-          ...updatedOptions,
-          ...this.shareClientConfig
-        })
+        (0, import_utils_common.adjustResponse)(
+          await this.context.getPermission(filePermissionKey, {
+            ...updatedOptions,
+            ...this.shareClientConfig
+          })
+        )
       );
     });
   }
@@ -767,26 +819,31 @@ class ShareDirectoryClient extends import_StorageClient.StorageClient {
       "ShareDirectoryClient-create",
       options,
       async (updatedOptions) => {
-        const rawResponse = await this.context.create({
-          ...updatedOptions,
-          fileChangeOn: (0, import_models2.fileChangeTimeToString)(updatedOptions.changeTime),
-          fileCreatedOn: (0, import_models2.fileCreationTimeToString)(updatedOptions.creationTime),
-          fileLastWriteOn: (0, import_models2.fileLastWriteTimeToString)(updatedOptions.lastWriteTime),
-          fileAttributes: updatedOptions.fileAttributes ? (0, import_models2.fileAttributesToString)(updatedOptions.fileAttributes) : void 0,
-          owner: updatedOptions.posixProperties?.owner,
-          group: updatedOptions.posixProperties?.group,
-          fileMode: (0, import_utils_common.toOctalFileMode)(updatedOptions.posixProperties?.fileMode),
-          ...this.shareClientConfig
-        });
+        const { metadata, ...restOptions } = updatedOptions;
+        const metadataHeaders = (0, import_models2.metadataToRawHeaders)(metadata);
+        const response = (0, import_utils_common.adjustResponse)(
+          await this.context.create({
+            ...restOptions,
+            fileChangeOn: (0, import_models2.fileChangeTimeToString)(updatedOptions.changeTime),
+            fileCreatedOn: (0, import_models2.fileCreationTimeToString)(updatedOptions.creationTime),
+            fileLastWriteOn: (0, import_models2.fileLastWriteTimeToString)(updatedOptions.lastWriteTime),
+            fileAttributes: updatedOptions.fileAttributes ? (0, import_models2.fileAttributesToString)(updatedOptions.fileAttributes) : void 0,
+            owner: updatedOptions.posixProperties?.owner,
+            group: updatedOptions.posixProperties?.group,
+            fileMode: (0, import_utils_common.toOctalFileMode)(updatedOptions.posixProperties?.fileMode),
+            ...this.shareClientConfig,
+            requestOptions: { headers: metadataHeaders }
+          })
+        );
         const wrappedRes = {
-          ...rawResponse,
-          _response: rawResponse._response,
+          ...response,
+          _response: response._response,
           // _response is made non-enumerable,
           posixProperties: {
-            fileMode: (0, import_utils_common.parseOctalFileMode)(rawResponse.fileMode),
-            fileType: rawResponse.nfsFileType,
-            owner: rawResponse.owner,
-            group: rawResponse.group
+            fileMode: (0, import_utils_common.parseOctalFileMode)(response.fileMode),
+            fileType: response.nfsFileType,
+            owner: response.owner,
+            group: response.group
           }
         };
         return (0, import_utils_common.assertResponse)(wrappedRes);
@@ -815,6 +872,7 @@ class ShareDirectoryClient extends import_StorageClient.StorageClient {
           if (e.details?.errorCode === "ResourceAlreadyExists") {
             return {
               succeeded: false,
+              errorCode: e.details?.errorCode,
               ...e.response?.parsedHeaders,
               _response: e.response
             };
@@ -837,26 +895,31 @@ class ShareDirectoryClient extends import_StorageClient.StorageClient {
       "ShareDirectoryClient-setProperties",
       properties,
       async (updatedOptions) => {
-        const rawResponse = await this.context.setProperties({
-          ...updatedOptions,
-          fileChangeOn: (0, import_models2.fileChangeTimeToString)(updatedOptions.changeTime),
-          fileCreatedOn: (0, import_models2.fileCreationTimeToString)(updatedOptions.creationTime),
-          fileLastWriteOn: (0, import_models2.fileLastWriteTimeToString)(updatedOptions.lastWriteTime),
-          fileAttributes: updatedOptions.fileAttributes ? (0, import_models2.fileAttributesToString)(updatedOptions.fileAttributes) : void 0,
-          owner: updatedOptions.posixProperties?.owner,
-          group: updatedOptions.posixProperties?.group,
-          fileMode: (0, import_utils_common.toOctalFileMode)(updatedOptions.posixProperties?.fileMode),
-          ...this.shareClientConfig
-        });
-        return (0, import_utils_common.assertResponse)({
-          ...rawResponse,
-          _response: rawResponse._response,
+        const response = (0, import_utils_common.adjustResponse)(
+          await this.context.setProperties({
+            ...updatedOptions,
+            fileChangeOn: (0, import_models2.fileChangeTimeToString)(updatedOptions.changeTime),
+            fileCreatedOn: (0, import_models2.fileCreationTimeToString)(updatedOptions.creationTime),
+            fileLastWriteOn: (0, import_models2.fileLastWriteTimeToString)(updatedOptions.lastWriteTime),
+            fileAttributes: updatedOptions.fileAttributes ? (0, import_models2.fileAttributesToString)(updatedOptions.fileAttributes) : void 0,
+            owner: updatedOptions.posixProperties?.owner,
+            group: updatedOptions.posixProperties?.group,
+            fileMode: (0, import_utils_common.toOctalFileMode)(updatedOptions.posixProperties?.fileMode),
+            ...this.shareClientConfig
+          })
+        );
+        const wrappedRes = {
+          ...response,
+          _response: response._response,
           posixProperties: {
-            fileMode: (0, import_utils_common.parseOctalFileMode)(rawResponse.fileMode),
-            owner: rawResponse.owner,
-            group: rawResponse.group
+            fileMode: (0, import_utils_common.parseOctalFileMode)(response.fileMode),
+            owner: response.owner,
+            group: response.group
           }
-        });
+        };
+        return (0, import_utils_common.assertResponse)(
+          wrappedRes
+        );
       }
     );
   }
@@ -1070,20 +1133,26 @@ class ShareDirectoryClient extends import_StorageClient.StorageClient {
       "ShareDirectoryClient-getProperties",
       options,
       async (updatedOptions) => {
-        const rawResponse = await this.context.getProperties({
-          ...updatedOptions,
-          ...this.shareClientConfig
-        });
-        return (0, import_utils_common.assertResponse)({
-          ...rawResponse,
-          _response: rawResponse._response,
+        const response = (0, import_utils_common.adjustResponse)(
+          await this.context.getProperties({
+            ...updatedOptions,
+            ...this.shareClientConfig
+          })
+        );
+        const wrappedRes = {
+          ...response,
+          _response: response._response,
+          metadata: (0, import_models2.rawHeadersToMetadata)(response._response.headers.rawHeaders()),
           posixProperties: {
-            fileMode: (0, import_utils_common.parseOctalFileMode)(rawResponse.fileMode),
-            owner: rawResponse.owner,
-            group: rawResponse.group,
-            fileType: rawResponse.nfsFileType
+            fileMode: (0, import_utils_common.parseOctalFileMode)(response.fileMode),
+            owner: response.owner,
+            group: response.group,
+            fileType: response.nfsFileType
           }
-        });
+        };
+        return (0, import_utils_common.assertResponse)(
+          wrappedRes
+        );
       }
     );
   }
@@ -1101,7 +1170,9 @@ class ShareDirectoryClient extends import_StorageClient.StorageClient {
       options,
       async (updatedOptions) => {
         return (0, import_utils_common.assertResponse)(
-          await this.context.delete({ ...updatedOptions, ...this.shareClientConfig })
+          (0, import_utils_common.adjustResponse)(
+            await this.context.delete({ ...updatedOptions, ...this.shareClientConfig })
+          )
         );
       }
     );
@@ -1128,6 +1199,7 @@ class ShareDirectoryClient extends import_StorageClient.StorageClient {
           if (e.details?.errorCode === "ResourceNotFound" || e.details?.errorCode === "ParentNotFound") {
             return {
               succeeded: false,
+              errorCode: e.details?.errorCode,
               ...e.response?.parsedHeaders,
               _response: e.response
             };
@@ -1150,12 +1222,15 @@ class ShareDirectoryClient extends import_StorageClient.StorageClient {
       "ShareDirectoryClient-setMetadata",
       options,
       async (updatedOptions) => {
+        const metadataHeaders = (0, import_models2.metadataToRawHeaders)(metadata);
         return (0, import_utils_common.assertResponse)(
-          await this.context.setMetadata({
-            ...updatedOptions,
-            metadata,
-            ...this.shareClientConfig
-          })
+          (0, import_utils_common.adjustResponse)(
+            await this.context.setMetadata({
+              ...updatedOptions,
+              ...this.shareClientConfig,
+              requestOptions: { headers: metadataHeaders }
+            })
+          )
         );
       }
     );
@@ -1420,18 +1495,20 @@ class ShareDirectoryClient extends import_StorageClient.StorageClient {
       "ShareDirectoryClient-listFilesAndDirectoriesSegment",
       options,
       async (updatedOptions) => {
-        const rawResponse = (0, import_utils_common.assertResponse)(
-          await this.context.listFilesAndDirectoriesSegment({
-            ...updatedOptions,
-            marker,
-            ...this.shareClientConfig
-          })
+        const response = (0, import_utils_common.assertResponse)(
+          (0, import_utils_common.adjustResponse)(
+            await this.context.listFilesAndDirectoriesSegment({
+              ...updatedOptions,
+              marker,
+              ...this.shareClientConfig
+            })
+          )
         );
         const wrappedResponse = {
-          ...(0, import_utils_common.ConvertInternalResponseOfListFiles)(rawResponse),
+          ...(0, import_utils_common.ConvertInternalResponseOfListFiles)(response),
           _response: {
-            ...rawResponse._response,
-            parsedBody: (0, import_utils_common.ConvertInternalResponseOfListFiles)(rawResponse._response.parsedBody)
+            ...response._response,
+            parsedBody: (0, import_utils_common.ConvertInternalResponseOfListFiles)(response._response.parsedBody)
           }
           // _response is made non-enumerable
         };
@@ -1641,11 +1718,13 @@ class ShareDirectoryClient extends import_StorageClient.StorageClient {
       async (updatedOptions) => {
         marker = marker === "" ? void 0 : marker;
         const response = (0, import_utils_common.assertResponse)(
-          await this.context.listHandles({
-            ...updatedOptions,
-            marker,
-            ...this.shareClientConfig
-          })
+          (0, import_utils_common.adjustResponse)(
+            await this.context.listHandles({
+              ...updatedOptions,
+              marker,
+              ...this.shareClientConfig
+            })
+          )
         );
         if (response.handleList === "") {
           response.handleList = void 0;
@@ -1680,17 +1759,19 @@ class ShareDirectoryClient extends import_StorageClient.StorageClient {
         if (marker === "") {
           marker = void 0;
         }
-        const rawResponse = (0, import_utils_common.assertResponse)(
-          await this.context.forceCloseHandles("*", {
-            ...updatedOptions,
-            marker,
-            ...this.shareClientConfig
-          })
+        const response = (0, import_utils_common.assertResponse)(
+          (0, import_utils_common.adjustResponse)(
+            await this.context.forceCloseHandles("*", {
+              ...updatedOptions,
+              marker,
+              ...this.shareClientConfig
+            })
+          )
         );
         return {
-          ...rawResponse,
-          closedHandlesCount: rawResponse.numberOfHandlesClosed ?? 0,
-          closeFailureCount: rawResponse.numberOfHandlesFailedToClose ?? 0
+          ...response,
+          closedHandlesCount: response.numberOfHandlesClosed ?? 0,
+          closeFailureCount: response.numberOfHandlesFailedToClose ?? 0
         };
       }
     );
@@ -1746,10 +1827,12 @@ class ShareDirectoryClient extends import_StorageClient.StorageClient {
             `Parameter handleID should be a specified handle ID. Use forceCloseHandlesSegment() to close all handles.`
           );
         }
-        const rawResponse = await this.context.forceCloseHandles(handleId, {
-          ...updatedOptions,
-          ...this.shareClientConfig
-        });
+        const rawResponse = (0, import_utils_common.adjustResponse)(
+          await this.context.forceCloseHandles(handleId, {
+            ...updatedOptions,
+            ...this.shareClientConfig
+          })
+        );
         const response = rawResponse;
         response.closedHandlesCount = rawResponse.numberOfHandlesClosed || 0;
         response.closeFailureCount = rawResponse.numberOfHandlesFailedToClose || 0;
@@ -1811,17 +1894,19 @@ class ShareDirectoryClient extends import_StorageClient.StorageClient {
       "ShareDirectoryClient-rename",
       options,
       async (updatedOptions) => {
+        const { metadata, ...restOptions } = updatedOptions;
+        const metadataHeaders = (0, import_models2.metadataToRawHeaders)(metadata);
         const response = (0, import_utils_common.assertResponse)(
-          await destDirectory.context.rename(this.url, {
-            ...updatedOptions,
-            sourceLeaseAccessConditions: updatedOptions.sourceLeaseAccessConditions ? {
-              sourceLeaseId: updatedOptions.sourceLeaseAccessConditions.leaseId
-            } : void 0,
-            destinationLeaseAccessConditions: updatedOptions.destinationLeaseAccessConditions ? {
-              destinationLeaseId: updatedOptions.destinationLeaseAccessConditions.leaseId
-            } : void 0,
-            ...this.shareClientConfig
-          })
+          (0, import_utils_common.adjustResponse)(
+            await destDirectory.context.rename(this.url, {
+              ...restOptions,
+              ...updatedOptions.copyFileSmbInfo,
+              sourceLeaseId: updatedOptions.sourceLeaseAccessConditions?.leaseId,
+              destinationLeaseId: updatedOptions.destinationLeaseAccessConditions?.leaseId,
+              ...this.shareClientConfig,
+              requestOptions: { headers: metadataHeaders }
+            })
+          )
         );
         return {
           destinationDirectoryClient: destDirectory,
@@ -1938,8 +2023,12 @@ class ShareFileClient extends import_StorageClient.StorageClient {
     options = (0, import_models2.validateAndSetDefaultsForFileAndDirectoryCreateCommonOptions)(options);
     options.fileHttpHeaders = options.fileHttpHeaders || {};
     return import_tracing.tracingClient.withSpan("ShareFileClient-create", options, async (updatedOptions) => {
+      const { metadata, ...restOptions } = updatedOptions;
+      const metadataHeaders = (0, import_models2.metadataToRawHeaders)(metadata);
       const parameters = {
-        ...updatedOptions,
+        ...restOptions,
+        ...updatedOptions.leaseAccessConditions,
+        ...updatedOptions.fileHttpHeaders,
         fileChangeOn: (0, import_models2.fileChangeTimeToString)(updatedOptions.changeTime),
         fileCreatedOn: (0, import_models2.fileCreationTimeToString)(updatedOptions.creationTime),
         fileLastWriteOn: (0, import_models2.fileLastWriteTimeToString)(updatedOptions.lastWriteTime),
@@ -1967,16 +2056,21 @@ class ShareFileClient extends import_StorageClient.StorageClient {
         parameters.body = createChecksumBody.body;
         parameters.contentLength = createChecksumBody.contentLength;
       }
-      const rawResponse = await this.context.create(size, parameters);
+      const response = (0, import_utils_common.adjustResponse)(
+        await this.context.create(size, {
+          ...parameters,
+          requestOptions: { headers: metadataHeaders }
+        })
+      );
       const wrappedRes = {
-        ...rawResponse,
-        _response: rawResponse._response,
+        ...response,
+        _response: response._response,
         // _response is made non-enumerable,
         posixProperties: {
-          fileMode: (0, import_utils_common.parseOctalFileMode)(rawResponse.fileMode),
-          fileType: rawResponse.nfsFileType,
-          owner: rawResponse.owner,
-          group: rawResponse.group
+          fileMode: (0, import_utils_common.parseOctalFileMode)(response.fileMode),
+          fileType: response.nfsFileType,
+          owner: response.owner,
+          group: response.group
         }
       };
       return (0, import_utils_common.assertResponse)(wrappedRes);
@@ -2066,66 +2160,68 @@ class ShareFileClient extends import_StorageClient.StorageClient {
         throw new RangeError(`rangeGetContentMD5 only works with partial data downloading`);
       }
       const downloadFullFile = offset === 0 && !count;
-      const rawResponse = await this.context.download({
-        ...updatedOptions,
-        requestOptions: {
-          onDownloadProgress: import_core_util.isNodeLike ? void 0 : updatedOptions.onProgress
-          // for Node.js, progress is reported by RetriableReadableStream
-        },
-        range: downloadFullFile ? void 0 : (0, import_Range.rangeToString)({ offset, count }),
-        ...this.shareClientConfig,
-        structuredBodyType: contentChecksumAlgorithm === "StorageCrc64" ? "XSM/1.0; properties=crc64" : void 0
-      });
-      const res = (0, import_utils_common.assertResponse)({
-        ...rawResponse,
-        _response: rawResponse._response,
-        // _response is made non-enumerable,
+      const response = (0, import_utils_common.adjustResponse)(
+        await this.context.download({
+          ...updatedOptions,
+          ...updatedOptions.leaseAccessConditions,
+          requestOptions: {
+            onDownloadProgress: import_core_util.isNodeLike ? void 0 : updatedOptions.onProgress
+            // for Node.js, progress is reported by RetriableReadableStream
+          },
+          range: downloadFullFile ? void 0 : (0, import_Range.rangeToString)({ offset, count }),
+          ...this.shareClientConfig,
+          structuredBodyType: contentChecksumAlgorithm === "StorageCrc64" ? "XSM/1.0; properties=crc64" : void 0
+        })
+      );
+      const wrappedRes = {
+        ...response,
+        _response: response._response,
+        // _response is made non-enumerable
+        metadata: (0, import_models2.rawHeadersToMetadata)(response._response.headers.rawHeaders()),
         posixProperties: {
-          fileMode: (0, import_utils_common.parseOctalFileMode)(rawResponse.fileMode),
-          owner: rawResponse.owner,
-          group: rawResponse.group,
-          linkCount: rawResponse.linkCount
-        }
-      });
+          fileMode: (0, import_utils_common.parseOctalFileMode)(response.fileMode),
+          owner: response.owner,
+          group: response.group,
+          linkCount: response.linkCount
+        },
+        leaseDuration: response.leaseDuration ? response.leaseDuration : void 0,
+        leaseState: response.leaseState ? response.leaseState : void 0,
+        leaseStatus: response.leaseStatus ? response.leaseStatus : void 0
+      };
       if (!import_core_util.isNodeLike) {
         if (contentChecksumAlgorithm === "StorageCrc64") {
-          res.blobBody = (0, import_storage_common4.structuredMessageDecodingBrowser)(await res.blobBody);
+          wrappedRes.blobBody = (0, import_storage_common4.structuredMessageDecodingBrowser)(await wrappedRes.blobBody);
         }
-        return res;
+        return wrappedRes;
       }
       if (updatedOptions.maxRetryRequests === void 0 || updatedOptions.maxRetryRequests < 0) {
         updatedOptions.maxRetryRequests = import_constants.DEFAULT_MAX_DOWNLOAD_RETRY_REQUESTS;
       }
-      if (res.contentLength === void 0) {
+      if (wrappedRes.contentLength === void 0) {
         throw new RangeError(`File download response doesn't contain valid content length header`);
       }
-      const contentLength = contentChecksumAlgorithm === "StorageCrc64" ? res.structuredContentLength : res.contentLength;
+      const contentLength = contentChecksumAlgorithm === "StorageCrc64" ? wrappedRes.structuredContentLength : wrappedRes.contentLength;
       return new import_FileDownloadResponse.FileDownloadResponse(
-        res,
+        wrappedRes,
         async (start) => {
           const updatedDownloadOptions = {
+            ...updatedOptions,
             range: (0, import_Range.rangeToString)({
               count: offset + contentLength - start,
               offset: start
-            })
-          };
-          const downloadRes = await this.context.download({
-            ...updatedOptions,
-            ...updatedDownloadOptions,
+            }),
             ...this.shareClientConfig,
-            // TODO: confirm whether this is needed
             structuredBodyType: contentChecksumAlgorithm === "StorageCrc64" ? "XSM/1.0; properties=crc64" : void 0
-          });
-          if (!(downloadRes.etag === res.etag)) {
+          };
+          const downloadRes = await this.context.download(updatedDownloadOptions);
+          if (!(downloadRes.etag === wrappedRes.etag)) {
             throw new Error("File has been modified concurrently");
           }
+          const resBody = downloadRes.readableStreamBody;
           if (contentChecksumAlgorithm === "StorageCrc64") {
-            return (0, import_storage_common4.structuredMessageDecodingStream)(
-              downloadRes.readableStreamBody,
-              {}
-            );
+            return (0, import_storage_common4.structuredMessageDecodingStream)(resBody, {});
           } else {
-            return downloadRes.readableStreamBody;
+            return resBody;
           }
         },
         offset,
@@ -2172,22 +2268,30 @@ class ShareFileClient extends import_StorageClient.StorageClient {
       "ShareFileClient-getProperties",
       options,
       async (updatedOptions) => {
-        const rawResponse = await this.context.getProperties({
-          ...updatedOptions,
-          ...this.shareClientConfig
-        });
-        return (0, import_utils_common.assertResponse)({
-          ...rawResponse,
-          _response: rawResponse._response,
+        const response = (0, import_utils_common.adjustResponse)(
+          await this.context.getProperties({
+            ...updatedOptions,
+            ...updatedOptions.leaseAccessConditions,
+            ...this.shareClientConfig
+          })
+        );
+        const wrappedRes = {
+          ...response,
+          _response: response._response,
           // _response is made non-enumerable,
+          metadata: (0, import_models2.rawHeadersToMetadata)(response._response.headers.rawHeaders()),
           posixProperties: {
-            fileMode: (0, import_utils_common.parseOctalFileMode)(rawResponse.fileMode),
-            fileType: rawResponse.nfsFileType,
-            owner: rawResponse.owner,
-            group: rawResponse.group,
-            linkCount: rawResponse.linkCount
-          }
-        });
+            fileMode: (0, import_utils_common.parseOctalFileMode)(response.fileMode),
+            fileType: response.nfsFileType,
+            owner: response.owner,
+            group: response.group,
+            linkCount: response.linkCount
+          },
+          leaseDuration: response.leaseDuration ? response.leaseDuration : void 0,
+          leaseState: response.leaseState ? response.leaseState : void 0,
+          leaseStatus: response.leaseStatus ? response.leaseStatus : void 0
+        };
+        return (0, import_utils_common.assertResponse)(wrappedRes);
       }
     );
   }
@@ -2207,28 +2311,33 @@ class ShareFileClient extends import_StorageClient.StorageClient {
       "ShareFileClient-setProperties",
       properties,
       async (updatedOptions) => {
-        const rawResponse = await this.context.setHttpHeaders({
-          ...updatedOptions,
-          fileChangeOn: (0, import_models2.fileChangeTimeToString)(updatedOptions.changeTime),
-          fileCreatedOn: (0, import_models2.fileCreationTimeToString)(updatedOptions.creationTime),
-          fileLastWriteOn: (0, import_models2.fileLastWriteTimeToString)(updatedOptions.lastWriteTime),
-          fileAttributes: updatedOptions.fileAttributes ? (0, import_models2.fileAttributesToString)(updatedOptions.fileAttributes) : void 0,
-          owner: updatedOptions.posixProperties?.owner,
-          group: updatedOptions.posixProperties?.group,
-          fileMode: (0, import_utils_common.toOctalFileMode)(updatedOptions.posixProperties?.fileMode),
-          ...this.shareClientConfig
-        });
-        return (0, import_utils_common.assertResponse)({
-          ...rawResponse,
-          _response: rawResponse._response,
+        const response = (0, import_utils_common.adjustResponse)(
+          await this.context.setHttpHeaders({
+            ...updatedOptions,
+            ...updatedOptions.leaseAccessConditions,
+            ...updatedOptions.fileHttpHeaders,
+            fileChangeOn: (0, import_models2.fileChangeTimeToString)(updatedOptions.changeTime),
+            fileCreatedOn: (0, import_models2.fileCreationTimeToString)(updatedOptions.creationTime),
+            fileLastWriteOn: (0, import_models2.fileLastWriteTimeToString)(updatedOptions.lastWriteTime),
+            fileAttributes: updatedOptions.fileAttributes ? (0, import_models2.fileAttributesToString)(updatedOptions.fileAttributes) : void 0,
+            owner: updatedOptions.posixProperties?.owner,
+            group: updatedOptions.posixProperties?.group,
+            fileMode: (0, import_utils_common.toOctalFileMode)(updatedOptions.posixProperties?.fileMode),
+            ...this.shareClientConfig
+          })
+        );
+        const wrappedRes = {
+          ...response,
+          _response: response._response,
           // _response is made non-enumerable,
           posixProperties: {
-            fileMode: (0, import_utils_common.parseOctalFileMode)(rawResponse.fileMode),
-            owner: rawResponse.owner,
-            group: rawResponse.group,
-            linkCount: rawResponse.linkCount
+            fileMode: (0, import_utils_common.parseOctalFileMode)(response.fileMode),
+            owner: response.owner,
+            group: response.group,
+            linkCount: response.linkCount
           }
-        });
+        };
+        return (0, import_utils_common.assertResponse)(wrappedRes);
       }
     );
   }
@@ -2252,7 +2361,13 @@ class ShareFileClient extends import_StorageClient.StorageClient {
   async delete(options = {}) {
     return import_tracing.tracingClient.withSpan("ShareFileClient-delete", options, async (updatedOptions) => {
       return (0, import_utils_common.assertResponse)(
-        await this.context.delete({ ...updatedOptions, ...this.shareClientConfig })
+        (0, import_utils_common.adjustResponse)(
+          await this.context.delete({
+            ...updatedOptions,
+            ...updatedOptions.leaseAccessConditions,
+            ...this.shareClientConfig
+          })
+        )
       );
     });
   }
@@ -2287,6 +2402,7 @@ class ShareFileClient extends import_StorageClient.StorageClient {
           if (e.details?.errorCode === "ResourceNotFound" || e.details?.errorCode === "ParentNotFound") {
             return {
               succeeded: false,
+              errorCode: e.details?.errorCode,
               ...e.response?.parsedHeaders,
               _response: e.response
             };
@@ -2314,29 +2430,33 @@ class ShareFileClient extends import_StorageClient.StorageClient {
       "ShareFileClient-setHTTPHeaders",
       options,
       async (updatedOptions) => {
-        const rawResponse = await this.context.setHttpHeaders({
-          ...updatedOptions,
-          fileHttpHeaders,
-          fileCreatedOn: (0, import_models2.fileCreationTimeToString)(updatedOptions.creationTime),
-          fileLastWriteOn: (0, import_models2.fileLastWriteTimeToString)(updatedOptions.lastWriteTime),
-          fileChangeOn: (0, import_models2.fileChangeTimeToString)(updatedOptions.changeTime),
-          fileAttributes: updatedOptions.fileAttributes ? (0, import_models2.fileAttributesToString)(updatedOptions.fileAttributes) : void 0,
-          owner: updatedOptions.posixProperties?.owner,
-          group: updatedOptions.posixProperties?.group,
-          fileMode: (0, import_utils_common.toOctalFileMode)(updatedOptions.posixProperties?.fileMode),
-          ...this.shareClientConfig
-        });
-        return (0, import_utils_common.assertResponse)({
-          ...rawResponse,
-          _response: rawResponse._response,
+        const response = (0, import_utils_common.adjustResponse)(
+          await this.context.setHttpHeaders({
+            ...updatedOptions,
+            ...updatedOptions.leaseAccessConditions,
+            ...fileHttpHeaders,
+            fileCreatedOn: (0, import_models2.fileCreationTimeToString)(updatedOptions.creationTime),
+            fileLastWriteOn: (0, import_models2.fileLastWriteTimeToString)(updatedOptions.lastWriteTime),
+            fileChangeOn: (0, import_models2.fileChangeTimeToString)(updatedOptions.changeTime),
+            fileAttributes: updatedOptions.fileAttributes ? (0, import_models2.fileAttributesToString)(updatedOptions.fileAttributes) : void 0,
+            owner: updatedOptions.posixProperties?.owner,
+            group: updatedOptions.posixProperties?.group,
+            fileMode: (0, import_utils_common.toOctalFileMode)(updatedOptions.posixProperties?.fileMode),
+            ...this.shareClientConfig
+          })
+        );
+        const wrappedRes = {
+          ...response,
+          _response: response._response,
           // _response is made non-enumerable,
           posixProperties: {
-            fileMode: (0, import_utils_common.parseOctalFileMode)(rawResponse.fileMode),
-            owner: rawResponse.owner,
-            group: rawResponse.group,
-            linkCount: rawResponse.linkCount
+            fileMode: (0, import_utils_common.parseOctalFileMode)(response.fileMode),
+            owner: response.owner,
+            group: response.group,
+            linkCount: response.linkCount
           }
-        });
+        };
+        return (0, import_utils_common.assertResponse)(wrappedRes);
       }
     );
   }
@@ -2357,28 +2477,32 @@ class ShareFileClient extends import_StorageClient.StorageClient {
     }
     options = (0, import_models2.validateAndSetDefaultsForFileAndDirectorySetPropertiesCommonOptions)(options);
     return import_tracing.tracingClient.withSpan("ShareFileClient-resize", options, async (updatedOptions) => {
-      const rawResponse = await this.context.setHttpHeaders({
-        ...updatedOptions,
-        fileContentLength: length,
-        fileChangeOn: (0, import_models2.fileChangeTimeToString)(options.changeTime),
-        fileCreatedOn: (0, import_models2.fileCreationTimeToString)(options.creationTime),
-        fileLastWriteOn: (0, import_models2.fileLastWriteTimeToString)(options.lastWriteTime),
-        fileAttributes: (0, import_models2.fileAttributesToString)(updatedOptions.fileAttributes),
-        owner: updatedOptions.posixProperties?.owner,
-        group: updatedOptions.posixProperties?.group,
-        fileMode: (0, import_utils_common.toOctalFileMode)(options.posixProperties?.fileMode),
-        ...this.shareClientConfig
-      });
-      return (0, import_utils_common.assertResponse)({
-        ...rawResponse,
-        _response: rawResponse._response,
+      const response = (0, import_utils_common.adjustResponse)(
+        await this.context.setHttpHeaders({
+          ...updatedOptions,
+          ...updatedOptions.leaseAccessConditions,
+          fileContentLength: length,
+          fileChangeOn: (0, import_models2.fileChangeTimeToString)(options.changeTime),
+          fileCreatedOn: (0, import_models2.fileCreationTimeToString)(options.creationTime),
+          fileLastWriteOn: (0, import_models2.fileLastWriteTimeToString)(options.lastWriteTime),
+          fileAttributes: (0, import_models2.fileAttributesToString)(updatedOptions.fileAttributes),
+          owner: updatedOptions.posixProperties?.owner,
+          group: updatedOptions.posixProperties?.group,
+          fileMode: (0, import_utils_common.toOctalFileMode)(options.posixProperties?.fileMode),
+          ...this.shareClientConfig
+        })
+      );
+      const wrappedRes = {
+        ...response,
+        _response: response._response,
         posixProperties: {
-          fileMode: (0, import_utils_common.parseOctalFileMode)(rawResponse.fileMode),
-          owner: rawResponse.owner,
-          group: rawResponse.group,
-          linkCount: rawResponse.linkCount
+          fileMode: (0, import_utils_common.parseOctalFileMode)(response.fileMode),
+          owner: response.owner,
+          group: response.group,
+          linkCount: response.linkCount
         }
-      });
+      };
+      return (0, import_utils_common.assertResponse)(wrappedRes);
     });
   }
   /**
@@ -2397,12 +2521,16 @@ class ShareFileClient extends import_StorageClient.StorageClient {
       "ShareFileClient-setMetadata",
       options,
       async (updatedOptions) => {
+        const metadataHeaders = (0, import_models2.metadataToRawHeaders)(metadata);
         return (0, import_utils_common.assertResponse)(
-          await this.context.setMetadata({
-            ...updatedOptions,
-            metadata,
-            ...this.shareClientConfig
-          })
+          (0, import_utils_common.adjustResponse)(
+            await this.context.setMetadata({
+              ...updatedOptions,
+              ...updatedOptions.leaseAccessConditions,
+              ...this.shareClientConfig,
+              requestOptions: { headers: metadataHeaders }
+            })
+          )
         );
       }
     );
@@ -2467,6 +2595,7 @@ class ShareFileClient extends import_StorageClient.StorageClient {
         }
         const parameters = {
           ...updatedOptions,
+          ...updatedOptions.leaseAccessConditions,
           requestOptions: {
             onUploadProgress: updatedOptions.onProgress
           },
@@ -2480,7 +2609,7 @@ class ShareFileClient extends import_StorageClient.StorageClient {
           this.shareClientConfig?.uploadContentChecksumAlgorithm
         );
         parameters.body = uploadBodyParameters.body;
-        return (0, import_utils_common.assertResponse)(
+        const response = (0, import_utils_common.adjustResponse)(
           await this.context.uploadRange(
             (0, import_Range.rangeToString)({ count: contentLength, offset }),
             "update",
@@ -2488,6 +2617,7 @@ class ShareFileClient extends import_StorageClient.StorageClient {
             parameters
           )
         );
+        return (0, import_utils_common.assertResponse)(response);
       }
     );
   }
@@ -2512,15 +2642,19 @@ class ShareFileClient extends import_StorageClient.StorageClient {
         if (count <= 0 || count > import_constants.FILE_RANGE_MAX_SIZE_BYTES) {
           throw new RangeError(`count must be > 0 and <= ${import_constants.FILE_RANGE_MAX_SIZE_BYTES} bytes`);
         }
-        return (0, import_utils_common.assertResponse)(
-          await this.context.uploadRangeFromURL(
+        const response = (0, import_utils_common.adjustResponse)(
+          await this.context.uploadRangeFromUrl(
             (0, import_Range.rangeToString)({ offset: destOffset, count }),
             sourceURL,
+            "update",
             0,
             {
               ...updatedOptions,
+              ...updatedOptions.leaseAccessConditions,
+              sourceContentCrc64: updatedOptions.sourceContentCrc64,
+              sourceIfMatchCrc64: updatedOptions.sourceConditions?.sourceIfMatchCrc64,
+              sourceIfNoneMatchCrc64: updatedOptions.sourceConditions?.sourceIfNoneMatchCrc64,
               sourceRange: (0, import_Range.rangeToString)({ offset: sourceOffset, count }),
-              sourceModifiedAccessConditions: updatedOptions.sourceConditions,
               copySourceAuthorization: (0, import_utils_common.httpAuthorizationToString)(
                 updatedOptions.sourceAuthorization
               ),
@@ -2528,6 +2662,14 @@ class ShareFileClient extends import_StorageClient.StorageClient {
             }
           )
         );
+        const wrappedRes = {
+          ...response,
+          _response: response._response
+          // _response is made non-enumerable,
+        };
+        return (0, import_utils_common.assertResponse)(
+          wrappedRes
+        );
       }
     );
   }
@@ -2545,11 +2687,17 @@ class ShareFileClient extends import_StorageClient.StorageClient {
         throw new RangeError(`offset must >= 0 and contentLength must be > 0`);
       }
       return (0, import_utils_common.assertResponse)(
-        await this.context.uploadRange(
-          (0, import_Range.rangeToString)({ count: contentLength, offset }),
-          "clear",
-          0,
-          { ...updatedOptions, ...this.shareClientConfig }
+        (0, import_utils_common.adjustResponse)(
+          await this.context.uploadRange(
+            (0, import_Range.rangeToString)({ count: contentLength, offset }),
+            "clear",
+            0,
+            {
+              ...updatedOptions,
+              ...updatedOptions.leaseAccessConditions,
+              ...this.shareClientConfig
+            }
+          )
         )
       );
     });
@@ -2557,6 +2705,9 @@ class ShareFileClient extends import_StorageClient.StorageClient {
   /**
    * Returns the list of valid ranges for a file.
    *
+   * @deprecated Use {@link ShareFileClient.listRanges} instead, which returns a paginated
+   * async iterable and supports files with a large number of ranges.
+   *
    * @param options - Options to File Get range List operation.
    */
   async getRangeList(options = {}) {
@@ -2565,11 +2716,14 @@ class ShareFileClient extends import_StorageClient.StorageClient {
       options,
       async (updatedOptions) => {
         const originalResponse = (0, import_utils_common.assertResponse)(
-          await this.context.getRangeList({
-            ...updatedOptions,
-            range: updatedOptions.range ? (0, import_Range.rangeToString)(updatedOptions.range) : void 0,
-            ...this.shareClientConfig
-          })
+          (0, import_utils_common.adjustResponse)(
+            await this.context.getRangeList({
+              ...updatedOptions,
+              ...updatedOptions.leaseAccessConditions,
+              range: updatedOptions.range ? (0, import_Range.rangeToString)(updatedOptions.range) : void 0,
+              ...this.shareClientConfig
+            })
+          )
         );
         const parsedBody = originalResponse._response.parsedBody.ranges ? originalResponse._response.parsedBody.ranges : [];
         return {
@@ -2583,6 +2737,9 @@ class ShareFileClient extends import_StorageClient.StorageClient {
   /**
    * Returns the list of ranges that differ between a previous share snapshot and this file.
    *
+   * @deprecated Use {@link ShareFileClient.listRangesDiff} instead, which returns a paginated
+   * async iterable and supports files with a large number of ranges.
+   *
    * @param prevShareSnapshot - The previous snapshot parameter is an opaque DateTime value that specifies the previous share snapshot to compare with.
    * @param options -
    */
@@ -2592,17 +2749,152 @@ class ShareFileClient extends import_StorageClient.StorageClient {
       options,
       async (updatedOptions) => {
         return (0, import_utils_common.assertResponse)(
-          await this.context.getRangeList({
-            ...updatedOptions,
-            prevsharesnapshot: prevShareSnapshot,
-            supportRename: options.includeRenames,
-            range: updatedOptions.range ? (0, import_Range.rangeToString)(updatedOptions.range) : void 0,
-            ...this.shareClientConfig
-          })
+          (0, import_utils_common.adjustResponse)(
+            await this.context.getRangeList({
+              ...updatedOptions,
+              ...updatedOptions.leaseAccessConditions,
+              prevsharesnapshot: prevShareSnapshot,
+              supportRename: options.includeRenames,
+              range: updatedOptions.range ? (0, import_Range.rangeToString)(updatedOptions.range) : void 0,
+              ...this.shareClientConfig
+            })
+          )
         );
       }
     );
   }
+  /**
+   * Returns the list of valid ranges for a file, as a paginated async iterable.
+   *
+   * `.byPage()` returns an async iterable iterator to list the ranges in pages.
+   *
+   * @see https://learn.microsoft.com/rest/api/storageservices/list-ranges
+   *
+   * @param options - Options to the File List Ranges operation.
+   * @returns An asyncIterableIterator that supports paging.
+   */
+  listRanges(options = {}) {
+    const iter = this.listRangeItems(options);
+    return {
+      /**
+       * The next method, part of the iteration protocol
+       */
+      async next() {
+        return iter.next();
+      },
+      /**
+       * The connection to the async iterator, part of the iteration protocol
+       */
+      [Symbol.asyncIterator]() {
+        return this;
+      },
+      /**
+       * Return an AsyncIterableIterator that works a page at a time
+       */
+      byPage: (settings = {}) => {
+        return this.iterateRangeSegments((0, import_utils_common.removeEmptyString)(settings.continuationToken), {
+          maxPageSize: settings.maxPageSize,
+          ...options
+        });
+      }
+    };
+  }
+  /**
+   * Returns the list of ranges that differ between a previous share snapshot and this file,
+   * as a paginated async iterable.
+   *
+   * `.byPage()` returns an async iterable iterator to list the ranges in pages.
+   *
+   * @see https://learn.microsoft.com/rest/api/storageservices/list-ranges
+   *
+   * @param prevShareSnapshot - The previous snapshot parameter is an opaque DateTime value that specifies the previous share snapshot to compare with.
+   * @param options - Options to the File List Ranges Diff operation.
+   * @returns An asyncIterableIterator that supports paging.
+   */
+  listRangesDiff(prevShareSnapshot, options = {}) {
+    const iter = this.listRangeItems({ ...options, prevShareSnapshot });
+    return {
+      /**
+       * The next method, part of the iteration protocol
+       */
+      async next() {
+        return iter.next();
+      },
+      /**
+       * The connection to the async iterator, part of the iteration protocol
+       */
+      [Symbol.asyncIterator]() {
+        return this;
+      },
+      /**
+       * Return an AsyncIterableIterator that works a page at a time
+       */
+      byPage: (settings = {}) => {
+        return this.iterateRangeSegments((0, import_utils_common.removeEmptyString)(settings.continuationToken), {
+          maxPageSize: settings.maxPageSize,
+          ...options,
+          prevShareSnapshot
+        });
+      }
+    };
+  }
+  /**
+   * Returns an AsyncIterableIterator for {@link ShareFileRange} items.
+   *
+   * @param options - Options to the File List Ranges operation.
+   */
+  async *listRangeItems(options = {}) {
+    for await (const segment of this.iterateRangeSegments(void 0, options)) {
+      yield* (0, import_utils_common.extractShareFileRangeItems)(segment.ranges, segment.clearRanges);
+    }
+  }
+  /**
+   * Returns an AsyncIterableIterator for {@link FileListRangesSegmentResponse} objects.
+   *
+   * @param marker - A string value that identifies the portion of the list to be returned with the next list operation.
+   * @param options - Options to the File List Ranges operation.
+   */
+  async *iterateRangeSegments(marker, options = {}) {
+    let rangeSegment;
+    do {
+      rangeSegment = await this.listRangeSegment(marker, options);
+      marker = rangeSegment.continuationToken;
+      yield await rangeSegment;
+    } while (marker);
+  }
+  /**
+   * Returns a single segment of ranges for a file, starting from the specified marker.
+   *
+   * @param marker - A string value that identifies the portion of the list to be returned with the next list operation.
+   * @param options - Options to the File List Ranges operation.
+   */
+  async listRangeSegment(marker, options = {}) {
+    return import_tracing.tracingClient.withSpan(
+      "ShareFileClient-listRangeSegment",
+      options,
+      async (updatedOptions) => {
+        const response = (0, import_utils_common.assertResponse)(
+          (0, import_utils_common.adjustResponse)(
+            await this.context.listAllRanges({
+              ...updatedOptions,
+              ...updatedOptions.leaseAccessConditions,
+              marker: marker === "" ? void 0 : marker,
+              maxResults: updatedOptions.maxPageSize,
+              prevsharesnapshot: updatedOptions.prevShareSnapshot,
+              supportRename: updatedOptions.includeRenames,
+              range: updatedOptions.range ? (0, import_Range.rangeToString)(updatedOptions.range) : void 0,
+              ...this.shareClientConfig
+            })
+          )
+        );
+        const wrappedResponse = {
+          ...response,
+          continuationToken: response.nextMarker ? response.nextMarker : void 0
+        };
+        return wrappedResponse;
+      }
+    );
+  }
   /**
    * Copies a blob or file to a destination file within the storage account.
    *
@@ -2621,15 +2913,20 @@ class ShareFileClient extends import_StorageClient.StorageClient {
       options,
       async (updatedOptions) => {
         return (0, import_utils_common.assertResponse)(
-          await this.context.startCopy(copySource, {
-            ...updatedOptions,
-            ...this.shareClientConfig,
-            owner: updatedOptions.posixProperties?.owner,
-            group: updatedOptions.posixProperties?.group,
-            fileMode: (0, import_utils_common.toOctalFileMode)(updatedOptions.posixProperties?.fileMode),
-            fileModeCopyMode: updatedOptions.fileModeCopyMode,
-            fileOwnerCopyMode: updatedOptions.fileOwnerCopyMode
-          })
+          (0, import_utils_common.adjustResponse)(
+            await this.context.startCopy(copySource, {
+              ...updatedOptions,
+              ...updatedOptions.leaseAccessConditions,
+              ...updatedOptions.copyFileSmbInfo,
+              ...updatedOptions.posixProperties,
+              ...this.shareClientConfig,
+              owner: updatedOptions.posixProperties?.owner,
+              group: updatedOptions.posixProperties?.group,
+              fileMode: (0, import_utils_common.toOctalFileMode)(updatedOptions.posixProperties?.fileMode),
+              fileModeCopyMode: updatedOptions.fileModeCopyMode,
+              fileOwnerCopyMode: updatedOptions.fileOwnerCopyMode
+            })
+          )
         );
       }
     );
@@ -2648,7 +2945,13 @@ class ShareFileClient extends import_StorageClient.StorageClient {
       options,
       async (updatedOptions) => {
         return (0, import_utils_common.assertResponse)(
-          await this.context.abortCopy(copyId, { ...updatedOptions, ...this.shareClientConfig })
+          (0, import_utils_common.adjustResponse)(
+            await this.context.abortCopy(copyId, {
+              ...updatedOptions,
+              ...updatedOptions.leaseAccessConditions,
+              ...this.shareClientConfig
+            })
+          )
         );
       }
     );
@@ -3030,11 +3333,14 @@ class ShareFileClient extends import_StorageClient.StorageClient {
       async (updatedOptions) => {
         marker = marker === "" ? void 0 : marker;
         const response = (0, import_utils_common.assertResponse)(
-          await this.context.listHandles({
-            ...updatedOptions,
-            ...this.shareClientConfig,
-            marker
-          })
+          (0, import_utils_common.adjustResponse)(
+            await this.context.listHandles({
+              ...updatedOptions,
+              maxResults: updatedOptions.maxPageSize,
+              ...this.shareClientConfig,
+              marker
+            })
+          )
         );
         if (response.handleList === "") {
           response.handleList = void 0;
@@ -3138,11 +3444,13 @@ class ShareFileClient extends import_StorageClient.StorageClient {
       options,
       async (updatedOptions) => {
         marker = marker === "" ? void 0 : marker;
-        const rawResponse = await this.context.forceCloseHandles("*", {
-          ...updatedOptions,
-          ...this.shareClientConfig,
-          marker
-        });
+        const rawResponse = (0, import_utils_common.adjustResponse)(
+          await this.context.forceCloseHandles("*", {
+            ...updatedOptions,
+            ...this.shareClientConfig,
+            marker
+          })
+        );
         const response = rawResponse;
         response.closedHandlesCount = rawResponse.numberOfHandlesClosed || 0;
         response.closeFailureCount = rawResponse.numberOfHandlesFailedToClose || 0;
@@ -3202,10 +3510,12 @@ class ShareFileClient extends import_StorageClient.StorageClient {
             `Parameter handleID should be a specified handle ID. Use forceCloseHandlesSegment() to close all handles.`
           );
         }
-        const rawResponse = await this.context.forceCloseHandles(handleId, {
-          ...updatedOptions,
-          ...this.shareClientConfig
-        });
+        const rawResponse = (0, import_utils_common.adjustResponse)(
+          await this.context.forceCloseHandles(handleId, {
+            ...updatedOptions,
+            ...this.shareClientConfig
+          })
+        );
         const response = rawResponse;
         response.closedHandlesCount = rawResponse.numberOfHandlesClosed || 0;
         response.closeFailureCount = rawResponse.numberOfHandlesFailedToClose || 0;
@@ -3224,22 +3534,26 @@ class ShareFileClient extends import_StorageClient.StorageClient {
       "ShareFileClient-createHardLink",
       options,
       async (updatedOptions) => {
-        const rawResponse = await this.context.createHardLink(targetFile, {
-          ...updatedOptions,
-          ...this.shareClientConfig
-        });
-        return (0, import_utils_common.assertResponse)({
-          ...rawResponse,
-          _response: rawResponse._response,
+        const response = (0, import_utils_common.adjustResponse)(
+          await this.context.createHardLink(targetFile, {
+            ...updatedOptions,
+            ...updatedOptions.leaseAccessConditions,
+            ...this.shareClientConfig
+          })
+        );
+        const wrappedRes = {
+          ...response,
+          _response: response._response,
           // _response is made non-enumerable,
           posixProperties: {
-            fileMode: (0, import_utils_common.parseOctalFileMode)(rawResponse.fileMode),
-            fileType: rawResponse.nfsFileType,
-            owner: rawResponse.owner,
-            group: rawResponse.group,
-            linkCount: rawResponse.linkCount
+            fileMode: (0, import_utils_common.parseOctalFileMode)(response.fileMode),
+            fileType: response.nfsFileType,
+            owner: response.owner,
+            group: response.group,
+            linkCount: response.linkCount
           }
-        });
+        };
+        return (0, import_utils_common.assertResponse)(wrappedRes);
       }
     );
   }
@@ -3255,19 +3569,27 @@ class ShareFileClient extends import_StorageClient.StorageClient {
       "ShareFileClient-createSymbolicLink",
       options,
       async (updatedOptions) => {
-        const rawResponse = await this.context.createSymbolicLink(linkText, {
-          ...updatedOptions,
-          ...this.shareClientConfig
-        });
+        const { metadata, ...restOptions } = updatedOptions;
+        const metadataHeaders = (0, import_models2.metadataToRawHeaders)(metadata);
+        const response = (0, import_utils_common.adjustResponse)(
+          await this.context.createSymbolicLink(linkText, {
+            ...restOptions,
+            ...updatedOptions.leaseAccessConditions,
+            fileCreationTime: (0, import_models2.fileCreationTimeToString)(updatedOptions.creationTime),
+            fileLastWriteTime: (0, import_models2.fileLastWriteTimeToString)(updatedOptions.lastWriteTime),
+            ...this.shareClientConfig,
+            requestOptions: { headers: metadataHeaders }
+          })
+        );
         return (0, import_utils_common.assertResponse)({
-          ...rawResponse,
-          _response: rawResponse._response,
+          ...response,
+          _response: response._response,
           // _response is made non-enumerable,
           posixProperties: {
-            fileMode: (0, import_utils_common.parseOctalFileMode)(rawResponse.fileMode),
-            owner: rawResponse.owner,
-            group: rawResponse.group,
-            fileType: rawResponse.nfsFileType
+            fileMode: (0, import_utils_common.parseOctalFileMode)(response.fileMode),
+            owner: response.owner,
+            group: response.group,
+            fileType: response.nfsFileType
           }
         });
       }
@@ -3283,10 +3605,12 @@ class ShareFileClient extends import_StorageClient.StorageClient {
       options,
       async (updatedOptions) => {
         return (0, import_utils_common.assertResponse)(
-          await this.context.getSymbolicLink({
-            ...updatedOptions,
-            ...this.shareClientConfig
-          })
+          (0, import_utils_common.adjustResponse)(
+            await this.context.getSymbolicLink({
+              ...updatedOptions,
+              ...this.shareClientConfig
+            })
+          )
         );
       }
     );
@@ -3450,20 +3774,20 @@ class ShareFileClient extends import_StorageClient.StorageClient {
     }
     const destFile = new ShareFileClient(destinationUrl, this.pipeline, this.shareClientConfig);
     return import_tracing.tracingClient.withSpan("ShareFileClient-rename", options, async (updatedOptions) => {
+      const { metadata, ...restOptions } = updatedOptions;
+      const metadataHeaders = (0, import_models2.metadataToRawHeaders)(metadata);
       const response = (0, import_utils_common.assertResponse)(
-        await destFile.context.rename(this.url, {
-          ...updatedOptions,
-          sourceLeaseAccessConditions: updatedOptions.sourceLeaseAccessConditions ? {
-            sourceLeaseId: updatedOptions.sourceLeaseAccessConditions.leaseId
-          } : void 0,
-          destinationLeaseAccessConditions: updatedOptions.destinationLeaseAccessConditions ? {
-            destinationLeaseId: updatedOptions.destinationLeaseAccessConditions.leaseId
-          } : void 0,
-          fileHttpHeaders: options.contentType ? {
-            fileContentType: options.contentType
-          } : void 0,
-          ...this.shareClientConfig
-        })
+        (0, import_utils_common.adjustResponse)(
+          await destFile.context.rename(this.url, {
+            ...restOptions,
+            ...updatedOptions.copyFileSmbInfo,
+            sourceLeaseId: updatedOptions.sourceLeaseAccessConditions?.leaseId,
+            destinationLeaseId: updatedOptions.destinationLeaseAccessConditions?.leaseId,
+            fileContentType: options.contentType,
+            ...this.shareClientConfig,
+            requestOptions: { headers: metadataHeaders }
+          })
+        )
       );
       return {
         destinationFileClient: destFile,
@@ -3526,12 +3850,14 @@ class ShareLeaseClient {
       options,
       async (updatedOptions) => {
         return (0, import_utils_common.assertResponse)(
-          await this.fileOrShare.acquireLease({
-            ...updatedOptions,
-            ...this.shareClientConfig,
-            duration,
-            proposedLeaseId: this._leaseId
-          })
+          (0, import_utils_common.adjustResponse)(
+            await this.fileOrShare.acquireLease({
+              ...updatedOptions,
+              ...this.shareClientConfig,
+              leaseDuration: duration,
+              proposedLeaseId: this._leaseId
+            })
+          )
         );
       }
     );
@@ -3549,11 +3875,13 @@ class ShareLeaseClient {
       options,
       async (updatedOptions) => {
         const response = (0, import_utils_common.assertResponse)(
-          await this.fileOrShare.changeLease(this._leaseId, {
-            ...updatedOptions,
-            ...this.shareClientConfig,
-            proposedLeaseId
-          })
+          (0, import_utils_common.adjustResponse)(
+            await this.fileOrShare.changeLease(this._leaseId, {
+              ...updatedOptions,
+              ...this.shareClientConfig,
+              proposedLeaseId
+            })
+          )
         );
         this._leaseId = proposedLeaseId;
         return response;
@@ -3573,10 +3901,12 @@ class ShareLeaseClient {
       options,
       async (updatedOptions) => {
         return (0, import_utils_common.assertResponse)(
-          await this.fileOrShare.releaseLease(this._leaseId, {
-            ...updatedOptions,
-            ...this.shareClientConfig
-          })
+          (0, import_utils_common.adjustResponse)(
+            await this.fileOrShare.releaseLease(this._leaseId, {
+              ...updatedOptions,
+              ...this.shareClientConfig
+            })
+          )
         );
       }
     );
@@ -3593,10 +3923,12 @@ class ShareLeaseClient {
       options,
       async (updatedOptions) => {
         return (0, import_utils_common.assertResponse)(
-          await this.fileOrShare.breakLease({
-            ...updatedOptions,
-            ...this.shareClientConfig
-          })
+          (0, import_utils_common.adjustResponse)(
+            await this.fileOrShare.breakLease({
+              ...updatedOptions,
+              ...this.shareClientConfig
+            })
+          )
         );
       }
     );
@@ -3618,10 +3950,12 @@ class ShareLeaseClient {
           throw new RangeError("The renewLease operation is not available for lease on file.");
         }
         return (0, import_utils_common.assertResponse)(
-          await this.fileOrShare.renewLease(this._leaseId, {
-            ...updatedOptions,
-            ...this.shareClientConfig
-          })
+          (0, import_utils_common.adjustResponse)(
+            await this.fileOrShare.renewLease(this._leaseId, {
+              ...updatedOptions,
+              ...this.shareClientConfig
+            })
+          )
         );
       }
     );