@webex/plugin-meetings 2.60.0 → 2.60.1-next.2

package/dist/locus-info/index.js

@@ -15,12 +15,10 @@ var _inherits2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/
 var _possibleConstructorReturn2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/possibleConstructorReturn"));
 var _getPrototypeOf2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/getPrototypeOf"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs2/helpers/defineProperty"));
-var _isEqual2 = _interopRequireDefault(require("lodash/isEqual"));
+var _lodash = require("lodash");
 var _loggerProxy = _interopRequireDefault(require("../common/logs/logger-proxy"));
 var _eventsScope = _interopRequireDefault(require("../common/events/events-scope"));
 var _constants = require("../constants");
-var _metrics = _interopRequireDefault(require("../metrics"));
-var _config = require("../metrics/config");
 var _infoUtils = _interopRequireDefault(require("./infoUtils"));
 var _fullState = _interopRequireDefault(require("./fullState"));
 var _selfUtils = _interopRequireDefault(require("./selfUtils"));
@@ -29,6 +27,8 @@ var _controlsUtils = _interopRequireDefault(require("./controlsUtils"));
 var _embeddedAppsUtils = _interopRequireDefault(require("./embeddedAppsUtils"));
 var _mediaSharesUtils = _interopRequireDefault(require("./mediaSharesUtils"));
 var _parser = _interopRequireDefault(require("./parser"));
+var _metrics = _interopRequireDefault(require("../metrics"));
+var _constants2 = _interopRequireDefault(require("../metrics/constants"));
 function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = (0, _getPrototypeOf2.default)(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = (0, _getPrototypeOf2.default)(this).constructor; result = _Reflect$construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return (0, _possibleConstructorReturn2.default)(this, result); }; }
 function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !_Reflect$construct) return false; if (_Reflect$construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(_Reflect$construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
 /**
@@ -37,9 +37,16 @@ function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !_R
  * @private
  * @class LocusInfo
  */
-var LocusInfo = /*#__PURE__*/function (_EventsScope) {
+var LocusInfo = exports.default = /*#__PURE__*/function (_EventsScope) {
   (0, _inherits2.default)(LocusInfo, _EventsScope);
   var _super = _createSuper(LocusInfo);
+  /**
+   * Constructor
+   * @param {function} updateMeeting callback to update the meeting object from an object
+   * @param {object} webex
+   * @param {string} meetingId
+   * @returns {undefined}
+   */
   function LocusInfo(updateMeeting, webex, meetingId) {
     var _this;
     (0, _classCallCheck2.default)(this, LocusInfo);
@@ -68,10 +75,12 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "fullState", void 0);
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "host", void 0);
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "info", void 0);
+    (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "roles", void 0);
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "mediaShares", void 0);
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "replace", void 0);
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "url", void 0);
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "services", void 0);
+    (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "mainSessionLocusCache", void 0);
     _this.parsedLocus = {
       states: []
     };
