@azure/data-tables 13.3.1-alpha.20241125.1 → 13.3.1-alpha.20241127.2

package/dist/commonjs/sas/sasQueryParameters.js

@@ -0,0 +1,197 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SasQueryParameters = void 0;
+const sasIPRange_js_1 = require("./sasIPRange.js");
+const truncateISO8061Date_js_1 = require("../utils/truncateISO8061Date.js");
+/**
+ * Represents the components that make up an Azure SAS' query parameters. This type is not constructed directly
+ * by the user; it is only generated by the {@link AccountSasSignatureValues} and {@link TableSasSignatureValues}
+ * types. Once generated, it can be encoded into a `string` and appended to a URL directly (though caution should
+ * be taken here in case there are existing query parameters, which might affect the appropriate means of appending
+ * these query parameters).
+ *
+ * NOTE: Instances of this class are immutable.
+ */
+class SasQueryParameters {
+    /**
+     * Optional. IP range allowed for this SAS.
+     *
+     * @readonly
+     */
+    get ipRange() {
+        if (this.ipRangeInner) {
+            return {
+                end: this.ipRangeInner.end,
+                start: this.ipRangeInner.start,
+            };
+        }
+        return undefined;
+    }
+    /**
+     * Creates an instance of SASQueryParameters.
+     *
+     * @param version - Representing the table service version
+     * @param signature - Representing the signature for the SAS token
+     * @param options - Optional. Options to construct the SASQueryParameters.
+     */
+    constructor(version, signature, options = {}) {
+        this.version = version;
+        this.signature = signature;
+        this.permissions = options.permissions;
+        this.services = options.services;
+        this.resourceTypes = options.resourceTypes;
+        this.protocol = options.protocol;
+        this.startsOn = options.startsOn;
+        this.expiresOn = options.expiresOn;
+        this.ipRangeInner = options.ipRange;
+        this.identifier = options.identifier;
+        this.tableName = options.tableName;
+        this.endPartitionKey = options.endPartitionKey;
+        this.endRowKey = options.endRowKey;
+        this.startPartitionKey = options.startPartitionKey;
+        this.startRowKey = options.startRowKey;
+        if (options.userDelegationKey) {
+            this.signedOid = options.userDelegationKey.signedObjectId;
+            this.signedTenantId = options.userDelegationKey.signedTenantId;
+            this.signedStartsOn = options.userDelegationKey.signedStartsOn;
+            this.signedExpiresOn = options.userDelegationKey.signedExpiresOn;
+            this.signedService = options.userDelegationKey.signedService;
+            this.signedVersion = options.userDelegationKey.signedVersion;
+            this.preauthorizedAgentObjectId = options.preauthorizedAgentObjectId;
+            this.correlationId = options.correlationId;
+        }
+    }
+    /**
+     * Encodes all SAS query parameters into a string that can be appended to a URL.
+     *
+     */
+    toString() {
+        const params = [
+            "sv", // SignedVersion
+            "ss", // SignedServices
+            "srt", // SignedResourceTypes
+            "spr", // SignedProtocol
+            "st", // SignedStart
+            "se", // SignedExpiry
+            "sip", // SignedIP
+            "si", // SignedIdentifier
+            "skoid", // Signed object ID
+            "sktid", // Signed tenant ID
+            "skt", // Signed key start time
+            "ske", // Signed key expiry time
+            "sks", // Signed key service
+            "skv", // Signed key version
+            "sr", // signedResource
+            "sp", // SignedPermission
+            "sig", // Signature
+            "rscc", // Cache-Control
+            "rscd", // Content-Disposition
+            "rsce", // Content-Encoding
+            "rscl", // Content-Language
+            "rsct", // Content-Type
+            "saoid", // signedAuthorizedObjectId
+            "scid", // signedCorrelationId
+            "tn", // TableName,
+            "srk", // StartRowKey
+            "spk", // StartPartitionKey
+            "epk", // EndPartitionKey
+            "erk", // EndRowKey
+        ];
+        const queries = [];
+        for (const param of params) {
+            switch (param) {
+                case "sv":
+                    this.tryAppendQueryParameter(queries, param, this.version);
+                    break;
+                case "ss":
+                    this.tryAppendQueryParameter(queries, param, this.services);
+                    break;
+                case "srt":
+                    this.tryAppendQueryParameter(queries, param, this.resourceTypes);
+                    break;
+                case "spr":
+                    this.tryAppendQueryParameter(queries, param, this.protocol);
+                    break;
+                case "st":
+                    this.tryAppendQueryParameter(queries, param, this.startsOn ? (0, truncateISO8061Date_js_1.truncatedISO8061Date)(this.startsOn, false) : undefined);
+                    break;
+                case "se":
+                    this.tryAppendQueryParameter(queries, param, this.expiresOn ? (0, truncateISO8061Date_js_1.truncatedISO8061Date)(this.expiresOn, false) : undefined);
+                    break;
+                case "sip":
+                    this.tryAppendQueryParameter(queries, param, this.ipRange ? (0, sasIPRange_js_1.ipRangeToString)(this.ipRange) : undefined);
+                    break;
+                case "si":
+                    this.tryAppendQueryParameter(queries, param, this.identifier);
+                    break;
+                case "skoid": // Signed object ID
+                    this.tryAppendQueryParameter(queries, param, this.signedOid);
+                    break;
+                case "sktid": // Signed tenant ID
+                    this.tryAppendQueryParameter(queries, param, this.signedTenantId);
+                    break;
+                case "skt": // Signed key start time
+                    this.tryAppendQueryParameter(queries, param, this.signedStartsOn ? (0, truncateISO8061Date_js_1.truncatedISO8061Date)(this.signedStartsOn, false) : undefined);
+                    break;
+                case "ske": // Signed key expiry time
+                    this.tryAppendQueryParameter(queries, param, this.signedExpiresOn ? (0, truncateISO8061Date_js_1.truncatedISO8061Date)(this.signedExpiresOn, false) : undefined);
+                    break;
+                case "sks": // Signed key service
+                    this.tryAppendQueryParameter(queries, param, this.signedService);
+                    break;
+                case "skv": // Signed key version
+                    this.tryAppendQueryParameter(queries, param, this.signedVersion);
+                    break;
+                case "sp":
+                    this.tryAppendQueryParameter(queries, param, this.permissions);
+                    break;
+                case "sig":
+                    this.tryAppendQueryParameter(queries, param, this.signature);
+                    break;
+                case "saoid":
+                    this.tryAppendQueryParameter(queries, param, this.preauthorizedAgentObjectId);
+                    break;
+                case "scid":
+                    this.tryAppendQueryParameter(queries, param, this.correlationId);
+                    break;
+                case "tn":
+                    this.tryAppendQueryParameter(queries, param, this.tableName);
+                    break;
+                case "spk":
+                    this.tryAppendQueryParameter(queries, param, this.startPartitionKey);
+                    break;
+                case "srk":
+                    this.tryAppendQueryParameter(queries, param, this.startRowKey);
+                    break;
+                case "epk":
+                    this.tryAppendQueryParameter(queries, param, this.endPartitionKey);
+                    break;
+                case "erk":
+                    this.tryAppendQueryParameter(queries, param, this.endRowKey);
+                    break;
+            }
+        }
+        return queries.join("&");
+    }
+    /**
+     * A private helper method used to filter and append query key/value pairs into an array.
+     *
+     * @param queries -
+     * @param key -
+     * @param value -
+     */
+    tryAppendQueryParameter(queries, key, value) {
+        if (!value) {
+            return;
+        }
+        key = encodeURIComponent(key);
+        value = encodeURIComponent(value);
+        if (key.length > 0 && value.length > 0) {
+            queries.push(`${key}=${value}`);
+        }
+    }
+}
+exports.SasQueryParameters = SasQueryParameters;
+//# sourceMappingURL=sasQueryParameters.js.map

