@rongcloud/engine 5.6.2-beem.7 → 5.7.0-beem.1

package/index.d.ts

@@ -102,154 +102,6 @@ declare enum TagChangeType {
     delete = 3
 }
 
-/**
- * 通信协议中 fixHeader 第一个字节中的 Qos 数据标识
- * ```
- * fixHeader：command(4 bit) | dup(1 bit) | Qos(2 bit) | retain(1 bit)
- * ```
- */
-declare enum QOS {
-    AT_MOST_ONCE = 0,
-    AT_LEAST_ONCE = 1,
-    EXACTLY_ONCE = 2,
-    DEFAULT = 3
-}
-/**
- * 通信协议中 fixHeader 第一个字节中的 command 数据标识，用于判断操作类型
- * ```
- * fixHeader：command(4 bit) | dup(1 bit) | Qos(2 bit) | retain(1 bit)
- * ```
- */
-declare enum OperationType {
-    /** 私有云专用，解密协商指令 */
-    SYMMETRIC = 0,
-    /** 连接请求 */
-    CONNECT = 1,
-    /** 连接应答 */
-    CONN_ACK = 2,
-    /** 上行发送消息 */
-    PUBLISH = 3,
-    /** 上行发送消息的应答 */
-    PUB_ACK = 4,
-    /** 上行拉消息 */
-    QUERY = 5,
-    /** 上行拉消息的应答 */
-    QUERY_ACK = 6,
-    /** QueryConfirm */
-    QUERY_CONFIRM = 7,
-    SUBSCRIBE = 8,
-    SUB_ACK = 9,
-    UNSUBSCRIBE = 10,
-    UNSUB_ACK = 11,
-    PING_REQ = 12,
-    PING_RESP = 13,
-    /** 连接挂断 */
-    DISCONNECT = 14,
-    RESERVER2 = 15
-}
-/**
- * connect 版本号，用于区分 ConnAckMessage 的解析规则
- */
-declare enum ConnAckProtocolVer {
-    /**
-     * V4 说明：
-     * ```
-     * 增加 flag 来标识每个位置是否有内容，如果没有 messageId 说明此 APP 没有配置防重放，默认取0
-     * status            |   4byte
-     * flag              |   1byte  每一位标识是否有对应值，由低到高
-     * userId            |   可变长
-     * sessionId         |   可变长
-     * timestamp         |   8byte
-     * messageId         |   4byte
-     * onlineClientInfo  |   可变长
-     * ===
-     * flag 描述：
-     * | | | |          4          |      3       |       2      |      1       |     0     |
-     * | | | | hasOnlineClientInfo | hasMessageId | hasTimeStamp | hasSessionId | hasUserId |
-     * ```
-     */
-    V4 = 4,
-    /**
-     * V3 说明：
-     * ```
-     * status            |   4byte
-     * userId            |   可变长
-     * sessionId         |   可变长
-     * timestamp         |   8byte
-     * descyptionType    |   1byte
-     * secretKey         |   可变长
-     * onlineClientInfo  |   可变长
-     * ```
-     */
-    V3 = 3
-}
-
-/**
- * @todo 注释补全
- * @description
- * Header 处理
-*/
-declare class Header {
-    readonly type: OperationType;
-    private readonly _retain;
-    qos: QOS;
-    private readonly _dup;
-    readonly syncMsg: boolean;
-    constructor(type: OperationType, retain?: boolean, qos?: QOS, dup?: boolean);
-    encode(): number;
-}
-/**
- * @description
- * 融云读取二进制数据
-*/
-declare class RongStreamReader {
-    private _pool;
-    private _position;
-    private _poolLen;
-    constructor(arr: Uint8Array);
-    check(): boolean;
-    /**
-     * 读 2 位
-     */
-    read2Byte(): number;
-    /**
-     * 读 4 位
-     */
-    readInt(): number;
-    /**
-     * 读 8 位
-     */
-    readLong(): number;
-    /**
-     * 读 1 位
-     */
-    readByte(): number;
-    /**
-     * 获取数据
-     */
-    readUTF(): string;
-    /**
-     * 读剩余的所有值
-     */
-    readAll(): Uint8Array;
-}
-/**
- * @description
- * 融云写入二进制数据
-*/
-declare class RongStreamWriter {
-    private _pool;
-    private _position;
-    private _writen;
-    /**
-     * 写入缓存区, writen 值往后移
-     */
-    write(byte: number): number;
-    writeArr(byte: Array<number>): number[];
-    writeUTF(str: string): void;
-    getBytesArray(): Array<number>;
-}
-
 /**
  * LogLevel 等级定义，与大数据服务器日志等级保持一致
  */
