@webex/plugin-meetings 3.0.0-beta.40 → 3.0.0-beta.401

package/dist/types/meeting-info/meeting-info-v2.d.ts

@@ -29,6 +29,22 @@ export declare class MeetingInfoV2AdhocMeetingError extends Error {
      */
     constructor(wbxAppApiErrorCode?: number, message?: string);
 }
+/**
+ * Error preventing join because of a meeting policy
+ */
+export declare class MeetingInfoV2PolicyError extends Error {
+    meetingInfo: object;
+    sdkMessage: string;
+    wbxAppApiCode: number;
+    /**
+     *
+     * @constructor
+     * @param {Number} [wbxAppApiErrorCode]
+     * @param {Object} [meetingInfo]
+     * @param {String} [message]
+     */
+    constructor(wbxAppApiErrorCode?: number, meetingInfo?: object, message?: string);
+}
 /**
  * Error to indicate that preferred webex site not present to start adhoc meeting
  */
@@ -66,14 +82,21 @@ export default class MeetingInfoV2 {
      * @memberof MeetingInfo
      */
     fetchInfoOptions(destination: string, type?: string): any;
+    /**
+     * Raises a MeetingInfoV2PolicyError for policy error codes
+     * @param {any} err the error from the request
+     * @returns {void}
+     */
+    handlePolicyError: (err: any) => void;
     /**
      * Creates adhoc space meetings for a space by fetching the conversation infomation
      * @param {String} conversationUrl conversationUrl to start adhoc meeting on
+     * @param {String} installedOrgID org ID of user's machine
      * @returns {Promise} returns a meeting info object
      * @public
      * @memberof MeetingInfo
      */
-    createAdhocSpaceMeeting(conversationUrl: string): Promise<any>;
+    createAdhocSpaceMeeting(conversationUrl: string, installedOrgID?: string): Promise<any>;
     /**
      * Fetches meeting info from the server
      * @param {String} destination one of many different types of destinations to look up info for
@@ -82,6 +105,10 @@ export default class MeetingInfoV2 {
      * @param {Object} captchaInfo
      * @param {String} captchaInfo.code
      * @param {String} captchaInfo.id
+     * @param {String} installedOrgID org ID of user's machine
+     * @param {String} locusId
+     * @param {Object} extraParams
+     * @param {Object} options
      * @returns {Promise} returns a meeting info object
      * @public
      * @memberof MeetingInfo
@@ -89,5 +116,8 @@ export default class MeetingInfoV2 {
     fetchMeetingInfo(destination: string, type?: string, password?: string, captchaInfo?: {
         code: string;
         id: string;
+    }, installedOrgID?: any, locusId?: any, extraParams?: object, options?: {
+        meetingId?: string;
+        sendCAevents?: boolean;
     }): Promise<any>;
 }

package/dist/types/meetings/collection.d.ts

@@ -20,4 +20,21 @@ export default class MeetingCollection extends Collection {
      * @memberof MeetingCollection
      */
     getByKey(key: string, value: any): any;
+    /**
+     * get a specific meeting searching for key
+     * @param {String} breakoutUrl
+     * @returns {Meeting} if found, else returns null
+     * @public
+     * @memberof MeetingCollection
+     */
+    getActiveBreakoutLocus(breakoutUrl: string): any;
+    /**
+     * Gets the meeting that has a webrtc media connection
+     * NOTE: this function assumes there is no more than 1 such meeting
+     *
+     * @returns {Meeting} first meeting found, else undefined
+     * @public
+     * @memberof MeetingCollection
+     */
+    getActiveWebrtcMeeting(): any;
 }

package/dist/types/meetings/index.d.ts

@@ -1,7 +1,11 @@
 import '@webex/internal-plugin-mercury';
 import '@webex/internal-plugin-conversation';
+import '@webex/internal-plugin-metrics';
 import { WebexPlugin } from '@webex/webex-core';
 import 'webrtc-adapter';
+import { CallStateForMetrics } from '../meeting';
+import Reachability from '../reachability';
+import { INoiseReductionEffect, IVirtualBackgroundEffect } from './meetings.types';
 /**
  * Meetings Ready Event
  * Emitted when the meetings instance on webex is ready
@@ -55,11 +59,13 @@ export default class Meetings extends WebexPlugin {
     meetingCollection: any;
     personalMeetingRoom: any;
     preferredWebexSite: any;
-    reachability: any;
+    reachability: Reachability;
     registered: any;
     request: any;
     geoHintInfo: any;
     meetingInfo: any;
+    mediaHelpers: any;
+    breakoutLocusForHandleLater: any;
     namespace: string;
     /**
      * Initializes the Meetings Plugin
@@ -68,6 +74,34 @@ export default class Meetings extends WebexPlugin {
      * @memberof Meetings
      */
     constructor(...args: any[]);
