@webex/plugin-meetings 3.0.0-bnr.5 → 3.0.0-stream-classes.2

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

@@ -1,7 +1,10 @@
 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 Reachability from '../reachability';
+import { INoiseReductionEffect, IVirtualBackgroundEffect } from './meetings.types';
 /**
  * Meetings Ready Event
  * Emitted when the meetings instance on webex is ready
@@ -55,12 +58,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
@@ -87,6 +91,16 @@ export default class Meetings extends WebexPlugin {
      * @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
@@ -178,6 +192,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={}]
@@ -199,27 +231,20 @@ export default class Meetings extends WebexPlugin {
         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<unknown>;
     /**
      * Get geoHint for info for meetings
      * @returns {Promise}
@@ -256,15 +281,19 @@ export default class Meetings extends WebexPlugin {
      * @param {string} destination - sipURL, spaceId, 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
      * @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): any;
     /**
      * @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 {String} correlationId the optional specified correlationId
      * @returns {Promise} a new meeting instance complete with meeting info and destination
      * @private
      * @memberof Meetings
@@ -299,6 +328,22 @@ export default class Meetings extends WebexPlugin {
      * @memberof Meetings
      */
     syncMeetings(): any;
+    /**
+     * sort out locus array for initial creating
+     * @param {Array} loci original locus array
+     * @returns {undefined}
+     * @public
+     * @memberof Meetings
+     */
+    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

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,4 +1,4 @@
-import { IExternalRoles } from './types';
+import { IExternalRoles, IMediaStatus } from './types';
 /**
  * @class Member
  */
