@vlian/infrastructure 0.9.10

package/dist/cjs/managers/UserManager/runtime/SyncManager.js

@@ -0,0 +1,256 @@
+/**
+ * 数据同步管理模块
+ * 负责用户信息/设置同步到服务器、同步队列管理、同步失败重试
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "SyncManager", {
+    enumerable: true,
+    get: function() {
+        return SyncManager;
+    }
+});
+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;
+}
+let SyncManager = class SyncManager {
+    /**
+   * 同步用户信息
+   */ async syncUserInfo(userId, userInfo) {
+        if (!this.userInfoUpdater) {
+            this.logger?.warn('userInfoUpdater is not provided, skipping sync');
+            return;
+        }
+        if (this.syncStrategy === 'immediate') {
+            return this.syncUserInfoImmediate(userId, userInfo);
+        } else if (this.syncStrategy === 'batch') {
+            return this.syncUserInfoBatch(userId, userInfo);
+        } else {
+            // queue 策略
+            this.queueManager.enqueue('userInfo', userId, userInfo);
+            // 异步触发同步
+            this.triggerSync().catch(()=>{
+            // 同步失败，忽略
+            });
+        }
+    }
+    /**
+   * 同步用户设置
+   */ async syncUserSettings(userId, settings) {
+        if (!this.userSettingsUpdater) {
+            this.logger?.warn('userSettingsUpdater is not provided, skipping sync');
+            return;
+        }
+        if (this.syncStrategy === 'immediate') {
+            return this.syncUserSettingsImmediate(userId, settings);
+        } else if (this.syncStrategy === 'batch') {
+            return this.syncUserSettingsBatch(userId, settings);
+        } else {
+            // queue 策略
+            this.queueManager.enqueue('userSettings', userId, settings);
+            // 异步触发同步
+            this.triggerSync().catch(()=>{
+            // 同步失败，忽略
+            });
+        }
+    }
+    /**
+   * 立即同步用户信息
+   */ async syncUserInfoImmediate(userId, userInfo) {
+        const startTime = Date.now();
+        try {
+            await this.userInfoUpdater(userId, userInfo);
+            const duration = Date.now() - startTime;
+            this.performanceMonitor.recordMetric('sync_user_info', duration, {
+                userId
+            });
+            this.lastSyncTime = Date.now();
+            this.failedCount = 0;
+        } catch (error) {
+            const duration = Date.now() - startTime;
+            this.performanceMonitor.recordMetric('sync_user_info', duration, {
+                userId,
+                error: true
+            });
+            this.failedCount++;
+            throw this.errorHandler.handleError(error, {
+                operation: 'syncUserInfo',
+                userId
+            });
+        }
+    }
+    /**
+   * 批量同步用户信息
+   */ async syncUserInfoBatch(userId, userInfo) {
+        // 添加到队列
+        this.queueManager.enqueue('userInfo', userId, userInfo);
+        // 清除之前的定时器
+        if (this.batchSyncTimer) {
+            clearTimeout(this.batchSyncTimer);
+        }
+        // 设置延迟同步
+        this.batchSyncTimer = setTimeout(()=>{
+            this.batchSyncTimer = null;
+            this.processBatchSync().catch(()=>{
+            // 批量同步失败，忽略
+            });
+        }, this.batchSyncDelay);
+    }
+    /**
+   * 立即同步用户设置
+   */ async syncUserSettingsImmediate(userId, settings) {
+        const startTime = Date.now();
+        try {
+            await this.userSettingsUpdater(userId, settings);
+            const duration = Date.now() - startTime;
+            this.performanceMonitor.recordMetric('sync_user_settings', duration, {
+                userId
+            });
+            this.lastSyncTime = Date.now();
+            this.failedCount = 0;
+        } catch (error) {
+            const duration = Date.now() - startTime;
+            this.performanceMonitor.recordMetric('sync_user_settings', duration, {
+                userId,
+                error: true
+            });
+            this.failedCount++;
+            throw this.errorHandler.handleError(error, {
+                operation: 'syncUserSettings',
+                userId
+            });
+        }
+    }
+    /**
+   * 批量同步用户设置
+   */ async syncUserSettingsBatch(userId, settings) {
+        // 添加到队列
+        this.queueManager.enqueue('userSettings', userId, settings);
+        // 清除之前的定时器
+        if (this.batchSyncTimer) {
+            clearTimeout(this.batchSyncTimer);
+        }
+        // 设置延迟同步
+        this.batchSyncTimer = setTimeout(()=>{
+            this.batchSyncTimer = null;
+            this.processBatchSync().catch(()=>{
+            // 批量同步失败，忽略
+            });
+        }, this.batchSyncDelay);
+    }
+    /**
+   * 处理批量同步
+   */ async processBatchSync() {
+        if (this.isSyncing) {
+            return;
+        }
+        this.isSyncing = true;
+        try {
+            // 处理用户信息队列
+            while(this.queueManager.getQueueSize('userInfo') > 0){
+                const item = this.queueManager.dequeue('userInfo');
+                if (item && this.userInfoUpdater) {
+                    try {
+                        await this.syncUserInfoImmediate(item.userId, item.data);
+                    } catch (error) {
+                        // 同步失败，如果重试次数未超限，重新入队
+                        if (item.retryCount < this.syncRetryConfig.maxRetries) {
+                            this.queueManager.incrementRetryCount(item);
+                            this.queueManager.enqueue('userInfo', item.userId, item.data);
+                        }
+                    }
+                }
+            }
+            // 处理用户设置队列
+            while(this.queueManager.getQueueSize('userSettings') > 0){
+                const item = this.queueManager.dequeue('userSettings');
+                if (item && this.userSettingsUpdater) {
+                    try {
+                        await this.syncUserSettingsImmediate(item.userId, item.data);
+                    } catch (error) {
+                        // 同步失败，如果重试次数未超限，重新入队
+                        if (item.retryCount < this.syncRetryConfig.maxRetries) {
+                            this.queueManager.incrementRetryCount(item);
+                            this.queueManager.enqueue('userSettings', item.userId, item.data);
+                        }
+                    }
+                }
+            }
+        } finally{
+            this.isSyncing = false;
+        }
+    }
+    /**
+   * 触发同步（队列策略）
+   */ async triggerSync() {
+        if (this.isSyncing) {
+            return;
+        }
+        await this.processBatchSync();
+    }
+    /**
+   * 同步所有待同步的数据
+   */ async syncAll() {
+        if (this.isSyncing) {
+            return;
+        }
+        await this.processBatchSync();
+    }
+    /**
+   * 获取同步队列状态
+   */ getSyncQueueStatus() {
+        return {
+            pendingUserInfo: this.queueManager.getQueueSize('userInfo'),
+            pendingUserSettings: this.queueManager.getQueueSize('userSettings'),
+            isSyncing: this.isSyncing,
+            lastSyncTime: this.lastSyncTime,
+            failedCount: this.failedCount
+        };
+    }
+    /**
+   * 清理资源
+   */ destroy() {
+        if (this.batchSyncTimer) {
+            clearTimeout(this.batchSyncTimer);
+            this.batchSyncTimer = null;
+        }
+    }
+    constructor(options){
+        _define_property(this, "queueManager", void 0);
+        _define_property(this, "errorHandler", void 0);
+        _define_property(this, "performanceMonitor", void 0);
+        _define_property(this, "logger", void 0);
+        _define_property(this, "syncStrategy", void 0);
+        _define_property(this, "batchSyncDelay", void 0);
+        _define_property(this, "syncRetryConfig", void 0);
+        _define_property(this, "isSyncing", false);
+        _define_property(this, "batchSyncTimer", null);
+        _define_property(this, "lastSyncTime", void 0);
+        _define_property(this, "failedCount", 0);
+        // 用户信息/设置更新函数
+        _define_property(this, "userInfoUpdater", void 0);
+        _define_property(this, "userSettingsUpdater", void 0);
+        this.queueManager = options.queueManager;
+        this.errorHandler = options.errorHandler;
+        this.performanceMonitor = options.performanceMonitor;
+        this.logger = options.logger;
+        this.syncStrategy = options.syncStrategy;
+        this.batchSyncDelay = options.batchSyncDelay;
+        this.syncRetryConfig = options.syncRetryConfig;
+        this.userInfoUpdater = options.userInfoUpdater;
+        this.userSettingsUpdater = options.userSettingsUpdater;
+    }
+};
+
+//# sourceMappingURL=SyncManager.js.map

