trackersdk2 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 黄文杰
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/TrackerSDK.d.ts

@@ -0,0 +1,123 @@
+import type { TrackerConfig, TrackEvent, TagNames } from "./types";
+export declare class TrackerSDK {
+    private config;
+    private autoTrackClickHandler;
+    private eventQueue;
+    private batchTimer;
+    private hasSentBeforeUnload;
+    constructor();
+    init(config: TrackerConfig): void;
+    /**
+     * @description 重试批量上报之前上报失败的数据
+     * @returns Promise<void>
+     */
+    private retryFailedBatches;
+    /**
+     * @description 监听页面卸载事件，确保数据上报
+     * @returns void
+     */
+    private setupPageUnloadHandler;
+    /**
+     * @description 获取设备id
+     */
+    private getDeviceId;
+    /**
+     *  @description navigator.sendBeacon 和 fetch 双通道实现数据上报
+     *  @param data 上报的负载
+     */
+    private send;
+    /**
+     * @description 入队列
+     * @param payload 上报的负载
+     */
+    private enqueue;
+    /**
+     * @description 刷新队列，批量上报
+     * @return void
+     */
+    private flush;
+    /**
+     * @description navigator.sendBeacon单条错误上报失败的fetch回退方案
+     * @param payload any
+     * */
+    private fallbackSend;
+    /**
+     * @description 错误事件立即上报
+     * @param data 上报的负载
+     * @returns void
+     */
+    sendImmediately(payload: TrackEvent): void;
+    /**
+     * @description 批量上报
+     * @param events 上报的事件数组
+     * @returns Promise<void>
+     */
+    private sendBatch;
+    /**
+     * @description 批量上报的fetch回退方案
+     * @param payload 上报的负载
+     * @returns Promise<void>
+     */
+    private fallbackSendBatch;
+    private saveFailedBatch;
+    /**
+     * @description 自定义点击事件
+     */
+    track(event: string, properties?: Record<string, any>): void;
+    /**
+     * @description 用于自动点击埋点
+     *
+     * @param element 点击的DOM元素
+     */
+    trackClick(element: Element): void;
+    /**
+     * @description 自动pv
+     *
+     * @param path pv的页面路径
+     * @param properties 上报数据
+     */
+    trackPV(path: string, properties?: Record<string, any>): void;
+    /**
+     * @description 统计uv（每天每个设备只上报一次）
+     *
+     */
+    trackUV(): void;
+    /** @description 初始化错误事件监听
+     *
+     */
+    setupErrorTracking(): void;
+    /**
+     * @description vue3 全局错误处理器
+     */
+    setupVueErrorHandlder(app: any): void;
+    private setupPerformanceTracking;
+    /**
+     * @description 监控FCP
+     * @returns void
+     */
+    private observeFCP;
+    /**
+     * @description 监控LCP
+     * @returns void
+     */
+    private observeLCP;
+    /**
+     * @description 监控CLS
+     * @returns void
+     */
+    private observeCLS;
+    /**
+     * @description 监控TTFB
+     * @returns void
+     */
+    private observeTTFB;
+    /**
+     * @description 全埋点(谨慎使用,存在性能问题)
+     */
+    enableAutoTracking(): void;
+    /**
+     * @description: 设置可触发自动埋点的DOM元素标签名称白名单
+     */
+    setEnableAutoClickTagNameList(tagNameList: Array<TagNames>): void;
+}
+export declare const tracker: TrackerSDK;