package/dist/commonjs/sas/sasQueryParameters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sasQueryParameters.js","sourceRoot":"","sources":["../../../src/sas/sasQueryParameters.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { SasIPRange } from \"./sasIPRange.js\";\nimport { ipRangeToString } from \"./sasIPRange.js\";\nimport type { UserDelegationKey } from \"./models.js\";\nimport { truncatedISO8061Date } from \"../utils/truncateISO8061Date.js\";\n\n/**\n * Protocols for generated SAS.\n */\nexport type SasProtocol = \"https\" | \"https,http\";\n\n/**\n * Represents the components that make up an Azure SAS' query parameters. This type is not constructed directly\n * by the user; it is only generated by the {@link AccountSasSignatureValues} and {@link TableSasSignatureValues}\n * types. Once generated, it can be encoded into a `string` and appended to a URL directly (though caution should\n * be taken here in case there are existing query parameters, which might affect the appropriate means of appending\n * these query parameters).\n *\n * NOTE: Instances of this class are immutable.\n */\nexport class SasQueryParameters {\n  /**\n   * The Tables API version.\n   */\n  public readonly version: string;\n\n  /**\n   * Optional. Table name to generate the SAS for\n   */\n  public readonly tableName?: string;\n\n  /**\n   * Optional. The allowed HTTP protocol(s).\n   */\n  public readonly protocol?: SasProtocol;\n\n  /**\n   * Optional. The start time for this SAS token.\n   */\n  public readonly startsOn?: Date;\n\n  /**\n   * Optional only when identifier is provided. The expiry time for this SAS token.\n   */\n  public readonly expiresOn?: Date;\n\n  /**\n   * Optional only when identifier is provided.\n   * Please refer to {@link AccountSasPermissions}, or {@link TableSasPermissions} for\n   * more details.\n   */\n  public readonly permissions?: string;\n\n  /**\n   * Optional. The table services being accessed (only for Account SAS). Please refer to {@link AccountSasServices}\n   * for more details.\n   */\n  public readonly services?: string;\n\n  /**\n   * Optional. The table resource types being accessed (only for Account SAS). Please refer to\n   * {@link AccountSasResourceTypes} for more details.\n   */\n  public readonly resourceTypes?: string;\n\n  /**\n   * Optional. The signed identifier (only for {@link TableSasSignatureValues}).\n   *\n   * @see https://docs.microsoft.com/en-us/rest/api/storageservices/establishing-a-stored-access-policy\n   */\n  public readonly identifier?: string;\n\n  /**\n   * The signature for the SAS token.\n   */\n  public readonly signature: string;\n\n  /**\n   * Inner value of getter ipRange.\n   */\n  private readonly ipRangeInner?: SasIPRange;\n\n  /**\n   * The Azure Active Directory object ID in GUID format.\n   * Property of user delegation key.\n   */\n  private readonly signedOid?: string;\n\n  /**\n   * The Azure Active Directory tenant ID in GUID format.\n   * Property of user delegation key.\n   */\n  private readonly signedTenantId?: string;\n\n  /**\n   * The date-time the key is active.\n   * Property of user delegation key.\n   */\n  private readonly signedStartsOn?: Date;\n\n  /**\n   * The date-time the key expires.\n   * Property of user delegation key.\n   */\n  private readonly signedExpiresOn?: Date;\n\n  /**\n   * Abbreviation of the Azure Table service that accepts the user delegation key.\n   * Property of user delegation key.\n   */\n  private readonly signedService?: string;\n\n  /**\n   * The service version that created the user delegation key.\n   * Property of user delegation key.\n   */\n  private readonly signedVersion?: string;\n\n  /**\n   * Authorized AAD Object ID in GUID format. The AAD Object ID of a user authorized by the owner of the User Delegation Key\n   * to perform the action granted by the SAS. The Azure Table service will ensure that the owner of the user delegation key\n   * has the required permissions before granting access but no additional permission check for the user specified in\n   * this value will be performed. This is only used for User Delegation SAS.\n   */\n  public readonly preauthorizedAgentObjectId?: string;\n\n  /**\n   * A GUID value that will be logged in the table diagnostic logs and can be used to correlate SAS generation with table resource access.\n   * This is only used for User Delegation SAS.\n   */\n  public readonly correlationId?: string;\n\n  /**\n   * Optional, but startPartitionKey must accompany startRowKey. The minimum partition and row keys that are accessible with this shared access signature.\n   * Key values are inclusive. If they're omitted, there's no lower bound on the table entities that can be accessed.\n   */\n  public readonly startPartitionKey?: string;\n\n  /**\n   * Optional, but startPartitionKey must accompany startRowKey. The minimum partition and row keys that are accessible with this shared access signature.\n   * Key values are inclusive. If they're omitted, there's no lower bound on the table entities that can be accessed.\n   */\n  public readonly startRowKey?: string;\n\n  /**\n   * Optional, but endPartitionKey must accompany endRowKey. The maximum partition and row keys that are accessible with this shared access signature.\n   * Key values are inclusive. If they're omitted, there's no upper bound on the table entities that can be accessed.\n   */\n  public readonly endPartitionKey?: string;\n\n  /**\n   * Optional, but endPartitionKey must accompany endRowKey. The maximum partition and row keys that are accessible with this shared access signature.\n   * Key values are inclusive. If they're omitted, there's no upper bound on the table entities that can be accessed.\n   */\n  public readonly endRowKey?: string;\n\n  /**\n   * Optional. IP range allowed for this SAS.\n   *\n   * @readonly\n   */\n  public get ipRange(): SasIPRange | undefined {\n    if (this.ipRangeInner) {\n      return {\n        end: this.ipRangeInner.end,\n        start: this.ipRangeInner.start,\n      };\n    }\n    return undefined;\n  }\n\n  /**\n   * Creates an instance of SASQueryParameters.\n   *\n   * @param version - Representing the table service version\n   * @param signature - Representing the signature for the SAS token\n   * @param options - Optional. Options to construct the SASQueryParameters.\n   */\n  constructor(version: string, signature: string, options: SasQueryParametersOptions = {}) {\n    this.version = version;\n    this.signature = signature;\n\n    this.permissions = options.permissions;\n    this.services = options.services;\n    this.resourceTypes = options.resourceTypes;\n    this.protocol = options.protocol;\n    this.startsOn = options.startsOn;\n    this.expiresOn = options.expiresOn;\n    this.ipRangeInner = options.ipRange;\n    this.identifier = options.identifier;\n    this.tableName = options.tableName;\n    this.endPartitionKey = options.endPartitionKey;\n    this.endRowKey = options.endRowKey;\n    this.startPartitionKey = options.startPartitionKey;\n    this.startRowKey = options.startRowKey;\n\n    if (options.userDelegationKey) {\n      this.signedOid = options.userDelegationKey.signedObjectId;\n      this.signedTenantId = options.userDelegationKey.signedTenantId;\n      this.signedStartsOn = options.userDelegationKey.signedStartsOn;\n      this.signedExpiresOn = options.userDelegationKey.signedExpiresOn;\n      this.signedService = options.userDelegationKey.signedService;\n      this.signedVersion = options.userDelegationKey.signedVersion;\n\n      this.preauthorizedAgentObjectId = options.preauthorizedAgentObjectId;\n      this.correlationId = options.correlationId;\n    }\n  }\n\n  /**\n   * Encodes all SAS query parameters into a string that can be appended to a URL.\n   *\n   */\n  public toString(): string {\n    const params: string[] = [\n      \"sv\", // SignedVersion\n      \"ss\", // SignedServices\n      \"srt\", // SignedResourceTypes\n      \"spr\", // SignedProtocol\n      \"st\", // SignedStart\n      \"se\", // SignedExpiry\n      \"sip\", // SignedIP\n      \"si\", // SignedIdentifier\n      \"skoid\", // Signed object ID\n      \"sktid\", // Signed tenant ID\n      \"skt\", // Signed key start time\n      \"ske\", // Signed key expiry time\n      \"sks\", // Signed key service\n      \"skv\", // Signed key version\n      \"sr\", // signedResource\n      \"sp\", // SignedPermission\n      \"sig\", // Signature\n      \"rscc\", // Cache-Control\n      \"rscd\", // Content-Disposition\n      \"rsce\", // Content-Encoding\n      \"rscl\", // Content-Language\n      \"rsct\", // Content-Type\n      \"saoid\", // signedAuthorizedObjectId\n      \"scid\", // signedCorrelationId\n      \"tn\", // TableName,\n      \"srk\", // StartRowKey\n      \"spk\", // StartPartitionKey\n      \"epk\", // EndPartitionKey\n      \"erk\", // EndRowKey\n    ];\n    const queries: string[] = [];\n\n    for (const param of params) {\n      switch (param) {\n        case \"sv\":\n          this.tryAppendQueryParameter(queries, param, this.version);\n          break;\n        case \"ss\":\n          this.tryAppendQueryParameter(queries, param, this.services);\n          break;\n        case \"srt\":\n          this.tryAppendQueryParameter(queries, param, this.resourceTypes);\n          break;\n        case \"spr\":\n          this.tryAppendQueryParameter(queries, param, this.protocol);\n          break;\n        case \"st\":\n          this.tryAppendQueryParameter(\n            queries,\n            param,\n            this.startsOn ? truncatedISO8061Date(this.startsOn, false) : undefined,\n          );\n          break;\n        case \"se\":\n          this.tryAppendQueryParameter(\n            queries,\n            param,\n            this.expiresOn ? truncatedISO8061Date(this.expiresOn, false) : undefined,\n          );\n          break;\n        case \"sip\":\n          this.tryAppendQueryParameter(\n            queries,\n            param,\n            this.ipRange ? ipRangeToString(this.ipRange) : undefined,\n          );\n          break;\n        case \"si\":\n          this.tryAppendQueryParameter(queries, param, this.identifier);\n          break;\n        case \"skoid\": // Signed object ID\n          this.tryAppendQueryParameter(queries, param, this.signedOid);\n          break;\n        case \"sktid\": // Signed tenant ID\n          this.tryAppendQueryParameter(queries, param, this.signedTenantId);\n          break;\n        case \"skt\": // Signed key start time\n          this.tryAppendQueryParameter(\n            queries,\n            param,\n            this.signedStartsOn ? truncatedISO8061Date(this.signedStartsOn, false) : undefined,\n          );\n          break;\n        case \"ske\": // Signed key expiry time\n          this.tryAppendQueryParameter(\n            queries,\n            param,\n            this.signedExpiresOn ? truncatedISO8061Date(this.signedExpiresOn, false) : undefined,\n          );\n          break;\n        case \"sks\": // Signed key service\n          this.tryAppendQueryParameter(queries, param, this.signedService);\n          break;\n        case \"skv\": // Signed key version\n          this.tryAppendQueryParameter(queries, param, this.signedVersion);\n          break;\n        case \"sp\":\n          this.tryAppendQueryParameter(queries, param, this.permissions);\n          break;\n        case \"sig\":\n          this.tryAppendQueryParameter(queries, param, this.signature);\n          break;\n        case \"saoid\":\n          this.tryAppendQueryParameter(queries, param, this.preauthorizedAgentObjectId);\n          break;\n        case \"scid\":\n          this.tryAppendQueryParameter(queries, param, this.correlationId);\n          break;\n        case \"tn\":\n          this.tryAppendQueryParameter(queries, param, this.tableName);\n          break;\n        case \"spk\":\n          this.tryAppendQueryParameter(queries, param, this.startPartitionKey);\n          break;\n        case \"srk\":\n          this.tryAppendQueryParameter(queries, param, this.startRowKey);\n          break;\n        case \"epk\":\n          this.tryAppendQueryParameter(queries, param, this.endPartitionKey);\n          break;\n        case \"erk\":\n          this.tryAppendQueryParameter(queries, param, this.endRowKey);\n          break;\n      }\n    }\n    return queries.join(\"&\");\n  }\n\n  /**\n   * A private helper method used to filter and append query key/value pairs into an array.\n   *\n   * @param queries -\n   * @param key -\n   * @param value -\n   */\n  private tryAppendQueryParameter(queries: string[], key: string, value?: string): void {\n    if (!value) {\n      return;\n    }\n\n    key = encodeURIComponent(key);\n    value = encodeURIComponent(value);\n    if (key.length > 0 && value.length > 0) {\n      queries.push(`${key}=${value}`);\n    }\n  }\n}\n\n/**\n * Options to construct {@link SasQueryParameters}.\n */\nexport interface SasQueryParametersOptions {\n  /**\n   * Optional only when identifier is provided.\n   * Please refer to {@link AccountSasPermissions}, or {@link TableSasPermissions} for\n   * more details.\n   */\n  permissions?: string;\n  /**\n   * Optional. Table name to generate the SAS for\n   */\n  tableName?: string;\n  /**\n   * Optional. The storage services being accessed (only for Account SAS). Please refer to {@link AccountSasServices}\n   * for more details.\n   */\n  services?: string;\n  /**\n   * Optional. The storage resource types being accessed (only for Account SAS). Please refer to\n   * {@link AccountSasResourceTypes} for more details.\n   */\n  resourceTypes?: string;\n  /**\n   * Optional. The allowed HTTP protocol(s).\n   */\n  protocol?: SasProtocol;\n  /**\n   * Optional. The start time for this SAS token.\n   */\n  startsOn?: Date;\n  /**\n   * Optional only when identifier is provided. The expiry time for this SAS token.\n   */\n  expiresOn?: Date;\n  /**\n   * Optional. IP ranges allowed in this SAS.\n   */\n  ipRange?: SasIPRange;\n  /**\n   * Optional. The signed identifier for access policy\n   *\n   * @see https://docs.microsoft.com/rest/api/storageservices/establishing-a-stored-access-policy\n   */\n  identifier?: string;\n  /**\n   * Optional. Specifies which resources are accessible via the SAS (only for {@link AccountSasSignatureValues}).\n   * @see https://docs.microsoft.com/rest/api/storageservices/create-service-sas#specifying-the-signed-resource-blob-service-only\n   */\n  resource?: string;\n  /**\n   * User delegation key properties.\n   */\n  userDelegationKey?: UserDelegationKey;\n  /**\n   * Authorized AAD Object ID in GUID format. The AAD Object ID of a user authorized by the owner of the User Delegation Key\n   * to perform the action granted by the SAS. The Azure Table service will ensure that the owner of the user delegation key\n   * has the required permissions before granting access but no additional permission check for the user specified in\n   * this value will be performed. This cannot be used in conjuction with {@link signedUnauthorizedUserObjectId}.\n   * This is only used for User Delegation SAS.\n   */\n  preauthorizedAgentObjectId?: string;\n  /**\n   * A GUID value that will be logged in the storage diagnostic logs and can be used to correlate SAS generation with storage resource access.\n   * This is only used for User Delegation SAS.\n   */\n  correlationId?: string;\n\n  /**\n   * Optional, but startPartitionKey must accompany startRowKey. The minimum partition and row keys that are accessible with this shared access signature.\n   * Key values are inclusive. If they're omitted, there's no lower bound on the table entities that can be accessed.\n   */\n  startPartitionKey?: string;\n\n  /**\n   * Optional, but startPartitionKey must accompany startRowKey. The minimum partition and row keys that are accessible with this shared access signature.\n   * Key values are inclusive. If they're omitted, there's no lower bound on the table entities that can be accessed.\n   */\n  startRowKey?: string;\n\n  /**\n   * Optional, but endPartitionKey must accompany endRowKey. The maximum partition and row keys that are accessible with this shared access signature.\n   * Key values are inclusive. If they're omitted, there's no upper bound on the table entities that can be accessed.\n   */\n  endPartitionKey?: string;\n\n  /**\n   * Optional, but endPartitionKey must accompany endRowKey. The maximum partition and row keys that are accessible with this shared access signature.\n   * Key values are inclusive. If they're omitted, there's no upper bound on the table entities that can be accessed.\n   */\n  endRowKey?: string;\n}\n"]}