package/dist/cjs/managers/UserManager/runtime/SyncManager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/UserManager/runtime/SyncManager.ts"],"sourcesContent":["/**\n * 数据同步管理模块\n * 负责用户信息/设置同步到服务器、同步队列管理、同步失败重试\n */\n\nimport type { Logger, SyncQueueStatus } from '../types';\nimport { QueueManager } from './QueueManager';\nimport { ErrorHandler } from '../modules/ErrorHandler';\nimport { PerformanceMonitor } from '../observability/PerformanceMonitor';\n\n/**\n * 同步管理器\n */\nexport class SyncManager {\n  private queueManager: QueueManager;\n  private errorHandler: ErrorHandler;\n  private performanceMonitor: PerformanceMonitor;\n  private logger?: Logger;\n  \n  private syncStrategy: 'immediate' | 'batch' | 'queue';\n  private batchSyncDelay: number;\n  private syncRetryConfig: {\n    maxRetries: number;\n    retryDelay: number;\n    backoffMultiplier: number;\n  };\n  \n  private isSyncing: boolean = false;\n  private batchSyncTimer: ReturnType<typeof setTimeout> | null = null;\n  private lastSyncTime?: number;\n  private failedCount: number = 0;\n  \n  // 用户信息/设置更新函数\n  private userInfoUpdater?: (userId: string, userInfo: unknown) => Promise<unknown>;\n  private userSettingsUpdater?: (userId: string, settings: unknown) => Promise<unknown>;\n\n  constructor(options: {\n    queueManager: QueueManager;\n    errorHandler: ErrorHandler;\n    performanceMonitor: PerformanceMonitor;\n    logger?: Logger;\n    syncStrategy: 'immediate' | 'batch' | 'queue';\n    batchSyncDelay: number;\n    syncRetryConfig: {\n      maxRetries: number;\n      retryDelay: number;\n      backoffMultiplier: number;\n    };\n    userInfoUpdater?: (userId: string, userInfo: unknown) => Promise<unknown>;\n    userSettingsUpdater?: (userId: string, settings: unknown) => Promise<unknown>;\n  }) {\n    this.queueManager = options.queueManager;\n    this.errorHandler = options.errorHandler;\n    this.performanceMonitor = options.performanceMonitor;\n    this.logger = options.logger;\n    this.syncStrategy = options.syncStrategy;\n    this.batchSyncDelay = options.batchSyncDelay;\n    this.syncRetryConfig = options.syncRetryConfig;\n    this.userInfoUpdater = options.userInfoUpdater;\n    this.userSettingsUpdater = options.userSettingsUpdater;\n  }\n\n  /**\n   * 同步用户信息\n   */\n  async syncUserInfo(userId: string, userInfo: unknown): Promise<void> {\n    if (!this.userInfoUpdater) {\n      this.logger?.warn('userInfoUpdater is not provided, skipping sync');\n      return;\n    }\n\n    if (this.syncStrategy === 'immediate') {\n      return this.syncUserInfoImmediate(userId, userInfo);\n    } else if (this.syncStrategy === 'batch') {\n      return this.syncUserInfoBatch(userId, userInfo);\n    } else {\n      // queue 策略\n      this.queueManager.enqueue('userInfo', userId, userInfo);\n      // 异步触发同步\n      this.triggerSync().catch(() => {\n        // 同步失败，忽略\n      });\n    }\n  }\n\n  /**\n   * 同步用户设置\n   */\n  async syncUserSettings(userId: string, settings: unknown): Promise<void> {\n    if (!this.userSettingsUpdater) {\n      this.logger?.warn('userSettingsUpdater is not provided, skipping sync');\n      return;\n    }\n\n    if (this.syncStrategy === 'immediate') {\n      return this.syncUserSettingsImmediate(userId, settings);\n    } else if (this.syncStrategy === 'batch') {\n      return this.syncUserSettingsBatch(userId, settings);\n    } else {\n      // queue 策略\n      this.queueManager.enqueue('userSettings', userId, settings);\n      // 异步触发同步\n      this.triggerSync().catch(() => {\n        // 同步失败，忽略\n      });\n    }\n  }\n\n  /**\n   * 立即同步用户信息\n   */\n  private async syncUserInfoImmediate(userId: string, userInfo: unknown): Promise<void> {\n    const startTime = Date.now();\n    try {\n      await this.userInfoUpdater!(userId, userInfo);\n      const duration = Date.now() - startTime;\n      this.performanceMonitor.recordMetric('sync_user_info', duration, { userId });\n      this.lastSyncTime = Date.now();\n      this.failedCount = 0;\n    } catch (error) {\n      const duration = Date.now() - startTime;\n      this.performanceMonitor.recordMetric('sync_user_info', duration, { userId, error: true });\n      this.failedCount++;\n      throw this.errorHandler.handleError(error, {\n        operation: 'syncUserInfo',\n        userId,\n      });\n    }\n  }\n\n  /**\n   * 批量同步用户信息\n   */\n  private async syncUserInfoBatch(userId: string, userInfo: unknown): Promise<void> {\n    // 添加到队列\n    this.queueManager.enqueue('userInfo', userId, userInfo);\n    \n    // 清除之前的定时器\n    if (this.batchSyncTimer) {\n      clearTimeout(this.batchSyncTimer);\n    }\n    \n    // 设置延迟同步\n    this.batchSyncTimer = setTimeout(() => {\n      this.batchSyncTimer = null;\n      this.processBatchSync().catch(() => {\n        // 批量同步失败，忽略\n      });\n    }, this.batchSyncDelay);\n  }\n\n  /**\n   * 立即同步用户设置\n   */\n  private async syncUserSettingsImmediate(userId: string, settings: unknown): Promise<void> {\n    const startTime = Date.now();\n    try {\n      await this.userSettingsUpdater!(userId, settings);\n      const duration = Date.now() - startTime;\n      this.performanceMonitor.recordMetric('sync_user_settings', duration, { userId });\n      this.lastSyncTime = Date.now();\n      this.failedCount = 0;\n    } catch (error) {\n      const duration = Date.now() - startTime;\n      this.performanceMonitor.recordMetric('sync_user_settings', duration, { userId, error: true });\n      this.failedCount++;\n      throw this.errorHandler.handleError(error, {\n        operation: 'syncUserSettings',\n        userId,\n      });\n    }\n  }\n\n  /**\n   * 批量同步用户设置\n   */\n  private async syncUserSettingsBatch(userId: string, settings: unknown): Promise<void> {\n    // 添加到队列\n    this.queueManager.enqueue('userSettings', userId, settings);\n    \n    // 清除之前的定时器\n    if (this.batchSyncTimer) {\n      clearTimeout(this.batchSyncTimer);\n    }\n    \n    // 设置延迟同步\n    this.batchSyncTimer = setTimeout(() => {\n      this.batchSyncTimer = null;\n      this.processBatchSync().catch(() => {\n        // 批量同步失败，忽略\n      });\n    }, this.batchSyncDelay);\n  }\n\n  /**\n   * 处理批量同步\n   */\n  private async processBatchSync(): Promise<void> {\n    if (this.isSyncing) {\n      return;\n    }\n\n    this.isSyncing = true;\n    try {\n      // 处理用户信息队列\n      while (this.queueManager.getQueueSize('userInfo') > 0) {\n        const item = this.queueManager.dequeue('userInfo');\n        if (item && this.userInfoUpdater) {\n          try {\n            await this.syncUserInfoImmediate(item.userId, item.data);\n          } catch (error) {\n            // 同步失败，如果重试次数未超限，重新入队\n            if (item.retryCount < this.syncRetryConfig.maxRetries) {\n              this.queueManager.incrementRetryCount(item);\n              this.queueManager.enqueue('userInfo', item.userId, item.data);\n            }\n          }\n        }\n      }\n\n      // 处理用户设置队列\n      while (this.queueManager.getQueueSize('userSettings') > 0) {\n        const item = this.queueManager.dequeue('userSettings');\n        if (item && this.userSettingsUpdater) {\n          try {\n            await this.syncUserSettingsImmediate(item.userId, item.data);\n          } catch (error) {\n            // 同步失败，如果重试次数未超限，重新入队\n            if (item.retryCount < this.syncRetryConfig.maxRetries) {\n              this.queueManager.incrementRetryCount(item);\n              this.queueManager.enqueue('userSettings', item.userId, item.data);\n            }\n          }\n        }\n      }\n    } finally {\n      this.isSyncing = false;\n    }\n  }\n\n  /**\n   * 触发同步（队列策略）\n   */\n  private async triggerSync(): Promise<void> {\n    if (this.isSyncing) {\n      return;\n    }\n\n    await this.processBatchSync();\n  }\n\n  /**\n   * 同步所有待同步的数据\n   */\n  async syncAll(): Promise<void> {\n    if (this.isSyncing) {\n      return;\n    }\n\n    await this.processBatchSync();\n  }\n\n  /**\n   * 获取同步队列状态\n   */\n  getSyncQueueStatus(): SyncQueueStatus {\n    return {\n      pendingUserInfo: this.queueManager.getQueueSize('userInfo'),\n      pendingUserSettings: this.queueManager.getQueueSize('userSettings'),\n      isSyncing: this.isSyncing,\n      lastSyncTime: this.lastSyncTime,\n      failedCount: this.failedCount,\n    };\n  }\n\n  /**\n   * 清理资源\n   */\n  destroy(): void {\n    if (this.batchSyncTimer) {\n      clearTimeout(this.batchSyncTimer);\n      this.batchSyncTimer = null;\n    }\n  }\n}\n"],"names":["SyncManager","syncUserInfo","userId","userInfo","userInfoUpdater","logger","warn","syncStrategy","syncUserInfoImmediate","syncUserInfoBatch","queueManager","enqueue","triggerSync","catch","syncUserSettings","settings","userSettingsUpdater","syncUserSettingsImmediate","syncUserSettingsBatch","startTime","Date","now","duration","performanceMonitor","recordMetric","lastSyncTime","failedCount","error","errorHandler","handleError","operation","batchSyncTimer","clearTimeout","setTimeout","processBatchSync","batchSyncDelay","isSyncing","getQueueSize","item","dequeue","data","retryCount","syncRetryConfig","maxRetries","incrementRetryCount","syncAll","getSyncQueueStatus","pendingUserInfo","pendingUserSettings","destroy","options"],"mappings":"AAAA;;;CAGC;;;;+BAUYA;;;eAAAA;;;;;;;;;;;;;;;;AAAN,IAAA,AAAMA,cAAN,MAAMA;IAiDX;;GAEC,GACD,MAAMC,aAAaC,MAAc,EAAEC,QAAiB,EAAiB;QACnE,IAAI,CAAC,IAAI,CAACC,eAAe,EAAE;YACzB,IAAI,CAACC,MAAM,EAAEC,KAAK;YAClB;QACF;QAEA,IAAI,IAAI,CAACC,YAAY,KAAK,aAAa;YACrC,OAAO,IAAI,CAACC,qBAAqB,CAACN,QAAQC;QAC5C,OAAO,IAAI,IAAI,CAACI,YAAY,KAAK,SAAS;YACxC,OAAO,IAAI,CAACE,iBAAiB,CAACP,QAAQC;QACxC,OAAO;YACL,WAAW;YACX,IAAI,CAACO,YAAY,CAACC,OAAO,CAAC,YAAYT,QAAQC;YAC9C,SAAS;YACT,IAAI,CAACS,WAAW,GAAGC,KAAK,CAAC;YACvB,UAAU;YACZ;QACF;IACF;IAEA;;GAEC,GACD,MAAMC,iBAAiBZ,MAAc,EAAEa,QAAiB,EAAiB;QACvE,IAAI,CAAC,IAAI,CAACC,mBAAmB,EAAE;YAC7B,IAAI,CAACX,MAAM,EAAEC,KAAK;YAClB;QACF;QAEA,IAAI,IAAI,CAACC,YAAY,KAAK,aAAa;YACrC,OAAO,IAAI,CAACU,yBAAyB,CAACf,QAAQa;QAChD,OAAO,IAAI,IAAI,CAACR,YAAY,KAAK,SAAS;YACxC,OAAO,IAAI,CAACW,qBAAqB,CAAChB,QAAQa;QAC5C,OAAO;YACL,WAAW;YACX,IAAI,CAACL,YAAY,CAACC,OAAO,CAAC,gBAAgBT,QAAQa;YAClD,SAAS;YACT,IAAI,CAACH,WAAW,GAAGC,KAAK,CAAC;YACvB,UAAU;YACZ;QACF;IACF;IAEA;;GAEC,GACD,MAAcL,sBAAsBN,MAAc,EAAEC,QAAiB,EAAiB;QACpF,MAAMgB,YAAYC,KAAKC,GAAG;QAC1B,IAAI;YACF,MAAM,IAAI,CAACjB,eAAe,CAAEF,QAAQC;YACpC,MAAMmB,WAAWF,KAAKC,GAAG,KAAKF;YAC9B,IAAI,CAACI,kBAAkB,CAACC,YAAY,CAAC,kBAAkBF,UAAU;gBAAEpB;YAAO;YAC1E,IAAI,CAACuB,YAAY,GAAGL,KAAKC,GAAG;YAC5B,IAAI,CAACK,WAAW,GAAG;QACrB,EAAE,OAAOC,OAAO;YACd,MAAML,WAAWF,KAAKC,GAAG,KAAKF;YAC9B,IAAI,CAACI,kBAAkB,CAACC,YAAY,CAAC,kBAAkBF,UAAU;gBAAEpB;gBAAQyB,OAAO;YAAK;YACvF,IAAI,CAACD,WAAW;YAChB,MAAM,IAAI,CAACE,YAAY,CAACC,WAAW,CAACF,OAAO;gBACzCG,WAAW;gBACX5B;YACF;QACF;IACF;IAEA;;GAEC,GACD,MAAcO,kBAAkBP,MAAc,EAAEC,QAAiB,EAAiB;QAChF,QAAQ;QACR,IAAI,CAACO,YAAY,CAACC,OAAO,CAAC,YAAYT,QAAQC;QAE9C,WAAW;QACX,IAAI,IAAI,CAAC4B,cAAc,EAAE;YACvBC,aAAa,IAAI,CAACD,cAAc;QAClC;QAEA,SAAS;QACT,IAAI,CAACA,cAAc,GAAGE,WAAW;YAC/B,IAAI,CAACF,cAAc,GAAG;YACtB,IAAI,CAACG,gBAAgB,GAAGrB,KAAK,CAAC;YAC5B,YAAY;YACd;QACF,GAAG,IAAI,CAACsB,cAAc;IACxB;IAEA;;GAEC,GACD,MAAclB,0BAA0Bf,MAAc,EAAEa,QAAiB,EAAiB;QACxF,MAAMI,YAAYC,KAAKC,GAAG;QAC1B,IAAI;YACF,MAAM,IAAI,CAACL,mBAAmB,CAAEd,QAAQa;YACxC,MAAMO,WAAWF,KAAKC,GAAG,KAAKF;YAC9B,IAAI,CAACI,kBAAkB,CAACC,YAAY,CAAC,sBAAsBF,UAAU;gBAAEpB;YAAO;YAC9E,IAAI,CAACuB,YAAY,GAAGL,KAAKC,GAAG;YAC5B,IAAI,CAACK,WAAW,GAAG;QACrB,EAAE,OAAOC,OAAO;YACd,MAAML,WAAWF,KAAKC,GAAG,KAAKF;YAC9B,IAAI,CAACI,kBAAkB,CAACC,YAAY,CAAC,sBAAsBF,UAAU;gBAAEpB;gBAAQyB,OAAO;YAAK;YAC3F,IAAI,CAACD,WAAW;YAChB,MAAM,IAAI,CAACE,YAAY,CAACC,WAAW,CAACF,OAAO;gBACzCG,WAAW;gBACX5B;YACF;QACF;IACF;IAEA;;GAEC,GACD,MAAcgB,sBAAsBhB,MAAc,EAAEa,QAAiB,EAAiB;QACpF,QAAQ;QACR,IAAI,CAACL,YAAY,CAACC,OAAO,CAAC,gBAAgBT,QAAQa;QAElD,WAAW;QACX,IAAI,IAAI,CAACgB,cAAc,EAAE;YACvBC,aAAa,IAAI,CAACD,cAAc;QAClC;QAEA,SAAS;QACT,IAAI,CAACA,cAAc,GAAGE,WAAW;YAC/B,IAAI,CAACF,cAAc,GAAG;YACtB,IAAI,CAACG,gBAAgB,GAAGrB,KAAK,CAAC;YAC5B,YAAY;YACd;QACF,GAAG,IAAI,CAACsB,cAAc;IACxB;IAEA;;GAEC,GACD,MAAcD,mBAAkC;QAC9C,IAAI,IAAI,CAACE,SAAS,EAAE;YAClB;QACF;QAEA,IAAI,CAACA,SAAS,GAAG;QACjB,IAAI;YACF,WAAW;YACX,MAAO,IAAI,CAAC1B,YAAY,CAAC2B,YAAY,CAAC,cAAc,EAAG;gBACrD,MAAMC,OAAO,IAAI,CAAC5B,YAAY,CAAC6B,OAAO,CAAC;gBACvC,IAAID,QAAQ,IAAI,CAAClC,eAAe,EAAE;oBAChC,IAAI;wBACF,MAAM,IAAI,CAACI,qBAAqB,CAAC8B,KAAKpC,MAAM,EAAEoC,KAAKE,IAAI;oBACzD,EAAE,OAAOb,OAAO;wBACd,sBAAsB;wBACtB,IAAIW,KAAKG,UAAU,GAAG,IAAI,CAACC,eAAe,CAACC,UAAU,EAAE;4BACrD,IAAI,CAACjC,YAAY,CAACkC,mBAAmB,CAACN;4BACtC,IAAI,CAAC5B,YAAY,CAACC,OAAO,CAAC,YAAY2B,KAAKpC,MAAM,EAAEoC,KAAKE,IAAI;wBAC9D;oBACF;gBACF;YACF;YAEA,WAAW;YACX,MAAO,IAAI,CAAC9B,YAAY,CAAC2B,YAAY,CAAC,kBAAkB,EAAG;gBACzD,MAAMC,OAAO,IAAI,CAAC5B,YAAY,CAAC6B,OAAO,CAAC;gBACvC,IAAID,QAAQ,IAAI,CAACtB,mBAAmB,EAAE;oBACpC,IAAI;wBACF,MAAM,IAAI,CAACC,yBAAyB,CAACqB,KAAKpC,MAAM,EAAEoC,KAAKE,IAAI;oBAC7D,EAAE,OAAOb,OAAO;wBACd,sBAAsB;wBACtB,IAAIW,KAAKG,UAAU,GAAG,IAAI,CAACC,eAAe,CAACC,UAAU,EAAE;4BACrD,IAAI,CAACjC,YAAY,CAACkC,mBAAmB,CAACN;4BACtC,IAAI,CAAC5B,YAAY,CAACC,OAAO,CAAC,gBAAgB2B,KAAKpC,MAAM,EAAEoC,KAAKE,IAAI;wBAClE;oBACF;gBACF;YACF;QACF,SAAU;YACR,IAAI,CAACJ,SAAS,GAAG;QACnB;IACF;IAEA;;GAEC,GACD,MAAcxB,cAA6B;QACzC,IAAI,IAAI,CAACwB,SAAS,EAAE;YAClB;QACF;QAEA,MAAM,IAAI,CAACF,gBAAgB;IAC7B;IAEA;;GAEC,GACD,MAAMW,UAAyB;QAC7B,IAAI,IAAI,CAACT,SAAS,EAAE;YAClB;QACF;QAEA,MAAM,IAAI,CAACF,gBAAgB;IAC7B;IAEA;;GAEC,GACDY,qBAAsC;QACpC,OAAO;YACLC,iBAAiB,IAAI,CAACrC,YAAY,CAAC2B,YAAY,CAAC;YAChDW,qBAAqB,IAAI,CAACtC,YAAY,CAAC2B,YAAY,CAAC;YACpDD,WAAW,IAAI,CAACA,SAAS;YACzBX,cAAc,IAAI,CAACA,YAAY;YAC/BC,aAAa,IAAI,CAACA,WAAW;QAC/B;IACF;IAEA;;GAEC,GACDuB,UAAgB;QACd,IAAI,IAAI,CAAClB,cAAc,EAAE;YACvBC,aAAa,IAAI,CAACD,cAAc;YAChC,IAAI,CAACA,cAAc,GAAG;QACxB;IACF;IAvPA,YAAYmB,OAcX,CAAE;QApCH,uBAAQxC,gBAAR,KAAA;QACA,uBAAQkB,gBAAR,KAAA;QACA,uBAAQL,sBAAR,KAAA;QACA,uBAAQlB,UAAR,KAAA;QAEA,uBAAQE,gBAAR,KAAA;QACA,uBAAQ4B,kBAAR,KAAA;QACA,uBAAQO,mBAAR,KAAA;QAMA,uBAAQN,aAAqB;QAC7B,uBAAQL,kBAAuD;QAC/D,uBAAQN,gBAAR,KAAA;QACA,uBAAQC,eAAsB;QAE9B,cAAc;QACd,uBAAQtB,mBAAR,KAAA;QACA,uBAAQY,uBAAR,KAAA;QAiBE,IAAI,CAACN,YAAY,GAAGwC,QAAQxC,YAAY;QACxC,IAAI,CAACkB,YAAY,GAAGsB,QAAQtB,YAAY;QACxC,IAAI,CAACL,kBAAkB,GAAG2B,QAAQ3B,kBAAkB;QACpD,IAAI,CAAClB,MAAM,GAAG6C,QAAQ7C,MAAM;QAC5B,IAAI,CAACE,YAAY,GAAG2C,QAAQ3C,YAAY;QACxC,IAAI,CAAC4B,cAAc,GAAGe,QAAQf,cAAc;QAC5C,IAAI,CAACO,eAAe,GAAGQ,QAAQR,eAAe;QAC9C,IAAI,CAACtC,eAAe,GAAG8C,QAAQ9C,eAAe;QAC9C,IAAI,CAACY,mBAAmB,GAAGkC,QAAQlC,mBAAmB;IACxD;AAgOF"}

package/dist/cjs/managers/UserManager/runtime/index.js

@@ -0,0 +1,24 @@
+/**
+ * Runtime 层导出
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get QueueManager () {
+        return _QueueManager.QueueManager;
+    },
+    get SyncManager () {
+        return _SyncManager.SyncManager;
+    }
+});
+const _SyncManager = require("./SyncManager");
+const _QueueManager = require("./QueueManager");
+
+//# sourceMappingURL=index.js.map

package/dist/cjs/managers/UserManager/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/UserManager/runtime/index.ts"],"sourcesContent":["/**\n * Runtime 层导出\n */\n\nexport { SyncManager } from './SyncManager';\nexport { QueueManager } from './QueueManager';\n"],"names":["QueueManager","SyncManager"],"mappings":"AAAA;;CAEC;;;;;;;;;;;QAGQA;eAAAA,0BAAY;;QADZC;eAAAA,wBAAW;;;6BAAQ;8BACC"}

package/dist/cjs/managers/UserManager/types.js

@@ -0,0 +1,76 @@
+/**
+ * UserManager 类型定义
+ * 完全泛型化的用户管理类型
+ */ // ========== 框架服务类型声明 ==========
+/**
+ * @vlian/framework AppEventBus 类型声明
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get UserError () {
+        return UserError;
+    },
+    get UserErrorCode () {
+        return UserErrorCode;
+    },
+    get UserEventType () {
+        return UserEventType;
+    }
+});
+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;
+}
+var UserEventType = /*#__PURE__*/ function(UserEventType) {
+    UserEventType["USER_INFO_LOADED"] = "user:info:loaded";
+    UserEventType["USER_INFO_UPDATED"] = "user:info:updated";
+    UserEventType["USER_INFO_REFRESHED"] = "user:info:refreshed";
+    UserEventType["USER_SETTINGS_LOADED"] = "user:settings:loaded";
+    UserEventType["USER_SETTINGS_UPDATED"] = "user:settings:updated";
+    UserEventType["USER_SETTINGS_REFRESHED"] = "user:settings:refreshed";
+    UserEventType["SYNC_STARTED"] = "user:sync:started";
+    UserEventType["SYNC_COMPLETED"] = "user:sync:completed";
+    UserEventType["SYNC_FAILED"] = "user:sync:failed";
+    UserEventType["CACHE_CLEARED"] = "user:cache:cleared";
+    return UserEventType;
+}({});
+var UserErrorCode = /*#__PURE__*/ function(UserErrorCode) {
+    UserErrorCode["USER_NOT_AUTHENTICATED"] = "USER_NOT_AUTHENTICATED";
+    UserErrorCode["USER_INFO_NOT_FOUND"] = "USER_INFO_NOT_FOUND";
+    UserErrorCode["USER_SETTINGS_NOT_FOUND"] = "USER_SETTINGS_NOT_FOUND";
+    UserErrorCode["VALIDATION_FAILED"] = "VALIDATION_FAILED";
+    UserErrorCode["SYNC_FAILED"] = "SYNC_FAILED";
+    UserErrorCode["STORAGE_ERROR"] = "STORAGE_ERROR";
+    UserErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    UserErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+    return UserErrorCode;
+}({});
+let UserError = class UserError extends Error {
+    constructor(message, code, context, cause){
+        super(message), _define_property(this, "code", void 0), _define_property(this, "context", void 0), _define_property(this, "cause", void 0), this.code = code, this.context = context, this.cause = cause;
+        this.name = 'UserError';
+        // 保持错误堆栈
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, UserError);
+        }
+    }
+};
+
+//# sourceMappingURL=types.js.map

