@qhr123/sa2kit 0.7.2 → 0.8.1

package/dist/analytics/index.d.mts

@@ -735,9 +735,14 @@ declare function useAutoTracking(analytics: Analytics | null, options?: {
  */
 
 /**
- * Web 存储适配器（使用 localStorage）
+ * Web 事件存储适配器
+ * 基于通用 WebStorageAdapter 实现
+ *
+ * 注意：此适配器专门用于 Analytics 埋点事件的存储
+ * 与通用存储适配器 (storage/adapters/web-adapter) 不同
  */
-declare class WebStorageAdapter implements AnalyticsStorageAdapter {
+declare class WebEventStorageAdapter implements AnalyticsStorageAdapter {
+    private storage;
     private EVENTS_KEY;
     private DEVICE_INFO_KEY;
     private SESSION_ID_KEY;
@@ -771,7 +776,7 @@ declare class WebDeviceAdapter implements AnalyticsDeviceAdapter {
  * 统一的 Web 适配器对象
  */
 declare const webAdapter: {
-    storage: WebStorageAdapter;
+    storage: WebEventStorageAdapter;
     network: WebNetworkAdapter;
     device: WebDeviceAdapter;
 };
@@ -782,10 +787,10 @@ declare const webAdapter: {
  */
 
 /**
- * Mobile 存储适配器
+ * Mobile 事件存储适配器
  * 需要在 mobile 项目中实现具体的 AsyncStorage 逻辑
  */
-declare class MobileStorageAdapter implements AnalyticsStorageAdapter {
+declare class MobileEventStorageAdapter implements AnalyticsStorageAdapter {
     private storage;
     private EVENTS_KEY;
     private DEVICE_INFO_KEY;
@@ -832,6 +837,11 @@ declare class MobileDeviceAdapter implements AnalyticsDeviceAdapter {
     generateDeviceId(): Promise<string>;
     private getDefaultDeviceInfo;
 }
+/**
+ * @deprecated 使用 MobileEventStorageAdapter 替代
+ * 保留此导出以向后兼容
+ */
+declare const MobileStorageAdapter: typeof MobileEventStorageAdapter;
 
 /**
  * 小程序平台适配器
@@ -839,9 +849,9 @@ declare class MobileDeviceAdapter implements AnalyticsDeviceAdapter {
  */
 
 /**
- * 小程序存储适配器
+ * 小程序事件存储适配器
  */
-declare class MiniappStorageAdapter implements AnalyticsStorageAdapter {
+declare class MiniappEventStorageAdapter implements AnalyticsStorageAdapter {
     private storage?;
     private EVENTS_KEY;
     private DEVICE_INFO_KEY;
@@ -887,6 +897,11 @@ declare class MiniappDeviceAdapter implements AnalyticsDeviceAdapter {
     generateDeviceId(): Promise<string>;
     private getDefaultDeviceInfo;
 }
+/**
+ * @deprecated 使用 MiniappEventStorageAdapter 替代
+ * 保留此导出以向后兼容
+ */
+declare const MiniappStorageAdapter: typeof MiniappEventStorageAdapter;
 
 /**
  * Desktop 平台适配器
@@ -894,9 +909,9 @@ declare class MiniappDeviceAdapter implements AnalyticsDeviceAdapter {
  */
 
 /**
- * Desktop 存储适配器（使用 localStorage）
+ * Desktop 事件存储适配器（使用 localStorage）
  */
-declare class DesktopStorageAdapter implements AnalyticsStorageAdapter {
+declare class DesktopEventStorageAdapter implements AnalyticsStorageAdapter {
     private EVENTS_KEY;
     private DEVICE_INFO_KEY;
     private SESSION_ID_KEY;
@@ -924,6 +939,11 @@ declare class DesktopDeviceAdapter implements AnalyticsDeviceAdapter {
     private getOSName;
     private getOSVersion;
 }
+/**
+ * @deprecated 使用 DesktopEventStorageAdapter 替代
+ * 保留此导出以向后兼容
+ */
+declare const DesktopStorageAdapter: typeof DesktopEventStorageAdapter;
 
 /**
  * 埋点管理界面组件类型
@@ -1061,4 +1081,4 @@ declare const AnalyticsDashboard: React__default.FC<AnalyticsDashboardProps>;
 
 declare const ANALYTICS_VERSION = "1.0.0";
 
-export { ANALYTICS_VERSION, Analytics, type AnalyticsConfig, AnalyticsDashboard, type AnalyticsDashboardProps, type AnalyticsDeviceAdapter, type AnalyticsEvent, type AnalyticsNetworkAdapter, type AnalyticsStorageAdapter, type ApiCallEvent, BarChart, type BaseEvent, CatchError, type ChartDataPoint, type ClickEvent, type DashboardEvent, type DashboardStats, DesktopDeviceAdapter, DesktopNetworkAdapter, DesktopStorageAdapter, type DeviceInfo, type ErrorEvent, EventList, type EventListProps, EventPriority, EventQueue, EventType, type FilterOptions, FilterPanel, type FilterPanelProps, MiniappDeviceAdapter, MiniappNetworkAdapter, MiniappStorageAdapter, MobileDeviceAdapter, MobileNetworkAdapter, MobileStorageAdapter, type PageViewEvent, type PerformanceEvent, PieChart, StatCard, type StatCardProps, Track, TrackClick, TrackPerformance, type UploadResponse, Uploader, WebDeviceAdapter, WebNetworkAdapter, WebStorageAdapter, createAnalytics, createDesktopConfig, createMiniappConfig, createMobileConfig, createWebConfig, debounce, deepClone, formatEvent, formatTimestamp, generateUniqueId, getAllInstanceKeys, getAnalyticsInstance, getBatchSize, getCurrentPageTitle, getCurrentPageUrl, getEventSize, getGlobalAnalytics, getPageDuration, getReferrer, isAnalyticsInitialized, isDevelopment, isMobile, mergeEventProperties, resetAllAnalytics, resetAnalytics, safeParse, safeStringify, sanitizeEvent, setGlobalAnalytics, throttle, useAnalytics, useAutoTracking, useErrorTracking, usePageDuration, usePageView, usePerformanceTracking, useTrackClick, useTrackEvent, validateEvent, validateEvents, webAdapter };
+export { ANALYTICS_VERSION, Analytics, type AnalyticsConfig, AnalyticsDashboard, type AnalyticsDashboardProps, type AnalyticsDeviceAdapter, type AnalyticsEvent, type AnalyticsNetworkAdapter, type AnalyticsStorageAdapter, type ApiCallEvent, BarChart, type BaseEvent, CatchError, type ChartDataPoint, type ClickEvent, type DashboardEvent, type DashboardStats, DesktopDeviceAdapter, DesktopEventStorageAdapter, DesktopNetworkAdapter, DesktopStorageAdapter, type DeviceInfo, type ErrorEvent, EventList, type EventListProps, EventPriority, EventQueue, EventType, type FilterOptions, FilterPanel, type FilterPanelProps, MiniappDeviceAdapter, MiniappEventStorageAdapter, MiniappNetworkAdapter, MiniappStorageAdapter, MobileDeviceAdapter, MobileEventStorageAdapter, MobileNetworkAdapter, MobileStorageAdapter, type PageViewEvent, type PerformanceEvent, PieChart, StatCard, type StatCardProps, Track, TrackClick, TrackPerformance, type UploadResponse, Uploader, WebDeviceAdapter, WebEventStorageAdapter, WebNetworkAdapter, createAnalytics, createDesktopConfig, createMiniappConfig, createMobileConfig, createWebConfig, debounce, deepClone, formatEvent, formatTimestamp, generateUniqueId, getAllInstanceKeys, getAnalyticsInstance, getBatchSize, getCurrentPageTitle, getCurrentPageUrl, getEventSize, getGlobalAnalytics, getPageDuration, getReferrer, isAnalyticsInitialized, isDevelopment, isMobile, mergeEventProperties, resetAllAnalytics, resetAnalytics, safeParse, safeStringify, sanitizeEvent, setGlobalAnalytics, throttle, useAnalytics, useAutoTracking, useErrorTracking, usePageDuration, usePageView, usePerformanceTracking, useTrackClick, useTrackEvent, validateEvent, validateEvents, webAdapter };

package/dist/analytics/index.d.ts

@@ -735,9 +735,14 @@ declare function useAutoTracking(analytics: Analytics | null, options?: {
  */
 
 /**
- * Web 存储适配器（使用 localStorage）
+ * Web 事件存储适配器
+ * 基于通用 WebStorageAdapter 实现
+ *
+ * 注意：此适配器专门用于 Analytics 埋点事件的存储
+ * 与通用存储适配器 (storage/adapters/web-adapter) 不同
  */
-declare class WebStorageAdapter implements AnalyticsStorageAdapter {
+declare class WebEventStorageAdapter implements AnalyticsStorageAdapter {
+    private storage;
     private EVENTS_KEY;
     private DEVICE_INFO_KEY;
     private SESSION_ID_KEY;
@@ -771,7 +776,7 @@ declare class WebDeviceAdapter implements AnalyticsDeviceAdapter {
  * 统一的 Web 适配器对象
  */
 declare const webAdapter: {
-    storage: WebStorageAdapter;
+    storage: WebEventStorageAdapter;
     network: WebNetworkAdapter;
     device: WebDeviceAdapter;
 };
@@ -782,10 +787,10 @@ declare const webAdapter: {
  */
 
 /**
- * Mobile 存储适配器
+ * Mobile 事件存储适配器
  * 需要在 mobile 项目中实现具体的 AsyncStorage 逻辑
  */
-declare class MobileStorageAdapter implements AnalyticsStorageAdapter {
+declare class MobileEventStorageAdapter implements AnalyticsStorageAdapter {
     private storage;
     private EVENTS_KEY;
     private DEVICE_INFO_KEY;
@@ -832,6 +837,11 @@ declare class MobileDeviceAdapter implements AnalyticsDeviceAdapter {
     generateDeviceId(): Promise<string>;
     private getDefaultDeviceInfo;
 }
+/**
+ * @deprecated 使用 MobileEventStorageAdapter 替代
+ * 保留此导出以向后兼容
+ */
+declare const MobileStorageAdapter: typeof MobileEventStorageAdapter;
 
 /**
  * 小程序平台适配器
@@ -839,9 +849,9 @@ declare class MobileDeviceAdapter implements AnalyticsDeviceAdapter {
  */
 
 /**
- * 小程序存储适配器
+ * 小程序事件存储适配器
  */
-declare class MiniappStorageAdapter implements AnalyticsStorageAdapter {
+declare class MiniappEventStorageAdapter implements AnalyticsStorageAdapter {
     private storage?;
     private EVENTS_KEY;
     private DEVICE_INFO_KEY;
@@ -887,6 +897,11 @@ declare class MiniappDeviceAdapter implements AnalyticsDeviceAdapter {
     generateDeviceId(): Promise<string>;
     private getDefaultDeviceInfo;
 }
+/**
+ * @deprecated 使用 MiniappEventStorageAdapter 替代
+ * 保留此导出以向后兼容
+ */
+declare const MiniappStorageAdapter: typeof MiniappEventStorageAdapter;
 
 /**
  * Desktop 平台适配器
@@ -894,9 +909,9 @@ declare class MiniappDeviceAdapter implements AnalyticsDeviceAdapter {
  */
 
 /**
- * Desktop 存储适配器（使用 localStorage）
+ * Desktop 事件存储适配器（使用 localStorage）
  */
-declare class DesktopStorageAdapter implements AnalyticsStorageAdapter {
+declare class DesktopEventStorageAdapter implements AnalyticsStorageAdapter {
     private EVENTS_KEY;
     private DEVICE_INFO_KEY;
     private SESSION_ID_KEY;
@@ -924,6 +939,11 @@ declare class DesktopDeviceAdapter implements AnalyticsDeviceAdapter {
     private getOSName;
     private getOSVersion;
 }
+/**
+ * @deprecated 使用 DesktopEventStorageAdapter 替代
+ * 保留此导出以向后兼容
+ */
+declare const DesktopStorageAdapter: typeof DesktopEventStorageAdapter;
 
 /**
  * 埋点管理界面组件类型
@@ -1061,4 +1081,4 @@ declare const AnalyticsDashboard: React__default.FC<AnalyticsDashboardProps>;
 
 declare const ANALYTICS_VERSION = "1.0.0";
 
-export { ANALYTICS_VERSION, Analytics, type AnalyticsConfig, AnalyticsDashboard, type AnalyticsDashboardProps, type AnalyticsDeviceAdapter, type AnalyticsEvent, type AnalyticsNetworkAdapter, type AnalyticsStorageAdapter, type ApiCallEvent, BarChart, type BaseEvent, CatchError, type ChartDataPoint, type ClickEvent, type DashboardEvent, type DashboardStats, DesktopDeviceAdapter, DesktopNetworkAdapter, DesktopStorageAdapter, type DeviceInfo, type ErrorEvent, EventList, type EventListProps, EventPriority, EventQueue, EventType, type FilterOptions, FilterPanel, type FilterPanelProps, MiniappDeviceAdapter, MiniappNetworkAdapter, MiniappStorageAdapter, MobileDeviceAdapter, MobileNetworkAdapter, MobileStorageAdapter, type PageViewEvent, type PerformanceEvent, PieChart, StatCard, type StatCardProps, Track, TrackClick, TrackPerformance, type UploadResponse, Uploader, WebDeviceAdapter, WebNetworkAdapter, WebStorageAdapter, createAnalytics, createDesktopConfig, createMiniappConfig, createMobileConfig, createWebConfig, debounce, deepClone, formatEvent, formatTimestamp, generateUniqueId, getAllInstanceKeys, getAnalyticsInstance, getBatchSize, getCurrentPageTitle, getCurrentPageUrl, getEventSize, getGlobalAnalytics, getPageDuration, getReferrer, isAnalyticsInitialized, isDevelopment, isMobile, mergeEventProperties, resetAllAnalytics, resetAnalytics, safeParse, safeStringify, sanitizeEvent, setGlobalAnalytics, throttle, useAnalytics, useAutoTracking, useErrorTracking, usePageDuration, usePageView, usePerformanceTracking, useTrackClick, useTrackEvent, validateEvent, validateEvents, webAdapter };
+export { ANALYTICS_VERSION, Analytics, type AnalyticsConfig, AnalyticsDashboard, type AnalyticsDashboardProps, type AnalyticsDeviceAdapter, type AnalyticsEvent, type AnalyticsNetworkAdapter, type AnalyticsStorageAdapter, type ApiCallEvent, BarChart, type BaseEvent, CatchError, type ChartDataPoint, type ClickEvent, type DashboardEvent, type DashboardStats, DesktopDeviceAdapter, DesktopEventStorageAdapter, DesktopNetworkAdapter, DesktopStorageAdapter, type DeviceInfo, type ErrorEvent, EventList, type EventListProps, EventPriority, EventQueue, EventType, type FilterOptions, FilterPanel, type FilterPanelProps, MiniappDeviceAdapter, MiniappEventStorageAdapter, MiniappNetworkAdapter, MiniappStorageAdapter, MobileDeviceAdapter, MobileEventStorageAdapter, MobileNetworkAdapter, MobileStorageAdapter, type PageViewEvent, type PerformanceEvent, PieChart, StatCard, type StatCardProps, Track, TrackClick, TrackPerformance, type UploadResponse, Uploader, WebDeviceAdapter, WebEventStorageAdapter, WebNetworkAdapter, createAnalytics, createDesktopConfig, createMiniappConfig, createMobileConfig, createWebConfig, debounce, deepClone, formatEvent, formatTimestamp, generateUniqueId, getAllInstanceKeys, getAnalyticsInstance, getBatchSize, getCurrentPageTitle, getCurrentPageUrl, getEventSize, getGlobalAnalytics, getPageDuration, getReferrer, isAnalyticsInitialized, isDevelopment, isMobile, mergeEventProperties, resetAllAnalytics, resetAnalytics, safeParse, safeStringify, sanitizeEvent, setGlobalAnalytics, throttle, useAnalytics, useAutoTracking, useErrorTracking, usePageDuration, usePageView, usePerformanceTracking, useTrackClick, useTrackEvent, validateEvent, validateEvents, webAdapter };

package/dist/analytics/index.js

@@ -1,5 +1,6 @@
 'use strict';
 
+var chunkQU5OT4DF_js = require('../chunk-QU5OT4DF.js');
 require('../chunk-DGUM43GV.js');
 var React5 = require('react');
 
@@ -1164,28 +1165,24 @@ function useAutoTracking(analytics, options = {}) {
 }
 
 // src/analytics/adapters/web.ts
-var WebStorageAdapter = class {
+var WebEventStorageAdapter = class {
   constructor() {
+    this.storage = new chunkQU5OT4DF_js.WebStorageAdapter();
     this.EVENTS_KEY = "analytics:events";
     this.DEVICE_INFO_KEY = "analytics:device_info";
     this.SESSION_ID_KEY = "analytics:session_id";
   }
   async saveEvents(events) {
     try {
-      if (typeof window !== "undefined") {
-        localStorage.setItem(this.EVENTS_KEY, JSON.stringify(events));
-      }
+      await this.storage.setItem(this.EVENTS_KEY, JSON.stringify(events));
     } catch (error) {
       console.error("Failed to save events:", error);
     }
   }
   async getEvents() {
     try {
-      if (typeof window !== "undefined") {
-        const data = localStorage.getItem(this.EVENTS_KEY);
-        return data ? JSON.parse(data) : [];
-      }
-      return [];
+      const data = await this.storage.getItem(this.EVENTS_KEY);
+      return data ? JSON.parse(data) : [];
     } catch (error) {
       console.error("Failed to get events:", error);
       return [];
@@ -1193,29 +1190,22 @@ var WebStorageAdapter = class {
   }
   async clearEvents() {
     try {
-      if (typeof window !== "undefined") {
-        localStorage.removeItem(this.EVENTS_KEY);
-      }
+      await this.storage.removeItem(this.EVENTS_KEY);
     } catch (error) {
       console.error("Failed to clear events:", error);
     }
   }
   async saveDeviceInfo(info) {
     try {
-      if (typeof window !== "undefined") {
-        localStorage.setItem(this.DEVICE_INFO_KEY, JSON.stringify(info));
-      }
+      await this.storage.setItem(this.DEVICE_INFO_KEY, JSON.stringify(info));
     } catch (error) {
       console.error("Failed to save device info:", error);
     }
   }
   async getDeviceInfo() {
     try {
-      if (typeof window !== "undefined") {
-        const data = localStorage.getItem(this.DEVICE_INFO_KEY);
-        return data ? JSON.parse(data) : null;
-      }
-      return null;
+      const data = await this.storage.getItem(this.DEVICE_INFO_KEY);
+      return data ? JSON.parse(data) : null;
     } catch (error) {
       console.error("Failed to get device info:", error);
       return null;
@@ -1223,7 +1213,7 @@ var WebStorageAdapter = class {
   }
   async saveSessionId(sessionId) {
     try {
-      if (typeof window !== "undefined") {
+      if (typeof window !== "undefined" && typeof sessionStorage !== "undefined") {
         sessionStorage.setItem(this.SESSION_ID_KEY, sessionId);
       }
     } catch (error) {
@@ -1232,7 +1222,7 @@ var WebStorageAdapter = class {
   }
   async getSessionId() {
     try {
-      if (typeof window !== "undefined") {
+      if (typeof window !== "undefined" && typeof sessionStorage !== "undefined") {
         return sessionStorage.getItem(this.SESSION_ID_KEY);
       }
       return null;
@@ -1344,13 +1334,13 @@ var WebDeviceAdapter = class {
   }
 };
 var webAdapter = {
-  storage: new WebStorageAdapter(),
+  storage: new WebEventStorageAdapter(),
   network: new WebNetworkAdapter(),
   device: new WebDeviceAdapter()
 };
 
 // src/analytics/adapters/mobile.ts
-var MobileStorageAdapter = class {
+var MobileEventStorageAdapter = class {
   // 需要注入具体的存储实现
   constructor(storage) {
     this.storage = storage;
@@ -1505,9 +1495,10 @@ var MobileDeviceAdapter = class {
     };
   }
 };
+var MobileStorageAdapter = MobileEventStorageAdapter;
 
 // src/analytics/adapters/miniapp.ts
-var MiniappStorageAdapter = class {
+var MiniappEventStorageAdapter = class {
   // 需要注入 Taro 的存储 API
   constructor(storage) {
     this.storage = storage;
@@ -1686,9 +1677,10 @@ var MiniappDeviceAdapter = class {
     };
   }
 };
+var MiniappStorageAdapter = MiniappEventStorageAdapter;
 
 // src/analytics/adapters/desktop.ts
-var DesktopStorageAdapter = class {
+var DesktopEventStorageAdapter = class {
   constructor() {
     this.EVENTS_KEY = "analytics:events";
     this.DEVICE_INFO_KEY = "analytics:device_info";
@@ -1846,6 +1838,7 @@ var DesktopDeviceAdapter = class {
     return navigator.userAgent;
   }
 };
+var DesktopStorageAdapter = DesktopEventStorageAdapter;
 var StatCard = ({
   title,
   value,
@@ -2532,6 +2525,7 @@ exports.AnalyticsDashboard = AnalyticsDashboard;
 exports.BarChart = BarChart;
 exports.CatchError = CatchError;
 exports.DesktopDeviceAdapter = DesktopDeviceAdapter;
+exports.DesktopEventStorageAdapter = DesktopEventStorageAdapter;
 exports.DesktopNetworkAdapter = DesktopNetworkAdapter;
 exports.DesktopStorageAdapter = DesktopStorageAdapter;
 exports.EventList = EventList;
@@ -2540,9 +2534,11 @@ exports.EventQueue = EventQueue;
 exports.EventType = EventType;
 exports.FilterPanel = FilterPanel;
 exports.MiniappDeviceAdapter = MiniappDeviceAdapter;
+exports.MiniappEventStorageAdapter = MiniappEventStorageAdapter;
 exports.MiniappNetworkAdapter = MiniappNetworkAdapter;
 exports.MiniappStorageAdapter = MiniappStorageAdapter;
 exports.MobileDeviceAdapter = MobileDeviceAdapter;
+exports.MobileEventStorageAdapter = MobileEventStorageAdapter;
 exports.MobileNetworkAdapter = MobileNetworkAdapter;
 exports.MobileStorageAdapter = MobileStorageAdapter;
 exports.PieChart = PieChart;
@@ -2552,8 +2548,8 @@ exports.TrackClick = TrackClick;
 exports.TrackPerformance = TrackPerformance;
 exports.Uploader = Uploader;
 exports.WebDeviceAdapter = WebDeviceAdapter;
+exports.WebEventStorageAdapter = WebEventStorageAdapter;
 exports.WebNetworkAdapter = WebNetworkAdapter;
-exports.WebStorageAdapter = WebStorageAdapter;
 exports.createAnalytics = createAnalytics;
 exports.createDesktopConfig = createDesktopConfig;
 exports.createMiniappConfig = createMiniappConfig;