@realtimexsco/live-chat 1.4.9 → 1.4.11

package/dist/index.d.mts

@@ -105,6 +105,27 @@ type ChatQueryParamsByApi = Partial<Record<Exclude<ChatApiKey, "all" | "get">, C
 /** Match an axios request URL to a named API key (first match wins). */
 declare function resolveChatApiKey(url?: string): Exclude<ChatApiKey, "all" | "get"> | null;
 
+type ChatApiVersionKey = "default" | "push";
+interface ChatApiVersionConfig {
+    /** Main chat REST API version (usually parsed from `setChatBaseURL`). */
+    default?: string;
+    /** Push notification API version. Default: `v2`. */
+    push?: string;
+}
+/**
+ * Strip a trailing `/v1`, `/v2`, … from the configured base URL.
+ * `https://realtimex.softwareco.com/api/v1` → `https://realtimex.softwareco.com/api`
+ */
+declare const resolveApiRoot: (baseUrl?: string) => string;
+declare const buildVersionedApiUrl: (path: string, options?: {
+    version?: string;
+    baseUrl?: string;
+    service?: ChatApiVersionKey;
+}) => string;
+declare const setChatApiVersions: (config?: ChatApiVersionConfig | null) => void;
+declare const getChatApiVersions: () => Readonly<Record<ChatApiVersionKey, string>>;
+declare const setChatPushApiVersion: (version: string) => void;
+
 declare const setChatClientId: (id: string) => void;
 declare const setChatAccessToken: (token: string) => void;
 declare const setChatBaseURL: (url: string) => void;
@@ -143,11 +164,52 @@ declare const getChatQueryParamsByApi: () => {
     presignedUrls?: Record<string, string> | undefined;
 };
 
+interface PushNotificationToggleRenderProps {
+    label: string;
+    description: string;
+    checked: boolean;
+    disabled: boolean;
+    loading: boolean;
+    permissionBlocked: boolean;
+    error: string | null;
+    onCheckedChange: (checked: boolean) => void;
+}
+interface PushNotificationToggleProps {
+    className?: string;
+    label?: string;
+    description?: string;
+    /** Build your own row UI while keeping package push logic. */
+    children?: (props: PushNotificationToggleRenderProps) => ReactNode;
+}
+/**
+ * Drop-in per-user push notification switch. Renders nothing while push is
+ * unsupported by the browser, disabled by the workspace admins, or not yet
+ * configured on the backend — users only ever see a switch they can use.
+ *
+ * On: prompts for browser permission and registers this device.
+ * Off: unregisters this device.
+ */
+declare const PushNotificationToggle: ({ className, label, description, children, }: PushNotificationToggleProps) => React.JSX.Element | null;
+
 interface ChatForwardItem {
     message: IMessage;
     attachmentId?: string;
 }
 
