@webex/plugin-meetings 3.7.0 → 3.8.0

package/dist/members/index.d.ts

@@ -0,0 +1,353 @@
+import { StatelessWebexPlugin } from '@webex/webex-core';
+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 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 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: string;
+    /**
+     *
+     * @param {Object} attrs
+     * @param {Object} options
+     * @memberof Members
+     */
+    constructor(attrs: any, options: object);
+    /**
+     * Internal update the self Id value
+     * @param {Object} payload
+     * @param {Object} payload.newSelf
+     * @param {Object} payload.oldSelf
+     * @returns {undefined}
+     * @private
+     * @memberof Members
+     */
+    locusSelfUpdate(payload: {
+        newSelf: any;
+        oldSelf: any;
+    }): void;
+    /**
+     * Internal update the hostId value
+     * @param {Object} payload
+     * @param {Object} payload.newHost
+     * @param {Object} payload.oldHost
+     * @returns {undefined}
+     * @private
+     * @memberof Members
+     */
+    locusHostUpdate(payload: {
+        newHost: any;
+        oldHost: any;
+    }): void;
+    /**
+     * clear member collection
+     * @returns {void}
+     * @private
+     * @memberof Members
+     */
+    clearMembers(): void;
+    /**
+     * 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
+     * @param {Object} payload
+     * @param {Object} payload.participants
+     * @returns {undefined}
+     * @private
+     * @memberof Members
+     */
+    locusParticipantsUpdate(payload: {
+        participants: object;
+        isReplace?: boolean;
+    }): void;
+    /**
+     * Internal update the content id
+     * @param {Object} payload
+     * @param {Object} payload.current
+     * @param {Object} payload.previous
+     * @returns {undefined}
+     * @private
+     * @memberof Members
+     */
+    locusMediaSharesUpdate(payload: {
+        current: any;
+        previous: any;
+    }): void;
+    /**
+     * Internal update the locus url value
+     * @param {Object} payload
+     * @param {String} payload.locusUrl
+     * @returns {undefined}
+     * @private
+     * @memberof Members
+     */
+    locusUrlUpdate(payload: any): void;
+    /**
+     * Internal update the type of meeting
+     * @param {Object} payload
+     * @param {String} payload.type
+     * @returns {undefined}
+     * @private
+     * @memberof Members
+     */
+    locusFullStateTypeUpdate(payload: {
+        type: string;
+    }): void;
+    /**
+     * sets values in the members collection for updated and added properties from delta
+     * @param {Object} membersUpdate {updated: [], added: []}
+     * @returns {Object} membersCollection
+     * @private
+     * @memberof Members
+     */
+    private handleMembersUpdate;
+    /**
+     * set members to the member collection from each updated/added lists as passed in
+     * @param {Array} list
+     * @returns {undefined}
+     * @private
+     * @memberof Members
+     */
+    private constructMembers;
+    /**
+     * Internal update the participants value
+     * @param {Object} payload
+     * @returns {Object}
+     * @private
+     * @memberof Members
+     */
+    private handleLocusInfoUpdatedParticipants;
+    /**
+     * Update the locus Url
+     * @param {Object} locus
+     * @param {String} [locusUrl] optional, takes precedence
+     * @throws {ParameterError}
+     * @returns {undefined}
+     * @public
+     * @memberof Members
+     */
+    setLocusUrl(locus: any, locusUrl?: string): void;
+    /**
+     * Update the host id
+     * @param {Object} locus
+     * @param {String} [hostId] optional, takes precedence
+     * @throws {ParameterError}
+     * @returns {undefined}
+     * @public
+     * @memberof Members
+     */
+    setHostId(locus: any, hostId?: string): void;
+    /**
+     * Update the type
+     * @param {Object} fullState
+     * @param {String} [type] optional, takes precedence
+     * @throws {ParameterError}
+     * @returns {undefined}
+     * @public
+     * @memberof Members
+     */
+    setType(fullState: any, type?: string): void;
+    /**
+     * Update the self Id
+     * @param {Object} locus
+     * @param {String} [selfId] optional, takes precedence
+     * @throws {Error}
+     * @returns {undefined}
+     * @memberof Members
+     */
+    setSelfId(locus: any, selfId?: string): void;
+    /**
+     * Update the media share content id
+     * @param {Object} locus
+     * @param {String} [contentId] optional, takes precedence
+     * @throws {Error}
+     * @returns {undefined}
+     * @memberof Members
+     */
+    setMediaShareContentId(locus: any, contentId?: string): void;
+    /**
+     * Update the media share whiteboard id
+     * @param {Object} locus
+     * @param {String} [whiteboardId] optional, takes precedence
+     * @throws {Error}
+     * @returns {undefined}
+     * @memberof Members
+     */
+    setMediaShareWhiteboardId(locus: any, whiteboardId?: string): void;
+    /**
+     * Find all the updates, and added members
+     * Removed/left members will end up in updates
+     * Each array contains only members
+     * @param {Array} participants the locus participants
+     * @returns {Object} {added: {Array}, updated: {Array}}
+     * @private
+     * @memberof Members
+     */
+    private update;
+    /**
+     * Adds a guest Member to the associated meeting
+     * @param {String} invitee
+     * @param {Boolean} [alertIfActive]
+     * @returns {Promise}
+     * @memberof Members
+     */
+    addMember(invitee: any, alertIfActive?: boolean): any;
+    /**
+     * Cancels an outgoing PSTN call to the associated meeting
+     * @param {String} invitee
+     * @returns {Promise}
+     * @memberof Members
+     */
+    cancelPhoneInvite(invitee: any): any;
+    /**
+     * Admits waiting members (invited guests to meeting)
+     * @param {Array} memberIds
+     * @param {Object} sessionLocusUrls: {authorizingLocusUrl, mainLocusUrl}
+     * @returns {Promise}
+     * @public
+     * @memberof Members
+     */
+    admitMembers(memberIds: Array<any>, sessionLocusUrls?: {
+        authorizingLocusUrl: string;
+        mainLocusUrl: string;
+    }): any;
+    /**
+     * Removes a member from the meeting
+     * @param {String} memberId
+     * @returns {Promise}
+     * @public
+     * @memberof Members
+     */
+    removeMember(memberId: string): any;
+    /**
+     * 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: string, mute?: boolean, isAudio?: boolean): any;
+    /**
+     * 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
+     */
+    assignRoles(memberId: string, roles: Array<ServerRoleShape>): any;
+    /**
+     * Raise or lower the hand of a member in a meeting
+     * @param {String} memberId
+     * @param {boolean} [raise] - to raise hand (=true) or lower (=false), default: true
+     * @returns {Promise}
+     * @public
+     * @memberof Members
+     */
+    raiseOrLowerHand(memberId: string, raise?: boolean): any;
+    /**
+     * Lower all hands of members in a meeting
+     * @param {String} requestingMemberId - id of the participant which requested the lower all hands
+     * @returns {Promise}
+     * @public
+     * @memberof Members
+     */
+    lowerAllHands(requestingMemberId: string): any;
+    /**
+     * Transfers the host to another member
+     * @param {String} memberId
+     * @param {boolean} [moderator] default true
+     * @returns {Promise}
+     * @public
+     * @memberof Members
+     */
+    transferHostToMember(memberId: string, moderator?: boolean): any;
+    /**
+     * Sends DTMF tones for the PSTN member of a meeting
+     * @param {String} tones a string of one or more DTMF tones to send
+     * @param {String} memberId member id
+     * @returns {Promise}
+     * @public
+     * @memberof Members
+     */
+    sendDialPadKey(tones?: string, memberId?: string): any;
+    /** Finds a member that has any device with a csi matching provided value
+     *
+     * @param {number} csi
+     * @returns {Member}
+     */
+    findMemberByCsi(csi: any): unknown;
+    /**
+     * 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: any, mediaType?: string, mediaContent?: string): any[];
+    /**
+     * 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
+     */
+    editDisplayName(memberId: string, requestingParticipantId: string, alias: string): any;
+}

