@anker-in/analysis 0.1.0

package/dist/core/track/track.js

@@ -0,0 +1,128 @@
+import { isPlatformAvailable, logger } from "../utils";
+import { gtagTrack } from "./gtagTrack";
+import { metaTrack } from "./metaTrack";
+function track(config) {
+    const { platform, ...params } = config;
+    if (!isPlatformAvailable(platform)) {
+        logger.warn(`Platform ${platform} is not available`);
+        return;
+    }
+    try {
+        switch (platform) {
+            case "gtag": {
+                const gtagParams = params;
+                handleGtagTrack(gtagParams);
+                break;
+            }
+            case "meta": {
+                const metaParams = params;
+                handleMetaTrack(metaParams);
+                break;
+            }
+            default:
+                logger.warn(`Unsupported platform: ${platform}`);
+        }
+    }
+    catch (error) {
+        logger.error(`Failed to track on platform ${platform}:`, error);
+    }
+}
+/**
+ * 处理 Gtag 埋点
+ */
+function handleGtagTrack(params) {
+    const { eventName, measurementId, nonInteraction, customParams } = params;
+    // 构建 gtag 事件参数对象
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const eventParams = {
+        ...customParams,
+    };
+    // 处理转化类事件
+    if ("send_to" in params) {
+        eventParams.send_to = params.send_to;
+        if (params.value !== undefined) {
+            eventParams.value = params.value;
+        }
+        if (params.currency) {
+            eventParams.currency = params.currency;
+        }
+        if (params.transactionId) {
+            eventParams.transaction_id = params.transactionId;
+        }
+    }
+    // 处理电商类事件
+    if ("items" in params) {
+        // 转换 items 格式为 gtag 标准格式
+        eventParams.items = params.items.map((item) => ({
+            item_id: item.item_id,
+            item_name: item.item_name,
+            price: item.price,
+            quantity: item.quantity,
+            ...(item.item_brand && { item_brand: item.item_brand }),
+            ...(item.item_category && { item_category: item.item_category }),
+            ...(item.item_variant && { item_variant: item.item_variant }),
+            ...(item.currency && { currency: item.currency }),
+            // 保留其他自定义字段
+            ...Object.fromEntries(Object.entries(item).filter(([key]) => ![
+                "item_id",
+                "item_name",
+                "price",
+                "quantity",
+                "item_brand",
+                "item_category",
+                "item_variant",
+                "currency",
+            ].includes(key))),
+        }));
+        if (params.value !== undefined) {
+            eventParams.value = params.value;
+        }
+        if (params.currency) {
+            eventParams.currency = params.currency;
+        }
+        if (params.transactionId) {
+            eventParams.transaction_id = params.transactionId;
+        }
+        if (params.tax !== undefined) {
+            eventParams.tax = params.tax;
+        }
+        if (params.shipping !== undefined) {
+            eventParams.shipping = params.shipping;
+        }
+        if (params.coupon) {
+            eventParams.coupon = params.coupon;
+        }
+    }
+    // 添加非交互事件标记
+    if (nonInteraction) {
+        eventParams.non_interaction = true;
+    }
+    // 构建 dataLayer 格式: ['event', eventName, params]
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const dataLayerArgs = [
+        "event",
+        eventName,
+        eventParams,
+    ];
+    // 如果有 measurementId，先发送 config
+    if (measurementId) {
+        gtagTrack(["config", measurementId, {}]);
+    }
+    // 发送事件
+    gtagTrack(dataLayerArgs);
+    logger.log(`Gtag event tracked: ${eventName}`, eventParams);
+}
+/**
+ * 处理 Meta Pixel 埋点
+ */
+function handleMetaTrack(params) {
+    const { event, data } = params;
+    if (!event) {
+        logger.warn("Meta Pixel event name is required");
+        return;
+    }
+    metaTrack(event, data);
+    logger.log(`Meta Pixel event tracked: ${event}`, data);
+}
+export default track;
+export { track };

package/dist/core/tracking/dispatcher.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 埋点调度器模块
+ * 负责根据平台类型分发事件到对应的适配器
+ */
+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=dispatcher.d.ts.map

