Merge pull request #441 from elopezanaya/light-sdk-ams

Load AMS based on config definition

Author: elopezanaya

CHANGELOG.md

@@ -4,14 +4,26 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+### Added
+
+- Load AMS based on config.
+
+### Fixed
+
+- Fix for methods receiving exceptionDetails , but not logging it in telemetry
+- Fix to prevent double load of AMS
+- Fix to prevent startchat to finish before AMS client loads. (latency detected, future work to be part of AMS client enhancements)
+
 ## [1.10.16] - 2025-03-27
 
 ### Added
+
 - Added exception details for telemetry for SendMessage
 - Expose `OriginalMessageId` to `ChatSDK.onNewMessage()` to handle message ordering
 - Update `ChatSDK.sendMessage()` to return `OmnichannelMessage`
 
 ### Changed
+
 - Uptake [@microsoft/ocsdk@0.5.13](https://www.npmjs.com/package/@microsoft/ocsdk/v/0.5.13)
 
 ## [1.10.15] - 2025-03-11

README.md

@@ -14,48 +14,49 @@ Headless Chat SDK to build your own chat widget against Dynamics 365 Omnichannel
 Please make sure you have a chat widget configured before using this package or you can follow this [link](https://docs.microsoft.com/en-us/dynamics365/customer-service/add-chat-widget)
 
 ## Table of Contents
+
 - [Live Chat Widget vs. Chat SDK](#live-chat-widget-vs-chat-sdk)
 - [Releases](#releases)
 - [Installation](#installation)
 - [Installation on React Native](#installation-on-react-native)
 - [SDK Methods](#sdk-methods)
-    - [Initialization](#initialization)
-    - [Start Chat](#start-chat)
-    - [End Chat](#end-chat)
-    - [Get Pre-Chat Survey](#get-pre-chat-survey)
-    - [Get Live Chat Config](#get-live-chat-config)
-    - [Get Current Live Chat Context](#get-current-live-chat-context)
-    - [Get Data Masking Rules](#get-data-masking-rules)
-    - [Get Chat Reconnect Context](#get-chat-reconnect-context)
-    - [Get Conversation Details](#get-conversation-details)
-    - [Get Chat Token](#get-chat-token)
-    - [Get Calling Token](#get-calling-token)
-    - [Get Messages](#get-messages)
-    - [Send Messages](#send-messages)
-    - [On New Message](#on-new-message)
-    - [On Typing Event](#on-typing-event)
-    - [On Agent End Session](#on-agent-end-session)
-    - [Send Typing Event](#send-typing-event)
-    - [Email Live Chat Transcript](#email-live-chat-transcript)
-    - [Get Live Chat Transcript](#get-live-chat-transcript)
-    - [Upload File Attachment](#upload-file-attachment)
-    - [Download File Attachment](#download-file-attachment)
-    - [Create Chat Adapter](#create-chat-adapter)
-    - [Get Voice & Video Calling](#get-voice--video-calling)
-    - [Get Post Chat Survey Context](#get-post-chat-survey-context)
+  - [Initialization](#initialization)
+  - [Start Chat](#start-chat)
+  - [End Chat](#end-chat)
+  - [Get Pre-Chat Survey](#get-pre-chat-survey)
+  - [Get Live Chat Config](#get-live-chat-config)
+  - [Get Current Live Chat Context](#get-current-live-chat-context)
+  - [Get Data Masking Rules](#get-data-masking-rules)
+  - [Get Chat Reconnect Context](#get-chat-reconnect-context)
+  - [Get Conversation Details](#get-conversation-details)
+  - [Get Chat Token](#get-chat-token)
+  - [Get Calling Token](#get-calling-token)
+  - [Get Messages](#get-messages)
+  - [Send Messages](#send-messages)
+  - [On New Message](#on-new-message)
+  - [On Typing Event](#on-typing-event)
+  - [On Agent End Session](#on-agent-end-session)
+  - [Send Typing Event](#send-typing-event)
+  - [Email Live Chat Transcript](#email-live-chat-transcript)
+  - [Get Live Chat Transcript](#get-live-chat-transcript)
+  - [Upload File Attachment](#upload-file-attachment)
+  - [Download File Attachment](#download-file-attachment)
+  - [Create Chat Adapter](#create-chat-adapter)
+  - [Get Voice & Video Calling](#get-voice--video-calling)
+  - [Get Post Chat Survey Context](#get-post-chat-survey-context)
 - [Common Scenarios](#common-scenarios)
-    - [Using BotFramework-WebChat](#using-botframework-webchat)
-    - [Escalation to Voice & Video](#escalation-to-voice--video)
-    - [Pre-Chat Survey](#pre-chat-survey)
-    - [Post-Chat Survey](#post-chat-survey)
-    - [Reconnect to existing Chat](#reconnect-to-existing-chat)
-    - [Authenticated Chat](#authenticated-chat)
-    - [Persistent Chat](#persistent-chat)
-    - [Chat Reconnect with Authenticated User](#chat-reconnect-with-authenticated-user)
-    - [Chat Reconnect with Unauthenticated User](#chat-reconnect-with-unauthenticated-user)
-    - [Handling chat Disconnect on Mobile platform](#handling-chat-disconnect-on-mobile-platform)
-    - [Operating Hours](#operating-hours)
-    - [Single Sign-on for Bots](/docs/scenarios/SINGLE_SIGN_ON_FOR_BOTS.md)
+  - [Using BotFramework-WebChat](#using-botframework-webchat)
+  - [Escalation to Voice & Video](#escalation-to-voice--video)
+  - [Pre-Chat Survey](#pre-chat-survey)
+  - [Post-Chat Survey](#post-chat-survey)
+  - [Reconnect to existing Chat](#reconnect-to-existing-chat)
+  - [Authenticated Chat](#authenticated-chat)
+  - [Persistent Chat](#persistent-chat)
+  - [Chat Reconnect with Authenticated User](#chat-reconnect-with-authenticated-user)
+  - [Chat Reconnect with Unauthenticated User](#chat-reconnect-with-unauthenticated-user)
+  - [Handling chat Disconnect on Mobile platform](#handling-chat-disconnect-on-mobile-platform)
+  - [Operating Hours](#operating-hours)
+  - [Single Sign-on for Bots](/docs/scenarios/SINGLE_SIGN_ON_FOR_BOTS.md)
 - [Sample Apps](https://github.com/microsoft/omnichannel-chat-sdk-samples)
 - [Feature Comparisons](#feature-comparisons)
 - [Telemetry](#telemetry)
@@ -65,6 +66,7 @@ Please make sure you have a chat widget configured before using this package or
 ## Live Chat Widget vs. Chat SDK
 
 Omnichannel offers a live chat widget (LCW) by default. You can use the Chat SDK to build your custom chat widget if:
+
 - You want to fully customize the user interface of the chat widget to conform with your branding.
 - You want to integrate Omnichannel into your mobile app using React Native.
 - You want to integrate additional functionalities that LCW does not offer.
@@ -75,24 +77,24 @@ Omnichannel offers a live chat widget (LCW) by default. You can use the Chat SDK
 | Feature | Live Chat Widget | Chat SDK | Notes |
 | -----  | ----- | ----- | ----- |
 | Bring Your Own Widget | ❌ | ✔ | |
-| Web Support | ✔ | ✔ |
-| React Native Support | ❌ | ✔ |
+| Web Support | ✔ | ✔ ||
+| React Native Support | ❌ | ✔ | |
 | Escalation to Voice & Video | ✔ | ✔ | Only supported on Web |
 | Co-browse | ✔ | 3rd party add-on | Only supported on Web |
 | Screen Sharing | ✔ | 3rd party add-on | Only supported on Web |
-| Authenticated Chat | ✔ | ✔ |
-| Pre-chat Survey | ✔ | ✔ |
-| Post-chat Survey | ✔ | ✔ |
-| Download Transcript | ✔ | ✔ |
-| Email Transcript | ✔ | ✔ |
-| Data Masking | ✔ | ✔ |
-| File Attachments | ✔ | ✔ |
-| Custom Context | ✔ | ✔ |
-| Proactive Chat | ✔ | BYOI **\*** |
-| Persistent Chat | ✔ | ✔ |
-| Chat Reconnect | ✔ | ✔ |
-| Operating Hours | ✔ | ✔ |
-| Get Agent Availability | ✔ | ✔ |
+| Authenticated Chat | ✔ | ✔ | |
+| Pre-chat Survey | ✔ | ✔ | |
+| Post-chat Survey | ✔ | ✔ | |
+| Download Transcript | ✔ | ✔ | |
+| Email Transcript | ✔ | ✔ | |
+| Data Masking | ✔ | ✔ | |
+| File Attachments | ✔ | ✔ | |
+| Custom Context | ✔ | ✔ | |
+| Proactive Chat | ✔ | BYOI **\*** | |
+| Persistent Chat | ✔ | ✔ | |
+| Chat Reconnect | ✔ | ✔ | |
+| Operating Hours | ✔ | ✔ | |
+| Get Agent Availability | ✔ | ✔ | |
 | Queue Position | ✔ | ✔ | No SDK method. Handled as *system message* |
 | Average Wait Time | ✔ | ✔ | No SDK method. Handled as *system message* |
 
@@ -142,7 +144,7 @@ New releases are published on a regular basis to ensure the product quality.
 
 ## Installation
 
-```
+```console
 npm install @microsoft/omnichannel-chat-sdk --save
 ```
 
@@ -151,31 +153,37 @@ npm install @microsoft/omnichannel-chat-sdk --save
 The following steps will be required to run Omnichannel Chat SDK on React Native:
 
 1. Install `node-libs-react-native`
-    ```
+
+    ```console
     npm install node-libs-react-native --save-dev
     ```
 
 1. Install `react-native-randomBytes`
-    ```
+
+    ```console
     npm install react-native-randombytes --save-dev
     ```
 
 1. Install `react-native-get-random-values`
-    ```
+
+    ```console
     npm install react-native-get-random-values --save-dev
     ```
 
 1. Install `react-native-url-polyfill`
-    ```
+
+    ```console
     npm install react-native-url-polyfill --save-dev
     ```
 
 1. Install `@azure/core-asynciterator-polyfill`
-    ```
+
+    ```console
     npm install @azure/core-asynciterator-polyfill --save-dev
     ```
 
 1. Update *metro.config.js* to use React Native compatible Node Core modules
+
     ```ts
     module.exports = {
         // ...
@@ -190,6 +198,7 @@ The following steps will be required to run Omnichannel Chat SDK on React Native
     ```
 
 1. Add the following *import* on top of your entry point file
+
     ```ts
     import 'node-libs-react-native/globals';
     import 'react-native-get-random-values';
@@ -223,10 +232,14 @@ const chatSDK = new OmnichannelChatSDK.OmnichannelChatSDK(omnichannelConfig, cha
 
 const optionalParams = {
     getLiveChatConfigOptionalParams: {
-        sendCacheHeaders: false // Whether to send Cache-Control HTTP header to GetChatConfig call
+        sendCacheHeaders: false,// Whether to send Cache-Control HTTP header to GetChatConfig call
+        useSequentialLoad: false // Whether to use sequential load for chat config, if not present, by default uses parallel load for faster initialization
+
     }
 };
 
+
+// For the case when the widget doesnt have enabled support for attachments, Upload/download operations wont be supported
 await chatSDK.initialize(optionalParams);
 ```
 
@@ -394,6 +407,7 @@ chatSDK.onNewMessage((message) => {
     console.log(message);
 }, optionalParams);
 ```
+
 ### On Typing Event
 
 It subscribes to an agent typing event.
@@ -512,6 +526,7 @@ try {
     }
 }
 ```
+
 ### Get Post Chat Survey Context
 
 It gets the participant type that should be used for the survey and both the default and bot survey details.
@@ -532,7 +547,7 @@ const agentAvailability = await chatSDK.getAgentAvailability();
 
 ### Pre-Chat Survey
 
-> See https://docs.microsoft.com/en-us/dynamics365/customer-service/configure-pre-chat-survey?tabs=customerserviceadmincenter on how to set up pre-conversation surveys
+> See <https://docs.microsoft.com/en-us/dynamics365/customer-service/configure-pre-chat-survey?tabs=customerserviceadmincenter> on how to set up pre-conversation surveys
 
 ```ts
     import * as AdaptiveCards, { Action } from "adaptivecards";
@@ -567,7 +582,7 @@ const agentAvailability = await chatSDK.getAgentAvailability();
 
 ### Post-Chat Survey
 
-> See https://docs.microsoft.com/en-us/dynamics365/customer-service/configure-post-conversation-survey?tabs=customerserviceadmincenter on how to set up post-conversation surveys
+> See <https://docs.microsoft.com/en-us/dynamics365/customer-service/configure-post-conversation-survey?tabs=customerserviceadmincenter> on how to set up post-conversation surveys
 
 > ❗ `chatSDK.getPostChatSurveyContext()` needs to be called before `chatSDK.endChat()` is called
 
@@ -626,7 +641,7 @@ messages.reverse().forEach((message: any) => renderMessage(message)); // Logic t
 
 ### Authenticated Chat
 
-> See https://docs.microsoft.com/en-us/dynamics365/customer-service/create-chat-auth-settings?tabs=customerserviceadmincenter#create-a-chat-authentication-setting-record on how to set up an authenticated chat
+> See <https://docs.microsoft.com/en-us/dynamics365/customer-service/create-chat-auth-settings?tabs=customerserviceadmincenter#create-a-chat-authentication-setting-record> on how to set up an authenticated chat
 
 ```ts
 const chatSDKConfig = {
@@ -649,7 +664,7 @@ await chatSDK.initialize();
 
 ### Persistent Chat
 
-> See https://docs.microsoft.com/en-us/dynamics365/customer-service/persistent-chat on how to set up persistent chat
+> See <https://docs.microsoft.com/en-us/dynamics365/customer-service/persistent-chat> on how to set up persistent chat
 
 ```ts
 const chatSDKConfig = {
@@ -673,9 +688,10 @@ await chatSDK.initialize();
 
 // from this point, this acts like a persistent chat
 ```
+
 ### Chat Reconnect with Authenticated User
 
-> See https://docs.microsoft.com/en-us/dynamics365/customer-service/configure-reconnect-chat?tabs=customerserviceadmincenter#enable-reconnection-to-a-previous-chat-session on how to set up chat reconnect
+> See <https://docs.microsoft.com/en-us/dynamics365/customer-service/configure-reconnect-chat?tabs=customerserviceadmincenter#enable-reconnection-to-a-previous-chat-session> on how to set up chat reconnect
 
 ```ts
 const chatSDKConfig = {
@@ -715,7 +731,7 @@ chatSDK.startChat();
 
 ### Chat Reconnect with Unauthenticated User
 
-> See https://docs.microsoft.com/en-us/dynamics365/customer-service/configure-reconnect-chat?tabs=customerserviceadmincenter#enable-reconnection-to-a-previous-chat-session on how to set up chat reconnect
+> See <https://docs.microsoft.com/en-us/dynamics365/customer-service/configure-reconnect-chat?tabs=customerserviceadmincenter#enable-reconnection-to-a-previous-chat-session> on how to set up chat reconnect
 
 ```ts
 const chatSDKConfig = {
@@ -759,7 +775,7 @@ if (chatReconnectContext.reconnectId) {
 
 ### Operating Hours
 
-> See https://docs.microsoft.com/en-us/dynamics365/customer-service/create-operating-hours?tabs=customerserviceadmincenter on how to set up operating hours
+> See <https://docs.microsoft.com/en-us/dynamics365/customer-service/create-operating-hours?tabs=customerserviceadmincenter> on how to set up operating hours
 
 ```ts
 const chatConfig = await chatSDK.getLiveChatConfig();
@@ -796,11 +812,12 @@ window.addEventListener("visibilitychange", async () => {
 });
 ```
 
-
 ### Using [BotFramework-WebChat](https://github.com/microsoft/BotFramework-WebChat)
+>
 > :warning: Currently supported on web only
 
 Minimum Requirement Checklist
+
 1. [ ] Initialize ChatSDK
 1. [ ] Start new conversation
 1. [ ] Create Chat Adapter
@@ -838,9 +855,10 @@ const store = createStore(
 ```
 
 ### Escalation to Voice & Video
+>
 > :warning: Currently supported on web only
 
-> See https://docs.microsoft.com/en-us/dynamics365/customer-service/call-options-visual-engagement on how to set up calling options
+> See <https://docs.microsoft.com/en-us/dynamics365/customer-service/call-options-visual-engagement> on how to set up calling options
 
 ```ts
 import OmnichannelChatSDK from '@microsoft/omnichannel-chat-sdk';
@@ -948,17 +966,19 @@ if (VoiceVideoCallingSDK) {
 ## Feature Comparisons
 
 ### Web
+
 | | Custom Control | WebChat Control |
 | --- | --- | --- |
 | **Features** | | |
 | Chat Widget UI | Not provided | Basic chat client provided |
 | Data Masking | Embedded | Requires `Data Masking Middleware` implementation |
 | Send Typing indicator | Embedded | Requires `sendTypingIndicator` flag set to `true` |
-| PreChat Survey | Requires Adaptive Cards renderer | Requires Adaptive Cards renderer
+| PreChat Survey | Requires Adaptive Cards renderer | Requires Adaptive Cards renderer|
 | Display Attachments | Requires implementation | Basic interface provided & Customizable |
 | Incoming messages handling | IC3 protocol message data | DirectLine activity data |
 
 ### React Native
+
 | | Custom Control | Gifted Chat Control | WebChat Control |
 | --- | --- | --- | --- |
 | **Features** | | | Currently not supported |
@@ -1007,7 +1027,7 @@ await chatSDK.initialize();
 
 This project welcomes contributions and suggestions.  Most contributions require you to agree to a
 Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
-the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
+the rights to use your contribution. For details, visit <https://cla.opensource.microsoft.com>.
 
 When you submit a pull request, a CLA bot will automatically determine whether you need to provide
 a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions

__tests__/OmnichannelChatSDK.node.spec.ts

@@ -36,6 +36,7 @@ describe('Omnichannel Chat SDK (Node), Sequential', () => {
 
         const chatSDK = new OmnichannelChatSDK(omnichannelConfig);
         chatSDK.getChatConfig = jest.fn();
+        chatSDK["isAMSClientAllowed"] = true;
 
         await chatSDK.initialize();
 
@@ -82,6 +83,7 @@ describe('Omnichannel Chat SDK (Node), Sequential', () => {
         };
         chatSDK.getChatConfig = jest.fn();
         chatSDK.getChatToken = jest.fn();
+        chatSDK["isAMSClientAllowed"] = true;
 
         await chatSDK.initialize();
 
@@ -113,6 +115,7 @@ describe('Omnichannel Chat SDK (Node), Sequential', () => {
         };
         chatSDK.getChatConfig = jest.fn();
         chatSDK.getChatToken = jest.fn();
+        chatSDK["isAMSClientAllowed"] = true;
 
         await chatSDK.initialize();