@microsoft/omnichannel-chat-sdk 2.0.0-main.3932063 → 2.0.0-main.972a35d

package/README.md

@@ -332,7 +332,12 @@ await chatSDK.startChat(optionalParams);
 
 ### End Chat
 
-It ends the current Omnichannel conversation.
+It ends the current conversation for non-persistent workstreams.
+
+For persistent workstreams, will end the conversation only if this feature is enabled:
+
+* The "Modern" UI has been created and set to active for the channel in use (See: [Configure a chat widget | Microsoft Learn](https://learn.microsoft.com/dynamics365/customer-service/administer/add-chat-widget))
+* In channel setup, on the "Chat widget" tab, the option "Customer can end conversations" is set to On
 
 ```ts
 await chatSDK.endChat();

package/lib/OmnichannelChatSDK.js

@@ -109,6 +109,7 @@ var startPolling_1 = require("./commands/startPolling");
 var stopPolling_1 = require("./commands/stopPolling");
 var urlResolvers_1 = require("./utils/urlResolvers");
 var OmnichannelConfigValidator_1 = require("./validators/OmnichannelConfigValidator");
+var prefetchedConfigValidator_1 = require("./validators/prefetchedConfigValidator");
 var OmnichannelChatSDK = /** @class */ (function () {
     function OmnichannelChatSDK(omnichannelConfig, chatSDKConfig) {
         if (chatSDKConfig === void 0) { chatSDKConfig = SDKConfigValidators_1.defaultChatSDKConfig; }
@@ -1281,10 +1282,10 @@ var OmnichannelChatSDK = /** @class */ (function () {
     };
     OmnichannelChatSDK.prototype.closeChat = function (endChatOptionalParams) {
         return __awaiter(this, void 0, void 0, function () {
-            var cleanupMetadata, sessionCloseOptionalParams, isReconnectChat, isChatReconnect, error_14;
-            var _a, _b;
-            return __generator(this, function (_c) {
-                switch (_c.label) {
+            var cleanupMetadata, sessionCloseOptionalParams, sessionCloseRequestId, isReconnectChat, isChatReconnect, error_14;
+            var _a, _b, _c, _d, _e, _f;
+            return __generator(this, function (_g) {
+                switch (_g.label) {
                     case 0:
                         cleanupMetadata = {
                             RequestId: this.requestId,
@@ -1294,34 +1295,43 @@ var OmnichannelChatSDK = /** @class */ (function () {
                         // in case a session was ended by agent or disconnected, there is no need to close the session
                         this.scenarioMarker.startScenario(TelemetryEvent_1.default.CloseChatSession, cleanupMetadata);
                         if (!!(endChatOptionalParams === null || endChatOptionalParams === void 0 ? void 0 : endChatOptionalParams.isSessionEnded)) return [3 /*break*/, 5];
-                        _c.label = 1;
+                        _g.label = 1;
                     case 1:
-                        _c.trys.push([1, 3, , 4]);
+                        _g.trys.push([1, 3, , 4]);
                         sessionCloseOptionalParams = {};
+                        sessionCloseRequestId = this.requestId;
                         if (this.isPersistentChat && !((_a = this.chatSDKConfig.persistentChat) === null || _a === void 0 ? void 0 : _a.disable)) {
                             isReconnectChat = this.reconnectId !== null ? true : false;
                             sessionCloseOptionalParams.isPersistentChat = this.isPersistentChat;
                             sessionCloseOptionalParams.isReconnectChat = isReconnectChat;
+                            if ((0, parsers_1.parseLowerCaseString)((_c = (_b = this.liveChatConfig) === null || _b === void 0 ? void 0 : _b.LiveWSAndLiveChatEngJoin) === null || _c === void 0 ? void 0 : _c.msdyn_enablecustomerclosepersistentchat) === "true" &&
+                                isReconnectChat &&
+                                typeof this.reconnectId === "string" &&
+                                this.reconnectId.length > 0 &&
+                                (0, parsers_1.parseLowerCaseString)((_e = (_d = this.liveChatConfig) === null || _d === void 0 ? void 0 : _d.LcwFcbConfiguration) === null || _e === void 0 ? void 0 : _e.lcwPersistentChatCustomerEndEnabled) === "true") {
+                                sessionCloseRequestId = this.reconnectId;
+                            }
                         }
-                        if (this.isChatReconnect && !((_b = this.chatSDKConfig.chatReconnect) === null || _b === void 0 ? void 0 : _b.disable) && !this.isPersistentChat) {
+                        if (this.isChatReconnect && !((_f = this.chatSDKConfig.chatReconnect) === null || _f === void 0 ? void 0 : _f.disable) && !this.isPersistentChat) {
                             isChatReconnect = this.reconnectId !== null ? true : false;
                             this.requestId = isChatReconnect ? this.reconnectId : this.requestId; // Chat Reconnect session to close
+                            sessionCloseRequestId = this.requestId;
                             sessionCloseOptionalParams.isReconnectChat = isChatReconnect;
                         }
                         if (this.authenticatedUserToken) {
                             sessionCloseOptionalParams.authenticatedUserToken = this.authenticatedUserToken;
                         }
-                        return [4 /*yield*/, this.OCClient.sessionClose(this.requestId, sessionCloseOptionalParams)];
+                        return [4 /*yield*/, this.OCClient.sessionClose(sessionCloseRequestId, sessionCloseOptionalParams)];
                     case 2:
-                        _c.sent();
+                        _g.sent();
                         return [3 /*break*/, 4];
                     case 3:
-                        error_14 = _c.sent();
+                        error_14 = _g.sent();
                         exceptionThrowers_1.default.throwConversationClosureFailure(error_14, this.scenarioMarker, TelemetryEvent_1.default.CloseChatSession, __assign(__assign({}, cleanupMetadata), { isSessionEnded: String(!(endChatOptionalParams === null || endChatOptionalParams === void 0 ? void 0 : endChatOptionalParams.isSessionEnded)) }));
                         return [3 /*break*/, 4];
                     case 4:
                         this.scenarioMarker.completeScenario(TelemetryEvent_1.default.CloseChatSession, cleanupMetadata);
-                        _c.label = 5;
+                        _g.label = 5;
                     case 5: return [2 /*return*/];
                 }
             });
@@ -3395,53 +3405,95 @@ var OmnichannelChatSDK = /** @class */ (function () {
     };
     OmnichannelChatSDK.prototype.getChatConfig = function () {
         return __awaiter(this, arguments, void 0, function (optionalParams) {
-            var sendCacheHeaders, bypassCache, liveChatConfig, startTime, error_30, clientElapsedMs, _a;
-            var _b, _c;
+            var sendCacheHeaders, _a, prefetchedLiveChatConfig, prefetchedConfigAttestation, bypassCache, prefetchAttempted, prefetchResult, prefetchError_1, liveChatConfig, startTime, error_30, clientElapsedMs, _b;
+            var _c, _d;
             if (optionalParams === void 0) { optionalParams = {}; }
-            return __generator(this, function (_d) {
-                switch (_d.label) {
+            return __generator(this, function (_e) {
+                switch (_e.label) {
                     case 0:
                         sendCacheHeaders = optionalParams.sendCacheHeaders;
+                        _a = optionalParams, prefetchedLiveChatConfig = _a.prefetchedLiveChatConfig, prefetchedConfigAttestation = _a.prefetchedConfigAttestation;
                         bypassCache = sendCacheHeaders === true;
-                        startTime = typeof performance !== 'undefined' ? performance.now() : undefined;
-                        _d.label = 1;
+                        prefetchAttempted = prefetchedLiveChatConfig !== undefined && prefetchedLiveChatConfig !== null;
+                        if (!prefetchAttempted) return [3 /*break*/, 5];
+                        _e.label = 1;
                     case 1:
-                        _d.trys.push([1, 3, , 8]);
-                        return [4 /*yield*/, this.OCClient.getChatConfig(this.requestId, bypassCache)];
+                        _e.trys.push([1, 4, , 5]);
+                        prefetchResult = (0, prefetchedConfigValidator_1.default)(prefetchedLiveChatConfig, prefetchedConfigAttestation, { orgId: this.omnichannelConfig.orgId, widgetId: this.omnichannelConfig.widgetId }, bypassCache, this.omnichannelConfig.orgUrl);
+                        if (!prefetchResult.accepted) return [3 /*break*/, 3];
+                        // Ordered so nothing is latched from a payload we may still
+                        // reject: building the configuration is the step that can
+                        // throw, and evaluating attachment support flips a flag that
+                        // is never turned back off.
+                        return [4 /*yield*/, this.buildConfigurations(prefetchedLiveChatConfig)];
                     case 2:
-                        liveChatConfig = _d.sent();
+                        // Ordered so nothing is latched from a payload we may still
+                        // reject: building the configuration is the step that can
+                        // throw, and evaluating attachment support flips a flag that
+                        // is never turned back off.
+                        _e.sent();
+                        this.liveChatConfig = prefetchedLiveChatConfig;
+                        this.evaluateAMSAvailability();
+                        this.scenarioMarker.singleRecord(TelemetryEvent_1.default.PrefetchedLiveChatConfigUsed, {
+                            RequestId: this.requestId || ""
+                        });
+                        return [2 /*return*/, this.liveChatConfig];
+                    case 3:
+                        this.scenarioMarker.singleRecord(TelemetryEvent_1.default.PrefetchedLiveChatConfigRejected, {
+                            RequestId: this.requestId || "",
+                            ExceptionDetails: JSON.stringify({ reason: prefetchResult.reason })
+                        });
+                        return [3 /*break*/, 5];
+                    case 4:
+                        prefetchError_1 = _e.sent();
+                        // Adoption itself failed (e.g. buildConfigurations rejected the
+                        // payload). Fall through rather than surface it: the network fetch
+                        // below is the correct, working behavior.
+                        this.scenarioMarker.singleRecord(TelemetryEvent_1.default.PrefetchedLiveChatConfigRejected, {
+                            RequestId: this.requestId || "",
+                            ExceptionDetails: JSON.stringify({ reason: "Exception", error: "".concat(prefetchError_1) })
+                        });
+                        return [3 /*break*/, 5];
+                    case 5:
+                        startTime = typeof performance !== 'undefined' ? performance.now() : undefined;
+                        _e.label = 6;
+                    case 6:
+                        _e.trys.push([6, 8, , 13]);
+                        return [4 /*yield*/, this.OCClient.getChatConfig(this.requestId, bypassCache)];
+                    case 7:
+                        liveChatConfig = _e.sent();
                         this.liveChatConfig = liveChatConfig;
                         this.evaluateAMSAvailability();
                         this.buildConfigurations(liveChatConfig);
                         /* istanbul ignore next */
                         this.debug && console.log("[OmnichannelChatSDK][getChatConfig][liveChatVersion] ".concat(this.liveChatVersion));
                         return [2 /*return*/, this.liveChatConfig];
-                    case 3:
-                        error_30 = _d.sent();
+                    case 8:
+                        error_30 = _e.sent();
                         clientElapsedMs = startTime !== undefined
                             ? Math.round(performance.now() - startTime)
                             : undefined;
                         // Attach timing info to error object for outer catch blocks to use
                         // eslint-disable-next-line @typescript-eslint/no-explicit-any
                         error_30.__chatConfigElapsedMs = clientElapsedMs;
-                        if (!(0, internalUtils_1.isCoreServicesOrgUrlDNSError)(error_30, this.coreServicesOrgUrl, this.dynamicsLocationCode)) return [3 /*break*/, 6];
+                        if (!(0, internalUtils_1.isCoreServicesOrgUrlDNSError)(error_30, this.coreServicesOrgUrl, this.dynamicsLocationCode)) return [3 /*break*/, 11];
                         this.omnichannelConfig.orgUrl = this.unqServicesOrgUrl;
-                        _a = this;
+                        _b = this;
                         return [4 /*yield*/, ocsdk_1.SDKProvider.getSDK(this.omnichannelConfig, (0, createOcSDKConfiguration_1.default)(false), this.ocSdkLogger)];
-                    case 4:
-                        _a.OCClient = _d.sent();
+                    case 9:
+                        _b.OCClient = _e.sent();
                         return [4 /*yield*/, this.OCClient.getChatConfig(this.requestId, bypassCache)];
-                    case 5:
-                        liveChatConfig = _d.sent(); // Bubble up error by default to throw ChatConfigRetrievalFailure
-                        return [3 /*break*/, 7];
-                    case 6:
+                    case 10:
+                        liveChatConfig = _e.sent(); // Bubble up error by default to throw ChatConfigRetrievalFailure
+                        return [3 /*break*/, 12];
+                    case 11:
                         // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                        if (((_c = (_b = error_30.response) === null || _b === void 0 ? void 0 : _b.headers) === null || _c === void 0 ? void 0 : _c.errorcode) && parseInt(error_30.response.headers.errorcode) === OmnichannelErrorCodes_1.default.WidgetNotFound) {
+                        if (((_d = (_c = error_30.response) === null || _c === void 0 ? void 0 : _c.headers) === null || _d === void 0 ? void 0 : _d.errorcode) && parseInt(error_30.response.headers.errorcode) === OmnichannelErrorCodes_1.default.WidgetNotFound) {
                             console.warn("No widget with the given app id is present in the system.");
                         }
                         throw error_30; // Bubble up error by default to throw ChatConfigRetrievalFailure
-                    case 7: return [3 /*break*/, 8];
-                    case 8: return [2 /*return*/, this.liveChatConfig];
+                    case 12: return [3 /*break*/, 13];
+                    case 13: return [2 /*return*/, this.liveChatConfig];
                 }
             });
         });
@@ -3451,18 +3503,23 @@ var OmnichannelChatSDK = /** @class */ (function () {
         return __awaiter(this, void 0, void 0, function () {
             var dataMaskingConfig, authSettings, liveWSAndLiveChatEngJoin, liveChatVersion, chatWidgetLanguage;
             return __generator(this, function (_a) {
-                dataMaskingConfig = liveChatConfig.DataMaskingInfo, authSettings = liveChatConfig.LiveChatConfigAuthSettings, liveWSAndLiveChatEngJoin = liveChatConfig.LiveWSAndLiveChatEngJoin, liveChatVersion = liveChatConfig.LiveChatVersion, chatWidgetLanguage = liveChatConfig.ChatWidgetLanguage;
-                Promise.all([
-                    this.setDataMaskingConfiguration(dataMaskingConfig),
-                    this.setPrechatConfigurations(liveWSAndLiveChatEngJoin),
-                    this.setAuthSettingConfig(authSettings),
-                    this.setPersistentChatConfiguration(liveWSAndLiveChatEngJoin),
-                    this.setCallingOptionConfiguration(liveWSAndLiveChatEngJoin),
-                    this.setLocaleIdConfiguration(chatWidgetLanguage),
-                    this.setLiveChatVersionConfiguration(liveChatVersion),
-                    this.setWidgetSnippetBaseUrl(liveWSAndLiveChatEngJoin)
-                ]);
-                return [2 /*return*/];
+                switch (_a.label) {
+                    case 0:
+                        dataMaskingConfig = liveChatConfig.DataMaskingInfo, authSettings = liveChatConfig.LiveChatConfigAuthSettings, liveWSAndLiveChatEngJoin = liveChatConfig.LiveWSAndLiveChatEngJoin, liveChatVersion = liveChatConfig.LiveChatVersion, chatWidgetLanguage = liveChatConfig.ChatWidgetLanguage;
+                        return [4 /*yield*/, Promise.all([
+                                this.setDataMaskingConfiguration(dataMaskingConfig),
+                                this.setPrechatConfigurations(liveWSAndLiveChatEngJoin),
+                                this.setAuthSettingConfig(authSettings),
+                                this.setPersistentChatConfiguration(liveWSAndLiveChatEngJoin),
+                                this.setCallingOptionConfiguration(liveWSAndLiveChatEngJoin),
+                                this.setLocaleIdConfiguration(chatWidgetLanguage),
+                                this.setLiveChatVersionConfiguration(liveChatVersion),
+                                this.setWidgetSnippetBaseUrl(liveWSAndLiveChatEngJoin)
+                            ])];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/];
+                }
             });
         });
     };