@anker-in/analysis 0.1.0

package/dist/core/adapters/gtag.js

@@ -0,0 +1,55 @@
+/**
+ * Google Analytics / gtag.js 适配器
+ * 使用标准的 window.gtag() API
+ * 专注于转化事件追踪
+ */
+/**
+ * gtag 埋点函数
+ * 调用 window.gtag() 标准 API
+ */
+export const gtagTrack = (command, targetOrEventName, params) => {
+    if (typeof window === "undefined") {
+        return;
+    }
+    // 确保 gtag 函数存在
+    if (typeof window.gtag !== "function") {
+        console.warn("gtag is not available. Please load gtag.js first.");
+        return;
+    }
+    try {
+        window.gtag(command, targetOrEventName, params);
+    }
+    catch (error) {
+        console.error("gtagTrack error:", error);
+    }
+};
+/**
+ * 发送 gtag 事件
+ */
+export const gtagEvent = (eventName, eventParams) => {
+    gtagTrack("event", eventName, eventParams);
+};
+/**
+ * 发送 gtag config
+ */
+export const gtagConfig = (measurementId, configParams) => {
+    gtagTrack("config", measurementId, configParams);
+};
+/**
+ * 检测 gtag 是否可用
+ */
+export const isGtagAvailable = () => {
+    if (typeof window === "undefined") {
+        return false;
+    }
+    return typeof window.gtag === "function";
+};
+/**
+ * gtag 适配器对象
+ */
+export const gtagAdapter = {
+    track: gtagTrack,
+    event: gtagEvent,
+    config: gtagConfig,
+    isAvailable: isGtagAvailable,
+};

package/dist/core/adapters/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Adapters 模块统一导出
+ */
+export * from "./gtag";
+export * from "./meta";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC"}

package/dist/core/adapters/index.js

@@ -0,0 +1,5 @@
+/**
+ * Adapters 模块统一导出
+ */
+export * from "./gtag";
+export * from "./meta";

package/dist/core/adapters/meta.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Meta Pixel 适配器
+ * 提供 Facebook/Meta Pixel 的埋点功能
+ */
+/**
+ * Meta Pixel 埋点函数
+ */
+export declare const metaTrack: (event: string, data?: object) => void;
+/**
+ * 检测 Meta Pixel 是否可用
+ */
+export declare const isMetaAvailable: () => boolean;
+/**
+ * Meta Pixel 适配器对象
+ */
+export declare const metaAdapter: {
+    track: (event: string, data?: object) => void;
+    isAvailable: () => boolean;
+};
+//# sourceMappingURL=meta.d.ts.map

package/dist/core/adapters/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,KAAG,IAexD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,QAAO,OAKlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW;mBA9BS,MAAM,SAAS,MAAM,KAAG,IAAI;uBAoB1B,OAAO;CAazC,CAAC"}

package/dist/core/adapters/meta.js

@@ -0,0 +1,41 @@
+/**
+ * Meta Pixel 适配器
+ * 提供 Facebook/Meta Pixel 的埋点功能
+ */
+/**
+ * Meta Pixel 埋点函数
+ */
+export const metaTrack = (event, data) => {
+    if (typeof window === "undefined") {
+        return;
+    }
+    if (typeof window.fbq !== "undefined") {
+        try {
+            if (data) {
+                window.fbq("track", event, data);
+            }
+            else {
+                window.fbq("track", event);
+            }
+        }
+        catch (error) {
+            console.log("fbqTrack error", error);
+        }
+    }
+};
+/**
+ * 检测 Meta Pixel 是否可用
+ */
+export const isMetaAvailable = () => {
+    if (typeof window === "undefined") {
+        return false;
+    }
+    return typeof window.fbq !== "undefined";
+};
+/**
+ * Meta Pixel 适配器对象
+ */
+export const metaAdapter = {
+    track: metaTrack,
+    isAvailable: isMetaAvailable,
+};

