@webex/plugin-meetings 3.0.0-beta.7 → 3.0.0-beta.71

package/src/locus-info/{selfUtils.js → selfUtils.ts}

@@ -1,4 +1,6 @@
+/* eslint-disable default-param-last */
 
+import {isEqual} from 'lodash';
 import {
   _IDLE_,
   _JOINED_,
@@ -11,11 +13,12 @@ import {
   MEDIA_STATE,
   AUDIO,
   VIDEO,
-  MediaContent
+  MediaContent,
+  SELF_ROLES,
 } from '../constants';
 import ParameterError from '../common/errors/parameter';
 
-const SelfUtils = {};
+const SelfUtils: any = {};
 const PSTN_DEVICE_TYPE = 'PROVISIONAL';
 
 /**
@@ -24,12 +27,13 @@ const PSTN_DEVICE_TYPE = 'PROVISIONAL';
  * @param {String} deviceId
  * @returns {undefined}
  */
-SelfUtils.parse = (self, deviceId) => {
+SelfUtils.parse = (self: any, deviceId: string) => {
   if (self) {
     const joinedWith = self.devices.find((device) => deviceId === device.url);
     const pstnDevices = self.devices.filter((device) => PSTN_DEVICE_TYPE === device.deviceType);
 
     return {
+      remoteVideoMuted: SelfUtils.getRemoteVideoMuted(self),
       remoteMuted: SelfUtils.getRemoteMuted(self),
       unmuteAllowed: SelfUtils.getUnmuteAllowed(self),
       localAudioUnmuteRequested: SelfUtils.getLocalAudioUnmuteRequested(self),
@@ -48,9 +52,7 @@ SelfUtils.parse = (self, deviceId) => {
       joinedWith,
       pstnDevices,
       // current media stats is for the current device who has joined
-      currentMediaStatus: SelfUtils.getMediaStatus(
-        joinedWith?.mediaSessions
-      ),
+      currentMediaStatus: SelfUtils.getMediaStatus(joinedWith?.mediaSessions),
       creator: self.isCreator, // check if its used,
       selfId: self.id,
       selfIdentity: SelfUtils.getSelfIdentity(self),
@@ -60,22 +62,27 @@ SelfUtils.parse = (self, deviceId) => {
       isUserUnadmitted: self.state === _IDLE_ && joinedWith?.intent?.type === _WAIT_,
       layout: SelfUtils.getLayout(self),
       canNotViewTheParticipantList: SelfUtils.canNotViewTheParticipantList(self),
-      isSharingBlocked: SelfUtils.isSharingBlocked(self)
+      isSharingBlocked: SelfUtils.isSharingBlocked(self),
+      breakoutSessions: SelfUtils.getBreakouts(self),
     };
   }
 
   return null;
 };
 
-SelfUtils.getLayout = (self) => (Array.isArray(self?.controls?.layouts) ? self.controls.layouts[0].type : undefined);
+SelfUtils.getBreakouts = (self) => self?.controls?.breakout?.sessions;
 
-SelfUtils.getRoles = (self) => (self?.controls?.role?.roles || []).reduce((roles, role) => {
-  if (role.hasRole) {
-    roles.push(role.type);
-  }
+SelfUtils.getLayout = (self) =>
+  Array.isArray(self?.controls?.layouts) ? self.controls.layouts[0].type : undefined;
+
+SelfUtils.getRoles = (self) =>
+  (self?.controls?.role?.roles || []).reduce((roles, role) => {
+    if (role.hasRole) {
+      roles.push(role.type);
+    }
 
-  return roles;
-}, []);
+    return roles;
+  }, []);
 
 SelfUtils.canNotViewTheParticipantList = (self) => !!self?.canNotViewTheParticipantList;
 
@@ -84,30 +91,43 @@ SelfUtils.isSharingBlocked = (self) => !!self?.isSharingBlocked;
 SelfUtils.getSelves = (oldSelf, newSelf, deviceId) => {
   const previous = oldSelf && SelfUtils.parse(oldSelf, deviceId);
   const current = newSelf && SelfUtils.parse(newSelf, deviceId);
-  const updates = {};
+  const updates: any = {};
 
   updates.isUserUnadmitted = SelfUtils.isUserUnadmitted(current);
   updates.isUserAdmitted = SelfUtils.isUserAdmitted(previous, current);
+  updates.isVideoMutedByOthersChanged = SelfUtils.videoMutedByOthersChanged(previous, current);
   updates.isMutedByOthersChanged = SelfUtils.mutedByOthersChanged(previous, current);
-  updates.localAudioUnmuteRequestedByServer = SelfUtils.localAudioUnmuteRequestedByServer(previous, current);
-  updates.localAudioUnmuteRequiredByServer = SelfUtils.localAudioUnmuteRequiredByServer(previous, current);
+  updates.localAudioUnmuteRequestedByServer = SelfUtils.localAudioUnmuteRequestedByServer(
+    previous,
+    current
+  );
+  updates.localAudioUnmuteRequiredByServer = SelfUtils.localAudioUnmuteRequiredByServer(
+    previous,
+    current
+  );
   updates.moderatorChanged = SelfUtils.moderatorChanged(previous, current);
+  updates.isUpgradeToModeratorOrCohost = SelfUtils.isUpgradeToModeratorOrCohost(previous, current);
   updates.isMediaInactiveOrReleased = SelfUtils.wasMediaInactiveOrReleased(previous, current);
   updates.isUserObserving = SelfUtils.isDeviceObserving(previous, current);
   updates.layoutChanged = SelfUtils.layoutChanged(previous, current);
 
   updates.isMediaInactive = SelfUtils.isMediaInactive(previous, current);
-  updates.audioStateChange = previous?.currentMediaStatus.audio !== current.currentMediaStatus.audio;
-  updates.videoStateChange = previous?.currentMediaStatus.video !== current.currentMediaStatus.video;
-  updates.shareStateChange = previous?.currentMediaStatus.share !== current.currentMediaStatus.share;
-
-  updates.canNotViewTheParticipantListChanged = previous?.canNotViewTheParticipantList !== current.canNotViewTheParticipantList;
+  updates.audioStateChange =
+    previous?.currentMediaStatus.audio !== current.currentMediaStatus.audio;
+  updates.videoStateChange =
+    previous?.currentMediaStatus.video !== current.currentMediaStatus.video;
+  updates.shareStateChange =
+    previous?.currentMediaStatus.share !== current.currentMediaStatus.share;
+
+  updates.canNotViewTheParticipantListChanged =
+    previous?.canNotViewTheParticipantList !== current.canNotViewTheParticipantList;
   updates.isSharingBlockedChanged = previous?.isSharingBlocked !== current.isSharingBlocked;
+  updates.breakoutsChanged = SelfUtils.breakoutsChanged(previous, current);
 
   return {
     previous,
     current,
-    updates
+    updates,
   };
 };
 
@@ -115,8 +135,8 @@ SelfUtils.getSelves = (oldSelf, newSelf, deviceId) => {
  * Checks if user has joined the meeting
  * @param {Object} self
  * @returns {boolean} isJoined
-*/
-SelfUtils.isJoined = (self) => self?.state === _JOINED_;
+ */
+SelfUtils.isJoined = (self: any) => self?.state === _JOINED_;
 
 /**
  * Validate if the Meeting Layout Controls Layout has changed.
@@ -125,8 +145,11 @@ SelfUtils.isJoined = (self) => self?.state === _JOINED_;
  * @param {Self} current - Current self state [per event]
  * @returns {boolean} - If the MEeting Layout Controls Layout has changed.
  */
-SelfUtils.layoutChanged = (previous, current) => current?.layout && previous?.layout !== current?.layout;
+SelfUtils.layoutChanged = (previous: any, current: any) =>
+  current?.layout && previous?.layout !== current?.layout;
 
+SelfUtils.breakoutsChanged = (previous, current) =>
+  !isEqual(previous?.breakoutSessions, current?.breakoutSessions);
 
 SelfUtils.isMediaInactive = (previous, current) => {
   if (
@@ -137,15 +160,12 @@ SelfUtils.isMediaInactive = (previous, current) => {
     current.joinedWith &&
     current.joinedWith.mediaSessions
   ) {
-    const previousMediaStatus = SelfUtils.getMediaStatus(
-      previous.joinedWith.mediaSessions
-    );
-    const currentMediaStatus = SelfUtils.getMediaStatus(
-      current.joinedWith.mediaSessions
-    );
+    const previousMediaStatus = SelfUtils.getMediaStatus(previous.joinedWith.mediaSessions);
+    const currentMediaStatus = SelfUtils.getMediaStatus(current.joinedWith.mediaSessions);
 
     if (
-      previousMediaStatus.audio && currentMediaStatus.audio &&
+      previousMediaStatus.audio &&
+      currentMediaStatus.audio &&
       previousMediaStatus.audio.state !== MEDIA_STATE.inactive &&
       currentMediaStatus.audio.state === MEDIA_STATE.inactive &&
       currentMediaStatus.audio.direction !== MEDIA_STATE.inactive
@@ -154,7 +174,8 @@ SelfUtils.isMediaInactive = (previous, current) => {
     }
 
     if (
-      previousMediaStatus.video && currentMediaStatus.video &&
+      previousMediaStatus.video &&
+      currentMediaStatus.video &&
       previousMediaStatus.video.state !== MEDIA_STATE.inactive &&
       currentMediaStatus.video.state === MEDIA_STATE.inactive &&
       currentMediaStatus.video.direction !== MEDIA_STATE.inactive
@@ -163,7 +184,8 @@ SelfUtils.isMediaInactive = (previous, current) => {
     }
 
     if (
-      previousMediaStatus.share && currentMediaStatus.share &&
+      previousMediaStatus.share &&
+      currentMediaStatus.share &&
       previousMediaStatus.share.state !== MEDIA_STATE.inactive &&
       currentMediaStatus.share.state === MEDIA_STATE.inactive &&
       currentMediaStatus.share.direction !== MEDIA_STATE.inactive
@@ -178,7 +200,13 @@ SelfUtils.isMediaInactive = (previous, current) => {
 };
 
 SelfUtils.getLastModified = (self) => {
-  if (!self || !self.controls || !self.controls.audio || !self.controls.audio.meta || !self.controls.audio.meta.lastModified) {
+  if (
+    !self ||
+    !self.controls ||
+    !self.controls.audio ||
+    !self.controls.audio.meta ||
+    !self.controls.audio.meta.lastModified
+  ) {
     return null;
   }
 
@@ -186,7 +214,13 @@ SelfUtils.getLastModified = (self) => {
 };
 
 SelfUtils.getModifiedBy = (self) => {
-  if (!self || !self.controls || !self.controls.audio || !self.controls.audio.meta || !self.controls.audio.meta.modifiedBy) {
+  if (
+    !self ||
+    !self.controls ||
+    !self.controls.audio ||
+    !self.controls.audio.meta ||
+    !self.controls.audio.meta.modifiedBy
+  ) {
     return null;
   }
 
@@ -198,7 +232,7 @@ SelfUtils.getModifiedBy = (self) => {
  * @param {Object} self
  * @returns {String}
  */
-SelfUtils.getSelfIdentity = (self) => {
+SelfUtils.getSelfIdentity = (self: any) => {
   if (!self && !self.person) {
     return null;
   }
@@ -206,12 +240,25 @@ SelfUtils.getSelfIdentity = (self) => {
   return self.person.id;
 };
 
+/**
+ * get the "remote video mute" property from the self object
+ * @param {Object} self
+ * @returns {Boolean}
+ */
+SelfUtils.getRemoteVideoMuted = (self: any) => {
+  if (!self || !self.controls || !self.controls.video) {
+    return null;
+  }
+
+  return self.controls.video.muted;
+};
+
 /**
  * get the "remote mute" property from the self object
  * @param {Object} self
  * @returns {Boolean}
  */
-SelfUtils.getRemoteMuted = (self) => {
+SelfUtils.getRemoteMuted = (self: any) => {
   if (!self || !self.controls || !self.controls.audio) {
     return null;
   }
@@ -229,43 +276,46 @@ SelfUtils.getUnmuteAllowed = (self) => {
   return !self.controls.audio.disallowUnmute;
 };
 
-
 SelfUtils.getLocalAudioUnmuteRequired = (self) => !!self?.controls?.audio?.localAudioUnmuteRequired;
 
 SelfUtils.getStatus = (status) => ({
   audio: status.audioStatus,
   video: status.videoStatus,
-  slides: status.videoSlidesStatus
+  slides: status.videoSlidesStatus,
 });
 
-
 /**
  * @param {Object} oldSelf
  * @param {Object} changedSelf
  * @returns {Boolean}
  */
-SelfUtils.wasMediaInactiveOrReleased = (oldSelf = {}, changedSelf) => oldSelf.joinedWith && oldSelf.joinedWith.state === _JOINED_ && changedSelf.joinedWith.state === _LEFT_ &&
- (changedSelf.joinedWith.reason === MEETING_END_REASON.INACTIVE || changedSelf.joinedWith.reason === MEETING_END_REASON.MEDIA_RELEASED);
-
+SelfUtils.wasMediaInactiveOrReleased = (oldSelf: any = {}, changedSelf: any) =>
+  oldSelf.joinedWith &&
+  oldSelf.joinedWith.state === _JOINED_ &&
+  changedSelf.joinedWith.state === _LEFT_ &&
+  (changedSelf.joinedWith.reason === MEETING_END_REASON.INACTIVE ||
+    changedSelf.joinedWith.reason === MEETING_END_REASON.MEDIA_RELEASED);
 
 /**
  * @param {Object} check
  * @returns {Boolean}
  */
-SelfUtils.isLocusUserUnadmitted = (check) => check && check.joinedWith?.intent?.type === _WAIT_ && check.state === _IDLE_;
+SelfUtils.isLocusUserUnadmitted = (check: any) =>
+  check && check.joinedWith?.intent?.type === _WAIT_ && check.state === _IDLE_;
 
 /**
  * @param {Object} check
  * @returns {Boolean}
  */
-SelfUtils.isLocusUserAdmitted = (check) => check && check.joinedWith?.intent?.type !== _WAIT_ && check.state === _JOINED_;
+SelfUtils.isLocusUserAdmitted = (check: any) =>
+  check && check.joinedWith?.intent?.type !== _WAIT_ && check.state === _JOINED_;
 
 /**
  * @param {Object} self
  * @returns {Boolean}
  * @throws {Error} when self is undefined
  */
-SelfUtils.isUserUnadmitted = (self) => {
+SelfUtils.isUserUnadmitted = (self: object) => {
   if (!self) {
     throw new ParameterError('self must be defined to determine if self is unadmitted as guest.');
   }
@@ -278,12 +328,38 @@ SelfUtils.moderatorChanged = (oldSelf, changedSelf) => {
     return true;
   }
   if (!changedSelf) {
-    throw new ParameterError('New self must be defined to determine if self transitioned moderator status.');
+    throw new ParameterError(
+      'New self must be defined to determine if self transitioned moderator status.'
+    );
   }
 
   return oldSelf.moderator !== changedSelf.moderator;
 };
 
+/**
+ * @param {Object} oldSelf
+ * @param {Object} changedSelf
+ * @returns {Boolean}
+ * @throws {Error} if changed self was undefined
+ */
+SelfUtils.isUpgradeToModeratorOrCohost = (oldSelf, changedSelf) => {
+  if (!oldSelf) {
+    return false;
+  }
+  if (!changedSelf) {
+    throw new ParameterError(
+      'New self must be defined to determine if self transitioned moderator or cohost status.'
+    );
+  }
+  const isAttendeeOnly =
+    oldSelf.roles.includes(SELF_ROLES.ATTENDEE) &&
+    !oldSelf.roles.includes(SELF_ROLES.COHOST) &&
+    !oldSelf.roles.includes(SELF_ROLES.MODERATOR);
+  const isCohost = changedSelf.roles.includes(SELF_ROLES.COHOST);
+  const isModerator = changedSelf.roles.includes(SELF_ROLES.MODERATOR);
+
+  return isAttendeeOnly && (isCohost || isModerator);
+};
 
 /**
  * @param {Object} oldSelf
@@ -291,7 +367,11 @@ SelfUtils.moderatorChanged = (oldSelf, changedSelf) => {
  * @returns {Boolean}
  * @throws {Error} if changed self was undefined
  */
-SelfUtils.isDeviceObserving = (oldSelf, changedSelf) => oldSelf && oldSelf.joinedWith?.intent?.type === _MOVE_MEDIA_ && changedSelf && changedSelf.joinedWith?.intent?.type === _OBSERVE_;
+SelfUtils.isDeviceObserving = (oldSelf: any, changedSelf: any) =>
+  oldSelf &&
+  oldSelf.joinedWith?.intent?.type === _MOVE_MEDIA_ &&
+  changedSelf &&
+  changedSelf.joinedWith?.intent?.type === _OBSERVE_;
 
 /**
  * @param {Object} oldSelf
@@ -299,24 +379,45 @@ SelfUtils.isDeviceObserving = (oldSelf, changedSelf) => oldSelf && oldSelf.joine
  * @returns {Boolean}
  * @throws {Error} if changed self was undefined
  */
-SelfUtils.isUserAdmitted = (oldSelf, changedSelf) => {
+SelfUtils.isUserAdmitted = (oldSelf: object, changedSelf: object) => {
   if (!oldSelf) {
     // if there was no previous locus, it couldn't have been admitted yet
     return false;
   }
   if (!changedSelf) {
-    throw new ParameterError('New self must be defined to determine if self transitioned to admitted as guest.');
+    throw new ParameterError(
+      'New self must be defined to determine if self transitioned to admitted as guest.'
+    );
   }
 
   return SelfUtils.isLocusUserUnadmitted(oldSelf) && SelfUtils.isLocusUserAdmitted(changedSelf);
 };
 
+SelfUtils.videoMutedByOthersChanged = (oldSelf, changedSelf) => {
+  if (!changedSelf) {
+    throw new ParameterError(
+      'New self must be defined to determine if self was video muted by others.'
+    );
+  }
+
+  if (!oldSelf || oldSelf.remoteVideoMuted === null) {
+    if (changedSelf.remoteVideoMuted) {
+      return true; // this happens when host disables "Allow start video"
+    }
+
+    // we don't want to be sending the 'meeting:self:videoUnmutedByOthers' notification on meeting join
+    return false;
+  }
+
+  return oldSelf.remoteVideoMuted !== changedSelf.remoteVideoMuted;
+};
+
 SelfUtils.mutedByOthersChanged = (oldSelf, changedSelf) => {
   if (!changedSelf) {
     throw new ParameterError('New self must be defined to determine if self was muted by others.');
   }
 
-  if (!oldSelf || (oldSelf.remoteMuted === null)) {
+  if (!oldSelf || oldSelf.remoteMuted === null) {
     if (changedSelf.remoteMuted) {
       return true; // this happens when mute on-entry is enabled
     }
@@ -325,25 +426,35 @@ SelfUtils.mutedByOthersChanged = (oldSelf, changedSelf) => {
     return false;
   }
 
-  return (changedSelf.remoteMuted !== null) &&
-    ((oldSelf.remoteMuted !== changedSelf.remoteMuted) || (changedSelf.remoteMuted && (oldSelf.unmuteAllowed !== changedSelf.unmuteAllowed)));
+  return (
+    changedSelf.remoteMuted !== null &&
+    (oldSelf.remoteMuted !== changedSelf.remoteMuted ||
+      (changedSelf.remoteMuted && oldSelf.unmuteAllowed !== changedSelf.unmuteAllowed))
+  );
 };
 
-SelfUtils.localAudioUnmuteRequestedByServer = (oldSelf = {}, changedSelf) => {
+SelfUtils.localAudioUnmuteRequestedByServer = (oldSelf: any = {}, changedSelf: any) => {
   if (!changedSelf) {
-    throw new ParameterError('New self must be defined to determine if self received request to unmute.');
+    throw new ParameterError(
+      'New self must be defined to determine if self received request to unmute.'
+    );
   }
 
   return changedSelf.localAudioUnmuteRequested && !oldSelf.localAudioUnmuteRequested;
 };
 
-
-SelfUtils.localAudioUnmuteRequiredByServer = (oldSelf = {}, changedSelf) => {
+SelfUtils.localAudioUnmuteRequiredByServer = (oldSelf: any = {}, changedSelf: any) => {
   if (!changedSelf) {
-    throw new ParameterError('New self must be defined to determine if localAudioUnmuteRequired changed.');
+    throw new ParameterError(
+      'New self must be defined to determine if localAudioUnmuteRequired changed.'
+    );
   }
 
-  return !changedSelf.remoteMuted && changedSelf.localAudioUnmuteRequired && (oldSelf.localAudioUnmuteRequired !== changedSelf.localAudioUnmuteRequired);
+  return (
+    !changedSelf.remoteMuted &&
+    changedSelf.localAudioUnmuteRequired &&
+    oldSelf.localAudioUnmuteRequired !== changedSelf.localAudioUnmuteRequired
+  );
 };
 
 /**
@@ -353,7 +464,7 @@ SelfUtils.localAudioUnmuteRequiredByServer = (oldSelf = {}, changedSelf) => {
  * @returns {Object}
  */
 
-SelfUtils.getSipUrl = (partner, type, sipUri) => {
+SelfUtils.getSipUrl = (partner: any, type, sipUri) => {
   // For webex meeting the sipUrl gets updated in info parser
   if (partner && type === _CALL_) {
     return {sipUri: partner.person.sipUrl || partner.person.id};
@@ -366,15 +477,20 @@ SelfUtils.getMediaStatus = (mediaSessions = []) => {
   const mediaStatus = {
     audio: {},
     video: {},
-    share: {}
+    share: {},
   };
 
-  mediaStatus.audio = mediaSessions.find((media) => media.mediaType === AUDIO && media.mediaContent === MediaContent.main);
-  mediaStatus.video = mediaSessions.find((media) => media.mediaType === VIDEO && media.mediaContent === MediaContent.main);
-  mediaStatus.share = mediaSessions.find((media) => media.mediaType === VIDEO && media.mediaContent === MediaContent.slides);
+  mediaStatus.audio = mediaSessions.find(
+    (media) => media.mediaType === AUDIO && media.mediaContent === MediaContent.main
+  );
+  mediaStatus.video = mediaSessions.find(
+    (media) => media.mediaType === VIDEO && media.mediaContent === MediaContent.main
+  );
+  mediaStatus.share = mediaSessions.find(
+    (media) => media.mediaType === VIDEO && media.mediaContent === MediaContent.slides
+  );
 
   return mediaStatus;
 };
 
-
 export default SelfUtils;