@vlian/infrastructure 0.9.10

package/dist/types/managers/UserManager/UserManager.d.ts

@@ -0,0 +1,121 @@
+/**
+ * UserManager - 用户管理器
+ *
+ * 提供用户信息和用户设置管理能力
+ * 完全泛型化，用户信息类型由用户定义
+ * 基于 @vlian/framework 的 Storage、StateManager 和 AppEventBus
+ */
+import type { UserOptions, UserEventType, EventMetadata, EventListenerOptions, SyncQueueStatus, HealthCheckResult, PerformanceMetrics } from './types';
+/**
+ * UserManager 类
+ */
+export declare class UserManager<TUserInfo = unknown, TUserSettings = unknown> {
+    private options;
+    private environment;
+    private isProduction;
+    private storageManager;
+    private stateManager?;
+    private errorHandler;
+    private cacheManager;
+    private settingsCacheManager;
+    private concurrencyController;
+    private validator;
+    private userInfoManager;
+    private userSettingsManager;
+    private queueManager;
+    private syncManager;
+    private loggingManager;
+    private monitoringManager;
+    private performanceMonitor;
+    private eventManager;
+    /**
+     * 构造函数
+     */
+    constructor(options: UserOptions<TUserInfo, TUserSettings>);
+    /**
+     * 初始化所有模块
+     */
+    private initializeModules;
+    /**
+     * 初始化时自动加载用户信息和设置
+     */
+    private initializeAutoLoad;
+    /**
+     * 验证配置
+     */
+    private validateConfig;
+    /**
+     * 获取用户信息
+     */
+    getUserInfo(): TUserInfo | null;
+    /**
+     * 更新用户信息
+     */
+    updateUserInfo(userInfo: Partial<TUserInfo>): Promise<void>;
+    /**
+     * 刷新用户信息
+     */
+    refreshUserInfo(force?: boolean): Promise<void>;
+    /**
+     * 清除用户信息缓存
+     */
+    clearUserInfoCache(): void;
+    /**
+     * 获取用户设置（同步，从缓存获取）
+     * 注意：如果缓存中没有，需要调用 loadUserSettings 异步加载
+     */
+    getUserSettings(): TUserSettings | null;
+    /**
+     * 从存储加载用户设置（异步）
+     */
+    loadUserSettings(): Promise<TUserSettings | null>;
+    /**
+     * 更新用户设置
+     */
+    updateUserSettings(settings: Partial<TUserSettings>): Promise<void>;
+    /**
+     * 刷新用户设置
+     */
+    refreshUserSettings(force?: boolean): Promise<void>;
+    /**
+     * 清除用户设置缓存
+     */
+    clearUserSettingsCache(): void;
+    /**
+     * 同步所有待同步的数据
+     */
+    syncAll(): Promise<void>;
+    /**
+     * 获取同步队列状态
+     */
+    getSyncQueueStatus(): SyncQueueStatus;
+    /**
+     * 订阅事件
+     */
+    on<EventData = unknown>(event: UserEventType, listener: (data: EventData, metadata: EventMetadata) => void | Promise<void>, options?: EventListenerOptions): () => void;
+    /**
+     * 取消订阅
+     */
+    off<EventData = unknown>(event: UserEventType, listener?: (data: EventData, metadata: EventMetadata) => void | Promise<void>): void;
+    /**
+     * 一次性订阅
+     */
+    once<EventData = unknown>(event: UserEventType, listener: (data: EventData, metadata: EventMetadata) => void | Promise<void>): () => void;
+    /**
+     * 健康检查
+     */
+    healthCheck(): Promise<HealthCheckResult>;
+    /**
+     * 获取性能指标
+     */
+    getPerformanceMetrics(): PerformanceMetrics[];
+    /**
+     * 清除性能指标
+     */
+    clearPerformanceMetrics(): void;
+    /**
+     * 销毁实例
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=UserManager.d.ts.map

package/dist/types/managers/UserManager/UserManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserManager.d.ts","sourceRoot":"","sources":["../../../../src/managers/UserManager/UserManager.ts"],"names":[],"mappings":"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"}

package/dist/types/managers/UserManager/constants.d.ts

@@ -0,0 +1,56 @@
+/**
+ * UserManager 常量定义
+ */
+import { UserEventType } from './types';
+/**
+ * 默认配置值
+ */
+export declare const DEFAULT_OPTIONS: {
+    readonly eventNamespace: "user:";
+    readonly enableEvents: true;
+    readonly enableUserInfoCache: true;
+    readonly userInfoCacheExpiry: undefined;
+    readonly userSettingsKey: (userId: string) => string;
+    readonly enableUserSettingsCache: true;
+    readonly concurrencyStrategy: "queue";
+    readonly maxQueueSize: 100;
+    readonly operationTimeout: 30000;
+    readonly syncStrategy: "queue";
+    readonly batchSyncDelay: 1000;
+    readonly syncRetryConfig: {
+        readonly maxRetries: 3;
+        readonly retryDelay: 1000;
+        readonly backoffMultiplier: 2;
+    };
+    readonly enableOfflineQueue: true;
+    readonly enableLogging: false;
+    readonly enableMonitoring: false;
+    readonly enableDetailedMetrics: false;
+    readonly autoLoadUserInfoOnInit: false;
+    readonly autoLoadUserSettingsOnInit: false;
+    readonly devMode: boolean;
+    readonly validateConfig: true;
+};
+/**
+ * 生产环境配置覆盖
+ */
+export declare const PRODUCTION_OVERRIDES: {
+    readonly devMode: false;
+    readonly enableDetailedMetrics: false;
+};
+/**
+ * 事件类型映射（用于类型检查）
+ */
+export declare const USER_EVENT_TYPES: {
+    readonly USER_INFO_LOADED: UserEventType.USER_INFO_LOADED;
+    readonly USER_INFO_UPDATED: UserEventType.USER_INFO_UPDATED;
+    readonly USER_INFO_REFRESHED: UserEventType.USER_INFO_REFRESHED;
+    readonly USER_SETTINGS_LOADED: UserEventType.USER_SETTINGS_LOADED;
+    readonly USER_SETTINGS_UPDATED: UserEventType.USER_SETTINGS_UPDATED;
+    readonly USER_SETTINGS_REFRESHED: UserEventType.USER_SETTINGS_REFRESHED;
+    readonly SYNC_STARTED: UserEventType.SYNC_STARTED;
+    readonly SYNC_COMPLETED: UserEventType.SYNC_COMPLETED;
+    readonly SYNC_FAILED: UserEventType.SYNC_FAILED;
+    readonly CACHE_CLEARED: UserEventType.CACHE_CLEARED;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/managers/UserManager/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/managers/UserManager/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AA6BxC;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;uCAUA,MAAM;;;;;;;;;;;;;;;;;;;;CAgCxB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;CAGvB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;CAWnB,CAAC"}

package/dist/types/managers/UserManager/core/CacheManager.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 缓存管理模块
+ * 负责内存缓存管理
+ */
+/**
+ * 缓存管理器
+ */
+export declare class CacheManager<T> {
+    private cache;
+    private defaultTTL?;
+    private maxSize?;
+    private hits;
+    private misses;
+    constructor(options?: {
+        defaultTTL?: number;
+        maxSize?: number;
+    });
+    /**
+     * 获取缓存值
+     */
+    get(key: string): T | null;
+    /**
+     * 设置缓存值
+     */
+    set(key: string, value: T, ttl?: number): void;
+    /**
+     * 检查是否存在
+     */
+    has(key: string): boolean;
+    /**
+     * 删除缓存
+     */
+    delete(key: string): boolean;
+    /**
+     * 清除所有缓存
+     */
+    clear(): void;
+    /**
+     * 获取缓存大小
+     */
+    size(): number;
+    /**
+     * 获取所有键
+     */
+    keys(): string[];
+    /**
+     * 获取最旧的键
+     */
+    private getOldestKey;
+    /**
+     * 获取缓存统计信息
+     */
+    getStatistics(): {
+        size: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+        keys: string[];
+    };
+    /**
+     * 重置统计信息
+     */
+    resetStatistics(): void;
+}
+//# sourceMappingURL=CacheManager.d.ts.map

package/dist/types/managers/UserManager/core/CacheManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../../../../src/managers/UserManager/core/CacheManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC;IACzB,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;gBAEP,OAAO,CAAC,EAAE;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;IAKD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAkB1B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAyB9C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAezB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAIhB;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,aAAa,IAAI;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB;IAaD;;OAEG;IACH,eAAe,IAAI,IAAI;CAIxB"}

package/dist/types/managers/UserManager/core/ConcurrencyController.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 并发控制模块
+ * 控制用户管理操作的并发执行
+ * 支持串行队列和版本号机制
+ */
+/**
+ * 并发控制器
+ */
+export declare class ConcurrencyController {
+    private strategy;
+    private maxQueueSize;
+    private operationTimeout;
+    private queue;
+    private isProcessing;
+    private versionCounter;
+    constructor(options: {
+        strategy: 'queue' | 'version' | 'none';
+        maxQueueSize: number;
+        operationTimeout: number;
+    });
+    /**
+     * 执行操作（带并发控制）
+     */
+    execute<T>(operation: () => Promise<T>): Promise<T>;
+    /**
+     * 处理队列
+     */
+    private processQueue;
+    /**
+     * 执行任务
+     */
+    private executeTask;
+    /**
+     * 清除队列
+     */
+    clear(): void;
+    /**
+     * 获取队列长度
+     */
+    getQueueLength(): number;
+}
+//# sourceMappingURL=ConcurrencyController.d.ts.map

package/dist/types/managers/UserManager/core/ConcurrencyController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConcurrencyController.d.ts","sourceRoot":"","sources":["../../../../../src/managers/UserManager/core/ConcurrencyController.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAK;gBAEf,OAAO,EAAE;QACnB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;QACvC,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;KAC1B;IAMD;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA8CzD;;OAEG;YACW,YAAY;IAkC1B;;OAEG;YACW,WAAW;IAczB;;OAEG;IACH,KAAK,IAAI,IAAI;IAgBb;;OAEG;IACH,cAAc,IAAI,MAAM;CAGzB"}

package/dist/types/managers/UserManager/core/StateManagerWrapper.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 状态管理封装模块
+ * 封装 @vlian/framework StateManager，负责状态管理实例初始化
+ */
+import type { StateManagerInstance } from '../types';
+/**
+ * 状态管理器封装
+ */
+export declare class StateManagerWrapper {
+    private stateManager;
+    private namespace;
+    private logger?;
+    private memoryStore;
+    private subscribers;
+    constructor(options: {
+        stateManager?: {
+            instance?: StateManagerInstance;
+            namespace?: string;
+        };
+        logger?: {
+            warn: (message: string, ...args: unknown[]) => void;
+            error: (message: string, ...args: unknown[]) => void;
+        };
+    });
+    /**
+     * 初始化状态管理实例
+     */
+    private initStateManager;
+    /**
+     * 获取键名（带命名空间）
+     */
+    private getKey;
+    /**
+     * 获取值
+     */
+    get<T>(key: string): T | null;
+    /**
+     * 设置值
+     */
+    set<T>(key: string, value: T): void;
+    /**
+     * 删除值
+     */
+    remove(key: string): void;
+    /**
+     * 订阅值变化
+     */
+    subscribe<T>(key: string, callback: (value: T) => void): () => void;
+}
+//# sourceMappingURL=StateManagerWrapper.d.ts.map

package/dist/types/managers/UserManager/core/StateManagerWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateManagerWrapper.d.ts","sourceRoot":"","sources":["../../../../../src/managers/UserManager/core/StateManagerWrapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,YAAY,CAAqC;IACzD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAgH;IAG/H,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,WAAW,CAAyD;gBAG1E,OAAO,EAAE;QACP,YAAY,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACvE,MAAM,CAAC,EAAE;YAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;YAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;SAAE,CAAC;KACxH;IAOH;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuCxB;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAY7B;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAuBnC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAUzB;;OAEG;IACH,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;CAuBpE"}

package/dist/types/managers/UserManager/core/UserCore.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 用户核心模块
+ * 核心用户管理逻辑，仅依赖必需的服务
+ */
+import { CacheManager } from './CacheManager';
+import { StateManagerWrapper } from './StateManagerWrapper';
+import { ConcurrencyController } from './ConcurrencyController';
+import { UserValidator } from './UserValidator';
+import type { AuthManager } from '../types';
+/**
+ * 用户核心类
+ */
+export declare class UserCore<TUserInfo = unknown, TUserSettings = unknown> {
+    private cacheManager;
+    private settingsCacheManager;
+    private stateManager?;
+    private concurrencyController;
+    private validator;
+    private authManager;
+    private userInfoCacheKey;
+    private userSettingsCacheKey;
+    constructor(options: {
+        cacheManager: CacheManager<TUserInfo>;
+        settingsCacheManager: CacheManager<TUserSettings>;
+        stateManager?: StateManagerWrapper;
+        concurrencyController: ConcurrencyController;
+        validator: UserValidator<TUserInfo, TUserSettings>;
+        authManager: AuthManager<unknown>;
+        userInfoCacheKey?: string;
+        userSettingsCacheKey?: string;
+    });
+    /**
+     * 获取用户信息（从缓存或状态）
+     */
+    getUserInfo(): TUserInfo | null;
+    /**
+     * 设置用户信息（到缓存和状态）
+     */
+    setUserInfo(userInfo: TUserInfo): void;
+    /**
+     * 清除用户信息
+     */
+    clearUserInfo(): void;
+    /**
+     * 获取用户设置（从缓存）
+     */
+    getUserSettings(): TUserSettings | null;
+    /**
+     * 设置用户设置（到缓存）
+     */
+    setUserSettings(settings: TUserSettings): void;
+    /**
+     * 清除用户设置
+     */
+    clearUserSettings(): void;
+    /**
+     * 执行操作（带并发控制）
+     */
+    execute<T>(operation: () => Promise<T>): Promise<T>;
+    /**
+     * 获取并发控制器
+     */
+    getConcurrencyController(): ConcurrencyController;
+}
+//# sourceMappingURL=UserCore.d.ts.map

package/dist/types/managers/UserManager/core/UserCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserCore.d.ts","sourceRoot":"","sources":["../../../../../src/managers/UserManager/core/UserCore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;GAEG;AACH,qBAAa,QAAQ,CAAC,SAAS,GAAG,OAAO,EAAE,aAAa,GAAG,OAAO;IAChE,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,oBAAoB,CAA8B;IAC1D,OAAO,CAAC,YAAY,CAAC,CAAsB;IAC3C,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,oBAAoB,CAA2B;gBAGrD,OAAO,EAAE;QACP,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;QACtC,oBAAoB,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC;QAClD,YAAY,CAAC,EAAE,mBAAmB,CAAC;QACnC,qBAAqB,EAAE,qBAAqB,CAAC;QAC7C,SAAS,EAAE,aAAa,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACnD,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;QAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B;IAYH;;OAEG;IACH,WAAW,IAAI,SAAS,GAAG,IAAI;IAkB/B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI;IAmBtC;;OAEG;IACH,aAAa,IAAI,IAAI;IAOrB;;OAEG;IACH,eAAe,IAAI,aAAa,GAAG,IAAI;IASvC;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAc9C;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIzD;;OAEG;IACH,wBAAwB,IAAI,qBAAqB;CAGlD"}

package/dist/types/managers/UserManager/core/UserInfoManager.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 用户信息管理模块（Core 层）
+ * 负责用户信息的获取、更新、缓存管理
+ */
+import type { AuthManager, Logger, MonitoringService } from '../types';
+import { CacheManager } from './CacheManager';
+import { StateManagerWrapper } from './StateManagerWrapper';
+import { ConcurrencyController } from './ConcurrencyController';
+import { UserValidator } from './UserValidator';
+import { SyncManager } from '../runtime/SyncManager';
+import { ErrorHandler } from '../modules/ErrorHandler';
+import { PerformanceMonitor } from '../observability/PerformanceMonitor';
+import { EventManager } from '../observability/EventManager';
+/**
+ * 用户信息管理器
+ */
+export declare class UserInfoManager<TUserInfo = unknown> {
+    private cacheManager;
+    private stateManager?;
+    private syncManager;
+    private errorHandler;
+    private performanceMonitor;
+    private eventManager;
+    private authManager;
+    private concurrencyController;
+    private validator;
+    private userInfoFetcher?;
+    private userInfoUpdater?;
+    private enableCache;
+    private cacheExpiry?;
+    private cacheKey;
+    constructor(options: {
+        authManager: AuthManager<unknown>;
+        cacheManager: CacheManager<TUserInfo>;
+        stateManager?: StateManagerWrapper;
+        syncManager: SyncManager;
+        errorHandler: ErrorHandler;
+        performanceMonitor: PerformanceMonitor;
+        eventManager: EventManager;
+        concurrencyController: ConcurrencyController;
+        validator: UserValidator<TUserInfo, unknown>;
+        logger?: Logger;
+        monitoring?: MonitoringService;
+        userInfoFetcher?: (userId: string) => Promise<TUserInfo>;
+        userInfoUpdater?: (userId: string, userInfo: Partial<TUserInfo>) => Promise<TUserInfo>;
+        enableCache: boolean;
+        cacheExpiry?: number;
+    });
+    /**
+     * 获取用户信息
+     */
+    getUserInfo(): TUserInfo | null;
+    /**
+     * 更新用户信息（带并发控制）
+     */
+    updateUserInfo(userInfo: Partial<TUserInfo>): Promise<void>;
+    /**
+     * 刷新用户信息（从服务器获取最新数据，带并发控制）
+     */
+    refreshUserInfo(force?: boolean): Promise<void>;
+    /**
+     * 清除用户信息缓存
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=UserInfoManager.d.ts.map

package/dist/types/managers/UserManager/core/UserInfoManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserInfoManager.d.ts","sourceRoot":"","sources":["../../../../../src/managers/UserManager/core/UserInfoManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,MAAM,EACN,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAa7D;;GAEG;AACH,qBAAa,eAAe,CAAC,SAAS,GAAG,OAAO;IAC9C,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,YAAY,CAAC,CAAsB;IAC3C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,SAAS,CAAoC;IAErD,OAAO,CAAC,eAAe,CAAC,CAAyC;IACjE,OAAO,CAAC,eAAe,CAAC,CAAuE;IAC/F,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAuB;gBAE3B,OAAO,EAAE;QACnB,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;QAClC,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;QACtC,YAAY,CAAC,EAAE,mBAAmB,CAAC;QACnC,WAAW,EAAE,WAAW,CAAC;QACzB,YAAY,EAAE,YAAY,CAAC;QAC3B,kBAAkB,EAAE,kBAAkB,CAAC;QACvC,YAAY,EAAE,YAAY,CAAC;QAC3B,qBAAqB,EAAE,qBAAqB,CAAC;QAC7C,SAAS,EAAE,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,iBAAiB,CAAC;QAC/B,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;QACzD,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;QACvF,WAAW,EAAE,OAAO,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;IAgBD;;OAEG;IACH,WAAW,IAAI,SAAS,GAAG,IAAI;IAc/B;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDjE;;OAEG;IACG,eAAe,CAAC,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA2D5D;;OAEG;IACH,UAAU,IAAI,IAAI;CASnB"}

package/dist/types/managers/UserManager/core/UserSettingsManager.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 用户设置管理模块（Core 层）
+ * 负责用户设置的获取、更新、持久化
+ */
+import type { AuthManager, Logger, MonitoringService } from '../types';
+import { CacheManager } from './CacheManager';
+import { ConcurrencyController } from './ConcurrencyController';
+import { UserValidator } from './UserValidator';
+import { StorageManager } from '../modules/StorageManager';
+import { SyncManager } from '../runtime/SyncManager';
+import { ErrorHandler } from '../modules/ErrorHandler';
+import { PerformanceMonitor } from '../observability/PerformanceMonitor';
+import { EventManager } from '../observability/EventManager';
+/**
+ * 用户设置管理器
+ */
+export declare class UserSettingsManager<TUserSettings = unknown> {
+    private cacheManager;
+    private storageManager;
+    private syncManager;
+    private errorHandler;
+    private performanceMonitor;
+    private eventManager;
+    private authManager;
+    private concurrencyController;
+    private validator;
+    private logger?;
+    private userSettingsFetcher?;
+    private userSettingsUpdater?;
+    private userSettingsKey;
+    private enableCache;
+    constructor(options: {
+        authManager: AuthManager<unknown>;
+        cacheManager: CacheManager<TUserSettings>;
+        storageManager: StorageManager;
+        syncManager: SyncManager;
+        errorHandler: ErrorHandler;
+        performanceMonitor: PerformanceMonitor;
+        eventManager: EventManager;
+        concurrencyController: ConcurrencyController;
+        validator: UserValidator<unknown, TUserSettings>;
+        logger?: Logger;
+        monitoring?: MonitoringService;
+        userSettingsFetcher?: (userId: string) => Promise<TUserSettings>;
+        userSettingsUpdater?: (userId: string, settings: Partial<TUserSettings>) => Promise<TUserSettings>;
+        userSettingsKey: string | ((userId: string) => string);
+        enableCache: boolean;
+    });
+    /**
+     * 获取存储键名
+     */
+    private getStorageKey;
+    /**
+     * 获取用户设置（同步，从缓存获取）
+     * 注意：如果缓存中没有，需要调用 loadUserSettings 异步加载
+     */
+    getUserSettings(): TUserSettings | null;
+    /**
+     * 从存储加载用户设置（带并发控制）
+     */
+    loadUserSettings(): Promise<TUserSettings | null>;
+    /**
+     * 更新用户设置（带并发控制）
+     */
+    updateUserSettings(settings: Partial<TUserSettings>): Promise<void>;
+    /**
+     * 刷新用户设置（从服务器获取最新数据，带并发控制）
+     */
+    refreshUserSettings(force?: boolean): Promise<void>;
+    /**
+     * 清除用户设置缓存
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=UserSettingsManager.d.ts.map

package/dist/types/managers/UserManager/core/UserSettingsManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserSettingsManager.d.ts","sourceRoot":"","sources":["../../../../../src/managers/UserManager/core/UserSettingsManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,MAAM,EACN,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAW7D;;GAEG;AACH,qBAAa,mBAAmB,CAAC,aAAa,GAAG,OAAO;IACtD,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,MAAM,CAAC,CAAS;IAExB,OAAO,CAAC,mBAAmB,CAAC,CAA6C;IACzE,OAAO,CAAC,mBAAmB,CAAC,CAA+E;IAC3G,OAAO,CAAC,eAAe,CAAwC;IAC/D,OAAO,CAAC,WAAW,CAAU;gBAEjB,OAAO,EAAE;QACnB,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;QAClC,YAAY,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC;QAC1C,cAAc,EAAE,cAAc,CAAC;QAC/B,WAAW,EAAE,WAAW,CAAC;QACzB,YAAY,EAAE,YAAY,CAAC;QAC3B,kBAAkB,EAAE,kBAAkB,CAAC;QACvC,YAAY,EAAE,YAAY,CAAC;QAC3B,qBAAqB,EAAE,qBAAqB,CAAC;QAC7C,SAAS,EAAE,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACjD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,iBAAiB,CAAC;QAC/B,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;QACjE,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;QACnG,eAAe,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;QACvD,WAAW,EAAE,OAAO,CAAC;KACtB;IAiBD;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;;OAGG;IACH,eAAe,IAAI,aAAa,GAAG,IAAI;IAoBvC;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAgDvD;;OAEG;IACG,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmEzE;;OAEG;IACG,mBAAmB,CAAC,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAwDhE;;OAEG;IACH,UAAU,IAAI,IAAI;CAUnB"}

package/dist/types/managers/UserManager/core/UserValidator.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 用户数据验证器
+ * 负责验证用户信息和用户设置的数据格式
+ */
+/**
+ * 用户验证器
+ */
+export declare class UserValidator<TUserInfo = unknown, TUserSettings = unknown> {
+    private userInfoValidator?;
+    private userSettingsValidator?;
+    constructor(options?: {
+        userInfoValidator?: (userInfo: Partial<TUserInfo>) => boolean | string;
+        userSettingsValidator?: (settings: Partial<TUserSettings>) => boolean | string;
+    });
+    /**
+     * 验证用户信息
+     */
+    validateUserInfo(userInfo: Partial<TUserInfo>): {
+        valid: boolean;
+        error?: string;
+    };
+    /**
+     * 验证用户设置
+     */
+    validateUserSettings(settings: Partial<TUserSettings>): {
+        valid: boolean;
+        error?: string;
+    };
+}
+//# sourceMappingURL=UserValidator.d.ts.map

package/dist/types/managers/UserManager/core/UserValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserValidator.d.ts","sourceRoot":"","sources":["../../../../../src/managers/UserManager/core/UserValidator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,qBAAa,aAAa,CAAC,SAAS,GAAG,OAAO,EAAE,aAAa,GAAG,OAAO;IACrE,OAAO,CAAC,iBAAiB,CAAC,CAAqD;IAC/E,OAAO,CAAC,qBAAqB,CAAC,CAAyD;gBAE3E,OAAO,CAAC,EAAE;QACpB,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,OAAO,GAAG,MAAM,CAAC;QACvE,qBAAqB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK,OAAO,GAAG,MAAM,CAAC;KAChF;IAKD;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAgBlF;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CAe3F"}

package/dist/types/managers/UserManager/core/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Core 层导出
+ */
+export { UserCore } from './UserCore';
+export { ConcurrencyController } from './ConcurrencyController';
+export { UserValidator } from './UserValidator';
+export { StateManagerWrapper } from './StateManagerWrapper';
+export { CacheManager } from './CacheManager';
+export { UserInfoManager } from './UserInfoManager';
+export { UserSettingsManager } from './UserSettingsManager';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/managers/UserManager/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/managers/UserManager/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/types/managers/UserManager/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * UserManager 导出文件
+ */
+export { UserManager } from './UserManager';
+export { UserEventType, UserError, UserErrorCode, } from './types';
+export type { UserOptions, EventMetadata, EventListenerOptions, SyncQueueStatus, HealthCheckResult, PerformanceMetrics, ConfigValidationResult, AppEventBus, Logger, MonitoringService, StorageInstance, StateManagerInstance, StorageStrategy, Environment, AuthManager, } from './types';
+export { DEFAULT_OPTIONS, PRODUCTION_OVERRIDES, USER_EVENT_TYPES, } from './constants';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/managers/UserManager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/managers/UserManager/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EACL,aAAa,EACb,SAAS,EACT,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,WAAW,EACX,MAAM,EACN,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,aAAa,CAAC"}