@anker-in/analysis 0.2.0 → 0.2.1

package/dist/index.d.mts

@@ -114,7 +114,6 @@ interface WithTrackingConfig<P extends PlatformType = PlatformType> {
  * TrackByTags 事件数据接口
  */
 interface TrackByTagsData {
-    event: string;
     [key: string]: any;
 }
 /**
@@ -122,7 +121,7 @@ interface TrackByTagsData {
  */
 interface TrackByTagsParams {
     tags: string[];
-    data: TrackByTagsData[];
+    data?: TrackByTagsData[];
 }
 /**
  * 解析后的标签结构（内部使用）
@@ -262,17 +261,17 @@ declare function withTracking<T extends (...args: any[]) => any>(fn: T, config:
 declare function useTracking(config: WithTrackingConfig): <T extends (...args: any[]) => any>(fn: T) => T;
 
 /**
- * 基于标签进行埋点上报
+ * 基于标签进行埋点上报（简化版）
  *
  * @param tags - 标签数组，格式: ['fbq:atc:1234567890', 'gtag:atc:AW-123456789/abc123']
- * @param data - 事件数据数组，每个元素包含 event 字段用于匹配标签
+ * @param data - 事件数据数组，包含事件相关的额外数据
  *
  * @example
  * ```typescript
- * trackByTags(
- *   ['fbq:atc:1234567890', 'gtag:atc:AW-123456789/abc123'],
- *   [{ event: 'atc' }]
- * );
+ * trackByTags({
+ *   tags: ['fbq:atc:1234567890', 'gtag:atc:AW-123456789/abc123'],
+ *   data: [{ event: 'custom' }]
+ * });
  * ```
  */
 declare function trackByTags({ tags, data }: TrackByTagsParams): void;
@@ -325,6 +324,109 @@ declare function updateScriptsType(scriptIds: string[] | ((index: number) => str
  */
 declare const isPlatformAvailable: (platform: PlatformType) => boolean;
 
+/**
+ * 触发埋点上报工具
+ *
+ * 从 sessionStorage 读取 trackTags 配置，并根据 trackPoint 触发对应的埋点上报
+ */
+/**
+ * TrackTags 配置类型
+ * key: trackPoint 标识
+ * value: 标签数组
+ */
+interface TrackTagsConfig {
+    [trackPoint: string]: string[];
+}
+/**
+ * 埋点触发选项
+ */
+interface TriggerTrackOptions {
+    tags?: Array<string>;
+    /** 自定义事件数据 */
+    eventData?: Record<string, unknown>;
+    /** 自定义存储键名，默认为 'trackTags' */
+    storageKey?: string;
+    /** 是否静默失败（不输出警告日志），默认为 false */
+    silent?: boolean;
+}
+/**
+ * 触发埋点上报
+ *
+ * 从 sessionStorage 读取 trackTags 配置，根据 trackPoint 获取对应的标签数组，
+ * 然后调用 trackByTags 进行埋点上报。
+ *
+ * @param trackPoint - 埋点标识，对应 trackTags 中的 key
+ * @param options - 可选配置项
+ *
+ * @example
+ * ```typescript
+ * // 基础用法
+ * triggerTrack('add_to_cart');
+ *
+ * // 带自定义数据
+ * triggerTrack('purchase', {
+ *   eventData: {
+ *     value: 99.99,
+ *     currency: 'USD',
+ *     transactionId: 'ORDER-123'
+ *   }
+ * });
+ *
+ * // 使用自定义存储键
+ * triggerTrack('custom_event', {
+ *   storageKey: 'customTrackTags'
+ * });
+ * ```
+ */
+declare function triggerTrack(trackPoint: string, options?: TriggerTrackOptions): void;
+/**
+ * 批量触发多个埋点
+ *
+ * @param trackPoints - 埋点标识数组
+ * @param options - 可选配置项（应用到所有埋点）
+ *
+ * @example
+ * ```typescript
+ * // 批量触发多个埋点
+ * triggerTrackBatch(['view_item', 'add_to_cart']);
+ *
+ * // 带共享的事件数据
+ * triggerTrackBatch(['event1', 'event2'], {
+ *   eventData: { sessionId: '12345' }
+ * });
+ * ```
+ */
+declare function triggerTrackBatch(trackPoints: string[], options?: TriggerTrackOptions): void;
+/**
+ * 设置 trackTags 到 sessionStorage
+ *
+ * @param trackTags - TrackTags 配置对象
+ * @param storageKey - 存储键名，默认为 'trackTags'
+ *
+ * @example
+ * ```typescript
+ * setTrackTags({
+ *   'add_to_cart': ['fbq:atc:123456', 'gtag:atc:AW-123/abc'],
+ *   'purchase': ['fbq:purchase:123456', 'gtag:purchase:AW-123/xyz']
+ * });
+ * ```
+ */
+declare function setTrackTags(trackTags: TrackTagsConfig, storageKey?: string): void;
+/**
+ * 清除 trackTags
+ *
+ * @param storageKey - 存储键名，默认为 'trackTags'
+ */
+declare function clearTrackTags(storageKey?: string): void;
+/**
+ * 检查某个 trackPoint 是否存在
+ *
+ * @param trackPoint - 埋点标识
+ * @param storageKey - 存储键名，默认为 'trackTags'
+ * @returns 是否存在对应的标签配置
+ */
+declare function hasTrackPoint(trackPoint: string, storageKey?: string): boolean;
+
 /**
  * Google Analytics / gtag.js 适配器
  * 使用标准的 window.gtag() API
@@ -384,4 +486,4 @@ declare const _default: {
     updateScriptsType: typeof updateScriptsType;
 };
 
-export { type AnalysisConfig, type AutoTrackConfig, type BasePlatformConfig, type Currency, type GtagConfig, type GtagConfigParams, type GtagEventName, GtagPixel, type GtagTrackParams, MetaPixel, type MetaPixelConfig, type MetaTrackParams, type ParsedTag, PixelsManager, type PixelsManagerConfig, type PlatformType, type ScarabConfig, type TikTokPixelConfig, type TrackByTagsData, type TrackByTagsParams, type TrackConfig, type TrackEventType, type TrackParams, TrackTagsVersionMap, type Tracker, type UpdateScriptTypeOptions, _default as default, gtagTrack, isPlatformAvailable, logger, metaTrack, track, trackByTags, updateScriptType, updateScriptsType, useTracking, withTracking };
+export { type AnalysisConfig, type AutoTrackConfig, type BasePlatformConfig, type Currency, type GtagConfig, type GtagConfigParams, type GtagEventName, GtagPixel, type GtagTrackParams, MetaPixel, type MetaPixelConfig, type MetaTrackParams, type ParsedTag, PixelsManager, type PixelsManagerConfig, type PlatformType, type ScarabConfig, type TikTokPixelConfig, type TrackByTagsData, type TrackByTagsParams, type TrackConfig, type TrackEventType, type TrackParams, type TrackTagsConfig, TrackTagsVersionMap, type Tracker, type TriggerTrackOptions, type UpdateScriptTypeOptions, clearTrackTags, _default as default, gtagTrack, hasTrackPoint, isPlatformAvailable, logger, metaTrack, setTrackTags, track, trackByTags, triggerTrack, triggerTrackBatch, updateScriptType, updateScriptsType, useTracking, withTracking };

package/dist/index.d.ts

@@ -114,7 +114,6 @@ interface WithTrackingConfig<P extends PlatformType = PlatformType> {
  * TrackByTags 事件数据接口
  */
 interface TrackByTagsData {
-    event: string;
     [key: string]: any;
 }
 /**
@@ -122,7 +121,7 @@ interface TrackByTagsData {
  */
 interface TrackByTagsParams {
     tags: string[];
-    data: TrackByTagsData[];
+    data?: TrackByTagsData[];
 }
 /**
  * 解析后的标签结构（内部使用）
@@ -262,17 +261,17 @@ declare function withTracking<T extends (...args: any[]) => any>(fn: T, config:
 declare function useTracking(config: WithTrackingConfig): <T extends (...args: any[]) => any>(fn: T) => T;
 
 /**
- * 基于标签进行埋点上报
+ * 基于标签进行埋点上报（简化版）
  *
  * @param tags - 标签数组，格式: ['fbq:atc:1234567890', 'gtag:atc:AW-123456789/abc123']
- * @param data - 事件数据数组，每个元素包含 event 字段用于匹配标签
+ * @param data - 事件数据数组，包含事件相关的额外数据
  *
  * @example
  * ```typescript
- * trackByTags(
- *   ['fbq:atc:1234567890', 'gtag:atc:AW-123456789/abc123'],
- *   [{ event: 'atc' }]
- * );
+ * trackByTags({
+ *   tags: ['fbq:atc:1234567890', 'gtag:atc:AW-123456789/abc123'],
+ *   data: [{ event: 'custom' }]
+ * });
  * ```
  */
 declare function trackByTags({ tags, data }: TrackByTagsParams): void;
@@ -325,6 +324,109 @@ declare function updateScriptsType(scriptIds: string[] | ((index: number) => str
  */
 declare const isPlatformAvailable: (platform: PlatformType) => boolean;
 
+/**
+ * 触发埋点上报工具
+ *
+ * 从 sessionStorage 读取 trackTags 配置，并根据 trackPoint 触发对应的埋点上报
+ */
+/**
+ * TrackTags 配置类型
+ * key: trackPoint 标识
+ * value: 标签数组
+ */
+interface TrackTagsConfig {
+    [trackPoint: string]: string[];
+}
+/**
+ * 埋点触发选项
+ */
+interface TriggerTrackOptions {
+    tags?: Array<string>;
+    /** 自定义事件数据 */
+    eventData?: Record<string, unknown>;
+    /** 自定义存储键名，默认为 'trackTags' */
+    storageKey?: string;
+    /** 是否静默失败（不输出警告日志），默认为 false */
+    silent?: boolean;
+}
+/**
+ * 触发埋点上报
+ *
+ * 从 sessionStorage 读取 trackTags 配置，根据 trackPoint 获取对应的标签数组，
+ * 然后调用 trackByTags 进行埋点上报。
+ *
+ * @param trackPoint - 埋点标识，对应 trackTags 中的 key
+ * @param options - 可选配置项
+ *
+ * @example
+ * ```typescript
+ * // 基础用法
+ * triggerTrack('add_to_cart');
+ *
+ * // 带自定义数据
+ * triggerTrack('purchase', {
+ *   eventData: {
+ *     value: 99.99,
+ *     currency: 'USD',
+ *     transactionId: 'ORDER-123'
+ *   }
+ * });
+ *
+ * // 使用自定义存储键
+ * triggerTrack('custom_event', {
+ *   storageKey: 'customTrackTags'
+ * });
+ * ```
+ */
+declare function triggerTrack(trackPoint: string, options?: TriggerTrackOptions): void;
+/**
+ * 批量触发多个埋点
+ *
+ * @param trackPoints - 埋点标识数组
+ * @param options - 可选配置项（应用到所有埋点）
+ *
+ * @example
+ * ```typescript
+ * // 批量触发多个埋点
+ * triggerTrackBatch(['view_item', 'add_to_cart']);
+ *
+ * // 带共享的事件数据
+ * triggerTrackBatch(['event1', 'event2'], {
+ *   eventData: { sessionId: '12345' }
+ * });
+ * ```
+ */
+declare function triggerTrackBatch(trackPoints: string[], options?: TriggerTrackOptions): void;
+/**
+ * 设置 trackTags 到 sessionStorage
+ *
+ * @param trackTags - TrackTags 配置对象
+ * @param storageKey - 存储键名，默认为 'trackTags'
+ *
+ * @example
+ * ```typescript
+ * setTrackTags({
+ *   'add_to_cart': ['fbq:atc:123456', 'gtag:atc:AW-123/abc'],
+ *   'purchase': ['fbq:purchase:123456', 'gtag:purchase:AW-123/xyz']
+ * });
+ * ```
+ */
+declare function setTrackTags(trackTags: TrackTagsConfig, storageKey?: string): void;
+/**
+ * 清除 trackTags
+ *
+ * @param storageKey - 存储键名，默认为 'trackTags'
+ */
+declare function clearTrackTags(storageKey?: string): void;
+/**
+ * 检查某个 trackPoint 是否存在
+ *
+ * @param trackPoint - 埋点标识
+ * @param storageKey - 存储键名，默认为 'trackTags'
+ * @returns 是否存在对应的标签配置
+ */
+declare function hasTrackPoint(trackPoint: string, storageKey?: string): boolean;
+
 /**
  * Google Analytics / gtag.js 适配器
  * 使用标准的 window.gtag() API
@@ -384,4 +486,4 @@ declare const _default: {
     updateScriptsType: typeof updateScriptsType;
 };
 
-export { type AnalysisConfig, type AutoTrackConfig, type BasePlatformConfig, type Currency, type GtagConfig, type GtagConfigParams, type GtagEventName, GtagPixel, type GtagTrackParams, MetaPixel, type MetaPixelConfig, type MetaTrackParams, type ParsedTag, PixelsManager, type PixelsManagerConfig, type PlatformType, type ScarabConfig, type TikTokPixelConfig, type TrackByTagsData, type TrackByTagsParams, type TrackConfig, type TrackEventType, type TrackParams, TrackTagsVersionMap, type Tracker, type UpdateScriptTypeOptions, _default as default, gtagTrack, isPlatformAvailable, logger, metaTrack, track, trackByTags, updateScriptType, updateScriptsType, useTracking, withTracking };
+export { type AnalysisConfig, type AutoTrackConfig, type BasePlatformConfig, type Currency, type GtagConfig, type GtagConfigParams, type GtagEventName, GtagPixel, type GtagTrackParams, MetaPixel, type MetaPixelConfig, type MetaTrackParams, type ParsedTag, PixelsManager, type PixelsManagerConfig, type PlatformType, type ScarabConfig, type TikTokPixelConfig, type TrackByTagsData, type TrackByTagsParams, type TrackConfig, type TrackEventType, type TrackParams, type TrackTagsConfig, TrackTagsVersionMap, type Tracker, type TriggerTrackOptions, type UpdateScriptTypeOptions, clearTrackTags, _default as default, gtagTrack, hasTrackPoint, isPlatformAvailable, logger, metaTrack, setTrackTags, track, trackByTags, triggerTrack, triggerTrackBatch, updateScriptType, updateScriptsType, useTracking, withTracking };

package/dist/index.js

@@ -123,6 +123,239 @@ var isPlatformAvailable = /* @__PURE__ */ __name((platform) => {
   }
 }, "isPlatformAvailable");
 
+// src/constants/tagsMap.ts
+var TrackTagsVersionMap = {
+  "fbq:act": "fbq:atc",
+  "gtag:conversion": "gtag:atc"
+};
+
+// src/autoTrack/trackByTags.ts
+function parseTag(tag) {
+  const parts = tag.split(":");
+  if (parts.length < 2) {
+    return null;
+  }
+  return {
+    media: parts[0]?.toLowerCase() || "",
+    event: parts[1]?.toLowerCase() || "",
+    target: parts[2] || null
+  };
+}
+__name(parseTag, "parseTag");
+function adaptEventName(tags) {
+  for (let i = 0; i < tags.length; i++) {
+    if (!tags[i]) {
+      continue;
+    }
+    for (const [oldEvent, newEvent] of Object.entries(TrackTagsVersionMap)) {
+      if (tags[i]?.includes(oldEvent)) {
+        tags[i] = tags[i]?.replace(oldEvent, newEvent) ?? "";
+        break;
+      }
+    }
+  }
+}
+__name(adaptEventName, "adaptEventName");
+function handleTagTracking(parsedTag, eventData) {
+  const { media, event, target } = parsedTag;
+  if (!target) {
+    logger.warn(`Tag missing target: ${media}:${event}`);
+    return;
+  }
+  try {
+    switch (media) {
+      case "fbq":
+      case "meta": {
+        const config = {
+          platform: "meta",
+          event: target,
+          // target 作为事件名
+          data: eventData
+        };
+        track(config);
+        break;
+      }
+      case "gtag": {
+        const config = {
+          platform: "gtag",
+          eventName: "conversion",
+          send_to: target,
+          // target 作为转化目标ID
+          value: eventData?.value ?? 1,
+          currency: eventData?.currency,
+          transactionId: eventData?.transactionId
+        };
+        track(config);
+        break;
+      }
+      default:
+        logger.warn(`Unsupported media platform: ${media}`);
+    }
+  } catch (error) {
+    logger.error(`Failed to track tag ${media}:${event}:${target}:`, error);
+  }
+}
+__name(handleTagTracking, "handleTagTracking");
+function trackByTags({ tags, data }) {
+  if (!tags || tags.length === 0) {
+    logger.warn("trackByTags: tags array is empty");
+    return;
+  }
+  const adaptedTags = [...tags];
+  adaptEventName(adaptedTags);
+  const firstData = data && data.length > 0 ? data[0] : void 0;
+  const { event, ...trackingData } = firstData || {};
+  adaptedTags.forEach((tag) => {
+    const parsed = parseTag(tag);
+    if (!parsed) {
+      logger.warn(`trackByTags: Invalid tag format: ${tag}`);
+      return;
+    }
+    handleTagTracking(parsed, trackingData);
+  });
+}
+__name(trackByTags, "trackByTags");
+
+// src/core/helpers/triggerTrack.ts
+function getTrackTagsFromStorage(storageKey) {
+  if (typeof window === "undefined" || !window.sessionStorage) {
+    logger.warn("sessionStorage is not available");
+    return null;
+  }
+  try {
+    const trackTagsRaw = sessionStorage.getItem(storageKey);
+    if (!trackTagsRaw) {
+      return null;
+    }
+    const trackTags = JSON.parse(trackTagsRaw);
+    if (!trackTags || typeof trackTags !== "object") {
+      logger.warn(
+        `Invalid trackTags format in sessionStorage key: ${storageKey}`
+      );
+      return null;
+    }
+    return trackTags;
+  } catch (error) {
+    logger.error(`Failed to parse trackTags from sessionStorage:`, error);
+    return null;
+  }
+}
+__name(getTrackTagsFromStorage, "getTrackTagsFromStorage");
+function triggerTrack(trackPoint, options = {}) {
+  const {
+    tags,
+    eventData = {},
+    storageKey = "trackTags",
+    silent = false
+  } = options;
+  if (!trackPoint || typeof trackPoint !== "string") {
+    if (!silent) {
+      logger.warn("triggerTrack: trackPoint is required and must be a string");
+    }
+    return;
+  }
+  const trackTagsRow = getTrackTagsFromStorage(storageKey);
+  if (!trackTagsRow) {
+    if (!silent) {
+      logger.warn(
+        `triggerTrack: trackTags not found in sessionStorage (key: ${storageKey})`
+      );
+    }
+    return;
+  }
+  const trackTags = tags || trackTagsRow[trackPoint];
+  if (!trackTags) {
+    if (!silent) {
+      logger.warn(`triggerTrack: No tags found for trackPoint: ${trackPoint}`);
+    }
+    return;
+  }
+  if (!Array.isArray(trackTags)) {
+    if (!silent) {
+      logger.warn(
+        `triggerTrack: Tags for trackPoint "${trackPoint}" is not an array`
+      );
+    }
+    return;
+  }
+  if (trackTags.length === 0) {
+    if (!silent) {
+      logger.log(
+        `triggerTrack: Tags array is empty for trackPoint: ${trackPoint}`
+      );
+    }
+    return;
+  }
+  try {
+    trackByTags({
+      tags: trackTags,
+      data: [{ event: "custom", ...eventData }]
+    });
+    logger.log(
+      `triggerTrack: Successfully triggered for trackPoint: ${trackPoint}`,
+      {
+        tagsCount: trackTags.length,
+        trackTags
+      }
+    );
+  } catch (error) {
+    logger.error(
+      `triggerTrack: Failed to track for trackPoint: ${trackPoint}`,
+      error
+    );
+  }
+}
+__name(triggerTrack, "triggerTrack");
+function triggerTrackBatch(trackPoints, options = {}) {
+  if (!Array.isArray(trackPoints)) {
+    logger.warn("triggerTrackBatch: trackPoints must be an array");
+    return;
+  }
+  trackPoints.forEach((trackPoint) => {
+    triggerTrack(trackPoint, options);
+  });
+}
+__name(triggerTrackBatch, "triggerTrackBatch");
+function setTrackTags(trackTags, storageKey = "trackTags") {
+  if (typeof window === "undefined" || !window.sessionStorage) {
+    logger.warn("sessionStorage is not available");
+    return;
+  }
+  try {
+    const trackTagsJson = JSON.stringify(trackTags);
+    sessionStorage.setItem(storageKey, trackTagsJson);
+    logger.log(
+      `setTrackTags: Successfully saved to sessionStorage (key: ${storageKey})`
+    );
+  } catch (error) {
+    logger.error("setTrackTags: Failed to save to sessionStorage", error);
+  }
+}
+__name(setTrackTags, "setTrackTags");
+function clearTrackTags(storageKey = "trackTags") {
+  if (typeof window === "undefined" || !window.sessionStorage) {
+    return;
+  }
+  try {
+    sessionStorage.removeItem(storageKey);
+    logger.log(
+      `clearTrackTags: Successfully removed from sessionStorage (key: ${storageKey})`
+    );
+  } catch (error) {
+    logger.error("clearTrackTags: Failed to remove from sessionStorage", error);
+  }
+}
+__name(clearTrackTags, "clearTrackTags");
+function hasTrackPoint(trackPoint, storageKey = "trackTags") {
+  const trackTags = getTrackTagsFromStorage(storageKey);
+  if (!trackTags) {
+    return false;
+  }
+  const tags = trackTags[trackPoint];
+  return Array.isArray(tags) && tags.length > 0;
+}
+__name(hasTrackPoint, "hasTrackPoint");
+
 // src/core/adapters/gtag.ts
 var gtagTrack = /* @__PURE__ */ __name((command, targetOrEventName, params) => {
   if (typeof window === "undefined") {
@@ -215,121 +448,6 @@ function handleMetaTrack(params) {
 }
 __name(handleMetaTrack, "handleMetaTrack");
 
-// src/constants/tagsMap.ts
-var TrackTagsVersionMap = {
-  "fbq:act": "fbq:atc",
-  "gtag:conversion": "gtag:atc"
-};
-
-// src/autoTrack/trackByTags.ts
-function parseTag(tag) {
-  const parts = tag.split(":");
-  if (parts.length < 2) {
-    return null;
-  }
-  return {
-    media: parts[0]?.toLowerCase() || "",
-    event: parts[1]?.toLowerCase() || "",
-    target: parts[2] || null
-  };
-}
-__name(parseTag, "parseTag");
-function adaptEventName(tags) {
-  for (let i = 0; i < tags.length; i++) {
-    if (!tags[i]) {
-      continue;
-    }
-    for (const [oldEvent, newEvent] of Object.entries(TrackTagsVersionMap)) {
-      if (tags[i]?.includes(oldEvent)) {
-        tags[i] = tags[i]?.replace(oldEvent, newEvent) ?? "";
-        break;
-      }
-    }
-  }
-}
-__name(adaptEventName, "adaptEventName");
-function filterTagsByEvent(tags, eventSymbol) {
-  return tags.filter((tag) => {
-    const parsed = parseTag(tag);
-    return parsed?.event === eventSymbol.toLowerCase();
-  });
-}
-__name(filterTagsByEvent, "filterTagsByEvent");
-function handleTagTracking(parsedTag, eventData) {
-  const { media, event, target } = parsedTag;
-  if (!target) {
-    logger.warn(`Tag missing target: ${media}:${event}`);
-    return;
-  }
-  try {
-    switch (media) {
-      case "fbq":
-      case "meta": {
-        const config = {
-          platform: "meta",
-          event: target,
-          // target 作为事件名
-          data: eventData
-        };
-        track(config);
-        break;
-      }
-      case "gtag": {
-        const config = {
-          platform: "gtag",
-          eventName: "conversion",
-          send_to: target,
-          // target 作为转化目标ID
-          value: eventData?.value ?? 1,
-          currency: eventData?.currency,
-          transactionId: eventData?.transactionId
-        };
-        track(config);
-        break;
-      }
-      default:
-        logger.warn(`Unsupported media platform: ${media}`);
-    }
-  } catch (error) {
-    logger.error(`Failed to track tag ${media}:${event}:${target}:`, error);
-  }
-}
-__name(handleTagTracking, "handleTagTracking");
-function trackByTags({ tags, data }) {
-  if (!tags || tags.length === 0) {
-    logger.warn("trackByTags: tags array is empty");
-    return;
-  }
-  if (!data || data.length === 0) {
-    logger.warn("trackByTags: data array is empty");
-    return;
-  }
-  const adaptedTags = [...tags];
-  adaptEventName(adaptedTags);
-  data.forEach((trackData) => {
-    const eventSymbol = trackData.event?.toLowerCase();
-    if (!eventSymbol) {
-      logger.warn("trackByTags: event symbol is missing in trackData");
-      return;
-    }
-    const matchedTags = filterTagsByEvent(adaptedTags, eventSymbol);
-    if (matchedTags.length === 0) {
-      logger.log(`trackByTags: No tags found for event: ${eventSymbol}`);
-      return;
-    }
-    const { event, ...eventData } = trackData;
-    matchedTags.forEach((tag) => {
-      const parsed = parseTag(tag);
-      if (!parsed) {
-        logger.warn(`trackByTags: Invalid tag format: ${tag}`);
-        return;
-      }
-      handleTagTracking(parsed, eventData);
-    });
-  });
-}
-__name(trackByTags, "trackByTags");
-
 // src/core/tracking/with-tracking.ts
 function executeTracking(trackPoint, trackConfig) {
   const configs = Array.isArray(trackConfig) ? trackConfig : [trackConfig ?? {}];
@@ -634,13 +752,18 @@ export {
   MetaPixel_default as MetaPixel,
   PixelsManager_default as PixelsManager,
   TrackTagsVersionMap,
+  clearTrackTags,
   index_default as default,
   gtagTrack,
+  hasTrackPoint,
   isPlatformAvailable,
   logger,
   metaTrack,
+  setTrackTags,
   track,
   trackByTags,
+  triggerTrack,
+  triggerTrackBatch,
   updateScriptType,
   updateScriptsType,
   useTracking,