easemob-chat-uikit 2.4.2 → 3.0.0

package/types/module/hooks/useSDK.d.ts

@@ -1,6 +1,16 @@
-import { ChatSDK } from '../SDK';
+import { ChatClient, ChatManager, ChatRoomManager, ChatThreadManager, ContactManager, GroupManager, PresenceManager, PushManager, UserInfoManager } from '../SDK';
 declare const useSDK: () => {
-    ChatSDK: import("easemob-websdk").EasemobChatStatic;
-    ChatSDKType: typeof ChatSDK;
+    ChatSDK: {
+        ChatClient: typeof ChatClient;
+        ChatManager: typeof ChatManager;
+        ChatRoomManager: typeof ChatRoomManager;
+        ChatThreadManager: typeof ChatThreadManager;
+        ContactManager: typeof ContactManager;
+        GroupManager: typeof GroupManager;
+        PresenceManager: typeof PresenceManager;
+        PushManager: typeof PushManager;
+        UserInfoManager: typeof UserInfoManager;
+    };
+    ChatSDKType: typeof import("easemob-websdk");
 };
 export { useSDK };

package/types/module/hooks/useThreadContext.d.ts

@@ -1,7 +1,7 @@
 declare const useThreadContext: () => {
     currentThread: import("..").CurrentThread;
     threadList: {
-        [key: string]: (import("easemob-websdk").EasemobChat.ChatThreadDetail & {
+        [key: string]: (import("easemob-websdk").ChatThreadSummary & {
             members?: string[] | undefined;
         })[];
     };
@@ -9,7 +9,9 @@ declare const useThreadContext: () => {
     setCurrentThread: (thread: import("..").CurrentThread) => void;
     setThreadVisible: (visible: boolean) => void;
     getGroupChatThreads: (parentId: string, cursor?: string | undefined) => Promise<string | null>;
-    getThreadMembers: (parentId: string, threadId: string, cursor?: string | undefined) => Promise<string[]>;
+    getThreadMembers: (parentId: string, threadId: string, cursor?: string | undefined) => Promise<string[] & {
+        cursor?: string | undefined;
+    }>;
     removeChatThreadMember: (parentId: string, threadId: string, userId: string) => any;
     getCurrentChatThreadDetail: (threadId: string) => Promise<void>;
 };

package/types/module/imageMessage/ImageMessage.d.ts

@@ -1,8 +1,9 @@
 import React from 'react';
 import { BaseMessageProps, renderUserProfileProps } from '../baseMessage';
 import type { ImageMessageType } from '../types/messageType';
+import type { ChatSDK } from 'module/SDK';
 export interface ImageMessageProps extends BaseMessageProps {
-    imageMessage: ImageMessageType;
+    imageMessage: ImageMessageType | ChatSDK.Message;
     prefix?: string;
     style?: React.CSSProperties;
     className?: string;
@@ -17,7 +18,7 @@ export interface ImageMessageProps extends BaseMessageProps {
         visible: boolean;
         imageUrl: string;
         onClose: () => void;
-        message: ImageMessageType;
+        message: ChatSDK.Message;
     }) => React.ReactNode;
 }
 export interface ImagePreviewProps {
@@ -27,7 +28,7 @@ export interface ImagePreviewProps {
     onCancel?: () => void;
 }
 export declare const ImagePreview: (props: ImagePreviewProps) => import("react/jsx-runtime").JSX.Element;
-declare const _default: ((props: ImageMessageProps) => import("react/jsx-runtime").JSX.Element) & {
+declare const _default: ((props: ImageMessageProps) => import("react/jsx-runtime").JSX.Element | null) & {
     displayName: string;
 };
 export default _default;

package/types/module/imageMessage/imageCache.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 获取图片的缓存 blob URL，如果未缓存则通过 fetch 获取并缓存
+ */
+export declare function getCachedImageUrl(url: string): string | undefined;
+export declare function fetchAndCacheImage(url: string): Promise<string>;

package/types/module/index.d.ts

@@ -42,8 +42,8 @@ import Chatroom from './chatroom';
 import ChatroomMember from './chatroomMember';
 import ChatroomMessage from './chatroomMessage';
 import CallKit from './callkit';
-import { CallKitProps, CallInfo, CallErrorCode, CallError } from './callkit';
+import { CallKitProps, CallInfo, CallErrorCode, CallError, CallKitRTCProvider, RTCTokenInfo, RTCUidUserIdMap } from './callkit';
 import { CallKitRef } from './callkit/types/index';
-export type { AudioMessageProps, BaseMessageProps, FileMessageProps, ImageMessageProps, ImagePreviewProps, NoticeMessageProps, TextMessageProps, VideoMessageProps, MessageStatusProps, CombinedMessageProps, PinnedMessageProps, RepliedMsgProps, UnsentRepliedMsgProps, ChatProps, MsgListProps, ConversationItemProps, ConversationListProps, ConversationData, MessageInputProps, MoreActionProps, RecorderProps, EmojiProps, SelectedControlsProps, SuggestListProps, TextareaProps, HeaderProps, EmptyProps, RecalledMessageProps, RootStore, InitConfig, MessageStore, Message, SelectedMessage, Typing, ConversationStore, AT_TYPE, Conversation, CurrentConversation, ById, AddressStore, MemberRole, MemberItem, GroupItem, AppUserInfo, ThreadStore, ThreadData, CurrentThread, ProviderProps, ContextProps, ThreadProps, UserProfileProps, BlocklistProps, ContactListProps, ContactDetailProps, GroupDetailProps, GroupMemberProps, UserCardMessageProps, UserSelectProps, CallKitProps, CallKitRef, CallInfo, CallErrorCode, CallError, MessageRenderContext, MessageRenderer, MessageType, };
+export type { AudioMessageProps, BaseMessageProps, FileMessageProps, ImageMessageProps, ImagePreviewProps, NoticeMessageProps, TextMessageProps, VideoMessageProps, MessageStatusProps, CombinedMessageProps, PinnedMessageProps, RepliedMsgProps, UnsentRepliedMsgProps, ChatProps, MsgListProps, ConversationItemProps, ConversationListProps, ConversationData, MessageInputProps, MoreActionProps, RecorderProps, EmojiProps, SelectedControlsProps, SuggestListProps, TextareaProps, HeaderProps, EmptyProps, RecalledMessageProps, RootStore, InitConfig, MessageStore, Message, SelectedMessage, Typing, ConversationStore, AT_TYPE, Conversation, CurrentConversation, ById, AddressStore, MemberRole, MemberItem, GroupItem, AppUserInfo, ThreadStore, ThreadData, CurrentThread, ProviderProps, ContextProps, ThreadProps, UserProfileProps, BlocklistProps, ContactListProps, ContactDetailProps, GroupDetailProps, GroupMemberProps, UserCardMessageProps, UserSelectProps, CallKitProps, CallKitRef, CallInfo, CallErrorCode, CallError, CallKitRTCProvider, RTCTokenInfo, RTCUidUserIdMap, MessageRenderContext, MessageRenderer, MessageType, };
 declare const UIKitProvider: import("react").NamedExoticComponent<ProviderProps>;
 export { AudioMessage, BaseMessage, FileMessage, ImageMessage, NoticeMessage, TextMessage, VideoMessage, CombinedMessage, PinnedMessage, RepliedMsg, UnsentRepliedMsg, MessageStatus, Chat, MessageList, ContactList, ConversationList, ConversationItem, MessageInput, Header, Empty, RecalledMessage, rootStore, RootContext, RootProvider, RootConsumer, Provider, UIKitProvider, Thread, UserProfile, Blocklist, useClient, useConversations, usePinnedMessage, useHistoryMessages, useSDK, useIsMobile, useScreen, useConversationContext, useChatContext, useAddressContext, useThreadContext, useChatroomContext, Chatroom, ChatroomMember, ChatroomMessage, ContactItem, ContactDetail, GroupDetail, GroupMember, UserCardMessage, UserSelect, CallKit, };

package/types/module/messageInput/MessageInput.d.ts

@@ -1,8 +1,9 @@
 import React, { ReactNode } from 'react';
 import { MoreActionProps } from './moreAction';
-import { ChatSDK } from '../SDK';
+import type { ChatSDK } from '../SDK';
 import { CurrentConversation } from '../store/ConversationStore';
 import { GiftKeyboardProps } from './gift/GiftKeyboard';
+import type { BeforeSendMessage } from './sendTypes';
 export type Actions = {
     name: string;
     visible: boolean;
@@ -24,9 +25,9 @@ export interface MessageInputProps {
     disabled?: boolean;
     isChatThread?: boolean;
     enabledMention?: boolean;
-    onSendMessage?: (message: ChatSDK.MessageBody) => void;
+    onSendMessage?: (message: ChatSDK.Message) => void;
     conversation?: CurrentConversation;
-    onBeforeSendMessage?: (message: ChatSDK.MessageBody) => Promise<CurrentConversation | void>;
+    onBeforeSendMessage?: BeforeSendMessage;
     giftKeyboardProps?: GiftKeyboardProps;
     onChange?: (value: string) => void;
     onFocus?: () => void;

package/types/module/messageInput/constants.d.ts

@@ -0,0 +1 @@
+export declare const AT_ALL = "ALL";

package/types/module/messageInput/gift/GiftKeyboard.d.ts

@@ -1,7 +1,8 @@
 import React, { ReactNode } from 'react';
-import { ChatSDK } from '../../SDK';
+import type { ChatSDK } from '../../SDK';
 import { CurrentConversation } from '../../store/ConversationStore';
 import giftConfig from './giftConfig';
+import type { BeforeSendMessage } from '../sendTypes';
 export interface GiftKeyboardProps {
     prefix?: string;
     className?: string;
@@ -12,11 +13,8 @@ export interface GiftKeyboardProps {
     onClick?: (e: React.MouseEvent<Element, MouseEvent>) => void;
     conversation?: CurrentConversation;
     gifts?: ReactNode[];
-    onSendMessage?: (message: ChatSDK.CustomMsgBody) => void;
-    onBeforeSendMessage?: (message: ChatSDK.MessageBody) => Promise<{
-        chatType: 'chatRoom';
-        conversationId: string;
-    } | void>;
+    onSendMessage?: (message: ChatSDK.Message) => void;
+    onBeforeSendMessage?: BeforeSendMessage;
     giftConfig?: typeof giftConfig;
     closeAfterClick?: boolean;
 }

package/types/module/messageInput/moreAction/MoreAction.d.ts

@@ -1,6 +1,6 @@
 import React, { ReactNode } from 'react';
-import { ChatSDK } from '../../SDK';
 import { CurrentConversation } from '../../store/ConversationStore';
+import type { BeforeSendMessage } from '../sendTypes';
 export interface MoreActionProps {
     style?: React.CSSProperties;
     className?: string;
@@ -14,7 +14,7 @@ export interface MoreActionProps {
     }>;
     conversation?: CurrentConversation;
     isChatThread?: boolean;
-    onBeforeSendMessage?: (message: ChatSDK.MessageBody) => Promise<CurrentConversation | void>;
+    onBeforeSendMessage?: BeforeSendMessage;
 }
 declare let MoreAction: (props: MoreActionProps) => import("react/jsx-runtime").JSX.Element;
 export { MoreAction };

package/types/module/messageInput/recorder/Recorder.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
-import { ChatSDK } from '../../SDK';
+import type { ChatSDK } from '../../SDK';
 import { CurrentConversation } from '../../store/ConversationStore';
+import type { BeforeSendMessage } from '../sendTypes';
 export interface RecorderProps {
     prefix?: string;
     className?: string;
@@ -10,9 +11,9 @@ export interface RecorderProps {
     cancelBtnShape?: 'circle' | 'square';
     onShow?: () => void;
     onHide?: () => void;
-    onSend?: (message: ChatSDK.MessageBody) => void;
+    onSend?: (message: ChatSDK.Message) => void;
     conversation?: CurrentConversation;
-    onBeforeSendMessage?: (message: ChatSDK.MessageBody) => Promise<CurrentConversation | void>;
+    onBeforeSendMessage?: BeforeSendMessage;
     isChatThread?: boolean;
     disabled?: boolean;
     disabledTitle?: string;

package/types/module/messageInput/selectedControls/SelectedControls.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { ChatSDK } from '../../SDK';
+import type { ChatSDK } from '../../SDK';
 import { CurrentConversation } from '../../store/ConversationStore';
 export interface SelectedControlsProps {
     prefix?: string;
@@ -7,7 +7,7 @@ export interface SelectedControlsProps {
     className?: string;
     onHide?: () => void;
     conversation?: CurrentConversation;
-    onSendMessage?: (message: ChatSDK.CombineMsgBody) => void;
+    onSendMessage?: (message: ChatSDK.Message) => void;
 }
 declare const SelectedControls: (props: SelectedControlsProps) => import("react/jsx-runtime").JSX.Element;
 export { SelectedControls };

package/types/module/messageInput/sendTypes.d.ts

@@ -0,0 +1,25 @@
+import type { ChatSDK } from '../SDK';
+import type { CurrentConversation } from '../store/ConversationStore';
+export type SendMessageKind = 'text' | 'image' | 'file' | 'voice' | 'video' | 'custom' | 'combine';
+export interface SendMessageRoute {
+    conversationId: string;
+    conversationType: ChatSDK.ChatConversationType;
+    /** 定向消息接收者列表 */
+    receiverList?: string[];
+    /** 是否仅投递给在线用户 */
+    deliverOnlineOnly?: boolean;
+    /** 消息优先级 */
+    priority?: 'high' | 'normal' | 'low';
+}
+export interface BeforeSendMessageContext<Body = unknown> {
+    kind: SendMessageKind;
+    route: SendMessageRoute;
+    body: Body;
+    ext?: Record<string, unknown>;
+    isChatThread?: boolean;
+}
+export type BeforeSendMessage = (context: BeforeSendMessageContext) => Promise<CurrentConversation | SendMessageRoute | void>;
+export declare function toSendMessageRoute(cvs: CurrentConversation): SendMessageRoute;
+/** Message-level read receipts are only requested for single chat. */
+export declare function shouldEnableReadReceipt(conversationType?: string): boolean;
+export declare function resolveBeforeSendRoute(onBeforeSendMessage: BeforeSendMessage | undefined, context: BeforeSendMessageContext): Promise<SendMessageRoute>;

package/types/module/messageInput/suggestList/SuggestList.d.ts

@@ -1,6 +1,5 @@
 import React from 'react';
 import { MemberItem } from '../../store/AddressStore';
-export declare const AT_ALL = "ALL";
 export interface SuggestListProps {
     visible: boolean;
     style?: React.CSSProperties;

package/types/module/messageInput/textarea/Textarea.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
-import { ChatSDK } from '../../SDK';
+import type { ChatSDK } from '../../SDK';
 import { CurrentConversation } from '../../store/ConversationStore';
+import type { BeforeSendMessage } from '../sendTypes';
 export interface TextareaProps {
     prefix?: string;
     className?: string;
@@ -12,9 +13,9 @@ export interface TextareaProps {
     enabledMention?: boolean;
     enabledTyping?: boolean;
     isChatThread?: boolean;
-    onSendMessage?: (message: ChatSDK.TextMsgBody) => void;
+    onSendMessage?: (message: ChatSDK.Message) => void;
     conversation?: CurrentConversation;
-    onBeforeSendMessage?: (message: ChatSDK.MessageBody) => Promise<CurrentConversation | void>;
+    onBeforeSendMessage?: BeforeSendMessage;
     onChange?: (value: string) => void;
     onFocus?: () => void;
 }

package/types/module/pinnedTextMessage/PinnedTextMessage.d.ts

@@ -1,10 +1,10 @@
 import React from 'react';
-import { ChatSDK } from '../SDK';
+import type { ChatSDK } from '../SDK';
 export interface PinnedTextMessageProps {
     className?: string;
     style?: React.CSSProperties;
     children?: React.ReactNode;
-    message: ChatSDK.PinnedMessageInfo;
+    message: ChatSDK.PinnedMessageSummary;
 }
 declare const PinnedTextMessage: (props: PinnedTextMessageProps) => import("react/jsx-runtime").JSX.Element;
 export { PinnedTextMessage };

package/types/module/repliedMessage/RepliedMsg.d.ts

@@ -1,13 +1,14 @@
 import React, { ReactNode } from 'react';
-import { ChatSDK } from '../SDK';
+import type { ChatSDK } from '../SDK';
 import { BaseMessageType } from '../baseMessage/BaseMessage';
+type QuoteMessageType = 'text' | 'txt' | 'file' | 'image' | 'img' | 'voice' | 'audio' | 'custom' | 'video' | 'combine' | 'loc' | 'recall';
 export interface CustomMessageQuoteContext {
-    message: ChatSDK.CustomMsgBody;
+    message: ChatSDK.Message;
     msgQuote?: {
         msgID: string;
         msgPreview: string;
         msgSender: string;
-        msgType: ChatSDK.MessageBody['type'];
+        msgType: QuoteMessageType;
     };
     prefixCls: string;
 }

package/types/module/store/AddressStore.d.ts

@@ -1,4 +1,3 @@
-import { ChatSDK } from '../SDK';
 export type MemberRole = 'member' | 'owner' | 'admin';
 export interface ContactRequest {
     from: string;
@@ -8,30 +7,47 @@ export interface ContactRequest {
     requestStatus: 'pending' | 'accepted' | 'read';
 }
 export interface MemberItem {
-    userId: ChatSDK.UserId;
+    userId: string;
     role: MemberRole;
-    attributes?: ChatSDK.MemberAttributes;
+    attributes?: Record<string, string>;
     silent?: boolean;
     initial?: string;
     name?: string;
 }
-export interface GroupItem extends ChatSDK.BaseGroupInfo {
+export interface GroupItem {
+    groupId: string;
+    name: string;
+    groupName?: string;
+    description?: string;
+    memberCount?: number;
+    public?: boolean;
+    joinApprovalRequired?: boolean;
+    allowInvites?: boolean;
+    maxMembers?: number;
+    role?: MemberRole;
     disabled?: boolean;
-    info?: ChatSDK.GroupDetailInfo;
+    info?: Record<string, any>;
     members?: MemberItem[];
     hasMembersNext?: boolean;
-    admins?: ChatSDK.UserId[];
+    admins?: string[];
     silent?: boolean;
     initial?: string;
-    name?: string;
     avatarUrl?: string;
 }
-export type AppUserInfo = Partial<Record<ChatSDK.ConfigurableKey, any>> & {
+export type AppUserInfo = Record<string, any> & {
     userId: string;
+    nickname?: string;
+    avatarUrl?: string;
+    /** @deprecated Use avatarUrl instead. Kept for compatibility with older UIKit integrations. */
+    avatarurl?: string;
     isOnline?: boolean;
     presenceExt?: string;
 };
-export type ChatroomInfo = ChatSDK.GetChatRoomDetailsResult & {
+export type AppUserInfoMap = Record<string, AppUserInfo>;
+export type AppUserInfoProviderResult = AppUserInfo[] | AppUserInfoMap;
+export type AppUserInfoProvider = (userIds: string[]) => Promise<AppUserInfoProviderResult> | AppUserInfoProviderResult;
+export type ChatroomInfo = Record<string, any> & {
+    id: string;
     membersId?: string[];
     admins?: string[];
     muteList?: string[];
@@ -50,11 +66,18 @@ declare class AddressStore {
     searchList: any;
     requests: ContactRequest[];
     thread: {
-        [key: string]: ChatSDK.ThreadChangeInfo[];
+        [key: string]: any[];
     };
     blockList: string[];
     constructor();
     setAppUserInfo: (appUsersInfo: Record<string, AppUserInfo>) => void;
+    mergeAppUserInfo: (appUsersInfo: Record<string, AppUserInfo> | AppUserInfo[]) => void;
+    resolveUserInfo: (userId?: string) => AppUserInfo;
+    hasUserInfo: (userId: string) => boolean;
+    ensureUserInfos: (userIds: string[], options?: {
+        withPresence?: boolean;
+        force?: boolean;
+    }) => Promise<unknown>;
     setContacts(contacts: any): void;
     setContactRemark(userId: string, remark: string): void;
     deleteContact(userId: string): void;
@@ -64,14 +87,36 @@ declare class AddressStore {
     updateGroupAvatar(groupId: string, avatar: string): void;
     updateGroupName(groupId: string, groupName: string): void;
     setHasGroupsNext(hasNext: boolean): void;
-    setGroupMembers(groupId: string, membersList: ChatSDK.GroupMember[]): void;
+    /** Ensure a joined group exists locally (e.g. invitee onMembersJoined before getGroupInfo). */
+    ensureGroupInList(groupId: string, groupName?: string): void;
+    /**
+     * Upsert local groups from SDK getJoinedGroupList().
+     * ContactList watches addressStore.groups by reference; always reassign the array.
+     */
+    syncJoinedGroupsFromSdk(): void;
+    /** Normalize SDK4/SDK5 group member payloads to MemberItem.userId + role. */
+    private normalizeGroupMemberEntry;
+    setGroupMembers(groupId: string, membersList: Array<{
+        userId?: string;
+        member?: string;
+        owner?: string;
+        role?: MemberRole;
+    } | {
+        user?: {
+            userId?: string;
+        };
+        role?: MemberRole;
+    }>): void;
     removeGroupMember(groupId: string, userId: string): void;
     setGroupItemHasMembersNext(groupId: string, hasNext: boolean): void;
-    setGroupMemberAttributesAsync: (groupId: string, userId: string, attributes: ChatSDK.MemberAttributes) => void;
-    setGroupMemberAttributes(groupId: string, userId: string, attributes: ChatSDK.MemberAttributes): void;
+    setGroupMemberAttributesAsync: (groupId: string, userId: string, attributes: Record<string, string>) => void;
+    setGroupMemberAttributes(groupId: string, userId: string, attributes: Record<string, string>): void;
     setGroupAdmins: (groupId: string, admins: string[]) => void;
     getUserInfo: (userId: string, withPresence?: boolean, force?: boolean) => Promise<void | AppUserInfo>;
     getUserInfoWithPresence: (userIdList: string[]) => void;
+    normalizeAppUsersInfo: (appUsersInfo: Record<string, AppUserInfo> | AppUserInfo[]) => AppUserInfoMap;
+    normalizeAppUsersInfoMap: (appUsersInfo: Record<string, AppUserInfo>) => AppUserInfoMap;
+    normalizeAppUserInfo: (userInfo: AppUserInfo, fallbackUserId?: string) => AppUserInfo;
     setChatroom(chatroom: any): void;
     updateChatroomMemberCount(roomId: string, count: number): void;
     setChatroomAdmins: (chatroomId: string, admins: string[]) => void;

package/types/module/store/ConversationStore.d.ts

@@ -1,10 +1,10 @@
 import { ChatType } from '../types/messageType';
-import { ChatSDK } from '../SDK';
+import type { ChatSDK } from '../SDK';
 export type AT_TYPE = 'NONE' | 'ALL' | 'ME';
 export interface Conversation {
     chatType: ChatType;
     conversationId: string;
-    lastMessage: Exclude<ChatSDK.MessageBody, ChatSDK.ReadMsgBody | ChatSDK.DeliveryMsgBody>;
+    lastMessage: ChatSDK.Message | Record<string, unknown>;
     unreadCount: number;
     name?: string;
     atType?: AT_TYPE;
@@ -25,19 +25,66 @@ export interface ById {
 declare class ConversationStore {
     rootStore: any;
     currentCvs: CurrentConversation;
-    conversationList: Conversation[];
+    /** Normalized map: source of truth */
+    byId: ById;
+    /** Ordered keys into byId, sorted by pinned + lastMessage time */
+    orderedIds: string[];
     searchList: Conversation[];
     hasConversationNext: boolean;
-    byId: ById;
     constructor(rootStore: any);
+    /** Computed getter: backward-compatible array derived from byId + orderedIds */
+    get conversationList(): Conversation[];
+    private resortIds;
+    private syncSdkCurrentConversation;
     setCurrentCvs: (currentCvs: CurrentConversation) => void;
+    /**
+     * Resolve display name from SDK conversation update.
+     * SDK may set conversationName === conversationId as a placeholder; keep local/group name then.
+     */
+    private resolveSyncedConversationName;
+    /** Sync unreadCount (and optional fields) from SDK conversation list updates. */
+    syncUnreadFromSdkItems(items: ReadonlyArray<{
+        conversationId: string;
+        conversationType: ChatType | string;
+        unreadCount: number;
+        isPinned?: boolean;
+        conversationName?: string;
+        conversationAvatar?: string;
+        lastMessage?: any;
+    }>): void;
+    /**
+     * Apply SDK `onConversationListUpdate`:
+     * - remove conversations from `patch.removed`
+     * - on `patch.reset`, treat `items` as the authoritative snapshot and drop local extras
+     * - upsert unread/name/avatar/lastMessage from `items`
+     */
+    syncFromSdkConversationListUpdate(payload: {
+        items?: ReadonlyArray<{
+            conversationId: string;
+            conversationType: ChatType | string;
+            unreadCount: number;
+            isPinned?: boolean;
+            conversationName?: string;
+            conversationAvatar?: string;
+            lastMessage?: any;
+        }>;
+        patch?: {
+            reset?: boolean;
+            removed?: ReadonlyArray<{
+                conversationId: string;
+                conversationType: ChatType | string;
+            }>;
+        };
+    }): void;
+    clearUnreadForConversation(chatType: ChatType, conversationId: string): void;
+    clearAllUnreadCounts(): void;
     setConversation(conversations: Conversation[]): void;
     addConversation(conversation: Conversation): void;
     setSearchList(conversations: Conversation[]): void;
     deleteConversation(conversation: CurrentConversation): void;
     modifyConversation(conversation: Conversation): void;
     topConversation(conversation: Conversation): void;
-    getConversation(chatType: ChatType, cvsId: string): undefined;
+    getConversation(chatType: ChatType, cvsId: string): Conversation;
     setAtType(chatType: ChatType, cvsId: string, atType: AT_TYPE): void;
     setHasConversationNext(hasNext: boolean): void;
     updateConversationName(chatType: ChatType, cvsId: string): void;
@@ -48,7 +95,7 @@ declare class ConversationStore {
     setSilentModeForConversation(cvs: CurrentConversation): void;
     clearRemindTypeForConversation(cvs: CurrentConversation): void;
     getSilentModeForConversations(cvs: CurrentConversation[]): void;
-    setOnlineStatus(result: ChatSDK.SubscribePresence[]): void;
+    setOnlineStatus(result: readonly ChatSDK.PresenceInfo[]): void;
     clear(): void;
 }
 export default ConversationStore;

package/types/module/store/ConversationSyncService.d.ts

@@ -0,0 +1,15 @@
+import type { BaseMessageType } from '../baseMessage/BaseMessage';
+import type { RootStore } from './index';
+declare class ConversationSyncService {
+    private rootStore;
+    constructor(rootStore: RootStore);
+    /**
+     * Resolve display name for a newly created conversation.
+     * Prefer addressStore, then SDK conversation list / joined groups (SDK 0.20.29+ may already
+     * enrich group name after onMembersJoined).
+     */
+    private resolveConversationDisplayName;
+    /** Sync conversation list when a non-chatRoom message is received */
+    syncOnMessageReceived(message: BaseMessageType, conversationId: string, conversationType: string, currentUserId: string): void;
+}
+export default ConversationSyncService;