@@ -23,10 +23,13 @@ export default class Member {
     isUser: any;
     isVideoMuted: any;
     roles: IExternalRoles;
+    mediaStatus: IMediaStatus;
     name: any;
     participant: any;
     status: any;
     supportsBreakouts: boolean;
+    supportsInterpretation: boolean;
+    supportLiveAnnotation: boolean;
     type: any;
     namespace: string;
     /**

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

@@ -19,3 +19,14 @@ export type ParticipantWithRoles = {
         };
     };
 };
+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/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,9 +28,23 @@ 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;
+    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
@@ -29,9 +52,23 @@ export default class MembersRequest extends StatelessWebexPlugin {
      * @param {String} options.memberId ID of PSTN user
      * @returns {Promise}
      */
-    assignRolesMember(options: any): any;
-    raiseOrLowerHandMember(options: any): any;
-    lowerAllHandsMember(options: any): any;
+    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}
@@ -42,8 +79,16 @@ export default class MembersRequest extends StatelessWebexPlugin {
     editDisplayNameMember(options: {
         locusUrl: string;
         requestingParticipantId: string;
-    }): any;
-    transferHostToMember(options: any): 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
+     * @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
@@ -58,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/util.d.ts

@@ -1,2 +1,210 @@
-declare const MembersUtil: any;
+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 {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: any;
+                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;

package/dist/types/metrics/constants.d.ts

@@ -7,6 +7,7 @@ declare const BEHAVIORAL_METRICS: {
     JOIN_FAILURE: string;
     ADD_MEDIA_SUCCESS: string;
     ADD_MEDIA_FAILURE: string;
+    ROAP_MERCURY_EVENT_RECEIVED: string;
     CONNECTION_SUCCESS: string;
     CONNECTION_FAILURE: string;
     MEETING_LEAVE_FAILURE: string;

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

@@ -1,3 +1,6 @@
+/*!
+ * Copyright (c) 2015-2020 Cisco Systems, Inc. See LICENSE file.
+ */
 /**
  * @description Metrics handles all the call metrics events
  * @export
@@ -5,9 +8,6 @@
  */
 declare class Metrics {
     static instance: Metrics;
-    _events: any;
-    keys: any;
-    meetingCollection: any;
     webex: any;
     /**
      * Create Metrics Object
@@ -19,118 +19,11 @@ declare class Metrics {
     /**
      * Initializes the Metrics singleton with a meeting Collection.
      *
-     * @param {Object} meetingCollection meetings object
      * @param {Object} webex  webex SDK object
      *
      * @returns {void}
      */
-    initialSetup(meetingCollection: object, webex: object): void;
-    /**
-     * poste Meeting event metrics
-     * @param {object} options {meetingId/meeting} as a json object
-     * @param {Meeting} options.meeting Meeting object
-     * @param {String} options.meetingId
-     * @param {object} options.data
-     * @param {object} options.event
-     * @returns {object} null
-     */
-    postEvent(options: {
-        meeting?: any;
-        meetingId?: string;
-        data?: object;
-        event?: any;
-    } | any): void;
-    /**
-     *  Docs for Call analyzer metrics
-     *   https://sqbu-github.cisco.com/WebExSquared/call-analyzer/wiki
-     *   https://sqbu-github.cisco.com/WebExSquared/event-dictionary/blob/master/diagnostic-events.raml
-     */
-    initPayload(eventType: any, identifiers: any, options: any): any;
-    /**
-     * get the payload specific for a media quality event through call analyzer
-     * @param {String} eventType the event name
-     * @param {Object} identifiers contains the identifiers needed for CA
-     * @param {String} identifiers.correlationId
-     * @param {String} identifiers.locusUrl
-     * @param {String} identifiers.locusId
-     * @param {Object} options
-     * @param {Object} options.intervalData
-     * @param {String} options.clientType
-     * @returns {Object}
-     * @public
-     * @memberof Metrics
-     */
-    initMediaPayload(eventType: string, identifiers: {
-        correlationId: string;
-        locusUrl: string;
-        locusId: string;
-    }, options?: {
-        intervalData: object;
-        clientType: string;
-    } | any): {
-        eventId: any;
-        version: number;
-        origin: {
-            audioSetupDelay: any;
-            videoSetupDelay: any;
-            name: string;
-            networkType: any;
-            userAgent: string;
-            clientInfo: {
-                clientType: any;
-                clientVersion: string;
-                localNetworkPrefix: string;
-                os: any;
-                osVersion: any;
-                subClientType: any;
-                browser: any;
-                browserVersion: any;
-            };
-        };
-        originTime: {
-            triggered: string;
-        };
-        senderCountryCode: any;
-        event: {
-            name: string;
-            canProceed: boolean;
-            identifiers: {
-                correlationId: string;
-                locusUrl: string;
-                locusId: string;
-            };
-            intervals: any[];
-            joinTimes: any;
-            eventData: {
-                webClientDomain: any;
-            };
-            sourceMetadata: {
-                applicationSoftwareType: string;
-                applicationSoftwareVersion: any;
-                mediaEngineSoftwareType: any;
-                mediaEngineSoftwareVersion: any;
-                startTime: string;
-            };
-        };
-    };
-    /**
-     * This function Parses a Locus error and returns a diagnostic event payload.
-     * It should keep updating from:
-     * https://sqbu-github.cisco.com/WebExSquared/spark-client-framework/blob/master/spark-client-framework/Adapters/TelephonyAdapter/TelephonyAdapter.cpp#L920
-     *
-     * @param {Object} err the error Object from Locus response
-     * @param {boolean} showToUser true if a toast is shown to user
-     * @returns {{showToUser: boolean, category: string, errorDescription: string,
-     *  errorCode: number, errorData: *, fatal: boolean, name: string}}
-     */
-    parseLocusError(err: any, showToUser: boolean): any;
-    generateErrorPayload(errorCode: any, shownToUser: any, name: any, err: any): any;
-    /**
-     * Returns a formated string of the user agent.
-     *
-     * @returns {string} formatted user agent information
-     */
-    userAgentToString(): string;
+    initialSetup(webex: object): void;
     /**
      * Uploads given metric to the Metrics service as an Behavioral metric.
      * Metadata about the environment such as browser, OS, SDK and their versions