@@ -570,7 +422,7 @@ declare enum ErrorCode {
      */
     FORBIDDEN_IN_CHATROOM = 23408,
     /**
-     * 聊天室中成员被踢出
+     * 当前用户被目标聊天室封禁
      */
     RC_CHATROOM_USER_KICKED = 23409,
     /**
@@ -663,9 +515,9 @@ declare enum ErrorCode {
      */
     RC_HTTP_RECV_FAIL = 30006,
     /**
-     * 导航操作的 HTTP 请求，返回不是200。
+     * 导航请求失败
      */
-    RC_NAVI_RESOURCE_ERROR = 30007,
+    RC_NAVI_REQ_FAILED = 30007,
     /**
      * 导航数据解析后，其中不存在有效数据。
      */
@@ -675,21 +527,17 @@ declare enum ErrorCode {
      */
     RC_DOMAIN_NOT_RESOLVE = 30009,
     /**
-     * 创建 Socket 失败。
+     * Socket 连接失败
      */
     RC_SOCKET_NOT_CREATED = 30010,
     /**
-     * Socket 被断开。
+     * Socket 连接断开
      */
     RC_SOCKET_DISCONNECTED = 30011,
     /**
-     * PING 操作失败。
-     */
-    RC_PING_SEND_FAIL = 30012,
-    /**
-     * PING 超时。
+     * PING 连续失败次数超限制
      */
-    RC_PONG_RECV_FAIL = 30013,
+    RC_PING_EXCEED_LIMIT = 30012,
     /**
      * 消息发送失败。
      */
@@ -699,27 +547,27 @@ declare enum ErrorCode {
      */
     RC_MSG_CONTENT_EXCEED_LIMIT = 30016,
     /**
-     * 做 connect 连接时，收到的 ACK 超时。
+     * TCP 连接中，CMP 应答超时。
      */
     RC_CONN_ACK_TIMEOUT = 31000,
     /**
-     * 参数错误。
+     * 连接协议版本错误
      */
     RC_CONN_PROTO_VERSION_ERROR = 31001,
     /**
-     * 参数错误，App Id 错误。
+     * 客户端连接用设备 info 信息错误
      */
-    RC_CONN_ID_REJECT = 31002,
+    RC_CONN_IDENTIFIER_REJECTED = 31002,
     /**
-     * 服务器不可用。
+     * 连接服务未开通，需要排查后台小程序（或桌面端）服务是否已开通
      */
     RC_CONN_SERVER_UNAVAILABLE = 31003,
     /**
-     * Token 错误。
+     * Token 无法解析，或 Token 已过期
      */
-    RC_CONN_USER_OR_PASSWD_ERROR = 31004,
+    RC_CONN_TOKEN_INCORRECT = 31004,
     /**
-     * websocket 鉴权失败，通常为连接后未及时发送 Ping 或接收到 Pong
+     * 防黑产校验失败
      */
     RC_CONN_NOT_AUTHRORIZED = 31005,
     /**
@@ -727,31 +575,51 @@ declare enum ErrorCode {
      */
     RC_CONN_REDIRECTED = 31006,
     /**
-     * NAME 与后台注册信息不一致。
+     * 包名不合法（目前仅限移动端使用）
      */
     RC_CONN_PACKAGE_NAME_INVALID = 31007,
     /**
-     * APP 被屏蔽、删除或不存在。
+     * Appkey 已被封禁或删除
      */
     RC_CONN_APP_BLOCKED_OR_DELETED = 31008,
     /**
-     * 用户被屏蔽。
+     * 用户已被封禁
      */
     RC_CONN_USER_BLOCKED = 31009,
     /**
-     * Disconnect，由服务器返回，比如用户互踢。
+     * 其他端登录导致本端被踢
      */
     RC_DISCONN_KICK = 31010,
     /**
-     * Disconnect，由服务器返回，比如用户互踢。
+     * 用户在线时被封禁导致连接断开
      */
     RC_DISCONN_EXCEPTION = 31011,
     /**
-     * 开启禁止把已在线客户端踢下线开关后，该错误码标识已有同类型端在线，禁止链接；
+     * Token 已过期
+     */
+    RC_CONN_TOKEN_EXPIRED = 31020,
+    /**
+     * Token 中携带 deviceId 时，检测 Token 中 deviceId 与链接设备 deviceId 不一致
+     */
+    RC_CONN_DEVICE_ERROR = 31021,
+    /**
+     * 页面域名不在安全域名白名单内，需通过开发者后台添加安全域名配置
+     */
+    RC_CONN_HOSTNAME_ERROR = 31022,
+    /**
+     * 开启禁止把已在线客户端踢下线开关后，该错误码标识已有同类型端在线
      */
     RC_DISCONN_SAME_CLIENT_ON_LINE = 31023,
     /**
-     * app 验证Token 验证不通过。所有内部超时，访问失败,返回给客户端sdk都是验证不通过，由服务端日志去看具体是那种失败。
+     * 连接数已达上限（私有云）
+     */
+    RC_LISCENSE_COUNT_OUT_OF_LIMIT = 31024,
+    /**
+     * 客户端连错环境，引发连接拒绝；如使用开发环境 Appkey 连接到生产环境
+     */
+    RC_CONN_WRONG_CLUSTER = 31025,
+    /**
+     * 开启 AppServer 联合鉴权功能后，到 AppServer 认证失败
      */
     RC_APP_AUTH_NOT_PASS = 31026,
     /**
@@ -759,16 +627,15 @@ declare enum ErrorCode {
      */
     RC_OTP_USED = 31027,
     /**
-     * token平台验证失败
+     * Token 绑定的平台与登录平台不符
      */
     RC_PLATFORM_ERROR = 31028,
     /**
      * 用户账号已销户
-     * @desc  请检查您使用的 Token 是否正确，以及对应的 UserId 是否被销户
      */
-    RC_CONN_USER_LOGOUT = 31029,
+    RC_ACCOUNT_CANCELLATION = 31029,
     /**
-     * 证书过期，SDK不会重连
+     * License 授权过期（私有云）
      */
     RC_LICENSE_EXPIRED = 31030,
     /**
@@ -779,6 +646,10 @@ declare enum ErrorCode {
      * 协议层内部错误。
      */
     RC_MSG_DATA_INCOMPLETE = 32002,
+    /**
+     * TCP 连接重置
+     */
+    RC_TCP_RESET = 32054,
     /**
      * 未调用 init 初始化函数。
      */
@@ -888,7 +759,7 @@ declare enum ErrorCode {
      */
     CAN_NOT_RECONNECT = 35007,
     /**
-     * 不支持的平台类型，一般小程序或 PC 未开通
+     * 无可用的 IM 服务地址
      */
     SERVER_UNAVAILABLE = 35008,
     /**
@@ -1058,11 +929,34 @@ declare enum ErrorCode {
      * 聊天室设置批量kv，一次不能超过10个
      */
     CHATROOM_KV_STORE_OUT_LIMIT = 23429,
-    SEARCH_PROPS_LIMIT_ERROR = 35022
+    SEARCH_PROPS_LIMIT_ERROR = 35022,
+    /**
+     * 非法的代理配置，RongIMProxy 为空或者非法
+     */
+    INVALID_PARAMETER_PROXY = 34238,
+    /**
+     * 代理测试服务地址为空或者非法
+     */
+    INVALID_PARAMETER_TESTHOST = 34239,
+    /**
+     * 开发者接口调用 testProxy 接口时无法联通
+     */
+    INVALID_CONNECT_TESTHOST_FAILED = 34240,
+    /**
+     * 开发者调用 connect 时 proxy 服务设置失败
+     * 移动端使用的为 31028，但web 端此状态码已经被占用，所以改为 web 端使用号码段 35XXX
+     * @discussion 设置 setProxy 接口不可在连接或正在连接中的状态调用。
+     */
+    RC_CONN_PROXY_UNAVAILABLE = 35028,
+    /**
+     * proxy 服务不可用
+     */
+    PROXY_UNAVAILABLE = 17
 }
 
 /**
  * 连接状态
+ * @deprecated 请使用 `RCConnectionStatus` 替代此枚举声明
  */
 declare enum ConnectionStatus {
     /**
@@ -1148,7 +1042,11 @@ declare enum ConnectionStatus {
     /**
      * 证书过期，SDK不会重连
      */
-    RC_LICENSE_EXPIRED = 31030
+    RC_LICENSE_EXPIRED = 31030,
+    /**
+     * Token 错误。
+     */
+    RC_CONN_USER_OR_PASSWD_ERROR = 31004
 }
 
 /**
@@ -1178,92 +1076,6 @@ declare enum ReceivedStatus {
     UNREAD = 0
 }
 
-/**
- * CMP/Comet 服务连接应答码
- */
-declare const ConnectResultCode: {
-    /**
-     * 连接成功
-     */
-    ACCEPTED: number;
-    /**
-     * 协议版本不匹配
-     * @description 暂未使用
-     */
-    UNACCEPTABLE_PROTOCOL_VERSION: number;
-    /**
-     * 客户端（移动端 TCP 连接建立时）`info` 字段格式错误
-     * @description 格式：`{平台类型}-{设备信息}-{sdk版本}`。
-     * 其中设备信息为：{手机类型}{手机型号}{网络类型，4G/WIFI}{运营商标识, 移动/电信/联通}
-     */
-    IDENTIFIER_REJECTED: number;
-    /**
-     * 不支持的平台类型，一般小程序或 PC 未开通
-     */
-    SERVER_UNAVAILABLE: number;
-    /**
-     * Token无法解析，或Token已过期
-     */
-    TOKEN_INCORRECT: number;
-    /**
-     * 防黑产规则相关应答
-     */
-    NOT_AUTHORIZED: number;
-    /**
-     * 服务重定向，一般服务扩缩容时，落点已经改变，此时 userId 链接到旧的节点时，会触发该错误。
-     * 客户端收到该应答后须重新访问导航，重新获取 CMP 地址
-     */
-    REDIRECT: number;
-    /**
-     * 暂未使用
-     */
-    PACKAGE_ERROR: number;
-    /**
-     * 该 AppKey 已经封禁或删除
-     */
-    APP_BLOCK_OR_DELETE: number;
-    /**
-     * 该用户 ID 已经被封禁
-     */
-    BLOCK: number;
-    /**
-     * Token 已过期，暂未使用
-     */
-    TOKEN_EXPIRE: number;
-    /**
-     * Token 中携带 deviceId 时，检测 Token 中 deviceId 与链接设备 deviceId 不一致
-     */
-    DEVICE_ERROR: number;
-    /**
-     * Web 端设置安全域名后，连接端域名不在安全域名范围内
-     */
-    HOSTNAME_ERROR: number;
-    /**
-     * 开启`禁止把已在线客户端踢下线`开关后，该错误码标识已有同类型端在线，禁止链接
-     */
-    HASOHTERSAMECLIENTONLINE: number;
-    /**
-     * 客户端连错环境，引发连接拒绝
-     */
-    IN_OTHER_CLUSTER: number;
-    /**
-     * app 验证Token 验证不通过。所有内部超时，访问失败,返回给客户端sdk都是验证不通过，由服务端日志去看具体是那种失败。
-     */
-    APP_AUTH_NOT_PASS: number;
-    /**
-     * One Time Password 已经被使用过
-     */
-    OTP_USED: number;
-    /**
-     * token平台验证失败
-     */
-    PLATFORM_ERROR: number;
-    /**
-     * 用户账号已销户，不再进行连接
-     */
-    USER_LOGOUT: number;
-};
-
 /**
  * 内置消息类型
  */
@@ -1328,6 +1140,14 @@ declare enum MessageType {
      * 撤回消息
     */
     RECALL = "RC:RcCmd",
+    /**
+     * 撤回通知消息
+     *
+     * 融云定义了 ObjectName 为 `RC:RcNtf` 的撤回通知消息
+     *
+     * PC: recallMessage 会替换聊天记录中的原始消息为一条 objectName 为 `RC:RcNtf` 的撤回通知消息
+     */
+    RECALL_NOTIFICATION_MESSAGE = "RC:RcNtf",
     /**
      * 已读同步状态消息
     */
@@ -1515,6 +1335,7 @@ declare enum LogTagId {
     L_DESTROY_O = "L_DESTROY_O",
     A_CONNECT_T = "A-connect-T",
     A_CONNECT_R = "A-connect-R",
+    A_CONNECT_S = "A-connect-S",
     A_DISCONNECT_O = "A-disconnect-O",
     A_RECONNECT_T = "A-reconnect-T",
     A_RECONNECT_R = "A_RECONNECT_R",
@@ -1570,6 +1391,8 @@ declare enum LogTagId {
     P_REGTYP_E = "P-regtype-E",
     L_GET_NAVI_T = "L-get_navi-T",
     L_GET_NAVI_R = "L-get_navi-R",
+    L_GET_NAVI_O = "L-get_navi-O",
+    L_PARSE_NAVI_E = "L-parse_navi-E",
     L_ENV_S = "L-Env-S",
     L_GET_INDEX_NAVI_S = "L-get_index_navi-S",
     A_JOIN_CHATROOM_T = "A-join_chatroom-T",
@@ -1580,6 +1403,7 @@ declare enum LogTagId {
     A_QUIT_CHATROOM_R = "A-quit_chatroom-R",
     L_REJOIN_CHATROOM_T = "L-rejoin_chatroom-T",
     L_REJOIN_CHATROOM_R = "L-rejoin_chatroom-R",
+    L_REJOIN_CHATROOM_S = "L-rejoin_chatroom-S",
     L_MEDIA_S = "L-media-S",
     L_MEDIA_UPLOAD_T = "L-media_upload-T",
     L_MEDIA_UPLOAD_R = "L-media_upload-R",
@@ -1589,13 +1413,17 @@ declare enum LogTagId {
     G_GET_REAL_TIMELOG_COMMAND_S = "G-get_real_timelog_command-S",
     L_CHECK_ALIVE_IM_T = "L-check_alive_im-T",
     L_CHECK_ALIVE_IM_R = "L-check_alive_im-R",
+    L_CHECK_ALIVE_IM_S = "L-check_alive_im-S",
     A_GET_HISTORY_MSG_T = "A-get_history_msg-T",
     A_GET_HISTORY_MSG_R = "A-get_history_msg-R",
     L_GET_HISTORY_MSG_T = "L-get_history_msg-T",
     L_GET_HISTORY_MSG_R = "L-get_history_msg-R",
+    A_GET_PRIVATE_MESSAGE_DELIVER_TIME_E = "A-get_privage_message_deliver_time-E",
+    A_GET_GROUP_MESSAGE_DELIVER_LIST_E = "A-get_group_message_deliver_list-E",
     A_CALLBACK_O = "A-callback-O",
     A_CALLBACK_E = "A-callback-E",
     L_CALLBACK_E = "L-callback-E",
+    A_GET_TOP_CONVERSATION_LIST_E = "A-get_top_conversation_list-E",
     /**
      * PB 数据编码错误
      */
@@ -1621,6 +1449,7 @@ declare enum LogTagId {
     L_UNKNOWN_TOPIC_E = "L_UNKNOWN_TOPIC_E",
     L_RECV_RMTP_O = "L_RECV_RMTP_O",
     L_RECV_RMTP_E = "L_RECV_RMTP_E",
+    L_RECV_S_NTF_O = "L-recv_s_ntf_O",
     /** 版本号上报 */
     L_VER_REPORT_T = "L-VER_REPORT-T",
     /** 版本号上报结果 */
@@ -1629,7 +1458,10 @@ declare enum LogTagId {
     L_CALL_MAIN_SYNC_O = "L_CALL_MAIN_SYNC_O",
     /** 未知的通知 */
     L_UNSUPPORT_NTF_FROM_MAIN_E = "L_UNSUPPORT_NTF_FROM_MAIN_E",
-    A_SET_MSG_CONTENT_O = "A_SET_MSG_CONTENT_O"
+    A_SET_MSG_CONTENT_O = "A_SET_MSG_CONTENT_O",
+    A_REMOVE_PROXY_O = "A-remove_proxy-O",
+    A_SET_PROXY_O = "A-set_proxy-O",
+    A_TEST_PROXY_O = "A-test_proxy-O"
 }
 
 /**
@@ -2432,6 +2264,13 @@ interface IUltraUnreadMsg {
     mentionedType?: number;
 }
 
+interface IMentionInfo {
+    type: MentionedType;
+    /**
+     * 被 @ 的用户 Id 列表，仅在 `type` 为 `2` 时有效
+     */
+    userIdList: string[];
+}
 /**
  * 从服务器拉取到的会话数据结构
  * @category Interface
@@ -2467,16 +2306,7 @@ interface IReceivedConversation {
     /**
      * 消息中的 @ 数据，仅在 `conversationType` 为 `ConversationType.GROUP` 时有效
      */
-    mentionedInfo?: {
-        /**
-         * `@ 类型，其中 1 为 @ 所有人，2 为 @ 部分人`
-         */
-        type: 1 | 2;
-        /**
-         * 被 @ 的用户 Id 列表，仅在 `type` 为 `2` 时有效
-         */
-        userIdList: string[];
-    } | null;
+    mentionedInfo?: IMentionInfo | null;
     /**
      * 会话免打扰状态
      * @description
@@ -2630,742 +2460,855 @@ interface IUltraUnreadConversation {
 }
 
 /**
- * 导航信息数据就结构
+ * @category Interface
  */
-interface INaviInfo {
+interface IChatroomEntryListenerData {
     /**
-     * Navi 数据请求响应码，200 为成功请求
-     */
-    code: number;
+     * 更新的键
+    */
+    key: string;
     /**
-     * 获取 Navi 数据失败时的提示信息
-     */
-    errorMessage?: string;
+     * 更新的值
+    */
+    value: string;
     /**
-     * 获取 Navi 数据失败时的请求 url 信息
-     */
-    url?: string;
+     * 更新的时间
+    */
+    timestamp: number;
     /**
-     * 请求导航数据时使用的协议：http / https
-     * @description 该字段为 SDK 内增加的字段，导航接口数据中不存在
-     */
-    protocol: 'http' | 'https';
+     * 更新的聊天室 ID
+    */
+    chatroomId: string;
     /**
-     * 获取导航时使用的 userId，小程序不走导航，故拿不到 userId
-     */
-    userId?: string;
+     * 更新类型
+    */
+    type: ChatroomEntryType;
+}
+/**
+ * @category Interface
+ */
+interface IChatroomRejoinedFailed {
     /**
-     * CMP 服务 Websocket 连接地址，包含域名与端口，不含 ws 或 wss 协议头
-     * @example a.domain.com:443
+     * 自动重新加入的聊天室 ID
+    */
+    chatroomId: string;
+    /**
+     * 自动重新加入失败的 code
+    */
+    errorCode: number;
+}
+/**
+ * @category Interface
+ */
+interface IChatroomRejoinedSuccessed {
+    /**
+     * 自动重新加入的聊天室 ID
+    */
+    chatroomId: string;
+    /**
+     * 自动重新加入的聊天室拉取消息的数量
+    */
+    count: number;
+}
+/**
+ * @category Interface
+ */
+interface IChatroomUserChangeInfo {
+    users: {
+        [userId: string]: ChatroomUserChangeType;
+    };
+    chatroomId: string;
+}
+declare type IChatroomRejoinedInfo = IChatroomRejoinedFailed | IChatroomRejoinedSuccessed;
+/**
+ * 聊天室信息
+ * @category Interface
+*/
+interface IChatroomListenerData {
+    /**
+     * SDK 内部重连聊天室信息
+    */
+    rejoinedRoom?: IChatroomRejoinedInfo;
+    /**
+     * 监听到的聊天室 KV 更新
+    */
+    updatedEntries?: IChatroomEntryListenerData[];
+    /**
+     * 登录退出的用户通知
      */
-    server: string;
+    userChange?: IChatroomUserChangeInfo;
     /**
-     * 备用 CMP 服务地址，包含域名与端口，不含 ws 或 wss 协议头，多个备用地址以 ',' 分割
-     * @example a.domain.com:443,b.domain.com:443
+     * 聊天室销毁
      */
-    backupServer?: string;
+    chatroomDestroyed?: string;
+}
+/**
+ * @category Interface
+ */
+interface IChatroomEntry {
     /**
-     * 备用 CMP 服务地址，POST 请求 TCP 连接返回的是 bs 字段，非 backupServer 字段
+     * 属性名称, 支持英文字母、数字、+、=、-、_ 的组合方式, 最大长度 128 字符
      */
-    bs?: string;
+    key: string;
     /**
-     * RTC 服务配置，其值可能为 null、无效字符串、有效 JSON 字符串
-     * 1. 公有云未开通音视频时，值为 null
-     * 2. 私有云无配置时为 `{ "strategy": 0 }`
+     * 属性对应的值, 最大长度 4096 字符
      */
-    voipCallInfo: string | null;
+    value: string;
     /**
-     * 聊天室 kv 存储开关
-     * @todo 需确认详细有效值
-     * @description 公有云独有配置
+     * 设置成功后是否发送通知消息
      */
-    kvStorage: number;
+    isSendNotification?: boolean;
     /**
-     * HttpDNS 功能开关，在 web 端无效
-     * @description 公有云独有配置
+     * RC:chrmKVNotiMsg 消息中携带的附加信息
      */
-    openHttpDNS: boolean;
+    notificationExtra?: string;
     /**
-     * 历史消息云存储功能开关
-     * @description
-     * 1. 公有云通过 `developer.rongcloud.cn` 管理后台 `单群聊消息云端存储` 功能开关进行配置
-     * 2. 私有云默认为 `true`
+     * 用户退出聊天室时是否清除此属性
      */
-    historyMsg: boolean;
+    isAutoDelete?: boolean;
+}
+/**
+ * @category Interface
+ */
+interface IChatroomUser {
     /**
-     * 聊天室历史消息开关
-     * @description
-     * 1. 私有云对聊天室功能支持有限，默认为 `false`
-     * 2. TODO: 公有云配置待确认
+     * 用户 id
      */
-    chatroomMsg: boolean;
+    id: string;
     /**
-     * 文件服务器地址
-     * @description
-     * 1. 公有云下，该地址为七牛云服务器地址
-     * 2. 私有云下，该地址为私有云自研文件服务器地址
+     * 加入聊天室的时间
      */
-    uploadServer: string;
+    time: number;
+}
+/**
+ * @category Interface
+ */
+interface IChatroomInfo {
     /**
-     * 实时位置共享配置，web 端无需处理
+     * 成员列表
+     * @todo 需确认数组元素的数据结构
      */
-    location: null | string;
+    userInfos: IChatroomUser[];
     /**
-     * 实时日志上传开关
-     * @todo 需确认有效值及作用
+     * 房间内总人数
      */
-    monitor: number;
+    userCount: number;
+}
+/**
+ * @category Interface
+ */
+interface IRemoveChatroomEntry {
     /**
-     * 是否允许加入多聊天室开关
+     * 属性名称, 支持英文字母、数字、+、=、-、_ 的组合方式, 最大长度 128 字符
      */
-    joinMChrm: boolean;
+    key: string;
     /**
-     * 是否开启公众号功能：`0` 为未开启，`1` 为已开启
+     * 删除成功后是否发送通知消息
      */
-    openMp: 0 | 1;
+    isSendNotification?: boolean;
     /**
-     * 是否开启用户级配置，若开启，需连接成功后立即拉取实时配置，0 | 1
-     * @description
-     * 配置来源:
-     * 1. 导航
-     * 2. 服务端实时下发
-     * 已有配置字段:
-     * 1. Lan. 推送使用的语言设置，用户端可自定义修改. Web 端未做设置, 只做接收
-     * 2. ShPushSwit. 推送是否显示详情设置，用户端可自定义修改. Web 端未做设置, 只做接收
-     * 3. MobPushSwit: Web/PC 在线，移动端不在线是否发送推送开关，用户端可自定义修改. Web 端未做设置, 只做接收
-     * 4. OffMsgDur: 离线消息保存天数，设置天数不可大于App级对应配置，用户端可自定义修改. Web 端未做设置, 只做接收
-     * 5. VoipInfo: 音视频相关配置，用户端不可自定义修改. 由服务端决定，与导航下发格式一致
-     * @todo 需确认公有云与私有云区别
+     * RC:chrmKVNotiMsg 消息中携带的附加信息
      */
-    openUS: 0 | 1;
+    notificationExtra?: string;
+}
+/**
+ * @category Interface
+ */
+interface IRemoveChatroomEntries {
     /**
-     * 超级群功能开关,1表示开
+     * key 属性名称, 支持英文字母、数字、+、=、-、_ 的组合方式, 最大长度 128 字符
      */
-    ugMsg?: 0 | 1;
+    entries: {
+        key: string;
+    }[];
     /**
-     * 群离线消息最大下发条数，`0` 为关闭
-     * @description 公有云独有配合
+     * 删除成功后是否发送通知消息
      */
-    grpMsgLimit: number;
     /**
-     * 消息加密开关，0 为关闭
-     * @todo
-     * 1. 确定其控制的功能
-     * 2. 确定 web 相关性
+     * RC:chrmKVNotiMsg 消息中携带的附加信息
      */
-    isFormatted: number;
+    notificationExtra?: string;
+}
+/**
+ * @category Interface
+ */
+interface IChatroomEntries {
     /**
-     * GIF 动图大小限制，默认 2048 KB
+     * entries ,要设置的属性列表
+     * key 属性名称, 支持英文字母、数字、+、=、-、_ 的组合方式, 最大长度 128 字符
+     * value 属性对应的值, 最大长度 4096 字符
      */
-    gifSize: number;
+    entries: {
+        key: string;
+        value: string;
+    }[];
     /**
-     * 上传小视频时长限制，单位：秒
-     * @description 公有云字段，即私有云配置中的 `uploadVideoTimeLimit`
+     * 设置成功后是否发送通知消息
      */
-    videoTimes?: number;
     /**
-     * 上传小视频时长限制，单位：秒
-     * @description 私有云字段，即公有云配置中的 `videoTimes`
+     * RC:chrmKVNotiMsg 消息中携带的附加信息
      */
-    uploadVideoTimeLimit?: number;
+    notificationExtra?: string;
     /**
-     * 实时日志上传开关：`0` 为关闭，`1` 为开启
+     * 用户退出聊天室时是否清除此属性
      */
-    logSwitch: number;
+    isAutoDelete?: boolean;
     /**
-     * 实时日志上传策略，值为 JSON 字符串
-     * @example `'{
-     * "url": "logcollection.ronghub.com", // 上传地址
-     * "level": 1,                         // 日志等级
-     * "itv": 6,                           // 上传频率，即时间间隔，单位 s
-     * "times": 5                          // 重试次数？
-     * }'`
+     * 是否强制覆盖
      */
-    logPolicy: string;
+    isForce?: boolean;
+}
+
+/**
+ * @category Interface
+ */
+interface IUploadAuth {
     /**
-     * 百度 BOS 存储服务地址
-     * @description 公有云独有配置
-     * @example `gz.bcebos.com`
-     */
-    bosAddr?: string;
+     * 七牛 token 有效期
+    */
+    deadline: number;
     /**
-     * 阿里上传配置，字符串数组，数组顺序代表 七牛、百度、阿里云 上传权重
-     * @example
-     * ```
-     * `[{"qiniu":"upload.qiniup.com","p":"1"},
-     *  {"baidu":"gz.bcebos.com","p":"2"},
-     *  {"aliyun":"oss-cn-beijing.aliyuncs.com","p":"3"}]`
-     * ```
+     * 七牛上传 token
+    */
+    token: string;
+    /**
+     * 百度上传 token
+    */
+    bosToken: string;
+    /**
+     * 百度上传 header Date
+    */
+    bosDate: string;
+    /**
+     * 百度上传路径
+    */
+    path: string;
+    /**
+     * 上传文件名，阿里上传获取下载地址时，必须使用上传文件名，所以需抛出到业务端
      */
-    ossConfig?: string;
+    fileName: string;
     /**
-     * 私有云专有属性，可用来判断当前环境是公有云还是私有云，私有云环境下该值为 `1`
+     * 阿里云 oss 的 AccessKeyId
      */
-    type?: number;
+    osskeyId: string;
     /**
-     * @deprecated 已废弃
+     * 阿里云 oss post 请求表单域中的字段 policy
      */
-    compDays: number;
+    ossPolicy: string;
     /**
-     * @deprecated 已废弃
+     * 阿里云 oss 根据 policy 计算的签名信息
      */
-    msgAck: unknown;
+    ossSign: string;
     /**
-     * @deprecated 已废弃
+     * 阿里云 oss 存储空间名称
      */
-    activeServer: string;
+    ossBucketName: string;
     /**
-     * @deprecated 已废弃
+     * s3 认证凭证，对应 post上传 x-amz-credential 字段
      */
-    qnAddr: string;
+    s3Credential: string;
     /**
-     * @deprecated 已废弃
+     * 加密算法，对应 post上传 x-amz-algorithm 字段
      */
-    extkitSwitch: number;
+    s3Algorithm: string;
     /**
-     * @deprecated 已废弃
+     * s3 日期，对应 post上传 x-amz-date 字段
      */
-    alone: boolean;
+    s3Date: string;
     /**
-     * @deprecated 已废弃
+     * s3 policy，对应 post上传 policy 字段
      */
-    voipServer: string;
+    s3Policy: string;
     /**
-     * 离线日志上报地址
-     * @deprecated 已废弃
+     * s3 签名信息，对应 post上传 x-amz-signature 字段
      */
-    offlinelogserver: string;
+    s3Signature: string;
     /**
-     * 在线日志上报地址
-     * @deprecated 已废弃
+     * s3 存储空间名称
      */
-    onlinelogserver?: string;
+    s3BucketName: string;
     /**
-     * 链路加密字段，内容为 JSON 字符串，仅限 C++ 可用
+     * stc  Authorization 头
      */
-    crypto?: string;
+    stcAuthorization: string;
     /**
-     * 群组回执开关, 1: 打开，0(或者没有): 关闭
+     * stc  xAmzContentSha256
      */
-    grpRRVer?: number;
+    stcContentSha256: string;
     /**
-     * 防黑产开关, 1: 打开，0：关闭
+     * stc date
      */
-    openAnti?: number;
+    stcDate: string;
     /**
-     * 鉴权认证
+     * stc 存储空间名称
      */
-    jwt?: string;
+    stcBucketName: string;
 }
 
-/**
- * @category Interface
- */
-interface IChatroomEntryListenerData {
-    /**
-     * 更新的键
-    */
-    key: string;
-    /**
-     * 更新的值
-    */
-    value: string;
-    /**
-     * 更新的时间
-    */
-    timestamp: number;
-    /**
-     * 更新的聊天室 ID
-    */
-    chatroomId: string;
-    /**
-     * 更新类型
-    */
-    type: ChatroomEntryType;
+interface IRTCRoomInfo {
+    roomId: string;
+    roomData: unknown[];
+    userCount: number;
+    list: unknown[];
 }
-/**
- * @category Interface
- */
-interface IChatroomRejoinedFailed {
-    /**
-     * 自动重新加入的聊天室 ID
-    */
-    chatroomId: string;
-    /**
-     * 自动重新加入失败的 code
-    */
-    errorCode: number;
+interface IRtcTokenData {
+    rtcToken: string;
 }
-/**
- * @category Interface
- */
-interface IChatroomRejoinedSuccessed {
-    /**
-     * 自动重新加入的聊天室 ID
-    */
-    chatroomId: string;
-    /**
-     * 自动重新加入的聊天室拉取消息的数量
-    */
-    count: number;
+interface IRTCUsers {
+    users: {
+        [userId: string]: {
+            /**
+             * 发布的资源数据，是一个 JSON 字符串，解析后为发布的资源列表
+             */
+            uris?: string;
+            /**
+             * 加房间的身份标识，保存主房间 roomId
+             */
+            extra?: string;
+        };
+    };
+}
+interface IJoinRTCRoomData extends IRTCUsers {
+    token: string;
+    sessionId: string;
+    roomInfo: {
+        key: string;
+        value: string;
+    }[];
+    kvEntries: IServerRTCRoomEntry[];
+    offlineKickTime: number;
+}
+interface KVString {
+    [key: string]: string;
 }
 /**
- * @category Interface
+ * 设置 RTC 人员 inner、outer 数据
  */
-interface IChatroomUserChangeInfo {
-    users: {
-        [userId: string]: ChatroomUserChangeType;
-    };
-    chatroomId: string;
+interface IRTCUserData {
+    [key: string]: string;
 }
-declare type IChatroomRejoinedInfo = IChatroomRejoinedFailed | IChatroomRejoinedSuccessed;
+
 /**
- * 聊天室信息
  * @category Interface
-*/
-interface IChatroomListenerData {
+ */
+interface IAsyncRes<T = void> {
     /**
-     * SDK 内部重连聊天室信息
-    */
-    rejoinedRoom?: IChatroomRejoinedInfo;
+     * Promise 执行结果
+     */
+    code: ErrorCode;
     /**
-     * 监听到的聊天室 KV 更新
-    */
-    updatedEntries?: IChatroomEntryListenerData[];
+     * 结果数据
+     */
+    data?: T;
     /**
-     * 登录退出的用户通知
+     * 错误消息
      */
-    userChange?: IChatroomUserChangeInfo;
+    msg?: string;
+}
+/**
+ * 异步任务结果定义
+ * @description
+ * 通过 `Promise.resolve` 来处理预期内的异常，进而通过 Uncatch Promise Error 暴露预期外的异常
+ */
+declare type IPromiseResult<T = void> = Promise<IAsyncRes<T>>;
+interface IConnectResult {
     /**
-     * 聊天室销毁
+     * 连接错误码
      */
-    chatroomDestroyed?: string;
+    code: ErrorCode;
+    /**
+     * 导航获取成功后即可有相应的值，在导航数据获取完成之前该值为 undefined
+     */
+    userId?: string;
 }
+
 /**
- * @category Interface
+ * 代理信息
  */
-interface IChatroomEntry {
+interface IProxy {
+    socksHost: string;
+    socksPort: number;
+    socksUsername?: string;
+    socksPassword?: string;
+}
+
+declare enum HttpMethod {
+    GET = "GET",
+    POST = "POST"
+}
+interface IRequest {
+    url: string;
     /**
-     * 属性名称, 支持英文字母、数字、+、=、-、_ 的组合方式, 最大长度 128 字符
+     * @default `HttpMethod.GET`
      */
-    key: string;
+    method?: HttpMethod | 'GET' | 'POST';
     /**
-     * 属性对应的值, 最大长度 4096 字符
+     * 查询数据
      */
-    value: string;
+    query?: {
+        [key: string]: string | number | null;
+    };
     /**
-     * 设置成功后是否发送通知消息
+     * Request Header 信息
      */
-    isSendNotification?: boolean;
+    headers?: {
+        [key: string]: string;
+    };
     /**
-     * RC:chrmKVNotiMsg 消息中携带的附加信息
+     * Request Body 数据
      */
-    notificationExtra?: string;
+    body?: Object | string;
     /**
-     * 用户退出聊天室时是否清除此属性
+     * 超时设置，默认 `60s`
      */
-    isAutoDelete?: boolean;
-}
-/**
- * @category Interface
- */
-interface IChatroomUser {
+    timeout?: number;
     /**
-     * 用户 id
+     * 【Alipay-Only】
+     * 期望返回的数据格式，如果为 json 则返回后会对返回的数据进行一次 JSON.parse
      */
-    id: string;
+    dataType?: 'json' | 'text' | 'base64' | 'arraybuffer';
     /**
-     * 加入聊天室的时间
+     * socks5 代理参数，仅 Electron 平台有效，web 平台默认为 null
      */
-    time: number;
+    proxy?: IProxy | null;
+}
+interface IStorage {
+    setItem(key: string, value: string): void;
+    getItem(key: string): string | null;
+    removeItem(key: string): void;
+    clear(): void;
+}
+interface IResponse {
+    status: number;
+    data?: string;
 }
 /**
- * @category Interface
+ * 网络状态枚举
  */
-interface IChatroomInfo {
+declare enum NetworkType {
+    WIFI = "wifi",
+    FOUR_G = "4g",
+    THREE_G = "3g",
+    TWO_G = "2g",
+    FIVE_G = "2g",
+    THREE_GENT = "3gnet",
+    UNKONWN = "unknown"
+}
+interface IWebSocket {
     /**
-     * 成员列表
-     * @todo 需确认数组元素的数据结构
+     * 监听连接建立事件，此时 WebSocket 实例已准备好收发数据
+     * @param callback
      */
-    userInfos: IChatroomUser[];
+    onOpen(callback: () => void): void;
     /**
-     * 房间内总人数
+     * 监听连接关闭事件
+     * @param callback
      */
-    userCount: number;
-}
-/**
- * @category Interface
- */
-interface IRemoveChatroomEntry {
+    onClose(callback: (code?: number, reason?: string) => void): void;
     /**
-     * 属性名称, 支持英文字母、数字、+、=、-、_ 的组合方式, 最大长度 128 字符
+     * 监听接收服务器消息事件
+     * @param callback
      */
-    key: string;
+    onMessage(callback: (data: string | ArrayBuffer) => void): void;
     /**
-     * 删除成功后是否发送通知消息
+     * 监听链接错误事件
+     * @param callback
      */
-    isSendNotification?: boolean;
+    onError(callback: (error: unknown) => void): void;
     /**
-     * RC:chrmKVNotiMsg 消息中携带的附加信息
+     * 向服务器发送数据
+     * @param data
      */
-    notificationExtra?: string;
+    send(data: ArrayBuffer | string): void;
+    /**
+     * 关闭连接
+     * @param code
+     * @param reason
+     */
+    close(code?: number, reason?: string): void;
 }
 /**
- * @category Interface
+ * 平台运行时抽象
  */
-interface IRemoveChatroomEntries {
+interface IRuntime {
     /**
-     * key 属性名称, 支持英文字母、数字、+、=、-、_ 的组合方式, 最大长度 128 字符
+     * 平台标识
      */
-    entries: {
-        key: string;
-    }[];
+    tag: string;
     /**
-     * 删除成功后是否发送通知消息
+     * 发送 http 请求
+     * @param options
      */
+    httpReq(options: IRequest): Promise<IResponse>;
     /**
-     * RC:chrmKVNotiMsg 消息中携带的附加信息
+     * 是否使用导航
      */
-    notificationExtra?: string;
-}
-/**
- * @category Interface
- */
-interface IChatroomEntries {
+    useNavi: boolean;
     /**
-     * entries ,要设置的属性列表
-     * key 属性名称, 支持英文字母、数字、+、=、-、_ 的组合方式, 最大长度 128 字符
-     * value 属性对应的值, 最大长度 4096 字符
+     * websocket 地址上附加的平台字段
      */
-    entries: {
-        key: string;
-        value: string;
-    }[];
+    connectPlatform: string;
     /**
-     * 设置成功后是否发送通知消息
+     * websocket 地址上 apiVer 字段，代表代码是否来源于 uniapp
      */
+    isFromUniapp: boolean;
     /**
-     * RC:chrmKVNotiMsg 消息中携带的附加信息
+     * 创建长连接实例
      */
-    notificationExtra?: string;
+    createWebSocket(url: string, protocols?: string[]): IWebSocket;
     /**
-     * 用户退出聊天室时是否清除此属性
+     * 存储模块
      */
-    isAutoDelete?: boolean;
+    localStorage: IStorage;
     /**
-     * 是否强制覆盖
+     * 在某些非浏览器平台，其等同于 localStorage
      */
-    isForce?: boolean;
+    sessionStorage: IStorage;
+    /**
+     * 获取网络状态
+     * 2g 3g 4g wifi unkown
+     */
+    getNetworkType(): Promise<NetworkType>;
 }
 
 /**
- * @category Interface
+ * 拓展方法定义，便于 electron-solution 实现时保持接口类型推导可用
  */
-interface IUploadAuth {
+interface IExtraMethod {
+    getConversationsByPage(conversationTypes: ConversationType[], sentTime: number, count: number, channelId?: string): Promise<IAsyncRes<IReceivedConversation[]>>;
+    getHistoryMessagesByObjectNames(conversationType: ConversationType, targetId: string, sentTime: number, count: number, objectNames: string[], desc: 0 | 1, tag: string): Promise<IAsyncRes<{
+        list: IReceivedMessage[];
+        hasMore: boolean;
+    }>>;
+    updateMessageReceiptStatus(conersationType: ConversationType, targetId: string, timestamp: number, channelId?: string): Promise<IAsyncRes<boolean>>;
+}
+
+/**
+ * 导航信息数据就结构
+ */
+interface INaviInfo {
     /**
-     * 七牛 token 有效期
-    */
-    deadline: number;
+     * Navi 数据请求响应码，200 为成功请求
+     */
+    code: number;
     /**
-     * 七牛上传 token
-    */
-    token: string;
+     * 获取 Navi 数据失败时的提示信息
+     */
+    errorMessage?: string;
     /**
-     * 百度上传 token
-    */
-    bosToken: string;
+     * 获取 Navi 数据失败时的请求 url 信息
+     */
+    url?: string;
     /**
-     * 百度上传 header Date
-    */
-    bosDate: string;
+     * 请求导航数据时使用的协议：http / https
+     * @description 该字段为 SDK 内增加的字段，导航接口数据中不存在
+     */
+    protocol: 'http' | 'https';
     /**
-     * 百度上传路径
-    */
-    path: string;
+     * 获取导航时使用的 userId，小程序不走导航，故拿不到 userId
+     */
+    userId?: string;
     /**
-     * 上传文件名，阿里上传获取下载地址时，必须使用上传文件名，所以需抛出到业务端
+     * CMP 服务 Websocket 连接地址，包含域名与端口，不含 ws 或 wss 协议头
+     * @example a.domain.com:443
      */
-    fileName: string;
+    server: string;
     /**
-     * 阿里云 oss 的 AccessKeyId
+     * 备用 CMP 服务地址，包含域名与端口，不含 ws 或 wss 协议头，多个备用地址以 ',' 分割
+     * @example a.domain.com:443,b.domain.com:443
      */
-    osskeyId: string;
+    backupServer?: string;
     /**
-     * 阿里云 oss post 请求表单域中的字段 policy
+     * 备用 CMP 服务地址，POST 请求 TCP 连接返回的是 bs 字段，非 backupServer 字段
      */
-    ossPolicy: string;
+    bs?: string;
     /**
-     * 阿里云 oss 根据 policy 计算的签名信息
+     * RTC 服务配置，其值可能为 null、无效字符串、有效 JSON 字符串
+     * 1. 公有云未开通音视频时，值为 null
+     * 2. 私有云无配置时为 `{ "strategy": 0 }`
      */
-    ossSign: string;
+    voipCallInfo: string | null;
     /**
-     * 阿里云 oss 存储空间名称
+     * 聊天室 kv 存储开关
+     * @todo 需确认详细有效值
+     * @description 公有云独有配置
      */
-    ossBucketName: string;
+    kvStorage: number;
     /**
-     * s3 认证凭证，对应 post上传 x-amz-credential 字段
+     * HttpDNS 功能开关，在 web 端无效
+     * @description 公有云独有配置
      */
-    s3Credential: string;
+    openHttpDNS: boolean;
     /**
-     * 加密算法，对应 post上传 x-amz-algorithm 字段
+     * 历史消息云存储功能开关
+     * @description
+     * 1. 公有云通过 `developer.rongcloud.cn` 管理后台 `单群聊消息云端存储` 功能开关进行配置
+     * 2. 私有云默认为 `true`
      */
-    s3Algorithm: string;
+    historyMsg: boolean;
     /**
-     * s3 日期，对应 post上传 x-amz-date 字段
+     * 聊天室历史消息开关
+     * @description
+     * 1. 私有云对聊天室功能支持有限，默认为 `false`
+     * 2. TODO: 公有云配置待确认
      */
-    s3Date: string;
+    chatroomMsg: boolean;
     /**
-     * s3 policy，对应 post上传 policy 字段
+     * 文件服务器地址
+     * @description
+     * 1. 公有云下，该地址为七牛云服务器地址
+     * 2. 私有云下，该地址为私有云自研文件服务器地址
      */
-    s3Policy: string;
+    uploadServer: string;
     /**
-     * s3 签名信息，对应 post上传 x-amz-signature 字段
+     * 实时位置共享配置，web 端无需处理
      */
-    s3Signature: string;
+    location: null | string;
     /**
-     * s3 存储空间名称
+     * 实时日志上传开关
+     * @todo 需确认有效值及作用
      */
-    s3BucketName: string;
+    monitor: number;
     /**
-     * stc  Authorization 头
+     * 是否允许加入多聊天室开关
      */
-    stcAuthorization: string;
+    joinMChrm: boolean;
     /**
-     * stc  xAmzContentSha256
+     * 是否开启公众号功能：`0` 为未开启，`1` 为已开启
      */
-    stcContentSha256: string;
+    openMp: 0 | 1;
     /**
-     * stc date
+     * 是否开启用户级配置，若开启，需连接成功后立即拉取实时配置，0 | 1
+     * @description
+     * 配置来源:
+     * 1. 导航
+     * 2. 服务端实时下发
+     * 已有配置字段:
+     * 1. Lan. 推送使用的语言设置，用户端可自定义修改. Web 端未做设置, 只做接收
+     * 2. ShPushSwit. 推送是否显示详情设置，用户端可自定义修改. Web 端未做设置, 只做接收
+     * 3. MobPushSwit: Web/PC 在线，移动端不在线是否发送推送开关，用户端可自定义修改. Web 端未做设置, 只做接收
+     * 4. OffMsgDur: 离线消息保存天数，设置天数不可大于App级对应配置，用户端可自定义修改. Web 端未做设置, 只做接收
+     * 5. VoipInfo: 音视频相关配置，用户端不可自定义修改. 由服务端决定，与导航下发格式一致
+     * @todo 需确认公有云与私有云区别
      */
-    stcDate: string;
+    openUS: 0 | 1;
     /**
-     * stc 存储空间名称
+     * 超级群功能开关,1表示开
      */
-    stcBucketName: string;
-}
-
-interface IRTCRoomInfo {
-    roomId: string;
-    roomData: unknown[];
-    userCount: number;
-    list: unknown[];
-}
-interface IRtcTokenData {
-    rtcToken: string;
-}
-interface IRTCUsers {
-    users: {
-        [userId: string]: {
-            /**
-             * 发布的资源数据，是一个 JSON 字符串，解析后为发布的资源列表
-             */
-            uris?: string;
-            /**
-             * 加房间的身份标识，保存主房间 roomId
-             */
-            extra?: string;
-        };
-    };
-}
-interface IJoinRTCRoomData extends IRTCUsers {
-    token: string;
-    sessionId: string;
-    roomInfo: {
-        key: string;
-        value: string;
-    }[];
-    kvEntries: IServerRTCRoomEntry[];
-    offlineKickTime: number;
-}
-interface KVString {
-    [key: string]: string;
-}
-/**
- * 设置 RTC 人员 inner、outer 数据
- */
-interface IRTCUserData {
-    [key: string]: string;
-}
-
-/**
- * @category Interface
- */
-interface IAsyncRes<T = void> {
+    ugMsg?: 0 | 1;
     /**
-     * Promise 执行结果
+     * 群离线消息最大下发条数，`0` 为关闭
+     * @description 公有云独有配合
      */
-    code: ErrorCode;
+    grpMsgLimit: number;
     /**
-     * 结果数据
+     * 消息加密开关，0 为关闭
+     * @todo
+     * 1. 确定其控制的功能
+     * 2. 确定 web 相关性
      */
-    data?: T;
+    isFormatted: number;
     /**
-     * 错误消息
+     * GIF 动图大小限制，默认 2048 KB
      */
-    msg?: string;
-}
-/**
- * 异步任务结果定义
- * @description
- * 通过 `Promise.resolve` 来处理预期内的异常，进而通过 Uncatch Promise Error 暴露预期外的异常
- */
-declare type IPromiseResult<T = void> = Promise<IAsyncRes<T>>;
-interface IConnectResult {
+    gifSize: number;
     /**
-     * 连接错误码
+     * 上传小视频时长限制，单位：秒
+     * @description 公有云字段，即私有云配置中的 `uploadVideoTimeLimit`
      */
-    code: ErrorCode;
+    videoTimes?: number;
     /**
-     * 导航获取成功后即可有相应的值，在导航数据获取完成之前该值为 undefined
+     * 上传小视频时长限制，单位：秒
+     * @description 私有云字段，即公有云配置中的 `videoTimes`
      */
-    userId?: string;
-}
-
-declare enum HttpMethod {
-    GET = "GET",
-    POST = "POST"
-}
-interface IRequest {
-    url: string;
+    uploadVideoTimeLimit?: number;
     /**
-     * @default `HttpMethod.GET`
+     * 实时日志上传开关：`0` 为关闭，`1` 为开启
      */
-    method?: HttpMethod | 'GET' | 'POST';
+    logSwitch: number;
     /**
-     * 查询数据
+     * 实时日志上传策略，值为 JSON 字符串
+     * @example `'{
+     * "url": "logcollection.ronghub.com", // 上传地址
+     * "level": 1,                         // 日志等级
+     * "itv": 6,                           // 上传频率，即时间间隔，单位 s
+     * "times": 5                          // 重试次数？
+     * }'`
      */
-    query?: {
-        [key: string]: string | number | null;
-    };
+    logPolicy: string;
     /**
-     * Request Header 信息
+     * 百度 BOS 存储服务地址
+     * @description 公有云独有配置
+     * @example `gz.bcebos.com`
      */
-    headers?: {
-        [key: string]: string;
-    };
+    bosAddr?: string;
     /**
-     * Request Body 数据
+     * 阿里上传配置，字符串数组，数组顺序代表 七牛、百度、阿里云 上传权重
+     * @example
+     * ```
+     * `[{"qiniu":"upload.qiniup.com","p":"1"},
+     *  {"baidu":"gz.bcebos.com","p":"2"},
+     *  {"aliyun":"oss-cn-beijing.aliyuncs.com","p":"3"}]`
+     * ```
      */
-    body?: Object | string;
+    ossConfig?: string;
     /**
-     * 超时设置，默认 `60s`
+     * 私有云专有属性，可用来判断当前环境是公有云还是私有云，私有云环境下该值为 `1`
      */
-    timeout?: number;
+    type?: number;
     /**
-     * 【Alipay-Only】
-     * 期望返回的数据格式，如果为 json 则返回后会对返回的数据进行一次 JSON.parse
+     * @deprecated 已废弃
      */
-    dataType?: 'json' | 'text' | 'base64' | 'arraybuffer';
-}
-interface IStorage {
-    setItem(key: string, value: string): void;
-    getItem(key: string): string | null;
-    removeItem(key: string): void;
-    clear(): void;
-}
-interface IResponse {
-    status: number;
-    data?: string;
-}
-/**
- * 网络状态枚举
- */
-declare enum NetworkType {
-    WIFI = "wifi",
-    FOUR_G = "4g",
-    THREE_G = "3g",
-    TWO_G = "2g",
-    FIVE_G = "2g",
-    THREE_GENT = "3gnet",
-    UNKONWN = "unknown"
-}
-interface IWebSocket {
+    compDays: number;
     /**
-     * 监听连接建立事件，此时 WebSocket 实例已准备好收发数据
-     * @param callback
+     * @deprecated 已废弃
      */
-    onOpen(callback: () => void): void;
+    msgAck: unknown;
     /**
-     * 监听连接关闭事件
-     * @param callback
+     * @deprecated 已废弃
      */
-    onClose(callback: (code?: number, reason?: string) => void): void;
+    activeServer: string;
+    /**
+     * @deprecated 已废弃
+     */
+    qnAddr: string;
+    /**
+     * @deprecated 已废弃
+     */
+    extkitSwitch: number;
+    /**
+     * @deprecated 已废弃
+     */
+    alone: boolean;
+    /**
+     * @deprecated 已废弃
+     */
+    voipServer: string;
+    /**
+     * 离线日志上报地址
+     * @deprecated 已废弃
+     */
+    offlinelogserver: string;
+    /**
+     * 在线日志上报地址
+     * @deprecated 已废弃
+     */
+    onlinelogserver?: string;
     /**
-     * 监听接收服务器消息事件
-     * @param callback
+     * 链路加密字段，内容为 JSON 字符串，仅限 C++ 可用
      */
-    onMessage(callback: (data: string | ArrayBuffer) => void): void;
+    crypto?: string;
     /**
-     * 监听链接错误事件
-     * @param callback
+     * 群组回执开关, 1: 打开，0(或者没有): 关闭
      */
-    onError(callback: (error: unknown) => void): void;
+    grpRRVer?: number;
     /**
-     * 向服务器发送数据
-     * @param data
+     * 防黑产开关, 1: 打开，0：关闭
      */
-    send(data: ArrayBuffer | string): void;
+    openAnti?: number;
     /**
-     * 关闭连接
-     * @param code
-     * @param reason
+     * 鉴权认证
      */
-    close(code?: number, reason?: string): void;
+    jwt?: string;
 }
+
+declare type INaviCache = {
+    token: string;
+    naviInfo: INaviInfo;
+    timestamp: number;
+};
 /**
- * 平台运行时抽象
+ * 导航数据管理类，负责管理导航有效期、导航请求、导航缓存
  */
-interface IRuntime {
+declare abstract class BasicNavi {
+    protected readonly appkey: string;
+    protected readonly logger: BasicLogger;
     /**
-     * 平台标识
+     * 业务层的自定义导航配置
      */
-    tag: string;
+    protected readonly navigators: string[];
+    constructor(appkey: string, logger: BasicLogger, 
     /**
-     * 发送 http 请求
-     * @param options
+     * 业务层的自定义导航配置
      */
-    httpReq(options: IRequest): Promise<IResponse>;
+    navigators: string[]);
     /**
-     * 是否使用导航
+     * 当前进行中的导航请求
      */
-    useNavi: boolean;
+    private crtRequest;
     /**
-     * websocket 地址上附加的平台字段
+     * 请求导航数据
+     * @param token
+     * @param ignoreCache 是否忽略缓存，强制从服务器重新拉取。
+     * @param ignoreExpire 是否忽略有效期检查。理论上只需要在建立连接时需要检测 navi 有效期，其他场景无需检测
+     * @param traceId 事务日志跟踪 ID
      */
-    connectPlatform: string;
+    request(token: string, ignoreCache: boolean, ignoreExpire: boolean, traceId: string): IPromiseResult<INaviInfo>;
+    private sendRequest;
     /**
-     * websocket 地址上 apiVer 字段，代表代码是否来源于 uniapp
+     * 从指定服务列表中顺序尝试获取导航
+     * @param uris 导航服务列表
+     * @param token
+     * @param traceId
      */
-    isFromUniapp: boolean;
+    private requestHandler;
     /**
-     * 创建长连接实例
+     * 向目标导航服务发送请求
+     * @param uri 导航服务地址
+     * @param appkey
+     * @param token
+     * @param version
+     * @param timeout 请求超时时间
+     * @param traceId
      */
-    createWebSocket?(url: string, protocols?: string[]): IWebSocket;
+    protected abstract httpRequest(uri: string, appkey: string, token: string, version: string, timeout: number, traceId: string): IPromiseResult<INaviInfo>;
     /**
-     * 存储模块
+     * 转换 Navi 接口 HTTP 请求状态码为 ErrorCode 定义
+     * @param code
      */
-    localStorage: IStorage;
+    protected transHttpCode(code: number): ErrorCode;
     /**
-     * 在某些非浏览器平台，其等同于 localStorage
+     * 设置缓存
+     * @param formatedToken
+     * @param naviInfo
+     * @description 设置缓存的同时会检测缓存中的既有数据，适当清理，避免无效数据长时间占用存储空间
      */
-    sessionStorage: IStorage;
+    protected abstract setNaviCache(formatedToken: string, naviInfo: INaviInfo): void;
     /**
-     * 获取网络状态
-     * 2g 3g 4g wifi unkown
+     * 获取缓存数据
+     * @param formatedToken
      */
-    getNetworkType(): Promise<NetworkType>;
+    protected abstract getNaviCache(formatedToken: string): INaviCache | null;
+    /**
+     * 获取缓存的导航信息
+     * @param token
+     */
+    getNaviInfoFromCache(token: string): INaviInfo | null;
+    /**
+     * RTC 配置变更，更新 navi 缓存
+     * @param token
+     * @param voipCallInfo
+     */
+    updateVoipCallInfo(token: string, voipCallInfo: string): void;
 }
 
 /**
- * 拓展方法定义，便于 electron-solution 实现时保持接口类型推导可用
+ * Websocket 导航工具类
  */
-interface IExtraMethod {
-    getConversationsByPage(conversationTypes: ConversationType[], sentTime: number, count: number, channelId?: string): Promise<IAsyncRes<IReceivedConversation[]>>;
-    getHistoryMessagesByObjectNames(conversationType: ConversationType, targetId: string, sentTime: number, count: number, objectNames: string[], desc: 0 | 1, tag: string): Promise<IAsyncRes<{
-        list: IReceivedMessage[];
-        hasMore: boolean;
-    }>>;
-    updateMessageReceiptStatus(conersationType: ConversationType, targetId: string, timestamp: number, channelId?: string): Promise<IAsyncRes<boolean>>;
+declare class WebSocketNavi extends BasicNavi {
+    private runtime;
+    /**
+     * 小程序平台服务地址，多个地址以 ',' 分割
+     */
+    private readonly miniCmpUris;
+    constructor(appkey: string, logger: BasicLogger, runtime: IRuntime, 
+    /**
+     * 小程序平台服务地址，多个地址以 ',' 分割
+     */
+    miniCmpUris: string, navigators?: string[]);
+    protected httpRequest(uri: string, appkey: string, token: string, version: string, timeout: number, traceId: string): IPromiseResult<INaviInfo>;
+    protected getNaviCache(formatedToken: string): INaviCache | null;
+    protected setNaviCache(formatedToken: string, naviInfo: INaviInfo): void;
 }
 
 /**
@@ -3459,17 +3402,216 @@ interface IProcessInfo {
 }
 
 /**
- * engine 基本接口定义，用于约束 Electron 下主进程、渲染进程、JSEngine 的编码一致性
+ * 连接状态定义枚举值
  */
-interface IEngine {
+declare enum RCConnectionStatus {
+    /**
+     * 已连接
+     */
+    CONNECTED = 0,
+    /**
+     * 连接中
+     */
+    CONNECTING = 1,
+    /**
+     * 无连接，或已断开
+     */
+    DISCONNECTED = 2,
+    /**
+     * 连接暂停状态，SDK 内部 5s 后会自动尝试重连
+     */
+    SUSPENDED = 3
+}
+interface IConnectionListener {
+    /**
+     * 连接成功
+     */
+    onConnected(): void;
+    /**
+     * 连接中止，SDK 内部会进行重连
+     * @param code 中止原因
+     */
+    onSuspend(code: ErrorCode): void;
+    /**
+     * 连接中
+     */
+    onConnecting(): void;
+    /**
+     * 连接已终止
+     * @param code 连接终止原因
+     */
+    onDisconnected(code: ErrorCode): void;
+}
+/**
+ * 抽象连接管理器类，负责 engine 层的连接状态维持，和对外的连接状态通知
+ */
+declare abstract class AConnectionMgr {
+    protected readonly appkey: string;
+    private navi;
+    protected logger: BasicLogger;
+    private listener;
+    constructor(appkey: string, navi: BasicNavi, logger: BasicLogger, listener: IConnectionListener);
+    /**
+     * 当前连接所用 token
+     */
+    private token;
+    /**
+     * 获取当前连接中使用的 token
+     * @returns
+     */
+    getToken(): string;
+    private reconnectKick;
+    /**
+     * 当前连接状态
+     */
+    private _crtConnectionStatus;
+    /**
+     * 当前用户 ID
+     */
+    protected _crtUserId: string;
+    /**
+     * 获取当前用户 ID
+     * @returns
+     */
+    getCurrentUserId(): string;
+    /**
+     * 修改连接状态
+     * @param status
+     * @param code
+     */
+    private setConnectionStatus;
+    /**
+     * 获取当前连接状态
+     * @returns
+     */
+    getConnectionStatus(): RCConnectionStatus;
     /**
      * 建立连接
      * @param token
+     * @param reconnectKickEnable 设置断线重连时是否踢出当前正在重连的设备 (仅 Electron 环境有效)
+     *  同一个账号在一台新设备上登录的时候，会把这个账号在之前登录的设备上踢出。
+     *  由于 SDK 有断线重连功能，存在下面情况。
+     *  用户在 A 设备登录，A 设备网络不稳定，没有连接成功，SDK 启动重连机制。
+     *  用户此时又在 B 设备登录，B 设备连接成功。
+     *  A 设备网络稳定之后，用户在 A 设备连接成功，B 设备被踢出。
+     *  这个字段就是为这种情况加的。
+     *  设置 reconnectKickEnable 为 true 时，SDK 重连的时候发现此时已有别的设备连接成功，不再强行踢出已有设备，而是踢出重连设备。
+     */
+    connect(token: string, reconnectKickEnable: boolean, traceId: string): IPromiseResult<string>;
+    /**
+     * 执行中的连接事务
+     */
+    private _crtConnectionTask;
+    /**
+     * 尝试建立连接
+     * @param token
+     * @param reconnectKickEnable
+     * @param ignoreNaviCache
+     * @param traceId
+     * @description 函数会检测当前是否有进行中的连接任务，若存在，则直接返回当前连接任务
+     */
+    private try2Connect;
+    /**
+     * 创建连接任务
+     * @param token
+     * @param reconnectKickEnable
+     * @param ignoreNaviCache
+     * @param traceId
+     * @returns
+     */
+    private createConnectionTask;
+    private reconnectTimer;
+    /**
+     * 尝试重连
+     * @param ignoreNaviCache 是否忽略 navi 缓存以重新请求 navi
+     */
+    private try2Reconnect;
+    /**
+     * 服务器主动断开时由子类调用，函数将根据 reason 确定是否尝试重连
+     * @param reason
+     */
+    protected onDisconnectByServer(code: ErrorCode): void;
+    /**
+     * Socket 异常中断时由子类调用，SDK 尝试恢复重连
+     */
+    protected onDisconenctUnusual(code: ErrorCode): void;
+    /**
+     * 建立 Socket 连接，由子类集成实现
+     * @param token
      * @param naviInfo
      * @param reconnectKickEnable
+     * @param traceId
+     */
+    protected abstract connectWithToken(token: string, naviInfo: INaviInfo, reconnectKickEnable: boolean, traceId: string): IPromiseResult<string>;
+    /**
+     * 当前累计心跳超时次数
+     */
+    private _failedCount;
+    /**
+     * 允许连续 PING 超时次数，超出指定次数后会主动关闭 socket 并重新连接
+     */
+    private readonly ALLOW_FAILED_TIMES;
+    /**
+     * 启动心跳计时器
+     */
+    private checkAlive;
+    /**
+     * 关闭连接
+     * @param inReconnect
+     */
+    protected abstract close(inReconnect: boolean): void;
+    /**
+     * 完成一次 ping 过程，并返回响应状态码
+     * @param timeout 超时时间
+     */
+    protected abstract sendPing(timeout: number): Promise<ErrorCode>;
+    /**
+     * 业务层主动断开连接时调用
+     */
+    disconnect(): Promise<void>;
+    /**
+     * 清理重连计时器
+     */
+    private stopReconnectTimer;
+}
+
+/**
+ * 查询错误码是否为服务下发的 disconnect 通知 status 所转换
+ * @param code
+ * @description 排除重定向 31006，因 disconnect 和 connAck 都包含元素可被转换为 31006
+ */
+declare const isDisconnectCode: (code: ErrorCode) => boolean;
+/**
+ * 查询错误码是否为服务下发的 connAck status 所转换
+ * @param code
+ * @description 排除重定向 31006，因 disconnect 和 connAck 都包含元素可被转换为 31006
+ */
+declare const isConnnectAckCode: (code: ErrorCode) => boolean;
+
+/**
+ * 进程内缓存数据
+ */
+interface IProcessCache {
+    crtUserId: string;
+    connectedTime: number;
+    naviInfo: INaviInfo | null;
+    connectionStatus: RCConnectionStatus;
+    deviceId: string;
+}
+/**
+ * 约束主进程 CppEngine 与 CppService 间的方法定义，以便于代码检查
+ */
+interface IEngine {
+    /**
+     * 注册本渲染进程至主进程，以接收主进程的消息通知，同时同步主进程的当前缓存数据
+     */
+    getMainProcessCache(): IProcessCache;
+    /**
+     * 建立连接
+     * @param token
+     * @param reconnectKickEnable
      */
-    connect(token: string, naviInfo: INaviInfo, reconnectKickEnable?: boolean): Promise<ErrorCode>;
-    requestNaviInfo(uris: string[], appkey: string, token: string, checkCA?: boolean): Promise<INaviInfo | null>;
+    connect(token: string, reconnectKickEnable: boolean, traceId: string): IPromiseResult<string>;
     getNaviInfoFromCache(): INaviInfo | null;
     /**
      * 上报版本信息
@@ -3591,6 +3733,10 @@ interface IEngine {
      * 获取指定会话
      */
     getConversation(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<IReceivedConversation | null>;
+    /**
+     * 获取未读会话列表
+     */
+    getUnreadConversationList(conversationTypes: ConversationType[]): IPromiseResult<IReceivedConversation[]>;
     /**
      * 删除会话
      * @description 该删除操作会删除服务器端存储的会话数据
@@ -3879,7 +4025,7 @@ interface IEngine {
     /**
      * 获取消息
      */
-    getMessage(messageId: number): IPromiseResult<IReceivedMessage>;
+    getMessage(messageId: number | string): IPromiseResult<IReceivedMessage>;
     /**
      * 设置消息内容
      */
@@ -3951,7 +4097,7 @@ interface IEngine {
     /**
      * 无差别获取本地置顶列表
      */
-    getTopConversationList(): Promise<IAsyncRes<IBaseConversationInfo[]>>;
+    getTopConversationList(conversationTypes?: ConversationType[], channelId?: string): Promise<IAsyncRes<IReceivedConversation[]>>;
     /**
      * 获取单个群聊会话 @ 消息未读数
      */
@@ -3969,6 +4115,18 @@ interface IEngine {
      * 获取应用主进程信息，仅限 Electron 平台可用
      */
     getMainProcessInfo(): IPromiseResult<IProcessInfo>;
+    /**
+     * 设置代理
+     */
+    setProxy(proxy: IProxy | null): IPromiseResult<IProxy>;
+    /**
+     * 获取代理
+     */
+    getProxy(): IPromiseResult<IProxy>;
+    /**
+     * 测试代理
+     */
+    testProxy(proxy: IProxy, testHost: string): Promise<IResponse>;
     rtcPing(roomId: string, mode: number, broadcastType?: number): Promise<IAsyncRes<any>>;
     rtcSignaling(roomId: string, method: string, isQuery: boolean, sourceData: any): Promise<{
         code: ErrorCode;
@@ -4202,65 +4360,49 @@ interface IEndRoomPKOptions {
 /**
  * 消息送达相关接口
  */
+/**
+ * 送达的用户信息
+ * @hidden
+ */
 interface IDeliveredUser {
     time: number;
     userId: string;
 }
+/**
+ * 获取群组消息送达的状态信息
+ * @hidden
+ */
 interface IGroupMessageDeliverInfo {
     totalCount: number;
     list: IDeliveredUser[];
 }
+/**
+ * 单聊消息送达通知数据
+ * @hidden
+ */
 interface IMessageDeliver {
     deliverTime: number;
     messageUId: string;
     objectName: string;
     targetId: string;
 }
+/**
+ * 群组消息送达通知数据信息
+ * @hidden
+ */
 interface IGroupMessageDeliveredStatusInfo {
     MessageUId: string;
     deliveryCount: number;
 }
+/**
+ * 群组消息送达通知数据
+ * @hidden
+ */
 interface IGroupMessageDeliverStatus {
     totalCount: number;
     list: IGroupMessageDeliveredStatusInfo[];
 }
 
-/**
- * IndexDB中存储的log数据
- */
-interface ILogInfo {
-    sessionId: string;
-    time: number;
-    level: LogLevel;
-    content: string;
-    userId?: string;
-    logSource?: LogSource;
-    tagId?: LogTagId;
-}
-interface IRealTimeLog {
-    level: LogLevel;
-    content: string;
-}
-interface ILogExtensions {
-    traceId?: string;
-    logSource?: LogSource;
-}
-interface ILogInit {
-    userId?: string;
-    localLogLevel?: LogLevel;
-    customLogPrint?: (logLevel: LogLevel, msg: string) => void;
-}
-interface IInitBigDataOption {
-    runtime?: IRuntime;
-    appkey?: string;
-    version?: string;
-    userId?: string;
-}
-interface IBigdataLogInit extends IInitBigDataOption {
-    logUrl: string;
-    sessionId: string;
-}
-
 /**
  * 定义已废弃，请使用 `IRemoveChatroomEntries` 替换
  * @deprecated
@@ -4410,118 +4552,11 @@ declare const initLogDB: (appkey: string, logger: ILogger, expireTime?: number)
 declare const deInitLogDB: () => Promise<void>;
 
 /**
- * 日志数据转为 csv 结构数据
- * @param log
- * @returns
- */
-declare const transcsv: (log: ILogData) => string;
-
-/**
- * @description
- * 读数据处理基类
-*/
-declare class BaseReader {
-    readonly header: Header;
-    messageId: number;
-    timestamp: number;
-    syncMsg: boolean;
-    protected identifier: string;
-    constructor(header: Header);
-    getIdentifier(): string | number;
-    read(logger: ILogger, stream: RongStreamReader, length: number, protocolVer: ConnAckProtocolVer): void;
-    readMessage(logger: ILogger, stream: RongStreamReader, length?: number, protocolVer?: ConnAckProtocolVer): {
-        stream: RongStreamReader;
-        length: number | undefined;
-    };
-}
-/**
- * @description
- * 写数据处理基类
- */
-declare abstract class BaseWriter {
-    private _header;
-    lengthSize: number;
-    data: any;
-    messageId: number;
-    topic: string;
-    targetId: string;
-    identifier: string;
-    constructor(headerType: OperationType);
-    getIdentifier(): string | number;
-    write(stream: RongStreamWriter): void;
-    abstract writeMessage(stream: RongStreamWriter): void;
-    setHeaderQos(qos: number): void;
-    getHeaderFlag(): number;
-    getLengthSize(): number;
-    getBufferData(): Int8Array;
-}
-declare class RetryableReader extends BaseReader {
-    messageId: number;
-    readMessage(logger: ILogger, stream: RongStreamReader, length: number): {
-        stream: RongStreamReader;
-        length: number;
-    };
-}
-declare class RetryableWriter extends BaseWriter {
-    writeMessage(stream: RongStreamWriter): void;
-}
-declare class PublishReader extends RetryableReader {
-    topic: string;
-    data: any;
-    targetId: string;
-    date: any;
-    syncMsg: boolean;
-    identifier: string;
-    readMessage(logger: ILogger, stream: RongStreamReader, length: number): {
-        stream: RongStreamReader;
-        length: number;
-    };
-}
-/**
- * @description
- * 发消息使用
- */
-declare class PublishWriter extends RetryableWriter {
-    topic: string;
-    data: any;
-    targetId: string;
-    date: any;
-    syncMsg: boolean;
-    identifier: string;
-    constructor(topic: string, data: any, targetId: string);
-    writeMessage(stream: RongStreamWriter): void;
-}
-/**
- * @description
- * 发消息, Server 给的 Ack 回执
- */
-declare class PubAckReader extends RetryableReader {
-    status: number;
-    date: number;
-    data: any;
-    millisecond: number;
-    messageUId: string;
-    timestamp: number;
-    identifier: string;
-    topic: string;
-    targetId: string;
-    readMessage(logger: ILogger, stream: RongStreamReader, length: number): {
-        stream: RongStreamReader;
-        length: number;
-    };
-}
-/**
- * @description
- * Web 主动查询
+ * 日志数据转为 csv 结构数据
+ * @param log
+ * @returns
  */
-declare class QueryWriter extends RetryableWriter {
-    topic: string;
-    data: any;
-    targetId: string;
-    identifier: string;
-    constructor(topic: string, data: any, targetId: string);
-    writeMessage(stream: RongStreamWriter): void;
-}
+declare const transcsv: (log: ILogData) => string;
 
 /**
  * 会话属性
@@ -4598,26 +4633,12 @@ interface IServerUserSetting {
     };
     version: number;
 }
-interface ISyncMsgArgs {
-    inboxTime: number;
-    sendboxTime: number;
-    broadcastSyncTime?: number;
-}
 interface IGetMsgOption {
     timestamp?: number;
     count?: number;
     order?: number;
     channelId?: string;
 }
-interface IGetConversationListOption {
-    type?: number;
-    count?: number;
-    startTime?: number;
-    order?: 0 | 1;
-}
-interface IClearMsgOption {
-    timestamp?: number;
-}
 
 /**
  * TODO: 确定对外暴露的必要性
@@ -4633,362 +4654,9 @@ declare const DelayTimer: {
     getTime: () => number;
 };
 
-/**
- * 序列化、反序列化数据通道
-*/
-declare class DataCodec {
-    private logger;
-    private _codec;
-    constructor(logger: BasicLogger);
-    private static createPBCodec;
-    /**
-     * PB 数据 转为 rmtp 数据 反序列化 通用数据
-     * 根据解析的 PBName 分配解码方法. 如果没有单独的解码方法定义. 直接返回 pb 解析后的结果
-    */
-    decodeByPBName(data: any, pbName: string, option?: any): any;
-    private _readBytes;
-    /**
-     * ====== 以下为 rmtp 数据 反序列化为 可用数据 ======
-     */
-    private _formatBytes;
-    /**
-     * 格式化多端同步消息
-    */
-    private _formatSyncMessages;
-    /**
-     * 格式化接收消息
-    */
-    private _formatReceivedMessage;
-    /**
-     * 格式化发送消息
-    */
-    private _formatSentMessage;
-    /**
-     * 格式化历史消息
-    */
-    private _formatHistoryMessages;
-    /**
-     * 格式化超级群消息变更列表
-    */
-    private _formatUltraMsgChangeList;
-    /**
-     * 格式化超级群消息变更列表
-    */
-    private _formatUltraOperateStatusNotifyList;
-    /**
-     * 格式化超级群变更后消息列表
-    */
-    private _formatUltraMsgList;
-    /**
-     * 格式化超级群获取指定会话未读 @ 消息列表
-    */
-    private _formatUltraGroupUnreadMentionedList;
-    /**
-     * 格式化会话列表
-    */
-    private _formatConversationList;
-    /**
-     * 格式化用户设置
-    */
-    private _formatSetUserSettingOutput;
-    /**
-     * 格式化聊天室信息
-    */
-    private _formatChatRoomInfos;
-    /**
-     * 格式化 聊天室 KV 列表
-    */
-    private _formatChatRoomKVList;
-    /**
-     * 格式化 用户设置
-    */
-    private _formatUserSetting;
-    /**
-     * 格式化 会话状态 置顶、免打扰
-    */
-    private _formatConversationStatus;
-    /**
-      * 格式化 获取已读列表
-    */
-    private _formatGrpReadReceiptQryResp;
-    /**
-     * 格式化用户配置通知
-     */
-    private _formatUserSettingNotification;
-    /**
-     * 拉取聊天室 kv 存储时的最新时间戳
-     */
-    private _formatChrmKVVersion;
-    /**
-     * 格式化加入 RTC 房间的用户信息
-     */
-    private _formatRTCJoinedUserInfo;
-    /**
-     * ===== 以下为通用数据 序列化为 PB 数据 =====
-     * Engine Index 调用处理数据
-    */
-    /**
-     * ? 待补全注释
-    */
-    encodeServerConfParams(): any[];
-    /**
-     * 上行消息基础配置
-    */
-    private _getUpMsgModule;
-    /**
-     * 序列化上行消息
-    */
-    encodeUpMsg(conversation: IConversationOption, option: ISendMsgOptions): any[];
-    /**
-     * 序列化拉取多端消息
-    */
-    encodeSyncMsg(syncMsgArgs: ISyncMsgArgs): any[];
-    /**
-     * 序列化拉取聊天室消息
-    */
-    encodeChrmSyncMsg(time: number, count: number): any[];
-    /**
-     * 序列化历史消息所需参数
-    */
-    encodeGetHistoryMsg(targetId: string, option: IGetMsgOption): any[];
-    /**
-     * 序列化同步超级群所需参数
-    */
-    encodeSuperSyncMsg(syncTime: number): any[];
-    /**
-     * 序列化会话列表
-    */
-    encodeGetConversationList(option: IGetConversationListOption): any[];
-    /**
-     * 旧会话列表. 获取、删除都调用此方法
-    */
-    encodeOldConversationList(option: IGetConversationListOption): any[];
-    /**
-     * 旧会话列表删除，支持多组织
-     */
-    encodeRemoveOldConversationList(conversation: IConversationOption): any[];
-    /**
-     * 旧会话列表删除
-    */
-    encodeRemoveConversationList(conversationList: IConversationOption[]): any[];
-    /**
-     * 批量删除消息通过消息 ID
-    */
-    encodeDeleteMessages(conversationType: ConversationType, targetId: string, list: {
-        messageUId: string;
-        sentTime: number;
-        messageDirection: MessageDirection;
-    }[], channelId: string): any[];
-    /**
-     * 批量删除消息通过时间
-    */
-    encodeClearMessages(targetId: string, timestamp: number, channelId: string, conversationType?: ConversationType): any[];
-    /**
-     * 未读数清除
-    */
-    encodeClearUnreadCount(conversation: IConversationOption, option: IClearMsgOption): any[];
-    /**
-     * 对已有的超级群消息扩展
-    */
-    encodeExpandUltraMessage(option: IUltraExMsgOptions, userId: string): any[];
-    /**
-     * 对已有的超级群消息扩展
-    */
-    encodemodifyMessage(option: IUltraModifyMsgOptions, userId: string): any[];
-    /**
-     * 超级群消息变更通知
-    */
-    encodeQueryMsgChange(time: number): any[];
-    /**
-     * 超级群消息变更通知
-    */
-    encodeMsgQuery(option: IUltraMsgQueryOptions): any[];
-    /**
-     * 序列化获取超级群获取指定会话未读 @ 消息列表参数
-    */
-    encodeUnreadMentionedMsgQuery(option: IUltraGroupUnreadMentionedOption): any[];
-    /**
-     * 正在输入中
-     */
-    encodeOperateStatus(targetId: string, conversationType: ConversationType, channelId: string, operationType: OperateStatus): any[];
-    /**
-     * 加入退出聊天室
-    */
-    encodeJoinOrQuitChatRoom(): any[];
-    /**
-     * 获取聊天室信息
-     * @param count 获取人数
-     * @param order 排序方式
-    */
-    encodeGetChatRoomInfo(count: number, order: number): any[];
-    /**
-     * 设置指定超级群默认通知配置
-     * @param notificationLevel
-     * * NotificationLevel
-     * @param channelId 超级群频道 Id
-     */
-    encodeSetUltraGroupDefaultNotificationLevel(notificationLevel: NotificationLevel, channelId: string): any;
-    /**
-     * 查询指定超级群默认通知配置
-     * @param channelId 频道 ID
-     */
-    encodeGetUltraGroupDefaultNotificationLevel(channelId: string): any;
-    /**
-     * 上传文件认证信息获取
-    */
-    encodeGetFileToken(fileType: number, fileName: string, httpMethod?: string, queryString?: string): any;
-    /**
-      * 获取七牛上传url
-    */
-    encodeGetFileUrl(inputPBName: string, fileType: number, fileName?: string, originName?: string): any;
-    /**
-      * 聊天室 KV 存储
-    */
-    encodeModifyChatRoomKV(chrmId: string, entry: IChrmKVEntry, currentUserId: string): any;
-    encodeModifyChatRoomKVS(chrmId: string, entryOptions: IChrmKVEntries, currentUserId: string): any;
-    /**
-      * KV 存储拉取
-    */
-    encodePullChatRoomKV(time: number): any;
-    /**
-      * 用户实时配置更新
-    */
-    encodePullUserSetting(version: number): any;
-    /**
-      * 获取会话状态 (置顶、免打扰)
-    */
-    encodeGetConversationStatus(time: number): any;
-    /**
-      * 设置会话状态 (置顶、免打扰)
-    */
-    encodeSetConversationStatus(statusList: Array<ISetConversationStatusOptions>, conversationUpdatedTime: number): any;
-    /**
-     * 序列化发送群组已读回执
-     */
-    encodeReadReceipt(messageUIds: string[], channelId?: string): any;
-    /**
-     * 序列化创建tag消息
-     */
-    encodeCreateTag(tags: Array<ITagParam>, version: number): any;
-    /**
-     * 序列化获取群组消息已读列表
-     */
-    encodeMessageReader(messageUId: string, channelId?: string): any;
-    /**
-     * 序列化删除tag消息
-     */
-    encodeRemoveTag(tagIds: Array<string>, version: number): any;
-    /**
-     * 解除会话标签关系
-     */
-    encodeDisConversationTag(tagIds: Array<string>): any;
-    /**
-     * 序列化更新会话标签
-     */
-    encodeUpdateConversationTag(tags: IConversationTag[], conversations: IConversationOption[]): any;
-    /**
-     * 序列号上报SDK信息
-     */
-    encodeReportSDKInfo(info: string): any;
-    /**
-     * 序列号超级群获取会话参数
-     */
-    encodeUltraGroup(syncTime: number, isEraseMsgContent: boolean): any;
-    /**
-     * 设置聊天室关联的rtc房间
-    */
-    encodebindRTCRoomForChatroom(options: IRTCRoomBindOption): any;
-}
-
-interface IDataChannelWatcher {
-    /**
-     * 连接状态变更通知
-     */
-    status: (status: ConnectionStatus) => void;
-    /**
-     * 业务信令通知
-     * @params signal
-     * @params ack 当接收到的数据为多端同步消息时，ack 值为 PubAck，否则为 undefined
-     */
-    signal: (signal: PublishReader, ack?: PubAckReader) => void;
-}
-/**
- * @todo 迁移中的 DataCodec 模块导致数据通道不够独立，与 xhr-polling 通信可能会有耦合，后续需解耦
- * @description
- * 1. 基于 WebSocket 协议建立数据通道，实现数据收发
- * 2. 基于 Protobuf 进行数据编解码
- */
-declare class WebSocketChannel {
-    private _runtime;
-    private _watcher;
-    private logger;
-    readonly codec: DataCodec;
-    connectedTime: number;
-    userId: string;
-    sendConnectTime: number;
-    private _socket;
-    private _pingResolve?;
-    /**
-     * 本端发送消息时等待接收 PubAck 的 Promise.resolve 函数
-     */
-    private _messageIds;
-    /**
-     * 接收多端同步消息时，等待 PubAck 的 Promise.resolve 函数
-     */
-    private _syncMessageIds;
-    constructor(_runtime: IRuntime, _watcher: IDataChannelWatcher, logger: BasicLogger);
-    /**
-     * 建立连接，连接成功则返回 Websocket 实例，否则返回连接错误码
-     * @param appkey
-     * @param token
-     * @param hosts 服务器地址，不包含协议头，`hostname:port`
-     * @param protocol 请求导航数据时使用的网络协议, /ping 与 websocket 需要继续遵循该协议
-     * @param apiVersion 需符合 `/\d+(\.\d+){2}/` 规则，对于预发布版本号如 `3.1.0-alpha.1` 需认定为 `3.1.0`
-     * @param protocolVer
-     */
-    connect(appkey: string, token: string, hosts: string[], protocol: 'http' | 'https', apiVersion: string, protocolVer: ConnAckProtocolVer): Promise<ErrorCode>;
-    /**
-     * 发起连接请求
-     */
-    private _connect;
-    /**
-     * 当前累计心跳超时次数
-     */
-    private _failedCount;
-    /**
-     * 允许连续 PING 超时次数，次数内不主动关闭连接
-     */
-    private readonly ALLOW_FAILED_TIMES;
-    /**
-     * ping定时器
-     */
-    private _timer;
-    private _checkAlive;
-    private _onReceiveSignal;
-    /**
-     * 只发送数据，无需响应
-     */
-    sendOnly(writer: BaseWriter): void;
-    /**
-     * 有效值 0 - 65535，超出 65535 位数超长溢出
-     */
-    private _idCount;
-    private _generateMessageId;
-    /**
-     * @param writer
-     * @param pbName 响应数据的 PB 定义
-     * @param timeout 超时配置，单位 ms
-     */
-    send<T>(writer: QueryWriter | PublishWriter, respPBName?: string, option?: any, timeout?: number): Promise<IAsyncRes<T>>;
-    /**
-     * 关闭数据通道，同时清空监听
-     */
-    close(): void;
-}
-
 declare type IMessageListnenr = (message: IReceivedMessage, leftCount?: number, hasMore?: boolean) => void;
 declare type IMessagesListnenr = (messages: IReceivedMessage[], leftCount?: number, hasMore?: boolean) => void;
-declare type IConnectionStatusListener = (status: ConnectionStatus) => void;
+declare type IConnectionStatusListener = (status: RCConnectionStatus | ErrorCode | ConnectionStatus) => void;
 declare type IConversationStateListener = (conversation: IUpdatedConversation[]) => void;
 declare type IChatroomListener = (state: IChatroomListenerData) => void;
 declare type IRTCInnerListener = {
@@ -5005,12 +4673,18 @@ declare type IGroupMessageDeliveredStatusListener = (data: IGroupMessageDeliverS
 interface IWatcher {
     message?: IMessageListnenr;
     batchMessage?: IMessagesListnenr;
-    connectionState?: IConnectionStatusListener;
+    /**
+     * 连接状态变更监听
+     * @param status 变更的连接状态
+     * @param code 当连接状态为 `RCConnectionStatus.DISCONNECTED` 或 `RCConnectionStatus.SUSPEND` 时有值
+     */
+    connection?: (status: RCConnectionStatus, code?: ErrorCode) => void;
     conversationState?: IConversationStateListener;
     chatroomState?: IChatroomListener;
     expansion?: IExpansionListener;
     /**
      * 为兼容老版本 RTCLib 与 CallLib 接收消息的方式，新版本消息走插件机制
+     * @deprecated
      */
     rtcInnerWatcher?: IRTCInnerListener;
     /**
@@ -5034,10 +4708,6 @@ interface IWatcher {
      * 群聊消息送达状态通知
     */
     groupMessageDeliveredStatus?: IGroupMessageDeliveredStatusListener;
-    onConnecting?: () => void;
-    onConnected?: () => void;
-    onDisconnect?: (status: ConnectionStatus) => void;
-    onSuspend?: (status: ConnectionStatus | ErrorCode) => void;
     readReceiptReceived?: (conversation: IConversationOption, messageUId: string, sentTime: number) => void;
     messageReceiptRequest?: (conversation: IConversationOption, messageUId: string, senderUserId: string) => void;
     messageReceiptResponse?: (conversation: IConversationOption, receivedUserId: string, messageUIdList: string[]) => void;
@@ -5059,10 +4729,6 @@ interface IAPIContextOption {
      * 应用 appkey
      */
     appkey: string;
-    /**
-     * IMLib 版本号
-     */
-    apiVersion: string;
     /**
      * 自定义导航地址:
      * 1. 私有云环境下该值为必填项
@@ -5082,10 +4748,6 @@ interface IAPIContextOption {
      * typing状态过期时间
      */
     typingExpireTime?: number;
-    /**
-     * 是否校验证书，默认为 true
-     */
-    checkCA?: boolean;
     /**
      * 开启后，SDK 内的 HTTP 请求将由 Electron 主进程内发送。
      * @since 5.6.0
@@ -5186,6 +4848,11 @@ declare class Codec<T> {
      * @param data 待解码数据
      */
     decode(pbname: string, uint8array: Uint8Array): any;
+    /**
+     * protobuf 结构中，int64 类型数据无法直接转为 JS 的 number 数据，需计算获取
+     * @param data
+     */
+    private fixInt64Values;
 }
 
 declare class APIContext {
@@ -5203,19 +4870,10 @@ declare class APIContext {
      */
     private _pluginInstanseMap;
     private readonly _engine;
-    /**
-     * 核心库版本号，后期与 4.0 IM SDK 版本号保持一致
-     */
-    readonly coreVersion: string;
     readonly appkey: string;
-    readonly apiVersion: string;
     private readonly _options;
     private _versionInfo;
     private _typingInfo;
-    /**
-     * 内部连接状态标识，为 ture 时不允许调用 reconnect 方法
-     */
-    private _isInternalConnected;
     /**
      * RTC 相关的编解码模块，用于向前兼容 RTC 旧版本的编解码，
      * 包括向 CppEngine 提供 RTC 业务编解码能力
@@ -5233,21 +4891,23 @@ declare class APIContext {
      * @param options
      */
     install<T, O>(plugin: IPluginGenerator<T, O>, options: O): T | null;
-    private _connectionStatus;
-    private _canRedirectConnect;
+    private _onConnectionStatusChange;
+    private _processChatrormMessage;
+    private _processChrmMemChangeMessage;
+    private _processTypingStatusMessage;
+    private _processInterceptMessage;
     /**
-     * 重定向后，递归调用 connect
-     */
-    private _handleRedirect;
+     * 消息处理器(v2/v4/next 版本中兼容)
+     * 返回 false | undefined：消息继续向上抛出，true：内部处理或转为事件回调，无需向上抛出
+    */
+    private _compatibleMessageProccessor;
+    private _processReadReceiptMessage;
+    private _processReadReceiptRequestMessage;
+    private _processReadReceiptResponseMessage;
     /**
-     * 连接状态变更回调
-     * @param message
+     * 消息处理器（imlib-next 中转为事件回调, 无需抛出）
      */
-    private _connectionStatusListener;
-    _handleConnecting(): void;
-    _handleConnected(): void;
-    _handleDisconnect(status: ConnectionStatus): void;
-    _handleSuspend(status: ConnectionStatus | ErrorCode): void;
+    private _messageProccessor;
     private _messageReceiver;
     _batchMessageReceiver(messages: IReceivedMessage[], leftCount?: number, hasMore?: boolean): void;
     /**
@@ -5320,6 +4980,7 @@ declare class APIContext {
     getCurrentUserId(): string;
     getConnectionStatus(): ConnectionStatus;
     get token(): string;
+    refetchNaviInfo(): IPromiseResult<INaviInfo | null>;
     /**
      * 建立连接，连接失败则抛出异常，连接成功后返回用户 userId，否则返回相应的错误码
      * @param token
@@ -5333,22 +4994,14 @@ declare class APIContext {
         这个字段就是为这种情况加的。
         设置 reconnectKickEnable 为 true 时，SDK 重连的时候发现此时已有别的设备连接成功，不再强行踢出已有设备，而是踢出重连设备。
      */
-    connect(token: string, refreshNavi?: boolean, reconnectKickEnable?: boolean, traceId?: string): Promise<IConnectResult>;
-    /**
-     * 拉取实时配置 web 端需更新 voipCall 字段
-     */
-    private _pullUserSettings;
+    connect(token: string, reconnectKickEnable: boolean, traceId: string): Promise<IConnectResult>;
     disconnect(): Promise<void>;
     reconnect(reconnectKickEnable?: boolean): Promise<IConnectResult>;
     private _getTokenWithoutNavi;
     /**
      * 获取当前缓存的导航数据
      */
-    getInfoFromCache(): INaviInfo | null;
-    /**
-     * 请求服务导航数据
-     */
-    reqNaviInfo(refreshNavi: boolean, traceId?: string): IPromiseResult<INaviInfo | null>;
+    getNaviInfoFromCache(): INaviInfo | null;
     private _registerMessageSearchPropsMapping;
     /**
      * 消息注册
@@ -5714,7 +5367,11 @@ declare class APIContext {
     /**
      * 获取所有本地置顶列表
      */
-    getTopConversationList(): Promise<IAsyncRes<IBaseConversationInfo[]>>;
+    getTopConversationList(conversationTypes?: ConversationType[], channelId?: string): Promise<IAsyncRes<IReceivedConversation[]>>;
+    /**
+     * 获取未读会话列表
+     */
+    getUnreadConversationList(conversationTypes?: ConversationType[]): Promise<IAsyncRes<IReceivedConversation[]>>;
     getUnreadMentionedCount(conversation: IConversationOption): Promise<IAsyncRes<number>>;
     /**
       * 获取所有群聊会话 @ 消息未读数
@@ -5849,7 +5506,7 @@ declare class APIContext {
     /**
      * 获取本地消息
     */
-    getMessage(messageId: number): Promise<IAsyncRes<IReceivedMessage>>;
+    getMessage(messageId: number | string): Promise<IAsyncRes<IReceivedMessage>>;
     /**
      * 设置消息内容
     */
@@ -6003,20 +5660,32 @@ declare class APIContext {
      * SDK设置聊天室关联的rtc房间
      */
     bindRTCRoomForChatroom(option: IRTCRoomBindOption): Promise<ErrorCode>;
+    /**
+     * 设置代理
+     */
+    setProxy(proxy: IProxy | null): IPromiseResult<IProxy>;
+    /**
+     * 获取代理
+     */
+    getProxy(): IPromiseResult<IProxy>;
+    /**
+     * 测试代理
+     */
+    testProxy(proxy: IProxy, testHost: string): Promise<IResponse>;
 }
 
 declare class PluginContext {
     protected readonly _context: APIContext;
     constructor(_context: APIContext);
-    /**
-     * 重新请求服务导航数据
-     */
-    refetchNaviInfo(): IPromiseResult<INaviInfo | null>;
     /**
      * 获取 context
      */
     __getContext(): APIContext;
     createCodec<T extends CodecPBMaps>(keymaps: T, pbDesc: string): Codec<T>;
+    /**
+     * 重新请求服务导航数据
+     */
+    refetchNaviInfo(): IPromiseResult<INaviInfo | null>;
     /**
      * 获取当前的导航数据
      */
@@ -6035,9 +5704,10 @@ declare class PluginContext {
     onnavidatachange?(naviInfo: INaviInfo): void;
     /**
      * 接收 IM 连接状态变更通知
-     * @param status
+     * @param status 当前连接状态，ConnectionStatus 仅作为向前兼容声明，实际通知只有 RCConnectionStatus 值
+     * @param code 当连接状态为 `RCConnectionStatus.DISCONNECTED` 或 `RCConnectionStatus.SUSPEND` 时有值
      */
-    onconnectionstatechange?(status: ConnectionStatus): void;
+    onconnectionstatechange?(status: RCConnectionStatus | ConnectionStatus, code?: ErrorCode): void;
     /**
      * IM 客户端销毁通知
      */
@@ -6314,14 +5984,13 @@ declare const keymaps: CodecPBMaps;
  */
 declare type RTCKeyMaps = typeof keymaps;
 
-interface IEngineWatcher {
+interface IEngineWatcher extends IConnectionListener {
     /**
      * @param message 消息
      * @param leftCount 参数废弃，值始终为 undefined
      * @param hasMore 消息是否收取结束，需与协议栈配合使用
     */
     batchMessage: (messages: IReceivedMessage[], leftCount?: number, hasMore?: boolean) => void;
-    status: (status: ConnectionStatus) => void;
     chatroom: (event: IChatroomListenerData) => void;
     conversation: (event: any) => void;
     expansion: (event: IExpansionListenerData) => void;
@@ -6348,7 +6017,7 @@ interface IEngineWatcher {
 /**
  * 引擎定义
  */
-declare abstract class AEngine implements IEngine {
+declare abstract class AEngine {
     readonly runtime: IRuntime;
     readonly rtcCodec: Codec<RTCKeyMaps>;
     protected readonly _watcher: IEngineWatcher;
@@ -6359,8 +6028,6 @@ declare abstract class AEngine implements IEngine {
     */
     abstract getConnectedTime(): number;
     protected readonly _appkey: string;
-    protected readonly _apiVer: string;
-    protected readonly _apiVersion: string;
     private _rtcKVManager;
     /**
      * 引擎初始化
@@ -6373,28 +6040,22 @@ declare abstract class AEngine implements IEngine {
      * @param listener
      */
     registerRTCSignalingListener(listener: ((buffer: Uint8Array) => void) | undefined): void;
-    abstract requestNaviInfo(uris: string[], appkey: string, token: string, checkCA?: boolean): Promise<INaviInfo | null>;
     /**
-     * 为非 engine 包创建 logger 工具实例
+     * 忽视缓存，重新请求导航数据
      */
-    abstract createLogger(id: string, type: LogType): BasicLogger;
+    abstract refetchNaviInfo(): IPromiseResult<INaviInfo | null>;
     /**
-     * 获取 engine 包内部 logger 工具
+     * 获取导航缓存数据
      */
-    getInnerLogger(): BasicLogger;
+    abstract getNaviInfoFromCache(): INaviInfo | null;
     /**
-     * 获取导航数据
-     * @param token
-     * @param dynamicUris token 携带的动态导航地址
-     * @param force 是否强制重新获取并清空缓存数据
+     * 为非 engine 包创建 logger 工具实例
      */
-    getNaviInfo(token: string, dynamicUris: string[], force: boolean, checkCA?: boolean): Promise<INaviInfo | null>;
-    protected setNaviInfo2Cache(token: string, naviInfo: INaviInfo): void;
-    abstract getNaviInfoFromCache(): INaviInfo | null;
+    abstract createLogger(id: string, type: LogType): BasicLogger;
     /**
-     * 清空导航数据：内存数据、缓存数据
+     * 获取 engine 包内部 logger 工具
      */
-    private _clear;
+    getInnerLogger(): BasicLogger;
     /**
      * 调用非标准方法。所谓非标准方法，是为某些特定需求或产品添加，暂未作为标准接口添加至 API 层。
      * 对于未实现的方法，接口响应 Unsupport 错误码
@@ -6405,10 +6066,10 @@ declare abstract class AEngine implements IEngine {
     /**
      * 建立连接
      * @param token
-     * @param naviInfo
      * @param reconnectKickEnable
+     * @param traceId
      */
-    abstract connect(token: string, naviInfo: INaviInfo, reconnectKickEnable?: boolean, traceId?: string): Promise<ErrorCode>;
+    abstract connect(token: string, reconnectKickEnable: boolean, traceId: string): IPromiseResult<string>;
     /**
      * 发送SDK版本
      * @param versionInfo
@@ -6518,6 +6179,10 @@ declare abstract class AEngine implements IEngine {
      * 获取指定会话
     */
     abstract getConversation(conversationType: ConversationType, targetId: string, channelId: string): IPromiseResult<IReceivedConversation | null>;
+    /**
+     * 获取未读会话列表
+     */
+    abstract getUnreadConversationList(conversationTypes: ConversationType[]): IPromiseResult<IReceivedConversation[]>;
     /**
      * 删除会话
      * @description 该删除操作会删除服务器端存储的会话数据
@@ -6594,11 +6259,15 @@ declare abstract class AEngine implements IEngine {
     /**
      * 断开连接
      */
-    abstract disconnect(): void;
+    abstract disconnect(): Promise<void>;
     /**
      * 拉取用户级配置数据
      */
     abstract pullUserSettings(version: number): IPromiseResult<IServerUserSetting>;
+    /**
+     * 获取当前连接状态
+     */
+    abstract getConnectionStatus(): RCConnectionStatus;
     /**
      * 消息注册
      * @description
@@ -6909,7 +6578,7 @@ declare abstract class AEngine implements IEngine {
     /**
      * 获取消息
     */
-    abstract getMessage(messageId: number): IPromiseResult<IReceivedMessage>;
+    abstract getMessage(messageId: number | string): IPromiseResult<IReceivedMessage>;
     /**
      * 设置消息内容
     */
@@ -7014,7 +6683,7 @@ declare abstract class AEngine implements IEngine {
     /**
      * 无差别获取本地置顶列表
      */
-    abstract getTopConversationList(): Promise<IAsyncRes<IBaseConversationInfo[]>>;
+    abstract getTopConversationList(conversationTypes: ConversationType[], channelId?: string): Promise<IAsyncRes<IReceivedConversation[]>>;
     /**
      * 获取单个群聊会话 @ 消息未读数
      */
@@ -7118,6 +6787,18 @@ declare abstract class AEngine implements IEngine {
      * Engine 反初始化
      */
     destroy(): void;
+    /**
+     * 设置代理
+     */
+    abstract setProxy(proxy: IProxy | null): IPromiseResult<IProxy>;
+    /**
+    * 获取代理
+    */
+    abstract getProxy(): IPromiseResult<IProxy>;
+    /**
+     * 测试代理
+     */
+    abstract testProxy(proxy: IProxy, testHost: string): Promise<IResponse>;
 }
 
 declare class AppStorage {
@@ -7262,6 +6943,7 @@ declare const notEmptyObject: (val: Object) => boolean;
 declare const isValidConversationType: (conversation: number) => boolean;
 declare const isValidNotificationLevel: (level: number) => boolean;
 declare const isValidChannelId: (value: any) => boolean;
+declare const isTypeInConversationList: (type: number) => boolean;
 /**
  * 判断是否是一个有效的文件类型
  */
@@ -7292,31 +6974,31 @@ declare function ID(): string;
 /**
  * @deprecated
  */
-declare function init(userLogInfo: ILogInit): void;
+declare function init(userLogInfo: any): void;
 /**
  * @deprecated
  */
-declare function log(logLevel: LogLevel, tagId: LogTagId | string, logObj?: Object, logExtens?: ILogExtensions): void;
+declare function log(logLevel: LogLevel, tagId: LogTagId | string, logObj?: Object, logExtens?: any): void;
 /**
  * @deprecated
  */
-declare const debug: (tagId: string, logObj?: Object | undefined, logExtens?: ILogExtensions | undefined) => void;
+declare const debug: (tagId: string, logObj?: Object | undefined, logExtens?: any) => void;
 /**
  * @deprecated
  */
-declare const info: (tagId: string, logObj?: Object | undefined, logExtens?: ILogExtensions | undefined) => void;
+declare const info: (tagId: string, logObj?: Object | undefined, logExtens?: any) => void;
 /**
  * @deprecated
  */
-declare const warn: (tagId: string, logObj?: Object | undefined, logExtens?: ILogExtensions | undefined) => void;
+declare const warn: (tagId: string, logObj?: Object | undefined, logExtens?: any) => void;
 /**
  * @deprecated
  */
-declare const error: (tagId: string, logObj?: Object | undefined, logExtens?: ILogExtensions | undefined) => void;
+declare const error: (tagId: string, logObj?: Object | undefined, logExtens?: any) => void;
 /**
  * @deprecated
  */
-declare const fatal: (tagId: string, logObj?: Object | undefined, logExtens?: ILogExtensions | undefined) => void;
+declare const fatal: (tagId: string, logObj?: Object | undefined, logExtens?: any) => void;
 
 declare const base_logLevelTransformer: typeof logLevelTransformer;
 declare const base_ID: typeof ID;
@@ -7553,11 +7235,6 @@ declare const getBrowser: (runtime: IRuntime) => {
     type: any;
     version: any;
 };
-/**
- * 将连接时服务端返回码转换成业务响应码
- * @param code 连接响应码
- */
-declare const formatConnectResponseCode: (code: number) => ErrorCode;
 declare const clone: (target: any) => any;
 
 /**
@@ -7647,6 +7324,12 @@ declare const DB_LOG_FLUSH_FREQUENCY = 3000;
 declare const ONE_LOG_SIZE_MAX = 1000;
 /** 日志上报域名 */
 declare const LOG_REPORT_URI = "logcollection.ronghub.com";
+/** SDK 版本号 */
+declare const VERSION: string;
+/**
+ * 祛除标签的标准版本号，如愿版本号为 `3.1.0-alpha.1`，则该值为 `3.1.0`
+ */
+declare const FORMATED_VERSION: string;
 
 /**
  * 请使用 `Codec` 替代 `AbsCodec`
@@ -7655,8 +7338,9 @@ declare const LOG_REPORT_URI = "logcollection.ronghub.com";
 declare type AbsCodec<T> = Codec<T>;
 
 /**
+ * @deprecated
  * engine 版本号
  */
 declare const version: string;
 
-export { AEngine, APIContext, AbsCodec, AppStorage, AssertRules, BasicLogger, BasicReporter, CPP_PROTOCAL_MSGTYPE_OPTION, CallLibMsgType, ChatroomEntryType, ChatroomUserChangeType, Codec, CodecPBMaps, ConnectResultCode, ConnectionStatus, ConversationType, DB_LOG_FLUSH_FREQUENCY, DB_LOG_MAX_SIZE, DelayTimer, EnableLogL, ErrorCode, EventEmitter, FileType, HTTP_TIMEOUT, HttpMethod, IAPIContextOption, IAndroidPushConfig, IAsyncRes, IBaseConversationInfo, IBigdataLogInit, IBlockedMessageInfo, ICancelRoomPKOptions, IChatRoomEntries, IChatRoomEntry, IChatroomEntries, IChatroomEntry, IChatroomEntryListenerData, IChatroomInfo, IChatroomListener, IChatroomListenerData, IChatroomRejoinedFailed, IChatroomRejoinedInfo, IChatroomRejoinedSuccessed, IChatroomUser, IChatroomUserChangeInfo, IChrmKVEntries, IChrmKVEntry, IConnectResult, IConnectionStatusListener, IConversationOption, IConversationState, IConversationStateListener, IConversationTag, IConversationTagListener, IDeletedExpansion, IDeliveredUser, IEndRoomPKOptions, IEngine, IEngineWatcher, IEventListener, IExpansionListener, IExpansionListenerData, IExpansionMsgContent, IExtraMethod, IGetMsgOption, IGetUltraGroupListOption, IGooglePushConfig, IGroupMessageDeliverInfo, IGroupMessageDeliverStatus, IInitBigDataOption, IInsertMsgOptions, IIsValidExpansion, IJoinRTCRoomData, ILocalReadReceiptInfo, ILocalTagStatus, ILogDB, ILogData, ILogExtensions, ILogInfo, ILogInit, 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, INaviInfo, IOSInfo, IOperateStatusNotify, IPluginGenerator, IProcessInfo, IPromiseResult, IPushConfig, IRTCInnerListener, IRTCJoinedInfo, IRTCRoomBindOption, IRTCRoomInfo, IRTCUserData, IRTCUsers, IReadReceiptInfo, IRealTimeLog, IRecallMsgContent, IRecallMsgOptions, IReceivedConversation, IReceivedConversationByTag, IReceivedMessage, IRemoveChatRoomEntries, IRemoveChatRoomEntry, IRemoveChatroomEntries, IRemoveChatroomEntry, IReqRoomPKOptions, IRequest, IResRoomPKOptions, IResponse, IRtcTokenData, IRuntime, ISendExMsgOptions, ISendMsgOptions, IServerConversationStatus, IServerRTCRoomEntry, IServerUserSetting, ISetConversationStatusOptions, IStorage, ITagInfo, ITagListener, ITagParam, ITagStatus, ITypingInfo, ITypingMessage, ITypingUser, IUltraChannelChangeInfo, IUltraChannelDeleteInfo, IUltraChannelUserKickedInfo, IUltraExMsgOptions, IUltraGroupConversation, IUltraGroupOption, IUltraGroupUnreadMentionedOption, IUltraModifyMsgOptions, IUltraMsgQueryOptions, IUltraUnreadConversation, IUltraUnreadMsg, IUpdatedConversation, IUpdatedExpansion, IUploadAuth, IUserProfile, IWatcher, IWebSocket, IiOSPushConfig, IndexDBLogger, IndexDBReporter, RTCKeyMaps as InnerRTCKeyMaps, ItypingStateListener, KVString, LOG_REPORT_URI, LiveRole, LiveType, LogContent, LogL, LogLevel, LogSource, LogTagId, LogType, Logger, MAX_MESSAGE_CONTENT_BYTES, MAX_MESSAGE_EXPANSION_KEY_LENGTH, MAX_MESSAGE_EXPANSION_VAL_LENGTH, MINI_SOCKET_CONNECT_URIS, MentionedType, MessageBlockSourceType, MessageBlockType, MessageDirection, MessageType, NAVI_CACHE_DURATION, NAVI_REQ_TIMEOUT, NetworkType, NotificationLevel, NotificationStatus, ONE_LOG_SIZE_MAX, OperateStatus, PUBLIC_CLOUD_NAVI_URIS, PluginContext, RCAssertError, REAT_TIME_LOG_SIZE, RTCApiType, RTCIdentityChangeType, RTCJoinType, RTCMode, RTCPluginContext, ReceivedStatus, SEND_MESSAGE_TYPE_OPTION, STATUS_MESSAGE, STORAGE_ROOT_KEY, StoreKeys, TagChangeType, UltraGroupChannelChangeType, UltraGroupChannelType, UltraMsgChangeType, UltraMsgSubChangeType, UploadMethod, VersionManage, WEB_SOCKET_TIMEOUT, WebSocketChannel, appendUrl, assert, clone, cloneByJSON, deInitLogDB, logger as engineLogger, forEach, formatConnectResponseCode, getBrowser, getClientMessageId, getMimeKey, getUUID, getUUID22, getUploadFileName, indexOf, initLogDB, isArray, isArrayBuffer, isBoolean, isFunction, isHttpUrl, isInObject, isInclude, isNull, isNumber, isObject, isString, isUndefined, isValidChannelId, isValidChrmEntryKey, isValidChrmEntryValue, isValidConversationType, isValidExpansion, isValidFileType, isValidNotificationLevel, base as logger, map, notEmptyArray, notEmptyObject, notEmptyString, pushConfigsToJSON, pushJSONToConfigs, todo, transcsv, usingCppEngine, validate, version };
+export { AConnectionMgr, AEngine, APIContext, AbsCodec, AppStorage, AssertRules, BasicLogger, BasicNavi, BasicReporter, CPP_PROTOCAL_MSGTYPE_OPTION, CallLibMsgType, ChatroomEntryType, ChatroomUserChangeType, Codec, CodecPBMaps, ConnectionStatus, ConversationType, DB_LOG_FLUSH_FREQUENCY, DB_LOG_MAX_SIZE, DelayTimer, EnableLogL, ErrorCode, EventEmitter, FORMATED_VERSION, FileType, HTTP_TIMEOUT, HttpMethod, IAPIContextOption, IAndroidPushConfig, IAsyncRes, IBaseConversationInfo, IBlockedMessageInfo, ICancelRoomPKOptions, IChatRoomEntries, IChatRoomEntry, IChatroomEntries, IChatroomEntry, IChatroomEntryListenerData, IChatroomInfo, IChatroomListener, IChatroomListenerData, IChatroomRejoinedFailed, IChatroomRejoinedInfo, IChatroomRejoinedSuccessed, IChatroomUser, IChatroomUserChangeInfo, IChrmKVEntries, IChrmKVEntry, IConnectResult, IConnectionListener, IConnectionStatusListener, IConversationOption, IConversationState, IConversationStateListener, IConversationTag, IConversationTagListener, IDeletedExpansion, IDeliveredUser, IEndRoomPKOptions, IEngine, IEngineWatcher, IEventListener, IExpansionListener, IExpansionListenerData, IExpansionMsgContent, IExtraMethod, IGetMsgOption, IGetUltraGroupListOption, IGooglePushConfig, IGroupMessageDeliverInfo, IGroupMessageDeliverStatus, IGroupMessageDeliveredStatusInfo, 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, INaviInfo, 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, IStorage, ITagInfo, ITagListener, ITagParam, ITagStatus, ITypingInfo, ITypingMessage, ITypingUser, IUltraChannelChangeInfo, IUltraChannelDeleteInfo, IUltraChannelUserKickedInfo, IUltraExMsgOptions, IUltraGroupConversation, IUltraGroupOption, IUltraGroupUnreadMentionedOption, IUltraModifyMsgOptions, IUltraMsgQueryOptions, IUltraUnreadConversation, IUltraUnreadMsg, IUpdatedConversation, IUpdatedExpansion, IUploadAuth, IUserProfile, IWatcher, IWebSocket, IiOSPushConfig, IndexDBLogger, IndexDBReporter, RTCKeyMaps as InnerRTCKeyMaps, ItypingStateListener, KVString, LOG_REPORT_URI, LiveRole, LiveType, LogContent, LogL, LogLevel, LogSource, LogTagId, LogType, Logger, MAX_MESSAGE_CONTENT_BYTES, MAX_MESSAGE_EXPANSION_KEY_LENGTH, MAX_MESSAGE_EXPANSION_VAL_LENGTH, MINI_SOCKET_CONNECT_URIS, MentionedType, MessageBlockSourceType, MessageBlockType, MessageDirection, MessageType, NAVI_CACHE_DURATION, NAVI_REQ_TIMEOUT, NetworkType, NotificationLevel, NotificationStatus, ONE_LOG_SIZE_MAX, OperateStatus, PUBLIC_CLOUD_NAVI_URIS, PluginContext, RCAssertError, RCConnectionStatus, REAT_TIME_LOG_SIZE, RTCApiType, RTCIdentityChangeType, RTCJoinType, RTCMode, RTCPluginContext, ReceivedStatus, SEND_MESSAGE_TYPE_OPTION, STATUS_MESSAGE, STORAGE_ROOT_KEY, StoreKeys, TagChangeType, UltraGroupChannelChangeType, UltraGroupChannelType, UltraMsgChangeType, UltraMsgSubChangeType, UploadMethod, VERSION, VersionManage, WEB_SOCKET_TIMEOUT, WebSocketNavi, appendUrl, assert, clone, cloneByJSON, deInitLogDB, logger as engineLogger, forEach, getBrowser, getClientMessageId, getMimeKey, getUUID, getUUID22, getUploadFileName, indexOf, initLogDB, isArray, isArrayBuffer, isBoolean, isConnnectAckCode as isConnnectAck, isDisconnectCode as isDisconnectedByServer, isFunction, isHttpUrl, isInObject, isInclude, isNull, isNumber, isObject, isString, isTypeInConversationList, isUndefined, isValidChannelId, isValidChrmEntryKey, isValidChrmEntryValue, isValidConversationType, isValidExpansion, isValidFileType, isValidNotificationLevel, base as logger, map, notEmptyArray, notEmptyObject, notEmptyString, pushConfigsToJSON, pushJSONToConfigs, todo, transcsv, usingCppEngine, validate, version };