package/dist/core/helpers/function-utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 函数工具模块
+ * 提供防抖、节流、安全执行等通用函数工具
+ */
+/**
+ * 防抖函数
+ */
+export declare function debounce<T extends (...args: any[]) => any>(fn: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * 节流函数
+ */
+export declare function throttle<T extends (...args: any[]) => any>(fn: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * 安全执行函数,捕获错误
+ */
+export declare function safeExecute<T>(fn: () => T, errorMessage?: string): T | undefined;
+//# sourceMappingURL=function-utils.d.ts.map

package/dist/core/helpers/function-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-utils.d.ts","sourceRoot":"","sources":["../../../src/core/helpers/function-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAQlC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CASlC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,CAAC,EACX,YAAY,CAAC,EAAE,MAAM,GACpB,CAAC,GAAG,SAAS,CAOf"}

package/dist/core/helpers/function-utils.js

@@ -0,0 +1,43 @@
+/**
+ * 函数工具模块
+ * 提供防抖、节流、安全执行等通用函数工具
+ */
+import { logger } from "./logger";
+/**
+ * 防抖函数
+ */
+export function debounce(fn, delay) {
+    let timer = null;
+    return function (...args) {
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            fn.apply(this, args);
+        }, delay);
+    };
+}
+/**
+ * 节流函数
+ */
+export function throttle(fn, delay) {
+    let lastTime = 0;
+    return function (...args) {
+        const now = Date.now();
+        if (now - lastTime >= delay) {
+            lastTime = now;
+            fn.apply(this, args);
+        }
+    };
+}
+/**
+ * 安全执行函数,捕获错误
+ */
+export function safeExecute(fn, errorMessage) {
+    try {
+        return fn();
+    }
+    catch (error) {
+        logger.error(errorMessage || "Error executing function:", error);
+        return undefined;
+    }
+}

package/dist/core/helpers/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Helpers 模块统一导出
+ */
+export * from "./logger";
+export * from "./script-loader";
+export * from "./function-utils";
+export * from "./platform-detector";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/helpers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/dist/core/helpers/index.js

@@ -0,0 +1,7 @@
+/**
+ * Helpers 模块统一导出
+ */
+export * from "./logger";
+export * from "./script-loader";
+export * from "./function-utils";
+export * from "./platform-detector";

