@azure/storage-file-share 12.23.0-beta.1 → 12.23.0

package/dist/index.js

@@ -1,5 +1,7 @@
 'use strict';
 
+Object.defineProperty(exports, '__esModule', { value: true });
+
 var coreRestPipeline = require('@azure/core-rest-pipeline');
 var coreUtil = require('@azure/core-util');
 var tslib = require('tslib');
@@ -7,16 +9,14 @@ var coreAuth = require('@azure/core-auth');
 var coreHttpCompat = require('@azure/core-http-compat');
 var coreClient = require('@azure/core-client');
 var coreXml = require('@azure/core-xml');
-var logger$2 = require('@azure/logger');
+var logger$1 = require('@azure/logger');
 var abortController = require('@azure/abort-controller');
 var crypto = require('crypto');
 var coreTracing = require('@azure/core-tracing');
-require('@azure/core-paging');
 var stream = require('stream');
 var events = require('events');
 var fs = require('fs');
 var util = require('util');
-var uuid = require('uuid');
 
 function _interopNamespaceDefault(e) {
     var n = Object.create(null);
@@ -336,13 +336,17 @@ function ipRangeToString(ipRange) {
 
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
-const SDK_VERSION$1 = "12.23.0-beta.1";
-const SERVICE_VERSION = "2023-01-03";
+const SDK_VERSION = "12.23.0";
+const SERVICE_VERSION = "2024-05-04";
 const FILE_MAX_SIZE_BYTES = 4 * 1024 * 1024 * 1024 * 1024; // 4TB
 const FILE_RANGE_MAX_SIZE_BYTES = 4 * 1024 * 1024; // 4MB
 const DEFAULT_MAX_DOWNLOAD_RETRY_REQUESTS = 5;
 const DEFAULT_HIGH_LEVEL_CONCURRENCY = 5;
 const REQUEST_TIMEOUT = 100 * 1000; // In ms
+/**
+ * The OAuth scope to use with Azure Storage.
+ */
+const StorageOAuthScopes = "https://storage.azure.com/.default";
 const URLConstants$1 = {
     Parameters: {
         FORCE_BROWSER_NO_CACHE: "_",
@@ -353,6 +357,88 @@ const URLConstants$1 = {
 };
 const FileAttributesPreserve = "Preserve";
 const FileAttributesNone = "None";
+const StorageFileLoggingAllowedHeaderNames = [
+    "Access-Control-Allow-Origin",
+    "Cache-Control",
+    "Content-Length",
+    "Content-Type",
+    "Date",
+    "Request-Id",
+    "traceparent",
+    "Transfer-Encoding",
+    "User-Agent",
+    "x-ms-client-request-id",
+    "x-ms-date",
+    "x-ms-error-code",
+    "x-ms-request-id",
+    "x-ms-return-client-request-id",
+    "x-ms-version",
+    "Accept-Ranges",
+    "Content-Disposition",
+    "Content-Encoding",
+    "Content-Language",
+    "Content-MD5",
+    "Content-Range",
+    "ETag",
+    "Last-Modified",
+    "Server",
+    "Vary",
+    "x-ms-content-crc64",
+    "x-ms-copy-action",
+    "x-ms-copy-completion-time",
+    "x-ms-copy-id",
+    "x-ms-copy-progress",
+    "x-ms-copy-status",
+    "x-ms-has-immutability-policy",
+    "x-ms-has-legal-hold",
+    "x-ms-lease-state",
+    "x-ms-lease-status",
+    "x-ms-range",
+    "x-ms-request-server-encrypted",
+    "x-ms-server-encrypted",
+    "x-ms-snapshot",
+    "x-ms-source-range",
+    "x-ms-cache-control",
+    "x-ms-content-disposition",
+    "x-ms-content-encoding",
+    "x-ms-content-language",
+    "x-ms-content-length",
+    "x-ms-content-md5",
+    "x-ms-content-type",
+    "x-ms-file-attributes",
+    "x-ms-file-change-time",
+    "x-ms-file-creation-time",
+    "x-ms-file-id",
+    "x-ms-file-last-write-time",
+    "x-ms-file-parent-id",
+    "x-ms-handle-id",
+    "x-ms-number-of-handles-closed",
+    "x-ms-recursive",
+    "x-ms-share-quota",
+    "x-ms-type",
+    "x-ms-write",
+];
+const StorageFileLoggingAllowedQueryParameters = [
+    "comp",
+    "maxresults",
+    "rscc",
+    "rscd",
+    "rsce",
+    "rscl",
+    "rsct",
+    "se",
+    "si",
+    "sip",
+    "sp",
+    "spr",
+    "sr",
+    "srt",
+    "ss",
+    "st",
+    "sv",
+    "copyid",
+    "restype",
+];
 /// List of ports used for path style addressing.
 /// Path style addressing means that storage account is put in URI's Path segment in instead of in host.
 const PathStylePorts = [
@@ -606,6 +692,36 @@ function truncatedISO8061Date(date, withMilliseconds = true) {
         ? dateString.substring(0, dateString.length - 1) + "0000" + "Z"
         : dateString.substring(0, dateString.length - 5) + "Z";
 }
+/**
+ * Delay specified time interval.
+ *
+ * @param timeInMs -
+ * @param aborter -
+ * @param abortError -
+ */
+async function delay(timeInMs, aborter, abortError) {
+    return new Promise((resolve, reject) => {
+        /* eslint-disable-next-line prefer-const */
+        let timeout;
+        const abortHandler = () => {
+            if (timeout !== undefined) {
+                clearTimeout(timeout);
+            }
+            reject(abortError);
+        };
+        const resolveHandler = () => {
+            if (aborter !== undefined) {
+                aborter.removeEventListener("abort", abortHandler);
+            }
+            resolve();
+        };
+        /* eslint-disable-next-line prefer-const */
+        timeout = setTimeout(resolveHandler, timeInMs);
+        if (aborter !== undefined) {
+            aborter.addEventListener("abort", abortHandler);
+        }
+    });
+}
 /**
  * Extracts account name from the url
  * @param url - url to extract the account name from
@@ -1005,7 +1121,7 @@ function generateAccountSASQueryParameters(accountSASSignatureValues, sharedKeyC
             accountSASSignatureValues.ipRange ? ipRangeToString(accountSASSignatureValues.ipRange) : "",
             accountSASSignatureValues.protocol ? accountSASSignatureValues.protocol : "",
             version,
-            "",
+            "", // Reserved for encryption scope
             "", // Account SAS requires an additional newline character
         ].join("\n");
     }
@@ -1279,7 +1395,7 @@ function getCanonicalName(accountName, shareName, filePath) {
 /**
  * The `@azure/logger` configuration for this package.
  */
-const logger$1 = logger$2.createClientLogger("storage-blob");
+const logger = logger$1.createClientLogger("storage-file-share");
 
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
@@ -1321,294 +1437,6 @@ class BaseRequestPolicy {
     }
 }
 
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT license.
-const SDK_VERSION = "12.23.0-beta.1";
-/**
- * The OAuth scope to use with Azure Storage.
- */
-const StorageOAuthScopes = "https://storage.azure.com/.default";
-const URLConstants = {
-    Parameters: {
-        FORCE_BROWSER_NO_CACHE: "_",
-        SIGNATURE: "sig",
-        SNAPSHOT: "snapshot",
-        VERSIONID: "versionid",
-        TIMEOUT: "timeout",
-    },
-};
-const HeaderConstants = {
-    AUTHORIZATION: "Authorization",
-    AUTHORIZATION_SCHEME: "Bearer",
-    CONTENT_ENCODING: "Content-Encoding",
-    CONTENT_ID: "Content-ID",
-    CONTENT_LANGUAGE: "Content-Language",
-    CONTENT_LENGTH: "Content-Length",
-    CONTENT_MD5: "Content-Md5",
-    CONTENT_TRANSFER_ENCODING: "Content-Transfer-Encoding",
-    CONTENT_TYPE: "Content-Type",
-    COOKIE: "Cookie",
-    DATE: "date",
-    IF_MATCH: "if-match",
-    IF_MODIFIED_SINCE: "if-modified-since",
-    IF_NONE_MATCH: "if-none-match",
-    IF_UNMODIFIED_SINCE: "if-unmodified-since",
-    PREFIX_FOR_STORAGE: "x-ms-",
-    RANGE: "Range",
-    USER_AGENT: "User-Agent",
-    X_MS_CLIENT_REQUEST_ID: "x-ms-client-request-id",
-    X_MS_COPY_SOURCE: "x-ms-copy-source",
-    X_MS_DATE: "x-ms-date",
-    X_MS_ERROR_CODE: "x-ms-error-code",
-    X_MS_VERSION: "x-ms-version",
-};
-const StorageBlobLoggingAllowedHeaderNames = [
-    "Access-Control-Allow-Origin",
-    "Cache-Control",
-    "Content-Length",
-    "Content-Type",
-    "Date",
-    "Request-Id",
-    "traceparent",
-    "Transfer-Encoding",
-    "User-Agent",
-    "x-ms-client-request-id",
-    "x-ms-date",
-    "x-ms-error-code",
-    "x-ms-request-id",
-    "x-ms-return-client-request-id",
-    "x-ms-version",
-    "Accept-Ranges",
-    "Content-Disposition",
-    "Content-Encoding",
-    "Content-Language",
-    "Content-MD5",
-    "Content-Range",
-    "ETag",
-    "Last-Modified",
-    "Server",
-    "Vary",
-    "x-ms-content-crc64",
-    "x-ms-copy-action",
-    "x-ms-copy-completion-time",
-    "x-ms-copy-id",
-    "x-ms-copy-progress",
-    "x-ms-copy-status",
-    "x-ms-has-immutability-policy",
-    "x-ms-has-legal-hold",
-    "x-ms-lease-state",
-    "x-ms-lease-status",
-    "x-ms-range",
-    "x-ms-request-server-encrypted",
-    "x-ms-server-encrypted",
-    "x-ms-snapshot",
-    "x-ms-source-range",
-    "If-Match",
-    "If-Modified-Since",
-    "If-None-Match",
-    "If-Unmodified-Since",
-    "x-ms-access-tier",
-    "x-ms-access-tier-change-time",
-    "x-ms-access-tier-inferred",
-    "x-ms-account-kind",
-    "x-ms-archive-status",
-    "x-ms-blob-append-offset",
-    "x-ms-blob-cache-control",
-    "x-ms-blob-committed-block-count",
-    "x-ms-blob-condition-appendpos",
-    "x-ms-blob-condition-maxsize",
-    "x-ms-blob-content-disposition",
-    "x-ms-blob-content-encoding",
-    "x-ms-blob-content-language",
-    "x-ms-blob-content-length",
-    "x-ms-blob-content-md5",
-    "x-ms-blob-content-type",
-    "x-ms-blob-public-access",
-    "x-ms-blob-sequence-number",
-    "x-ms-blob-type",
-    "x-ms-copy-destination-snapshot",
-    "x-ms-creation-time",
-    "x-ms-default-encryption-scope",
-    "x-ms-delete-snapshots",
-    "x-ms-delete-type-permanent",
-    "x-ms-deny-encryption-scope-override",
-    "x-ms-encryption-algorithm",
-    "x-ms-if-sequence-number-eq",
-    "x-ms-if-sequence-number-le",
-    "x-ms-if-sequence-number-lt",
-    "x-ms-incremental-copy",
-    "x-ms-lease-action",
-    "x-ms-lease-break-period",
-    "x-ms-lease-duration",
-    "x-ms-lease-id",
-    "x-ms-lease-time",
-    "x-ms-page-write",
-    "x-ms-proposed-lease-id",
-    "x-ms-range-get-content-md5",
-    "x-ms-rehydrate-priority",
-    "x-ms-sequence-number-action",
-    "x-ms-sku-name",
-    "x-ms-source-content-md5",
-    "x-ms-source-if-match",
-    "x-ms-source-if-modified-since",
-    "x-ms-source-if-none-match",
-    "x-ms-source-if-unmodified-since",
-    "x-ms-tag-count",
-    "x-ms-encryption-key-sha256",
-    "x-ms-if-tags",
-    "x-ms-source-if-tags",
-];
-const StorageBlobLoggingAllowedQueryParameters = [
-    "comp",
-    "maxresults",
-    "rscc",
-    "rscd",
-    "rsce",
-    "rscl",
-    "rsct",
-    "se",
-    "si",
-    "sip",
-    "sp",
-    "spr",
-    "sr",
-    "srt",
-    "ss",
-    "st",
-    "sv",
-    "include",
-    "marker",
-    "prefix",
-    "copyid",
-    "restype",
-    "blockid",
-    "blocklisttype",
-    "delimiter",
-    "prevsnapshot",
-    "ske",
-    "skoid",
-    "sks",
-    "skt",
-    "sktid",
-    "skv",
-    "snapshot",
-];
-
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT license.
-/**
- * Set URL parameter name and value. If name exists in URL parameters, old value
- * will be replaced by name key. If not provide value, the parameter will be deleted.
- *
- * @param url - Source URL string
- * @param name - Parameter name
- * @param value - Parameter value
- * @returns An updated URL string
- */
-function setURLParameter(url, name, value) {
-    const urlParsed = new URL(url);
-    const encodedName = encodeURIComponent(name);
-    const encodedValue = value ? encodeURIComponent(value) : undefined;
-    // mutating searchParams will change the encoding, so we have to do this ourselves
-    const searchString = urlParsed.search === "" ? "?" : urlParsed.search;
-    const searchPieces = [];
-    for (const pair of searchString.slice(1).split("&")) {
-        if (pair) {
-            const [key] = pair.split("=", 2);
-            if (key !== encodedName) {
-                searchPieces.push(pair);
-            }
-        }
-    }
-    if (encodedValue) {
-        searchPieces.push(`${encodedName}=${encodedValue}`);
-    }
-    urlParsed.search = searchPieces.length ? `?${searchPieces.join("&")}` : "";
-    return urlParsed.toString();
-}
-/**
- * Set URL host.
- *
- * @param url - Source URL string
- * @param host - New host string
- * @returns An updated URL string
- */
-function setURLHost(url, host) {
-    const urlParsed = new URL(url);
-    urlParsed.hostname = host;
-    return urlParsed.toString();
-}
-/**
- * Get URL path from an URL string.
- *
- * @param url - Source URL string
- */
-function getURLPath(url) {
-    try {
-        const urlParsed = new URL(url);
-        return urlParsed.pathname;
-    }
-    catch (e) {
-        return undefined;
-    }
-}
-/**
- * Get URL query key value pairs from an URL string.
- *
- * @param url -
- */
-function getURLQueries(url) {
-    let queryString = new URL(url).search;
-    if (!queryString) {
-        return {};
-    }
-    queryString = queryString.trim();
-    queryString = queryString.startsWith("?") ? queryString.substring(1) : queryString;
-    let querySubStrings = queryString.split("&");
-    querySubStrings = querySubStrings.filter((value) => {
-        const indexOfEqual = value.indexOf("=");
-        const lastIndexOfEqual = value.lastIndexOf("=");
-        return (indexOfEqual > 0 && indexOfEqual === lastIndexOfEqual && lastIndexOfEqual < value.length - 1);
-    });
-    const queries = {};
-    for (const querySubString of querySubStrings) {
-        const splitResults = querySubString.split("=");
-        const key = splitResults[0];
-        const value = splitResults[1];
-        queries[key] = value;
-    }
-    return queries;
-}
-/**
- * Delay specified time interval.
- *
- * @param timeInMs -
- * @param aborter -
- * @param abortError -
- */
-async function delay(timeInMs, aborter, abortError) {
-    return new Promise((resolve, reject) => {
-        /* eslint-disable-next-line prefer-const */
-        let timeout;
-        const abortHandler = () => {
-            if (timeout !== undefined) {
-                clearTimeout(timeout);
-            }
-            reject(abortError);
-        };
-        const resolveHandler = () => {
-            if (aborter !== undefined) {
-                aborter.removeEventListener("abort", abortHandler);
-            }
-            resolve();
-        };
-        timeout = setTimeout(resolveHandler, timeInMs);
-        if (aborter !== undefined) {
-            aborter.addEventListener("abort", abortHandler);
-        }
-    });
-}
-
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
 /**
@@ -1631,7 +1459,6 @@ const DEFAULT_RETRY_OPTIONS$1 = {
     maxTries: 4,
     retryDelayInMs: 4 * 1000,
     retryPolicyType: exports.StorageRetryPolicyType.EXPONENTIAL,
-    secondaryHost: "",
     tryTimeoutInMs: undefined, // Use server side default timeout strategy
 };
 const RETRY_ABORT_ERROR$1 = new abortController.AbortError("The operation was aborted.");
@@ -1667,9 +1494,6 @@ class StorageRetryPolicy extends BaseRequestPolicy {
             maxRetryDelayInMs: retryOptions.maxRetryDelayInMs && retryOptions.maxRetryDelayInMs >= 0
                 ? retryOptions.maxRetryDelayInMs
                 : DEFAULT_RETRY_OPTIONS$1.maxRetryDelayInMs,
-            secondaryHost: retryOptions.secondaryHost
-                ? retryOptions.secondaryHost
-                : DEFAULT_RETRY_OPTIONS$1.secondaryHost,
         };
     }
     /**
@@ -1692,20 +1516,14 @@ class StorageRetryPolicy extends BaseRequestPolicy {
      */
     async attemptSendRequest(request, secondaryHas404, attempt) {
         const newRequest = request.clone();
-        const isPrimaryRetry = secondaryHas404 ||
-            !this.retryOptions.secondaryHost ||
-            !(request.method === "GET" || request.method === "HEAD" || request.method === "OPTIONS") ||
-            attempt % 2 === 1;
-        if (!isPrimaryRetry) {
-            newRequest.url = setURLHost(newRequest.url, this.retryOptions.secondaryHost);
-        }
+        const isPrimaryRetry = true;
         // Set the server-side timeout query parameter "timeout=[seconds]"
         if (this.retryOptions.tryTimeoutInMs) {
-            newRequest.url = setURLParameter(newRequest.url, URLConstants.Parameters.TIMEOUT, Math.floor(this.retryOptions.tryTimeoutInMs / 1000).toString());
+            newRequest.url = setURLParameter$1(newRequest.url, URLConstants$1.Parameters.TIMEOUT, Math.floor(this.retryOptions.tryTimeoutInMs / 1000).toString());
         }
         let response;
         try {
-            logger$1.info(`RetryPolicy: =====> Try=${attempt} ${isPrimaryRetry ? "Primary" : "Secondary"}`);
+            logger.info(`RetryPolicy: =====> Try=${attempt} ${isPrimaryRetry ? "Primary" : "Secondary"}`);
             response = await this._nextPolicy.sendRequest(newRequest);
             if (!this.shouldRetry(isPrimaryRetry, attempt, response)) {
                 return response;
@@ -1713,7 +1531,7 @@ class StorageRetryPolicy extends BaseRequestPolicy {
             secondaryHas404 = secondaryHas404 || (!isPrimaryRetry && response.status === 404);
         }
         catch (err) {
-            logger$1.error(`RetryPolicy: Caught error, message: ${err.message}, code: ${err.code}`);
+            logger.error(`RetryPolicy: Caught error, message: ${err.message}, code: ${err.code}`);
             if (!this.shouldRetry(isPrimaryRetry, attempt, response, err)) {
                 throw err;
             }
@@ -1731,7 +1549,7 @@ class StorageRetryPolicy extends BaseRequestPolicy {
      */
     shouldRetry(isPrimaryRetry, attempt, response, err) {
         if (attempt >= this.retryOptions.maxTries) {
-            logger$1.info(`RetryPolicy: Attempt(s) ${attempt} >= maxTries ${this.retryOptions
+            logger.info(`RetryPolicy: Attempt(s) ${attempt} >= maxTries ${this.retryOptions
                 .maxTries}, no further try.`);
             return false;
         }
@@ -1753,7 +1571,7 @@ class StorageRetryPolicy extends BaseRequestPolicy {
                 if (err.name.toUpperCase().includes(retriableError) ||
                     err.message.toUpperCase().includes(retriableError) ||
                     (err.code && err.code.toString().toUpperCase() === retriableError)) {
-                    logger$1.info(`RetryPolicy: Network error ${retriableError} found, will retry.`);
+                    logger.info(`RetryPolicy: Network error ${retriableError} found, will retry.`);
                     return true;
                 }
             }
@@ -1764,17 +1582,17 @@ class StorageRetryPolicy extends BaseRequestPolicy {
         if (response || err) {
             const statusCode = response ? response.status : err ? err.statusCode : 0;
             if (!isPrimaryRetry && statusCode === 404) {
-                logger$1.info(`RetryPolicy: Secondary access with 404, will retry.`);
+                logger.info(`RetryPolicy: Secondary access with 404, will retry.`);
                 return true;
             }
             // Server internal error or server timeout
             if (statusCode === 503 || statusCode === 500) {
-                logger$1.info(`RetryPolicy: Will retry for status code ${statusCode}.`);
+                logger.info(`RetryPolicy: Will retry for status code ${statusCode}.`);
                 return true;
             }
         }
         if ((err === null || err === void 0 ? void 0 : err.code) === "PARSE_ERROR" && (err === null || err === void 0 ? void 0 : err.message.startsWith(`Error "Error: Unclosed root tag`))) {
-            logger$1.info("RetryPolicy: Incomplete XML response likely due to service timeout, will retry.");
+            logger.info("RetryPolicy: Incomplete XML response likely due to service timeout, will retry.");
             return true;
         }
         return false;
@@ -1801,7 +1619,7 @@ class StorageRetryPolicy extends BaseRequestPolicy {
         else {
             delayTimeInMs = Math.random() * 1000;
         }
-        logger$1.info(`RetryPolicy: Delay for ${delayTimeInMs}ms`);
+        logger.info(`RetryPolicy: Delay for ${delayTimeInMs}ms`);
         return delay(delayTimeInMs, abortSignal, RETRY_ABORT_ERROR$1);
     }
 }
@@ -1830,6 +1648,117 @@ class StorageRetryPolicyFactory {
     }
 }
 
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+const URLConstants = {
+    Parameters: {
+        FORCE_BROWSER_NO_CACHE: "_",
+        SIGNATURE: "sig",
+        SNAPSHOT: "snapshot",
+        VERSIONID: "versionid",
+        TIMEOUT: "timeout",
+    },
+};
+const HeaderConstants = {
+    AUTHORIZATION: "Authorization",
+    AUTHORIZATION_SCHEME: "Bearer",
+    CONTENT_ENCODING: "Content-Encoding",
+    CONTENT_ID: "Content-ID",
+    CONTENT_LANGUAGE: "Content-Language",
+    CONTENT_LENGTH: "Content-Length",
+    CONTENT_MD5: "Content-Md5",
+    CONTENT_TRANSFER_ENCODING: "Content-Transfer-Encoding",
+    CONTENT_TYPE: "Content-Type",
+    COOKIE: "Cookie",
+    DATE: "date",
+    IF_MATCH: "if-match",
+    IF_MODIFIED_SINCE: "if-modified-since",
+    IF_NONE_MATCH: "if-none-match",
+    IF_UNMODIFIED_SINCE: "if-unmodified-since",
+    PREFIX_FOR_STORAGE: "x-ms-",
+    RANGE: "Range",
+    USER_AGENT: "User-Agent",
+    X_MS_CLIENT_REQUEST_ID: "x-ms-client-request-id",
+    X_MS_COPY_SOURCE: "x-ms-copy-source",
+    X_MS_DATE: "x-ms-date",
+    X_MS_ERROR_CODE: "x-ms-error-code",
+    X_MS_VERSION: "x-ms-version",
+};
+
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+/**
+ * Set URL parameter name and value. If name exists in URL parameters, old value
+ * will be replaced by name key. If not provide value, the parameter will be deleted.
+ *
+ * @param url - Source URL string
+ * @param name - Parameter name
+ * @param value - Parameter value
+ * @returns An updated URL string
+ */
+function setURLParameter(url, name, value) {
+    const urlParsed = new URL(url);
+    const encodedName = encodeURIComponent(name);
+    const encodedValue = value ? encodeURIComponent(value) : undefined;
+    // mutating searchParams will change the encoding, so we have to do this ourselves
+    const searchString = urlParsed.search === "" ? "?" : urlParsed.search;
+    const searchPieces = [];
+    for (const pair of searchString.slice(1).split("&")) {
+        if (pair) {
+            const [key] = pair.split("=", 2);
+            if (key !== encodedName) {
+                searchPieces.push(pair);
+            }
+        }
+    }
+    if (encodedValue) {
+        searchPieces.push(`${encodedName}=${encodedValue}`);
+    }
+    urlParsed.search = searchPieces.length ? `?${searchPieces.join("&")}` : "";
+    return urlParsed.toString();
+}
+/**
+ * Get URL path from an URL string.
+ *
+ * @param url - Source URL string
+ */
+function getURLPath(url) {
+    try {
+        const urlParsed = new URL(url);
+        return urlParsed.pathname;
+    }
+    catch (e) {
+        return undefined;
+    }
+}
+/**
+ * Get URL query key value pairs from an URL string.
+ *
+ * @param url -
+ */
+function getURLQueries(url) {
+    let queryString = new URL(url).search;
+    if (!queryString) {
+        return {};
+    }
+    queryString = queryString.trim();
+    queryString = queryString.startsWith("?") ? queryString.substring(1) : queryString;
+    let querySubStrings = queryString.split("&");
+    querySubStrings = querySubStrings.filter((value) => {
+        const indexOfEqual = value.indexOf("=");
+        const lastIndexOfEqual = value.lastIndexOf("=");
+        return (indexOfEqual > 0 && indexOfEqual === lastIndexOfEqual && lastIndexOfEqual < value.length - 1);
+    });
+    const queries = {};
+    for (const querySubString of querySubStrings) {
+        const splitResults = querySubString.split("=");
+        const key = splitResults[0];
+        const value = splitResults[1];
+        queries[key] = value;
+    }
+    return queries;
+}
+
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
 /**
@@ -2172,17 +2101,16 @@ const RETRY_ABORT_ERROR = new abortController.AbortError("The operation was abor
  * Retry policy with exponential retry and linear retry implemented.
  */
 function storageRetryPolicy(options = {}) {
-    var _a, _b, _c, _d, _e, _f;
+    var _a, _b, _c, _d, _e;
     const retryPolicyType = (_a = options.retryPolicyType) !== null && _a !== void 0 ? _a : DEFAULT_RETRY_OPTIONS.retryPolicyType;
     const maxTries = (_b = options.maxTries) !== null && _b !== void 0 ? _b : DEFAULT_RETRY_OPTIONS.maxTries;
     const retryDelayInMs = (_c = options.retryDelayInMs) !== null && _c !== void 0 ? _c : DEFAULT_RETRY_OPTIONS.retryDelayInMs;
     const maxRetryDelayInMs = (_d = options.maxRetryDelayInMs) !== null && _d !== void 0 ? _d : DEFAULT_RETRY_OPTIONS.maxRetryDelayInMs;
-    const secondaryHost = (_e = options.secondaryHost) !== null && _e !== void 0 ? _e : DEFAULT_RETRY_OPTIONS.secondaryHost;
-    const tryTimeoutInMs = (_f = options.tryTimeoutInMs) !== null && _f !== void 0 ? _f : DEFAULT_RETRY_OPTIONS.tryTimeoutInMs;
+    const tryTimeoutInMs = (_e = options.tryTimeoutInMs) !== null && _e !== void 0 ? _e : DEFAULT_RETRY_OPTIONS.tryTimeoutInMs;
     function shouldRetry({ isPrimaryRetry, attempt, response, error, }) {
         var _a, _b;
         if (attempt >= maxTries) {
-            logger$1.info(`RetryPolicy: Attempt(s) ${attempt} >= maxTries ${maxTries}, no further try.`);
+            logger.info(`RetryPolicy: Attempt(s) ${attempt} >= maxTries ${maxTries}, no further try.`);
             return false;
         }
         if (error) {
@@ -2190,13 +2118,13 @@ function storageRetryPolicy(options = {}) {
                 if (error.name.toUpperCase().includes(retriableError) ||
                     error.message.toUpperCase().includes(retriableError) ||
                     (error.code && error.code.toString().toUpperCase() === retriableError)) {
-                    logger$1.info(`RetryPolicy: Network error ${retriableError} found, will retry.`);
+                    logger.info(`RetryPolicy: Network error ${retriableError} found, will retry.`);
                     return true;
                 }
             }
             if ((error === null || error === void 0 ? void 0 : error.code) === "PARSE_ERROR" &&
                 (error === null || error === void 0 ? void 0 : error.message.startsWith(`Error "Error: Unclosed root tag`))) {
-                logger$1.info("RetryPolicy: Incomplete XML response likely due to service timeout, will retry.");
+                logger.info("RetryPolicy: Incomplete XML response likely due to service timeout, will retry.");
                 return true;
             }
         }
@@ -2206,12 +2134,12 @@ function storageRetryPolicy(options = {}) {
         if (response || error) {
             const statusCode = (_b = (_a = response === null || response === void 0 ? void 0 : response.status) !== null && _a !== void 0 ? _a : error === null || error === void 0 ? void 0 : error.statusCode) !== null && _b !== void 0 ? _b : 0;
             if (!isPrimaryRetry && statusCode === 404) {
-                logger$1.info(`RetryPolicy: Secondary access with 404, will retry.`);
+                logger.info(`RetryPolicy: Secondary access with 404, will retry.`);
                 return true;
             }
             // Server internal error or server timeout
             if (statusCode === 503 || statusCode === 500) {
-                logger$1.info(`RetryPolicy: Will retry for status code ${statusCode}.`);
+                logger.info(`RetryPolicy: Will retry for status code ${statusCode}.`);
                 return true;
             }
         }
@@ -2219,7 +2147,7 @@ function storageRetryPolicy(options = {}) {
     }
     function calculateDelay(isPrimaryRetry, attempt) {
         let delayTimeInMs = 0;
-        if (isPrimaryRetry) {
+        {
             switch (retryPolicyType) {
                 case StorageRetryPolicyType.EXPONENTIAL:
                     delayTimeInMs = Math.min((Math.pow(2, attempt - 1) - 1) * retryDelayInMs, maxRetryDelayInMs);
@@ -2229,10 +2157,7 @@ function storageRetryPolicy(options = {}) {
                     break;
             }
         }
-        else {
-            delayTimeInMs = Math.random() * 1000;
-        }
-        logger$1.info(`RetryPolicy: Delay for ${delayTimeInMs}ms`);
+        logger.info(`RetryPolicy: Delay for ${delayTimeInMs}ms`);
         return delayTimeInMs;
     }
     return {
@@ -2240,35 +2165,31 @@ function storageRetryPolicy(options = {}) {
         async sendRequest(request, next) {
             // Set the server-side timeout query parameter "timeout=[seconds]"
             if (tryTimeoutInMs) {
-                request.url = setURLParameter(request.url, URLConstants.Parameters.TIMEOUT, String(Math.floor(tryTimeoutInMs / 1000)));
+                request.url = setURLParameter$1(request.url, URLConstants$1.Parameters.TIMEOUT, String(Math.floor(tryTimeoutInMs / 1000)));
             }
             const primaryUrl = request.url;
-            const secondaryUrl = secondaryHost ? setURLHost(request.url, secondaryHost) : undefined;
             let secondaryHas404 = false;
             let attempt = 1;
             let retryAgain = true;
             let response;
             let error;
             while (retryAgain) {
-                const isPrimaryRetry = secondaryHas404 ||
-                    !secondaryUrl ||
-                    !["GET", "HEAD", "OPTIONS"].includes(request.method) ||
-                    attempt % 2 === 1;
-                request.url = isPrimaryRetry ? primaryUrl : secondaryUrl;
+                const isPrimaryRetry = true;
+                request.url = primaryUrl;
                 response = undefined;
                 error = undefined;
                 try {
-                    logger$1.info(`RetryPolicy: =====> Try=${attempt} ${isPrimaryRetry ? "Primary" : "Secondary"}`);
+                    logger.info(`RetryPolicy: =====> Try=${attempt} ${isPrimaryRetry ? "Primary" : "Secondary"}`);
                     response = await next(request);
                     secondaryHas404 = secondaryHas404 || (!isPrimaryRetry && response.status === 404);
                 }
                 catch (e) {
                     if (coreRestPipeline.isRestError(e)) {
-                        logger$1.error(`RetryPolicy: Caught error, message: ${e.message}, code: ${e.code}`);
+                        logger.error(`RetryPolicy: Caught error, message: ${e.message}, code: ${e.code}`);
                         error = e;
                     }
                     else {
-                        logger$1.error(`RetryPolicy: Caught error, message: ${coreUtil.getErrorMessage(e)}`);
+                        logger.error(`RetryPolicy: Caught error, message: ${coreUtil.getErrorMessage(e)}`);
                         throw e;
                     }
                 }
@@ -2577,9 +2498,9 @@ function getCoreClientOptions(pipeline) {
             ? `${restOptions.userAgentOptions.userAgentPrefix} ${packageDetails}`
             : `${packageDetails}`;
         corePipeline = coreClient.createClientPipeline(Object.assign(Object.assign({}, restOptions), { loggingOptions: {
-                additionalAllowedHeaderNames: StorageBlobLoggingAllowedHeaderNames,
-                additionalAllowedQueryParameters: StorageBlobLoggingAllowedQueryParameters,
-                logger: logger$1.info,
+                additionalAllowedHeaderNames: StorageFileLoggingAllowedHeaderNames,
+                additionalAllowedQueryParameters: StorageFileLoggingAllowedQueryParameters,
+                logger: logger.info,
             }, userAgentOptions: {
                 userAgentPrefix,
             }, serializationOptions: {
@@ -2625,7 +2546,7 @@ function getCoreClientOptions(pipeline) {
         }
         pipeline._corePipeline = corePipeline;
     }
-    return Object.assign(Object.assign({}, restOptions), { httpClient, pipeline: corePipeline });
+    return Object.assign(Object.assign({}, restOptions), { allowInsecureConnection: true, httpClient, pipeline: corePipeline });
 }
 function getCredentialFromPipeline(pipeline) {
     // see if we squirreled one away on the type itself
@@ -2722,7 +2643,7 @@ function isCoreHttpPolicyFactory(factory) {
  */
 const tracingClient = coreTracing.createTracingClient({
     packageName: "@azure/storage-file-share",
-    packageVersion: SDK_VERSION$1,
+    packageVersion: SDK_VERSION,
     namespace: "Microsoft.Storage",
 });
 
@@ -3736,6 +3657,14 @@ const HandleItem = {
                     name: "String"
                 }
             },
+            clientName: {
+                serializedName: "ClientName",
+                required: true,
+                xmlName: "ClientName",
+                type: {
+                    name: "String"
+                }
+            },
             openTime: {
                 serializedName: "OpenTime",
                 required: true,
@@ -8101,7 +8030,7 @@ const timeoutInSeconds = {
 const version = {
     parameterPath: "version",
     mapper: {
-        defaultValue: "2023-01-03",
+        defaultValue: "2024-05-04",
         isConstant: true,
         serializedName: "x-ms-version",
         type: {
@@ -9130,6 +9059,16 @@ const prevsharesnapshot = {
         }
     }
 };
+const supportRename = {
+    parameterPath: ["options", "supportRename"],
+    mapper: {
+        serializedName: "x-ms-file-support-rename",
+        xmlName: "x-ms-file-support-rename",
+        type: {
+            name: "Boolean"
+        }
+    }
+};
 const filePermissionCopyMode = {
     parameterPath: ["options", "copyFileSmbInfo", "filePermissionCopyMode"],
     mapper: {
@@ -10861,6 +10800,7 @@ const uploadRangeFromURLOperationSpec = {
         version,
         accept1,
         leaseId,
+        fileRequestIntent,
         allowTrailingDot,
         allowSourceTrailingDot,
         range1,
@@ -10903,7 +10843,8 @@ const getRangeListOperationSpec = {
         leaseId,
         fileRequestIntent,
         allowTrailingDot,
-        range
+        range,
+        supportRename
     ],
     isXML: true,
     serializer: xmlSerializer
@@ -11096,7 +11037,7 @@ let StorageClient$1 = class StorageClient extends coreHttpCompat__namespace.Exte
         const defaults = {
             requestContentType: "application/json; charset=utf-8"
         };
-        const packageDetails = `azsdk-js-azure-storage-file-share/12.23.0-beta.1`;
+        const packageDetails = `azsdk-js-azure-storage-file-share/12.23.0`;
         const userAgentPrefix = options.userAgentOptions && options.userAgentOptions.userAgentPrefix
             ? `${options.userAgentOptions.userAgentPrefix} ${packageDetails}`
             : `${packageDetails}`;
@@ -11107,7 +11048,7 @@ let StorageClient$1 = class StorageClient extends coreHttpCompat__namespace.Exte
         // Parameter assignments
         this.url = url;
         // Assigning values to Constant parameters
-        this.version = options.version || "2023-01-03";
+        this.version = options.version || "2024-05-04";
         this.fileRangeWriteFromUrl = options.fileRangeWriteFromUrl || "update";
         this.service = new ServiceImpl(this);
         this.share = new ShareImpl(this);
@@ -11801,13 +11742,6 @@ function rangeToString(range) {
         : `bytes=${range.offset}-`;
 }
 
-// Copyright (c) Microsoft Corporation.
-// Licensed under the MIT license.
-/**
- * The `@azure/logger` configuration for this package.
- */
-const logger = logger$2.createClientLogger("storage-file-share");
-
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
 /**
@@ -11903,6 +11837,22 @@ function fileLastWriteTimeToString(time) {
 function fileChangeTimeToString(time) {
     return time instanceof Date ? truncatedISO8061Date(time) : time;
 }
+/**
+ * Defines the known cloud audiences for Storage.
+ */
+exports.StorageFileAudience = void 0;
+(function (StorageFileAudience) {
+    /**
+     * The OAuth scope to use to retrieve an AAD token for Azure Storage.
+     */
+    StorageFileAudience["StorageOAuthScopes"] = "https://storage.azure.com/.default";
+})(exports.StorageFileAudience || (exports.StorageFileAudience = {}));
+/**
+ * To get the OAuth audience for a storage account for file service.
+ */
+function getFileServiceAccountAudience(storageAccountName) {
+    return `https://${storageAccountName}.file.core.windows.net/.default`;
+}
 
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT license.
@@ -12382,7 +12332,7 @@ class ShareClient extends StorageClient {
     options) {
         let pipeline;
         let url;
-        if (credentialOrPipelineOrShareName instanceof Pipeline) {
+        if (isPipelineLike(credentialOrPipelineOrShareName)) {
             // (url: string, pipeline: Pipeline)
             url = urlOrConnectionString;
             pipeline = credentialOrPipelineOrShareName;
@@ -12877,7 +12827,7 @@ class ShareDirectoryClient extends StorageClient {
     /* eslint-disable-next-line @azure/azure-sdk/ts-naming-options */
     options = {}) {
         let pipeline;
-        if (credentialOrPipeline instanceof Pipeline) {
+        if (isPipelineLike(credentialOrPipeline)) {
             pipeline = credentialOrPipeline;
         }
         else if (credentialOrPipeline instanceof Credential ||
@@ -13171,8 +13121,8 @@ class ShareDirectoryClient extends StorageClient {
      *                          items. The marker value is opaque to the client.
      * @param options - Options to list files and directories operation.
      */
-    iterateFilesAndDirectoriesSegments(marker, options = {}) {
-        return tslib.__asyncGenerator(this, arguments, function* iterateFilesAndDirectoriesSegments_1() {
+    iterateFilesAndDirectoriesSegments(marker_1) {
+        return tslib.__asyncGenerator(this, arguments, function* iterateFilesAndDirectoriesSegments_1(marker, options = {}) {
             if (options.prefix === "") {
                 options.prefix = undefined;
             }
@@ -13189,8 +13139,8 @@ class ShareDirectoryClient extends StorageClient {
      *
      * @param options - Options to list files and directories operation.
      */
-    listFilesAndDirectoriesItems(options = {}) {
-        return tslib.__asyncGenerator(this, arguments, function* listFilesAndDirectoriesItems_1() {
+    listFilesAndDirectoriesItems() {
+        return tslib.__asyncGenerator(this, arguments, function* listFilesAndDirectoriesItems_1(options = {}) {
             var _a, e_1, _b, _c;
             if (options.prefix === "") {
                 options.prefix = undefined;
@@ -13378,8 +13328,8 @@ class ShareDirectoryClient extends StorageClient {
      *                          set of list items.
      * @param options - Options to list handles operation.
      */
-    iterateHandleSegments(marker, options = {}) {
-        return tslib.__asyncGenerator(this, arguments, function* iterateHandleSegments_1() {
+    iterateHandleSegments(marker_1) {
+        return tslib.__asyncGenerator(this, arguments, function* iterateHandleSegments_1(marker, options = {}) {
             let listHandlesResponse;
             if (!!marker || marker === undefined) {
                 do {
@@ -13395,8 +13345,8 @@ class ShareDirectoryClient extends StorageClient {
      *
      * @param options - Options to list handles operation.
      */
-    listHandleItems(options = {}) {
-        return tslib.__asyncGenerator(this, arguments, function* listHandleItems_1() {
+    listHandleItems() {
+        return tslib.__asyncGenerator(this, arguments, function* listHandleItems_1(options = {}) {
             var _a, e_2, _b, _c;
             let marker;
             try {
@@ -13693,7 +13643,7 @@ class ShareFileClient extends StorageClient {
     /* eslint-disable-next-line @azure/azure-sdk/ts-naming-options */
     options) {
         let pipeline;
-        if (credentialOrPipeline instanceof Pipeline) {
+        if (isPipelineLike(credentialOrPipeline)) {
             pipeline = credentialOrPipeline;
         }
         else if (credentialOrPipeline instanceof Credential ||
@@ -14136,7 +14086,7 @@ class ShareFileClient extends StorageClient {
      */
     async getRangeListDiff(prevShareSnapshot, options = {}) {
         return tracingClient.withSpan("ShareFileClient-getRangeListDiff", options, async (updatedOptions) => {
-            return assertResponse(await this.context.getRangeList(Object.assign(Object.assign(Object.assign({}, updatedOptions), { prevsharesnapshot: prevShareSnapshot, range: updatedOptions.range ? rangeToString(updatedOptions.range) : undefined }), this.shareClientConfig)));
+            return assertResponse(await this.context.getRangeList(Object.assign(Object.assign(Object.assign({}, updatedOptions), { prevsharesnapshot: prevShareSnapshot, supportRename: options.includeRenames, range: updatedOptions.range ? rangeToString(updatedOptions.range) : undefined }), this.shareClientConfig)));
         });
     }
     /**
@@ -14524,8 +14474,8 @@ class ShareFileClient extends StorageClient {
      *                          set of list items.
      * @param options - Options to list handles operation.
      */
-    iterateHandleSegments(marker, options = {}) {
-        return tslib.__asyncGenerator(this, arguments, function* iterateHandleSegments_2() {
+    iterateHandleSegments(marker_1) {
+        return tslib.__asyncGenerator(this, arguments, function* iterateHandleSegments_2(marker, options = {}) {
             let listHandlesResponse;
             if (!!marker || marker === undefined) {
                 do {
@@ -14541,8 +14491,8 @@ class ShareFileClient extends StorageClient {
      *
      * @param options - Options to list handles operation.
      */
-    listHandleItems(options = {}) {
-        return tslib.__asyncGenerator(this, arguments, function* listHandleItems_2() {
+    listHandleItems() {
+        return tslib.__asyncGenerator(this, arguments, function* listHandleItems_2(options = {}) {
             var _a, e_3, _b, _c;
             let marker;
             try {
@@ -14789,7 +14739,7 @@ class ShareLeaseClient {
         }
         this._url = client.url;
         if (!leaseId) {
-            leaseId = uuid.v4();
+            leaseId = coreUtil.randomUUID();
         }
         this._leaseId = leaseId;
     }
@@ -14929,7 +14879,7 @@ class ShareServiceClient extends StorageClient {
     /* eslint-disable-next-line @azure/azure-sdk/ts-naming-options */
     options) {
         let pipeline;
-        if (credentialOrPipeline instanceof Pipeline) {
+        if (isPipelineLike(credentialOrPipeline)) {
             pipeline = credentialOrPipeline;
         }
         else if (credentialOrPipeline instanceof Credential ||
@@ -15030,8 +14980,8 @@ class ShareServiceClient extends StorageClient {
      *                          items. The marker value is opaque to the client.
      * @param options - Options to list shares operation.
      */
-    listSegments(marker, options = {}) {
-        return tslib.__asyncGenerator(this, arguments, function* listSegments_1() {
+    listSegments(marker_1) {
+        return tslib.__asyncGenerator(this, arguments, function* listSegments_1(marker, options = {}) {
             if (options.prefix === "") {
                 options.prefix = undefined;
             }
@@ -15048,8 +14998,8 @@ class ShareServiceClient extends StorageClient {
      *
      * @param options - Options to list shares operation.
      */
-    listItems(options = {}) {
-        return tslib.__asyncGenerator(this, arguments, function* listItems_1() {
+    listItems() {
+        return tslib.__asyncGenerator(this, arguments, function* listItems_1(options = {}) {
             var _a, e_1, _b, _c;
             if (options.prefix === "") {
                 options.prefix = undefined;
@@ -15269,7 +15219,7 @@ exports.KnownShareTokenIntent = void 0;
     KnownShareTokenIntent["Backup"] = "backup";
 })(exports.KnownShareTokenIntent || (exports.KnownShareTokenIntent = {}));
 
-Object.defineProperty(exports, 'RestError', {
+Object.defineProperty(exports, "RestError", {
     enumerable: true,
     get: function () { return coreRestPipeline.RestError; }
 });
@@ -15300,6 +15250,7 @@ exports.StorageSharedKeyCredential = StorageSharedKeyCredential;
 exports.StorageSharedKeyCredentialPolicy = StorageSharedKeyCredentialPolicy;
 exports.generateAccountSASQueryParameters = generateAccountSASQueryParameters;
 exports.generateFileSASQueryParameters = generateFileSASQueryParameters;
+exports.getFileServiceAccountAudience = getFileServiceAccountAudience;
 exports.isPipelineLike = isPipelineLike;
 exports.logger = logger;
 exports.newPipeline = newPipeline;