/**
 * 分析统计 SDK 接口
 * 
 * - 分析/统计 SDK 的通用接口
 * - 用于事件上报（例如：友盟、Google Analytics、Mixpanel）
 * - 所有分析 SDK 都应该实现这些方法
 */

import { ISDK } from "./ISDK";

export interface IAnalyticsSDK extends ISDK {
    /**
     * 判断统计功能是否可用
     * @returns {boolean} true 表示启用，false 表示禁用
     * 
     * - 不同环境下可能有不同表现（如 Test 环境默认关闭）
     * - SDK 初始化失败时也可能返回 false
     */  
    isAnalyticsEnabled(): boolean;

    /**
     * 上报事件
     * @param eventName 事件名称
     * @param value 事件参数（可选）
     * 
     * - 常用于埋点上报，例如：关卡完成、按钮点击
     * - 不同 SDK 内部实现方式可能不同（友盟、Firebase、GA）
     */
    trackEvent(eventName: string, value?: any): void;
}