@webex/plugin-meetings 3.11.0 → 3.12.0

package/dist/types/interceptors/dataChannelAuthToken.d.ts

@@ -0,0 +1,43 @@
+/*!
+ * Copyright (c) 2015-2026 Cisco Systems, Inc. See LICENSE file.
+ */
+import { Interceptor } from '@webex/http-core';
+/**
+ * @class
+ */
+export default class DataChannelAuthTokenInterceptor extends Interceptor {
+    private _refreshDataChannelToken;
+    private _isDataChannelTokenEnabled;
+    constructor(options: any);
+    /**
+     * @returns {DataChannelAuthTokenInterceptor}
+     */
+    static create(): DataChannelAuthTokenInterceptor;
+    private getRetryKey;
+    private getHeader;
+    /**
+     * Intercepts outgoing requests and refreshes the Data-Channel-Auth-Token
+     * if the current JWT token is expired before the request is sent.
+     *
+     * @param {Object} options - The original request options.
+     * @returns {Promise<Object>} Updated request options with refreshed token if needed.
+     */
+    onRequest(options: any): Promise<any>;
+    /**
+     * Intercept responses and, on 401/403 with `Data-Channel-Auth-Token` header,
+     * attempt to refresh the data channel token and retry the original request once.
+     *
+     * @param {Object} options
+     * @param {Object} reason
+     * @returns {Promise<HttpResponse>}
+     */
+    onResponseError(options: any, reason: any): Promise<unknown>;
+    /**
+     * Retry the failed data channel request after a delay.
+     * Refreshes the Data-Channel-Auth-Token and re-sends the original request.
+     *
+     * @param {Object} options - Original request options.
+     * @returns {Promise<HttpResponse>} - Resolves on successful retry.
+     */
+    refreshTokenAndRetryWithDelay(options: any): Promise<unknown>;
+}

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

@@ -1,3 +1,4 @@
 import LocusRetryStatusInterceptor from './locusRetry';
 import LocusRouteTokenInterceptor from './locusRouteToken';
-export { LocusRetryStatusInterceptor, LocusRouteTokenInterceptor };
+import DataChannelAuthTokenInterceptor from './dataChannelAuthToken';
+export { LocusRetryStatusInterceptor, LocusRouteTokenInterceptor, DataChannelAuthTokenInterceptor };

package/dist/types/interceptors/utils.d.ts

@@ -0,0 +1 @@
+export declare const isJwtTokenExpired: (token: string) => boolean;

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

@@ -1,6 +1,6 @@
 import EventsScope from '../common/events/events-scope';
 import { LOCUSEVENT } from '../constants';
