@azure/storage-file-share 12.28.0-beta.1 → 12.28.1-alpha.20250724.2

package/dist/esm/AccountSASServices.js.map

@@ -1 +1 @@
-{"version":3,"file":"AccountSASServices.js","sourceRoot":"","sources":["../../src/AccountSASServices.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC;;;;;;;;GAQG;AACH,MAAM,OAAO,kBAAkB;IAA/B;QAgCE;;WAEG;QACI,SAAI,GAAY,KAAK,CAAC;QAE7B;;WAEG;QACI,SAAI,GAAY,KAAK,CAAC;QAE7B;;WAEG;QACI,UAAK,GAAY,KAAK,CAAC;QAE9B;;WAEG;QACI,UAAK,GAAY,KAAK,CAAC;IAsBhC,CAAC;IAvEC;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,QAAgB;QAClC,MAAM,kBAAkB,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAEpD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,QAAQ,CAAC,EAAE,CAAC;gBACV,KAAK,GAAG;oBACN,kBAAkB,CAAC,IAAI,GAAG,IAAI,CAAC;oBAC/B,MAAM;gBACR,KAAK,GAAG;oBACN,kBAAkB,CAAC,IAAI,GAAG,IAAI,CAAC;oBAC/B,MAAM;gBACR,KAAK,GAAG;oBACN,kBAAkB,CAAC,KAAK,GAAG,IAAI,CAAC;oBAChC,MAAM;gBACR,KAAK,GAAG;oBACN,kBAAkB,CAAC,KAAK,GAAG,IAAI,CAAC;oBAChC,MAAM;gBACR;oBACE,MAAM,IAAI,UAAU,CAAC,8BAA8B,CAAC,EAAE,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QAED,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAsBD;;;OAGG;IACI,QAAQ;QACb,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;CACF","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\n/**\n * ONLY AVAILABLE IN NODE.JS RUNTIME.\n *\n * This is a helper class to construct a string representing the services accessible by an AccountSAS. Setting a value\n * to true means that any SAS which uses these permissions will grant access to that service. Once all the\n * values are set, this should be serialized with toString and set as the services field on an\n * {@link AccountSASSignatureValues} object. It is possible to construct the services string without this class, but\n * the order of the services is particular and this class guarantees correctness.\n */\nexport class AccountSASServices {\n  /**\n   * Creates an {@link AccountSASServices} from the specified services string. This method will throw an\n   * Error if it encounters a character that does not correspond to a valid service.\n   *\n   * @param services -\n   */\n  public static parse(services: string): AccountSASServices {\n    const accountSASServices = new AccountSASServices();\n\n    for (const c of services) {\n      switch (c) {\n        case \"b\":\n          accountSASServices.blob = true;\n          break;\n        case \"f\":\n          accountSASServices.file = true;\n          break;\n        case \"q\":\n          accountSASServices.queue = true;\n          break;\n        case \"t\":\n          accountSASServices.table = true;\n          break;\n        default:\n          throw new RangeError(`Invalid service character: ${c}`);\n      }\n    }\n\n    return accountSASServices;\n  }\n\n  /**\n   * Permission to access blob resources granted.\n   */\n  public blob: boolean = false;\n\n  /**\n   * Permission to access file resources granted.\n   */\n  public file: boolean = false;\n\n  /**\n   * Permission to access queue resources granted.\n   */\n  public queue: boolean = false;\n\n  /**\n   * Permission to access table resources granted.\n   */\n  public table: boolean = false;\n\n  /**\n   * Converts the given services to a string.\n   *\n   */\n  public toString(): string {\n    const services: string[] = [];\n    if (this.blob) {\n      services.push(\"b\");\n    }\n    if (this.table) {\n      services.push(\"t\");\n    }\n    if (this.queue) {\n      services.push(\"q\");\n    }\n    if (this.file) {\n      services.push(\"f\");\n    }\n    return services.join(\"\");\n  }\n}\n"]}
+{"version":3,"file":"AccountSASServices.js","sourceRoot":"","sources":["../../src/AccountSASServices.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC;;;;;;;;GAQG;AACH,MAAM,OAAO,kBAAkB;IAC7B;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,QAAgB;QAClC,MAAM,kBAAkB,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAEpD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,QAAQ,CAAC,EAAE,CAAC;gBACV,KAAK,GAAG;oBACN,kBAAkB,CAAC,IAAI,GAAG,IAAI,CAAC;oBAC/B,MAAM;gBACR,KAAK,GAAG;oBACN,kBAAkB,CAAC,IAAI,GAAG,IAAI,CAAC;oBAC/B,MAAM;gBACR,KAAK,GAAG;oBACN,kBAAkB,CAAC,KAAK,GAAG,IAAI,CAAC;oBAChC,MAAM;gBACR,KAAK,GAAG;oBACN,kBAAkB,CAAC,KAAK,GAAG,IAAI,CAAC;oBAChC,MAAM;gBACR;oBACE,MAAM,IAAI,UAAU,CAAC,8BAA8B,CAAC,EAAE,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QAED,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,IAAI,GAAY,KAAK,CAAC;IAE7B;;OAEG;IACI,IAAI,GAAY,KAAK,CAAC;IAE7B;;OAEG;IACI,KAAK,GAAY,KAAK,CAAC;IAE9B;;OAEG;IACI,KAAK,GAAY,KAAK,CAAC;IAE9B;;;OAGG;IACI,QAAQ;QACb,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;CACF","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\n/**\n * ONLY AVAILABLE IN NODE.JS RUNTIME.\n *\n * This is a helper class to construct a string representing the services accessible by an AccountSAS. Setting a value\n * to true means that any SAS which uses these permissions will grant access to that service. Once all the\n * values are set, this should be serialized with toString and set as the services field on an\n * {@link AccountSASSignatureValues} object. It is possible to construct the services string without this class, but\n * the order of the services is particular and this class guarantees correctness.\n */\nexport class AccountSASServices {\n  /**\n   * Creates an {@link AccountSASServices} from the specified services string. This method will throw an\n   * Error if it encounters a character that does not correspond to a valid service.\n   *\n   * @param services -\n   */\n  public static parse(services: string): AccountSASServices {\n    const accountSASServices = new AccountSASServices();\n\n    for (const c of services) {\n      switch (c) {\n        case \"b\":\n          accountSASServices.blob = true;\n          break;\n        case \"f\":\n          accountSASServices.file = true;\n          break;\n        case \"q\":\n          accountSASServices.queue = true;\n          break;\n        case \"t\":\n          accountSASServices.table = true;\n          break;\n        default:\n          throw new RangeError(`Invalid service character: ${c}`);\n      }\n    }\n\n    return accountSASServices;\n  }\n\n  /**\n   * Permission to access blob resources granted.\n   */\n  public blob: boolean = false;\n\n  /**\n   * Permission to access file resources granted.\n   */\n  public file: boolean = false;\n\n  /**\n   * Permission to access queue resources granted.\n   */\n  public queue: boolean = false;\n\n  /**\n   * Permission to access table resources granted.\n   */\n  public table: boolean = false;\n\n  /**\n   * Converts the given services to a string.\n   *\n   */\n  public toString(): string {\n    const services: string[] = [];\n    if (this.blob) {\n      services.push(\"b\");\n    }\n    if (this.table) {\n      services.push(\"t\");\n    }\n    if (this.queue) {\n      services.push(\"q\");\n    }\n    if (this.file) {\n      services.push(\"f\");\n    }\n    return services.join(\"\");\n  }\n}\n"]}