@@ -85,38 +94,95 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }
 
   /**
-   * Apply locus delta data to meeting
-   * @param {string} action Locus delta action
-   * @param {Locus} locus
+   * Does a Locus sync. It tries to get the latest delta DTO or if it can't, it falls back to getting the full Locus DTO.
+   *
    * @param {Meeting} meeting
    * @returns {undefined}
    */
   (0, _createClass2.default)(LocusInfo, [{
+    key: "doLocusSync",
+    value: function doLocusSync(meeting) {
+      var _this2 = this;
+      var isDelta;
+      var url;
+      if (this.locusParser.workingCopy.syncUrl) {
+        url = this.locusParser.workingCopy.syncUrl;
+        isDelta = true;
+      } else {
+        url = meeting.locusUrl;
+        isDelta = false;
+      }
+      _loggerProxy.default.logger.info("Locus-info:index#doLocusSync --> doing Locus sync (getting ".concat(isDelta ? 'delta' : 'full', " DTO)"));
+
+      // return value ignored on purpose
+      meeting.meetingRequest.getLocusDTO({
+        url: url
+      }).catch(function (e) {
+        if (isDelta) {
+          _loggerProxy.default.logger.info('Locus-info:index#doLocusSync --> delta sync failed, falling back to full sync');
+          _metrics.default.sendBehavioralMetric(_constants2.default.LOCUS_DELTA_SYNC_FAILED, {
+            correlationId: meeting.correlationId,
+            url: url,
+            reason: e.message,
+            errorName: e.name,
+            stack: e.stack,
+            code: e.code
+          });
+          isDelta = false;
+          return meeting.meetingRequest.getLocusDTO({
+            url: meeting.locusUrl
+          }).catch(function (err) {
+            _loggerProxy.default.logger.info('Locus-info:index#doLocusSync --> fallback full sync failed, destroying the meeting');
+            _this2.webex.meetings.destroy(meeting, _constants.MEETING_REMOVED_REASON.LOCUS_DTO_SYNC_FAILED);
+            throw err;
+          });
+        }
+        _loggerProxy.default.logger.info('Locus-info:index#doLocusSync --> fallback full sync failed, destroying the meeting');
+        _this2.webex.meetings.destroy(meeting, _constants.MEETING_REMOVED_REASON.LOCUS_DTO_SYNC_FAILED);
+        throw e;
+      }).then(function (res) {
+        if (isDelta) {
+          if (!(0, _lodash.isEmpty)(res.body)) {
+            meeting.locusInfo.handleLocusDelta(res.body, meeting);
+          } else {
+            _loggerProxy.default.logger.info('Locus-info:index#doLocusSync --> received empty body from syncUrl, so we already have latest Locus DTO');
+          }
+        } else {
+          meeting.locusInfo.onFullLocus(res.body);
+        }
+        // Notify parser to resume processing delta events.
+        // Any deltas in the queue that have now been superseded by this sync will simply be ignored
+        _this2.locusParser.resume();
+      });
+    }
+
+    /**
+     * Apply locus delta data to meeting
+     * @param {string} action Locus delta action
+     * @param {Locus} locus
+     * @param {Meeting} meeting
+     * @returns {undefined}
+     */
+  }, {
     key: "applyLocusDeltaData",
     value: function applyLocusDeltaData(action, locus, meeting) {
-      var _this2 = this;
       var _LocusDeltaParser$loc = _parser.default.loci,
         DESYNC = _LocusDeltaParser$loc.DESYNC,
         USE_CURRENT = _LocusDeltaParser$loc.USE_CURRENT,
-        USE_INCOMING = _LocusDeltaParser$loc.USE_INCOMING;
+        USE_INCOMING = _LocusDeltaParser$loc.USE_INCOMING,
+        WAIT = _LocusDeltaParser$loc.WAIT,
+        LOCUS_URL_CHANGED = _LocusDeltaParser$loc.LOCUS_URL_CHANGED;
       switch (action) {
         case USE_INCOMING:
           meeting.locusInfo.onDeltaLocus(locus);
           break;
         case USE_CURRENT:
-          meeting.locusDesync = false;
-          meeting.needToGetFullLocus = false;
+        case WAIT:
+          // do nothing
           break;
         case DESYNC:
-          meeting.meetingRequest.getFullLocus({
-            desync: true,
-            locusUrl: meeting.locusUrl
-          }).then(function (res) {
-            meeting.locusInfo.onFullLocus(res.body);
-            // Notify parser to resume processing delta events
-            // now that we have full locus from DESYNC.
-            _this2.locusParser.resume();
-          });
+        case LOCUS_URL_CHANGED:
+          this.doLocusSync(meeting);
           break;
         default:
           _loggerProxy.default.logger.info("Locus-info:index#applyLocusDeltaData --> Unknown locus delta action: ".concat(action));
@@ -186,13 +252,13 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
        * @member LocusInfo
        */
       this.deltaParticipants = [];
-
+      this.updateLocusCache(locus);
       // above section only updates the locusInfo object
       // The below section makes sure it updates the locusInfo as well as updates the meeting object
       this.updateParticipants(locus.participants);
       // For 1:1 space meeting the conversation Url does not exist in locus.conversation
       this.updateConversationUrl(locus.conversationUrl, locus.info);
-      this.updateControls(locus.controls);
+      this.updateControls(locus.controls, locus.self);
       this.updateLocusUrl(locus.url);
       this.updateFullState(locus.fullState);
       this.updateMeetingInfo(locus.info);
@@ -212,6 +278,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "initialSetup",
     value: function initialSetup(locus) {
+      this.updateLocusCache(locus);
       this.onFullLocus(locus);
 
       // Change it to true after it receives it first locus object
@@ -229,6 +296,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
     value: function parse(meeting, data) {
       // eslint-disable-next-line @typescript-eslint/no-shadow
       var eventType = data.eventType;
+      var locus = this.getTheLocusToUpdate(data.locus);
       _loggerProxy.default.logger.info("Locus-info:index#parse --> received locus data: ".concat(eventType));
       switch (eventType) {
         case _constants.LOCUSEVENT.PARTICIPANT_JOIN:
@@ -245,15 +313,15 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
         case _constants.LOCUSEVENT.PARTICIPANT_DECLINED:
         case _constants.LOCUSEVENT.FLOOR_GRANTED:
         case _constants.LOCUSEVENT.FLOOR_RELEASED:
-          this.onFullLocus(data.locus, eventType);
+          this.onFullLocus(locus, eventType);
           break;
         case _constants.LOCUSEVENT.DIFFERENCE:
-          this.handleLocusDelta(data.locus, meeting);
+          this.handleLocusDelta(locus, meeting);
           break;
         default:
           // Why will there be a event with no eventType ????
           // we may not need this, we can get full locus
-          this.handleLocusDelta(data.locus, meeting);
+          this.handleLocusDelta(locus, meeting);
       }
     }
 
@@ -277,18 +345,22 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
      * @returns {object} null
      * @memberof LocusInfo
      */
-    // eslint-disable-next-line @typescript-eslint/no-shadow
   }, {
     key: "onFullLocus",
     value: function onFullLocus(locus, eventType) {
       if (!locus) {
         _loggerProxy.default.logger.error('Locus-info:index#onFullLocus --> object passed as argument was invalid, continuing.');
       }
+      if (!this.locusParser.isNewFullLocus(locus)) {
+        _loggerProxy.default.logger.info("Locus-info:index#onFullLocus --> ignoring old full locus DTO, eventType=".concat(eventType));
+        return;
+      }
       this.updateParticipantDeltas(locus.participants);
       this.scheduledMeeting = locus.meeting || null;
       this.participants = locus.participants;
+      var isReplaceMembers = _controlsUtils.default.isNeedReplaceMembers(this.controls, locus.controls);
       this.updateLocusInfo(locus);
-      this.updateParticipants(locus.participants);
+      this.updateParticipants(locus.participants, isReplaceMembers);
       this.isMeetingActive();
       this.handleOneOnOneEvent(eventType);
       this.updateEmbeddedApps(locus.embeddedApps);
@@ -340,8 +412,9 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "onDeltaLocus",
     value: function onDeltaLocus(locus) {
+      var isReplaceMembers = _controlsUtils.default.isNeedReplaceMembers(this.controls, locus.controls);
       this.updateLocusInfo(locus);
-      this.updateParticipants(locus.participants);
+      this.updateParticipants(locus.participants, isReplaceMembers);
       this.isMeetingActive();
     }
 
@@ -353,8 +426,14 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "updateLocusInfo",
     value: function updateLocusInfo(locus) {
-      var _locus$links2;
-      this.updateControls(locus.controls);
+      var _locus$self, _locus$self2, _locus$links2;
+      if (((_locus$self = locus.self) === null || _locus$self === void 0 ? void 0 : _locus$self.reason) === 'MOVED' && ((_locus$self2 = locus.self) === null || _locus$self2 === void 0 ? void 0 : _locus$self2.state) === 'LEFT') {
+        // When moved to a breakout session locus sends a message for the previous locus
+        // indicating that we have been moved. It isn't helpful to continue parsing this
+        // as it gets interpreted as if we have left the call
+        return;
+      }
+      this.updateControls(locus.controls, locus.self);
       this.updateConversationUrl(locus.conversationUrl, locus.info);
       this.updateCreated(locus.created);
       this.updateFullState(locus.fullState);
@@ -420,9 +499,13 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
         if (this.fullState && this.fullState.state === _constants.LOCUS.STATE.INACTIVE) {
           // TODO: update the meeting state
           _loggerProxy.default.logger.warn('Locus-info:index#isMeetingActive --> Call Ended, locus state is inactive.');
-          _metrics.default.postEvent({
-            event: _config.eventType.REMOTE_ENDED,
-            meetingId: this.meetingId
+
+          // @ts-ignore
+          this.webex.internal.newMetrics.submitClientEvent({
+            name: 'client.call.remote-ended',
+            options: {
+              meetingId: this.meetingId
+            }
           });
           this.emitScoped({
             file: 'locus-info',
@@ -432,9 +515,12 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
             shouldLeave: false
           });
         } else if (partner.state === _constants.MEETING_STATE.STATES.LEFT && this.parsedLocus.self && (this.parsedLocus.self.state === _constants.MEETING_STATE.STATES.DECLINED || this.parsedLocus.self.state === _constants.MEETING_STATE.STATES.NOTIFIED || this.parsedLocus.self.state === _constants.MEETING_STATE.STATES.JOINED)) {
-          _metrics.default.postEvent({
-            event: _config.eventType.REMOTE_ENDED,
-            meetingId: this.meetingId
+          // @ts-ignore
+          this.webex.internal.newMetrics.submitClientEvent({
+            name: 'client.call.remote-ended',
+            options: {
+              meetingId: this.meetingId
+            }
           });
           this.emitScoped({
             file: 'locus-info',
@@ -445,9 +531,12 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
           });
         } else if (this.parsedLocus.self && this.parsedLocus.self.state === _constants.MEETING_STATE.STATES.LEFT && (partner.state === _constants.MEETING_STATE.STATES.LEFT || partner.state === _constants.MEETING_STATE.STATES.DECLINED || partner.state === _constants.MEETING_STATE.STATES.NOTIFIED || partner.state === _constants.MEETING_STATE.STATES.IDLE) // Happens when user just joins and adds no Media
         ) {
-          _metrics.default.postEvent({
-            event: _config.eventType.REMOTE_ENDED,
-            meetingId: this.meetingId
+          // @ts-ignore
+          this.webex.internal.newMetrics.submitClientEvent({
+            name: 'client.call.remote-ended',
+            options: {
+              meetingId: this.meetingId
+            }
           });
           this.emitScoped({
             file: 'locus-info',
@@ -462,9 +551,13 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
         // @ts-ignore
         this.fullState.state === _constants.LOCUS.STATE.TERMINATING)) {
           _loggerProxy.default.logger.warn('Locus-info:index#isMeetingActive --> Meeting is ending due to inactive or terminating');
-          _metrics.default.postEvent({
-            event: _config.eventType.REMOTE_ENDED,
-            meetingId: this.meetingId
+
+          // @ts-ignore
+          this.webex.internal.newMetrics.submitClientEvent({
+            name: 'client.call.remote-ended',
+            options: {
+              meetingId: this.meetingId
+            }
           });
           this.emitScoped({
             file: 'locus-info',
@@ -475,9 +568,13 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
           });
         } else if (this.fullState && this.fullState.removed) {
           // user has been dropped from a meeting
-          _metrics.default.postEvent({
-            event: _config.eventType.REMOTE_ENDED,
-            meetingId: this.meetingId
+
+          // @ts-ignore
+          this.webex.internal.newMetrics.submitClientEvent({
+            name: 'client.call.remote-ended',
+            options: {
+              meetingId: this.meetingId
+            }
           });
           this.emitScoped({
             file: 'locus-info',
@@ -600,15 +697,15 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
     }
 
     /**
-     *
+     * update meeting's members
      * @param {Object} participants new participants object
-     * @param {boolen} deltaParticpantFlag  delta event
+     * @param {Boolean} isReplace is replace the whole members
      * @returns {Array} updatedParticipants
      * @memberof LocusInfo
      */
   }, {
     key: "updateParticipants",
-    value: function updateParticipants(participants) {
+    value: function updateParticipants(participants, isReplace) {
       var _this$parsedLocus$con;
       this.emitScoped({
         file: 'locus-info',
@@ -618,19 +715,21 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
         recordingId: this.parsedLocus.controls && ((_this$parsedLocus$con = this.parsedLocus.controls.record) === null || _this$parsedLocus$con === void 0 ? void 0 : _this$parsedLocus$con.modifiedBy),
         selfIdentity: this.parsedLocus.self && this.parsedLocus.self.selfIdentity,
         selfId: this.parsedLocus.self && this.parsedLocus.self.selfId,
-        hostId: this.parsedLocus.host && this.parsedLocus.host.hostId
+        hostId: this.parsedLocus.host && this.parsedLocus.host.hostId,
+        isReplace: isReplace
       });
     }
 
     /**
      * @param {Object} controls
+     * @param {Object} self
      * @returns {undefined}
      * @memberof LocusInfo
      */
   }, {
     key: "updateControls",
-    value: function updateControls(controls) {
-      if (controls && !(0, _isEqual2.default)(this.controls, controls)) {
+    value: function updateControls(controls, self) {
+      if (controls && !(0, _lodash.isEqual)(this.controls, controls)) {
         this.parsedLocus.controls = _controlsUtils.default.parse(controls);
         var _ControlsUtils$getCon = _controlsUtils.default.getControls(this.controls, controls),
           _ControlsUtils$getCon2 = _ControlsUtils$getCon.updates,
@@ -639,7 +738,74 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
           hasMeetingContainerChanged = _ControlsUtils$getCon2.hasMeetingContainerChanged,
           hasTranscribeChanged = _ControlsUtils$getCon2.hasTranscribeChanged,
           hasEntryExitToneChanged = _ControlsUtils$getCon2.hasEntryExitToneChanged,
+          hasBreakoutChanged = _ControlsUtils$getCon2.hasBreakoutChanged,
+          hasVideoEnabledChanged = _ControlsUtils$getCon2.hasVideoEnabledChanged,
+          hasMuteOnEntryChanged = _ControlsUtils$getCon2.hasMuteOnEntryChanged,
+          hasShareControlChanged = _ControlsUtils$getCon2.hasShareControlChanged,
+          hasDisallowUnmuteChanged = _ControlsUtils$getCon2.hasDisallowUnmuteChanged,
+          hasReactionsChanged = _ControlsUtils$getCon2.hasReactionsChanged,
+          hasReactionDisplayNamesChanged = _ControlsUtils$getCon2.hasReactionDisplayNamesChanged,
+          hasViewTheParticipantListChanged = _ControlsUtils$getCon2.hasViewTheParticipantListChanged,
+          hasRaiseHandChanged = _ControlsUtils$getCon2.hasRaiseHandChanged,
+          hasVideoChanged = _ControlsUtils$getCon2.hasVideoChanged,
+          hasInterpretationChanged = _ControlsUtils$getCon2.hasInterpretationChanged,
           current = _ControlsUtils$getCon.current;
+        if (hasMuteOnEntryChanged) {
+          this.emitScoped({
+            file: 'locus-info',
+            function: 'updateControls'
+          }, _constants.LOCUSINFO.EVENTS.CONTROLS_MUTE_ON_ENTRY_CHANGED, {
+            state: current.muteOnEntry
+          });
+        }
+        if (hasShareControlChanged) {
+          this.emitScoped({
+            file: 'locus-info',
+            function: 'updateControls'
+          }, _constants.LOCUSINFO.EVENTS.CONTROLS_SHARE_CONTROL_CHANGED, {
+            state: current.shareControl
+          });
+        }
+        if (hasDisallowUnmuteChanged) {
+          this.emitScoped({
+            file: 'locus-info',
+            function: 'updateControls'
+          }, _constants.LOCUSINFO.EVENTS.CONTROLS_DISALLOW_UNMUTE_CHANGED, {
+            state: current.disallowUnmute
+          });
+        }
+        if (hasReactionsChanged || hasReactionDisplayNamesChanged) {
+          this.emitScoped({
+            file: 'locus-info',
+            function: 'updateControls'
+          }, _constants.LOCUSINFO.EVENTS.CONTROLS_REACTIONS_CHANGED, {
+            state: current.reactions
+          });
+        }
+        if (hasViewTheParticipantListChanged) {
+          this.emitScoped({
+            file: 'locus-info',
+            function: 'updateControls'
+          }, _constants.LOCUSINFO.EVENTS.CONTROLS_VIEW_THE_PARTICIPANTS_LIST_CHANGED, {
+            state: current.viewTheParticipantList
+          });
+        }
+        if (hasRaiseHandChanged) {
+          this.emitScoped({
+            file: 'locus-info',
+            function: 'updateControls'
+          }, _constants.LOCUSINFO.EVENTS.CONTROLS_RAISE_HAND_CHANGED, {
+            state: current.raiseHand
+          });
+        }
+        if (hasVideoChanged) {
+          this.emitScoped({
+            file: 'locus-info',
+            function: 'updateControls'
+          }, _constants.LOCUSINFO.EVENTS.CONTROLS_VIDEO_CHANGED, {
+            state: current.video
+          });
+        }
         if (hasRecordingChanged || hasRecordingPausedChanged) {
           var state = null;
           if (hasRecordingPausedChanged) {
@@ -682,16 +848,51 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
             caption: caption
           });
         }
+        if (hasBreakoutChanged) {
+          var breakout = current.breakout;
+          breakout.breakoutMoveId = _selfUtils.default.getReplacedBreakoutMoveId(self, this.webex.internal.device.url);
+          this.emitScoped({
+            file: 'locus-info',
+            function: 'updateControls'
+          }, _constants.LOCUSINFO.EVENTS.CONTROLS_MEETING_BREAKOUT_UPDATED, {
+            breakout: breakout
+          });
+        }
+        if (hasInterpretationChanged) {
+          var interpretation = current.interpretation;
+          this.emitScoped({
+            file: 'locus-info',
+            function: 'updateControls'
+          }, _constants.LOCUSINFO.EVENTS.CONTROLS_MEETING_INTERPRETATION_UPDATED, {
+            interpretation: interpretation
+          });
+        }
         if (hasEntryExitToneChanged) {
           var entryExitTone = current.entryExitTone;
+          this.updateMeeting({
+            entryExitTone: entryExitTone
+          });
           this.emitScoped({
             file: 'locus-info',
             function: 'updateControls'
           }, _constants.LOCUSINFO.EVENTS.CONTROLS_ENTRY_EXIT_TONE_UPDATED, {
             entryExitTone: entryExitTone
           });
+        }
+
+        // videoEnabled is handled differently than other controls,
+        // to fit with audio mute status logic
+        if (hasVideoEnabledChanged) {
+          var videoEnabled = current.videoEnabled;
           this.updateMeeting({
-            entryExitTone: entryExitTone
+            unmuteVideoAllowed: videoEnabled
+          });
+          this.emitScoped({
+            file: 'locus-info',
+            function: 'updateControls'
+          }, _constants.LOCUSINFO.EVENTS.SELF_REMOTE_VIDEO_MUTE_STATUS_UPDATED, {
+            // muted: not part of locus.controls
+            unmuteAllowed: videoEnabled
           });
         }
         this.controls = controls;
@@ -707,12 +908,12 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "updateConversationUrl",
     value: function updateConversationUrl(conversationUrl, info) {
-      if (conversationUrl && !(0, _isEqual2.default)(this.conversationUrl, conversationUrl)) {
+      if (conversationUrl && !(0, _lodash.isEqual)(this.conversationUrl, conversationUrl)) {
         this.conversationUrl = conversationUrl;
         this.updateMeeting({
           conversationUrl: conversationUrl
         });
-      } else if (info && info.conversationUrl && !(0, _isEqual2.default)(this.conversationUrl, info.conversationUrl)) {
+      } else if (info && info.conversationUrl && !(0, _lodash.isEqual)(this.conversationUrl, info.conversationUrl)) {
         this.conversationUrl = info.conversationUrl;
         this.updateMeeting({
           conversationUrl: info.conversationUrl
@@ -728,7 +929,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "updateCreated",
     value: function updateCreated(created) {
-      if (created && !(0, _isEqual2.default)(this.created, created)) {
+      if (created && !(0, _lodash.isEqual)(this.created, created)) {
         this.created = created;
       }
     }
@@ -741,7 +942,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "updateServices",
     value: function updateServices(services) {
-      if (services && !(0, _isEqual2.default)(this.services, services)) {
+      if (services && !(0, _lodash.isEqual)(this.services, services)) {
         this.services = services;
         this.emitScoped({
           file: 'locus-info',
@@ -760,7 +961,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "updateFullState",
     value: function updateFullState(fullState) {
-      if (fullState && !(0, _isEqual2.default)(this.fullState, fullState)) {
+      if (fullState && !(0, _lodash.isEqual)(this.fullState, fullState)) {
         var result = _fullState.default.getFullState(this.fullState, fullState);
         this.updateMeeting(result.current);
         if (result.updates.meetingStateChangedTo) {
@@ -795,7 +996,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "updateHostInfo",
     value: function updateHostInfo(host) {
-      if (host && !(0, _isEqual2.default)(this.host, host)) {
+      if (host && !(0, _lodash.isEqual)(this.host, host)) {
         var parsedHosts = _hostUtils.default.getHosts(this.host, host);
         this.updateMeeting(parsedHosts.current);
         this.parsedLocus.host = parsedHosts.current;
@@ -824,18 +1025,11 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "updateMeetingInfo",
     value: function updateMeetingInfo(info, self) {
-      if (info && !(0, _isEqual2.default)(this.info, info)) {
-        var _this$parsedLocus$sel;
-        var roles = self ? _selfUtils.default.getRoles(self) : ((_this$parsedLocus$sel = this.parsedLocus.self) === null || _this$parsedLocus$sel === void 0 ? void 0 : _this$parsedLocus$sel.roles) || [];
+      var _this$parsedLocus$sel;
+      var roles = self ? _selfUtils.default.getRoles(self) : ((_this$parsedLocus$sel = this.parsedLocus.self) === null || _this$parsedLocus$sel === void 0 ? void 0 : _this$parsedLocus$sel.roles) || [];
+      if (info && !(0, _lodash.isEqual)(this.info, info) || roles.length && !(0, _lodash.isEqual)(this.roles, roles) && info) {
         var isJoined = _selfUtils.default.isJoined(self || this.parsedLocus.self);
         var parsedInfo = _infoUtils.default.getInfos(this.parsedLocus.info, info, roles, isJoined);
-        this.emitScoped({
-          file: 'locus-info',
-          function: 'updateMeetingInfo'
-        }, _constants.LOCUSINFO.EVENTS.MEETING_INFO_UPDATED, {
-          info: parsedInfo.current,
-          self: self
-        });
         if (parsedInfo.updates.isLocked) {
           this.emitScoped({
             file: 'locus-info',
@@ -852,7 +1046,12 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
         this.parsedLocus.info = parsedInfo.current;
         // Parses the info and adds necessary values
         this.updateMeeting(parsedInfo.current);
+        this.emitScoped({
+          file: 'locus-info',
+          function: 'updateMeetingInfo'
+        }, _constants.LOCUSINFO.EVENTS.MEETING_INFO_UPDATED);
       }
+      this.roles = roles;
     }
 
     /**
@@ -888,9 +1087,11 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "updateMediaShares",
     value: function updateMediaShares(mediaShares) {
-      if (mediaShares && !(0, _isEqual2.default)(this.mediaShares, mediaShares)) {
+      if (mediaShares && !(0, _lodash.isEqual)(this.mediaShares, mediaShares)) {
         var parsedMediaShares = _mediaSharesUtils.default.getMediaShares(this.mediaShares, mediaShares);
         this.updateMeeting(parsedMediaShares.current);
+        this.parsedLocus.mediaShares = parsedMediaShares.current;
+        this.mediaShares = mediaShares;
         this.emitScoped({
           file: 'locus-info',
           function: 'updateMediaShares'
@@ -898,8 +1099,6 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
           current: parsedMediaShares.current,
           previous: parsedMediaShares.previous
         });
-        this.parsedLocus.mediaShares = parsedMediaShares.current;
-        this.mediaShares = mediaShares;
       }
     }
 
@@ -911,7 +1110,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "updateParticipantsUrl",
     value: function updateParticipantsUrl(participantsUrl) {
-      if (participantsUrl && !(0, _isEqual2.default)(this.participantsUrl, participantsUrl)) {
+      if (participantsUrl && !(0, _lodash.isEqual)(this.participantsUrl, participantsUrl)) {
         this.participantsUrl = participantsUrl;
       }
     }
@@ -924,7 +1123,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "updateReplace",
     value: function updateReplace(replace) {
-      if (replace && !(0, _isEqual2.default)(this.replace, replace)) {
+      if (replace && !(0, _lodash.isEqual)(this.replace, replace)) {
         this.replace = replace;
       }
     }
@@ -941,7 +1140,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
     key: "updateSelf",
     value: function updateSelf(self, participants) {
       // @ts-ignore - check where this.self come from
-      if (self && !(0, _isEqual2.default)(this.self, self)) {
+      if (self && !(0, _lodash.isEqual)(this.self, self)) {
         // @ts-ignore
         var parsedSelves = _selfUtils.default.getSelves(this.self, self, this.webex.internal.device.url);
         this.updateMeeting(parsedSelves.current);
@@ -970,6 +1169,23 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
             layout: parsedSelves.current.layout
           });
         }
+        if (parsedSelves.updates.breakoutsChanged) {
+          this.emitScoped({
+            file: 'locus-info',
+            function: 'updateSelf'
+          }, _constants.LOCUSINFO.EVENTS.SELF_MEETING_BREAKOUTS_CHANGED, {
+            breakoutSessions: parsedSelves.current.breakoutSessions
+          });
+        }
+        if (parsedSelves.updates.interpretationChanged) {
+          this.emitScoped({
+            file: 'locus-info',
+            function: 'updateSelf'
+          }, _constants.LOCUSINFO.EVENTS.SELF_MEETING_INTERPRETATION_CHANGED, {
+            interpretation: parsedSelves.current.interpretation,
+            selfParticipantId: parsedSelves.current.selfId
+          });
+        }
         if (parsedSelves.updates.isMediaInactiveOrReleased) {
           this.emitScoped({
             file: 'locus-info',
@@ -984,6 +1200,26 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
             function: 'updateSelf'
           }, _constants.LOCUSINFO.EVENTS.SELF_MODERATOR_CHANGED, self);
         }
+        if (parsedSelves.updates.isRolesChanged) {
+          var _parsedSelves$previou, _parsedSelves$current;
+          this.emitScoped({
+            file: 'locus-info',
+            function: 'updateSelf'
+          }, _constants.LOCUSINFO.EVENTS.SELF_ROLES_CHANGED, {
+            oldRoles: (_parsedSelves$previou = parsedSelves.previous) === null || _parsedSelves$previou === void 0 ? void 0 : _parsedSelves$previou.roles,
+            newRoles: (_parsedSelves$current = parsedSelves.current) === null || _parsedSelves$current === void 0 ? void 0 : _parsedSelves$current.roles
+          });
+        }
+        if (parsedSelves.updates.isVideoMutedByOthersChanged) {
+          this.emitScoped({
+            file: 'locus-info',
+            function: 'updateSelf'
+          }, _constants.LOCUSINFO.EVENTS.SELF_REMOTE_VIDEO_MUTE_STATUS_UPDATED, {
+            muted: parsedSelves.current.remoteVideoMuted
+            // unmuteAllowed: not part of .self
+          });
+        }
+
         if (parsedSelves.updates.localAudioUnmuteRequiredByServer) {
           this.emitScoped({
             file: 'locus-info',
@@ -1029,14 +1265,14 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
           _constants.LOCUSINFO.EVENTS.MEDIA_INACTIVITY, _selfUtils.default.getMediaStatus(self.mediaSessions));
         }
         if (parsedSelves.updates.audioStateChange || parsedSelves.updates.videoStateChange || parsedSelves.updates.shareStateChange) {
-          var _parsedSelves$current, _parsedSelves$current2, _parsedSelves$current3;
+          var _parsedSelves$current2, _parsedSelves$current3, _parsedSelves$current4;
           this.emitScoped({
             file: 'locus-info',
             function: 'updateSelf'
           }, _constants.LOCUSINFO.EVENTS.MEDIA_STATUS_CHANGE, {
-            audioStatus: (_parsedSelves$current = parsedSelves.current.currentMediaStatus) === null || _parsedSelves$current === void 0 ? void 0 : _parsedSelves$current.audio,
-            videoStatus: (_parsedSelves$current2 = parsedSelves.current.currentMediaStatus) === null || _parsedSelves$current2 === void 0 ? void 0 : _parsedSelves$current2.video,
-            shareStatus: (_parsedSelves$current3 = parsedSelves.current.currentMediaStatus) === null || _parsedSelves$current3 === void 0 ? void 0 : _parsedSelves$current3.share
+            audioStatus: (_parsedSelves$current2 = parsedSelves.current.currentMediaStatus) === null || _parsedSelves$current2 === void 0 ? void 0 : _parsedSelves$current2.audio,
+            videoStatus: (_parsedSelves$current3 = parsedSelves.current.currentMediaStatus) === null || _parsedSelves$current3 === void 0 ? void 0 : _parsedSelves$current3.video,
+            shareStatus: (_parsedSelves$current4 = parsedSelves.current.currentMediaStatus) === null || _parsedSelves$current4 === void 0 ? void 0 : _parsedSelves$current4.share
           });
         }
         if (parsedSelves.updates.isUserObserving) {
@@ -1105,7 +1341,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "updateAclUrl",
     value: function updateAclUrl(aclUrl) {
-      if (aclUrl && !(0, _isEqual2.default)(this.aclUrl, aclUrl)) {
+      if (aclUrl && !(0, _lodash.isEqual)(this.aclUrl, aclUrl)) {
         this.aclUrl = aclUrl;
       }
     }
@@ -1118,7 +1354,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "updateBasequence",
     value: function updateBasequence(baseSequence) {
-      if (baseSequence && !(0, _isEqual2.default)(this.baseSequence, baseSequence)) {
+      if (baseSequence && !(0, _lodash.isEqual)(this.baseSequence, baseSequence)) {
         this.baseSequence = baseSequence;
       }
     }
@@ -1131,7 +1367,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "updateSequence",
     value: function updateSequence(sequence) {
-      if (sequence && !(0, _isEqual2.default)(this.sequence, sequence)) {
+      if (sequence && !(0, _lodash.isEqual)(this.sequence, sequence)) {
         this.sequence = sequence;
       }
     }
@@ -1144,7 +1380,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "updateMemberShip",
     value: function updateMemberShip(membership) {
-      if (membership && !(0, _isEqual2.default)(this.membership, membership)) {
+      if (membership && !(0, _lodash.isEqual)(this.membership, membership)) {
         this.membership = membership;
       }
     }
@@ -1157,12 +1393,117 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "updateIdentifiers",
     value: function updateIdentifiers(identities) {
-      if (identities && !(0, _isEqual2.default)(this.identities, identities)) {
+      if (identities && !(0, _lodash.isEqual)(this.identities, identities)) {
         this.identities = identities;
       }
     }
+
+    /**
+     * check the locus is main session's one or not, if is main session's, update main session cache
+     * @param {Object} locus
+     * @returns {undefined}
+     * @memberof LocusInfo
+     */
+  }, {
+    key: "updateLocusCache",
+    value: function updateLocusCache(locus) {
+      var isMainSessionDTO = _controlsUtils.default.isMainSessionDTO(locus);
+      if (isMainSessionDTO) {
+        this.updateMainSessionLocusCache(locus);
+      }
+    }
+
+    /**
+     * if return from breakout to main session, need to use cached main session DTO since locus won't send the full locus (participants)
+     * if join breakout from main session, need to query main locus url (if response with 403 means no privilege, need to clear the cache)
+     * @param {Object} newLocus
+     * @returns {Object}
+     * @memberof LocusInfo
+     */
+  }, {
+    key: "getTheLocusToUpdate",
+    value: function getTheLocusToUpdate(newLocus) {
+      var switchStatus = _controlsUtils.default.getSessionSwitchStatus(this.controls, newLocus === null || newLocus === void 0 ? void 0 : newLocus.controls);
+      if (switchStatus.isReturnToMain && this.mainSessionLocusCache) {
+        return (0, _lodash.cloneDeep)(this.mainSessionLocusCache);
+      }
+      if (switchStatus.isJoinToBreakout) {
+        this.emitScoped({
+          file: 'locus-info',
+          function: 'updateControls'
+        }, _constants.LOCUSINFO.EVENTS.CONTROLS_JOIN_BREAKOUT_FROM_MAIN, {
+          mainLocusUrl: this.url
+        });
+      }
+      return newLocus;
+    }
+
+    /**
+     * merge participants by participant id
+     * @param {Array} participants
+     * @param {Array} sourceParticipants
+     * @returns {Array} merged participants
+     * @memberof LocusInfo
+     */
+    // eslint-disable-next-line class-methods-use-this
+  }, {
+    key: "mergeParticipants",
+    value: function mergeParticipants(participants, sourceParticipants) {
+      if (!sourceParticipants || !sourceParticipants.length) return participants;
+      if (!participants || !participants.length) {
+        return sourceParticipants;
+      }
+      sourceParticipants.forEach(function (participant) {
+        var existIndex = participants.findIndex(function (p) {
+          return p.id === participant.id;
+        });
+        if (existIndex > -1) {
+          participants.splice(existIndex, 1, participant);
+        } else {
+          participants.push(participant);
+        }
+      });
+      return participants;
+    }
+
+    /**
+     * need cache main sessions' participants since locus will not send the full list when cohost/host leave breakout
+     * @param {Object} mainLocus
+     * @returns {undefined}
+     * @memberof LocusInfo
+     */
+  }, {
+    key: "updateMainSessionLocusCache",
+    value: function updateMainSessionLocusCache(mainLocus) {
+      var _this5 = this;
+      if (!mainLocus) {
+        return;
+      }
+      var locusClone = (0, _lodash.cloneDeep)(mainLocus);
+      if (this.mainSessionLocusCache) {
+        // shallow merge and do special merge for participants
+        (0, _lodash.assignWith)(this.mainSessionLocusCache, locusClone, function (objValue, srcValue, key) {
+          if (key === 'participants') {
+            return _this5.mergeParticipants(objValue, srcValue);
+          }
+          return srcValue || objValue;
+        });
+      } else {
+        this.mainSessionLocusCache = locusClone;
+      }
+    }
+
+    /**
+     * clear main session cache
+     * @returns {undefined}
+     * @memberof LocusInfo
+     */
+  }, {
+    key: "clearMainSessionLocusCache",
+    value: function clearMainSessionLocusCache() {
+      this.mainSessionLocusCache = null;
+    }
   }]);
   return LocusInfo;
 }(_eventsScope.default);
-exports.default = LocusInfo;
 //# sourceMappingURL=index.js.map