package/dist/commonjs/sas/tableSasPermisions.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Creates a {@link TableSasPermissions} from the specified permissions string. This method will throw an
+ * Error if it encounters a character that does not correspond to a valid permission.
+ *
+ * @param permissions -
+ */
+export declare function tableSasPermissionsFromString(permissions: string): TableSasPermissions;
+/**
+ * Converts the given permissions to a string. Using this method will guarantee the permissions are in an
+ * order accepted by the service.
+ *
+ * @returns A string which represents the TableSasPermissions
+ */
+export declare function tableSasPermissionsToString(permissions?: TableSasPermissions): string;
+/**
+ * A type that looks like a Table SAS permission.
+ * Used in {@link TableSasPermissions} to parse SAS permissions from raw objects.
+ */
+export interface TableSasPermissions {
+    /**
+     * Specifies Query access granted.
+     */
+    query?: boolean;
+    /**
+     * Specifies Add access granted.
+     */
+    add?: boolean;
+    /**
+     * Specifies Update access granted.
+     */
+    update?: boolean;
+    /**
+     * Specifies Delete access granted.
+     */
+    delete?: boolean;
+}
+//# sourceMappingURL=tableSasPermisions.d.ts.map

package/dist/commonjs/sas/tableSasPermisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableSasPermisions.d.ts","sourceRoot":"","sources":["../../../src/sas/tableSasPermisions.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,CAsBtF;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAoBrF;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/commonjs/sas/tableSasPermisions.js

