@microsoft/omnichannel-chat-sdk 2.0.1 → 2.0.2-main.8b19159

package/README.md

@@ -113,10 +113,14 @@ For a detailed tracking of the releases, please refer to the [Changelog document
 
 _**Important Note:**_ Versions below 1.11.0 are no longer supported after November 1st, 2025. Please update to recent versions to ensure you have the latest features and bug fixes.
 
+_**Known issue:**_ Versions earlier than 1.11.6 can start duplicate conversations when an application calls `startChat()` again before the previous call is complete. Upgrade to 1.11.8 or later. See [Concurrent `startChat()` calls in versions before 1.11.6](docs/KNOWN_ISSUE_CONCURRENT_STARTCHAT.md).
+
 | Version | Docs | Release Date | End of Support | Deprecated |
 | -- | -- | -- | -- | -- |
+| 2.0.2 | [Release Notes](https://github.com/microsoft/omnichannel-chat-sdk/releases/tag/v2.0.2) | Oct 20th 2026 | Oct 20th 2027 | |
 | 2.0.1 | [Release Notes](https://github.com/microsoft/omnichannel-chat-sdk/releases/tag/v2.0.1) | Oct 1st 2026 | Oct 1st 2027 | |
 | 2.0.0 | [Migration Guide](docs/MIGRATION_2.0.md) / [Release Notes](https://github.com/microsoft/omnichannel-chat-sdk/releases/tag/v2.0.0) | Aug 13th 2026 | Aug 13th 2027 | |
+| 1.11.8 | [Release Notes](https://github.com/microsoft/omnichannel-chat-sdk/releases/tag/v1.11.8) | Feb 2nd 2026 | Feb 2nd 2027 | |
 | 1.11.4 | [Release Notes](https://github.com/microsoft/omnichannel-chat-sdk/releases/tag/v1.11.4) | Jul 17th 2025 | Jul 17th 2026 | |
 | 1.11.3 | [Release Notes](https://github.com/microsoft/omnichannel-chat-sdk/releases/tag/v1.11.3) | Jul 14th 2025 | Jul 14th 2026 | |
 | 1.11.2 | [Release Notes](https://github.com/microsoft/omnichannel-chat-sdk/releases/tag/v1.11.2) | Jun 24th 2025 | Jun 24th 2026 | |

package/lib/OmnichannelChatSDK.d.ts

@@ -57,6 +57,7 @@ declare class OmnichannelChatSDK {
     private coreServicesOrgUrl;
     private dynamicsLocationCode;
     private chatToken;
+    private chatTokenUnauthorizedRecovery;
     private liveChatConfig;
     private widgetSnippetBaseUrl;
     private liveChatVersion;
@@ -77,6 +78,7 @@ declare class OmnichannelChatSDK {
     private isPersistentChat;
     private isChatReconnect;
     private reconnectId;
+    private endedChatSessionKey;
     private refreshTokenTimer;
     private AMSClientLoadCurrentState;
     private isMaskingDisabled;
@@ -165,6 +167,30 @@ declare class OmnichannelChatSDK {
     getLiveChatConfig(optionalParams?: GetLiveChatConfigOptionalParams): Promise<ChatConfig>;
     getChatToken(cached?: boolean, optionalParams?: GetChatTokenOptionalParams): Promise<IChatToken>;
     setChatToken(chatToken: FetchChatTokenResponse): void;
+    /**
+     * Creates the ACS token refresher used to renew the chat token before it expires. Returns undefined, which keeps
+     * the existing behavior, unless renewal is enabled in the chat config, not disabled in the SDK config and
+     * supported by the installed OCSDK. The refresher never throws and falls back to the current token on failure.
+     */
+    private createChatTokenRefresher;
+    /**
+     * Gives the renewed chat token to the attachment client, which keeps the token it was initialized with and uses
+     * it for every upload and download. Runs in the background and never throws: on failure, attachments keep using
+     * the previous token as they did before renewal existed.
+     */
+    private refreshAttachmentClientToken;
+    /**
+     * Creates the recovery for chat requests that fail with 401 while the chat token has not
+     * expired. Returns null, which keeps the existing behavior, unless chat token renewal is enabled and recovery is
+     * not disabled in the SDK config.
+     */
+    private createChatTokenUnauthorizedRecovery;
+    /**
+     * Returns the token of the authenticated user to renew the chat token with, refreshed from the auth token
+     * provider when possible because the token used to start the chat may have expired. Returns undefined for
+     * unauthenticated chats.
+     */
+    private getAuthenticatedUserTokenForChatTokenRenewal;
     getCallingToken(): Promise<string>;
     private recordMessages;
     getMessages(): Promise<GetMessagesResponse>;
@@ -208,6 +234,15 @@ declare class OmnichannelChatSDK {
     downloadFileAttachment(fileMetadata: FileMetadata | IFileMetadata): Promise<Blob>;
     emailLiveChatTranscript(body: ChatTranscriptBody, optionalParams?: EmailLiveChatTranscriptOptionaParams): Promise<void>;
     getLiveChatTranscript(optionalParams?: GetLiveChatTranscriptOptionalParams): Promise<GetLiveChatTranscriptResponse>;
+    /**
+     * Returns the ended chat's session key when the call targets that chat, or null.
+     */
+    private getEndedChatSessionKey;
+    /**
+     * Sends the session key on one OCSDK request without leaving it on the shared client. OCSDK copies the
+     * key into the request headers before its first await, so the previous key is restored before the HTTP wait.
+     */
+    private withRequestSessionKey;
     createChatAdapter(optionalParams?: ChatAdapterOptionalParams): Promise<ChatAdapter>;
     isVoiceVideoCallingEnabled(): boolean;
     getVoiceVideoCalling(voiceVideoCallingOptionalParams?: VoiceVideoCallingOptionalParams): Promise<GetVoiceVideoCallingResponse>;

package/lib/OmnichannelChatSDK.js

@@ -103,6 +103,8 @@ var location_1 = require("./utils/location");
 var internalUtils_1 = require("./utils/internalUtils");
 var loggerUtils_1 = require("./utils/loggerUtils");
 var parsers_1 = require("./utils/parsers");
+var chatTokenUnauthorizedRecovery_1 = require("./utils/chatTokenUnauthorizedRecovery");
+var chatTokenRenewal_1 = require("./utils/chatTokenRenewal");
 var platform_1 = require("./utils/platform");
 var retrieveCollectorUri_1 = require("./telemetry/retrieveCollectorUri");
 var startPolling_1 = require("./commands/startPolling");
@@ -125,6 +127,7 @@ var OmnichannelChatSDK = /** @class */ (function () {
         this.unqServicesOrgUrl = null;
         this.coreServicesOrgUrl = null;
         this.dynamicsLocationCode = null;
+        this.chatTokenUnauthorizedRecovery = null;
         this.widgetSnippetBaseUrl = '';
         this.dataMaskingRules = { rules: [] };
         this.authSettings = null;
@@ -141,6 +144,8 @@ var OmnichannelChatSDK = /** @class */ (function () {
         this.isPersistentChat = false;
         this.isChatReconnect = false;
         this.reconnectId = null;
+        // Session key of the most recently ended chat. MRT validates it on transcript calls made after endChat.
+        this.endedChatSessionKey = null;
         this.refreshTokenTimer = null;
         this.AMSClientLoadCurrentState = AMSClientLoadStates_1.AMSClientLoadStates.NOT_LOADED;
         this.isMaskingDisabled = false;
@@ -876,6 +881,7 @@ var OmnichannelChatSDK = /** @class */ (function () {
                 switch (_u.label) {
                     case 0:
                         this.isEndingChat = false;
+                        this.endedChatSessionKey = null;
                         this.scenarioMarker.startScenario(TelemetryEvent_1.default.StartChat, {
                             RequestId: this.requestId
                         });
@@ -1097,10 +1103,10 @@ var OmnichannelChatSDK = /** @class */ (function () {
                             });
                         }); };
                         messagingClientPromise = function () { return __awaiter(_this, void 0, void 0, function () {
-                            var chatAdapterConfig, error_8, telemetryData, _a, error_9, telemetryData, error_10, telemetryData, _b, error_11, telemetryData;
-                            var _c, _d;
-                            return __generator(this, function (_e) {
-                                switch (_e.label) {
+                            var chatAdapterConfig, tokenRefresher, error_8, telemetryData, _a, error_9, telemetryData, error_10, telemetryData, _b, error_11, telemetryData;
+                            var _c, _d, _e;
+                            return __generator(this, function (_f) {
+                                switch (_f.label) {
                                     case 0:
                                         if (!(this.liveChatVersion === LiveChatVersion_1.default.V2)) return [3 /*break*/, 8];
                                         chatAdapterConfig = {
@@ -1110,18 +1116,22 @@ var OmnichannelChatSDK = /** @class */ (function () {
                                             environmentUrl: this.chatToken.acsEndpoint,
                                             pollingInterval: 30000
                                         };
-                                        _e.label = 1;
+                                        _f.label = 1;
                                     case 1:
-                                        _e.trys.push([1, 3, , 4]);
+                                        _f.trys.push([1, 3, , 4]);
+                                        tokenRefresher = this.createChatTokenRefresher(chatAdapterConfig.token);
+                                        this.chatTokenUnauthorizedRecovery = this.createChatTokenUnauthorizedRecovery(chatAdapterConfig.token, tokenRefresher);
                                         return [4 /*yield*/, ((_c = this.ACSClient) === null || _c === void 0 ? void 0 : _c.initialize({
                                                 token: chatAdapterConfig.token,
                                                 environmentUrl: chatAdapterConfig.environmentUrl,
+                                                tokenRefresher: tokenRefresher,
+                                                unauthorizedRecovery: (_d = this.chatTokenUnauthorizedRecovery) !== null && _d !== void 0 ? _d : undefined
                                             }))];
                                     case 2:
-                                        _e.sent();
+                                        _f.sent();
                                         return [3 /*break*/, 4];
                                     case 3:
-                                        error_8 = _e.sent();
+                                        error_8 = _f.sent();
                                         telemetryData = {
                                             RequestId: this.requestId,
                                             ChatId: this.chatToken.chatId,
@@ -1129,22 +1139,22 @@ var OmnichannelChatSDK = /** @class */ (function () {
                                         exceptionThrowers_1.default.throwMessagingClientInitializationFailure(error_8, this.scenarioMarker, TelemetryEvent_1.default.StartChat, telemetryData);
                                         return [3 /*break*/, 4];
                                     case 4:
-                                        _e.trys.push([4, 6, , 7]);
+                                        _f.trys.push([4, 6, , 7]);
                                         _a = this;
-                                        return [4 /*yield*/, ((_d = this.ACSClient) === null || _d === void 0 ? void 0 : _d.joinConversation({
+                                        return [4 /*yield*/, ((_e = this.ACSClient) === null || _e === void 0 ? void 0 : _e.joinConversation({
                                                 id: chatAdapterConfig.id,
                                                 threadId: chatAdapterConfig.threadId,
                                                 pollingInterval: chatAdapterConfig.pollingInterval
                                             }))];
                                     case 5:
-                                        _a.conversation = (_e.sent());
+                                        _a.conversation = (_f.sent());
                                         this.scenarioMarker.completeScenario(TelemetryEvent_1.default.StartChat, {
                                             RequestId: this.requestId,
                                             ChatId: this.chatToken.chatId
                                         });
                                         return [3 /*break*/, 7];
                                     case 6:
-                                        error_9 = _e.sent();
+                                        error_9 = _f.sent();
                                         telemetryData = {
                                             RequestId: this.requestId,
                                             ChatId: this.chatToken.chatId,
@@ -1153,17 +1163,17 @@ var OmnichannelChatSDK = /** @class */ (function () {
                                         return [3 /*break*/, 7];
                                     case 7: return [3 /*break*/, 14];
                                     case 8:
-                                        _e.trys.push([8, 10, , 11]);
+                                        _f.trys.push([8, 10, , 11]);
                                         return [4 /*yield*/, this.IC3Client.initialize({
                                                 token: this.chatToken.token,
                                                 regionGtms: this.chatToken.regionGTMS,
                                                 visitor: true
                                             })];
                                     case 9:
-                                        _e.sent();
+                                        _f.sent();
                                         return [3 /*break*/, 11];
                                     case 10:
-                                        error_10 = _e.sent();
+                                        error_10 = _f.sent();
                                         telemetryData = {
                                             RequestId: this.requestId,
                                             ChatId: this.chatToken.chatId,
@@ -1171,18 +1181,18 @@ var OmnichannelChatSDK = /** @class */ (function () {
                                         exceptionThrowers_1.default.throwMessagingClientInitializationFailure(error_10, this.scenarioMarker, TelemetryEvent_1.default.StartChat, telemetryData);
                                         return [3 /*break*/, 11];
                                     case 11:
-                                        _e.trys.push([11, 13, , 14]);
+                                        _f.trys.push([11, 13, , 14]);
                                         _b = this;
                                         return [4 /*yield*/, this.IC3Client.joinConversation(this.chatToken.chatId)];
                                     case 12:
-                                        _b.conversation = _e.sent();
+                                        _b.conversation = _f.sent();
                                         this.scenarioMarker.completeScenario(TelemetryEvent_1.default.StartChat, {
                                             RequestId: this.requestId,
                                             ChatId: this.chatToken.chatId
                                         });
                                         return [3 /*break*/, 14];
                                     case 13:
-                                        error_11 = _e.sent();
+                                        error_11 = _f.sent();
                                         telemetryData = {
                                             RequestId: this.requestId,
                                             ChatId: this.chatToken.chatId,
@@ -1360,7 +1370,7 @@ var OmnichannelChatSDK = /** @class */ (function () {
     };
     OmnichannelChatSDK.prototype.internalEndChat = function () {
         return __awaiter(this, arguments, void 0, function (endChatOptionalParams) {
-            var cleanupMetadata, isReactNative, isConversationalSurveyEnabled, shouldWaitForSurvey, telemetryData, surveyStarted, error_15, error_16, telemetryData;
+            var cleanupMetadata, isReactNative, isConversationalSurveyEnabled, shouldWaitForSurvey, telemetryData, surveyStarted, error_15, error_16, telemetryData, endedChatId, endedSessionId;
             var _a, _b, _c;
             if (endChatOptionalParams === void 0) { endChatOptionalParams = {}; }
             return __generator(this, function (_d) {
@@ -1419,12 +1429,17 @@ var OmnichannelChatSDK = /** @class */ (function () {
                         exceptionThrowers_1.default.throwConversationClosureFailure(error_16, this.scenarioMarker, TelemetryEvent_1.default.EndChat, telemetryData);
                         return [3 /*break*/, 11];
                     case 10:
-                        // Cleanup always runs, regardless of success or failure
-                        // This ensures resources are released even if closeChat or survey waiting throws
+                        endedChatId = this.chatToken.chatId;
+                        endedSessionId = this.OCClient.sessionId || this.sessionId;
+                        // Keep the previous chat's key when this call had no chat to end (for example a second endChat).
+                        if (endedChatId && endedSessionId) {
+                            this.endedChatSessionKey = { chatId: endedChatId, sessionId: endedSessionId };
+                        }
                         (_c = this.conversation) === null || _c === void 0 ? void 0 : _c.disconnect();
                         this.conversation = null;
                         this.requestId = (0, ocsdk_1.uuidv4)();
                         this.chatToken = {};
+                        this.chatTokenUnauthorizedRecovery = null;
                         this.reconnectId = null;
                         if (this.IC3Client) {
                             this.IC3Client.dispose();
@@ -1790,6 +1805,181 @@ var OmnichannelChatSDK = /** @class */ (function () {
             this.sessionId = this.OCClient.sessionId;
         }
     };
+    /**
+     * Creates the ACS token refresher used to renew the chat token before it expires. Returns undefined, which keeps
+     * the existing behavior, unless renewal is enabled in the chat config, not disabled in the SDK config and
+     * supported by the installed OCSDK. The refresher never throws and falls back to the current token on failure.
+     */
+    OmnichannelChatSDK.prototype.createChatTokenRefresher = function (initialToken) {
+        var _this = this;
+        var _a, _b, _c, _d, _e, _f;
+        try {
+            if (this.liveChatVersion !== LiveChatVersion_1.default.V2
+                || ((_b = (_a = this.chatSDKConfig) === null || _a === void 0 ? void 0 : _a.chatTokenRenewal) === null || _b === void 0 ? void 0 : _b.disable) === true
+                || (0, parsers_1.parseLowerCaseString)((_d = (_c = this.liveChatConfig) === null || _c === void 0 ? void 0 : _c.LcwFcbConfiguration) === null || _d === void 0 ? void 0 : _d.lcwChatTokenRenewalEnabled) !== "true"
+                || typeof ((_e = this.OCClient) === null || _e === void 0 ? void 0 : _e.renewChatToken) !== "function"
+                || !initialToken
+                || !((_f = this.chatToken) === null || _f === void 0 ? void 0 : _f.chatId)
+                || !this.requestId) {
+                return undefined;
+            }
+            var chatId_1 = this.chatToken.chatId;
+            var requestId_1 = this.requestId;
+            // A reconnected chat is found by its reconnect id, not by the new request id
+            var renewalId_1 = this.reconnectId || requestId_1;
+            var telemetryData_1 = {
+                RequestId: requestId_1,
+                ChatId: chatId_1
+            };
+            return (0, chatTokenRenewal_1.createChatTokenRefresher)({
+                initialToken: initialToken,
+                chatId: chatId_1,
+                isChatActive: function () { var _a; return !_this.isEndingChat && _this.requestId === requestId_1 && ((_a = _this.chatToken) === null || _a === void 0 ? void 0 : _a.chatId) === chatId_1; },
+                renewChatToken: function () { return __awaiter(_this, void 0, void 0, function () {
+                    var renewChatTokenOptionalParams, authenticatedUserToken;
+                    return __generator(this, function (_a) {
+                        switch (_a.label) {
+                            case 0:
+                                renewChatTokenOptionalParams = {};
+                                return [4 /*yield*/, this.getAuthenticatedUserTokenForChatTokenRenewal()];
+                            case 1:
+                                authenticatedUserToken = _a.sent();
+                                if (authenticatedUserToken) {
+                                    renewChatTokenOptionalParams.authenticatedUserToken = authenticatedUserToken;
+                                }
+                                return [2 /*return*/, this.OCClient.renewChatToken(renewalId_1, renewChatTokenOptionalParams)];
+                        }
+                    });
+                }); },
+                isNonRetriableStatus: function (statusCode) { return (_this.authenticatedUserToken ? chatTokenRenewal_1.authenticatedNonRetriableStatusCodes : chatTokenRenewal_1.defaultNonRetriableStatusCodes).includes(statusCode); },
+                onRenewed: function (renewed) {
+                    var _a;
+                    _this.chatToken = __assign(__assign({}, _this.chatToken), { token: renewed.Token, expiresIn: renewed.ExpiresIn !== undefined && renewed.ExpiresIn !== null ? String(renewed.ExpiresIn) : _this.chatToken.expiresIn, voiceVideoCallToken: (_a = renewed.VoiceVideoCallToken) !== null && _a !== void 0 ? _a : _this.chatToken.voiceVideoCallToken });
+                    _this.refreshAttachmentClientToken(chatId_1);
+                },
+                onStart: function () { return _this.scenarioMarker.startScenario(TelemetryEvent_1.default.RenewChatToken, telemetryData_1); },
+                onSuccess: function () { return _this.scenarioMarker.completeScenario(TelemetryEvent_1.default.RenewChatToken, telemetryData_1); },
+                onFailure: function (reason, error) {
+                    var exceptionDetails = {
+                        response: reason,
+                        errorObject: error !== undefined ? "".concat(error) : undefined
+                    };
+                    _this.scenarioMarker.failScenario(TelemetryEvent_1.default.RenewChatToken, __assign(__assign({}, telemetryData_1), { ExceptionDetails: JSON.stringify(exceptionDetails) }));
+                }
+            });
+        }
+        catch (_g) {
+            return undefined;
+        }
+    };
+    /**
+     * Gives the renewed chat token to the attachment client, which keeps the token it was initialized with and uses
+     * it for every upload and download. Runs in the background and never throws: on failure, attachments keep using
+     * the previous token as they did before renewal existed.
+     */
+    OmnichannelChatSDK.prototype.refreshAttachmentClientToken = function (chatId) {
+        var _this = this;
+        try {
+            var amsClient_1 = this.AMSClient;
+            var chatToken_1 = this.chatToken;
+            if (!this.isAMSClientAllowed
+                || this.AMSClientLoadCurrentState !== AMSClientLoadStates_1.AMSClientLoadStates.LOADED
+                || !amsClient_1
+                || typeof amsClient_1.initialize !== "function"
+                || (chatToken_1 === null || chatToken_1 === void 0 ? void 0 : chatToken_1.chatId) !== chatId
+                || !chatToken_1.token) {
+                return;
+            }
+            var telemetryData_2 = {
+                RequestId: this.requestId,
+                ChatId: chatId
+            };
+            this.scenarioMarker.startScenario(TelemetryEvent_1.default.RefreshAttachmentClientToken, telemetryData_2);
+            Promise.resolve()
+                .then(function () { return amsClient_1.initialize({ chatToken: chatToken_1 }); })
+                .then(function () {
+                _this.scenarioMarker.completeScenario(TelemetryEvent_1.default.RefreshAttachmentClientToken, telemetryData_2);
+            }, function (error) {
+                _this.scenarioMarker.failScenario(TelemetryEvent_1.default.RefreshAttachmentClientToken, __assign(__assign({}, telemetryData_2), { ExceptionDetails: JSON.stringify({ errorObject: "".concat(error) }) }));
+            })
+                .catch(function () {
+                // Telemetry failures must not surface
+            });
+        }
+        catch (_a) {
+            // Attachments keep using the previous token
+        }
+    };
+    /**
+     * Creates the recovery for chat requests that fail with 401 while the chat token has not
+     * expired. Returns null, which keeps the existing behavior, unless chat token renewal is enabled and recovery is
+     * not disabled in the SDK config.
+     */
+    OmnichannelChatSDK.prototype.createChatTokenUnauthorizedRecovery = function (initialToken, tokenRefresher) {
+        var _this = this;
+        var _a, _b, _c;
+        try {
+            if (!tokenRefresher
+                || ((_b = (_a = this.chatSDKConfig) === null || _a === void 0 ? void 0 : _a.chatTokenRenewal) === null || _b === void 0 ? void 0 : _b.disableUnauthorizedRecovery) === true
+                || !initialToken) {
+                return null;
+            }
+            var telemetryData_3 = {
+                RequestId: this.requestId,
+                ChatId: (_c = this.chatToken) === null || _c === void 0 ? void 0 : _c.chatId
+            };
+            return (0, chatTokenUnauthorizedRecovery_1.createChatTokenUnauthorizedRecovery)({
+                initialToken: initialToken,
+                refreshToken: tokenRefresher,
+                onStart: function () { return _this.scenarioMarker.startScenario(TelemetryEvent_1.default.ChatTokenUnauthorizedRecovery, telemetryData_3); },
+                onSuccess: function (_source, usedExistingToken) {
+                    if (!usedExistingToken) {
+                        _this.scenarioMarker.completeScenario(TelemetryEvent_1.default.ChatTokenUnauthorizedRecovery, telemetryData_3);
+                    }
+                },
+                onFailure: function (source, reason) {
+                    _this.scenarioMarker.failScenario(TelemetryEvent_1.default.ChatTokenUnauthorizedRecovery, __assign(__assign({}, telemetryData_3), { ExceptionDetails: JSON.stringify({ response: reason, source: source }) }));
+                }
+            });
+        }
+        catch (_d) {
+            return null;
+        }
+    };
+    /**
+     * Returns the token of the authenticated user to renew the chat token with, refreshed from the auth token
+     * provider when possible because the token used to start the chat may have expired. Returns undefined for
+     * unauthenticated chats.
+     */
+    OmnichannelChatSDK.prototype.getAuthenticatedUserTokenForChatTokenRenewal = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var token, _a;
+            var _b;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
+                    case 0:
+                        if (!this.authenticatedUserToken) {
+                            return [2 /*return*/, undefined];
+                        }
+                        if (!(typeof ((_b = this.chatSDKConfig) === null || _b === void 0 ? void 0 : _b.getAuthToken) === "function")) return [3 /*break*/, 4];
+                        _c.label = 1;
+                    case 1:
+                        _c.trys.push([1, 3, , 4]);
+                        return [4 /*yield*/, this.chatSDKConfig.getAuthToken()];
+                    case 2:
+                        token = _c.sent();
+                        if (typeof token === "string" && token.trim().length > 0) {
+                            return [2 /*return*/, token];
+                        }
+                        return [3 /*break*/, 4];
+                    case 3:
+                        _a = _c.sent();
+                        return [3 /*break*/, 4];
+                    case 4: return [2 /*return*/, this.authenticatedUserToken];
+                }
+            });
+        });
+    };
     OmnichannelChatSDK.prototype.getCallingToken = function () {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
@@ -2628,7 +2818,8 @@ var OmnichannelChatSDK = /** @class */ (function () {
     };
     OmnichannelChatSDK.prototype.emailLiveChatTranscript = function (body_1) {
         return __awaiter(this, arguments, void 0, function (body, optionalParams) {
-            var emailTranscriptOptionalParams, requestId, chatToken, chatId, sessionId, emailRequestBody, error_27;
+            var emailTranscriptOptionalParams, requestId, chatToken, chatId, requestSessionKey, emailRequestBody_1, error_27;
+            var _this = this;
             var _a;
             if (optionalParams === void 0) { optionalParams = {}; }
             return __generator(this, function (_b) {
@@ -2638,16 +2829,12 @@ var OmnichannelChatSDK = /** @class */ (function () {
                         requestId = this.requestId;
                         chatToken = this.chatToken;
                         chatId = chatToken.chatId;
-                        sessionId = this.sessionId;
                         if (optionalParams.liveChatContext) {
                             requestId = optionalParams.liveChatContext.requestId;
                             chatToken = optionalParams.liveChatContext.chatToken;
                             chatId = chatToken.chatId;
                         }
-                        if ((_a = optionalParams.liveChatContext) === null || _a === void 0 ? void 0 : _a.sessionId) {
-                            sessionId = optionalParams.liveChatContext.sessionId;
-                            this.OCClient.sessionId = sessionId;
-                        }
+                        requestSessionKey = ((_a = optionalParams.liveChatContext) === null || _a === void 0 ? void 0 : _a.sessionId) || this.getEndedChatSessionKey(chatId);
                         this.scenarioMarker.startScenario(TelemetryEvent_1.default.EmailLiveChatTranscript, {
                             RequestId: requestId,
                             ChatId: chatId
@@ -2661,18 +2848,15 @@ var OmnichannelChatSDK = /** @class */ (function () {
                         if (this.authenticatedUserToken) {
                             emailTranscriptOptionalParams.authenticatedUserToken = this.authenticatedUserToken;
                         }
-                        emailRequestBody = {
+                        emailRequestBody_1 = {
                             ChatId: chatId,
                             EmailAddress: body.emailAddress,
                             DefaultAttachmentMessage: body.attachmentMessage,
                             CustomerLocale: body.locale || (0, locale_1.getLocaleStringFromId)(this.localeId)
                         };
-                        return [4 /*yield*/, this.OCClient.emailTranscript(requestId, chatToken.token, emailRequestBody, emailTranscriptOptionalParams)];
+                        return [4 /*yield*/, this.withRequestSessionKey(requestSessionKey, function () { return _this.OCClient.emailTranscript(requestId, chatToken.token, emailRequestBody_1, emailTranscriptOptionalParams); })];
                     case 2:
                         _b.sent();
-                        if (this.sessionId) {
-                            this.OCClient.sessionId = this.sessionId;
-                        }
                         this.scenarioMarker.completeScenario(TelemetryEvent_1.default.EmailLiveChatTranscript, {
                             RequestId: requestId,
                             ChatId: chatId
@@ -2693,7 +2877,8 @@ var OmnichannelChatSDK = /** @class */ (function () {
     };
     OmnichannelChatSDK.prototype.getLiveChatTranscript = function () {
         return __awaiter(this, arguments, void 0, function (optionalParams) {
-            var getChatTranscriptOptionalParams, requestId, chatToken, chatId, sessionId, transcriptResponse, error_28, telemetryData;
+            var getChatTranscriptOptionalParams, requestId, chatToken, chatId, requestSessionKey, transcriptResponse, error_28, telemetryData;
+            var _this = this;
             var _a, _b;
             if (optionalParams === void 0) { optionalParams = {}; }
             return __generator(this, function (_c) {
@@ -2703,7 +2888,6 @@ var OmnichannelChatSDK = /** @class */ (function () {
                         requestId = this.requestId;
                         chatToken = this.chatToken;
                         chatId = chatToken.chatId;
-                        sessionId = this.sessionId;
                         if (optionalParams.liveChatContext) {
                             if (this.isPersistentChat && !((_a = this.chatSDKConfig.persistentChat) === null || _a === void 0 ? void 0 : _a.disable)) {
                                 requestId = this.requestId || optionalParams.liveChatContext.requestId;
@@ -2715,10 +2899,6 @@ var OmnichannelChatSDK = /** @class */ (function () {
                             }
                             chatId = chatToken.chatId;
                         }
-                        if ((_b = optionalParams.liveChatContext) === null || _b === void 0 ? void 0 : _b.sessionId) {
-                            sessionId = optionalParams.liveChatContext.sessionId;
-                            this.OCClient.sessionId = sessionId;
-                        }
                         if (!chatId) {
                             throw new ChatSDKError_1.ChatSDKError(ChatSDKError_1.ChatSDKErrorName.LiveChatTranscriptRetrievalFailure, undefined, {
                                 response: ChatSDKError_1.ChatSDKErrorName.LiveChatTranscriptRetrievalFailure,
@@ -2732,18 +2912,16 @@ var OmnichannelChatSDK = /** @class */ (function () {
                         if (!this.isInitialized) {
                             exceptionThrowers_1.default.throwUninitializedChatSDK(this.scenarioMarker, TelemetryEvent_1.default.GetLiveChatTranscript);
                         }
+                        requestSessionKey = ((_b = optionalParams.liveChatContext) === null || _b === void 0 ? void 0 : _b.sessionId) || this.getEndedChatSessionKey(chatId);
                         _c.label = 1;
                     case 1:
                         _c.trys.push([1, 3, , 4]);
                         if (this.authenticatedUserToken) {
                             getChatTranscriptOptionalParams.authenticatedUserToken = this.authenticatedUserToken;
                         }
-                        return [4 /*yield*/, this.OCClient.getChatTranscripts(requestId, chatToken.chatId, chatToken.token, getChatTranscriptOptionalParams)];
+                        return [4 /*yield*/, this.withRequestSessionKey(requestSessionKey, function () { return _this.OCClient.getChatTranscripts(requestId, chatToken.chatId, chatToken.token, getChatTranscriptOptionalParams); })];
                     case 2:
                         transcriptResponse = _c.sent();
-                        if (this.sessionId) {
-                            this.OCClient.sessionId = this.sessionId;
-                        }
                         this.scenarioMarker.completeScenario(TelemetryEvent_1.default.GetLiveChatTranscript, {
                             RequestId: requestId,
                             ChatId: chatId
@@ -2762,6 +2940,30 @@ var OmnichannelChatSDK = /** @class */ (function () {
             });
         });
     };
+    /**
+     * Returns the ended chat's session key when the call targets that chat, or null.
+     */
+    OmnichannelChatSDK.prototype.getEndedChatSessionKey = function (chatId) {
+        var _a;
+        return chatId && ((_a = this.endedChatSessionKey) === null || _a === void 0 ? void 0 : _a.chatId) === chatId ? this.endedChatSessionKey.sessionId : null;
+    };
+    /**
+     * Sends the session key on one OCSDK request without leaving it on the shared client. OCSDK copies the
+     * key into the request headers before its first await, so the previous key is restored before the HTTP wait.
+     */
+    OmnichannelChatSDK.prototype.withRequestSessionKey = function (sessionKey, request) {
+        if (!sessionKey) {
+            return request();
+        }
+        var previousSessionKey = this.OCClient.sessionId;
+        this.OCClient.sessionId = sessionKey;
+        try {
+            return request();
+        }
+        finally {
+            this.OCClient.sessionId = previousSessionKey;
+        }
+    };
     OmnichannelChatSDK.prototype.createChatAdapter = function () {
         return __awaiter(this, arguments, void 0, function (optionalParams) {
             var protocol, supportedChatAdapterProtocols, options, fileManager;