package/dist/core/tracking/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../../src/core/tracking/dispatcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,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;AA6ElD,eAAe,KAAK,CAAC;AACrB,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/dist/core/tracking/dispatcher.js

@@ -0,0 +1,67 @@
+/**
+ * 埋点调度器模块
+ * 负责根据平台类型分发事件到对应的适配器
+ */
+import { isPlatformAvailable, logger } from "../helpers";
+import { gtagEvent, gtagConfig } from "../adapters/gtag";
+import { metaTrack } from "../adapters/meta";
+function track(config) {
+    const { platform, ...params } = config;
+    if (!isPlatformAvailable(platform)) {
+        logger.warn(`Platform ${platform} is not available`);
+        return;
+    }
+    try {
+        switch (platform) {
+            case "gtag": {
+                const gtagParams = params;
+                handleGtagTrack(gtagParams);
+                break;
+            }
+            case "meta": {
+                const metaParams = params;
+                handleMetaTrack(metaParams);
+                break;
+            }
+            default:
+                logger.warn(`Unsupported platform: ${platform}`);
+        }
+    }
+    catch (error) {
+        logger.error(`Failed to track on platform ${platform}:`, error);
+    }
+}
+/**
+ * 处理 Gtag 埋点（转化事件）
+ */
+function handleGtagTrack(params) {
+    const { eventName, measurementId, ...restParams } = params;
+    // 如果有 measurementId，先发送 config
+    if (measurementId) {
+        gtagConfig(measurementId, {});
+    }
+    // 构建事件参数
+    const eventParams = { ...restParams };
+    // 处理 transactionId -> transaction_id 转换
+    if (eventParams.transactionId && !eventParams.transaction_id) {
+        eventParams.transaction_id = eventParams.transactionId;
+        delete eventParams.transactionId;
+    }
+    // 发送转化事件
+    gtagEvent(eventName, eventParams);
+    logger.log(`Gtag conversion tracked: ${eventName}`, eventParams);
+}
+/**
+ * 处理 Meta Pixel 埋点
+ */
+function handleMetaTrack(params) {
+    const { event, data } = params;
+    if (!event) {
+        logger.warn("Meta Pixel event name is required");
+        return;
+    }
+    metaTrack(event, data);
+    logger.log(`Meta Pixel event tracked: ${event}`, data);
+}
+export default track;
+export { track };

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

@@ -0,0 +1,6 @@
+/**
+ * Tracking 模块统一导出
+ */
+export { track } from "./dispatcher";
+export { withTracking, useTracking } from "./with-tracking";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/tracking/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/core/tracking/index.js

@@ -0,0 +1,5 @@
+/**
+ * Tracking 模块统一导出
+ */
+export { track } from "./dispatcher";
+export { withTracking, useTracking } from "./with-tracking";

package/dist/core/tracking/with-tracking.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 埋点装饰器模块
+ * 提供函数包装器和 React Hooks，为业务函数添加埋点能力
+ */
+import type { WithTrackingConfig } from "../../types";
+export declare function withTracking<T extends (...args: any[]) => any>(fn: T, config: WithTrackingConfig): T;
+/**
+ * React Hooks 专用
+ *
+ * 为 React 组件提供埋点 Hook
+ *
+ * @example
+ * ```typescript
+ * function ProductCard({ product }) {
+ *   const trackAddToCart = useTracking({
+ *     trackConfig: {
+ *       platform: "gtag",
+ *       eventName: "add_to_cart"
+ *     }
+ *   });
+ *
+ *   const handleClick = () => {
+ *     trackAddToCart(() => {
+ *       addToCart(product.id);
+ *     });
+ *   };
+ *
+ *   return <button onClick={handleClick}>Add to Cart</button>;
+ * }
+ * ```
+ */
+export declare function useTracking(config: WithTrackingConfig): <T extends (...args: any[]) => any>(fn: T) => T;
+//# sourceMappingURL=with-tracking.d.ts.map

