@realtimexsco/live-chat 1.1.0 → 1.3.0

package/dist/index.d.mts

@@ -1,4 +1,5 @@
-import React from 'react';
+import * as React from 'react';
+import React__default, { ReactNode } from 'react';
 import * as zustand_middleware from 'zustand/middleware';
 import * as zustand from 'zustand';
 import { ManagerOptions, SocketOptions, Socket } from 'socket.io-client';
@@ -22,12 +23,14 @@ interface IChannel {
     starredCount?: number;
     isLeft?: boolean;
     isBlocked?: boolean;
+    email?: string;
 }
 interface IMessage {
     id: string;
     _id?: string;
     content: string;
     sender: string;
+    senderId?: string;
     receiver?: string;
     timestamp: string;
     isOwnMessage: boolean;
@@ -49,52 +52,45 @@ interface IMessageAttachment {
     url: string;
     type: "image" | "video" | "audio" | "file";
     name: string;
+    fileType?: string;
+    size?: number;
+    width?: number;
+    height?: number;
+    duration?: number;
+    caption?: string;
+    starredBy?: string[];
+    reactions?: any[];
+    isStarredByMe?: boolean;
+    isPinned?: boolean;
+    isDeletedForEveryone?: boolean;
+}
+/** Payload shape for dm_send / group_message_send socket events */
+interface ISocketMessageAttachment {
+    url: string;
+    filename: string;
+    fileType: string;
+    size?: number;
+    width?: number;
+    height?: number;
+    duration?: number;
+    uploadedAt?: string;
+    caption?: string;
 }
 interface IAttachment {
     id: string;
     file: File;
     previewUrl: string;
     type: "image" | "video" | "audio" | "file";
+    uploadStatus: "uploading" | "uploaded" | "error";
+    uploadError?: string;
+    caption?: string;
+    uploaded?: ISocketMessageAttachment;
 }
 
-interface UIConfig {
-    showSidebarAvatar?: boolean;
-    sidebarAvatarColor?: string;
-    showChannelDetails?: boolean;
-    messageDateFormat?: (date: string) => string;
-}
-interface ChatContextValue {
-    activeChannel: IChannel | null;
-    setActiveChannel: (channel: IChannel | null) => void;
-    onSendMessage?: (content: string, attachments: any[]) => void;
-    client?: any;
-    theme?: string;
-    uiConfig: UIConfig;
-    themeColor: string;
-    channelsData?: IChannel[];
-    messagesData?: Record<string, IMessage[]>;
-}
-declare const useChatContext: () => ChatContextValue;
-interface ChatProps {
-    children: React.ReactNode;
-    onSendMessage?: (content: string, attachments: any[]) => void;
-    client?: {
-        id: string;
-    };
-    theme?: string;
-    uiConfig?: UIConfig;
-    themeColor?: string;
-    accessToken?: string;
-    loggedUserDetails?: any;
-    apiUrl?: string;
-    socketUrl?: string;
-    channelsData?: IChannel[];
-    messagesData?: Record<string, IMessage[]>;
-    onMessageReceived?: (message: any) => void;
-    onSocketConnected?: (socketId: string) => void;
-    onSocketError?: (error: string) => void;
+interface ChatForwardItem {
+    message: IMessage;
+    attachmentId?: string;
 }
-declare const Chat: ({ children, onSendMessage, client, theme, uiConfig, themeColor, accessToken, loggedUserDetails, apiUrl, socketUrl, channelsData, messagesData, onMessageReceived, onSocketConnected, onSocketError }: ChatProps) => React.JSX.Element;
 
 interface ChatLayoutConfig {
     /** Sidebar with profile + conversation list */
@@ -115,28 +111,15 @@ interface ChatLayoutConfig {
 declare const defaultChatLayoutConfig: Required<ChatLayoutConfig>;
 declare const mergeChatLayoutConfig: (config?: ChatLayoutConfig) => Required<ChatLayoutConfig>;
 
-interface ChatMainProps {
-    clientId: string;
-    loggedUserDetails: any;
-    accessToken: string;
-    apiUrl?: string;
-    socketUrl?: string;
-    themeColor?: string;
-    theme?: string;
-    uiConfig?: UIConfig;
-    /** Control which sections render. Omit for full UI. */
-    layout?: ChatLayoutConfig;
-}
-declare const ChatMain: (props: ChatMainProps) => React.JSX.Element;
-
 interface IUser {
     _id: string;
+    id?: string;
     name: string;
     email: string;
     role: string;
     isActive: boolean;
-    createdAt: string | Date;
-    updatedAt: string | Date;
+    createdAt: Date;
+    updatedAt: Date;
     image?: string;
     refreshToken?: string;
     isOnline?: boolean;
@@ -149,7 +132,6 @@ interface AuthState {
     accessToken: string | null;
     tenantId: string | null;
     isTenant: boolean;
-    /** True only after client-user login + session setup completes */
     isSessionReady: boolean;
     setSession: (payload: {
         accessToken: string;
@@ -157,8 +139,8 @@ interface AuthState {
         tenantId?: string;
         isTenant?: boolean;
     }) => void;
-    setSessionReady: (ready: boolean) => void;
     clearSession: () => void;
+    setSessionReady: (ready: boolean) => void;
 }
 interface GroupPermissions {
     onlyAdminCanSendMessage: boolean;
@@ -176,6 +158,7 @@ interface IConversationInfo {
     groupName?: string;
     groupDescription?: string;
     image?: string;
+    groupImage?: string;
     groupAdmins: any[];
     createdAt: string;
     updatedAt: string;
@@ -201,12 +184,8 @@ interface SocketState {
     isFetchingAllUsers: boolean;
     isFetchingConversations: boolean;
     isFetchingMessages: boolean;
-    isFetchingMessagesByConv: Record<string, number>;
-    isFetchingInfo: Record<string, boolean>;
     conversationsPage: number;
     conversationsHasMore: boolean;
-    lastConversationsFetchKey: string | null;
-    sidebarConversationsSearchKey: string | null;
     lastDM: any | null;
     lastEditDM: any | null;
     lastDeleteDM: any | null;
@@ -219,6 +198,8 @@ interface SocketState {
     typingUsers: Record<string, any[]>;
     pinnedMessagesByConversation: Record<string, any[]>;
     starredMessagesByConversation: Record<string, any[]>;
+    isFetchingPinnedMessages: Record<string, boolean>;
+    isFetchingStarredMessages: Record<string, boolean>;
     messagePendingActions: Record<string, string[]>;
     messagesMetadata: Record<string, MessagesMetadata>;
     liveConversationCounts: Record<string, {
@@ -228,13 +209,14 @@ interface SocketState {
     isClearingChat: Record<string, boolean>;
     isDeletingConversation: Record<string, boolean>;
     conversationInfos: Record<string, IConversationInfo>;
+    isFetchingInfo: Record<string, boolean>;
     isSearchActive: boolean;
     searchedMessageId: string | null;
     activeConversationId: string | null;
-    appError: AppErrorState | null;
-    composerDisabledReason: string | null;
+    globalAppError: AppErrorState | null;
+    conversationErrors: Record<string, AppErrorState>;
+    composerDisabledByConversation: Record<string, string>;
     rateLimitResetAt: number;
-    activeChannel: IChannel | null;
     connectRequested: (config?: any) => void;
     disconnectRequested: () => void;
     setConnecting: () => void;
@@ -270,9 +252,8 @@ interface SocketState {
     receivedGroupMessage: (payload: any) => void;
     fetchMessages: (conversationId: string, limit?: number, cursor?: string | null) => Promise<void>;
     setActiveConversationId: (conversationId: string | null) => void;
-    setActiveChannel: (channel: IChannel | null) => void;
     handleAppError: (message: string) => void;
-    clearAppError: () => void;
+    clearAppError: (conversationId?: string | null) => void;
     setRateLimitResetAt: (resetAt: number) => void;
     receivedDM: (dm: any) => void;
     emitDmSend: (payload: any) => void;
@@ -395,6 +376,7 @@ interface SocketState {
         sender: string;
         targetConversationIds: string[];
         sourceConversationId?: string;
+        attachmentId?: string;
     }) => void;
     clearForwardPending: (messageId?: string) => void;
     emitConversationUpdate: (payload: {
@@ -405,14 +387,539 @@ interface SocketState {
         sender: string;
     }) => void;
     receivedGroupLeave: (payload: any) => void;
-    fetchSearchMessageContext: (messageId: string) => Promise<void>;
+    fetchSearchMessageContext: (messageId: string, options?: {
+        searchMode?: boolean;
+    }) => Promise<void>;
     setSearchActive: (active: boolean) => void;
     setSearchedMessageId: (messageId: string | null) => void;
-    toggleBlock: (userId: string, isBlocked: boolean) => void;
+    toggleBlock: (userId: string, isBlocked: boolean, conversationId?: string | null) => void;
 }
 interface AppStoreState extends SocketState, AuthState {
 }
 
+/** Context passed to phone / video call handlers */
+interface ChatCallContext {
+    activeChannel: IChannel;
+    conversationId: string | null;
+}
+/** Feature flags & callbacks — phone/video call, etc. */
+interface ChatFeatures {
+    /** Show voice call button in header (default: `true` for DMs) */
+    showPhoneCall?: boolean;
+    /** Show video call button in header (default: `true`) */
+    showVideoCall?: boolean;
+    /**
+     * When `true`, hide phone/video buttons in group chats.
+     * Default: `false` (buttons show in all chats).
+     */
+    hideCallActionsInGroupChats?: boolean;
+    /** Called when user taps voice call */
+    onPhoneCall?: (ctx: ChatCallContext) => void;
+    /** Called when user taps video call */
+    onVideoCall?: (ctx: ChatCallContext) => void;
+}
+declare const defaultChatFeatures: Required<Pick<ChatFeatures, 'showPhoneCall' | 'showVideoCall' | 'hideCallActionsInGroupChats'>>;
+interface AvatarSlotProps {
+    src?: string | null;
+    alt?: string;
+    name?: string;
+    fallback?: string;
+    id?: string;
+    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    showOnline?: boolean;
+    isOnline?: boolean;
+    className?: string;
+    fallbackClassName?: string;
+}
+interface MessageItemSlotProps {
+    isSender: boolean;
+    message: string;
+    createdAt: string;
+    attachments?: IMessageAttachment[];
+    messageId?: string;
+    receiver?: string;
+    isEdited?: boolean;
+    isDeletedForEveryone?: boolean;
+    reactions?: any[];
+    conversationId?: string;
+    onReply?: () => void;
+    onForward?: () => void;
+    replyTo?: any;
+    isPinned?: boolean;
+    isStarred?: boolean;
+    isForwarded?: boolean;
+    status?: 'sent' | 'delivered' | 'read';
+    isGroup?: boolean;
+    isSystemMessage?: boolean;
+    conversationInfo?: any;
+    isHighlighted?: boolean;
+    senderName?: string;
+    senderImage?: string;
+    showSenderName?: boolean;
+    showSenderLabel?: boolean;
+    senderAvatarImage?: string;
+    isGroupedWithPrev?: boolean;
+    isGroupedWithNext?: boolean;
+}
+interface ChannelHeaderSlotProps {
+    activeChannel: IChannel | null;
+    conversationId: string | null;
+    onBack?: () => void;
+}
+interface ChannelListSlotProps {
+    activeChannel: IChannel | null;
+    onChannelSelect: (channel: IChannel) => void;
+    onNewChatClick?: () => void;
+    debouncedSearch?: string;
+}
+interface ChannelListItemSlotProps {
+    channel: IChannel & {
+        isTyping?: boolean;
+        draftPreview?: string | null;
+        isOwnLastMessage?: boolean;
+        lastMessage?: IChannel['lastMessage'] & {
+            status?: 'sent' | 'delivered' | 'read';
+        };
+    };
+    isActive: boolean;
+    onSelect: (channel: IChannel) => void;
+}
+interface LoggedUserDetailsSlotProps {
+    loggedUserDetails: any;
+    onUserSelect?: (channel: IChannel) => void;
+    isCreateModalOpen?: boolean;
+    setIsCreateModalOpen?: (open: boolean) => void;
+    searchQuery?: string;
+    setSearchQuery?: (val: string) => void;
+}
+interface ActiveChannelMessagesSlotProps {
+    activeChannel: IChannel | null;
+    loggedUserId?: string;
+    conversationMessages?: any[];
+    localMessages?: IMessage[];
+    isLoading?: boolean;
+    conversationId?: string | null;
+    onReply?: (message: IMessage) => void;
+    onForward?: (message: IMessage) => void;
+    conversationInfo: IConversationInfo | null;
+}
+interface ChannelMessageBoxSlotProps {
+    activeChannel: IChannel | null;
+    conversationId: string | null;
+    onSendMessage?: (content: string, attachments: IAttachment[], replyTo?: IMessage | null) => void;
+    replyTo?: IMessage | null;
+    onCancelReply?: () => void;
+}
+interface ForwardModalSlotProps {
+    isOpen: boolean;
+    onClose: () => void;
+    items: ChatForwardItem[];
+    onForwardComplete?: (channel: IChannel) => void;
+}
+interface ChatPanelAlertsSlotProps {
+    className?: string;
+}
+/**
+ * Replace the entire chat shell. Custom layouts should call `useChatController()`
+ * for state, handlers, and message data.
+ */
+interface ChatLayoutSlotProps {
+    layout?: ChatLayoutConfig;
+    loggedUserDetails?: any;
+    themeColor?: string;
+    className?: string;
+    shellClassName?: string;
+}
+interface HeaderLeftSideSlotProps {
+    onBack?: () => void;
+    activeChannel: IChannel;
+    pinnedCount: number;
+    starredCount: number;
+    onOpenDetails: () => void;
+    onOpenPins: () => void;
+    onOpenStars: () => void;
+}
+interface HeaderRightSideSlotProps {
+    activeChannel: IChannel;
+    conversationId: string | null;
+    isAdmin: boolean;
+    canViewMembers: boolean;
+    onOpenSearch: () => void;
+    onOpenDetails: () => void;
+    onOpenPermissions: () => void;
+    onOpenMembers: () => void;
+    onOpenAdmins: () => void;
+    onOpenAttachments: () => void;
+    onOpenPins: () => void;
+    onOpenStars: () => void;
+    onOpenClearChat: () => void;
+    onOpenDeleteChannel: () => void;
+    onOpenLeaveGroup?: () => void;
+    onToggleBlock?: () => void;
+    isBlocked?: boolean;
+}
+interface HeaderCallActionsSlotProps {
+    activeChannel: IChannel;
+    conversationId: string | null;
+    showPhoneCall?: boolean;
+    showVideoCall?: boolean;
+    onPhoneCall?: () => void;
+    onVideoCall?: () => void;
+    className?: string;
+}
+interface PhoneCallButtonSlotProps {
+    activeChannel: IChannel;
+    conversationId: string | null;
+    onPhoneCall?: () => void;
+    className?: string;
+}
+interface VideoCallButtonSlotProps {
+    activeChannel: IChannel;
+    conversationId: string | null;
+    onVideoCall?: () => void;
+    className?: string;
+}
+interface HeaderSearchOverlaySlotProps {
+    searchQuery: string;
+    isSearching: boolean;
+    searchResults: any[];
+    onSelectResult: (result: any) => void;
+    hasMore: boolean;
+    isLoadingMore: boolean;
+    onLoadMore: () => void;
+}
+interface ChatActionModalSlotProps {
+    isOpen: boolean;
+    onOpenChange: (open: boolean) => void;
+    title: string;
+    description: string;
+    warningTitle: string;
+    warningDescription: string;
+    actionButtonText: string;
+    loadingText: string;
+    isLoading: boolean;
+    onAction: () => void;
+    type: 'clear' | 'delete' | 'block';
+}
+interface ChannelDetailsDrawerSlotProps {
+    isOpen: boolean;
+    onOpenChange: (open: boolean) => void;
+    activeChannel: IChannel;
+    conversationInfo: IConversationInfo | null;
+}
+interface MembersDrawerSlotProps {
+    isOpen: boolean;
+    onOpenChange: (open: boolean) => void;
+    conversationId: string | null;
+    conversationInfo: IConversationInfo | null;
+}
+interface AdminsDrawerSlotProps {
+    isOpen: boolean;
+    onOpenChange: (open: boolean) => void;
+    conversationId: string | null;
+    conversationInfo: IConversationInfo | null;
+}
+interface PermissionDrawerSlotProps {
+    isOpen: boolean;
+    onOpenChange: (open: boolean) => void;
+    conversationId: string | null;
+    conversationInfo: IConversationInfo | null;
+}
+interface AttachmentsDrawerSlotProps {
+    isOpen: boolean;
+    onOpenChange: (open: boolean) => void;
+}
+interface PinnedMessagesDrawerSlotProps {
+    isOpen: boolean;
+    onOpenChange: (open: boolean) => void;
+    pinnedMessages: any[];
+    loggedUserDetails: any;
+    conversationId: string | null;
+    activeChannel: IChannel;
+    loadingIds: Set<string>;
+    formatRelativeTime: (date: string) => string;
+    onUnpin: (messageId: string) => void;
+}
+interface StarredMessagesDrawerSlotProps {
+    isOpen: boolean;
+    onOpenChange: (open: boolean) => void;
+    starredMessages: any[];
+    loggedUserDetails: any;
+    conversationId: string | null;
+    activeChannel: IChannel;
+    loadingIds: Set<string>;
+    formatRelativeTime: (date: string) => string;
+    onUnstar: (messageId: string) => void;
+}
+interface MessageToolbarSlotProps {
+    isSender: boolean;
+    isRecent: boolean;
+    messageId: string;
+    isPinned?: boolean;
+    isStarred?: boolean;
+    isPinPending?: boolean;
+    isStarPending?: boolean;
+    isReactionOpen: boolean;
+    isDeleteOpen: boolean;
+    setIsReactionOpen: (val: boolean) => void;
+    setIsDeleteOpen: (val: boolean) => void;
+    onReply?: () => void;
+    onForward?: () => void;
+    onEdit: () => void;
+    onDelete: (deleteType: 'me' | 'everyone') => void;
+    onReactionClick: (emoji: any) => void;
+    onPinClick: () => void;
+    onStarClick: () => void;
+    canUnpin: boolean;
+    canEdit: boolean;
+}
+interface MessageStatusSlotProps {
+    status?: 'sent' | 'delivered' | 'read';
+    isPending?: boolean;
+    isGroup?: boolean;
+    className?: string;
+}
+interface MessageAttachmentsSlotProps {
+    attachments: IMessageAttachment[];
+    isDeletedForEveryone?: boolean;
+}
+interface MessageReactionsSlotProps {
+    groupedReactions: Record<string, number>;
+    reactions?: any[];
+    loggedUserId?: string;
+    isSender: boolean;
+    isDeletedForEveryone?: boolean;
+    onReactionClick: (emoji: string) => void;
+}
+interface MessageReplySnippetSlotProps {
+    replyTo: any;
+    isSender: boolean;
+    loggedUserDetails?: any;
+    allUsers?: any[];
+}
+interface ChatClassNames {
+    shell?: string;
+    mainPanel?: string;
+    sidebar?: string;
+    loggedUserDetails?: string;
+    channelList?: string;
+    channelListItem?: string;
+    channelListItemActive?: string;
+    channelHeader?: string;
+    headerLeft?: string;
+    headerRight?: string;
+    headerCallActions?: string;
+    phoneCallButton?: string;
+    videoCallButton?: string;
+    messageList?: string;
+    messageItem?: string;
+    messageBubble?: string;
+    messageBubbleSender?: string;
+    messageBubbleReceiver?: string;
+    messageInput?: string;
+    messageInputTextarea?: string;
+    avatar?: string;
+    avatarFallback?: string;
+    dateDivider?: string;
+    emptyState?: string;
+    forwardModal?: string;
+    chatPanelAlerts?: string;
+    drawer?: string;
+    drawerContent?: string;
+    searchOverlay?: string;
+}
+interface ChatComponents {
+    /** Case 1: replace the entire chat UI shell */
+    ChatLayout?: React__default.ComponentType<ChatLayoutSlotProps>;
+    LoggedUserDetails?: React__default.ComponentType<LoggedUserDetailsSlotProps>;
+    ChannelList?: React__default.ComponentType<ChannelListSlotProps>;
+    ChannelListItem?: React__default.ComponentType<ChannelListItemSlotProps>;
+    ChannelHeader?: React__default.ComponentType<ChannelHeaderSlotProps>;
+    HeaderLeftSide?: React__default.ComponentType<HeaderLeftSideSlotProps>;
+    HeaderRightSide?: React__default.ComponentType<HeaderRightSideSlotProps>;
+    HeaderCallActions?: React__default.ComponentType<HeaderCallActionsSlotProps>;
+    PhoneCallButton?: React__default.ComponentType<PhoneCallButtonSlotProps>;
+    VideoCallButton?: React__default.ComponentType<VideoCallButtonSlotProps>;
+    HeaderSearchOverlay?: React__default.ComponentType<HeaderSearchOverlaySlotProps>;
+    MessageList?: React__default.ComponentType<ActiveChannelMessagesSlotProps>;
+    MessageItem?: React__default.ComponentType<MessageItemSlotProps>;
+    MessageInput?: React__default.ComponentType<ChannelMessageBoxSlotProps>;
+    ForwardModal?: React__default.ComponentType<ForwardModalSlotProps>;
+    ChatPanelAlerts?: React__default.ComponentType<ChatPanelAlertsSlotProps>;
+    ChatActionModal?: React__default.ComponentType<ChatActionModalSlotProps>;
+    ChannelDetailsDrawer?: React__default.ComponentType<ChannelDetailsDrawerSlotProps>;
+    MembersDrawer?: React__default.ComponentType<MembersDrawerSlotProps>;
+    AdminsDrawer?: React__default.ComponentType<AdminsDrawerSlotProps>;
+    PermissionDrawer?: React__default.ComponentType<PermissionDrawerSlotProps>;
+    AttachmentsDrawer?: React__default.ComponentType<AttachmentsDrawerSlotProps>;
+    PinnedMessagesDrawer?: React__default.ComponentType<PinnedMessagesDrawerSlotProps>;
+    StarredMessagesDrawer?: React__default.ComponentType<StarredMessagesDrawerSlotProps>;
+    Avatar?: React__default.ComponentType<AvatarSlotProps>;
+    MessageToolbar?: React__default.ComponentType<MessageToolbarSlotProps>;
+    MessageStatus?: React__default.ComponentType<MessageStatusSlotProps>;
+    MessageAttachments?: React__default.ComponentType<MessageAttachmentsSlotProps>;
+    MessageReactions?: React__default.ComponentType<MessageReactionsSlotProps>;
+    MessageReplySnippet?: React__default.ComponentType<MessageReplySnippetSlotProps>;
+    ChatThemeToggle?: React__default.ComponentType<{
+        className?: string;
+    }>;
+    ChatDateTimeSettings?: React__default.ComponentType<Record<string, never>>;
+    ChatSocketStatus?: React__default.ComponentType<{
+        className?: string;
+    }>;
+}
+interface ChatCustomizationConfig {
+    components?: ChatComponents;
+    classNames?: ChatClassNames;
+    features?: ChatFeatures;
+}
+declare const defaultChatClassNames: ChatClassNames;
+declare const defaultChatComponents: ChatComponents;
+declare const mergeChatCustomization: (config?: ChatCustomizationConfig) => {
+    components: ChatComponents;
+    classNames: ChatClassNames;
+    features: ChatFeatures;
+};
+
+interface UIConfig extends ChatCustomizationConfig {
+    showSidebarAvatar?: boolean;
+    sidebarAvatarColor?: string;
+    showChannelDetails?: boolean;
+    messageDateFormat?: (date: string) => string;
+}
+interface ChatContextValue {
+    onSendMessage?: (content: string, attachments: any[]) => void;
+    client?: any;
+    theme?: string;
+    uiConfig: UIConfig;
+    themeColor: string;
+    channelsData?: IChannel[];
+    messagesData?: Record<string, IMessage[]>;
+}
+declare const useChatContext: () => ChatContextValue;
+interface ChatProps {
+    children: React__default.ReactNode;
+    onSendMessage?: (content: string, attachments: any[]) => void;
+    client?: {
+        id: string;
+    };
+    theme?: string;
+    uiConfig?: UIConfig;
+    themeColor?: string;
+    accessToken?: string;
+    loggedUserDetails?: any;
+    apiUrl: string;
+    socketUrl?: string;
+    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, channelsData, messagesData, onMessageReceived, onSocketConnected, onSocketError }: ChatProps) => React__default.JSX.Element;
+
+type ChatColorMode = 'light' | 'dark';
+
+interface ChatThemeContextValue {
+    colorMode: ChatColorMode;
+    isDark: boolean;
+    isThemeTransitionReady: boolean;
+    themeColor: string;
+    themeStyles: React__default.CSSProperties;
+    scopeClassName: string;
+    setColorMode: (mode: ChatColorMode) => void;
+    toggleColorMode: () => void;
+    showColorModeToggle: boolean;
+}
+interface ChatThemeProviderProps {
+    children: React__default.ReactNode;
+    /** Brand color — pass from host project, same as npm package usage */
+    themeColor: string;
+    /** Optional controlled light/dark — omit to use built-in toggle (default: light) */
+    colorMode?: ChatColorMode;
+    /** Default light/dark when uncontrolled. Defaults to `light`. */
+    defaultColorMode?: ChatColorMode;
+    onColorModeChange?: (mode: ChatColorMode) => void;
+    showColorModeToggle?: boolean;
+}
+declare const ChatThemeProvider: ({ children, themeColor, colorMode, defaultColorMode, onColorModeChange, showColorModeToggle, }: ChatThemeProviderProps) => React__default.JSX.Element;
+declare const useChatTheme: () => ChatThemeContextValue;
+
+interface ChatDateTimePreferences {
+    /** BCP 47 locale, e.g. "en-US", "en-GB". Defaults to browser locale. */
+    locale?: string;
+    /** IANA timezone, e.g. "America/New_York". Defaults to browser timezone. */
+    timeZone?: string;
+    /** `true` = 12-hour, `false` = 24-hour. Defaults to locale preference. */
+    hour12?: boolean;
+}
+declare function createChatDateTimeFormatters(prefs: ChatDateTimePreferences): {
+    prefs: ChatDateTimePreferences;
+    formatMessageTime: (input: Date | string | number) => string;
+    formatSidebarTime: (input: Date | string | number) => string;
+    formatDateDivider: (input: Date | string | number) => string;
+    formatShortDate: (input: Date | string | number) => string;
+    formatLongDate: (input: Date | string | number) => string;
+    formatSavedMessageDate: (dateStr?: string) => string;
+};
+type ChatDateTimeFormatters = ReturnType<typeof createChatDateTimeFormatters>;
+
+type ChatViewportHeight = "full" | "screen" | "auto" | (string & {});
+type ChatViewportProps = {
+    children: React__default.ReactNode;
+    className?: string;
+    /**
+     * Height strategy for the chat root.
+     * - `full` (default): fill parent (`h-full`) — parent must have a bounded height
+     * - `screen`: full viewport (`h-dvh`)
+     * - `auto`: no height class — use with `className` / `style.height`
+     * - any CSS length: e.g. `calc(100dvh - 4rem)` for admin shells with fixed header
+     */
+    height?: ChatViewportHeight;
+    style?: React__default.CSSProperties;
+};
+/** Bounded root wrapper — required for scroll + input to stay inside the chat panel */
+declare function ChatViewport({ children, className, height, style, }: ChatViewportProps): React__default.JSX.Element;
+
+interface ChatMainProps {
+    clientId: string;
+    loggedUserDetails: any;
+    accessToken: string;
+    apiUrl: string;
+    socketUrl?: string;
+    themeColor?: string;
+    theme?: string;
+    uiConfig?: UIConfig;
+    /** Replace any built-in component with your own */
+    components?: ChatComponents;
+    /** Override classNames per UI region */
+    classNames?: ChatClassNames;
+    /** Phone/video call and other feature callbacks */
+    features?: ChatFeatures;
+    layout?: ChatLayoutConfig;
+    colorMode?: ChatColorMode;
+    defaultColorMode?: ChatColorMode;
+    onColorModeChange?: (mode: ChatColorMode) => void;
+    showColorModeToggle?: boolean;
+    locale?: string;
+    timeZone?: string;
+    hour12?: boolean;
+    defaultLocale?: string;
+    defaultTimeZone?: string;
+    defaultHour12?: boolean;
+    onDateTimePreferencesChange?: (prefs: ChatDateTimePreferences) => void;
+    showDateTimeSettings?: boolean;
+    error?: string | null;
+    info?: string | null;
+    onErrorDismiss?: () => void;
+    onInfoDismiss?: () => void;
+    /** Outer viewport height — default `full` (parent must set height). Use `screen` or `calc(100dvh - 4rem)` in admin apps */
+    viewportHeight?: ChatViewportHeight;
+    /** Extra classes on the viewport wrapper */
+    viewportClassName?: string;
+}
+declare const ChatMain: ({ clientId, loggedUserDetails, accessToken, apiUrl, socketUrl, 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;
     setState(state: AppStoreState | ((state: AppStoreState) => AppStoreState), replace: true): unknown;
@@ -443,7 +950,10 @@ interface ISocketConfig {
     url: string;
     options: Partial<ManagerOptions & SocketOptions>;
 }
-declare const getSocketConfig: (accessToken: string, tenantId: string, apiBaseUrl?: string) => ISocketConfig;
+declare const getSocketConfig: (accessToken: string, tenantId: string, options?: {
+    apiUrl?: string;
+    socketUrl?: string;
+}) => ISocketConfig;
 
 declare class SocketService {
     private socket;
@@ -459,12 +969,14 @@ declare class SocketService {
         messageId: string;
         sender: string;
         receiver: string;
+        attachmentId?: string;
     }): void;
     emitDmDelete(payload: {
         messageId: string;
         sender: string;
         receiver: string;
-        deleteType: "me" | "everyone";
+        deleteType: 'me' | 'everyone';
+        attachmentId?: string;
     }): void;
     emitDmClearChat(payload: {
         conversationId: string;
@@ -526,6 +1038,9 @@ declare class SocketService {
         messageId: string;
         sender: string;
         targetConversationIds: string[];
+        receiver?: string;
+        conversationId?: string;
+        attachmentId?: string;
     }): void;
     emitGroupJoin(payload: {
         conversationId: string;
@@ -550,7 +1065,8 @@ declare class SocketService {
     emitGroupDelete(payload: {
         messageId: string;
         sender: string;
-        deleteType: "me" | "everyone";
+        deleteType: 'me' | 'everyone';
+        attachmentId?: string;
     }): void;
     emitGroupPin(payload: {
         conversationId: string;
@@ -578,6 +1094,9 @@ declare class SocketService {
         messageId: string;
         sender: string;
         targetConversationIds: string[];
+        conversationId?: string;
+        sourceConversationId?: string;
+        attachmentId?: string;
     }): void;
     emitConversationUpdate(payload: {
         conversationId: string;
@@ -591,8 +1110,8 @@ declare class SocketService {
 declare const socketService: SocketService;
 
 declare const Channel: ({ children }: {
-    children: React.ReactNode;
-}) => React.JSX.Element;
+    children: React__default.ReactNode;
+}) => React__default.JSX.Element;
 
 interface ChannelListProps {
     activeChannel: IChannel | null;
@@ -600,14 +1119,17 @@ interface ChannelListProps {
     onNewChatClick?: () => void;
     debouncedSearch?: string;
 }
-declare const ChannelList: ({ activeChannel, onChannelSelect, onNewChatClick, debouncedSearch }: ChannelListProps) => React.JSX.Element;
+
+declare const ChannelListView: ({ activeChannel, onChannelSelect, onNewChatClick, debouncedSearch }: ChannelListProps) => React.JSX.Element;
 
 interface ChannelHeaderProps {
     activeChannel: IChannel | null;
     conversationId: string | null;
     onBack?: () => void;
+    onActiveChannelPatch?: (patch: Partial<IChannel>) => void;
 }
-declare const ChannelHeader: ({ activeChannel, conversationId, onBack, }: ChannelHeaderProps) => React.JSX.Element | null;
+
+declare const ChannelHeaderView: (props: ChannelHeaderProps) => React.JSX.Element | null;
 
 interface ActiveChannelMessagesProps {
     activeChannel: IChannel | null;
@@ -618,72 +1140,69 @@ interface ActiveChannelMessagesProps {
     conversationId?: string | null;
     onReply?: (message: IMessage) => void;
     onForward?: (message: IMessage) => void;
+    onForwardItems?: (items: ChatForwardItem[]) => void;
+    onSelectionModeChange?: (active: boolean) => void;
     conversationInfo: IConversationInfo | null;
 }
-declare const ActiveChannelMessages: ({ activeChannel, loggedUserId, conversationMessages, localMessages, isLoading, conversationId, onReply, onForward, conversationInfo }: ActiveChannelMessagesProps) => React.JSX.Element;
+
+declare const ActiveChannelMessagesView: (props: ActiveChannelMessagesProps) => React.JSX.Element;
 
 interface ChannelMessageBoxProps {
     activeChannel: IChannel | null;
     conversationId: string | null;
-    onSendMessage?: (content: string, attachments: IAttachment[], replyTo?: IMessage | null) => void;
+    onSendMessage?: (content: string, attachments: ISocketMessageAttachment[], replyTo?: IMessage | null) => void;
     replyTo?: IMessage | null;
     onCancelReply?: () => void;
+    onActiveChannelPatch?: (patch: Partial<IChannel>) => void;
 }
-declare const ChannelMessageBox: ({ activeChannel, conversationId, onSendMessage, replyTo, onCancelReply }: ChannelMessageBoxProps) => React.JSX.Element | null;
+
+declare const ChannelMessageBoxView: (props: ChannelMessageBoxProps) => React__default.JSX.Element | null;
 
 interface LoggedUserDetailsProps {
-    loggedUserDetails?: any;
+    loggedUserDetails: any;
     onUserSelect?: (channel: IChannel) => void;
     isCreateModalOpen?: boolean;
     setIsCreateModalOpen?: (open: boolean) => void;
     searchQuery?: string;
     setSearchQuery?: (val: string) => void;
-    themeColor?: string;
 }
-declare const LoggedUserDetails: ({ loggedUserDetails: propsLoggedUserDetails, onUserSelect, isCreateModalOpen: propsIsCreateModalOpen, setIsCreateModalOpen: propsSetIsCreateModalOpen, searchQuery: propsSearchQuery, setSearchQuery: propsSetSearchQuery, themeColor: propsThemeColor, }: LoggedUserDetailsProps) => React.JSX.Element;
+declare const LoggedUserDetails: ({ loggedUserDetails, onUserSelect, isCreateModalOpen, setIsCreateModalOpen, searchQuery, setSearchQuery, }: LoggedUserDetailsProps) => React.JSX.Element;
 
 interface ForwardModalProps {
     isOpen: boolean;
     onClose: () => void;
-    message: IMessage | null;
+    items: ChatForwardItem[];
     onForwardComplete: (channel: IChannel) => void;
 }
-declare const ForwardModal: ({ isOpen, onClose, message, onForwardComplete }: ForwardModalProps) => React.JSX.Element | null;
 
-interface ChatLayoutProps {
-    /** Toggle which UI blocks are rendered */
-    layout?: ChatLayoutConfig;
-    /** Passed to LoggedUserDetails */
-    loggedUserDetails?: any;
-    themeColor?: string;
-    className?: string;
-    shellClassName?: string;
-}
+declare function ForwardModalView(props: ForwardModalProps): React.JSX.Element | null;
+
+type ChatLayoutProps = ChatLayoutSlotProps;
 /**
- * Composable chat shell — turn sections on/off via `layout`.
- *
- * @example Full UI (default)
- * `<ChatLayout />`
- *
- * @example Messages only (no sidebar, header, or input)
- * `<ChatLayout layout={{ sidebar: false, header: false, input: false }} />`
- *
- * @example Custom — import pieces individually instead:
- * `import { Channel, MessageList } from '@realtimexsco/live-chat'`
+ * Chat layout entry — renders `components.ChatLayout` when provided,
+ * otherwise the package default. Custom full-UI layouts should use
+ * `useChatController()` inside their component.
  */
-declare const ChatLayout: ({ layout, loggedUserDetails: loggedUserDetailsProp, themeColor, className, shellClassName, }: ChatLayoutProps) => React.JSX.Element;
+declare const ChatLayout: (props: ChatLayoutProps) => React__default.JSX.Element;
+
+type DefaultChatLayoutProps = ChatLayoutSlotProps;
+declare const DefaultChatLayout: ({ layout, loggedUserDetails: loggedUserDetailsProp, className, shellClassName, }: DefaultChatLayoutProps) => React__default.JSX.Element;
+
+declare function buildReplyTarget(message: IMessage, attachmentId?: string): IMessage;
+declare function buildForwardItem(message: IMessage, attachmentId?: string): ChatForwardItem;
 
 interface ChatControllerState {
-    replyTo: IMessage | null;
-    forwardMessage: IMessage | null;
-    isForwardModalOpen: boolean;
+    activeChannel: IChannel | null;
+    activeConversationId: string | null;
+    replyToMessage: IMessage | null;
+    forwardItems: ChatForwardItem[];
+    isMessageSelectionMode: boolean;
     searchQuery: string;
     debouncedSearch: string;
     isCreateModalOpen: boolean;
 }
 declare const useChatController: () => {
     activeChannel: IChannel | null;
-    setActiveChannel: (channel: IChannel | null) => void;
     conversationId: string | null;
     rateLimitResetAt: number;
     isFetchingMessages: boolean;
@@ -694,12 +1213,28 @@ declare const useChatController: () => {
     state: ChatControllerState;
     updateState: (updates: Partial<ChatControllerState>) => void;
     handleChannelSelect: (channel: IChannel) => void;
-    handleSendMessage: (content: string, attachments: IAttachment[], replyTo?: IMessage | null) => void;
+    handleSendMessage: (content: string, attachments: ISocketMessageAttachment[], replyTo?: IMessage | null) => void;
+    handleSelectionModeChange: (active: boolean) => void;
+    handleActiveChannelPatch: (patch: Partial<IChannel>) => void;
+    buildReplyTarget: typeof buildReplyTarget;
+    buildForwardItem: typeof buildForwardItem;
+    setActiveChannel: (channel: IChannel | null) => void;
 };
 
 declare const setChatClientId: (id: string) => void;
 declare const setChatAccessToken: (token: string) => void;
 declare const setChatBaseURL: (url: string) => void;
+declare const getChatBaseUrl: () => string;
+declare const setChatSocketUrl: (url: string) => void;
+declare const getChatSocketUrl: () => string;
+
+/** Normalize API base URL passed by the host app (must end with /api/v1). */
+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`.
+ */
+declare function resolveSocketUrl(socketUrl?: string, apiUrl?: string): string;
 
 type IDMMessage = {
     sender: string;
@@ -767,4 +1302,114 @@ declare function uniqueList<T extends Record<string, any>>(list: T[], key: keyof
 declare const capitalizeFirst: (str: string) => string;
 declare const getFirstAndLastNameOneCharacter: (name: string) => string;
 
-export { Channel, ChannelHeader, ChannelList, Chat, ChatLayout, type ChatLayoutConfig, ChatMain, ForwardModal, 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, LoggedUserDetails, ChannelMessageBox as MessageInput, ActiveChannelMessages as MessageList, type UIConfig, capitalizeFirst, ChatMain as default, defaultChatLayoutConfig, downloadFile, getFirstAndLastNameOneCharacter, getResponsiveWidth, getSocketConfig, isEmpty, mergeChatLayoutConfig, setChatAccessToken, setChatBaseURL, setChatClientId, showNotification, socketService, uniqueList, useChatContext, useChatController, useStore as useChatStore };
+interface ChatCustomizationContextValue {
+    components: ChatComponents;
+    classNames: ChatClassNames;
+    features: ChatFeatures;
+    slotClassName: (key: keyof ChatClassNames, defaultClassName?: string) => string | undefined;
+    resolveComponent: <P extends object>(slot: keyof ChatComponents, DefaultComponent: React__default.ComponentType<P>) => React__default.ComponentType<P>;
+}
+interface ChatCustomizationProviderProps {
+    children: React__default.ReactNode;
+    customization?: ChatCustomizationConfig;
+}
+declare const ChatCustomizationProvider: ({ children, customization, }: ChatCustomizationProviderProps) => React__default.JSX.Element;
+declare const useChatCustomization: () => ChatCustomizationContextValue;
+declare const useChatCustomizationOptional: () => ChatCustomizationContextValue;
+declare const useChatFeatures: () => ChatFeatures;
+declare const useChatFeaturesOptional: () => ChatFeatures;
+
+declare const DefaultChatAvatar: ({ src, alt, name, fallback, size, showOnline, isOnline, className, fallbackClassName, }: AvatarSlotProps) => React__default.JSX.Element;
+declare const ChatAvatar: (props: AvatarSlotProps) => React__default.JSX.Element;
+
+declare const DefaultChannelListItem: ({ channel, isActive, onSelect, }: ChannelListItemSlotProps) => React__default.JSX.Element;
+declare const ChannelListItem: (props: ChannelListItemSlotProps) => React__default.JSX.Element;
+
+declare const HeaderCallActions: (props: HeaderCallActionsSlotProps) => React__default.JSX.Element | null;
+
+/**
+ * Built-in components for every `ChatComponents` slot.
+ * Use as fallback when building custom wrappers: `withMyTheme(packageDefaultComponents.MessageItem)`.
+ */
+declare const packageDefaultComponents: ChatComponents;
+
+interface MessageItemProps {
+    isSender: boolean;
+    message: string;
+    createdAt: string;
+    attachments?: IMessageAttachment[];
+    messageId?: string;
+    receiver?: string;
+    isEdited?: boolean;
+    isDeletedForEveryone?: boolean;
+    reactions?: any[];
+    conversationId?: string;
+    onReply?: () => void;
+    onForward?: () => void;
+    onReplyClick?: (messageId: string) => void;
+    replyTo?: any;
+    isPinned?: boolean;
+    isStarred?: boolean;
+    isForwarded?: boolean;
+    status?: "sent" | "delivered" | "read";
+    isGroup?: boolean;
+    isSystemMessage?: boolean;
+    conversationInfo?: any;
+    isHighlighted?: boolean;
+    senderName?: string;
+    senderImage?: string;
+    showSenderName?: boolean;
+    showSenderLabel?: boolean;
+    senderAvatarImage?: string;
+    isGroupedWithPrev?: boolean;
+    isGroupedWithNext?: boolean;
+    selectionMode?: boolean;
+    selectedKeys?: Set<string>;
+    onToggleSelect?: () => void;
+    onToggleAttachmentSelect?: (attachmentId: string) => void;
+    onEnterSelectionMode?: (attachmentId?: string) => void;
+}
+
+declare function MessageItemView(props: MessageItemProps): React.JSX.Element;
+
+interface ChatDateTimePreferencesChange {
+    locale?: string;
+    timeZone?: string;
+    hour12?: boolean;
+}
+interface ChatLocaleContextValue extends ChatDateTimeFormatters {
+    locale?: string;
+    timeZone?: string;
+    hour12: boolean;
+    setLocale: (locale?: string) => void;
+    setTimeZone: (timeZone?: string) => void;
+    setHour12: (hour12: boolean) => void;
+    showDateTimeSettings: boolean;
+}
+interface ChatLocaleProviderProps {
+    children: React__default.ReactNode;
+    locale?: string;
+    timeZone?: string;
+    hour12?: boolean;
+    defaultLocale?: string;
+    defaultTimeZone?: string;
+    defaultHour12?: boolean;
+    onDateTimePreferencesChange?: (prefs: ChatDateTimePreferencesChange) => void;
+    showDateTimeSettings?: boolean;
+}
+declare const ChatLocaleProvider: ({ children, locale: controlledLocale, timeZone: controlledTimeZone, hour12: controlledHour12, defaultLocale, defaultTimeZone, defaultHour12, onDateTimePreferencesChange, showDateTimeSettings, }: ChatLocaleProviderProps) => React__default.JSX.Element;
+declare const useChatLocale: () => ChatLocaleContextValue;
+
+interface ChatAlertsContextValue {
+    error?: string | null;
+    info?: string | null;
+    onDismissError?: () => void;
+    onDismissInfo?: () => void;
+}
+declare function ChatAlertsProvider({ children, value, }: {
+    children: ReactNode;
+    value: ChatAlertsContextValue;
+}): React.JSX.Element;
+declare function useChatAlerts(): ChatAlertsContextValue;
+
+export { type ActiveChannelMessagesSlotProps, type AdminsDrawerSlotProps, type AttachmentsDrawerSlotProps, type AvatarSlotProps, Channel, type ChannelDetailsDrawerSlotProps, ChannelHeaderView as ChannelHeader, type ChannelHeaderSlotProps, ChannelListView as ChannelList, ChannelListItem, type ChannelListItemSlotProps, type ChannelListSlotProps, type ChannelMessageBoxSlotProps, Chat, type ChatActionModalSlotProps, ChatAlertsProvider, ChatAvatar, type ChatCallContext, type ChatClassNames, type ChatColorMode, type ChatComponents, type ChatCustomizationConfig, ChatCustomizationProvider, type ChatDateTimePreferences, type ChatFeatures, ChatLayout, type ChatLayoutConfig, type ChatLayoutSlotProps, ChatLocaleProvider, ChatMain, type ChatPanelAlertsSlotProps, ChatThemeProvider, ChatViewport, type ChatViewportHeight, DefaultChannelListItem, DefaultChatAvatar, DefaultChatLayout, 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, 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, type PermissionDrawerSlotProps, type PhoneCallButtonSlotProps, type PinnedMessagesDrawerSlotProps, type StarredMessagesDrawerSlotProps, type UIConfig, type VideoCallButtonSlotProps, capitalizeFirst, ChatMain as default, defaultChatClassNames, defaultChatComponents, defaultChatFeatures, defaultChatLayoutConfig, downloadFile, getChatBaseUrl, getChatSocketUrl, getFirstAndLastNameOneCharacter, getResponsiveWidth, getSocketConfig, isEmpty, mergeChatCustomization, mergeChatLayoutConfig, packageDefaultComponents, resolveApiUrl, resolveSocketUrl, setChatAccessToken, setChatBaseURL, setChatClientId, setChatSocketUrl, showNotification, socketService, uniqueList, useChatAlerts, useChatContext, useChatController, useChatCustomization, useChatCustomizationOptional, useChatFeatures, useChatFeaturesOptional, useChatLocale, useStore as useChatStore, useChatTheme };