@microsoft/omnichannel-chat-sdk 1.3.1-main.2674439 → 1.3.1-main.9823ada

package/lib/OmnichannelChatSDK.js

@@ -87,6 +87,7 @@ var createOmnichannelMessage_1 = require("./utils/createOmnichannelMessage");
 var createTelemetry_1 = require("./utils/createTelemetry");
 var createVoiceVideoCalling_1 = require("./api/createVoiceVideoCalling");
 var MessageTags_1 = require("./core/messaging/MessageTags");
+var exceptionThrowers_1 = require("./utils/exceptionThrowers");
 var location_1 = require("./utils/location");
 var utilities_1 = require("./utils/utilities");
 var urlResolvers_1 = require("./utils/urlResolvers");
@@ -113,7 +114,7 @@ var OmnichannelChatSDK = /** @class */ (function () {
         this.isChatReconnect = false;
         this.reconnectId = null;
         this.refreshTokenTimer = null;
-        this.populateInitChatOptionalParam = function (requestOptionalParams, optionalParams) {
+        this.populateInitChatOptionalParam = function (requestOptionalParams, optionalParams, telemetryEvent) {
             requestOptionalParams.initContext.locale = locale_1.getLocaleStringFromId(_this.localeId);
             if (optionalParams.customContext) {
                 requestOptionalParams.initContext.customContextData = optionalParams.customContext; // eslint-disable-line @typescript-eslint/no-explicit-any
@@ -138,17 +139,12 @@ var OmnichannelChatSDK = /** @class */ (function () {
             }
             if (optionalParams.sendDefaultInitContext) {
                 if (platform_1.default.isNode() || platform_1.default.isReactNative()) {
-                    var exceptionDetails = {
-                        response: ChatSDKErrors_1.default.UnsupportedPlatform,
-                        message: "sendDefaultInitContext is only supported on browser"
-                    };
-                    console.error(exceptionDetails.message);
-                    _this.scenarioMarker.failScenario(TelemetryEvent_1.default.GetAgentAvailability, {
+                    var message = "sendDefaultInitContext is only supported on browser";
+                    var telemetryData = {
                         RequestId: _this.requestId,
-                        ChatId: _this.chatToken.chatId,
-                        ExceptionDetails: JSON.stringify(exceptionDetails)
-                    });
-                    throw new Error(exceptionDetails.response);
+                        ChatId: _this.chatToken.chatId
+                    };
+                    exceptionThrowers_1.default.throwUnsupportedPlatform(_this.scenarioMarker, telemetryEvent, message, telemetryData);
                 }
                 requestOptionalParams.getContext = true;
             }
@@ -231,7 +227,7 @@ var OmnichannelChatSDK = /** @class */ (function () {
     OmnichannelChatSDK.prototype.initialize = function (optionalParams) {
         if (optionalParams === void 0) { optionalParams = {}; }
         return __awaiter(this, void 0, void 0, function () {
-            var _a, getLiveChatConfigOptionalParams, _b, _c, e_1;
+            var _a, e_1, getLiveChatConfigOptionalParams, e_2, supportedLiveChatVersions, _b, _c, e_3;
             return __generator(this, function (_d) {
                 switch (_d.label) {
                     case 0:
@@ -242,17 +238,37 @@ var OmnichannelChatSDK = /** @class */ (function () {
                         }
                         _d.label = 1;
                     case 1:
-                        _d.trys.push([1, 9, , 10]);
+                        _d.trys.push([1, 3, , 4]);
                         this.OCSDKProvider = ocsdk_1.SDKProvider;
                         _a = this;
                         return [4 /*yield*/, ocsdk_1.SDKProvider.getSDK(this.omnichannelConfig, {}, this.ocSdkLogger)];
                     case 2:
                         _a.OCClient = _d.sent();
+                        return [3 /*break*/, 4];
+                    case 3:
+                        e_1 = _d.sent();
+                        exceptionThrowers_1.default.throwOmnichannelClientInitializationFailure(e_1, this.scenarioMarker, TelemetryEvent_1.default.InitializeChatSDK);
+                        return [3 /*break*/, 4];
+                    case 4:
+                        _d.trys.push([4, 6, , 7]);
                         getLiveChatConfigOptionalParams = optionalParams.getLiveChatConfigOptionalParams;
                         return [4 /*yield*/, this.getChatConfig(getLiveChatConfigOptionalParams || {})];
-                    case 3:
+                    case 5:
                         _d.sent();
-                        if (!(this.liveChatVersion === LiveChatVersion_1.default.V2)) return [3 /*break*/, 5];
+                        return [3 /*break*/, 7];
+                    case 6:
+                        e_2 = _d.sent();
+                        exceptionThrowers_1.default.throwChatConfigRetrievalFailure(e_2, this.scenarioMarker, TelemetryEvent_1.default.InitializeChatSDK);
+                        return [3 /*break*/, 7];
+                    case 7:
+                        supportedLiveChatVersions = [LiveChatVersion_1.default.V1, LiveChatVersion_1.default.V2];
+                        if (!supportedLiveChatVersions.includes(this.liveChatVersion)) {
+                            exceptionThrowers_1.default.throwUnsupportedLiveChatVersionFailure(new Error(ChatSDKErrors_1.default.UnsupportedLiveChatVersion), this.scenarioMarker, TelemetryEvent_1.default.InitializeChatSDK);
+                        }
+                        _d.label = 8;
+                    case 8:
+                        _d.trys.push([8, 13, , 14]);
+                        if (!(this.liveChatVersion === LiveChatVersion_1.default.V2)) return [3 /*break*/, 10];
                         this.ACSClient = new ACSClient_1.default(this.acsClientLogger);
                         _b = this;
                         return [4 /*yield*/, omnichannel_amsclient_1.default({
@@ -261,28 +277,25 @@ var OmnichannelChatSDK = /** @class */ (function () {
                                 debug: false,
                                 logger: this.amsClientLogger
                             })];
-                    case 4:
+                    case 9:
                         _b.AMSClient = _d.sent();
-                        return [3 /*break*/, 8];
-                    case 5:
-                        if (!(this.liveChatVersion === LiveChatVersion_1.default.V1)) return [3 /*break*/, 7];
+                        return [3 /*break*/, 12];
+                    case 10:
+                        if (!(this.liveChatVersion === LiveChatVersion_1.default.V1)) return [3 /*break*/, 12];
                         _c = this;
                         return [4 /*yield*/, this.getIC3Client()];
-                    case 6:
+                    case 11:
                         _c.IC3Client = _d.sent();
-                        return [3 /*break*/, 8];
-                    case 7: throw new Error("Unsupported LiveChatVersion");
-                    case 8:
+                        _d.label = 12;
+                    case 12:
                         this.isInitialized = true;
                         this.scenarioMarker.completeScenario(TelemetryEvent_1.default.InitializeChatSDK);
-                        return [3 /*break*/, 10];
-                    case 9:
-                        e_1 = _d.sent();
-                        this.scenarioMarker.failScenario(TelemetryEvent_1.default.InitializeChatSDK, {
-                            ExceptionDetails: JSON.stringify(e_1)
-                        });
-                        return [3 /*break*/, 10];
-                    case 10: return [2 /*return*/, this.liveChatConfig];
+                        return [3 /*break*/, 14];
+                    case 13:
+                        e_3 = _d.sent();
+                        exceptionThrowers_1.default.throwMessagingClientCreationFailure(e_3, this.scenarioMarker, TelemetryEvent_1.default.InitializeChatSDK);
+                        return [3 /*break*/, 14];
+                    case 14: return [2 /*return*/, this.liveChatConfig];
                 }
             });
         });
@@ -375,116 +388,108 @@ var OmnichannelChatSDK = /** @class */ (function () {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v;
         if (optionalParams === void 0) { optionalParams = {}; }
         return __awaiter(this, void 0, void 0, function () {
-            var shouldReinitIC3Client, _w, reconnectableChatsParams, reconnectableChatsResponse, _x, exceptionDetails, conversationDetails, exceptionDetails, exceptionDetails, _y, exceptionDetails, sessionInitOptionalParams, location_2, error_3, exceptionDetails, chatAdapterConfig, error_4, exceptionDetails, _z, error_5, exceptionDetails, error_6, exceptionDetails, error_7, exceptionDetails, _0, error_8, exceptionDetails;
+            var shouldReinitIC3Client, _w, reconnectableChatsParams, reconnectableChatsResponse, e_4, telemetryData, conversationDetails, telemetryData, telemetryData, e_5, telemetryData, sessionInitOptionalParams, location_2, error_3, telemetryData, chatAdapterConfig, error_4, telemetryData, _x, error_5, telemetryData, error_6, telemetryData, error_7, telemetryData, _y, error_8, telemetryData;
             var _this = this;
-            return __generator(this, function (_1) {
-                switch (_1.label) {
+            return __generator(this, function (_z) {
+                switch (_z.label) {
                     case 0:
                         this.scenarioMarker.startScenario(TelemetryEvent_1.default.StartChat, {
                             RequestId: this.requestId
                         });
+                        if (!this.isInitialized) {
+                            exceptionThrowers_1.default.throwUninitializedChatSDK(this.scenarioMarker, TelemetryEvent_1.default.StartChat);
+                        }
                         shouldReinitIC3Client = !platform_1.default.isNode() && !platform_1.default.isReactNative() && !this.IC3Client && this.liveChatVersion === LiveChatVersion_1.default.V1;
                         if (!shouldReinitIC3Client) return [3 /*break*/, 2];
                         _w = this;
                         return [4 /*yield*/, this.getIC3Client()];
                     case 1:
-                        _w.IC3Client = _1.sent();
-                        _1.label = 2;
+                        _w.IC3Client = _z.sent();
+                        _z.label = 2;
                     case 2:
                         if (this.isChatReconnect && !((_a = this.chatSDKConfig.chatReconnect) === null || _a === void 0 ? void 0 : _a.disable) && !this.isPersistentChat && optionalParams.reconnectId) {
                             this.reconnectId = optionalParams.reconnectId;
                         }
                         if (!(this.isPersistentChat && !((_b = this.chatSDKConfig.persistentChat) === null || _b === void 0 ? void 0 : _b.disable))) return [3 /*break*/, 6];
-                        _1.label = 3;
+                        _z.label = 3;
                     case 3:
-                        _1.trys.push([3, 5, , 6]);
+                        _z.trys.push([3, 5, , 6]);
                         reconnectableChatsParams = {
                             authenticatedUserToken: this.authenticatedUserToken
                         };
                         return [4 /*yield*/, this.OCClient.getReconnectableChats(reconnectableChatsParams)];
                     case 4:
-                        reconnectableChatsResponse = _1.sent();
+                        reconnectableChatsResponse = _z.sent();
                         if (reconnectableChatsResponse && reconnectableChatsResponse.reconnectid) {
                             this.reconnectId = reconnectableChatsResponse.reconnectid;
                         }
                         return [3 /*break*/, 6];
                     case 5:
-                        _x = _1.sent();
-                        exceptionDetails = {
-                            response: "OCClientGetReconnectableChatsFailed"
+                        e_4 = _z.sent();
+                        telemetryData = {
+                            RequestId: this.requestId,
+                            ChatId: this.chatToken.chatId,
                         };
-                        throw Error(exceptionDetails.response);
+                        exceptionThrowers_1.default.throwPersistentChatConversationRetrievalFailure(e_4, this.scenarioMarker, TelemetryEvent_1.default.StartChat, telemetryData);
+                        return [3 /*break*/, 6];
                     case 6:
                         if (!(optionalParams.liveChatContext && Object.keys(optionalParams.liveChatContext).length > 0 && !this.reconnectId)) return [3 /*break*/, 8];
                         this.chatToken = optionalParams.liveChatContext.chatToken || {};
                         this.requestId = optionalParams.liveChatContext.requestId || ocsdk_1.uuidv4();
                         return [4 /*yield*/, this.getConversationDetails()];
                     case 7:
-                        conversationDetails = _1.sent();
+                        conversationDetails = _z.sent();
                         if (Object.keys(conversationDetails).length === 0) {
-                            exceptionDetails = {
-                                response: "InvalidConversation"
-                            };
-                            this.scenarioMarker.failScenario(TelemetryEvent_1.default.StartChat, {
+                            telemetryData = {
                                 RequestId: this.requestId,
                                 ChatId: this.chatToken.chatId,
-                                ExceptionDetails: JSON.stringify(exceptionDetails)
-                            });
-                            console.error("Conversation not found");
-                            throw Error(exceptionDetails.response);
+                            };
+                            exceptionThrowers_1.default.throwInvalidConversation(this.scenarioMarker, TelemetryEvent_1.default.StartChat, telemetryData);
                         }
                         if (conversationDetails.state === LiveWorkItemState_1.default.WrapUp || conversationDetails.state === LiveWorkItemState_1.default.Closed) {
-                            exceptionDetails = {
-                                response: "ClosedConversation"
-                            };
-                            this.scenarioMarker.failScenario(TelemetryEvent_1.default.StartChat, {
+                            console.error("Unable to join conversation that's in '" + conversationDetails.state + "' state");
+                            telemetryData = {
                                 RequestId: this.requestId,
                                 ChatId: this.chatToken.chatId,
-                                ExceptionDetails: JSON.stringify(exceptionDetails)
-                            });
-                            console.error("Unable to join conversation that's in '" + conversationDetails.state + "' state");
-                            throw Error(exceptionDetails.response);
+                            };
+                            exceptionThrowers_1.default.throwClosedConversation(this.scenarioMarker, TelemetryEvent_1.default.StartChat, telemetryData);
                         }
-                        _1.label = 8;
+                        _z.label = 8;
                     case 8:
                         if (!this.authSettings) return [3 /*break*/, 14];
                         if (!!this.authenticatedUserToken) return [3 /*break*/, 10];
                         return [4 /*yield*/, this.setAuthTokenProvider(this.chatSDKConfig.getAuthToken)];
                     case 9:
-                        _1.sent();
-                        _1.label = 10;
+                        _z.sent();
+                        _z.label = 10;
                     case 10:
                         if (!(optionalParams.liveChatContext && Object.keys(optionalParams.liveChatContext).length > 0)) return [3 /*break*/, 14];
                         this.chatToken = optionalParams.liveChatContext.chatToken || {};
                         this.requestId = optionalParams.liveChatContext.requestId || ocsdk_1.uuidv4();
-                        _1.label = 11;
+                        _z.label = 11;
                     case 11:
-                        _1.trys.push([11, 13, , 14]);
+                        _z.trys.push([11, 13, , 14]);
                         return [4 /*yield*/, this.OCClient.validateAuthChatRecord(this.requestId, {
                                 authenticatedUserToken: this.authenticatedUserToken,
                                 chatId: this.chatToken.chatId
                             })];
                     case 12:
-                        _1.sent();
+                        _z.sent();
                         return [3 /*break*/, 14];
                     case 13:
-                        _y = _1.sent();
-                        exceptionDetails = {
-                            response: "OCClientValidateAuthChatRecordFailed",
-                            message: "InvalidAuthChatRecord"
-                        };
-                        this.scenarioMarker.failScenario(TelemetryEvent_1.default.StartChat, {
+                        e_5 = _z.sent();
+                        telemetryData = {
                             RequestId: this.requestId,
                             ChatId: this.chatToken.chatId,
-                            ExceptionDetails: JSON.stringify(exceptionDetails)
-                        });
-                        throw Error(exceptionDetails.response);
+                        };
+                        exceptionThrowers_1.default.throwAuthenticatedChatConversationRetrievalFailure(e_5, this.scenarioMarker, TelemetryEvent_1.default.StartChat, telemetryData);
+                        return [3 /*break*/, 14];
                     case 14:
                         if (!(this.chatToken && Object.keys(this.chatToken).length === 0)) return [3 /*break*/, 16];
                         return [4 /*yield*/, this.getChatToken(false)];
                     case 15:
-                        _1.sent();
-                        _1.label = 16;
+                        _z.sent();
+                        _z.label = 16;
                     case 16:
                         (_c = this.ic3ClientLogger) === null || _c === void 0 ? void 0 : _c.setChatId(this.chatToken.chatId || '');
                         (_d = this.ocSdkLogger) === null || _d === void 0 ? void 0 : _d.setChatId(this.chatToken.chatId || '');
@@ -495,7 +500,7 @@ var OmnichannelChatSDK = /** @class */ (function () {
                         sessionInitOptionalParams = {
                             initContext: {}
                         };
-                        sessionInitOptionalParams = this.populateInitChatOptionalParam(sessionInitOptionalParams, optionalParams);
+                        sessionInitOptionalParams = this.populateInitChatOptionalParam(sessionInitOptionalParams, optionalParams, TelemetryEvent_1.default.StartChat);
                         sessionInitOptionalParams.initContext.isProactiveChat = !!optionalParams.isProactiveChat;
                         if (this.isPersistentChat && !((_j = this.chatSDKConfig.persistentChat) === null || _j === void 0 ? void 0 : _j.disable)) {
                             sessionInitOptionalParams.reconnectId = this.reconnectId;
@@ -506,36 +511,31 @@ var OmnichannelChatSDK = /** @class */ (function () {
                         if (!(((_m = (_l = this.liveChatConfig) === null || _l === void 0 ? void 0 : _l.LiveWSAndLiveChatEngJoin) === null || _m === void 0 ? void 0 : _m.msdyn_requestvisitorlocation) === "true")) return [3 /*break*/, 18];
                         return [4 /*yield*/, location_1.getLocationInfo(this.scenarioMarker, this.chatToken.chatId, this.requestId)];
                     case 17:
-                        location_2 = _1.sent();
+                        location_2 = _z.sent();
                         sessionInitOptionalParams.initContext.latitude = location_2.latitude;
                         sessionInitOptionalParams.initContext.longitude = location_2.longitude;
-                        _1.label = 18;
+                        _z.label = 18;
                     case 18:
                         if (!!optionalParams.liveChatContext) return [3 /*break*/, 22];
-                        _1.label = 19;
+                        _z.label = 19;
                     case 19:
-                        _1.trys.push([19, 21, , 22]);
+                        _z.trys.push([19, 21, , 22]);
                         return [4 /*yield*/, this.OCClient.sessionInit(this.requestId, sessionInitOptionalParams)];
                     case 20:
-                        _1.sent();
+                        _z.sent();
                         return [3 /*break*/, 22];
                     case 21:
-                        error_3 = _1.sent();
-                        exceptionDetails = {
-                            response: "OCClientSessionInitFailed"
+                        error_3 = _z.sent();
+                        telemetryData = {
+                            RequestId: this.requestId,
+                            ChatId: this.chatToken.chatId,
                         };
                         // eslint-disable-next-line @typescript-eslint/no-explicit-any
                         if (((_o = error_3) === null || _o === void 0 ? void 0 : _o.isAxiosError) && ((_q = (_p = error_3.response) === null || _p === void 0 ? void 0 : _p.headers) === null || _q === void 0 ? void 0 : _q.errorcode.toString()) === OmnichannelErrorCodes_1.default.WidgetUseOutsideOperatingHour.toString()) {
-                            exceptionDetails.response = OmnichannelErrorCodes_1.default[OmnichannelErrorCodes_1.default.WidgetUseOutsideOperatingHour].toString();
-                            exceptionDetails.message = 'Widget used outside of operating hours';
-                            console.error(exceptionDetails.message);
+                            exceptionThrowers_1.default.throwWidgetUseOutsideOperatingHour(error_3, this.scenarioMarker, TelemetryEvent_1.default.StartChat, telemetryData);
                         }
-                        this.scenarioMarker.failScenario(TelemetryEvent_1.default.StartChat, {
-                            RequestId: this.requestId,
-                            ChatId: this.chatToken.chatId,
-                            ExceptionDetails: JSON.stringify(exceptionDetails)
-                        });
-                        throw new Error(exceptionDetails.response);
+                        exceptionThrowers_1.default.throwConversationInitializationFailure(error_3, this.scenarioMarker, TelemetryEvent_1.default.StartChat, telemetryData);
+                        return [3 /*break*/, 22];
                     case 22:
                         if (!(this.liveChatVersion === LiveChatVersion_1.default.V2)) return [3 /*break*/, 33];
                         chatAdapterConfig = {
@@ -545,120 +545,101 @@ var OmnichannelChatSDK = /** @class */ (function () {
                             environmentUrl: this.chatToken.acsEndpoint,
                             pollingInterval: 30000
                         };
-                        _1.label = 23;
+                        _z.label = 23;
                     case 23:
-                        _1.trys.push([23, 25, , 26]);
+                        _z.trys.push([23, 25, , 26]);
                         return [4 /*yield*/, ((_r = this.ACSClient) === null || _r === void 0 ? void 0 : _r.initialize({
                                 token: chatAdapterConfig.token,
                                 environmentUrl: chatAdapterConfig.environmentUrl
                             }))];
                     case 24:
-                        _1.sent();
+                        _z.sent();
                         return [3 /*break*/, 26];
                     case 25:
-                        error_4 = _1.sent();
-                        exceptionDetails = {
-                            response: "ACSClientInitializeFailed"
-                        };
-                        this.scenarioMarker.failScenario(TelemetryEvent_1.default.StartChat, {
+                        error_4 = _z.sent();
+                        telemetryData = {
                             RequestId: this.requestId,
                             ChatId: this.chatToken.chatId,
-                            ExceptionDetails: JSON.stringify(exceptionDetails)
-                        });
-                        console.error("OmnichannelChatSDK/startChat/initialize/error " + error_4);
-                        return [2 /*return*/, error_4];
+                        };
+                        exceptionThrowers_1.default.throwMessagingClientInitializationFailure(error_4, this.scenarioMarker, TelemetryEvent_1.default.StartChat, telemetryData);
+                        return [3 /*break*/, 26];
                     case 26:
-                        _1.trys.push([26, 28, , 29]);
-                        _z = this;
+                        _z.trys.push([26, 28, , 29]);
+                        _x = this;
                         return [4 /*yield*/, ((_s = this.ACSClient) === null || _s === void 0 ? void 0 : _s.joinConversation({
                                 id: chatAdapterConfig.id,
                                 threadId: chatAdapterConfig.threadId,
                                 pollingInterval: chatAdapterConfig.pollingInterval
                             }))];
                     case 27:
-                        _z.conversation = (_1.sent());
+                        _x.conversation = (_z.sent());
                         this.scenarioMarker.completeScenario(TelemetryEvent_1.default.StartChat, {
                             RequestId: this.requestId,
                             ChatId: this.chatToken.chatId
                         });
                         return [3 /*break*/, 29];
                     case 28:
-                        error_5 = _1.sent();
-                        exceptionDetails = {
-                            response: "ACSClientJoinConversationFailed"
-                        };
-                        this.scenarioMarker.failScenario(TelemetryEvent_1.default.StartChat, {
+                        error_5 = _z.sent();
+                        telemetryData = {
                             RequestId: this.requestId,
                             ChatId: this.chatToken.chatId,
-                            ExceptionDetails: JSON.stringify(exceptionDetails)
-                        });
-                        console.error("OmnichannelChatSDK/startChat/joinConversation/error " + error_5);
-                        throw Error(exceptionDetails.response);
+                        };
+                        exceptionThrowers_1.default.throwMessagingClientConversationJoinFailure(error_5, this.scenarioMarker, TelemetryEvent_1.default.StartChat, telemetryData);
+                        return [3 /*break*/, 29];
                     case 29:
-                        _1.trys.push([29, 31, , 32]);
+                        _z.trys.push([29, 31, , 32]);
                         return [4 /*yield*/, ((_t = this.AMSClient) === null || _t === void 0 ? void 0 : _t.initialize({
                                 chatToken: this.chatToken
                             }))];
                     case 30:
-                        _1.sent();
+                        _z.sent();
                         return [3 /*break*/, 32];
                     case 31:
-                        error_6 = _1.sent();
-                        exceptionDetails = {
-                            response: "AMSClientInitializeFailed"
-                        };
-                        this.scenarioMarker.failScenario(TelemetryEvent_1.default.StartChat, {
+                        error_6 = _z.sent();
+                        telemetryData = {
                             RequestId: this.requestId,
                             ChatId: this.chatToken.chatId,
-                            ExceptionDetails: JSON.stringify(exceptionDetails)
-                        });
-                        throw Error(exceptionDetails.response);
+                        };
+                        exceptionThrowers_1.default.throwMessagingClientInitializationFailure(error_6, this.scenarioMarker, TelemetryEvent_1.default.StartChat, telemetryData);
+                        return [3 /*break*/, 32];
                     case 32: return [3 /*break*/, 39];
                     case 33:
-                        _1.trys.push([33, 35, , 36]);
+                        _z.trys.push([33, 35, , 36]);
                         return [4 /*yield*/, this.IC3Client.initialize({
                                 token: this.chatToken.token,
                                 regionGtms: this.chatToken.regionGTMS,
                                 visitor: true
                             })];
                     case 34:
-                        _1.sent();
+                        _z.sent();
                         return [3 /*break*/, 36];
                     case 35:
-                        error_7 = _1.sent();
-                        exceptionDetails = {
-                            response: "IC3ClientInitializeFailed"
-                        };
-                        this.scenarioMarker.failScenario(TelemetryEvent_1.default.StartChat, {
+                        error_7 = _z.sent();
+                        telemetryData = {
                             RequestId: this.requestId,
                             ChatId: this.chatToken.chatId,
-                            ExceptionDetails: JSON.stringify(exceptionDetails)
-                        });
-                        console.error("OmnichannelChatSDK/startChat/initialize/error " + error_7);
-                        return [2 /*return*/, error_7];
+                        };
+                        exceptionThrowers_1.default.throwMessagingClientInitializationFailure(error_7, this.scenarioMarker, TelemetryEvent_1.default.StartChat, telemetryData);
+                        return [3 /*break*/, 36];
                     case 36:
-                        _1.trys.push([36, 38, , 39]);
-                        _0 = this;
+                        _z.trys.push([36, 38, , 39]);
+                        _y = this;
                         return [4 /*yield*/, this.IC3Client.joinConversation(this.chatToken.chatId)];
                     case 37:
-                        _0.conversation = _1.sent();
+                        _y.conversation = _z.sent();
                         this.scenarioMarker.completeScenario(TelemetryEvent_1.default.StartChat, {
                             RequestId: this.requestId,
                             ChatId: this.chatToken.chatId
                         });
                         return [3 /*break*/, 39];
                     case 38:
-                        error_8 = _1.sent();
-                        exceptionDetails = {
-                            response: "IC3ClientJoinConversationFailed"
-                        };
-                        this.scenarioMarker.failScenario(TelemetryEvent_1.default.StartChat, {
+                        error_8 = _z.sent();
+                        telemetryData = {
                             RequestId: this.requestId,
                             ChatId: this.chatToken.chatId,
-                            ExceptionDetails: JSON.stringify(exceptionDetails)
-                        });
-                        console.error("OmnichannelChatSDK/startChat/joinConversation/error " + error_8);
-                        return [2 /*return*/, error_8];
+                        };
+                        exceptionThrowers_1.default.throwMessagingClientConversationJoinFailure(error_8, this.scenarioMarker, TelemetryEvent_1.default.StartChat, telemetryData);
+                        return [3 /*break*/, 39];
                     case 39:
                         if (this.isPersistentChat && !((_u = this.chatSDKConfig.persistentChat) === null || _u === void 0 ? void 0 : _u.disable)) {
                             this.refreshTokenTimer = setInterval(function () { return __awaiter(_this, void 0, void 0, function () {
@@ -681,7 +662,7 @@ var OmnichannelChatSDK = /** @class */ (function () {
     OmnichannelChatSDK.prototype.endChat = function () {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q;
         return __awaiter(this, void 0, void 0, function () {
-            var sessionCloseOptionalParams, isReconnectChat, isChatReconnect, error_9, exceptionDetails;
+            var sessionCloseOptionalParams, isReconnectChat, isChatReconnect, error_9, telemetryData;
             return __generator(this, function (_r) {
                 switch (_r.label) {
                     case 0:
@@ -738,16 +719,12 @@ var OmnichannelChatSDK = /** @class */ (function () {
                         return [3 /*break*/, 4];
                     case 3:
                         error_9 = _r.sent();
-                        exceptionDetails = {
-                            response: "OCClientSessionCloseFailed"
-                        };
-                        this.scenarioMarker.failScenario(TelemetryEvent_1.default.EndChat, {
+                        telemetryData = {
                             RequestId: this.requestId,
-                            ChatId: this.chatToken.chatId,
-                            ExceptionDetails: JSON.stringify(exceptionDetails),
-                        });
-                        console.error("OmnichannelChatSDK/endChat/error " + error_9);
-                        return [2 /*return*/, error_9];
+                            ChatId: this.chatToken.chatId
+                        };
+                        exceptionThrowers_1.default.throwConversationClosureFailure(error_9, this.scenarioMarker, TelemetryEvent_1.default.EndChat, telemetryData);
+                        return [3 /*break*/, 4];
                     case 4:
                         if (this.refreshTokenTimer !== null) {
                             clearInterval(this.refreshTokenTimer);
@@ -790,7 +767,7 @@ var OmnichannelChatSDK = /** @class */ (function () {
     OmnichannelChatSDK.prototype.getConversationDetails = function () {
         var _a, _b, _c, _d;
         return __awaiter(this, void 0, void 0, function () {
-            var getLWIDetailsOptionalParams, lwiDetails, state, conversationId, agentAcceptedOn, canRenderPostChat, participantType, liveWorkItemDetails, error_10;
+            var getLWIDetailsOptionalParams, lwiDetails, state, conversationId, agentAcceptedOn, canRenderPostChat, participantType, liveWorkItemDetails, error_10, exceptionDetails;
             return __generator(this, function (_e) {
                 switch (_e.label) {
                     case 0:
@@ -835,11 +812,15 @@ var OmnichannelChatSDK = /** @class */ (function () {
                         return [2 /*return*/, liveWorkItemDetails];
                     case 3:
                         error_10 = _e.sent();
+                        exceptionDetails = {
+                            response: ChatSDKErrors_1.default.ConversationDetailsRetrievalFailure,
+                            errorObject: "" + error_10
+                        };
                         this.scenarioMarker.failScenario(TelemetryEvent_1.default.GetConversationDetails, {
                             RequestId: this.requestId,
                             ChatId: this.chatToken.chatId || '',
+                            ExceptionDetails: JSON.stringify(exceptionDetails)
                         });
-                        console.error("OmnichannelChatSDK/getConversationDetails/error " + error_10);
                         return [3 /*break*/, 4];
                     case 4: return [2 /*return*/, {}];
                 }
@@ -879,20 +860,20 @@ var OmnichannelChatSDK = /** @class */ (function () {
         });
     };
     OmnichannelChatSDK.prototype.getChatToken = function (cached) {
-        var _a, _b;
+        var _a, _b, _c;
         if (cached === void 0) { cached = true; }
         return __awaiter(this, void 0, void 0, function () {
-            var getChatTokenOptionalParams, chatToken, chatId, token, regionGtms, expiresIn, visitorId, voiceVideoCallToken, acsEndpoint, attachmentConfiguration, error_11, exceptionDetails;
-            return __generator(this, function (_c) {
-                switch (_c.label) {
+            var getChatTokenOptionalParams, chatToken, chatId, token, regionGtms, expiresIn, visitorId, voiceVideoCallToken, acsEndpoint, attachmentConfiguration, error_11, telemetryData;
+            return __generator(this, function (_d) {
+                switch (_d.label) {
                     case 0:
                         this.scenarioMarker.startScenario(TelemetryEvent_1.default.GetChatToken, {
                             RequestId: this.requestId
                         });
                         if (!!cached) return [3 /*break*/, 5];
-                        _c.label = 1;
+                        _d.label = 1;
                     case 1:
-                        _c.trys.push([1, 3, , 4]);
+                        _d.trys.push([1, 3, , 4]);
                         getChatTokenOptionalParams = {};
                         if (this.authenticatedUserToken) {
                             getChatTokenOptionalParams.authenticatedUserToken = this.authenticatedUserToken;
@@ -905,7 +886,7 @@ var OmnichannelChatSDK = /** @class */ (function () {
                         }
                         return [4 /*yield*/, this.OCClient.getChatToken(this.requestId, getChatTokenOptionalParams)];
                     case 2:
-                        chatToken = _c.sent();
+                        chatToken = _d.sent();
                         chatId = chatToken.ChatId, token = chatToken.Token, regionGtms = chatToken.RegionGtms, expiresIn = chatToken.ExpiresIn, visitorId = chatToken.VisitorId, voiceVideoCallToken = chatToken.VoiceVideoCallToken, acsEndpoint = chatToken.ACSEndpoint, attachmentConfiguration = chatToken.AttachmentConfiguration;
                         this.chatToken = {
                             chatId: chatId,
@@ -926,16 +907,12 @@ var OmnichannelChatSDK = /** @class */ (function () {
                         });
                         return [3 /*break*/, 4];
                     case 3:
-                        error_11 = _c.sent();
-                        exceptionDetails = {
-                            response: "OCClientGetChatTokenFailed"
-                        };
-                        this.scenarioMarker.failScenario(TelemetryEvent_1.default.GetChatToken, {
+                        error_11 = _d.sent();
+                        telemetryData = {
                             RequestId: this.requestId,
-                            ChatId: this.chatToken.chatId,
-                            ExceptionDetails: JSON.stringify(exceptionDetails),
-                        });
-                        console.error("OmnichannelChatSDK/getChatToken/error " + error_11);
+                            ChatId: (_c = this.chatToken) === null || _c === void 0 ? void 0 : _c.chatId,
+                        };
+                        exceptionThrowers_1.default.throwChatTokenRetrievalFailure(error_11, this.scenarioMarker, TelemetryEvent_1.default.GetChatToken, telemetryData);
                         return [3 /*break*/, 4];
                     case 4: return [3 /*break*/, 6];
                     case 5:
@@ -943,7 +920,7 @@ var OmnichannelChatSDK = /** @class */ (function () {
                             RequestId: this.requestId,
                             ChatId: this.chatToken.chatId
                         });
-                        _c.label = 6;
+                        _d.label = 6;
                     case 6: return [2 /*return*/, this.chatToken];
                 }
             });
@@ -1610,31 +1587,41 @@ var OmnichannelChatSDK = /** @class */ (function () {
             });
         });
     };
-    OmnichannelChatSDK.prototype.getLiveChatTranscript = function () {
+    OmnichannelChatSDK.prototype.getLiveChatTranscript = function (optionalParams) {
+        if (optionalParams === void 0) { optionalParams = {}; }
         return __awaiter(this, void 0, void 0, function () {
-            var getChatTranscriptOptionalParams, transcriptResponse;
+            var getChatTranscriptOptionalParams, requestId, chatToken, chatId, transcriptResponse, telemetryData;
             return __generator(this, function (_a) {
                 getChatTranscriptOptionalParams = {};
+                requestId = this.requestId;
+                chatToken = this.chatToken;
+                chatId = chatToken.chatId;
+                if (optionalParams.liveChatContext) {
+                    requestId = optionalParams.liveChatContext.requestId;
+                    chatToken = optionalParams.liveChatContext.chatToken;
+                    chatId = chatToken.chatId;
+                }
                 this.scenarioMarker.startScenario(TelemetryEvent_1.default.GetLiveChatTranscript, {
-                    RequestId: this.requestId,
-                    ChatId: this.chatToken.chatId
+                    RequestId: requestId,
+                    ChatId: chatId
                 });
                 try {
                     if (this.authenticatedUserToken) {
                         getChatTranscriptOptionalParams.authenticatedUserToken = this.authenticatedUserToken;
                     }
-                    transcriptResponse = this.OCClient.getChatTranscripts(this.requestId, this.chatToken.chatId, this.chatToken.token, getChatTranscriptOptionalParams);
+                    transcriptResponse = this.OCClient.getChatTranscripts(requestId, chatToken.chatId, chatToken.token, getChatTranscriptOptionalParams);
                     this.scenarioMarker.completeScenario(TelemetryEvent_1.default.GetLiveChatTranscript, {
-                        RequestId: this.requestId,
-                        ChatId: this.chatToken.chatId
+                        RequestId: requestId,
+                        ChatId: chatId
                     });
                     return [2 /*return*/, transcriptResponse];
                 }
                 catch (error) {
-                    this.scenarioMarker.failScenario(TelemetryEvent_1.default.GetLiveChatTranscript, {
-                        RequestId: this.requestId,
-                        ChatId: this.chatToken.chatId
-                    });
+                    telemetryData = {
+                        RequestId: requestId,
+                        ChatId: chatId
+                    };
+                    exceptionThrowers_1.default.throwLiveChatTranscriptRetrievalFailure(error, this.scenarioMarker, TelemetryEvent_1.default.GetLiveChatTranscript, telemetryData);
                 }
                 return [2 /*return*/];
             });
@@ -1671,31 +1658,19 @@ var OmnichannelChatSDK = /** @class */ (function () {
     OmnichannelChatSDK.prototype.getVoiceVideoCalling = function (params) {
         if (params === void 0) { params = {}; }
         return __awaiter(this, void 0, void 0, function () {
-            var exceptionDetails, exceptionDetails, chatConfig, liveWSAndLiveChatEngJoin, msdyn_widgetsnippet, widgetSnippetSourceRegex, result;
+            var message, message, chatConfig, liveWSAndLiveChatEngJoin, msdyn_widgetsnippet, widgetSnippetSourceRegex, result;
             var _this = this;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
                         this.scenarioMarker.startScenario(TelemetryEvent_1.default.GetVoiceVideoCalling);
                         if (platform_1.default.isNode() || platform_1.default.isReactNative()) {
-                            exceptionDetails = {
-                                response: "UnsupportedPlatform",
-                                message: "VoiceVideoCalling is only supported on browser"
-                            };
-                            this.scenarioMarker.failScenario(TelemetryEvent_1.default.GetVoiceVideoCalling, {
-                                ExceptionDetails: JSON.stringify(exceptionDetails)
-                            });
-                            throw new Error(exceptionDetails.response);
+                            message = "VoiceVideoCalling is only supported on browser";
+                            exceptionThrowers_1.default.throwUnsupportedPlatform(this.scenarioMarker, TelemetryEvent_1.default.GetVoiceVideoCalling, message);
                         }
                         if (this.callingOption.toString() === CallingOptionsOptionSetNumber_1.default.NoCalling.toString()) {
-                            exceptionDetails = {
-                                response: "FeatureDisabled",
-                                message: "Voice and video call is not enabled"
-                            };
-                            this.scenarioMarker.failScenario(TelemetryEvent_1.default.GetVoiceVideoCalling, {
-                                ExceptionDetails: JSON.stringify(exceptionDetails)
-                            });
-                            throw new Error(exceptionDetails.response);
+                            message = "Voice and video call is not enabled";
+                            exceptionThrowers_1.default.throwFeatureDisabled(this.scenarioMarker, TelemetryEvent_1.default.GetVoiceVideoCalling, message);
                         }
                         return [4 /*yield*/, this.getChatConfig()];
                     case 1:
@@ -1874,7 +1849,7 @@ var OmnichannelChatSDK = /** @class */ (function () {
     OmnichannelChatSDK.prototype.getAgentAvailability = function (optionalParams) {
         if (optionalParams === void 0) { optionalParams = {}; }
         return __awaiter(this, void 0, void 0, function () {
-            var reportError, getAgentAvailabilityOptionalParams, response, e_2;
+            var reportError, getAgentAvailabilityOptionalParams, response, e_6;
             var _this = this;
             return __generator(this, function (_a) {
                 switch (_a.label) {
@@ -1907,7 +1882,7 @@ var OmnichannelChatSDK = /** @class */ (function () {
                         getAgentAvailabilityOptionalParams = {
                             initContext: {}
                         };
-                        getAgentAvailabilityOptionalParams = this.populateInitChatOptionalParam(getAgentAvailabilityOptionalParams, optionalParams);
+                        getAgentAvailabilityOptionalParams = this.populateInitChatOptionalParam(getAgentAvailabilityOptionalParams, optionalParams, TelemetryEvent_1.default.GetAgentAvailability);
                         _a.label = 1;
                     case 1:
                         _a.trys.push([1, 3, , 4]);
@@ -1916,9 +1891,9 @@ var OmnichannelChatSDK = /** @class */ (function () {
                         response = _a.sent();
                         return [2 /*return*/, response];
                     case 3:
-                        e_2 = _a.sent();
+                        e_6 = _a.sent();
                         // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                        reportError("GetAgentAvailabilityFailed", e_2.message);
+                        reportError("GetAgentAvailabilityFailed", e_6.message);
                         return [3 /*break*/, 4];
                     case 4: return [2 /*return*/];
                 }
@@ -2021,22 +1996,19 @@ var OmnichannelChatSDK = /** @class */ (function () {
     OmnichannelChatSDK.prototype.getChatConfig = function (optionalParams) {
         if (optionalParams === void 0) { optionalParams = {}; }
         return __awaiter(this, void 0, void 0, function () {
-            var sendCacheHeaders, bypassCache, liveChatConfig, dataMaskingConfig, authSettings, liveWSAndLiveChatEngJoin, liveChatVersion, chatWidgetLanguage, msdyn_localeid, setting, preChatSurvey, msdyn_prechatenabled, msdyn_callingoptions, msdyn_conversationmode, msdyn_enablechatreconnect, isPreChatEnabled, isChatReconnectEnabled, error_18;
+            var sendCacheHeaders, bypassCache, liveChatConfig, dataMaskingConfig, authSettings, liveWSAndLiveChatEngJoin, liveChatVersion, chatWidgetLanguage, msdyn_localeid, setting, preChatSurvey, msdyn_prechatenabled, msdyn_callingoptions, msdyn_conversationmode, msdyn_enablechatreconnect, isPreChatEnabled, isChatReconnectEnabled;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
                         sendCacheHeaders = optionalParams.sendCacheHeaders;
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, 5, , 6]);
                         bypassCache = sendCacheHeaders === true;
                         return [4 /*yield*/, this.OCClient.getChatConfig(this.requestId, bypassCache)];
-                    case 2:
+                    case 1:
                         liveChatConfig = _a.sent();
                         dataMaskingConfig = liveChatConfig.DataMaskingInfo, authSettings = liveChatConfig.LiveChatConfigAuthSettings, liveWSAndLiveChatEngJoin = liveChatConfig.LiveWSAndLiveChatEngJoin, liveChatVersion = liveChatConfig.LiveChatVersion, chatWidgetLanguage = liveChatConfig.ChatWidgetLanguage;
                         msdyn_localeid = chatWidgetLanguage.msdyn_localeid;
                         this.localeId = msdyn_localeid || locale_1.defaultLocaleId;
-                        this.liveChatVersion = liveChatVersion || LiveChatVersion_1.default.V1;
+                        this.liveChatVersion = liveChatVersion || LiveChatVersion_1.default.V2;
                         /* istanbul ignore next */
                         this.debug && console.log("[OmnichannelChatSDK][getChatConfig][liveChatVersion] " + this.liveChatVersion);
                         setting = dataMaskingConfig.setting;
@@ -2058,12 +2030,12 @@ var OmnichannelChatSDK = /** @class */ (function () {
                         if (isPreChatEnabled && preChatSurvey && preChatSurvey.trim().length > 0) {
                             this.preChatSurvey = preChatSurvey;
                         }
-                        if (!this.authSettings) return [3 /*break*/, 4];
+                        if (!this.authSettings) return [3 /*break*/, 3];
                         return [4 /*yield*/, this.setAuthTokenProvider(this.chatSDKConfig.getAuthToken)];
-                    case 3:
+                    case 2:
                         _a.sent();
-                        _a.label = 4;
-                    case 4:
+                        _a.label = 3;
+                    case 3:
                         if (this.preChatSurvey) {
                             /* istanbul ignore next */
                             this.debug && console.log('Prechat Survey!');
@@ -2071,11 +2043,6 @@ var OmnichannelChatSDK = /** @class */ (function () {
                         this.callingOption = msdyn_callingoptions;
                         this.liveChatConfig = liveChatConfig;
                         return [2 /*return*/, this.liveChatConfig];
-                    case 5:
-                        error_18 = _a.sent();
-                        console.error("OmnichannelChatSDK/getChatConfig/error " + error_18);
-                        return [2 /*return*/, error_18];
-                    case 6: return [2 /*return*/];
                 }
             });
         });
@@ -2088,7 +2055,7 @@ var OmnichannelChatSDK = /** @class */ (function () {
     };
     OmnichannelChatSDK.prototype.updateChatToken = function (newToken, newRegionGTMS) {
         return __awaiter(this, void 0, void 0, function () {
-            var sessionInfo, error_19, exceptionDetails;
+            var sessionInfo, error_18, exceptionDetails;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
@@ -2116,7 +2083,7 @@ var OmnichannelChatSDK = /** @class */ (function () {
                         });
                         return [3 /*break*/, 5];
                     case 4:
-                        error_19 = _a.sent();
+                        error_18 = _a.sent();
                         exceptionDetails = {
                             response: "UpdateChatTokenFailed"
                         };
@@ -2125,7 +2092,7 @@ var OmnichannelChatSDK = /** @class */ (function () {
                             ChatId: this.chatToken.chatId,
                             ExceptionDetails: JSON.stringify(exceptionDetails)
                         });
-                        console.error("OmnichannelChatSDK/updateChatToken/error " + error_19);
+                        console.error("OmnichannelChatSDK/updateChatToken/error " + error_18);
                         return [3 /*break*/, 5];
                     case 5: return [2 /*return*/];
                 }