@webex/plugin-meetings 3.0.0-beta.17 → 3.0.0-beta.171

package/dist/locus-info/index.js

@@ -15,12 +15,12 @@ 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 _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"));
@@ -40,6 +40,13 @@ function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !_R
 var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   (0, _inherits2.default)(LocusInfo, _EventsScope);
   var _super = _createSuper(LocusInfo);
+  /**
+   * Constructor
+   * @param {boolean} updateMeeting true if the meeting should be updated
+   * @param {object} webex
+   * @param {string} meetingId
+   * @returns {undefined}
+   */
   function LocusInfo(updateMeeting, webex, meetingId) {
     var _this;
     (0, _classCallCheck2.default)(this, LocusInfo);
@@ -68,9 +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: []
     };
@@ -109,7 +119,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
         case DESYNC:
           meeting.meetingRequest.getFullLocus({
             desync: true,
-            locusUrl: meeting.locusUrl
+            locusUrl: locus.url ? locus.url : meeting.locusUrl
           }).then(function (res) {
             meeting.locusInfo.onFullLocus(res.body);
             // Notify parser to resume processing delta events
@@ -154,6 +164,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "init",
     value: function init() {
+      var _locus$links;
       var locus = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
       this.created = locus.created || null;
       this.scheduledMeeting = locus.meeting || null;
@@ -184,13 +195,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);
@@ -199,6 +210,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
       this.updateSelf(locus.self, locus.participants);
       this.updateHostInfo(locus.host);
       this.updateMediaShares(locus.mediaShares);
+      this.updateServices((_locus$links = locus.links) === null || _locus$links === void 0 ? void 0 : _locus$links.services);
     }
 
     /**
@@ -209,6 +221,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
@@ -226,6 +239,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:
@@ -242,15 +256,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);
       }
     }
 
@@ -284,8 +298,9 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
       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);
@@ -337,8 +352,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();
     }
 
@@ -350,7 +366,14 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
   }, {
     key: "updateLocusInfo",
     value: function updateLocusInfo(locus) {
-      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);
@@ -367,6 +390,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
       this.updateMemberShip(locus.membership);
       this.updateIdentifiers(locus.identities);
       this.updateEmbeddedApps(locus.embeddedApps);
+      this.updateServices((_locus$links2 = locus.links) === null || _locus$links2 === void 0 ? void 0 : _locus$links2.services);
       this.compareAndUpdate();
       // update which required to compare different objects from locus
     }
@@ -415,9 +439,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',
@@ -427,9 +455,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',
@@ -440,9 +471,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',
@@ -457,9 +491,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',
@@ -470,9 +508,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',
@@ -595,15 +637,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',
@@ -613,18 +655,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),
@@ -634,7 +678,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) {
@@ -677,16 +788,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;
@@ -728,6 +874,25 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
       }
     }
 
+    /**
+     * @param {Object} services
+     * @returns {undefined}
+     * @memberof LocusInfo
+     */
+  }, {
+    key: "updateServices",
+    value: function updateServices(services) {
+      if (services && !(0, _isEqual2.default)(this.services, services)) {
+        this.services = services;
+        this.emitScoped({
+          file: 'locus-info',
+          function: 'updateServices'
+        }, _constants.LOCUSINFO.EVENTS.LINKS_SERVICES, {
+          services: services
+        });
+      }
+    }
+
     /**
      * @param {Object} fullState
      * @returns {undefined}
@@ -800,9 +965,9 @@ 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({
@@ -829,6 +994,7 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
         // Parses the info and adds necessary values
         this.updateMeeting(parsedInfo.current);
       }
+      this.roles = roles;
     }
 
     /**
@@ -867,6 +1033,8 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
       if (mediaShares && !(0, _isEqual2.default)(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'
@@ -874,8 +1042,6 @@ var LocusInfo = /*#__PURE__*/function (_EventsScope) {
           current: parsedMediaShares.current,
           previous: parsedMediaShares.previous
         });
-        this.parsedLocus.mediaShares = parsedMediaShares.current;
-        this.mediaShares = mediaShares;
       }
     }
 
@@ -946,6 +1112,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',
@@ -960,6 +1143,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',
@@ -1005,14 +1208,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) {
@@ -1137,6 +1340,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, 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, _cloneDeep2.default)(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, _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);