@webex/plugin-meetings 3.0.0-beta.1 → 3.0.0-beta.104

package/src/member/{util.js → util.ts}

@@ -1,3 +1,4 @@
+import {IExternalRoles, ParticipantWithRoles, ServerRoles, ServerRoleShape} from './types';
 import {
   _USER_,
   _RESOURCE_ROOM_,
@@ -13,17 +14,69 @@ import {
   VIDEO_STATUS,
   _SEND_RECEIVE_,
   _RECEIVE_ONLY_,
-  _CALL_
+  _CALL_,
 } from '../constants';
 import ParameterError from '../common/errors/parameter';
 
-const MemberUtil = {};
+const MemberUtil: any = {};
+
+/**
+ * @param {Object} participant the locus participant
+ * @returns {[ServerRoleShape]}
+ */
+MemberUtil.getControlsRoles = (participant: ParticipantWithRoles): Array<ServerRoleShape> =>
+  participant?.controls?.role?.roles;
+
+/**
+ * @param {Object} participant the locus participant
+ * @param {ServerRoles} controlRole the search role
+ * @returns {Boolean}
+ */
+MemberUtil.hasRole = (participant: any, controlRole: ServerRoles): boolean =>
+  MemberUtil.getControlsRoles(participant)?.some(
+    (role) => role.type === controlRole && role.hasRole
+  );
+
+/**
+ * @param {Object} participant the locus participant
+ * @returns {Boolean}
+ */
+MemberUtil.hasCohost = (participant: ParticipantWithRoles): boolean =>
+  MemberUtil.hasRole(participant, ServerRoles.Cohost) || false;
+
+/**
+ * @param {Object} participant the locus participant
+ * @returns {Boolean}
+ */
+MemberUtil.hasModerator = (participant: ParticipantWithRoles): boolean =>
+  MemberUtil.hasRole(participant, ServerRoles.Moderator) || false;
 
 /**
  * @param {Object} participant the locus participant
  * @returns {Boolean}
  */
-MemberUtil.isUser = (participant) => participant && participant.type === _USER_;
+MemberUtil.hasPresenter = (participant: ParticipantWithRoles): boolean =>
+  MemberUtil.hasRole(participant, ServerRoles.Presenter) || false;
+
+/**
+ * @param {Object} participant the locus participant
+ * @returns {IExternalRoles}
+ */
+MemberUtil.extractControlRoles = (participant: ParticipantWithRoles): IExternalRoles => {
+  const roles = {
+    cohost: MemberUtil.hasCohost(participant),
+    moderator: MemberUtil.hasModerator(participant),
+    presenter: MemberUtil.hasPresenter(participant),
+  };
+
+  return roles;
+};
+
+/**
+ * @param {Object} participant the locus participant
+ * @returns {Boolean}
+ */
+MemberUtil.isUser = (participant: any) => participant && participant.type === _USER_;
 
 MemberUtil.isModerator = (participant) => participant && participant.moderator;
 
@@ -31,15 +84,16 @@ MemberUtil.isModerator = (participant) => participant && participant.moderator;
  * @param {Object} participant the locus participant
  * @returns {Boolean}
  */
-MemberUtil.isGuest = (participant) => participant && participant.guest;
+MemberUtil.isGuest = (participant: any) => participant && participant.guest;
 
 /**
  * @param {Object} participant the locus participant
  * @returns {Boolean}
  */
-MemberUtil.isDevice = (participant) => participant && participant.type === _RESOURCE_ROOM_;
+MemberUtil.isDevice = (participant: any) => participant && participant.type === _RESOURCE_ROOM_;
 
-MemberUtil.isModeratorAssignmentProhibited = (participant) => participant && participant.moderatorAssignmentNotAllowed;
+MemberUtil.isModeratorAssignmentProhibited = (participant) =>
+  participant && participant.moderatorAssignmentNotAllowed;
 
 /**
  * checks to see if the participant id is the same as the passed id
@@ -48,8 +102,8 @@ MemberUtil.isModeratorAssignmentProhibited = (participant) => participant && par
  * @param {String} id
  * @returns {Boolean}
  */
-MemberUtil.isSame = (participant, id) => participant &&
-  (participant.id === id || participant.person && participant.person.id === id);
+MemberUtil.isSame = (participant: any, id: string) =>
+  participant && (participant.id === id || (participant.person && participant.person.id === id));
 
 /**
  * checks to see if the participant id is the same as the passed id for associated devices
@@ -58,9 +112,12 @@ MemberUtil.isSame = (participant, id) => participant &&
  * @param {String} id
  * @returns {Boolean}
  */
-MemberUtil.isAssociatedSame = (participant, id) => participant &&
-participant.associatedUsers &&
-participant.associatedUsers.some((user) => (user.id === id || user.person && user.person.id === id));
+MemberUtil.isAssociatedSame = (participant: any, id: string) =>
+  participant &&
+  participant.associatedUsers &&
+  participant.associatedUsers.some(
+    (user) => user.id === id || (user.person && user.person.id === id)
+  );
 
 /**
  * @param {Object} participant the locus participant
@@ -68,16 +125,24 @@ participant.associatedUsers.some((user) => (user.id === id || user.person && use
  * @param {String} status
  * @returns {Boolean}
  */
-MemberUtil.isNotAdmitted = (participant, isGuest, status) => participant &&
-  participant.guest && ((participant.devices && participant.devices[0] &&
-  participant.devices[0].intent && participant.devices[0].intent.type === _WAIT_ &&
-  isGuest && status === _IN_LOBBY_) || !status === _IN_MEETING_);
+MemberUtil.isNotAdmitted = (participant: any, isGuest: boolean, status: string): boolean =>
+  participant &&
+  participant.guest &&
+  ((participant.devices &&
+    participant.devices[0] &&
+    participant.devices[0].intent &&
+    participant.devices[0].intent.type === _WAIT_ &&
+    // @ts-ignore
+    isGuest &&
+    status === _IN_LOBBY_) ||
+    // @ts-ignore
+    !status === _IN_MEETING_);
 
 /**
  * @param {Object} participant the locus participant
  * @returns {Boolean}
  */
-MemberUtil.isAudioMuted = (participant) => {
+MemberUtil.isAudioMuted = (participant: any) => {
   if (!participant) {
     throw new ParameterError('Audio could not be processed, participant is undefined.');
   }
@@ -99,7 +164,7 @@ MemberUtil.isAudioMuted = (participant) => {
  * @param {Object} participant the locus participant
  * @returns {Boolean}
  */
-MemberUtil.isVideoMuted = (participant) => {
+MemberUtil.isVideoMuted = (participant: any) => {
   if (!participant) {
     throw new ParameterError('Video could not be processed, participant is undefined.');
   }
@@ -111,7 +176,7 @@ MemberUtil.isVideoMuted = (participant) => {
  * @param {Object} participant the locus participant
  * @returns {Boolean}
  */
-MemberUtil.isHandRaised = (participant) => {
+MemberUtil.isHandRaised = (participant: any) => {
   if (!participant) {
     throw new ParameterError('Raise hand could not be processed, participant is undefined.');
   }
@@ -119,13 +184,25 @@ MemberUtil.isHandRaised = (participant) => {
   return participant.controls?.hand?.raised || false;
 };
 
+/**
+ * @param {Object} participant the locus participant
+ * @returns {Boolean}
+ */
+MemberUtil.isBreakoutsSupported = (participant) => {
+  if (!participant) {
+    throw new ParameterError('Breakout support could not be processed, participant is undefined.');
+  }
+
+  return !participant.doesNotSupportBreakouts;
+};
+
 /**
  * utility method for audio/video muted status
  * @param {String} status
  * @param {String} accessor
  * @returns {Boolean}
  */
-MemberUtil.isMuted = (status, accessor) => {
+MemberUtil.isMuted = (status: string, accessor: string) => {
   if (status) {
     if (status[accessor] === _RECEIVE_ONLY_) {
       return true;
@@ -143,7 +220,7 @@ MemberUtil.isMuted = (status, accessor) => {
  * @param {Object} controls
  * @returns {String|null}
  */
-MemberUtil.getRecordingMember = (controls) => {
+MemberUtil.getRecordingMember = (controls: any) => {
   if (!controls) {
     return null;
   }
@@ -158,7 +235,7 @@ MemberUtil.getRecordingMember = (controls) => {
  * @param {Object} participant the locus participant
  * @returns {Boolean}
  */
-MemberUtil.isRecording = (participant) => {
+MemberUtil.isRecording = (participant: any) => {
   if (!participant) {
     throw new ParameterError('Recording could not be processed, participant is undefined.');
   }
@@ -204,7 +281,7 @@ MemberUtil.isMutable = (isSelf, isDevice, isInMeeting, isMuted, type) => {
  * @param {Object} participant the locus participant
  * @returns {String}
  */
-MemberUtil.extractStatus = (participant) => {
+MemberUtil.extractStatus = (participant: any) => {
   if (!(participant && participant.devices && participant.devices.length)) {
     return _NOT_IN_MEETING_;
   }
@@ -213,7 +290,10 @@ MemberUtil.extractStatus = (participant) => {
   }
   if (participant.state === _IDLE_) {
     if (participant.devices && participant.devices.length > 0) {
-      const foundDevice = participant.devices.find((device) => device.intent && (device.intent.type === _WAIT_ || device.intent.type === _OBSERVE_));
+      const foundDevice = participant.devices.find(
+        (device) =>
+          device.intent && (device.intent.type === _WAIT_ || device.intent.type === _OBSERVE_)
+      );
 
       return foundDevice ? _IN_LOBBY_ : _NOT_IN_MEETING_;
     }
@@ -231,7 +311,7 @@ MemberUtil.extractStatus = (participant) => {
  * @param {Object} participant the locus participant
  * @returns {String}
  */
-MemberUtil.extractId = (participant) => {
+MemberUtil.extractId = (participant: any) => {
   if (participant) {
     return participant.id;
   }
@@ -243,7 +323,7 @@ MemberUtil.extractId = (participant) => {
  * @param {Object} participant the locus participant
  * @returns {String}
  */
-MemberUtil.extractName = (participant) => {
+MemberUtil.extractName = (participant: any) => {
   if (participant && participant.person) {
     return participant.person.name;
   }

package/src/members/{collection.js → collection.ts}

@@ -4,8 +4,8 @@ import {MEETINGS} from '../constants';
  * @class MembersCollection
  */
 export default class MembersCollection {
+  members: any;
   namespace = MEETINGS;
-
   /**
    * @param {Object} locus
    * @memberof Members
@@ -26,7 +26,7 @@ export default class MembersCollection {
    * @param {String} id
    * @returns {Member}
    */
-  get(id) {
+  get(id: string) {
     return this.members[id];
   }
 
@@ -37,4 +37,12 @@ export default class MembersCollection {
   getAll() {
     return this.members;
   }
+
+  /**
+   * @returns {void}
+   * reset members
+   */
+  reset() {
+    this.members = {};
+  }
 }