@@ -0,0 +1,60 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tableSasPermissionsFromString = tableSasPermissionsFromString;
+exports.tableSasPermissionsToString = tableSasPermissionsToString;
+/**
+ * Creates a {@link TableSasPermissions} from the specified permissions string. This method will throw an
+ * Error if it encounters a character that does not correspond to a valid permission.
+ *
+ * @param permissions -
+ */
+function tableSasPermissionsFromString(permissions) {
+    const tableSasPermissions = {};
+    for (const char of permissions) {
+        switch (char) {
+            case "r":
+                tableSasPermissions.query = true;
+                break;
+            case "a":
+                tableSasPermissions.add = true;
+                break;
+            case "u":
+                tableSasPermissions.update = true;
+                break;
+            case "d":
+                tableSasPermissions.delete = true;
+                break;
+            default:
+                throw new RangeError(`Invalid permission: ${char}`);
+        }
+    }
+    return tableSasPermissions;
+}
+/**
+ * Converts the given permissions to a string. Using this method will guarantee the permissions are in an
+ * order accepted by the service.
+ *
+ * @returns A string which represents the TableSasPermissions
+ */
+function tableSasPermissionsToString(permissions) {
+    if (!permissions) {
+        return "";
+    }
+    const permissionsString = [];
+    if (permissions.query) {
+        permissionsString.push("r");
+    }
+    if (permissions.add) {
+        permissionsString.push("a");
+    }
+    if (permissions.update) {
+        permissionsString.push("u");
+    }
+    if (permissions.delete) {
+        permissionsString.push("d");
+    }
+    return permissionsString.join("");
+}
+//# sourceMappingURL=tableSasPermisions.js.map

