@vlian/infrastructure 0.9.10

package/dist/esm/managers/PermissionManager/observability/PerformanceMonitor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/PermissionManager/observability/PerformanceMonitor.ts"],"sourcesContent":["/**\n * 性能监控模块\n * 封装 @vlian/framework MonitoringService，负责性能指标收集和上报\n */\n\nimport type { MonitoringService, PerformanceMetrics, PerformanceStatistics } from '../types';\n\n/**\n * 性能监控器\n */\nexport class PerformanceMonitor {\n  private monitoring?: MonitoringService;\n  private enableDetailedMetrics: boolean;\n  private metrics: PerformanceMetrics[] = [];\n  private maxMetricsSize: number = 100;\n\n  constructor(options?: {\n    monitoring?: MonitoringService;\n    enableDetailedMetrics?: boolean;\n    maxMetricsSize?: number;\n  }) {\n    this.monitoring = options?.monitoring;\n    this.enableDetailedMetrics = options?.enableDetailedMetrics ?? false;\n    this.maxMetricsSize = options?.maxMetricsSize ?? 100;\n  }\n\n  /**\n   * 记录性能指标\n   */\n  recordPerformance(\n    operation: string,\n    duration: number,\n    metadata?: Record<string, unknown>\n  ): void {\n    const metric: PerformanceMetrics = {\n      operation,\n      duration,\n      timestamp: Date.now(),\n      metadata,\n    };\n\n    // 添加到指标数组\n    if (this.enableDetailedMetrics) {\n      this.metrics.push(metric);\n      // 限制数组大小\n      if (this.metrics.length > this.maxMetricsSize) {\n        this.metrics.shift();\n      }\n    }\n\n    // 上报到监控服务\n    if (this.monitoring) {\n      try {\n        this.monitoring.reportPerformance(\n          {\n            [`${operation}_duration`]: duration,\n          },\n          metadata\n        );\n      } catch (error) {\n        // 上报失败，忽略\n      }\n    }\n  }\n\n  /**\n   * 获取性能指标\n   */\n  getPerformanceMetrics(): PerformanceMetrics[] {\n    return [...this.metrics];\n  }\n\n  /**\n   * 清除性能指标\n   */\n  clearPerformanceMetrics(): void {\n    this.metrics = [];\n  }\n\n  /**\n   * 获取性能统计\n   */\n  getStatistics(operation?: string): PerformanceStatistics[] {\n    const filteredMetrics = operation\n      ? this.metrics.filter(m => m.operation === operation)\n      : this.metrics;\n\n    if (filteredMetrics.length === 0) {\n      return [];\n    }\n\n    const durations = filteredMetrics.map(m => m.duration).sort((a, b) => a - b);\n    const totalDuration = durations.reduce((sum, d) => sum + d, 0);\n    const count = durations.length;\n    const averageDuration = totalDuration / count;\n    const minDuration = durations[0];\n    const maxDuration = durations[durations.length - 1];\n    const p95Index = Math.floor(count * 0.95);\n    const p99Index = Math.floor(count * 0.99);\n    const p95 = durations[p95Index] || maxDuration;\n    const p99 = durations[p99Index] || maxDuration;\n\n    return [{\n      operation: operation || 'all',\n      count,\n      totalDuration,\n      averageDuration,\n      minDuration,\n      maxDuration,\n      p95Duration: p95,\n      p99Duration: p99,\n      errorCount: 0,\n      errorRate: 0,\n    }];\n  }\n}\n"],"names":["PerformanceMonitor","recordPerformance","operation","duration","metadata","metric","timestamp","Date","now","enableDetailedMetrics","metrics","push","length","maxMetricsSize","shift","monitoring","reportPerformance","error","getPerformanceMetrics","clearPerformanceMetrics","getStatistics","filteredMetrics","filter","m","durations","map","sort","a","b","totalDuration","reduce","sum","d","count","averageDuration","minDuration","maxDuration","p95Index","Math","floor","p99Index","p95","p99","p95Duration","p99Duration","errorCount","errorRate","options"],"mappings":"AAAA;;;CAGC;;;;;;;;;;;;;AAID;;CAEC,GACD,OAAO,MAAMA;IAgBX;;GAEC,GACDC,kBACEC,SAAiB,EACjBC,QAAgB,EAChBC,QAAkC,EAC5B;QACN,MAAMC,SAA6B;YACjCH;YACAC;YACAG,WAAWC,KAAKC,GAAG;YACnBJ;QACF;QAEA,UAAU;QACV,IAAI,IAAI,CAACK,qBAAqB,EAAE;YAC9B,IAAI,CAACC,OAAO,CAACC,IAAI,CAACN;YAClB,SAAS;YACT,IAAI,IAAI,CAACK,OAAO,CAACE,MAAM,GAAG,IAAI,CAACC,cAAc,EAAE;gBAC7C,IAAI,CAACH,OAAO,CAACI,KAAK;YACpB;QACF;QAEA,UAAU;QACV,IAAI,IAAI,CAACC,UAAU,EAAE;YACnB,IAAI;gBACF,IAAI,CAACA,UAAU,CAACC,iBAAiB,CAC/B;oBACE,CAAC,GAAGd,UAAU,SAAS,CAAC,CAAC,EAAEC;gBAC7B,GACAC;YAEJ,EAAE,OAAOa,OAAO;YACd,UAAU;YACZ;QACF;IACF;IAEA;;GAEC,GACDC,wBAA8C;QAC5C,OAAO;eAAI,IAAI,CAACR,OAAO;SAAC;IAC1B;IAEA;;GAEC,GACDS,0BAAgC;QAC9B,IAAI,CAACT,OAAO,GAAG,EAAE;IACnB;IAEA;;GAEC,GACDU,cAAclB,SAAkB,EAA2B;QACzD,MAAMmB,kBAAkBnB,YACpB,IAAI,CAACQ,OAAO,CAACY,MAAM,CAACC,CAAAA,IAAKA,EAAErB,SAAS,KAAKA,aACzC,IAAI,CAACQ,OAAO;QAEhB,IAAIW,gBAAgBT,MAAM,KAAK,GAAG;YAChC,OAAO,EAAE;QACX;QAEA,MAAMY,YAAYH,gBAAgBI,GAAG,CAACF,CAAAA,IAAKA,EAAEpB,QAAQ,EAAEuB,IAAI,CAAC,CAACC,GAAGC,IAAMD,IAAIC;QAC1E,MAAMC,gBAAgBL,UAAUM,MAAM,CAAC,CAACC,KAAKC,IAAMD,MAAMC,GAAG;QAC5D,MAAMC,QAAQT,UAAUZ,MAAM;QAC9B,MAAMsB,kBAAkBL,gBAAgBI;QACxC,MAAME,cAAcX,SAAS,CAAC,EAAE;QAChC,MAAMY,cAAcZ,SAAS,CAACA,UAAUZ,MAAM,GAAG,EAAE;QACnD,MAAMyB,WAAWC,KAAKC,KAAK,CAACN,QAAQ;QACpC,MAAMO,WAAWF,KAAKC,KAAK,CAACN,QAAQ;QACpC,MAAMQ,MAAMjB,SAAS,CAACa,SAAS,IAAID;QACnC,MAAMM,MAAMlB,SAAS,CAACgB,SAAS,IAAIJ;QAEnC,OAAO;YAAC;gBACNlC,WAAWA,aAAa;gBACxB+B;gBACAJ;gBACAK;gBACAC;gBACAC;gBACAO,aAAaF;gBACbG,aAAaF;gBACbG,YAAY;gBACZC,WAAW;YACb;SAAE;IACJ;IAlGA,YAAYC,OAIX,CAAE;QATH,uBAAQhC,cAAR,KAAA;QACA,uBAAQN,yBAAR,KAAA;QACA,uBAAQC,WAAgC,EAAE;QAC1C,uBAAQG,kBAAyB;QAO/B,IAAI,CAACE,UAAU,GAAGgC,SAAShC;QAC3B,IAAI,CAACN,qBAAqB,GAAGsC,SAAStC,yBAAyB;QAC/D,IAAI,CAACI,cAAc,GAAGkC,SAASlC,kBAAkB;IACnD;AA2FF"}

package/dist/esm/managers/PermissionManager/observability/index.js

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

package/dist/esm/managers/PermissionManager/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/PermissionManager/observability/index.ts"],"sourcesContent":["/**\n * Observability 层导出\n */\n\nexport { EventManager } from './EventManager';\nexport { PerformanceMonitor } from './PerformanceMonitor';\nexport { LoggingManager } from './LoggingManager';\nexport { MonitoringManager } from './MonitoringManager';\n"],"names":["EventManager","PerformanceMonitor","LoggingManager","MonitoringManager"],"mappings":"AAAA;;CAEC,GAED,SAASA,YAAY,QAAQ,iBAAiB;AAC9C,SAASC,kBAAkB,QAAQ,uBAAuB;AAC1D,SAASC,cAAc,QAAQ,mBAAmB;AAClD,SAASC,iBAAiB,QAAQ,sBAAsB"}

package/dist/esm/managers/PermissionManager/runtime/EnvironmentAdapter.js

@@ -0,0 +1,105 @@
+/**
+ * 运行时环境适配器
+ * 处理不同运行环境的差异（浏览器、SSR、微前端等）
+ */ 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;
+}
+import { EnvironmentDetector } from "../modules/EnvironmentDetector";
+/**
+ * 环境适配器实现
+ */ export class EnvironmentAdapter {
+    /**
+   * 获取环境类型
+   */ getEnvironment() {
+        return this.environment;
+    }
+    /**
+   * 是否支持当前环境
+   */ isSupported() {
+        return this.environment !== 'unknown';
+    }
+    /**
+   * 初始化
+   */ async init() {
+        // 环境特定的初始化逻辑
+        switch(this.environment){
+            case 'browser':
+                break;
+            case 'node':
+                break;
+            case 'ssr':
+                break;
+            case 'worker':
+                break;
+        }
+    }
+    /**
+   * 序列化数据（用于跨线程/进程传递）
+   */ serialize(data) {
+        try {
+            return JSON.stringify(data);
+        } catch (error) {
+            throw new Error(`Failed to serialize data: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+   * 反序列化数据
+   */ deserialize(data) {
+        try {
+            return JSON.parse(data);
+        } catch (error) {
+            throw new Error(`Failed to deserialize data: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+   * 水合权限数据（SSR 场景）
+   */ async hydrate(_data) {
+        if (this.environment === 'ssr') {
+        // SSR 环境下的数据水合逻辑
+        // 将服务端权限数据注入到客户端
+        // TODO: 实现数据水合逻辑
+        }
+    }
+    /**
+   * 获取环境特定的存储键
+   */ getStorageKey(baseKey) {
+        return `${this.environment}:${baseKey}`;
+    }
+    /**
+   * 检查是否支持特定功能
+   */ supportsFeature(feature) {
+        switch(feature){
+            case 'serialization':
+                return [
+                    'browser',
+                    'node',
+                    'worker'
+                ].includes(this.environment);
+            case 'hydration':
+                return this.environment === 'ssr';
+            case 'storage':
+                return [
+                    'browser',
+                    'node'
+                ].includes(this.environment);
+            default:
+                return false;
+        }
+    }
+    constructor(environment){
+        _define_property(this, "environment", void 0);
+        this.environment = environment ?? EnvironmentDetector.detectEnvironment();
+    }
+}
+
+//# sourceMappingURL=EnvironmentAdapter.js.map

package/dist/esm/managers/PermissionManager/runtime/EnvironmentAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/PermissionManager/runtime/EnvironmentAdapter.ts"],"sourcesContent":["/**\n * 运行时环境适配器\n * 处理不同运行环境的差异（浏览器、SSR、微前端等）\n */\n\nimport type { Environment, PermissionData, EnvironmentAdapter as IEnvironmentAdapter } from '../types';\nimport { EnvironmentDetector } from '../modules/EnvironmentDetector';\n\n/**\n * 环境适配器实现\n */\nexport class EnvironmentAdapter implements IEnvironmentAdapter {\n  public readonly environment: Environment;\n\n  constructor(environment?: Environment) {\n    this.environment = environment ?? EnvironmentDetector.detectEnvironment();\n  }\n\n  /**\n   * 获取环境类型\n   */\n  getEnvironment(): Environment {\n    return this.environment;\n  }\n\n  /**\n   * 是否支持当前环境\n   */\n  isSupported(): boolean {\n    return this.environment !== 'unknown';\n  }\n\n  /**\n   * 初始化\n   */\n  async init(): Promise<void> {\n    // 环境特定的初始化逻辑\n    switch (this.environment) {\n      case 'browser':\n        // 浏览器环境特定初始化\n        break;\n      case 'node':\n        // Node.js 环境特定初始化\n        break;\n      case 'ssr':\n        // SSR 环境特定初始化\n        break;\n      case 'worker':\n        // Worker 环境特定初始化\n        break;\n    }\n  }\n\n  /**\n   * 序列化数据（用于跨线程/进程传递）\n   */\n  serialize(data: unknown): string {\n    try {\n      return JSON.stringify(data);\n    } catch (error) {\n      throw new Error(`Failed to serialize data: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n\n  /**\n   * 反序列化数据\n   */\n  deserialize<T = unknown>(data: string): T {\n    try {\n      return JSON.parse(data) as T;\n    } catch (error) {\n      throw new Error(`Failed to deserialize data: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n\n  /**\n   * 水合权限数据（SSR 场景）\n   */\n  async hydrate(_data: PermissionData): Promise<void> {\n    if (this.environment === 'ssr') {\n      // SSR 环境下的数据水合逻辑\n      // 将服务端权限数据注入到客户端\n      // TODO: 实现数据水合逻辑\n    }\n  }\n\n  /**\n   * 获取环境特定的存储键\n   */\n  getStorageKey(baseKey: string): string {\n    return `${this.environment}:${baseKey}`;\n  }\n\n  /**\n   * 检查是否支持特定功能\n   */\n  supportsFeature(feature: 'serialization' | 'hydration' | 'storage'): boolean {\n    switch (feature) {\n      case 'serialization':\n        return ['browser', 'node', 'worker'].includes(this.environment);\n      case 'hydration':\n        return this.environment === 'ssr';\n      case 'storage':\n        return ['browser', 'node'].includes(this.environment);\n      default:\n        return false;\n    }\n  }\n}\n"],"names":["EnvironmentDetector","EnvironmentAdapter","getEnvironment","environment","isSupported","init","serialize","data","JSON","stringify","error","Error","message","String","deserialize","parse","hydrate","_data","getStorageKey","baseKey","supportsFeature","feature","includes","detectEnvironment"],"mappings":"AAAA;;;CAGC;;;;;;;;;;;;;AAGD,SAASA,mBAAmB,QAAQ,iCAAiC;AAErE;;CAEC,GACD,OAAO,MAAMC;IAOX;;GAEC,GACDC,iBAA8B;QAC5B,OAAO,IAAI,CAACC,WAAW;IACzB;IAEA;;GAEC,GACDC,cAAuB;QACrB,OAAO,IAAI,CAACD,WAAW,KAAK;IAC9B;IAEA;;GAEC,GACD,MAAME,OAAsB;QAC1B,aAAa;QACb,OAAQ,IAAI,CAACF,WAAW;YACtB,KAAK;gBAEH;YACF,KAAK;gBAEH;YACF,KAAK;gBAEH;YACF,KAAK;gBAEH;QACJ;IACF;IAEA;;GAEC,GACDG,UAAUC,IAAa,EAAU;QAC/B,IAAI;YACF,OAAOC,KAAKC,SAAS,CAACF;QACxB,EAAE,OAAOG,OAAO;YACd,MAAM,IAAIC,MAAM,CAAC,0BAA0B,EAAED,iBAAiBC,QAAQD,MAAME,OAAO,GAAGC,OAAOH,QAAQ;QACvG;IACF;IAEA;;GAEC,GACDI,YAAyBP,IAAY,EAAK;QACxC,IAAI;YACF,OAAOC,KAAKO,KAAK,CAACR;QACpB,EAAE,OAAOG,OAAO;YACd,MAAM,IAAIC,MAAM,CAAC,4BAA4B,EAAED,iBAAiBC,QAAQD,MAAME,OAAO,GAAGC,OAAOH,QAAQ;QACzG;IACF;IAEA;;GAEC,GACD,MAAMM,QAAQC,KAAqB,EAAiB;QAClD,IAAI,IAAI,CAACd,WAAW,KAAK,OAAO;QAC9B,iBAAiB;QACjB,iBAAiB;QACjB,iBAAiB;QACnB;IACF;IAEA;;GAEC,GACDe,cAAcC,OAAe,EAAU;QACrC,OAAO,GAAG,IAAI,CAAChB,WAAW,CAAC,CAAC,EAAEgB,SAAS;IACzC;IAEA;;GAEC,GACDC,gBAAgBC,OAAkD,EAAW;QAC3E,OAAQA;YACN,KAAK;gBACH,OAAO;oBAAC;oBAAW;oBAAQ;iBAAS,CAACC,QAAQ,CAAC,IAAI,CAACnB,WAAW;YAChE,KAAK;gBACH,OAAO,IAAI,CAACA,WAAW,KAAK;YAC9B,KAAK;gBACH,OAAO;oBAAC;oBAAW;iBAAO,CAACmB,QAAQ,CAAC,IAAI,CAACnB,WAAW;YACtD;gBACE,OAAO;QACX;IACF;IA7FA,YAAYA,WAAyB,CAAE;QAFvC,uBAAgBA,eAAhB,KAAA;QAGE,IAAI,CAACA,WAAW,GAAGA,eAAeH,oBAAoBuB,iBAAiB;IACzE;AA4FF"}

package/dist/esm/managers/PermissionManager/runtime/index.js

@@ -0,0 +1,5 @@
+/**
+ * Runtime 层导出
+ */ export { EnvironmentAdapter } from "./EnvironmentAdapter";
+
+//# sourceMappingURL=index.js.map

package/dist/esm/managers/PermissionManager/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/PermissionManager/runtime/index.ts"],"sourcesContent":["/**\n * Runtime 层导出\n */\n\nexport { EnvironmentAdapter } from './EnvironmentAdapter';\n"],"names":["EnvironmentAdapter"],"mappings":"AAAA;;CAEC,GAED,SAASA,kBAAkB,QAAQ,uBAAuB"}

package/dist/esm/managers/PermissionManager/types/framework.d.js

@@ -0,0 +1,10 @@
+/**
+ * @vlian/framework 类型声明
+ * 统一存放框架依赖的类型定义，避免重复声明
+ */ /**
+ * AppEventBus 接口
+ */ /**
+ * 事件监听器选项
+ */ export { };
+
+//# sourceMappingURL=framework.d.js.map

package/dist/esm/managers/PermissionManager/types/framework.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/PermissionManager/types/framework.d.ts"],"sourcesContent":["/**\n * @vlian/framework 类型声明\n * 统一存放框架依赖的类型定义，避免重复声明\n */\n\n/**\n * 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  ): () => void;\n  \n  emit<T = unknown>(\n    event: string,\n    data: T,\n    metadata?: Partial<EventMetadata>\n  ): void | Promise<void>;\n}\n\n/**\n * 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 * 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 * StateManagerInstance 接口\n */\nexport interface StateManagerInstance {\n  get<T = unknown>(key: string): T | null;\n  set<T = unknown>(key: string, value: T): void;\n  remove(key: string): void;\n  clear(): void;\n  namespace?: string;\n}\n\n/**\n * AuthManager 接口\n */\nexport interface AuthManager<T = unknown> {\n  getUserInfo(): T | null;\n  isAuthenticated(): boolean;\n}\n\n/**\n * 事件元数据\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"],"names":[],"mappings":"AAAA;;;CAGC,GAED;;CAEC,GAwED;;CAEC,GACD,WAGC"}

package/dist/esm/managers/PermissionManager/types.js

@@ -0,0 +1,59 @@
+/**
+ * PermissionManager 类型定义
+ */ // 从统一的框架类型声明文件导入
+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;
+}
+/**
+ * 权限事件类型枚举
+ */ export var PermissionEventType = /*#__PURE__*/ function(PermissionEventType) {
+    PermissionEventType["PERMISSIONS_LOADED"] = "permission:loaded";
+    PermissionEventType["PERMISSIONS_UPDATED"] = "permission:updated";
+    PermissionEventType["PERMISSIONS_REFRESHED"] = "permission:refreshed";
+    PermissionEventType["PERMISSION_CHECK"] = "permission:check";
+    PermissionEventType["CACHE_CLEARED"] = "permission:cache:cleared";
+    PermissionEventType["PERMISSION_STATE_CHANGED"] = "permission:state:changed";
+    return PermissionEventType;
+}({});
+/**
+ * 错误码枚举
+ */ export var PermissionErrorCode = /*#__PURE__*/ function(PermissionErrorCode) {
+    // 配置错误 (001-099)
+    PermissionErrorCode["CONFIG_ERROR_001"] = "PERMISSION_ERROR_001";
+    PermissionErrorCode["CONFIG_ERROR_002"] = "PERMISSION_ERROR_002";
+    PermissionErrorCode["CONFIG_ERROR_003"] = "PERMISSION_ERROR_003";
+    // 数据错误 (100-199)
+    PermissionErrorCode["DATA_ERROR_100"] = "PERMISSION_ERROR_100";
+    PermissionErrorCode["DATA_ERROR_101"] = "PERMISSION_ERROR_101";
+    PermissionErrorCode["DATA_ERROR_102"] = "PERMISSION_ERROR_102";
+    // 检查错误 (200-299)
+    PermissionErrorCode["CHECK_ERROR_200"] = "PERMISSION_ERROR_200";
+    PermissionErrorCode["CHECK_ERROR_201"] = "PERMISSION_ERROR_201";
+    // 存储错误 (300-399)
+    PermissionErrorCode["STORAGE_ERROR_300"] = "PERMISSION_ERROR_300";
+    PermissionErrorCode["STORAGE_ERROR_301"] = "PERMISSION_ERROR_301";
+    // 安全错误 (400-499)
+    PermissionErrorCode["SECURITY_ERROR_400"] = "PERMISSION_ERROR_400";
+    PermissionErrorCode["SECURITY_ERROR_401"] = "PERMISSION_ERROR_401";
+    return PermissionErrorCode;
+}({});
+/**
+ * 权限错误类
+ */ export class PermissionError extends Error {
+    constructor(code, message, context){
+        super(message), _define_property(this, "code", void 0), _define_property(this, "context", void 0), this.code = code, this.context = context;
+        this.name = 'PermissionError';
+    }
+}
+
+//# sourceMappingURL=types.js.map

package/dist/esm/managers/PermissionManager/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/managers/PermissionManager/types.ts"],"sourcesContent":["/**\n * PermissionManager 类型定义\n */\n\n// 从统一的框架类型声明文件导入\nimport type {\n  AppEventBus,\n  Logger,\n  MonitoringService,\n  StateManagerInstance,\n  AuthManager,\n  EventMetadata,\n  EventListenerOptions,\n} from './types/framework';\n\n// 重新导出框架类型，供外部使用\nexport type {\n  AppEventBus,\n  Logger,\n  MonitoringService,\n  StateManagerInstance,\n  AuthManager,\n  EventMetadata,\n  EventListenerOptions,\n};\n\n/**\n * 权限数据\n */\nexport interface PermissionData {\n  /**\n   * 权限标识数组\n   */\n  permissions: string[];\n  \n  /**\n   * 角色标识数组\n   */\n  roles: string[];\n  \n  /**\n   * 权限树结构（可选）\n   */\n  permissionTree?: PermissionTree;\n  \n  /**\n   * 数据更新时间戳\n   */\n  updatedAt?: number;\n  \n  /**\n   * 数据过期时间戳（可选）\n   */\n  expiresAt?: number;\n}\n\n/**\n * 权限树节点\n */\nexport interface PermissionTreeNode {\n  /**\n   * 权限标识\n   */\n  permission: string;\n  \n  /**\n   * 子权限节点\n   */\n  children?: PermissionTreeNode[];\n  \n  /**\n   * 权限描述（可选）\n   */\n  description?: string;\n}\n\n/**\n * 权限树结构\n */\nexport interface PermissionTree {\n  /**\n   * 根节点数组\n   */\n  roots: PermissionTreeNode[];\n}\n\n/**\n * 权限树配置\n */\nexport interface PermissionTreeConfig {\n  /**\n   * 权限树数据\n   */\n  tree: PermissionTree;\n  \n  /**\n   * 是否启用权限继承（默认：true）\n   */\n  enableInheritance?: boolean;\n  \n  /**\n   * 权限路径分隔符（默认：':'）\n   */\n  pathSeparator?: string;\n}\n\n/**\n * PermissionManager 配置选项\n */\nexport interface PermissionOptions {\n  // ========== 依赖注入（必需）==========\n  /**\n   * AuthManager 实例（必需）\n   * 用于获取用户信息和权限数据\n   */\n  authManager: AuthManager<unknown>;\n  \n  /**\n   * @vlian/framework StateManager 配置（可选）\n   * 用于权限数据状态管理，支持跨组件共享\n   * 如果不提供，使用内存存储（默认）\n   * 注意：不允许使用浏览器本地存储（localStorage/sessionStorage）\n   */\n  stateManager?: {\n    instance?: StateManagerInstance;\n    namespace?: string; // 状态命名空间，用于隔离\n  };\n  \n  /**\n   * @vlian/framework AppEventBus 实例（可选）\n   * 如果不提供，内部会创建独立的事件总线\n   */\n  eventBus?: AppEventBus;\n  \n  /**\n   * @vlian/framework Logger 实例（可选）\n   */\n  logger?: Logger;\n  \n  /**\n   * @vlian/framework MonitoringService 实例（可选）\n   */\n  monitoring?: MonitoringService;\n  \n  // ========== 权限数据来源配置 ==========\n  /**\n   * 权限数据提取函数（可选）\n   * 从用户信息中提取权限和角色\n   * 如果不提供，使用默认提取逻辑\n   */\n  permissionExtractor?: (userInfo: unknown) => PermissionData | null;\n  \n  /**\n   * 权限数据获取函数（可选）\n   * 从 API 获取权限数据\n   * 如果不提供，只从用户信息中提取\n   */\n  permissionFetcher?: () => Promise<PermissionData>;\n  \n  // ========== 存储配置 ==========\n  /**\n   * 存储策略（默认：'memory'）\n   * - 'memory': 内存存储（默认）\n   * - 'state': 使用 @vlian/framework 状态管理\n   */\n  storageStrategy?: 'memory' | 'state';\n  \n  /**\n   * 是否启用缓存（默认：true）\n   */\n  enableCache?: boolean;\n  \n  /**\n   * 缓存过期时间（毫秒，默认：无过期）\n   * 仅对内存缓存有效\n   */\n  cacheExpiry?: number;\n  \n  // ========== 权限加密配置 ==========\n  /**\n   * 是否启用权限数据加密（默认：false）\n   * 启用后，权限数据会加密存储，获取时自动解密\n   */\n  enableEncryption?: boolean;\n  \n  /**\n   * 加密函数（可选）\n   * 如果不提供，使用默认的 AES 加密\n   * @param data 待加密的数据\n   * @param key 加密密钥\n   * @returns 加密后的数据\n   */\n  encrypt?: (data: string, key: string) => string | Promise<string>;\n  \n  /**\n   * 解密函数（可选）\n   * 如果不提供，使用默认的 AES 解密\n   * @param encryptedData 加密的数据\n   * @param key 解密密钥\n   * @returns 解密后的数据\n   */\n  decrypt?: (encryptedData: string, key: string) => string | Promise<string>;\n  \n  /**\n   * 加密密钥（可选）\n   * 如果不提供，使用默认密钥（不推荐生产环境使用）\n   * 建议通过环境变量或密钥管理服务提供\n   */\n  encryptionKey?: string;\n  \n  // ========== 权限树配置 ==========\n  /**\n   * 是否启用权限树支持（默认：false）\n   */\n  enablePermissionTree?: boolean;\n  \n  /**\n   * 权限树配置（可选）\n   * 如果提供，将用于权限继承检查\n   */\n  permissionTreeConfig?: PermissionTreeConfig;\n  \n  // ========== 通配符匹配配置 ==========\n  /**\n   * 是否启用通配符匹配（默认：false）\n   * ⚠️ 安全警告：启用通配符匹配可能导致过度授权，建议谨慎使用\n   * 建议优先使用精确权限或权限树继承\n   */\n  enableWildcardMatch?: boolean;\n  \n  /**\n   * 通配符匹配模式（默认：'direct'）\n   * - 'direct': 只匹配直接子权限（如 `user:*` 只匹配 `user:edit`，不匹配 `user:order:create`）\n   * - 'recursive': 递归匹配所有后代权限（如 `user:*` 匹配所有 `user:` 开头的权限）\n   * ⚠️ 安全警告：'recursive' 模式风险更高，可能导致过度授权\n   */\n  wildcardMatchMode?: 'direct' | 'recursive';\n  \n  /**\n   * 允许的通配符模式（可选）\n   * 如果不提供，使用默认规则：\n   * - 允许：路径末尾通配符（如 `user:*`）\n   * - 禁止：全局通配符（`*`）\n   * - 禁止：路径开头通配符（`*:edit`）\n   * - 禁止：路径中间通配符（`user:*:delete`）\n   * \n   * 如果提供，将覆盖默认规则\n   * @example\n   * // 只允许特定格式的通配符\n   * allowedWildcardPatterns: [/^[a-z]+:\\*$/] // 只允许 'module:*' 格式\n   */\n  allowedWildcardPatterns?: RegExp[];\n  \n  /**\n   * 是否记录通配符权限使用日志（默认：true）\n   * 用于权限审计和安全监控\n   */\n  logWildcardUsage?: boolean;\n  \n  // ========== 事件配置 ==========\n  /**\n   * 事件命名空间前缀（默认：'permission:'）\n   */\n  eventNamespace?: string;\n  \n  /**\n   * 是否启用事件（默认：true）\n   */\n  enableEvents?: boolean;\n  \n  // ========== 性能配置 ==========\n  /**\n   * 是否启用详细性能指标（默认：false）\n   */\n  enableDetailedMetrics?: boolean;\n  \n  /**\n   * 性能指标收集器（可选）\n   */\n  metricsCollector?: (metrics: PerformanceMetrics) => void;\n  \n  // ========== 并发控制配置 ==========\n  /**\n   * 并发控制策略（默认：'queue'）\n   * - 'queue': 串行队列机制，保证操作顺序执行，避免竞态条件（默认推荐）\n   * - 'version': 版本号机制，只应用最新操作，适合高并发场景\n   * - 'none': 无并发控制，直接执行（不推荐）\n   */\n  concurrencyStrategy?: 'queue' | 'version' | 'none';\n  \n  /**\n   * 队列最大长度（默认：100）\n   * 当使用串行队列策略时，防止内存溢出\n   */\n  maxQueueSize?: number;\n  \n  /**\n   * 操作超时时间（毫秒，默认：30000）\n   * 操作超过此时间会自动取消并拒绝\n   * 设置为 0 表示无超时限制\n   */\n  operationTimeout?: number;\n  \n  // ========== 其他配置 ==========\n  /**\n   * 实例 ID（可选）\n   * 用于多实例场景下的隔离\n   */\n  instanceId?: string;\n  \n  /**\n   * 是否启用开发模式（默认：自动检测）\n   */\n  devMode?: boolean;\n  \n  /**\n   * 是否启用配置验证（默认：true）\n   */\n  validateConfig?: boolean;\n}\n\n/**\n * 权限事件类型枚举\n */\nexport enum PermissionEventType {\n  PERMISSIONS_LOADED = 'permission:loaded',           // 权限数据加载完成\n  PERMISSIONS_UPDATED = 'permission:updated',         // 权限数据更新\n  PERMISSIONS_REFRESHED = 'permission:refreshed',     // 权限数据刷新\n  PERMISSION_CHECK = 'permission:check',              // 权限检查（用于监控）\n  CACHE_CLEARED = 'permission:cache:cleared',         // 缓存清除\n  PERMISSION_STATE_CHANGED = 'permission:state:changed', // 权限状态变化\n}\n\n// EventMetadata 和 EventListenerOptions 已从 framework.d.ts 导入并重新导出\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    permissionData: 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\n/**\n * 权限检查结果（增强版）\n */\nexport interface PermissionCheckResult {\n  /**\n   * 是否拥有权限\n   */\n  result: boolean;\n  \n  /**\n   * 匹配类型\n   */\n  matchType: 'exact' | 'tree' | 'wildcard' | 'none';\n  \n  /**\n   * 失败原因（当 result 为 false 时）\n   */\n  reason?: 'no_data' | 'denied' | 'expired' | 'rate_limited' | 'error';\n  \n  /**\n   * 匹配的权限标识（如果有）\n   */\n  matchedPermission?: string;\n  \n  /**\n   * 检查耗时（毫秒）\n   */\n  duration?: number;\n}\n\n/**\n * 权限状态变化事件数据\n */\nexport interface PermissionStateChangeData {\n  /**\n   * 变化的权限列表\n   */\n  permissions: string[];\n  \n  /**\n   * 变化的角色列表\n   */\n  roles: string[];\n  \n  /**\n   * 变化类型\n   */\n  changeType: 'added' | 'removed' | 'updated';\n  \n  /**\n   * 变化时间戳\n   */\n  timestamp: number;\n}\n\n/**\n * 错误码枚举\n */\nexport enum PermissionErrorCode {\n  // 配置错误 (001-099)\n  CONFIG_ERROR_001 = 'PERMISSION_ERROR_001', // 缺少必需配置\n  CONFIG_ERROR_002 = 'PERMISSION_ERROR_002', // 生产环境缺少加密密钥\n  CONFIG_ERROR_003 = 'PERMISSION_ERROR_003', // 配置验证失败\n  \n  // 数据错误 (100-199)\n  DATA_ERROR_100 = 'PERMISSION_ERROR_100', // 权限数据加载失败\n  DATA_ERROR_101 = 'PERMISSION_ERROR_101', // 权限数据过期\n  DATA_ERROR_102 = 'PERMISSION_ERROR_102', // 权限数据完整性校验失败\n  \n  // 检查错误 (200-299)\n  CHECK_ERROR_200 = 'PERMISSION_ERROR_200', // 权限检查失败\n  CHECK_ERROR_201 = 'PERMISSION_ERROR_201', // 权限检查被限流\n  \n  // 存储错误 (300-399)\n  STORAGE_ERROR_300 = 'PERMISSION_ERROR_300', // 存储操作失败\n  STORAGE_ERROR_301 = 'PERMISSION_ERROR_301', // 存储数据损坏\n  \n  // 安全错误 (400-499)\n  SECURITY_ERROR_400 = 'PERMISSION_ERROR_400', // 安全策略违反\n  SECURITY_ERROR_401 = 'PERMISSION_ERROR_401', // 加密/解密失败\n}\n\n/**\n * 权限错误类\n */\nexport class PermissionError extends Error {\n  constructor(\n    public code: PermissionErrorCode,\n    message: string,\n    public context?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = 'PermissionError';\n  }\n}\n\n/**\n * 配置预设类型\n */\nexport type PermissionConfigPreset = 'production' | 'development' | 'minimal' | 'custom';\n\n/**\n * 配置分组\n */\nexport interface PermissionConfigGroups {\n  storage?: {\n    strategy?: 'memory' | 'state';\n    enableCache?: boolean;\n    cacheExpiry?: number;\n  };\n  security?: {\n    enableEncryption?: boolean;\n    encryptionKey?: string;\n    enableWildcardMatch?: boolean;\n    requireEncryptionKey?: boolean;\n  };\n  performance?: {\n    enableDetailedMetrics?: boolean;\n    enableConcurrentCheck?: boolean;\n    cacheSizeLimit?: number;\n  };\n  events?: {\n    enableEvents?: boolean;\n    eventNamespace?: string;\n  };\n}\n\n/**\n * 权限检查策略接口\n */\nexport interface PermissionCheckStrategy {\n  /**\n   * 检查权限\n   */\n  check(\n    permission: string,\n    permissionData: PermissionData | null,\n    context?: Record<string, unknown>\n  ): PermissionCheckResult;\n  \n  /**\n   * 策略名称\n   */\n  name: string;\n  \n  /**\n   * 策略优先级（数字越大优先级越高）\n   */\n  priority?: number;\n}\n\n/**\n * 权限检查中间件\n */\nexport interface PermissionCheckMiddleware {\n  /**\n   * 中间件名称\n   */\n  name: string;\n  \n  /**\n   * 检查前执行\n   */\n  beforeCheck?(\n    permission: string,\n    context: Record<string, unknown>\n  ): void | Promise<void>;\n  \n  /**\n   * 检查后执行\n   */\n  afterCheck?(\n    permission: string,\n    result: PermissionCheckResult,\n    context: Record<string, unknown>\n  ): void | Promise<void>;\n  \n  /**\n   * 中间件优先级（数字越大优先级越高）\n   */\n  priority?: number;\n}\n\n/**\n * 权限插件接口\n */\nexport interface PermissionPlugin {\n  /**\n   * 插件名称\n   */\n  name: string;\n  \n  /**\n   * 插件版本\n   */\n  version?: string;\n  \n  /**\n   * 初始化钩子\n   */\n  onInit?(manager: unknown): void | Promise<void>;\n  \n  /**\n   * 销毁钩子\n   */\n  onDestroy?(): void | Promise<void>;\n  \n  /**\n   * 权限检查前钩子\n   */\n  beforePermissionCheck?(\n    permission: string,\n    context: Record<string, unknown>\n  ): void | Promise<void>;\n  \n  /**\n   * 权限检查后钩子\n   */\n  afterPermissionCheck?(\n    permission: string,\n    result: PermissionCheckResult,\n    context: Record<string, unknown>\n  ): void | Promise<void>;\n  \n  /**\n   * 权限数据更新前钩子\n   */\n  beforePermissionUpdate?(\n    permissions: string[],\n    roles: string[]\n  ): void | Promise<void>;\n  \n  /**\n   * 权限数据更新后钩子\n   */\n  afterPermissionUpdate?(\n    permissions: string[],\n    roles: string[]\n  ): void | Promise<void>;\n}\n\n/**\n * 权限数据源\n */\nexport interface PermissionDataSource {\n  /**\n   * 数据源名称\n   */\n  name: string;\n  \n  /**\n   * 优先级（数字越大优先级越高）\n   */\n  priority: number;\n  \n  /**\n   * 获取权限数据\n   */\n  fetch(): Promise<PermissionData | null>;\n  \n  /**\n   * 是否启用\n   */\n  enabled?: boolean;\n}\n\n/**\n * 权限数据源合并策略\n */\nexport type DataSourceMergeStrategy = 'union' | 'intersection' | 'priority' | 'custom';\n\n/**\n * 权限匹配器接口\n */\nexport interface PermissionMatcher {\n  /**\n   * 匹配器名称\n   */\n  name: string;\n  \n  /**\n   * 检查是否匹配\n   */\n  match(permission: string, userPermission: string): boolean;\n  \n  /**\n   * 匹配器优先级\n   */\n  priority?: number;\n}\n\n/**\n * 缓存项（带过期时间）\n */\nexport interface CacheItem<T> {\n  value: T;\n  timestamp: number;\n  expiresAt?: number;\n}\n\n/**\n * 性能统计信息\n */\nexport interface PerformanceStatistics {\n  /**\n   * 操作名称\n   */\n  operation: string;\n  \n  /**\n   * 调用次数\n   */\n  count: number;\n  \n  /**\n   * 总耗时（毫秒）\n   */\n  totalDuration: number;\n  \n  /**\n   * 平均耗时（毫秒）\n   */\n  averageDuration: number;\n  \n  /**\n   * 最小耗时（毫秒）\n   */\n  minDuration: number;\n  \n  /**\n   * 最大耗时（毫秒）\n   */\n  maxDuration: number;\n  \n  /**\n   * P95 耗时（毫秒）\n   */\n  p95Duration?: number;\n  \n  /**\n   * P99 耗时（毫秒）\n   */\n  p99Duration?: number;\n  \n  /**\n   * 缓存命中率（0-1）\n   */\n  cacheHitRate?: number;\n  \n  /**\n   * 错误次数\n   */\n  errorCount: number;\n  \n  /**\n   * 错误率（0-1）\n   */\n  errorRate: number;\n}\n\n/**\n * 健康检查详细诊断信息\n */\nexport interface HealthCheckDiagnostics {\n  /**\n   * 存储状态\n   */\n  storage: {\n    available: boolean;\n    strategy: string;\n    size?: number;\n    error?: string;\n  };\n  \n  /**\n   * 缓存状态\n   */\n  cache: {\n    enabled: boolean;\n    size: number;\n    hitRate?: number;\n    memoryUsage?: number;\n  };\n  \n  /**\n   * 权限数据状态\n   */\n  permissionData: {\n    loaded: boolean;\n    permissionCount: number;\n    roleCount: number;\n    lastUpdated?: number;\n    expiresAt?: number;\n  };\n  \n  /**\n   * 最近错误\n   */\n  recentErrors: Array<{\n    code: string;\n    message: string;\n    timestamp: number;\n  }>;\n  \n  /**\n   * 性能指标\n   */\n  performance: {\n    averageCheckDuration: number;\n    totalChecks: number;\n    errorRate: number;\n  };\n}\n\n/**\n * 审计日志条目\n */\nexport interface AuditLogEntry {\n  /**\n   * 日志 ID\n   */\n  id: string;\n  \n  /**\n   * 操作类型\n   */\n  operation: 'check' | 'update' | 'refresh' | 'clear_cache' | 'error';\n  \n  /**\n   * 操作目标（权限、角色等）\n   */\n  target?: string;\n  \n  /**\n   * 操作结果\n   */\n  result: 'success' | 'failure' | 'denied';\n  \n  /**\n   * 操作时间戳\n   */\n  timestamp: number;\n  \n  /**\n   * 用户信息（如果有）\n   */\n  userId?: string;\n  \n  /**\n   * 额外上下文\n   */\n  context?: Record<string, unknown>;\n}\n\n/**\n * 权限变更历史条目\n */\nexport interface PermissionChangeHistory {\n  /**\n   * 变更 ID\n   */\n  id: string;\n  \n  /**\n   * 变更类型\n   */\n  changeType: 'added' | 'removed' | 'updated';\n  \n  /**\n   * 变更目标类型\n   */\n  targetType: 'permission' | 'role';\n  \n  /**\n   * 变更目标标识\n   */\n  target: string;\n  \n  /**\n   * 变更前值（如果是更新）\n   */\n  oldValue?: string[];\n  \n  /**\n   * 变更后值\n   */\n  newValue: string[];\n  \n  /**\n   * 变更时间戳\n   */\n  timestamp: number;\n  \n  /**\n   * 变更原因\n   */\n  reason?: string;\n}\n\n/**\n * 环境适配器接口\n */\nexport interface EnvironmentAdapter {\n  /**\n   * 环境类型\n   */\n  environment: Environment;\n  \n  /**\n   * 是否支持\n   */\n  isSupported(): boolean;\n  \n  /**\n   * 初始化\n   */\n  init?(): void | Promise<void>;\n  \n  /**\n   * 序列化（用于跨线程/进程传递）\n   */\n  serialize?(data: unknown): string | Promise<string>;\n  \n  /**\n   * 反序列化\n   */\n  deserialize?(data: string): unknown | Promise<unknown>;\n  \n  /**\n   * 水合（SSR 场景）\n   */\n  hydrate?(data: PermissionData): void | Promise<void>;\n}\n\n/**\n * 限流配置\n */\nexport interface RateLimitConfig {\n  /**\n   * 是否启用限流\n   */\n  enabled: boolean;\n  \n  /**\n   * 时间窗口（毫秒）\n   */\n  windowMs: number;\n  \n  /**\n   * 最大请求数\n   */\n  maxRequests: number;\n  \n  /**\n   * 限流策略\n   */\n  strategy?: 'token_bucket' | 'sliding_window' | 'fixed_window';\n}\n\n/**\n * 调试信息\n */\nexport interface DebugInfo {\n  /**\n   * 实例信息\n   */\n  instance: {\n    id: string;\n    environment: Environment;\n    isProduction: boolean;\n  };\n  \n  /**\n   * 配置信息\n   */\n  config: {\n    storageStrategy: string;\n    enableCache: boolean;\n    enableEncryption: boolean;\n    enablePermissionTree: boolean;\n    enableWildcardMatch: boolean;\n    wildcardMatchMode?: 'direct' | 'recursive';\n  };\n  \n  /**\n   * 权限数据状态\n   */\n  permissionData: {\n    loaded: boolean;\n    permissionCount: number;\n    roleCount: number;\n    lastUpdated?: number;\n  };\n  \n  /**\n   * 缓存状态\n   */\n  cache: {\n    size: number;\n    hitRate?: number;\n  };\n  \n  /**\n   * 性能统计\n   */\n  performance: PerformanceStatistics[];\n  \n  /**\n   * 最近操作历史\n   */\n  recentOperations: Array<{\n    operation: string;\n    timestamp: number;\n    duration: number;\n    result: string;\n  }>;\n}\n\n/**\n * 扩展权限选项（包含所有新功能）\n */\nexport interface ExtendedPermissionOptions extends PermissionOptions {\n  // 配置预设\n  preset?: PermissionConfigPreset;\n  \n  // 配置分组\n  configGroups?: PermissionConfigGroups;\n  \n  // 策略\n  checkStrategies?: PermissionCheckStrategy[];\n  \n  // 中间件\n  middlewares?: PermissionCheckMiddleware[];\n  \n  // 插件\n  plugins?: PermissionPlugin[];\n  \n  // 多数据源\n  dataSources?: PermissionDataSource[];\n  dataSourceMergeStrategy?: DataSourceMergeStrategy;\n  \n  // 自定义匹配器\n  matchers?: PermissionMatcher[];\n  \n  // 限流配置\n  rateLimit?: RateLimitConfig;\n  \n  // 审计日志配置\n  enableAuditLog?: boolean;\n  auditLogMaxSize?: number;\n  \n  // 变更历史配置\n  enableChangeHistory?: boolean;\n  changeHistoryMaxSize?: number;\n  \n  // 环境适配器\n  environmentAdapter?: EnvironmentAdapter;\n  \n  // 配置热更新\n  enableConfigHotUpdate?: boolean;\n}\n"],"names":["PermissionEventType","PermissionErrorCode","PermissionError","Error","code","message","context","name"],"mappings":"AAAA;;CAEC,GAED,iBAAiB;;;;;;;;;;;;;;AA6TjB;;CAEC,GACD,OAAO,IAAA,AAAKA,6CAAAA;;;;;;;WAAAA;MAOX;AAkGD;;CAEC,GACD,OAAO,IAAA,AAAKC,6CAAAA;IACV,iBAAiB;;;;IAKjB,iBAAiB;;;;IAKjB,iBAAiB;;;IAIjB,iBAAiB;;;IAIjB,iBAAiB;;;WAnBPA;MAsBX;AAED;;CAEC,GACD,OAAO,MAAMC,wBAAwBC;IACnC,YACE,AAAOC,IAAyB,EAChCC,OAAe,EACf,AAAOC,OAAiC,CACxC;QACA,KAAK,CAACD,kGAJCD,OAAAA,WAEAE,UAAAA;QAGP,IAAI,CAACC,IAAI,GAAG;IACd;AACF"}

package/dist/esm/managers/PermissionManager/utils/configUtils.js

@@ -0,0 +1,138 @@
+/**
+ * 配置工具函数
+ * 负责配置预设、验证等功能
+ */ import { CONFIG_PRESETS, PRODUCTION_OVERRIDES } from "../constants";
+import { PermissionError, PermissionErrorCode } from "../types";
+import { EnvironmentDetector } from "../modules";
+/**
+ * 应用配置预设
+ */ export function applyConfigPreset(options, preset) {
+    if (!preset || preset === 'custom') {
+        return options;
+    }
+    const presetConfig = CONFIG_PRESETS[preset];
+    if (!presetConfig) {
+        return options;
+    }
+    // 合并预设配置（预设配置优先级较低）
+    return {
+        ...presetConfig,
+        ...options,
+        // 保留用户提供的关键配置
+        authManager: options.authManager,
+        stateManager: options.stateManager,
+        eventBus: options.eventBus,
+        logger: options.logger,
+        monitoring: options.monitoring
+    };
+}
+/**
+ * 验证配置（统一验证逻辑，整合 EnvironmentDetector 的验证）
+ */ export function validateConfig(options, isProduction) {
+    const errors = [];
+    const warnings = [];
+    // 验证必需配置
+    if (!options.authManager) {
+        errors.push('authManager is required');
+    }
+    // 验证存储策略
+    if (options.storageStrategy && ![
+        'memory',
+        'state'
+    ].includes(options.storageStrategy)) {
+        errors.push('storageStrategy must be "memory" or "state"');
+    }
+    // 验证权限树配置
+    if (options.enablePermissionTree && !options.permissionTreeConfig) {
+        warnings.push('enablePermissionTree is true but permissionTreeConfig is not provided');
+    }
+    // 验证通配符配置
+    if (options.enableWildcardMatch && options.wildcardMatchMode === 'recursive') {
+        warnings.push('recursive wildcard match mode may cause over-authorization, use with caution');
+    }
+    // 验证加密配置
+    if (options.enableEncryption) {
+        if (!options.encrypt && !options.encryptionKey) {
+            const message = isProduction ? 'enableEncryption is true but no encryption key provided (required in production)' : 'enableEncryption is true but no encryption key provided, using default (not recommended for production)';
+            if (isProduction) {
+                errors.push(message);
+            } else {
+                warnings.push(message);
+            }
+        }
+        if (options.encrypt && !options.decrypt) {
+            errors.push('decrypt is required when encrypt is provided');
+        }
+        if (options.decrypt && !options.encrypt) {
+            errors.push('encrypt is required when decrypt is provided');
+        }
+    }
+    // 生产环境验证
+    if (isProduction) {
+        // 生产环境必须提供加密密钥（如果启用了加密）
+        if (options.enableEncryption && !options.encryptionKey) {
+            const requireEncryptionKey = options.configGroups?.security?.requireEncryptionKey;
+            if (requireEncryptionKey !== false) {
+                errors.push('Production environment requires encryptionKey when enableEncryption is true');
+            } else {
+                warnings.push('Production environment should provide encryptionKey when enableEncryption is true');
+            }
+        }
+        // 生产环境警告：通配符匹配
+        if (options.enableWildcardMatch) {
+            warnings.push('Wildcard matching is enabled in production environment, which may cause security risks');
+        }
+    }
+    // 验证事件命名空间
+    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.rateLimit?.enabled) {
+        if (!options.rateLimit.windowMs || options.rateLimit.windowMs <= 0) {
+            errors.push('rateLimit.windowMs must be greater than 0');
+        }
+        if (!options.rateLimit.maxRequests || options.rateLimit.maxRequests <= 0) {
+            errors.push('rateLimit.maxRequests must be greater than 0');
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings
+    };
+}
+/**
+ * 创建配置（应用预设和验证）
+ */ export function createConfig(options) {
+    const isProduction = EnvironmentDetector.checkIsProduction();
+    // 应用预设
+    const config = applyConfigPreset(options, options.preset);
+    // 应用生产环境覆盖
+    if (isProduction) {
+        Object.assign(config, PRODUCTION_OVERRIDES);
+    }
+    // 验证配置
+    if (config.validateConfig !== false) {
+        const validation = validateConfig(config, isProduction);
+        if (!validation.valid) {
+            const errorMsg = validation.errors.join(', ');
+            throw new PermissionError(PermissionErrorCode.CONFIG_ERROR_003, `Configuration validation failed: ${errorMsg}`, {
+                warnings: validation.warnings
+            });
+        }
+        // 输出警告
+        if (validation.warnings.length > 0 && config.devMode) {
+            validation.warnings.forEach((warning)=>{
+                config.logger?.warn(`Config warning: ${warning}`);
+            });
+        }
+    }
+    return config;
+}
+
+//# sourceMappingURL=configUtils.js.map

package/dist/esm/managers/PermissionManager/utils/configUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/PermissionManager/utils/configUtils.ts"],"sourcesContent":["/**\n * 配置工具函数\n * 负责配置预设、验证等功能\n */\n\nimport type {\n  ExtendedPermissionOptions,\n  PermissionConfigPreset,\n  ConfigValidationResult,\n} from '../types';\nimport { CONFIG_PRESETS, PRODUCTION_OVERRIDES } from '../constants';\nimport { PermissionError, PermissionErrorCode } from '../types';\nimport { EnvironmentDetector } from '../modules';\n\n/**\n * 应用配置预设\n */\nexport function applyConfigPreset(\n  options: ExtendedPermissionOptions,\n  preset?: PermissionConfigPreset\n): ExtendedPermissionOptions {\n  if (!preset || preset === 'custom') {\n    return options;\n  }\n\n  const presetConfig = CONFIG_PRESETS[preset];\n  if (!presetConfig) {\n    return options;\n  }\n\n  // 合并预设配置（预设配置优先级较低）\n  return {\n    ...presetConfig,\n    ...options,\n    // 保留用户提供的关键配置\n    authManager: options.authManager,\n    stateManager: options.stateManager,\n    eventBus: options.eventBus,\n    logger: options.logger,\n    monitoring: options.monitoring,\n  } as ExtendedPermissionOptions;\n}\n\n/**\n * 验证配置（统一验证逻辑，整合 EnvironmentDetector 的验证）\n */\nexport function validateConfig(\n  options: ExtendedPermissionOptions,\n  isProduction: boolean\n): ConfigValidationResult {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n\n  // 验证必需配置\n  if (!options.authManager) {\n    errors.push('authManager is required');\n  }\n\n  // 验证存储策略\n  if (options.storageStrategy && !['memory', 'state'].includes(options.storageStrategy)) {\n    errors.push('storageStrategy must be \"memory\" or \"state\"');\n  }\n\n  // 验证权限树配置\n  if (options.enablePermissionTree && !options.permissionTreeConfig) {\n    warnings.push('enablePermissionTree is true but permissionTreeConfig is not provided');\n  }\n\n  // 验证通配符配置\n  if (options.enableWildcardMatch && options.wildcardMatchMode === 'recursive') {\n    warnings.push('recursive wildcard match mode may cause over-authorization, use with caution');\n  }\n\n  // 验证加密配置\n  if (options.enableEncryption) {\n    if (!options.encrypt && !options.encryptionKey) {\n      const message = isProduction\n        ? 'enableEncryption is true but no encryption key provided (required in production)'\n        : 'enableEncryption is true but no encryption key provided, using default (not recommended for production)';\n      if (isProduction) {\n        errors.push(message);\n      } else {\n        warnings.push(message);\n      }\n    }\n    if (options.encrypt && !options.decrypt) {\n      errors.push('decrypt is required when encrypt is provided');\n    }\n    if (options.decrypt && !options.encrypt) {\n      errors.push('encrypt is required when decrypt is provided');\n    }\n  }\n\n  // 生产环境验证\n  if (isProduction) {\n    // 生产环境必须提供加密密钥（如果启用了加密）\n    if (options.enableEncryption && !options.encryptionKey) {\n      const requireEncryptionKey = options.configGroups?.security?.requireEncryptionKey;\n      if (requireEncryptionKey !== false) {\n        errors.push('Production environment requires encryptionKey when enableEncryption is true');\n      } else {\n        warnings.push('Production environment should provide encryptionKey when enableEncryption is true');\n      }\n    }\n\n    // 生产环境警告：通配符匹配\n    if (options.enableWildcardMatch) {\n      warnings.push('Wildcard matching is enabled in production environment, which may cause security risks');\n    }\n  }\n\n  // 验证事件命名空间\n  if (options.eventNamespace && !options.eventNamespace.endsWith(':')) {\n    warnings.push('eventNamespace should end with \":\" for better isolation');\n  }\n\n  // 验证实例 ID\n  if (options.instanceId && !/^[a-zA-Z0-9_-]+$/.test(options.instanceId)) {\n    errors.push('instanceId must contain only alphanumeric characters, hyphens, and underscores');\n  }\n\n  // 验证限流配置\n  if (options.rateLimit?.enabled) {\n    if (!options.rateLimit.windowMs || options.rateLimit.windowMs <= 0) {\n      errors.push('rateLimit.windowMs must be greater than 0');\n    }\n    if (!options.rateLimit.maxRequests || options.rateLimit.maxRequests <= 0) {\n      errors.push('rateLimit.maxRequests must be greater than 0');\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  };\n}\n\n/**\n * 创建配置（应用预设和验证）\n */\nexport function createConfig(\n  options: ExtendedPermissionOptions\n): ExtendedPermissionOptions {\n  const isProduction = EnvironmentDetector.checkIsProduction();\n\n  // 应用预设\n  const config = applyConfigPreset(options, options.preset);\n\n  // 应用生产环境覆盖\n  if (isProduction) {\n    Object.assign(config, PRODUCTION_OVERRIDES);\n  }\n\n  // 验证配置\n  if (config.validateConfig !== false) {\n    const validation = validateConfig(config, isProduction);\n    if (!validation.valid) {\n      const errorMsg = validation.errors.join(', ');\n      throw new PermissionError(\n        PermissionErrorCode.CONFIG_ERROR_003,\n        `Configuration validation failed: ${errorMsg}`,\n        { warnings: validation.warnings }\n      );\n    }\n    // 输出警告\n    if (validation.warnings.length > 0 && config.devMode) {\n      validation.warnings.forEach(warning => {\n        config.logger?.warn(`Config warning: ${warning}`);\n      });\n    }\n  }\n\n  return config;\n}\n"],"names":["CONFIG_PRESETS","PRODUCTION_OVERRIDES","PermissionError","PermissionErrorCode","EnvironmentDetector","applyConfigPreset","options","preset","presetConfig","authManager","stateManager","eventBus","logger","monitoring","validateConfig","isProduction","errors","warnings","push","storageStrategy","includes","enablePermissionTree","permissionTreeConfig","enableWildcardMatch","wildcardMatchMode","enableEncryption","encrypt","encryptionKey","message","decrypt","requireEncryptionKey","configGroups","security","eventNamespace","endsWith","instanceId","test","rateLimit","enabled","windowMs","maxRequests","valid","length","createConfig","checkIsProduction","config","Object","assign","validation","errorMsg","join","CONFIG_ERROR_003","devMode","forEach","warning","warn"],"mappings":"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"}