@rongcloud/engine 5.8.6-alpha.2 → 5.9.0-alpha.1

package/index.d.ts

@@ -263,10 +263,20 @@ interface IChatroomRejoinedSuccessed extends IChatroomJoinResponse {
  * @category Interface
  */
 interface IChatroomUserChangeInfo {
+    /**
+     * 加入、退出的成员列表
+     */
     users: {
         [userId: string]: ChatroomUserChangeType;
     };
+    /**
+     * 聊天室 ID
+     */
     chatroomId: string;
+    /**
+     * 聊天室成员人数
+     */
+    memberCount: number;
 }
 /**
  * @category Interface
@@ -824,6 +834,30 @@ declare enum ErrorCode {
      * @since 5.8.2
      */
     SYS_CONVERSATION_NOT_SUPPORT_MESSAGE = 20109,
+    /**
+     * 服务端未知错误
+     */
+    RC_SERVER_UNKOWN_ERROR = 25104,
+    /**
+     * 未开通已读 V4
+     */
+    RC_READ_RECEIPT_V4_INVALID = 26005,
+    /**
+     * 未开通会话驱动
+     */
+    RC_SERVER_DRIVE_UNREAD_COUNT_INVALID = 26006,
+    /**
+     * 消息 UID 传反
+     */
+    RC_SERVER_PARAMETER_MESSAGEUIDS_CONFUSED = 26007,
+    /**
+     * 会话 UID 不合法
+     */
+    RC_SERVER_PARAMETER_MESSAGEUID_INVALID = 26009,
+    /**
+     * 参数错误
+     */
+    RC_SERVER_PARAMETER_INVALID = 26010,
     /**
      * 发送消息频率过高，1 秒钟最多只允许发送 5 条消息
      */
@@ -1432,6 +1466,16 @@ declare enum ErrorCode {
      * 设置的代理地址不可用
      */
     RC_CONN_PROXY_UNAVAILABLE = 34245,
+    /**
+     * 不支持V4已读回执功能
+     * @since 5.9.0
+     */
+    READ_RECEIPT_V4_NOT_SUPPORT = 34292,
+    /**
+     * 不支持更新v4已读回执信息
+     * @since 5.9.0
+     */
+    READ_RECEIPT_V4_UPDATE_NOT_SUPPORT = 34293,
     /**
      * 方法未支持
      */
@@ -1725,7 +1769,15 @@ declare enum ErrorCode {
      * cookie被禁用
      * @deprecated
      */
-    COOKIE_ENABLE = 51001
+    COOKIE_ENABLE = 51001,
+    /**
+     * 子进程意外终止，如果是已连接状态，SDK 会自动重连
+     */
+    SUB_PROCESS_EXIT = 34289,
+    /**
+     * addon 模块不存在
+     */
+    ADDON_NOT_EXIST = 34290
 }
 
 /**
@@ -1894,6 +1946,10 @@ declare enum MessageType {
      * 合并转发消息
     */
     COMBINE = "RC:CombineMsg",
+    /**
+     * 合并转发消息 v2 版本
+     */
+    COMBINE_V2 = "RC:CombineV2Msg",
     /**
      * 聊天室 KV 通知消息
     */
@@ -1939,9 +1995,13 @@ declare enum MessageType {
     */
     SYNC_READ_STATUS = "RC:SRSMsg",
     /**
-     * 接受群已读回执更新消息(导航开关grpRRVer为1时使用)
+     * 接受群已读回执更新消息(导航开关grpRRVer = 1时使用)
      */
     GROUP_READ_RECEIPT_REQUEST = "RC:RRMsg",
+    /**
+     * 已读回执消息（V4）(导航开关grpRRVer = 3 时使用)，支持单群聊
+     */
+    READ_STATE = "RC:RSMsg",
     /**
      * 消息送达报告，仅单聊
     */
@@ -1950,14 +2010,6 @@ declare enum MessageType {
      * 消息送达状态报告，仅群聊
      */
     DELIVERED_MSG = "RC:DRMsg",
-    /**
-     * 用户加入聊天室
-     */
-    CHATROOM_JOIN = "RC:ChrmJoinNtf",
-    /**
-     * 用户退出聊天室
-     */
-    CHATROOM_LEFT = "RC:ChrmQuitNtf",
     /**
      * 用户加入退出聊天室的集合
      */
@@ -2209,6 +2261,14 @@ declare enum LogTagId {
     A_CALLBACK_O = "A-callback-O",
     A_CALLBACK_E = "A-callback-E",
     L_CALLBACK_E = "L-callback-E",
+    A_SEND_MESSAGE_READ_RECEIPT_V4_T = "A-send_message_read_receipt_V4-T",
+    A_SEND_MESSAGE_READ_RECEIPT_V4_R = "A-send_message_read_receipt_V4-R",
+    A_GET_MESSAGE_READ_RECEIPT_V4_T = "A-get_message_read_receipt_V4-T",
+    A_GET_MESSAGE_READ_RECEIPT_V4_R = "A-get_message_read_receipt_V4-R",
+    A_BATCH_GET_MESSAGE_READ_RECEIPT_INFO_V4_T = "A-batch_get_message_read_receipt_info_V4-T",
+    A_BATCH_GET_MESSAGE_READ_RECEIPT_INFO_V4_R = "A-batch_get_message_read_receipt_info_V4-R",
+    A_SYNC_READ_STATUS_T = "A-sync_read_status-T",
+    A_SYNC_READ_STATUS_R = "A-sync_read_status-R",
     A_GET_TOP_CONVERSATION_LIST_E = "A-get_top_conversation_list-E",
     /**
      * PB 数据编码错误
@@ -2264,9 +2324,7 @@ declare enum LogTagId {
     L_CLOUD_CONFIG_DATA_E = "L-cloud_config_data_error",
     L_CLOUD_SET_CACHE_O = "L-cloud_set_cache-O",
     L_CLOUD_GET_CACHE_O = "L-cloud_get_cache-O",
-    L_CLOUD_MSG_NTF_O = "L-cloud_msg_ntf-O",
-    L_PARSE_JSON_MSGS_E = "L-parse_json_messsages-E",
-    L_PARSE_JSON_E = "L-parse_json-E"
+    L_CLOUD_MSG_NTF_O = "L-cloud_msg_ntf-O"
 }
 
 /** 统计数据标签 */
@@ -2330,6 +2388,13 @@ declare enum EConnectProtocol {
     HTTPS = 12
 }
 
+declare enum InterruptionLevel {
+    PASSIVE = "passive",
+    ACTIVE = "active",
+    TIME_SENSITIVE = "time-sensitive",
+    CRITICAL = "critical"
+}
+
 /**
  * 荣耀推送级别
  * LOW：资讯营销类消息
@@ -2566,6 +2631,11 @@ interface IiOSPushConfig {
      * 和 category 对应
      */
     richMediaUri?: string;
+    /**
+     * iOS 时效性通知：需要人们立刻注意的通知，类似账户安全问题或快递动态
+     * @since 5.9.0 版本开始支持
+     */
+    interruptionLevel?: InterruptionLevel;
 }
 /**
  * @category Interface
@@ -2695,6 +2765,11 @@ interface IMessageReader {
     readTime: number;
     userId: string;
 }
+interface IMessageReadReceiptV4Response {
+    list: IMessageReader[];
+    readCount: number;
+    totalCount: number;
+}
 /**
  * @category Interface
  */
@@ -2703,10 +2778,22 @@ interface IMessageReaderResponse {
     list: IMessageReader[];
 }
 interface ILocalReadReceiptInfo {
+    /**
+     * 仅已读 V2 支持
+     * @hidden
+     */
     hasRespond?: boolean;
+    /**
+     * 仅已读 V2 支持
+     * @hidden
+     */
     readerInfo?: {
         [userId: string]: number;
     };
+    /**
+     * 仅已读 V4 支持
+     */
+    readerList?: IMessageReader[];
     readCount?: number;
     totalCount?: number;
 }
@@ -2715,21 +2802,73 @@ interface ILocalReadReceiptInfo {
  */
 interface IReadReceiptInfo {
     /**
-     * 是否已经发送已读回执
+     * 是否已经发送已读回执, 仅 V2 支持
+     * @hidden
+     * @deprecated
      */
     hasRespond?: boolean;
     /**
-     * 已阅读用户列表（不准确）
+     * 已阅读用户列表（不准确）, 仅 V2 支持
      */
     readerList?: IMessageReader[];
     /**
-     * 阅读人数（不准确）
+     * 阅读人数
      */
     readCount?: number;
     /**
-     * 群组总人数（不准确）
+     * 群组总人数
+     */
+    totalCount?: number;
+}
+/**
+ * 已读回执事件通知数据
+ * @category Interface
+ * @since 5.9.0
+ */
+interface IReadReceiptData {
+    privateReadReceipt?: IPrivateReadReceiptData;
+    groupReadReceipt?: IGroupReadReceiptData;
+}
+/**
+ * 单聊已读回执事件通知数据
+ * @category Interface
+ * @since 5.9.0
+ */
+interface IPrivateReadReceiptData extends IConversationOption {
+    /**
+     * 最后已读消息时间 (单聊)
+     */
+    endMsgTime?: number;
+}
+/**
+ * 群聊已读回执事件通知数据
+ * @category Interface
+ * @since 5.9.0
+ */
+interface IGroupReadReceiptData extends IConversationOption {
+    /**
+   * 已读人数 (群聊)
+   */
+    readedCount?: number;
+    /**
+     * 消息发送时群总人数 (群聊)
      */
     totalCount?: number;
+    /**
+     * 消息 UID(群聊)
+     */
+    messageUId?: string;
+}
+/**
+ * 多端同步会话已读状态事件数据
+ * @category Interface
+ * @since 5.9.0
+ */
+interface ISyncReadStatusData extends IConversationOption {
+    /**
+     * 已读消息时间
+     */
+    timestamp: number;
 }
 /**
  * 从服务端接收到的消息数据
@@ -2860,6 +2999,14 @@ interface IReceivedMessage {
      */
     hasMore?: boolean;
 }
+/**
+ * 第一条未读消息信息
+ * @category Interface
+ */
+interface IFirstUnreadMessageInfo {
+    messageUId: string;
+    sentTime: number;
+}
 /**
  * @category Interface
  */
@@ -3281,6 +3428,73 @@ interface MentionedInfoBody {
     userIdList?: string[];
     mentionedContent?: string;
 }
+/**
+ * 被合并的消息数据结构
+ */
+interface ICombinedMessage {
+    /**
+     * 消息发送者的用户 Id
+     */
+    fromUserId: string;
+    /**
+     * 消息所属会话 Id
+     */
+    targetId: string;
+    /**
+     * 消息发送时间
+     */
+    timestamp: number;
+    /**
+     * 消息类型
+     */
+    objectName: string;
+    /**
+     * 消息内容
+     */
+    content: any;
+}
+/**
+ * v2 版本合并转发消息 content 结构
+ */
+interface ICombineV2MessageContent {
+    /**
+     * 被合并消息的来源会话类型
+     */
+    conversationType: ConversationType;
+    /**
+     * 合并信息摘要，建议取被合并消息中的前三条消息的内容
+     */
+    summaryList: string[];
+    /**
+     * 名称列表，单聊时为双方的名称，群聊时为群组名称
+     */
+    nameList: string[];
+    /**
+     * 被合并消息的条目数量
+     */
+    msgNum: number;
+    /**
+     * 被合并消息的消息内容，仅当内容 JSON 序列化后长度小于 120K 时有值；当长度大于 120K 时，内容将被以文件的形式远端存储。
+     */
+    msgList?: Array<ICombinedMessage>;
+    /**
+     * 被合并消息的内容 JSON 序列化后长度大于 120K 时的文件名，暂时无作用，移动端依据此字段判断是否有文件需要下载，而非 remoteUrl 字段
+     */
+    jsonMsgKey?: string;
+    /**
+     * 远端存储文件的 URL，仅 jsonMsgKey 有值时存在
+     */
+    remoteUrl?: string;
+}
+/**
+ * @category Interface
+ */
+interface IClearMessageOption {
+    targetId: string;
+    conversationType: ConversationType;
+    channelId?: string;
+    timestamp?: number;
+}
 
 interface IUpdateItem {
     isTop?: {
@@ -3386,6 +3600,10 @@ interface IReceivedConversation {
      * 会话操作时间，暂仅 Electron 平台支持
      */
     operationTime?: number;
+    /**
+     * 会话草稿
+     */
+    draft?: string;
 }
 /**
  * @category Interface
@@ -4149,9 +4367,19 @@ interface INaviInfo {
      */
     crypto?: string;
     /**
-     * 群组回执开关, 1: 打开，0(或者没有): 关闭
+     * 群组回执开关,
+     *  0(或者没有): 关闭 v1 版本
+     * 1: 打开， v2 版本
+     * 2: 废弃
+     * 3: V4 版本，单群聊已读回执
      */
     grpRRVer?: number;
+    /**
+     * 会话驱动类型
+     * 0: 默认，客户端离线消息驱动计算未读数(客户端通过pullMsg结果计算)
+     * 1: 服务端会话驱动计算未读数(调用pullSes进行初始化),暂只影响更新会话已读时间接口
+     */
+    sesDriven?: number;
     /**
      * 防黑产开关, 1: 打开，0：关闭
      */
@@ -4488,7 +4716,11 @@ declare enum AreaCode {
     /**
      * 新增新加坡数据中心
      */
-    SG_A = 4
+    SG_A = 4,
+    /**
+     * 沙特数据中心
+     */
+    SA = 5
 }
 
 interface IStaticConfigData {
@@ -4640,8 +4872,7 @@ declare class WebsocketStaticConfigManager extends BasicStaticConfigManager {
  */
 declare class WebSocketNavi extends BasicNavi {
     private runtime;
-    private environment;
-    constructor(appkey: string, logger: BasicLogger, statisticLog: BasicStatistic, runtime: IRuntime, staticConfigManager: WebsocketStaticConfigManager, environment?: string);
+    constructor(appkey: string, logger: BasicLogger, statisticLog: BasicStatistic, runtime: IRuntime, staticConfigManager: WebsocketStaticConfigManager);
     protected httpRequest(uri: string, appkey: string, token: string, traceId: string, finished: boolean): IPromiseResult<INaviInfo>;
     protected httpRequestV2(uri: string, appkey: string, token: string, traceId: string): IPromiseResult<INaviInfo>;
     protected getNaviCache(formatedToken: string): INaviCache | null;
@@ -4978,6 +5209,7 @@ interface IProcessCache {
     naviInfo: INaviInfo | null;
     connectionStatus: RCConnectionStatus;
     deviceId: string;
+    deltaTime: number;
 }
 /**
  * 约束主进程 CppEngine 与 CppService 间的方法定义，以便于代码检查
@@ -4986,7 +5218,7 @@ interface IEngine {
     /**
      * 注册本渲染进程至主进程，以接收主进程的消息通知，同时同步主进程的当前缓存数据
      */
-    getMainProcessCache(): IProcessCache;
+    getMainProcessCache(): Promise<IProcessCache>;
     /**
      * 建立连接
      * @param token
@@ -5125,6 +5357,7 @@ interface IEngine {
      * @param targetId
      */
     removeConversation(conversationType: ConversationType, targetId: string, channelId: string): Promise<ErrorCode>;
+    batchRemoveConversation(conversations: IConversationOption[]): Promise<ErrorCode>;
     /**
      * 获取所有会话未读数
      * @param channelId 多组织 Id
@@ -5144,6 +5377,7 @@ interface IEngine {
      * 获取第一个未读消息
      */
     getFirstUnreadMessage(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<IReceivedMessage | null>;
+    getFirstUnreadMessageInfo(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<IFirstUnreadMessageInfo | null>;
     /**
      * 设置/保存指定会话消息草稿
      * @draft 草稿内容
@@ -5165,7 +5399,9 @@ interface IEngine {
      * 批量设置会话 置顶、免打扰
      */
     batchSetConversationStatus(statusList: ISetConversationStatusOptions[]): Promise<ErrorCode>;
+    batchSetConversationToTop(conversations: IConversationOption[], isTop: boolean, isCreateConversation?: boolean): Promise<ErrorCode>;
     setConversationNotificationLevel(conversationType: ConversationType, targetId: string, notificationLevel: NotificationLevel, channelId?: string): Promise<number>;
+    batchSetConversationNotificationLevel(conversations: IConversationOption[], notificationLevel: NotificationLevel): Promise<ErrorCode>;
     getConversationNotificationLevel(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<NotificationLevel>;
     getTotalUnreadCountByLevels(conversationTypes: ConversationType[], levels: NotificationLevel[], isMentioned?: boolean): Promise<IAsyncRes<number>>;
     sendMessage(conversationType: ConversationType, targetId: string, options: ISendMsgOptions, onBefore?: (messageId: number) => void, traceId?: string): IPromiseResult<IReceivedMessage>;
@@ -5329,13 +5565,25 @@ interface IEngine {
     getTagsForConversation(conversation: IConversationOption): IPromiseResult<IConversationTag[]>;
     /**
      * 发送群组消息已读回执
-     * 导航下发已读回执开关为 true 时调用
+     * 导航下发已读回执开关为 1 时调用
      */
     sendReadReceiptMessage(targetId: string, messageUIds: string[], channelId?: string): Promise<IAsyncRes>;
     /**
      * 获取群组消息已读列表
      */
     getMessageReader(targetId: string, messageUId: string, channelId?: string): IPromiseResult<IMessageReaderResponse>;
+    /**
+     * 发送已读回执(V4)
+     */
+    sendReadReceiptMessageV4(conversation: IConversationOption, startMsgUid: string, endMsgUid: string): Promise<IAsyncRes>;
+    /**
+     * 获取消息已读回执列表, 暂仅支持群聊(V4)
+     */
+    getMessageReadReceiptV4(conversation: IConversationOption, messageUid: string): IPromiseResult<IMessageReadReceiptV4Response>;
+    /**
+     * 多端同步会话的已读时间(V4)
+     */
+    updateConversationReadTime(conversation: IConversationOption, timestamp: number): Promise<IAsyncRes>;
     /**
      * 获取服务器时间
      */
@@ -5402,6 +5650,9 @@ interface IEngine {
      * 通过时间戳删除本地消息
      */
     deleteMessagesByTimestamp(conversationType: ConversationType, targetId: string, timestamp: number, cleanSpace: boolean, channelId: string): Promise<ErrorCode>;
+    batchClearMessagesByTimestamp(options: IClearMessageOption[]): Promise<ErrorCode>;
+    batchClearMessagesByTimestamp(options: IClearMessageOption[]): Promise<ErrorCode>;
+    batchClearRemoteHistoryMessages(options: IClearMessageOption[], isDeleteLocal?: boolean): Promise<ErrorCode>;
     /**
      * 清空会话下历史消息
      */
@@ -5580,7 +5831,9 @@ interface IUpdatedExpansion {
         [key: string]: any;
     };
     messageUId: string;
-    channelId?: string;
+    conversationType: ConversationType;
+    targetId: string;
+    channelId: string;
 }
 /**
  * 扩展删除
@@ -5589,7 +5842,9 @@ interface IUpdatedExpansion {
 interface IDeletedExpansion {
     deletedKeys: string[];
     messageUId: string;
-    channelId?: string;
+    conversationType: ConversationType;
+    targetId: string;
+    channelId: string;
 }
 /**
  * 扩展变更监听
@@ -6230,6 +6485,14 @@ interface IWatcher {
     ultraGroupChannelUserKicked?: (list: IUltraChannelUserKickedInfo[]) => void;
     ultraGroupChannelDelete?: (list: IUltraChannelDeleteInfo[]) => void;
     userGroupStatus?: (data: IUserGroupStatusInfo) => void;
+    /**
+   * 已读回执 V4
+   */
+    messageReadReceipt?: (data: IReadReceiptData) => void;
+    /**
+     * 同步已读状态 V4
+     */
+    syncReadStatus?: (data: ISyncReadStatusData) => void;
 }
 interface IAPIContextOption {
     /**
@@ -6288,10 +6551,6 @@ interface IAPIContextOption {
      * 日志服务地址
      */
     logServerUrl?: string;
-    /**
-     * 私有云环境配置
-     */
-    environment?: string;
 }
 
 interface IPluginGenerator<API, InitOption> {
@@ -6429,7 +6688,6 @@ declare class APIContext {
      */
     install<T, O>(plugin: IPluginGenerator<T, O>, options: O): T | null;
     private _onConnectionStatusChange;
-    private _processChatrormMessage;
     private _processChrmMemChangeMessage;
     private _processTypingStatusMessage;
     private _processInterceptMessage;
@@ -6528,6 +6786,8 @@ declare class APIContext {
     private _ultraGroupChannelUserKickedListener;
     private _ultraGroupChannelDeleteListener;
     private _userGroupStatusListener;
+    private _messageReadReceipt;
+    private _syncReadStatus;
     /**
      * rtc 数据变更通知 pluginContext
      */
@@ -6633,6 +6893,19 @@ declare class APIContext {
      * @param messageUIds
      */
     getMessageReader(targetId: string, messageUId: string, channelId?: string): Promise<IAsyncRes<IMessageReaderResponse>>;
+    /**
+     * 发送已读回执(V4)
+     */
+    sendReadReceiptMessageV4(conversation: IConversationOption, startMsgUid: string, endMsgUid: string): Promise<IAsyncRes>;
+    /**
+     * 获取消息已读回执列表, 暂仅支持群聊(V4)
+     */
+    getMessageReadReceiptV4(conversation: IConversationOption, messageUid: string): IPromiseResult<IMessageReadReceiptV4Response>;
+    batchGetMessageReadReceiptInfoV4(conversation: IConversationOption, messageUIds: string[]): IPromiseResult<IGroupReadReceiptData[]>;
+    /**
+     * 多端同步会话的已读时间(V4)
+     */
+    updateConversationReadTime(conversation: IConversationOption, timestamp: number): Promise<IAsyncRes>;
     /**
      * 反初始化，清空所有监听及计时器
      */
@@ -6686,6 +6959,7 @@ declare class APIContext {
      * 删除会话
      */
     removeConversation(conversationType: ConversationType, targetId: string, channelId?: string): Promise<ErrorCode>;
+    batchRemoveConversation(conversations: IConversationOption[]): Promise<ErrorCode>;
     /**
      * 获取超级群会话列表
      */
@@ -6728,6 +7002,7 @@ declare class APIContext {
      * 获取第一个未读消息
      */
     getFirstUnreadMessage(conversationType: ConversationType, targetId: string, channelId?: string): Promise<IAsyncRes<IReceivedMessage | null>>;
+    getFirstUnreadMessageInfo(conversationType: ConversationType, targetId: string, channelId: string): Promise<IAsyncRes<IFirstUnreadMessageInfo | null>>;
     /**
      * 设置会话免打扰
      * 原： setConversationStatus 已废弃
@@ -6740,7 +7015,9 @@ declare class APIContext {
      * * 5: 消息通知被屏蔽，即不接收消息通知
      */
     setConversationNotificationLevel(conversationType: ConversationType, targetId: string, notificationLevel?: NotificationLevel, channelId?: string): Promise<ErrorCode>;
+    batchSetConversationNotificationLevel(conversations: IConversationOption[], notificationLevel: NotificationLevel): Promise<ErrorCode>;
     setConversationStatus(conversationType: ConversationType, targetId: string, isTop?: boolean, notificationStatus?: 1 | 2, channelId?: string): Promise<ErrorCode>;
+    batchSetConversationToTop(conversations: IConversationOption[], isTop: boolean, isCreateConversation?: boolean): Promise<ErrorCode>;
     saveConversationMessageDraft(conversationType: ConversationType, targetId: string, draft: string, channelId?: string): Promise<ErrorCode>;
     getConversationMessageDraft(conversationType: ConversationType, targetId: string, channelId?: string): Promise<IAsyncRes<string>>;
     clearConversationMessageDraft(conversationType: ConversationType, targetId: string, channelId?: string): Promise<ErrorCode>;
@@ -7105,6 +7382,11 @@ declare class APIContext {
      * 从本地消息数据库中删除某一会话指定时间之前的消息数据
     */
     deleteMessagesByTimestamp(conversationType: ConversationType, targetId: string, timestamp: number, cleanSpace: boolean, channelId?: string): Promise<ErrorCode>;
+    /**
+     * 通过时间戳批量清除本地消息
+     */
+    batchClearMessagesByTimestamp(options: IClearMessageOption[]): Promise<ErrorCode>;
+    batchClearRemoteHistoryMessages(options: IClearMessageOption[], isDeleteLocal?: boolean): Promise<ErrorCode>;
     /**
      * 清空会话下历史消息
     */
@@ -7259,7 +7541,7 @@ declare class PluginContext {
      */
     ondestroy?(): void;
     /**
-     * beem 专有接口，做 groupCall 用到
+     * groupCall 用到
      */
     onCallInfo?(data: string): void;
     /**
@@ -7554,6 +7836,14 @@ interface IEngineWatcher extends IConnectionListener {
     callInfo: (data: string) => void;
     onNaviDataChange: (naviInfo: INaviInfo) => void;
     userGroupStatus: (info: IUserGroupStatusInfo) => void;
+    /**
+     * 已读回执 V4
+     */
+    messageReadReceipt: (data: IReadReceiptData) => void;
+    /**
+     * 同步已读状态 V4
+     */
+    syncReadStatus: (data: ISyncReadStatusData) => void;
 }
 /**
  * 引擎定义
@@ -7759,6 +8049,7 @@ declare abstract class AEngine {
      * @param targetId
      */
     abstract removeConversation(conversationType: ConversationType, targetId: string, channelId: string): Promise<ErrorCode>;
+    abstract batchRemoveConversation(conversations: IConversationOption[]): Promise<ErrorCode>;
     /**
      * 获取所有会话未读数
      * @param channelId 多组织 Id
@@ -7786,6 +8077,7 @@ declare abstract class AEngine {
      * 获取第一个未读消息
      */
     abstract getFirstUnreadMessage(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<IReceivedMessage | null>;
+    abstract getFirstUnreadMessageInfo(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<IFirstUnreadMessageInfo | null>;
     /**
      * 设置/保存指定会话消息草稿
      * @draft 草稿内容
@@ -7807,6 +8099,7 @@ declare abstract class AEngine {
      * 批量设置会话 置顶、免打扰
      */
     abstract batchSetConversationStatus(statusList: ISetConversationStatusOptions[]): Promise<ErrorCode>;
+    abstract batchSetConversationToTop(conversations: IConversationOption[], isTop: boolean, isCreateConversation?: boolean): Promise<ErrorCode>;
     abstract sendMessage(conversationType: ConversationType, targetId: string, options: ISendMsgOptions, 
     /**
      * c++ 消息写库后存在自增 Id，必要时需要向业务层暴露，JSEngine 无需实现
@@ -7825,6 +8118,22 @@ declare abstract class AEngine {
      * @param messageUIds
      */
     abstract getMessageReader(targetId: string, messageUId: string, channelId?: string): IPromiseResult<IMessageReaderResponse>;
+    /**
+     * 发送已读回执(V4)
+     */
+    abstract sendReadReceiptMessageV4(conversation: IConversationOption, startMsgUid: string, endMsgUid: string): Promise<IAsyncRes>;
+    /**
+     * 获取消息已读回执列表, 暂仅支持群聊(V4)
+     */
+    abstract getMessageReadReceiptV4(conversation: IConversationOption, messageUid: string): IPromiseResult<IMessageReadReceiptV4Response>;
+    /**
+     * 批量获取消息已读回执信息, 暂仅支持群聊(V4)
+     */
+    abstract batchGetMessageReadReceiptInfoV4(conversation: IConversationOption, messageUIds: string[]): IPromiseResult<IGroupReadReceiptData[]>;
+    /**
+     * 多端同步会话的已读时间(V4)
+     */
+    abstract updateConversationReadTime(conversation: IConversationOption, timestamp: number): Promise<IAsyncRes>;
     /**
      * 断开连接
      * @param closeDB 是否关闭数据库，默认为 true，仅 Electron 平台有效
@@ -8156,6 +8465,11 @@ declare abstract class AEngine {
      * 通过时间戳删除本地消息
     */
     abstract deleteMessagesByTimestamp(conversationType: ConversationType, targetId: string, timestamp: number, cleanSpace: boolean, channelId: string): Promise<ErrorCode>;
+    /**
+     * 通过时间戳批量清除本地消息
+    */
+    abstract batchClearMessagesByTimestamp(options: IClearMessageOption[]): Promise<ErrorCode>;
+    abstract batchClearRemoteHistoryMessages(options: IClearMessageOption[], isDeleteLocal?: boolean): Promise<ErrorCode>;
     /**
      * 清空会话下历史消息
     */
@@ -8244,6 +8558,7 @@ declare abstract class AEngine {
     */
     abstract getConversationNotificationStatus(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<NotificationStatus>;
     abstract setConversationNotificationLevel(conversationType: ConversationType, targetId: string, notificationLevel?: NotificationLevel, channelId?: string): Promise<ErrorCode>;
+    abstract batchSetConversationNotificationLevel(conversations: IConversationOption[], notificationLevel: NotificationLevel): Promise<ErrorCode>;
     /**
     * 获取会话免打扰状态
     * 旧：getConversationNotificationStatus
@@ -8404,6 +8719,12 @@ declare class AppStorage {
     get(key: string): any;
     getKeys(): string[];
     getValues(): any;
+    /**
+     * 全量更新
+     */
+    update(value?: {
+        [key: string]: any;
+    }): void;
 }
 
 declare class Todo extends Error {
@@ -8600,6 +8921,16 @@ declare namespace base {
 declare const getUUID: () => string;
 declare const getUUID22: () => string;
 
+declare class SuspendablePromise<T> {
+    private readonly _promise;
+    private _resolve;
+    private _onCancel;
+    constructor(handle: (resolve: (val: T) => void) => void, onCancel: (resolve: (val: T) => void) => void);
+    private _onResolve;
+    result(): Promise<T>;
+    abort(): void;
+}
+
 /**
  * 预定义的验证规则，只包含`值类型`数据验证
  * 引用类型数据需使用自定义 validator 校验函数进行校验
@@ -8716,9 +9047,8 @@ declare const getbundleId: () => string;
  */
 declare const decryptCBC: (data: string, key: string, iv: string) => Promise<string>;
 declare function fixUrlProtocol(url: string, protocol?: EConnectProtocol): string;
-declare const getMinionURL: (naviInfo: INaviInfo, logger: BasicLogger) => string;
 
-declare function httpRequest(options: IRequest): Promise<IResponse>;
+declare function httpRequest(options: IRequest): SuspendablePromise<IResponse>;
 
 /**
  * @todo 后期禁用此方法，容易滥用，且会丢失上下文的数据类型跟踪
@@ -8881,12 +9211,18 @@ declare const LOCAL_STORAGE_KEYS: {
     SEND_MSG_KEY: (appKey: string, curUserId: string) => string;
     /**
      * tag 信息拉取时间戳
+     * @deprecated 由 USER_SETTING_KEY 代替
      */
     USER_SETTING_TIME_KEY: (appKey: string, curUserId: string) => string;
     /**
      * tag 状态
+     * @deprecated 由 USER_SETTING_KEY 代替
      */
     TAG_STATE_KEY: (appKey: string, curUserId: string) => string;
+    /**
+     * 用户配置信息（当前仅存了 tag 信息和 version）
+     */
+    USER_SETTING_KEY: (appKey: string, curUserId: string) => string;
     /**
      * staticConfig 静态配置
      */
@@ -9054,4 +9390,4 @@ declare type AbsCodec<T> = Codec<T>;
  */
 declare const version: string;
 
-export { AConnectionMgr, AEngine, APIContext, AbsCodec, AppStorage, AreaCode, AssertRules, BaseCloudController, BasicLogger, BasicNavi, BasicReporter, BasicStaticConfigManager, BasicStatistic, BasicStatisticReporter, CPP_PROTOCAL_MSGTYPE_OPTION, CallLibMsgType, ChatroomEntryType, ChatroomSyncStatusReason, ChatroomUserChangeType, ChrmMemBanType, ChrmMemOperateType, ChrmSyncStatus, Codec, CodecPBMaps, ConnectReason, ConnectType, ConnectionStatus, Content, ConversationType, DB_LOG_FLUSH_FREQUENCY, DB_LOG_MAX_SIZE, DelayTimer, EConnectProtocol, EnableLogL, EnterpriseType, ErrorCode, EventEmitter, FORMATED_VERSION, FileType, HTTP_TIMEOUT, HttpMethod, IAPIContextOption, IAndroidPushConfig, IAsyncRes, IBaseConversationInfo, IBaseStatisticsData, IBlockedMessageInfo, ICancelRoomPKOptions, IChannelAndUserGroupChangeData, IChatRoomEntries, IChatRoomEntry, IChatroomEntries, IChatroomEntry, IChatroomEntryListenerData, IChatroomInfo, IChatroomJoinResponse, IChatroomListener, IChatroomListenerData, IChatroomNotifyBan, IChatroomNotifyBlock, IChatroomNotifyMultiLoginSync, IChatroomRejoinedFailed, IChatroomRejoinedInfo, IChatroomRejoinedSuccessed, IChatroomUser, IChatroomUserChangeInfo, IChrmKVEntries, IChrmKVEntry, ICloudController, IConnectResult, IConnectionListener, IConnectionStatusListener, IConversationIdentifier, IConversationOption, IConversationState, IConversationStateListener, IConversationTag, IConversationTagListener, IDeletedExpansion, IDeliveredUser, IDownloadAuth, IEndRoomPKOptions, IEngine, IEngineWatcher, IEventListener, IExpansionListener, IExpansionListenerData, IExpansionMsgContent, IExtraMethod, IGetMsgOption, IGetUltraGroupListOption, IGooglePushConfig, IGroupMessageDeliverInfo, IGroupMessageDeliverStatus, IGroupMessageDeliveredStatusInfo, IInsertMessage, IInsertMsgOptions, IIsValidExpansion, IJoinRTCRoomData, ILocalReadReceiptInfo, ILocalTagStatus, ILogDB, ILogData, ILogger, IM_CHATROOM_PULL_INTERVAL_TIME, IM_PING_INTERVAL_TIME, IM_PING_MIN_TIMEOUT, IM_PING_TIMEOUT, IM_SIGNAL_TIMEOUT, IMessageDeliver, IMessageDeliveredListener, IMessageListnenr, IMessageReader, IMessageReaderResponse, IMetionedData, INaviCache, INaviContextInfo, INaviInfo, INetwork, IOSInfo, IOperateInfo, IOperateStatusNotify, IOperateSummary, IPluginGenerator, IProcessCache, IProcessInfo, IPromiseResult, IProxy, IPushConfig, IRTCInnerListener, IRTCJoinedInfo, IRTCRoomBindOption, IRTCRoomInfo, IRTCUserData, IRTCUsers, IReadReceiptInfo, IRecallMsgContent, IRecallMsgOptions, IReceivedConversation, IReceivedConversationByTag, IReceivedMessage, IRemoveChatRoomEntries, IRemoveChatRoomEntry, IRemoveChatroomEntries, IRemoveChatroomEntry, IReqRoomPKOptions, IRequest, IResRoomPKOptions, IResponse, IRtcTokenData, IRuntime, ISendExMsgOptions, ISendMsgOptions, IServerConversationStatus, IServerRTCRoomEntry, IServerUserSetting, ISetConversationStatusOptions, IStaticConfig, IStatistic, IStatisticDB, IStatisticData, IStatisticsCMPData, IStatisticsCSData, IStatisticsDurData, IStatisticsNaviData, IStatisticsNetworkData, IStatisticsRMTPData, IStatisticsWebsocketData, IStorage, ITagInfo, ITagListener, ITagParam, ITagStatus, ITypingInfo, ITypingMessage, ITypingUser, IUltraChannelChangeInfo, IUltraChannelDeleteInfo, IUltraChannelUserKickedInfo, IUltraExMsgOptions, IUltraGroupConversation, IUltraGroupOption, IUltraGroupUnreadInfo, IUltraGroupUnreadMentionedOption, IUltraModifyMsgOptions, IUltraMsgQueryOptions, IUltraUnreadConversation, IUltraUnreadMsg, IUpdateItem, IUpdatedConversation, IUpdatedExpansion, IUploadAuth, IUploadTask, IUserGroupChangeData, IUserGroupStatusInfo, IUserProfile, IWatcher, IWebSocket, IiOSPushConfig, IndexDBLogger, IndexDBReporter, IndexDBStatistic, IndexDBStatisticReporter, RTCKeyMaps as InnerRTCKeyMaps, InvokerType, ItypingStateListener, KVString, LOCAL_STORAGE_KEYS, LiveRole, LiveType, LogContent, LogL, LogLevel, LogSource, LogTagId, LogType, MAX_MESSAGE_CONTENT_BYTES, MAX_MESSAGE_EXPANSION_KEY_LENGTH, MAX_MESSAGE_EXPANSION_VAL_LENGTH, MAX_UPLOAD_FILE_SIZE, MentionedInfoBody, MentionedType, MessageBlockSourceType, MessageBlockType, MessageDirection, MessageType, NAVI_CACHE_DURATION, NAVI_REQ_TIMEOUT, NaviCacheType, NetworkType, NotificationLevel, NotificationStatus, ONE_LOG_SIZE_MAX, OperateStatus, PluginContext, ProtocalType, PushImportanceHonor, RCAssertError, RCConnectionStatus, RC_DEFAULT_USER, REAT_TIME_LOG_SIZE, RTCApiType, RTCIdentityChangeType, RTCJoinType, RTCMode, RTCPluginContext, ReceivedStatus, SEND_MESSAGE_TYPE_OPTION, STATIC_CONFIG_CACHE_TIME, STATIC_CONFIG_IV, STATIC_CONFIG_KEY, STATUS_MESSAGE, SentStatus, StatisticL, StatisticsTag, StatisticsVersion, StoreKeys, TagChangeType, Type, UPLOAD_FILE_CHUNK_SIZE, UltraGroupChannelChangeType, UltraGroupChannelType, UltraMentionedType, UltraMsgChangeType, UltraMsgSubChangeType, UploadMethod, UserGroupChangeType, VERSION, VersionManage, WEB_SOCKET_TIMEOUT, WebSocketNavi, appendUrl, assert, clone, cloneByJSON, deInitLogDB, decryptCBC, fixUrlProtocol, forEach, getBrowser, getClientMessageId, getDeviceId, getMimeKey, getMinionURL, getUUID, getUUID22, getUploadFileName, getbundleId, httpRequest, indexOf, initLogDB, initStatisticDB, isArray, isArrayBuffer, isBoolean, isConnnectAckCode as isConnnectAck, isDisconnectCode as isDisconnectedByServer, isFunction, isHttpUrl, isInObject, isInclude, isNull, isNumber, isObject, isStartCloudController, isString, isTypeInConversationList, isUndefined, isValidChannelId, isValidChrmEntryKey, isValidChrmEntryValue, isValidConversationType, isValidExpansion, isValidFileType, isValidNotificationLevel, base as logger, map, notEmptyArray, notEmptyObject, notEmptyString, pushConfigsToJSON, pushJSONToConfigs, statisticTranscsv, todo, transcsv, unInitStatisticDB, urlCenter, usingCppEngine, validate, version };
+export { AConnectionMgr, AEngine, APIContext, AbsCodec, AppStorage, AreaCode, AssertRules, BaseCloudController, BasicLogger, BasicNavi, BasicReporter, BasicStaticConfigManager, BasicStatistic, BasicStatisticReporter, CPP_PROTOCAL_MSGTYPE_OPTION, CallLibMsgType, ChatroomEntryType, ChatroomSyncStatusReason, ChatroomUserChangeType, ChrmMemBanType, ChrmMemOperateType, ChrmSyncStatus, Codec, CodecPBMaps, ConnectReason, ConnectType, ConnectionStatus, Content, ConversationType, DB_LOG_FLUSH_FREQUENCY, DB_LOG_MAX_SIZE, DelayTimer, EConnectProtocol, EnableLogL, EnterpriseType, ErrorCode, EventEmitter, FORMATED_VERSION, FileType, HTTP_TIMEOUT, HttpMethod, IAPIContextOption, IAndroidPushConfig, IAsyncRes, IBaseConversationInfo, IBaseStatisticsData, IBlockedMessageInfo, ICancelRoomPKOptions, IChannelAndUserGroupChangeData, IChatRoomEntries, IChatRoomEntry, IChatroomEntries, IChatroomEntry, IChatroomEntryListenerData, IChatroomInfo, IChatroomJoinResponse, IChatroomListener, IChatroomListenerData, IChatroomNotifyBan, IChatroomNotifyBlock, IChatroomNotifyMultiLoginSync, IChatroomRejoinedFailed, IChatroomRejoinedInfo, IChatroomRejoinedSuccessed, IChatroomUser, IChatroomUserChangeInfo, IChrmKVEntries, IChrmKVEntry, IClearMessageOption, ICloudController, ICombineV2MessageContent, ICombinedMessage, IConnectResult, IConnectionListener, IConnectionStatusListener, IConversationIdentifier, IConversationOption, IConversationState, IConversationStateListener, IConversationTag, IConversationTagListener, IDeletedExpansion, IDeliveredUser, IDownloadAuth, IEndRoomPKOptions, IEngine, IEngineWatcher, IEventListener, IExpansionListener, IExpansionListenerData, IExpansionMsgContent, IExtraMethod, IFirstUnreadMessageInfo, IGetMsgOption, IGetUltraGroupListOption, IGooglePushConfig, IGroupMessageDeliverInfo, IGroupMessageDeliverStatus, IGroupMessageDeliveredStatusInfo, IGroupReadReceiptData, IInsertMessage, IInsertMsgOptions, IIsValidExpansion, IJoinRTCRoomData, ILocalReadReceiptInfo, ILocalTagStatus, ILogDB, ILogData, ILogger, IM_CHATROOM_PULL_INTERVAL_TIME, IM_PING_INTERVAL_TIME, IM_PING_MIN_TIMEOUT, IM_PING_TIMEOUT, IM_SIGNAL_TIMEOUT, IMessageDeliver, IMessageDeliveredListener, IMessageListnenr, IMessageReadReceiptV4Response, IMessageReader, IMessageReaderResponse, IMetionedData, INaviCache, INaviContextInfo, INaviInfo, INetwork, IOSInfo, IOperateInfo, IOperateStatusNotify, IOperateSummary, IPluginGenerator, IPrivateReadReceiptData, IProcessCache, IProcessInfo, IPromiseResult, IProxy, IPushConfig, IRTCInnerListener, IRTCJoinedInfo, IRTCRoomBindOption, IRTCRoomInfo, IRTCUserData, IRTCUsers, IReadReceiptData, IReadReceiptInfo, IRecallMsgContent, IRecallMsgOptions, IReceivedConversation, IReceivedConversationByTag, IReceivedMessage, IRemoveChatRoomEntries, IRemoveChatRoomEntry, IRemoveChatroomEntries, IRemoveChatroomEntry, IReqRoomPKOptions, IRequest, IResRoomPKOptions, IResponse, IRtcTokenData, IRuntime, ISendExMsgOptions, ISendMsgOptions, IServerConversationStatus, IServerRTCRoomEntry, IServerUserSetting, ISetConversationStatusOptions, IStaticConfig, IStatistic, IStatisticDB, IStatisticData, IStatisticsCMPData, IStatisticsCSData, IStatisticsDurData, IStatisticsNaviData, IStatisticsNetworkData, IStatisticsRMTPData, IStatisticsWebsocketData, IStorage, ISyncReadStatusData, ITagInfo, ITagListener, ITagParam, ITagStatus, ITypingInfo, ITypingMessage, ITypingUser, IUltraChannelChangeInfo, IUltraChannelDeleteInfo, IUltraChannelUserKickedInfo, IUltraExMsgOptions, IUltraGroupConversation, IUltraGroupOption, IUltraGroupUnreadInfo, IUltraGroupUnreadMentionedOption, IUltraModifyMsgOptions, IUltraMsgQueryOptions, IUltraUnreadConversation, IUltraUnreadMsg, IUpdateItem, IUpdatedConversation, IUpdatedExpansion, IUploadAuth, IUploadTask, IUserGroupChangeData, IUserGroupStatusInfo, IUserProfile, IWatcher, IWebSocket, IiOSPushConfig, IndexDBLogger, IndexDBReporter, IndexDBStatistic, IndexDBStatisticReporter, RTCKeyMaps as InnerRTCKeyMaps, InterruptionLevel, InvokerType, ItypingStateListener, KVString, LOCAL_STORAGE_KEYS, LiveRole, LiveType, LogContent, LogL, LogLevel, LogSource, LogTagId, LogType, MAX_MESSAGE_CONTENT_BYTES, MAX_MESSAGE_EXPANSION_KEY_LENGTH, MAX_MESSAGE_EXPANSION_VAL_LENGTH, MAX_UPLOAD_FILE_SIZE, MentionedInfoBody, MentionedType, MessageBlockSourceType, MessageBlockType, MessageDirection, MessageType, NAVI_CACHE_DURATION, NAVI_REQ_TIMEOUT, NaviCacheType, NetworkType, NotificationLevel, NotificationStatus, ONE_LOG_SIZE_MAX, OperateStatus, PluginContext, ProtocalType, PushImportanceHonor, RCAssertError, RCConnectionStatus, RC_DEFAULT_USER, REAT_TIME_LOG_SIZE, RTCApiType, RTCIdentityChangeType, RTCJoinType, RTCMode, RTCPluginContext, ReceivedStatus, SEND_MESSAGE_TYPE_OPTION, STATIC_CONFIG_CACHE_TIME, STATIC_CONFIG_IV, STATIC_CONFIG_KEY, STATUS_MESSAGE, SentStatus, StatisticL, StatisticsTag, StatisticsVersion, StoreKeys, SuspendablePromise, TagChangeType, Type, UPLOAD_FILE_CHUNK_SIZE, UltraGroupChannelChangeType, UltraGroupChannelType, UltraMentionedType, UltraMsgChangeType, UltraMsgSubChangeType, UploadMethod, UserGroupChangeType, VERSION, VersionManage, WEB_SOCKET_TIMEOUT, WebSocketNavi, appendUrl, assert, clone, cloneByJSON, deInitLogDB, decryptCBC, fixUrlProtocol, forEach, getBrowser, getClientMessageId, getDeviceId, getMimeKey, getUUID, getUUID22, getUploadFileName, getbundleId, httpRequest, indexOf, initLogDB, initStatisticDB, isArray, isArrayBuffer, isBoolean, isConnnectAckCode as isConnnectAck, isDisconnectCode as isDisconnectedByServer, isFunction, isHttpUrl, isInObject, isInclude, isNull, isNumber, isObject, isStartCloudController, isString, isTypeInConversationList, isUndefined, isValidChannelId, isValidChrmEntryKey, isValidChrmEntryValue, isValidConversationType, isValidExpansion, isValidFileType, isValidNotificationLevel, base as logger, map, notEmptyArray, notEmptyObject, notEmptyString, pushConfigsToJSON, pushJSONToConfigs, statisticTranscsv, todo, transcsv, unInitStatisticDB, urlCenter, usingCppEngine, validate, version };