+    /**
+     * check whether you need to handle this main session's locus data or not
+     * @param {Object} meeting current meeting data
+     * @param {Object} newLocus new locus data
+     * @returns {boolean}
+     * @private
+     * @memberof Meetings
+     */
+    private isNeedHandleMainLocus;
+    /**
+     * check whether you need to handle this locus data or not
+     * @param {Object} meeting old locus data
+     * @param {Object} newLocus new locus data
+     * @returns {boolean}
+     * @private
+     * @memberof Meetings
+     */
+    private isNeedHandleLocusDTO;
+    /**
+     * get corresponding meeting object by locus data
+     * @param {Object} data a locus event
+     * @param {String} data.locusUrl
+     * @param {Object} data.locus
+     * @returns {Object}
+     * @private
+     * @memberof Meetings
+     */
+    getCorrespondingMeetingByLocus(data: any): any;
     /**
      * handle locus events and takes meeting actions with them as they come in
      * @param {Object} data a locus event
@@ -126,21 +160,21 @@ export default class Meetings extends WebexPlugin {
      */
     private _toggleUnifiedMeetings;
     /**
-     * API to enable or disable TURN discovery
-     * @param {Boolean} enable
+     * API to toggle starting adhoc meeting
+     * @param {Boolean} changeState
      * @private
      * @memberof Meetings
      * @returns {undefined}
      */
-    private _toggleTurnDiscovery;
+    private _toggleAdhocMeetings;
     /**
-     * API to toggle starting adhoc meeting
-     * @param {Boolean} changeState
+     * API to toggle TCP reachability, needs to be called before webex.meetings.register()
+     * @param {Boolean} newValue
      * @private
      * @memberof Meetings
      * @returns {undefined}
      */
-    private _toggleAdhocMeetings;
+    private _toggleTcpReachability;
     /**
      * Explicitly sets up the meetings plugin by registering
      * the device, connecting to mercury, and listening for locus events.
@@ -159,6 +193,24 @@ export default class Meetings extends WebexPlugin {
      * @memberof Meetings
      */
     unregister(): any;
+    /**
+     * Creates a noise reduction effect
+     *
+     * @param {INoiseReductionEffect} options optional custom effect options
+     * @returns {Promise<effect>} noise reduction effect.
+     * @public
+     * @memberof Meetings
+     */
+    createNoiseReductionEffect: (options?: INoiseReductionEffect) => Promise<any>;
+    /**
+     * Creates a virtual background effect
+     *
+     * @param {IVirtualBackgroundEffect} options optional custom effect options
+     * @returns {Promise<effect>} virtual background effect.
+     * @public
+     * @memberof Meetings
+     */
+    createVirtualBackgroundEffect: (options?: IVirtualBackgroundEffect) => Promise<any>;
     /**
      * Uploads logs to the webex services for tracking
      * @param {Object} [options={}]
@@ -172,35 +224,30 @@ export default class Meetings extends WebexPlugin {
      * @returns {String} feedback ID logs were submitted under
      */
     uploadLogs(options?: {
+        autoupload?: boolean;
         callStart?: string;
         feedbackId?: string;
+        locussessionid?: string;
         locusId?: string;
         correlationId?: string;
         meetingId?: string;
         userId?: string;
         orgId?: string;
     }): any;
-    /**
-     * initializes the reachability instance for Meetings
-     * @returns {undefined}
-     * @public
-     * @memberof Meetings
-     */
-    setReachability(): void;
     /**
      * gets the reachability instance for Meetings
      * @returns {Reachability}
      * @public
      * @memberof Meetings
      */
-    getReachability(): any;
+    getReachability(): Reachability;
     /**
      * initializes and starts gathering reachability for Meetings
      * @returns {Promise}
      * @public
      * @memberof Meetings
      */
