@rongcloud/engine 5.3.3 → 5.3.4

package/index.d.ts

@@ -1190,9 +1190,9 @@ declare enum ErrorCode {
      */
     CHATROOM_KEY_NOT_EXIST = 23427,
     /*!
-     聊天室设置 KV 失败，出现在两人或者多端同时操作一个 kv。
-     如果出现该错误，为避免和其他端同时操作，请延时一定时间再试
-    */
+      聊天室设置 KV 失败，出现在两人或者多端同时操作一个 kv。
+      如果出现该错误，为避免和其他端同时操作，请延时一定时间再试
+      */
     CHATROOM_KV_SET_ERROR = 23431,
     /**
      * 敏感词屏蔽
@@ -1327,6 +1327,10 @@ declare enum ErrorCode {
      * Disconnect，由服务器返回，比如用户互踢。
      */
     RC_DISCONN_EXCEPTION = 31011,
+    /**
+     * 开启禁止把已在线客户端踢下线开关后，该错误码标识已有同类型端在线，禁止链接；
+     */
+    RC_DISCONN_SAME_CLIENT_ON_LINE = 31023,
     /**
      * app 验证Token 验证不通过。所有内部超时，访问失败,返回给客户端sdk都是验证不通过，由服务端日志去看具体是那种失败。
      */
@@ -1416,11 +1420,11 @@ declare enum ErrorCode {
     CONVER_CLEAR_ERROR = 34007,
     /**
      * 扩展存储 key value 超出限制 (错误码与移动端对齐)
-    */
+     */
     EXPANSION_LIMIT_EXCEET = 34010,
     /**
      * 消息不支持扩展，原消息 canIncludeExpansion 值为 false (错误码与移动端对齐)
-    */
+     */
     MESSAGE_KV_NOT_SUPPORT = 34008,
     CLEAR_HIS_TIME_ERROR = 34011,
     /**
@@ -2272,6 +2276,10 @@ interface IChatroomEntries {
      * 用户退出聊天室时是否清除此属性
      */
     isAutoDelete?: boolean;
+    /**
+     * 是否强制覆盖
+     */
+    isForce?: boolean;
 }
 
 interface IUploadAuth {
@@ -2679,6 +2687,10 @@ declare enum ConnectionStatus {
      * appkey 不正确
      */
     APPKEY_IS_FAKE = 20,
+    /**
+    * 其他端登录，本端禁止连接和重连
+    */
+    FORBID_RECONNECT_BY_OTHER_SAME_CLIENT = 31023,
     /**
      * 互踢次数过多（`count > 5`），此时可能出现：在其它他设备登陆有 reconnect 逻辑
      */
@@ -2933,44 +2945,83 @@ interface IMetionedData {
 }
 
 declare enum LogLevel {
-    /**
-     * 等同于 `LogLevel.DEBUG`
-     */
     LOG = 0,
-    /**
-     * 0
-     */
     DEBUG = 0,
-    /**
-     * 1
-     */
     INFO = 1,
-    /**
-     * 2
-     */
     WARN = 2,
-    /**
-     * 3
-     */
     ERROR = 3,
-    /**
-     * 4
-     */
     FATAL = 4,
-    /**
-     * 统计日志类型
-     */
     STATISTICS = 6,
-    /**
-     * 不展示任何日志
-     */
     NONE = 1000
 }
-
-declare enum LogType {
+declare enum LogSource {
     IM = "IM",
     RTC = "RTC"
 }
+declare enum LogTagId {
+    L_IMSDK_VER_O = "L-imsdk_ver-O",
+    A_INIT_O = "A-init-O",
+    L_INIT_O = "L-init-O",
+    P_INIT_O = "P-init-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",
+    L_CONNECT_T = "L-connect-T",
+    L_CONNECT_R = "L-connect-R",
+    L_CONNECT_S = "L-connect-S",
+    P_CONNECT_O = "P-connect-O",
+    P_CONNECT_S = "P-connect-S",
+    A_SEND_MSG_T = "A-send_msg-T",
+    A_SEND_MSG_R = "A-send_msg-R",
+    P_SEND_MSG_T = "P-send_msg-T",
+    P_SEND_MSG_R = "P-send_msg-R",
+    L_SEND_MSG_T = "L-send_msg-T",
+    L_SEND_MSG_R = "L-send_msg-R",
+    L_PULL_MSG_T = "L-pull_msg-T",
+    L_PULL_MSG_R = "L-pull_msg-R",
+    L_PULL_ULTRA_MSG_T = "L-pull_ultra_msg-T",
+    L_PULL_ULTRA_MSG_R = "L-pull_ultra_msg-R",
+    L_PULL_CHATROOM_KV_T = "L-pull_chatroom_kv-T",
+    L_PULL_CHATROOM_KV_R = "L-pull_chatroom_kv-R",
+    L_PULL_CHATROOM_MSG_T = "L-pull_chatroom_msg-T",
+    L_PULL_CHATROOM_MSG_R = "L-pull_chatroom_msg-R",
+    A_DELETE_MESSAGES_S = "A-delete_messages-S",
+    P_DELETE_MSG_S = "P-delete_msg-S",
+    L_PULL_CONVERSATION_S = "L-pull_conversation-S",
+    L_RECALL_ULTRA_MSG_S = "L-recall_ultra_msg-S",
+    A_REGTYP_O = "A-regtyp-O",
+    P_REGTYP_O = "P-regtype-O",
+    P_REGTYP_E = "P-regtype-E",
+    L_GET_NAVI_T = "L-get_navi-T",
+    L_GET_NAVI_R = "L-get_navi-R",
+    L_ENV_S = "L-Env-S",
+    L_GET_INDEX_NAVI_S = "L-get_index_navi-S",
+    A_JOIN_CHATROOM_T = "A-join_chatroom-T",
+    A_JOIN_CHATROOM_R = "A-join_chatroom-R",
+    L_JOIN_CHATROOM_T = "L-join_chatroom-T",
+    L_JOIN_CHATROOM_R = "L-join_chatroom-R",
+    A_QUIT_CHATROOM_T = "A-quit_chatroom-T",
+    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_MEDIA_S = "L-media-S",
+    L_MEDIA_UPLOAD_T = "L-media_upload-T",
+    L_MEDIA_UPLOAD_R = "L-media_upload-R",
+    G_UPLOAD_LOG_S = "G-upload_log-S",
+    G_UPLOAD_LOG_E = "G-upload_log-E",
+    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",
+    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_CALLBACK_O = "A-callback-O",
+    A_CALLBACK_E = "A-callback-E"
+}
 
 /**
  * 拓展方法定义，便于 electron-solution 实现时保持接口类型推导可用
@@ -3705,6 +3756,32 @@ interface ITypingMessage {
     list: Array<ITypingUser>;
 }
 
+/**
+ * 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;
+}
+
 /**
  * 定义已废弃，请使用 `IRemoveChatroomEntries` 替换
  * @deprecated
@@ -3965,7 +4042,7 @@ declare class DataCodec {
     /**
       * 设置会话状态 (置顶、免打扰)
     */
-    encodeSetConversationStatus(statusList: Array<ISetConversationStatusOptions>): any;
+    encodeSetConversationStatus(statusList: Array<ISetConversationStatusOptions>, conversationUpdatedTime: number): any;
     /**
      * 序列化发送群组已读回执
      */
@@ -4230,32 +4307,6 @@ declare class CometChannel extends ADataChannel {
     close(): void;
 }
 
-interface IPluginGenerator<API, InitOption> {
-    /**
-     * 只读插件标识
-     */
-    readonly tag: string;
-    /**
-     * 版本号
-     */
-    readonly version?: string;
-    /**
-     * 插件名称
-     */
-    readonly name?: string;
-    /**
-     * 插件安装前的环境检测，通过返回 boolean 值确认插件是否可运行
-     */
-    verify(runtime: IRuntime): boolean;
-    /**
-     * 插件初始化
-     * @param context 插件调用上下文，用于实现插件的消息注册、消息首发等
-     * @param runtime 运行时实例，用于标识最终的运行时平台
-     * @param options 初始化参数
-     */
-    setup(context: PluginContext, runtime: IRuntime, options: InitOption): API;
-}
-
 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;
@@ -4375,6 +4426,32 @@ interface IAPIContextOption {
     checkCA?: boolean;
 }
 
+interface IPluginGenerator<API, InitOption> {
+    /**
+     * 只读插件标识
+     */
+    readonly tag: string;
+    /**
+     * 版本号
+     */
+    readonly version?: string;
+    /**
+     * 插件名称
+     */
+    readonly name?: string;
+    /**
+     * 插件安装前的环境检测，通过返回 boolean 值确认插件是否可运行
+     */
+    verify(runtime: IRuntime): boolean;
+    /**
+     * 插件初始化
+     * @param context 插件调用上下文，用于实现插件的消息注册、消息首发等
+     * @param runtime 运行时实例，用于标识最终的运行时平台
+     * @param options 初始化参数
+     */
+    setup(context: PluginContext, runtime: IRuntime, options: InitOption): API;
+}
+
 declare class APIContext {
     private _runtime;
     private static _context?;
@@ -4501,7 +4578,7 @@ declare class APIContext {
         这个字段就是为这种情况加的。
         设置 reconnectKickEnable 为 true 时，SDK 重连的时候发现此时已有别的设备连接成功，不再强行踢出已有设备，而是踢出重连设备。
      */
-    connect(token: string, refreshNavi?: boolean, reconnectKickEnable?: boolean): Promise<IConnectResult>;
+    connect(token: string, refreshNavi?: boolean, reconnectKickEnable?: boolean, traceId?: string): Promise<IConnectResult>;
     /**
      * 拉取实时配置 web 端需更新 voipCall 字段
      */
@@ -4531,7 +4608,7 @@ declare class APIContext {
      * @param content
      * @param options
      */
-    sendMessage(conversationType: ConversationType, targetId: string, options: ISendMsgOptions, onBefore?: (messageId: number) => void): Promise<IAsyncRes<IReceivedMessage>>;
+    sendMessage(conversationType: ConversationType, targetId: string, options: ISendMsgOptions, onBefore?: (messageId: number) => void, traceId?: string): Promise<IAsyncRes<IReceivedMessage>>;
     /**
      * 发送扩展消息
      * @param messageUId 消息 Id
@@ -4565,7 +4642,7 @@ declare class APIContext {
      * @param channelId
      * @param objectName
      */
-    getHistoryMessage(conversationType: ConversationType, targetId: string, timestamp?: number, count?: number, order?: 0 | 1, channelId?: string, objectName?: string): Promise<IAsyncRes<{
+    getHistoryMessage(conversationType: ConversationType, targetId: string, timestamp?: number, count?: number, order?: 0 | 1, channelId?: string, objectName?: string, traceId?: string): Promise<IAsyncRes<{
         list: IReceivedMessage[];
         hasMore: boolean;
     }>>;
@@ -4662,13 +4739,13 @@ declare class APIContext {
      * @param roomId 聊天室房间 Id
      * @param count 进入聊天室成功后，自动拉取的历史消息数量，默认值为 `10`，最大有效值为 `50`，`-1` 为不拉取
      */
-    joinChatroom(roomId: string, count?: number): Promise<ErrorCode>;
+    joinChatroom(roomId: string, count?: number, traceId?: string): Promise<ErrorCode>;
     /**
      * 加入聊天室，若聊天室不存在则抛出异常
      * @param roomId 聊天室房间 Id
      * @param count 进入聊天室成功后，自动拉取的历史消息数量，默认值为 `10`，最大有效值为 `50`，`-1` 为不拉取
      */
-    joinExistChatroom(roomId: string, count?: number): Promise<ErrorCode>;
+    joinExistChatroom(roomId: string, count?: number, traceId?: string): Promise<ErrorCode>;
     /**
      * 退出聊天室
      * @param roomId
@@ -4774,6 +4851,7 @@ declare class APIContext {
     getFileToken(fileType: FileType, fileName?: string, httpMethod?: 'POST' | 'PUT', queryString?: string): Promise<IUploadAuth & {
         bos: string;
         qiniu: string;
+        ossConfig: string;
     }>;
     /**
      * 获取 七牛、百度、阿里云 上传成功可下载的 URL
@@ -5358,7 +5436,7 @@ declare abstract class AEngine implements IEngine {
      * @param naviInfo
      * @param reconnectKickEnable
      */
-    abstract connect(token: string, naviInfo: INaviInfo, reconnectKickEnable?: boolean): Promise<ErrorCode>;
+    abstract connect(token: string, naviInfo: INaviInfo, reconnectKickEnable?: boolean, traceId?: string): Promise<ErrorCode>;
     /**
      * 发送SDK版本
      * @param versionInfo
@@ -5396,7 +5474,7 @@ declare abstract class AEngine implements IEngine {
     /**
      * 消息类型
      */
-    objectName: string): IPromiseResult<{
+    objectName: string, traceId?: string): IPromiseResult<{
         list: IReceivedMessage[];
         hasMore: boolean;
     }>;
@@ -5512,7 +5590,7 @@ declare abstract class AEngine implements IEngine {
     /**
      * c++ 消息写库后存在自增 Id，必要时需要向业务层暴露，JSEngine 无需实现
      */
-    onBefore?: (messageId: number) => void): IPromiseResult<IReceivedMessage>;
+    onBefore?: (messageId: number) => void, traceId?: string): IPromiseResult<IReceivedMessage>;
     /**
      * 发送群组消息已读回执
      * 导航下发已读回执开关为 true 时调用
@@ -5550,12 +5628,12 @@ declare abstract class AEngine implements IEngine {
      * 加入聊天室
      * @param count 拉取消息数量
     */
-    abstract joinChatroom(chatroomId: string, count: number): Promise<ErrorCode>;
+    abstract joinChatroom(chatroomId: string, count: number, traceId?: string): Promise<ErrorCode>;
     /**
      * 加入已存在的聊天室
      * @param count 拉取消息数量
     */
-    abstract joinExistChatroom(chatroomId: string, count: number): Promise<ErrorCode>;
+    abstract joinExistChatroom(chatroomId: string, count: number, traceId?: string): Promise<ErrorCode>;
     /**
      * 退出聊天室
     */
@@ -5750,7 +5828,7 @@ declare abstract class AEngine implements IEngine {
      * @param targetId
      * @param options
      */
-    abstract sendUltraMessage(targetId: string, options: ISendMsgOptions): Promise<IAsyncRes>;
+    abstract sendUltraMessage(targetId: string, options: ISendMsgOptions, traceId?: string): Promise<IAsyncRes>;
     /**
      * 超级群消息正在输入中
      * @param options
@@ -5776,7 +5854,7 @@ declare abstract class AEngine implements IEngine {
      * @param targetId
      * @param options
      */
-    abstract getUltraHistoryMsg(targetId: string, options: IGetMsgOption): Promise<IAsyncRes>;
+    abstract getUltraHistoryMsg(targetId: string, options: IGetMsgOption, traceId?: string): Promise<IAsyncRes>;
     abstract getConversationListWithAllChannel(): IPromiseResult<IReceivedConversation[]>;
     abstract getConversationListWithAllChannelByPage(index: number, limit: number): IPromiseResult<IReceivedConversation[]>;
     /**
@@ -5997,232 +6075,6 @@ declare const appendUrl: (url: string, query?: {
     [key: string]: string | number | null;
 } | undefined) => string;
 
-/**
- * IndexDB中存储的log数据
- */
-interface ILogInfo {
-    sessionId: string;
-    time: number;
-    level: LogLevel;
-    content: string;
-    userId: string;
-}
-interface IRealTimeLog {
-    level: LogLevel;
-    content: string;
-}
-
-interface ILogPolicy {
-    url: string;
-    level: number;
-    itv: number;
-    times: number;
-}
-interface IReportLogInitInfo {
-    runtime: IRuntime;
-    logSwitch: number;
-    logPolicy: ILogPolicy;
-    appkey: string;
-    version: string;
-    userId?: string;
-    sessionId?: string;
-}
-/**
- * 更新上传日志属性
- */
-interface IReportLogUpdateInfo {
-    runtime?: IRuntime;
-    logSwitch?: number;
-    logPolicy?: ILogPolicy;
-    appkey?: string;
-    version?: string;
-    userId?: string;
-    sessionId?: string;
-}
-/**
- * 初始化上传日志属性
- */
-interface IFullLogParams {
-    startTime: number;
-    endTime: number;
-    platform: string;
-    logId: string;
-    uri: string;
-    packageName?: string;
-}
-/**
- * 日志上报类
- */
-declare class UploadLog {
-    private info;
-    private logUrl;
-    level: number;
-    itv: number;
-    times: number;
-    private deviceId;
-    private deviceInfo;
-    logSwitch: number;
-    static currentRTTimes: number;
-    static reportSwitch: boolean;
-    private static _instance;
-    constructor(info: IReportLogInitInfo);
-    /**
-     * 重新设置类属性
-     */
-    updateUploadLogAttr(info: IReportLogUpdateInfo): void;
-    static init(info: IReportLogInitInfo): UploadLog;
-    static getInstance(): UploadLog | null;
-    /**
-     * 上报实时日志
-     */
-    reportRealtimeLog(list: IRealTimeLog[]): Promise<void>;
-    /**
-     * 上报全量日志
-     */
-    reportFullLog(params: IFullLogParams): Promise<void>;
-    distroy(): void;
-}
-
-/** 统计数据标签 **/
-declare enum StatisticsTag {
-    'IM_NAVI' = "IM-stats_navi-S",
-    'IM_WEBSOCKET' = "IM-stats_websocket-S",
-    'IM_COMET' = "IM-stats_comet-S",
-    'IM_CONNECTION_DURATION' = "IM-stats_con_dur-S"
-}
-
-/** 统计日志公共数据参数 */
-interface IUpdateBaseStatisticsDataOption {
-    sdkPrivate?: number;
-    serverPrivate?: number;
-    bundleId?: string;
-}
-/** 统计日志公共数据 */
-interface IBaseStatisticsData {
-    sdkPrivate: number;
-    serverPrivate: number;
-    bundleId: string;
-}
-
-declare class Logger {
-    readonly tag: string;
-    readonly type?: LogType | undefined;
-    private readonly initiator?;
-    /**
-     *
-     * @param tag 标签
-     * @param type 类型
-     * @param initiator 发起方(A: APP 层，L: Lib 层)
-     */
-    constructor(tag: string, type?: LogType | undefined, initiator?: string | undefined);
-    /**
-     * 输出等级
-     */
-    private _outLevel;
-    /**
-     * 为向前兼容，暂不删除
-     */
-    private _stdout?;
-    /**
-     * 输出函数
-     */
-    private _logStdout?;
-    /**
-     * 本地存储日志列表
-     */
-    static databaseLogList: ILogInfo[];
-    /**
-     * 定时上传日志列表
-     */
-    static realTimeLogList: IRealTimeLog[];
-    static readonly sessionId: string;
-    static userId: string;
-    static init(userId: string): void;
-    static reset(): void;
-    /**
-     * 默认输出函数
-     * @param level
-     * @param args
-     */
-    private _defaultStdout;
-    /**
-     * 向 databaseLogList 中 push 日志
-     * @param level 打印等级
-     * @param content 日志内容
-     * @param tag 日志tag
-     */
-    __pushLocalLog(level: LogLevel, content: string, tag: string): void;
-    /**
-     * 向数据库中插入 log 数据
-     */
-    __insertLogIntoDatabase(): Promise<boolean>;
-    /**
-     * 修改 log 输出等级
-     * @param logLevel
-     */
-    setLogLevel(logLevel?: LogLevel): void;
-    setLogStdout(stdout?: (level: LogLevel, content: string) => void): void;
-    log(level: LogLevel, ...args: any[]): void;
-    debug: (...args: any[]) => void;
-    info: (...args: any[]) => void;
-    warn: (...args: any[]) => void;
-    error: (...args: any[]) => void;
-    fatal: (...args: any[]) => void;
-    /**
-     * 日志实时上报
-     * @param level 日志等级
-     * @param tag 日志标签
-     * @param content 日志内容
-     */
-    reportLog(level: LogLevel, tag: string, content: string): void;
-    /**
-     * @deprecated
-     * 函数已废弃，使用 `setLogLevel` 与 `setStdout` 方法替代
-     */
-    set(outLevel: LogLevel, stdout?: (level: LogLevel, ...args: any[]) => void): void;
-    /**
-     * 接口已废弃，改用 `setLogStdout`
-     * @param stdout
-     * @deprecated
-     */
-    setStdout(stdout?: (level: LogLevel, msgTag: string, ...args: any[]) => void): void;
-    __clearRealTimeLog(): void;
-    /** 日志上传实例 */
-    static _reportLog: UploadLog;
-    /** 初始化日志上传 */
-    initReportLog(info: IReportLogInitInfo): void;
-    /**
-     * 设置日志上传实例属性
-     */
-    updateUploadLogAttr(info: IReportLogUpdateInfo): void;
-    /**
-     * 开始上报实时日志（定时上传）
-     * @returns void
-     */
-    startReport(): void;
-    /**
-     * 上报统计日志
-     * @param tag 统计日志类型
-     * @param content 日志内容
-     */
-    reportStatisticsLog(tag: StatisticsTag | string, content: any): Promise<void>;
-    /** 统计日志缓存数据 */
-    private statisticsCaches;
-    private baseStatisData;
-    /**
-     * 更新统计日志共用数据 updateStatisticsBaseData
-     */
-    updateStatisticsBaseData(options: IUpdateBaseStatisticsDataOption): void;
-    /** 获取统计日志共用数据 getStatisticsBaseData */
-    getStatisticsBaseData(): IBaseStatisticsData;
-    /** 设置统计日志数据 setStatisticsData */
-    setStatisticsData<T>(tag: StatisticsTag | string, options?: T | {
-        [key: string]: any;
-    }, isReset?: boolean): void;
-    /** 获取数据 getStatisticsData */
-    getStatisticsData<T>(tag: StatisticsTag | string): T | any;
-}
-
 declare type IEventListener = (...args: any[]) => void;
 declare class EventEmitter {
     private readonly _map;
@@ -6350,6 +6202,148 @@ declare const isValidExpansion: (expansion: {
     [key: string]: string;
 } | undefined) => IIsValidExpansion;
 
+/** ******************************************新重构logger，按照Web新日志规范上报  ********************************** **/
+declare const sessionId: string;
+/**
+ * logLevelTransformer
+ * @description 数据中心与前端日志规范LogLevel定义不统一
+ *              WebLogLevel(前端日志级别) -> ServerLogLevel（服务器日志级别）
+ * @param level { LogLevel }
+ * @returns serverLogLevel
+ */
+declare function logLevelTransformer(level: LogLevel): number;
+/**
+ * 序列化引用型数据为字符串
+ * @value value
+ */
+declare const formatLogObj: (value: unknown) => unknown;
+/**
+* 缓存日志
+* @param logLevel 打印等级
+* @param logObj 日志内容
+* @param tagId 日志tag
+*/
+declare function insertIntoLogCache(logLevel: LogLevel, tagId: string, logObj: any, logSource?: LogSource): ILogInfo;
+/**
+ * 本地默认输出函数
+ * @param level
+ * @param args
+ */
+declare function _defaultStdout(level: LogLevel, msgTag: string, logContent?: any): void;
+/**
+ *  Trace ID 生成器
+ */
+declare function ID(): string;
+declare function init(userLogInfo: ILogInit): void;
+declare function log(logLevel: LogLevel, tagId: LogTagId | string, logObj?: Object, logExtens?: ILogExtensions): void;
+declare const debug: (tagId: string, logObj?: Object | undefined, logExtens?: ILogExtensions | undefined) => void;
+declare const info: (tagId: string, logObj?: Object | undefined, logExtens?: ILogExtensions | undefined) => void;
+declare const warn: (tagId: string, logObj?: Object | undefined, logExtens?: ILogExtensions | undefined) => void;
+declare const error: (tagId: string, logObj?: Object | undefined, logExtens?: ILogExtensions | undefined) => void;
+declare const fatal: (tagId: string, logObj?: Object | undefined, logExtens?: ILogExtensions | undefined) => void;
+
+declare const base_sessionId: typeof sessionId;
+declare const base_logLevelTransformer: typeof logLevelTransformer;
+declare const base_formatLogObj: typeof formatLogObj;
+declare const base_insertIntoLogCache: typeof insertIntoLogCache;
+declare const base__defaultStdout: typeof _defaultStdout;
+declare const base_ID: typeof ID;
+declare const base_init: typeof init;
+declare const base_log: typeof log;
+declare const base_debug: typeof debug;
+declare const base_info: typeof info;
+declare const base_warn: typeof warn;
+declare const base_error: typeof error;
+declare const base_fatal: typeof fatal;
+declare namespace base {
+  export {
+    base_sessionId as sessionId,
+    base_logLevelTransformer as logLevelTransformer,
+    base_formatLogObj as formatLogObj,
+    base_insertIntoLogCache as insertIntoLogCache,
+    base__defaultStdout as _defaultStdout,
+    base_ID as ID,
+    base_init as init,
+    base_log as log,
+    base_debug as debug,
+    base_info as info,
+    base_warn as warn,
+    base_error as error,
+    base_fatal as fatal,
+  };
+}
+
+/** *********************实时日志上报***************** */
+
+/**
+   * 缓存日志实时
+   * @param logLevel 日志等级
+   * @param tagId 日志标签
+   * @param content 日志内容
+   */
+declare function reportLog(logLevel: LogLevel, tagId: string, content: string, logSource?: LogSource): void;
+
+/** ******************************************旧Logger类，fix兼容用，逐步废弃 ********************************** **/
+
+/**
+ * @description 兼容旧版用法，建议用Logger静态方法
+ *  1、不符合新版Web日志规范
+ *  2、不支持自定义TagId
+ *  3、后续可能删除,要逐步迁移新Web规范
+ */
+declare class Logger {
+    readonly tagId: string;
+    readonly logSource?: LogSource | undefined;
+    private readonly initiator?;
+    /**
+     *
+     * @param tagId
+     * @param logSource 类型
+     * @param initiator 发起方(A: APP 层，L: Lib 层)
+     */
+    constructor(tagId: string, logSource?: LogSource | undefined, initiator?: string | undefined);
+    /**
+     *  本地控制台日志输出级别
+     */
+    private _localLogLevel;
+    /**
+     * 自定义本地日志输出函数
+     */
+    private _customLogPrint?;
+    /**
+     * 为向前兼容，暂不删除
+     */
+    private _stdout?;
+    /**
+     * 自定义本地打印日志级别
+     * @param logLevel
+     */
+    setLogLevel(logLevel?: LogLevel): void;
+    /**
+     * 自定义本地打印函数
+     */
+    setLogStdout(stdout?: (level: LogLevel, content: string) => void): void;
+    log(logLevel: LogLevel, ...args: any[]): void;
+    debug: (...args: any[]) => void;
+    info: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+    fatal: (...args: any[]) => void;
+    /**
+     * @deprecated
+     * 函数已废弃，使用 `setLogLevel` 与 `setStdout` 方法替代
+     */
+    set(outLevel: LogLevel, stdout?: (level: LogLevel, ...args: any[]) => void): void;
+    /**
+     * 接口已废弃，改用 `setLogStdout`
+     * @param stdout
+     * @deprecated
+     */
+    setStdout(stdout?: (level: LogLevel, msgTag: string, ...args: any[]) => void): void;
+    reportLog: typeof reportLog;
+}
+declare const _default: Logger;
+
 /**
  * 预定义的验证规则，只包含`值类型`数据验证
  * 引用类型数据需使用自定义 validator 校验函数进行校验
@@ -6577,10 +6571,14 @@ declare enum CONNECTION_TYPE {
     WEBSOCKET = "websocket",
     COMET = "comet"
 }
+declare const REAT_TIME_LOG_SIZE = 500;
+declare const DB_LOG_MAX_SIZE = 100000;
+declare const DB_LOG_FLUSH_FREQUENCY = 3000;
+declare const ONE_LOG_SIZE_MAX = 1000;
 
 /**
  * engine 版本号
  */
 declare const version: string;
 
-export { AEngine, APIContext, AppStorage, AssertRules, CONNECTION_TYPE, CPP_PROTOCAL_MSGTYPE_OPTION, CallLibMsgType, ChatroomEntryType, ChatroomUserChangeType as ChatroomMemberChangeType, CometChannel, ConnectResultCode, ConnectionStatus, ConversationType, DelayTimer, ErrorCode, EventEmitter, FileType, HttpMethod, IAPIContextOption, IAsyncRes, IBaseConversationInfo, IBlockedMessageInfo, ICancelRoomPKOptions, IChatRoomEntries, IChatRoomEntry, IChatroomEntries, IChatroomEntry, IChatroomInfo, IChatroomListener, IChatroomListenerData, IChrmKVEntries, IChrmKVEntry, IConnectResult, IConnectionStatusListener, IConversationOption, IConversationState, IConversationStateListener, IConversationTag, IConversationTagListener, IDataChannelWatcher, IDeletedExpansion, IEndRoomPKOptions, IEngine, IEngineWatcher, IEventListener, IExpansionListener, IExpansionListenerData, IExpansionMsgContent, IExtraMethod, IGetMsgOption, IInsertMsgOptions, IIsValidExpansion, IJoinRTCRoomData, ILocalReadReceiptInfo, ILocalTagStatus, IM_CHATROOM_PULL_INTERVAL_TIME, IM_COMET_PULLMSG_TIMEOUT, IM_PING_INTERVAL_TIME, IM_PING_MIN_TIMEOUT, IM_PING_TIMEOUT, IM_SIGNAL_TIMEOUT, IMessageListnenr, IMessageReader, IMessageReaderResponse, IMetionedData, INaviInfo, IPluginGenerator, IPromiseResult, 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, IUltraExMsgOptions, IUltraGroupOption, IUltraModifyMsgOptions, IUltraMsgQueryOptions, IUpdatedConversation, IUpdatedExpansion, IUploadAuth, IUserProfile, IWatcher, IWebSocket, ItypingStateListener, KVString, LiveRole, LiveType, LogLevel, LogType, Logger, MAX_MESSAGE_CONTENT_BYTES, MAX_MESSAGE_EXPANSION_KEY_LENGTH, MAX_MESSAGE_EXPANSION_VAL_LENGTH, MINI_COMET_CONNECT_URIS, MINI_SOCKET_CONNECT_URIS, MentionedType, MessageBlockType, MessageDirection, MessageType, NAVI_CACHE_DURATION, NAVI_REQ_TIMEOUT, NetworkType, NotificationLevel, NotificationStatus, OperateStatus, PING_REQ_TIMEOUT, PUBLIC_CLOUD_NAVI_URIS, PluginContext, RCAssertError, RTCApiType, RTCIdentityChangeType, RTCJoinType, RTCMode, RTCPluginContext, ReceivedStatus, SEND_MESSAGE_TYPE_OPTION, STATUS_MESSAGE, STORAGE_ROOT_KEY, TagChangeType, UploadMethod, VersionManage, WEB_SOCKET_TIMEOUT, WebSocketChannel, appendUrl, assert, clone, cloneByJSON, forEach, formatConnectResponseCode, getBrowser, getMimeKey, getUploadFileName, indexOf, isArray, isArrayBuffer, isBoolean, isFunction, isHttpUrl, isInObject, isInclude, isNull, isNumber, isObject, isString, isUndefined, isValidChrmEntryKey, isValidChrmEntryValue, isValidConversationType, isValidExpansion, isValidFileType, map, notEmptyArray, notEmptyObject, notEmptyString, pushConfigsToJSON, pushJSONToConfigs, todo, usingCppEngine, validate, version };
+export { AEngine, APIContext, AppStorage, AssertRules, CONNECTION_TYPE, CPP_PROTOCAL_MSGTYPE_OPTION, CallLibMsgType, ChatroomEntryType, ChatroomUserChangeType as ChatroomMemberChangeType, CometChannel, ConnectResultCode, ConnectionStatus, ConversationType, DB_LOG_FLUSH_FREQUENCY, DB_LOG_MAX_SIZE, DelayTimer, ErrorCode, EventEmitter, FileType, HttpMethod, IAPIContextOption, IAsyncRes, IBaseConversationInfo, IBlockedMessageInfo, ICancelRoomPKOptions, IChatRoomEntries, IChatRoomEntry, IChatroomEntries, IChatroomEntry, IChatroomInfo, IChatroomListener, IChatroomListenerData, IChrmKVEntries, IChrmKVEntry, IConnectResult, IConnectionStatusListener, IConversationOption, IConversationState, IConversationStateListener, IConversationTag, IConversationTagListener, IDataChannelWatcher, IDeletedExpansion, IEndRoomPKOptions, IEngine, IEngineWatcher, IEventListener, IExpansionListener, IExpansionListenerData, IExpansionMsgContent, IExtraMethod, IGetMsgOption, IInsertMsgOptions, IIsValidExpansion, IJoinRTCRoomData, ILocalReadReceiptInfo, ILocalTagStatus, ILogExtensions, ILogInfo, ILogInit, IM_CHATROOM_PULL_INTERVAL_TIME, IM_COMET_PULLMSG_TIMEOUT, IM_PING_INTERVAL_TIME, IM_PING_MIN_TIMEOUT, IM_PING_TIMEOUT, IM_SIGNAL_TIMEOUT, IMessageListnenr, IMessageReader, IMessageReaderResponse, IMetionedData, INaviInfo, IPluginGenerator, 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, IUltraExMsgOptions, IUltraGroupOption, IUltraModifyMsgOptions, IUltraMsgQueryOptions, IUpdatedConversation, IUpdatedExpansion, IUploadAuth, IUserProfile, IWatcher, IWebSocket, ItypingStateListener, KVString, LiveRole, LiveType, LogLevel, LogSource, LogTagId, Logger, MAX_MESSAGE_CONTENT_BYTES, MAX_MESSAGE_EXPANSION_KEY_LENGTH, MAX_MESSAGE_EXPANSION_VAL_LENGTH, MINI_COMET_CONNECT_URIS, MINI_SOCKET_CONNECT_URIS, MentionedType, MessageBlockType, MessageDirection, MessageType, NAVI_CACHE_DURATION, NAVI_REQ_TIMEOUT, NetworkType, NotificationLevel, NotificationStatus, ONE_LOG_SIZE_MAX, OperateStatus, PING_REQ_TIMEOUT, 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, TagChangeType, UploadMethod, VersionManage, WEB_SOCKET_TIMEOUT, WebSocketChannel, appendUrl, assert, clone, cloneByJSON, _default as engineLogger, forEach, formatConnectResponseCode, getBrowser, getMimeKey, getUploadFileName, indexOf, isArray, isArrayBuffer, isBoolean, isFunction, isHttpUrl, isInObject, isInclude, isNull, isNumber, isObject, isString, isUndefined, isValidChrmEntryKey, isValidChrmEntryValue, isValidConversationType, isValidExpansion, isValidFileType, base as logger, map, notEmptyArray, notEmptyObject, notEmptyString, pushConfigsToJSON, pushJSONToConfigs, todo, usingCppEngine, validate, version };