@vlian/infrastructure 0.9.10

package/dist/cjs/managers/AuthManager/modules/runtime/RefreshScheduler.js

@@ -0,0 +1,248 @@
+/**
+ * 自动刷新调度模块
+ * 负责 Token 自动刷新的调度、页面可见性监听、网络状态监听
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "RefreshScheduler", {
+    enumerable: true,
+    get: function() {
+        return RefreshScheduler;
+    }
+});
+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 RefreshScheduler = class RefreshScheduler {
+    /**
+   * 设置页面可见性监听器
+   */ setupVisibilityListener() {
+        // 类型安全的 document 检查
+        const doc = typeof globalThis !== 'undefined' && 'document' in globalThis ? globalThis.document : undefined;
+        if (!doc || typeof doc.hidden === 'undefined') {
+            return;
+        }
+        // 检查初始状态
+        this.isPageVisible = !doc.hidden;
+        this.visibilityHandler = ()=>{
+            const wasVisible = this.isPageVisible;
+            const currentDoc = typeof globalThis !== 'undefined' && 'document' in globalThis ? globalThis.document : undefined;
+            this.isPageVisible = currentDoc ? !currentDoc.hidden : true;
+            if (wasVisible !== this.isPageVisible) {
+                this.logger?.debug(`Page visibility changed: ${this.isPageVisible ? 'visible' : 'hidden'}`);
+                if (this.isPageVisible) {
+                    // 页面变为可见，恢复自动刷新
+                    if (this.autoRefresh && this.onCheckAndRefresh) {
+                        this.startAutoRefresh();
+                        // 立即检查一次 Token
+                        this.onCheckAndRefresh().catch((error)=>{
+                            this.logger?.error('Failed to check token after page visible:', error);
+                        });
+                    }
+                } else {
+                    // 页面隐藏，暂停自动刷新
+                    this.stopAutoRefresh();
+                }
+            }
+        };
+        // 使用标准 API 名称
+        const visibilityChangeEvent = 'visibilitychange';
+        if (doc.addEventListener) {
+            doc.addEventListener(visibilityChangeEvent, this.visibilityHandler);
+        }
+        this.logger?.debug('Page visibility listener setup');
+    }
+    /**
+   * 移除页面可见性监听器
+   */ removeVisibilityListener() {
+        if (!this.visibilityHandler) {
+            return;
+        }
+        const doc = typeof globalThis !== 'undefined' && 'document' in globalThis ? globalThis.document : undefined;
+        if (doc && doc.removeEventListener) {
+            doc.removeEventListener('visibilitychange', this.visibilityHandler);
+            this.visibilityHandler = null;
+            this.logger?.debug('Page visibility listener removed');
+        }
+    }
+    /**
+   * 设置网络状态监听器
+   */ setupNetworkStatusListener(customListener) {
+        if (this.environment !== 'browser') {
+            return;
+        }
+        const globalWindow = typeof globalThis !== 'undefined' && 'window' in globalThis ? globalThis.window : undefined;
+        const globalNavigator = typeof globalThis !== 'undefined' && 'navigator' in globalThis ? globalThis.navigator : undefined;
+        const handleOnline = ()=>{
+            this.networkOnline = true;
+            this.logger?.debug('Network status: online');
+            customListener?.onOnline?.();
+            // 恢复自动刷新
+            if (this.autoRefresh && this.onCheckAndRefresh) {
+                this.startAutoRefresh();
+                // 立即检查一次 Token
+                this.onCheckAndRefresh().catch((error)=>{
+                    this.logger?.error('Failed to check token after network online:', error);
+                });
+            }
+        };
+        const handleOffline = ()=>{
+            this.networkOnline = false;
+            this.logger?.debug('Network status: offline');
+            customListener?.onOffline?.();
+            // 暂停自动刷新
+            this.stopAutoRefresh();
+        };
+        // 检查初始状态
+        if (globalNavigator && 'onLine' in globalNavigator) {
+            this.networkOnline = globalNavigator.onLine ?? true;
+        }
+        // 添加事件监听
+        if (globalWindow && globalWindow.addEventListener) {
+            globalWindow.addEventListener('online', handleOnline);
+            globalWindow.addEventListener('offline', handleOffline);
+        }
+        // 保存监听器引用以便清理
+        this.networkListeners = {
+            onOnline: handleOnline,
+            onOffline: handleOffline
+        };
+    }
+    /**
+   * 移除网络状态监听器
+   */ removeNetworkStatusListener() {
+        if (!this.networkListeners || this.environment !== 'browser') {
+            return;
+        }
+        const globalWindow = typeof globalThis !== 'undefined' && 'window' in globalThis ? globalThis.window : undefined;
+        if (globalWindow && globalWindow.removeEventListener) {
+            if (this.networkListeners.onOnline) {
+                globalWindow.removeEventListener('online', this.networkListeners.onOnline);
+            }
+            if (this.networkListeners.onOffline) {
+                globalWindow.removeEventListener('offline', this.networkListeners.onOffline);
+            }
+        }
+        this.networkListeners = null;
+        this.logger?.debug('Network status listener removed');
+    }
+    /**
+   * 启动自动刷新检查（支持智能调度）
+   */ startAutoRefresh() {
+        if (this.refreshTimer) {
+            clearInterval(this.refreshTimer);
+        }
+        const checkAndRefresh = ()=>{
+            // 如果页面隐藏且启用了暂停功能，跳过刷新检查
+            if (this.pauseRefreshOnHidden && !this.isPageVisible) {
+                this.logger?.debug('Skipping refresh check: page is hidden');
+                return;
+            }
+            // 如果网络离线，跳过刷新检查
+            if (this.listenNetworkStatus && !this.networkOnline) {
+                this.logger?.debug('Skipping refresh check: network is offline');
+                return;
+            }
+            // 如果启用了智能调度，使用 requestIdleCallback 执行任务
+            if (this.useSmartScheduling && typeof globalThis.requestIdleCallback !== 'undefined') {
+                globalThis.requestIdleCallback(()=>{
+                    this.onCheckAndRefresh?.().catch((error)=>{
+                        const errorMessage = error instanceof Error ? error.message : String(error);
+                        this.logger?.error('Auto refresh check failed:', errorMessage);
+                    });
+                }, {
+                    timeout: this.refreshInterval
+                });
+            } else {
+                // 直接执行（不使用智能调度）
+                this.onCheckAndRefresh?.().catch((error)=>{
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    this.logger?.error('Auto refresh check failed:', errorMessage);
+                });
+            }
+        };
+        // 使用 setInterval 设置定时检查
+        this.refreshTimer = setInterval(checkAndRefresh, this.refreshInterval);
+        this.onStartRefresh?.();
+    }
+    /**
+   * 停止自动刷新检查
+   */ stopAutoRefresh() {
+        if (this.refreshTimer) {
+            clearInterval(this.refreshTimer);
+            this.refreshTimer = null;
+        }
+        this.onStopRefresh?.();
+    }
+    /**
+   * 检查是否可以执行刷新（考虑页面可见性和网络状态）
+   */ canRefresh() {
+        // 如果页面隐藏且启用了暂停功能，不能刷新
+        if (this.pauseRefreshOnHidden && !this.isPageVisible) {
+            return false;
+        }
+        // 如果网络离线，不能刷新
+        if (this.listenNetworkStatus && !this.networkOnline) {
+            return false;
+        }
+        return true;
+    }
+    /**
+   * 清理资源
+   */ destroy() {
+        // 停止自动刷新
+        this.stopAutoRefresh();
+        // 移除页面可见性监听器
+        this.removeVisibilityListener();
+        // 移除网络状态监听器
+        this.removeNetworkStatusListener();
+    }
+    constructor(options){
+        _define_property(this, "refreshTimer", null);
+        _define_property(this, "isPageVisible", true);
+        _define_property(this, "networkOnline", true);
+        _define_property(this, "visibilityHandler", null);
+        _define_property(this, "networkListeners", null);
+        _define_property(this, "autoRefresh", void 0);
+        _define_property(this, "pauseRefreshOnHidden", void 0);
+        _define_property(this, "useSmartScheduling", void 0);
+        _define_property(this, "refreshInterval", void 0);
+        _define_property(this, "listenNetworkStatus", void 0);
+        _define_property(this, "environment", void 0);
+        _define_property(this, "logger", void 0);
+        _define_property(this, "onCheckAndRefresh", void 0);
+        _define_property(this, "onStartRefresh", void 0);
+        _define_property(this, "onStopRefresh", void 0);
+        this.autoRefresh = options.autoRefresh;
+        this.pauseRefreshOnHidden = options.pauseRefreshOnHidden;
+        this.useSmartScheduling = options.useSmartScheduling;
+        this.refreshInterval = options.refreshInterval;
+        this.listenNetworkStatus = options.listenNetworkStatus;
+        this.environment = options.environment;
+        this.logger = options.logger;
+        this.onCheckAndRefresh = options.onCheckAndRefresh;
+        this.onStartRefresh = options.onStartRefresh;
+        this.onStopRefresh = options.onStopRefresh;
+        // 设置页面可见性监听（如果启用）
+        if (this.pauseRefreshOnHidden) {
+            this.setupVisibilityListener();
+        }
+        // 设置网络状态监听（如果启用）
+        if (this.listenNetworkStatus) {
+            this.setupNetworkStatusListener(options.networkStatusListener);
+        }
+    }
+};
+
+//# sourceMappingURL=RefreshScheduler.js.map