package/dist/commonjs/sas/tableSasPermisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableSasPermisions.js","sourceRoot":"","sources":["../../../src/sas/tableSasPermisions.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;AAQlC,sEAsBC;AAQD,kEAoBC;AAxDD;;;;;GAKG;AACH,SAAgB,6BAA6B,CAAC,WAAmB;IAC/D,MAAM,mBAAmB,GAAwB,EAAE,CAAC;IACpD,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,GAAG;gBACN,mBAAmB,CAAC,KAAK,GAAG,IAAI,CAAC;gBACjC,MAAM;YACR,KAAK,GAAG;gBACN,mBAAmB,CAAC,GAAG,GAAG,IAAI,CAAC;gBAC/B,MAAM;YACR,KAAK,GAAG;gBACN,mBAAmB,CAAC,MAAM,GAAG,IAAI,CAAC;gBAClC,MAAM;YACR,KAAK,GAAG;gBACN,mBAAmB,CAAC,MAAM,GAAG,IAAI,CAAC;gBAClC,MAAM;YACR;gBACE,MAAM,IAAI,UAAU,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,2BAA2B,CAAC,WAAiC;IAC3E,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,iBAAiB,GAAa,EAAE,CAAC;IACvC,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;QACtB,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,WAAW,CAAC,GAAG,EAAE,CAAC;QACpB,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;QACvB,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;QACvB,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACpC,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\n/**\n * Creates a {@link TableSasPermissions} from the specified permissions string. This method will throw an\n * Error if it encounters a character that does not correspond to a valid permission.\n *\n * @param permissions -\n */\nexport function tableSasPermissionsFromString(permissions: string): TableSasPermissions {\n  const tableSasPermissions: TableSasPermissions = {};\n  for (const char of permissions) {\n    switch (char) {\n      case \"r\":\n        tableSasPermissions.query = true;\n        break;\n      case \"a\":\n        tableSasPermissions.add = true;\n        break;\n      case \"u\":\n        tableSasPermissions.update = true;\n        break;\n      case \"d\":\n        tableSasPermissions.delete = true;\n        break;\n      default:\n        throw new RangeError(`Invalid permission: ${char}`);\n    }\n  }\n\n  return tableSasPermissions;\n}\n\n/**\n * Converts the given permissions to a string. Using this method will guarantee the permissions are in an\n * order accepted by the service.\n *\n * @returns A string which represents the TableSasPermissions\n */\nexport function tableSasPermissionsToString(permissions?: TableSasPermissions): string {\n  if (!permissions) {\n    return \"\";\n  }\n\n  const permissionsString: string[] = [];\n  if (permissions.query) {\n    permissionsString.push(\"r\");\n  }\n  if (permissions.add) {\n    permissionsString.push(\"a\");\n  }\n  if (permissions.update) {\n    permissionsString.push(\"u\");\n  }\n\n  if (permissions.delete) {\n    permissionsString.push(\"d\");\n  }\n  return permissionsString.join(\"\");\n}\n\n/**\n * A type that looks like a Table SAS permission.\n * Used in {@link TableSasPermissions} to parse SAS permissions from raw objects.\n */\nexport interface TableSasPermissions {\n  /**\n   * Specifies Query access granted.\n   */\n  query?: boolean;\n\n  /**\n   * Specifies Add access granted.\n   */\n  add?: boolean;\n\n  /**\n   * Specifies Update access granted.\n   */\n  update?: boolean;\n\n  /**\n   * Specifies Delete access granted.\n   */\n  delete?: boolean;\n}\n"]}

package/dist/commonjs/sas/tableSasSignatureValues.d.ts

@@ -0,0 +1,88 @@
+/**
+ * ONLY AVAILABLE IN NODE.JS RUNTIME.
+ *
+ * TableSASSignatureValues is used to help generating SAS tokens for tables.
+ */
+import type { SasIPRange } from "./sasIPRange.js";
+import type { SasProtocol } from "./sasQueryParameters.js";
+import { SasQueryParameters } from "./sasQueryParameters.js";
+import type { TableSasPermissions } from "./tableSasPermisions.js";
+import type { NamedKeyCredential } from "@azure/core-auth";
+/**
+ * ONLY AVAILABLE IN NODE.JS RUNTIME.
+ *
+ * TableSASSignatureValues is used to help generating Table service SAS tokens for tables
+ */
+export interface TableSasSignatureValues {
+    /**
+     * The version of the service this SAS will target. If not specified, it will default to the version targeted by the
+     * library.
+     */
+    version?: string;
+    /**
+     * Optional. SAS protocols, HTTPS only or HTTPSandHTTP
+     */
+    protocol?: SasProtocol;
+    /**
+     * Optional. When the SAS will take effect.
+     */
+    startsOn?: Date;
+    /**
+     * Optional. If identifier is not provided has a default value of one hour from the time the token is generated.
+     * The time after which the SAS will no longer work.
+     */
+    expiresOn?: Date;
+    /**
+     * Optional. If identifier is not provided has a default value of "read"
+     * Please refer to {@link TableSasPermissions} depending on the resource
+     * being accessed for help constructing the permissions string.
+     */
+    permissions?: TableSasPermissions;
+    /**
+     * Optional. IP ranges allowed in this SAS.
+     */
+    ipRange?: SasIPRange;
+    /**
+     * Optional. The name of the access policy on the container this SAS references if any.
+     *
+     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/establishing-a-stored-access-policy
+     */
+    identifier?: string;
+    /**
+     * Define the start of a Partition Key range
+     * Table queries will only return results that are within the range, and attempts to use the shared access signature to add, update, or delete entities outside this range will fail.
+     * If startPartitionKey equals endPartitionKey the shared access signature only authorizes access to entities in one partition in the table.
+     * If startPartitionKey equals endPartitionKey and startRowKey equals endRowKey, the shared access signature can only access one entity in one partition
+     */
+    startPartitionKey?: string;
+    /**
+     * Define the end of a Partition Key range
+     * Table queries will only return results that are within the range, and attempts to use the shared access signature to add, update, or delete entities outside this range will fail.
+     * If startPartitionKey equals endPartitionKey the shared access signature only authorizes access to entities in one partition in the table.
+     * If startPartitionKey equals endPartitionKey and startRowKey equals endRowKey, the shared access signature can only access one entity in one partition
+     */
+    endPartitionKey?: string;
+    /**
+     * Define the start of a Row Key range
+     * Table queries will only return results that are within the range, and attempts to use the shared access signature to add, update, or delete entities outside this range will fail.
+     * If startPartitionKey equals endPartitionKey the shared access signature only authorizes access to entities in one partition in the table.
+     * If startPartitionKey equals endPartitionKey and startRowKey equals endRowKey, the shared access signature can only access one entity in one partition
+     */
+    startRowKey?: string;
+    /**
+     * Define the end of a Row Key range
+     * Table queries will only return results that are within the range, and attempts to use the shared access signature to add, update, or delete entities outside this range will fail.
+     * If startPartitionKey equals endPartitionKey the shared access signature only authorizes access to entities in one partition in the table.
+     * If startPartitionKey equals endPartitionKey and startRowKey equals endRowKey, the shared access signature can only access one entity in one partition
+     */
+    endRowKey?: string;
+}
+/**
+ * ONLY AVAILABLE IN NODE.JS RUNTIME.
+ *
+ * Creates an instance of SASQueryParameters.
+ *
+ * **Note**: When identifier is not provided, permissions has a default value of "read" and expiresOn of one hour from the time the token is generated.
+ */
+export declare function generateTableSasQueryParameters(tableName: string, credential: NamedKeyCredential, tableSasSignatureValues: TableSasSignatureValues): SasQueryParameters;
+//# sourceMappingURL=tableSasSignatureValues.d.ts.map

package/dist/commonjs/sas/tableSasSignatureValues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableSasSignatureValues.d.ts","sourceRoot":"","sources":["../../../src/sas/tableSasSignatureValues.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,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;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAK3D;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC;IAEhB;;;OAGG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC;;OAEG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC;IAErB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,kBAAkB,EAC9B,uBAAuB,EAAE,uBAAuB,GAC/C,kBAAkB,CAyDpB"}

package/dist/commonjs/sas/tableSasSignatureValues.js

@@ -0,0 +1,77 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTableSasQueryParameters = generateTableSasQueryParameters;
+const sasIPRange_js_1 = require("./sasIPRange.js");
+const sasQueryParameters_js_1 = require("./sasQueryParameters.js");
+const tableSasPermisions_js_1 = require("./tableSasPermisions.js");
+const constants_js_1 = require("../utils/constants.js");
+const computeHMACSHA256_js_1 = require("../utils/computeHMACSHA256.js");
+const truncateISO8061Date_js_1 = require("../utils/truncateISO8061Date.js");
+/**
+ * ONLY AVAILABLE IN NODE.JS RUNTIME.
+ *
+ * Creates an instance of SASQueryParameters.
+ *
+ * **Note**: When identifier is not provided, permissions has a default value of "read" and expiresOn of one hour from the time the token is generated.
+ */
+function generateTableSasQueryParameters(tableName, credential, tableSasSignatureValues) {
+    var _a, _b, _c, _d, _e, _f;
+    const version = (_a = tableSasSignatureValues.version) !== null && _a !== void 0 ? _a : constants_js_1.SERVICE_VERSION;
+    if (credential === undefined) {
+        throw TypeError("Invalid NamedKeyCredential");
+    }
+    if (!tableName) {
+        throw new Error("Must provide a 'tableName'");
+    }
+    const signedPermissions = (0, tableSasPermisions_js_1.tableSasPermissionsToString)(tableSasSignatureValues.permissions);
+    const signedStart = tableSasSignatureValues.startsOn
+        ? (0, truncateISO8061Date_js_1.truncatedISO8061Date)(tableSasSignatureValues.startsOn, false /** withMilliseconds */)
+        : "";
+    const signedExpiry = tableSasSignatureValues.expiresOn
+        ? (0, truncateISO8061Date_js_1.truncatedISO8061Date)(tableSasSignatureValues.expiresOn, false /** withMilliseconds */)
+        : "";
+    const canonicalizedResource = getCanonicalName(credential.name, tableName);
+    const signedIdentifier = (_b = tableSasSignatureValues.identifier) !== null && _b !== void 0 ? _b : "";
+    const signedIP = (0, sasIPRange_js_1.ipRangeToString)(tableSasSignatureValues.ipRange);
+    const signedProtocol = tableSasSignatureValues.protocol || "";
+    const startingPartitionKey = (_c = tableSasSignatureValues.startPartitionKey) !== null && _c !== void 0 ? _c : "";
+    const startingRowKey = (_d = tableSasSignatureValues.startRowKey) !== null && _d !== void 0 ? _d : "";
+    const endingPartitionKey = (_e = tableSasSignatureValues.endPartitionKey) !== null && _e !== void 0 ? _e : "";
+    const endingRowKey = (_f = tableSasSignatureValues.endRowKey) !== null && _f !== void 0 ? _f : "";
+    const stringToSign = [
+        signedPermissions,
+        signedStart,
+        signedExpiry,
+        canonicalizedResource,
+        signedIdentifier,
+        signedIP,
+        signedProtocol,
+        version,
+        startingPartitionKey,
+        startingRowKey,
+        endingPartitionKey,
+        endingRowKey,
+    ].join("\n");
+    const signature = (0, computeHMACSHA256_js_1.computeHMACSHA256)(stringToSign, credential.key);
+    return new sasQueryParameters_js_1.SasQueryParameters(version, signature, {
+        permissions: signedPermissions,
+        protocol: tableSasSignatureValues.protocol,
+        startsOn: tableSasSignatureValues.startsOn,
+        expiresOn: tableSasSignatureValues.expiresOn,
+        ipRange: tableSasSignatureValues.ipRange,
+        identifier: tableSasSignatureValues.identifier,
+        tableName,
+        startPartitionKey: tableSasSignatureValues.startPartitionKey,
+        startRowKey: tableSasSignatureValues.startRowKey,
+        endPartitionKey: tableSasSignatureValues.endPartitionKey,
+        endRowKey: tableSasSignatureValues.endRowKey,
+    });
+}
+function getCanonicalName(accountName, tableName) {
+    // Sample CanonicalName for URL = https://myaccount.table.core.windows.net/Employees(PartitionKey='Jeff',RowKey='Price'):
+    //   canonicalizedResource = "/table/myaccount/employees"
+    return `/table/${accountName}/${tableName.toLowerCase()}`;
+}
+//# sourceMappingURL=tableSasSignatureValues.js.map

package/dist/commonjs/sas/tableSasSignatureValues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableSasSignatureValues.js","sourceRoot":"","sources":["../../../src/sas/tableSasSignatureValues.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\n/**\n * ONLY AVAILABLE IN NODE.JS RUNTIME.\n *\n * TableSASSignatureValues is used to help generating SAS tokens for tables.\n */\n\nimport type { SasIPRange } from \"./sasIPRange.js\";\nimport { ipRangeToString } from \"./sasIPRange.js\";\nimport type { SasProtocol } from \"./sasQueryParameters.js\";\nimport { SasQueryParameters } from \"./sasQueryParameters.js\";\nimport type { TableSasPermissions } from \"./tableSasPermisions.js\";\nimport { tableSasPermissionsToString } from \"./tableSasPermisions.js\";\nimport type { NamedKeyCredential } from \"@azure/core-auth\";\nimport { SERVICE_VERSION } from \"../utils/constants.js\";\nimport { computeHMACSHA256 } from \"../utils/computeHMACSHA256.js\";\nimport { truncatedISO8061Date } from \"../utils/truncateISO8061Date.js\";\n\n/**\n * ONLY AVAILABLE IN NODE.JS RUNTIME.\n *\n * TableSASSignatureValues is used to help generating Table service SAS tokens for tables\n */\nexport interface TableSasSignatureValues {\n  /**\n   * The version of the service this SAS will target. If not specified, it will default to the version targeted by the\n   * library.\n   */\n  version?: string;\n\n  /**\n   * Optional. SAS protocols, HTTPS only or HTTPSandHTTP\n   */\n  protocol?: SasProtocol;\n\n  /**\n   * Optional. When the SAS will take effect.\n   */\n  startsOn?: Date;\n\n  /**\n   * Optional. If identifier is not provided has a default value of one hour from the time the token is generated.\n   * The time after which the SAS will no longer work.\n   */\n  expiresOn?: Date;\n\n  /**\n   * Optional. If identifier is not provided has a default value of \"read\"\n   * Please refer to {@link TableSasPermissions} depending on the resource\n   * being accessed for help constructing the permissions string.\n   */\n  permissions?: TableSasPermissions;\n  /**\n   * Optional. IP ranges allowed in this SAS.\n   */\n  ipRange?: SasIPRange;\n\n  /**\n   * Optional. The name of the access policy on the container this SAS references if any.\n   *\n   * @see https://docs.microsoft.com/en-us/rest/api/storageservices/establishing-a-stored-access-policy\n   */\n  identifier?: string;\n\n  /**\n   * Define the start of a Partition Key range\n   * Table queries will only return results that are within the range, and attempts to use the shared access signature to add, update, or delete entities outside this range will fail.\n   * If startPartitionKey equals endPartitionKey the shared access signature only authorizes access to entities in one partition in the table.\n   * If startPartitionKey equals endPartitionKey and startRowKey equals endRowKey, the shared access signature can only access one entity in one partition\n   */\n  startPartitionKey?: string;\n  /**\n   * Define the end of a Partition Key range\n   * Table queries will only return results that are within the range, and attempts to use the shared access signature to add, update, or delete entities outside this range will fail.\n   * If startPartitionKey equals endPartitionKey the shared access signature only authorizes access to entities in one partition in the table.\n   * If startPartitionKey equals endPartitionKey and startRowKey equals endRowKey, the shared access signature can only access one entity in one partition\n   */\n  endPartitionKey?: string;\n  /**\n   * Define the start of a Row Key range\n   * Table queries will only return results that are within the range, and attempts to use the shared access signature to add, update, or delete entities outside this range will fail.\n   * If startPartitionKey equals endPartitionKey the shared access signature only authorizes access to entities in one partition in the table.\n   * If startPartitionKey equals endPartitionKey and startRowKey equals endRowKey, the shared access signature can only access one entity in one partition\n   */\n  startRowKey?: string;\n  /**\n   * Define the end of a Row Key range\n   * Table queries will only return results that are within the range, and attempts to use the shared access signature to add, update, or delete entities outside this range will fail.\n   * If startPartitionKey equals endPartitionKey the shared access signature only authorizes access to entities in one partition in the table.\n   * If startPartitionKey equals endPartitionKey and startRowKey equals endRowKey, the shared access signature can only access one entity in one partition\n   */\n  endRowKey?: string;\n}\n\n/**\n * ONLY AVAILABLE IN NODE.JS RUNTIME.\n *\n * Creates an instance of SASQueryParameters.\n *\n * **Note**: When identifier is not provided, permissions has a default value of \"read\" and expiresOn of one hour from the time the token is generated.\n */\nexport function generateTableSasQueryParameters(\n  tableName: string,\n  credential: NamedKeyCredential,\n  tableSasSignatureValues: TableSasSignatureValues,\n): SasQueryParameters {\n  const version = tableSasSignatureValues.version ?? SERVICE_VERSION;\n\n  if (credential === undefined) {\n    throw TypeError(\"Invalid NamedKeyCredential\");\n  }\n\n  if (!tableName) {\n    throw new Error(\"Must provide a 'tableName'\");\n  }\n\n  const signedPermissions = tableSasPermissionsToString(tableSasSignatureValues.permissions);\n  const signedStart = tableSasSignatureValues.startsOn\n    ? truncatedISO8061Date(tableSasSignatureValues.startsOn, false /** withMilliseconds */)\n    : \"\";\n  const signedExpiry = tableSasSignatureValues.expiresOn\n    ? truncatedISO8061Date(tableSasSignatureValues.expiresOn, false /** withMilliseconds */)\n    : \"\";\n  const canonicalizedResource = getCanonicalName(credential.name, tableName);\n  const signedIdentifier = tableSasSignatureValues.identifier ?? \"\";\n  const signedIP = ipRangeToString(tableSasSignatureValues.ipRange);\n  const signedProtocol = tableSasSignatureValues.protocol || \"\";\n  const startingPartitionKey = tableSasSignatureValues.startPartitionKey ?? \"\";\n  const startingRowKey = tableSasSignatureValues.startRowKey ?? \"\";\n  const endingPartitionKey = tableSasSignatureValues.endPartitionKey ?? \"\";\n  const endingRowKey = tableSasSignatureValues.endRowKey ?? \"\";\n\n  const stringToSign = [\n    signedPermissions,\n    signedStart,\n    signedExpiry,\n    canonicalizedResource,\n    signedIdentifier,\n    signedIP,\n    signedProtocol,\n    version,\n    startingPartitionKey,\n    startingRowKey,\n    endingPartitionKey,\n    endingRowKey,\n  ].join(\"\\n\");\n\n  const signature = computeHMACSHA256(stringToSign, credential.key);\n\n  return new SasQueryParameters(version, signature, {\n    permissions: signedPermissions,\n    protocol: tableSasSignatureValues.protocol,\n    startsOn: tableSasSignatureValues.startsOn,\n    expiresOn: tableSasSignatureValues.expiresOn,\n    ipRange: tableSasSignatureValues.ipRange,\n    identifier: tableSasSignatureValues.identifier,\n    tableName,\n    startPartitionKey: tableSasSignatureValues.startPartitionKey,\n    startRowKey: tableSasSignatureValues.startRowKey,\n    endPartitionKey: tableSasSignatureValues.endPartitionKey,\n    endRowKey: tableSasSignatureValues.endRowKey,\n  });\n}\n\nfunction getCanonicalName(accountName: string, tableName: string): string {\n  // Sample CanonicalName for URL = https://myaccount.table.core.windows.net/Employees(PartitionKey='Jeff',RowKey='Price'):\n  //   canonicalizedResource = \"/table/myaccount/employees\"\n  return `/table/${accountName}/${tableName.toLowerCase()}`;\n}\n"]}

