@ermis-network/ermis-chat-react 1.0.7 → 1.0.9

package/dist/index.d.mts

@@ -220,6 +220,8 @@ type AvatarProps = {
     size?: number;
     /** Additional CSS class name */
     className?: string;
+    /** Disable opening the lightbox on click */
+    disableLightbox?: boolean;
 };
 type ChannelProps = {
     children: React.ReactNode;
@@ -259,6 +261,16 @@ type ChannelHeaderProps = {
     CallBadgeComponent?: React.ComponentType<{
         callType: string;
     }>;
+    /** Show online/offline indicator for direct friend channels (default: true) */
+    showOnlineStatus?: boolean;
+    /** I18n label for "Online" subtitle (default: "Online") */
+    onlineLabel?: string;
+    /** I18n label for "Offline" subtitle (default: "Offline") */
+    offlineLabel?: string;
+    /** Custom online indicator component (replaces the default dot + label) */
+    OnlineIndicatorComponent?: React.ComponentType<{
+        isOnline: boolean;
+    }>;
 };
 /** Data passed to a fully custom HeaderComponent */
 type ChannelHeaderData = {
@@ -338,6 +350,8 @@ type ChannelItemProps = {
     actionLabels?: ChannelActionLabels;
     /** Custom icons for default channel actions */
     actionIcons?: ChannelActionIcons;
+    /** Whether the other user in this direct channel is online (friend channels only) */
+    isOnline?: boolean;
 };
 type ChannelListProps = {
     filters?: ChannelFilters;
@@ -393,9 +407,13 @@ type ChannelListProps = {
     actionLabels?: ChannelActionLabels;
     /** Custom icons for default channel actions */
     actionIcons?: ChannelActionIcons;
+    /** Show online/offline indicator dots on channel item avatars for friend channels (default: true) */
+    showOnlineStatus?: boolean;
 };
 type AttachmentProps = {
     attachment: Attachment;
+    /** Click handler — when provided, attachment becomes clickable (opens lightbox) */
+    onClick?: () => void;
 };
 type MessageRendererProps = {
     message: FormatMessageResponse;
@@ -412,6 +430,18 @@ type DateSeparatorProps = {
 type JumpToLatestProps = {
     onClick: () => void;
 };
+type MediaLightboxItem = {
+    type: 'image' | 'video';
+    src: string;
+    alt?: string;
+    posterSrc?: string;
+};
+type MediaLightboxProps = {
+    items: MediaLightboxItem[];
+    initialIndex?: number;
+    isOpen: boolean;
+    onClose: () => void;
+};
 type MessageListProps = {
     /** Fully custom render for each message */
     renderMessage?: (message: FormatMessageResponse, isOwnMessage: boolean) => React.ReactNode;
@@ -459,6 +489,8 @@ type MessageListProps = {
     TypingIndicatorComponent?: React.ComponentType;
     /** Custom component for message reactions */
     MessageReactionsComponent?: React.ComponentType<MessageReactionsProps>;
+    /** Custom media lightbox component (replaces the default lightbox entirely) */
+    MediaLightboxComponent?: React.ComponentType<MediaLightboxProps>;
     /** I18n Labels */
     emptyTitle?: string;
     emptySubtitle?: string;
@@ -471,9 +503,21 @@ type MessageListProps = {
     pendingOverlaySubtitle?: string;
     pendingAcceptLabel?: string;
     pendingRejectLabel?: string;
+    /** I18n Label for skip button on direct messaging channels (default: "Skip") */
+    pendingSkipLabel?: string;
+    skippedOverlayTitle?: string;
+    skippedOverlaySubtitle?: string;
+    skippedAcceptLabel?: string;
     closedTopicOverlayTitle?: string;
     closedTopicOverlaySubtitle?: string;
     closedTopicReopenLabel?: string;
+    /** Custom component for pending invitee notification in direct channels */
+    PendingInviteeNotificationComponent?: React.ComponentType<{
+        inviteeName?: string;
+        label?: string;
+    }>;
+    /** I18n Label for pending invitee notification */
+    pendingInviteeLabel?: string | ((inviteeName?: string) => string);
 };
 type ReactionUser = {
     id: string;
@@ -1160,6 +1204,7 @@ type CreateChannelModalProps = {
     cancelButtonLabel?: string;
     createButtonLabel?: string;
     creatingButtonLabel?: string;
+    messageButtonLabel?: string;
     /** File upload configuration for group channel images */
     imageAccept?: string;
     maxImageSize?: number;
@@ -1250,6 +1295,38 @@ declare function useBlockedState(channel: Channel$1 | null | undefined, currentU
     isBlocked: boolean;
 };
 
+type OnlineStatus = 'online' | 'offline' | 'unknown';
+/**
+ * Hook that returns the online/offline status of a specific user.
+ *
+ * The status is determined by checking `channel.state.watchers` on the
+ * "friend" channel (direct channel where both members have `owner` role).
+ * Real-time updates are received via `user.watching.start` and
+ * `user.watching.stop` WebSocket events on that channel.
+ *
+ * Returns `'unknown'` if the user is not a friend (no qualifying channel found).
+ *
+ * @param userId   – The user ID to check the online status of.
+ * @param channels – The full list of loaded channels (from ChannelList).
+ */
+declare function useOnlineStatus(userId: string | undefined, channels: Channel$1[]): OnlineStatus;
+
+/**
+ * Bulk hook that returns a `Set<string>` of user IDs that are currently online.
+ *
+ * Only users who are "friends" (exist in a direct channel where both
+ * members have `owner` role) are tracked. The status is derived from
+ * `channel.state.watchers` and kept in sync via `user.watching.start`
+ * and `user.watching.stop` WebSocket events at the **client** level
+ * for efficiency (single subscription instead of N per-channel ones).
+ *
+ * Usage in ChannelList: `const onlineUsers = useOnlineUsers(channels);`
+ * Then check: `onlineUsers.has(userId)`.
+ *
+ * @param channels – The full list of loaded channels (from ChannelList).
+ */
+declare function useOnlineUsers(channels: Channel$1[]): Set<string>;
+
 /**
  * Hook that tracks whether the current user is in a 'pending' state for the given channel.
  */
@@ -1295,6 +1372,8 @@ declare const Channel: React$1.FC<ChannelProps>;
  * - `AvatarComponent` — replace the avatar
  * - `renderTitle(channel)` — fully custom title rendering
  * - `renderRight(channel)` — render content on the right side
+ * - `showOnlineStatus` — show online/offline dot for friend channels (default: true)
+ * - `OnlineIndicatorComponent` — replace the default indicator
  *
  * For a fully custom header, use `Channel`'s `HeaderComponent` prop instead.
  */
@@ -1381,6 +1460,79 @@ declare function replaceMentionsForPreview(text: string, message: FormatMessageR
     mentioned_all?: boolean;
 }, userMap: Record<string, string>, renderWrapper?: (userId: string, name: string) => string): string;
 
+/** Channel supports group features: roles, capabilities, settings, topics, edit, delete */
+declare function isGroupChannel(channel: Channel$1 | null | undefined): boolean;
+/** Channel is a direct (1-on-1) conversation: block/unblock, no roles */
+declare function isDirectChannel(channel: Channel$1 | null | undefined): boolean;
+/** Channel is a topic (sub-channel of a group channel) */
+declare function isTopicChannel(channel: Channel$1 | null | undefined): boolean;
+/** Channel is a public group that users can join without invite */
+declare function isPublicGroupChannel(channel: Channel$1 | null | undefined): boolean;
+/** The proxy "general" channel of a topics-enabled group */
+declare function isGeneralProxy(channel: Channel$1 | null | undefined): boolean;
+/** Channel has topics feature enabled */
+declare function hasTopicsEnabled(channel: Channel$1 | null | undefined): boolean;
+/** Whether blocked state is relevant for this channel type */
+declare function supportsBlocking(channel: Channel$1 | null | undefined): boolean;
+
+declare const CHANNEL_ROLES: {
+    readonly OWNER: "owner";
+    readonly MODERATOR: "moder";
+    readonly MEMBER: "member";
+    readonly PENDING: "pending";
+    readonly SKIPPED: "skipped";
+};
+type ChannelRole = typeof CHANNEL_ROLES[keyof typeof CHANNEL_ROLES] | string;
+/** Checks if the user is in a pending state */
+declare function isPendingMember(role?: string): boolean;
+/** Checks if the user is in a skipped state (skipped a direct message invite) */
+declare function isSkippedMember(role?: string): boolean;
+/** Checks if the user has management permissions (owner or moderator) */
+declare function canManageChannel(role?: string): boolean;
+/** Determines if the current user has the permission to remove a specific target member */
+declare function canRemoveTargetMember(currentUserRole?: string, targetRole?: string): boolean;
+/** Determines if the current user has the permission to ban a specific target member */
+declare function canBanTargetMember(currentUserRole?: string, targetRole?: string): boolean;
+/** Determines if the current user has the permission to promote a member to moderator */
+declare function canPromoteTargetMember(currentUserRole?: string, targetRole?: string): boolean;
+/** Determines if the current user has the permission to demote a moderator to simple member */
+declare function canDemoteTargetMember(currentUserRole?: string, targetRole?: string): boolean;
+/** Checks if the user is an owner of the channel */
+declare function isOwnerMember(role?: string): boolean;
+/**
+ * Checks if a direct channel represents a "friend" relationship:
+ * both members must have the 'owner' channel_role.
+ */
+declare function isFriendChannel(channel: Channel$1 | null | undefined, targetUserId: string, currentUserId: string): boolean;
+
+declare const MESSAGE_TYPES: {
+    readonly REGULAR: "regular";
+    readonly SYSTEM: "system";
+    readonly STICKER: "sticker";
+    readonly SIGNAL: "signal";
+    readonly ERROR: "error";
+};
+declare const ATTACHMENT_TYPES: {
+    readonly IMAGE: "image";
+    readonly VIDEO: "video";
+    readonly VOICE_RECORDING: "voiceRecording";
+    readonly LINK_PREVIEW: "linkPreview";
+    readonly FILE: "file";
+    readonly AUDIO: "audio";
+};
+type MessageType = (typeof MESSAGE_TYPES)[keyof typeof MESSAGE_TYPES] | string;
+type AttachmentType = (typeof ATTACHMENT_TYPES)[keyof typeof ATTACHMENT_TYPES] | string;
+declare function isSystemMessage(message: any): boolean;
+declare function isStickerMessage(message: any): boolean;
+declare function isRegularMessage(message: any): boolean;
+declare function isSignalMessage(message: any): boolean;
+declare function isImageAttachment(attachment: any): boolean;
+declare function isVideoAttachment(attachment: any): boolean;
+declare function isVoiceRecordingAttachment(attachment: any): boolean;
+declare function isLinkPreviewAttachment(attachment: any): boolean;
+declare function isImage(attachment: any): boolean;
+declare function isVideo(attachment: any): boolean;
+
 declare const MessageAttachment: React$1.FC<AttachmentProps>;
 declare const AttachmentList: React$1.FC<{
     attachments?: Attachment[];
@@ -1403,6 +1555,13 @@ declare const ErrorMessage: React$1.FC<MessageRendererProps>;
  */
 declare const defaultMessageRenderers: Record<MessageLabel, React$1.ComponentType<MessageRendererProps>>;
 
+/**
+ * MediaLightbox – full-screen overlay for viewing images & videos.
+ * Supports prev/next navigation, keyboard controls, and image zoom.
+ * Renders via React portal into document.body.
+ */
+declare const MediaLightbox: React$1.FC<MediaLightboxProps>;
+
 declare const MessageInput: React$1.FC<MessageInputProps>;
 
 /**
@@ -1583,4 +1742,4 @@ declare const ErmisCallProvider: React$1.FC<ErmisCallProviderProps>;
 
 declare const ErmisCallUI: React$1.FC<ErmisCallUIProps>;
 
-export { type AddMemberButtonProps, type AddMemberModalProps, type AddMemberUserItemProps, type AttachButtonProps, type AttachmentItem, AttachmentList, type AttachmentProps, Avatar, type AvatarProps, type CallContextValue, Channel, type ChannelAction, type ChannelActionsProps, ChannelHeader, type ChannelHeaderData, type ChannelHeaderProps, ChannelInfo, type ChannelInfoActionsProps, type ChannelInfoCoverProps, type ChannelInfoEmptyStateProps, type ChannelInfoFileItemProps, type ChannelInfoHeaderProps, type ChannelInfoLinkItemProps, type ChannelInfoMediaItemProps, type ChannelInfoMemberItemProps, type ChannelInfoProps, type ChannelInfoTabsProps, ChannelItem, type ChannelItemProps, ChannelList, type ChannelListProps, type ChannelProps, ChannelTopicGroup, type ChatContextValue, ChatProvider, type ChatProviderProps, CreateChannelModal, type CreateChannelModalProps, type DateSeparatorProps, DefaultChannelActions, DefaultChannelInfoActions, DefaultChannelInfoCover, DefaultChannelInfoHeader, DefaultChannelInfoTabs, Dropdown, type DropdownProps, type EmojiButtonProps, type EmojiPickerProps, type ErmisCallConnectedAudioProps, type ErmisCallConnectedVideoProps, ErmisCallContext, type ErmisCallControlsBarProps, type ErmisCallErrorProps, ErmisCallProvider, type ErmisCallProviderProps, type ErmisCallRingingProps, ErmisCallUI, type ErmisCallUIProps, ErrorMessage, type FilePreviewItem, FilesPreview, type FilesPreviewProps, type ForwardChannelItemProps, ForwardMessageModal, type ForwardMessageModalProps, type JumpToLatestProps, type LatestReaction, type MediaTab, type MentionMember, type MentionPayload, MentionSuggestions, type MentionSuggestionsProps, MessageActionsBox, type MessageActionsBoxProps, MessageAttachment, type MessageBubbleProps, MessageInput, type MessageInputProps, MessageItem, type MessageItemProps, type MessageListProps, MessageQuickReactions, MessageReactions, type MessageReactionsProps, type MessageRendererProps, Modal, type ModalProps, Panel, type PinnedMessageItemProps, PinnedMessages, type PinnedMessagesProps, PollMessage, QuotedMessagePreview, type QuotedMessagePreviewProps, type ReactionUser, RegularMessage, ReplyPreview, type ReplyPreviewProps, type SendButtonProps, SignalMessage, StickerMessage, SystemMessage, SystemMessageItem, type SystemMessageItemProps, type Theme, TopicModal, TypingIndicator, type TypingIndicatorProps, type TypingUser, type UseChannelMessagesOptions, type UseChannelReturn, type UseLoadMessagesOptions, type UseLoadMessagesReturn, type UseMentionsOptions, type UseMentionsReturn, type UseScrollToMessageOptions, type UseScrollToMessageReturn, UserPicker, type UserPickerItemProps, type UserPickerProps, type UserPickerSelectedBoxProps, type UserPickerUser, VirtualMessageList, closeAllDropdowns, computeDefaultActions, dedupMessages, defaultMessageRenderers, formatDateLabel, formatTime, getDateKey, getMessageUserId, replaceMentionsForPreview, useBannedState, useBlockedState, useCallContext, useChannel, useChannelListUpdates, useChannelMessages, useChannelRowUpdates, useChatClient, useLoadMessages, useMentions, useMessageActions, usePendingState, useScrollToMessage, useTypingIndicator };
+export { ATTACHMENT_TYPES, type AddMemberButtonProps, type AddMemberModalProps, type AddMemberUserItemProps, type AttachButtonProps, type AttachmentItem, AttachmentList, type AttachmentProps, type AttachmentType, Avatar, type AvatarProps, CHANNEL_ROLES, type CallContextValue, Channel, type ChannelAction, type ChannelActionsProps, ChannelHeader, type ChannelHeaderData, type ChannelHeaderProps, ChannelInfo, type ChannelInfoActionsProps, type ChannelInfoCoverProps, type ChannelInfoEmptyStateProps, type ChannelInfoFileItemProps, type ChannelInfoHeaderProps, type ChannelInfoLinkItemProps, type ChannelInfoMediaItemProps, type ChannelInfoMemberItemProps, type ChannelInfoProps, type ChannelInfoTabsProps, ChannelItem, type ChannelItemProps, ChannelList, type ChannelListProps, type ChannelProps, type ChannelRole, ChannelTopicGroup, type ChatContextValue, ChatProvider, type ChatProviderProps, CreateChannelModal, type CreateChannelModalProps, type DateSeparatorProps, DefaultChannelActions, DefaultChannelInfoActions, DefaultChannelInfoCover, DefaultChannelInfoHeader, DefaultChannelInfoTabs, Dropdown, type DropdownProps, type EmojiButtonProps, type EmojiPickerProps, type ErmisCallConnectedAudioProps, type ErmisCallConnectedVideoProps, ErmisCallContext, type ErmisCallControlsBarProps, type ErmisCallErrorProps, ErmisCallProvider, type ErmisCallProviderProps, type ErmisCallRingingProps, ErmisCallUI, type ErmisCallUIProps, ErrorMessage, type FilePreviewItem, FilesPreview, type FilesPreviewProps, type ForwardChannelItemProps, ForwardMessageModal, type ForwardMessageModalProps, type JumpToLatestProps, type LatestReaction, MESSAGE_TYPES, MediaLightbox, type MediaLightboxItem, type MediaLightboxProps, type MediaTab, type MentionMember, type MentionPayload, MentionSuggestions, type MentionSuggestionsProps, MessageActionsBox, type MessageActionsBoxProps, MessageAttachment, type MessageBubbleProps, MessageInput, type MessageInputProps, MessageItem, type MessageItemProps, type MessageListProps, MessageQuickReactions, MessageReactions, type MessageReactionsProps, type MessageRendererProps, type MessageType, Modal, type ModalProps, type OnlineStatus, Panel, type PinnedMessageItemProps, PinnedMessages, type PinnedMessagesProps, PollMessage, QuotedMessagePreview, type QuotedMessagePreviewProps, type ReactionUser, RegularMessage, ReplyPreview, type ReplyPreviewProps, type SendButtonProps, SignalMessage, StickerMessage, SystemMessage, SystemMessageItem, type SystemMessageItemProps, type Theme, TopicModal, TypingIndicator, type TypingIndicatorProps, type TypingUser, type UseChannelMessagesOptions, type UseChannelReturn, type UseLoadMessagesOptions, type UseLoadMessagesReturn, type UseMentionsOptions, type UseMentionsReturn, type UseScrollToMessageOptions, type UseScrollToMessageReturn, UserPicker, type UserPickerItemProps, type UserPickerProps, type UserPickerSelectedBoxProps, type UserPickerUser, VirtualMessageList, canBanTargetMember, canDemoteTargetMember, canManageChannel, canPromoteTargetMember, canRemoveTargetMember, closeAllDropdowns, computeDefaultActions, dedupMessages, defaultMessageRenderers, formatDateLabel, formatTime, getDateKey, getMessageUserId, hasTopicsEnabled, isDirectChannel, isFriendChannel, isGeneralProxy, isGroupChannel, isImage, isImageAttachment, isLinkPreviewAttachment, isOwnerMember, isPendingMember, isPublicGroupChannel, isRegularMessage, isSignalMessage, isSkippedMember, isStickerMessage, isSystemMessage, isTopicChannel, isVideo, isVideoAttachment, isVoiceRecordingAttachment, replaceMentionsForPreview, supportsBlocking, useBannedState, useBlockedState, useCallContext, useChannel, useChannelListUpdates, useChannelMessages, useChannelRowUpdates, useChatClient, useLoadMessages, useMentions, useMessageActions, useOnlineStatus, useOnlineUsers, usePendingState, useScrollToMessage, useTypingIndicator };

package/dist/index.d.ts

@@ -220,6 +220,8 @@ type AvatarProps = {
     size?: number;
     /** Additional CSS class name */
     className?: string;
+    /** Disable opening the lightbox on click */
+    disableLightbox?: boolean;
 };
 type ChannelProps = {
     children: React.ReactNode;
@@ -259,6 +261,16 @@ type ChannelHeaderProps = {
     CallBadgeComponent?: React.ComponentType<{
         callType: string;
     }>;
+    /** Show online/offline indicator for direct friend channels (default: true) */
+    showOnlineStatus?: boolean;
+    /** I18n label for "Online" subtitle (default: "Online") */
+    onlineLabel?: string;
+    /** I18n label for "Offline" subtitle (default: "Offline") */
+    offlineLabel?: string;
+    /** Custom online indicator component (replaces the default dot + label) */
+    OnlineIndicatorComponent?: React.ComponentType<{
+        isOnline: boolean;
+    }>;
 };
 /** Data passed to a fully custom HeaderComponent */
 type ChannelHeaderData = {
@@ -338,6 +350,8 @@ type ChannelItemProps = {
     actionLabels?: ChannelActionLabels;
     /** Custom icons for default channel actions */
     actionIcons?: ChannelActionIcons;
+    /** Whether the other user in this direct channel is online (friend channels only) */
+    isOnline?: boolean;
 };
 type ChannelListProps = {
     filters?: ChannelFilters;
@@ -393,9 +407,13 @@ type ChannelListProps = {
     actionLabels?: ChannelActionLabels;
     /** Custom icons for default channel actions */
     actionIcons?: ChannelActionIcons;
+    /** Show online/offline indicator dots on channel item avatars for friend channels (default: true) */
+    showOnlineStatus?: boolean;
 };
 type AttachmentProps = {
     attachment: Attachment;
+    /** Click handler — when provided, attachment becomes clickable (opens lightbox) */
+    onClick?: () => void;
 };
 type MessageRendererProps = {
     message: FormatMessageResponse;
@@ -412,6 +430,18 @@ type DateSeparatorProps = {
 type JumpToLatestProps = {
     onClick: () => void;
 };
+type MediaLightboxItem = {
+    type: 'image' | 'video';
+    src: string;
+    alt?: string;
+    posterSrc?: string;
+};
+type MediaLightboxProps = {
+    items: MediaLightboxItem[];
+    initialIndex?: number;
+    isOpen: boolean;
+    onClose: () => void;
+};
 type MessageListProps = {
     /** Fully custom render for each message */
     renderMessage?: (message: FormatMessageResponse, isOwnMessage: boolean) => React.ReactNode;
@@ -459,6 +489,8 @@ type MessageListProps = {
     TypingIndicatorComponent?: React.ComponentType;
     /** Custom component for message reactions */
     MessageReactionsComponent?: React.ComponentType<MessageReactionsProps>;
+    /** Custom media lightbox component (replaces the default lightbox entirely) */
+    MediaLightboxComponent?: React.ComponentType<MediaLightboxProps>;
     /** I18n Labels */
     emptyTitle?: string;
     emptySubtitle?: string;
@@ -471,9 +503,21 @@ type MessageListProps = {
     pendingOverlaySubtitle?: string;
     pendingAcceptLabel?: string;
     pendingRejectLabel?: string;
+    /** I18n Label for skip button on direct messaging channels (default: "Skip") */
+    pendingSkipLabel?: string;
+    skippedOverlayTitle?: string;
+    skippedOverlaySubtitle?: string;
+    skippedAcceptLabel?: string;
     closedTopicOverlayTitle?: string;
     closedTopicOverlaySubtitle?: string;
     closedTopicReopenLabel?: string;
+    /** Custom component for pending invitee notification in direct channels */
+    PendingInviteeNotificationComponent?: React.ComponentType<{
+        inviteeName?: string;
+        label?: string;
+    }>;
+    /** I18n Label for pending invitee notification */
+    pendingInviteeLabel?: string | ((inviteeName?: string) => string);
 };
 type ReactionUser = {
     id: string;
@@ -1160,6 +1204,7 @@ type CreateChannelModalProps = {
     cancelButtonLabel?: string;
     createButtonLabel?: string;
     creatingButtonLabel?: string;
+    messageButtonLabel?: string;
     /** File upload configuration for group channel images */
     imageAccept?: string;
     maxImageSize?: number;
@@ -1250,6 +1295,38 @@ declare function useBlockedState(channel: Channel$1 | null | undefined, currentU
     isBlocked: boolean;
 };
 
+type OnlineStatus = 'online' | 'offline' | 'unknown';
+/**
+ * Hook that returns the online/offline status of a specific user.
+ *
+ * The status is determined by checking `channel.state.watchers` on the
+ * "friend" channel (direct channel where both members have `owner` role).
+ * Real-time updates are received via `user.watching.start` and
+ * `user.watching.stop` WebSocket events on that channel.
+ *
+ * Returns `'unknown'` if the user is not a friend (no qualifying channel found).
+ *
+ * @param userId   – The user ID to check the online status of.
+ * @param channels – The full list of loaded channels (from ChannelList).
+ */
+declare function useOnlineStatus(userId: string | undefined, channels: Channel$1[]): OnlineStatus;
+
+/**
+ * Bulk hook that returns a `Set<string>` of user IDs that are currently online.
+ *
+ * Only users who are "friends" (exist in a direct channel where both
+ * members have `owner` role) are tracked. The status is derived from
+ * `channel.state.watchers` and kept in sync via `user.watching.start`
+ * and `user.watching.stop` WebSocket events at the **client** level
+ * for efficiency (single subscription instead of N per-channel ones).
+ *
+ * Usage in ChannelList: `const onlineUsers = useOnlineUsers(channels);`
+ * Then check: `onlineUsers.has(userId)`.
+ *
+ * @param channels – The full list of loaded channels (from ChannelList).
+ */
+declare function useOnlineUsers(channels: Channel$1[]): Set<string>;
+
 /**
  * Hook that tracks whether the current user is in a 'pending' state for the given channel.
  */
@@ -1295,6 +1372,8 @@ declare const Channel: React$1.FC<ChannelProps>;
  * - `AvatarComponent` — replace the avatar
  * - `renderTitle(channel)` — fully custom title rendering
  * - `renderRight(channel)` — render content on the right side
+ * - `showOnlineStatus` — show online/offline dot for friend channels (default: true)
+ * - `OnlineIndicatorComponent` — replace the default indicator
  *
  * For a fully custom header, use `Channel`'s `HeaderComponent` prop instead.
  */
@@ -1381,6 +1460,79 @@ declare function replaceMentionsForPreview(text: string, message: FormatMessageR
     mentioned_all?: boolean;
 }, userMap: Record<string, string>, renderWrapper?: (userId: string, name: string) => string): string;
 
+/** Channel supports group features: roles, capabilities, settings, topics, edit, delete */
+declare function isGroupChannel(channel: Channel$1 | null | undefined): boolean;
+/** Channel is a direct (1-on-1) conversation: block/unblock, no roles */
+declare function isDirectChannel(channel: Channel$1 | null | undefined): boolean;
+/** Channel is a topic (sub-channel of a group channel) */
+declare function isTopicChannel(channel: Channel$1 | null | undefined): boolean;
+/** Channel is a public group that users can join without invite */
+declare function isPublicGroupChannel(channel: Channel$1 | null | undefined): boolean;
+/** The proxy "general" channel of a topics-enabled group */
+declare function isGeneralProxy(channel: Channel$1 | null | undefined): boolean;
+/** Channel has topics feature enabled */
+declare function hasTopicsEnabled(channel: Channel$1 | null | undefined): boolean;
+/** Whether blocked state is relevant for this channel type */
+declare function supportsBlocking(channel: Channel$1 | null | undefined): boolean;
+
+declare const CHANNEL_ROLES: {
+    readonly OWNER: "owner";
+    readonly MODERATOR: "moder";
+    readonly MEMBER: "member";
+    readonly PENDING: "pending";
+    readonly SKIPPED: "skipped";
+};
+type ChannelRole = typeof CHANNEL_ROLES[keyof typeof CHANNEL_ROLES] | string;
+/** Checks if the user is in a pending state */
+declare function isPendingMember(role?: string): boolean;
+/** Checks if the user is in a skipped state (skipped a direct message invite) */
+declare function isSkippedMember(role?: string): boolean;
+/** Checks if the user has management permissions (owner or moderator) */
+declare function canManageChannel(role?: string): boolean;
+/** Determines if the current user has the permission to remove a specific target member */
+declare function canRemoveTargetMember(currentUserRole?: string, targetRole?: string): boolean;
+/** Determines if the current user has the permission to ban a specific target member */
+declare function canBanTargetMember(currentUserRole?: string, targetRole?: string): boolean;
+/** Determines if the current user has the permission to promote a member to moderator */
+declare function canPromoteTargetMember(currentUserRole?: string, targetRole?: string): boolean;
+/** Determines if the current user has the permission to demote a moderator to simple member */
+declare function canDemoteTargetMember(currentUserRole?: string, targetRole?: string): boolean;
+/** Checks if the user is an owner of the channel */
+declare function isOwnerMember(role?: string): boolean;
+/**
+ * Checks if a direct channel represents a "friend" relationship:
+ * both members must have the 'owner' channel_role.
+ */
+declare function isFriendChannel(channel: Channel$1 | null | undefined, targetUserId: string, currentUserId: string): boolean;
+
+declare const MESSAGE_TYPES: {
+    readonly REGULAR: "regular";
+    readonly SYSTEM: "system";
+    readonly STICKER: "sticker";
+    readonly SIGNAL: "signal";
+    readonly ERROR: "error";
+};
+declare const ATTACHMENT_TYPES: {
+    readonly IMAGE: "image";
+    readonly VIDEO: "video";
+    readonly VOICE_RECORDING: "voiceRecording";
+    readonly LINK_PREVIEW: "linkPreview";
+    readonly FILE: "file";
+    readonly AUDIO: "audio";
+};
+type MessageType = (typeof MESSAGE_TYPES)[keyof typeof MESSAGE_TYPES] | string;
+type AttachmentType = (typeof ATTACHMENT_TYPES)[keyof typeof ATTACHMENT_TYPES] | string;
+declare function isSystemMessage(message: any): boolean;
+declare function isStickerMessage(message: any): boolean;
+declare function isRegularMessage(message: any): boolean;
+declare function isSignalMessage(message: any): boolean;
+declare function isImageAttachment(attachment: any): boolean;
+declare function isVideoAttachment(attachment: any): boolean;
+declare function isVoiceRecordingAttachment(attachment: any): boolean;
+declare function isLinkPreviewAttachment(attachment: any): boolean;
+declare function isImage(attachment: any): boolean;
+declare function isVideo(attachment: any): boolean;
+
 declare const MessageAttachment: React$1.FC<AttachmentProps>;
 declare const AttachmentList: React$1.FC<{
     attachments?: Attachment[];
@@ -1403,6 +1555,13 @@ declare const ErrorMessage: React$1.FC<MessageRendererProps>;
  */
 declare const defaultMessageRenderers: Record<MessageLabel, React$1.ComponentType<MessageRendererProps>>;
 
+/**
+ * MediaLightbox – full-screen overlay for viewing images & videos.
+ * Supports prev/next navigation, keyboard controls, and image zoom.
+ * Renders via React portal into document.body.
+ */
+declare const MediaLightbox: React$1.FC<MediaLightboxProps>;
+
 declare const MessageInput: React$1.FC<MessageInputProps>;
 
 /**
@@ -1583,4 +1742,4 @@ declare const ErmisCallProvider: React$1.FC<ErmisCallProviderProps>;
 
 declare const ErmisCallUI: React$1.FC<ErmisCallUIProps>;
 
-export { type AddMemberButtonProps, type AddMemberModalProps, type AddMemberUserItemProps, type AttachButtonProps, type AttachmentItem, AttachmentList, type AttachmentProps, Avatar, type AvatarProps, type CallContextValue, Channel, type ChannelAction, type ChannelActionsProps, ChannelHeader, type ChannelHeaderData, type ChannelHeaderProps, ChannelInfo, type ChannelInfoActionsProps, type ChannelInfoCoverProps, type ChannelInfoEmptyStateProps, type ChannelInfoFileItemProps, type ChannelInfoHeaderProps, type ChannelInfoLinkItemProps, type ChannelInfoMediaItemProps, type ChannelInfoMemberItemProps, type ChannelInfoProps, type ChannelInfoTabsProps, ChannelItem, type ChannelItemProps, ChannelList, type ChannelListProps, type ChannelProps, ChannelTopicGroup, type ChatContextValue, ChatProvider, type ChatProviderProps, CreateChannelModal, type CreateChannelModalProps, type DateSeparatorProps, DefaultChannelActions, DefaultChannelInfoActions, DefaultChannelInfoCover, DefaultChannelInfoHeader, DefaultChannelInfoTabs, Dropdown, type DropdownProps, type EmojiButtonProps, type EmojiPickerProps, type ErmisCallConnectedAudioProps, type ErmisCallConnectedVideoProps, ErmisCallContext, type ErmisCallControlsBarProps, type ErmisCallErrorProps, ErmisCallProvider, type ErmisCallProviderProps, type ErmisCallRingingProps, ErmisCallUI, type ErmisCallUIProps, ErrorMessage, type FilePreviewItem, FilesPreview, type FilesPreviewProps, type ForwardChannelItemProps, ForwardMessageModal, type ForwardMessageModalProps, type JumpToLatestProps, type LatestReaction, type MediaTab, type MentionMember, type MentionPayload, MentionSuggestions, type MentionSuggestionsProps, MessageActionsBox, type MessageActionsBoxProps, MessageAttachment, type MessageBubbleProps, MessageInput, type MessageInputProps, MessageItem, type MessageItemProps, type MessageListProps, MessageQuickReactions, MessageReactions, type MessageReactionsProps, type MessageRendererProps, Modal, type ModalProps, Panel, type PinnedMessageItemProps, PinnedMessages, type PinnedMessagesProps, PollMessage, QuotedMessagePreview, type QuotedMessagePreviewProps, type ReactionUser, RegularMessage, ReplyPreview, type ReplyPreviewProps, type SendButtonProps, SignalMessage, StickerMessage, SystemMessage, SystemMessageItem, type SystemMessageItemProps, type Theme, TopicModal, TypingIndicator, type TypingIndicatorProps, type TypingUser, type UseChannelMessagesOptions, type UseChannelReturn, type UseLoadMessagesOptions, type UseLoadMessagesReturn, type UseMentionsOptions, type UseMentionsReturn, type UseScrollToMessageOptions, type UseScrollToMessageReturn, UserPicker, type UserPickerItemProps, type UserPickerProps, type UserPickerSelectedBoxProps, type UserPickerUser, VirtualMessageList, closeAllDropdowns, computeDefaultActions, dedupMessages, defaultMessageRenderers, formatDateLabel, formatTime, getDateKey, getMessageUserId, replaceMentionsForPreview, useBannedState, useBlockedState, useCallContext, useChannel, useChannelListUpdates, useChannelMessages, useChannelRowUpdates, useChatClient, useLoadMessages, useMentions, useMessageActions, usePendingState, useScrollToMessage, useTypingIndicator };
+export { ATTACHMENT_TYPES, type AddMemberButtonProps, type AddMemberModalProps, type AddMemberUserItemProps, type AttachButtonProps, type AttachmentItem, AttachmentList, type AttachmentProps, type AttachmentType, Avatar, type AvatarProps, CHANNEL_ROLES, type CallContextValue, Channel, type ChannelAction, type ChannelActionsProps, ChannelHeader, type ChannelHeaderData, type ChannelHeaderProps, ChannelInfo, type ChannelInfoActionsProps, type ChannelInfoCoverProps, type ChannelInfoEmptyStateProps, type ChannelInfoFileItemProps, type ChannelInfoHeaderProps, type ChannelInfoLinkItemProps, type ChannelInfoMediaItemProps, type ChannelInfoMemberItemProps, type ChannelInfoProps, type ChannelInfoTabsProps, ChannelItem, type ChannelItemProps, ChannelList, type ChannelListProps, type ChannelProps, type ChannelRole, ChannelTopicGroup, type ChatContextValue, ChatProvider, type ChatProviderProps, CreateChannelModal, type CreateChannelModalProps, type DateSeparatorProps, DefaultChannelActions, DefaultChannelInfoActions, DefaultChannelInfoCover, DefaultChannelInfoHeader, DefaultChannelInfoTabs, Dropdown, type DropdownProps, type EmojiButtonProps, type EmojiPickerProps, type ErmisCallConnectedAudioProps, type ErmisCallConnectedVideoProps, ErmisCallContext, type ErmisCallControlsBarProps, type ErmisCallErrorProps, ErmisCallProvider, type ErmisCallProviderProps, type ErmisCallRingingProps, ErmisCallUI, type ErmisCallUIProps, ErrorMessage, type FilePreviewItem, FilesPreview, type FilesPreviewProps, type ForwardChannelItemProps, ForwardMessageModal, type ForwardMessageModalProps, type JumpToLatestProps, type LatestReaction, MESSAGE_TYPES, MediaLightbox, type MediaLightboxItem, type MediaLightboxProps, type MediaTab, type MentionMember, type MentionPayload, MentionSuggestions, type MentionSuggestionsProps, MessageActionsBox, type MessageActionsBoxProps, MessageAttachment, type MessageBubbleProps, MessageInput, type MessageInputProps, MessageItem, type MessageItemProps, type MessageListProps, MessageQuickReactions, MessageReactions, type MessageReactionsProps, type MessageRendererProps, type MessageType, Modal, type ModalProps, type OnlineStatus, Panel, type PinnedMessageItemProps, PinnedMessages, type PinnedMessagesProps, PollMessage, QuotedMessagePreview, type QuotedMessagePreviewProps, type ReactionUser, RegularMessage, ReplyPreview, type ReplyPreviewProps, type SendButtonProps, SignalMessage, StickerMessage, SystemMessage, SystemMessageItem, type SystemMessageItemProps, type Theme, TopicModal, TypingIndicator, type TypingIndicatorProps, type TypingUser, type UseChannelMessagesOptions, type UseChannelReturn, type UseLoadMessagesOptions, type UseLoadMessagesReturn, type UseMentionsOptions, type UseMentionsReturn, type UseScrollToMessageOptions, type UseScrollToMessageReturn, UserPicker, type UserPickerItemProps, type UserPickerProps, type UserPickerSelectedBoxProps, type UserPickerUser, VirtualMessageList, canBanTargetMember, canDemoteTargetMember, canManageChannel, canPromoteTargetMember, canRemoveTargetMember, closeAllDropdowns, computeDefaultActions, dedupMessages, defaultMessageRenderers, formatDateLabel, formatTime, getDateKey, getMessageUserId, hasTopicsEnabled, isDirectChannel, isFriendChannel, isGeneralProxy, isGroupChannel, isImage, isImageAttachment, isLinkPreviewAttachment, isOwnerMember, isPendingMember, isPublicGroupChannel, isRegularMessage, isSignalMessage, isSkippedMember, isStickerMessage, isSystemMessage, isTopicChannel, isVideo, isVideoAttachment, isVoiceRecordingAttachment, replaceMentionsForPreview, supportsBlocking, useBannedState, useBlockedState, useCallContext, useChannel, useChannelListUpdates, useChannelMessages, useChannelRowUpdates, useChatClient, useLoadMessages, useMentions, useMessageActions, useOnlineStatus, useOnlineUsers, usePendingState, useScrollToMessage, useTypingIndicator };