@webex/plugin-meetings 3.7.0-next.9 → 3.7.0-wxcc.1

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

@@ -229,11 +229,12 @@ export default class LocusInfo extends EventsScope {
     /**
      * handles when the locus.mediaShares is updated
      * @param {Object} mediaShares the locus.mediaShares property
+     * @param {boolean} forceUpdate force to update the mediaShares
      * @returns {undefined}
      * @memberof LocusInfo
      * emits internal event locus_info_update_media_shares
      */
-    updateMediaShares(mediaShares: object): void;
+    updateMediaShares(mediaShares: object, forceUpdate?: boolean): void;
     /**
      * @param {String} participantsUrl
      * @returns {undefined}

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

@@ -43,6 +43,7 @@ interface IInMeetingActions {
     waitingForOthersToJoin?: boolean;
     canSendReactions?: boolean;
     canManageBreakout?: boolean;
+    canStartBreakout?: boolean;
     canBroadcastMessageToBreakout?: boolean;
     canAdmitLobbyToBreakout?: boolean;
     isBreakoutPreassignmentsEnabled?: boolean;
@@ -137,6 +138,7 @@ export default class InMeetingActions implements IInMeetingActions {
     waitingForOthersToJoin: any;
     canSendReactions: any;
     canManageBreakout: any;
+    canStartBreakout: any;
     canBroadcastMessageToBreakout: any;
     canAdmitLobbyToBreakout: any;
     isBreakoutPreassignmentsEnabled: any;

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

@@ -837,6 +837,14 @@ export default class Meeting extends StatelessWebexPlugin {
         authorizingLocusUrl: string;
         mainLocusUrl: string;
     }): any;
+    /**
+     * Manages be right back status updates for the current participant.
+     *
+     * @param {boolean} enabled - Indicates whether the user enabled brb or not.
+     * @returns {Promise<void>} resolves when the brb status is updated or does nothing if not in a multistream meeting.
+     * @throws {Error} - Throws an error if the request fails.
+     */
+    beRightBack(enabled: boolean): Promise<void>;
     /**
      * Remove the member from the meeting, boot them
      * @param {String} memberId
@@ -1046,11 +1054,12 @@ export default class Meeting extends StatelessWebexPlugin {
      * Close the peer connections and remove them from the class.
      * Cleanup any media connection related things.
      *
+     * @param {boolean} resetMuteStates whether to also reset the audio/video mute state information
      * @returns {Promise}
      * @public
      * @memberof Meeting
      */
-    closePeerConnections(): Promise<void>;
+    closePeerConnections(resetMuteStates?: boolean): Promise<void>;
     /**
      * Unsets the peer connections on the class
      * warning DO NOT CALL WITHOUT CLOSING PEER CONNECTIONS FIRST
@@ -1115,7 +1124,7 @@ export default class Meeting extends StatelessWebexPlugin {
      * @param {Object} options - options to join with media
      * @param {JoinOptions} [options.joinOptions] - see #join()
      * @param {AddMediaOptions} [options.mediaOptions] - see #addMedia()
-     * @returns {Promise} -- {join: see join(), media: see addMedia()}
+     * @returns {Promise} -- {join: see join(), media: see addMedia(), multistreamEnabled: flag to indicate if we managed to join in multistream mode}
      * @public
      * @memberof Meeting
      * @example
@@ -1337,16 +1346,6 @@ export default class Meeting extends StatelessWebexPlugin {
      * @returns {void}
      */
     private createStatsAnalyzer;
-    /**
-     * Handles device logging
-     *
-     * @private
-     * @static
-     * @param {boolean} isAudioEnabled
-     * @param {boolean} isVideoEnabled
-     * @returns {Promise<void>}
-     */
-    private static handleDeviceLogging;
     /**
      * Returns a promise. This promise is created once the local sdp offer has been successfully created and is resolved
      * once the remote sdp answer has been received.
@@ -1412,6 +1411,14 @@ export default class Meeting extends StatelessWebexPlugin {
      * @returns {Promise<void>}
      */
     private cleanUpOnAddMediaFailure;
+    /**
+     * Cleans up stats analyzer, peer connection and other things before
+     * we can create a new transcoded media connection
+     *
+     * @private
+     * @returns {Promise<void>}
+     */
+    private downgradeFromMultistreamToTranscoded;
     /**
      * Sends stats report, closes peer connection and cleans up any media connection
      * related things before trying to establish media connection again with turn server

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

@@ -73,4 +73,8 @@ export declare class LocusMediaRequest extends WebexPlugin {
     send(request: Request): Promise<RequestResult>;
     /** Returns true if a confluence on the server is already created */
     isConfluenceCreated(): boolean;
+    /**
+     * This method needs to be called when we downgrade from multistream to transcoded connection.
+     */
+    downgradeFromMultistreamToTranscoded(): void;
 }

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