package/dist/commonjs/secondaryEndpointPolicy.d.ts

@@ -0,0 +1,17 @@
+import type { OperationOptions } from "@azure/core-client";
+import type { PipelinePolicy } from "@azure/core-rest-pipeline";
+/**
+ * The programmatic identifier of the tablesSecondaryEndpointPolicy.
+ */
+export declare const tablesSecondaryEndpointPolicyName = "tablesSecondaryEndpointPolicy";
+export declare const SecondaryLocationHeaderName = "tables-secondary-endpoint";
+/**
+ * Policy that would replace the Primary Endpoint with the secondary endpoint
+ * when the `tables-secondary-endpoint` is set in the request
+ */
+export declare const tablesSecondaryEndpointPolicy: PipelinePolicy;
+/**
+ * Utility function that injects the SecondaryEndpointHeader into an operation options
+ */
+export declare function injectSecondaryEndpointHeader(options: OperationOptions): OperationOptions;
+//# sourceMappingURL=secondaryEndpointPolicy.d.ts.map

package/dist/commonjs/secondaryEndpointPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secondaryEndpointPolicy.d.ts","sourceRoot":"","sources":["../../src/secondaryEndpointPolicy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,iCAAiC,kCAAkC,CAAC;AACjF,eAAO,MAAM,2BAA2B,8BAA8B,CAAC;AAGvE;;;GAGG;AACH,eAAO,MAAM,6BAA6B,EAAE,cAa3C,CAAC;AAEF;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAYzF"}

