@azure/storage-common 12.4.1 → 12.6.0-beta.1

package/dist/esm/crc64.js

@@ -1,33 +1,8 @@
 // Copyright (c) Microsoft Corporation.
 // Licensed under the MIT License.
 
-// ESM-COMPAT-START (this block is stripped from dist/commonjs by copyJSFiles.cjs)
-// In ESM under Node, `require`, `__filename`, and `__dirname` are not defined.
-// Synthesize them from `import.meta.url` so the Emscripten Node branch below works as-is.
-// Specifiers are held in variables to prevent web bundlers from statically resolving `node:*`.
-// The detection check below MUST stay byte-for-byte identical to the Emscripten-generated
-// `ENVIRONMENT_IS_NODE` check later in this file; otherwise the polyfill and the Node branch
-// can disagree and the ESM `ReferenceError: require is not defined` bug returns.
-import { createRequire } from "node:module";
-import { dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-const __isNode__ =
-  typeof process === "object" &&
-  typeof process.versions === "object" &&
-  typeof process.versions.node === "string";
-let require;
-let __filename;
-let __dirname;
-if (__isNode__) {
-  require = createRequire(import.meta.url);
-  __filename = fileURLToPath(import.meta.url);
-  __dirname = dirname(__filename);
-}
-// ESM-COMPAT-END
-
 var NativeCRC64 = (() => {
   var _scriptDir = typeof document !== 'undefined' && document.currentScript ? document.currentScript.src : undefined;
-  if (typeof __filename !== 'undefined') _scriptDir = _scriptDir || __filename;
   return (
 function(NativeCRC64) {
   NativeCRC64 = NativeCRC64 || {};
@@ -133,52 +108,10 @@ function logExceptionOnExit(e) {
 
 if (ENVIRONMENT_IS_NODE) {
   if (typeof process == 'undefined' || !process.release || process.release.name !== 'node') throw new Error('not compiled for this environment (did you build to HTML and try to run it not on the web, or set ENVIRONMENT to something - like node - and run it someplace else - like on the web?)');
-// NODE-READ-START (this block is replaced with a no-op in dist/browser and dist/react-native by copyJSFiles.cjs)
-  // `require()` is no-op in an ESM module, use `createRequire()` to construct
-  // the require()` function.  This is only necessary for multi-environment
-  // builds, `-sENVIRONMENT=node` emits a static import declaration instead.
-  // TODO: Swap all `require()`'s with `import()`'s?
-  // These modules will usually be used on Node.js. Load them eagerly to avoid
-  // the complexity of lazy-loading.
-  var fs = require('fs');
-  var nodePath = require('path');
-
-  if (ENVIRONMENT_IS_WORKER) {
-    scriptDirectory = nodePath.dirname(scriptDirectory) + '/';
-  } else {
-    scriptDirectory = __dirname + '/';
-  }
-
-// include: node_shell_read.js
-
-
-read_ = (filename, binary) => {
-  // We need to re-wrap `file://` strings to URLs. Normalizing isn't
-  // necessary in that case, the path should already be absolute.
-  filename = isFileURI(filename) ? new URL(filename) : nodePath.normalize(filename);
-  return fs.readFileSync(filename, binary ? undefined : 'utf8');
-};
-
-readBinary = (filename) => {
-  var ret = read_(filename, true);
-  if (!ret.buffer) {
-    ret = new Uint8Array(ret);
-  }
-  assert(ret.buffer);
-  return ret;
-};
-
-readAsync = (filename, onload, onerror) => {
-  // See the comment in the `read_` function.
-  filename = isFileURI(filename) ? new URL(filename) : nodePath.normalize(filename);
-  fs.readFile(filename, function(err, data) {
-    if (err) onerror(err);
-    else onload(data.buffer);
-  });
-};
-
-// end include: node_shell_read.js
-// NODE-READ-END
+  // The wasm is base64-embedded (see `binaryInString`) and loaded via `getBinary()`,
+  // so the Node fs/path read hooks emitted by Emscripten are never exercised and
+  // have been removed. This keeps the file free of Node built-in imports so it can be
+  // consumed as-is by web bundlers and by ESM-to-CommonJS bundlers (see issue #39057).
   if (process['argv'].length > 1) {
     thisProgram = process['argv'][1].replace(/\\/g, '/');
   }
@@ -217,26 +150,6 @@ if (ENVIRONMENT_IS_SHELL) {
 
   if ((typeof process == 'object' && typeof require === 'function') || typeof window == 'object' || typeof importScripts == 'function') throw new Error('not compiled for this environment (did you build to HTML and try to run it not on the web, or set ENVIRONMENT to something - like node - and run it someplace else - like on the web?)');
 
-  if (typeof read != 'undefined') {
-    read_ = function shell_read(f) {
-      return read(f);
-    };
-  }
-
-  readBinary = function readBinary(f) {
-    let data;
-    if (typeof readbuffer == 'function') {
-      return new Uint8Array(readbuffer(f));
-    }
-    data = read(f, 'binary');
-    assert(typeof data == 'object');
-    return data;
-  };
-
-  readAsync = function readAsync(f, onload, onerror) {
-    setTimeout(() => onload(readBinary(f)), 0);
-  };
-
   if (typeof scriptArgs != 'undefined') {
     arguments_ = scriptArgs;
   } else if (typeof arguments != 'undefined') {
@@ -263,72 +176,9 @@ if (ENVIRONMENT_IS_SHELL) {
 // Node.js workers are detected as a combination of ENVIRONMENT_IS_WORKER and
 // ENVIRONMENT_IS_NODE.
 if (ENVIRONMENT_IS_WEB || ENVIRONMENT_IS_WORKER) {
-  if (ENVIRONMENT_IS_WORKER) { // Check worker, not web, since window could be polyfilled
-    scriptDirectory = self.location.href;
-  } else if (typeof document != 'undefined' && document.currentScript) { // web
-    scriptDirectory = document.currentScript.src;
-  }
-  // When MODULARIZE, this JS may be executed later, after document.currentScript
-  // is gone, so we saved it, and we use it here instead of any other info.
-  if (_scriptDir) {
-    scriptDirectory = _scriptDir;
-  }
-  // blob urls look like blob:http://site.com/etc/etc and we cannot infer anything from them.
-  // otherwise, slice off the final part of the url to find the script directory.
-  // if scriptDirectory does not contain a slash, lastIndexOf will return -1,
-  // and scriptDirectory will correctly be replaced with an empty string.
-  // If scriptDirectory contains a query (starting with ?) or a fragment (starting with #),
-  // they are removed because they could contain a slash.
-  if (scriptDirectory.indexOf('blob:') !== 0) {
-    scriptDirectory = scriptDirectory.substr(0, scriptDirectory.replace(/[?#].*/, "").lastIndexOf('/')+1);
-  } else {
-    scriptDirectory = '';
-  }
-
   if (!(typeof window == 'object' || typeof importScripts == 'function')) throw new Error('not compiled for this environment (did you build to HTML and try to run it not on the web, or set ENVIRONMENT to something - like node - and run it someplace else - like on the web?)');
-
-  // Differentiate the Web Worker from the Node Worker case, as reading must
-  // be done differently.
-  {
-// include: web_or_worker_shell_read.js
-
-
-  read_ = (url) => {
-      var xhr = new XMLHttpRequest();
-      xhr.open('GET', url, false);
-      xhr.send(null);
-      return xhr.responseText;
-  }
-
-  if (ENVIRONMENT_IS_WORKER) {
-    readBinary = (url) => {
-        var xhr = new XMLHttpRequest();
-        xhr.open('GET', url, false);
-        xhr.responseType = 'arraybuffer';
-        xhr.send(null);
-        return new Uint8Array(/** @type{!ArrayBuffer} */(xhr.response));
-    };
-  }
-
-  readAsync = (url, onload, onerror) => {
-    var xhr = new XMLHttpRequest();
-    xhr.open('GET', url, true);
-    xhr.responseType = 'arraybuffer';
-    xhr.onload = () => {
-      if (xhr.status == 200 || (xhr.status == 0 && xhr.response)) { // file URLs can return 0
-        onload(xhr.response);
-        return;
-      }
-      onerror();
-    };
-    xhr.onerror = onerror;
-    xhr.send(null);
-  }
-
-// end include: web_or_worker_shell_read.js
-  }
-
-  setWindowTitle = (title) => document.title = title;
+  // The XHR-based read hooks emitted by Emscripten are unused because the wasm is
+  // base64-embedded; they have been removed so the file contains no DOM/XHR I/O.
 } else
 {
   throw new Error('environment detection error');

package/dist/esm/indexPlatform.d.ts

@@ -6,6 +6,7 @@ export * from "./StructuredMessageDecodingStream.js";
 export * from "./StorageCRC64Calculator.js";
 export { getCachedDefaultHttpClient } from "./cache.js";
 export type * from "./interfaces.js";
+export * from "./StorageResponseFormat.js";
 export * from "./StorageBrowserPolicyFactory.js";
 export * from "./credentials/AnonymousCredential.js";
 export * from "./credentials/Credential.js";
@@ -19,6 +20,8 @@ export * from "./policies/StorageCorrectContentLengthPolicy.js";
 export * from "./policies/StorageRetryPolicyV2.js";
 export * from "./policies/StorageSharedKeyCredentialPolicy.js";
 export * from "./policies/StorageSharedKeyCredentialPolicyV2.js";
+export { buildStorageSharedKeyStringToSign } from "./policies/SharedKeySigning.js";
+export * from "./policies/StorageRedirectRangeHeaderPolicy.js";
 export * from "./policies/StorageRequestFailureDetailsParserPolicy.js";
 export * from "./credentials/UserDelegationKeyCredential.js";
 export type { UserDelegationKey } from "./credentials/UserDelegationKey.js";

package/dist/esm/indexPlatform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"indexPlatform.d.ts","sourceRoot":"","sources":["../../src/indexPlatform.ts"],"names":[],"mappings":"AAGA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AACxD,mBAAmB,sBAAsB,CAAC;AAE1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kDAAkD,CAAC;AAEjE,cAAc,gCAAgC,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,cAAc,yCAAyC,CAAC;AACxD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,sDAAsD,CAAC;AACrE,cAAc,oCAAoC,CAAC;AACnD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,uDAAuD,CAAC;AACtE,cAAc,6DAA6D,CAAC;AAC5E,cAAc,mDAAmD,CAAC;AAClE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAG5E,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"indexPlatform.d.ts","sourceRoot":"","sources":["../../src/indexPlatform.ts"],"names":[],"mappings":"AAGA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AACxD,mBAAmB,sBAAsB,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAE3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kDAAkD,CAAC;AAEjE,cAAc,gCAAgC,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,cAAc,yCAAyC,CAAC;AACxD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,sDAAsD,CAAC;AACrE,cAAc,oCAAoC,CAAC;AACnD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,uDAAuD,CAAC;AACtE,OAAO,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AACnF,cAAc,gDAAgD,CAAC;AAC/D,cAAc,wDAAwD,CAAC;AACvE,cAAc,mDAAmD,CAAC;AAClE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAG5E,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/esm/indexPlatform.js

@@ -7,6 +7,7 @@ export * from "./StructuredMessageEncodingStream.js";
 export * from "./StructuredMessageDecodingStream.js";
 export * from "./StorageCRC64Calculator.js";
 export { getCachedDefaultHttpClient } from "./cache.js";
+export * from "./StorageResponseFormat.js";
 export * from "./StorageBrowserPolicyFactory.js";
 export * from "./credentials/AnonymousCredential.js";
 export * from "./credentials/Credential.js";
@@ -20,6 +21,8 @@ export * from "./policies/StorageCorrectContentLengthPolicy.js";
 export * from "./policies/StorageRetryPolicyV2.js";
 export * from "./policies/StorageSharedKeyCredentialPolicy.js";
 export * from "./policies/StorageSharedKeyCredentialPolicyV2.js";
+export { buildStorageSharedKeyStringToSign } from "./policies/SharedKeySigning.js";
+export * from "./policies/StorageRedirectRangeHeaderPolicy.js";
 export * from "./policies/StorageRequestFailureDetailsParserPolicy.js";
 export * from "./credentials/UserDelegationKeyCredential.js";
 //# sourceMappingURL=indexPlatform.js.map

package/dist/esm/indexPlatform.js.map

@@ -1 +1 @@
-{"version":3,"file":"indexPlatform.js","sourceRoot":"","sources":["../../src/indexPlatform.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAGxD,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kDAAkD,CAAC;AAEjE,cAAc,gCAAgC,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,cAAc,yCAAyC,CAAC;AACxD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,sDAAsD,CAAC;AACrE,cAAc,oCAAoC,CAAC;AACnD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,uDAAuD,CAAC;AACtE,cAAc,6DAA6D,CAAC;AAC5E,cAAc,mDAAmD,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nexport * from \"#platform/BufferScheduler\";\nexport * from \"#platform/bufferHelpers\";\nexport { createBlobFromData } from \"./bufferHelpers.common.js\";\nexport * from \"#platform/StructuredMessageEncodingStream\";\nexport * from \"#platform/StructuredMessageDecodingStream\";\nexport * from \"./StorageCRC64Calculator.js\";\nexport { getCachedDefaultHttpClient } from \"./cache.js\";\nexport type * from \"#platform/interfaces\";\n\nexport * from \"./StorageBrowserPolicyFactory.js\";\nexport * from \"./credentials/AnonymousCredential.js\";\nexport * from \"./credentials/Credential.js\";\nexport * from \"#platform/credentials/StorageSharedKeyCredential\";\n\nexport * from \"./StorageRetryPolicyFactory.js\";\nexport { BaseRequestPolicy } from \"./policies/RequestPolicy.js\";\nexport * from \"./policies/AnonymousCredentialPolicy.js\";\nexport * from \"./policies/CredentialPolicy.js\";\nexport * from \"#platform/policies/StorageBrowserPolicyV2\";\nexport * from \"#platform/policies/StorageCorrectContentLengthPolicy\";\nexport * from \"./policies/StorageRetryPolicyV2.js\";\nexport * from \"./policies/StorageSharedKeyCredentialPolicy.js\";\nexport * from \"#platform/policies/StorageSharedKeyCredentialPolicyV2\";\nexport * from \"#platform/policies/StorageRequestFailureDetailsParserPolicy\";\nexport * from \"#platform/credentials/UserDelegationKeyCredential\";\nexport type { UserDelegationKey } from \"./credentials/UserDelegationKey.js\";\n\n// Re-export Readable stream type for Node.js (never in browser/react-native)\nexport type { Readable } from \"node:stream\";\n"]}
+{"version":3,"file":"indexPlatform.js","sourceRoot":"","sources":["../../src/indexPlatform.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAExD,cAAc,4BAA4B,CAAC;AAE3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC;AACrD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kDAAkD,CAAC;AAEjE,cAAc,gCAAgC,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,cAAc,yCAAyC,CAAC;AACxD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,sDAAsD,CAAC;AACrE,cAAc,oCAAoC,CAAC;AACnD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,uDAAuD,CAAC;AACtE,OAAO,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AACnF,cAAc,gDAAgD,CAAC;AAC/D,cAAc,wDAAwD,CAAC;AACvE,cAAc,mDAAmD,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nexport * from \"#platform/BufferScheduler\";\nexport * from \"#platform/bufferHelpers\";\nexport { createBlobFromData } from \"./bufferHelpers.common.js\";\nexport * from \"#platform/StructuredMessageEncodingStream\";\nexport * from \"#platform/StructuredMessageDecodingStream\";\nexport * from \"./StorageCRC64Calculator.js\";\nexport { getCachedDefaultHttpClient } from \"./cache.js\";\nexport type * from \"#platform/interfaces\";\nexport * from \"./StorageResponseFormat.js\";\n\nexport * from \"./StorageBrowserPolicyFactory.js\";\nexport * from \"./credentials/AnonymousCredential.js\";\nexport * from \"./credentials/Credential.js\";\nexport * from \"#platform/credentials/StorageSharedKeyCredential\";\n\nexport * from \"./StorageRetryPolicyFactory.js\";\nexport { BaseRequestPolicy } from \"./policies/RequestPolicy.js\";\nexport * from \"./policies/AnonymousCredentialPolicy.js\";\nexport * from \"./policies/CredentialPolicy.js\";\nexport * from \"#platform/policies/StorageBrowserPolicyV2\";\nexport * from \"#platform/policies/StorageCorrectContentLengthPolicy\";\nexport * from \"./policies/StorageRetryPolicyV2.js\";\nexport * from \"./policies/StorageSharedKeyCredentialPolicy.js\";\nexport * from \"#platform/policies/StorageSharedKeyCredentialPolicyV2\";\nexport { buildStorageSharedKeyStringToSign } from \"./policies/SharedKeySigning.js\";\nexport * from \"./policies/StorageRedirectRangeHeaderPolicy.js\";\nexport * from \"./policies/StorageRequestFailureDetailsParserPolicy.js\";\nexport * from \"#platform/credentials/UserDelegationKeyCredential\";\nexport type { UserDelegationKey } from \"./credentials/UserDelegationKey.js\";\n\n// Re-export Readable stream type for Node.js (never in browser/react-native)\nexport type { Readable } from \"node:stream\";\n"]}

package/dist/esm/package.json

@@ -1,3 +1,8 @@
 {
-  "type": "module"
+  "name": "@azure/storage-common",
+  "version": "12.6.0-beta.1",
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json"
+  }
 }

package/dist/esm/policies/SharedKeySigning.d.ts

@@ -0,0 +1,32 @@
+import type { PipelineRequest } from "@azure/core-rest-pipeline";
+/**
+ * Sets the request headers that participate in the Shared Key signature and are derived from
+ * the request itself: `x-ms-date`, and `Content-Length` for a string or Buffer body.
+ *
+ * `Content-Length` is a signed field: a request with a body whose `Content-Length` isn't set
+ * gets a signature the service rejects.
+ */
+export declare function prepareSharedKeyHeaders(request: PipelineRequest): void;
+/**
+ * Builds the string to sign for the Azure Storage Shared Key authorization scheme.
+ *
+ * Before building it, sets the request headers that the signature covers and that come from
+ * the request itself: `x-ms-date`, and `Content-Length` for a string or Buffer body. Send the
+ * request with these headers, since the signature depends on them.
+ *
+ * @param request - The request to sign. Its `x-ms-date` header is set, and so is its
+ * `Content-Length` header when the body is a string or a Buffer.
+ * @param accountName - The storage account name used to build the canonicalized resource.
+ * @returns The string to sign, ready to be signed with HMAC-SHA256.
+ * @see https://learn.microsoft.com/rest/api/storageservices/authorize-with-shared-key
+ */
+export declare function buildStorageSharedKeyStringToSign(request: PipelineRequest, accountName: string): string;
+/**
+ * Builds the string to sign from the request as it is, without setting any header. For a caller
+ * that sets the signed headers itself on the request it sends.
+ *
+ * @param request - The request whose headers and URL form the string to sign.
+ * @param accountName - The storage account name used to build the canonicalized resource.
+ */
+export declare function buildStringToSign(request: PipelineRequest, accountName: string): string;
+//# sourceMappingURL=SharedKeySigning.d.ts.map

package/dist/esm/policies/SharedKeySigning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SharedKeySigning.d.ts","sourceRoot":"","sources":["../../../src/policies/SharedKeySigning.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAmHjE;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAUtE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,MAAM,GAClB,MAAM,CAGR;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAqBvF"}

package/dist/esm/policies/SharedKeySigning.js

@@ -0,0 +1,156 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { HeaderConstants } from "../utils/constants.js";
+import { getURLPath } from "../utils/utils.common.js";
+import { compareHeader } from "../utils/SharedKeyComparator.js";
+/**
+ * Retrieve header value according to shared key sign rules.
+ * @see https://learn.microsoft.com/rest/api/storageservices/authenticate-with-shared-key
+ */
+function getHeaderValueToSign(request, headerName) {
+    const value = request.headers.get(headerName);
+    if (!value) {
+        return "";
+    }
+    // When using version 2015-02-21 or later, if Content-Length is zero, then
+    // set the Content-Length part of the StringToSign to an empty string.
+    // https://learn.microsoft.com/rest/api/storageservices/authenticate-with-shared-key
+    if (headerName === HeaderConstants.CONTENT_LENGTH && value === "0") {
+        return "";
+    }
+    return value;
+}
+/**
+ * To construct the CanonicalizedHeaders portion of the signature string, follow these steps:
+ * 1. Retrieve all headers for the resource that begin with x-ms-, including the x-ms-date header.
+ * 2. Convert each HTTP header name to lowercase.
+ * 3. Sort the headers lexicographically by header name, in ascending order.
+ *    Each header may appear only once in the string.
+ * 4. Replace any linear whitespace in the header value with a single space.
+ * 5. Trim any whitespace around the colon in the header.
+ * 6. Finally, append a new-line character to each canonicalized header in the resulting list.
+ *    Construct the CanonicalizedHeaders string by concatenating all headers in this list into a single string.
+ *
+ */
+function getCanonicalizedHeadersString(request) {
+    let headersArray = [];
+    for (const [name, value] of request.headers) {
+        if (name.toLowerCase().startsWith(HeaderConstants.PREFIX_FOR_STORAGE)) {
+            headersArray.push({ name, value });
+        }
+    }
+    headersArray.sort((a, b) => {
+        return compareHeader(a.name.toLowerCase(), b.name.toLowerCase());
+    });
+    // Remove duplicate headers
+    headersArray = headersArray.filter((value, index, array) => {
+        if (index > 0 && value.name.toLowerCase() === array[index - 1].name.toLowerCase()) {
+            return false;
+        }
+        return true;
+    });
+    let canonicalizedHeadersStringToSign = "";
+    headersArray.forEach((header) => {
+        canonicalizedHeadersStringToSign += `${header.name
+            .toLowerCase()
+            .trimRight()}:${header.value.trimLeft()}\n`;
+    });
+    return canonicalizedHeadersStringToSign;
+}
+function getCanonicalizedResourceString(request, accountName) {
+    const path = getURLPath(request.url) || "/";
+    let canonicalizedResourceString = "";
+    canonicalizedResourceString += `/${accountName}${path}`;
+    // A name that repeats, whether spelled identically or differing only by case, contributes all
+    // of its values as one sorted, comma-joined line.
+    const valuesByKey = getCanonicalizedQueryValues(request.url);
+    for (const key of [...valuesByKey.keys()].sort()) {
+        canonicalizedResourceString += `\n${key}:${valuesByKey.get(key).sort().join(",")}`;
+    }
+    return canonicalizedResourceString;
+}
+/**
+ * Groups query parameter values by lowercased name. Parses the raw query rather than reusing
+ * `getURLQueries`, which keeps only the last value for a repeated name and discards parameters
+ * that the service still canonicalizes.
+ */
+function getCanonicalizedQueryValues(url) {
+    const valuesByKey = new Map();
+    const queryString = new URL(url).search.replace(/^\?/, "").trim();
+    if (!queryString) {
+        return valuesByKey;
+    }
+    for (const pair of queryString.split("&")) {
+        if (!pair) {
+            continue;
+        }
+        // Split at the first "=" only: "=" is legal inside a value, and a name carried without one
+        // still participates in the signature.
+        const separator = pair.indexOf("=");
+        const key = decodeURIComponent(separator === -1 ? pair : pair.substring(0, separator)).toLowerCase();
+        const values = valuesByKey.get(key) ?? [];
+        values.push(separator === -1 ? "" : decodeURIComponent(pair.substring(separator + 1)));
+        valuesByKey.set(key, values);
+    }
+    return valuesByKey;
+}
+/**
+ * Sets the request headers that participate in the Shared Key signature and are derived from
+ * the request itself: `x-ms-date`, and `Content-Length` for a string or Buffer body.
+ *
+ * `Content-Length` is a signed field: a request with a body whose `Content-Length` isn't set
+ * gets a signature the service rejects.
+ */
+export function prepareSharedKeyHeaders(request) {
+    request.headers.set(HeaderConstants.X_MS_DATE, new Date().toUTCString());
+    if (request.body &&
+        (typeof request.body === "string" || Buffer.isBuffer(request.body)) &&
+        request.body.length > 0) {
+        request.headers.set(HeaderConstants.CONTENT_LENGTH, Buffer.byteLength(request.body));
+    }
+}
+/**
+ * Builds the string to sign for the Azure Storage Shared Key authorization scheme.
+ *
+ * Before building it, sets the request headers that the signature covers and that come from
+ * the request itself: `x-ms-date`, and `Content-Length` for a string or Buffer body. Send the
+ * request with these headers, since the signature depends on them.
+ *
+ * @param request - The request to sign. Its `x-ms-date` header is set, and so is its
+ * `Content-Length` header when the body is a string or a Buffer.
+ * @param accountName - The storage account name used to build the canonicalized resource.
+ * @returns The string to sign, ready to be signed with HMAC-SHA256.
+ * @see https://learn.microsoft.com/rest/api/storageservices/authorize-with-shared-key
+ */
+export function buildStorageSharedKeyStringToSign(request, accountName) {
+    prepareSharedKeyHeaders(request);
+    return buildStringToSign(request, accountName);
+}
+/**
+ * Builds the string to sign from the request as it is, without setting any header. For a caller
+ * that sets the signed headers itself on the request it sends.
+ *
+ * @param request - The request whose headers and URL form the string to sign.
+ * @param accountName - The storage account name used to build the canonicalized resource.
+ */
+export function buildStringToSign(request, accountName) {
+    return ([
+        request.method.toUpperCase(),
+        getHeaderValueToSign(request, HeaderConstants.CONTENT_ENCODING),
+        getHeaderValueToSign(request, HeaderConstants.CONTENT_LANGUAGE),
+        getHeaderValueToSign(request, HeaderConstants.CONTENT_LENGTH),
+        getHeaderValueToSign(request, HeaderConstants.CONTENT_MD5),
+        getHeaderValueToSign(request, HeaderConstants.CONTENT_TYPE),
+        // Signed requests always carry x-ms-date, which requires this slot to stay empty.
+        "",
+        getHeaderValueToSign(request, HeaderConstants.IF_MODIFIED_SINCE),
+        getHeaderValueToSign(request, HeaderConstants.IF_MATCH),
+        getHeaderValueToSign(request, HeaderConstants.IF_NONE_MATCH),
+        getHeaderValueToSign(request, HeaderConstants.IF_UNMODIFIED_SINCE),
+        getHeaderValueToSign(request, HeaderConstants.RANGE),
+    ].join("\n") +
+        "\n" +
+        getCanonicalizedHeadersString(request) +
+        getCanonicalizedResourceString(request, accountName));
+}
+//# sourceMappingURL=SharedKeySigning.js.map

package/dist/esm/policies/SharedKeySigning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SharedKeySigning.js","sourceRoot":"","sources":["../../../src/policies/SharedKeySigning.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAGlC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAEhE;;;GAGG;AACH,SAAS,oBAAoB,CAAC,OAAwB,EAAE,UAAkB;IACxE,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAE9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,0EAA0E;IAC1E,sEAAsE;IACtE,oFAAoF;IACpF,IAAI,UAAU,KAAK,eAAe,CAAC,cAAc,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QACnE,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,6BAA6B,CAAC,OAAwB;IAC7D,IAAI,YAAY,GAA2C,EAAE,CAAC;IAC9D,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAC5C,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACtE,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAU,EAAE;QACjC,OAAO,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,2BAA2B;IAC3B,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACzD,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YAClF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,IAAI,gCAAgC,GAAW,EAAE,CAAC;IAClD,YAAY,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QAC9B,gCAAgC,IAAI,GAAG,MAAM,CAAC,IAAI;aAC/C,WAAW,EAAE;aACb,SAAS,EAAE,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,OAAO,gCAAgC,CAAC;AAC1C,CAAC;AAED,SAAS,8BAA8B,CAAC,OAAwB,EAAE,WAAmB;IACnF,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;IAE5C,IAAI,2BAA2B,GAAW,EAAE,CAAC;IAC7C,2BAA2B,IAAI,IAAI,WAAW,GAAG,IAAI,EAAE,CAAC;IAExD,8FAA8F;IAC9F,kDAAkD;IAClD,MAAM,WAAW,GAAG,2BAA2B,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7D,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACjD,2BAA2B,IAAI,KAAK,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACtF,CAAC;IAED,OAAO,2BAA2B,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,SAAS,2BAA2B,CAAC,GAAW;IAC9C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;IAChD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,SAAS;QACX,CAAC;QAED,2FAA2F;QAC3F,uCAAuC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,kBAAkB,CAC5B,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CACvD,CAAC,WAAW,EAAE,CAAC;QAChB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACvF,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAwB;IAC9D,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAEzE,IACE,OAAO,CAAC,IAAI;QACZ,CAAC,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EACvB,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,cAAc,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACvF,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iCAAiC,CAC/C,OAAwB,EACxB,WAAmB;IAEnB,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,OAAO,iBAAiB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAwB,EAAE,WAAmB;IAC7E,OAAO,CACL;QACE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE;QAC5B,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC,gBAAgB,CAAC;QAC/D,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC,gBAAgB,CAAC;QAC/D,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC,cAAc,CAAC;QAC7D,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC,WAAW,CAAC;QAC1D,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC,YAAY,CAAC;QAC3D,kFAAkF;QAClF,EAAE;QACF,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC,iBAAiB,CAAC;QAChE,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC,QAAQ,CAAC;QACvD,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC,aAAa,CAAC;QAC5D,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC,mBAAmB,CAAC;QAClE,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC;KACrD,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,IAAI;QACJ,6BAA6B,CAAC,OAAO,CAAC;QACtC,8BAA8B,CAAC,OAAO,EAAE,WAAW,CAAC,CACrD,CAAC;AACJ,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { PipelineRequest } from \"@azure/core-rest-pipeline\";\nimport { HeaderConstants } from \"../utils/constants.js\";\nimport { getURLPath } from \"../utils/utils.common.js\";\nimport { compareHeader } from \"../utils/SharedKeyComparator.js\";\n\n/**\n * Retrieve header value according to shared key sign rules.\n * @see https://learn.microsoft.com/rest/api/storageservices/authenticate-with-shared-key\n */\nfunction getHeaderValueToSign(request: PipelineRequest, headerName: string): string {\n  const value = request.headers.get(headerName);\n\n  if (!value) {\n    return \"\";\n  }\n\n  // When using version 2015-02-21 or later, if Content-Length is zero, then\n  // set the Content-Length part of the StringToSign to an empty string.\n  // https://learn.microsoft.com/rest/api/storageservices/authenticate-with-shared-key\n  if (headerName === HeaderConstants.CONTENT_LENGTH && value === \"0\") {\n    return \"\";\n  }\n\n  return value;\n}\n\n/**\n * To construct the CanonicalizedHeaders portion of the signature string, follow these steps:\n * 1. Retrieve all headers for the resource that begin with x-ms-, including the x-ms-date header.\n * 2. Convert each HTTP header name to lowercase.\n * 3. Sort the headers lexicographically by header name, in ascending order.\n *    Each header may appear only once in the string.\n * 4. Replace any linear whitespace in the header value with a single space.\n * 5. Trim any whitespace around the colon in the header.\n * 6. Finally, append a new-line character to each canonicalized header in the resulting list.\n *    Construct the CanonicalizedHeaders string by concatenating all headers in this list into a single string.\n *\n */\nfunction getCanonicalizedHeadersString(request: PipelineRequest): string {\n  let headersArray: Array<{ name: string; value: string }> = [];\n  for (const [name, value] of request.headers) {\n    if (name.toLowerCase().startsWith(HeaderConstants.PREFIX_FOR_STORAGE)) {\n      headersArray.push({ name, value });\n    }\n  }\n\n  headersArray.sort((a, b): number => {\n    return compareHeader(a.name.toLowerCase(), b.name.toLowerCase());\n  });\n\n  // Remove duplicate headers\n  headersArray = headersArray.filter((value, index, array) => {\n    if (index > 0 && value.name.toLowerCase() === array[index - 1].name.toLowerCase()) {\n      return false;\n    }\n    return true;\n  });\n\n  let canonicalizedHeadersStringToSign: string = \"\";\n  headersArray.forEach((header) => {\n    canonicalizedHeadersStringToSign += `${header.name\n      .toLowerCase()\n      .trimRight()}:${header.value.trimLeft()}\\n`;\n  });\n\n  return canonicalizedHeadersStringToSign;\n}\n\nfunction getCanonicalizedResourceString(request: PipelineRequest, accountName: string): string {\n  const path = getURLPath(request.url) || \"/\";\n\n  let canonicalizedResourceString: string = \"\";\n  canonicalizedResourceString += `/${accountName}${path}`;\n\n  // A name that repeats, whether spelled identically or differing only by case, contributes all\n  // of its values as one sorted, comma-joined line.\n  const valuesByKey = getCanonicalizedQueryValues(request.url);\n  for (const key of [...valuesByKey.keys()].sort()) {\n    canonicalizedResourceString += `\\n${key}:${valuesByKey.get(key)!.sort().join(\",\")}`;\n  }\n\n  return canonicalizedResourceString;\n}\n\n/**\n * Groups query parameter values by lowercased name. Parses the raw query rather than reusing\n * `getURLQueries`, which keeps only the last value for a repeated name and discards parameters\n * that the service still canonicalizes.\n */\nfunction getCanonicalizedQueryValues(url: string): Map<string, string[]> {\n  const valuesByKey = new Map<string, string[]>();\n  const queryString = new URL(url).search.replace(/^\\?/, \"\").trim();\n  if (!queryString) {\n    return valuesByKey;\n  }\n\n  for (const pair of queryString.split(\"&\")) {\n    if (!pair) {\n      continue;\n    }\n\n    // Split at the first \"=\" only: \"=\" is legal inside a value, and a name carried without one\n    // still participates in the signature.\n    const separator = pair.indexOf(\"=\");\n    const key = decodeURIComponent(\n      separator === -1 ? pair : pair.substring(0, separator),\n    ).toLowerCase();\n    const values = valuesByKey.get(key) ?? [];\n    values.push(separator === -1 ? \"\" : decodeURIComponent(pair.substring(separator + 1)));\n    valuesByKey.set(key, values);\n  }\n\n  return valuesByKey;\n}\n\n/**\n * Sets the request headers that participate in the Shared Key signature and are derived from\n * the request itself: `x-ms-date`, and `Content-Length` for a string or Buffer body.\n *\n * `Content-Length` is a signed field: a request with a body whose `Content-Length` isn't set\n * gets a signature the service rejects.\n */\nexport function prepareSharedKeyHeaders(request: PipelineRequest): void {\n  request.headers.set(HeaderConstants.X_MS_DATE, new Date().toUTCString());\n\n  if (\n    request.body &&\n    (typeof request.body === \"string\" || Buffer.isBuffer(request.body)) &&\n    request.body.length > 0\n  ) {\n    request.headers.set(HeaderConstants.CONTENT_LENGTH, Buffer.byteLength(request.body));\n  }\n}\n\n/**\n * Builds the string to sign for the Azure Storage Shared Key authorization scheme.\n *\n * Before building it, sets the request headers that the signature covers and that come from\n * the request itself: `x-ms-date`, and `Content-Length` for a string or Buffer body. Send the\n * request with these headers, since the signature depends on them.\n *\n * @param request - The request to sign. Its `x-ms-date` header is set, and so is its\n * `Content-Length` header when the body is a string or a Buffer.\n * @param accountName - The storage account name used to build the canonicalized resource.\n * @returns The string to sign, ready to be signed with HMAC-SHA256.\n * @see https://learn.microsoft.com/rest/api/storageservices/authorize-with-shared-key\n */\nexport function buildStorageSharedKeyStringToSign(\n  request: PipelineRequest,\n  accountName: string,\n): string {\n  prepareSharedKeyHeaders(request);\n  return buildStringToSign(request, accountName);\n}\n\n/**\n * Builds the string to sign from the request as it is, without setting any header. For a caller\n * that sets the signed headers itself on the request it sends.\n *\n * @param request - The request whose headers and URL form the string to sign.\n * @param accountName - The storage account name used to build the canonicalized resource.\n */\nexport function buildStringToSign(request: PipelineRequest, accountName: string): string {\n  return (\n    [\n      request.method.toUpperCase(),\n      getHeaderValueToSign(request, HeaderConstants.CONTENT_ENCODING),\n      getHeaderValueToSign(request, HeaderConstants.CONTENT_LANGUAGE),\n      getHeaderValueToSign(request, HeaderConstants.CONTENT_LENGTH),\n      getHeaderValueToSign(request, HeaderConstants.CONTENT_MD5),\n      getHeaderValueToSign(request, HeaderConstants.CONTENT_TYPE),\n      // Signed requests always carry x-ms-date, which requires this slot to stay empty.\n      \"\",\n      getHeaderValueToSign(request, HeaderConstants.IF_MODIFIED_SINCE),\n      getHeaderValueToSign(request, HeaderConstants.IF_MATCH),\n      getHeaderValueToSign(request, HeaderConstants.IF_NONE_MATCH),\n      getHeaderValueToSign(request, HeaderConstants.IF_UNMODIFIED_SINCE),\n      getHeaderValueToSign(request, HeaderConstants.RANGE),\n    ].join(\"\\n\") +\n    \"\\n\" +\n    getCanonicalizedHeadersString(request) +\n    getCanonicalizedResourceString(request, accountName)\n  );\n}\n"]}

package/dist/esm/policies/StorageRedirectRangeHeaderPolicy.d.ts

@@ -0,0 +1,10 @@
+import type { PipelinePolicy } from "@azure/core-rest-pipeline";
+/**
+ * Redirects the "range" header to "x-ms-range" for Azure Storage requests as the latter is preferred.
+ */
+export declare const storageRedirectRangeHeaderPolicyName = "storageRedirectRangeHeaderPolicy";
+/**
+ * StorageRedirectRangeHeaderPolicy
+ */
+export declare function storageRedirectRangeHeaderPolicy(): PipelinePolicy;
+//# sourceMappingURL=StorageRedirectRangeHeaderPolicy.d.ts.map

package/dist/esm/policies/StorageRedirectRangeHeaderPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageRedirectRangeHeaderPolicy.d.ts","sourceRoot":"","sources":["../../../src/policies/StorageRedirectRangeHeaderPolicy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAIV,cAAc,EACf,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,oCAAoC,qCAAqC,CAAC;AAEvF;;GAEG;AACH,wBAAgB,gCAAgC,IAAI,cAAc,CAWjE"}

package/dist/esm/policies/StorageRedirectRangeHeaderPolicy.js

@@ -0,0 +1,22 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/**
+ * Redirects the "range" header to "x-ms-range" for Azure Storage requests as the latter is preferred.
+ */
+export const storageRedirectRangeHeaderPolicyName = "storageRedirectRangeHeaderPolicy";
+/**
+ * StorageRedirectRangeHeaderPolicy
+ */
+export function storageRedirectRangeHeaderPolicy() {
+    return {
+        name: storageRedirectRangeHeaderPolicyName,
+        async sendRequest(request, next) {
+            if (request.headers.has("range")) {
+                request.headers.set("x-ms-range", request.headers.get("range"));
+                request.headers.delete("range");
+            }
+            return next(request);
+        },
+    };
+}
+//# sourceMappingURL=StorageRedirectRangeHeaderPolicy.js.map

package/dist/esm/policies/StorageRedirectRangeHeaderPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageRedirectRangeHeaderPolicy.js","sourceRoot":"","sources":["../../../src/policies/StorageRedirectRangeHeaderPolicy.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AASlC;;GAEG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,kCAAkC,CAAC;AAEvF;;GAEG;AACH,MAAM,UAAU,gCAAgC;IAC9C,OAAO;QACL,IAAI,EAAE,oCAAoC;QAC1C,KAAK,CAAC,WAAW,CAAC,OAAwB,EAAE,IAAiB;YAC3D,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,CAAC;gBACjE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAClC,CAAC;YACD,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type {\n  PipelineRequest,\n  PipelineResponse,\n  SendRequest,\n  PipelinePolicy,\n} from \"@azure/core-rest-pipeline\";\n\n/**\n * Redirects the \"range\" header to \"x-ms-range\" for Azure Storage requests as the latter is preferred.\n */\nexport const storageRedirectRangeHeaderPolicyName = \"storageRedirectRangeHeaderPolicy\";\n\n/**\n * StorageRedirectRangeHeaderPolicy\n */\nexport function storageRedirectRangeHeaderPolicy(): PipelinePolicy {\n  return {\n    name: storageRedirectRangeHeaderPolicyName,\n    async sendRequest(request: PipelineRequest, next: SendRequest): Promise<PipelineResponse> {\n      if (request.headers.has(\"range\")) {\n        request.headers.set(\"x-ms-range\", request.headers.get(\"range\")!);\n        request.headers.delete(\"range\");\n      }\n      return next(request);\n    },\n  };\n}\n"]}

package/dist/esm/policies/StorageRequestFailureDetailsParserPolicy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StorageRequestFailureDetailsParserPolicy.d.ts","sourceRoot":"","sources":["../../../src/policies/StorageRequestFailureDetailsParserPolicy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAIV,cAAc,EACf,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,4CAA4C,6CACb,CAAC;AAE7C;;GAEG;AACH,wBAAgB,wCAAwC,IAAI,cAAc,CA0BzE"}
+{"version":3,"file":"StorageRequestFailureDetailsParserPolicy.d.ts","sourceRoot":"","sources":["../../../src/policies/StorageRequestFailureDetailsParserPolicy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAIV,cAAc,EACf,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,4CAA4C,6CACb,CAAC;AAE7C;;GAEG;AACH,wBAAgB,wCAAwC,IAAI,cAAc,CA2CzE"}

package/dist/esm/policies/StorageRequestFailureDetailsParserPolicy.js

@@ -13,6 +13,18 @@ export function storageRequestFailureDetailsParserPolicy() {
         async sendRequest(request, next) {
             try {
                 const response = await next(request);
+                if (response.status === 400 &&
+                    response.bodyAsText?.includes("<Error><Code>InvalidHeaderValue</Code>") &&
+                    response.bodyAsText.includes("<HeaderName>x-ms-version</HeaderName>")) {
+                    // replace the error message with a more user-friendly one that includes a link to documentation
+                    /* example response text:
+                    `<?xml version="1.0" encoding="utf-8"?>
+          <Error><Code>InvalidHeaderValue</Code><Message>The value for one of the HTTP headers is not in the correct format.
+          RequestId:e5ea566c-101e-001c-1ec4-acf180000000
+          Time:2026-03-05T17:24:34.6688015Z</Message><HeaderName>x-ms-version</HeaderName><HeaderValue>3025-01-01</HeaderValue></Error>`
+                    */
+                    response.bodyAsText = response.bodyAsText.replace(/<Message>.*<\/Message>/s, "<Message>The provided service version is not enabled on this storage account. Please see https://learn.microsoft.com/rest/api/storageservices/versioning-for-the-azure-storage-services for additional information.</Message>");
+                }
                 return response;
             }
             catch (err) {

package/dist/esm/policies/StorageRequestFailureDetailsParserPolicy.js.map

@@ -1 +1 @@
-{"version":3,"file":"StorageRequestFailureDetailsParserPolicy.js","sourceRoot":"","sources":["../../../src/policies/StorageRequestFailureDetailsParserPolicy.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AASlC;;GAEG;AACH,MAAM,CAAC,MAAM,4CAA4C,GACvD,0CAA0C,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,wCAAwC;IACtD,OAAO;QACL,IAAI,EAAE,4CAA4C;QAClD,KAAK,CAAC,WAAW,CAAC,OAAwB,EAAE,IAAiB;YAC3D,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;gBACrC,OAAO,QAAQ,CAAC;YAClB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IACE,OAAO,GAAG,KAAK,QAAQ;oBACvB,GAAG,KAAK,IAAI;oBACX,GAAW,CAAC,QAAQ;oBACpB,GAAW,CAAC,QAAQ,CAAC,UAAU,EAChC,CAAC;oBACD,IACG,GAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,oBAAoB;wBAC7D,GAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,KAAK,cAAc,EAC9D,CAAC;wBACA,GAAW,CAAC,OAAO;4BAClB,8MAA8M,CAAC;oBACnN,CAAC;gBACH,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type {\n  PipelineRequest,\n  PipelineResponse,\n  SendRequest,\n  PipelinePolicy,\n} from \"@azure/core-rest-pipeline\";\n\n/**\n * The programmatic identifier of the StorageRequestFailureDetailsParserPolicy.\n */\nexport const storageRequestFailureDetailsParserPolicyName =\n  \"storageRequestFailureDetailsParserPolicy\";\n\n/**\n * StorageRequestFailureDetailsParserPolicy\n */\nexport function storageRequestFailureDetailsParserPolicy(): PipelinePolicy {\n  return {\n    name: storageRequestFailureDetailsParserPolicyName,\n    async sendRequest(request: PipelineRequest, next: SendRequest): Promise<PipelineResponse> {\n      try {\n        const response = await next(request);\n        return response;\n      } catch (err) {\n        if (\n          typeof err === \"object\" &&\n          err !== null &&\n          (err as any).response &&\n          (err as any).response.parsedBody\n        ) {\n          if (\n            (err as any).response.parsedBody.code === \"InvalidHeaderValue\" &&\n            (err as any).response.parsedBody.HeaderName === \"x-ms-version\"\n          ) {\n            (err as any).message =\n              \"The provided service version is not enabled on this storage account. Please see https://learn.microsoft.com/rest/api/storageservices/versioning-for-the-azure-storage-services for additional information.\\n\";\n          }\n        }\n        throw err;\n      }\n    },\n  };\n}\n"]}
+{"version":3,"file":"StorageRequestFailureDetailsParserPolicy.js","sourceRoot":"","sources":["../../../src/policies/StorageRequestFailureDetailsParserPolicy.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AASlC;;GAEG;AACH,MAAM,CAAC,MAAM,4CAA4C,GACvD,0CAA0C,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,wCAAwC;IACtD,OAAO;QACL,IAAI,EAAE,4CAA4C;QAClD,KAAK,CAAC,WAAW,CAAC,OAAwB,EAAE,IAAiB;YAC3D,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;gBACrC,IACE,QAAQ,CAAC,MAAM,KAAK,GAAG;oBACvB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,wCAAwC,CAAC;oBACvE,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,uCAAuC,CAAC,EACrE,CAAC;oBACD,gGAAgG;oBAChG;;;;;sBAKE;oBACF,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,OAAO,CAC/C,yBAAyB,EACzB,+NAA+N,CAChO,CAAC;gBACJ,CAAC;gBACD,OAAO,QAAQ,CAAC;YAClB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IACE,OAAO,GAAG,KAAK,QAAQ;oBACvB,GAAG,KAAK,IAAI;oBACX,GAAW,CAAC,QAAQ;oBACpB,GAAW,CAAC,QAAQ,CAAC,UAAU,EAChC,CAAC;oBACD,IACG,GAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,oBAAoB;wBAC7D,GAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,KAAK,cAAc,EAC9D,CAAC;wBACA,GAAW,CAAC,OAAO;4BAClB,8MAA8M,CAAC;oBACnN,CAAC;gBACH,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type {\n  PipelineRequest,\n  PipelineResponse,\n  SendRequest,\n  PipelinePolicy,\n} from \"@azure/core-rest-pipeline\";\n\n/**\n * The programmatic identifier of the StorageRequestFailureDetailsParserPolicy.\n */\nexport const storageRequestFailureDetailsParserPolicyName =\n  \"storageRequestFailureDetailsParserPolicy\";\n\n/**\n * StorageRequestFailureDetailsParserPolicy\n */\nexport function storageRequestFailureDetailsParserPolicy(): PipelinePolicy {\n  return {\n    name: storageRequestFailureDetailsParserPolicyName,\n    async sendRequest(request: PipelineRequest, next: SendRequest): Promise<PipelineResponse> {\n      try {\n        const response = await next(request);\n        if (\n          response.status === 400 &&\n          response.bodyAsText?.includes(\"<Error><Code>InvalidHeaderValue</Code>\") &&\n          response.bodyAsText.includes(\"<HeaderName>x-ms-version</HeaderName>\")\n        ) {\n          // replace the error message with a more user-friendly one that includes a link to documentation\n          /* example response text:\n          `<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<Error><Code>InvalidHeaderValue</Code><Message>The value for one of the HTTP headers is not in the correct format.\nRequestId:e5ea566c-101e-001c-1ec4-acf180000000\nTime:2026-03-05T17:24:34.6688015Z</Message><HeaderName>x-ms-version</HeaderName><HeaderValue>3025-01-01</HeaderValue></Error>`\n          */\n          response.bodyAsText = response.bodyAsText.replace(\n            /<Message>.*<\\/Message>/s,\n            \"<Message>The provided service version is not enabled on this storage account. Please see https://learn.microsoft.com/rest/api/storageservices/versioning-for-the-azure-storage-services for additional information.</Message>\",\n          );\n        }\n        return response;\n      } catch (err) {\n        if (\n          typeof err === \"object\" &&\n          err !== null &&\n          (err as any).response &&\n          (err as any).response.parsedBody\n        ) {\n          if (\n            (err as any).response.parsedBody.code === \"InvalidHeaderValue\" &&\n            (err as any).response.parsedBody.HeaderName === \"x-ms-version\"\n          ) {\n            (err as any).message =\n              \"The provided service version is not enabled on this storage account. Please see https://learn.microsoft.com/rest/api/storageservices/versioning-for-the-azure-storage-services for additional information.\\n\";\n          }\n        }\n        throw err;\n      }\n    },\n  };\n}\n"]}

package/dist/esm/policies/StorageRetryPolicy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StorageRetryPolicy.d.ts","sourceRoot":"","sources":["../../../src/policies/StorageRetryPolicy.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,aAAa,EACb,wBAAwB,IAAI,oBAAoB,EAChD,oBAAoB,EACpB,eAAe,IAAI,WAAW,EAC9B,cAAc,IAAI,qBAAqB,EACxC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAM3E;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,CAAC,EAAE,mBAAmB,GAAG,oBAAoB,CAM9F;AAcD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,iBAAiB;IACvD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IAEnD;;;;;;OAMG;gBAED,UAAU,EAAE,aAAa,EACzB,OAAO,EAAE,oBAAoB,EAC7B,YAAY,GAAE,mBAA2C;IAyC3D;;;;OAIG;IACU,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI9E;;;;;;;;;OASG;cACa,kBAAkB,CAChC,OAAO,EAAE,WAAW,EACpB,eAAe,EAAE,OAAO,EACxB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC;IA0CjC;;;;;;;OAOG;IACH,SAAS,CAAC,WAAW,CACnB,cAAc,EAAE,OAAO,EACvB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,qBAAqB,EAChC,GAAG,CAAC,EAAE,SAAS,GACd,OAAO;IA6EV;;;;;;OAMG;YACW,KAAK;CA0BpB"}
+{"version":3,"file":"StorageRetryPolicy.d.ts","sourceRoot":"","sources":["../../../src/policies/StorageRetryPolicy.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,aAAa,EACb,wBAAwB,IAAI,oBAAoB,EAChD,oBAAoB,EACpB,eAAe,IAAI,WAAW,EAC9B,cAAc,IAAI,qBAAqB,EACxC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAM3E;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,CAAC,EAAE,mBAAmB,GAAG,oBAAoB,CAM9F;AAcD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,iBAAiB;IACvD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IAEnD;;;;;;OAMG;gBAED,UAAU,EAAE,aAAa,EACzB,OAAO,EAAE,oBAAoB,EAC7B,YAAY,GAAE,mBAA2C;IAyC3D;;;;OAIG;IACU,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI9E;;;;;;;;;OASG;cACa,kBAAkB,CAChC,OAAO,EAAE,WAAW,EACpB,eAAe,EAAE,OAAO,EACxB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC;IA0CjC;;;;;;;OAOG;IACH,SAAS,CAAC,WAAW,CACnB,cAAc,EAAE,OAAO,EACvB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,qBAAqB,EAChC,GAAG,CAAC,EAAE,SAAS,GACd,OAAO;IA8EV;;;;;;OAMG;YACW,KAAK;CA0BpB"}

package/dist/esm/policies/StorageRetryPolicy.js

@@ -116,7 +116,7 @@ export class StorageRetryPolicy extends BaseRequestPolicy {
             }
         }
         await this.delay(isPrimaryRetry, attempt, request.abortSignal);
-        return this.attemptSendRequest(request, secondaryHas404, ++attempt);
+        return this.attemptSendRequest(request, secondaryHas404, attempt + 1);
     }
     /**
      * Decide whether to retry according to last HTTP response and retry counters.
@@ -128,8 +128,7 @@ export class StorageRetryPolicy extends BaseRequestPolicy {
      */
     shouldRetry(isPrimaryRetry, attempt, response, err) {
         if (attempt >= this.retryOptions.maxTries) {
-            logger.info(`RetryPolicy: Attempt(s) ${attempt} >= maxTries ${this.retryOptions
-                .maxTries}, no further try.`);
+            logger.info(`RetryPolicy: Attempt(s) ${attempt} >= maxTries ${this.retryOptions.maxTries}, no further try.`);
             return false;
         }
         // Handle network failures, you may need to customize the list when you implement