package/dist/core/tracking/with-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-tracking.d.ts","sourceRoot":"","sources":["../../../src/core/tracking/with-tracking.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAGV,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAgCrB,wBAAgB,YAAY,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC5D,EAAE,EAAE,CAAC,EACL,MAAM,EAAE,kBAAkB,GACzB,CAAC,CA8FH;AAOD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,kBAAkB,IAC5C,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,IAAI,CAAC,OAGjD"}

package/dist/core/tracking/with-tracking.js

@@ -0,0 +1,137 @@
+/**
+ * 埋点装饰器模块
+ * 提供函数包装器和 React Hooks，为业务函数添加埋点能力
+ */
+import { track } from "./dispatcher";
+import { logger, debounce, throttle } from "../helpers";
+import { trackByTags } from "../../autoTrack/trackByTags";
+/**
+ * 执行埋点上报
+ */
+function executeTracking(trackPoint, trackConfig) {
+    const configs = Array.isArray(trackConfig)
+        ? trackConfig
+        : [trackConfig ?? {}];
+    configs.forEach((config) => {
+        try {
+            track(config);
+        }
+        catch (error) {
+            logger.error("withTracking: 埋点执行失败", error);
+        }
+    });
+    if (typeof window !== "undefined" &&
+        !!trackPoint &&
+        window.__FUN_TRACK_TAGS__?.[trackPoint ?? ""]?.length > 0) {
+        trackByTags({
+            tags: window.__FUN_TRACK_TAGS__?.[trackPoint ?? ""] ?? [],
+            data: [{ event: "custom" }],
+        });
+    }
+}
+export function withTracking(fn, config) {
+    const { trackConfig, timing = "after", condition, trackOnError = false, errorTrackConfig, debounce: debounceTime, throttle: throttleTime, trackPoint, } = config;
+    // 核心包装函数
+    function wrappedFunction(...args) {
+        // 条件检查
+        if (condition && !condition(args)) {
+            return fn(...args);
+        }
+        // 生成埋点配置
+        const getTrackConfig = (result) => {
+            return typeof trackConfig === "function"
+                ? trackConfig(args, result)
+                : trackConfig;
+        };
+        // Before 时机
+        if (timing === "before" || timing === "both") {
+            const config = getTrackConfig();
+            executeTracking(trackPoint, config);
+        }
+        // 执行原函数
+        try {
+            const result = fn(...args);
+            // 处理异步函数
+            if (result instanceof Promise) {
+                return result
+                    .then((resolvedResult) => {
+                    if (timing === "after" || timing === "both") {
+                        const config = getTrackConfig(resolvedResult);
+                        executeTracking(trackPoint, config);
+                    }
+                    return resolvedResult;
+                })
+                    .catch((error) => {
+                    if (trackOnError && errorTrackConfig) {
+                        executeTracking(trackPoint, errorTrackConfig(error, args));
+                    }
+                    throw error;
+                });
+            }
+            // 同步函数 After 时机
+            if (timing === "after" || timing === "both") {
+                const config = getTrackConfig(result);
+                executeTracking(trackPoint, config);
+            }
+            return result;
+        }
+        catch (error) {
+            // 错误时上报
+            if (trackOnError && errorTrackConfig) {
+                executeTracking(trackPoint, errorTrackConfig(error, args));
+            }
+            throw error;
+        }
+    }
+    if (typeof window !== "undefined" && !!trackPoint) {
+        const urlParams = new URLSearchParams(window.location.search);
+        if (urlParams.has("TRACK_DEV")) {
+            return ((...args) => {
+                window.open(`http://localhost:3002/tracking?trackPoint=${trackPoint}`, "_blank");
+            });
+        }
+    }
+    // 应用防抖/节流
+    if (debounceTime) {
+        return debounce(wrappedFunction, debounceTime);
+    }
+    if (throttleTime) {
+        return throttle(wrappedFunction, throttleTime);
+    }
+    // __TRACK_POINT_MARKER__(trackPoint);
+    return wrappedFunction;
+}
+// 定义标记函数（仅用于 AST 识别）
+function __TRACK_POINT_MARKER__(trackPoint) {
+    // 空函数，仅用于 AST 标记
+}
+/**
+ * React Hooks 专用
+ *
+ * 为 React 组件提供埋点 Hook
+ *
+ * @example
+ * ```typescript
+ * function ProductCard({ product }) {
+ *   const trackAddToCart = useTracking({
+ *     trackConfig: {
+ *       platform: "gtag",
+ *       eventName: "add_to_cart"
+ *     }
+ *   });
+ *
+ *   const handleClick = () => {
+ *     trackAddToCart(() => {
+ *       addToCart(product.id);
+ *     });
+ *   };
+ *
+ *   return <button onClick={handleClick}>Add to Cart</button>;
+ * }
+ * ```
+ */
+export function useTracking(config) {
+    return (fn) => {
+        return withTracking(fn, config);
+    };
+}