package/dist/core/helpers/logger.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 日志工具模块
+ * 提供统一的日志记录功能
+ */
+/**
+ * 创建日志工具
+ */
+export declare function createLogger(initialEnabled?: boolean): {
+    setEnabled(value: boolean): void;
+    log(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+};
+export declare const logger: {
+    setEnabled(value: boolean): void;
+    log(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/helpers/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/core/helpers/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,YAAY,CAAC,cAAc,UAAQ;sBAI7B,OAAO;iBAIZ,GAAG,EAAE;kBAMJ,GAAG,EAAE;mBAMJ,GAAG,EAAE;EAMvB;AAGD,eAAO,MAAM,MAAM;sBAzBG,OAAO;iBAIZ,GAAG,EAAE;kBAMJ,GAAG,EAAE;mBAMJ,GAAG,EAAE;CASY,CAAC"}

package/dist/core/helpers/logger.js

@@ -0,0 +1,32 @@
+/**
+ * 日志工具模块
+ * 提供统一的日志记录功能
+ */
+/**
+ * 创建日志工具
+ */
+export function createLogger(initialEnabled = false) {
+    let enabled = initialEnabled;
+    return {
+        setEnabled(value) {
+            enabled = value;
+        },
+        log(...args) {
+            if (enabled) {
+                console.log("[Analysis SDK]", ...args);
+            }
+        },
+        warn(...args) {
+            if (enabled) {
+                console.warn("[Analysis SDK]", ...args);
+            }
+        },
+        error(...args) {
+            if (enabled) {
+                console.error("[Analysis SDK]", ...args);
+            }
+        },
+    };
+}
+// 全局 logger 实例
+export const logger = createLogger();

package/dist/core/helpers/platform-detector.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 平台检测模块
+ * 检测各个埋点平台的可用性
+ */
+import type { PlatformType } from "../../types";
+/**
+ * 检测指定平台是否可用
+ */
+export declare const isPlatformAvailable: (platform: PlatformType) => boolean;
+/**
+ * 检测所有可用的平台
+ */
+export declare const detectAvailablePlatforms: () => PlatformType[];
+//# sourceMappingURL=platform-detector.d.ts.map

package/dist/core/helpers/platform-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-detector.d.ts","sourceRoot":"","sources":["../../../src/core/helpers/platform-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,UAAU,YAAY,KAAG,OAgB5D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,QAAO,YAAY,EAGvD,CAAC"}

package/dist/core/helpers/platform-detector.js

@@ -0,0 +1,28 @@
+/**
+ * 平台检测模块
+ * 检测各个埋点平台的可用性
+ */
+/**
+ * 检测指定平台是否可用
+ */
+export const isPlatformAvailable = (platform) => {
+    if (typeof window === "undefined") {
+        return false;
+    }
+    switch (platform) {
+        case "gtag":
+            return (typeof window.gtag !== "undefined" ||
+                typeof window.dataLayer !== "undefined");
+        case "meta":
+            return typeof window.fbq !== "undefined";
+        default:
+            return false;
+    }
+};
+/**
+ * 检测所有可用的平台
+ */
+export const detectAvailablePlatforms = () => {
+    const platforms = ["gtag", "meta"];
+    return platforms.filter((platform) => isPlatformAvailable(platform));
+};

package/dist/core/helpers/script-loader.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 脚本加载和管理模块
+ * 提供动态加载和控制第三方脚本的能力
+ */
+/**
+ * 加载外部脚本
+ */
+export declare function loadScript(src: string, id?: string): Promise<void>;
+/**
+ * 更新脚本的 type 属性配置
+ */
+export interface UpdateScriptTypeOptions {
+    /** 脚本元素的 ID */
+    id: string;
+    /** 是否启用脚本 */
+    enabled: boolean;
+    /** 是否在启用时重新执行脚本内容 */
+    executeOnEnable?: boolean;
+    /** 错误处理回调 */
+    onError?: (error: Error) => void;
+}
+/**
+ * 动态更新脚本的 type 属性
+ * 用于根据 cookie consent 状态动态启用/禁用脚本
+ *
+ * @param options - 配置选项
+ * @returns 是否成功更新
+ */
+export declare function updateScriptType(options: UpdateScriptTypeOptions): boolean;
+/**
+ * 批量更新多个脚本的 type 属性
+ *
+ * @param scriptIds - 脚本 ID 数组或生成 ID 的函数
+ * @param enabled - 是否启用脚本
+ * @param executeOnEnable - 是否在启用时重新执行脚本内容
+ * @returns 成功更新的脚本数量
+ */
+export declare function updateScriptsType(scriptIds: string[] | ((index: number) => string), enabled: boolean, executeOnEnable?: boolean): number;
+//# sourceMappingURL=script-loader.d.ts.map

package/dist/core/helpers/script-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-loader.d.ts","sourceRoot":"","sources":["../../../src/core/helpers/script-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BlE;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,eAAe;IACf,EAAE,EAAE,MAAM,CAAC;IACX,aAAa;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,qBAAqB;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa;IACb,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CA0C1E;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,EACjD,OAAO,EAAE,OAAO,EAChB,eAAe,UAAO,GACrB,MAAM,CAyBR"}

package/dist/core/helpers/script-loader.js

@@ -0,0 +1,107 @@
+/**
+ * 脚本加载和管理模块
+ * 提供动态加载和控制第三方脚本的能力
+ */
+import { logger } from "./logger";
+/**
+ * 加载外部脚本
+ */
+export function loadScript(src, id) {
+    return new Promise((resolve, reject) => {
+        // 检查是否已加载
+        if (id && document.getElementById(id)) {
+            logger.log(`Script ${id} already loaded`);
+            resolve();
+            return;
+        }
+        const script = document.createElement("script");
+        script.src = src;
+        script.async = true;
+        if (id) {
+            script.id = id;
+        }
+        script.onload = () => {
+            logger.log(`Script loaded: ${src}`);
+            resolve();
+        };
+        script.onerror = () => {
+            logger.error(`Failed to load script: ${src}`);
+            reject(new Error(`Failed to load script: ${src}`));
+        };
+        document.head.appendChild(script);
+    });
+}
+/**
+ * 动态更新脚本的 type 属性
+ * 用于根据 cookie consent 状态动态启用/禁用脚本
+ *
+ * @param options - 配置选项
+ * @returns 是否成功更新
+ */
+export function updateScriptType(options) {
+    const { id, enabled, executeOnEnable = true, onError } = options;
+    if (typeof window === "undefined") {
+        return false;
+    }
+    const scriptElement = document.getElementById(id);
+    if (!scriptElement) {
+        logger.warn(`Script element with id "${id}" not found`);
+        return false;
+    }
+    const newType = enabled ? "text/javascript" : "text/plain";
+    const currentType = scriptElement.getAttribute("type");
+    // 如果从 text/plain 变为 text/javascript，需要重新执行脚本
+    if (executeOnEnable &&
+        currentType === "text/plain" &&
+        newType === "text/javascript") {
+        scriptElement.setAttribute("type", newType);
+        // 重新执行脚本内容
+        const scriptContent = scriptElement.innerHTML;
+        if (scriptContent && typeof window.eval === "function") {
+            try {
+                window.eval(scriptContent);
+                logger.log(`Script "${id}" executed successfully`);
+            }
+            catch (e) {
+                const error = e instanceof Error ? e : new Error(String(e));
+                logger.error(`Script "${id}" execution error:`, error);
+                if (onError) {
+                    onError(error);
+                }
+            }
+        }
+    }
+    else {
+        scriptElement.setAttribute("type", newType);
+    }
+    return true;
+}
+/**
+ * 批量更新多个脚本的 type 属性
+ *
+ * @param scriptIds - 脚本 ID 数组或生成 ID 的函数
+ * @param enabled - 是否启用脚本
+ * @param executeOnEnable - 是否在启用时重新执行脚本内容
+ * @returns 成功更新的脚本数量
+ */
+export function updateScriptsType(scriptIds, enabled, executeOnEnable = true) {
+    if (typeof window === "undefined") {
+        return 0;
+    }
+    let successCount = 0;
+    const ids = Array.isArray(scriptIds)
+        ? scriptIds
+        : Array.from({ length: 100 }, (_, i) => scriptIds(i)).filter((id) => document.getElementById(id));
+    ids.forEach((id) => {
+        const success = updateScriptType({
+            id,
+            enabled,
+            executeOnEnable,
+        });
+        if (success) {
+            successCount++;
+        }
+    });
+    logger.log(`Updated ${successCount}/${ids.length} scripts`);
+    return successCount;
+}

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Core 模块统一导出
+ */
+export * from "./tracking";
+export * from "./adapters";
+export * from "./helpers";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,YAAY,CAAC;AAG3B,cAAc,YAAY,CAAC;AAG3B,cAAc,WAAW,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,9 @@
+/**
+ * Core 模块统一导出
+ */
+// Tracking 模块
+export * from "./tracking";
+// Adapters 模块
+export * from "./adapters";
+// Helpers 模块
+export * from "./helpers";

package/dist/core/track/gtagTrack.d.ts

@@ -0,0 +1,2 @@
+export declare const gtagTrack: (args: any) => void;
+//# sourceMappingURL=gtagTrack.d.ts.map

package/dist/core/track/gtagTrack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gtagTrack.d.ts","sourceRoot":"","sources":["../../../src/core/track/gtagTrack.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,GAAI,MAAM,GAAG,KAAG,IAUrC,CAAC"}

package/dist/core/track/gtagTrack.js

@@ -0,0 +1,12 @@
+export const gtagTrack = (args) => {
+    if (typeof window === "undefined") {
+        return;
+    }
+    window.dataLayer = window?.dataLayer || [];
+    try {
+        window?.dataLayer?.push(args);
+    }
+    catch (error) {
+        console.log("gtagTrack error", error);
+    }
+};

package/dist/core/track/index.d.ts

@@ -0,0 +1,4 @@
+export { track } from "./track";
+export { gtagTrack } from "./gtagTrack";
+export { metaTrack } from "./metaTrack";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/track/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/track/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/core/track/index.js

@@ -0,0 +1,3 @@
+export { track } from "./track";
+export { gtagTrack } from "./gtagTrack";
+export { metaTrack } from "./metaTrack";

package/dist/core/track/metaTrack.d.ts

@@ -0,0 +1,2 @@
+export declare const metaTrack: (event: string, data?: object) => void;
+//# sourceMappingURL=metaTrack.d.ts.map

package/dist/core/track/metaTrack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metaTrack.d.ts","sourceRoot":"","sources":["../../../src/core/track/metaTrack.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,KAAG,IAexD,CAAC"}

package/dist/core/track/metaTrack.js

@@ -0,0 +1,18 @@
+export const metaTrack = (event, data) => {
+    if (typeof window === "undefined") {
+        return;
+    }
+    if (typeof window.fbq !== "undefined") {
+        try {
+            if (data) {
+                window.fbq("track", event, data);
+            }
+            else {
+                window.fbq("track", event);
+            }
+        }
+        catch (error) {
+            console.log("fbqTrack error", error);
+        }
+    }
+};

package/dist/core/track/track.d.ts

@@ -0,0 +1,6 @@
+import type { TrackConfig } from "../../types";
+declare function track(config: TrackConfig<"gtag">): void;
+declare function track(config: TrackConfig<"meta">): void;
+export default track;
+export { track };
+//# sourceMappingURL=track.d.ts.map

package/dist/core/track/track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.d.ts","sourceRoot":"","sources":["../../../src/core/track/track.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EAGZ,MAAM,aAAa,CAAC;AAKrB,iBAAS,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AAClD,iBAAS,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;AAuJlD,eAAe,KAAK,CAAC;AACrB,OAAO,EAAE,KAAK,EAAE,CAAC"}