@webex/plugin-meetings 3.0.0-beta.39 → 3.0.0-beta.391

package/dist/locus-info/index.js

@@ -15,12 +15,13 @@ 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 _isEmpty2 = _interopRequireDefault(require("lodash/isEmpty"));
+var _cloneDeep2 = _interopRequireDefault(require("lodash/cloneDeep"));
+var _assignWith2 = _interopRequireDefault(require("lodash/assignWith"));
 var _isEqual2 = _interopRequireDefault(require("lodash/isEqual"));
 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 +30,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; } }
 /**
@@ -40,6 +43,13 @@ function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !_R
 var LocusInfo = /*#__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 +78,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 +97,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, _isEmpty2.default)(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 +255,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 +281,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 +299,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 +316,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 +348,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 +415,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();
     }
 
@@ -360,7 +436,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
         // as it gets interpreted as if we have left the call
         return;
       }
-      this.updateControls(locus.controls);
+      this.updateControls(locus.controls, locus.self);
       this.updateConversationUrl(locus.conversationUrl, locus.info);
       this.updateCreated(locus.created);
       this.updateFullState(locus.fullState);
@@ -426,9 +502,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',
@@ -438,9 +518,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',
@@ -451,9 +534,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',
@@ -468,9 +554,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',
@@ -481,9 +571,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',
@@ -606,15 +700,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',
@@ -624,18 +718,20 @@ 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) {
+    value: function updateControls(controls, self) {
       if (controls && !(0, _isEqual2.default)(this.controls, controls)) {
         this.parsedLocus.controls = _controlsUtils.default.parse(controls);
         var _ControlsUtils$getCon = _controlsUtils.default.getControls(this.controls, controls),
@@ -646,7 +742,73 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
           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) {
@@ -691,6 +853,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
         }
         if (hasBreakoutChanged) {
           var breakout = current.breakout;
+          breakout.breakoutMoveId = _selfUtils.default.getReplacedBreakoutMoveId(self, this.webex.internal.device.url);
           this.emitScoped({
             file: 'locus-info',
             function: 'updateControls'
@@ -698,16 +861,41 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
             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;
@@ -840,18 +1028,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, _isEqual2.default)(this.info, info) || roles.length && !(0, _isEqual2.default)(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',
@@ -868,7 +1049,15 @@ 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, {
+          isInitializing: !self // if self is undefined, then the update is caused by locus init
+        });
       }
+
+      this.roles = roles;
     }
 
     /**
@@ -994,6 +1183,15 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
             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',
@@ -1008,6 +1206,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',
@@ -1053,14 +1271,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) {
@@ -1185,6 +1403,112 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
         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, main session is not active for the attendee and remove main session locus 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, _cloneDeep2.default)(this.mainSessionLocusCache);
+      }
+      var isMainSessionDTO = this.mainSessionLocusCache && _controlsUtils.default.isMainSessionDTO(this.mainSessionLocusCache);
+      if (isMainSessionDTO) {
+        var _this$fullState, _this$mainSessionLocu, _this$mainSessionLocu2;
+        var isActive = [_constants.LOCUS.STATE.ACTIVE, _constants.LOCUS.STATE.INITIALIZING, _constants.LOCUS.STATE.TERMINATING].includes((_this$fullState = this.fullState) === null || _this$fullState === void 0 ? void 0 : _this$fullState.state) && !((_this$mainSessionLocu = this.mainSessionLocusCache) !== null && _this$mainSessionLocu !== void 0 && (_this$mainSessionLocu2 = _this$mainSessionLocu.self) !== null && _this$mainSessionLocu2 !== void 0 && _this$mainSessionLocu2.removed);
+        if (!isActive) {
+          this.clearMainSessionLocusCache();
+        }
+      }
+      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, _cloneDeep2.default)(mainLocus);
+      if (this.mainSessionLocusCache) {
+        // shallow merge and do special merge for participants
+        (0, _assignWith2.default)(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);