-    startReachability(): any;
+    startReachability(): Promise<import("../reachability").ReachabilityResults>;
     /**
      * Get geoHint for info for meetings
      * @returns {Promise}
@@ -233,19 +280,37 @@ export default class Meetings extends WebexPlugin {
      */
     private destroy;
     /**
-     * Create a meeting.
-     * @param {string} destination - sipURL, spaceId, phonenumber, or locus object}
+     * Create a meeting or return an existing meeting.
+     *
+     * When meeting info passed it should be complete, e.g.: fetched after password or captcha provided
+     *
+     * @param {string} destination - sipURL, phonenumber, or locus object}
      * @param {string} [type] - the optional specified type, such as locusId
      * @param {Boolean} useRandomDelayForInfo - whether a random delay should be added to fetching meeting info
+     * @param {Object} infoExtraParams extra parameters to be provided when fetching meeting info
+     * @param {string} correlationId - the optional specified correlationId (callStateForMetrics.correlationId can be provided instead)
+     * @param {Boolean} failOnMissingMeetingInfo - whether to throw an error if meeting info fails to fetch (for calls that are not 1:1 or content share)
+     * @param {CallStateForMetrics} callStateForMetrics - information about call state for metrics
+     * @param {Object} [meetingInfo] - Pre-fetched complete meeting info
+     * @param {String} [meetingLookupUrl] - meeting info prefetch url
      * @returns {Promise<Meeting>} A new Meeting.
      * @public
      * @memberof Meetings
      */
-    create(destination: string, type?: string, useRandomDelayForInfo?: boolean): any;
+    create(destination: string, type?: string, useRandomDelayForInfo?: boolean, infoExtraParams?: {}, correlationId?: string, failOnMissingMeetingInfo?: boolean, callStateForMetrics?: CallStateForMetrics, meetingInfo?: any, meetingLookupUrl?: any): any;
     /**
+     * Create meeting
+     *
+     * When meeting info passed it should be complete, e.g.: fetched after password or captcha provided
+     *
      * @param {String} destination see create()
      * @param {String} type see create()
      * @param {Boolean} useRandomDelayForInfo whether a random delay should be added to fetching meeting info
+     * @param {Object} infoExtraParams extra parameters to be provided when fetching meeting info
+     * @param {CallStateForMetrics} callStateForMetrics - information about call state for metrics
+     * @param {Boolean} failOnMissingMeetingInfo - whether to throw an error if meeting info fails to fetch (for calls that are not 1:1 or content share)
+     * @param {Object} [meetingInfo] - Pre-fetched complete meeting info
+     * @param {String} [meetingLookupUrl] - meeting info prefetch url
      * @returns {Promise} a new meeting instance complete with meeting info and destination
      * @private
      * @memberof Meetings
@@ -274,12 +339,31 @@ export default class Meetings extends WebexPlugin {
         endDate: object;
     }): any;
     /**
-     * syncs all the meeting from server
+     * Syncs all the meetings from server. Does nothing and returns immediately if unverified guest.
+     * @param {boolean} keepOnlyLocusMeetings - whether the sync should keep only locus meetings or any other meeting in meetingCollection
+     * @returns {Promise<void>}
+     * @public
+     * @memberof Meetings
+     */
+    syncMeetings({ keepOnlyLocusMeetings }?: {
+        keepOnlyLocusMeetings?: boolean;
+    }): Promise<void>;
+    /**
+     * sort out locus array for initial creating
+     * @param {Array} loci original locus array
      * @returns {undefined}
      * @public
      * @memberof Meetings
      */
-    syncMeetings(): any;
+    sortLocusArrayToUpdate(loci: any[]): any[];
+    /**
+     * check breakout locus which waiting for main locus's meeting to be created, then handle the breakout locus
+     * @param {Object} newCreatedLocus the locus which just create meeting object of it
+     * @returns {undefined}
+     * @public
+     * @memberof Meetings
+     */
+    checkHandleBreakoutLocus(newCreatedLocus: any): void;
     /**
      * Get all scheduled meetings.
      * @param {object} options
@@ -294,4 +378,12 @@ export default class Meetings extends WebexPlugin {
      * @returns {Logger}
      */
     getLogger(): any;
+    /**
+     * Returns the first meeting it finds that has the webrtc media connection created.
+     * Useful for debugging in the console.
+     *
+     * @private
+     * @returns {Meeting} Meeting object that has a webrtc media connection, else undefined
+     */
+    getActiveWebrtcMeeting(): any;
 }

package/dist/types/meetings/meetings.types.d.ts

@@ -0,0 +1,4 @@
+import type { NoiseReductionEffectOptions, VirtualBackgroundEffectOptions } from '@webex/media-helpers';
+type INoiseReductionEffect = Omit<NoiseReductionEffectOptions, 'authToken' | 'workletProcessorUrl' | 'legacyProcessorUrl'>;
+type IVirtualBackgroundEffect = Omit<VirtualBackgroundEffectOptions, 'authToken'>;
+export type { INoiseReductionEffect, IVirtualBackgroundEffect };

package/dist/types/member/index.d.ts

