@vlian/infrastructure 0.9.10

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/managers/ThemeManager/types.ts"],"sourcesContent":["/**\n * ThemeManager 类型定义\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 * 环境类型\n */\nexport type Environment = 'browser' | 'node' | 'ssr' | 'worker' | 'unknown';\n\n// ========== 事件类型 ==========\n\n/**\n * 主题事件类型枚举\n */\nexport enum ThemeEventType {\n  THEME_CHANGED = 'theme:changed',\n  THEME_CONFIG_UPDATED = 'theme:config:updated',\n  THEME_CONFIG_LOADED = 'theme:config:loaded',\n  THEME_CONFIG_CACHED = 'theme:config:cached',\n  THEME_CONFIG_CLEARED = 'theme:config:cleared',\n}\n\n/**\n * 事件元数据\n */\nexport interface EventMetadata {\n  timestamp: number;\n  instanceId?: 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 */\nexport interface ThemeChangedEventData {\n  previousTheme: string | null;\n  currentTheme: string;\n  timestamp: number;\n}\n\n/**\n * 主题配置更新事件数据\n */\nexport interface ThemeConfigUpdatedEventData<TThemeConfig = unknown> {\n  theme: string;\n  config: TThemeConfig;\n  previousConfig?: TThemeConfig;\n  timestamp: number;\n}\n\n// ========== 配置类型 ==========\n\n/**\n * ThemeManager 配置选项\n * @template TThemeConfig 主题配置类型，完全由用户定义\n */\nexport interface ThemeOptions<TThemeConfig = unknown> {\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  /**\n   * 是否启用日志（默认：false）\n   * 如果为 false，即使提供了 logger 也不会使用\n   */\n  enableLogging?: boolean;\n  \n  /**\n   * @vlian/framework Logger 实例（可选）\n   * 仅在 enableLogging=true 时使用\n   */\n  logger?: Logger;\n  \n  /**\n   * 是否启用监控（默认：false）\n   * 如果为 false，即使提供了 monitoring 也不会使用\n   */\n  enableMonitoring?: boolean;\n  \n  /**\n   * @vlian/framework MonitoringService 实例（可选）\n   * 仅在 enableMonitoring=true 时使用\n   * 用于错误监控、性能指标上报和用户行为追踪\n   */\n  monitoring?: MonitoringService;\n  \n  /**\n   * 是否启用事件（默认：false）\n   * 如果为 false，不会创建或使用事件总线\n   */\n  enableEvents?: boolean;\n  \n  /**\n   * @vlian/framework AppEventBus 实例（可选）\n   * 仅在 enableEvents=true 时使用\n   * 如果不提供且 enableEvents=true，内部会创建独立的事件总线\n   */\n  eventBus?: AppEventBus;\n  \n  // ========== 实例隔离配置 ==========\n  /**\n   * 实例隔离模式（默认：'isolated'）\n   * - 'isolated': 每个实例完全独立，不共享任何全局状态（默认，适用于小项目）\n   * - 'shared': 共享全局 EventBus/Monitoring（适用于微前端主应用）\n   * - 'hybrid': 事件独立，监控共享（适用于微前端子应用）\n   */\n  isolationMode?: 'isolated' | 'shared' | 'hybrid';\n  \n  // ========== 主题配置 ==========\n  /**\n   * 可用主题列表（可选）\n   * 如果不提供，通过 setTheme 动态添加\n   */\n  availableThemes?: string[];\n  \n  /**\n   * 默认主题（可选）\n   * 如果不提供，使用第一个可用主题或 'default'\n   */\n  defaultTheme?: string;\n  \n  /**\n   * 主题配置映射（可选）\n   * 主题名称 -> 主题配置对象\n   * 如果不提供，通过 setThemeConfig 动态设置\n   */\n  themeConfigs?: Record<string, TThemeConfig>;\n  \n  /**\n   * 默认主题配置（可选）\n   * 用于与用户配置合并\n   */\n  defaultThemeConfig?: TThemeConfig;\n  \n  // ========== 存储配置 ==========\n  /**\n   * 当前主题存储键名（默认：'theme:current'）\n   */\n  currentThemeKey?: string;\n  \n  /**\n   * 主题配置存储键名前缀（默认：'theme:config:'）\n   */\n  themeConfigKeyPrefix?: string;\n  \n  // ========== 事件配置 ==========\n  /**\n   * 事件命名空间前缀（默认：'theme:'）\n   * 用于在 AppEventBus 中隔离事件\n   * 仅在 enableEvents=true 时生效\n   */\n  eventNamespace?: string;\n  \n  // ========== 验证配置 ==========\n  /**\n   * 主题配置验证函数（可选）\n   * 验证主题配置格式\n   * @returns true 表示验证通过，string 表示验证失败的错误信息\n   */\n  themeConfigValidator?: (config: TThemeConfig) => true | string;\n  \n  // ========== CSS 变量配置 ==========\n  /**\n   * CSS 变量前缀（默认：'--theme'）\n   */\n  cssVariablePrefix?: string;\n  \n  /**\n   * CSS 变量格式化函数（可选）\n   * 自定义 CSS 变量名称格式化\n   */\n  cssVariableFormatter?: (key: string, value: unknown) => string;\n  \n  // ========== 缓存配置 ==========\n  /**\n   * 是否启用主题配置缓存（默认：true）\n   */\n  enableCache?: boolean;\n  \n  /**\n   * 缓存过期时间（毫秒，默认：不过期）\n   */\n  cacheExpiry?: number;\n  \n  // ========== 性能配置 ==========\n  /**\n   * 是否启用详细性能指标（默认：false）\n   * 仅在 enableMonitoring=true 时生效\n   */\n  enableDetailedMetrics?: boolean;\n  \n  // ========== 并发控制配置 ==========\n  /**\n   * 并发控制策略（默认：'queue'）\n   * - 'queue': 串行队列，保证顺序执行（默认，推荐）\n   * - 'version': 版本号机制，只应用最新操作\n   * - 'none': 无控制，允许并发（不推荐，可能导致竞态条件）\n   */\n  concurrencyStrategy?: 'queue' | 'version' | 'none';\n  \n  /**\n   * 队列最大长度（默认：100）\n   * 当使用 'queue' 策略时，超过此长度会拒绝新操作并抛出错误\n   */\n  maxQueueSize?: number;\n  \n  /**\n   * 操作超时时间（毫秒，默认：30000，即30秒）\n   * 当操作超过此时间时，会触发超时错误\n   */\n  operationTimeout?: number;\n  \n  // ========== 生命周期钩子配置 ==========\n  /**\n   * 生命周期钩子（可选）\n   * 用于在关键操作前后执行自定义逻辑\n   */\n  hooks?: LifecycleHooks<TThemeConfig>;\n  \n  // ========== 其他配置 ==========\n  /**\n   * 实例 ID（可选）\n   * 用于多实例隔离\n   * 如果不提供，会自动生成唯一 ID\n   */\n  instanceId?: string;\n}\n\n/**\n * 主题配置类型\n * 完全由用户定义，ThemeManager 不做任何假设\n * @template TThemeConfig 主题配置类型\n */\nexport type ThemeConfig<TThemeConfig = unknown> = TThemeConfig;\n\n// ========== 错误类型 ==========\n\n/**\n * 主题错误代码\n */\nexport enum ThemeErrorCode {\n  UNKNOWN_ERROR = 'THEME_UNKNOWN_ERROR',\n  THEME_NOT_FOUND = 'THEME_NOT_FOUND',\n  THEME_CONFIG_NOT_FOUND = 'THEME_CONFIG_NOT_FOUND',\n  VALIDATION_FAILED = 'THEME_VALIDATION_FAILED',\n  STORAGE_ERROR = 'THEME_STORAGE_ERROR',\n  CONCURRENCY_ERROR = 'THEME_CONCURRENCY_ERROR',\n  OPERATION_TIMEOUT = 'THEME_OPERATION_TIMEOUT',\n  QUEUE_OVERFLOW = 'THEME_QUEUE_OVERFLOW',\n}\n\n/**\n * 主题错误类\n */\nexport class ThemeError extends Error {\n  public readonly code: ThemeErrorCode;\n  public readonly context?: Record<string, unknown>;\n  public readonly originalError?: Error;\n\n  constructor(\n    message: string,\n    code: ThemeErrorCode = ThemeErrorCode.UNKNOWN_ERROR,\n    context?: Record<string, unknown>,\n    originalError?: Error\n  ) {\n    super(message);\n    this.name = 'ThemeError';\n    this.code = code;\n    this.context = context;\n    this.originalError = originalError;\n    \n    // 保持堆栈跟踪\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, ThemeError);\n    }\n  }\n}\n\n// ========== 健康检查和性能指标 ==========\n\n/**\n * 健康检查结果\n */\nexport interface HealthCheckResult {\n  healthy: boolean;\n  checks: {\n    storage: { healthy: boolean; error?: string };\n    stateManager?: { healthy: boolean; error?: string };\n    eventBus?: { healthy: boolean; error?: string };\n    cache: { healthy: boolean; error?: string };\n  };\n  timestamp: number;\n}\n\n/**\n * 性能指标\n */\nexport interface PerformanceMetrics {\n  operation: string;\n  duration: number;\n  timestamp: number;\n  [key: string]: unknown;\n}\n\n/**\n * 配置验证结果\n */\nexport interface ConfigValidationResult {\n  valid: boolean;\n  errors: string[];\n  warnings: string[];\n}\n\n// ========== 生命周期钩子类型 ==========\n\n/**\n * 生命周期钩子函数类型\n */\nexport type LifecycleHook<T = unknown> = (context: T) => void | Promise<void>;\n\n/**\n * 主题切换前钩子上下文\n */\nexport interface BeforeThemeChangeContext {\n  previousTheme: string | null;\n  newTheme: string;\n  cancel: () => void;\n}\n\n/**\n * 主题切换后钩子上下文\n */\nexport interface AfterThemeChangeContext {\n  previousTheme: string | null;\n  currentTheme: string;\n}\n\n/**\n * 配置更新前钩子上下文\n */\nexport interface BeforeConfigUpdateContext<TThemeConfig = unknown> {\n  theme: string;\n  currentConfig: TThemeConfig | null;\n  newConfig: Partial<TThemeConfig>;\n  cancel: () => void;\n}\n\n/**\n * 配置更新后钩子上下文\n */\nexport interface AfterConfigUpdateContext<TThemeConfig = unknown> {\n  theme: string;\n  previousConfig: TThemeConfig | null;\n  currentConfig: TThemeConfig;\n}\n\n/**\n * 生命周期钩子配置\n */\nexport interface LifecycleHooks<TThemeConfig = unknown> {\n  /**\n   * 初始化钩子（实例初始化时执行）\n   */\n  onInit?: LifecycleHook<void>;\n  \n  /**\n   * 销毁钩子（实例销毁时执行）\n   */\n  onDestroy?: LifecycleHook<void>;\n  \n  /**\n   * 主题切换前钩子\n   */\n  beforeThemeChange?: LifecycleHook<BeforeThemeChangeContext>;\n  \n  /**\n   * 主题切换后钩子\n   */\n  afterThemeChange?: LifecycleHook<AfterThemeChangeContext>;\n  \n  /**\n   * 配置更新前钩子\n   */\n  beforeConfigUpdate?: LifecycleHook<BeforeConfigUpdateContext<TThemeConfig>>;\n  \n  /**\n   * 配置更新后钩子\n   */\n  afterConfigUpdate?: LifecycleHook<AfterConfigUpdateContext<TThemeConfig>>;\n}\n\n// ========== 缓存统计类型 ==========\n\n/**\n * 缓存统计信息\n */\nexport interface CacheStatistics {\n  /**\n   * 缓存大小（项数）\n   */\n  size: number;\n  \n  /**\n   * 缓存命中次数\n   */\n  hits: number;\n  \n  /**\n   * 缓存未命中次数\n   */\n  misses: number;\n  \n  /**\n   * 缓存命中率（0-1）\n   */\n  hitRate: number;\n  \n  /**\n   * 所有缓存键\n   */\n  keys: string[];\n}\n\n// ========== 批量更新类型 ==========\n\n/**\n * 批量更新项\n */\nexport interface BatchUpdateItem<TThemeConfig = unknown> {\n  theme: string;\n  config: Partial<TThemeConfig>;\n}\n\n/**\n * 批量更新结果\n */\nexport interface BatchUpdateResult<TThemeConfig = unknown> {\n  /**\n   * 成功更新的主题\n   */\n  success: Record<string, TThemeConfig>;\n  \n  /**\n   * 失败的主题及错误信息\n   */\n  errors: Record<string, string>;\n  \n  /**\n   * 总数量\n   */\n  total: number;\n  \n  /**\n   * 成功数量\n   */\n  successCount: number;\n  \n  /**\n   * 失败数量\n   */\n  errorCount: number;\n}\n"],"names":["ThemeError","ThemeErrorCode","ThemeEventType","Error","message","code","context","originalError","name","captureStackTrace"],"mappings":"AAAA;;;CAGC,GAED,iCAAiC;AAEjC;;CAEC;;;;;;;;;;;QA2VYA;eAAAA;;QAdDC;eAAAA;;QA9PAC;eAAAA;;;;;;;;;;;;;;;;AAAL,IAAA,AAAKA,wCAAAA;;;;;;WAAAA;;AA8PL,IAAA,AAAKD,wCAAAA;;;;;;;;;WAAAA;;AAcL,IAAA,AAAMD,aAAN,MAAMA,mBAAmBG;IAK9B,YACEC,OAAe,EACfC,4BAAmD,EACnDC,OAAiC,EACjCC,aAAqB,CACrB;QACA,KAAK,CAACH,UAVR,uBAAgBC,QAAhB,KAAA,IACA,uBAAgBC,WAAhB,KAAA,IACA,uBAAgBC,iBAAhB,KAAA;QASE,IAAI,CAACC,IAAI,GAAG;QACZ,IAAI,CAACH,IAAI,GAAGA;QACZ,IAAI,CAACC,OAAO,GAAGA;QACf,IAAI,CAACC,aAAa,GAAGA;QAErB,SAAS;QACT,IAAIJ,MAAMM,iBAAiB,EAAE;YAC3BN,MAAMM,iBAAiB,CAAC,IAAI,EAAET;QAChC;IACF;AACF"}

