@webex/plugin-meetings 3.9.0-next.2 → 3.9.0-next.21

package/dist/types/locus-info/index.d.ts

@@ -1,4 +1,47 @@
 import EventsScope from '../common/events/events-scope';
+export type LocusDTO = {
+    controls?: any;
+    fullState?: {
+        active: boolean;
+        count: number;
+        lastActive: string;
+        locked: boolean;
+        sessionId: string;
+        seessionIds: string[];
+        startTime: number;
+        state: string;
+        type: string;
+    };
+    host?: {
+        id: string;
+        incomingCallProtocols: any[];
+        isExternal: boolean;
+        name: string;
+        orgId: string;
+    };
+    info?: any;
+    links?: any;
+    mediaShares?: any[];
+    meetings?: any[];
+    participants: any[];
+    replaces?: any[];
+    self?: any;
+    sequence?: {
+        dirtyParticipants: number;
+        entries: number[];
+        rangeEnd: number;
+        rangeStart: number;
+        sequenceHash: number;
+        sessionToken: string;
+        since: string;
+        totalParticipants: number;
+    };
+    syncUrl?: string;
+    url?: string;
+};
+export type LocusApiResponseBody = {
+    locus: LocusDTO;
+};
 /**
  * @description LocusInfo extends ChildEmitter to convert locusInfo info a private emitter to parent object
  * @export
@@ -49,6 +92,8 @@ export default class LocusInfo extends EventsScope {
      * Does a Locus sync. It tries to get the latest delta DTO or if it can't, it falls back to getting the full Locus DTO.
      *
      * @param {Meeting} meeting
+     * @param {boolean} isLocusUrlChanged
+     * @param {Locus} locus
      * @returns {undefined}
      */
     private doLocusSync;
@@ -81,6 +126,13 @@ export default class LocusInfo extends EventsScope {
      * @memberof LocusInfo
      */
     initialSetup(locus: object): void;
+    /**
+     * Handles HTTP response from Locus API call.
+     * @param {Meeting} meeting meeting object
+     * @param {LocusApiResponseBody} responseBody body of the http response from Locus API call
+     * @returns {void}
+     */
+    handleLocusAPIResponse(meeting: any, responseBody: LocusApiResponseBody): void;
     /**
      * @param {Meeting} meeting
      * @param {Object} data
@@ -150,11 +202,12 @@ export default class LocusInfo extends EventsScope {
     /**
      * update meeting's members
      * @param {Object} participants new participants object
+     * @param {Array} removedParticipantIds list of removed participants
      * @param {Boolean} isReplace is replace the whole members
      * @returns {Array} updatedParticipants
      * @memberof LocusInfo
      */
-    updateParticipants(participants: object, isReplace?: boolean): void;
+    updateParticipants(participants: object, removedParticipantIds?: string[], isReplace?: boolean): void;
     /**
      * @param {Object} controls
      * @param {Object} self

package/dist/types/media/properties.d.ts

@@ -1,5 +1,6 @@
 import { LocalCameraStream, LocalMicrophoneStream, LocalDisplayStream, LocalSystemAudioStream, RemoteStream } from '@webex/media-helpers';
 import { ClientEvent } from '@webex/internal-plugin-metrics';
+import { throttle } from 'lodash';
 export type MediaDirection = {
     sendAudio: boolean;
     sendVideo: boolean;
@@ -26,6 +27,10 @@ export default class MediaProperties {
     videoDeviceId: any;
     videoStream?: LocalCameraStream;
     namespace: string;
+    mediaIssueCounters: {
+        [key: string]: number;
+    };
+    throttledSendMediaIssueMetric: ReturnType<typeof throttle>;
     /**
      * @param {Object} [options] -- to auto construct
      * @returns {MediaProperties}
@@ -63,6 +68,11 @@ export default class MediaProperties {
      * @returns {void}
      */
     setVideoDeviceId(deviceId: string): void;
+    /**
+     * Clears the webrtcMediaConnection. This method should be called after
+     * peer connection is closed and no longer needed.
+     * @returns {void}
+     */
     unsetPeerConnection(): void;
     /**
      * Removes both remote audio and video from class instance
@@ -129,4 +139,15 @@ export default class MediaProperties {
         selectedCandidatePairChanges: number;
         numTransports: number;
     }>;
+    /**
+     * Sends a metric about a media issue. Metrics are throttled so that we don't
+     * send too many of them, but include a count so that we know how many issues
+     * were detected.
+     *
+     * @param {string} issueType
+     * @param {string} issueSubType
+     * @param {string} correlationId
+     * @returns {void}
+     */
+    sendMediaIssueMetric(issueType: string, issueSubType: string, correlationId: any): void;
 }

