@vlian/infrastructure 0.9.10

package/dist/esm/managers/UserManager/modules/PerformanceMonitor.js

@@ -0,0 +1,107 @@
+/**
+ * 性能监控模块
+ * 封装 @vlian/framework MonitoringService，负责性能指标收集和上报
+ */ function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+/**
+ * 性能监控器
+ */ export class PerformanceMonitor {
+    /**
+   * 记录性能指标
+   */ recordMetric(operation, duration, metadata) {
+        const metric = {
+            operation,
+            duration,
+            timestamp: Date.now(),
+            ...metadata
+        };
+        // 添加到指标数组
+        if (this.enableDetailedMetrics) {
+            this.metrics.push(metric);
+            // 限制数组大小
+            if (this.metrics.length > this.maxMetricsSize) {
+                this.metrics.shift();
+            }
+        }
+        // 调用自定义收集器
+        if (this.metricsCollector) {
+            try {
+                this.metricsCollector(metric);
+            } catch (error) {
+            // 收集器错误，忽略
+            }
+        }
+        // 上报到监控服务
+        if (this.monitoring) {
+            try {
+                this.monitoring.reportPerformance({
+                    [`${operation}_duration`]: duration
+                }, metadata);
+            } catch (error) {
+            // 上报失败，忽略
+            }
+        }
+    }
+    /**
+   * 获取性能指标
+   */ getMetrics() {
+        return [
+            ...this.metrics
+        ];
+    }
+    /**
+   * 清除性能指标
+   */ clearMetrics() {
+        this.metrics = [];
+    }
+    /**
+   * 获取性能统计
+   */ getStatistics(operation) {
+        const filteredMetrics = operation ? this.metrics.filter((m)=>m.operation === operation) : this.metrics;
+        if (filteredMetrics.length === 0) {
+            return {
+                count: 0,
+                totalDuration: 0,
+                averageDuration: 0,
+                minDuration: 0,
+                maxDuration: 0
+            };
+        }
+        const durations = filteredMetrics.map((m)=>m.duration);
+        const totalDuration = durations.reduce((sum, d)=>sum + d, 0);
+        const averageDuration = totalDuration / durations.length;
+        const minDuration = Math.min(...durations);
+        const maxDuration = Math.max(...durations);
+        return {
+            count: filteredMetrics.length,
+            totalDuration,
+            averageDuration,
+            minDuration,
+            maxDuration
+        };
+    }
+    constructor(options){
+        _define_property(this, "monitoring", void 0);
+        _define_property(this, "metricsCollector", void 0);
+        _define_property(this, "enableDetailedMetrics", void 0);
+        _define_property(this, "metrics", []);
+        _define_property(this, "maxMetricsSize", 100);
+        this.monitoring = options?.monitoring;
+        this.metricsCollector = options?.metricsCollector;
+        this.enableDetailedMetrics = options?.enableDetailedMetrics ?? false;
+        this.maxMetricsSize = options?.maxMetricsSize ?? 100;
+    }
+}
+
+//# sourceMappingURL=PerformanceMonitor.js.map