+interface IUser {
+    _id: string;
+    id?: string;
+    name: string;
+    email: string;
+    role: string;
+    isActive: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+    image?: string;
+    refreshToken?: string;
+    isOnline?: boolean;
+}
+
 interface ChatLayoutConfig {
     /** Sidebar with profile + conversation list */
     sidebar?: boolean;
@@ -167,20 +229,6 @@ interface ChatLayoutConfig {
 declare const defaultChatLayoutConfig: Required<ChatLayoutConfig>;
 declare const mergeChatLayoutConfig: (config?: ChatLayoutConfig) => Required<ChatLayoutConfig>;
 
-interface IUser {
-    _id: string;
-    id?: string;
-    name: string;
-    email: string;
-    role: string;
-    isActive: boolean;
-    createdAt: Date;
-    updatedAt: Date;
-    image?: string;
-    refreshToken?: string;
-    isOnline?: boolean;
-}
-
 type SocketStatus = "idle" | "connecting" | "connected" | "disconnected" | "error";
 interface AuthState {
     loggedUserDetails: IUser | null;
@@ -548,6 +596,33 @@ interface LoggedUserDetailsSlotProps {
     searchQuery?: string;
     setSearchQuery?: (val: string) => void;
 }
+/** Full settings button + modal (replace for a completely custom account settings UI). */
+interface LoggedUserSettingsDialogSlotProps {
+    loggedUserDetails: any;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    title?: string;
+    showProfile?: boolean;
+    showPushToggle?: boolean;
+    className?: string;
+}
+/** Settings gear button only — used when customizing the dialog shell. */
+interface LoggedUserSettingsTriggerSlotProps {
+    onClick: () => void;
+    className?: string;
+    tooltip?: string;
+    ariaLabel?: string;
+}
+/** Modal body — profile, push toggle, or your own settings rows. */
+interface LoggedUserSettingsContentSlotProps {
+    loggedUserDetails: any;
+    user: IUser;
+    onClose?: () => void;
+    title?: string;
+    showProfile?: boolean;
+    showPushToggle?: boolean;
+    className?: string;
+}
 interface ActiveChannelMessagesSlotProps {
     activeChannel: IChannel | null;
     loggedUserId?: string;
@@ -758,6 +833,12 @@ interface ChatClassNames {
     mainPanel?: string;
     sidebar?: string;
     loggedUserDetails?: string;
+    loggedUserSettingsTrigger?: string;
+    loggedUserSettingsDialog?: string;
+    loggedUserSettingsHeader?: string;
+    loggedUserSettingsContent?: string;
+    loggedUserSettingsAvatar?: string;
+    pushNotificationToggle?: string;
     channelList?: string;
     channelListItem?: string;
     channelListItemActive?: string;
@@ -788,6 +869,10 @@ interface ChatComponents {
     /** Case 1: replace the entire chat UI shell */
     ChatLayout?: React__default.ComponentType<ChatLayoutSlotProps>;
     LoggedUserDetails?: React__default.ComponentType<LoggedUserDetailsSlotProps>;
+    LoggedUserSettingsDialog?: React__default.ComponentType<LoggedUserSettingsDialogSlotProps>;
+    LoggedUserSettingsTrigger?: React__default.ComponentType<LoggedUserSettingsTriggerSlotProps>;
+    LoggedUserSettingsContent?: React__default.ComponentType<LoggedUserSettingsContentSlotProps>;
+    PushNotificationToggle?: React__default.ComponentType<PushNotificationToggleProps>;
     ChannelList?: React__default.ComponentType<ChannelListSlotProps>;
     ChannelListItem?: React__default.ComponentType<ChannelListItemSlotProps>;
     ChannelHeader?: React__default.ComponentType<ChannelHeaderSlotProps>;
@@ -875,13 +960,19 @@ interface ChatProps {
     queryParamApis?: ChatApiKey[];
     /** Different query params per API key */
     queryParamsByApi?: ChatQueryParamsByApi;
+    /**
+     * Per-service API versions after `/api`.
+     * Example: `{ default: 'v1', push: 'v2' }`.
+     * `default` is also parsed from `apiUrl` when it ends with `/v1`, `/v2`, etc.
+     */
+    apiVersions?: ChatApiVersionConfig;
     channelsData?: IChannel[];
     messagesData?: Record<string, IMessage[]>;
     onMessageReceived?: (message: any) => void;
     onSocketConnected?: (socketId: string) => void;
     onSocketError?: (error: string) => void;
 }
-declare const Chat: ({ children, onSendMessage, client, theme, uiConfig, themeColor, accessToken, loggedUserDetails, apiUrl, socketUrl, queryParams, queryParamApis, queryParamsByApi, channelsData, messagesData, onMessageReceived, onSocketConnected, onSocketError }: ChatProps) => React__default.JSX.Element;
+declare const Chat: ({ children, onSendMessage, client, theme, uiConfig, themeColor, accessToken, loggedUserDetails, apiUrl, socketUrl, queryParams, queryParamApis, queryParamsByApi, apiVersions, channelsData, messagesData, onMessageReceived, onSocketConnected, onSocketError }: ChatProps) => React__default.JSX.Element;
 
 type ChatColorMode = 'light' | 'dark';
 
@@ -966,6 +1057,8 @@ interface ChatMainProps {
      * pinnedMessages, starredMessages, searchMessages, searchMessagesContext
      */
     queryParamsByApi?: ChatQueryParamsByApi;
+    /** Per-service API versions after `/api` — e.g. `{ default: 'v1', push: 'v2' }`. */
+    apiVersions?: ChatApiVersionConfig;
     themeColor?: string;
     theme?: string;
     uiConfig?: UIConfig;
@@ -997,7 +1090,7 @@ interface ChatMainProps {
     /** Extra classes on the viewport wrapper */
     viewportClassName?: string;
 }
-declare const ChatMain: ({ clientId, loggedUserDetails, accessToken, apiUrl, socketUrl, queryParams, queryParamApis, queryParamsByApi, themeColor, theme, uiConfig, components, classNames, features, layout, colorMode, defaultColorMode, onColorModeChange, showColorModeToggle, locale, timeZone, hour12, defaultLocale, defaultTimeZone, defaultHour12, onDateTimePreferencesChange, showDateTimeSettings, error, info, onErrorDismiss, onInfoDismiss, viewportHeight, viewportClassName, }: ChatMainProps) => React__default.JSX.Element;
+declare const ChatMain: ({ clientId, loggedUserDetails, accessToken, apiUrl, socketUrl, queryParams, queryParamApis, queryParamsByApi, apiVersions, themeColor, theme, uiConfig, components, classNames, features, layout, colorMode, defaultColorMode, onColorModeChange, showColorModeToggle, locale, timeZone, hour12, defaultLocale, defaultTimeZone, defaultHour12, onDateTimePreferencesChange, showDateTimeSettings, error, info, onErrorDismiss, onInfoDismiss, viewportHeight, viewportClassName, }: ChatMainProps) => React__default.JSX.Element;
 
 declare const useStore: zustand.UseBoundStore<Omit<zustand.StoreApi<AppStoreState>, "setState" | "persist"> & {
     setState(partial: AppStoreState | Partial<AppStoreState> | ((state: AppStoreState) => AppStoreState | Partial<AppStoreState>), replace?: false | undefined): unknown;
@@ -1297,6 +1390,14 @@ interface LoggedUserDetailsProps {
 }
 declare const LoggedUserDetails: ({ loggedUserDetails, onUserSelect, isCreateModalOpen, setIsCreateModalOpen, searchQuery, setSearchQuery, }: LoggedUserDetailsProps) => React.JSX.Element;
 
+declare const LoggedUserSettingsDialog: ({ loggedUserDetails, open: controlledOpen, onOpenChange: controlledOnOpenChange, title, showProfile, showPushToggle, className, }: LoggedUserSettingsDialogSlotProps) => React.JSX.Element;
+
+declare const LoggedUserSettingsTrigger: ({ onClick, className, tooltip, ariaLabel, }: LoggedUserSettingsTriggerSlotProps) => React.JSX.Element;
+
+declare const LoggedUserSettingsContent: ({ user, title, showProfile, showPushToggle, className, }: LoggedUserSettingsContentSlotProps) => React.JSX.Element;
+
+declare const buildLoggedUserProfile: (loggedUserDetails: IUser | null | undefined) => IUser;
+
 interface ForwardModalProps {
     isOpen: boolean;
     onClose: () => void;
@@ -1354,7 +1455,7 @@ declare const useChatController: () => {
 declare function resolveApiUrl(apiUrl?: string): string;
 /**
  * Socket.io connects to the host origin with path `/connection`.
- * Prefer explicit `socketUrl`; otherwise derive from `apiUrl` by stripping `/api/v1`.
+ * Prefer explicit `socketUrl`; otherwise derive from `apiUrl` by stripping `/api/vN`.
  */
 declare function resolveSocketUrl(socketUrl?: string, apiUrl?: string): string;
 
@@ -1536,8 +1637,8 @@ declare function ChatAlertsProvider({ children, value, }: {
 declare function useChatAlerts(): ChatAlertsContextValue;
 
 declare const buttonVariants: (props?: ({
-    variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
-    size?: "xs" | "sm" | "lg" | "default" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
+    variant?: "default" | "link" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+    size?: "default" | "sm" | "xs" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare function Button({ className, variant, size, asChild, ...props }: React.ComponentProps<"button"> & VariantProps<typeof buttonVariants> & {
     asChild?: boolean;
@@ -1621,21 +1722,6 @@ interface UsePushNotifications extends PushNotificationsState {
  */
 declare const usePushNotifications: () => UsePushNotifications;
 
-interface PushNotificationToggleProps {
-    className?: string;
-    label?: string;
-    description?: string;
-}
-/**
- * Drop-in per-user push notification switch. Renders nothing while push is
- * unsupported by the browser, disabled by the workspace admins, or not yet
- * configured on the backend — users only ever see a switch they can use.
- *
- * On: prompts for browser permission and registers this device.
- * Off: unregisters this device.
- */
-declare const PushNotificationToggle: ({ className, label, description, }: PushNotificationToggleProps) => React.JSX.Element | null;
-
 interface ForegroundPushPayload {
     title?: string;
     body?: string;
@@ -1656,6 +1742,8 @@ declare const OPEN_CONVERSATION_EVENT = "realtimex:open-conversation";
 declare const NOTIFICATION_CLICK_SW_TYPE = "realtimex:notification-click";
 /** Must match the channel name in firebase-messaging-sw.js */
 declare const PUSH_BROADCAST_CHANNEL = "realtimex-push";
+/** Must match the cache name in firebase-messaging-sw.js */
+declare const PUSH_DATA_CACHE_NAME = "realtimex-push-data-v1";
 interface PushOpenRequest {
     conversationId: string;
     senderId?: string;
@@ -1678,10 +1766,13 @@ declare const requestOpenConversation: (conversationId: string, meta?: Record<st
 /** Open immediately when the chat store/controller is already mounted. */
 declare const buildChannelFromPushRequest: (request: PushOpenRequest, loggedUserId?: string, allUsers?: any[]) => IChannel;
 interface NotificationClickBridgeOptions {
-    /** Host chat route, default `/chat` */
+    /** Host chat route, default `/chat` (no query string — conversation id stays internal). */
     chatPath?: string;
-    onNavigate?: (conversationId: string, pathWithQuery: string) => void;
+    /** Navigate to the chat route when the user is not already on it. */
+    onNavigate?: (conversationId: string, chatPath: string) => void;
 }
+/** Cold-start fallback when the SW opened `/chat` without a URL query param. */
+declare const consumePendingOpenFromPushCache: () => Promise<PushOpenRequest | null>;
 declare const installNotificationClickBridge: (options?: NotificationClickBridgeOptions) => (() => void);
 
-export { type ActiveChannelMessagesSlotProps, type AdminsDrawerSlotProps, type AttachmentsDrawerSlotProps, type AvatarSlotProps, CHAT_API_KEYS, CHAT_GET_API_KEYS, Calendar, CalendarDayButton, Channel, type ChannelDetailsDrawerSlotProps, ChannelHeaderView as ChannelHeader, type ChannelHeaderSlotProps, ChannelListView as ChannelList, ChannelListItem, type ChannelListItemSlotProps, type ChannelListSlotProps, type ChannelMessageBoxSlotProps, Chat, type ChatActionModalSlotProps, ChatAlertsProvider, type ChatApiKey, ChatAvatar, type ChatCallContext, type ChatClassNames, type ChatColorMode, type ChatComponents, type ChatCustomizationConfig, ChatCustomizationProvider, ChatDateJumpMenu, type ChatDateTimePreferences, type ChatFeatures, type ChatGetApiKey, ChatLayout, type ChatLayoutConfig, type ChatLayoutSlotProps, ChatLocaleProvider, ChatMain, type ChatPanelAlertsSlotProps, type ChatQueryParams, type ChatQueryParamsByApi, ChatThemeProvider, ChatViewport, type ChatViewportHeight, DefaultChannelListItem, DefaultChatAvatar, DefaultChatLayout, ForegroundPushBridge, type ForegroundPushBridgeProps, type ForegroundPushPayload, ForwardModalView as ForwardModal, type ForwardModalSlotProps, HeaderCallActions, type HeaderCallActionsSlotProps, type HeaderLeftSideSlotProps, type HeaderRightSideSlotProps, type HeaderSearchOverlaySlotProps, type IAttachment, type IChannel, type IDMDelete, type IDMEditMessage, type IDMForward, type IDMMessage, type IDMPin, type IDMReaction, type IDMRead, type IDMStar, type IDMTyping, type IDMUnstar, type IMessage, type ISocketConfig, type JumpToPreset, LoggedUserDetails, type LoggedUserDetailsSlotProps, type MembersDrawerSlotProps, type MessageAttachmentsSlotProps, ChannelMessageBoxView as MessageInput, MessageItemView as MessageItem, type MessageItemSlotProps, ActiveChannelMessagesView as MessageList, type MessageReactionsSlotProps, type MessageReplySnippetSlotProps, type MessageStatusSlotProps, type MessageToolbarSlotProps, NOTIFICATION_CLICK_SW_TYPE, type NotificationClickBridgeOptions, OPEN_CONVERSATION_EVENT, PUSH_BROADCAST_CHANNEL, PUSH_CHANGED_EVENT, type PendingJump, type PermissionDrawerSlotProps, type PhoneCallButtonSlotProps, type PinnedMessagesDrawerSlotProps, type PushConfig, PushNotificationToggle, type PushNotificationToggleProps, type PushNotificationsState, type PushOpenRequest, type PushPreference, type StarredMessagesDrawerSlotProps, type UIConfig, type UsePushNotifications, type VideoCallButtonSlotProps, apiGetPushConfig, apiGetPushPreference, apiRegisterPushToken, apiRemovePushToken, apiUpdatePushPreference, buildChannelFromPushRequest, capitalizeFirst, clampJumpDate, consumePendingOpenConversation, consumePendingOpenRequest, ChatMain as default, defaultChatClassNames, defaultChatComponents, defaultChatFeatures, defaultChatLayoutConfig, disablePushOnThisDevice, downloadFile, enablePushOnThisDevice, getChatBaseUrl, getChatQueryParamApis, getChatQueryParams, getChatQueryParamsByApi, getChatSocketUrl, getFirstAndLastNameOneCharacter, getResponsiveWidth, getSocketConfig, getStoredPushToken, installNotificationClickBridge, isEmpty, isPushSupported, mergeChatCustomization, mergeChatLayoutConfig, onForegroundPush, packageDefaultComponents, peekPendingOpenConversation, peekPendingOpenRequest, requestOpenConversation, resolveApiUrl, resolveChatApiKey, resolveConversationIdFromPushData, resolveJumpDateBounds, resolveJumpPreset, resolveJumpStep, resolveSocketUrl, setChatAccessToken, setChatBaseURL, setChatClientId, setChatQueryParamApis, setChatQueryParams, setChatQueryParamsByApi, setChatSocketUrl, showNotification, smoothScrollToMessage, socketService, startOfLocalDay, toDateInputValue, uniqueList, useChatAlerts, useChatContext, useChatController, useChatCustomization, useChatCustomizationOptional, useChatFeatures, useChatFeaturesOptional, useChatLocale, useStore as useChatStore, useChatTheme, usePushNotifications };
+export { type ActiveChannelMessagesSlotProps, type AdminsDrawerSlotProps, type AttachmentsDrawerSlotProps, type AvatarSlotProps, CHAT_API_KEYS, CHAT_GET_API_KEYS, Calendar, CalendarDayButton, Channel, type ChannelDetailsDrawerSlotProps, ChannelHeaderView as ChannelHeader, type ChannelHeaderSlotProps, ChannelListView as ChannelList, ChannelListItem, type ChannelListItemSlotProps, type ChannelListSlotProps, type ChannelMessageBoxSlotProps, Chat, type ChatActionModalSlotProps, ChatAlertsProvider, type ChatApiKey, type ChatApiVersionConfig, type ChatApiVersionKey, ChatAvatar, type ChatCallContext, type ChatClassNames, type ChatColorMode, type ChatComponents, type ChatCustomizationConfig, ChatCustomizationProvider, ChatDateJumpMenu, type ChatDateTimePreferences, type ChatFeatures, type ChatGetApiKey, ChatLayout, type ChatLayoutConfig, type ChatLayoutSlotProps, ChatLocaleProvider, ChatMain, type ChatPanelAlertsSlotProps, type ChatQueryParams, type ChatQueryParamsByApi, ChatThemeProvider, ChatViewport, type ChatViewportHeight, DefaultChannelListItem, DefaultChatAvatar, DefaultChatLayout, ForegroundPushBridge, type ForegroundPushBridgeProps, type ForegroundPushPayload, ForwardModalView as ForwardModal, type ForwardModalSlotProps, HeaderCallActions, type HeaderCallActionsSlotProps, type HeaderLeftSideSlotProps, type HeaderRightSideSlotProps, type HeaderSearchOverlaySlotProps, type IAttachment, type IChannel, type IDMDelete, type IDMEditMessage, type IDMForward, type IDMMessage, type IDMPin, type IDMReaction, type IDMRead, type IDMStar, type IDMTyping, type IDMUnstar, type IMessage, type ISocketConfig, type JumpToPreset, LoggedUserDetails, type LoggedUserDetailsSlotProps, LoggedUserSettingsContent, type LoggedUserSettingsContentSlotProps, LoggedUserSettingsDialog, type LoggedUserSettingsDialogSlotProps, LoggedUserSettingsTrigger, type LoggedUserSettingsTriggerSlotProps, type MembersDrawerSlotProps, type MessageAttachmentsSlotProps, ChannelMessageBoxView as MessageInput, MessageItemView as MessageItem, type MessageItemSlotProps, ActiveChannelMessagesView as MessageList, type MessageReactionsSlotProps, type MessageReplySnippetSlotProps, type MessageStatusSlotProps, type MessageToolbarSlotProps, NOTIFICATION_CLICK_SW_TYPE, type NotificationClickBridgeOptions, OPEN_CONVERSATION_EVENT, PUSH_BROADCAST_CHANNEL, PUSH_CHANGED_EVENT, PUSH_DATA_CACHE_NAME, type PendingJump, type PermissionDrawerSlotProps, type PhoneCallButtonSlotProps, type PinnedMessagesDrawerSlotProps, type PushConfig, PushNotificationToggle, type PushNotificationToggleProps, type PushNotificationToggleRenderProps, type PushNotificationsState, type PushOpenRequest, type PushPreference, type StarredMessagesDrawerSlotProps, type UIConfig, type UsePushNotifications, type VideoCallButtonSlotProps, apiGetPushConfig, apiGetPushPreference, apiRegisterPushToken, apiRemovePushToken, apiUpdatePushPreference, buildChannelFromPushRequest, buildLoggedUserProfile, buildVersionedApiUrl, capitalizeFirst, clampJumpDate, consumePendingOpenConversation, consumePendingOpenFromPushCache, consumePendingOpenRequest, ChatMain as default, defaultChatClassNames, defaultChatComponents, defaultChatFeatures, defaultChatLayoutConfig, disablePushOnThisDevice, downloadFile, enablePushOnThisDevice, getChatApiVersions, getChatBaseUrl, getChatQueryParamApis, getChatQueryParams, getChatQueryParamsByApi, getChatSocketUrl, getFirstAndLastNameOneCharacter, getResponsiveWidth, getSocketConfig, getStoredPushToken, installNotificationClickBridge, isEmpty, isPushSupported, mergeChatCustomization, mergeChatLayoutConfig, onForegroundPush, packageDefaultComponents, peekPendingOpenConversation, peekPendingOpenRequest, requestOpenConversation, resolveApiRoot, resolveApiUrl, resolveChatApiKey, resolveConversationIdFromPushData, resolveJumpDateBounds, resolveJumpPreset, resolveJumpStep, resolveSocketUrl, setChatAccessToken, setChatApiVersions, setChatBaseURL, setChatClientId, setChatPushApiVersion, setChatQueryParamApis, setChatQueryParams, setChatQueryParamsByApi, setChatSocketUrl, showNotification, smoothScrollToMessage, socketService, startOfLocalDay, toDateInputValue, uniqueList, useChatAlerts, useChatContext, useChatController, useChatCustomization, useChatCustomizationOptional, useChatFeatures, useChatFeaturesOptional, useChatLocale, useStore as useChatStore, useChatTheme, usePushNotifications };

package/dist/index.d.ts

@@ -105,6 +105,27 @@ type ChatQueryParamsByApi = Partial<Record<Exclude<ChatApiKey, "all" | "get">, C
 /** Match an axios request URL to a named API key (first match wins). */
 declare function resolveChatApiKey(url?: string): Exclude<ChatApiKey, "all" | "get"> | null;
 
+type ChatApiVersionKey = "default" | "push";
+interface ChatApiVersionConfig {
+    /** Main chat REST API version (usually parsed from `setChatBaseURL`). */
+    default?: string;
+    /** Push notification API version. Default: `v2`. */
+    push?: string;
+}
+/**
+ * Strip a trailing `/v1`, `/v2`, … from the configured base URL.
+ * `https://realtimex.softwareco.com/api/v1` → `https://realtimex.softwareco.com/api`
+ */
+declare const resolveApiRoot: (baseUrl?: string) => string;
+declare const buildVersionedApiUrl: (path: string, options?: {
+    version?: string;
+    baseUrl?: string;
+    service?: ChatApiVersionKey;
+}) => string;
+declare const setChatApiVersions: (config?: ChatApiVersionConfig | null) => void;
+declare const getChatApiVersions: () => Readonly<Record<ChatApiVersionKey, string>>;
+declare const setChatPushApiVersion: (version: string) => void;
+
 declare const setChatClientId: (id: string) => void;
 declare const setChatAccessToken: (token: string) => void;
 declare const setChatBaseURL: (url: string) => void;
@@ -143,11 +164,52 @@ declare const getChatQueryParamsByApi: () => {
     presignedUrls?: Record<string, string> | undefined;
 };
 
+interface PushNotificationToggleRenderProps {
+    label: string;
+    description: string;
+    checked: boolean;
+    disabled: boolean;
+    loading: boolean;
+    permissionBlocked: boolean;
+    error: string | null;
+    onCheckedChange: (checked: boolean) => void;
+}
+interface PushNotificationToggleProps {
+    className?: string;
+    label?: string;
+    description?: string;
+    /** Build your own row UI while keeping package push logic. */
+    children?: (props: PushNotificationToggleRenderProps) => ReactNode;
+}
+/**
+ * Drop-in per-user push notification switch. Renders nothing while push is
+ * unsupported by the browser, disabled by the workspace admins, or not yet
+ * configured on the backend — users only ever see a switch they can use.
+ *
+ * On: prompts for browser permission and registers this device.
+ * Off: unregisters this device.
+ */
+declare const PushNotificationToggle: ({ className, label, description, children, }: PushNotificationToggleProps) => React.JSX.Element | null;
+
 interface ChatForwardItem {
     message: IMessage;
     attachmentId?: string;
 }
 
+interface IUser {
+    _id: string;
+    id?: string;
+    name: string;
+    email: string;
+    role: string;
+    isActive: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+    image?: string;
+    refreshToken?: string;
+    isOnline?: boolean;
+}
+
 interface ChatLayoutConfig {
     /** Sidebar with profile + conversation list */
     sidebar?: boolean;
@@ -167,20 +229,6 @@ interface ChatLayoutConfig {
 declare const defaultChatLayoutConfig: Required<ChatLayoutConfig>;
 declare const mergeChatLayoutConfig: (config?: ChatLayoutConfig) => Required<ChatLayoutConfig>;
 
-interface IUser {
-    _id: string;
-    id?: string;
-    name: string;
-    email: string;
-    role: string;
-    isActive: boolean;
-    createdAt: Date;
-    updatedAt: Date;
-    image?: string;
-    refreshToken?: string;
-    isOnline?: boolean;
-}
-
 type SocketStatus = "idle" | "connecting" | "connected" | "disconnected" | "error";
 interface AuthState {
     loggedUserDetails: IUser | null;
@@ -548,6 +596,33 @@ interface LoggedUserDetailsSlotProps {
     searchQuery?: string;
     setSearchQuery?: (val: string) => void;
 }
+/** Full settings button + modal (replace for a completely custom account settings UI). */
+interface LoggedUserSettingsDialogSlotProps {
+    loggedUserDetails: any;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    title?: string;
+    showProfile?: boolean;
+    showPushToggle?: boolean;
+    className?: string;
+}
+/** Settings gear button only — used when customizing the dialog shell. */
+interface LoggedUserSettingsTriggerSlotProps {
+    onClick: () => void;
+    className?: string;
+    tooltip?: string;
+    ariaLabel?: string;
+}
+/** Modal body — profile, push toggle, or your own settings rows. */
+interface LoggedUserSettingsContentSlotProps {
+    loggedUserDetails: any;
+    user: IUser;
+    onClose?: () => void;
+    title?: string;
+    showProfile?: boolean;
+    showPushToggle?: boolean;
+    className?: string;
+}
 interface ActiveChannelMessagesSlotProps {
     activeChannel: IChannel | null;
     loggedUserId?: string;
@@ -758,6 +833,12 @@ interface ChatClassNames {
     mainPanel?: string;
     sidebar?: string;
     loggedUserDetails?: string;
+    loggedUserSettingsTrigger?: string;
+    loggedUserSettingsDialog?: string;
+    loggedUserSettingsHeader?: string;
+    loggedUserSettingsContent?: string;
+    loggedUserSettingsAvatar?: string;
+    pushNotificationToggle?: string;
     channelList?: string;
     channelListItem?: string;
     channelListItemActive?: string;
@@ -788,6 +869,10 @@ interface ChatComponents {
     /** Case 1: replace the entire chat UI shell */
     ChatLayout?: React__default.ComponentType<ChatLayoutSlotProps>;
     LoggedUserDetails?: React__default.ComponentType<LoggedUserDetailsSlotProps>;
+    LoggedUserSettingsDialog?: React__default.ComponentType<LoggedUserSettingsDialogSlotProps>;
+    LoggedUserSettingsTrigger?: React__default.ComponentType<LoggedUserSettingsTriggerSlotProps>;
+    LoggedUserSettingsContent?: React__default.ComponentType<LoggedUserSettingsContentSlotProps>;
+    PushNotificationToggle?: React__default.ComponentType<PushNotificationToggleProps>;
     ChannelList?: React__default.ComponentType<ChannelListSlotProps>;
     ChannelListItem?: React__default.ComponentType<ChannelListItemSlotProps>;
     ChannelHeader?: React__default.ComponentType<ChannelHeaderSlotProps>;
@@ -875,13 +960,19 @@ interface ChatProps {
     queryParamApis?: ChatApiKey[];
     /** Different query params per API key */
     queryParamsByApi?: ChatQueryParamsByApi;
+    /**
+     * Per-service API versions after `/api`.
+     * Example: `{ default: 'v1', push: 'v2' }`.
+     * `default` is also parsed from `apiUrl` when it ends with `/v1`, `/v2`, etc.
+     */
+    apiVersions?: ChatApiVersionConfig;
     channelsData?: IChannel[];
     messagesData?: Record<string, IMessage[]>;
     onMessageReceived?: (message: any) => void;
     onSocketConnected?: (socketId: string) => void;
     onSocketError?: (error: string) => void;
 }
-declare const Chat: ({ children, onSendMessage, client, theme, uiConfig, themeColor, accessToken, loggedUserDetails, apiUrl, socketUrl, queryParams, queryParamApis, queryParamsByApi, channelsData, messagesData, onMessageReceived, onSocketConnected, onSocketError }: ChatProps) => React__default.JSX.Element;
+declare const Chat: ({ children, onSendMessage, client, theme, uiConfig, themeColor, accessToken, loggedUserDetails, apiUrl, socketUrl, queryParams, queryParamApis, queryParamsByApi, apiVersions, channelsData, messagesData, onMessageReceived, onSocketConnected, onSocketError }: ChatProps) => React__default.JSX.Element;
 
 type ChatColorMode = 'light' | 'dark';
 
@@ -966,6 +1057,8 @@ interface ChatMainProps {
      * pinnedMessages, starredMessages, searchMessages, searchMessagesContext
      */
     queryParamsByApi?: ChatQueryParamsByApi;
+    /** Per-service API versions after `/api` — e.g. `{ default: 'v1', push: 'v2' }`. */
+    apiVersions?: ChatApiVersionConfig;
     themeColor?: string;
     theme?: string;
     uiConfig?: UIConfig;
@@ -997,7 +1090,7 @@ interface ChatMainProps {
     /** Extra classes on the viewport wrapper */
     viewportClassName?: string;
 }
-declare const ChatMain: ({ clientId, loggedUserDetails, accessToken, apiUrl, socketUrl, queryParams, queryParamApis, queryParamsByApi, themeColor, theme, uiConfig, components, classNames, features, layout, colorMode, defaultColorMode, onColorModeChange, showColorModeToggle, locale, timeZone, hour12, defaultLocale, defaultTimeZone, defaultHour12, onDateTimePreferencesChange, showDateTimeSettings, error, info, onErrorDismiss, onInfoDismiss, viewportHeight, viewportClassName, }: ChatMainProps) => React__default.JSX.Element;
+declare const ChatMain: ({ clientId, loggedUserDetails, accessToken, apiUrl, socketUrl, queryParams, queryParamApis, queryParamsByApi, apiVersions, themeColor, theme, uiConfig, components, classNames, features, layout, colorMode, defaultColorMode, onColorModeChange, showColorModeToggle, locale, timeZone, hour12, defaultLocale, defaultTimeZone, defaultHour12, onDateTimePreferencesChange, showDateTimeSettings, error, info, onErrorDismiss, onInfoDismiss, viewportHeight, viewportClassName, }: ChatMainProps) => React__default.JSX.Element;
 
 declare const useStore: zustand.UseBoundStore<Omit<zustand.StoreApi<AppStoreState>, "setState" | "persist"> & {
     setState(partial: AppStoreState | Partial<AppStoreState> | ((state: AppStoreState) => AppStoreState | Partial<AppStoreState>), replace?: false | undefined): unknown;
@@ -1297,6 +1390,14 @@ interface LoggedUserDetailsProps {
 }
 declare const LoggedUserDetails: ({ loggedUserDetails, onUserSelect, isCreateModalOpen, setIsCreateModalOpen, searchQuery, setSearchQuery, }: LoggedUserDetailsProps) => React.JSX.Element;
 
+declare const LoggedUserSettingsDialog: ({ loggedUserDetails, open: controlledOpen, onOpenChange: controlledOnOpenChange, title, showProfile, showPushToggle, className, }: LoggedUserSettingsDialogSlotProps) => React.JSX.Element;
+
+declare const LoggedUserSettingsTrigger: ({ onClick, className, tooltip, ariaLabel, }: LoggedUserSettingsTriggerSlotProps) => React.JSX.Element;
+
+declare const LoggedUserSettingsContent: ({ user, title, showProfile, showPushToggle, className, }: LoggedUserSettingsContentSlotProps) => React.JSX.Element;
+
+declare const buildLoggedUserProfile: (loggedUserDetails: IUser | null | undefined) => IUser;
+
 interface ForwardModalProps {
     isOpen: boolean;
     onClose: () => void;
@@ -1354,7 +1455,7 @@ declare const useChatController: () => {
 declare function resolveApiUrl(apiUrl?: string): string;
 /**
  * Socket.io connects to the host origin with path `/connection`.
- * Prefer explicit `socketUrl`; otherwise derive from `apiUrl` by stripping `/api/v1`.
+ * Prefer explicit `socketUrl`; otherwise derive from `apiUrl` by stripping `/api/vN`.
  */
 declare function resolveSocketUrl(socketUrl?: string, apiUrl?: string): string;
 
@@ -1536,8 +1637,8 @@ declare function ChatAlertsProvider({ children, value, }: {
 declare function useChatAlerts(): ChatAlertsContextValue;
 
 declare const buttonVariants: (props?: ({
-    variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
-    size?: "xs" | "sm" | "lg" | "default" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
+    variant?: "default" | "link" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+    size?: "default" | "sm" | "xs" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare function Button({ className, variant, size, asChild, ...props }: React.ComponentProps<"button"> & VariantProps<typeof buttonVariants> & {
     asChild?: boolean;
@@ -1621,21 +1722,6 @@ interface UsePushNotifications extends PushNotificationsState {
  */
 declare const usePushNotifications: () => UsePushNotifications;
 
-interface PushNotificationToggleProps {
-    className?: string;
-    label?: string;
-    description?: string;
-}
-/**
- * Drop-in per-user push notification switch. Renders nothing while push is
- * unsupported by the browser, disabled by the workspace admins, or not yet
- * configured on the backend — users only ever see a switch they can use.
- *
- * On: prompts for browser permission and registers this device.
- * Off: unregisters this device.
- */
-declare const PushNotificationToggle: ({ className, label, description, }: PushNotificationToggleProps) => React.JSX.Element | null;
-
 interface ForegroundPushPayload {
     title?: string;
     body?: string;
@@ -1656,6 +1742,8 @@ declare const OPEN_CONVERSATION_EVENT = "realtimex:open-conversation";
 declare const NOTIFICATION_CLICK_SW_TYPE = "realtimex:notification-click";
 /** Must match the channel name in firebase-messaging-sw.js */
 declare const PUSH_BROADCAST_CHANNEL = "realtimex-push";
+/** Must match the cache name in firebase-messaging-sw.js */
+declare const PUSH_DATA_CACHE_NAME = "realtimex-push-data-v1";
 interface PushOpenRequest {
     conversationId: string;
     senderId?: string;
@@ -1678,10 +1766,13 @@ declare const requestOpenConversation: (conversationId: string, meta?: Record<st
 /** Open immediately when the chat store/controller is already mounted. */
 declare const buildChannelFromPushRequest: (request: PushOpenRequest, loggedUserId?: string, allUsers?: any[]) => IChannel;
 interface NotificationClickBridgeOptions {
-    /** Host chat route, default `/chat` */
+    /** Host chat route, default `/chat` (no query string — conversation id stays internal). */
     chatPath?: string;
-    onNavigate?: (conversationId: string, pathWithQuery: string) => void;
+    /** Navigate to the chat route when the user is not already on it. */
+    onNavigate?: (conversationId: string, chatPath: string) => void;
 }
+/** Cold-start fallback when the SW opened `/chat` without a URL query param. */
+declare const consumePendingOpenFromPushCache: () => Promise<PushOpenRequest | null>;
 declare const installNotificationClickBridge: (options?: NotificationClickBridgeOptions) => (() => void);
 
-export { type ActiveChannelMessagesSlotProps, type AdminsDrawerSlotProps, type AttachmentsDrawerSlotProps, type AvatarSlotProps, CHAT_API_KEYS, CHAT_GET_API_KEYS, Calendar, CalendarDayButton, Channel, type ChannelDetailsDrawerSlotProps, ChannelHeaderView as ChannelHeader, type ChannelHeaderSlotProps, ChannelListView as ChannelList, ChannelListItem, type ChannelListItemSlotProps, type ChannelListSlotProps, type ChannelMessageBoxSlotProps, Chat, type ChatActionModalSlotProps, ChatAlertsProvider, type ChatApiKey, ChatAvatar, type ChatCallContext, type ChatClassNames, type ChatColorMode, type ChatComponents, type ChatCustomizationConfig, ChatCustomizationProvider, ChatDateJumpMenu, type ChatDateTimePreferences, type ChatFeatures, type ChatGetApiKey, ChatLayout, type ChatLayoutConfig, type ChatLayoutSlotProps, ChatLocaleProvider, ChatMain, type ChatPanelAlertsSlotProps, type ChatQueryParams, type ChatQueryParamsByApi, ChatThemeProvider, ChatViewport, type ChatViewportHeight, DefaultChannelListItem, DefaultChatAvatar, DefaultChatLayout, ForegroundPushBridge, type ForegroundPushBridgeProps, type ForegroundPushPayload, ForwardModalView as ForwardModal, type ForwardModalSlotProps, HeaderCallActions, type HeaderCallActionsSlotProps, type HeaderLeftSideSlotProps, type HeaderRightSideSlotProps, type HeaderSearchOverlaySlotProps, type IAttachment, type IChannel, type IDMDelete, type IDMEditMessage, type IDMForward, type IDMMessage, type IDMPin, type IDMReaction, type IDMRead, type IDMStar, type IDMTyping, type IDMUnstar, type IMessage, type ISocketConfig, type JumpToPreset, LoggedUserDetails, type LoggedUserDetailsSlotProps, type MembersDrawerSlotProps, type MessageAttachmentsSlotProps, ChannelMessageBoxView as MessageInput, MessageItemView as MessageItem, type MessageItemSlotProps, ActiveChannelMessagesView as MessageList, type MessageReactionsSlotProps, type MessageReplySnippetSlotProps, type MessageStatusSlotProps, type MessageToolbarSlotProps, NOTIFICATION_CLICK_SW_TYPE, type NotificationClickBridgeOptions, OPEN_CONVERSATION_EVENT, PUSH_BROADCAST_CHANNEL, PUSH_CHANGED_EVENT, type PendingJump, type PermissionDrawerSlotProps, type PhoneCallButtonSlotProps, type PinnedMessagesDrawerSlotProps, type PushConfig, PushNotificationToggle, type PushNotificationToggleProps, type PushNotificationsState, type PushOpenRequest, type PushPreference, type StarredMessagesDrawerSlotProps, type UIConfig, type UsePushNotifications, type VideoCallButtonSlotProps, apiGetPushConfig, apiGetPushPreference, apiRegisterPushToken, apiRemovePushToken, apiUpdatePushPreference, buildChannelFromPushRequest, capitalizeFirst, clampJumpDate, consumePendingOpenConversation, consumePendingOpenRequest, ChatMain as default, defaultChatClassNames, defaultChatComponents, defaultChatFeatures, defaultChatLayoutConfig, disablePushOnThisDevice, downloadFile, enablePushOnThisDevice, getChatBaseUrl, getChatQueryParamApis, getChatQueryParams, getChatQueryParamsByApi, getChatSocketUrl, getFirstAndLastNameOneCharacter, getResponsiveWidth, getSocketConfig, getStoredPushToken, installNotificationClickBridge, isEmpty, isPushSupported, mergeChatCustomization, mergeChatLayoutConfig, onForegroundPush, packageDefaultComponents, peekPendingOpenConversation, peekPendingOpenRequest, requestOpenConversation, resolveApiUrl, resolveChatApiKey, resolveConversationIdFromPushData, resolveJumpDateBounds, resolveJumpPreset, resolveJumpStep, resolveSocketUrl, setChatAccessToken, setChatBaseURL, setChatClientId, setChatQueryParamApis, setChatQueryParams, setChatQueryParamsByApi, setChatSocketUrl, showNotification, smoothScrollToMessage, socketService, startOfLocalDay, toDateInputValue, uniqueList, useChatAlerts, useChatContext, useChatController, useChatCustomization, useChatCustomizationOptional, useChatFeatures, useChatFeaturesOptional, useChatLocale, useStore as useChatStore, useChatTheme, usePushNotifications };
+export { type ActiveChannelMessagesSlotProps, type AdminsDrawerSlotProps, type AttachmentsDrawerSlotProps, type AvatarSlotProps, CHAT_API_KEYS, CHAT_GET_API_KEYS, Calendar, CalendarDayButton, Channel, type ChannelDetailsDrawerSlotProps, ChannelHeaderView as ChannelHeader, type ChannelHeaderSlotProps, ChannelListView as ChannelList, ChannelListItem, type ChannelListItemSlotProps, type ChannelListSlotProps, type ChannelMessageBoxSlotProps, Chat, type ChatActionModalSlotProps, ChatAlertsProvider, type ChatApiKey, type ChatApiVersionConfig, type ChatApiVersionKey, ChatAvatar, type ChatCallContext, type ChatClassNames, type ChatColorMode, type ChatComponents, type ChatCustomizationConfig, ChatCustomizationProvider, ChatDateJumpMenu, type ChatDateTimePreferences, type ChatFeatures, type ChatGetApiKey, ChatLayout, type ChatLayoutConfig, type ChatLayoutSlotProps, ChatLocaleProvider, ChatMain, type ChatPanelAlertsSlotProps, type ChatQueryParams, type ChatQueryParamsByApi, ChatThemeProvider, ChatViewport, type ChatViewportHeight, DefaultChannelListItem, DefaultChatAvatar, DefaultChatLayout, ForegroundPushBridge, type ForegroundPushBridgeProps, type ForegroundPushPayload, ForwardModalView as ForwardModal, type ForwardModalSlotProps, HeaderCallActions, type HeaderCallActionsSlotProps, type HeaderLeftSideSlotProps, type HeaderRightSideSlotProps, type HeaderSearchOverlaySlotProps, type IAttachment, type IChannel, type IDMDelete, type IDMEditMessage, type IDMForward, type IDMMessage, type IDMPin, type IDMReaction, type IDMRead, type IDMStar, type IDMTyping, type IDMUnstar, type IMessage, type ISocketConfig, type JumpToPreset, LoggedUserDetails, type LoggedUserDetailsSlotProps, LoggedUserSettingsContent, type LoggedUserSettingsContentSlotProps, LoggedUserSettingsDialog, type LoggedUserSettingsDialogSlotProps, LoggedUserSettingsTrigger, type LoggedUserSettingsTriggerSlotProps, type MembersDrawerSlotProps, type MessageAttachmentsSlotProps, ChannelMessageBoxView as MessageInput, MessageItemView as MessageItem, type MessageItemSlotProps, ActiveChannelMessagesView as MessageList, type MessageReactionsSlotProps, type MessageReplySnippetSlotProps, type MessageStatusSlotProps, type MessageToolbarSlotProps, NOTIFICATION_CLICK_SW_TYPE, type NotificationClickBridgeOptions, OPEN_CONVERSATION_EVENT, PUSH_BROADCAST_CHANNEL, PUSH_CHANGED_EVENT, PUSH_DATA_CACHE_NAME, type PendingJump, type PermissionDrawerSlotProps, type PhoneCallButtonSlotProps, type PinnedMessagesDrawerSlotProps, type PushConfig, PushNotificationToggle, type PushNotificationToggleProps, type PushNotificationToggleRenderProps, type PushNotificationsState, type PushOpenRequest, type PushPreference, type StarredMessagesDrawerSlotProps, type UIConfig, type UsePushNotifications, type VideoCallButtonSlotProps, apiGetPushConfig, apiGetPushPreference, apiRegisterPushToken, apiRemovePushToken, apiUpdatePushPreference, buildChannelFromPushRequest, buildLoggedUserProfile, buildVersionedApiUrl, capitalizeFirst, clampJumpDate, consumePendingOpenConversation, consumePendingOpenFromPushCache, consumePendingOpenRequest, ChatMain as default, defaultChatClassNames, defaultChatComponents, defaultChatFeatures, defaultChatLayoutConfig, disablePushOnThisDevice, downloadFile, enablePushOnThisDevice, getChatApiVersions, getChatBaseUrl, getChatQueryParamApis, getChatQueryParams, getChatQueryParamsByApi, getChatSocketUrl, getFirstAndLastNameOneCharacter, getResponsiveWidth, getSocketConfig, getStoredPushToken, installNotificationClickBridge, isEmpty, isPushSupported, mergeChatCustomization, mergeChatLayoutConfig, onForegroundPush, packageDefaultComponents, peekPendingOpenConversation, peekPendingOpenRequest, requestOpenConversation, resolveApiRoot, resolveApiUrl, resolveChatApiKey, resolveConversationIdFromPushData, resolveJumpDateBounds, resolveJumpPreset, resolveJumpStep, resolveSocketUrl, setChatAccessToken, setChatApiVersions, setChatBaseURL, setChatClientId, setChatPushApiVersion, setChatQueryParamApis, setChatQueryParams, setChatQueryParamsByApi, setChatSocketUrl, showNotification, smoothScrollToMessage, socketService, startOfLocalDay, toDateInputValue, uniqueList, useChatAlerts, useChatContext, useChatController, useChatCustomization, useChatCustomizationOptional, useChatFeatures, useChatFeaturesOptional, useChatLocale, useStore as useChatStore, useChatTheme, usePushNotifications };