@seaverse/track-sdk 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,82 @@
+/**
+ * 通用事件属性类型
+ */
+interface EventProperties {
+    [key: string]: string | number | boolean | null | undefined;
+}
+/**
+ * 用户属性类型
+ */
+interface UserProperties {
+    [key: string]: string | number | boolean | null | undefined;
+}
+/**
+ * 埋点提供商类型
+ */
+declare enum TrackProvider {
+    FIREBASE = "firebase",
+    SENSORS = "sensors"
+}
+/**
+ * 埋点 SDK 配置（用户传入）
+ */
+interface TrackConfig {
+    /**
+     * 应用令牌
+     */
+    token: string;
+    /**
+     * 是否初始化 Firebase（默认 true）
+     */
+    initializeFirebase?: boolean;
+    /**
+     * 是否启用调试模式
+     */
+    debug?: boolean;
+}
+
+/**
+ * 埋点 SDK 客户端
+ */
+declare class TrackClient {
+    private config;
+    private platformConfig;
+    private adapters;
+    private initialized;
+    constructor(config: TrackConfig);
+    /**
+     * 验证配置
+     */
+    private validateConfig;
+    /**
+     * 初始化 SDK
+     */
+    initialize(): Promise<void>;
+    /**
+     * 跟踪事件
+     * @param eventName 事件名称
+     * @param properties 事件属性
+     */
+    track(eventName: string, properties?: EventProperties): Promise<void>;
+    /**
+     * 设置用户 ID
+     * @param userId 用户 ID
+     */
+    setUserId(userId: string): Promise<void>;
+    /**
+     * 设置用户属性
+     * @param properties 用户属性
+     */
+    setUserProperties(properties: UserProperties): Promise<void>;
+    /**
+     * 清除用户 ID（用户登出时调用）
+     */
+    clearUserId(): Promise<void>;
+    /**
+     * 获取已初始化的提供商列表
+     */
+    getInitializedProviders(): TrackProvider[];
+}
+
+export { TrackClient, TrackProvider };
+export type { EventProperties, TrackConfig, UserProperties };