@webex/contact-center 3.12.0-next.66 → 3.12.0-next.68

package/dist/cc.js

@@ -301,6 +301,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
     this.$webex.once(_constants.READY, () => {
       // @ts-ignore
       this.$config = this.config;
+      this.validatePluginConfig();
 
       /**
        * This is used for handling the async requests by sending webex.request and wait for corresponding websocket event.
@@ -368,6 +369,16 @@ class ContactCenter extends _webexCore.WebexPlugin {
     // @ts-ignore
     this.trigger(_types4.TASK_EVENTS.TASK_CAMPAIGN_PREVIEW_RESERVATION, task);
   };
+
+  /**
+   * Handles multi-login hydrate events emitted when browser login accepts an incoming call.
+   * @private
+   * @param {ITask} task The task object associated with multi-login hydrate
+   */
+  handleTaskMultiLoginHydrate = task => {
+    // @ts-ignore
+    this.trigger(_types4.TASK_EVENTS.TASK_MULTI_LOGIN_HYDRATE, task);
+  };
   handleRTDWebsocketMessage = payload => {
     this.taskManager.handleRealtimeWebsocketEvent(payload);
   };
@@ -381,6 +392,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
     this.taskManager.on(_types4.TASK_EVENTS.TASK_INCOMING, this.handleIncomingTask);
     this.taskManager.on(_types4.TASK_EVENTS.TASK_HYDRATE, this.handleTaskHydrate);
     this.taskManager.on(_types4.TASK_EVENTS.TASK_MERGED, this.handleTaskMerged);
+    this.taskManager.on(_types4.TASK_EVENTS.TASK_MULTI_LOGIN_HYDRATE, this.handleTaskMultiLoginHydrate);
     this.taskManager.on(_types4.TASK_EVENTS.TASK_CAMPAIGN_PREVIEW_RESERVATION, this.handleCampaignPreviewReservation);
   }
 
@@ -491,6 +503,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
       this.metricsManager.timeEvent([_constants4.METRIC_EVENT_NAMES.WEBSOCKET_DEREGISTER_SUCCESS, _constants4.METRIC_EVENT_NAMES.WEBSOCKET_DEREGISTER_FAIL]);
       this.taskManager.off(_types4.TASK_EVENTS.TASK_INCOMING, this.handleIncomingTask);
       this.taskManager.off(_types4.TASK_EVENTS.TASK_HYDRATE, this.handleTaskHydrate);
+      this.taskManager.off(_types4.TASK_EVENTS.TASK_MULTI_LOGIN_HYDRATE, this.handleTaskMultiLoginHydrate);
       this.taskManager.off(_types4.TASK_EVENTS.TASK_CAMPAIGN_PREVIEW_RESERVATION, this.handleCampaignPreviewReservation);
       this.taskManager.unregisterIncomingCallEvent();
       this.services.webSocketManager.off('message', this.handleWebsocketMessage);
@@ -609,6 +622,25 @@ class ContactCenter extends _webexCore.WebexPlugin {
     }
   }
 
+  /**
+   * Checks whether WebRTC registration should be skipped by config.
+   * @returns {boolean}
+   * @private
+   */
+  isWebRTCRegistrationDisabled() {
+    return this.$config?.disableWebRTCRegistration === true;
+  }
+
+  /**
+   * Validates contact-center plugin configuration before service initialization
+   * @private
+   */
+  validatePluginConfig() {
+    if (this.$config?.disableWebRTCRegistration === true && this.$config?.allowMultiLogin === false) {
+      throw new Error('Invalid Contact Center configuration: disableWebRTCRegistration cannot be true when allowMultiLogin is false. Enable allowMultiLogin or allow WebRTC registration so an SDK instance can receive Mobius/WebRTC task events.');
+    }
+  }
+
   /**
    * Connects to the websocket and fetches the agent profile
    * @returns {Promise<Profile>} Agent profile information
@@ -659,7 +691,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
           });
         });
       }
-      if (this.agentConfig.webRtcEnabled && this.agentConfig.loginVoiceOptions.includes(_types.LoginOption.BROWSER)) {
+      if (this.agentConfig.webRtcEnabled && this.agentConfig.loginVoiceOptions.includes(_types.LoginOption.BROWSER) && !this.isWebRTCRegistrationDisabled()) {
         try {
           await this.$webex.internal.mercury.connect();
           _loggerProxy.default.log('Authentication: webex.internal.mercury.connect successful', {
@@ -672,6 +704,11 @@ class ContactCenter extends _webexCore.WebexPlugin {
             method: _constants.METHODS.CONNECT_WEBSOCKET
           });
         }
+      } else if (this.isWebRTCRegistrationDisabled()) {
+        _loggerProxy.default.info('Skipping Mobius registration because disableWebRTCRegistration is enabled', {
+          module: _constants.CC_FILE,
+          method: _constants.METHODS.CONNECT_WEBSOCKET
+        });
       }
       if (this.$config && this.$config.allowAutomatedRelogin) {
         await this.silentRelogin();
@@ -756,8 +793,13 @@ class ContactCenter extends _webexCore.WebexPlugin {
           auxCodeId: _constants.EMPTY_STRING
         }
       });
-      if (this.agentConfig.webRtcEnabled && data.loginOption === _types.LoginOption.BROWSER) {
+      if (this.agentConfig.webRtcEnabled && data.loginOption === _types.LoginOption.BROWSER && !this.isWebRTCRegistrationDisabled()) {
         await this.webCallingService.registerWebCallingLine();
+      } else if (this.agentConfig.webRtcEnabled && data.loginOption === _types.LoginOption.BROWSER && this.isWebRTCRegistrationDisabled()) {
+        _loggerProxy.default.info('Skipping web calling line registration because disableWebRTCRegistration is enabled', {
+          module: _constants.CC_FILE,
+          method: _constants.METHODS.STATION_LOGIN
+        });
       }
       const resp = await loginResponse;
       const {
@@ -1213,6 +1255,13 @@ class ContactCenter extends _webexCore.WebexPlugin {
     this.agentConfig.deviceType = deviceType;
     switch (deviceType) {
       case _types.LoginOption.BROWSER:
+        if (this.isWebRTCRegistrationDisabled()) {
+          _loggerProxy.default.info('Skipping web calling line registration because disableWebRTCRegistration is enabled', {
+            module: _constants.CC_FILE,
+            method: _constants.METHODS.HANDLE_DEVICE_TYPE
+          });
+          break;
+        }
         try {
           await this.webCallingService.registerWebCallingLine();
         } catch (error) {