@vlian/infrastructure 0.9.10

package/dist/esm/managers/PermissionManager/modules/PerformanceMonitor.js

@@ -0,0 +1,181 @@
+/**
+ * 性能监控模块
+ * 负责性能指标的记录、追踪和统计分析
+ * 整合了原 PerformanceMonitor 和 PerformanceStatisticsCollector 的功能
+ */ 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 class PerformanceMonitor {
+    /**
+   * 生成追踪 ID
+   */ generateTraceId() {
+        this.traceIdCounter = (this.traceIdCounter + 1) % 1000000;
+        const timestamp = Date.now();
+        const random = Math.random().toString(36).substring(2, 9);
+        return `trace_${timestamp}_${this.traceIdCounter}_${random}`;
+    }
+    /**
+   * 记录性能指标
+   */ recordPerformance(operation, duration, metadata) {
+        // 在方法开始就检查，避免不必要的对象创建
+        if (!this.enableDetailedMetrics) {
+            return;
+        }
+        const metric = {
+            operation,
+            duration,
+            timestamp: Date.now(),
+            metadata: {
+                ...metadata,
+                environment: this.environment,
+                traceId: this.generateTraceId()
+            }
+        };
+        // 记录到总列表（保留最近 100 条）
+        this.performanceMetrics.push(metric);
+        if (this.performanceMetrics.length > 100) {
+            this.performanceMetrics.shift();
+        }
+        // 按操作分组记录（用于统计分析）
+        const operationMetrics = this.metricsByOperation.get(operation) ?? [];
+        operationMetrics.push(metric);
+        this.metricsByOperation.set(operation, operationMetrics);
+        // 保持每个操作最多保留 maxMetricsPerOperation 条记录
+        if (operationMetrics.length > this.maxMetricsPerOperation) {
+            operationMetrics.shift();
+        }
+        // 记录缓存命中/未命中
+        if (metadata?.cached === true) {
+            this.cacheHits.set(operation, (this.cacheHits.get(operation) ?? 0) + 1);
+        } else if (metadata?.cached === false) {
+            this.cacheMisses.set(operation, (this.cacheMisses.get(operation) ?? 0) + 1);
+        }
+        // 记录错误
+        if (metadata?.error) {
+            this.errors.set(operation, (this.errors.get(operation) ?? 0) + 1);
+        }
+        // 上报到监控服务
+        this.monitoring?.reportPerformance({
+            [operation]: duration
+        }, metadata);
+        // 自定义收集器
+        if (this.metricsCollector) {
+            this.metricsCollector(metric);
+        }
+    }
+    /**
+   * 获取性能指标（最近记录）
+   */ getPerformanceMetrics() {
+        return [
+            ...this.performanceMetrics
+        ];
+    }
+    /**
+   * 获取性能统计信息
+   */ getStatistics(operation) {
+        const operations = operation ? [
+            operation
+        ] : Array.from(this.metricsByOperation.keys());
+        const statistics = [];
+        for (const op of operations){
+            const metrics = this.metricsByOperation.get(op) ?? [];
+            if (metrics.length === 0) {
+                continue;
+            }
+            const durations = metrics.map((m)=>m.duration).sort((a, b)=>a - b);
+            const totalDuration = durations.reduce((sum, d)=>sum + d, 0);
+            const count = durations.length;
+            const averageDuration = totalDuration / count;
+            const minDuration = durations[0] ?? 0;
+            const maxDuration = durations[durations.length - 1] ?? 0;
+            // 计算 P95 和 P99
+            const p95Index = Math.floor(count * 0.95);
+            const p99Index = Math.floor(count * 0.99);
+            const p95Duration = durations[p95Index];
+            const p99Duration = durations[p99Index];
+            // 计算缓存命中率
+            const hits = this.cacheHits.get(op) ?? 0;
+            const misses = this.cacheMisses.get(op) ?? 0;
+            const totalCacheOps = hits + misses;
+            const cacheHitRate = totalCacheOps > 0 ? hits / totalCacheOps : undefined;
+            // 计算错误率
+            const errorCount = this.errors.get(op) ?? 0;
+            const errorRate = count > 0 ? errorCount / count : 0;
+            statistics.push({
+                operation: op,
+                count,
+                totalDuration,
+                averageDuration,
+                minDuration,
+                maxDuration,
+                p95Duration,
+                p99Duration,
+                cacheHitRate,
+                errorCount,
+                errorRate
+            });
+        }
+        return statistics;
+    }
+    /**
+   * 获取缓存命中率
+   */ getCacheHitRate(operation) {
+        const hits = this.cacheHits.get(operation) ?? 0;
+        const misses = this.cacheMisses.get(operation) ?? 0;
+        const total = hits + misses;
+        return total > 0 ? hits / total : undefined;
+    }
+    /**
+   * 清除性能指标
+   */ clearPerformanceMetrics(operation) {
+        if (operation) {
+            // 清除特定操作的指标
+            this.metricsByOperation.delete(operation);
+            this.cacheHits.delete(operation);
+            this.cacheMisses.delete(operation);
+            this.errors.delete(operation);
+            // 从总列表中移除该操作的指标
+            this.performanceMetrics = this.performanceMetrics.filter((m)=>m.operation !== operation);
+        } else {
+            // 清除所有指标
+            this.performanceMetrics = [];
+            this.metricsByOperation.clear();
+            this.cacheHits.clear();
+            this.cacheMisses.clear();
+            this.errors.clear();
+        }
+    }
+    constructor(options){
+        _define_property(this, "enableDetailedMetrics", void 0);
+        _define_property(this, "performanceMetrics", []);
+        _define_property(this, "metricsByOperation", new Map());
+        _define_property(this, "traceIdCounter", 0);
+        _define_property(this, "monitoring", void 0);
+        _define_property(this, "metricsCollector", void 0);
+        _define_property(this, "environment", void 0);
+        // 统计相关
+        _define_property(this, "cacheHits", new Map());
+        _define_property(this, "cacheMisses", new Map());
+        _define_property(this, "errors", new Map());
+        _define_property(this, "maxMetricsPerOperation", 1000); // 每个操作最多保留 1000 条记录
+        this.enableDetailedMetrics = options.enableDetailedMetrics;
+        this.monitoring = options.monitoring;
+        this.metricsCollector = options.metricsCollector;
+        this.environment = options.environment;
+        this.maxMetricsPerOperation = options.maxMetricsPerOperation ?? 1000;
+    }
+}
+
+//# sourceMappingURL=PerformanceMonitor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/PermissionManager/modules/PerformanceMonitor.ts"],"sourcesContent":["/**\n * 性能监控模块\n * 负责性能指标的记录、追踪和统计分析\n * 整合了原 PerformanceMonitor 和 PerformanceStatisticsCollector 的功能\n */\n\nimport type { PerformanceMetrics, PerformanceStatistics } from '../types';\n\n/**\n * 性能监控器（整合版）\n */\nexport class PerformanceMonitor {\n  private enableDetailedMetrics: boolean;\n  private performanceMetrics: PerformanceMetrics[] = [];\n  private metricsByOperation: Map<string, PerformanceMetrics[]> = new Map();\n  private traceIdCounter: number = 0;\n  private monitoring?: { reportPerformance: (metrics: Record<string, number>, context?: Record<string, unknown>) => void };\n  private metricsCollector?: (metrics: PerformanceMetrics) => void;\n  private environment: string;\n  \n  // 统计相关\n  private cacheHits: Map<string, number> = new Map();\n  private cacheMisses: Map<string, number> = new Map();\n  private errors: Map<string, number> = new Map();\n  private maxMetricsPerOperation: number = 1000; // 每个操作最多保留 1000 条记录\n\n  constructor(\n    options: {\n      enableDetailedMetrics: boolean;\n      monitoring?: { reportPerformance: (metrics: Record<string, number>, context?: Record<string, unknown>) => void };\n      metricsCollector?: (metrics: PerformanceMetrics) => void;\n      environment: string;\n      maxMetricsPerOperation?: number;\n    }\n  ) {\n    this.enableDetailedMetrics = options.enableDetailedMetrics;\n    this.monitoring = options.monitoring;\n    this.metricsCollector = options.metricsCollector;\n    this.environment = options.environment;\n    this.maxMetricsPerOperation = options.maxMetricsPerOperation ?? 1000;\n  }\n\n  /**\n   * 生成追踪 ID\n   */\n  private generateTraceId(): string {\n    this.traceIdCounter = (this.traceIdCounter + 1) % 1000000;\n    const timestamp = Date.now();\n    const random = Math.random().toString(36).substring(2, 9);\n    return `trace_${timestamp}_${this.traceIdCounter}_${random}`;\n  }\n\n  /**\n   * 记录性能指标\n   */\n  recordPerformance(operation: string, duration: number, metadata?: Record<string, unknown>): void {\n    // 在方法开始就检查，避免不必要的对象创建\n    if (!this.enableDetailedMetrics) {\n      return;\n    }\n\n    const metric: PerformanceMetrics = {\n      operation,\n      duration,\n      timestamp: Date.now(),\n      metadata: {\n        ...metadata,\n        environment: this.environment,\n        traceId: this.generateTraceId(),\n      },\n    };\n\n    // 记录到总列表（保留最近 100 条）\n    this.performanceMetrics.push(metric);\n    if (this.performanceMetrics.length > 100) {\n      this.performanceMetrics.shift();\n    }\n\n    // 按操作分组记录（用于统计分析）\n    const operationMetrics = this.metricsByOperation.get(operation) ?? [];\n    operationMetrics.push(metric);\n    this.metricsByOperation.set(operation, operationMetrics);\n\n    // 保持每个操作最多保留 maxMetricsPerOperation 条记录\n    if (operationMetrics.length > this.maxMetricsPerOperation) {\n      operationMetrics.shift();\n    }\n\n    // 记录缓存命中/未命中\n    if (metadata?.cached === true) {\n      this.cacheHits.set(operation, (this.cacheHits.get(operation) ?? 0) + 1);\n    } else if (metadata?.cached === false) {\n      this.cacheMisses.set(operation, (this.cacheMisses.get(operation) ?? 0) + 1);\n    }\n\n    // 记录错误\n    if (metadata?.error) {\n      this.errors.set(operation, (this.errors.get(operation) ?? 0) + 1);\n    }\n\n    // 上报到监控服务\n    this.monitoring?.reportPerformance(\n      { [operation]: duration },\n      metadata\n    );\n\n    // 自定义收集器\n    if (this.metricsCollector) {\n      this.metricsCollector(metric);\n    }\n  }\n\n  /**\n   * 获取性能指标（最近记录）\n   */\n  getPerformanceMetrics(): PerformanceMetrics[] {\n    return [...this.performanceMetrics];\n  }\n\n  /**\n   * 获取性能统计信息\n   */\n  getStatistics(operation?: string): PerformanceStatistics[] {\n    const operations = operation ? [operation] : Array.from(this.metricsByOperation.keys());\n    const statistics: PerformanceStatistics[] = [];\n\n    for (const op of operations) {\n      const metrics = this.metricsByOperation.get(op) ?? [];\n      if (metrics.length === 0) {\n        continue;\n      }\n\n      const durations = metrics.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] ?? 0;\n      const maxDuration = durations[durations.length - 1] ?? 0;\n\n      // 计算 P95 和 P99\n      const p95Index = Math.floor(count * 0.95);\n      const p99Index = Math.floor(count * 0.99);\n      const p95Duration = durations[p95Index];\n      const p99Duration = durations[p99Index];\n\n      // 计算缓存命中率\n      const hits = this.cacheHits.get(op) ?? 0;\n      const misses = this.cacheMisses.get(op) ?? 0;\n      const totalCacheOps = hits + misses;\n      const cacheHitRate = totalCacheOps > 0 ? hits / totalCacheOps : undefined;\n\n      // 计算错误率\n      const errorCount = this.errors.get(op) ?? 0;\n      const errorRate = count > 0 ? errorCount / count : 0;\n\n      statistics.push({\n        operation: op,\n        count,\n        totalDuration,\n        averageDuration,\n        minDuration,\n        maxDuration,\n        p95Duration,\n        p99Duration,\n        cacheHitRate,\n        errorCount,\n        errorRate,\n      });\n    }\n\n    return statistics;\n  }\n\n  /**\n   * 获取缓存命中率\n   */\n  getCacheHitRate(operation: string): number | undefined {\n    const hits = this.cacheHits.get(operation) ?? 0;\n    const misses = this.cacheMisses.get(operation) ?? 0;\n    const total = hits + misses;\n    return total > 0 ? hits / total : undefined;\n  }\n\n  /**\n   * 清除性能指标\n   */\n  clearPerformanceMetrics(operation?: string): void {\n    if (operation) {\n      // 清除特定操作的指标\n      this.metricsByOperation.delete(operation);\n      this.cacheHits.delete(operation);\n      this.cacheMisses.delete(operation);\n      this.errors.delete(operation);\n      // 从总列表中移除该操作的指标\n      this.performanceMetrics = this.performanceMetrics.filter(m => m.operation !== operation);\n    } else {\n      // 清除所有指标\n      this.performanceMetrics = [];\n      this.metricsByOperation.clear();\n      this.cacheHits.clear();\n      this.cacheMisses.clear();\n      this.errors.clear();\n    }\n  }\n}\n"],"names":["PerformanceMonitor","generateTraceId","traceIdCounter","timestamp","Date","now","random","Math","toString","substring","recordPerformance","operation","duration","metadata","enableDetailedMetrics","metric","environment","traceId","performanceMetrics","push","length","shift","operationMetrics","metricsByOperation","get","set","maxMetricsPerOperation","cached","cacheHits","cacheMisses","error","errors","monitoring","reportPerformance","metricsCollector","getPerformanceMetrics","getStatistics","operations","Array","from","keys","statistics","op","metrics","durations","map","m","sort","a","b","totalDuration","reduce","sum","d","count","averageDuration","minDuration","maxDuration","p95Index","floor","p99Index","p95Duration","p99Duration","hits","misses","totalCacheOps","cacheHitRate","undefined","errorCount","errorRate","getCacheHitRate","total","clearPerformanceMetrics","delete","filter","clear","options","Map"],"mappings":"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"}