package/dist/cjs/managers/UserManager/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/managers/UserManager/types.ts"],"sourcesContent":["/**\n * UserManager 类型定义\n * 完全泛型化的用户管理类型\n */\n\n// ========== 框架服务类型声明 ==========\n\n/**\n * @vlian/framework AppEventBus 类型声明\n */\nexport interface AppEventBus {\n  on<T = unknown>(\n    event: string,\n    listener: (data: T, metadata: EventMetadata) => void | Promise<void>,\n    options?: EventListenerOptions\n  ): () => void;\n  \n  off<T = unknown>(\n    event: string,\n    listener?: (data: T, metadata: EventMetadata) => void | Promise<void>\n  ): void;\n  \n  once<T = unknown>(\n    event: string,\n    listener: (data: T, metadata: EventMetadata) => void | Promise<void>,\n    options?: Omit<EventListenerOptions, 'once'>\n  ): () => void;\n  \n  emit<T = unknown>(\n    event: string,\n    data: T,\n    metadata?: Partial<EventMetadata>\n  ): void | Promise<void>;\n}\n\n/**\n * @vlian/framework Logger 类型声明\n */\nexport interface Logger {\n  info(message: string, ...args: unknown[]): void;\n  warn(message: string, ...args: unknown[]): void;\n  error(message: string, ...args: unknown[]): void;\n  debug(message: string, ...args: unknown[]): void;\n}\n\n/**\n * @vlian/framework MonitoringService 类型声明\n */\nexport interface MonitoringService {\n  captureError(error: unknown, context?: Record<string, unknown>): void;\n  trackEvent(eventName: string, properties?: Record<string, unknown>): void;\n  reportPerformance(metrics: Record<string, number>, context?: Record<string, unknown>): void;\n}\n\n/**\n * @vlian/framework StorageInstance 类型声明\n */\nexport interface StorageInstance {\n  get(key: string): Promise<string | null>;\n  set(key: string, value: string): Promise<void>;\n  remove(key: string): Promise<void>;\n}\n\n/**\n * @vlian/framework StateManagerInstance 类型声明\n */\nexport interface StateManagerInstance {\n  get<T>(key: string): T | null;\n  set<T>(key: string, value: T): void;\n  remove(key: string): void;\n  subscribe<T>(key: string, callback: (value: T) => void): () => void;\n}\n\n/**\n * 存储策略\n */\nexport type StorageStrategy = 'local' | 'session' | 'indexedDB' | 'memory';\n\n/**\n * AuthManager 类型声明（从 @vlian/infrastructure 导入）\n */\nexport interface AuthManager<TUserInfo = unknown> {\n  isAuthenticated(): boolean;\n  getUserInfo(): TUserInfo | null;\n  getUserId(): string | null;\n}\n\n// ========== 环境类型 ==========\n\n/**\n * 环境类型\n */\nexport type Environment = 'browser' | 'node' | 'ssr' | 'worker' | 'unknown';\n\n// ========== 事件类型 ==========\n\n/**\n * 用户事件类型枚举\n */\nexport enum UserEventType {\n  USER_INFO_LOADED = 'user:info:loaded',\n  USER_INFO_UPDATED = 'user:info:updated',\n  USER_INFO_REFRESHED = 'user:info:refreshed',\n  USER_SETTINGS_LOADED = 'user:settings:loaded',\n  USER_SETTINGS_UPDATED = 'user:settings:updated',\n  USER_SETTINGS_REFRESHED = 'user:settings:refreshed',\n  SYNC_STARTED = 'user:sync:started',\n  SYNC_COMPLETED = 'user:sync:completed',\n  SYNC_FAILED = 'user:sync:failed',\n  CACHE_CLEARED = 'user:cache:cleared',\n}\n\n/**\n * 事件元数据\n */\nexport interface EventMetadata {\n  timestamp: number;\n  instanceId?: string;\n  userId?: string;\n  traceId?: string;\n  eventType?: string;\n}\n\n/**\n * 事件监听器选项\n */\nexport interface EventListenerOptions {\n  once?: boolean;\n  priority?: number;\n}\n\n// ========== 配置类型 ==========\n\n/**\n * UserManager 配置选项\n * @template TUserInfo 用户信息类型，完全由用户定义\n * @template TUserSettings 用户设置类型，完全由用户定义\n */\nexport interface UserOptions<TUserInfo = unknown, TUserSettings = unknown> {\n  // ========== 依赖注入（必需）==========\n  /**\n   * AuthManager 实例（必需）\n   * 用于获取当前用户ID和认证信息\n   */\n  authManager: AuthManager<unknown>;\n  \n  // ========== @vlian/framework 依赖注入 ==========\n  /**\n   * @vlian/framework Storage 配置（可选）\n   * 用于用户设置持久化\n   * 方式1：指定存储策略（local/session/indexedDB）\n   * 方式2：直接提供 StorageInstance\n   */\n  storage?: {\n    instance?: StorageInstance;\n    strategy?: StorageStrategy;\n  };\n  \n  /**\n   * @vlian/framework StateManager 配置（可选）\n   * 用于用户信息状态管理，支持跨组件共享\n   * 如果不提供，使用内存存储（默认）\n   */\n  stateManager?: {\n    instance?: StateManagerInstance;\n    namespace?: string;\n  };\n  \n  /**\n   * @vlian/framework AppEventBus 实例（可选）\n   * 如果不提供，内部会创建独立的事件总线\n   */\n  eventBus?: AppEventBus;\n  \n  /**\n   * @vlian/framework Logger 实例（可选）\n   * 如果不提供，使用默认日志（console）\n   */\n  logger?: Logger;\n  \n  /**\n   * @vlian/framework MonitoringService 实例（可选）\n   * 用于错误监控、性能指标上报和用户行为追踪\n   */\n  monitoring?: MonitoringService;\n  \n  // ========== 用户信息配置 ==========\n  /**\n   * 用户信息获取函数（可选）\n   * 从 API 获取用户信息\n   */\n  userInfoFetcher?: (userId: string) => Promise<TUserInfo>;\n  \n  /**\n   * 用户信息更新函数（可选）\n   * 更新用户信息到服务器\n   */\n  userInfoUpdater?: (userId: string, userInfo: Partial<TUserInfo>) => Promise<TUserInfo>;\n  \n  /**\n   * 用户信息验证函数（可选）\n   * 验证用户信息格式\n   * @returns true 表示验证通过，string 表示验证失败的错误信息\n   */\n  userInfoValidator?: (userInfo: Partial<TUserInfo>) => boolean | string;\n  \n  /**\n   * 是否启用用户信息缓存（默认：true）\n   */\n  enableUserInfoCache?: boolean;\n  \n  /**\n   * 用户信息缓存过期时间（毫秒，默认：无过期）\n   */\n  userInfoCacheExpiry?: number;\n  \n  // ========== 用户设置配置 ==========\n  /**\n   * 用户设置获取函数（可选）\n   * 从 API 获取用户设置\n   */\n  userSettingsFetcher?: (userId: string) => Promise<TUserSettings>;\n  \n  /**\n   * 用户设置更新函数（可选）\n   * 更新用户设置到服务器\n   */\n  userSettingsUpdater?: (userId: string, settings: Partial<TUserSettings>) => Promise<TUserSettings>;\n  \n  /**\n   * 用户设置验证函数（可选）\n   * 验证用户设置格式\n   * @returns true 表示验证通过，string 表示验证失败的错误信息\n   */\n  userSettingsValidator?: (settings: Partial<TUserSettings>) => boolean | string;\n  \n  /**\n   * 用户设置存储键名（默认：'user_settings_{userId}'）\n   */\n  userSettingsKey?: string | ((userId: string) => string);\n  \n  /**\n   * 是否启用用户设置缓存（默认：true）\n   */\n  enableUserSettingsCache?: boolean;\n  \n  // ========== 并发控制配置 ==========\n  /**\n   * 并发控制策略（默认：'queue'）\n   * - 'queue': 串行队列机制，保证操作顺序执行，避免竞态条件\n   * - 'version': 版本号机制，只应用最新操作\n   * - 'none': 无控制，直接执行\n   */\n  concurrencyStrategy?: 'queue' | 'version' | 'none';\n  \n  /**\n   * 队列最大长度（默认：100）\n   * 防止内存溢出\n   */\n  maxQueueSize?: number;\n  \n  /**\n   * 操作超时时间（毫秒，默认：30000）\n   * 0 表示无超时\n   */\n  operationTimeout?: number;\n  \n  // ========== 数据同步配置 ==========\n  /**\n   * 同步策略（默认：'queue'）\n   * - 'immediate': 立即同步\n   * - 'batch': 批量同步（延迟合并）\n   * - 'queue': 队列同步（后台同步）\n   */\n  syncStrategy?: 'immediate' | 'batch' | 'queue';\n  \n  /**\n   * 批量同步延迟（毫秒，默认：1000）\n   * 仅在 syncStrategy 为 'batch' 时有效\n   */\n  batchSyncDelay?: number;\n  \n  /**\n   * 同步失败重试配置\n   */\n  syncRetryConfig?: {\n    maxRetries?: number;\n    retryDelay?: number;\n    backoffMultiplier?: number;\n  };\n  \n  /**\n   * 是否启用离线队列（默认：true）\n   */\n  enableOfflineQueue?: boolean;\n  \n  // ========== 事件配置 ==========\n  /**\n   * 事件命名空间前缀（默认：'user:'）\n   * 用于在 AppEventBus 中隔离事件\n   */\n  eventNamespace?: string;\n  \n  /**\n   * 是否启用事件（默认：true）\n   */\n  enableEvents?: boolean;\n  \n  // ========== 可观测性配置（完全可选，默认禁用）==========\n  /**\n   * 是否启用日志（默认：false）\n   * 如果为 false，即使提供了 logger 也不会使用\n   */\n  enableLogging?: boolean;\n  \n  /**\n   * 是否启用监控（默认：false）\n   * 如果为 false，即使提供了 monitoring 也不会使用\n   */\n  enableMonitoring?: boolean;\n  \n  // ========== 性能配置 ==========\n  /**\n   * 是否启用详细性能指标（默认：false）\n   */\n  enableDetailedMetrics?: boolean;\n  \n  /**\n   * 性能指标收集器（可选）\n   * 如果提供，会调用此函数收集性能指标\n   * 同时也会上报到 @vlian/framework MonitoringService\n   */\n  metricsCollector?: (metrics: PerformanceMetrics) => void;\n  \n  // ========== 初始化配置 ==========\n  /**\n   * 初始化时是否自动加载用户信息（默认：false）\n   * 如果为 true，在 UserManager 实例化时，如果用户已认证，会自动调用 refreshUserInfo() 加载用户信息\n   */\n  autoLoadUserInfoOnInit?: boolean;\n  \n  /**\n   * 初始化时是否自动加载用户设置（默认：false）\n   * 如果为 true，在 UserManager 实例化时，如果用户已认证，会自动调用 loadUserSettings() 加载用户设置\n   */\n  autoLoadUserSettingsOnInit?: boolean;\n  \n  // ========== 其他配置 ==========\n  /**\n   * 实例 ID（可选）\n   * 用于多实例场景下的隔离\n   */\n  instanceId?: string;\n  \n  /**\n   * 是否启用开发模式（默认：自动检测）\n   */\n  devMode?: boolean;\n  \n  /**\n   * 是否启用配置验证（默认：true）\n   */\n  validateConfig?: boolean;\n}\n\n// ========== 同步队列状态 ==========\n\n/**\n * 同步队列状态\n */\nexport interface SyncQueueStatus {\n  /**\n   * 待同步的用户信息数量\n   */\n  pendingUserInfo: number;\n  \n  /**\n   * 待同步的用户设置数量\n   */\n  pendingUserSettings: number;\n  \n  /**\n   * 是否正在同步\n   */\n  isSyncing: boolean;\n  \n  /**\n   * 最后同步时间\n   */\n  lastSyncTime?: number;\n  \n  /**\n   * 同步失败次数\n   */\n  failedCount: number;\n}\n\n// ========== 健康检查结果 ==========\n\n/**\n * 健康检查结果\n */\nexport interface HealthCheckResult {\n  /**\n   * 健康状态\n   */\n  status: 'healthy' | 'degraded' | 'unhealthy';\n  \n  /**\n   * 检查项\n   */\n  checks: {\n    storage: boolean;\n    stateManager: boolean;\n    eventBus: boolean;\n    cache: boolean;\n    syncQueue: boolean;\n  };\n  \n  /**\n   * 详细信息\n   */\n  details?: Record<string, unknown>;\n}\n\n// ========== 性能指标 ==========\n\n/**\n * 性能指标\n */\nexport interface PerformanceMetrics {\n  /**\n   * 操作名称\n   */\n  operation: string;\n  \n  /**\n   * 耗时（毫秒）\n   */\n  duration: number;\n  \n  /**\n   * 时间戳\n   */\n  timestamp: number;\n  \n  /**\n   * 其他上下文信息\n   */\n  [key: string]: unknown;\n}\n\n// ========== 错误类型 ==========\n\n/**\n * 用户管理错误代码\n */\nexport enum UserErrorCode {\n  USER_NOT_AUTHENTICATED = 'USER_NOT_AUTHENTICATED',\n  USER_INFO_NOT_FOUND = 'USER_INFO_NOT_FOUND',\n  USER_SETTINGS_NOT_FOUND = 'USER_SETTINGS_NOT_FOUND',\n  VALIDATION_FAILED = 'VALIDATION_FAILED',\n  SYNC_FAILED = 'SYNC_FAILED',\n  STORAGE_ERROR = 'STORAGE_ERROR',\n  NETWORK_ERROR = 'NETWORK_ERROR',\n  UNKNOWN_ERROR = 'UNKNOWN_ERROR',\n}\n\n/**\n * 用户管理错误类\n */\nexport class UserError extends Error {\n  constructor(\n    message: string,\n    public code: UserErrorCode,\n    public context?: Record<string, unknown>,\n    public cause?: Error\n  ) {\n    super(message);\n    this.name = 'UserError';\n    // 保持错误堆栈\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, UserError);\n    }\n  }\n}\n\n// ========== 配置验证结果 ==========\n\n/**\n * 配置验证结果\n */\nexport interface ConfigValidationResult {\n  valid: boolean;\n  errors: string[];\n  warnings: string[];\n}\n"],"names":["UserError","UserErrorCode","UserEventType","Error","message","code","context","cause","name","captureStackTrace"],"mappings":"AAAA;;;CAGC,GAED,iCAAiC;AAEjC;;CAEC;;;;;;;;;;;QA8cYA;eAAAA;;QAdDC;eAAAA;;QAtWAC;eAAAA;;;;;;;;;;;;;;;;AAAL,IAAA,AAAKA,uCAAAA;;;;;;;;;;;WAAAA;;AAsWL,IAAA,AAAKD,uCAAAA;;;;;;;;;WAAAA;;AAcL,IAAA,AAAMD,YAAN,MAAMA,kBAAkBG;IAC7B,YACEC,OAAe,EACf,AAAOC,IAAmB,EAC1B,AAAOC,OAAiC,EACxC,AAAOC,KAAa,CACpB;QACA,KAAK,CAACH,2IAJCC,OAAAA,WACAC,UAAAA,cACAC,QAAAA;QAGP,IAAI,CAACC,IAAI,GAAG;QACZ,SAAS;QACT,IAAIL,MAAMM,iBAAiB,EAAE;YAC3BN,MAAMM,iBAAiB,CAAC,IAAI,EAAET;QAChC;IACF;AACF"}