package/dist/members/request.d.ts

@@ -0,0 +1,114 @@
+import { StatelessWebexPlugin } from '@webex/webex-core';
+/**
+ * @class MembersRequest
+ */
+export default class MembersRequest extends StatelessWebexPlugin {
+    namespace: string;
+    locusDeltaRequest: (options: object) => Promise<any>;
+    /**
+     * Constructor
+     * @param {Object} attrs
+     * @param {Object} options
+     */
+    constructor(attrs: {
+        meeting: any;
+    }, options: object);
+    /**
+     *
+     * @param {Object} options with format of {invitee: string, locusUrl: string}
+     * @returns {Promise}
+     * @throws {Error} if the options are not valid and complete, must have invitee with emailAddress OR email AND locusUrl
+     * @memberof MembersRequest
+     */
+    addMembers(options: any): Promise<any>;
+    /**
+     *
+     * @param {Object} options
+     * @returns {Promise}
+     * @throws {Error} if the options are not valid and complete, must have memberIds AND locusUrl
+     * @memberof MembersRequest
+     */
+    admitMember(options: any): Promise<any>;
+    /**
+     * Sends a request to remove a member
+     * @param {Object} options
+     * @param {String} options.locusUrl
+     * @param {String} options.memberId ID of member
+     * @returns {Promise}
+     */
+    removeMember(options: any): Promise<any>;
+    /**
+     * Sends a request to mute a member
+     * @param {Object} options
+     * @param {String} options.locusUrl
+     * @param {String} options.memberId ID of member
+     * @returns {Promise}
+     */
+    muteMember(options: any): Promise<any>;
+    /**
+     * Sends a request to the DTMF endpoint to send tones
+     * @param {Object} options
+     * @param {String} options.locusUrl
+     * @param {String} options.memberId ID of PSTN user
+     * @returns {Promise}
+     */
+    assignRolesMember(options: any): Promise<any>;
+    /**
+     * Sends a request to raise or lower a member's hand
+     * @param {Object} options
+     * @param {String} options.locusUrl
+     * @param {String} options.memberId ID of member
+     * @returns {Promise}
+     */
+    raiseOrLowerHandMember(options: any): Promise<any>;
+    /**
+     * Sends a request to lower all hands
+     * @param {Object} options
+     * @param {String} options.locusUrl
+     * @param {String} options.requestingParticipantId ID of requesting participant
+     * @returns {Promise}
+     */
+    lowerAllHandsMember(options: any): Promise<any>;
+    /**
+     *
+     * @param {Object} options with format of {locusUrl: string, requestingParticipantId: string}
+     * @returns {Promise}
+     * @throws {Error} if the options are not valid and complete, must have requestingParticipantId AND locusUrl
+     * @memberof MembersRequest
+     */
+    editDisplayNameMember(options: {
+        locusUrl: string;
+        requestingParticipantId: string;
+    }): Promise<any>;
+    /**
+     * Sends a request to raise or lower a member's hand
+     * @param {Object} options
+     * @param {String} options.locusUrl
+     * @param {String} options.memberId ID of member
+     * @param {String} options.moderator ID of moderator
+     * @returns {Promise}
+     */
+    transferHostToMember(options: any): Promise<any>;
+    /**
+     * Sends a request to the DTMF endpoint to send tones
+     * @param {Object} options
+     * @param {String} options.locusUrl
+     * @param {String} options.url device url SIP user
+     * @param {String} options.tones a string of one or more DTMF tones to send
+     * @param {String} options.memberId ID of PSTN user
+     * @returns {Promise}
+     */
+    sendDialPadKey(options: {
+        locusUrl: string;
+        url: string;
+        tones: string;
+        memberId: string;
+    }): Promise<any>;
+    /**
+     * @param {Object} options with format of {invitee: string, locusUrl: string}
+     * @returns {Promise}
+     * @throws {Error} if the options are not valid and complete, must have invitee with emailAddress OR email AND locusUrl
+     * @memberof MembersRequest
+     */
+    cancelPhoneInvite(options: any): Promise<any>;
+}