package/dist/cjs/managers/ThemeManager/utils/IsolationUtils.js

@@ -0,0 +1,46 @@
+/**
+ * 实例隔离工具
+ * 管理实例隔离和命名空间
+ */ /**
+ * 生成唯一实例 ID
+ */ "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 createIsolationConfig () {
+        return createIsolationConfig;
+    },
+    get createNamespacePrefix () {
+        return createNamespacePrefix;
+    },
+    get generateInstanceId () {
+        return generateInstanceId;
+    }
+});
+function generateInstanceId() {
+    return `theme_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+}
+function createNamespacePrefix(baseNamespace, instanceId) {
+    if (!instanceId) {
+        return baseNamespace;
+    }
+    return `${baseNamespace}${instanceId}:`;
+}
+function createIsolationConfig(mode, instanceId, baseEventNamespace = 'theme:') {
+    const id = instanceId || generateInstanceId();
+    const eventNamespace = mode === 'isolated' || mode === 'hybrid' ? createNamespacePrefix(baseEventNamespace, id) : baseEventNamespace;
+    return {
+        mode,
+        instanceId: id,
+        eventNamespace
+    };
+}
+
+//# sourceMappingURL=IsolationUtils.js.map

package/dist/cjs/managers/ThemeManager/utils/IsolationUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/ThemeManager/utils/IsolationUtils.ts"],"sourcesContent":["/**\n * 实例隔离工具\n * 管理实例隔离和命名空间\n */\n\n/**\n * 生成唯一实例 ID\n */\nexport function generateInstanceId(): string {\n  return `theme_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;\n}\n\n/**\n * 创建命名空间前缀\n */\nexport function createNamespacePrefix(baseNamespace: string, instanceId?: string): string {\n  if (!instanceId) {\n    return baseNamespace;\n  }\n  return `${baseNamespace}${instanceId}:`;\n}\n\n/**\n * 隔离模式配置\n */\nexport interface IsolationConfig {\n  mode: 'isolated' | 'shared' | 'hybrid';\n  instanceId: string;\n  eventNamespace: string;\n}\n\n/**\n * 创建隔离配置\n */\nexport function createIsolationConfig(\n  mode: 'isolated' | 'shared' | 'hybrid',\n  instanceId?: string,\n  baseEventNamespace: string = 'theme:'\n): IsolationConfig {\n  const id = instanceId || generateInstanceId();\n  const eventNamespace = mode === 'isolated' || mode === 'hybrid'\n    ? createNamespacePrefix(baseEventNamespace, id)\n    : baseEventNamespace;\n\n  return {\n    mode,\n    instanceId: id,\n    eventNamespace,\n  };\n}\n"],"names":["createIsolationConfig","createNamespacePrefix","generateInstanceId","Date","now","Math","random","toString","substring","baseNamespace","instanceId","mode","baseEventNamespace","id","eventNamespace"],"mappings":"AAAA;;;CAGC,GAED;;CAEC;;;;;;;;;;;QA2BeA;eAAAA;;QAnBAC;eAAAA;;QAPAC;eAAAA;;;AAAT,SAASA;IACd,OAAO,CAAC,MAAM,EAAEC,KAAKC,GAAG,GAAG,CAAC,EAAEC,KAAKC,MAAM,GAAGC,QAAQ,CAAC,IAAIC,SAAS,CAAC,GAAG,IAAI;AAC5E;AAKO,SAASP,sBAAsBQ,aAAqB,EAAEC,UAAmB;IAC9E,IAAI,CAACA,YAAY;QACf,OAAOD;IACT;IACA,OAAO,GAAGA,gBAAgBC,WAAW,CAAC,CAAC;AACzC;AAcO,SAASV,sBACdW,IAAsC,EACtCD,UAAmB,EACnBE,qBAA6B,QAAQ;IAErC,MAAMC,KAAKH,cAAcR;IACzB,MAAMY,iBAAiBH,SAAS,cAAcA,SAAS,WACnDV,sBAAsBW,oBAAoBC,MAC1CD;IAEJ,OAAO;QACLD;QACAD,YAAYG;QACZC;IACF;AACF"}