package/dist/types/meeting/in-meeting-actions.d.ts

@@ -39,6 +39,7 @@ interface IInMeetingActions {
     isLocalRecordingPaused?: boolean;
     isManualCaptionActive?: boolean;
     isSaveTranscriptsEnabled?: boolean;
+    isSpokenLanguageAutoDetectionEnabled?: boolean;
     isWebexAssistantActive?: boolean;
     canViewCaptionPanel?: boolean;
     isRealTimeTranslationEnabled?: boolean;
@@ -147,6 +148,7 @@ export default class InMeetingActions implements IInMeetingActions {
     isLocalRecordingPaused: any;
     isManualCaptionActive: any;
     isSaveTranscriptsEnabled: any;
+    isSpokenLanguageAutoDetectionEnabled: any;
     isWebexAssistantActive: any;
     canViewCaptionPanel: any;
     isRealTimeTranslationEnabled: any;

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

@@ -2,7 +2,7 @@
 import { StatelessWebexPlugin } from '@webex/webex-core';
 import { ClientEvent, ClientEventLeaveReason } from '@webex/internal-plugin-metrics';
 import { ClientEvent as RawClientEvent } from '@webex/event-dictionary-ts';
-import { MediaType, StatsAnalyzer, NetworkQualityMonitor } from '@webex/internal-media-core';
+import { MediaType, StatsAnalyzer, NetworkQualityMonitor, StatsMonitor } from '@webex/internal-media-core';
 import { LocalStream, LocalCameraStream, LocalDisplayStream, LocalSystemAudioStream, LocalMicrophoneStream } from '@webex/media-helpers';
 import Roap, { type TurnDiscoverySkipReason } from '../roap/index';
 import { type TurnServerInfo } from '../roap/types';
@@ -98,6 +98,7 @@ export declare enum ScreenShareFloorStatus {
 type FetchMeetingInfoParams = {
     password?: string;
     registrationId?: string;
+    classificationId?: string;
     captchaCode?: string;
     extraParams?: Record<string, any>;
     sendCAevents?: boolean;
@@ -428,6 +429,7 @@ export default class Meeting extends StatelessWebexPlugin {
     shareStatus: string;
     screenShareFloorState: ScreenShareFloorStatus;
     statsAnalyzer: StatsAnalyzer;
+    statsMonitor: StatsMonitor;
     transcription: Transcription;
     updateMediaConnections: (mediaConnections: any[]) => void;
     userDisplayHints: any;
@@ -2021,5 +2023,13 @@ export default class Meeting extends StatelessWebexPlugin {
      * @returns {Promise} The locus request
      */
     unsetStage(): Promise<any>;
+    /**
+     * Notifies the host with the given meeting UUID and display names.
+     *
+     * @param {string} meetingUuid - The UUID of the meeting.
+     * @param {string[]} displayName - An array of display names to notify the host with.
+     * @returns {Promise<any>} The result of the notifyHost request.
+     */
+    notifyHost(meetingUuid: string, displayName: string[]): any;
 }
 export {};

package/dist/types/meeting/request.d.ts

@@ -322,4 +322,13 @@ export default class MeetingRequest extends StatelessWebexPlugin {
      * @returns {Promise} The locus request
      */
     synchronizeStage(locusUrl: string, videoLayout: SynchronizeVideoLayout): Promise<any>;
+    /**
+     * Sends a request to notify the host of a meeting.
+     * @param {string} siteFullUrl - The site URL.
+     * @param {string} locusId - The locus ID.
+     * @param {string} meetingUuid - The meeting UUID.
+     * @param {Array<string>} displayName - The display names to notify the host about.
+     * @returns {Promise}
+     */
+    notifyHost(siteFullUrl: string, locusId: string, meetingUuid: string, displayName: string[]): any;
 }

package/dist/types/meeting/util.d.ts

@@ -14,6 +14,12 @@ declare const MeetingUtil: {
      * @returns {IP_VERSION|undefined} ipver value to be passed to the backend APIs or undefined if we should not pass any value to the backend
      */
     getIpVersion(webex: any): IP_VERSION | undefined;
+    /**
+     * Returns CA event labels related to Orpheus ipver parameter that can be sent to CA with any CA event
+     * @param {any} webex instance
+     * @returns {Array<string>|undefined} array of CA event labels or undefined if no labels should be sent
+     */
+    getCaEventLabelsForIpVersion(webex: any): Array<string> | undefined;
     joinMeeting: (meeting: any, options: any) => Promise<any>;
     cleanUp: (meeting: any) => any;
     disconnectPhoneAudio: (meeting: any, phoneUrl: any) => any;
@@ -76,6 +82,7 @@ declare const MeetingUtil: {
     isLocalRecordingPaused: (displayHints: any) => any;
     canStopManualCaption: (displayHints: any) => any;
     isManualCaptionActive: (displayHints: any) => any;
+    isSpokenLanguageAutoDetectionEnabled: (displayHints: any) => any;
     isWebexAssistantActive: (displayHints: any) => any;
     canViewCaptionPanel: (displayHints: any) => any;
     isRealTimeTranslationEnabled: (displayHints: any) => any;
@@ -95,14 +102,14 @@ declare const MeetingUtil: {
      */
     addSequence: (meeting: any, requestBody: any) => void;
     /**
-     * Updates the locus info for the meeting with the delta locus
-     * returned from requests that include the sequence information
+     * Updates the locus info for the meeting with the locus
+     * information returned from API requests made to Locus
      * Returns the original response object
      * @param {Object} meeting The meeting object
      * @param {Object} response The response of the http request
      * @returns {Object}
      */
-    updateLocusWithDelta: (meeting: any, response: any) => any;
+    updateLocusFromApiResponse: (meeting: any, response: any) => any;
     generateBuildLocusDeltaRequestOptions: (originalMeeting: any) => (originalOptions: any) => any;
     generateLocusDeltaRequest: (originalMeeting: any) => (originalOptions: any) => any;
     selfSupportsFeature: (feature: SELF_POLICY, userPolicies: Record<SELF_POLICY, boolean>) => boolean;

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

@@ -187,20 +187,22 @@ export default class MeetingInfoV2 {
      * @param {String} conversationUrl conversationUrl to start adhoc meeting on
      * @param {String} installedOrgID org ID of user's machine
      * @param {Boolean} enableStaticMeetingLink whether or not to enable static meeting link
+     * @param {String} classificationId need it to start adhoc meeting if space support classification
      * @returns {Promise} returns a meeting info object
      * @public
      * @memberof MeetingInfo
      */
-    createAdhocSpaceMeetingOrEnableStaticMeetingLink(conversationUrl: string, installedOrgID?: string, enableStaticMeetingLink?: boolean): Promise<any>;
+    createAdhocSpaceMeetingOrEnableStaticMeetingLink(conversationUrl: string, installedOrgID?: string, enableStaticMeetingLink?: boolean, classificationId?: any): Promise<any>;
     /**
      * 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
+     * @param {String} classificationId if space is support classification, it needs provide it during start instant meeting
      * @returns {Promise} returns a meeting info object
      * @public
      * @memberof MeetingInfo
      */
-    createAdhocSpaceMeeting(conversationUrl: string, installedOrgID?: string): Promise<any>;
+    createAdhocSpaceMeeting(conversationUrl: string, installedOrgID?: string, classificationId?: string): Promise<any>;
     /**
      * Fetches details for static meeting link
      * @param {String} conversationUrl conversationUrl that's required to find static meeting link if it exists
@@ -239,6 +241,7 @@ export default class MeetingInfoV2 {
      * @param {Object} options
      * @param {String} registrationId
      * @param {String} fullSiteUrl
+     * @param {String} classificationId
      * @returns {Promise} returns a meeting info object
      * @public
      * @memberof MeetingInfo
@@ -249,5 +252,5 @@ export default class MeetingInfoV2 {
     }, installedOrgID?: any, locusId?: any, extraParams?: object, options?: {
         meetingId?: string;
         sendCAevents?: boolean;
-    }, registrationId?: string, fullSiteUrl?: string): Promise<any>;
+    }, registrationId?: string, fullSiteUrl?: string, classificationId?: string): Promise<any>;
 }

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

@@ -400,11 +400,12 @@ export default class Meetings extends WebexPlugin {
      * @param {Object} [meetingInfo] - Pre-fetched complete meeting info
      * @param {String} [meetingLookupUrl] - meeting info prefetch url
      * @param {string} sessionCorrelationId - the optional specified sessionCorrelationId (callStateForMetrics.sessionCorrelationId) can be provided instead
+     * @param {String} classificationId - If space support classification, it will provide it while start instant meeting
      * @returns {Promise<Meeting>} A new Meeting.
      * @public
      * @memberof Meetings
      */
-    create(destination: string, type?: DESTINATION_TYPE, useRandomDelayForInfo?: boolean, infoExtraParams?: {}, correlationId?: string, failOnMissingMeetingInfo?: boolean, callStateForMetrics?: CallStateForMetrics, meetingInfo?: any, meetingLookupUrl?: any, sessionCorrelationId?: string): any;
+    create(destination: string, type?: DESTINATION_TYPE, useRandomDelayForInfo?: boolean, infoExtraParams?: {}, correlationId?: string, failOnMissingMeetingInfo?: boolean, callStateForMetrics?: CallStateForMetrics, meetingInfo?: any, meetingLookupUrl?: any, sessionCorrelationId?: string, classificationId?: string): any;
     /**
      * Enable static meeting links for given conversation url.
      *
@@ -438,6 +439,7 @@ export default class Meetings extends WebexPlugin {
      * @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
+     * @param {String} classificationId see create()
      * @returns {Promise} a new meeting instance complete with meeting info and destination
      * @private
      * @memberof Meetings

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

@@ -95,4 +95,5 @@ export interface Participant {
     status: ParticipantMediaStatus;
     type: string;
     url: ParticipantUrl;
+    isRemoved: boolean;
 }

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

@@ -22,6 +22,12 @@ export default class MembersCollection {
      * @memberof MembersCollection
      */
     getAll(): Record<string, Member>;
+    /**
+     * Removes a member from the collection
+     * @param {String} id
+     * @returns {void}
+     */
+    remove(id: string): void;
     /**
      * @returns {void}
      * reset members

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

@@ -77,7 +77,9 @@ export default class Members extends StatelessWebexPlugin {
      * 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
+     * @param {Object} payload.participants new/updated participants
+     * @param {Boolean} payload.isReplace whether to replace the whole members collection
+     * @param {Object} payload.removedParticipantIds ids of the removed participants
      * @returns {undefined}
      * @private
      * @memberof Members
@@ -85,6 +87,7 @@ export default class Members extends StatelessWebexPlugin {
     locusParticipantsUpdate(payload: {
         participants: object;
         isReplace?: boolean;
+        removedParticipantIds?: Array<string>;
     }): void;
     /**
      * Internal update the content id
@@ -127,6 +130,12 @@ export default class Members extends StatelessWebexPlugin {
      * @memberof Members
      */
     private handleMembersUpdate;
+    /**
+     * removes members from the collection
+     * @param {Array<string>} removedMembers removed members ids
+     * @returns {void}
+     */
+    private removeMembers;
     /**
      * set members to the member collection from each updated/added lists as passed in
      * @param {Array} list
@@ -338,9 +347,10 @@ export default class Members extends StatelessWebexPlugin {
      * @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} [suffix] - name suffix (optional)
      * @returns {Promise}
      * @public
      * @memberof Members
      */
-    editDisplayName(memberId: string, requestingParticipantId: string, alias: string): any;
+    editDisplayName(memberId: string, requestingParticipantId: string, alias: string, suffix?: string): any;
 }

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

@@ -110,13 +110,15 @@ declare const MembersUtil: {
      * @param {String} requestingParticipantId id of the participant who is sending request (optional)
      * @param {String} alias alias name
      * @param {String} locusUrl url
+     * @param {String} suffix optional suffix
      * @returns {Object} consists of {memberID: string, requestingParticipantId: string, alias: string, locusUrl: string}
      */
-    generateEditDisplayNameMemberOptions: (memberId: any, requestingParticipantId: any, alias: any, locusUrl: any) => {
+    generateEditDisplayNameMemberOptions: (memberId: any, requestingParticipantId: any, alias: any, locusUrl: any, suffix: any) => {
         memberId: any;
         requestingParticipantId: any;
         alias: any;
         locusUrl: any;
+        suffix: any;
     };
     getMuteMemberRequestParams: (options: any) => {
         method: string;
@@ -178,8 +180,9 @@ declare const MembersUtil: {
         method: string;
         uri: string;
         body: {
-            aliasValue: any;
-            requestingParticipantId: any;
+            aliasValue: string;
+            requestingParticipantId: string;
+            suffixValue?: string;
         };
     };
     getTransferHostToMemberRequestParams: (options: any) => {

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

@@ -83,5 +83,6 @@ declare const BEHAVIORAL_METRICS: {
     VERIFY_REGISTRATION_ID_SUCCESS: string;
     VERIFY_REGISTRATION_ID_ERROR: string;
     JOIN_FORBIDDEN_ERROR: string;
+    MEDIA_ISSUE_DETECTED: string;
 };
 export { BEHAVIORAL_METRICS as default };

package/dist/webinar/index.js

@@ -458,7 +458,7 @@ var Webinar = _webexCore.WebexPlugin.extend({
       }, _callee7);
     }))();
   },
-  version: "3.9.0-next.2"
+  version: "3.9.0-next.21"
 });
 var _default = exports.default = Webinar;
 //# sourceMappingURL=index.js.map

package/package.json

@@ -19,7 +19,7 @@
     "directory": "packages/@webex/plugin-meetings"
   },
   "engines": {
-    "node": ">=16"
+    "node": ">=18"
   },
   "browserify": {
     "transform": [
@@ -43,7 +43,7 @@
     "@webex/eslint-config-legacy": "0.0.0",
     "@webex/jest-config-legacy": "0.0.0",
     "@webex/legacy-tools": "0.0.0",
-    "@webex/plugin-rooms": "3.8.1-next.15",
+    "@webex/plugin-rooms": "3.9.0-next.5",
     "@webex/test-helper-chai": "3.8.1-next.11",
     "@webex/test-helper-mocha": "3.8.1-next.11",
     "@webex/test-helper-mock-webex": "3.8.1-next.11",
@@ -61,22 +61,22 @@
   },
   "dependencies": {
     "@webex/common": "3.8.1-next.11",
-    "@webex/event-dictionary-ts": "^1.0.1819",
-    "@webex/internal-media-core": "2.18.5",
-    "@webex/internal-plugin-conversation": "3.8.1-next.18",
-    "@webex/internal-plugin-device": "3.8.1-next.15",
-    "@webex/internal-plugin-llm": "3.8.1-next.16",
-    "@webex/internal-plugin-mercury": "3.8.1-next.15",
-    "@webex/internal-plugin-metrics": "3.8.1-next.15",
-    "@webex/internal-plugin-support": "3.8.1-next.18",
-    "@webex/internal-plugin-user": "3.8.1-next.15",
-    "@webex/internal-plugin-voicea": "3.8.1-next.42",
-    "@webex/media-helpers": "3.8.1-next.16",
-    "@webex/plugin-people": "3.8.1-next.15",
-    "@webex/plugin-rooms": "3.8.1-next.15",
+    "@webex/event-dictionary-ts": "^1.0.1930",
+    "@webex/internal-media-core": "2.19.0",
+    "@webex/internal-plugin-conversation": "3.9.0-next.5",
+    "@webex/internal-plugin-device": "3.9.0-next.4",
+    "@webex/internal-plugin-llm": "3.9.0-next.4",
+    "@webex/internal-plugin-mercury": "3.9.0-next.4",
+    "@webex/internal-plugin-metrics": "3.9.0-next.4",
+    "@webex/internal-plugin-support": "3.9.0-next.6",
+    "@webex/internal-plugin-user": "3.9.0-next.4",
+    "@webex/internal-plugin-voicea": "3.9.0-next.5",
+    "@webex/media-helpers": "3.9.0-next.1",
+    "@webex/plugin-people": "3.9.0-next.4",
+    "@webex/plugin-rooms": "3.9.0-next.5",
     "@webex/ts-sdp": "^1.8.1",
     "@webex/web-capabilities": "^1.6.0",
-    "@webex/webex-core": "3.8.1-next.15",
+    "@webex/webex-core": "3.9.0-next.4",
     "ampersand-collection": "^2.0.2",
     "bowser": "^2.11.0",
     "btoa": "^1.2.1",
@@ -92,5 +92,5 @@
   "//": [
     "TODO: upgrade jwt-decode when moving to node 18"
   ],
-  "version": "3.9.0-next.2"
+  "version": "3.9.0-next.21"
 }

package/src/constants.ts

@@ -347,6 +347,7 @@ export const EVENT_TRIGGERS = {
   MEETING_SELF_LEFT: 'meeting:self:left',
   NETWORK_QUALITY: 'network:quality',
   MEDIA_NEGOTIATED: 'media:negotiated',
+  MEDIA_INBOUND_AUDIO_ISSUE_DETECTED: 'media:inboundAudio:issueDetected',
   // the following events apply only to multistream media connections
   ACTIVE_SPEAKER_CHANGED: 'media:activeSpeakerChanged',
   REMOTE_VIDEO_SOURCE_COUNT_CHANGED: 'media:remoteVideoSourceCountChanged',
@@ -966,6 +967,7 @@ export const DISPLAY_HINTS = {
   MANUAL_CAPTION_STOP: 'MANUAL_CAPTION_STOP',
   MANUAL_CAPTION_STATUS_ACTIVE: 'MANUAL_CAPTION_STATUS_ACTIVE',
   DISPLAY_REAL_TIME_TRANSLATION: 'DISPLAY_REAL_TIME_TRANSLATION',
+  SPOKEN_LANGUAGE_AUTO_DETECTION_ENABLED: 'SPOKEN_LANGUAGE_AUTO_DETECTION_ENABLED',
   ENABLE_CAPTION_PANEL: 'ENABLE_CAPTION_PANEL',
   DISPLAY_NON_ENGLISH_ASR: 'DISPLAY_NON_ENGLISH_ASR',
   TRANSCRIPTION_CONTROL_START: 'TRANSCRIPTION_CONTROL_START',