package/dist/esm/managers/PermissionManager/modules/PerformanceStatistics.js

@@ -0,0 +1,125 @@
+/**
+ * 性能统计模块
+ * 负责收集和分析性能指标
+ */ 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 class PerformanceStatisticsCollector {
+    /**
+   * 记录性能指标
+   */ record(metric) {
+        const operation = metric.operation;
+        const metrics = this.metrics.get(operation) ?? [];
+        metrics.push(metric);
+        this.metrics.set(operation, metrics);
+        // 保持最近 1000 条记录
+        if (metrics.length > 1000) {
+            metrics.shift();
+        }
+        // 记录缓存命中/未命中
+        if (metric.metadata?.cached === true) {
+            this.cacheHits.set(operation, (this.cacheHits.get(operation) ?? 0) + 1);
+        } else if (metric.metadata?.cached === false) {
+            this.cacheMisses.set(operation, (this.cacheMisses.get(operation) ?? 0) + 1);
+        }
+        // 记录错误
+        if (metric.metadata?.error) {
+            this.errors.set(operation, (this.errors.get(operation) ?? 0) + 1);
+        }
+    }
+    /**
+   * 获取统计信息
+   */ getStatistics(operation) {
+        const operations = operation ? [
+            operation
+        ] : Array.from(this.metrics.keys());
+        const statistics = [];
+        for (const op of operations){
+            const metrics = this.metrics.get(op) ?? [];
+            if (metrics.length === 0) {
+                continue;
+            }
+            const durations = metrics.map((m)=>m.duration).sort((a, b)=>a - b);
+            const totalDuration = durations.reduce((sum, d)=>sum + d, 0);
+            const count = durations.length;
+            const averageDuration = totalDuration / count;
+            const minDuration = durations[0] ?? 0;
+            const maxDuration = durations[durations.length - 1] ?? 0;
+            // 计算 P95 和 P99
+            const p95Index = Math.floor(count * 0.95);
+            const p99Index = Math.floor(count * 0.99);
+            const p95Duration = durations[p95Index];
+            const p99Duration = durations[p99Index];
+            // 计算缓存命中率
+            const hits = this.cacheHits.get(op) ?? 0;
+            const misses = this.cacheMisses.get(op) ?? 0;
+            const totalCacheOps = hits + misses;
+            const cacheHitRate = totalCacheOps > 0 ? hits / totalCacheOps : undefined;
+            // 计算错误率
+            const errorCount = this.errors.get(op) ?? 0;
+            const errorRate = count > 0 ? errorCount / count : 0;
+            statistics.push({
+                operation: op,
+                count,
+                totalDuration,
+                averageDuration,
+                minDuration,
+                maxDuration,
+                p95Duration,
+                p99Duration,
+                cacheHitRate,
+                errorCount,
+                errorRate
+            });
+        }
+        return statistics;
+    }
+    /**
+   * 获取所有统计信息
+   */ getAllStatistics() {
+        return this.getStatistics();
+    }
+    /**
+   * 清除统计信息
+   */ clear(operation) {
+        if (operation) {
+            this.metrics.delete(operation);
+            this.cacheHits.delete(operation);
+            this.cacheMisses.delete(operation);
+            this.errors.delete(operation);
+        } else {
+            this.metrics.clear();
+            this.cacheHits.clear();
+            this.cacheMisses.clear();
+            this.errors.clear();
+        }
+    }
+    /**
+   * 获取缓存命中率
+   */ getCacheHitRate(operation) {
+        const hits = this.cacheHits.get(operation) ?? 0;
+        const misses = this.cacheMisses.get(operation) ?? 0;
+        const total = hits + misses;
+        return total > 0 ? hits / total : undefined;
+    }
+    constructor(){
+        _define_property(this, "metrics", new Map());
+        _define_property(this, "cacheHits", new Map());
+        _define_property(this, "cacheMisses", new Map());
+        _define_property(this, "errors", new Map());
+    }
+}
+
+//# sourceMappingURL=PerformanceStatistics.js.map

