@webex/contact-center 3.12.0-task-refactor.10 → 3.12.0-task-refactor.11

package/dist/cc.js

@@ -300,6 +300,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.
@@ -349,6 +350,16 @@ class ContactCenter extends _webexCore.WebexPlugin {
     this.trigger(_types4.TASK_EVENTS.TASK_HYDRATE, task);
   };
 
+  /**
+   * Handles multi-login hydrate events for SDK instances without Mobius registration
+   * @private
+   * @param {ITask} task The task object associated with the multi-login hydrate
+   */
+  handleTaskMultiLoginHydrate = task => {
+    // @ts-ignore
+    this.trigger(_types4.TASK_EVENTS.TASK_MULTI_LOGIN_HYDRATE, task);
+  };
+
   /**
    * Handles task merged events when tasks are combined eg: EPDN merge/transfer
    * @private
@@ -367,6 +378,7 @@ class ContactCenter extends _webexCore.WebexPlugin {
   incomingTaskListener() {
     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_MULTI_LOGIN_HYDRATE, this.handleTaskMultiLoginHydrate);
     this.taskManager.on(_types4.TASK_EVENTS.TASK_MERGED, this.handleTaskMerged);
   }
 
@@ -476,6 +488,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.unregisterIncomingCallEvent();
       this.services.webSocketManager.off('message', this.handleWebsocketMessage);
       this.services.rtdWebSocketManager.off('message', this.handleRTDWebsocketMessage);
@@ -654,7 +667,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()) {
           this.$webex.internal.mercury.connect().then(() => {
             _loggerProxy.default.log('Authentication: webex.internal.mercury.connect successful', {
               module: _constants.CC_FILE,
@@ -666,6 +679,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();
@@ -742,8 +760,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 {
@@ -1070,6 +1093,25 @@ class ContactCenter extends _webexCore.WebexPlugin {
     this.taskManager.handleRealtimeWebsocketEvent(event);
   };
 
+  /**
+   * Checks whether Mobius/WebRTC registration should be skipped by config
+   * @returns {boolean} True when browser WebRTC registration is disabled
+   * @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.');
+    }
+  }
+
   /**
    * Initializes event listeners for the Contact Center service
    * Sets up handlers for connection state changes and other core events
@@ -1204,6 +1246,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) {