package/dist/members/types.d.ts

@@ -0,0 +1,25 @@
+export declare enum ServerRoles {
+    Cohost = "COHOST",
+    Moderator = "MODERATOR",
+    Presenter = "PRESENTER"
+}
+export type ServerRoleShape = {
+    type: ServerRoles;
+    hasRole: boolean;
+    hostKey?: string;
+};
+export type RoleAssignmentOptions = {
+    roles: Array<ServerRoleShape>;
+    locusUrl: string;
+    memberId: string;
+};
+export type RoleAssignmentBody = {
+    role: {
+        roles: Array<ServerRoleShape>;
+    };
+};
+export type RoleAssignmentRequest = {
+    method: string;
+    uri: string;
+    body: RoleAssignmentBody;
+};

package/dist/members/util.d.ts

@@ -0,0 +1,215 @@
+import { RoleAssignmentOptions, RoleAssignmentRequest, ServerRoleShape } from './types';
+declare const MembersUtil: {
+    /**
+     * @param {Object} invitee with emailAddress, email or phoneNumber
+     * @param {String} locusUrl
+     * @param {Boolean} alertIfActive
+     * @returns {Object} the format object
+     */
+    generateAddMemberOptions: (invitee: object, locusUrl: string, alertIfActive: boolean) => {
+        invitee: object;
+        locusUrl: string;
+        alertIfActive: boolean;
+    };
+    /**
+     * @param {Array} memberIds
+     * @param {String} locusUrl
+     * @returns {Object} the format object
+     */
+    generateAdmitMemberOptions: (memberIds: Array<any>, locusUrl: string) => {
+        locusUrl: string;
+        memberIds: any[];
+    };
+    /**
+     * @param {Object} options with {invitee: {emailAddress, email, phoneNumber}, alertIfActive}
+     * @returns {Object} with {invitees: [{address}], alertIfActive}
+     */
+    getAddMemberBody: (options: any) => {
+        invitees: {
+            address: any;
+        }[];
+        alertIfActive: any;
+    };
+    /**
+     * @param {Object} options with {memberIds, authorizingLocusUrl}
+     * @returns {Object} admit with {memberIds}
+     */
+    getAdmitMemberRequestBody: (options: any) => any;
+    /**
+     * @param {Object} format with {memberIds, locusUrl, sessionLocusUrls}
+     * @returns {Object} the request parameters (method, uri, body) needed to make a admitMember request
+     * if a host/cohost is in a breakout session, the locus url should be the main session locus url
+     */
+    getAdmitMemberRequestParams: (format: any) => {
+        method: string;
+        uri: string;
+        body: any;
+    };
+    /**
+     * @param {Object} format with {invitee {emailAddress, email, phoneNumber}, locusUrl, alertIfActive}
+     * @returns {Object} the request parameters (method, uri, body) needed to make a addMember request
+     */
+    getAddMemberRequestParams: (format: any) => {
+        method: string;
+        uri: any;
+        body: {
+            invitees: {
+                address: any;
+            }[];
+            alertIfActive: any;
+        };
+    };
+    isInvalidInvitee: (invitee: any) => boolean;
+    getRemoveMemberRequestParams: (options: any) => {
+        method: string;
+        uri: string;
+        body: {
+            reason: any;
+        };
+    };
+    generateTransferHostMemberOptions: (transfer: any, moderator: any, locusUrl: any) => {
+        moderator: any;
+        locusUrl: any;
+        memberId: any;
+    };
+    generateRemoveMemberOptions: (removal: any, locusUrl: any) => {
+        reason: string;
+        memberId: any;
+        locusUrl: any;
+    };
+    generateMuteMemberOptions: (memberId: any, status: any, locusUrl: any, isAudio: any) => {
+        memberId: any;
+        muted: any;
+        locusUrl: any;
+        isAudio: any;
+    };
+    generateRaiseHandMemberOptions: (memberId: any, status: any, locusUrl: any) => {
+        memberId: any;
+        raised: any;
+        locusUrl: any;
+    };
+    /**
+     * @param {String} memberId
+     * @param {[ServerRoleShape]} roles
+     * @param {String} locusUrl
+     * @returns {RoleAssignmentOptions}
+     */
+    generateRoleAssignmentMemberOptions: (memberId: string, roles: Array<ServerRoleShape>, locusUrl: string) => RoleAssignmentOptions;
+    generateLowerAllHandsMemberOptions: (requestingParticipantId: any, locusUrl: any) => {
+        requestingParticipantId: any;
+        locusUrl: any;
+    };
+    /**
+     * @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
+     * @param {String} locusUrl url
+     * @returns {Object} consists of {memberID: string, requestingParticipantId: string, alias: string, locusUrl: string}
+     */
+    generateEditDisplayNameMemberOptions: (memberId: any, requestingParticipantId: any, alias: any, locusUrl: any) => {
+        memberId: any;
+        requestingParticipantId: any;
+        alias: any;
+        locusUrl: any;
+    };
+    getMuteMemberRequestParams: (options: any) => {
+        method: string;
+        uri: string;
+        body: {
+            [x: string]: {
+                muted: any;
+            };
+        };
+    };
+    /**
+     * @param {ServerRoleShape} role
+     * @returns {ServerRoleShape} the role shape to be added to the body
+     */
+    getAddedRoleShape: (role: ServerRoleShape) => ServerRoleShape;
+    /**
+     * @param {RoleAssignmentOptions} options
+     * @returns {RoleAssignmentRequest} the request parameters (method, uri, body) needed to make a addMember request
+     */
+    getRoleAssignmentMemberRequestParams: (options: RoleAssignmentOptions) => RoleAssignmentRequest;
+    getRaiseHandMemberRequestParams: (options: any) => {
+        method: string;
+        uri: string;
+        body: {
+            hand: {
+                raised: any;
+            };
+        };
+    };
+    getLowerAllHandsMemberRequestParams: (options: any) => {
+        method: string;
+        uri: string;
+        body: {
+            hand: {
+                raised: boolean;
+            };
+            requestingParticipantId: any;
+        };
+    };
+    /**
+     * @param {Object} options with format of {locusUrl: string, requestingParticipantId: string}
+     * @returns {Object} request parameters (method, uri, body) needed to make a editDisplayName request
+     */
+    editDisplayNameMemberRequestParams: (options: any) => {
+        method: string;
+        uri: string;
+        body: {
+            aliasValue: any;
+            requestingParticipantId: any;
+        };
+    };
+    getTransferHostToMemberRequestParams: (options: any) => {
+        method: string;
+        uri: string;
+        body: {
+            role: {
+                moderator: any;
+            };
+        };
+    };
+    genderateSendDTMFOptions: (url: any, tones: any, memberId: any, locusUrl: any) => {
+        url: any;
+        tones: any;
+        memberId: any;
+        locusUrl: any;
+    };
+    generateSendDTMFRequestParams: ({ url, tones, memberId, locusUrl }: {
+        url: any;
+        tones: any;
+        memberId: any;
+        locusUrl: any;
+    }) => {
+        method: string;
+        uri: string;
+        body: {
+            device: {
+                url: any;
+            };
+            memberId: any;
+            dtmf: {
+                correlationId: string;
+                tones: any;
+                direction: string;
+            };
+        };
+    };
+    cancelPhoneInviteOptions: (invitee: any, locusUrl: any) => {
+        invitee: any;
+        locusUrl: any;
+    };
+    generateCancelInviteRequestParams: (options: any) => {
+        method: string;
+        uri: any;
+        body: {
+            actionType: string;
+            invitees: {
+                address: any;
+            }[];
+        };
+    };
+};
+export default MembersUtil;