package/dist/esm/managers/PermissionManager/modules/PerformanceStatistics.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/PermissionManager/modules/PerformanceStatistics.ts"],"sourcesContent":["/**\n * 性能统计模块\n * 负责收集和分析性能指标\n */\n\nimport type { PerformanceStatistics, PerformanceMetrics } from '../types';\n\n/**\n * 性能统计器\n */\nexport class PerformanceStatisticsCollector {\n  private metrics: Map<string, PerformanceMetrics[]> = new Map();\n  private cacheHits: Map<string, number> = new Map();\n  private cacheMisses: Map<string, number> = new Map();\n  private errors: Map<string, number> = new Map();\n\n  /**\n   * 记录性能指标\n   */\n  record(metric: PerformanceMetrics): void {\n    const operation = metric.operation;\n    const metrics = this.metrics.get(operation) ?? [];\n    metrics.push(metric);\n    this.metrics.set(operation, metrics);\n\n    // 保持最近 1000 条记录\n    if (metrics.length > 1000) {\n      metrics.shift();\n    }\n\n    // 记录缓存命中/未命中\n    if (metric.metadata?.cached === true) {\n      this.cacheHits.set(operation, (this.cacheHits.get(operation) ?? 0) + 1);\n    } else if (metric.metadata?.cached === false) {\n      this.cacheMisses.set(operation, (this.cacheMisses.get(operation) ?? 0) + 1);\n    }\n\n    // 记录错误\n    if (metric.metadata?.error) {\n      this.errors.set(operation, (this.errors.get(operation) ?? 0) + 1);\n    }\n  }\n\n  /**\n   * 获取统计信息\n   */\n  getStatistics(operation?: string): PerformanceStatistics[] {\n    const operations = operation ? [operation] : Array.from(this.metrics.keys());\n    const statistics: PerformanceStatistics[] = [];\n\n    for (const op of operations) {\n      const metrics = this.metrics.get(op) ?? [];\n      if (metrics.length === 0) {\n        continue;\n      }\n\n      const durations = metrics.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] ?? 0;\n      const maxDuration = durations[durations.length - 1] ?? 0;\n\n      // 计算 P95 和 P99\n      const p95Index = Math.floor(count * 0.95);\n      const p99Index = Math.floor(count * 0.99);\n      const p95Duration = durations[p95Index];\n      const p99Duration = durations[p99Index];\n\n      // 计算缓存命中率\n      const hits = this.cacheHits.get(op) ?? 0;\n      const misses = this.cacheMisses.get(op) ?? 0;\n      const totalCacheOps = hits + misses;\n      const cacheHitRate = totalCacheOps > 0 ? hits / totalCacheOps : undefined;\n\n      // 计算错误率\n      const errorCount = this.errors.get(op) ?? 0;\n      const errorRate = count > 0 ? errorCount / count : 0;\n\n      statistics.push({\n        operation: op,\n        count,\n        totalDuration,\n        averageDuration,\n        minDuration,\n        maxDuration,\n        p95Duration,\n        p99Duration,\n        cacheHitRate,\n        errorCount,\n        errorRate,\n      });\n    }\n\n    return statistics;\n  }\n\n  /**\n   * 获取所有统计信息\n   */\n  getAllStatistics(): PerformanceStatistics[] {\n    return this.getStatistics();\n  }\n\n  /**\n   * 清除统计信息\n   */\n  clear(operation?: string): void {\n    if (operation) {\n      this.metrics.delete(operation);\n      this.cacheHits.delete(operation);\n      this.cacheMisses.delete(operation);\n      this.errors.delete(operation);\n    } else {\n      this.metrics.clear();\n      this.cacheHits.clear();\n      this.cacheMisses.clear();\n      this.errors.clear();\n    }\n  }\n\n  /**\n   * 获取缓存命中率\n   */\n  getCacheHitRate(operation: string): number | undefined {\n    const hits = this.cacheHits.get(operation) ?? 0;\n    const misses = this.cacheMisses.get(operation) ?? 0;\n    const total = hits + misses;\n    return total > 0 ? hits / total : undefined;\n  }\n}\n"],"names":["PerformanceStatisticsCollector","record","metric","operation","metrics","get","push","set","length","shift","metadata","cached","cacheHits","cacheMisses","error","errors","getStatistics","operations","Array","from","keys","statistics","op","durations","map","m","duration","sort","a","b","totalDuration","reduce","sum","d","count","averageDuration","minDuration","maxDuration","p95Index","Math","floor","p99Index","p95Duration","p99Duration","hits","misses","totalCacheOps","cacheHitRate","undefined","errorCount","errorRate","getAllStatistics","clear","delete","getCacheHitRate","total","Map"],"mappings":"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"}

package/dist/esm/managers/PermissionManager/modules/PermissionChecker.js

@@ -0,0 +1,218 @@
+/**
+ * 权限检查模块
+ * 负责权限检查的核心逻辑，包括权限树、通配符匹配等
+ */ 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 class PermissionChecker {
+    /**
+   * 检查用户是否拥有指定权限
+   */ hasPermission(permission, permissionData, permissionTreeCache) {
+        if (!permissionData) {
+            return {
+                result: false,
+                matchType: 'none'
+            };
+        }
+        const permissions = permissionData.permissions || [];
+        // 1. 精确匹配检查（优先级最高）
+        if (permissions.includes(permission)) {
+            return {
+                result: true,
+                matchType: 'exact'
+            };
+        }
+        // 2. 权限树继承检查（需启用权限树）
+        if (this.enablePermissionTree && permissionTreeCache) {
+            const hasPermission = this.checkPermissionTree(permission, permissions, permissionTreeCache);
+            if (hasPermission) {
+                return {
+                    result: true,
+                    matchType: 'tree'
+                };
+            }
+        }
+        // 3. 通配符匹配检查（需显式启用，默认关闭）
+        if (this.enableWildcardMatch) {
+            const hasPermission = this.checkWildcardMatch(permission, permissions);
+            if (hasPermission !== null) {
+                if (this.logWildcardUsage) {
+                    this.logger?.info(`Wildcard permission check: ${permission}`, {
+                        matched: hasPermission
+                    });
+                }
+                return {
+                    result: hasPermission,
+                    matchType: 'wildcard'
+                };
+            }
+        }
+        // 默认拒绝策略
+        return {
+            result: false,
+            matchType: 'none'
+        };
+    }
+    /**
+   * 检查权限树继承
+   */ checkPermissionTree(permission, userPermissions, permissionTreeCache) {
+        const pathSeparator = this.permissionTreeConfig?.pathSeparator || ':';
+        const permissionParts = permission.split(pathSeparator);
+        // 从被检查的权限向上查找父权限
+        for(let i = permissionParts.length; i > 0; i--){
+            const parentPermission = permissionParts.slice(0, i).join(pathSeparator);
+            // 检查用户是否拥有父权限
+            if (userPermissions.includes(parentPermission)) {
+                // 检查权限树中是否存在继承关系
+                if (this.findPermissionInTree(parentPermission, permission, permissionTreeCache.roots)) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    /**
+   * 在权限树中查找权限
+   */ findPermissionInTree(parentPermission, childPermission, nodes) {
+        for (const node of nodes){
+            if (node.permission === parentPermission) {
+                // 检查子节点
+                if (node.children) {
+                    for (const child of node.children){
+                        if (child.permission === childPermission) {
+                            return true;
+                        }
+                        // 递归检查
+                        if (child.children) {
+                            if (this.findPermissionInTree(parentPermission, childPermission, [
+                                child
+                            ])) {
+                                return true;
+                            }
+                        }
+                    }
+                }
+            }
+            // 递归检查子节点
+            if (node.children) {
+                if (this.findPermissionInTree(parentPermission, childPermission, node.children)) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    /**
+   * 检查通配符匹配
+   */ checkWildcardMatch(permission, userPermissions) {
+        const pathSeparator = this.permissionTreeConfig?.pathSeparator || ':';
+        for (const userPermission of userPermissions){
+            // 检查是否是通配符权限
+            if (!userPermission.includes('*')) {
+                continue;
+            }
+            // 验证通配符权限格式
+            if (!this.validateWildcardPermission(userPermission)) {
+                continue;
+            }
+            // 检查是否匹配
+            if (this.matchWildcardPermission(userPermission, permission, pathSeparator)) {
+                return true;
+            }
+        }
+        return null; // 表示未匹配（不是 false，因为 false 表示明确拒绝）
+    }
+    /**
+   * 验证通配符权限格式
+   */ validateWildcardPermission(permission) {
+        // 检查是否允许全局通配符
+        if (permission === '*') {
+            return false; // 禁止全局通配符
+        }
+        // 检查是否在路径开头有通配符
+        if (permission.startsWith('*')) {
+            return false; // 禁止路径开头通配符
+        }
+        // 检查是否在路径中间有通配符（不是末尾）
+        // 例如：user:*:delete 中的 * 在中间，应该禁止
+        // 但 user:* 中的 * 在末尾，应该允许
+        const pathSeparator = this.permissionTreeConfig?.pathSeparator || ':';
+        const lastStarIndex = permission.lastIndexOf('*');
+        if (lastStarIndex > 0 && lastStarIndex < permission.length - 1) {
+            // * 不在末尾，检查是否在路径中间
+            const beforeStar = permission.substring(0, lastStarIndex);
+            const afterStar = permission.substring(lastStarIndex + 1);
+            if (beforeStar.includes(pathSeparator) && afterStar.includes(pathSeparator)) {
+                return false; // 禁止路径中间通配符
+            }
+        }
+        // 如果提供了允许的模式列表，检查是否符合
+        if (this.allowedWildcardPatterns) {
+            return this.allowedWildcardPatterns.some((pattern)=>pattern.test(permission));
+        }
+        // 使用默认规则：只允许路径末尾通配符
+        // 注意：在正则表达式中，* 需要转义为 \*，但在字符串中需要写成 \\*
+        return /^[a-zA-Z0-9_]+:\*$/.test(permission) || /^[a-zA-Z0-9_]+:[a-zA-Z0-9_]+:\*$/.test(permission);
+    }
+    /**
+   * 匹配通配符权限
+   */ matchWildcardPermission(wildcardPermission, permission, pathSeparator) {
+        // 移除通配符，获取前缀
+        // 同时移除末尾的分隔符（如果有的话）
+        let prefix = wildcardPermission.replace(/\*$/, '');
+        if (prefix.endsWith(pathSeparator)) {
+            prefix = prefix.slice(0, -pathSeparator.length);
+        }
+        if (this.wildcardMatchMode === 'recursive') {
+            // 递归匹配：匹配所有以 prefix 开头的权限
+            // 需要确保匹配的是完整的路径段，例如 admin:* 应该匹配 admin:user 但不匹配 adminuser
+            const prefixWithSeparator = prefix + pathSeparator;
+            return permission === prefix || permission.startsWith(prefixWithSeparator);
+        } else {
+            // 直接匹配：只匹配直接子权限
+            // 例如：user:* 匹配 user:edit，但不匹配 user:order:create
+            const permissionParts = permission.split(pathSeparator);
+            const prefixParts = prefix.split(pathSeparator).filter((part)=>part !== ''); // 过滤空字符串
+            // 前缀部分必须完全匹配，且被检查的权限比前缀多一个部分
+            if (permissionParts.length !== prefixParts.length + 1) {
+                return false;
+            }
+            for(let i = 0; i < prefixParts.length; i++){
+                if (permissionParts[i] !== prefixParts[i]) {
+                    return false;
+                }
+            }
+            return true;
+        }
+    }
+    constructor(options){
+        _define_property(this, "enablePermissionTree", void 0);
+        _define_property(this, "enableWildcardMatch", void 0);
+        _define_property(this, "wildcardMatchMode", void 0);
+        _define_property(this, "logWildcardUsage", void 0);
+        _define_property(this, "permissionTreeConfig", void 0);
+        _define_property(this, "allowedWildcardPatterns", void 0);
+        _define_property(this, "logger", void 0);
+        this.enablePermissionTree = options.enablePermissionTree;
+        this.enableWildcardMatch = options.enableWildcardMatch;
+        this.wildcardMatchMode = options.wildcardMatchMode;
+        this.logWildcardUsage = options.logWildcardUsage;
+        this.permissionTreeConfig = options.permissionTreeConfig;
+        this.allowedWildcardPatterns = options.allowedWildcardPatterns;
+        this.logger = options.logger;
+    }
+}
+
+//# sourceMappingURL=PermissionChecker.js.map

package/dist/esm/managers/PermissionManager/modules/PermissionChecker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/PermissionManager/modules/PermissionChecker.ts"],"sourcesContent":["/**\n * 权限检查模块\n * 负责权限检查的核心逻辑，包括权限树、通配符匹配等\n */\n\nimport type {\n  PermissionData,\n  PermissionTree,\n  PermissionTreeNode,\n  PermissionTreeConfig,\n} from '../types';\n\n/**\n * 权限检查器\n */\nexport class PermissionChecker {\n  private enablePermissionTree: boolean;\n  private enableWildcardMatch: boolean;\n  private wildcardMatchMode: 'direct' | 'recursive';\n  private logWildcardUsage: boolean;\n  private permissionTreeConfig?: PermissionTreeConfig;\n  private allowedWildcardPatterns?: RegExp[];\n  private logger?: { info: (message: string, ...args: unknown[]) => void };\n\n  constructor(\n    options: {\n      enablePermissionTree: boolean;\n      enableWildcardMatch: boolean;\n      wildcardMatchMode: 'direct' | 'recursive';\n      logWildcardUsage: boolean;\n      permissionTreeConfig?: PermissionTreeConfig;\n      allowedWildcardPatterns?: RegExp[];\n      logger?: { info: (message: string, ...args: unknown[]) => void };\n    }\n  ) {\n    this.enablePermissionTree = options.enablePermissionTree;\n    this.enableWildcardMatch = options.enableWildcardMatch;\n    this.wildcardMatchMode = options.wildcardMatchMode;\n    this.logWildcardUsage = options.logWildcardUsage;\n    this.permissionTreeConfig = options.permissionTreeConfig;\n    this.allowedWildcardPatterns = options.allowedWildcardPatterns;\n    this.logger = options.logger;\n  }\n\n  /**\n   * 检查用户是否拥有指定权限\n   */\n  hasPermission(\n    permission: string,\n    permissionData: PermissionData | null,\n    permissionTreeCache: PermissionTree | null\n  ): { result: boolean; matchType: 'exact' | 'tree' | 'wildcard' | 'none' } {\n    if (!permissionData) {\n      return { result: false, matchType: 'none' };\n    }\n\n    const permissions = permissionData.permissions || [];\n\n    // 1. 精确匹配检查（优先级最高）\n    if (permissions.includes(permission)) {\n      return { result: true, matchType: 'exact' };\n    }\n\n    // 2. 权限树继承检查（需启用权限树）\n    if (this.enablePermissionTree && permissionTreeCache) {\n      const hasPermission = this.checkPermissionTree(permission, permissions, permissionTreeCache);\n      if (hasPermission) {\n        return { result: true, matchType: 'tree' };\n      }\n    }\n\n    // 3. 通配符匹配检查（需显式启用，默认关闭）\n    if (this.enableWildcardMatch) {\n      const hasPermission = this.checkWildcardMatch(permission, permissions);\n      if (hasPermission !== null) {\n        if (this.logWildcardUsage) {\n          this.logger?.info(`Wildcard permission check: ${permission}`, {\n            matched: hasPermission,\n          });\n        }\n        return { result: hasPermission, matchType: 'wildcard' };\n      }\n    }\n\n    // 默认拒绝策略\n    return { result: false, matchType: 'none' };\n  }\n\n  /**\n   * 检查权限树继承\n   */\n  private checkPermissionTree(\n    permission: string,\n    userPermissions: string[],\n    permissionTreeCache: PermissionTree\n  ): boolean {\n    const pathSeparator = this.permissionTreeConfig?.pathSeparator || ':';\n    const permissionParts = permission.split(pathSeparator);\n\n    // 从被检查的权限向上查找父权限\n    for (let i = permissionParts.length; i > 0; i--) {\n      const parentPermission = permissionParts.slice(0, i).join(pathSeparator);\n      \n      // 检查用户是否拥有父权限\n      if (userPermissions.includes(parentPermission)) {\n        // 检查权限树中是否存在继承关系\n        if (this.findPermissionInTree(parentPermission, permission, permissionTreeCache.roots)) {\n          return true;\n        }\n      }\n    }\n\n    return false;\n  }\n\n  /**\n   * 在权限树中查找权限\n   */\n  private findPermissionInTree(\n    parentPermission: string,\n    childPermission: string,\n    nodes: PermissionTreeNode[]\n  ): boolean {\n    for (const node of nodes) {\n      if (node.permission === parentPermission) {\n        // 检查子节点\n        if (node.children) {\n          for (const child of node.children) {\n            if (child.permission === childPermission) {\n              return true;\n            }\n            // 递归检查\n            if (child.children) {\n              if (this.findPermissionInTree(parentPermission, childPermission, [child])) {\n                return true;\n              }\n            }\n          }\n        }\n      }\n      // 递归检查子节点\n      if (node.children) {\n        if (this.findPermissionInTree(parentPermission, childPermission, node.children)) {\n          return true;\n        }\n      }\n    }\n    return false;\n  }\n\n  /**\n   * 检查通配符匹配\n   */\n  private checkWildcardMatch(permission: string, userPermissions: string[]): boolean | null {\n    const pathSeparator = this.permissionTreeConfig?.pathSeparator || ':';\n    \n    for (const userPermission of userPermissions) {\n      // 检查是否是通配符权限\n      if (!userPermission.includes('*')) {\n        continue;\n      }\n\n      // 验证通配符权限格式\n      if (!this.validateWildcardPermission(userPermission)) {\n        continue;\n      }\n\n      // 检查是否匹配\n      if (this.matchWildcardPermission(userPermission, permission, pathSeparator)) {\n        return true;\n      }\n    }\n\n    return null; // 表示未匹配（不是 false，因为 false 表示明确拒绝）\n  }\n\n  /**\n   * 验证通配符权限格式\n   */\n  private validateWildcardPermission(permission: string): boolean {\n    // 检查是否允许全局通配符\n    if (permission === '*') {\n      return false; // 禁止全局通配符\n    }\n\n    // 检查是否在路径开头有通配符\n    if (permission.startsWith('*')) {\n      return false; // 禁止路径开头通配符\n    }\n\n    // 检查是否在路径中间有通配符（不是末尾）\n    // 例如：user:*:delete 中的 * 在中间，应该禁止\n    // 但 user:* 中的 * 在末尾，应该允许\n    const pathSeparator = this.permissionTreeConfig?.pathSeparator || ':';\n    const lastStarIndex = permission.lastIndexOf('*');\n    if (lastStarIndex > 0 && lastStarIndex < permission.length - 1) {\n      // * 不在末尾，检查是否在路径中间\n      const beforeStar = permission.substring(0, lastStarIndex);\n      const afterStar = permission.substring(lastStarIndex + 1);\n      if (beforeStar.includes(pathSeparator) && afterStar.includes(pathSeparator)) {\n        return false; // 禁止路径中间通配符\n      }\n    }\n\n    // 如果提供了允许的模式列表，检查是否符合\n    if (this.allowedWildcardPatterns) {\n      return this.allowedWildcardPatterns.some(pattern => pattern.test(permission));\n    }\n\n    // 使用默认规则：只允许路径末尾通配符\n    // 注意：在正则表达式中，* 需要转义为 \\*，但在字符串中需要写成 \\\\*\n    return /^[a-zA-Z0-9_]+:\\*$/.test(permission) || \n           /^[a-zA-Z0-9_]+:[a-zA-Z0-9_]+:\\*$/.test(permission);\n  }\n\n  /**\n   * 匹配通配符权限\n   */\n  private matchWildcardPermission(\n    wildcardPermission: string,\n    permission: string,\n    pathSeparator: string\n  ): boolean {\n    // 移除通配符，获取前缀\n    // 同时移除末尾的分隔符（如果有的话）\n    let prefix = wildcardPermission.replace(/\\*$/, '');\n    if (prefix.endsWith(pathSeparator)) {\n      prefix = prefix.slice(0, -pathSeparator.length);\n    }\n    \n    if (this.wildcardMatchMode === 'recursive') {\n      // 递归匹配：匹配所有以 prefix 开头的权限\n      // 需要确保匹配的是完整的路径段，例如 admin:* 应该匹配 admin:user 但不匹配 adminuser\n      const prefixWithSeparator = prefix + pathSeparator;\n      return permission === prefix || permission.startsWith(prefixWithSeparator);\n    } else {\n      // 直接匹配：只匹配直接子权限\n      // 例如：user:* 匹配 user:edit，但不匹配 user:order:create\n      const permissionParts = permission.split(pathSeparator);\n      const prefixParts = prefix.split(pathSeparator).filter(part => part !== ''); // 过滤空字符串\n      \n      // 前缀部分必须完全匹配，且被检查的权限比前缀多一个部分\n      if (permissionParts.length !== prefixParts.length + 1) {\n        return false;\n      }\n      \n      for (let i = 0; i < prefixParts.length; i++) {\n        if (permissionParts[i] !== prefixParts[i]) {\n          return false;\n        }\n      }\n      \n      return true;\n    }\n  }\n}\n"],"names":["PermissionChecker","hasPermission","permission","permissionData","permissionTreeCache","result","matchType","permissions","includes","enablePermissionTree","checkPermissionTree","enableWildcardMatch","checkWildcardMatch","logWildcardUsage","logger","info","matched","userPermissions","pathSeparator","permissionTreeConfig","permissionParts","split","i","length","parentPermission","slice","join","findPermissionInTree","roots","childPermission","nodes","node","children","child","userPermission","validateWildcardPermission","matchWildcardPermission","startsWith","lastStarIndex","lastIndexOf","beforeStar","substring","afterStar","allowedWildcardPatterns","some","pattern","test","wildcardPermission","prefix","replace","endsWith","wildcardMatchMode","prefixWithSeparator","prefixParts","filter","part","options"],"mappings":"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"}