@webex/plugin-meetings 3.11.0 → 3.12.0-next.1

package/src/meeting/index.ts

@@ -13,7 +13,7 @@ import {
   CALL_DIAGNOSTIC_CONFIG,
   RtcMetrics,
 } 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 {
   ConnectionState,
@@ -33,6 +33,8 @@ import {
   InboundAudioIssueSubTypes,
 } from '@webex/internal-media-core';
 
+import {DataChannelTokenType} from '@webex/internal-plugin-llm';
+
 import {
   LocalStream,
   LocalCameraStream,
@@ -55,6 +57,7 @@ import {
   isBrowserMediaError,
   isBrowserMediaErrorName,
 } from '@webex/internal-plugin-metrics/src/call-diagnostic/call-diagnostic-metrics.util';
+import {CapabilityState, WebCapabilities} from '@webex/web-capabilities';
 import {processNewCaptions} from './voicea-meeting';
 
 import {
@@ -178,8 +181,9 @@ import JoinForbiddenError from '../common/errors/join-forbidden-error';
 import {ReachabilityMetrics} from '../reachability/reachability.types';
 import {SetStageOptions, SetStageVideoLayout, UnsetStageVideoLayout} from './request.type';
 import {Invitee} from './type';
-import {DataSet} from '../hashTree/hashTreeParser';
+import {DataSet, HashTreeMessage, Metadata} from '../hashTree/hashTreeParser';
 import {LocusDTO} from '../locus-info/types';
+import AIEnableRequest from '../aiEnableRequest';
 
 // default callback so we don't call an undefined function, but in practice it should never be used
 const DEFAULT_ICE_PHASE_CALLBACK = () => 'JOIN_MEETING_FINAL';
@@ -249,6 +253,7 @@ export type AddMediaOptions = {
   remoteMediaManagerConfig?: RemoteMediaManagerConfiguration; // applies only to multistream meetings
   bundlePolicy?: BundlePolicy; // applies only to multistream meetings
   allowMediaInLobby?: boolean; // allows adding media when in the lobby
+  allowPublishMediaInLobby?: boolean; // allows publishing media when in the lobby, if not specified, default value false is used
   additionalMediaOptions?: AdditionalMediaOptions; // allows adding additional options like send/receive audio/video
 };
 
@@ -563,6 +568,34 @@ type MediaReachabilityMetrics = ReachabilityMetrics & {
  * @memberof Meeting
  */
 
+/**
+ * Stores an event so all events can be later retrieved via a console command for debugging.
+ * @param {string} type
+ * @param {Object} data
+ * @returns {void}
+ */
+export function storeEventForDebugging(
+  type: string,
+  data: {
+    eventType: any;
+    stateElementsMessage?: HashTreeMessage;
+  }
+) {
+  if ((window as any)?.locusEvents) {
+    // only store non-heartbeat hash tree messages
+    if (
+      data.eventType === LOCUSEVENT.HASH_TREE_DATA_UPDATED &&
+      data.stateElementsMessage?.locusStateElements
+    ) {
+      (window as any).locusEvents.push({
+        ...data,
+        timestamp: new Date().toLocaleString(),
+        type,
+      });
+    }
+  }
+}
+
 /**
  * @description Meeting is the crux of the plugin
  * @export
@@ -574,6 +607,7 @@ export default class Meeting extends StatelessWebexPlugin {
   breakouts: any;
   simultaneousInterpretation: any;
   annotation: any;
+  aiEnableRequest: any;
   webinar: any;
   conversationUrl: string;
   callStateForMetrics: CallStateForMetrics;
@@ -622,6 +656,13 @@ export default class Meeting extends StatelessWebexPlugin {
   keepAliveTimerId: NodeJS.Timeout;
   lastVideoLayoutInfo: any;
   locusInfo: any;
+  // this group of properties is populated via updateMeetingObject() that's registered as a callback with LocusInfo
+  isUserUnadmitted?: boolean;
+  joinedWith?: any;
+  selfId?: string;
+  roles: any[];
+  // ... there is more ... see SelfUtils.parse()
+  // end of the group
   locusMediaRequest?: LocusMediaRequest;
   mediaProperties: MediaProperties;
   mediaRequestManagers: {
@@ -656,7 +697,6 @@ export default class Meeting extends StatelessWebexPlugin {
   endCallInitJoinReq: any;
   endJoinReqResp: any;
   endLocalSDPGenRemoteSDPRecvDelay: any;
-  joinedWith: any;
   locusId: any;
   startCallInitJoinReq: any;
   startJoinReqResp: any;
@@ -671,12 +711,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 = MEETINGS;
   allowMediaInLobby: boolean;
@@ -893,6 +932,10 @@ export default class Meeting extends StatelessWebexPlugin {
      */
     // @ts-ignore
     this.simultaneousInterpretation = new SimultaneousInterpretation({}, {parent: this.webex});
+
+    // @ts-ignore
+    this.aiEnableRequest = new AIEnableRequest({}, {parent: this.webex});
+
     /**
      * @instance
      * @type {Annotation}
@@ -1542,6 +1585,12 @@ export default class Meeting extends StatelessWebexPlugin {
       }
     };
 
+    this.localConstraintsChangeHandler = () => {
+      if (!this.isMultistream) {
+        this.mediaProperties.webrtcMediaConnection?.updatePreferredBitrateKbps();
+      }
+    };
+
     /**
      * Promise that exists if SDP offer has been generated, and resolves once sdp answer is received.
      * @instance
@@ -2951,6 +3000,18 @@ export default class Meeting extends StatelessWebexPlugin {
       );
     });
 
+    this.locusInfo.on(
+      LOCUSINFO.EVENTS.CONTROLS_AI_SUMMARY_NOTIFICATION_UPDATED,
+      ({aiSummaryNotification}) => {
+        Trigger.trigger(
+          this,
+          {file: 'meeting/index', function: 'setupLocusControlsListener'},
+          EVENT_TRIGGERS.MEETING_CONTROLS_AI_SUMMARY_NOTIFICATION_UPDATED,
+          {aiSummaryNotification}
+        );
+      }
+    );
+
     this.locusInfo.on(LOCUSINFO.EVENTS.CONTROLS_WEBCAST_CHANGED, ({state}) => {
       Trigger.trigger(
         this,
@@ -3402,6 +3463,8 @@ export default class Meeting extends StatelessWebexPlugin {
         this.recordingController.setLocusUrl(this.locusUrl);
         this.controlsOptionsManager.setLocusUrl(this.locusUrl, !!isMainLocus);
         this.webinar.locusUrlUpdate(url);
+        // @ts-ignore
+        this.webex.internal.llm.setRefreshHandler(() => this.refreshDataChannelToken());
 
         Trigger.trigger(
           this,
@@ -3432,6 +3495,7 @@ export default class Meeting extends StatelessWebexPlugin {
       this.breakouts.breakoutServiceUrlUpdate(payload?.services?.breakout?.url);
       this.annotation.approvalUrlUpdate(payload?.services?.approval?.url);
       this.simultaneousInterpretation.approvalUrlUpdate(payload?.services?.approval?.url);
+      this.aiEnableRequest.approvalUrlUpdate(payload?.services?.approval?.url);
     });
   }
 
@@ -3529,6 +3593,9 @@ export default class Meeting extends StatelessWebexPlugin {
     // @ts-ignore - config coming from registerPlugin
     if (datachannelUrl && this.config.enableAutomaticLLM) {
       this.updateLLMConnection();
+      if (this.webinar.isJoinPracticeSessionDataChannel()) {
+        this.webinar.updatePSDataChannel();
+      }
     }
   }
 
@@ -3761,6 +3828,10 @@ export default class Meeting extends StatelessWebexPlugin {
       );
     });
 
+    this.locusInfo.on(LOCUSINFO.EVENTS.SELF_ID_CHANGED, (payload) => {
+      this.aiEnableRequest.selfParticipantIdUpdate(payload.selfId);
+    });
+
     this.locusInfo.on(LOCUSINFO.EVENTS.SELF_MEETING_INTERPRETATION_CHANGED, (payload) => {
       const targetChanged = this.simultaneousInterpretation.updateSelfInterpretation(payload);
       Trigger.trigger(
@@ -4263,6 +4334,9 @@ export default class Meeting extends StatelessWebexPlugin {
           bothLeaveAndEndMeetingAvailable: MeetingUtil.bothLeaveAndEndMeetingAvailable(
             this.userDisplayHints
           ),
+          requireHostEndMeetingBeforeLeave: MeetingUtil.requireHostEndMeetingBeforeLeave(
+            this.userDisplayHints
+          ),
           canEnableClosedCaption: MeetingUtil.canEnableClosedCaption(this.userDisplayHints),
           canStartTranscribing: MeetingUtil.canStartTranscribing(this.userDisplayHints),
           canStopTranscribing: MeetingUtil.canStopTranscribing(this.userDisplayHints),
@@ -4521,6 +4595,12 @@ export default class Meeting extends StatelessWebexPlugin {
             requiredHints: [DISPLAY_HINTS.DISABLE_ATTENDEE_START_POLLING_QA],
             displayHints: this.userDisplayHints,
           }),
+          canAttendeeRequestAiAssistantEnabled: MeetingUtil.canAttendeeRequestAiAssistantEnabled(
+            this.userDisplayHints,
+            this.roles
+          ),
+          isAttendeeRequestAiAssistantDeclinedAll:
+            MeetingUtil.attendeeRequestAiAssistantDeclinedAll(this.userDisplayHints),
         }) || changed;
     }
     if (changed) {
@@ -4592,7 +4672,8 @@ export default class Meeting extends StatelessWebexPlugin {
     mediaId: string;
     host: object;
     selfId: string;
-    dataSets: DataSet[];
+    dataSets: DataSet[]; // only sent by Locus when hash trees are used
+    metadata: Metadata; // only sent by Locus when hash trees are used
   }) {
     const mtgLocus: any = data.locus;
 
@@ -4608,6 +4689,7 @@ export default class Meeting extends StatelessWebexPlugin {
       trigger: 'join-response',
       locus: mtgLocus,
       dataSets: data.dataSets,
+      metadata: data.metadata,
     });
   }
 
@@ -4817,6 +4899,7 @@ export default class Meeting extends StatelessWebexPlugin {
       this.localVideoStreamMuteStateHandler
     );
     oldStream?.off(LocalStreamEventNames.OutputTrackChange, this.localOutputTrackChangeHandler);
+    oldStream?.off(LocalStreamEventNames.ConstraintsChange, this.localConstraintsChangeHandler);
 
     // we don't update this.mediaProperties.mediaDirection.sendVideo, because we always keep it as true to avoid extra SDP exchanges
     this.mediaProperties.setLocalVideoStream(localStream);
@@ -4832,6 +4915,7 @@ export default class Meeting extends StatelessWebexPlugin {
       this.localVideoStreamMuteStateHandler
     );
     localStream?.on(LocalStreamEventNames.OutputTrackChange, this.localOutputTrackChangeHandler);
+    localStream?.on(LocalStreamEventNames.ConstraintsChange, this.localConstraintsChangeHandler);
 
     if (!this.isMultistream || !localStream) {
       // for multistream WCME automatically un-publishes the old stream when we publish a new one
@@ -4966,6 +5050,7 @@ export default class Meeting extends StatelessWebexPlugin {
       this.localVideoStreamMuteStateHandler
     );
     videoStream?.off(LocalStreamEventNames.OutputTrackChange, this.localOutputTrackChangeHandler);
+    videoStream?.off(LocalStreamEventNames.ConstraintsChange, this.localConstraintsChangeHandler);
 
     shareAudioStream?.off(StreamEventNames.Ended, this.handleShareAudioStreamEnded);
     shareAudioStream?.off(
@@ -5379,6 +5464,18 @@ export default class Meeting extends StatelessWebexPlugin {
     let joined = false;
     let joinResponse = prevJoinResponse;
 
+    /* Before we do anything, check if RTCPeerConnection is available. Normally this is checked
+       by addMediaInternal() itself when creating the media connection, but since joinWithMedia()
+       is a convenience method that does both join() and addMedia(), we want to fail fast here
+       in case WebRTC is not available at all.
+     */
+    if (WebCapabilities.supportsRTCPeerConnection() === CapabilityState.NOT_CAPABLE) {
+      // throw the same error that would be thrown by addMediaInternal()
+      throw new Errors.WebrtcApiNotAvailableError(
+        'RTCPeerConnection API is not available in this environment'
+      );
+    }
+
     try {
       let turnServerInfo;
       let turnDiscoverySkippedReason;
@@ -5449,7 +5546,10 @@ export default class Meeting extends StatelessWebexPlugin {
       // if this was the first attempt, let's do a retry
       let shouldRetry = !isRetry;
 
-      if (CallDiagnosticUtils.isSdpOfferCreationError(error)) {
+      if (
+        CallDiagnosticUtils.isSdpOfferCreationError(error) ||
+        CallDiagnosticUtils.isWebrtcApiNotAvailableError(error)
+      ) {
         // errors related to offer creation (for example missing H264 codec) will happen again no matter how many times we try,
         // so there is no point doing a retry
         shouldRetry = false;
@@ -5742,6 +5842,11 @@ export default class Meeting extends StatelessWebexPlugin {
    */
   private processLocusLLMEvent = (event: LocusLLMEvent): void => {
     if (event.data.eventType === LOCUSEVENT.HASH_TREE_DATA_UPDATED) {
+      // @ts-ignore
+      if (this.config.experimental.storeLocusHashTreeEventsForDebugging) {
+        storeEventForDebugging('llm', event.data);
+      }
+
       this.locusInfo.parse(this, event.data);
     } else {
       LoggerProxy.logger.warn(
@@ -5765,7 +5870,7 @@ export default class Meeting extends StatelessWebexPlugin {
           this.isReactionsSupported()
         ) {
           const member = this.members.membersCollection.get(e.data.sender.participantId);
-          if (!member) {
+          if (!member && !this.locusInfo?.info?.isWebinar) {
             // @ts-ignore -- fix type
             LoggerProxy.logger.warn(
               `Meeting:index#processRelayEvent --> Skipping handling of ${REACTION_RELAY_TYPES.REACTION} for ${this.id}. participantId ${e.data.sender.participantId} does not exist in membersCollection.`
@@ -5773,7 +5878,7 @@ export default class Meeting extends StatelessWebexPlugin {
             break;
           }
 
-          const {name} = member;
+          const name = (member && member.name) || e.data.sender.displayName;
           const processedReaction: ProcessedReaction = {
             reaction: e.data.reaction,
             sender: {
@@ -6161,6 +6266,49 @@ export default class Meeting extends StatelessWebexPlugin {
     }
   }
 
+  /**
+   * 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 = async ({
+    removeOnlineListener = true,
+    throwOnError = true,
+  }: {
+    removeOnlineListener?: boolean;
+    throwOnError?: boolean;
+  } = {}): Promise<void> => {
+    try {
+      // @ts-ignore - Fix type
+      await this.webex.internal.llm.disconnectLLM({
+        code: 3050,
+        reason: 'done (permanent)',
+      });
+    } catch (error) {
+      LoggerProxy.logger.error(
+        'Meeting:index#cleanupLLMConneciton --> Failed to disconnect default LLM session',
+        error
+      );
+
+      if (throwOnError) {
+        throw error;
+      }
+    } finally {
+      if (removeOnlineListener) {
+        // @ts-ignore - Fix type
+        this.webex.internal.llm.off('online', this.handleLLMOnline);
+      }
+      // @ts-ignore - fix types
+      this.webex.internal.llm.off('event:relay.event', this.processRelayEvent);
+      // @ts-ignore - Fix type
+      this.webex.internal.llm.off(LOCUS_LLM_EVENT, this.processLocusLLMEvent);
+
+      this.clearLLMHealthCheckTimer();
+    }
+  };
+
   /**
    * Connects to low latency mercury and reconnects if the address has changed
    * It will also disconnect if called when the meeting has ended
@@ -6169,15 +6317,26 @@ export default class Meeting extends StatelessWebexPlugin {
    */
   async updateLLMConnection() {
     // @ts-ignore - Fix type
-    const {url, info: {datachannelUrl, practiceSessionDatachannelUrl} = {}} = this.locusInfo;
+    const {
+      url = undefined,
+      info: {datachannelUrl = undefined} = {},
+      self: {datachannelToken = undefined} = {},
+    } = this.locusInfo || {};
 
     const isJoined = this.isJoined();
 
+    // @ts-ignore
+    const currentToken = this.webex.internal.llm.getDatachannelToken(DataChannelTokenType.Default);
+
+    const finalToken = currentToken ?? datachannelToken;
+
+    if (!currentToken && datachannelToken) {
+      // @ts-ignore
+      this.webex.internal.llm.setDatachannelToken(datachannelToken, DataChannelTokenType.Default);
+    }
+
     // webinar panelist should use new data channel in practice session
-    const dataChannelUrl =
-      this.webinar.isJoinPracticeSessionDataChannel() && practiceSessionDatachannelUrl
-        ? practiceSessionDatachannelUrl
-        : datachannelUrl;
+    const dataChannelUrl = datachannelUrl;
 
     // @ts-ignore - Fix type
     if (this.webex.internal.llm.isConnected()) {
@@ -6190,21 +6349,7 @@ export default class Meeting extends StatelessWebexPlugin {
       ) {
         return undefined;
       }
-      // @ts-ignore - Fix type
-      await this.webex.internal.llm.disconnectLLM(
-        isJoined
-          ? {
-              code: 3050,
-              reason: 'done (permanent)',
-            }
-          : undefined
-      );
-      // @ts-ignore - Fix type
-      this.webex.internal.llm.off('event:relay.event', this.processRelayEvent);
-      // @ts-ignore - Fix type
-      this.webex.internal.llm.off(LOCUS_LLM_EVENT, this.processLocusLLMEvent);
-
-      this.clearLLMHealthCheckTimer();
+      await this.cleanupLLMConneciton({removeOnlineListener: false});
     }
 
     if (!isJoined) {
@@ -6213,7 +6358,7 @@ export default class Meeting extends StatelessWebexPlugin {
 
     // @ts-ignore - Fix type
     return this.webex.internal.llm
-      .registerAndConnect(url, dataChannelUrl)
+      .registerAndConnect(url, dataChannelUrl, finalToken)
       .then((registerAndConnectResult) => {
         // @ts-ignore - Fix type
         this.webex.internal.llm.off('event:relay.event', this.processRelayEvent);
@@ -7417,7 +7562,7 @@ export default class Meeting extends StatelessWebexPlugin {
    */
   private async waitForMediaConnectionConnected(): Promise<void> {
     try {
-      await this.mediaProperties.waitForMediaConnectionConnected();
+      await this.mediaProperties.waitForMediaConnectionConnected(this.correlationId);
     } catch (error) {
       const {iceConnected} = error;
 
@@ -8010,6 +8155,7 @@ export default class Meeting extends StatelessWebexPlugin {
       remoteMediaManagerConfig,
       bundlePolicy = 'max-bundle',
       additionalMediaOptions = {},
+      allowPublishMediaInLobby = false,
     } = options;
 
     const {
@@ -8030,7 +8176,6 @@ export default class Meeting extends StatelessWebexPlugin {
     const ipver = MeetingUtil.getIpVersion(this.webex); // used just for metrics
 
     // If the user is unjoined or guest waiting in lobby dont allow the user to addMedia
-    // @ts-ignore - isUserUnadmitted coming from SelfUtil
     if (this.isUserUnadmitted && !this.wirelessShare && !this.allowMediaInLobby) {
       throw new UserInLobbyError();
     }
@@ -8075,7 +8220,13 @@ export default class Meeting extends StatelessWebexPlugin {
     this.brbState = createBrbState(this, false);
 
     try {
-      await this.setUpLocalStreamReferences(localStreams);
+      // if we're in a lobby and allowPublishMediaInLobby==false, we don't want to
+      // setup local streams for publishing, because if we ever end up admitted to the meeting
+      // but Locus event about it for us is delayed or missed, others could see/hear our user's video/audio
+      // while the user would still think they're in the lobby
+      if (allowPublishMediaInLobby || !this.isUserUnadmitted) {
+        await this.setUpLocalStreamReferences(localStreams);
+      }
 
       this.setMercuryListener();
 
@@ -8543,12 +8694,12 @@ export default class Meeting extends StatelessWebexPlugin {
     LoggerProxy.logger.log('Meeting:index#leave --> Leaving a meeting');
 
     return MeetingUtil.leaveMeeting(this, options)
-      .then((leave) => {
+      .then(async (leave) => {
         // CA team recommends submitting this *after* locus /leave
         submitLeaveMetric();
 
         this.meetingFiniteStateMachine.leave();
-        this.clearMeetingData();
+        await this.clearMeetingData();
 
         // upload logs on leave irrespective of meeting delete
         Trigger.trigger(
@@ -9407,10 +9558,10 @@ export default class Meeting extends StatelessWebexPlugin {
     });
 
     return MeetingUtil.endMeetingForAll(this)
-      .then((end) => {
+      .then(async (end) => {
         this.meetingFiniteStateMachine.end();
 
-        this.clearMeetingData();
+        await this.clearMeetingData();
         // upload logs on leave irrespective of meeting delete
         Trigger.trigger(
           this,
@@ -9458,7 +9609,7 @@ export default class Meeting extends StatelessWebexPlugin {
    * @public
    * @memberof Meeting
    */
-  clearMeetingData = () => {
+  clearMeetingData = async () => {
     this.audio = null;
     this.video = null;
     this.screenShareFloorState = ScreenShareFloorStatus.RELEASED;
@@ -9474,12 +9625,7 @@ export default class Meeting extends StatelessWebexPlugin {
 
     this.annotation.deregisterEvents();
 
-    // @ts-ignore - fix types
-    this.webex.internal.llm.off('event:relay.event', this.processRelayEvent);
-    // @ts-ignore - Fix type
-    this.webex.internal.llm.off(LOCUS_LLM_EVENT, this.processLocusLLMEvent);
-
-    this.clearLLMHealthCheckTimer();
+    await this.cleanupLLMConneciton({throwOnError: false});
   };
 
   /**
@@ -10179,4 +10325,52 @@ export default class Meeting extends StatelessWebexPlugin {
   cancelSipCallOut(participantId: string) {
     return this.meetingRequest.cancelSipCallOut(participantId);
   }
+
+  /**
+   * Method to get new data
+   * @returns {Promise}
+   */
+  public async refreshDataChannelToken() {
+    const isPracticeSession = this.webinar.isJoinPracticeSessionDataChannel();
+    const dataChannelTokenType = this.getDataChannelTokenType();
+
+    try {
+      const res = await this.meetingRequest.fetchDatachannelToken({
+        locusUrl: this.locusUrl,
+        requestingParticipantId: this.members.selfId,
+        isPracticeSession,
+      });
+
+      return {
+        body: {
+          datachannelToken: res.body.datachannelToken,
+          dataChannelTokenType,
+        },
+      };
+    } catch (e) {
+      const msg = e?.message || String(e);
+
+      LoggerProxy.logger.warn(
+        `Meeting:index#refreshDataChannelToken --> DataChannel token refresh failed (likely locus changed or participant left): ${msg}`,
+        {statusCode: e?.statusCode}
+      );
+
+      return null;
+    }
+  }
+
+  /**
+   * 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.
+   */
+  public getDataChannelTokenType(): DataChannelTokenType {
+    if (this.webinar.isJoinPracticeSessionDataChannel()) {
+      return DataChannelTokenType.PracticeSession;
+    }
+
+    return DataChannelTokenType.Default;
+  }
 }

package/src/meeting/request.ts

@@ -33,6 +33,7 @@ import {
   ToggleReactionsOptions,
   PostMeetingDataConsentOptions,
   SynchronizeVideoLayout,
+  fetchDataChannelTokenOptions,
 } from './request.type';
 import MeetingUtil from './util';
 import {AnnotationInfo} from '../annotation/annotation.types';
@@ -1126,4 +1127,45 @@ export default class MeetingRequest extends StatelessWebexPlugin {
       throw err;
     }
   }
+
+  /**
+   * 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}>}
+   */
+  public async fetchDatachannelToken({
+    locusUrl,
+    requestingParticipantId,
+    isPracticeSession = false,
+  }: fetchDataChannelTokenOptions) {
+    if (!locusUrl || !requestingParticipantId) {
+      return Promise.reject(new Error('locusUrl and participantId are required'));
+    }
+    const practicePrefix = isPracticeSession ? '/practiceSession' : '';
+
+    const uri = `${locusUrl}/${PARTICIPANT}/${requestingParticipantId}${practicePrefix}/datachannel/token`;
+
+    // @ts-ignore
+    return this.locusDeltaRequest({
+      method: HTTP_VERBS.GET,
+      uri,
+    }).catch((err) => {
+      LoggerProxy.logger.warn(
+        `Meeting:request#fetchDatachannelToken --> Failed to retrieve ${
+          isPracticeSession ? 'practice session ' : ''
+        }datachannel token: ${err?.message || err}`
+      );
+
+      return null;
+    });
+  }
 }

package/src/meeting/request.type.ts

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