@@ -1,5 +1,5 @@
 import { StatelessWebexPlugin } from '@webex/webex-core';
-import { SendReactionOptions, ToggleReactionsOptions } from './request.type';
+import { SendReactionOptions, BrbOptions, ToggleReactionsOptions } from './request.type';
 import { AnnotationInfo } from '../annotation/annotation.types';
 import { ClientMediaPreferences } from '../reachability/reachability.types';
 /**
@@ -292,4 +292,15 @@ export default class MeetingRequest extends StatelessWebexPlugin {
      */
     toggleReactions({ enable, locusUrl, requestingParticipantId }: ToggleReactionsOptions): Promise<any>;
     getLocusStatusByUrl(locusUrl: string): any;
+    /**
+     * Sends a request to set be right back status.
+     *
+     * @param {Object} options - The options for brb request.
+     * @param {boolean} options.enabled - Whether brb status is enabled.
+     * @param {string} options.locusUrl - The URL of the locus.
+     * @param {string} options.deviceUrl - The URL of the device.
+     * @param {string} options.selfId - The ID of the participant.
+     * @returns {Promise}
+     */
+    setBrb({ enabled, locusUrl, deviceUrl, selfId }: BrbOptions): Promise<any>;
 }

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

@@ -9,3 +9,9 @@ export type ToggleReactionsOptions = {
     locusUrl: string;
     requestingParticipantId: string;
 };
+export type BrbOptions = {
+    enabled: boolean;
+    locusUrl: string;
+    deviceUrl: string;
+    selfId: string;
+};

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

