@webex/plugin-meetings 3.12.0-next.6 → 3.12.0-next.61

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

@@ -16,7 +16,7 @@ import { DESTINATION_TYPE, NETWORK_STATUS } from '../constants';
 import { ReceiveSlotManager } from '../multistream/receiveSlotManager';
 import { MediaRequestManager } from '../multistream/mediaRequestManager';
 import { Configuration as RemoteMediaManagerConfiguration, RemoteMediaManager } from '../multistream/remoteMediaManager';
-import { ReactionServerType, SkinToneType } from '../reactions/reactions.type';
+import { SkinToneType } from '../reactions/reactions.type';
 import InMeetingActions from './in-meeting-actions';
 import RecordingController from '../recording-controller';
 import ControlsOptionsManager from '../controls-options-manager';
@@ -374,7 +374,7 @@ export default class Meeting extends StatelessWebexPlugin {
     webinar: any;
     conversationUrl: string;
     callStateForMetrics: CallStateForMetrics;
-    destination: string;
+    destination: string | LocusDTO;
     destinationType: DESTINATION_TYPE;
     deviceUrl: string;
     hostId: string;
@@ -412,6 +412,8 @@ export default class Meeting extends StatelessWebexPlugin {
     floorGrantPending: boolean;
     hasJoinedOnce: boolean;
     hasWebsocketConnected: boolean;
+    private mercuryOnlineHandler?;
+    private mercuryOfflineHandler?;
     inMeetingActions: InMeetingActions;
     isLocalShareLive: boolean;
     isRoapInProgress: boolean;
@@ -514,6 +516,15 @@ export default class Meeting extends StatelessWebexPlugin {
      * @memberof Meeting
      */
     constructor(attrs: any, options: object, callback: (meeting: Meeting) => void);
+    /**
+     * Get the ingress payload type for a given media type and codec mime type
+     * @param {MediaType} mediaType - The media type
+     * @param {MediaCodecMimeType} codecMimeType - The codec mime type
+     * @returns {number | undefined} - The ingress payload type
+     * @private
+     * @memberof Meeting
+     */
+    private getIngressPayloadTypeCallback;
     /**
      * returns meeting is joined
      * @private
@@ -1051,6 +1062,13 @@ export default class Meeting extends StatelessWebexPlugin {
      * @memberof Meeting
      */
     setSipUri(sipUri: string): void;
+    /**
+     * After initial locus setup, refreshes destination with synced locus data and optionally
+     * performs deferred meeting info fetch when initial locus was incomplete.
+     * @param {LocusDTO} locus
+     * @returns {void}
+     */
+    finalizeMeetingAfterInitialLocusSetup(locus: LocusDTO): Promise<void>;
     /**
      * Set the locus info the class instance. Should be called with the parsed locus
      * we got in the join response.
@@ -1163,6 +1181,22 @@ export default class Meeting extends StatelessWebexPlugin {
      * @memberof Meeting
      */
     setMercuryListener(): void;
+    /**
+     * Removes this meeting's Mercury ONLINE/OFFLINE event listeners registered
+     * by setMercuryListener(). Must be called before Locus /leave to avoid
+     * unnecessary syncs/metrics triggered by events received while leaving
+     * (per Locus team recommendation).
+     *
+     * Mercury is a process-wide singleton shared with other plugins, so we
+     * pass the bound handler refs to .off() to avoid clearing every listener
+     * for ONLINE/OFFLINE on the shared emitter.
+     *
+     * Idempotent: subsequent calls are no-ops because the handler refs are
+     * cleared after detaching.
+     * @private
+     * @returns {void}
+     */
+    private stopListeningForMercuryEvents;
     /**
      * Close the peer connections and remove them from the class.
      * Cleanup any media connection related things.
@@ -1299,6 +1333,12 @@ export default class Meeting extends StatelessWebexPlugin {
      * @returns {void}
      */
     private processLocusLLMEvent;
+    /**
+     * Verifies the relay event was delivered for the active LLM session binding.
+     * @param {RelayEvent} event Event object coming from LLM Connection
+     * @returns {boolean}
+     */
+    private isRelayEventRouteValid;
     /**
      * Callback called when a relay event is received from meeting LLM Connection
      * @param {RelayEvent} e Event object coming from LLM Connection
@@ -1318,6 +1358,11 @@ export default class Meeting extends StatelessWebexPlugin {
      * @returns{void}
      */
     private triggerStopReceivingTranscriptionEvent;
+    /**
+     * Restores LLM subchannel subscriptions after reconnect when captions are active.
+     * @returns {void}
+     */
+    private restoreLLMSubscriptionsIfNeeded;
     /**
      * This is a callback for the LLM event that is triggered when it comes online
      * This method in turn will trigger an event to the developers that the LLM is connected
@@ -1351,8 +1396,41 @@ export default class Meeting extends StatelessWebexPlugin {
      * @returns {void}
      */
     private clearLLMHealthCheckTimer;
+    /**
+     * Removes LLM event listeners and clears the health check timer.
+     * Must be called before Locus /leave to avoid unnecessary syncs triggered
+     * by events received while leaving (per Locus team recommendation).
+     * Idempotent: safe to call multiple times; .off() is a no-op when no
+     * matching listener is registered.
+     * @private
+     * @returns {void}
+     */
+    private stopListeningForLLMEvents;
+    /**
+     * Stops listening on every event bus (LLM, Mercury, voicea/transcription,
+     * annotation) that could otherwise deliver events to this meeting while
+     * Locus is processing /leave or /end. Per the Locus team recommendation,
+     * this must run before the Locus request is dispatched to avoid
+     * unnecessary syncs triggered by in-flight events.
+     *
+     * Voicea (transcription) subscribes to llm 'event:relay.event' internally,
+     * and the annotation plugin subscribes to both mercury and llm, so both
+     * must be torn down alongside the direct LLM/Mercury listeners.
+     *
+     * Idempotent: safe to call multiple times; .off() is a no-op when no
+     * matching listener is registered, and stopTranscription is guarded.
+     * @private
+     * @returns {void}
+     */
+    private stopListeningForMeetingEvents;
     /**
      * Disconnects and cleans up the default LLM session listeners/timers.
+     *
+     * Ownership-aware: only calls `disconnectLLM` when this meeting is the
+     * current owner of the default LLM session (or when no owner is recorded).
+     * Event listeners belonging to this meeting instance are always detached
+     * so they do not receive another meeting's relay events.
+     *
      * @param {Object} options
      * @param {boolean} [options.removeOnlineListener=true] removes the one-time online listener
      * @param {boolean} [options.throwOnError=true] rethrows disconnect errors when true
@@ -1372,6 +1450,12 @@ export default class Meeting extends StatelessWebexPlugin {
      * @returns {void}
      */
     saveDataChannelToken(join: any): void;
+    /**
+     * Ensures default-session data channel token exists after lobby admission.
+     * Some lobby users do not receive a token until they are admitted.
+     * @returns {Promise<boolean>} true when a new token is fetched and cached
+     */
+    private ensureDefaultDatachannelTokenAfterAdmit;
     /**
      * Connects to low latency mercury and reconnects if the address has changed
      * It will also disconnect if called when the meeting has ended
@@ -1969,7 +2053,7 @@ export default class Meeting extends StatelessWebexPlugin {
      * @public
      * @memberof Meeting
      */
-    sendReaction(reactionType: ReactionServerType, skinToneType?: SkinToneType): any;
+    sendReaction(reactionType: string, skinToneType?: SkinToneType): any;
     /**
      * Extend the current meeting duration.
      *

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

@@ -133,6 +133,13 @@ declare const MeetingUtil: {
      * @returns {void}
      */
     addSequence: (meeting: any, requestBody: any) => void;
+    /**
+     * Checks if Locus API response contains a Locus DTO
+     *
+     * @param {any} response http response from Locus API call
+     * @returns {boolean} true if response contains a Locus DTO
+     */
+    isLocusDtoInAPIResponse(response: any): any;
     /**
      * Updates the locus info for the meeting with the locus
      * information returned from API requests made to Locus
@@ -146,6 +153,7 @@ declare const MeetingUtil: {
     generateLocusDeltaRequest: (originalMeeting: any) => (originalOptions: any) => any;
     canAttendeeRequestAiAssistantEnabled: (displayHints?: any[], roles?: any[]) => boolean;
     attendeeRequestAiAssistantDeclinedAll: (displayHints?: any[]) => boolean;
+    isAnonymizeDisplayNamesEnabled: (displayHints: any) => any;
     selfSupportsFeature: (feature: SELF_POLICY, userPolicies: Record<SELF_POLICY, boolean>) => boolean;
     parseInterpretationInfo: (meeting: any, meetingInfo: any) => void;
     /**

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

@@ -8,7 +8,7 @@ import 'webrtc-adapter';
 import { LOCUSEVENT, DESTINATION_TYPE } from '../constants';
 import { CallStateForMetrics } from '../meeting';
 import Reachability from '../reachability';
-import { INoiseReductionEffect, IVirtualBackgroundEffect, MeetingRegistrationStatus } from './meetings.types';
+import { FetchSitePreferencesMeViaSiteOptions, INoiseReductionEffect, IVirtualBackgroundEffect, MeetingRegistrationStatus, SitePreferencesResponse } from './meetings.types';
 import { HashTreeMessage } from '../hashTree/hashTreeParser';
 export type LocusEvent = {
     eventType: LOCUSEVENT;
@@ -254,6 +254,16 @@ export default class Meetings extends WebexPlugin {
      * @returns {undefined}
      */
     private _toggleEnableAudioTwccForMultistream;
+    /**
+     * API to toggle AV1 codec support for video slides in multistream,
+     * needs to be called before webex.meetings.joinWithMedia()
+     *
+     * @param {Boolean} newValue
+     * @private
+     * @memberof Meetings
+     * @returns {undefined}
+     */
+    private _toggleEnableAv1SlidesSupport;
     /**
      * API to toggle stopping ICE Candidates Gathering after first relay candidate,
      * needs to be called before webex.meetings.joinWithMedia()
@@ -368,6 +378,23 @@ export default class Meetings extends WebexPlugin {
      * @memberof Meetings
      */
     getPersonalMeetingRoom(): any;
+    /**
+     * Fetches site preferences for the provided Webex site, or the preferred Webex site.
+     * This is used to determine capabilities of the site, such as whether scheduling a webinar is supported.
+     *
+     * @param {object} [options]
+     * @param {string} [options.siteUrl] - Webex site URL. Defaults to preferredWebexSite, for example "cisco.webex.com".
+     * @param {string} [options.siteName] - Site name query override. Defaults to the site name derived from siteUrl, for example "cisco" for "cisco.webex.com".
+     * @param {SitePreferenceSelectOption[]} [options.selectOptions] - Preference sections to fetch. Defaults to 'scheduling'.
+     * @returns {Promise<SitePreferencesResponse>} site preferences response body
+     * @throws {ParameterError}
+     * @public
+     * @memberof Meetings
+     * @example
+     * const preferences = await webex.meetings.fetchSitePreferencesMeViaSite();
+     * const supportScheduleWebinar = preferences?.scheduling?.supportScheduleWebinar;
+     */
+    fetchSitePreferencesMeViaSite(options?: FetchSitePreferencesMeViaSiteOptions): Promise<SitePreferencesResponse>;
     /**
      * Returns basic information about a meeting that exists or
      * used to exist in the MeetingCollection
@@ -477,8 +504,9 @@ export default class Meetings extends WebexPlugin {
      * @public
      * @memberof Meetings
      */
-    syncMeetings({ keepOnlyLocusMeetings }?: {
+    syncMeetings({ keepOnlyLocusMeetings, skipHashTreeSync, }?: {
         keepOnlyLocusMeetings?: boolean;
+        skipHashTreeSync?: boolean;
     }): Promise<void>;
     /**
      * sort out locus array for initial creating

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

@@ -19,3 +19,18 @@ export type MeetingRegistrationStatus = {
     mercuryConnect: boolean;
     checkH264Support: boolean;
 };
+export declare enum SitePreferenceSelectOption {
+    SCHEDULING = "scheduling"
+}
+export type FetchSitePreferencesMeViaSiteOptions = {
+    siteUrl?: string;
+    siteName?: string;
+    selectOptions?: SitePreferenceSelectOption[];
+};
+export declare const DEFAULT_SITE_PREFERENCE_SELECT_OPTIONS: SitePreferenceSelectOption[];
+export type SitePreferencesResponse = {
+    scheduling?: {
+        supportScheduleWebinar?: boolean;
+        webinarWebLink?: string;
+    };
+};

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

@@ -1,4 +1,5 @@
 import { StatelessWebexPlugin } from '@webex/webex-core';
+import { type FetchSitePreferencesMeViaSiteOptions, type SitePreferencesResponse } from './meetings.types';
 /**
  * @class MeetingRequest
  */
@@ -18,6 +19,19 @@ export default class MeetingRequest extends StatelessWebexPlugin {
      * @returns {Promise<object>} getMeetingPreferences
      */
     getMeetingPreferences(): any;
+    /**
+     * Fetches site preferences from a given site given a select option and a siteUrl with an optional siteName. If siteName is not provided, it will be derived from the siteUrl. If siteUrl is not provided, it will throw an error. If selectOptions is not provided, it will default to scheduling.
+     *
+     * @param {object} [options]
+     * @param {string} [options.siteUrl] - Webex site URL, for example "cisco.webex.com".
+     * @param {string} [options.siteName] - Site name query override. Defaults to the site name derived from options.siteUrl, e.g., "cisco".
+     * @param {SitePreferenceSelectOption[]} [options.selectOptions] - Preference sections to fetch. Defaults to 'scheduling'.
+     * @returns {Promise<SitePreferencesResponse>} site preferences response body
+     * @throws {ParameterError}
+     * @public
+     * @memberof MeetingRequest
+     */
+    fetchSitePreferencesMeViaSite(options?: FetchSitePreferencesMeViaSiteOptions): Promise<SitePreferencesResponse>;
     /**
      *  Fetches indivdual locus rather then getting all at once
      * @param {object} responseBody determine the locus and fetch them if a remoteUrl is given

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

@@ -20,6 +20,7 @@ export default class Member {
     isModerator: any;
     isModeratorAssignmentProhibited: any;
     isPresenterAssignmentProhibited: any;
+    isAttendeeAssignmentProhibited: any;
     isMutable: any;
     isNotAdmitted: any;
     isRecording: any;

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

@@ -89,6 +89,7 @@ export interface Participant {
     moderator: boolean;
     moderatorAssignmentNotAllowed: boolean;
     presenterAssignmentNotAllowed: boolean;
+    attendeeAssignmentNotAllowed?: boolean;
     person: ParticipantPerson;
     resourceGuest: boolean;
     state: string;

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

@@ -66,6 +66,7 @@ declare const MemberUtil: {
     isDevice: (participant: Participant) => boolean;
     isModeratorAssignmentProhibited: (participant: Participant) => boolean;
     isPresenterAssignmentProhibited: (participant: Participant) => boolean;
+    isAttendeeAssignmentProhibited: (participant: Participant) => boolean;
     /**
      * checks to see if the participant id is the same as the passed id
      * there are multiple ids that can be used

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

@@ -92,5 +92,8 @@ declare const BEHAVIORAL_METRICS: {
     DEPRECATED_DELETE_CODEC_PARAMETERS_USED: string;
     SET_CUSTOM_CODEC_PARAMETERS_USED: string;
     MARK_CUSTOM_CODEC_PARAMETERS_FOR_DELETION_USED: string;
+    HASH_TREE_SYNC_FAILURE: string;
+    HASH_TREE_HEARTBEAT_WATCHDOG_EXPIRED: string;
+    HASH_TREE_EMPTY_LOCUS_STATE_ELEMENTS: string;
 };
 export { BEHAVIORAL_METRICS as default };

package/dist/types/multistream/codec/constants.d.ts

@@ -0,0 +1,7 @@
+import { AV1EncodingParams, SupportedResolution } from '@webex/internal-media-core';
+export declare const AV1_CODEC_PARAMETERS: Record<SupportedResolution, AV1EncodingParams>;
+export declare const H264_CODEC_PARAMETERS: {
+    maxFs: number;
+    maxFps: number;
+    maxMbps: number;
+};

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

@@ -1,4 +1,4 @@
-import { StreamRequest, NamedMediaGroup } from '@webex/internal-media-core';
+import { StreamRequest, NamedMediaGroup, MediaType, MediaCodecMimeType } from '@webex/internal-media-core';
 import { ReceiveSlot } from './receiveSlot';
 export interface ActiveSpeakerPolicyInfo {
     policy: 'active-speaker';
@@ -36,14 +36,22 @@ type DegradationPreferences = {
     maxMacroblocksLimit: number;
 };
 type SendMediaRequestsCallback = (streamRequests: StreamRequest[]) => void;
-type Kind = 'audio' | 'video';
-type Options = {
+type GetIngressPayloadTypeCallback = (mediaType: MediaType, codecMimeType: MediaCodecMimeType) => number | undefined;
+type AudioMediaRequestManagerOptions = {
     degradationPreferences: DegradationPreferences;
-    kind: Kind;
+    kind: 'audio';
     trimRequestsToNumOfSources: boolean;
 };
+type VideoMediaRequestManagerOptions = {
+    degradationPreferences: DegradationPreferences;
+    kind: 'video';
+    trimRequestsToNumOfSources: boolean;
+    enableAv1?: boolean;
+};
+type Options = AudioMediaRequestManagerOptions | VideoMediaRequestManagerOptions;
 export declare class MediaRequestManager {
     private sendMediaRequestsCallback;
+    private getIngressPayloadTypeCallback;
     private kind;
     private counter;
     private clientRequests;
@@ -51,9 +59,10 @@ export declare class MediaRequestManager {
     private sourceUpdateListener;
     private debouncedSourceUpdateListener;
     private trimRequestsToNumOfSources;
+    private enableAv1;
     private numTotalSources;
     private numLiveSources;
-    constructor(sendMediaRequestsCallback: SendMediaRequestsCallback, options: Options);
+    constructor(sendMediaRequestsCallback: SendMediaRequestsCallback, getIngressPayloadTypeCallback: GetIngressPayloadTypeCallback, options: Options);
     setDegradationPreferences(degradationPreferences: DegradationPreferences): void;
     private getDegradedClientRequests;
     /**
@@ -77,6 +86,14 @@ export declare class MediaRequestManager {
      * @returns {number} maxMbps
      */
     private getH264MaxMbps;
+    /**
+     * Returns the AV1 encoding parameters for a media request
+     * @param mediaRequest - The media request to get the AV1 encoding parameters for
+     * @returns {AV1EncodingParams} The AV1 encoding parameters
+     */
+    private getAv1EncodingParams;
+    private buildH264CodecInfo;
+    private buildAv1CodecInfo;
     /** Modifies the passed in clientRequests and makes sure that in total they don't ask
      *  for more streams than there are available.
      *

package/dist/types/reactions/reactions.type.d.ts

@@ -49,5 +49,8 @@ type RelayEventData = {
 };
 export type RelayEvent = {
     data: RelayEventData;
+    headers?: {
+        route?: string;
+    };
 };
 export {};