package/dist/esm/AccountSASSignatureValues.d.ts

@@ -1,5 +1,5 @@
 import { AccountSASPermissions } from "./AccountSASPermissions.js";
-import type { StorageSharedKeyCredential } from "@azure/storage-blob";
+import type { StorageSharedKeyCredential } from "@azure/storage-common";
 import type { SasIPRange } from "./SasIPRange.js";
 import type { SASProtocol } from "./SASQueryParameters.js";
 import { SASQueryParameters } from "./SASQueryParameters.js";
@@ -12,10 +12,10 @@ import { SASQueryParameters } from "./SASQueryParameters.js";
  * the former is mutable and a logical representation while the latter is immutable and used to generate actual REST
  * requests.
  *
- * @see https://learn.microsoft.com/en-us/azure/storage/common/storage-dotnet-shared-access-signature-part-1
+ * @see https://learn.microsoft.com/azure/storage/common/storage-dotnet-shared-access-signature-part-1
  * for more conceptual information on SAS
  *
- * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-an-account-sas
+ * @see https://learn.microsoft.com/rest/api/storageservices/constructing-an-account-sas
  * for descriptions of the parameters, including which are required
  */
 export interface AccountSASSignatureValues {
@@ -61,7 +61,7 @@ export interface AccountSASSignatureValues {
  * Generates a {@link SASQueryParameters} object which contains all SAS query parameters needed to make an actual
  * REST request.
  *
- * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-an-account-sas
+ * @see https://learn.microsoft.com/rest/api/storageservices/constructing-an-account-sas
  *
  * @param sharedKeyCredential -
  */

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

@@ -1 +1 @@
-{"version":3,"file":"AccountSASSignatureValues.d.ts","sourceRoot":"","sources":["../../src/AccountSASSignatureValues.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAI7D;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,IAAI,CAAC;IAEhB;;;OAGG;IACH,WAAW,EAAE,qBAAqB,CAAC;IAEnC;;OAEG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC;IAErB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iCAAiC,CAC/C,yBAAyB,EAAE,yBAAyB,EACpD,mBAAmB,EAAE,0BAA0B,GAC9C,kBAAkB,CAGpB;AAED,wBAAgB,yCAAyC,CACvD,yBAAyB,EAAE,yBAAyB,EACpD,mBAAmB,EAAE,0BAA0B,GAC9C;IAAE,kBAAkB,EAAE,kBAAkB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAgElE"}
+{"version":3,"file":"AccountSASSignatureValues.d.ts","sourceRoot":"","sources":["../../src/AccountSASSignatureValues.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAI7D;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,IAAI,CAAC;IAEhB;;;OAGG;IACH,WAAW,EAAE,qBAAqB,CAAC;IAEnC;;OAEG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC;IAErB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iCAAiC,CAC/C,yBAAyB,EAAE,yBAAyB,EACpD,mBAAmB,EAAE,0BAA0B,GAC9C,kBAAkB,CAGpB;AAED,wBAAgB,yCAAyC,CACvD,yBAAyB,EAAE,yBAAyB,EACpD,mBAAmB,EAAE,0BAA0B,GAC9C;IAAE,kBAAkB,EAAE,kBAAkB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAgElE"}

package/dist/esm/AccountSASSignatureValues.js

@@ -13,7 +13,7 @@ import { truncatedISO8061Date } from "./utils/utils.common.js";
  * Generates a {@link SASQueryParameters} object which contains all SAS query parameters needed to make an actual
  * REST request.
  *
- * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-an-account-sas
+ * @see https://learn.microsoft.com/rest/api/storageservices/constructing-an-account-sas
  *
  * @param sharedKeyCredential -
  */

package/dist/esm/AccountSASSignatureValues.js.map

@@ -1 +1 @@
-{"version":3,"file":"AccountSASSignatureValues.js","sourceRoot":"","sources":["../../src/AccountSASSignatureValues.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { AccountSASPermissions } from \"./AccountSASPermissions.js\";\nimport { AccountSASResourceTypes } from \"./AccountSASResourceTypes.js\";\nimport { AccountSASServices } from \"./AccountSASServices.js\";\nimport type { StorageSharedKeyCredential } from \"@azure/storage-blob\";\nimport type { SasIPRange } from \"./SasIPRange.js\";\nimport { ipRangeToString } from \"./SasIPRange.js\";\nimport type { SASProtocol } from \"./SASQueryParameters.js\";\nimport { SASQueryParameters } from \"./SASQueryParameters.js\";\nimport { SERVICE_VERSION } from \"./utils/constants.js\";\nimport { truncatedISO8061Date } from \"./utils/utils.common.js\";\n\n/**\n * ONLY AVAILABLE IN NODE.JS RUNTIME.\n *\n * AccountSASSignatureValues is used to generate a Shared Access Signature (SAS) for an Azure Storage account. Once\n * all the values here are set appropriately, call {@link generateAccountSASQueryParameters} to obtain a representation of the SAS\n * which can actually be applied to file urls. Note: that both this class and {@link SASQueryParameters} exist because\n * the former is mutable and a logical representation while the latter is immutable and used to generate actual REST\n * requests.\n *\n * @see https://learn.microsoft.com/en-us/azure/storage/common/storage-dotnet-shared-access-signature-part-1\n * for more conceptual information on SAS\n *\n * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-an-account-sas\n * for descriptions of the parameters, including which are required\n */\nexport interface AccountSASSignatureValues {\n  /**\n   * If not provided, this defaults to the service version targeted by this version of the library.\n   */\n  version?: string;\n\n  /**\n   * Optional. SAS protocols allowed.\n   */\n  protocol?: SASProtocol;\n\n  /**\n   * Optional. When the SAS will take effect.\n   */\n  startsOn?: Date;\n\n  /**\n   * The time after which the SAS will no longer work.\n   */\n  expiresOn: Date;\n\n  /**\n   * Specifies which operations the SAS user may perform. Please refer to {@link AccountSASPermissions} for help\n   * constructing the permissions string.\n   */\n  permissions: AccountSASPermissions;\n\n  /**\n   * Optional. IP range allowed.\n   */\n  ipRange?: SasIPRange;\n\n  /**\n   * The values that indicate the services accessible with this SAS. Please refer to {@link AccountSASServices} to\n   * construct this value.\n   */\n  services: string;\n\n  /**\n   * The values that indicate the resource types accessible with this SAS. Please refer\n   * to {@link AccountSASResourceTypes} to construct this value.\n   */\n  resourceTypes: string;\n}\n\n/**\n * ONLY AVAILABLE IN NODE.JS RUNTIME.\n *\n * Generates a {@link SASQueryParameters} object which contains all SAS query parameters needed to make an actual\n * REST request.\n *\n * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-an-account-sas\n *\n * @param sharedKeyCredential -\n */\nexport function generateAccountSASQueryParameters(\n  accountSASSignatureValues: AccountSASSignatureValues,\n  sharedKeyCredential: StorageSharedKeyCredential,\n): SASQueryParameters {\n  return generateAccountSASQueryParametersInternal(accountSASSignatureValues, sharedKeyCredential)\n    .sasQueryParameters;\n}\n\nexport function generateAccountSASQueryParametersInternal(\n  accountSASSignatureValues: AccountSASSignatureValues,\n  sharedKeyCredential: StorageSharedKeyCredential,\n): { sasQueryParameters: SASQueryParameters; stringToSign: string } {\n  const version = accountSASSignatureValues.version\n    ? accountSASSignatureValues.version\n    : SERVICE_VERSION;\n\n  const parsedPermissions = AccountSASPermissions.parse(\n    accountSASSignatureValues.permissions.toString(),\n  ).toString();\n  const parsedServices = AccountSASServices.parse(accountSASSignatureValues.services).toString();\n  const parsedResourceTypes = AccountSASResourceTypes.parse(\n    accountSASSignatureValues.resourceTypes,\n  ).toString();\n\n  let stringToSign: string;\n\n  if (version >= \"2020-12-06\") {\n    stringToSign = [\n      sharedKeyCredential.accountName,\n      parsedPermissions,\n      parsedServices,\n      parsedResourceTypes,\n      accountSASSignatureValues.startsOn\n        ? truncatedISO8061Date(accountSASSignatureValues.startsOn, false)\n        : \"\",\n      truncatedISO8061Date(accountSASSignatureValues.expiresOn, false),\n      accountSASSignatureValues.ipRange ? ipRangeToString(accountSASSignatureValues.ipRange) : \"\",\n      accountSASSignatureValues.protocol ? accountSASSignatureValues.protocol : \"\",\n      version,\n      \"\", // Reserved for encryption scope\n      \"\", // Account SAS requires an additional newline character\n    ].join(\"\\n\");\n  } else {\n    stringToSign = [\n      sharedKeyCredential.accountName,\n      parsedPermissions,\n      parsedServices,\n      parsedResourceTypes,\n      accountSASSignatureValues.startsOn\n        ? truncatedISO8061Date(accountSASSignatureValues.startsOn, false)\n        : \"\",\n      truncatedISO8061Date(accountSASSignatureValues.expiresOn, false),\n      accountSASSignatureValues.ipRange ? ipRangeToString(accountSASSignatureValues.ipRange) : \"\",\n      accountSASSignatureValues.protocol ? accountSASSignatureValues.protocol : \"\",\n      version,\n      \"\", // Account SAS requires an additional newline character\n    ].join(\"\\n\");\n  }\n\n  const signature: string = sharedKeyCredential.computeHMACSHA256(stringToSign);\n\n  return {\n    sasQueryParameters: new SASQueryParameters(\n      version,\n      signature,\n      parsedPermissions,\n      parsedServices,\n      parsedResourceTypes,\n      accountSASSignatureValues.protocol,\n      accountSASSignatureValues.startsOn,\n      accountSASSignatureValues.expiresOn,\n      accountSASSignatureValues.ipRange,\n    ),\n    stringToSign: stringToSign,\n  };\n}\n"]}
+{"version":3,"file":"AccountSASSignatureValues.js","sourceRoot":"","sources":["../../src/AccountSASSignatureValues.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { AccountSASPermissions } from \"./AccountSASPermissions.js\";\nimport { AccountSASResourceTypes } from \"./AccountSASResourceTypes.js\";\nimport { AccountSASServices } from \"./AccountSASServices.js\";\nimport type { StorageSharedKeyCredential } from \"@azure/storage-common\";\nimport type { SasIPRange } from \"./SasIPRange.js\";\nimport { ipRangeToString } from \"./SasIPRange.js\";\nimport type { SASProtocol } from \"./SASQueryParameters.js\";\nimport { SASQueryParameters } from \"./SASQueryParameters.js\";\nimport { SERVICE_VERSION } from \"./utils/constants.js\";\nimport { truncatedISO8061Date } from \"./utils/utils.common.js\";\n\n/**\n * ONLY AVAILABLE IN NODE.JS RUNTIME.\n *\n * AccountSASSignatureValues is used to generate a Shared Access Signature (SAS) for an Azure Storage account. Once\n * all the values here are set appropriately, call {@link generateAccountSASQueryParameters} to obtain a representation of the SAS\n * which can actually be applied to file urls. Note: that both this class and {@link SASQueryParameters} exist because\n * the former is mutable and a logical representation while the latter is immutable and used to generate actual REST\n * requests.\n *\n * @see https://learn.microsoft.com/azure/storage/common/storage-dotnet-shared-access-signature-part-1\n * for more conceptual information on SAS\n *\n * @see https://learn.microsoft.com/rest/api/storageservices/constructing-an-account-sas\n * for descriptions of the parameters, including which are required\n */\nexport interface AccountSASSignatureValues {\n  /**\n   * If not provided, this defaults to the service version targeted by this version of the library.\n   */\n  version?: string;\n\n  /**\n   * Optional. SAS protocols allowed.\n   */\n  protocol?: SASProtocol;\n\n  /**\n   * Optional. When the SAS will take effect.\n   */\n  startsOn?: Date;\n\n  /**\n   * The time after which the SAS will no longer work.\n   */\n  expiresOn: Date;\n\n  /**\n   * Specifies which operations the SAS user may perform. Please refer to {@link AccountSASPermissions} for help\n   * constructing the permissions string.\n   */\n  permissions: AccountSASPermissions;\n\n  /**\n   * Optional. IP range allowed.\n   */\n  ipRange?: SasIPRange;\n\n  /**\n   * The values that indicate the services accessible with this SAS. Please refer to {@link AccountSASServices} to\n   * construct this value.\n   */\n  services: string;\n\n  /**\n   * The values that indicate the resource types accessible with this SAS. Please refer\n   * to {@link AccountSASResourceTypes} to construct this value.\n   */\n  resourceTypes: string;\n}\n\n/**\n * ONLY AVAILABLE IN NODE.JS RUNTIME.\n *\n * Generates a {@link SASQueryParameters} object which contains all SAS query parameters needed to make an actual\n * REST request.\n *\n * @see https://learn.microsoft.com/rest/api/storageservices/constructing-an-account-sas\n *\n * @param sharedKeyCredential -\n */\nexport function generateAccountSASQueryParameters(\n  accountSASSignatureValues: AccountSASSignatureValues,\n  sharedKeyCredential: StorageSharedKeyCredential,\n): SASQueryParameters {\n  return generateAccountSASQueryParametersInternal(accountSASSignatureValues, sharedKeyCredential)\n    .sasQueryParameters;\n}\n\nexport function generateAccountSASQueryParametersInternal(\n  accountSASSignatureValues: AccountSASSignatureValues,\n  sharedKeyCredential: StorageSharedKeyCredential,\n): { sasQueryParameters: SASQueryParameters; stringToSign: string } {\n  const version = accountSASSignatureValues.version\n    ? accountSASSignatureValues.version\n    : SERVICE_VERSION;\n\n  const parsedPermissions = AccountSASPermissions.parse(\n    accountSASSignatureValues.permissions.toString(),\n  ).toString();\n  const parsedServices = AccountSASServices.parse(accountSASSignatureValues.services).toString();\n  const parsedResourceTypes = AccountSASResourceTypes.parse(\n    accountSASSignatureValues.resourceTypes,\n  ).toString();\n\n  let stringToSign: string;\n\n  if (version >= \"2020-12-06\") {\n    stringToSign = [\n      sharedKeyCredential.accountName,\n      parsedPermissions,\n      parsedServices,\n      parsedResourceTypes,\n      accountSASSignatureValues.startsOn\n        ? truncatedISO8061Date(accountSASSignatureValues.startsOn, false)\n        : \"\",\n      truncatedISO8061Date(accountSASSignatureValues.expiresOn, false),\n      accountSASSignatureValues.ipRange ? ipRangeToString(accountSASSignatureValues.ipRange) : \"\",\n      accountSASSignatureValues.protocol ? accountSASSignatureValues.protocol : \"\",\n      version,\n      \"\", // Reserved for encryption scope\n      \"\", // Account SAS requires an additional newline character\n    ].join(\"\\n\");\n  } else {\n    stringToSign = [\n      sharedKeyCredential.accountName,\n      parsedPermissions,\n      parsedServices,\n      parsedResourceTypes,\n      accountSASSignatureValues.startsOn\n        ? truncatedISO8061Date(accountSASSignatureValues.startsOn, false)\n        : \"\",\n      truncatedISO8061Date(accountSASSignatureValues.expiresOn, false),\n      accountSASSignatureValues.ipRange ? ipRangeToString(accountSASSignatureValues.ipRange) : \"\",\n      accountSASSignatureValues.protocol ? accountSASSignatureValues.protocol : \"\",\n      version,\n      \"\", // Account SAS requires an additional newline character\n    ].join(\"\\n\");\n  }\n\n  const signature: string = sharedKeyCredential.computeHMACSHA256(stringToSign);\n\n  return {\n    sasQueryParameters: new SASQueryParameters(\n      version,\n      signature,\n      parsedPermissions,\n      parsedServices,\n      parsedResourceTypes,\n      accountSASSignatureValues.protocol,\n      accountSASSignatureValues.startsOn,\n      accountSASSignatureValues.expiresOn,\n      accountSASSignatureValues.ipRange,\n    ),\n    stringToSign: stringToSign,\n  };\n}\n"]}

package/dist/esm/Clients.d.ts

@@ -4,7 +4,7 @@ import type { AbortSignalLike } from "@azure/abort-controller";
 import type { CopyFileSmbInfo, DeleteSnapshotsOptionType, DirectoryCreateResponse, DirectoryDeleteResponse, DirectoryGetPropertiesResponse, DirectoryItem, DirectoryListFilesAndDirectoriesSegmentResponse, DirectoryListHandlesResponse, DirectorySetMetadataResponse, DirectorySetPropertiesResponse, DirectoryForceCloseHandlesHeaders, FileAbortCopyResponse, FileCreateResponse, FileDeleteResponse, FileDownloadResponseModel, FileForceCloseHandlesHeaders, FileGetPropertiesResponse, FileGetRangeListHeaders, FileGetRangeListDiffResponse, FileItem, FileListHandlesResponse, FilePermissionFormat, FileSetHTTPHeadersResponse, FileSetMetadataResponse, FileStartCopyResponse, FileUploadRangeFromURLResponse, FileUploadRangeResponse, HandleItem, LeaseAccessConditions, ModeCopyMode, OwnerCopyMode, RangeModel, ShareCreatePermissionResponse, ShareCreateResponse, ShareCreateSnapshotResponse, ShareDeleteResponse, ShareGetAccessPolicyHeaders, ShareGetPermissionResponse, ShareGetPropertiesResponseModel, ShareGetStatisticsResponseModel, ShareSetAccessPolicyResponse, ShareSetMetadataResponse, ShareSetQuotaResponse, SignedIdentifierModel, SourceModifiedAccessConditions, ShareAccessTier, ShareSetPropertiesResponse, ShareRootSquash, FileRenameResponse, DirectoryRenameResponse, FileLastWrittenMode, SharePermission, FileCreateHardLinkResponse, FileCreateSymbolicLinkResponse, FileGetSymbolicLinkResponse } from "./generatedModels.js";
 import type { Pipeline } from "./Pipeline.js";
 import type { WithResponse } from "./utils/utils.common.js";
-import { Credential } from "@azure/storage-blob";
+import { Credential } from "@azure/storage-common";
 import type { CommonOptions } from "./StorageClient.js";
 import { StorageClient } from "./StorageClient.js";
 import type { PagedAsyncIterableIterator } from "@azure/core-paging";
@@ -14,6 +14,7 @@ import type { ShareSASPermissions } from "./ShareSASPermissions.js";
 import type { SASProtocol } from "./SASQueryParameters.js";
 import type { SasIPRange } from "./SasIPRange.js";
 import type { FileSASPermissions } from "./FileSASPermissions.js";
+import { Readable } from "node:stream";
 export { ShareClientOptions, ShareClientConfig } from "./models.js";
 /**
  * Options to configure the {@link ShareClient.create} operation.
@@ -266,7 +267,7 @@ export interface SignedIdentifier {
         expiresOn: Date;
         /**
          * the permissions for the acl policy
-         * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-share-acl
+         * @see https://learn.microsoft.com/rest/api/storageservices/set-share-acl
          */
         permissions: string;
     };
@@ -383,7 +384,7 @@ export interface CommonGenerateSasUrlOptions {
     /**
      * Optional. The name of the access policy on the share this SAS references if any.
      *
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/establishing-a-stored-access-policy
+     * @see https://learn.microsoft.com/rest/api/storageservices/establishing-a-stored-access-policy
      */
     identifier?: string;
     /**
@@ -475,7 +476,7 @@ export declare class ShareClient extends StorageClient {
     /**
      * Creates a new share under the specified account. If the share with
      * the same name already exists, the operation fails.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-share
+     * @see https://learn.microsoft.com/rest/api/storageservices/create-share
      *
      * @param options - Options to Share Create operation.
      * @returns Response data for the Share Create operation.
@@ -484,7 +485,7 @@ export declare class ShareClient extends StorageClient {
     /**
      * Creates a new share under the specified account. If the share with
      * the same name already exists, it is not changed.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-share
+     * @see https://learn.microsoft.com/rest/api/storageservices/create-share
      *
      * @param options -
      */
@@ -505,7 +506,7 @@ export declare class ShareClient extends StorageClient {
     get rootDirectoryClient(): ShareDirectoryClient;
     /**
      * Creates a new subdirectory under this share.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-directory
+     * @see https://learn.microsoft.com/rest/api/storageservices/create-directory
      *
      * @param directoryName -
      * @param options - Options to Directory Create operation.
@@ -518,7 +519,7 @@ export declare class ShareClient extends StorageClient {
     /**
      * Removes the specified empty sub directory under this share.
      * Note that the directory must be empty before it can be deleted.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-directory
+     * @see https://learn.microsoft.com/rest/api/storageservices/delete-directory
      *
      * @param directoryName -
      * @param options - Options to Directory Delete operation.
@@ -528,7 +529,7 @@ export declare class ShareClient extends StorageClient {
     /**
      * Creates a new file or replaces a file under the root directory of this share.
      * Note it only initializes the file with no content.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-file
+     * @see https://learn.microsoft.com/rest/api/storageservices/create-file
      *
      * @param fileName -
      * @param size - Specifies the maximum size in bytes for the file, up to 4 TB.
@@ -552,7 +553,7 @@ export declare class ShareClient extends StorageClient {
      * a share. An attempt to perform this operation on a share snapshot will fail with 400
      * (`InvalidQueryParameterValue`)
      *
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-file2
+     * @see https://learn.microsoft.com/rest/api/storageservices/delete-file2
      *
      * @param directoryName -
      * @param fileName -
@@ -573,7 +574,7 @@ export declare class ShareClient extends StorageClient {
     /**
      * Returns all user-defined metadata and system properties for the specified
      * share.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-share-properties
+     * @see https://learn.microsoft.com/rest/api/storageservices/get-share-properties
      *
      * WARNING: The `metadata` object returned in the response will have its keys in lowercase, even if
      * they originally contained uppercase characters. This differs from the metadata keys returned by
@@ -586,7 +587,7 @@ export declare class ShareClient extends StorageClient {
     /**
      * Marks the specified share for deletion. The share and any directories or files
      * contained within it are later deleted during garbage collection.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-share
+     * @see https://learn.microsoft.com/rest/api/storageservices/delete-share
      *
      * @param options - Options to Share Delete operation.
      * @returns Response data for the Share Delete operation.
@@ -595,7 +596,7 @@ export declare class ShareClient extends StorageClient {
     /**
      * Marks the specified share for deletion if it exists. The share and any directories or files
      * contained within it are later deleted during garbage collection.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-share
+     * @see https://learn.microsoft.com/rest/api/storageservices/delete-share
      *
      * @param options -
      */
@@ -605,7 +606,7 @@ export declare class ShareClient extends StorageClient {
      *
      * If no option provided, or no metadata defined in the option parameter, the share
      * metadata will be removed.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-share-metadata
+     * @see https://learn.microsoft.com/rest/api/storageservices/set-share-metadata
      *
      * @param metadata - If no metadata provided, all existing directory metadata will be removed.
      * @param option - Options to Share Set Metadata operation.
@@ -619,7 +620,7 @@ export declare class ShareClient extends StorageClient {
      * WARNING: JavaScript Date will potential lost precision when parsing start and expiry string.
      * For example, new Date("2018-12-31T03:44:23.8827891Z").toISOString() will get "2018-12-31T03:44:23.882Z".
      *
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-share-acl
+     * @see https://learn.microsoft.com/rest/api/storageservices/get-share-acl
      *
      * @param option - Options to Share Get Access Policy operation.
      * @returns Response data for the Share Get Access Policy operation.
@@ -636,7 +637,7 @@ export declare class ShareClient extends StorageClient {
      * When you establish a stored access policy on a share, it may take up to 30 seconds to take effect.
      * During this interval, a shared access signature that is associated with the stored access policy will
      * fail with status code 403 (Forbidden), until the access policy becomes active.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-share-acl
+     * @see https://learn.microsoft.com/rest/api/storageservices/set-share-acl
      *
      * @param shareAcl - Array of signed identifiers, each having a unique Id and details of access policy.
      * @param option - Options to Share Set Access Policy operation.
@@ -677,7 +678,7 @@ export declare class ShareClient extends StorageClient {
     /**
      * Creates a file permission (a security descriptor) at the share level.
      * The created security descriptor can be used for the files/directories in the share.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-permission
+     * @see https://learn.microsoft.com/rest/api/storageservices/create-permission
      *
      * @param options - Options to Share Create Permission operation.
      * @param filePermission - File permission described in the SDDL
@@ -686,7 +687,7 @@ export declare class ShareClient extends StorageClient {
     /**
      * Gets the Security Descriptor Definition Language (SDDL) for a given file permission key
      * which indicates a security descriptor.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-permission
+     * @see https://learn.microsoft.com/rest/api/storageservices/get-permission
      *
      * @param options - Options to Share Create Permission operation.
      * @param filePermissionKey - File permission key which indicates the security descriptor of the permission.
@@ -705,7 +706,7 @@ export declare class ShareClient extends StorageClient {
      * Generates a Service Shared Access Signature (SAS) URI based on the client properties
      * and parameters passed in. The SAS is signed by the shared key credential of the client.
      *
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
+     * @see https://learn.microsoft.com/rest/api/storageservices/constructing-a-service-sas
      *
      * @param options - Optional parameters.
      * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
@@ -717,7 +718,7 @@ export declare class ShareClient extends StorageClient {
      * Generates string to sign for a Service Shared Access Signature (SAS) URI based on the client properties
      * and parameters passed in. The SAS is signed by the shared key credential of the client.
      *
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
+     * @see https://learn.microsoft.com/rest/api/storageservices/constructing-a-service-sas
      *
      * @param options - Optional parameters.
      * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
@@ -982,7 +983,7 @@ export declare class ShareDirectoryClient extends StorageClient {
     constructor(url: string, pipeline: Pipeline, options?: ShareClientConfig);
     /**
      * Creates a new directory under the specified share or parent directory.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-directory
+     * @see https://learn.microsoft.com/rest/api/storageservices/create-directory
      *
      * @param options - Options to Directory Create operation.
      * @returns Response data for the Directory  operation.
@@ -991,14 +992,14 @@ export declare class ShareDirectoryClient extends StorageClient {
     /**
      * Creates a new directory under the specified share or parent directory if it does not already exists.
      * If the directory already exists, it is not modified.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-directory
+     * @see https://learn.microsoft.com/rest/api/storageservices/create-directory
      *
      * @param options -
      */
     createIfNotExists(options?: DirectoryCreateOptions): Promise<DirectoryCreateIfNotExistsResponse>;
     /**
      * Sets properties on the directory.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-directory-properties
+     * @see https://learn.microsoft.com/rest/api/storageservices/set-directory-properties
      *
      * @param DirectoryProperties - Directory properties. If no values are provided,
      *                                            existing values will be preserved.
@@ -1034,7 +1035,7 @@ export declare class ShareDirectoryClient extends StorageClient {
     getDirectoryClient(subDirectoryName: string): ShareDirectoryClient;
     /**
      * Creates a new subdirectory under this directory.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-directory
+     * @see https://learn.microsoft.com/rest/api/storageservices/create-directory
      *
      * @param directoryName -
      * @param options - Options to Directory Create operation.
@@ -1047,7 +1048,7 @@ export declare class ShareDirectoryClient extends StorageClient {
     /**
      * Removes the specified empty sub directory under this directory.
      * Note that the directory must be empty before it can be deleted.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-directory
+     * @see https://learn.microsoft.com/rest/api/storageservices/delete-directory
      *
      * @param directoryName -
      * @param options - Options to Directory Delete operation.
@@ -1056,7 +1057,7 @@ export declare class ShareDirectoryClient extends StorageClient {
     deleteSubdirectory(directoryName: string, options?: DirectoryDeleteOptions): Promise<DirectoryDeleteResponse>;
     /**
      * Creates a new file or replaces a file under this directory. Note it only initializes the file with no content.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-file
+     * @see https://learn.microsoft.com/rest/api/storageservices/create-file
      *
      * @param fileName -
      * @param size - Specifies the maximum size in bytes for the file, up to 4 TB.
@@ -1079,7 +1080,7 @@ export declare class ShareDirectoryClient extends StorageClient {
      * Delete File is not supported on a share snapshot, which is a read-only copy of
      * a share. An attempt to perform this operation on a share snapshot will fail with 400 (InvalidQueryParameterValue)
      *
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-file2
+     * @see https://learn.microsoft.com/rest/api/storageservices/delete-file2
      *
      * @param fileName - Name of the file to delete
      * @param options - Options to File Delete operation.
@@ -1136,7 +1137,7 @@ export declare class ShareDirectoryClient extends StorageClient {
      * Returns all system properties for the specified directory, and can also be used to check the
      * existence of a directory. The data returned does not include the files in the directory or any
      * subdirectories.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-directory-properties
+     * @see https://learn.microsoft.com/rest/api/storageservices/get-directory-properties
      *
      * @param options - Options to Directory Get Properties operation.
      * @returns Response data for the Directory Get Properties operation.
@@ -1145,7 +1146,7 @@ export declare class ShareDirectoryClient extends StorageClient {
     /**
      * Removes the specified empty directory. Note that the directory must be empty before it can be
      * deleted.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-directory
+     * @see https://learn.microsoft.com/rest/api/storageservices/delete-directory
      *
      * @param options - Options to Directory Delete operation.
      * @returns Response data for the Directory Delete operation.
@@ -1154,14 +1155,14 @@ export declare class ShareDirectoryClient extends StorageClient {
     /**
      * Removes the specified empty directory if it exists. Note that the directory must be empty before it can be
      * deleted.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-directory
+     * @see https://learn.microsoft.com/rest/api/storageservices/delete-directory
      *
      * @param options -
      */
     deleteIfExists(options?: DirectoryDeleteOptions): Promise<DirectoryDeleteIfExistsResponse>;
     /**
      * Updates user defined metadata for the specified directory.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-directory-metadata
+     * @see https://learn.microsoft.com/rest/api/storageservices/set-directory-metadata
      *
      * @param metadata - If no metadata provided, all existing directory metadata will be removed
      * @param options - Options to Directory Set Metadata operation.
@@ -1344,7 +1345,7 @@ export declare class ShareDirectoryClient extends StorageClient {
     /**
      * Returns a list of files or directories under the specified share or directory. It lists the
      * contents only for a single level of the directory hierarchy.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/list-directories-and-files
+     * @see https://learn.microsoft.com/rest/api/storageservices/list-directories-and-files
      *
      * @param marker - A string value that identifies the portion of the list to be returned with the next list operation.
      * @param options - Options to Directory List Files and Directories Segment operation.
@@ -1494,7 +1495,7 @@ export declare class ShareDirectoryClient extends StorageClient {
     listHandles(options?: DirectoryListHandlesOptions): PagedAsyncIterableIterator<HandleItem, DirectoryListHandlesResponse>;
     /**
      * Lists handles for a directory.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/list-handles
+     * @see https://learn.microsoft.com/rest/api/storageservices/list-handles
      *
      * @param marker - Optional. A string value that identifies the portion of the list to be
      *                          returned with the next list handles operation. The operation returns a
@@ -1506,7 +1507,7 @@ export declare class ShareDirectoryClient extends StorageClient {
     private listHandlesSegment;
     /**
      * Force close all handles for a directory.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/force-close-handles
+     * @see https://learn.microsoft.com/rest/api/storageservices/force-close-handles
      *
      * @param marker - Optional. A string value that identifies the position of handles that will
      *                          be closed with the next force close handles operation.
@@ -1518,14 +1519,14 @@ export declare class ShareDirectoryClient extends StorageClient {
     private forceCloseHandlesSegment;
     /**
      * Force close all handles for a directory.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/force-close-handles
+     * @see https://learn.microsoft.com/rest/api/storageservices/force-close-handles
      *
      * @param options -
      */
     forceCloseAllHandles(options?: DirectoryForceCloseHandlesSegmentOptions): Promise<CloseHandlesInfo>;
     /**
      * Force close a specific handle for a directory.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/force-close-handles
+     * @see https://learn.microsoft.com/rest/api/storageservices/force-close-handles
      *
      * @param aborter - Create a new Aborter instance with Aborter.none or Aborter.timeout(),
      *                          goto documents of Aborter for more examples about request cancellation
@@ -1708,7 +1709,7 @@ export interface FileUploadRangeFromURLOptions extends CommonOptions {
     abortSignal?: AbortSignalLike;
     /**
      * The timeout parameter is expressed in seconds. For more information, see <a
-     * href="https://learn.microsoft.com/en-us/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations?redirectedfrom=MSDN">Setting
+     * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations?redirectedfrom=MSDN">Setting
      * Timeouts for File Service Operations.</a>
      */
     timeoutInSeconds?: number;
@@ -2232,7 +2233,7 @@ export interface FileRenameOptions extends CommonOptions {
     metadata?: Metadata;
     /**
      * Optional.
-     * The timeout parameter is expressed in seconds. For more information, see <a href="https://learn.microsoft.com/en-us/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations?redirectedfrom=MSDN">Setting Timeouts for File Service Operations.</a>
+     * The timeout parameter is expressed in seconds. For more information, see <a href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations?redirectedfrom=MSDN">Setting Timeouts for File Service Operations.</a>
      */
     timeoutInSeconds?: number;
     /**
@@ -2291,7 +2292,7 @@ export interface DirectoryRenameOptions extends CommonOptions {
     copyFileSmbInfo?: CopyFileSmbInfo;
     /**
      * Optional.
-     * The timeout parameter is expressed in seconds. For more information, see <a href="https://learn.microsoft.com/en-us/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations?redirectedfrom=MSDN">Setting Timeouts for File Service Operations.</a>
+     * The timeout parameter is expressed in seconds. For more information, see <a href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations?redirectedfrom=MSDN">Setting Timeouts for File Service Operations.</a>
      */
     timeoutInSeconds?: number;
     /**
@@ -2391,7 +2392,7 @@ export declare class ShareFileClient extends StorageClient {
     withShareSnapshot(shareSnapshot: string): ShareFileClient;
     /**
      * Creates a new file or replaces a file. Note it only initializes the file with no content.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-file
+     * @see https://learn.microsoft.com/rest/api/storageservices/create-file
      *
      * @param size - Specifies the maximum size in bytes for the file, up to 4 TB.
      * @param options - Options to File Create operation.
@@ -2433,7 +2434,7 @@ export declare class ShareFileClient extends StorageClient {
      * * In Node.js, data returns in a Readable stream `readableStreamBody`
      * * In browsers, data returns in a promise `contentAsBlob`
      *
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-file
+     * @see https://learn.microsoft.com/rest/api/storageservices/get-file
      *
      * @param offset - From which position of the file to download, greater than or equal to 0
      * @param count - How much data to be downloaded, greater than 0. Will download to the end when undefined
@@ -2521,7 +2522,7 @@ export declare class ShareFileClient extends StorageClient {
     /**
      * Returns all user-defined metadata, standard HTTP properties, and system properties
      * for the file. It does not return the content of the file.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-file-properties
+     * @see https://learn.microsoft.com/rest/api/storageservices/get-file-properties
      *
      * @param options - Options to File Get Properties operation.
      * @returns Response data for the File Get Properties operation.
@@ -2529,7 +2530,7 @@ export declare class ShareFileClient extends StorageClient {
     getProperties(options?: FileGetPropertiesOptions): Promise<FileGetPropertiesResponse>;
     /**
      * Sets properties on the file.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-file-properties
+     * @see https://learn.microsoft.com/rest/api/storageservices/set-file-properties
      *
      * @param properties - File properties. For file HTTP headers(e.g. Content-Type),
      *                                       if no values are provided, existing HTTP headers will be removed.
@@ -2549,7 +2550,7 @@ export declare class ShareFileClient extends StorageClient {
      * Delete File is not supported on a share snapshot, which is a read-only copy of
      * a share. An attempt to perform this operation on a share snapshot will fail with 400 (InvalidQueryParameterValue)
      *
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-file2
+     * @see https://learn.microsoft.com/rest/api/storageservices/delete-file2
      *
      * @param options - Options to File Delete operation.
      * @returns Response data for the File Delete operation.
@@ -2567,7 +2568,7 @@ export declare class ShareFileClient extends StorageClient {
      * Delete File is not supported on a share snapshot, which is a read-only copy of
      * a share. An attempt to perform this operation on a share snapshot will fail with 400 (InvalidQueryParameterValue)
      *
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-file2
+     * @see https://learn.microsoft.com/rest/api/storageservices/delete-file2
      *
      * @param options -
      */
@@ -2577,7 +2578,7 @@ export declare class ShareFileClient extends StorageClient {
      *
      * If no option provided, or no value provided for the file HTTP headers in the options,
      * these file HTTP headers without a value will be cleared.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-file-properties
+     * @see https://learn.microsoft.com/rest/api/storageservices/set-file-properties
      *
      * @param FileHttpHeaders - File HTTP headers like Content-Type.
      *                                             Provide undefined will remove existing HTTP headers.
@@ -2588,7 +2589,7 @@ export declare class ShareFileClient extends StorageClient {
     /**
      * Resize file.
      *
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-file-properties
+     * @see https://learn.microsoft.com/rest/api/storageservices/set-file-properties
      *
      * @param length - Resizes a file to the specified size in bytes.
      *                        If the specified byte value is less than the current size of the file,
@@ -2602,7 +2603,7 @@ export declare class ShareFileClient extends StorageClient {
      *
      * If no metadata defined in the option parameter, the file
      * metadata will be removed.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-file-metadata
+     * @see https://learn.microsoft.com/rest/api/storageservices/set-file-metadata
      *
      * @param metadata - If no metadata provided, all existing directory metadata will be removed
      * @param options - Options to File Set Metadata operation.
@@ -2701,7 +2702,7 @@ export declare class ShareFileClient extends StorageClient {
     /**
      * Aborts a pending Copy File operation, and leaves a destination file with zero length and full
      * metadata.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/abort-copy-file
+     * @see https://learn.microsoft.com/rest/api/storageservices/abort-copy-file
      *
      * @param copyId - Id of the Copy File operation to abort.
      * @param options - Options to File Abort Copy From URL operation.
@@ -2809,7 +2810,7 @@ export declare class ShareFileClient extends StorageClient {
      *                            with max uploading concurrency
      * @param options -
      */
-    uploadStream(stream: NodeJS.ReadableStream, size: number, bufferSize: number, maxBuffers: number, options?: FileUploadStreamOptions): Promise<void>;
+    uploadStream(stream: Readable, size: number, bufferSize: number, maxBuffers: number, options?: FileUploadStreamOptions): Promise<void>;
     /**
      * ONLY AVAILABLE IN NODE.JS RUNTIME.
      *
@@ -2829,7 +2830,7 @@ export declare class ShareFileClient extends StorageClient {
     downloadToFile(filePath: string, offset?: number, count?: number, options?: FileDownloadOptions): Promise<FileDownloadResponseModel>;
     /**
      * Lists handles for a file.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/list-handles
+     * @see https://learn.microsoft.com/rest/api/storageservices/list-handles
      *
      * @param marker - Optional. A string value that identifies the portion of the list to be
      *                          returned with the next list handles operation. The operation returns a
@@ -2869,7 +2870,7 @@ export declare class ShareFileClient extends StorageClient {
     listHandles(options?: FileListHandlesOptions): PagedAsyncIterableIterator<HandleItem, FileListHandlesResponse>;
     /**
      * Force close all handles for a file.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/force-close-handles
+     * @see https://learn.microsoft.com/rest/api/storageservices/force-close-handles
      *
      * @param marker - Optional. A string value that identifies the position of handles that will
      *                          be closed with the next force close handles operation.
@@ -2881,14 +2882,14 @@ export declare class ShareFileClient extends StorageClient {
     private forceCloseHandlesSegment;
     /**
      * Force close all handles for a file.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/force-close-handles
+     * @see https://learn.microsoft.com/rest/api/storageservices/force-close-handles
      *
      * @param options - Options to force close handles operation.
      */
     forceCloseAllHandles(options?: FileForceCloseHandlesOptions): Promise<CloseHandlesInfo>;
     /**
      * Force close a specific handle for a file.
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/force-close-handles
+     * @see https://learn.microsoft.com/rest/api/storageservices/force-close-handles
      *
      * @param handleId - Specific handle ID, cannot be asterisk "*".
      *                          Use forceCloseAllHandles() to close all handles.
@@ -2928,7 +2929,7 @@ export declare class ShareFileClient extends StorageClient {
      * Generates a Service Shared Access Signature (SAS) URI based on the client properties
      * and parameters passed in. The SAS is signed by the shared key credential of the client.
      *
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
+     * @see https://learn.microsoft.com/rest/api/storageservices/constructing-a-service-sas
      *
      * @param options - Optional parameters.
      * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
@@ -2940,7 +2941,7 @@ export declare class ShareFileClient extends StorageClient {
      * Generates string to sign for a Service Shared Access Signature (SAS) URI based on the client properties
      * and parameters passed in. The SAS is signed by the shared key credential of the client.
      *
-     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
+     * @see https://learn.microsoft.com/rest/api/storageservices/constructing-a-service-sas
      *
      * @param options - Optional parameters.
      * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.