@@ -1,8 +1,10 @@
+import { IExternalRoles, IMediaStatus } from './types';
 /**
  * @class Member
  */
 export default class Member {
     associatedUser: any;
+    canReclaimHost: boolean;
     id: any;
     isAudioMuted: any;
     isContentSharing: any;
@@ -21,10 +23,14 @@ export default class Member {
     isSelf: any;
     isUser: any;
     isVideoMuted: any;
+    roles: IExternalRoles;
+    mediaStatus: IMediaStatus;
     name: any;
     participant: any;
     status: any;
     supportsBreakouts: boolean;
+    supportsInterpretation: boolean;
+    supportLiveAnnotation: boolean;
     type: any;
     namespace: string;
     /**
@@ -135,6 +141,14 @@ export default class Member {
      * @memberof Member
      */
     private processIsHost;
+    /**
+     * process the roles that have been applied to this member
+     * @param {Object} participant
+     * @returns {undefined}
+     * @private
+     * @memberof Member
+     */
+    private processRoles;
     /**
      * set the type for the member, could be MEETING or CALL
      * @param {String} type

package/dist/types/member/types.d.ts

@@ -0,0 +1,32 @@
+export interface IExternalRoles {
+    cohost: boolean;
+    moderator: boolean;
+    presenter: boolean;
+}
+export declare enum ServerRoles {
+    Cohost = "COHOST",
+    Moderator = "MODERATOR",
+    Presenter = "PRESENTER"
+}
+export type ServerRoleShape = {
+    type: ServerRoles;
+    hasRole: boolean;
+};
+export type ParticipantWithRoles = {
+    controls: {
+        role: {
+            roles: Array<ServerRoleShape>;
+        };
+    };
+};
+export declare enum MediaStatus {
+    RECVONLY = "RECVONLY",
+    SENDONLY = "SENDONLY",
+    SENDRECV = "SENDRECV",
+    INACTIVE = "INACTIVE",
+    UNKNOWN = "UNKNOWN"
+}
+export interface IMediaStatus {
+    audio: MediaStatus;
+    video: MediaStatus;
+}

package/dist/types/members/collection.d.ts

@@ -21,4 +21,9 @@ export default class MembersCollection {
      * @memberof MembersCollection
      */
     getAll(): any;
+    /**
+     * @returns {void}
+     * reset members
+     */
+    reset(): void;
 }

package/dist/types/members/index.d.ts

@@ -1,6 +1,7 @@
 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
@@ -91,6 +92,13 @@ export default class Members extends StatelessWebexPlugin {
         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
@@ -102,6 +110,7 @@ export default class Members extends StatelessWebexPlugin {
      */
     locusParticipantsUpdate(payload: {
         participants: object;
+        isReplace?: boolean;
     }): void;
     /**
      * Internal update the content id
@@ -245,11 +254,15 @@ export default class Members extends StatelessWebexPlugin {
     /**
      * Admits waiting members (invited guests to meeting)
      * @param {Array} memberIds
+     * @param {Object} sessionLocusUrls: {authorizingLocusUrl, mainLocusUrl}
      * @returns {Promise}
      * @public
      * @memberof Members
      */
-    admitMembers(memberIds: Array<any>): any;
+    admitMembers(memberIds: Array<any>, sessionLocusUrls?: {
+        authorizingLocusUrl: string;
+        mainLocusUrl: string;
+    }): any;
     /**
      * Removes a member from the meeting
      * @param {String} memberId
@@ -262,11 +275,21 @@ 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: string, mute?: boolean): any;
+    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
@@ -317,4 +340,14 @@ export default class Members extends StatelessWebexPlugin {
      * @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/types/members/request.d.ts

@@ -4,6 +4,15 @@ import { StatelessWebexPlugin } from '@webex/webex-core';
  */
 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}
@@ -11,7 +20,7 @@ export default class MembersRequest extends StatelessWebexPlugin {
      * @throws {Error} if the options are not valid and complete, must have invitee with emailAddress OR email AND locusUrl
      * @memberof MembersRequest
      */
-    addMembers(options: any): any;
+    addMembers(options: any): Promise<any>;
     /**
      *
      * @param {Object} options
@@ -19,12 +28,67 @@ export default class MembersRequest extends StatelessWebexPlugin {
      * @throws {Error} if the options are not valid and complete, must have memberIds AND locusUrl
      * @memberof MembersRequest
      */
-    admitMember(options: any): any;
-    removeMember(options: any): any;
-    muteMember(options: any): any;
-    raiseOrLowerHandMember(options: any): any;
-    lowerAllHandsMember(options: any): any;
-    transferHostToMember(options: any): any;
+    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
@@ -39,12 +103,12 @@ export default class MembersRequest extends StatelessWebexPlugin {
         url: string;
         tones: string;
         memberId: string;
-    }): any;
+    }): 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): any;
+    cancelPhoneInvite(options: any): Promise<any>;
 }

package/dist/types/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;
+};