package/dist/cjs/managers/AuthManager/modules/runtime/RefreshScheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/managers/AuthManager/modules/runtime/RefreshScheduler.ts"],"sourcesContent":["/**\n * 自动刷新调度模块\n * 负责 Token 自动刷新的调度、页面可见性监听、网络状态监听\n */\n\nimport type { NetworkStatusListener, Environment } from '../../types';\n\n/**\n * 刷新调度器\n */\nexport class RefreshScheduler {\n  private refreshTimer: ReturnType<typeof setInterval> | null = null;\n  private isPageVisible: boolean = true;\n  private networkOnline: boolean = true;\n  private visibilityHandler: (() => void) | null = null;\n  private networkListeners: NetworkStatusListener | null = null;\n  \n  private autoRefresh: boolean;\n  private pauseRefreshOnHidden: boolean;\n  private useSmartScheduling: boolean;\n  private refreshInterval: number;\n  private listenNetworkStatus: boolean;\n  private environment: Environment;\n  private logger?: { debug: (message: string, ...args: unknown[]) => void; error: (message: string, ...args: unknown[]) => void };\n  private onCheckAndRefresh?: () => Promise<void>;\n  private onStartRefresh?: () => void;\n  private onStopRefresh?: () => void;\n\n  constructor(\n    options: {\n      autoRefresh: boolean;\n      pauseRefreshOnHidden: boolean;\n      useSmartScheduling: boolean;\n      refreshInterval: number;\n      listenNetworkStatus: boolean;\n      environment: Environment;\n      logger?: { debug: (message: string, ...args: unknown[]) => void; error: (message: string, ...args: unknown[]) => void };\n      networkStatusListener?: NetworkStatusListener;\n      onCheckAndRefresh?: () => Promise<void>;\n      onStartRefresh?: () => void;\n      onStopRefresh?: () => void;\n    }\n  ) {\n    this.autoRefresh = options.autoRefresh;\n    this.pauseRefreshOnHidden = options.pauseRefreshOnHidden;\n    this.useSmartScheduling = options.useSmartScheduling;\n    this.refreshInterval = options.refreshInterval;\n    this.listenNetworkStatus = options.listenNetworkStatus;\n    this.environment = options.environment;\n    this.logger = options.logger;\n    this.onCheckAndRefresh = options.onCheckAndRefresh;\n    this.onStartRefresh = options.onStartRefresh;\n    this.onStopRefresh = options.onStopRefresh;\n\n    // 设置页面可见性监听（如果启用）\n    if (this.pauseRefreshOnHidden) {\n      this.setupVisibilityListener();\n    }\n\n    // 设置网络状态监听（如果启用）\n    if (this.listenNetworkStatus) {\n      this.setupNetworkStatusListener(options.networkStatusListener);\n    }\n  }\n\n  /**\n   * 设置页面可见性监听器\n   */\n  private setupVisibilityListener(): void {\n    // 类型安全的 document 检查\n    const doc = typeof globalThis !== 'undefined' && 'document' in globalThis \n      ? (globalThis as { document?: { hidden?: boolean; addEventListener?: Function; removeEventListener?: Function } }).document\n      : undefined;\n    \n    if (!doc || typeof doc.hidden === 'undefined') {\n      return;\n    }\n\n    // 检查初始状态\n    this.isPageVisible = !doc.hidden;\n\n    this.visibilityHandler = () => {\n      const wasVisible = this.isPageVisible;\n      const currentDoc = typeof globalThis !== 'undefined' && 'document' in globalThis \n        ? (globalThis as { document?: { hidden?: boolean } }).document\n        : undefined;\n      this.isPageVisible = currentDoc ? !currentDoc.hidden : true;\n\n      if (wasVisible !== this.isPageVisible) {\n        this.logger?.debug(`Page visibility changed: ${this.isPageVisible ? 'visible' : 'hidden'}`);\n        \n        if (this.isPageVisible) {\n          // 页面变为可见，恢复自动刷新\n          if (this.autoRefresh && this.onCheckAndRefresh) {\n            this.startAutoRefresh();\n            // 立即检查一次 Token\n            this.onCheckAndRefresh().catch((error) => {\n              this.logger?.error('Failed to check token after page visible:', error);\n            });\n          }\n        } else {\n          // 页面隐藏，暂停自动刷新\n          this.stopAutoRefresh();\n        }\n      }\n    };\n\n    // 使用标准 API 名称\n    const visibilityChangeEvent = 'visibilitychange';\n    if (doc.addEventListener) {\n      doc.addEventListener(visibilityChangeEvent, this.visibilityHandler as unknown as (event: Event) => void);\n    }\n    \n    this.logger?.debug('Page visibility listener setup');\n  }\n\n  /**\n   * 移除页面可见性监听器\n   */\n  private removeVisibilityListener(): void {\n    if (!this.visibilityHandler) {\n      return;\n    }\n    \n    const doc = typeof globalThis !== 'undefined' && 'document' in globalThis \n      ? (globalThis as { document?: { removeEventListener?: Function } }).document\n      : undefined;\n    \n    if (doc && doc.removeEventListener) {\n      doc.removeEventListener('visibilitychange', this.visibilityHandler as unknown as (event: Event) => void);\n      this.visibilityHandler = null;\n      this.logger?.debug('Page visibility listener removed');\n    }\n  }\n\n  /**\n   * 设置网络状态监听器\n   */\n  private setupNetworkStatusListener(customListener?: NetworkStatusListener): void {\n    if (this.environment !== 'browser') {\n      return;\n    }\n\n    const globalWindow = typeof globalThis !== 'undefined' && 'window' in globalThis \n      ? (globalThis as { window?: { addEventListener?: Function; removeEventListener?: Function } }).window \n      : undefined;\n\n    const globalNavigator = typeof globalThis !== 'undefined' && 'navigator' in globalThis \n      ? (globalThis as { navigator?: { onLine?: boolean } }).navigator \n      : undefined;\n\n    const handleOnline = () => {\n      this.networkOnline = true;\n      this.logger?.debug('Network status: online');\n      customListener?.onOnline?.();\n\n      // 恢复自动刷新\n      if (this.autoRefresh && this.onCheckAndRefresh) {\n        this.startAutoRefresh();\n        // 立即检查一次 Token\n        this.onCheckAndRefresh().catch((error) => {\n          this.logger?.error('Failed to check token after network online:', error);\n        });\n      }\n    };\n\n    const handleOffline = () => {\n      this.networkOnline = false;\n      this.logger?.debug('Network status: offline');\n      customListener?.onOffline?.();\n\n      // 暂停自动刷新\n      this.stopAutoRefresh();\n    };\n\n    // 检查初始状态\n    if (globalNavigator && 'onLine' in globalNavigator) {\n      this.networkOnline = globalNavigator.onLine ?? true;\n    }\n\n    // 添加事件监听\n    if (globalWindow && globalWindow.addEventListener) {\n      globalWindow.addEventListener('online', handleOnline as unknown as (event: Event) => void);\n      globalWindow.addEventListener('offline', handleOffline as unknown as (event: Event) => void);\n    }\n\n    // 保存监听器引用以便清理\n    this.networkListeners = {\n      onOnline: handleOnline,\n      onOffline: handleOffline,\n    };\n  }\n\n  /**\n   * 移除网络状态监听器\n   */\n  private removeNetworkStatusListener(): void {\n    if (!this.networkListeners || this.environment !== 'browser') {\n      return;\n    }\n\n    const globalWindow = typeof globalThis !== 'undefined' && 'window' in globalThis \n      ? (globalThis as { window?: { removeEventListener?: Function } }).window \n      : undefined;\n\n    if (globalWindow && globalWindow.removeEventListener) {\n      if (this.networkListeners.onOnline) {\n        globalWindow.removeEventListener('online', this.networkListeners.onOnline as unknown as (event: Event) => void);\n      }\n      if (this.networkListeners.onOffline) {\n        globalWindow.removeEventListener('offline', this.networkListeners.onOffline as unknown as (event: Event) => void);\n      }\n    }\n\n    this.networkListeners = null;\n    this.logger?.debug('Network status listener removed');\n  }\n\n  /**\n   * 启动自动刷新检查（支持智能调度）\n   */\n  startAutoRefresh(): void {\n    if (this.refreshTimer) {\n      clearInterval(this.refreshTimer);\n    }\n\n    const checkAndRefresh = () => {\n      // 如果页面隐藏且启用了暂停功能，跳过刷新检查\n      if (this.pauseRefreshOnHidden && !this.isPageVisible) {\n        this.logger?.debug('Skipping refresh check: page is hidden');\n        return;\n      }\n      \n      // 如果网络离线，跳过刷新检查\n      if (this.listenNetworkStatus && !this.networkOnline) {\n        this.logger?.debug('Skipping refresh check: network is offline');\n        return;\n      }\n      \n      // 如果启用了智能调度，使用 requestIdleCallback 执行任务\n      if (this.useSmartScheduling && typeof (globalThis as any).requestIdleCallback !== 'undefined') {\n        (globalThis as any).requestIdleCallback(\n          () => {\n            this.onCheckAndRefresh?.().catch((error) => {\n              const errorMessage = error instanceof Error ? error.message : String(error);\n              this.logger?.error('Auto refresh check failed:', errorMessage);\n            });\n          },\n          { timeout: this.refreshInterval }\n        );\n      } else {\n        // 直接执行（不使用智能调度）\n        this.onCheckAndRefresh?.().catch((error) => {\n          const errorMessage = error instanceof Error ? error.message : String(error);\n          this.logger?.error('Auto refresh check failed:', errorMessage);\n        });\n      }\n    };\n\n    // 使用 setInterval 设置定时检查\n    this.refreshTimer = setInterval(checkAndRefresh, this.refreshInterval);\n    this.onStartRefresh?.();\n  }\n\n  /**\n   * 停止自动刷新检查\n   */\n  stopAutoRefresh(): void {\n    if (this.refreshTimer) {\n      clearInterval(this.refreshTimer);\n      this.refreshTimer = null;\n    }\n    this.onStopRefresh?.();\n  }\n\n  /**\n   * 检查是否可以执行刷新（考虑页面可见性和网络状态）\n   */\n  canRefresh(): boolean {\n    // 如果页面隐藏且启用了暂停功能，不能刷新\n    if (this.pauseRefreshOnHidden && !this.isPageVisible) {\n      return false;\n    }\n    \n    // 如果网络离线，不能刷新\n    if (this.listenNetworkStatus && !this.networkOnline) {\n      return false;\n    }\n    \n    return true;\n  }\n\n  /**\n   * 清理资源\n   */\n  destroy(): void {\n    // 停止自动刷新\n    this.stopAutoRefresh();\n    \n    // 移除页面可见性监听器\n    this.removeVisibilityListener();\n\n    // 移除网络状态监听器\n    this.removeNetworkStatusListener();\n  }\n}\n"],"names":["RefreshScheduler","setupVisibilityListener","doc","globalThis","document","undefined","hidden","isPageVisible","visibilityHandler","wasVisible","currentDoc","logger","debug","autoRefresh","onCheckAndRefresh","startAutoRefresh","catch","error","stopAutoRefresh","visibilityChangeEvent","addEventListener","removeVisibilityListener","removeEventListener","setupNetworkStatusListener","customListener","environment","globalWindow","window","globalNavigator","navigator","handleOnline","networkOnline","onOnline","handleOffline","onOffline","onLine","networkListeners","removeNetworkStatusListener","refreshTimer","clearInterval","checkAndRefresh","pauseRefreshOnHidden","listenNetworkStatus","useSmartScheduling","requestIdleCallback","errorMessage","Error","message","String","timeout","refreshInterval","setInterval","onStartRefresh","onStopRefresh","canRefresh","destroy","options","networkStatusListener"],"mappings":"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"}

package/dist/cjs/managers/AuthManager/modules/runtime/index.js

@@ -0,0 +1,16 @@
+/**
+ * Runtime 层模块导出
+ * 运行时功能模块
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "RefreshScheduler", {
+    enumerable: true,
+    get: function() {
+        return _RefreshScheduler.RefreshScheduler;
+    }
+});
+const _RefreshScheduler = require("./RefreshScheduler");
+
+//# sourceMappingURL=index.js.map

package/dist/cjs/managers/AuthManager/modules/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/managers/AuthManager/modules/runtime/index.ts"],"sourcesContent":["/**\n * Runtime 层模块导出\n * 运行时功能模块\n */\n\nexport { RefreshScheduler } from './RefreshScheduler';\n"],"names":["RefreshScheduler"],"mappings":"AAAA;;;CAGC;;;;+BAEQA;;;eAAAA,kCAAgB;;;kCAAQ"}

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

@@ -0,0 +1,77 @@
+/**
+ * AuthManager 类型定义
+ * 完全泛型化的认证管理类型
+ */ // StorageInstance 接口定义
+// 注意：实际使用时应该从 @vlian/framework 导入
+"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 AuthError () {
+        return AuthError;
+    },
+    get AuthErrorCode () {
+        return AuthErrorCode;
+    },
+    get AuthEventType () {
+        return AuthEventType;
+    }
+});
+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 AuthEventType = /*#__PURE__*/ function(AuthEventType) {
+    AuthEventType["AUTH_SET"] = "auth:set";
+    AuthEventType["AUTH_CLEAR"] = "auth:clear";
+    AuthEventType["TOKEN_UPDATE"] = "token:update";
+    AuthEventType["TOKEN_REFRESH"] = "token:refresh";
+    AuthEventType["TOKEN_REFRESH_FAILURE"] = "token:refresh:failure";
+    AuthEventType["TOKEN_EXPIRED"] = "token:expired";
+    AuthEventType["AUTH_STATE_CHANGE"] = "auth:state:change";
+    AuthEventType["USER_INFO_UPDATE"] = "user:info:update"; // 用户信息更新
+    return AuthEventType;
+}({});
+let AuthError = class AuthError extends Error {
+    constructor(message, code, statusCode, originalError){
+        super(message), _define_property(this, "code", void 0), _define_property(this, "statusCode", void 0), _define_property(this, "originalError", void 0);
+        this.name = 'AuthError';
+        this.code = code;
+        this.statusCode = statusCode;
+        this.originalError = originalError;
+        // 保持正确的原型链
+        Object.setPrototypeOf(this, AuthError.prototype);
+    }
+};
+var AuthErrorCode = /*#__PURE__*/ function(AuthErrorCode) {
+    AuthErrorCode["TOKEN_EXPIRED"] = "TOKEN_EXPIRED";
+    AuthErrorCode["TOKEN_REFRESH_FAILED"] = "TOKEN_REFRESH_FAILED";
+    AuthErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    AuthErrorCode["STORAGE_ERROR"] = "STORAGE_ERROR";
+    AuthErrorCode["INVALID_TOKEN"] = "INVALID_TOKEN";
+    AuthErrorCode["INVALID_AUTH_DATA"] = "INVALID_AUTH_DATA";
+    AuthErrorCode["CONFIG_ERROR"] = "CONFIG_ERROR";
+    AuthErrorCode["ENVIRONMENT_ERROR"] = "ENVIRONMENT_ERROR";
+    AuthErrorCode["QUEUE_OVERFLOW"] = "QUEUE_OVERFLOW";
+    AuthErrorCode["OPERATION_TIMEOUT"] = "OPERATION_TIMEOUT";
+    AuthErrorCode["CONCURRENCY_ERROR"] = "CONCURRENCY_ERROR";
+    return AuthErrorCode;
+}({});
+
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/managers/AuthManager/types.ts"],"sourcesContent":["/**\n * AuthManager 类型定义\n * 完全泛型化的认证管理类型\n */\n\n// StorageInstance 接口定义\n// 注意：实际使用时应该从 @vlian/framework 导入\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 * 存储策略\n */\nexport type StorageStrategy = 'local' | 'session' | 'indexedDB';\n\n/**\n * Token 信息（标准化格式）\n */\nexport interface TokenInfo {\n  /**\n   * 访问 Token（必需）\n   */\n  accessToken: string;\n  \n  /**\n   * 刷新 Token（可选）\n   */\n  refreshToken?: string;\n  \n  /**\n   * 过期时间（秒）\n   */\n  expiresIn?: number;\n  \n  /**\n   * 过期时间戳（毫秒）\n   */\n  expiresAt?: number;\n  \n  /**\n   * Token 类型（默认：Bearer）\n   */\n  tokenType?: string;\n}\n\n/**\n * 认证数据（包含 Token 信息和可选的用户信息）\n */\nexport interface AuthData<TUserInfo = unknown> {\n  /**\n   * Token 信息（必需）\n   */\n  tokenInfo: TokenInfo;\n  \n  /**\n   * 用户信息（可选）\n   */\n  userInfo?: TUserInfo;\n}\n\n/**\n * Token 刷新函数类型\n * 用户需要提供此函数来实现 Token 刷新逻辑\n */\nexport type RefreshTokenFunction = (refreshToken: string) => Promise<TokenInfo>;\n\n/**\n * 加密函数类型（用于 Token 存储加密）\n * @param data 要加密的数据\n * @returns 加密后的字符串\n */\nexport type EncryptFunction = (data: string) => string | Promise<string>;\n\n/**\n * 解密函数类型（用于 Token 存储解密）\n * @param encryptedData 加密的数据\n * @returns 解密后的字符串\n */\nexport type DecryptFunction = (encryptedData: string) => string | Promise<string>;\n\n/**\n * 错误信息脱敏函数类型\n * @param error 原始错误\n * @returns 脱敏后的错误信息\n */\nexport type ErrorSanitizer = (error: unknown) => string;\n\n/**\n * 中间件函数类型\n * @param context 操作上下文\n * @param next 下一个中间件\n */\nexport type Middleware<TContext = unknown> = (\n  context: TContext,\n  next: () => Promise<void>\n) => Promise<void>;\n\n/**\n * 中间件上下文类型\n */\nexport interface MiddlewareContext {\n  operation: string;\n  [key: string]: unknown;\n}\n\n/**\n * 环境类型\n */\nexport type Environment = 'browser' | 'node' | 'ssr' | 'worker' | 'unknown';\n\n/**\n * 健康检查结果\n */\nexport interface HealthCheckResult {\n  status: 'healthy' | 'degraded' | 'unhealthy';\n  checks: {\n    storage: boolean;\n    eventBus: boolean;\n    authState: boolean;\n    tokenValid: boolean;\n  };\n  details?: Record<string, unknown>;\n}\n\n/**\n * 性能指标\n */\nexport interface PerformanceMetrics {\n  operation: string;\n  duration: number;\n  timestamp: number;\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * 配置验证结果\n */\nexport interface ConfigValidationResult {\n  valid: boolean;\n  errors: string[];\n  warnings: string[];\n}\n\n/**\n * Token 刷新重试配置\n */\nexport interface RefreshRetryConfig {\n  maxRetries?: number;\n  retryDelay?: number;\n  backoffMultiplier?: number;\n  retryableErrors?: readonly string[] | string[];\n}\n\n/**\n * 网络状态监听器\n */\nexport interface NetworkStatusListener {\n  onOnline?: () => void;\n  onOffline?: () => void;\n}\n\n/**\n * 生命周期钩子\n */\nexport interface LifecycleHooks {\n  beforeSetAuth?: (authData: AuthData) => Promise<void> | void;\n  afterSetAuth?: (authData: AuthData) => Promise<void> | void;\n  beforeClearAuth?: () => Promise<void> | void;\n  afterClearAuth?: () => Promise<void> | void;\n  beforeRefreshToken?: (refreshToken: string) => Promise<void> | void;\n  afterRefreshToken?: (tokenInfo: TokenInfo) => Promise<void> | void;\n}\n\n  /**\n   * AuthManager 配置选项\n   */\n  export interface AuthOptions {\n  // ========== 依赖注入（必需）==========\n  /**\n   * @vlian/framework Storage 配置\n   * 方式1：指定存储策略（local/session/indexedDB）\n   * 方式2：直接提供 StorageInstance\n   */\n  storage: {\n    instance?: StorageInstance;  // 直接提供存储实例\n    strategy?: StorageStrategy;   // 或指定存储策略\n  };\n  \n  /**\n   * @vlian/framework AppEventBus 实例（可选）\n   * 如果不提供，AuthManager 内部会创建独立的事件总线\n   */\n  eventBus?: AppEventBus;\n  \n  /**\n   * @vlian/framework Logger 实例（可选）\n   */\n  logger?: Logger;\n  \n  /**\n   * @vlian/framework MonitoringService 实例（可选）\n   * 用于错误监控、性能指标上报和用户行为追踪\n   */\n  monitoring?: MonitoringService;\n  \n  // ========== 存储键名配置 ==========\n  /**\n   * 认证数据存储键名（默认：'auth_data'）\n   * 所有认证数据（token）统一存储在一个键下\n   */\n  authDataKey?: string;\n  \n  /**\n   * Token 存储键名（默认：'auth_token'，可选，如果使用 authDataKey 则不需要）\n   * 如果设置了 authDataKey，此配置将被忽略\n   */\n  tokenKey?: string;\n  \n  // ========== Token 刷新配置 ==========\n  /**\n   * 是否启用自动刷新检查（默认：true）\n   * 注意：自动刷新需要用户提供 refreshTokenFunction\n   */\n  autoRefresh?: boolean;\n  \n  /**\n   * 刷新阈值（秒，默认：300，即5分钟前刷新）\n   */\n  refreshThreshold?: number;\n  \n  /**\n   * 刷新检查间隔（毫秒，默认：60000，即1分钟）\n   */\n  refreshInterval?: number;\n  \n  /**\n   * Token 刷新函数（可选）\n   * 如果提供，将用于自动刷新和手动刷新\n   * 如果不提供，用户需要手动调用 refreshToken(refreshFn)\n   */\n  refreshTokenFunction?: RefreshTokenFunction;\n  \n  // ========== 事件配置 ==========\n  /**\n   * 事件命名空间前缀（默认：'auth:'）\n   * 用于在 AppEventBus 中隔离事件\n   */\n  eventNamespace?: string;\n  \n  /**\n   * 是否启用事件（默认：true）\n   */\n  enableEvents?: boolean;\n  \n  // ========== 安全配置 ==========\n  /**\n   * Token 存储加密函数（可选）\n   * 如果提供，存储 Token 时会先加密，读取时会解密\n   * 注意：加密/解密函数应该是同步或异步的，AuthManager 会自动处理\n   */\n  encryptToken?: EncryptFunction;\n  \n  /**\n   * Token 存储解密函数（可选）\n   * 如果提供了 encryptToken，必须同时提供 decryptToken\n   */\n  decryptToken?: DecryptFunction;\n  \n  /**\n   * 错误信息脱敏函数（可选）\n   * 用于在日志和监控中脱敏敏感信息\n   * 如果不提供，使用默认的脱敏策略\n   */\n  errorSanitizer?: ErrorSanitizer;\n  \n  /**\n   * 是否在错误信息中隐藏敏感数据（默认：true）\n   * 当设置为 true 时，错误信息会被脱敏处理\n   */\n  sanitizeErrors?: boolean;\n  \n  // ========== 性能配置 ==========\n  /**\n   * Token 刷新超时时间（毫秒，默认：30000，即30秒）\n   * 如果刷新操作超过此时间，将自动取消并抛出超时错误\n   */\n  refreshTimeout?: number;\n  \n  /**\n   * 是否在页面隐藏时暂停自动刷新（默认：true）\n   * 使用 Page Visibility API 检测页面可见性\n   * 当页面隐藏时暂停定时器，页面显示时恢复\n   */\n  pauseRefreshOnHidden?: boolean;\n  \n  /**\n   * 批量写入延迟（毫秒，默认：100）\n   * 在指定时间内多次状态变更只会触发一次存储操作，用于性能优化\n   * 设置为 0 表示禁用批量写入，立即写入\n   */\n  batchWriteDelay?: number;\n  \n  /**\n   * 是否使用智能调度（默认：true）\n   * 启用后，定时器会在页面空闲时执行，减少对主线程的影响\n   * 使用 requestIdleCallback（如果可用）或降级到 setTimeout\n   */\n  useSmartScheduling?: boolean;\n  \n  // ========== 安全配置增强 ==========\n  /**\n   * 是否使用默认加密（默认：false）\n   * 当设置为 true 且未提供 encryptToken/decryptToken 时，使用内置的简单加密方案\n   * 注意：默认加密仅提供基本保护，生产环境建议使用更强的加密方案\n   * 生产环境会自动禁用默认加密\n   */\n  useDefaultEncryption?: boolean;\n  \n  /**\n   * 默认加密密钥（可选）\n   * 仅在 useDefaultEncryption 为 true 时使用\n   * 如果不提供，将使用基于时间戳的简单密钥（安全性较低，仅用于开发环境）\n   */\n  defaultEncryptionKey?: string;\n\n  /**\n   * 是否启用开发模式（默认：自动检测）\n   * 开发模式下会输出更详细的错误信息和调试日志\n   */\n  devMode?: boolean;\n\n  // ========== 中间件和扩展 ==========\n  /**\n   * 中间件列表（可选）\n   * 用于在关键操作前后执行自定义逻辑\n   */\n  middlewares?: Middleware<MiddlewareContext>[];\n\n  /**\n   * 生命周期钩子（可选）\n   * 在关键操作的生命周期节点执行回调\n   */\n  lifecycleHooks?: LifecycleHooks;\n\n  // ========== Token 刷新增强 ==========\n  /**\n   * Token 刷新重试配置（可选）\n   * 配置刷新失败时的重试策略\n   */\n  refreshRetryConfig?: RefreshRetryConfig;\n\n  /**\n   * Token 过期自动处理策略（可选）\n   * 'none': 不处理（默认）\n   * 'clear': 自动清除\n   * 'refresh': 尝试刷新\n   */\n  expiredTokenStrategy?: 'none' | 'clear' | 'refresh';\n\n  // ========== 网络状态 ==========\n  /**\n   * 是否监听网络状态（默认：false）\n   * 启用后会在网络离线时暂停刷新，在线时恢复\n   */\n  listenNetworkStatus?: boolean;\n\n  /**\n   * 网络状态监听器（可选）\n   * 自定义网络状态变化处理\n   */\n  networkStatusListener?: NetworkStatusListener;\n\n  // ========== 配置验证 ==========\n  /**\n   * 是否启用配置验证（默认：true）\n   * 启用后会在初始化时验证配置的有效性\n   */\n  validateConfig?: boolean;\n\n  /**\n   * 环境变量前缀（可选）\n   * 用于从环境变量读取配置，如 'AUTH_' 会读取 AUTH_AUTO_REFRESH 等\n   */\n  envPrefix?: string;\n\n  // ========== 实例隔离 ==========\n  /**\n   * 实例 ID（可选）\n   * 用于多实例场景下的隔离，会自动添加到存储键名前缀\n   */\n  instanceId?: string;\n\n  // ========== 可观测性增强 ==========\n  /**\n   * 是否启用详细性能指标（默认：false）\n   * 启用后会收集所有操作的性能指标\n   */\n  enableDetailedMetrics?: boolean;\n\n  /**\n   * 性能指标收集器（可选）\n   * 自定义性能指标收集逻辑\n   */\n  metricsCollector?: (metrics: PerformanceMetrics) => void;\n\n  /**\n   * 是否启用链路追踪（默认：false）\n   * 启用后会为每个操作生成追踪 ID\n   */\n  enableTracing?: 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 */\nexport enum AuthEventType {\n  AUTH_SET = 'auth:set',                    // 设置认证状态\n  AUTH_CLEAR = 'auth:clear',                // 清除认证状态\n  TOKEN_UPDATE = 'token:update',            // Token 更新\n  TOKEN_REFRESH = 'token:refresh',         // Token 刷新成功\n  TOKEN_REFRESH_FAILURE = 'token:refresh:failure', // Token 刷新失败\n  TOKEN_EXPIRED = 'token:expired',          // Token 过期\n  AUTH_STATE_CHANGE = 'auth:state:change',   // 认证状态变化\n  USER_INFO_UPDATE = 'user:info:update'      // 用户信息更新\n}\n\n/**\n * 设置认证事件数据\n */\nexport interface AuthSetEventData {\n  authData: AuthData<unknown>;\n}\n\n/**\n * 清除认证事件数据\n */\nexport interface AuthClearEventData {\n  // 空对象，表示已清除\n  [key: string]: never;\n}\n\n/**\n * Token 更新事件数据\n */\nexport interface TokenUpdateEventData {\n  tokenInfo: TokenInfo;\n}\n\n/**\n * Token 刷新事件数据\n */\nexport interface TokenRefreshEventData {\n  tokenInfo: TokenInfo;\n}\n\n/**\n * Token 刷新失败事件数据\n */\nexport interface TokenRefreshFailureEventData {\n  error: AuthError;\n}\n\n/**\n * 认证状态变化事件数据\n */\nexport interface AuthStateChangeEventData {\n  isAuthenticated: boolean;\n  previousState: boolean;\n}\n\n/**\n * 用户信息更新事件数据\n */\nexport interface UserInfoUpdateEventData {\n  userInfo: unknown;\n  previousUserInfo?: unknown;\n}\n\n/**\n * 事件元数据（基于 @vlian/framework AppEventBus）\n */\nexport interface EventMetadata {\n  timestamp: number;\n  eventType: string;\n  [key: string]: unknown;\n}\n\n/**\n * 事件监听器选项\n */\nexport interface EventListenerOptions {\n  once?: boolean;\n  [key: string]: unknown;\n}\n\n/**\n * 错误类型定义\n */\nexport class AuthError extends Error {\n  code: string;\n  statusCode?: number;\n  originalError?: Error;\n  \n  constructor(\n    message: string,\n    code: string,\n    statusCode?: number,\n    originalError?: Error\n  ) {\n    super(message);\n    this.name = 'AuthError';\n    this.code = code;\n    this.statusCode = statusCode;\n    this.originalError = originalError;\n    \n    // 保持正确的原型链\n    Object.setPrototypeOf(this, AuthError.prototype);\n  }\n}\n\n/**\n * 错误代码枚举\n */\nexport enum AuthErrorCode {\n  TOKEN_EXPIRED = 'TOKEN_EXPIRED',\n  TOKEN_REFRESH_FAILED = 'TOKEN_REFRESH_FAILED',\n  NETWORK_ERROR = 'NETWORK_ERROR',\n  STORAGE_ERROR = 'STORAGE_ERROR',\n  INVALID_TOKEN = 'INVALID_TOKEN',\n  INVALID_AUTH_DATA = 'INVALID_AUTH_DATA',\n  CONFIG_ERROR = 'CONFIG_ERROR',\n  ENVIRONMENT_ERROR = 'ENVIRONMENT_ERROR',\n  QUEUE_OVERFLOW = 'QUEUE_OVERFLOW',\n  OPERATION_TIMEOUT = 'OPERATION_TIMEOUT',\n  CONCURRENCY_ERROR = 'CONCURRENCY_ERROR'\n}\n\n// 类型声明（从 @vlian/framework 导入的类型）\ndeclare class 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  ): () => void;\n  \n  emit<T = unknown>(\n    event: string,\n    data: T,\n    metadata?: Partial<EventMetadata>\n  ): void | Promise<void>;\n}\n\ndeclare class 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\ndeclare class 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  trace?(operation: string, fn: () => Promise<unknown> | unknown): Promise<unknown>;\n}\n"],"names":["AuthError","AuthErrorCode","AuthEventType","Error","message","code","statusCode","originalError","name","Object","setPrototypeOf","prototype"],"mappings":"AAAA;;;CAGC,GAED,uBAAuB;AACvB,kCAAkC;;;;;;;;;;;;QAogBrBA;eAAAA;;QAyBDC;eAAAA;;QA5GAC;eAAAA;;;;;;;;;;;;;;;;AAAL,IAAA,AAAKA,uCAAAA;;;;;;;;4DAQiC,SAAS;WAR1CA;;AAmFL,IAAA,AAAMF,YAAN,MAAMA,kBAAkBG;IAK7B,YACEC,OAAe,EACfC,IAAY,EACZC,UAAmB,EACnBC,aAAqB,CACrB;QACA,KAAK,CAACH,UAVRC,uBAAAA,QAAAA,KAAAA,IACAC,uBAAAA,cAAAA,KAAAA,IACAC,uBAAAA,iBAAAA,KAAAA;QASE,IAAI,CAACC,IAAI,GAAG;QACZ,IAAI,CAACH,IAAI,GAAGA;QACZ,IAAI,CAACC,UAAU,GAAGA;QAClB,IAAI,CAACC,aAAa,GAAGA;QAErB,WAAW;QACXE,OAAOC,cAAc,CAAC,IAAI,EAAEV,UAAUW,SAAS;IACjD;AACF;AAKO,IAAA,AAAKV,uCAAAA;;;;;;;;;;;;WAAAA"}