-import HashTreeParser, { DataSet, HashTreeMessage } from '../hashTree/hashTreeParser';
+import HashTreeParser, { DataSet, HashTreeMessage, Metadata } from '../hashTree/hashTreeParser';
 import { HashTreeObject } from '../hashTree/types';
 import { Links, LocusDTO } from './types';
 export type LocusLLMEvent = {
@@ -12,6 +12,19 @@ export type LocusLLMEvent = {
 export type LocusApiResponseBody = {
     dataSets?: DataSet[];
     locus: LocusDTO;
+    metadata?: Metadata;
+};
+/**
+ * Creates a locus object from the objects received in a hash tree message. It usually will be
+ * incomplete, because hash tree messages only contain the parts of locus that have changed,
+ * and some updates come separately over Mercury or LLM in separate messages.
+ *
+ * @param {HashTreeMessage} message hash tree message to created the locus from
+ * @returns {Object} the created locus object and metadata if present
+ */
+export declare function createLocusFromHashTreeMessage(message: HashTreeMessage): {
+    locus: LocusDTO;
+    metadata?: Metadata;
 };
 /**
  * @description LocusInfo extends ChildEmitter to convert locusInfo info a private emitter to parent object
@@ -105,6 +118,7 @@ export default class LocusInfo extends EventsScope {
         trigger: 'join-response';
         locus: LocusDTO;
         dataSets?: DataSet[];
+        metadata?: Metadata;
     } | {
         trigger: 'locus-message';
         locus?: LocusDTO;
@@ -171,7 +185,9 @@ export default class LocusInfo extends EventsScope {
     /**
      * Function for handling full locus when it's using hash trees (so not the "classic" one).
      *
+     * @param {string} debugText string explaining the trigger for this call, added to logs for debugging purposes
      * @param {object} locus locus object
+     * @param {object} metadata locus hash trees metadata
      * @param {string} eventType locus event
      * @param {DataSet[]} dataSets
      * @returns {void}
@@ -180,6 +196,7 @@ export default class LocusInfo extends EventsScope {
     /**
      * Function for handling full locus when it's the "classic" one (not hash trees)
      *
+     * @param {string} debugText string explaining the trigger for this call, added to logs for debugging purposes
      * @param {object} locus locus object
      * @param {string} eventType locus event
      * @returns {void}
@@ -187,13 +204,15 @@ export default class LocusInfo extends EventsScope {
     private onFullLocusClassic;
     /**
      * updates the locus with full locus object
+     * @param {string} debugText string explaining the trigger for this call, added to logs for debugging purposes
      * @param {object} locus locus object
      * @param {string} eventType locus event
      * @param {DataSet[]} dataSets
+     * @param {object} metadata locus hash trees metadata
      * @returns {object} null
      * @memberof LocusInfo
      */
-    onFullLocus(locus: any, eventType?: string, dataSets?: Array<DataSet>): void;
+    onFullLocus(debugText: string, locus: any, eventType?: string, dataSets?: Array<DataSet>, metadata?: Metadata): void;
     /**
      * Common part of handling full locus, used by both classic and hash tree based locus handling
      * @param {object} locus locus object

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

@@ -20,6 +20,7 @@ export type Links = {
 };
 export type LocusDTO = {
     controls?: any;
+    embeddedApps?: any[];
     fullState?: LocusFullState;
     host?: {
         id: string;

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

@@ -1,5 +1,6 @@
 export interface MediaConnectionAwaiterProps {
     webrtcMediaConnection: any;
+    correlationId: string;
 }
 /**
  * @class MediaConnectionAwaiter
@@ -10,6 +11,7 @@ export default class MediaConnectionAwaiter {
     private defer;
     private retried;
     private iceConnected;
+    private correlationId;
     private onTimeoutCallback;
     private peerConnectionStateCallback;
     private iceConnectionStateCallback;
@@ -17,7 +19,7 @@ export default class MediaConnectionAwaiter {
     /**
      * @param {MediaConnectionAwaiterProps} mediaConnectionAwaiterProps
      */
-    constructor({ webrtcMediaConnection }: MediaConnectionAwaiterProps);
+    constructor({ webrtcMediaConnection, correlationId }: MediaConnectionAwaiterProps);
     /**
      * Returns true if the connection is connected, false otherwise.
      *
@@ -66,6 +68,13 @@ export default class MediaConnectionAwaiter {
      * @returns {void}
      */
     iceGatheringStateHandler(): void;
+    /**
+     * sends a metric with some additional info that might help debugging
+     * issues where browser doesn't update the RTCPeerConnection's iceConnectionState or connectionState
+     *
+     * @returns {void}
+     */
+    sendMetric(): Promise<void>;
     /**
      * Function called when the timeout is reached.
      *

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

@@ -93,9 +93,10 @@ export default class MediaProperties {
     /**
      * Waits for the webrtc media connection to be connected.
      *
+     * @param {string} correlationId
      * @returns {Promise<void>}
      */
-    waitForMediaConnectionConnected(): Promise<void>;
+    waitForMediaConnectionConnected(correlationId: string): Promise<void>;
     /**
      * Returns ICE transport information:
      * - selectedCandidatePairChanges - number of times the selected candidate pair was changed, it should be at least 1 for successful connections

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

@@ -28,6 +28,7 @@ interface IInMeetingActions {
     canLowerAllHands?: boolean;
     canLowerSomeoneElsesHand?: boolean;
     bothLeaveAndEndMeetingAvailable?: boolean;
+    requireHostEndMeetingBeforeLeave?: boolean;
     canEnableClosedCaption?: boolean;
     canStartTranscribing?: boolean;
     canStopTranscribing?: boolean;
@@ -112,6 +113,8 @@ interface IInMeetingActions {
     canMoveToLobby?: boolean;
     canEnablePollingQA?: boolean;
     canDisablePollingQA?: boolean;
+    canAttendeeRequestAiAssistantEnabled?: boolean;
+    isAttendeeRequestAiAssistantDeclinedAll?: boolean;
 }
 /**
  * @class InMeetingActions
@@ -140,6 +143,7 @@ export default class InMeetingActions implements IInMeetingActions {
     canLowerAllHands: any;
     canLowerSomeoneElsesHand: any;
     bothLeaveAndEndMeetingAvailable: any;
+    requireHostEndMeetingBeforeLeave: any;
     canEnableClosedCaption: any;
     canStartTranscribing: any;
     canStopTranscribing: any;
@@ -224,6 +228,8 @@ export default class InMeetingActions implements IInMeetingActions {
     canMoveToLobby: any;
     canEnablePollingQA: any;
     canDisablePollingQA: any;
+    canAttendeeRequestAiAssistantEnabled: any;
+    isAttendeeRequestAiAssistantDeclinedAll: any;
     /**
      * Returns all meeting action options
      * @returns {Object}

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

@@ -1,8 +1,9 @@
 /// <reference types="node" />
 import { StatelessWebexPlugin } from '@webex/webex-core';
 import { ClientEvent, ClientEventLeaveReason } from '@webex/internal-plugin-metrics';
-import { ClientEvent as RawClientEvent } from '@webex/event-dictionary-ts';
+import type { ClientEvent as RawClientEvent } from '@webex/event-dictionary-ts';
 import { MediaType, StatsAnalyzer, NetworkQualityMonitor, StatsMonitor } from '@webex/internal-media-core';
+import { DataChannelTokenType } from '@webex/internal-plugin-llm';
 import { LocalStream, LocalCameraStream, LocalDisplayStream, LocalSystemAudioStream, LocalMicrophoneStream } from '@webex/media-helpers';
 import Roap, { type TurnDiscoverySkipReason } from '../roap/index';
 import { type TurnServerInfo } from '../roap/types';
@@ -23,7 +24,7 @@ import { LocusMediaRequest } from './locusMediaRequest';
 import { BrbState } from './brbState';
 import { SetStageOptions } from './request.type';
 import { Invitee } from './type';
-import { DataSet } from '../hashTree/hashTreeParser';
+import { DataSet, Metadata } from '../hashTree/hashTreeParser';
 import { LocusDTO } from '../locus-info/types';
 export type CaptionData = {
     id: string;
@@ -70,6 +71,7 @@ export type AddMediaOptions = {
     remoteMediaManagerConfig?: RemoteMediaManagerConfiguration;
     bundlePolicy?: BundlePolicy;
     allowMediaInLobby?: boolean;
+    allowPublishMediaInLobby?: boolean;
     additionalMediaOptions?: AdditionalMediaOptions;
 };
 export type AdditionalMediaOptions = {
@@ -358,6 +360,7 @@ export default class Meeting extends StatelessWebexPlugin {
     breakouts: any;
     simultaneousInterpretation: any;
     annotation: any;
+    aiEnableRequest: any;
     webinar: any;
     conversationUrl: string;
     callStateForMetrics: CallStateForMetrics;
@@ -405,6 +408,10 @@ export default class Meeting extends StatelessWebexPlugin {
     keepAliveTimerId: NodeJS.Timeout;
     lastVideoLayoutInfo: any;
     locusInfo: any;
+    isUserUnadmitted?: boolean;
+    joinedWith?: any;
+    selfId?: string;
+    roles: any[];
     locusMediaRequest?: LocusMediaRequest;
     mediaProperties: MediaProperties;
     mediaRequestManagers: {
@@ -438,7 +445,6 @@ export default class Meeting extends StatelessWebexPlugin {
     endCallInitJoinReq: any;
     endJoinReqResp: any;
     endLocalSDPGenRemoteSDPRecvDelay: any;
-    joinedWith: any;
     locusId: any;
     startCallInitJoinReq: any;
     startJoinReqResp: any;
@@ -453,12 +459,11 @@ export default class Meeting extends StatelessWebexPlugin {
     permissionTokenReceivedLocalTime: number;
     resourceId: any;
     resourceUrl: string;
-    selfId: string;
     state: any;
     localAudioStreamMuteStateHandler: () => void;
     localVideoStreamMuteStateHandler: () => void;
     localOutputTrackChangeHandler: () => void;
-    roles: any[];
+    localConstraintsChangeHandler: () => void;
     environment: string;
     namespace: string;
     allowMediaInLobby: boolean;
@@ -1060,6 +1065,7 @@ export default class Meeting extends StatelessWebexPlugin {
         host: object;
         selfId: string;
         dataSets: DataSet[];
+        metadata: Metadata;
     }): void;
     /**
      * Upload logs for the current meeting
@@ -1335,6 +1341,14 @@ export default class Meeting extends StatelessWebexPlugin {
      * @returns {void}
      */
     private clearLLMHealthCheckTimer;
+    /**
+     * Disconnects and cleans up the default LLM session listeners/timers.
+     * @param {Object} options
+     * @param {boolean} [options.removeOnlineListener=true] removes the one-time online listener
+     * @param {boolean} [options.throwOnError=true] rethrows disconnect errors when true
+     * @returns {Promise<void>}
+     */
+    private cleanupLLMConneciton;
     /**
      * Connects to low latency mercury and reconnects if the address has changed
      * It will also disconnect if called when the meeting has ended
@@ -1909,7 +1923,7 @@ export default class Meeting extends StatelessWebexPlugin {
      * @public
      * @memberof Meeting
      */
-    clearMeetingData: () => void;
+    clearMeetingData: () => Promise<void>;
     /**
      * starts keepAlives being sent
      * @returns {void}
@@ -2087,5 +2101,23 @@ export default class Meeting extends StatelessWebexPlugin {
      * @memberof Meetings
      */
     cancelSipCallOut(participantId: string): Promise<any>;
+    /**
+     * Method to get new data
+     * @returns {Promise}
+     */
+    refreshDataChannelToken(): Promise<{
+        body: {
+            datachannelToken: any;
+            dataChannelTokenType: DataChannelTokenType;
+        };
+    }>;
+    /**
+     * Determines the current data channel token type based on the meeting state.
+     *
+     * variant should be used when connecting to the LLM data channel.
+     *
+     * @returns {DataChannelTokenType} The token type representing the current session mode.
+     */
+    getDataChannelTokenType(): DataChannelTokenType;
 }
 export {};

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

@@ -1,5 +1,5 @@
 import { StatelessWebexPlugin } from '@webex/webex-core';
-import { SendReactionOptions, BrbOptions, ToggleReactionsOptions, PostMeetingDataConsentOptions, SynchronizeVideoLayout } from './request.type';
+import { SendReactionOptions, BrbOptions, ToggleReactionsOptions, PostMeetingDataConsentOptions, SynchronizeVideoLayout, fetchDataChannelTokenOptions } from './request.type';
 import { AnnotationInfo } from '../annotation/annotation.types';
 import { ClientMediaPreferences } from '../reachability/reachability.types';
 /**
@@ -364,4 +364,19 @@ export default class MeetingRequest extends StatelessWebexPlugin {
      * @returns {Promise} The API response
      */
     cancelSipCallOut(participantId: any): Promise<any>;
+    /**
+     * Sends a request to retrieve the datachannel authorization token for a participant.
+     *
+     * For regular meeting data channel:
+     *   GET /locus/api/v1/loci/{uuid:lid}/participant/{uuid:pid}/datachannel/token
+     *
+     * For practice session data channel:
+     *   GET /locus/api/v1/loci/{uuid:lid}/participant/{uuid:pid}/practiceSession/datachannel/token
+     *
+     * @param {string} locusUrl - The locus url.
+     * @param {string} requestingParticipantId - The participant UUID.
+     * @param {boolean} [isPracticeSession=false] - Whether to get the practice session token.
+     * @returns {Promise<{datachannelToken: string}>}
+     */
+    fetchDatachannelToken({ locusUrl, requestingParticipantId, isPracticeSession, }: fetchDataChannelTokenOptions): Promise<any>;
 }

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