package/dist/esm/managers/UserManager/modules/PerformanceMonitor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/UserManager/modules/PerformanceMonitor.ts"],"sourcesContent":["/**\n * 性能监控模块\n * 封装 @vlian/framework MonitoringService，负责性能指标收集和上报\n */\n\nimport type { MonitoringService, PerformanceMetrics } from '../types';\n\n/**\n * 性能监控器\n */\nexport class PerformanceMonitor {\n  private monitoring?: MonitoringService;\n  private metricsCollector?: (metrics: PerformanceMetrics) => void;\n  private enableDetailedMetrics: boolean;\n  private metrics: PerformanceMetrics[] = [];\n  private maxMetricsSize: number = 100;\n\n  constructor(options?: {\n    monitoring?: MonitoringService;\n    metricsCollector?: (metrics: PerformanceMetrics) => void;\n    enableDetailedMetrics?: boolean;\n    maxMetricsSize?: number;\n  }) {\n    this.monitoring = options?.monitoring;\n    this.metricsCollector = options?.metricsCollector;\n    this.enableDetailedMetrics = options?.enableDetailedMetrics ?? false;\n    this.maxMetricsSize = options?.maxMetricsSize ?? 100;\n  }\n\n  /**\n   * 记录性能指标\n   */\n  recordMetric(\n    operation: string,\n    duration: number,\n    metadata?: Record<string, unknown>\n  ): void {\n    const metric: PerformanceMetrics = {\n      operation,\n      duration,\n      timestamp: Date.now(),\n      ...metadata,\n    };\n\n    // 添加到指标数组\n    if (this.enableDetailedMetrics) {\n      this.metrics.push(metric);\n      // 限制数组大小\n      if (this.metrics.length > this.maxMetricsSize) {\n        this.metrics.shift();\n      }\n    }\n\n    // 调用自定义收集器\n    if (this.metricsCollector) {\n      try {\n        this.metricsCollector(metric);\n      } catch (error) {\n        // 收集器错误，忽略\n      }\n    }\n\n    // 上报到监控服务\n    if (this.monitoring) {\n      try {\n        this.monitoring.reportPerformance(\n          {\n            [`${operation}_duration`]: duration,\n          },\n          metadata\n        );\n      } catch (error) {\n        // 上报失败，忽略\n      }\n    }\n  }\n\n  /**\n   * 获取性能指标\n   */\n  getMetrics(): PerformanceMetrics[] {\n    return [...this.metrics];\n  }\n\n  /**\n   * 清除性能指标\n   */\n  clearMetrics(): void {\n    this.metrics = [];\n  }\n\n  /**\n   * 获取性能统计\n   */\n  getStatistics(operation?: string): {\n    count: number;\n    totalDuration: number;\n    averageDuration: number;\n    minDuration: number;\n    maxDuration: number;\n  } {\n    const filteredMetrics = operation\n      ? this.metrics.filter((m) => m.operation === operation)\n      : this.metrics;\n\n    if (filteredMetrics.length === 0) {\n      return {\n        count: 0,\n        totalDuration: 0,\n        averageDuration: 0,\n        minDuration: 0,\n        maxDuration: 0,\n      };\n    }\n\n    const durations = filteredMetrics.map((m) => m.duration);\n    const totalDuration = durations.reduce((sum, d) => sum + d, 0);\n    const averageDuration = totalDuration / durations.length;\n    const minDuration = Math.min(...durations);\n    const maxDuration = Math.max(...durations);\n\n    return {\n      count: filteredMetrics.length,\n      totalDuration,\n      averageDuration,\n      minDuration,\n      maxDuration,\n    };\n  }\n}\n"],"names":["PerformanceMonitor","recordMetric","operation","duration","metadata","metric","timestamp","Date","now","enableDetailedMetrics","metrics","push","length","maxMetricsSize","shift","metricsCollector","error","monitoring","reportPerformance","getMetrics","clearMetrics","getStatistics","filteredMetrics","filter","m","count","totalDuration","averageDuration","minDuration","maxDuration","durations","map","reduce","sum","d","Math","min","max","options"],"mappings":"AAAA;;;CAGC;;;;;;;;;;;;;AAID;;CAEC,GACD,OAAO,MAAMA;IAmBX;;GAEC,GACDC,aACEC,SAAiB,EACjBC,QAAgB,EAChBC,QAAkC,EAC5B;QACN,MAAMC,SAA6B;YACjCH;YACAC;YACAG,WAAWC,KAAKC,GAAG;YACnB,GAAGJ,QAAQ;QACb;QAEA,UAAU;QACV,IAAI,IAAI,CAACK,qBAAqB,EAAE;YAC9B,IAAI,CAACC,OAAO,CAACC,IAAI,CAACN;YAClB,SAAS;YACT,IAAI,IAAI,CAACK,OAAO,CAACE,MAAM,GAAG,IAAI,CAACC,cAAc,EAAE;gBAC7C,IAAI,CAACH,OAAO,CAACI,KAAK;YACpB;QACF;QAEA,WAAW;QACX,IAAI,IAAI,CAACC,gBAAgB,EAAE;YACzB,IAAI;gBACF,IAAI,CAACA,gBAAgB,CAACV;YACxB,EAAE,OAAOW,OAAO;YACd,WAAW;YACb;QACF;QAEA,UAAU;QACV,IAAI,IAAI,CAACC,UAAU,EAAE;YACnB,IAAI;gBACF,IAAI,CAACA,UAAU,CAACC,iBAAiB,CAC/B;oBACE,CAAC,GAAGhB,UAAU,SAAS,CAAC,CAAC,EAAEC;gBAC7B,GACAC;YAEJ,EAAE,OAAOY,OAAO;YACd,UAAU;YACZ;QACF;IACF;IAEA;;GAEC,GACDG,aAAmC;QACjC,OAAO;eAAI,IAAI,CAACT,OAAO;SAAC;IAC1B;IAEA;;GAEC,GACDU,eAAqB;QACnB,IAAI,CAACV,OAAO,GAAG,EAAE;IACnB;IAEA;;GAEC,GACDW,cAAcnB,SAAkB,EAM9B;QACA,MAAMoB,kBAAkBpB,YACpB,IAAI,CAACQ,OAAO,CAACa,MAAM,CAAC,CAACC,IAAMA,EAAEtB,SAAS,KAAKA,aAC3C,IAAI,CAACQ,OAAO;QAEhB,IAAIY,gBAAgBV,MAAM,KAAK,GAAG;YAChC,OAAO;gBACLa,OAAO;gBACPC,eAAe;gBACfC,iBAAiB;gBACjBC,aAAa;gBACbC,aAAa;YACf;QACF;QAEA,MAAMC,YAAYR,gBAAgBS,GAAG,CAAC,CAACP,IAAMA,EAAErB,QAAQ;QACvD,MAAMuB,gBAAgBI,UAAUE,MAAM,CAAC,CAACC,KAAKC,IAAMD,MAAMC,GAAG;QAC5D,MAAMP,kBAAkBD,gBAAgBI,UAAUlB,MAAM;QACxD,MAAMgB,cAAcO,KAAKC,GAAG,IAAIN;QAChC,MAAMD,cAAcM,KAAKE,GAAG,IAAIP;QAEhC,OAAO;YACLL,OAAOH,gBAAgBV,MAAM;YAC7Bc;YACAC;YACAC;YACAC;QACF;IACF;IA/GA,YAAYS,OAKX,CAAE;QAXH,uBAAQrB,cAAR,KAAA;QACA,uBAAQF,oBAAR,KAAA;QACA,uBAAQN,yBAAR,KAAA;QACA,uBAAQC,WAAgC,EAAE;QAC1C,uBAAQG,kBAAyB;QAQ/B,IAAI,CAACI,UAAU,GAAGqB,SAASrB;QAC3B,IAAI,CAACF,gBAAgB,GAAGuB,SAASvB;QACjC,IAAI,CAACN,qBAAqB,GAAG6B,SAAS7B,yBAAyB;QAC/D,IAAI,CAACI,cAAc,GAAGyB,SAASzB,kBAAkB;IACnD;AAsGF"}

package/dist/esm/managers/UserManager/modules/QueueManager.js

@@ -0,0 +1,171 @@
+/**
+ * 队列管理模块
+ * 负责同步队列管理、队列合并优化
+ */ function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+/**
+ * 队列管理器
+ */ export class QueueManager {
+    /**
+   * 添加队列项
+   */ enqueue(type, userId, data) {
+        const item = {
+            type,
+            userId,
+            data,
+            timestamp: Date.now(),
+            retryCount: 0
+        };
+        if (type === 'userInfo') {
+            // 合并相同 userId 的队列项（只保留最新的）
+            const existingIndex = this.userInfoQueue.findIndex((q)=>q.userId === userId);
+            if (existingIndex >= 0) {
+                this.userInfoQueue[existingIndex] = item;
+            } else {
+                this.userInfoQueue.push(item);
+            }
+        } else {
+            // 合并相同 userId 的队列项（只保留最新的）
+            const existingIndex = this.userSettingsQueue.findIndex((q)=>q.userId === userId);
+            if (existingIndex >= 0) {
+                this.userSettingsQueue[existingIndex] = item;
+            } else {
+                this.userSettingsQueue.push(item);
+            }
+        }
+        // 持久化队列
+        if (this.enablePersistence && this.storage) {
+            this.persistQueue().catch(()=>{
+            // 持久化失败，忽略
+            });
+        }
+    }
+    /**
+   * 获取队列项
+   */ dequeue(type) {
+        const queue = type === 'userInfo' ? this.userInfoQueue : this.userSettingsQueue;
+        if (queue.length === 0) {
+            return null;
+        }
+        const item = queue.shift();
+        // 持久化队列
+        if (this.enablePersistence && this.storage) {
+            this.persistQueue().catch(()=>{
+            // 持久化失败，忽略
+            });
+        }
+        return item;
+    }
+    /**
+   * 获取队列大小
+   */ getQueueSize(type) {
+        return type === 'userInfo' ? this.userInfoQueue.length : this.userSettingsQueue.length;
+    }
+    /**
+   * 获取所有队列项（不删除）
+   */ peekAll(type) {
+        return type === 'userInfo' ? [
+            ...this.userInfoQueue
+        ] : [
+            ...this.userSettingsQueue
+        ];
+    }
+    /**
+   * 清除队列
+   */ clear(type) {
+        if (type) {
+            if (type === 'userInfo') {
+                this.userInfoQueue = [];
+            } else {
+                this.userSettingsQueue = [];
+            }
+        } else {
+            this.userInfoQueue = [];
+            this.userSettingsQueue = [];
+        }
+        // 持久化队列
+        if (this.enablePersistence && this.storage) {
+            this.persistQueue().catch(()=>{
+            // 持久化失败，忽略
+            });
+        }
+    }
+    /**
+   * 增加重试次数
+   */ incrementRetryCount(item) {
+        item.retryCount++;
+    }
+    /**
+   * 持久化队列到存储
+   */ async persistQueue() {
+        if (!this.storage) {
+            return;
+        }
+        try {
+            const queueData = {
+                userInfo: this.userInfoQueue,
+                userSettings: this.userSettingsQueue,
+                timestamp: Date.now()
+            };
+            await this.storage.set(this.storageKey, JSON.stringify(queueData));
+        } catch (error) {
+        // 持久化失败，忽略
+        }
+    }
+    /**
+   * 从存储恢复队列
+   */ async restoreQueue() {
+        if (!this.storage) {
+            return;
+        }
+        try {
+            const queueDataStr = await this.storage.get(this.storageKey);
+            if (!queueDataStr) {
+                return;
+            }
+            const queueData = JSON.parse(queueDataStr);
+            // 只恢复最近 24 小时内的队列项
+            const oneDayAgo = Date.now() - 24 * 60 * 60 * 1000;
+            if (queueData.timestamp < oneDayAgo) {
+                // 队列太旧，清除
+                await this.storage.remove(this.storageKey);
+                return;
+            }
+            this.userInfoQueue = queueData.userInfo || [];
+            this.userSettingsQueue = queueData.userSettings || [];
+        } catch (error) {
+            // 恢复失败，使用空队列
+            this.userInfoQueue = [];
+            this.userSettingsQueue = [];
+        }
+    }
+    constructor(options){
+        _define_property(this, "userInfoQueue", []);
+        _define_property(this, "userSettingsQueue", []);
+        _define_property(this, "storage", void 0);
+        _define_property(this, "storageKey", void 0);
+        _define_property(this, "enablePersistence", void 0);
+        this.storage = options?.storage;
+        this.storageKey = options?.storageKey || 'user_sync_queue';
+        this.enablePersistence = options?.enablePersistence ?? false;
+        // 如果启用了持久化，从存储中恢复队列
+        if (this.enablePersistence && this.storage) {
+            this.restoreQueue().catch(()=>{
+            // 恢复失败，使用空队列
+            });
+        }
+    }
+}
+
+//# sourceMappingURL=QueueManager.js.map

package/dist/esm/managers/UserManager/modules/QueueManager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/UserManager/modules/QueueManager.ts"],"sourcesContent":["/**\n * 队列管理模块\n * 负责同步队列管理、队列合并优化\n */\n\nimport type { StorageInstance } from '../types';\n\n/**\n * 队列项\n */\ninterface QueueItem {\n  type: 'userInfo' | 'userSettings';\n  userId: string;\n  data: unknown;\n  timestamp: number;\n  retryCount: number;\n}\n\n/**\n * 队列管理器\n */\nexport class QueueManager {\n  private userInfoQueue: QueueItem[] = [];\n  private userSettingsQueue: QueueItem[] = [];\n  private storage?: StorageInstance;\n  private storageKey: string;\n  private enablePersistence: boolean;\n\n  constructor(options?: {\n    storage?: StorageInstance;\n    storageKey?: string;\n    enablePersistence?: boolean;\n  }) {\n    this.storage = options?.storage;\n    this.storageKey = options?.storageKey || 'user_sync_queue';\n    this.enablePersistence = options?.enablePersistence ?? false;\n    \n    // 如果启用了持久化，从存储中恢复队列\n    if (this.enablePersistence && this.storage) {\n      this.restoreQueue().catch(() => {\n        // 恢复失败，使用空队列\n      });\n    }\n  }\n\n  /**\n   * 添加队列项\n   */\n  enqueue(type: 'userInfo' | 'userSettings', userId: string, data: unknown): void {\n    const item: QueueItem = {\n      type,\n      userId,\n      data,\n      timestamp: Date.now(),\n      retryCount: 0,\n    };\n\n    if (type === 'userInfo') {\n      // 合并相同 userId 的队列项（只保留最新的）\n      const existingIndex = this.userInfoQueue.findIndex(\n        (q) => q.userId === userId\n      );\n      if (existingIndex >= 0) {\n        this.userInfoQueue[existingIndex] = item;\n      } else {\n        this.userInfoQueue.push(item);\n      }\n    } else {\n      // 合并相同 userId 的队列项（只保留最新的）\n      const existingIndex = this.userSettingsQueue.findIndex(\n        (q) => q.userId === userId\n      );\n      if (existingIndex >= 0) {\n        this.userSettingsQueue[existingIndex] = item;\n      } else {\n        this.userSettingsQueue.push(item);\n      }\n    }\n\n    // 持久化队列\n    if (this.enablePersistence && this.storage) {\n      this.persistQueue().catch(() => {\n        // 持久化失败，忽略\n      });\n    }\n  }\n\n  /**\n   * 获取队列项\n   */\n  dequeue(type: 'userInfo' | 'userSettings'): QueueItem | null {\n    const queue = type === 'userInfo' ? this.userInfoQueue : this.userSettingsQueue;\n    if (queue.length === 0) {\n      return null;\n    }\n\n    const item = queue.shift()!;\n    \n    // 持久化队列\n    if (this.enablePersistence && this.storage) {\n      this.persistQueue().catch(() => {\n        // 持久化失败，忽略\n      });\n    }\n\n    return item;\n  }\n\n  /**\n   * 获取队列大小\n   */\n  getQueueSize(type: 'userInfo' | 'userSettings'): number {\n    return type === 'userInfo' \n      ? this.userInfoQueue.length \n      : this.userSettingsQueue.length;\n  }\n\n  /**\n   * 获取所有队列项（不删除）\n   */\n  peekAll(type: 'userInfo' | 'userSettings'): QueueItem[] {\n    return type === 'userInfo' \n      ? [...this.userInfoQueue] \n      : [...this.userSettingsQueue];\n  }\n\n  /**\n   * 清除队列\n   */\n  clear(type?: 'userInfo' | 'userSettings'): void {\n    if (type) {\n      if (type === 'userInfo') {\n        this.userInfoQueue = [];\n      } else {\n        this.userSettingsQueue = [];\n      }\n    } else {\n      this.userInfoQueue = [];\n      this.userSettingsQueue = [];\n    }\n\n    // 持久化队列\n    if (this.enablePersistence && this.storage) {\n      this.persistQueue().catch(() => {\n        // 持久化失败，忽略\n      });\n    }\n  }\n\n  /**\n   * 增加重试次数\n   */\n  incrementRetryCount(item: QueueItem): void {\n    item.retryCount++;\n  }\n\n  /**\n   * 持久化队列到存储\n   */\n  private async persistQueue(): Promise<void> {\n    if (!this.storage) {\n      return;\n    }\n\n    try {\n      const queueData = {\n        userInfo: this.userInfoQueue,\n        userSettings: this.userSettingsQueue,\n        timestamp: Date.now(),\n      };\n      await this.storage.set(this.storageKey, JSON.stringify(queueData));\n    } catch (error) {\n      // 持久化失败，忽略\n    }\n  }\n\n  /**\n   * 从存储恢复队列\n   */\n  private async restoreQueue(): Promise<void> {\n    if (!this.storage) {\n      return;\n    }\n\n    try {\n      const queueDataStr = await this.storage.get(this.storageKey);\n      if (!queueDataStr) {\n        return;\n      }\n\n      const queueData = JSON.parse(queueDataStr) as {\n        userInfo: QueueItem[];\n        userSettings: QueueItem[];\n        timestamp: number;\n      };\n\n      // 只恢复最近 24 小时内的队列项\n      const oneDayAgo = Date.now() - 24 * 60 * 60 * 1000;\n      if (queueData.timestamp < oneDayAgo) {\n        // 队列太旧，清除\n        await this.storage.remove(this.storageKey);\n        return;\n      }\n\n      this.userInfoQueue = queueData.userInfo || [];\n      this.userSettingsQueue = queueData.userSettings || [];\n    } catch (error) {\n      // 恢复失败，使用空队列\n      this.userInfoQueue = [];\n      this.userSettingsQueue = [];\n    }\n  }\n}\n"],"names":["QueueManager","enqueue","type","userId","data","item","timestamp","Date","now","retryCount","existingIndex","userInfoQueue","findIndex","q","push","userSettingsQueue","enablePersistence","storage","persistQueue","catch","dequeue","queue","length","shift","getQueueSize","peekAll","clear","incrementRetryCount","queueData","userInfo","userSettings","set","storageKey","JSON","stringify","error","restoreQueue","queueDataStr","get","parse","oneDayAgo","remove","options"],"mappings":"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"}

package/dist/esm/managers/UserManager/modules/StateManager.js

@@ -0,0 +1,145 @@
+/**
+ * 状态管理模块
+ * 封装 @vlian/framework StateManager，负责状态管理实例初始化
+ */ function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+/**
+ * 状态管理器封装
+ */ export class StateManagerWrapper {
+    /**
+   * 初始化状态管理实例
+   */ initStateManager(instance) {
+        if (instance) {
+            return instance;
+        }
+        // 如果没有提供实例，尝试从 @vlian/framework 获取
+        try {
+            let stateManagerModule;
+            // 1. 检查全局变量
+            if (typeof globalThis !== 'undefined') {
+                const global = globalThis;
+                stateManagerModule = global.window?.vlianFramework || global.vlianFramework;
+            }
+            // 2. 如果全局变量不存在，尝试使用 require
+            if (!stateManagerModule && typeof require !== 'undefined') {
+                try {
+                    // eslint-disable-next-line @typescript-eslint/no-require-imports
+                    stateManagerModule = require('@vlian/framework');
+                } catch  {
+                // require 失败，使用内存存储
+                }
+            }
+            if (stateManagerModule) {
+                const stateManager = stateManagerModule.stateManager || stateManagerModule.default?.stateManager;
+                if (stateManager) {
+                    return stateManager;
+                }
+            }
+        } catch (error) {
+            this.logger?.warn('Failed to initialize StateManager, using memory storage:', error);
+        }
+        // 如果没有找到，返回 null，使用内存存储
+        return null;
+    }
+    /**
+   * 获取键名（带命名空间）
+   */ getKey(key) {
+        return `${this.namespace}:${key}`;
+    }
+    /**
+   * 获取值
+   */ get(key) {
+        const fullKey = this.getKey(key);
+        if (this.stateManager) {
+            return this.stateManager.get(fullKey);
+        }
+        // 使用内存存储
+        const value = this.memoryStore.get(fullKey);
+        return value;
+    }
+    /**
+   * 设置值
+   */ set(key, value) {
+        const fullKey = this.getKey(key);
+        if (this.stateManager) {
+            this.stateManager.set(fullKey, value);
+        } else {
+            // 使用内存存储
+            this.memoryStore.set(fullKey, value);
+            // 通知订阅者
+            const subscribers = this.subscribers.get(fullKey);
+            if (subscribers) {
+                subscribers.forEach((callback)=>{
+                    try {
+                        callback(value);
+                    } catch (error) {
+                        this.logger?.error(`Error in state subscriber for ${fullKey}:`, error);
+                    }
+                });
+            }
+        }
+    }
+    /**
+   * 删除值
+   */ remove(key) {
+        const fullKey = this.getKey(key);
+        if (this.stateManager) {
+            this.stateManager.remove(fullKey);
+        } else {
+            // 使用内存存储
+            this.memoryStore.delete(fullKey);
+            this.subscribers.delete(fullKey);
+        }
+    }
+    /**
+   * 订阅值变化
+   */ subscribe(key, callback) {
+        const fullKey = this.getKey(key);
+        if (this.stateManager) {
+            return this.stateManager.subscribe(fullKey, callback);
+        }
+        // 使用内存存储
+        const subscribers = this.subscribers.get(fullKey) || new Set();
+        subscribers.add(callback);
+        this.subscribers.set(fullKey, subscribers);
+        // 返回取消订阅函数
+        return ()=>{
+            const currentSubscribers = this.subscribers.get(fullKey);
+            if (currentSubscribers) {
+                currentSubscribers.delete(callback);
+                if (currentSubscribers.size === 0) {
+                    this.subscribers.delete(fullKey);
+                }
+            }
+        };
+    }
+    /**
+   * 获取状态管理实例（用于健康检查等）
+   */ getStateManager() {
+        return this.stateManager;
+    }
+    constructor(options){
+        _define_property(this, "stateManager", null);
+        _define_property(this, "namespace", void 0);
+        _define_property(this, "logger", void 0);
+        // 内存存储（当没有提供 StateManager 时使用）
+        _define_property(this, "memoryStore", new Map());
+        _define_property(this, "subscribers", new Map());
+        this.logger = options.logger;
+        this.namespace = options.stateManager?.namespace || 'user_info';
+        this.stateManager = this.initStateManager(options.stateManager?.instance);
+    }
+}
+
+//# sourceMappingURL=StateManager.js.map

package/dist/esm/managers/UserManager/modules/StateManager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/UserManager/modules/StateManager.ts"],"sourcesContent":["/**\n * 状态管理模块\n * 封装 @vlian/framework StateManager，负责状态管理实例初始化\n */\n\nimport type { StateManagerInstance } from '../types';\n\n/**\n * 状态管理器封装\n */\nexport class StateManagerWrapper {\n  private stateManager: StateManagerInstance | null = null;\n  private namespace: string;\n  private logger?: { warn: (message: string, ...args: unknown[]) => void; error: (message: string, ...args: unknown[]) => void };\n  \n  // 内存存储（当没有提供 StateManager 时使用）\n  private memoryStore: Map<string, unknown> = new Map();\n  private subscribers: Map<string, Set<(value: unknown) => void>> = new Map();\n\n  constructor(\n    options: {\n      stateManager?: { instance?: StateManagerInstance; namespace?: string };\n      logger?: { warn: (message: string, ...args: unknown[]) => void; error: (message: string, ...args: unknown[]) => void };\n    }\n  ) {\n    this.logger = options.logger;\n    this.namespace = options.stateManager?.namespace || 'user_info';\n    this.stateManager = this.initStateManager(options.stateManager?.instance);\n  }\n\n  /**\n   * 初始化状态管理实例\n   */\n  private initStateManager(instance?: StateManagerInstance): StateManagerInstance | null {\n    if (instance) {\n      return instance;\n    }\n\n    // 如果没有提供实例，尝试从 @vlian/framework 获取\n    try {\n      let stateManagerModule: any;\n      \n      // 1. 检查全局变量\n      if (typeof globalThis !== 'undefined') {\n        const global = globalThis as any;\n        stateManagerModule = global.window?.vlianFramework || global.vlianFramework;\n      }\n      \n      // 2. 如果全局变量不存在，尝试使用 require\n      if (!stateManagerModule && typeof require !== 'undefined') {\n        try {\n          // eslint-disable-next-line @typescript-eslint/no-require-imports\n          stateManagerModule = require('@vlian/framework');\n        } catch {\n          // require 失败，使用内存存储\n        }\n      }\n      \n      if (stateManagerModule) {\n        const stateManager = stateManagerModule.stateManager || stateManagerModule.default?.stateManager;\n        if (stateManager) {\n          return stateManager;\n        }\n      }\n    } catch (error) {\n      this.logger?.warn('Failed to initialize StateManager, using memory storage:', error);\n    }\n\n    // 如果没有找到，返回 null，使用内存存储\n    return null;\n  }\n\n  /**\n   * 获取键名（带命名空间）\n   */\n  private getKey(key: string): string {\n    return `${this.namespace}:${key}`;\n  }\n\n  /**\n   * 获取值\n   */\n  get<T>(key: string): T | null {\n    const fullKey = this.getKey(key);\n    \n    if (this.stateManager) {\n      return this.stateManager.get<T>(fullKey);\n    }\n    \n    // 使用内存存储\n    const value = this.memoryStore.get(fullKey);\n    return value as T | null;\n  }\n\n  /**\n   * 设置值\n   */\n  set<T>(key: string, value: T): void {\n    const fullKey = this.getKey(key);\n    \n    if (this.stateManager) {\n      this.stateManager.set(fullKey, value);\n    } else {\n      // 使用内存存储\n      this.memoryStore.set(fullKey, value);\n      // 通知订阅者\n      const subscribers = this.subscribers.get(fullKey);\n      if (subscribers) {\n        subscribers.forEach((callback) => {\n          try {\n            callback(value);\n          } catch (error) {\n            this.logger?.error(`Error in state subscriber for ${fullKey}:`, error);\n          }\n        });\n      }\n    }\n  }\n\n  /**\n   * 删除值\n   */\n  remove(key: string): void {\n    const fullKey = this.getKey(key);\n    \n    if (this.stateManager) {\n      this.stateManager.remove(fullKey);\n    } else {\n      // 使用内存存储\n      this.memoryStore.delete(fullKey);\n      this.subscribers.delete(fullKey);\n    }\n  }\n\n  /**\n   * 订阅值变化\n   */\n  subscribe<T>(key: string, callback: (value: T) => void): () => void {\n    const fullKey = this.getKey(key);\n    \n    if (this.stateManager) {\n      return this.stateManager.subscribe(fullKey, callback);\n    }\n    \n    // 使用内存存储\n    const subscribers = this.subscribers.get(fullKey) || new Set();\n    subscribers.add(callback as (value: unknown) => void);\n    this.subscribers.set(fullKey, subscribers);\n    \n    // 返回取消订阅函数\n    return () => {\n      const currentSubscribers = this.subscribers.get(fullKey);\n      if (currentSubscribers) {\n        currentSubscribers.delete(callback as (value: unknown) => void);\n        if (currentSubscribers.size === 0) {\n          this.subscribers.delete(fullKey);\n        }\n      }\n    };\n  }\n\n  /**\n   * 获取状态管理实例（用于健康检查等）\n   */\n  getStateManager(): StateManagerInstance | null {\n    return this.stateManager;\n  }\n}\n"],"names":["StateManagerWrapper","initStateManager","instance","stateManagerModule","globalThis","global","window","vlianFramework","require","stateManager","default","error","logger","warn","getKey","key","namespace","get","fullKey","value","memoryStore","set","subscribers","forEach","callback","remove","delete","subscribe","Set","add","currentSubscribers","size","getStateManager","options","Map"],"mappings":"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"}

package/dist/esm/managers/UserManager/modules/StorageManager.js

@@ -0,0 +1,146 @@
+/**
+ * 存储管理模块
+ * 封装 @vlian/framework Storage，负责存储实例初始化
+ */ function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+import { UserError, UserErrorCode } from "../types";
+/**
+ * 存储管理器
+ */ export class StorageManager {
+    /**
+   * 初始化存储实例（带缓存优化）
+   */ initStorage(storageConfig) {
+        // 如果直接提供了实例，直接使用（最快路径）
+        if (storageConfig.instance) {
+            return storageConfig.instance;
+        }
+        // 如果没有提供实例，尝试从 @vlian/framework 获取
+        const strategy = storageConfig.strategy || 'local';
+        const cacheKey = `${strategy}_${this.environment}`;
+        // 检查缓存
+        if (StorageManager.storageCache.has(cacheKey)) {
+            return StorageManager.storageCache.get(cacheKey);
+        }
+        try {
+            // SSR 环境特殊处理
+            if (this.environment === 'ssr') {
+                // SSR 环境应该使用内存存储
+                const data = new Map();
+                const memoryStorage = {
+                    async get (key) {
+                        return data.get(key) || null;
+                    },
+                    async set (key, value) {
+                        data.set(key, value);
+                    },
+                    async remove (key) {
+                        data.delete(key);
+                    }
+                };
+                StorageManager.storageCache.set(cacheKey, memoryStorage);
+                return memoryStorage;
+            }
+            // Worker 环境特殊处理
+            if (this.environment === 'worker') {
+                // Worker 环境不支持 localStorage，使用 IndexedDB 或内存存储
+                if (strategy === 'local' || strategy === 'session') {
+                    this.logger?.warn(`${strategy} storage is not available in Worker environment, falling back to memory storage`);
+                    const data = new Map();
+                    const memoryStorage = {
+                        async get (key) {
+                            return data.get(key) || null;
+                        },
+                        async set (key, value) {
+                            data.set(key, value);
+                        },
+                        async remove (key) {
+                            data.delete(key);
+                        }
+                    };
+                    StorageManager.storageCache.set(cacheKey, memoryStorage);
+                    return memoryStorage;
+                }
+            }
+            // 优化的获取逻辑：按优先级检查
+            let storageModule;
+            // 1. 检查全局变量（最快，无需动态导入）
+            if (typeof globalThis !== 'undefined') {
+                const global = globalThis;
+                storageModule = global.window?.vlianFramework || global.vlianFramework;
+            }
+            // 2. 如果全局变量不存在，尝试使用 require（仅 Node.js/CommonJS 环境）
+            if (!storageModule && typeof require !== 'undefined') {
+                try {
+                    // eslint-disable-next-line @typescript-eslint/no-require-imports
+                    storageModule = require('@vlian/framework');
+                } catch  {
+                // require 失败，继续抛出错误
+                }
+            }
+            // 如果仍然没有找到，抛出错误
+            if (!storageModule) {
+                throw new UserError('@vlian/framework is not available. ' + 'Please provide storage.instance or ensure @vlian/framework is installed and accessible.', UserErrorCode.STORAGE_ERROR);
+            }
+            // 获取 storage 对象（优化：减少属性访问）
+            const storage = storageModule.storage || storageModule.default?.storage;
+            if (!storage) {
+                throw new UserError('Storage not found in @vlian/framework', UserErrorCode.STORAGE_ERROR);
+            }
+            // 根据策略返回对应的存储实例（优化：使用映射表）
+            const strategyMap = {
+                local: storage.local,
+                session: storage.session,
+                indexedDB: storage.indexedDB
+            };
+            const storageInstance = strategyMap[strategy] || storage.local || storage;
+            // 缓存存储实例
+            StorageManager.storageCache.set(cacheKey, storageInstance);
+            return storageInstance;
+        } catch (error) {
+            throw new UserError(`Failed to initialize storage: ${error instanceof Error ? error.message : String(error)}. ` + 'Please provide storage.instance or ensure @vlian/framework is installed and provides storage API.', UserErrorCode.STORAGE_ERROR, undefined, error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+   * 获取存储实例
+   */ getStorage() {
+        return this.storage;
+    }
+    /**
+   * 获取值
+   */ async get(key) {
+        return this.storage.get(key);
+    }
+    /**
+   * 设置值
+   */ async set(key, value) {
+        return this.storage.set(key, value);
+    }
+    /**
+   * 删除值
+   */ async remove(key) {
+        return this.storage.remove(key);
+    }
+    constructor(options){
+        _define_property(this, "storage", void 0);
+        _define_property(this, "environment", void 0);
+        _define_property(this, "logger", void 0);
+        this.environment = options.environment;
+        this.logger = options.logger;
+        this.storage = this.initStorage(options.storage);
+    }
+}
+// 存储初始化缓存（优化性能）
+_define_property(StorageManager, "storageCache", new Map());
+
+//# sourceMappingURL=StorageManager.js.map

package/dist/esm/managers/UserManager/modules/StorageManager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/UserManager/modules/StorageManager.ts"],"sourcesContent":["/**\n * 存储管理模块\n * 封装 @vlian/framework Storage，负责存储实例初始化\n */\n\nimport type { StorageInstance, StorageStrategy, Environment } from '../types';\nimport { UserError, UserErrorCode } from '../types';\n\n/**\n * 存储管理器\n */\nexport class StorageManager {\n  private storage: StorageInstance;\n  private environment: Environment;\n  private logger?: { warn: (message: string, ...args: unknown[]) => void; error: (message: string, ...args: unknown[]) => void };\n  \n  // 存储初始化缓存（优化性能）\n  private static storageCache: Map<string, StorageInstance> = new Map();\n\n  constructor(\n    options: {\n      storage: { instance?: StorageInstance; strategy?: StorageStrategy };\n      environment: Environment;\n      logger?: { warn: (message: string, ...args: unknown[]) => void; error: (message: string, ...args: unknown[]) => void };\n    }\n  ) {\n    this.environment = options.environment;\n    this.logger = options.logger;\n    this.storage = this.initStorage(options.storage);\n  }\n\n  /**\n   * 初始化存储实例（带缓存优化）\n   */\n  private initStorage(storageConfig: { instance?: StorageInstance; strategy?: StorageStrategy }): StorageInstance {\n    // 如果直接提供了实例，直接使用（最快路径）\n    if (storageConfig.instance) {\n      return storageConfig.instance;\n    }\n\n    // 如果没有提供实例，尝试从 @vlian/framework 获取\n    const strategy = storageConfig.strategy || 'local';\n    const cacheKey = `${strategy}_${this.environment}`;\n    \n    // 检查缓存\n    if (StorageManager.storageCache.has(cacheKey)) {\n      return StorageManager.storageCache.get(cacheKey)!;\n    }\n    \n    try {\n      // SSR 环境特殊处理\n      if (this.environment === 'ssr') {\n        // SSR 环境应该使用内存存储\n        const data = new Map<string, string>();\n        const memoryStorage: StorageInstance = {\n          async get(key: string): Promise<string | null> {\n            return data.get(key) || null;\n          },\n          async set(key: string, value: string): Promise<void> {\n            data.set(key, value);\n          },\n          async remove(key: string): Promise<void> {\n            data.delete(key);\n          },\n        };\n        StorageManager.storageCache.set(cacheKey, memoryStorage);\n        return memoryStorage;\n      }\n\n      // Worker 环境特殊处理\n      if (this.environment === 'worker') {\n        // Worker 环境不支持 localStorage，使用 IndexedDB 或内存存储\n        if (strategy === 'local' || strategy === 'session') {\n          this.logger?.warn(\n            `${strategy} storage is not available in Worker environment, falling back to memory storage`\n          );\n          const data = new Map<string, string>();\n          const memoryStorage: StorageInstance = {\n            async get(key: string): Promise<string | null> {\n              return data.get(key) || null;\n            },\n            async set(key: string, value: string): Promise<void> {\n              data.set(key, value);\n            },\n            async remove(key: string): Promise<void> {\n              data.delete(key);\n            },\n          };\n          StorageManager.storageCache.set(cacheKey, memoryStorage);\n          return memoryStorage;\n        }\n      }\n\n      // 优化的获取逻辑：按优先级检查\n      let storageModule: any;\n      \n      // 1. 检查全局变量（最快，无需动态导入）\n      if (typeof globalThis !== 'undefined') {\n        const global = globalThis as any;\n        storageModule = global.window?.vlianFramework || global.vlianFramework;\n      }\n      \n      // 2. 如果全局变量不存在，尝试使用 require（仅 Node.js/CommonJS 环境）\n      if (!storageModule && typeof require !== 'undefined') {\n        try {\n          // eslint-disable-next-line @typescript-eslint/no-require-imports\n          storageModule = require('@vlian/framework');\n        } catch {\n          // require 失败，继续抛出错误\n        }\n      }\n      \n      // 如果仍然没有找到，抛出错误\n      if (!storageModule) {\n        throw new UserError(\n          '@vlian/framework is not available. ' +\n          'Please provide storage.instance or ensure @vlian/framework is installed and accessible.',\n          UserErrorCode.STORAGE_ERROR\n        );\n      }\n      \n      // 获取 storage 对象（优化：减少属性访问）\n      const storage = storageModule.storage || storageModule.default?.storage;\n      if (!storage) {\n        throw new UserError(\n          'Storage not found in @vlian/framework',\n          UserErrorCode.STORAGE_ERROR\n        );\n      }\n      \n      // 根据策略返回对应的存储实例（优化：使用映射表）\n      const strategyMap: Record<string, StorageInstance | undefined> = {\n        local: storage.local,\n        session: storage.session,\n        indexedDB: storage.indexedDB,\n      };\n      \n      const storageInstance = strategyMap[strategy] || storage.local || storage;\n      \n      // 缓存存储实例\n      StorageManager.storageCache.set(cacheKey, storageInstance);\n      \n      return storageInstance;\n    } catch (error) {\n      throw new UserError(\n        `Failed to initialize storage: ${error instanceof Error ? error.message : String(error)}. ` +\n        'Please provide storage.instance or ensure @vlian/framework is installed and provides storage API.',\n        UserErrorCode.STORAGE_ERROR,\n        undefined,\n        error instanceof Error ? error : new Error(String(error))\n      );\n    }\n  }\n\n  /**\n   * 获取存储实例\n   */\n  getStorage(): StorageInstance {\n    return this.storage;\n  }\n\n  /**\n   * 获取值\n   */\n  async get(key: string): Promise<string | null> {\n    return this.storage.get(key);\n  }\n\n  /**\n   * 设置值\n   */\n  async set(key: string, value: string): Promise<void> {\n    return this.storage.set(key, value);\n  }\n\n  /**\n   * 删除值\n   */\n  async remove(key: string): Promise<void> {\n    return this.storage.remove(key);\n  }\n}\n"],"names":["UserError","UserErrorCode","StorageManager","initStorage","storageConfig","instance","strategy","cacheKey","environment","storageCache","has","get","data","Map","memoryStorage","key","set","value","remove","delete","logger","warn","storageModule","globalThis","global","window","vlianFramework","require","STORAGE_ERROR","storage","default","strategyMap","local","session","indexedDB","storageInstance","error","Error","message","String","undefined","getStorage","options"],"mappings":"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"}