package/dist/cjs/managers/UserManager/utils/DataManagerUtils.js

@@ -0,0 +1,162 @@
+/**
+ * 数据管理工具函数
+ * 提取 UserInfoManager 和 UserSettingsManager 的公共逻辑
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get emitLoadOrRefreshEvent () {
+        return emitLoadOrRefreshEvent;
+    },
+    get getDataFromCacheOrState () {
+        return getDataFromCacheOrState;
+    },
+    get isFirstLoad () {
+        return isFirstLoad;
+    },
+    get mergeData () {
+        return mergeData;
+    },
+    get requireAuthenticatedUser () {
+        return requireAuthenticatedUser;
+    },
+    get shouldUseCache () {
+        return shouldUseCache;
+    },
+    get updateCacheIfEnabled () {
+        return updateCacheIfEnabled;
+    },
+    get updateStateIfEnabled () {
+        return updateStateIfEnabled;
+    },
+    get validateData () {
+        return validateData;
+    },
+    get withAsyncOperation () {
+        return withAsyncOperation;
+    },
+    get withErrorHandler () {
+        return withErrorHandler;
+    },
+    get withPerformanceMonitor () {
+        return withPerformanceMonitor;
+    }
+});
+const _types = require("../types");
+function validateData(data, validator) {
+    if (!validator) {
+        return;
+    }
+    const validationResult = validator(data);
+    if (validationResult !== true) {
+        throw new _types.UserError(typeof validationResult === 'string' ? validationResult : 'Validation failed', _types.UserErrorCode.VALIDATION_FAILED, {
+            data
+        });
+    }
+}
+function requireAuthenticatedUser(authManager, operation, errorHandler) {
+    const userId = authManager.getUserId();
+    if (!userId) {
+        throw errorHandler.handleError(new Error('User is not authenticated'), {
+            operation
+        });
+    }
+    return userId;
+}
+function isFirstLoad(currentData) {
+    return currentData === null;
+}
+function mergeData(current, partial) {
+    return {
+        ...current || {},
+        ...partial
+    };
+}
+function updateCacheIfEnabled(enableCache, cacheManager, key, value, expiry) {
+    if (enableCache) {
+        cacheManager.set(key, value, expiry);
+    }
+}
+function updateStateIfEnabled(stateManager, key, value) {
+    if (stateManager) {
+        stateManager.set(key, value);
+    }
+}
+function getDataFromCacheOrState(cacheManager, stateManager, enableCache, cacheKey) {
+    // 优先从状态管理获取
+    if (stateManager) {
+        const stateData = stateManager.get(cacheKey);
+        if (stateData) {
+            return stateData;
+        }
+    }
+    // 从缓存获取
+    if (enableCache) {
+        const cachedData = cacheManager.get(cacheKey);
+        if (cachedData) {
+            return cachedData;
+        }
+    }
+    return null;
+}
+function emitLoadOrRefreshEvent(eventManager, isFirstLoad, loadedEvent, refreshedEvent, data, userId) {
+    if (isFirstLoad) {
+        eventManager.emitEvent(loadedEvent, {
+            ...data,
+            userId
+        });
+    } else {
+        eventManager.emitEvent(refreshedEvent, {
+            ...data,
+            userId
+        });
+    }
+}
+function shouldUseCache(force, enableCache, cacheManager, cacheKey) {
+    if (force) {
+        return false;
+    }
+    if (!enableCache) {
+        return false;
+    }
+    const cached = cacheManager.get(cacheKey);
+    return cached !== null;
+}
+async function withPerformanceMonitor(operation, performanceMonitor, fn, metadata) {
+    const startTime = Date.now();
+    try {
+        const result = await fn();
+        const duration = Date.now() - startTime;
+        performanceMonitor.recordMetric(operation, duration, metadata);
+        return result;
+    } catch (error) {
+        const duration = Date.now() - startTime;
+        performanceMonitor.recordMetric(operation, duration, {
+            ...metadata,
+            error: true
+        });
+        throw error;
+    }
+}
+async function withErrorHandler(errorHandler, operation, fn, context) {
+    try {
+        return await fn();
+    } catch (error) {
+        throw errorHandler.handleError(error, {
+            operation,
+            ...context
+        });
+    }
+}
+async function withAsyncOperation(operation, performanceMonitor, errorHandler, fn, context) {
+    return withErrorHandler(errorHandler, operation, ()=>withPerformanceMonitor(operation, performanceMonitor, fn, context), context);
+}
+
+//# sourceMappingURL=DataManagerUtils.js.map

package/dist/cjs/managers/UserManager/utils/DataManagerUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/UserManager/utils/DataManagerUtils.ts"],"sourcesContent":["/**\n * 数据管理工具函数\n * 提取 UserInfoManager 和 UserSettingsManager 的公共逻辑\n */\n\nimport type { AuthManager } from '../types';\nimport { UserError, UserErrorCode } from '../types';\nimport type { CacheManager } from '../core/CacheManager';\nimport type { StateManagerWrapper } from '../core/StateManagerWrapper';\nimport type { ErrorHandler } from '../modules/ErrorHandler';\nimport type { PerformanceMonitor } from '../observability/PerformanceMonitor';\nimport type { EventManager } from '../observability/EventManager';\nimport type { UserEventType } from '../types';\n\n/**\n * 验证数据\n */\nexport function validateData<T>(\n  data: Partial<T>,\n  validator?: (data: Partial<T>) => boolean | string\n): void {\n  if (!validator) {\n    return;\n  }\n\n  const validationResult = validator(data);\n  if (validationResult !== true) {\n    throw new UserError(\n      typeof validationResult === 'string' ? validationResult : 'Validation failed',\n      UserErrorCode.VALIDATION_FAILED,\n      { data }\n    );\n  }\n}\n\n/**\n * 要求用户已认证\n */\nexport function requireAuthenticatedUser(\n  authManager: AuthManager<unknown>,\n  operation: string,\n  errorHandler: ErrorHandler\n): string {\n  const userId = authManager.getUserId();\n  if (!userId) {\n    throw errorHandler.handleError(\n      new Error('User is not authenticated'),\n      { operation }\n    );\n  }\n  return userId;\n}\n\n/**\n * 检查是否是首次加载\n */\nexport function isFirstLoad<T>(currentData: T | null): boolean {\n  return currentData === null;\n}\n\n/**\n * 合并数据\n */\nexport function mergeData<T>(current: T | null, partial: Partial<T>): T {\n  return { ...(current || ({} as T)), ...partial } as T;\n}\n\n/**\n * 更新缓存（如果启用）\n */\nexport function updateCacheIfEnabled<T>(\n  enableCache: boolean,\n  cacheManager: CacheManager<T>,\n  key: string,\n  value: T,\n  expiry?: number\n): void {\n  if (enableCache) {\n    cacheManager.set(key, value, expiry);\n  }\n}\n\n/**\n * 更新状态管理（如果存在）\n */\nexport function updateStateIfEnabled<T>(\n  stateManager: StateManagerWrapper | undefined,\n  key: string,\n  value: T\n): void {\n  if (stateManager) {\n    stateManager.set(key, value);\n  }\n}\n\n/**\n * 从缓存或状态管理获取数据\n */\nexport function getDataFromCacheOrState<T>(\n  cacheManager: CacheManager<T>,\n  stateManager: StateManagerWrapper | undefined,\n  enableCache: boolean,\n  cacheKey: string\n): T | null {\n  // 优先从状态管理获取\n  if (stateManager) {\n    const stateData = stateManager.get<T>(cacheKey);\n    if (stateData) {\n      return stateData;\n    }\n  }\n\n  // 从缓存获取\n  if (enableCache) {\n    const cachedData = cacheManager.get(cacheKey);\n    if (cachedData) {\n      return cachedData;\n    }\n  }\n\n  return null;\n}\n\n/**\n * 触发加载或刷新事件\n */\nexport function emitLoadOrRefreshEvent<EventData extends Record<string, unknown>>(\n  eventManager: EventManager,\n  isFirstLoad: boolean,\n  loadedEvent: UserEventType,\n  refreshedEvent: UserEventType,\n  data: EventData,\n  userId: string\n): void {\n  if (isFirstLoad) {\n    eventManager.emitEvent(loadedEvent, { ...data, userId });\n  } else {\n    eventManager.emitEvent(refreshedEvent, { ...data, userId });\n  }\n}\n\n/**\n * 检查缓存是否有效（非强制刷新时）\n */\nexport function shouldUseCache<T>(\n  force: boolean,\n  enableCache: boolean,\n  cacheManager: CacheManager<T>,\n  cacheKey: string\n): boolean {\n  if (force) {\n    return false;\n  }\n  if (!enableCache) {\n    return false;\n  }\n  const cached = cacheManager.get(cacheKey);\n  return cached !== null;\n}\n\n/**\n * 性能监控包装器\n */\nexport async function withPerformanceMonitor<T>(\n  operation: string,\n  performanceMonitor: PerformanceMonitor,\n  fn: () => Promise<T>,\n  metadata?: Record<string, unknown>\n): Promise<T> {\n  const startTime = Date.now();\n  try {\n    const result = await fn();\n    const duration = Date.now() - startTime;\n    performanceMonitor.recordMetric(operation, duration, metadata);\n    return result;\n  } catch (error) {\n    const duration = Date.now() - startTime;\n    performanceMonitor.recordMetric(operation, duration, { ...metadata, error: true });\n    throw error;\n  }\n}\n\n/**\n * 错误处理包装器\n */\nexport async function withErrorHandler<T>(\n  errorHandler: ErrorHandler,\n  operation: string,\n  fn: () => Promise<T>,\n  context?: Record<string, unknown>\n): Promise<T> {\n  try {\n    return await fn();\n  } catch (error) {\n    throw errorHandler.handleError(error, {\n      operation,\n      ...context,\n    });\n  }\n}\n\n/**\n * 完整的异步操作包装器（性能监控 + 错误处理）\n */\nexport async function withAsyncOperation<T>(\n  operation: string,\n  performanceMonitor: PerformanceMonitor,\n  errorHandler: ErrorHandler,\n  fn: () => Promise<T>,\n  context?: Record<string, unknown>\n): Promise<T> {\n  return withErrorHandler(\n    errorHandler,\n    operation,\n    () => withPerformanceMonitor(operation, performanceMonitor, fn, context),\n    context\n  );\n}\n"],"names":["emitLoadOrRefreshEvent","getDataFromCacheOrState","isFirstLoad","mergeData","requireAuthenticatedUser","shouldUseCache","updateCacheIfEnabled","updateStateIfEnabled","validateData","withAsyncOperation","withErrorHandler","withPerformanceMonitor","data","validator","validationResult","UserError","UserErrorCode","VALIDATION_FAILED","authManager","operation","errorHandler","userId","getUserId","handleError","Error","currentData","current","partial","enableCache","cacheManager","key","value","expiry","set","stateManager","cacheKey","stateData","get","cachedData","eventManager","loadedEvent","refreshedEvent","emitEvent","force","cached","performanceMonitor","fn","metadata","startTime","Date","now","result","duration","recordMetric","error","context"],"mappings":"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"}