@cometchat/calls-sdk-react-native 5.0.1 → 5.0.2-beta.1

package/dist/index.d.ts

@@ -114,6 +114,8 @@ declare const EVENT_LISTENER_METHODS: {
     readonly onSessionLeft: "onSessionLeft";
     readonly onConnectionLost: "onConnectionLost";
     readonly onConnectionRestored: "onConnectionRestored";
+    readonly onRemoteConnectionLost: "onRemoteConnectionLost";
+    readonly onRemoteConnectionRestored: "onRemoteConnectionRestored";
     readonly onConnectionClosed: "onConnectionClosed";
     readonly onConnectionFailed: "onConnectionFailed";
     readonly onSessionTimedOut: "onSessionTimedOut";
@@ -184,6 +186,8 @@ declare const EVENT_LISTENER_METHODS_WEB: {
     readonly onSessionLeft: "onSessionLeft";
     readonly onConnectionLost: "onConnectionLost";
     readonly onConnectionRestored: "onConnectionRestored";
+    readonly onRemoteConnectionLost: "onRemoteConnectionLost";
+    readonly onRemoteConnectionRestored: "onRemoteConnectionRestored";
     readonly onConnectionClosed: "onConnectionClosed";
     readonly onConnectionFailed: "onConnectionFailed";
     readonly onSessionTimedOut: "onSessionTimedOut";
@@ -225,6 +229,7 @@ declare const EVENT_LISTENER_METHODS_WEB: {
 declare const EVENT_LISTENER_METHODS_MOBILE: {
   readonly MediaEventsListener: {
     readonly onAudioModeChanged: "onAudioModeChanged";
+    readonly onAudioModesChanged: "onAudioModesChanged";
     readonly onCameraFacingChanged: "onCameraFacingChanged";
     readonly onAudioMuted: "onAudioMuted";
     readonly onAudioUnMuted: "onAudioUnMuted";
@@ -260,6 +265,8 @@ declare const EVENT_LISTENER_METHODS_MOBILE: {
     readonly onSessionLeft: "onSessionLeft";
     readonly onConnectionLost: "onConnectionLost";
     readonly onConnectionRestored: "onConnectionRestored";
+    readonly onRemoteConnectionLost: "onRemoteConnectionLost";
+    readonly onRemoteConnectionRestored: "onRemoteConnectionRestored";
     readonly onConnectionClosed: "onConnectionClosed";
     readonly onConnectionFailed: "onConnectionFailed";
     readonly onSessionTimedOut: "onSessionTimedOut";
@@ -293,6 +300,64 @@ declare const INTERNAL_EVENTS: {
     readonly SDKInitialized: "internal.SDKInitialized";
   };
 };
+declare const CAPTION_LANGUAGES: readonly [{
+  readonly code: "en-US";
+  readonly label: "English (United States)";
+}, {
+  readonly code: "de-DE";
+  readonly label: "German (Germany)";
+}, {
+  readonly code: "en-GB";
+  readonly label: "English (United Kingdom)";
+}, {
+  readonly code: "es-ES";
+  readonly label: "Spanish (Spain)";
+}, {
+  readonly code: "fr-FR";
+  readonly label: "French (France)";
+}, {
+  readonly code: "hi-IN";
+  readonly label: "Hindi (India)";
+}, {
+  readonly code: "hu-HU";
+  readonly label: "Hungarian (Hungary)";
+}, {
+  readonly code: "it-IT";
+  readonly label: "Italian (Italy)";
+}, {
+  readonly code: "ja-JP";
+  readonly label: "Japanese (Japan)";
+}, {
+  readonly code: "ko-KR";
+  readonly label: "Korean (South Korea)";
+}, {
+  readonly code: "lt-LT";
+  readonly label: "Lithuanian (Lithuania)";
+}, {
+  readonly code: "ms-MY";
+  readonly label: "Malay (Malaysia)";
+}, {
+  readonly code: "nl-NL";
+  readonly label: "Dutch (Netherlands)";
+}, {
+  readonly code: "pt-PT";
+  readonly label: "Portuguese (Portugal)";
+}, {
+  readonly code: "ru-RU";
+  readonly label: "Russian (Russia)";
+}, {
+  readonly code: "sv-SE";
+  readonly label: "Swedish (Sweden)";
+}, {
+  readonly code: "tr-TR";
+  readonly label: "Turkish (Turkey)";
+}, {
+  readonly code: "zh";
+  readonly label: "Chinese Mandarin (Simplified, China)";
+}, {
+  readonly code: "zh-TW";
+  readonly label: "Chinese Mandarin (Traditional, Taiwan)";
+}];
 //#endregion
 //#region calls-sdk-core/utils/debounce.d.ts
 declare function debounce<T extends (...args: any[]) => any>(func: T, delay: number): (...args: Parameters<T>) => void;
@@ -310,6 +375,7 @@ type VideoInputDevice = MediaDeviceInfo & {
 type Subscription = (() => void) | {
   remove: () => void;
 };
+type SettingsDialogTab = 'audio' | 'video' | 'closedCaption';
 type BaseState = {
   participantListVisible: boolean;
   moreMenuVisible: boolean;
@@ -334,6 +400,7 @@ type BaseState = {
   cameraFacing: CameraFacingInternal;
   connectionRetryCount: number;
   settingsDialogVisible: boolean;
+  settingsDialogTab: SettingsDialogTab;
   virtualBackgroundDialogVisible: boolean;
   idealTimeoutTimer?: NodeJS.Timeout;
   idleTimeoutModalVisible: boolean;
@@ -420,7 +487,7 @@ declare const setLayout: (layout: Layout, sidebarLayoutSetProgrammatically?: boo
 declare const hideAllBottomSheets: () => void;
 declare const enablePictureInPictureLayout: () => void;
 declare const disablePictureInPictureLayout: () => void;
-declare const showSettingsDialog: () => void;
+declare const showSettingsDialog: (tab?: SettingsDialogTab) => void;
 declare const hideSettingsDialog: () => void;
 declare const toggleSettingsDialog: () => void;
 declare const showVirtualBackgroundDialog: () => void;
@@ -428,7 +495,7 @@ declare const hideVirtualBackgroundDialog: () => void;
 declare const toggleMirrorLocalVideo: () => void;
 declare const toggleEnableNoiseReduction: () => void;
 declare const setChatButtonUnreadCount: (count: number) => void;
-declare const setAudioMode: (mode: AudioMode["type"]) => void;
+declare const setAudioModes: (modes: AudioMode[]) => void;
 declare const getLayout: () => Layout;
 declare function initBaseStoreSubscriptions(): void;
 //#endregion
@@ -442,6 +509,12 @@ type ConferenceState = {
   p2p: boolean;
   conferenceStatus: 'initial' | 'joining' | 'joined' | 'error' | 'interrupted' | 'left' | 'restored' | 'reconnecting';
   connectionQuality: Map<string, number>;
+  /**
+   * pid → epoch ms of that participant's last remote stats update. Seeded
+   * when the participant joins; in peer calls, used to detect the remote
+   * peer's connection being lost (onRemoteConnectionLost).
+   */
+  remoteStatsTimestamps: Map<string, number>;
   raiseHandMap: Map<string, number>;
   recording: {
     status: ValueOf<typeof JitsiMeetJS.constants.recording.status>;
@@ -490,57 +563,359 @@ type ConfigStateInternal = {
   enableCompanionMode: boolean;
   sdkPlatform?: SDKPlatform;
 };
+/**
+ * Configuration that only applies on mobile platforms
+ * (native iOS / Android and React Native). These options are ignored on the web.
+ */
 type ConfigStateMobile = {
+  /**
+   * The audio output route the call should use. One of:
+   * - `'SPEAKER'` — the loudspeaker.
+   * - `'EARPIECE'` — the phone's earpiece.
+   * - `'HEADPHONES'` — wired headphones.
+   * - `'BLUETOOTH'` — a connected Bluetooth audio device.
+   *
+   * When omitted, the SDK chooses a route automatically based on the devices
+   * currently connected and updates it as devices are plugged in or removed.
+   *
+   * @default undefined — chosen automatically by the SDK
+   */
   audioMode?: AudioMode['type'];
+  /**
+   * Hides the audio-output (route) selector button from the call controls,
+   * preventing the user from switching between speaker, earpiece, headphones,
+   * and Bluetooth from within the SDK UI.
+   *
+   * @default false
+   */
   hideAudioModeButton: boolean;
+  /**
+   * Allows the user to tap the picture-in-picture tile to swap who is shown in
+   * the main spotlight. Only applies when `layout` is `'SPOTLIGHT'`.
+   *
+   * @default true
+   */
+  enableSpotlightSwap: boolean;
 };
+/**
+ * Configuration that only applies on the web platform.
+ * These options are ignored on mobile.
+ */
 type ConfigStateWeb = {
+  /**
+   * Applies background-noise suppression to the local microphone so that
+   * keyboard clicks, fans, and other ambient sounds are filtered out before
+   * your audio is sent to other participants.
+   *
+   * @default false
+   */
   enableNoiseReduction: boolean;
+  /**
+   * The `deviceId` of the microphone to capture audio from when the call
+   * starts. Use this to pre-select a specific input device instead of the
+   * system default. Device IDs come from the browser's
+   * `navigator.mediaDevices.enumerateDevices()`.
+   *
+   * @default undefined — uses the system default microphone
+   */
   audioInputDeviceId?: string;
+  /**
+   * The `deviceId` of the speaker / output device used to play remote
+   * participants' audio. Use this to pre-select a specific output device
+   * instead of the system default.
+   *
+   * @default undefined — uses the system default speaker
+   */
   audioOutputDeviceId?: string;
+  /**
+   * The `deviceId` of the camera to capture video from when the call starts.
+   * Use this to pre-select a specific camera instead of the system default.
+   *
+   * @default undefined — uses the system default camera
+   */
   videoInputDeviceId?: string;
+  /**
+   * Hides the screen-sharing button from the call controls, preventing the
+   * user from starting a screen share from within the SDK UI.
+   *
+   * @default false
+   */
   hideScreenSharingButton: boolean;
-  hideVirtualBackgroundButton: boolean;
   /**
-   * @unstable This API may change or be removed in a future release.
-   * When enabled, the SDK renders only remote audio elements without any
-   * visual UI (no video tiles, controls, or overlays). This allows the
-   * host app to provide its own custom UI while the SDK handles the
-   * underlying call connection and audio playback.
+   * Hides the virtual-background button from the call controls, preventing the
+   * user from blurring or replacing their camera background from within the
+   * SDK UI.
+   *
+   * @default false
    */
-  unstable_renderAudioOnly: boolean;
+  hideVirtualBackgroundButton: boolean;
 };
+/**
+ * Configuration that applies on both web and mobile platforms.
+ */
 type ConfigStateBoth = {
+  /**
+   * Whether the call starts as an audio-only (`'VOICE'`) call or a video
+   * (`'VIDEO'`) call. In a voice call no camera is acquired and no video
+   * tiles are shown.
+   *
+   * @default 'VIDEO'
+   */
   sessionType: SessionType;
+  /**
+   * The arrangement used to display participant video tiles:
+   * - `'TILE'` — an equal grid of all participants.
+   * - `'SIDEBAR'` — one main participant with the rest in a side strip.
+   * - `'SPOTLIGHT'` — a single full-screen participant with the local user
+   *   shown in a small picture-in-picture tile.
+   *
+   * @default 'TILE'
+   */
   layout: Layout;
+  /**
+   * Which camera to use when the call starts: `'FRONT'` (selfie) or `'REAR'`
+   * (back). Primarily relevant on mobile devices with multiple cameras; the
+   * user can still switch afterwards.
+   *
+   * @default undefined — uses the SDK's current camera (front by default)
+   */
   initialCameraFacing?: CameraFacing;
+  /**
+   * Automatically starts recording the session as soon as the call begins,
+   * without the user pressing the record button. Recording must be enabled
+   * for your app for this to take effect.
+   *
+   * @default false
+   */
   autoStartRecording: boolean;
+  /**
+   * Automatically starts live transcription as soon as the call begins,
+   * without the user pressing the transcription button. Transcription must
+   * be enabled for your app for this to take effect.
+   *
+   * @default false
+   */
+  autoStartTranscription: boolean;
+  /**
+   * Hides the recording button from the call controls, preventing the user
+   * from manually starting or stopping recording from within the SDK UI.
+   *
+   * @default true
+   */
   hideRecordingButton: boolean;
+  /**
+   * Hides the entire bottom control bar (mic, camera, leave, and every other
+   * call control). Useful when the host app provides its own controls.
+   *
+   * @default false
+   */
   hideControlPanel: boolean;
+  /**
+   * Hides the "leave call" button from the call controls. The host app is
+   * then responsible for providing its own way to leave the session.
+   *
+   * @default false
+   */
   hideLeaveSessionButton: boolean;
+  /**
+   * Hides the top header bar of the call UI (which shows the call title,
+   * session timer, and similar information).
+   *
+   * @default false
+   */
   hideHeaderPanel: boolean;
+  /**
+   * Hides the "raise hand" button from the call controls.
+   *
+   * @default false
+   */
   hideRaiseHandButton: boolean;
+  /**
+   * Hides the "share / invite" button that lets the user invite others to
+   * join the call.
+   *
+   * @default true
+   */
   hideShareInviteButton: boolean;
+  /**
+   * Hides the layout-switcher button, preventing the user from changing
+   * between the tile, sidebar, and spotlight layouts at runtime.
+   *
+   * @default false
+   */
   hideChangeLayoutButton: boolean;
+  /**
+   * Hides the microphone mute/unmute button from the call controls.
+   *
+   * @default false
+   */
   hideToggleAudioButton: boolean;
+  /**
+   * Hides the camera on/off button from the call controls.
+   *
+   * @default false
+   */
   hideToggleVideoButton: boolean;
+  /**
+   * Hides the button that opens the participant list panel.
+   *
+   * @default false
+   */
   hideParticipantListButton: boolean;
+  /**
+   * Hides the in-call chat button.
+   *
+   * @default true
+   */
   hideChatButton: boolean;
+  /**
+   * Hides the elapsed-time timer that shows how long the call has been
+   * running.
+   *
+   * @default false
+   */
   hideSessionTimer: boolean;
+  /**
+   * Hides the network-quality indicator that reflects each participant's
+   * connection strength.
+   *
+   * @default true
+   */
   hideNetworkIndicator: boolean;
+  /**
+   * Hides the "recording in progress" badge shown while the session is being
+   * recorded. The recording itself is unaffected.
+   *
+   * @default false
+   */
   hideRecordingStatusIndicator: boolean;
+  /**
+   * Hides the button that switches between the front and rear cameras.
+   * Mainly relevant on mobile devices with more than one camera.
+   *
+   * @default false
+   */
   hideSwitchCameraButton: boolean;
+  /**
+   * Hides the closed-caption button that lets the user show or hide live
+   * captions on screen. Even when set to `false`, the button only appears
+   * while transcription is running, since captions are produced from the
+   * live transcript.
+   *
+   * @default true
+   */
+  hideClosedCaptionButton: boolean;
+  /**
+   * Hides the transcription button from the call controls, preventing the
+   * user from manually starting or stopping live transcription from within
+   * the SDK UI.
+   *
+   * @default true
+   */
+  hideTranscriptionButton: boolean;
+  /**
+   * The currently selected caption/transcription language code (e.g.
+   * `en-US`). Selected from the closed-caption settings dropdown.
+   */
+  captionLanguage: CaptionLanguageCode;
+  /**
+   * Enables the per-participant context menu — opened by right-clicking (web)
+   * or long-pressing (mobile) a participant's tile — that exposes actions such
+   * as pinning a participant.
+   *
+   * Note: this menu is automatically unavailable in the `'SPOTLIGHT'` and
+   * picture-in-picture layouts regardless of this setting.
+   *
+   * @default true
+   */
   enableParticipantContextMenu: boolean;
+  /**
+   * The display name to show for the local user in the call (participant
+   * tiles, participant list, etc.). When left empty, the name associated with
+   * the logged-in user is used.
+   *
+   * @default '' — falls back to the logged-in user's name
+   */
   displayName: string;
+  /**
+   * Joins the call with the microphone muted. The user can unmute manually
+   * afterwards (unless the toggle-audio button is hidden).
+   *
+   * @default false
+   */
   startAudioMuted: boolean;
+  /**
+   * Joins the call with the camera off. The user can turn the camera on
+   * manually afterwards (unless the toggle-video button is hidden).
+   *
+   * @default false
+   */
   startVideoPaused: boolean;
+  /**
+   * Title text shown in the call's header panel (for example, the meeting or
+   * room name).
+   *
+   * @default '' — no title shown
+   */
   title: string;
+  /**
+   * How long, in milliseconds, the local user may remain alone in the call
+   * (no other participants) before an "are you still there?" idle prompt is
+   * shown. The countdown only runs while you are the only participant.
+   *
+   * @default 60000 — 60 seconds
+   */
   idleTimeoutPeriodBeforePrompt: number;
+  /**
+   * How long, in milliseconds, the idle prompt stays on screen waiting for a
+   * response before the SDK automatically leaves the call on the user's behalf.
+   *
+   * @default 180000 — 3 minutes
+   */
   idleTimeoutPeriodAfterPrompt: number;
+  /**
+   * Allows the user to drag the local picture-in-picture tile to reposition
+   * it. Only applies when `layout` is `'SPOTLIGHT'`.
+   *
+   * @default true
+   */
   enableSpotlightDrag: boolean;
-  enableSpotlightSwap: boolean;
+  /**
+   * Marks this as a one-to-one (peer) call. In a peer call, when one
+   * participant leaves the session ends for everyone rather than continuing
+   * without them (unless `forceLeave` is passed when leaving). The remote
+   * peer's connectivity is also watched: if no remote stats arrive for 10
+   * seconds onRemoteConnectionLost is published, and
+   * onRemoteConnectionRestored once they resume.
+   *
+   * @default false
+   */
   isPeerCall: boolean;
+  /**
+   * Enables the in-call toast notifications surfaced by the SDK (for example
+   * "X joined the call" or error messages). Set to `false` to suppress all
+   * SDK toasts.
+   *
+   * @default true
+   */
   enableNotifications: boolean;
+  /**
+   * @unstable This API may change or be removed in a future release.
+   * When enabled in a voice call (`sessionType: 'VOICE'`), the SDK renders
+   * no visible UI at all — no controls, header, modals, or toast
+   * notifications — while the call connection, media, and events continue
+   * to work normally. Remote participants' audio keeps playing. The host
+   * app is responsible for providing its own UI, including reacting to
+   * session end (the SDK's "session has ended" view and the idle-timeout
+   * prompt/auto-leave are not shown in this mode).
+   *
+   * Only supported in voice calls: for video calls (`sessionType:
+   * 'VIDEO'`) the flag is ignored with a console warning and the default
+   * UI is rendered.
+   *
+   * @default false
+   */
+  unstable_headlessMode: boolean;
 };
 type ConfigState = ConfigStateInternal & ConfigStateMobile & ConfigStateWeb & ConfigStateBoth;
 type Actions$3 = {
@@ -668,6 +1043,7 @@ declare const InternalSettingSchema: v.ObjectSchema<{
         readonly minHeightForQualityLvl: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.StringSchema<undefined>, undefined>, undefined>;
         readonly mobileCodecPreferenceOrder: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
       }, undefined>, undefined>;
+      readonly pcStatsInterval: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
     }, undefined>;
   }, undefined>;
   readonly sessionId: v.StringSchema<undefined>;
@@ -853,6 +1229,109 @@ declare const pauseVideoTrack: (authority?: number) => void;
 declare const resumeVideoTrack: (authority?: number) => Promise<void>;
 declare const toggleVideoTrack: () => void;
 //#endregion
+//#region calls-sdk-core/store/transcription.d.ts
+/**
+ * A single entry inside a transcription-result `transcript` array.
+ */
+interface TranscriptSegment {
+  confidence: number;
+  text: string;
+}
+/**
+ * The participant metadata attached to a transcription-result message.
+ */
+interface TranscriptionParticipant {
+  id: string;
+  name: string;
+  identity_name: string;
+  identity_group_id: string;
+  avatar_url?: string;
+}
+/**
+ * Shape of the payload received in `onEndpointMessageReceived` when
+ * `type === 'transcription-result'`. This is stored as the value of each
+ * entry in `transcriptionsMessages`, keyed by `message_id`.
+ */
+interface TranscriptionMessage {
+  transcript: TranscriptSegment[];
+  is_interim: boolean;
+  language: string;
+  message_id: string;
+  event: string;
+  type: 'transcription-result';
+  participant: TranscriptionParticipant;
+  stability: number;
+  timestamp: number;
+}
+interface TranscriptionState {
+  transcriptionsMessages: Map<string, TranscriptionMessage>;
+  /**
+   * Whether the live caption overlay should be shown. Toggled by the
+   * closed-caption button in the control pane / more menu.
+   */
+  showLiveCaption: boolean;
+  /**
+   * Whether transcription is currently active for the session.
+   */
+  isTranscribing: boolean;
+  /**
+   * Whether the transcriber has joined the session.
+   */
+  transcriberJoined: boolean;
+  /**
+   * The currently selected caption/transcription language code (e.g.
+   * `en-US`). Selected from the closed-caption settings dropdown.
+   */
+  captionLanguage: CaptionLanguageCode;
+}
+interface TranscriptionActions {
+  /**
+   * Insert or update a transcription message by key. Because a Map `set`
+   * overwrites an existing key, this handles both "add" and "update".
+   */
+  setTranscriptionMessage: (key: string, value: TranscriptionMessage) => void;
+  /**
+   * Remove all transcription messages.
+   */
+  clearTranscriptionMessages: () => void;
+  /**
+   * Toggle the live caption overlay on/off.
+   */
+  toggleShowLiveCaption: () => void;
+  reset: () => void;
+}
+declare const useTranscriptionStore: zustand0.UseBoundStore<Omit<zustand0.StoreApi<TranscriptionState & TranscriptionActions>, "subscribe"> & {
+  subscribe: {
+    (listener: (selectedState: TranscriptionState & TranscriptionActions, previousSelectedState: TranscriptionState & TranscriptionActions) => void): () => void;
+    <U>(selector: (state: TranscriptionState & TranscriptionActions) => U, listener: (selectedState: U, previousSelectedState: U) => void, options?: {
+      equalityFn?: ((a: U, b: U) => boolean) | undefined;
+      fireImmediately?: boolean;
+    } | undefined): () => void;
+  };
+}>;
+/**
+ * Returns the transcription messages as an array, ordered by their arrival
+ * (Map insertion order). Re-renders only when the underlying Map reference
+ * changes, i.e. when a message is added, updated, or cleared.
+ */
+declare function useTranscriptionMessages(): TranscriptionMessage[];
+/**
+ * Returns whether the live caption overlay is currently shown.
+ */
+declare function useShowLiveCaption(): boolean;
+/**
+ * Toggle the live caption overlay. Safe to call from outside React (e.g.
+ * button click handlers in the control pane).
+ */
+declare function toggleShowLiveCaption(): void;
+/**
+ * Returns whether transcription is currently active for the session.
+ */
+declare const useIsTranscribing: () => boolean;
+declare function startTranscription(): Promise<void>;
+declare function stopTranscription(): Promise<void>;
+declare function toggleTranscription(): Promise<void>;
+//#endregion
 //#region calls-sdk-core/store/utils/hooks.d.ts
 declare const useHideMuteAudioButton: () => boolean;
 declare const useHideToggleVideoButton: () => boolean;
@@ -860,6 +1339,8 @@ declare const useIsConferenceJoined: () => boolean;
 declare const useHideScreenSharingButton: () => boolean;
 declare const useHideSwitchCameraButton: () => boolean;
 declare const useHideChatButton: () => boolean;
+declare const useHideClosedCaptionButton: () => boolean;
+declare const useHideTranscriptionButton: () => boolean;
 declare const useLocalParticipant: <T = HumanParticipant>(selector?: (local: HumanParticipant) => T) => T;
 declare const useScreenShareRunning: () => any;
 declare const useTrackMuted: (mediaType: MediaType, participantId?: string) => boolean;
@@ -957,6 +1438,14 @@ declare class SessionMethodsCore {
    * If recording is active, it will be stopped, and vice versa.
    */
   static toggleRecording(): void;
+  /**
+   * Starts transcription of the call.
+   */
+  static startTranscription(): void;
+  /**
+   * Stops the ongoing call transcription.
+   */
+  static stopTranscription(): void;
   /**
    * Pins a participant's video to focus on them.
    * @param participantId - The ID of the participant to pin.
@@ -1045,6 +1534,7 @@ type ValueOf<T> = T[keyof T];
 type ParticipantRole = ValueOf<typeof PARTICIPANT_ROLE>;
 type NotificationType = 'info' | 'success' | 'warning' | 'error';
 type SDKPlatform = ValueOf<typeof SDK_PLATFORM>;
+type CaptionLanguageCode = (typeof CAPTION_LANGUAGES)[number]['code'] | (string & {});
 interface ITrackOptions {
   cameraDeviceId?: string | null;
   constraints?: {
@@ -1098,6 +1588,13 @@ type SDKEvents = Omit<_SDKEvents, 'onParticipantListChanged' | 'onConnectionFail
 };
 type MobileSDKEvents = SDKEvents & {
   onAudioModeChanged: (payload: AudioMode['type']) => void;
+  /**
+   * Fired when the list of available audio modes changes,
+   * e.g. a Bluetooth device or headphones are connected/disconnected.
+   *
+   * @param payload - The updated list of available audio modes.
+   */
+  onAudioModesChanged: (payload: AudioMode[]) => void;
   onCameraFacingChanged: (payload: CameraFacing) => void;
   onSwitchCameraButtonClicked: () => void;
   onPictureInPictureLayoutEnabled: () => void;
@@ -1227,6 +1724,7 @@ declare namespace controlPanel {
     export namespace tabs {
       let audio: string;
       let video: string;
+      let closedCaption: string;
     }
     export namespace deviceLabels {
       let microphone: string;
@@ -1243,6 +1741,10 @@ declare namespace controlPanel {
       let enableNoiseReduction: string;
     }
     export { audioSettings_1 as audioSettings };
+    export namespace closedCaptionSettings {
+      let language: string;
+      let enableClosedCaptions: string;
+    }
     export namespace videoSettings_1 {
       let mirrorMyVideo: string;
       let selectCameraToSeePreview: string;
@@ -1318,12 +1820,16 @@ declare namespace virtualBackground {
   }
   export { buttons_2 as buttons };
 }
+declare namespace closedCaptions {
+  let emptyState_1: string;
+  export { emptyState_1 as emptyState };
+}
 declare namespace general {
   let error: string;
 }
 declare let other: {};
 declare namespace __json_default_export {
-  export { header, controlPanel, idealTimeout, participantList, virtualBackground, general, other };
+  export { header, controlPanel, idealTimeout, participantList, virtualBackground, closedCaptions, general, other };
 }
 //#endregion
 //#region calls-sdk-core/i18n/state.d.ts
@@ -1386,6 +1892,7 @@ declare const useTranslation: () => {
         tabs: {
           audio: string;
           video: string;
+          closedCaption: string;
         };
         deviceLabels: {
           microphone: string;
@@ -1401,6 +1908,10 @@ declare const useTranslation: () => {
         audioSettings: {
           enableNoiseReduction: string;
         };
+        closedCaptionSettings: {
+          language: string;
+          enableClosedCaptions: string;
+        };
         videoSettings: {
           mirrorMyVideo: string;
           selectCameraToSeePreview: string;
@@ -1464,6 +1975,9 @@ declare const useTranslation: () => {
         done: string;
       };
     };
+    closedCaptions: {
+      emptyState: string;
+    };
     general: {
       error: string;
     };
@@ -4178,9 +4692,19 @@ declare class CometChatCalls extends SessionMethodsCore {
   }): () => void;
   /**
    * Sets the audio output mode (mobile only).
+   *
+   * The returned promise rejects with a `{ errorCode, errorDescription }`
+   * object when the mode is 'EARPIECE' during a video call
+   * (ERROR_INVALID_AUDIO_MODE), when the mode is not currently available —
+   * including when no call is active (ERROR_AUDIO_MODE_UNAVAILABLE), or when
+   * the native route switch fails.
+   *
+   * The `onAudioModeChanged` event fires only after the audio route actually
+   * changes, not when this method is called.
    * @param mode - The audio mode to set (e.g., 'SPEAKER', 'EARPIECE', 'BLUETOOTH', 'HEADPHONES').
+   * @returns A Promise that resolves once the route change has been dispatched.
    */
-  static setAudioMode(mode: AudioMode['type']): void;
+  static setAudioMode(mode: AudioMode['type']): Promise<void>;
   /**
    * Enables Picture-in-Picture (PIP) layout during the call.
    */