@vlian/infrastructure 0.9.10

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

@@ -0,0 +1,29 @@
+/**
+ * 监控管理模块
+ * 封装 @vlian/framework MonitoringService，负责错误监控和用户行为追踪
+ */
+import type { MonitoringService } from '../types';
+/**
+ * 监控管理器
+ */
+export declare class MonitoringManager {
+    private monitoring?;
+    private enableMonitoring;
+    constructor(options?: {
+        monitoring?: MonitoringService;
+        enableMonitoring?: boolean;
+    });
+    /**
+     * 捕获错误
+     */
+    captureError(error: unknown, context?: Record<string, unknown>): void;
+    /**
+     * 追踪事件
+     */
+    trackEvent(eventName: string, properties?: Record<string, unknown>): void;
+    /**
+     * 上报性能指标
+     */
+    reportPerformance(metrics: Record<string, number>, context?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=MonitoringManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MonitoringManager.d.ts","sourceRoot":"","sources":["../../../../../src/managers/UserManager/observability/MonitoringManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAAC,CAAoB;IACvC,OAAO,CAAC,gBAAgB,CAAU;gBAEtB,OAAO,CAAC,EAAE;QACpB,UAAU,CAAC,EAAE,iBAAiB,CAAC;QAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B;IAKD;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAYrE;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAYzE;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAW5F"}

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

@@ -0,0 +1,44 @@
+/**
+ * 性能监控模块
+ * 封装 @vlian/framework MonitoringService，负责性能指标收集和上报
+ */
+import type { MonitoringService, PerformanceMetrics } from '../types';
+/**
+ * 性能监控器
+ */
+export declare class PerformanceMonitor {
+    private monitoring?;
+    private metricsCollector?;
+    private enableDetailedMetrics;
+    private metrics;
+    private maxMetricsSize;
+    constructor(options?: {
+        monitoring?: MonitoringService;
+        metricsCollector?: (metrics: PerformanceMetrics) => void;
+        enableDetailedMetrics?: boolean;
+        maxMetricsSize?: number;
+    });
+    /**
+     * 记录性能指标
+     */
+    recordMetric(operation: string, duration: number, metadata?: Record<string, unknown>): void;
+    /**
+     * 获取性能指标
+     */
+    getMetrics(): PerformanceMetrics[];
+    /**
+     * 清除性能指标
+     */
+    clearMetrics(): void;
+    /**
+     * 获取性能统计
+     */
+    getStatistics(operation?: string): {
+        count: number;
+        totalDuration: number;
+        averageDuration: number;
+        minDuration: number;
+        maxDuration: number;
+    };
+}
+//# sourceMappingURL=PerformanceMonitor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PerformanceMonitor.d.ts","sourceRoot":"","sources":["../../../../../src/managers/UserManager/observability/PerformanceMonitor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEtE;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,UAAU,CAAC,CAAoB;IACvC,OAAO,CAAC,gBAAgB,CAAC,CAAwC;IACjE,OAAO,CAAC,qBAAqB,CAAU;IACvC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,cAAc,CAAe;gBAEzB,OAAO,CAAC,EAAE;QACpB,UAAU,CAAC,EAAE,iBAAiB,CAAC;QAC/B,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;QACzD,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB;IAOD;;OAEG;IACH,YAAY,CACV,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAyCP;;OAEG;IACH,UAAU,IAAI,kBAAkB,EAAE;IAIlC;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG;QACjC,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB;CA6BF"}

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

@@ -0,0 +1,8 @@
+/**
+ * Observability 层导出
+ */
+export { EventManager } from './EventManager';
+export { PerformanceMonitor } from './PerformanceMonitor';
+export { LoggingManager } from './LoggingManager';
+export { MonitoringManager } from './MonitoringManager';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/managers/UserManager/observability/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,64 @@
+/**
+ * 队列管理模块
+ * 负责同步队列管理、队列合并优化
+ */
+import type { StorageInstance } from '../types';
+/**
+ * 队列项
+ */
+interface QueueItem {
+    type: 'userInfo' | 'userSettings';
+    userId: string;
+    data: unknown;
+    timestamp: number;
+    retryCount: number;
+}
+/**
+ * 队列管理器
+ */
+export declare class QueueManager {
+    private userInfoQueue;
+    private userSettingsQueue;
+    private storage?;
+    private storageKey;
+    private enablePersistence;
+    constructor(options?: {
+        storage?: StorageInstance;
+        storageKey?: string;
+        enablePersistence?: boolean;
+    });
+    /**
+     * 添加队列项
+     */
+    enqueue(type: 'userInfo' | 'userSettings', userId: string, data: unknown): void;
+    /**
+     * 获取队列项
+     */
+    dequeue(type: 'userInfo' | 'userSettings'): QueueItem | null;
+    /**
+     * 获取队列大小
+     */
+    getQueueSize(type: 'userInfo' | 'userSettings'): number;
+    /**
+     * 获取所有队列项（不删除）
+     */
+    peekAll(type: 'userInfo' | 'userSettings'): QueueItem[];
+    /**
+     * 清除队列
+     */
+    clear(type?: 'userInfo' | 'userSettings'): void;
+    /**
+     * 增加重试次数
+     */
+    incrementRetryCount(item: QueueItem): void;
+    /**
+     * 持久化队列到存储
+     */
+    private persistQueue;
+    /**
+     * 从存储恢复队列
+     */
+    private restoreQueue;
+}
+export {};
+//# sourceMappingURL=QueueManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"QueueManager.d.ts","sourceRoot":"","sources":["../../../../../src/managers/UserManager/runtime/QueueManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;GAEG;AACH,UAAU,SAAS;IACjB,IAAI,EAAE,UAAU,GAAG,cAAc,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,aAAa,CAAmB;IACxC,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,OAAO,CAAC,CAAkB;IAClC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,iBAAiB,CAAU;gBAEvB,OAAO,CAAC,EAAE;QACpB,OAAO,CAAC,EAAE,eAAe,CAAC;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC7B;IAaD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAuC/E;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS,GAAG,IAAI;IAkB5D;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,MAAM;IAMvD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS,EAAE;IAMvD;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,cAAc,GAAG,IAAI;IAoB/C;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAI1C;;OAEG;YACW,YAAY;IAiB1B;;OAEG;YACW,YAAY;CAiC3B"}

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

@@ -0,0 +1,86 @@
+/**
+ * 数据同步管理模块
+ * 负责用户信息/设置同步到服务器、同步队列管理、同步失败重试
+ */
+import type { Logger, SyncQueueStatus } from '../types';
+import { QueueManager } from './QueueManager';
+import { ErrorHandler } from '../modules/ErrorHandler';
+import { PerformanceMonitor } from '../observability/PerformanceMonitor';
+/**
+ * 同步管理器
+ */
+export declare class SyncManager {
+    private queueManager;
+    private errorHandler;
+    private performanceMonitor;
+    private logger?;
+    private syncStrategy;
+    private batchSyncDelay;
+    private syncRetryConfig;
+    private isSyncing;
+    private batchSyncTimer;
+    private lastSyncTime?;
+    private failedCount;
+    private userInfoUpdater?;
+    private userSettingsUpdater?;
+    constructor(options: {
+        queueManager: QueueManager;
+        errorHandler: ErrorHandler;
+        performanceMonitor: PerformanceMonitor;
+        logger?: Logger;
+        syncStrategy: 'immediate' | 'batch' | 'queue';
+        batchSyncDelay: number;
+        syncRetryConfig: {
+            maxRetries: number;
+            retryDelay: number;
+            backoffMultiplier: number;
+        };
+        userInfoUpdater?: (userId: string, userInfo: unknown) => Promise<unknown>;
+        userSettingsUpdater?: (userId: string, settings: unknown) => Promise<unknown>;
+    });
+    /**
+     * 同步用户信息
+     */
+    syncUserInfo(userId: string, userInfo: unknown): Promise<void>;
+    /**
+     * 同步用户设置
+     */
+    syncUserSettings(userId: string, settings: unknown): Promise<void>;
+    /**
+     * 立即同步用户信息
+     */
+    private syncUserInfoImmediate;
+    /**
+     * 批量同步用户信息
+     */
+    private syncUserInfoBatch;
+    /**
+     * 立即同步用户设置
+     */
+    private syncUserSettingsImmediate;
+    /**
+     * 批量同步用户设置
+     */
+    private syncUserSettingsBatch;
+    /**
+     * 处理批量同步
+     */
+    private processBatchSync;
+    /**
+     * 触发同步（队列策略）
+     */
+    private triggerSync;
+    /**
+     * 同步所有待同步的数据
+     */
+    syncAll(): Promise<void>;
+    /**
+     * 获取同步队列状态
+     */
+    getSyncQueueStatus(): SyncQueueStatus;
+    /**
+     * 清理资源
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=SyncManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SyncManager.d.ts","sourceRoot":"","sources":["../../../../../src/managers/UserManager/runtime/SyncManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAEzE;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,MAAM,CAAC,CAAS;IAExB,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAIrB;IAEF,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAa;IAGhC,OAAO,CAAC,eAAe,CAAC,CAA0D;IAClF,OAAO,CAAC,mBAAmB,CAAC,CAA0D;gBAE1E,OAAO,EAAE;QACnB,YAAY,EAAE,YAAY,CAAC;QAC3B,YAAY,EAAE,YAAY,CAAC;QAC3B,kBAAkB,EAAE,kBAAkB,CAAC;QACvC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;QAC9C,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE;YACf,UAAU,EAAE,MAAM,CAAC;YACnB,UAAU,EAAE,MAAM,CAAC;YACnB,iBAAiB,EAAE,MAAM,CAAC;SAC3B,CAAC;QACF,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1E,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAC/E;IAYD;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBpE;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBxE;;OAEG;YACW,qBAAqB;IAmBnC;;OAEG;YACW,iBAAiB;IAkB/B;;OAEG;YACW,yBAAyB;IAmBvC;;OAEG;YACW,qBAAqB;IAkBnC;;OAEG;YACW,gBAAgB;IA2C9B;;OAEG;YACW,WAAW;IAQzB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;OAEG;IACH,kBAAkB,IAAI,eAAe;IAUrC;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB"}

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

@@ -0,0 +1,6 @@
+/**
+ * Runtime 层导出
+ */
+export { SyncManager } from './SyncManager';
+export { QueueManager } from './QueueManager';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/managers/UserManager/runtime/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

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

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

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

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