package/dist/commonjs/secondaryEndpointPolicy.js

@@ -0,0 +1,50 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tablesSecondaryEndpointPolicy = exports.SecondaryLocationHeaderName = exports.tablesSecondaryEndpointPolicyName = void 0;
+exports.injectSecondaryEndpointHeader = injectSecondaryEndpointHeader;
+/**
+ * The programmatic identifier of the tablesSecondaryEndpointPolicy.
+ */
+exports.tablesSecondaryEndpointPolicyName = "tablesSecondaryEndpointPolicy";
+exports.SecondaryLocationHeaderName = "tables-secondary-endpoint";
+const SecondaryLocationAccountSuffix = "-secondary";
+/**
+ * Policy that would replace the Primary Endpoint with the secondary endpoint
+ * when the `tables-secondary-endpoint` is set in the request
+ */
+exports.tablesSecondaryEndpointPolicy = {
+    name: exports.tablesSecondaryEndpointPolicyName,
+    sendRequest: async (req, next) => {
+        // Only replace the URL if the SecondaryLocationHeader is set
+        if (req.headers.get(exports.SecondaryLocationHeaderName)) {
+            // Since the header is for internal use only, clean it up.
+            req.headers.delete(exports.SecondaryLocationHeaderName);
+            // Calculate and update the secondary url
+            req.url = getSecondaryUrlFromPrimary(req.url);
+        }
+        return next(req);
+    },
+};
+/**
+ * Utility function that injects the SecondaryEndpointHeader into an operation options
+ */
+function injectSecondaryEndpointHeader(options) {
+    var _a;
+    const headerToInject = { [exports.SecondaryLocationHeaderName]: "true" };
+    return Object.assign(Object.assign({}, options), { requestOptions: Object.assign(Object.assign({}, options.requestOptions), { customHeaders: Object.assign(Object.assign({}, (_a = options.requestOptions) === null || _a === void 0 ? void 0 : _a.customHeaders), headerToInject) }) });
+}
+/**
+ * Utility function that calculates the secondary URL for a table instance given the primary URL.
+ */
+function getSecondaryUrlFromPrimary(primaryUrl) {
+    const parsedPrimaryUrl = new URL(primaryUrl);
+    const host = parsedPrimaryUrl.hostname.split(".");
+    if (host.length > 1) {
+        host[0] = `${host[0]}${SecondaryLocationAccountSuffix}`;
+    }
+    parsedPrimaryUrl.hostname = host.join(".");
+    return parsedPrimaryUrl.toString();
+}
+//# sourceMappingURL=secondaryEndpointPolicy.js.map

