@cometchat/calls-sdk-react-native 5.0.0-beta.1 → 5.0.0-beta.3

package/dist/index.js

@@ -75,17 +75,24 @@ var EventBus = class {
 			}
 		}
 	}
-	subscribe(actionType, listener) {
+	subscribe(actionType, listener, options) {
+		if (options?.signal?.aborted) {
+			return () => {};
+		}
 		if (!this.actionListenersMap.get(actionType)) {
 			this.actionListenersMap.set(actionType, []);
 		}
 		this.actionListenersMap.get(actionType)?.push(listener);
-		return () => {
+		const unsubscribe = () => {
 			const listenersList = this.actionListenersMap.get(actionType);
 			if (listenersList) {
 				this.actionListenersMap.set(actionType, listenersList.filter((l) => l !== listener));
 			}
 		};
+		if (options?.signal) {
+			options.signal.addEventListener("abort", unsubscribe, { once: true });
+		}
+		return unsubscribe;
 	}
 };
 const eventBus = new EventBus();
@@ -439,9 +446,9 @@ function getDefaultDevice(devices) {
 
 //#endregion
 //#region calls-sdk-core/utils/try-catch.ts
-async function tryCatch(promise) {
+async function tryCatch(promise, timeoutMs) {
 	try {
-		const data = await promise;
+		const data = timeoutMs != null ? await Promise.race([promise, new Promise((_, reject) => setTimeout(() => reject(new Error("timeout")), timeoutMs))]) : await promise;
 		return {
 			data,
 			error: null
@@ -485,76 +492,106 @@ function debounce(func, delay) {
 //#endregion
 //#region calls-sdk-core/utils/session-methods-core.ts
 var SessionMethodsCore = class {
+	/**
+	* Mutes the local user's audio during the call.
+	*/
 	static muteAudio() {
 		muteAudioTrack();
 	}
+	/**
+	* Unmutes the local user's audio during the call.
+	*/
 	static unmuteAudio() {
 		unMuteAudioTrack();
 	}
+	/**
+	* Pauses the local user's video stream.
+	*/
 	static pauseVideo() {
 		pauseVideoTrack();
 	}
+	/**
+	* Resumes the local user's video stream.
+	*/
 	static resumeVideo() {
 		resumeVideoTrack();
 	}
+	/**
+	* Local user leaves the current session.
+	*/
 	static leaveSession() {
 		leaveSession();
 	}
-	static startScreenSharing() {
-		startScreenSharing();
-	}
-	static stopScreenSharing() {
-		stopScreenSharing();
-	}
+	/**
+	* Raises the user's virtual hand in the call.
+	*/
 	static raiseHand() {
 		raisedHandLocal();
 	}
+	/**
+	* Lowers the user's virtual hand in the call.
+	*/
 	static lowerHand() {
 		lowerHandLocal();
 	}
+	/**
+	* Switches between the front and rear camera.
+	*/
 	static switchCamera() {
 		switchCamera();
 	}
+	/**
+	* Sets the layout type for the call.
+	* @param layout - The type of layout to set (tile, sidebar or spotlight).
+	*/
 	static setLayout(layout$1) {
 		setLayout(layout$1);
 	}
+	/**
+	* Starts recording the call.
+	*/
 	static startRecording() {}
+	/**
+	* Stops the ongoing call recording.
+	*/
 	static stopRecording() {}
-	static enablePictureInPictureLayout() {
-		enablePictureInPictureLayout();
-	}
-	static disablePictureInPictureLayout() {
-		disablePictureInPictureLayout();
-	}
+	/**
+	* Pins a participant's video to focus on them.
+	* @param participantId - The ID of the participant to pin.
+	* @param type - The type of the participant.
+	*/
 	static pinParticipant(participantId, type) {
 		pinParticipant(participantId, type);
 	}
+	/**
+	* Unpins a participant's video.
+	*/
 	static unpinParticipant() {
 		unpinParticipant();
 	}
+	/**
+	* Mutes the audio of a specific participant.
+	* @param participantId - The ID of the participant to mute.
+	*/
 	static muteParticipant(participantId) {
 		muteParticipant(participantId);
 	}
-	static pauseParticipantVideo(participantId) {
-		pauseParticipantVideo(participantId);
-	}
-	static setChatButtonUnreadCount(count) {
-		setChatButtonUnreadCount(count);
-	}
 	/**
-	* @deprecated use startScreenSharing() instead
+	* Pauses the video stream of a specific participant.
+	* @param participantId - The ID of the participant whose video to pause.
 	*/
-	static startScreenShare() {
-		this.startScreenSharing();
+	static pauseParticipantVideo(participantId) {
+		pauseParticipantVideo(participantId);
 	}
 	/**
-	* @deprecated use stopScreenSharing() instead
+	* Sets the unread message count displayed on the chat button.
+	* @param count - The number of unread messages.
 	*/
-	static stopScreenShare() {
-		this.stopScreenSharing();
+	static setChatButtonUnreadCount(count) {
+		setChatButtonUnreadCount(count);
 	}
 	/**
-	* @deprecated switchToVideoCall is deprecated and not supported
+	* @deprecated switchToVideoCall is deprecated and not supported.
 	*/
 	static switchToVideoCall() {
 		console.error("switchToVideoCall method deprecated and not supported.");
@@ -644,6 +681,27 @@ async function createLocalTrack(type, deviceId = null, cameraFacing = CAMERA_FAC
 		}
 	}
 }
+function createLocalTracks() {
+	const enableCompanionMode = useConfigStore.getState().enableCompanionMode;
+	if (!enableCompanionMode) {
+		const audioInputDeviceId = useConfigStore.getState().audioInputDeviceId ?? useBaseStore.getState().audioInputDevice?.deviceId;
+		createLocalTrack("audio", audioInputDeviceId);
+	}
+	const sessionType = useConfigStore.getState().sessionType;
+	if (sessionType === SESSION_TYPE.VIDEO) {
+		const videoInputDeviceIdP1 = useConfigStore.getState().videoInputDeviceId;
+		const videoInputDeviceIdP2 = useBaseStore.getState().videoInputDevice?.deviceId;
+		const initialCameraFacingP1 = useConfigStore.getState().initialCameraFacing;
+		const initialCameraFacingP2 = useBaseStore.getState().cameraFacing;
+		if (videoInputDeviceIdP1) {
+			createLocalTrack("video", videoInputDeviceIdP1);
+		} else if (initialCameraFacingP1) {
+			createLocalTrack("video", null, initialCameraFacingP2);
+		} else {
+			createLocalTrack("video", videoInputDeviceIdP2, initialCameraFacingP2);
+		}
+	}
+}
 function updateAudioInputDevice(deviceId) {
 	const audioInputDevices = useBaseStore.getState().audioInputDevices.filter((device) => device.deviceId !== "");
 	if (audioInputDevices.length > 0) {
@@ -843,7 +901,6 @@ const initialState$7 = {
 	hideLeaveSessionButton: false,
 	hideToggleAudioButton: false,
 	hideParticipantListButton: false,
-	hideSwitchLayoutButton: false,
 	hideChatButton: true,
 	hideToggleVideoButton: false,
 	hideScreenSharingButton: false,
@@ -860,7 +917,9 @@ const initialState$7 = {
 	idleTimeoutPeriodAfterPrompt: 18e4,
 	enableSpotlightDrag: true,
 	enableSpotlightSwap: true,
-	showFrameRate: false
+	showFrameRate: false,
+	enableCompanionMode: false,
+	isPeerCall: false
 };
 const useConfigStore = (0, zustand.create)()((0, zustand_middleware.subscribeWithSelector)((0, zustand_middleware.combine)(initialState$7, (set) => ({ reset: () => set(initialState$7) }))));
 const setConfig = (config) => {
@@ -1138,13 +1197,22 @@ const useConferenceStore = (0, zustand.create)()((0, zustand_middleware.subscrib
 	leaveConference: async () => {
 		const conference = useConferenceStore.getState().conference;
 		if (conference) {
-			const { error } = await tryCatch(conference.leave());
+			const { error } = await tryCatch(conference.leave(), 500);
 			if (error) {
 				console.warn("Error leaving conference:", error);
 				eventBus.publish({ type: EVENT_LISTENER_METHODS.SessionStatusListener.onSessionLeft });
 			}
 		}
 	},
+	endConference: async () => {
+		const conference = useConferenceStore.getState().conference;
+		if (conference) {
+			const { error } = await tryCatch(conference.end());
+			if (error) {
+				console.warn("Error ending conference:", error);
+			}
+		}
+	},
 	stopRecording: async () => {
 		const conference = useConferenceStore.getState().conference;
 		if (conference) {
@@ -1988,12 +2056,34 @@ const useConnectionStore = (0, zustand.create)()((0, zustand_middleware.subscrib
 	},
 	reset: () => set(initialState$2)
 }))));
+function waitForConnection() {
+	const { connectionStatus } = useConnectionStore.getState();
+	if (connectionStatus === "connected") return Promise.resolve();
+	return new Promise((resolve, reject) => {
+		const timeout = setTimeout(() => {
+			unsub();
+			reject(new Error("Connection timed out after 3 seconds"));
+		}, 3e3);
+		const unsub = useConnectionStore.subscribe((s) => s.connectionStatus, (status) => {
+			if (status === "connected") {
+				clearTimeout(timeout);
+				unsub();
+				resolve();
+			} else if (status === "error") {
+				clearTimeout(timeout);
+				unsub();
+				reject(useConnectionStore.getState().error);
+			}
+		});
+	});
+}
 
 //#endregion
 //#region calls-sdk-core/store/utils/hooks.ts
 const useHideMuteAudioButton = () => {
 	const hideMuteAudioButton = useConfigStore((state) => state.hideToggleAudioButton);
-	return hideMuteAudioButton;
+	const enableCompanionMode = useConfigStore((state) => state.enableCompanionMode);
+	return hideMuteAudioButton || enableCompanionMode;
 };
 const useHideToggleVideoButton = () => {
 	const hideToggleVideoButton = useConfigStore((state) => state.hideToggleVideoButton);
@@ -2311,8 +2401,13 @@ var ConferenceListener = class {
 		track.removeAllListeners(lib_jitsi_meet.default.events.track.NO_DATA_FROM_SOURCE);
 	}
 	onConferenceJoinInProgress() {}
-	onConferenceFailed(_conference, error, message) {
-		console.error("Conference failed:", error, message);
+	onConferenceFailed(errorName, error, message) {
+		console.log();
+		if (errorName === lib_jitsi_meet.default.errors.conference.CONFERENCE_DESTROYED) {
+			leaveSession({ forceLeave: true });
+			return;
+		}
+		console.error("Conference failed:", errorName, error, message);
 		useConferenceStore.setState({
 			conferenceStatus: "error",
 			conferenceJoined: false,
@@ -2512,17 +2607,23 @@ function addConferenceListeners(conference) {
 		}
 	});
 }
-async function createConference(connection, roomName) {
+async function _createConference() {
+	const sessionId = useConfigStore.getState().sessionId;
+	const connection = useConnectionStore.getState().connection;
 	if (!connection) {
 		throw new Error("No connection available");
 	}
+	const connectionStatus = useConnectionStore.getState().connectionStatus;
+	if (connectionStatus !== "connected") {
+		await waitForConnection();
+	}
 	const existingConference = useConferenceStore.getState().conference;
 	if (existingConference) {
 		console.log("Conference already exists, skipping creation");
 		return;
 	}
 	const connectionConfig = useConnectionStore.getState().connectionConfig;
-	const conference = connection.initJitsiConference(roomName, connectionConfig);
+	const conference = connection.initJitsiConference(sessionId, connectionConfig);
 	const localAudioTrack = getLocalTrack(MEDIA_TYPE.AUDIO)?.originalTrack;
 	const localVideoTrack = getLocalTrack(MEDIA_TYPE.VIDEO)?.originalTrack;
 	if (localAudioTrack) {
@@ -2537,6 +2638,20 @@ async function createConference(connection, roomName) {
 	conference.setDisplayName(useParticipantStore.getState().localParticipant.name);
 	conference.join();
 }
+async function createConference() {
+	const conference = useConferenceStore.getState().conference;
+	if (!conference) {
+		const result = await tryCatch(_createConference());
+		if (result.error) {
+			console.error("Error creating conference", result.error);
+			useConferenceStore.setState({
+				conferenceStatus: "error",
+				conferenceJoined: false,
+				conferenceError: result.error.message
+			});
+		}
+	}
+}
 function muteParticipant(participantId) {
 	const conference = useConferenceStore.getState().conference;
 	conference?.muteParticipant(participantId, "audio");
@@ -2548,7 +2663,12 @@ function pauseParticipantVideo(participantId) {
 
 //#endregion
 //#region calls-sdk-core/handlers/connection.ts
-function connect(roomName) {
+async function connect(autoJoinConference = true) {
+	const existingConnection = useConnectionStore.getState().connection;
+	if (existingConnection) {
+		createConference();
+		return;
+	}
 	const options = useConnectionStore.getState().connectionConfig;
 	const jwt = useConnectionStore.getState().jwt;
 	const iAmRecorder = useConfigStore.getState().iAmRecorder;
@@ -2564,15 +2684,8 @@ function connect(roomName) {
 	async function onConnectionEstablished() {
 		useConnectionStore.getState().connectionEstablished(connection);
 		eventBus.publish({ type: INTERNAL_EVENTS.onConnectionEstablished });
-		const result = await tryCatch(createConference(connection, roomName));
-		if (result.error) {
-			console.error("Error creating conference", result.error);
-			useConferenceStore.setState({
-				conferenceStatus: "error",
-				conferenceJoined: false,
-				conferenceError: result.error.message
-			});
-		}
+		if (!autoJoinConference) return;
+		createConference();
 	}
 	function onConnectionFailed(err, message, ...args) {
 		unsubscribe();
@@ -2778,6 +2891,7 @@ function initializeLib() {
 let isSessionStarted = false;
 let reconnectTimeoutId = null;
 const RECONNECT_DEBOUNCE_DELAY = 3e3;
+initializeLib();
 function startSession() {
 	const sessionId = useConfigStore.getState().sessionId;
 	if (!sessionId) {
@@ -2790,29 +2904,13 @@ function startSession() {
 	}
 	isSessionStarted = true;
 	console.log(`Session started in room: ${sessionId}`);
-	initializeLib();
-	const audioInputDeviceId = useConfigStore.getState().audioInputDeviceId ?? useBaseStore.getState().audioInputDevice?.deviceId;
-	createLocalTrack("audio", audioInputDeviceId);
-	const sessionType = useConfigStore.getState().sessionType;
-	if (sessionType === SESSION_TYPE.VIDEO) {
-		const videoInputDeviceIdP1 = useConfigStore.getState().videoInputDeviceId;
-		const videoInputDeviceIdP2 = useBaseStore.getState().videoInputDevice?.deviceId;
-		const initialCameraFacingP1 = useConfigStore.getState().initialCameraFacing;
-		const initialCameraFacingP2 = useBaseStore.getState().cameraFacing;
-		if (videoInputDeviceIdP1) {
-			createLocalTrack("video", videoInputDeviceIdP1);
-		} else if (initialCameraFacingP1) {
-			createLocalTrack("video", null, initialCameraFacingP2);
-		} else {
-			createLocalTrack("video", videoInputDeviceIdP2, initialCameraFacingP2);
-		}
-	}
+	createLocalTracks();
 	const audioOutputDeviceId = useConfigStore.getState().audioOutputDeviceId ?? useBaseStore.getState().audioOutputDevice?.deviceId;
 	if (audioOutputDeviceId) {
 		updateAudioOutputDevice(audioOutputDeviceId);
 	}
 	eventBus.startEmitting();
-	const test = tryCatchSync(() => connect(sessionId));
+	const test = tryCatchSync(() => connect());
 	if (test.error) {
 		console.error("Error connecting to session:", test.error);
 		useConnectionStore.getState().connectionFailed(test.error.message);
@@ -2829,8 +2927,14 @@ async function _leaveSession() {
 	await useConnectionStore.getState().disconnect();
 }
 const sessionMutex = new Mutex();
-function leaveSession() {
+function leaveSession(options = {}) {
 	return sessionMutex.run(async () => {
+		const isPeerCall = useConfigStore.getState().isPeerCall;
+		const shouldEnd = isPeerCall && !options.forceLeave;
+		if (shouldEnd) {
+			useConferenceStore.getState().endConference();
+			return;
+		}
 		useBaseStore.getState().clearIdealTimeoutTimer();
 		cancelPendingReconnect();
 		await _leaveSession();
@@ -3927,6 +4031,11 @@ const PopupMenu = ({ visible, onClose, options, anchorLayout }) => {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_native.Modal, {
 		transparent: true,
 		animationType: "none",
+		supportedOrientations: [
+			"portrait",
+			"landscape-left",
+			"landscape-right"
+		],
 		onRequestClose: onClose,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_native.Pressable, {
 			style: styles$27.backdrop,
@@ -5013,6 +5122,11 @@ function ConfirmationDialog() {
 		visible,
 		transparent: true,
 		animationType: "fade",
+		supportedOrientations: [
+			"portrait",
+			"landscape-left",
+			"landscape-right"
+		],
 		onRequestClose: handleBackdropPress,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_native.Pressable, {
 			style: styles$15.backdrop,
@@ -5817,6 +5931,11 @@ const IdealTimeoutModal = ({ style = {} }) => {
 		transparent: true,
 		visible: idleTimeoutModalVisible,
 		animationType: "none",
+		supportedOrientations: [
+			"portrait",
+			"landscape-left",
+			"landscape-right"
+		],
 		statusBarTranslucent: true,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_native.TouchableWithoutFeedback, {
 			onPress: handleOverlayPress,
@@ -5869,7 +5988,7 @@ const IdealTimeoutModal = ({ style = {} }) => {
 									})
 								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_native.TouchableOpacity, {
 									style: [styles$6.button, styles$6.buttonPrimary],
-									onPress: leaveSession,
+									onPress: () => leaveSession(),
 									activeOpacity: .8,
 									children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_native.Text, {
 										style: [commonStyles.bodyMedium, styles$6.buttonPrimaryText],
@@ -5898,6 +6017,7 @@ const styles$6 = react_native.StyleSheet.create({
 		borderWidth: 1,
 		borderColor: "#383838",
 		width: "100%",
+		maxWidth: 372,
 		paddingTop: 32,
 		paddingHorizontal: 20,
 		paddingBottom: 20,
@@ -6439,11 +6559,11 @@ function CallUI(props) {
 	const isConferenceJoined = useIsConferenceJoined();
 	(0, react.useLayoutEffect)(() => {
 		eventBus.publish({ type: INTERNAL_EVENTS.lifecycle.componentDidMount });
-		updateConfig(props.callSettings);
+		updateConfig(props.sessionSettings);
 		return () => {
 			eventBus.publish({ type: INTERNAL_EVENTS.lifecycle.componentWillUnmount }, true);
 		};
-	}, [props.callSettings]);
+	}, [props.sessionSettings]);
 	(0, react.useEffect)(() => {
 		useBaseStore.setState({ sdkPlatform: react_native.Platform.OS });
 		startSession();
@@ -6460,13 +6580,13 @@ function CallUI(props) {
 	(0, react.useEffect)(() => {
 		if (react_native.Platform.OS === "android") {
 			AudioModeModule_default.setMode(type === SESSION_TYPE.VOICE ? AudioModeModule_default.AUDIO_CALL : AudioModeModule_default.VIDEO_CALL);
-			if (props.callSettings.audioMode) {
-				AudioModeModule_default.setAudioDevice(props.callSettings.audioMode);
+			if (props.sessionSettings.audioMode) {
+				AudioModeModule_default.setAudioDevice(props.sessionSettings.audioMode);
 			}
 		} else if (react_native.Platform.OS === "ios") {
 			AudioModeModule_default.updateDeviceList();
 		}
-	}, [props.callSettings.audioMode, type]);
+	}, [props.sessionSettings.audioMode, type]);
 	if (isPIPLayoutEnabled) {
 		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(PiPTile_default, {});
 	}
@@ -6758,8 +6878,8 @@ async function callVerifyTokenAPI({ appId, region, calltoken, baseURL }) {
 }
 
 //#endregion
-//#region src/AppRN.tsx
-function App(props) {
+//#region src/AppReactNativeSDK.tsx
+function AppReactNativeSDK(props) {
 	const [internalSettings, setInternalSettings] = react.default.useState(null);
 	const [infoMessage, setInfoMessage] = react.default.useState(null);
 	(0, react.useEffect)(() => {
@@ -6771,7 +6891,7 @@ function App(props) {
 	}, []);
 	(0, react.useEffect)(() => {
 		const listeners = [];
-		const cs = props.callSettings ?? {};
+		const cs = props.sessionSettings ?? {};
 		if (cs.listener?.onUserJoined) {
 			listeners.push(CometChatCalls.addEventListener("onParticipantJoined", cs.listener.onUserJoined));
 		}
@@ -6809,7 +6929,7 @@ function App(props) {
 				listener();
 			});
 		};
-	}, [props.callSettings]);
+	}, [props.sessionSettings]);
 	(0, react.useEffect)(() => {
 		callVerifyTokenAPI({
 			appId: CometChatCalls.appSettings?.appId || "",
@@ -6838,14 +6958,12 @@ function App(props) {
 			visible: true
 		});
 	}
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(index_native_default, { callSettings: {
-		...props.callSettings,
-		...convertLegacyCallSettingsToV5Props(props?.callSettings ?? {}),
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(index_native_default, { sessionSettings: {
+		...props.sessionSettings,
+		...convertLegacyCallSettingsToV5Props(props?.sessionSettings ?? {}),
 		internalSettings
 	} });
 }
-var AppRN_default = App;
-const AppComponent = App;
 
 //#endregion
 //#region src/v4/Constants.ts
@@ -10578,7 +10696,13 @@ var CometChatCalls = class extends SessionMethodsCore {
 	static OngoingCallListener = OngoingCallListener;
 	static CallSettingsBuilder = CallSettingsBuilder;
 	static CallAppSettingsBuilder = CallAppSettingsBuilder;
-	static Component = AppComponent;
+	static Component = AppReactNativeSDK;
+	/**
+	* Initializes the CometChat Calls SDK with the provided app settings.
+	* Must be called before any other SDK methods.
+	* @param appSettings - The application settings for configuring the SDK.
+	* @returns An object indicating success or failure with error details.
+	*/
 	static async init(appSettings) {
 		const parsedAppSettings = valibot.safeParse(CallAppSettingsSchema, appSettings);
 		if (!parsedAppSettings.success) {
@@ -10613,6 +10737,14 @@ var CometChatCalls = class extends SessionMethodsCore {
 			error: null
 		};
 	}
+	/**
+	* Logs in a user with their UID and an optional auth key.
+	* If no auth key is provided, the one from app settings is used.
+	* @param uid - The unique identifier of the user.
+	* @param authKey - The authentication key. Falls back to the key provided in app settings.
+	* @returns A Promise that resolves to the logged-in User object.
+	* @throws {CometChatException} If login fails or validation errors occur.
+	*/
 	static async login(uid, authKey) {
 		try {
 			if (this.loginInProgress) {
@@ -10655,7 +10787,6 @@ var CometChatCalls = class extends SessionMethodsCore {
 			if (this.loggedInUser && this.loggedInUser.uid !== uid) {
 				await this.logoutInternal();
 			}
-			console.log("Logging in user with UID:", uid);
 			const authToken = await this.loginWithUID(uid, resolvedAuthKey);
 			const user = await this.authenticateWithToken(authToken);
 			this.loginInProgress = false;
@@ -10670,6 +10801,12 @@ var CometChatCalls = class extends SessionMethodsCore {
 			throw cometChatError;
 		}
 	}
+	/**
+	* Logs in a user directly with an auth token.
+	* @param authToken - The authentication token for the user.
+	* @returns A Promise that resolves to the logged-in User object.
+	* @throws {CometChatException} If login fails or the token is invalid.
+	*/
 	static async loginWithAuthToken(authToken) {
 		try {
 			if (this.loginInProgress) {
@@ -10712,6 +10849,11 @@ var CometChatCalls = class extends SessionMethodsCore {
 			throw cometChatError;
 		}
 	}
+	/**
+	* Logs out the currently logged-in user and clears local session data.
+	* @returns A Promise that resolves to a success message string.
+	* @throws {CometChatException} If no user is logged in or logout fails.
+	*/
 	static async logout() {
 		try {
 			if (!this.loggedInUser) {
@@ -10729,24 +10871,53 @@ var CometChatCalls = class extends SessionMethodsCore {
 			throw cometChatError;
 		}
 	}
+	/**
+	* Retrieves the currently logged-in user.
+	* @returns The logged-in User object, or null if no user is logged in.
+	*/
 	static getLoggedInUser() {
 		if (this.loggedInUser && typeof this.loggedInUser === "string") {
 			this.loggedInUser = JSON.parse(this.loggedInUser);
 		}
 		return this.loggedInUser;
 	}
+	/**
+	* Retrieves the auth token of the currently logged-in user.
+	* @returns The auth token string, or null if no user is logged in.
+	*/
 	static getUserAuthToken() {
 		return this.loggedInUser?.authToken || null;
 	}
+	/**
+	* Checks whether a user is currently logged in.
+	* @returns True if a user is logged in with a valid auth token, false otherwise.
+	*/
 	static isUserLoggedIn() {
 		return this.loggedInUser !== null && this.loggedInUser.authToken !== undefined;
 	}
+	/**
+	* Registers a login listener to receive login/logout lifecycle callbacks.
+	* @param listenerId - A unique identifier for the listener.
+	* @param listener - The listener object with callback methods.
+	*/
 	static addLoginListener(listenerId, listener) {
 		this.loginListeners.set(listenerId, listener);
 	}
+	/**
+	* Removes a previously registered login listener.
+	* @param listenerId - The unique identifier of the listener to remove.
+	*/
 	static removeLoginListener(listenerId) {
 		this.loginListeners.delete(listenerId);
 	}
+	/**
+	* Generates a call token for the given session.
+	* Uses the provided auth token or falls back to the logged-in user's token.
+	* @param sessionId - The session ID to generate a token for.
+	* @param authToken - Optional auth token. If omitted, the logged-in user's token is used.
+	* @returns A Promise that resolves to an object containing the generated token.
+	* @throws {CometChatException} If the session ID is missing, no auth token is available, or the SDK is not initialized.
+	*/
 	static async generateToken(sessionId, authToken) {
 		try {
 			if (!sessionId || sessionId.trim() === "") {
@@ -10980,8 +11151,27 @@ var CometChatCalls = class extends SessionMethodsCore {
 			}
 		});
 	}
-	static addEventListener(eventType, listener) {
-		return eventBus.subscribe(eventType, listener);
+	/**
+	* Adds an event listener for SDK events.
+	* @param eventType - The type of event to listen for.
+	* @param listener - The callback function to invoke when the event fires.
+	* @param options - Optional configuration including an AbortSignal for automatic cleanup.
+	* @returns An unsubscribe function to remove the listener.
+	*/
+	static addEventListener(eventType, listener, options) {
+		return eventBus.subscribe(eventType, listener, options);
+	}
+	/**
+	* Enables Picture-in-Picture (PIP) layout during the call.
+	*/
+	static enablePictureInPictureLayout() {
+		enablePictureInPictureLayout();
+	}
+	/**
+	* Disables Picture-in-Picture (PIP) layout.
+	*/
+	static disablePictureInPictureLayout() {
+		disablePictureInPictureLayout();
 	}
 };