@@ -94,4 +94,9 @@ export type SetStageVideoLayout = {
 export type UnsetStageVideoLayout = {
     overrideDefault: false;
 };
+export type fetchDataChannelTokenOptions = {
+    locusUrl: string;
+    requestingParticipantId: string;
+    isPracticeSession: boolean;
+};
 export type SynchronizeVideoLayout = SetStageVideoLayout | UnsetStageVideoLayout;

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

@@ -2,6 +2,34 @@ import { LocalCameraStream, LocalMicrophoneStream } from '@webex/media-helpers';
 import { SELF_POLICY, IP_VERSION } from '../constants';
 declare const MeetingUtil: {
     parseLocusJoin: (response: any) => any;
+    /**
+     * Sanitizes a WebSocket URL by extracting only protocol, host, and pathname
+     * Returns concatenated protocol + host + pathname for safe logging
+     * Note: This is used for logging only; URL matching uses partial matching via _urlsPartiallyMatch
+     * @param {string} urlString - The URL to sanitize
+     * @returns {string} Sanitized URL or empty string if parsing fails
+     */
+    sanitizeWebSocketUrl: (urlString: string) => string;
+    /**
+     * Checks if two URLs partially match using an endsWith approach
+     * Combines host and pathname, then checks if one ends with the other
+     * This handles cases where one URL goes through a proxy (e.g., /webproxy/) while the other is direct
+     * @param {string} url1 - First URL to compare
+     * @param {string} url2 - Second URL to compare
+     * @returns {boolean} True if one URL path ends with the other (partial match), false otherwise
+     */
+    _urlsPartiallyMatch: (url1: string, url2: string) => boolean;
+    /**
+     * Gets socket URL information for metrics, including whether the socket URLs match
+     * Uses partial matching to handle proxy URLs (e.g., URLs with /webproxy/ prefix)
+     * @param {Object} webex - The webex instance
+     * @returns {Object} Object with hasMismatchedSocket, mercurySocketUrl, and deviceSocketUrl properties
+     */
+    getSocketUrlInfo: (webex: any) => {
+        hasMismatchedSocket: boolean;
+        mercurySocketUrl: string;
+        deviceSocketUrl: string;
+    };
     remoteUpdateAudioVideo: (meeting: any, audioMuted?: boolean, videoMuted?: boolean) => any;
     hasOwner: (info: any) => any;
     isOwnerSelf: (owner: any, selfId: any) => boolean;
@@ -59,6 +87,7 @@ declare const MeetingUtil: {
     canUserLowerAllHands: (displayHints: any) => any;
     canUserLowerSomeoneElsesHand: (displayHints: any) => any;
     bothLeaveAndEndMeetingAvailable: (displayHints: any) => any;
+    requireHostEndMeetingBeforeLeave: (displayHints: any) => any;
     canManageBreakout: (displayHints: any) => any;
     canStartBreakout: (displayHints: any) => boolean;
     canBroadcastMessageToBreakout: (displayHints: any, policies?: {}) => boolean;
@@ -115,6 +144,8 @@ declare const MeetingUtil: {
     updateLocusFromApiResponse: (meeting: any, response: any) => any;
     generateBuildLocusDeltaRequestOptions: (originalMeeting: any) => (originalOptions: any) => any;
     generateLocusDeltaRequest: (originalMeeting: any) => (originalOptions: any) => any;
+    canAttendeeRequestAiAssistantEnabled: (displayHints?: any[], roles?: any[]) => boolean;
+    attendeeRequestAiAssistantDeclinedAll: (displayHints?: any[]) => boolean;
     selfSupportsFeature: (feature: SELF_POLICY, userPolicies: Record<SELF_POLICY, boolean>) => boolean;
     parseInterpretationInfo: (meeting: any, meetingInfo: any) => void;
     /**

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

@@ -95,6 +95,8 @@ export default class Meetings extends WebexPlugin {
     preferredWebexSite: any;
     reachability: Reachability;
     registered: any;
+    registrationPromise: Promise<void>;
+    unregistrationPromise: Promise<void>;
     request: any;
     geoHintInfo: any;
     meetingInfo: any;
@@ -150,7 +152,7 @@ export default class Meetings extends WebexPlugin {
      */
     private handleLocusEvent;
     /**
-     * handles locus events through mercury that are not roap
+     * handles locus events through mercury that are not roap or approval request events
      * @param {Object} envelope
      * @param {Object} envelope.data
      * @param {String} envelope.data.eventType
@@ -287,7 +289,7 @@ export default class Meetings extends WebexPlugin {
      * @public
      * @memberof Meetings
      */
-    unregister(): any;
+    unregister(): Promise<void>;
     /**
      * Creates a noise reduction effect
      *

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

@@ -6,6 +6,7 @@ export type MemberId = string;
 export default class Member {
     associatedUser: MemberId | null;
     associatedUsers: Set<MemberId>;
+    canApproveAIEnablement: boolean;
     canReclaimHost: boolean;
     id: MemberId;
     isAudioMuted: any;

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

@@ -5,6 +5,11 @@ declare const MemberUtil: {
      * @returns {Boolean}
      */
     canReclaimHost: (participant: any) => any;
+    /**
+     * @param {Object} participant - The locus participant object.
+     * @returns {Boolean}
+     */
+    canApproveAIEnablement: (participant: any) => boolean;
     /**
      * @param {Object} participant - The locus participant object.
      * @returns {[ServerRoleShape]}

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

@@ -87,5 +87,6 @@ declare const BEHAVIORAL_METRICS: {
     MEDIA_ISSUE_DETECTED: string;
     LOCUS_CLASSIC_VS_HASH_TREE_MISMATCH: string;
     LOCUS_HASH_TREE_UNSUPPORTED_OPERATION: string;
+    MEDIA_STILL_NOT_CONNECTED: string;
 };
 export { BEHAVIORAL_METRICS as default };

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

@@ -50,29 +50,12 @@ export declare class MediaRequestManager {
     private degradationPreferences;
     private sourceUpdateListener;
     private debouncedSourceUpdateListener;
-    private previousStreamRequests;
     private trimRequestsToNumOfSources;
     private numTotalSources;
     private numLiveSources;
     constructor(sendMediaRequestsCallback: SendMediaRequestsCallback, options: Options);
     setDegradationPreferences(degradationPreferences: DegradationPreferences): void;
     private getDegradedClientRequests;
-    /**
-     * Returns true if two stream requests are the same, false otherwise.
-     *
-     * @param {StreamRequest} streamRequestA - Stream request A for comparison.
-     * @param {StreamRequest} streamRequestB - Stream request B for comparison.
-     * @returns {boolean} - Whether they are equal.
-     */
-    isEqual(streamRequestA: StreamRequest, streamRequestB: StreamRequest): boolean;
-    /**
-     * Compares new stream requests to previous ones and determines
-     * if they are the same.
-     *
-     * @param {StreamRequest[]} newRequests - Array with new requests.
-     * @returns {boolean} - True if they are equal, false otherwise.
-     */
-    private checkIsNewRequestsEqualToPrev;
     /**
      * Returns the maxPayloadBitsPerSecond per Stream
      *
@@ -94,12 +77,6 @@ export declare class MediaRequestManager {
      * @returns {number} maxMbps
      */
     private getH264MaxMbps;
-    /**
-     * Clears the previous stream requests.
-     *
-     * @returns {void}
-     */
-    clearPreviousRequests(): void;
     /** 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

@@ -32,6 +32,7 @@ export declare enum SkinToneType {
     dark = "dark"
 }
 export type Sender = {
+    displayName: string;
     participantId: string;
 };
 export type ProcessedReaction = {

package/dist/types/webinar/utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Remove null/undefined/empty string values from an object
+ * @param {object} params
+ * @returns {object}
+ */
+export declare const sanitizeParams: (params: Record<string, any>) => Record<string, any>;