package/dist/core/utils.d.ts

@@ -0,0 +1,64 @@
+import type { PlatformType } from "../types";
+/**
+ * 创建日志工具
+ */
+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;
+};
+/**
+ * 加载外部脚本
+ */
+export declare function loadScript(src: string, id?: string): Promise<void>;
+/**
+ * 安全执行函数,捕获错误
+ */
+export declare function safeExecute<T>(fn: () => T, errorMessage?: string): T | undefined;
+/**
+ * 防抖函数
+ */
+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 const isPlatformAvailable: (platform: PlatformType) => boolean;
+/**
+ * 更新脚本的 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=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;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;AAErC;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BlE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,CAAC,EACX,YAAY,CAAC,EAAE,MAAM,GACpB,CAAC,GAAG,SAAS,CAOf;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,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,eAAO,MAAM,mBAAmB,GAAI,UAAU,YAAY,KAAG,OAgB5D,CAAC;AAEF;;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,CA2C1E;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/utils.js

@@ -0,0 +1,182 @@
+/**
+ * 创建日志工具
+ */
+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();
+/**
+ * 加载外部脚本
+ */
+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);
+    });
+}
+/**
+ * 安全执行函数,捕获错误
+ */
+export function safeExecute(fn, errorMessage) {
+    try {
+        return fn();
+    }
+    catch (error) {
+        logger.error(errorMessage || "Error executing function:", error);
+        return undefined;
+    }
+}
+/**
+ * 防抖函数
+ */
+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 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;
+    }
+};
+/**
+ * 动态更新脚本的 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/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Analysis SDK - 埋点 SDK 主入口
+ *
+ * 提供统一的埋点接口，支持多平台埋点上报
+ */
+export { track } from "./core/tracking";
+export { gtagTrack } from "./core/adapters";
+export { metaTrack } from "./core/adapters";
+export { withTracking, useTracking } from "./core/tracking";
+export { trackByTags } from "./autoTrack/trackByTags";
+export { logger, isPlatformAvailable, updateScriptType, updateScriptsType, } from "./core/helpers";
+export { GtagPixel, MetaPixel, PixelsManager } from "./pixels";
+export { TrackTagsVersionMap } from "./constants";
+export type { PlatformType, TrackEventType, BasePlatformConfig, PixelsManagerConfig, GtagConfig, MetaPixelConfig, TikTokPixelConfig, ScarabConfig, AnalysisConfig, TrackParams, Tracker, AutoTrackConfig, Currency, TrackConfig, GtagEventName, GtagTrackParams, GtagConfigParams, MetaTrackParams, TrackByTagsData, TrackByTagsParams, ParsedTag, } from "./types";
+export type { UpdateScriptTypeOptions } from "./core/helpers";
+import { track } from "./core/tracking";
+import { trackByTags } from "./autoTrack/trackByTags";
+import { updateScriptType, updateScriptsType } from "./core/helpers";
+import { withTracking, useTracking } from "./core/tracking";
+declare const _default: {
+    track: typeof track;
+    trackByTags: typeof trackByTags;
+    withTracking: typeof withTracking;
+    useTracking: typeof useTracking;
+    logger: {
+        setEnabled(value: boolean): void;
+        log(...args: any[]): void;
+        warn(...args: any[]): void;
+        error(...args: any[]): void;
+    };
+    isPlatformAvailable: (platform: import("./types").PlatformType) => boolean;
+    updateScriptType: typeof updateScriptType;
+    updateScriptsType: typeof updateScriptsType;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map