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

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

@@ -2,6 +2,7 @@
  * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
  */
 import {isEmpty} from 'lodash';
+// @ts-ignore
 import {StatelessWebexPlugin} from '@webex/webex-core';
 
 import {MEETINGS, EVENT_TRIGGERS, FLOOR_ACTION, CONTENT, WHITEBOARD} from '../constants';
@@ -13,53 +14,72 @@ import ParameterError from '../common/errors/parameter';
 import MembersCollection from './collection';
 import MembersRequest from './request';
 import MembersUtil from './util';
+import {ReceiveSlotManager} from '../multistream/receiveSlotManager';
+import {MediaRequestManager} from '../multistream/mediaRequestManager';
+import {ServerRoleShape} from './types';
 
 /**
-   * Members Update Event
-   * Emitted when something in the roster list needs to be updated
-   * @event members:update
-   * @instance
-   * @property {Object} delta the changes to the members list
-   * @property {Array} delta.updated array only the updates, includes removals, as they will have updated status and member properties
-   * @property {Array} delta.added array added members to the meeting
-   * @property {Array} full array the full members collection
-   * @memberof Members
-   */
+ * Members Update Event
+ * Emitted when something in the roster list needs to be updated
+ * @event members:update
+ * @instance
+ * @property {Object} delta the changes to the members list
+ * @property {Array} delta.updated array only the updates, includes removals, as they will have updated status and member properties
+ * @property {Array} delta.added array added members to the meeting
+ * @property {Array} full array the full members collection
+ * @memberof Members
+ */
 
 /**
-   * Members Content Update Event
-   * Emitted when who is sharing changes
-   * @event members:content:update
-   * @instance
-   * @property {String} activeContentSharingId
-   * @property {String} endedContentSharingId
-   * @memberof Members
-   */
+ * Members Content Update Event
+ * Emitted when who is sharing changes
+ * @event members:content:update
+ * @instance
+ * @property {String} activeContentSharingId
+ * @property {String} endedContentSharingId
+ * @memberof Members
+ */
 
 /**
-   * Members Host Update Event
-   * Emitted when who is the host changes
-   * @event members:host:update
-   * @instance
-   * @property {String} activeHostId
-   * @property {String} endedHostId
-   * @memberof Members
-   */
+ * Members Host Update Event
+ * Emitted when who is the host changes
+ * @event members:host:update
+ * @instance
+ * @property {String} activeHostId
+ * @property {String} endedHostId
+ * @memberof Members
+ */
 
 /**
-   * Members Self Update Event
-   * Emitted when who is the self changes
-   * @event members:self:update
-   * @instance
-   * @property {String} activeSelfId
-   * @property {String} endedSelfId
-   * @memberof Members
-   */
+ * Members Self Update Event
+ * Emitted when who is the self changes
+ * @event members:self:update
+ * @instance
+ * @property {String} activeSelfId
+ * @property {String} endedSelfId
+ * @memberof Members
+ */
 
 /**
  * @class Members
  */
 export default class Members extends StatelessWebexPlugin {
+  hostId: any;
+  locusUrl: any;
+  mediaShareContentId: any;
+  mediaShareWhiteboardId: any;
+  membersCollection: any;
+  membersRequest: any;
+  receiveSlotManager: ReceiveSlotManager;
+  mediaRequestManagers: {
+    audio: MediaRequestManager;
+    video: MediaRequestManager;
+  };
+
+  recordingId: any;
+  selfId: any;
+  type: any;
+
   namespace = MEETINGS;
 
   /**
@@ -68,7 +88,7 @@ export default class Members extends StatelessWebexPlugin {
    * @param {Object} options
    * @memberof Members
    */
-  constructor(attrs, options) {
+  constructor(attrs: any, options: object) {
     super({}, options);
     /**
      * The Members Request object to interact with server
@@ -76,7 +96,8 @@ export default class Members extends StatelessWebexPlugin {
      * @type {MembersRequest}
      * @private
      * @memberof Members
-    */
+     */
+    // @ts-ignore
     this.membersRequest = new MembersRequest({}, options);
     /**
      * The Members Collection cache
@@ -84,7 +105,7 @@ export default class Members extends StatelessWebexPlugin {
      * @type {MembersCollection}
      * @private
      * @memberof Members
-    */
+     */
     this.membersCollection = new MembersCollection();
     /**
      * The current locus url for the active meeting
@@ -92,7 +113,7 @@ export default class Members extends StatelessWebexPlugin {
      * @type {String}
      * @private
      * @memberof Members
-    */
+     */
     this.locusUrl = attrs.locusUrl || null;
     /**
      * The current hostId for the meeting
@@ -100,7 +121,7 @@ export default class Members extends StatelessWebexPlugin {
      * @type {String}
      * @private
      * @memberof Members
-    */
+     */
     this.hostId = null;
     /**
      * The current type for the meeting, could be MEETING or CALL
@@ -108,7 +129,7 @@ export default class Members extends StatelessWebexPlugin {
      * @type {String}
      * @private
      * @memberof Members
-    */
+     */
     this.type = null;
     /**
      * Locus has a self object, sent individually to the client
@@ -122,7 +143,7 @@ export default class Members extends StatelessWebexPlugin {
      * @type {String}
      * @private
      * @memberof Members
-    */
+     */
     this.selfId = null;
     /**
      * The current mediaShareContentId for the meeting
@@ -130,7 +151,7 @@ export default class Members extends StatelessWebexPlugin {
      * @type {String}
      * @private
      * @memberof Members
-    */
+     */
     this.mediaShareContentId = null;
     /**
      * The current mediaShareWhiteboardId for the meeting
@@ -138,7 +159,7 @@ export default class Members extends StatelessWebexPlugin {
      * @type {String}
      * @private
      * @memberof Members
-    */
+     */
     this.mediaShareWhiteboardId = null;
     /**
      * The current recordingId for the meeting, if it exists
@@ -146,8 +167,20 @@ export default class Members extends StatelessWebexPlugin {
      * @type {String}
      * @private
      * @memberof Members
-    */
+     */
     this.recordingId = null;
+
+    /**
+     * reference to a ReceiveSlotManager instance (for multistream)
+     * @private
+     */
+    this.receiveSlotManager = attrs.receiveSlotManager;
+
+    /**
+     * reference to a MediaRequestManager instance that manages main video requests (for multistream)
+     * @private
+     */
+    this.mediaRequestManagers = attrs.mediaRequestManagers;
   }
 
   /**
@@ -159,7 +192,7 @@ export default class Members extends StatelessWebexPlugin {
    * @private
    * @memberof Members
    */
-  locusSelfUpdate(payload) {
+  locusSelfUpdate(payload: {newSelf: any; oldSelf: any}) {
     let newSelfId = null;
     let oldSelfId = null;
 
@@ -190,12 +223,12 @@ export default class Members extends StatelessWebexPlugin {
       this,
       {
         file: 'members',
-        function: 'locusSelfUpdate'
+        function: 'locusSelfUpdate',
       },
       EVENT_TRIGGERS.MEMBERS_SELF_UPDATE,
       {
         activeSelfId: newSelfId,
-        endedSelfId: oldSelfId
+        endedSelfId: oldSelfId,
       }
     );
   }
@@ -209,7 +242,7 @@ export default class Members extends StatelessWebexPlugin {
    * @private
    * @memberof Members
    */
-  locusHostUpdate(payload) {
+  locusHostUpdate(payload: {newHost: any; oldHost: any}) {
     let newHostId = null;
     let oldHostId = null;
 
@@ -240,16 +273,35 @@ export default class Members extends StatelessWebexPlugin {
       this,
       {
         file: 'members',
-        function: 'locusHostUpdate'
+        function: 'locusHostUpdate',
       },
       EVENT_TRIGGERS.MEMBERS_HOST_UPDATE,
       {
         activeHostId: newHostId,
-        endedHostId: oldHostId
+        endedHostId: oldHostId,
       }
     );
   }
 
+  /**
+   * clear member collection
+   * @returns {void}
+   * @private
+   * @memberof Members
+   */
+  clearMembers() {
+    this.membersCollection.reset();
+    Trigger.trigger(
+      this,
+      {
+        file: 'members',
+        function: 'clearMembers',
+      },
+      EVENT_TRIGGERS.MEMBERS_CLEAR,
+      {}
+    );
+  }
+
   /**
    * when new participant updates come in, both delta and full participants, update them in members collection
    * delta object in the event will have {updated, added} and full will be the full membersCollection
@@ -259,21 +311,27 @@ export default class Members extends StatelessWebexPlugin {
    * @private
    * @memberof Members
    */
-  locusParticipantsUpdate(payload) {
+  locusParticipantsUpdate(payload: {participants: object; isReplace?: boolean}) {
     if (payload) {
+      if (payload.isReplace) {
+        this.clearMembers();
+      }
       const delta = this.handleLocusInfoUpdatedParticipants(payload);
       const full = this.handleMembersUpdate(delta); // SDK should propagate the full list for both delta and non delta updates
 
+      this.receiveSlotManager?.updateMemberIds();
+
       Trigger.trigger(
         this,
         {
           file: 'members',
-          function: 'locusParticipantsUpdate'
+          function: 'locusParticipantsUpdate',
         },
         EVENT_TRIGGERS.MEMBERS_UPDATE,
         {
           delta,
-          full
+          full,
+          isReplace: !!payload.isReplace,
         }
       );
     }
@@ -288,7 +346,7 @@ export default class Members extends StatelessWebexPlugin {
    * @private
    * @memberof Members
    */
-  locusMediaSharesUpdate(payload) {
+  locusMediaSharesUpdate(payload: {current: any; previous: any}) {
     const currentContent = payload.current?.content;
     const previousContent = payload.previous?.content;
     const currentWhiteboard = payload.current?.whiteboard;
@@ -307,8 +365,10 @@ export default class Members extends StatelessWebexPlugin {
         if (currentContent.disposition === FLOOR_ACTION.RELEASED) {
           whoStopped = currentContent.beneficiaryId;
           this.mediaShareContentId = null;
-        }
-        else if (currentContent.disposition === FLOOR_ACTION.GRANTED && currentContent.beneficiaryId !== previousContent.beneficiaryId) {
+        } else if (
+          currentContent.disposition === FLOOR_ACTION.GRANTED &&
+          currentContent.beneficiaryId !== previousContent.beneficiaryId
+        ) {
           whoStopped = previousContent.beneficiaryId;
         }
       }
@@ -325,8 +385,10 @@ export default class Members extends StatelessWebexPlugin {
         if (currentWhiteboard.disposition === FLOOR_ACTION.RELEASED) {
           whoStopped = currentWhiteboard.beneficiaryId;
           this.mediaShareWhiteboardId = null;
-        }
-        else if (currentWhiteboard.disposition === FLOOR_ACTION.GRANTED && currentWhiteboard.beneficiaryId !== previousWhiteboard.beneficiaryId) {
+        } else if (
+          currentWhiteboard.disposition === FLOOR_ACTION.GRANTED &&
+          currentWhiteboard.beneficiaryId !== previousWhiteboard.beneficiaryId
+        ) {
           whoStopped = previousWhiteboard.beneficiaryId;
         }
       }
@@ -351,17 +413,16 @@ export default class Members extends StatelessWebexPlugin {
       this,
       {
         file: 'members',
-        function: 'locusMediaSharesUpdate'
+        function: 'locusMediaSharesUpdate',
       },
       EVENT_TRIGGERS.MEMBERS_CONTENT_UPDATE,
       {
         activeSharingId: whoSharing,
-        endedSharingId: whoStopped
+        endedSharingId: whoStopped,
       }
     );
   }
 
-
   /**
    * Internal update the locus url value
    * @param {Object} payload
@@ -370,7 +431,7 @@ export default class Members extends StatelessWebexPlugin {
    * @private
    * @memberof Members
    */
-  locusUrlUpdate(payload) {
+  locusUrlUpdate(payload: any) {
     if (payload) {
       this.setLocusUrl(null, payload);
     }
@@ -384,7 +445,7 @@ export default class Members extends StatelessWebexPlugin {
    * @private
    * @memberof Members
    */
-  locusFullStateTypeUpdate(payload) {
+  locusFullStateTypeUpdate(payload: {type: string}) {
     // TODO: at some point there could be a timing issue here, for updating each member
     // ie., if the type changes AND there is no locus update, then each member will not know the type of call
     // which means they cannot determine isMutable && isRemovable
@@ -403,7 +464,7 @@ export default class Members extends StatelessWebexPlugin {
    * @private
    * @memberof Members
    */
-  handleMembersUpdate(membersUpdate) {
+  private handleMembersUpdate(membersUpdate: any) {
     if (membersUpdate) {
       if (membersUpdate.updated) {
         this.constructMembers(membersUpdate.updated);
@@ -423,7 +484,7 @@ export default class Members extends StatelessWebexPlugin {
    * @private
    * @memberof Members
    */
-  constructMembers(list) {
+  private constructMembers(list: Array<any>) {
     list.forEach((member) => {
       this.membersCollection.set(member.id, member);
     });
@@ -436,12 +497,14 @@ export default class Members extends StatelessWebexPlugin {
    * @private
    * @memberof Members
    */
-  handleLocusInfoUpdatedParticipants(payload) {
+  private handleLocusInfoUpdatedParticipants(payload: any) {
     this.hostId = payload.hostId || this.hostId;
     this.selfId = payload.selfId || this.selfId;
     this.recordingId = payload.recordingId;
     if (!payload.participants) {
-      LoggerProxy.logger.warn('Members:index#handleLocusInfoUpdatedParticipants --> participants payload is missing.');
+      LoggerProxy.logger.warn(
+        'Members:index#handleLocusInfoUpdatedParticipants --> participants payload is missing.'
+      );
     }
     const memberUpdate = this.update(payload.participants);
 
@@ -457,15 +520,15 @@ export default class Members extends StatelessWebexPlugin {
    * @public
    * @memberof Members
    */
-  setLocusUrl(locus, locusUrl = null) {
+  public setLocusUrl(locus: any, locusUrl: string = null) {
     if (locusUrl) {
       this.locusUrl = locusUrl;
-    }
-    else if (locus && (locus.locusUrl || locus.url)) {
+    } else if (locus && (locus.locusUrl || locus.url)) {
       this.locusUrl = locus.locusUrl || locus.url;
-    }
-    else {
-      throw new ParameterError('Setting locusUrl for the Members module should be done with a locus object or locusUrl');
+    } else {
+      throw new ParameterError(
+        'Setting locusUrl for the Members module should be done with a locus object or locusUrl'
+      );
     }
   }
 
@@ -478,15 +541,15 @@ export default class Members extends StatelessWebexPlugin {
    * @public
    * @memberof Members
    */
-  setHostId(locus, hostId = null) {
+  public setHostId(locus: any, hostId: string = null) {
     if (hostId) {
       this.hostId = hostId;
-    }
-    else if (locus) {
+    } else if (locus) {
       this.hostId = locus && locus.owner && locus.owner.info ? locus.owner.info : null;
-    }
-    else {
-      throw new ParameterError('Setting hostid for the Members module should be done with a locus object or hostId');
+    } else {
+      throw new ParameterError(
+        'Setting hostid for the Members module should be done with a locus object or hostId'
+      );
     }
   }
 
@@ -499,15 +562,15 @@ export default class Members extends StatelessWebexPlugin {
    * @public
    * @memberof Members
    */
-  setType(fullState, type = null) {
+  public setType(fullState: any, type: string = null) {
     if (type) {
       this.type = type;
-    }
-    else if (fullState) {
+    } else if (fullState) {
       this.type = (fullState && fullState.type) || null;
-    }
-    else {
-      throw new ParameterError('Setting type for the Members module should be done with a fullstate object or type string');
+    } else {
+      throw new ParameterError(
+        'Setting type for the Members module should be done with a fullstate object or type string'
+      );
     }
   }
 
@@ -519,15 +582,18 @@ export default class Members extends StatelessWebexPlugin {
    * @returns {undefined}
    * @memberof Members
    */
-  setSelfId(locus, selfId = null) {
+  setSelfId(locus: any, selfId: string = null) {
     if (selfId) {
       this.selfId = selfId;
-    }
-    else if (locus) {
-      this.selfId = locus && locus.self && locus.self.person && locus.self.person.id ? locus.self.person.id : null;
-    }
-    else {
-      throw new ParameterError('Setting selfid for the Members module should be done with a locus object or selfId');
+    } else if (locus) {
+      this.selfId =
+        locus && locus.self && locus.self.person && locus.self.person.id
+          ? locus.self.person.id
+          : null;
+    } else {
+      throw new ParameterError(
+        'Setting selfid for the Members module should be done with a locus object or selfId'
+      );
     }
   }
 
@@ -539,11 +605,10 @@ export default class Members extends StatelessWebexPlugin {
    * @returns {undefined}
    * @memberof Members
    */
-  setMediaShareContentId(locus, contentId) {
+  setMediaShareContentId(locus: any, contentId?: string) {
     if (contentId) {
       this.mediaShareContentId = contentId;
-    }
-    else if (locus) {
+    } else if (locus) {
       const contentMediaShare =
         locus.mediaShares &&
         locus.mediaShares.length &&
@@ -555,9 +620,10 @@ export default class Members extends StatelessWebexPlugin {
           contentMediaShare.floor.beneficiary &&
           contentMediaShare.floor.beneficiary.id) ||
         null;
-    }
-    else {
-      throw new ParameterError('Setting hostid for the Members module should be done with a locus object or hostId');
+    } else {
+      throw new ParameterError(
+        'Setting hostid for the Members module should be done with a locus object or hostId'
+      );
     }
   }
 
@@ -569,11 +635,10 @@ export default class Members extends StatelessWebexPlugin {
    * @returns {undefined}
    * @memberof Members
    */
-  setMediaShareWhiteboardId(locus, whiteboardId) {
+  setMediaShareWhiteboardId(locus: any, whiteboardId?: string) {
     if (whiteboardId) {
       this.mediaShareWhiteboardId = whiteboardId;
-    }
-    else if (locus) {
+    } else if (locus) {
       const whiteboardMediaShare =
         locus.mediaShares &&
         locus.mediaShares.length &&
@@ -585,9 +650,10 @@ export default class Members extends StatelessWebexPlugin {
           whiteboardMediaShare.floor.beneficiary &&
           whiteboardMediaShare.floor.beneficiary.id) ||
         null;
-    }
-    else {
-      throw new ParameterError('Setting hostid for the Members module should be done with a locus object or hostId');
+    } else {
+      throw new ParameterError(
+        'Setting hostid for the Members module should be done with a locus object or hostId'
+      );
     }
   }
 
@@ -600,7 +666,7 @@ export default class Members extends StatelessWebexPlugin {
    * @private
    * @memberof Members
    */
-  update(participants) {
+  private update(participants: Array<any>) {
     const membersUpdate = {added: [], updated: []};
 
     if (participants) {
@@ -620,11 +686,10 @@ export default class Members extends StatelessWebexPlugin {
               hostId: this.hostId,
               contentSharingId: this.mediaShareContentId,
               whiteboardSharingId: this.mediaShareWhiteboardId,
-              type: this.type
+              type: this.type,
             })
           );
-        }
-        else {
+        } else {
           membersUpdate.added.push(
             new Member(participant, {
               recordingId: this.recordingId,
@@ -632,7 +697,7 @@ export default class Members extends StatelessWebexPlugin {
               hostId: this.hostId,
               contentSharingId: this.mediaShareContentId,
               whiteboardSharingId: this.mediaShareWhiteboardId,
-              type: this.type
+              type: this.type,
             })
           );
         }
@@ -649,13 +714,17 @@ export default class Members extends StatelessWebexPlugin {
    * @returns {Promise}
    * @memberof Members
    */
-  addMember(invitee, alertIfActive) {
+  addMember(invitee: any, alertIfActive?: boolean) {
     if (!this.locusUrl) {
-      return Promise.reject(new ParameterError('The associated locus url for this meeting object must be defined.'));
+      return Promise.reject(
+        new ParameterError('The associated locus url for this meeting object must be defined.')
+      );
     }
     if (MembersUtil.isInvalidInvitee(invitee)) {
       return Promise.reject(
-        new ParameterError('The invitee must be defined with either a valid email, emailAddress or phoneNumber property.')
+        new ParameterError(
+          'The invitee must be defined with either a valid email, emailAddress or phoneNumber property.'
+        )
       );
     }
     const options = MembersUtil.generateAddMemberOptions(invitee, this.locusUrl, alertIfActive);
@@ -669,9 +738,11 @@ export default class Members extends StatelessWebexPlugin {
    * @returns {Promise}
    * @memberof Members
    */
-  cancelPhoneInvite(invitee) {
+  cancelPhoneInvite(invitee: any) {
     if (!this.locusUrl) {
-      return Promise.reject(new ParameterError('The associated locus url for this meeting object must be defined.'));
+      return Promise.reject(
+        new ParameterError('The associated locus url for this meeting object must be defined.')
+      );
     }
     if (MembersUtil.isInvalidInvitee(invitee)) {
       return Promise.reject(
@@ -680,22 +751,28 @@ export default class Members extends StatelessWebexPlugin {
     }
     const options = MembersUtil.cancelPhoneInviteOptions(invitee, this.locusUrl);
 
-
     return this.membersRequest.cancelPhoneInvite(options);
   }
 
   /**
    * Admits waiting members (invited guests to meeting)
    * @param {Array} memberIds
+   * @param {Object} sessionLocusUrls: {authorizingLocusUrl, mainLocusUrl}
    * @returns {Promise}
    * @public
    * @memberof Members
    */
-  admitMembers(memberIds) {
+  public admitMembers(
+    memberIds: Array<any>,
+    sessionLocusUrls?: {authorizingLocusUrl: string; mainLocusUrl: string}
+  ) {
     if (isEmpty(memberIds)) {
       return Promise.reject(new ParameterError('No member ids provided to admit.'));
     }
-    const options = MembersUtil.generateAdmitMemberOptions(memberIds, this.locusUrl);
+    const options = {
+      sessionLocusUrls,
+      ...MembersUtil.generateAdmitMemberOptions(memberIds, this.locusUrl),
+    };
 
     return this.membersRequest.admitMember(options);
   }
@@ -707,12 +784,16 @@ export default class Members extends StatelessWebexPlugin {
    * @public
    * @memberof Members
    */
-  removeMember(memberId) {
+  public removeMember(memberId: string) {
     if (!this.locusUrl) {
-      return Promise.reject(new ParameterError('The associated locus url for this meeting object must be defined.'));
+      return Promise.reject(
+        new ParameterError('The associated locus url for this meeting object must be defined.')
+      );
     }
     if (!memberId) {
-      return Promise.reject(new ParameterError('The member id must be defined to remove the member.'));
+      return Promise.reject(
+        new ParameterError('The member id must be defined to remove the member.')
+      );
     }
     const options = MembersUtil.generateRemoveMemberOptions(memberId, this.locusUrl);
 
@@ -723,22 +804,55 @@ export default class Members extends StatelessWebexPlugin {
    * Audio mutes another member in a meeting
    * @param {String} memberId
    * @param {boolean} [mute] default true
+   * @param {boolean} [isAudio] default true
    * @returns {Promise}
    * @public
    * @memberof Members
    */
-  muteMember(memberId, mute = true) {
+  public muteMember(memberId: string, mute = true, isAudio = true) {
     if (!this.locusUrl) {
-      return Promise.reject(new ParameterError('The associated locus url for this meetings members object must be defined.'));
+      return Promise.reject(
+        new ParameterError(
+          'The associated locus url for this meetings members object must be defined.'
+        )
+      );
     }
     if (!memberId) {
-      return Promise.reject(new ParameterError('The member id must be defined to mute the member.'));
+      return Promise.reject(
+        new ParameterError('The member id must be defined to mute the member.')
+      );
     }
-    const options = MembersUtil.generateMuteMemberOptions(memberId, mute, this.locusUrl);
+    const options = MembersUtil.generateMuteMemberOptions(memberId, mute, this.locusUrl, isAudio);
 
     return this.membersRequest.muteMember(options);
   }
 
+  /**
+   * Assign role(s) to a member in the meeting
+   * @param {String} memberId
+   * @param {[ServerRoleShape]} roles - to assign an array of roles
+   * @returns {Promise}
+   * @public
+   * @memberof Members
+   */
+  public assignRoles(memberId: string, roles: Array<ServerRoleShape>) {
+    if (!this.locusUrl) {
+      return Promise.reject(
+        new ParameterError(
+          'The associated locus url for this meetings members object must be defined.'
+        )
+      );
+    }
+    if (!memberId) {
+      return Promise.reject(
+        new ParameterError('The member id must be defined to assign the roles to a member.')
+      );
+    }
+    const options = MembersUtil.generateRoleAssignmentMemberOptions(memberId, roles, this.locusUrl);
+
+    return this.membersRequest.assignRolesMember(options);
+  }
+
   /**
    * Raise or lower the hand of a member in a meeting
    * @param {String} memberId
@@ -747,12 +861,18 @@ export default class Members extends StatelessWebexPlugin {
    * @public
    * @memberof Members
    */
-  raiseOrLowerHand(memberId, raise = true) {
+  public raiseOrLowerHand(memberId: string, raise = true) {
     if (!this.locusUrl) {
-      return Promise.reject(new ParameterError('The associated locus url for this meetings members object must be defined.'));
+      return Promise.reject(
+        new ParameterError(
+          'The associated locus url for this meetings members object must be defined.'
+        )
+      );
     }
     if (!memberId) {
-      return Promise.reject(new ParameterError('The member id must be defined to raise/lower the hand of the member.'));
+      return Promise.reject(
+        new ParameterError('The member id must be defined to raise/lower the hand of the member.')
+      );
     }
     const options = MembersUtil.generateRaiseHandMemberOptions(memberId, raise, this.locusUrl);
 
@@ -766,19 +886,29 @@ export default class Members extends StatelessWebexPlugin {
    * @public
    * @memberof Members
    */
-  lowerAllHands(requestingMemberId) {
+  public lowerAllHands(requestingMemberId: string) {
     if (!this.locusUrl) {
-      return Promise.reject(new ParameterError('The associated locus url for this meetings members object must be defined.'));
+      return Promise.reject(
+        new ParameterError(
+          'The associated locus url for this meetings members object must be defined.'
+        )
+      );
     }
     if (!requestingMemberId) {
-      return Promise.reject(new ParameterError('The requestingMemberId must be defined to lower all hands in a meeting.'));
+      return Promise.reject(
+        new ParameterError(
+          'The requestingMemberId must be defined to lower all hands in a meeting.'
+        )
+      );
     }
-    const options = MembersUtil.generateLowerAllHandsMemberOptions(requestingMemberId, this.locusUrl);
+    const options = MembersUtil.generateLowerAllHandsMemberOptions(
+      requestingMemberId,
+      this.locusUrl
+    );
 
     return this.membersRequest.lowerAllHandsMember(options);
   }
 
-
   /**
    * Transfers the host to another member
    * @param {String} memberId
@@ -787,19 +917,28 @@ export default class Members extends StatelessWebexPlugin {
    * @public
    * @memberof Members
    */
-  transferHostToMember(memberId, moderator = true) {
+  public transferHostToMember(memberId: string, moderator = true) {
     if (!this.locusUrl) {
-      return Promise.reject(new ParameterError('The associated locus url for this meetings members object must be defined.'));
+      return Promise.reject(
+        new ParameterError(
+          'The associated locus url for this meetings members object must be defined.'
+        )
+      );
     }
     if (!memberId) {
-      return Promise.reject(new ParameterError('The member id must be defined to transfer host to the member.'));
+      return Promise.reject(
+        new ParameterError('The member id must be defined to transfer host to the member.')
+      );
     }
-    const options = MembersUtil.generateTransferHostMemberOptions(memberId, moderator, this.locusUrl);
+    const options = MembersUtil.generateTransferHostMemberOptions(
+      memberId,
+      moderator,
+      this.locusUrl
+    );
 
     return this.membersRequest.transferHostToMember(options);
   }
 
-
   /**
    * Sends DTMF tones for the PSTN member of a meeting
    * @param {String} tones a string of one or more DTMF tones to send
@@ -808,7 +947,8 @@ export default class Members extends StatelessWebexPlugin {
    * @public
    * @memberof Members
    */
-  sendDialPadKey(tones = '', memberId = '') {
+  public sendDialPadKey(tones = '', memberId = '') {
+    // @ts-ignore
     if (!tones && tones !== 0) {
       return Promise.reject(new ParameterError('DMTF tones must be passed in'));
     }
@@ -831,6 +971,86 @@ export default class Members extends StatelessWebexPlugin {
       return this.membersRequest.sendDialPadKey(options);
     }
 
-    return Promise.reject(new Error('Members:index#sendDialPadKey --> cannot send DTMF, meeting does not have a connection to the "locus" call control service.'));
+    return Promise.reject(
+      new Error(
+        'Members:index#sendDialPadKey --> cannot send DTMF, meeting does not have a connection to the "locus" call control service.'
+      )
+    );
+  }
+
+  /** Finds a member that has any device with a csi matching provided value
+   *
+   * @param {number} csi
+   * @returns {Member}
+   */
+  findMemberByCsi(csi) {
+    return Object.values(this.membersCollection.getAll()).find((member) =>
+      // @ts-ignore
+      member.participant?.devices?.find((device) =>
+        device.csis?.find((memberCsi) => memberCsi === csi)
+      )
+    );
+  }
+
+  /**
+   * Returns an array of a member's CSIs matching the mediaType and mediaContent
+   *
+   * @param {string} memberId
+   * @param {string} mediaType 'audio' or 'video'
+   * @param {string} mediaContent 'main' or 'slides'
+   * @returns {Member}
+   */
+  getCsisForMember(memberId, mediaType = 'video', mediaContent = 'main') {
+    const csis = [];
+
+    this.membersCollection.get(memberId)?.participant?.devices?.forEach((device) => {
+      if (device.mediaSessions) {
+        const deviceCsis = device.mediaSessions
+          ?.filter(
+            (mediaSession) =>
+              mediaSession.mediaType === mediaType && mediaSession.mediaContent === mediaContent
+          )
+          .map((mediaSession) => mediaSession.csi);
+
+        csis.push(...deviceCsis);
+      }
+    });
+
+    return csis;
+  }
+
+  /**
+   * Edit display name of participants in a meeting
+   * @param {string} memberId - id of the participant who is receiving request
+   * @param {string} requestingParticipantId - id of the participant who is sending request (optional)
+   * @param {string} [alias] - alias name
+   * @returns {Promise}
+   * @public
+   * @memberof Members
+   */
+  public editDisplayName(memberId: string, requestingParticipantId: string, alias: string) {
+    if (!this.locusUrl) {
+      return Promise.reject(
+        new ParameterError(
+          'The associated locus url for this meetings members object must be defined.'
+        )
+      );
+    }
+    if (!memberId) {
+      return Promise.reject(
+        new ParameterError('The member id must be defined to edit display name of the member.')
+      );
+    }
+
+    const {locusUrl} = this;
+
+    const options = MembersUtil.generateEditDisplayNameMemberOptions(
+      memberId,
+      requestingParticipantId,
+      alias,
+      locusUrl
+    );
+
+    return this.membersRequest.editDisplayNameMember(options);
   }
 }