@@ -54,6 +54,7 @@ declare const MeetingUtil: {
     canUserLowerSomeoneElsesHand: (displayHints: any) => any;
     bothLeaveAndEndMeetingAvailable: (displayHints: any) => any;
     canManageBreakout: (displayHints: any) => any;
+    canStartBreakout: (displayHints: any) => boolean;
     canBroadcastMessageToBreakout: (displayHints: any, policies?: {}) => boolean;
     isSuppressBreakoutSupport: (displayHints: any) => any;
     canAdmitLobbyToBreakout: (displayHints: any) => boolean;
@@ -63,7 +64,6 @@ declare const MeetingUtil: {
     unlockMeeting: (actions: any, request: any, locusUrl: any) => any;
     handleAudioLogging: (audioStream?: LocalMicrophoneStream) => void;
     handleVideoLogging: (videoStream?: LocalCameraStream) => void;
-    handleDeviceLogging: (devices?: any[]) => void;
     endMeetingForAll: (meeting: any) => any;
     canEnableClosedCaption: (displayHints: any) => any;
     isSaveTranscriptsEnabled: (displayHints: any) => any;

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

@@ -65,9 +65,26 @@ export declare class MeetingInfoV2CaptchaError extends Error {
     constructor(wbxAppApiErrorCode?: number, captchaInfo?: object, message?: string);
 }
 /**
- * Error preventing join because of a webinar registration error
+ * Error preventing join because of a webinar have some error
  */
-export declare class MeetingInfoV2WebinarRegistrationError extends Error {
+export declare class MeetingInfoV2JoinWebinarError extends Error {
+    meetingInfo: any;
+    sdkMessage: any;
+    wbxAppApiCode: any;
+    body: any;
+    /**
+     *
+     * @constructor
+     * @param {Number} [wbxAppApiErrorCode]
+     * @param {Object} [meetingInfo]
+     * @param {String} [message]
+     */
+    constructor(wbxAppApiErrorCode?: number, meetingInfo?: object, message?: string);
+}
+/**
+ * Error preventing join because of a forbidden error
+ */
+export declare class MeetingInfoV2JoinForbiddenError extends Error {
     meetingInfo: any;
     sdkMessage: any;
     wbxAppApiCode: any;
@@ -107,11 +124,17 @@ export default class MeetingInfoV2 {
      */
     handlePolicyError: (err: any) => void;
     /**
-     * Raises a handleWebinarRegistrationError for webinar registration error codes
+     * Raises a handleJoinWebinarError for join webinar error codes
+     * @param {any} err the error from the request
+     * @returns {void}
+     */
+    handleJoinWebinarError: (err: any) => void;
+    /**
+     * Raises a handleForbiddenError for join meeting forbidden error
      * @param {any} err the error from the request
      * @returns {void}
      */
-    handleWebinarRegistrationError: (err: any) => void;
+    handleForbiddenError: (err: any) => void;
     /**
      * Creates adhoc space meetings for a space by fetching the conversation infomation
      * @param {String} conversationUrl conversationUrl to start adhoc meeting on

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

@@ -8,7 +8,7 @@ import 'webrtc-adapter';
 import { DESTINATION_TYPE } from '../constants';
 import { CallStateForMetrics } from '../meeting';
 import Reachability from '../reachability';
-import { INoiseReductionEffect, IVirtualBackgroundEffect } from './meetings.types';
+import { INoiseReductionEffect, IVirtualBackgroundEffect, MeetingRegistrationStatus } from './meetings.types';
 /**
  * Meetings Ready Event
  * Emitted when the meetings instance on webex is ready
@@ -94,6 +94,7 @@ export default class Meetings extends WebexPlugin {
     mediaHelpers: any;
     breakoutLocusForHandleLater: any;
     namespace: string;
+    registrationStatus: MeetingRegistrationStatus;
     /**
      * Initializes the Meetings Plugin
      * @constructor
@@ -178,6 +179,13 @@ export default class Meetings extends WebexPlugin {
      * @memberof Meetings
      */
     private onReady;
+    /**
+     * API to change log upload interval. Setting the factor to 0 will disable periodic log uploads.
+     *
+     * @param {number} factor new factor value
+     * @returns {void}
+     */
+    private _setLogUploadIntervalMultiplicationFactor;
     /**
      * API to toggle unified meetings
      * @param {Boolean} changeState
@@ -219,6 +227,13 @@ export default class Meetings extends WebexPlugin {
      * @returns {undefined}
      */
     private _toggleIpv6BackendNativeSupport;
+    /**
+     * Executes a registration step and updates the registration status.
+     * @param {Function} step - The registration step to execute.
+     * @param {string} stepName - The name of the registration step.
+     * @returns {Promise} A promise that resolves when the step is completed.
+     */
+    executeRegistrationStep(step: () => Promise<any>, stepName: string): Promise<void>;
     /**
      * Explicitly sets up the meetings plugin by registering
      * the device, connecting to mercury, and listening for locus events.

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

@@ -11,3 +11,11 @@ export declare const MEETING_KEY: {
     readonly CORRELATION_ID: "correlationId";
 };
 export type MEETING_KEY = Enum<typeof MEETING_KEY>;
+export type MeetingRegistrationStatus = {
+    fetchWebexSite: boolean;
+    getGeoHint: boolean;
+    startReachability: boolean;
+    deviceRegister: boolean;
+    mercuryConnect: boolean;
+    checkH264Support: boolean;
+};

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

@@ -21,6 +21,7 @@ export default class Member {
     isRecording: any;
     isRemovable: any;
     isSelf: any;
+    isBrb: boolean;
     isUser: any;
     isVideoMuted: any;
     roles: IExternalRoles;

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

@@ -19,6 +19,13 @@ export type ParticipantWithRoles = {
         };
     };
 };
+export type ParticipantWithBrb = {
+    controls: {
+        brb?: {
+            enabled: boolean;
+        };
+    };
+};
 export declare enum MediaStatus {
     RECVONLY = "RECVONLY",
     SENDONLY = "SENDONLY",

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

@@ -67,8 +67,9 @@ declare const BEHAVIORAL_METRICS: {
     ROAP_HTTP_RESPONSE_MISSING: string;
     TURN_DISCOVERY_REQUIRES_OK: string;
     REACHABILITY_COMPLETED: string;
-    WEBINAR_REGISTRATION_ERROR: string;
+    JOIN_WEBINAR_ERROR: string;
     GUEST_ENTERED_LOBBY: string;
     GUEST_EXITED_LOBBY: string;
+    JOIN_FORBIDDEN_ERROR: string;
 };
 export { BEHAVIORAL_METRICS as default };

package/dist/types/multistream/sendSlotManager.d.ts

@@ -1,4 +1,4 @@
-import { SendSlot, MediaType, LocalStream, MultistreamRoapMediaConnection, NamedMediaGroup } from '@webex/internal-media-core';
+import { SendSlot, MediaType, LocalStream, MultistreamRoapMediaConnection, NamedMediaGroup, StreamState } from '@webex/internal-media-core';
 export default class SendSlotManager {
     private readonly slots;
     private readonly LoggerProxy;
@@ -25,6 +25,13 @@ export default class SendSlotManager {
      * @returns {void}
      */
     setNamedMediaGroups(mediaType: MediaType, namedMediaGroups: NamedMediaGroup[]): void;
+    /**
+     * Sets the source state override for the given media type.
+     * @param {MediaType} mediaType - The type of media (must be MediaType.VideoMain to apply source state changes).
+     * @param {StreamState | null} state - The state to set or null to clear the override value.
+     * @returns {void}
+     */
+    setSourceStateOverride(mediaType: MediaType, state: StreamState | null): void;
     /**
      * This method publishes the given stream to the sendSlot for the given mediaType
      * @param {MediaType} mediaType MediaType of the sendSlot to which a stream needs to be published (AUDIO_MAIN/VIDEO_MAIN/AUDIO_SLIDES/VIDEO_SLIDES)