package/dist/cjs/managers/ThemeManager/utils/index.js

@@ -0,0 +1,22 @@
+/**
+ * 工具函数导出
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+_export_star(require("./IsolationUtils"), exports);
+function _export_star(from, to) {
+    Object.keys(from).forEach(function(k) {
+        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
+            Object.defineProperty(to, k, {
+                enumerable: true,
+                get: function() {
+                    return from[k];
+                }
+            });
+        }
+    });
+    return from;
+}
+
+//# sourceMappingURL=index.js.map

package/dist/cjs/managers/ThemeManager/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/ThemeManager/utils/index.ts"],"sourcesContent":["/**\n * 工具函数导出\n */\n\nexport * from './IsolationUtils';\n"],"names":[],"mappings":"AAAA;;CAEC;;;;qBAEa"}

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

@@ -0,0 +1,508 @@
+/**
+ * UserManager - 用户管理器
+ * 
+ * 提供用户信息和用户设置管理能力
+ * 完全泛型化，用户信息类型由用户定义
+ * 基于 @vlian/framework 的 Storage、StateManager 和 AppEventBus
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "UserManager", {
+    enumerable: true,
+    get: function() {
+        return UserManager;
+    }
+});
+const _types = require("./types");
+const _constants = require("./constants");
+const _ConcurrencyController = require("./core/ConcurrencyController");
+const _StateManagerWrapper = require("./core/StateManagerWrapper");
+const _CacheManager = require("./core/CacheManager");
+const _SyncManager = require("./runtime/SyncManager");
+const _QueueManager = require("./runtime/QueueManager");
+const _EventManager = require("./observability/EventManager");
+const _PerformanceMonitor = require("./observability/PerformanceMonitor");
+const _LoggingManager = require("./observability/LoggingManager");
+const _MonitoringManager = require("./observability/MonitoringManager");
+const _modules = require("./modules");
+const _core = require("./core");
+const _UserValidator = require("./core/UserValidator");
+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 UserManager = class UserManager {
+    /**
+   * 初始化所有模块
+   */ initializeModules() {
+        // 初始化公共模块
+        this.storageManager = new _modules.StorageManager({
+            storage: this.options.storage || {
+                strategy: 'local'
+            },
+            environment: this.environment,
+            logger: this.options.logger
+        });
+        this.errorHandler = new _modules.ErrorHandler({
+            logger: this.options.logger,
+            monitoring: this.options.monitoring,
+            sanitizeErrors: this.isProduction
+        });
+        // 初始化 Observability 层
+        this.loggingManager = new _LoggingManager.LoggingManager({
+            logger: this.options.logger,
+            enableLogging: this.options.enableLogging,
+            context: {
+                instanceId: this.options.instanceId
+            }
+        });
+        this.monitoringManager = new _MonitoringManager.MonitoringManager({
+            monitoring: this.options.monitoring,
+            enableMonitoring: this.options.enableMonitoring
+        });
+        this.performanceMonitor = new _PerformanceMonitor.PerformanceMonitor({
+            monitoring: this.options.monitoring,
+            enableDetailedMetrics: this.options.enableDetailedMetrics
+        });
+        this.eventManager = new _EventManager.EventManager({
+            eventBus: this.options.eventBus,
+            eventNamespace: this.options.eventNamespace,
+            enableEvents: this.options.enableEvents,
+            logger: this.options.enableLogging ? {
+                debug: (...args)=>this.loggingManager.debug(...args),
+                error: (...args)=>this.loggingManager.error(...args)
+            } : undefined,
+            monitoring: this.options.enableMonitoring ? {
+                trackEvent: (name, props)=>this.monitoringManager.trackEvent(name, props),
+                captureError: (error, ctx)=>this.monitoringManager.captureError(error, ctx)
+            } : undefined
+        });
+        // 初始化 Core 层
+        this.stateManager = this.options.stateManager ? new _StateManagerWrapper.StateManagerWrapper({
+            stateManager: this.options.stateManager,
+            logger: this.options.logger
+        }) : undefined;
+        this.cacheManager = new _CacheManager.CacheManager({
+            defaultTTL: this.options.userInfoCacheExpiry
+        });
+        this.settingsCacheManager = new _CacheManager.CacheManager({
+            defaultTTL: undefined
+        });
+        this.concurrencyController = new _ConcurrencyController.ConcurrencyController({
+            strategy: this.options.concurrencyStrategy,
+            maxQueueSize: this.options.maxQueueSize,
+            operationTimeout: this.options.operationTimeout
+        });
+        // 初始化 Validator 和 UserCore
+        this.validator = new _UserValidator.UserValidator({
+            userInfoValidator: this.options.userInfoValidator,
+            userSettingsValidator: this.options.userSettingsValidator
+        });
+        // UserCore 已集成到 UserInfoManager 和 UserSettingsManager 中
+        // this.userCore = new UserCore({
+        //   cacheManager: this.cacheManager,
+        //   settingsCacheManager: this.settingsCacheManager,
+        //   stateManager: this.stateManager,
+        //   concurrencyController: this.concurrencyController,
+        //   validator: this.validator,
+        //   authManager: this.options.authManager,
+        // });
+        // 初始化 Runtime 层
+        this.queueManager = new _QueueManager.QueueManager({
+            storage: this.storageManager.getStorage(),
+            storageKey: `user_sync_queue_${this.options.instanceId || 'default'}`,
+            enablePersistence: this.options.enableOfflineQueue
+        });
+        this.syncManager = new _SyncManager.SyncManager({
+            queueManager: this.queueManager,
+            errorHandler: this.errorHandler,
+            performanceMonitor: this.performanceMonitor,
+            logger: this.options.logger,
+            syncStrategy: this.options.syncStrategy,
+            batchSyncDelay: this.options.batchSyncDelay,
+            syncRetryConfig: {
+                maxRetries: this.options.syncRetryConfig.maxRetries ?? _constants.DEFAULT_OPTIONS.syncRetryConfig.maxRetries,
+                retryDelay: this.options.syncRetryConfig.retryDelay ?? _constants.DEFAULT_OPTIONS.syncRetryConfig.retryDelay,
+                backoffMultiplier: this.options.syncRetryConfig.backoffMultiplier ?? _constants.DEFAULT_OPTIONS.syncRetryConfig.backoffMultiplier
+            },
+            userInfoUpdater: this.options.userInfoUpdater,
+            userSettingsUpdater: this.options.userSettingsUpdater
+        });
+        // 初始化 Core 层业务管理器
+        this.userInfoManager = new _core.UserInfoManager({
+            authManager: this.options.authManager,
+            cacheManager: this.cacheManager,
+            stateManager: this.stateManager,
+            syncManager: this.syncManager,
+            errorHandler: this.errorHandler,
+            performanceMonitor: this.performanceMonitor,
+            eventManager: this.eventManager,
+            concurrencyController: this.concurrencyController,
+            validator: this.validator,
+            logger: this.options.logger,
+            monitoring: this.options.monitoring,
+            userInfoFetcher: this.options.userInfoFetcher,
+            userInfoUpdater: this.options.userInfoUpdater,
+            enableCache: this.options.enableUserInfoCache,
+            cacheExpiry: this.options.userInfoCacheExpiry
+        });
+        this.userSettingsManager = new _core.UserSettingsManager({
+            authManager: this.options.authManager,
+            cacheManager: this.settingsCacheManager,
+            storageManager: this.storageManager,
+            syncManager: this.syncManager,
+            errorHandler: this.errorHandler,
+            performanceMonitor: this.performanceMonitor,
+            eventManager: this.eventManager,
+            concurrencyController: this.concurrencyController,
+            validator: this.validator,
+            logger: this.options.logger,
+            monitoring: this.options.monitoring,
+            userSettingsFetcher: this.options.userSettingsFetcher,
+            userSettingsUpdater: this.options.userSettingsUpdater,
+            userSettingsKey: this.options.userSettingsKey,
+            enableCache: this.options.enableUserSettingsCache
+        });
+    }
+    /**
+   * 初始化时自动加载用户信息和设置
+   */ async initializeAutoLoad() {
+        // 检查用户是否已认证
+        if (!this.options.authManager.isAuthenticated()) {
+            if (this.options.devMode) {
+                this.options.logger?.debug('User is not authenticated, skipping auto load');
+            }
+            return;
+        }
+        const userId = this.options.authManager.getUserId();
+        if (!userId) {
+            return;
+        }
+        // 自动加载用户信息
+        if (this.options.autoLoadUserInfoOnInit && this.options.userInfoFetcher) {
+            if (this.options.devMode) {
+                this.options.logger?.debug('Auto loading user info on init', {
+                    userId
+                });
+            }
+            // 异步加载，不阻塞初始化
+            this.refreshUserInfo().catch((error)=>{
+                this.options.logger?.warn('Failed to auto load user info on init:', error);
+                this.options.monitoring?.captureError(error, {
+                    operation: 'autoLoadUserInfoOnInit',
+                    userId
+                });
+            });
+        }
+        // 自动加载用户设置
+        if (this.options.autoLoadUserSettingsOnInit) {
+            if (this.options.devMode) {
+                this.options.logger?.debug('Auto loading user settings on init', {
+                    userId
+                });
+            }
+            // 优先从服务器获取，如果没有 fetcher 则从本地存储加载
+            if (this.options.userSettingsFetcher) {
+                // 异步加载，不阻塞初始化
+                this.refreshUserSettings().catch((error)=>{
+                    this.options.logger?.warn('Failed to auto load user settings on init:', error);
+                    this.options.monitoring?.captureError(error, {
+                        operation: 'autoLoadUserSettingsOnInit',
+                        userId
+                    });
+                });
+            } else {
+                // 从本地存储加载
+                this.loadUserSettings().catch((error)=>{
+                    this.options.logger?.warn('Failed to auto load user settings from storage on init:', error);
+                    this.options.monitoring?.captureError(error, {
+                        operation: 'autoLoadUserSettingsOnInit',
+                        userId
+                    });
+                });
+            }
+        }
+    }
+    /**
+   * 验证配置
+   */ validateConfig(options) {
+        const errors = [];
+        const warnings = [];
+        // 验证事件命名空间
+        if (options.eventNamespace && !options.eventNamespace.endsWith(':')) {
+            warnings.push('eventNamespace should end with ":" for better isolation');
+        }
+        // 验证实例 ID
+        if (options.instanceId && !/^[a-zA-Z0-9_-]+$/.test(options.instanceId)) {
+            errors.push('instanceId must contain only alphanumeric characters, hyphens, and underscores');
+        }
+        // 验证同步配置
+        if (options.syncStrategy === 'batch' && options.batchSyncDelay < 0) {
+            errors.push('batchSyncDelay must be non-negative');
+        }
+        if (options.syncRetryConfig?.maxRetries !== undefined && options.syncRetryConfig.maxRetries < 0) {
+            errors.push('syncRetryConfig.maxRetries must be non-negative');
+        }
+        if (options.syncRetryConfig?.retryDelay !== undefined && options.syncRetryConfig.retryDelay < 0) {
+            errors.push('syncRetryConfig.retryDelay must be non-negative');
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings
+        };
+    }
+    // ========== 用户信息管理 API ==========
+    /**
+   * 获取用户信息
+   */ getUserInfo() {
+        return this.userInfoManager.getUserInfo();
+    }
+    /**
+   * 更新用户信息
+   */ async updateUserInfo(userInfo) {
+        return this.userInfoManager.updateUserInfo(userInfo);
+    }
+    /**
+   * 刷新用户信息
+   */ async refreshUserInfo(force) {
+        return this.userInfoManager.refreshUserInfo(force);
+    }
+    /**
+   * 清除用户信息缓存
+   */ clearUserInfoCache() {
+        this.userInfoManager.clearCache();
+    }
+    // ========== 用户设置管理 API ==========
+    /**
+   * 获取用户设置（同步，从缓存获取）
+   * 注意：如果缓存中没有，需要调用 loadUserSettings 异步加载
+   */ getUserSettings() {
+        return this.userSettingsManager.getUserSettings();
+    }
+    /**
+   * 从存储加载用户设置（异步）
+   */ async loadUserSettings() {
+        return this.userSettingsManager.loadUserSettings();
+    }
+    /**
+   * 更新用户设置
+   */ async updateUserSettings(settings) {
+        return this.userSettingsManager.updateUserSettings(settings);
+    }
+    /**
+   * 刷新用户设置
+   */ async refreshUserSettings(force) {
+        return this.userSettingsManager.refreshUserSettings(force);
+    }
+    /**
+   * 清除用户设置缓存
+   */ clearUserSettingsCache() {
+        this.userSettingsManager.clearCache();
+    }
+    // ========== 数据同步 API ==========
+    /**
+   * 同步所有待同步的数据
+   */ async syncAll() {
+        return this.syncManager.syncAll();
+    }
+    /**
+   * 获取同步队列状态
+   */ getSyncQueueStatus() {
+        return this.syncManager.getSyncQueueStatus();
+    }
+    // ========== 事件订阅 API ==========
+    /**
+   * 订阅事件
+   */ on(event, listener, options) {
+        return this.eventManager.on(event, listener, options);
+    }
+    /**
+   * 取消订阅
+   */ off(event, listener) {
+        return this.eventManager.off(event, listener);
+    }
+    /**
+   * 一次性订阅
+   */ once(event, listener) {
+        return this.eventManager.once(event, listener);
+    }
+    // ========== 高级 API ==========
+    /**
+   * 健康检查
+   */ async healthCheck() {
+        const checks = {
+            storage: true,
+            stateManager: true,
+            eventBus: true,
+            cache: true,
+            syncQueue: true
+        };
+        try {
+            // 检查存储
+            await this.storageManager.get('__health_check__');
+        } catch  {
+            checks.storage = false;
+        }
+        // 检查状态管理
+        if (this.stateManager) {
+            try {
+                this.stateManager.get('__health_check__');
+            } catch  {
+                checks.stateManager = false;
+            }
+        }
+        // 检查事件总线（总是可用，因为内部有 fallback）
+        checks.eventBus = true;
+        // 检查缓存
+        checks.cache = this.cacheManager.size() >= 0;
+        // 检查同步队列
+        const queueStatus = this.getSyncQueueStatus();
+        checks.syncQueue = queueStatus.pendingUserInfo >= 0 && queueStatus.pendingUserSettings >= 0;
+        // 计算健康状态
+        const failedChecks = Object.values(checks).filter((v)=>!v).length;
+        let status;
+        if (failedChecks === 0) {
+            status = 'healthy';
+        } else if (failedChecks <= 2) {
+            status = 'degraded';
+        } else {
+            status = 'unhealthy';
+        }
+        return {
+            status,
+            checks,
+            details: {
+                environment: this.environment,
+                instanceId: this.options.instanceId,
+                queueStatus
+            }
+        };
+    }
+    /**
+   * 获取性能指标
+   */ getPerformanceMetrics() {
+        return this.performanceMonitor.getMetrics();
+    }
+    /**
+   * 清除性能指标
+   */ clearPerformanceMetrics() {
+        this.performanceMonitor.clearMetrics();
+    }
+    /**
+   * 销毁实例
+   */ destroy() {
+        // 清理 Runtime 层
+        this.syncManager.destroy();
+        this.queueManager.clear();
+        // 清理 Observability 层
+        this.eventManager.destroy();
+        // 清理 Core 层
+        this.concurrencyController.clear();
+        this.cacheManager.clear();
+        this.settingsCacheManager.clear();
+        this.loggingManager?.debug('UserManager destroyed');
+    }
+    /**
+   * 构造函数
+   */ constructor(options){
+        _define_property(this, "options", void 0);
+        _define_property(this, "environment", void 0);
+        _define_property(this, "isProduction", void 0);
+        // 模块实例（在 initializeModules() 中初始化）
+        _define_property(this, "storageManager", void 0);
+        _define_property(this, "stateManager", void 0);
+        _define_property(this, "errorHandler", void 0);
+        // Core 层
+        _define_property(this, "cacheManager", void 0);
+        _define_property(this, "settingsCacheManager", void 0);
+        _define_property(this, "concurrencyController", void 0);
+        _define_property(this, "validator", void 0);
+        // private userCore!: UserCore<TUserInfo, TUserSettings>; // 已集成到 UserInfoManager 和 UserSettingsManager 中
+        // Core 层业务管理器
+        _define_property(this, "userInfoManager", void 0);
+        _define_property(this, "userSettingsManager", void 0);
+        // Runtime 层
+        _define_property(this, "queueManager", void 0);
+        _define_property(this, "syncManager", void 0);
+        // Observability 层
+        _define_property(this, "loggingManager", void 0);
+        _define_property(this, "monitoringManager", void 0);
+        _define_property(this, "performanceMonitor", void 0);
+        _define_property(this, "eventManager", void 0);
+        // 检测环境
+        this.environment = _modules.EnvironmentDetector.detectEnvironment();
+        this.isProduction = _modules.EnvironmentDetector.checkIsProduction();
+        // 验证必需配置
+        if (!options.authManager) {
+            throw new _types.UserError('authManager is required', _types.UserErrorCode.UNKNOWN_ERROR);
+        }
+        // 合并默认配置
+        this.options = {
+            ..._constants.DEFAULT_OPTIONS,
+            ...options,
+            authManager: options.authManager,
+            storage: options.storage,
+            stateManager: options.stateManager,
+            eventBus: options.eventBus,
+            logger: options.logger,
+            monitoring: options.monitoring,
+            userInfoFetcher: options.userInfoFetcher,
+            userInfoUpdater: options.userInfoUpdater,
+            userInfoValidator: options.userInfoValidator,
+            userSettingsFetcher: options.userSettingsFetcher,
+            userSettingsUpdater: options.userSettingsUpdater,
+            userSettingsValidator: options.userSettingsValidator,
+            metricsCollector: options.metricsCollector,
+            instanceId: options.instanceId
+        };
+        // 应用生产环境覆盖
+        if (this.isProduction) {
+            this.options = {
+                ...this.options,
+                ..._constants.PRODUCTION_OVERRIDES
+            };
+        }
+        // 配置验证
+        if (this.options.validateConfig !== false) {
+            const validation = this.validateConfig(this.options);
+            if (!validation.valid) {
+                const errorMsg = `Configuration validation failed: ${validation.errors.join(', ')}`;
+                if (this.options.devMode) {
+                    throw new _types.UserError(`${errorMsg}\nWarnings: ${validation.warnings.join(', ')}`, _types.UserErrorCode.UNKNOWN_ERROR);
+                } else {
+                    throw new _types.UserError(errorMsg, _types.UserErrorCode.UNKNOWN_ERROR);
+                }
+            }
+            if (validation.warnings.length > 0 && this.options.devMode) {
+                validation.warnings.forEach((warning)=>{
+                    this.options.logger?.warn(`Config warning: ${warning}`);
+                });
+            }
+        }
+        // 初始化模块
+        this.initializeModules();
+        // 开发模式日志
+        if (this.options.devMode && this.options.enableLogging) {
+            this.loggingManager?.debug('UserManager initialized', {
+                environment: this.environment,
+                isProduction: this.isProduction,
+                instanceId: this.options.instanceId
+            });
+        }
+        // 初始化时自动加载数据
+        this.initializeAutoLoad();
+    }
+};
+
+//# sourceMappingURL=UserManager.js.map