package/dist/commonjs/secondaryEndpointPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secondaryEndpointPolicy.js","sourceRoot":"","sources":["../../src/secondaryEndpointPolicy.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAkClC,sEAYC;AAzCD;;GAEG;AACU,QAAA,iCAAiC,GAAG,+BAA+B,CAAC;AACpE,QAAA,2BAA2B,GAAG,2BAA2B,CAAC;AACvE,MAAM,8BAA8B,GAAG,YAAY,CAAC;AAEpD;;;GAGG;AACU,QAAA,6BAA6B,GAAmB;IAC3D,IAAI,EAAE,yCAAiC;IACvC,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC/B,6DAA6D;QAC7D,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,mCAA2B,CAAC,EAAE,CAAC;YACjD,0DAA0D;YAC1D,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,mCAA2B,CAAC,CAAC;YAChD,yCAAyC;YACzC,GAAG,CAAC,GAAG,GAAG,0BAA0B,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,SAAgB,6BAA6B,CAAC,OAAyB;;IACrE,MAAM,cAAc,GAAG,EAAE,CAAC,mCAA2B,CAAC,EAAE,MAAM,EAAE,CAAC;IACjE,uCACK,OAAO,KACV,cAAc,kCACT,OAAO,CAAC,cAAc,KACzB,aAAa,kCACR,MAAA,OAAO,CAAC,cAAc,0CAAE,aAAa,GACrC,cAAc,QAGrB;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,0BAA0B,CAAC,UAAkB;IACpD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,8BAA8B,EAAE,CAAC;IAC1D,CAAC;IACD,gBAAgB,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE3C,OAAO,gBAAgB,CAAC,QAAQ,EAAE,CAAC;AACrC,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { OperationOptions } from \"@azure/core-client\";\nimport type { PipelinePolicy } from \"@azure/core-rest-pipeline\";\n\n/**\n * The programmatic identifier of the tablesSecondaryEndpointPolicy.\n */\nexport const tablesSecondaryEndpointPolicyName = \"tablesSecondaryEndpointPolicy\";\nexport const SecondaryLocationHeaderName = \"tables-secondary-endpoint\";\nconst SecondaryLocationAccountSuffix = \"-secondary\";\n\n/**\n * Policy that would replace the Primary Endpoint with the secondary endpoint\n * when the `tables-secondary-endpoint` is set in the request\n */\nexport const tablesSecondaryEndpointPolicy: PipelinePolicy = {\n  name: tablesSecondaryEndpointPolicyName,\n  sendRequest: async (req, next) => {\n    // Only replace the URL if the SecondaryLocationHeader is set\n    if (req.headers.get(SecondaryLocationHeaderName)) {\n      // Since the header is for internal use only, clean it up.\n      req.headers.delete(SecondaryLocationHeaderName);\n      // Calculate and update the secondary url\n      req.url = getSecondaryUrlFromPrimary(req.url);\n    }\n\n    return next(req);\n  },\n};\n\n/**\n * Utility function that injects the SecondaryEndpointHeader into an operation options\n */\nexport function injectSecondaryEndpointHeader(options: OperationOptions): OperationOptions {\n  const headerToInject = { [SecondaryLocationHeaderName]: \"true\" };\n  return {\n    ...options,\n    requestOptions: {\n      ...options.requestOptions,\n      customHeaders: {\n        ...options.requestOptions?.customHeaders,\n        ...headerToInject,\n      },\n    },\n  };\n}\n\n/**\n * Utility function that calculates the secondary URL for a table instance given the primary URL.\n */\nfunction getSecondaryUrlFromPrimary(primaryUrl: string): string {\n  const parsedPrimaryUrl = new URL(primaryUrl);\n  const host = parsedPrimaryUrl.hostname.split(\".\");\n  if (host.length > 1) {\n    host[0] = `${host[0]}${SecondaryLocationAccountSuffix}`;\n  }\n  parsedPrimaryUrl.hostname = host.join(\".\");\n\n  return parsedPrimaryUrl.toString();\n}\n"]}