@vlian/framework 1.0.3 → 1.0.4

package/dist/core/event/AppEventBus.cjs

@@ -0,0 +1,446 @@
+/**
+ * 应用级事件总线
+ * 提供高性能、类型安全、可观测的事件通信能力
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "AppEventBus", {
+    enumerable: true,
+    get: function() {
+        return AppEventBus;
+    }
+});
+const _utils = require("../../utils");
+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 AppEventBus = class AppEventBus {
+    /**
+   * 订阅事件
+   * 
+   * @param event - 事件名称
+   * @param listener - 事件监听器
+   * @param options - 监听器选项
+   * @returns 取消订阅函数
+   * 
+   * @example
+   * ```typescript
+   * const unsubscribe = eventBus.on('user:login', (data, metadata) => {
+   *   console.log('用户登录:', data);
+   * });
+   * 
+   * // 取消订阅
+   * unsubscribe();
+   * ```
+   */ on(event, listener, options = {}) {
+        const fullEventName = this.getFullEventName(event);
+        const listenerId = Symbol(`listener_${++this.listenerIdCounter}`);
+        const listenerWithOptions = {
+            listener: listener,
+            options: {
+                priority: options.priority ?? 100,
+                once: options.once ?? false,
+                namespace: options.namespace ?? this.config.namespacePrefix,
+                async: options.async ?? true
+            },
+            id: listenerId
+        };
+        if (!this.listeners.has(fullEventName)) {
+            this.listeners.set(fullEventName, new Set());
+        }
+        const listeners = this.listeners.get(fullEventName);
+        listeners.add(listenerWithOptions);
+        // 按优先级排序（数字越小优先级越高）
+        const sortedListeners = Array.from(listeners).sort((a, b)=>a.options.priority - b.options.priority);
+        this.listeners.set(fullEventName, new Set(sortedListeners));
+        // 返回取消订阅函数
+        return ()=>{
+            const currentListeners = this.listeners.get(fullEventName);
+            if (currentListeners) {
+                currentListeners.delete(listenerWithOptions);
+                if (currentListeners.size === 0) {
+                    this.listeners.delete(fullEventName);
+                }
+            }
+        };
+    }
+    /**
+   * 取消订阅事件
+   * 
+   * @param event - 事件名称
+   * @param listener - 事件监听器（可选，不提供则取消该事件的所有监听器）
+   */ off(event, listener) {
+        const fullEventName = this.getFullEventName(event);
+        const listeners = this.listeners.get(fullEventName);
+        if (!listeners) {
+            return;
+        }
+        if (listener) {
+            // 移除指定的监听器
+            for (const item of listeners){
+                if (item.listener === listener) {
+                    listeners.delete(item);
+                    break;
+                }
+            }
+        } else {
+            // 移除所有监听器
+            listeners.clear();
+        }
+        if (listeners.size === 0) {
+            this.listeners.delete(fullEventName);
+        }
+    }
+    /**
+   * 一次性订阅事件
+   * 
+   * @param event - 事件名称
+   * @param listener - 事件监听器
+   * @param options - 监听器选项
+   */ once(event, listener, options) {
+        return this.on(event, listener, {
+            ...options,
+            once: true
+        });
+    }
+    /**
+   * 发布事件
+   * 
+   * @param event - 事件名称
+   * @param data - 事件数据
+   * @param metadata - 事件元数据（可选）
+   * 
+   * @example
+   * ```typescript
+   * await eventBus.emit('user:login', {
+   *   userId: '123',
+   *   username: 'john',
+   * });
+   * ```
+   */ async emit(event, data, metadata) {
+        const fullEventName = this.getFullEventName(event);
+        const startTime = this.config.enablePerformanceMonitoring ? performance.now() : 0;
+        // 事件验证
+        if (this.config.enableValidation && !this.config.validator(fullEventName, data)) {
+            _utils.logger.warn(`事件 ${fullEventName} 验证失败，已忽略`);
+            return;
+        }
+        // 安全检查
+        if (this.config.enableSecurityMode && metadata?.source) {
+            if (!this.config.allowedSources.includes(metadata.source)) {
+                _utils.logger.warn(`事件 ${fullEventName} 的来源 ${metadata.source} 不在白名单中，已忽略`);
+                return;
+            }
+        }
+        // 构建事件元数据
+        const eventMetadata = {
+            source: metadata?.source,
+            timestamp: metadata?.timestamp ?? Date.now(),
+            eventId: metadata?.eventId ?? `event_${++this.eventCounter}`,
+            priority: metadata?.priority ?? 0,
+            instanceId: metadata?.instanceId ?? this.config.instanceId,
+            namespace: metadata?.namespace ?? this.config.namespacePrefix,
+            ...metadata
+        };
+        // 创建事件包装器
+        const eventWrapper = {
+            data: data,
+            metadata: eventMetadata
+        };
+        // 执行中间件（中间件可以阻止事件传播）
+        if (this.middlewares.length > 0) {
+            let middlewareIndex = 0;
+            let nextCalled = false;
+            const executeMiddleware = async ()=>{
+                if (middlewareIndex < this.middlewares.length) {
+                    nextCalled = false;
+                    const currentIndex = middlewareIndex;
+                    const middleware = this.middlewares[middlewareIndex++];
+                    const next = async ()=>{
+                        nextCalled = true;
+                        if (currentIndex < this.middlewares.length - 1) {
+                            await executeMiddleware();
+                        }
+                    };
+                    await Promise.resolve(middleware(fullEventName, data, eventMetadata, next));
+                    // 如果中间件没有调用 next()，阻止事件传播
+                    if (!nextCalled) {
+                        return;
+                    }
+                }
+            };
+            await executeMiddleware();
+            // 如果最后一个中间件没有调用 next()，阻止事件传播
+            if (!nextCalled && this.middlewares.length > 0) {
+                return;
+            }
+        }
+        // 获取监听器
+        const listeners = this.listeners.get(fullEventName);
+        // 记录事件历史（无论是否有监听器）
+        if (this.config.enableTracking) {
+            const executionTime = this.config.enablePerformanceMonitoring ? performance.now() - startTime : undefined;
+            this.recordEventHistory(fullEventName, data, eventMetadata, executionTime);
+        }
+        if (!listeners || listeners.size === 0) {
+            // 更新统计（即使没有监听器也记录）
+            this.updateStats(fullEventName, 0);
+            return;
+        }
+        // 执行监听器
+        const executionPromises = [];
+        const listenersToRemove = [];
+        for (const listenerWithOptions of listeners){
+            const executeListener = async ()=>{
+                try {
+                    if (listenerWithOptions.options.async) {
+                        await Promise.resolve(listenerWithOptions.listener(eventWrapper.data, eventWrapper.metadata));
+                    } else {
+                        listenerWithOptions.listener(eventWrapper.data, eventWrapper.metadata);
+                    }
+                    // 如果是一次性监听器，标记为待移除
+                    if (listenerWithOptions.options.once) {
+                        listenersToRemove.push(listenerWithOptions);
+                    }
+                } catch (error) {
+                    _utils.logger.error(`事件 ${fullEventName} 的监听器执行失败:`, error);
+                }
+            };
+            executionPromises.push(executeListener());
+        }
+        // 等待所有监听器执行完成
+        await Promise.allSettled(executionPromises);
+        // 移除一次性监听器
+        for (const listenerToRemove of listenersToRemove){
+            listeners.delete(listenerToRemove);
+        }
+        if (listeners.size === 0) {
+            this.listeners.delete(fullEventName);
+        }
+        // 更新统计信息
+        const executionTime = this.config.enablePerformanceMonitoring ? performance.now() - startTime : 0;
+        this.updateStats(fullEventName, executionTime, listeners.size);
+    }
+    /**
+   * 同步发布事件（不等待异步监听器完成）
+   * 
+   * @param event - 事件名称
+   * @param data - 事件数据
+   * @param metadata - 事件元数据（可选）
+   */ emitSync(event, data, metadata) {
+        // 同步执行 emit，但不等待 Promise 完成
+        this.emit(event, data, metadata).catch((error)=>{
+            _utils.logger.error(`同步发布事件 ${event} 失败:`, error);
+        });
+    }
+    /**
+   * 注册事件中间件
+   * 
+   * @param middleware - 中间件函数
+   * @returns 取消注册函数
+   * 
+   * @example
+   * ```typescript
+   * const unsubscribe = eventBus.use((event, data, metadata, next) => {
+   *   console.log('事件触发:', event);
+   *   return next();
+   * });
+   * ```
+   */ use(middleware) {
+        this.middlewares.push(middleware);
+        return ()=>{
+            const index = this.middlewares.indexOf(middleware);
+            if (index > -1) {
+                this.middlewares.splice(index, 1);
+            }
+        };
+    }
+    /**
+   * 清空所有事件监听器
+   */ clear() {
+        this.listeners.clear();
+    }
+    /**
+   * 清空事件历史记录
+   */ clearHistory() {
+        this.eventHistory = [];
+    }
+    /**
+   * 获取事件监听器数量
+   * 
+   * @param event - 事件名称（可选，不提供则返回所有事件的监听器总数）
+   */ listenerCount(event) {
+        if (event) {
+            const fullEventName = this.getFullEventName(event);
+            return this.listeners.get(fullEventName)?.size || 0;
+        }
+        let count = 0;
+        for (const listeners of this.listeners.values()){
+            count += listeners.size;
+        }
+        return count;
+    }
+    /**
+   * 获取所有事件名称
+   */ eventNames() {
+        return Array.from(this.listeners.keys());
+    }
+    /**
+   * 获取事件历史记录
+   * 
+   * @param event - 事件名称（可选，如果提供则只返回该事件的历史）
+   * @param limit - 限制返回的记录数
+   */ getEventHistory(event, limit) {
+        if (!this.config.enableTracking) {
+            return [];
+        }
+        let history = this.eventHistory;
+        if (event) {
+            const fullEventName = this.getFullEventName(event);
+            history = history.filter((h)=>h.event === fullEventName);
+        }
+        if (limit) {
+            history = history.slice(-limit);
+        }
+        return [
+            ...history
+        ];
+    }
+    /**
+   * 获取事件统计信息
+   * 
+   * @param event - 事件名称（可选，不提供则返回所有事件的统计）
+   */ getStats(event) {
+        if (event) {
+            const fullEventName = this.getFullEventName(event);
+            return this.stats.get(fullEventName) || {
+                event: fullEventName,
+                count: 0,
+                avgExecutionTime: 0,
+                listenerCount: 0,
+                lastTriggered: 0
+            };
+        }
+        return new Map(this.stats);
+    }
+    /**
+   * 获取配置
+   */ getConfig() {
+        return {
+            ...this.config
+        };
+    }
+    /**
+   * 更新配置
+   */ updateConfig(config) {
+        this.config = {
+            ...this.config,
+            ...config
+        };
+    }
+    /**
+   * 销毁事件总线（清理所有资源）
+   */ destroy() {
+        this.clear();
+        this.clearHistory();
+        this.middlewares = [];
+        this.stats.clear();
+    }
+    /**
+   * 获取完整事件名称（包含命名空间前缀）
+   */ getFullEventName(event) {
+        if (this.config.namespacePrefix) {
+            return `${this.config.namespacePrefix}${event}`;
+        }
+        return event;
+    }
+    /**
+   * 记录事件历史
+   */ recordEventHistory(event, data, metadata, executionTime) {
+        this.eventHistory.push({
+            event,
+            data,
+            metadata,
+            executionTime
+        });
+        // 限制历史记录大小
+        if (this.eventHistory.length > this.config.maxHistorySize) {
+            this.eventHistory.shift();
+        }
+    }
+    /**
+   * 更新统计信息
+   */ updateStats(event, executionTime, listenerCount = 0) {
+        if (!this.config.enablePerformanceMonitoring) {
+            return;
+        }
+        const existingStats = this.stats.get(event);
+        if (existingStats) {
+            const totalTime = existingStats.avgExecutionTime * existingStats.count + executionTime;
+            const newCount = existingStats.count + 1;
+            this.stats.set(event, {
+                ...existingStats,
+                count: newCount,
+                avgExecutionTime: totalTime / newCount,
+                listenerCount,
+                lastTriggered: Date.now()
+            });
+        } else {
+            this.stats.set(event, {
+                event,
+                count: 1,
+                avgExecutionTime: executionTime,
+                listenerCount,
+                lastTriggered: Date.now()
+            });
+        }
+    }
+    constructor(config = {}){
+        /**
+   * 事件监听器映射表
+   * 使用 Map + Set 结构提高性能
+   */ _define_property(this, "listeners", new Map());
+        /**
+   * 事件历史记录
+   */ _define_property(this, "eventHistory", []);
+        /**
+   * 事件中间件列表
+   */ _define_property(this, "middlewares", []);
+        /**
+   * 事件统计信息
+   */ _define_property(this, "stats", new Map());
+        /**
+   * 配置
+   */ _define_property(this, "config", void 0);
+        /**
+   * 事件计数器（用于生成唯一事件ID）
+   */ _define_property(this, "eventCounter", 0);
+        /**
+   * 监听器ID计数器
+   */ _define_property(this, "listenerIdCounter", 0);
+        this.config = {
+            enableTracking: config.enableTracking ?? process.env.NODE_ENV === 'development',
+            maxHistorySize: config.maxHistorySize ?? 100,
+            enableValidation: config.enableValidation ?? false,
+            validator: config.validator ?? (()=>true),
+            enablePerformanceMonitoring: config.enablePerformanceMonitoring ?? process.env.NODE_ENV === 'development',
+            namespacePrefix: config.namespacePrefix ?? '',
+            instanceId: config.instanceId,
+            enableSecurityMode: config.enableSecurityMode ?? false,
+            allowedSources: config.allowedSources ?? []
+        };
+    }
+};
+
+//# sourceMappingURL=AppEventBus.js.map

package/dist/core/event/AppEventBus.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/event/AppEventBus.ts"],"sourcesContent":["/**\n * 应用级事件总线\n * 提供高性能、类型安全、可观测的事件通信能力\n */\n\nimport { logger } from '../../utils';\nimport type {\n  EventListener,\n  EventMetadata,\n  EventWrapper,\n  EventMiddleware,\n  EventListenerOptions,\n  AppEventBusConfig,\n  EventStats,\n} from './types';\n\n/**\n * 带选项的监听器\n */\ninterface ListenerWithOptions {\n  listener: EventListener;\n  options: Required<EventListenerOptions>;\n  id: symbol;\n}\n\n/**\n * 事件历史记录\n */\ninterface EventHistoryRecord {\n  event: string;\n  data: unknown;\n  metadata: EventMetadata;\n  executionTime?: number;\n}\n\n/**\n * 应用事件总线\n */\nexport class AppEventBus {\n  /**\n   * 事件监听器映射表\n   * 使用 Map + Set 结构提高性能\n   */\n  private listeners: Map<string, Set<ListenerWithOptions>> = new Map();\n  \n  /**\n   * 事件历史记录\n   */\n  private eventHistory: EventHistoryRecord[] = [];\n  \n  /**\n   * 事件中间件列表\n   */\n  private middlewares: EventMiddleware[] = [];\n  \n  /**\n   * 事件统计信息\n   */\n  private stats: Map<string, EventStats> = new Map();\n  \n  /**\n   * 配置\n   */\n  private config: Required<AppEventBusConfig>;\n  \n  /**\n   * 事件计数器（用于生成唯一事件ID）\n   */\n  private eventCounter: number = 0;\n  \n  /**\n   * 监听器ID计数器\n   */\n  private listenerIdCounter: number = 0;\n\n  constructor(config: AppEventBusConfig = {}) {\n    this.config = {\n      enableTracking: config.enableTracking ?? (process.env.NODE_ENV === 'development'),\n      maxHistorySize: config.maxHistorySize ?? 100,\n      enableValidation: config.enableValidation ?? false,\n      validator: config.validator ?? (() => true),\n      enablePerformanceMonitoring: config.enablePerformanceMonitoring ?? (process.env.NODE_ENV === 'development'),\n      namespacePrefix: config.namespacePrefix ?? '',\n      instanceId: config.instanceId,\n      enableSecurityMode: config.enableSecurityMode ?? false,\n      allowedSources: config.allowedSources ?? [],\n    } as Required<AppEventBusConfig>;\n  }\n\n  /**\n   * 订阅事件\n   * \n   * @param event - 事件名称\n   * @param listener - 事件监听器\n   * @param options - 监听器选项\n   * @returns 取消订阅函数\n   * \n   * @example\n   * ```typescript\n   * const unsubscribe = eventBus.on('user:login', (data, metadata) => {\n   *   console.log('用户登录:', data);\n   * });\n   * \n   * // 取消订阅\n   * unsubscribe();\n   * ```\n   */\n  on<T = unknown>(\n    event: string,\n    listener: EventListener<T>,\n    options: EventListenerOptions = {}\n  ): () => void {\n    const fullEventName = this.getFullEventName(event);\n    const listenerId = Symbol(`listener_${++this.listenerIdCounter}`);\n    \n    const listenerWithOptions: ListenerWithOptions = {\n      listener: listener as EventListener,\n      options: {\n        priority: options.priority ?? 100,\n        once: options.once ?? false,\n        namespace: options.namespace ?? this.config.namespacePrefix,\n        async: options.async ?? true,\n      },\n      id: listenerId,\n    };\n\n    if (!this.listeners.has(fullEventName)) {\n      this.listeners.set(fullEventName, new Set());\n    }\n\n    const listeners = this.listeners.get(fullEventName)!;\n    listeners.add(listenerWithOptions);\n\n    // 按优先级排序（数字越小优先级越高）\n    const sortedListeners = Array.from(listeners).sort(\n      (a, b) => a.options.priority - b.options.priority\n    );\n    this.listeners.set(fullEventName, new Set(sortedListeners));\n\n    // 返回取消订阅函数\n    return () => {\n      const currentListeners = this.listeners.get(fullEventName);\n      if (currentListeners) {\n        currentListeners.delete(listenerWithOptions);\n        if (currentListeners.size === 0) {\n          this.listeners.delete(fullEventName);\n        }\n      }\n    };\n  }\n\n  /**\n   * 取消订阅事件\n   * \n   * @param event - 事件名称\n   * @param listener - 事件监听器（可选，不提供则取消该事件的所有监听器）\n   */\n  off<T = unknown>(event: string, listener?: EventListener<T>): void {\n    const fullEventName = this.getFullEventName(event);\n    const listeners = this.listeners.get(fullEventName);\n    \n    if (!listeners) {\n      return;\n    }\n\n    if (listener) {\n      // 移除指定的监听器\n      for (const item of listeners) {\n        if (item.listener === listener) {\n          listeners.delete(item);\n          break;\n        }\n      }\n    } else {\n      // 移除所有监听器\n      listeners.clear();\n    }\n\n    if (listeners.size === 0) {\n      this.listeners.delete(fullEventName);\n    }\n  }\n\n  /**\n   * 一次性订阅事件\n   * \n   * @param event - 事件名称\n   * @param listener - 事件监听器\n   * @param options - 监听器选项\n   */\n  once<T = unknown>(\n    event: string,\n    listener: EventListener<T>,\n    options?: Omit<EventListenerOptions, 'once'>\n  ): () => void {\n    return this.on(event, listener, { ...options, once: true });\n  }\n\n  /**\n   * 发布事件\n   * \n   * @param event - 事件名称\n   * @param data - 事件数据\n   * @param metadata - 事件元数据（可选）\n   * \n   * @example\n   * ```typescript\n   * await eventBus.emit('user:login', {\n   *   userId: '123',\n   *   username: 'john',\n   * });\n   * ```\n   */\n  async emit<T = unknown>(\n    event: string,\n    data?: T,\n    metadata?: Partial<EventMetadata>\n  ): Promise<void> {\n    const fullEventName = this.getFullEventName(event);\n    const startTime = this.config.enablePerformanceMonitoring ? performance.now() : 0;\n\n    // 事件验证\n    if (this.config.enableValidation && !this.config.validator(fullEventName, data)) {\n      logger.warn(`事件 ${fullEventName} 验证失败，已忽略`);\n      return;\n    }\n\n    // 安全检查\n    if (this.config.enableSecurityMode && metadata?.source) {\n      if (!this.config.allowedSources.includes(metadata.source)) {\n        logger.warn(`事件 ${fullEventName} 的来源 ${metadata.source} 不在白名单中，已忽略`);\n        return;\n      }\n    }\n\n    // 构建事件元数据\n    const eventMetadata: EventMetadata = {\n      source: metadata?.source,\n      timestamp: metadata?.timestamp ?? Date.now(),\n      eventId: metadata?.eventId ?? `event_${++this.eventCounter}`,\n      priority: metadata?.priority ?? 0,\n      instanceId: metadata?.instanceId ?? this.config.instanceId,\n      namespace: metadata?.namespace ?? this.config.namespacePrefix,\n      ...metadata,\n    };\n\n    // 创建事件包装器\n    const eventWrapper: EventWrapper<T> = {\n      data: data as T,\n      metadata: eventMetadata,\n    };\n\n    // 执行中间件（中间件可以阻止事件传播）\n    if (this.middlewares.length > 0) {\n      let middlewareIndex = 0;\n      let nextCalled = false;\n      \n      const executeMiddleware = async (): Promise<void> => {\n        if (middlewareIndex < this.middlewares.length) {\n          nextCalled = false;\n          const currentIndex = middlewareIndex;\n          const middleware = this.middlewares[middlewareIndex++];\n          \n          const next = async () => {\n            nextCalled = true;\n            if (currentIndex < this.middlewares.length - 1) {\n              await executeMiddleware();\n            }\n          };\n          \n          await Promise.resolve(middleware(fullEventName, data, eventMetadata, next));\n          \n          // 如果中间件没有调用 next()，阻止事件传播\n          if (!nextCalled) {\n            return;\n          }\n        }\n      };\n      \n      await executeMiddleware();\n      \n      // 如果最后一个中间件没有调用 next()，阻止事件传播\n      if (!nextCalled && this.middlewares.length > 0) {\n        return;\n      }\n    }\n\n    // 获取监听器\n    const listeners = this.listeners.get(fullEventName);\n    \n    // 记录事件历史（无论是否有监听器）\n    if (this.config.enableTracking) {\n      const executionTime = this.config.enablePerformanceMonitoring\n        ? performance.now() - startTime\n        : undefined;\n      this.recordEventHistory(fullEventName, data, eventMetadata, executionTime);\n    }\n    \n    if (!listeners || listeners.size === 0) {\n      // 更新统计（即使没有监听器也记录）\n      this.updateStats(fullEventName, 0);\n      return;\n    }\n\n    // 执行监听器\n    const executionPromises: Promise<void>[] = [];\n    const listenersToRemove: ListenerWithOptions[] = [];\n\n    for (const listenerWithOptions of listeners) {\n      const executeListener = async () => {\n        try {\n          if (listenerWithOptions.options.async) {\n            await Promise.resolve(\n              listenerWithOptions.listener(eventWrapper.data, eventWrapper.metadata)\n            );\n          } else {\n            listenerWithOptions.listener(eventWrapper.data, eventWrapper.metadata);\n          }\n\n          // 如果是一次性监听器，标记为待移除\n          if (listenerWithOptions.options.once) {\n            listenersToRemove.push(listenerWithOptions);\n          }\n        } catch (error) {\n          logger.error(`事件 ${fullEventName} 的监听器执行失败:`, error);\n        }\n      };\n\n      executionPromises.push(executeListener());\n    }\n\n    // 等待所有监听器执行完成\n    await Promise.allSettled(executionPromises);\n\n    // 移除一次性监听器\n    for (const listenerToRemove of listenersToRemove) {\n      listeners.delete(listenerToRemove);\n    }\n\n    if (listeners.size === 0) {\n      this.listeners.delete(fullEventName);\n    }\n\n    // 更新统计信息\n    const executionTime = this.config.enablePerformanceMonitoring\n      ? performance.now() - startTime\n      : 0;\n    this.updateStats(fullEventName, executionTime, listeners.size);\n  }\n\n  /**\n   * 同步发布事件（不等待异步监听器完成）\n   * \n   * @param event - 事件名称\n   * @param data - 事件数据\n   * @param metadata - 事件元数据（可选）\n   */\n  emitSync<T = unknown>(\n    event: string,\n    data?: T,\n    metadata?: Partial<EventMetadata>\n  ): void {\n    // 同步执行 emit，但不等待 Promise 完成\n    this.emit(event, data, metadata).catch((error) => {\n      logger.error(`同步发布事件 ${event} 失败:`, error);\n    });\n  }\n\n  /**\n   * 注册事件中间件\n   * \n   * @param middleware - 中间件函数\n   * @returns 取消注册函数\n   * \n   * @example\n   * ```typescript\n   * const unsubscribe = eventBus.use((event, data, metadata, next) => {\n   *   console.log('事件触发:', event);\n   *   return next();\n   * });\n   * ```\n   */\n  use(middleware: EventMiddleware): () => void {\n    this.middlewares.push(middleware);\n    \n    return () => {\n      const index = this.middlewares.indexOf(middleware);\n      if (index > -1) {\n        this.middlewares.splice(index, 1);\n      }\n    };\n  }\n\n  /**\n   * 清空所有事件监听器\n   */\n  clear(): void {\n    this.listeners.clear();\n  }\n\n  /**\n   * 清空事件历史记录\n   */\n  clearHistory(): void {\n    this.eventHistory = [];\n  }\n\n  /**\n   * 获取事件监听器数量\n   * \n   * @param event - 事件名称（可选，不提供则返回所有事件的监听器总数）\n   */\n  listenerCount(event?: string): number {\n    if (event) {\n      const fullEventName = this.getFullEventName(event);\n      return this.listeners.get(fullEventName)?.size || 0;\n    }\n\n    let count = 0;\n    for (const listeners of this.listeners.values()) {\n      count += listeners.size;\n    }\n    return count;\n  }\n\n  /**\n   * 获取所有事件名称\n   */\n  eventNames(): string[] {\n    return Array.from(this.listeners.keys());\n  }\n\n  /**\n   * 获取事件历史记录\n   * \n   * @param event - 事件名称（可选，如果提供则只返回该事件的历史）\n   * @param limit - 限制返回的记录数\n   */\n  getEventHistory(event?: string, limit?: number): EventHistoryRecord[] {\n    if (!this.config.enableTracking) {\n      return [];\n    }\n\n    let history = this.eventHistory;\n    if (event) {\n      const fullEventName = this.getFullEventName(event);\n      history = history.filter((h) => h.event === fullEventName);\n    }\n\n    if (limit) {\n      history = history.slice(-limit);\n    }\n\n    return [...history];\n  }\n\n  /**\n   * 获取事件统计信息\n   * \n   * @param event - 事件名称（可选，不提供则返回所有事件的统计）\n   */\n  getStats(event?: string): EventStats | Map<string, EventStats> {\n    if (event) {\n      const fullEventName = this.getFullEventName(event);\n      return this.stats.get(fullEventName) || {\n        event: fullEventName,\n        count: 0,\n        avgExecutionTime: 0,\n        listenerCount: 0,\n        lastTriggered: 0,\n      };\n    }\n\n    return new Map(this.stats);\n  }\n\n  /**\n   * 获取配置\n   */\n  getConfig(): AppEventBusConfig {\n    return { ...this.config };\n  }\n\n  /**\n   * 更新配置\n   */\n  updateConfig(config: Partial<AppEventBusConfig>): void {\n    this.config = {\n      ...this.config,\n      ...config,\n    };\n  }\n\n  /**\n   * 销毁事件总线（清理所有资源）\n   */\n  destroy(): void {\n    this.clear();\n    this.clearHistory();\n    this.middlewares = [];\n    this.stats.clear();\n  }\n\n  /**\n   * 获取完整事件名称（包含命名空间前缀）\n   */\n  private getFullEventName(event: string): string {\n    if (this.config.namespacePrefix) {\n      return `${this.config.namespacePrefix}${event}`;\n    }\n    return event;\n  }\n\n  /**\n   * 记录事件历史\n   */\n  private recordEventHistory(\n    event: string,\n    data: unknown,\n    metadata: EventMetadata,\n    executionTime?: number\n  ): void {\n    this.eventHistory.push({\n      event,\n      data,\n      metadata,\n      executionTime,\n    });\n\n    // 限制历史记录大小\n    if (this.eventHistory.length > this.config.maxHistorySize) {\n      this.eventHistory.shift();\n    }\n  }\n\n  /**\n   * 更新统计信息\n   */\n  private updateStats(\n    event: string,\n    executionTime: number,\n    listenerCount: number = 0\n  ): void {\n    if (!this.config.enablePerformanceMonitoring) {\n      return;\n    }\n\n    const existingStats = this.stats.get(event);\n    if (existingStats) {\n      const totalTime = existingStats.avgExecutionTime * existingStats.count + executionTime;\n      const newCount = existingStats.count + 1;\n      \n      this.stats.set(event, {\n        ...existingStats,\n        count: newCount,\n        avgExecutionTime: totalTime / newCount,\n        listenerCount,\n        lastTriggered: Date.now(),\n      });\n    } else {\n      this.stats.set(event, {\n        event,\n        count: 1,\n        avgExecutionTime: executionTime,\n        listenerCount,\n        lastTriggered: Date.now(),\n      });\n    }\n  }\n}\n"],"names":["AppEventBus","on","event","listener","options","fullEventName","getFullEventName","listenerId","Symbol","listenerIdCounter","listenerWithOptions","priority","once","namespace","config","namespacePrefix","async","id","listeners","has","set","Set","get","add","sortedListeners","Array","from","sort","a","b","currentListeners","delete","size","off","item","clear","emit","data","metadata","startTime","enablePerformanceMonitoring","performance","now","enableValidation","validator","logger","warn","enableSecurityMode","source","allowedSources","includes","eventMetadata","timestamp","Date","eventId","eventCounter","instanceId","eventWrapper","middlewares","length","middlewareIndex","nextCalled","executeMiddleware","currentIndex","middleware","next","Promise","resolve","enableTracking","executionTime","undefined","recordEventHistory","updateStats","executionPromises","listenersToRemove","executeListener","push","error","allSettled","listenerToRemove","emitSync","catch","use","index","indexOf","splice","clearHistory","eventHistory","listenerCount","count","values","eventNames","keys","getEventHistory","limit","history","filter","h","slice","getStats","stats","avgExecutionTime","lastTriggered","Map","getConfig","updateConfig","destroy","maxHistorySize","shift","existingStats","totalTime","newCount","process","env","NODE_ENV"],"mappings":"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"}

package/dist/core/event/AppEventBus.d.ts

@@ -0,0 +1,179 @@
+/**
+ * 应用级事件总线
+ * 提供高性能、类型安全、可观测的事件通信能力
+ */
+import type { EventListener, EventMetadata, EventMiddleware, EventListenerOptions, AppEventBusConfig, EventStats } from './types';
+/**
+ * 事件历史记录
+ */
+interface EventHistoryRecord {
+    event: string;
+    data: unknown;
+    metadata: EventMetadata;
+    executionTime?: number;
+}
+/**
+ * 应用事件总线
+ */
+export declare class AppEventBus {
+    /**
+     * 事件监听器映射表
+     * 使用 Map + Set 结构提高性能
+     */
+    private listeners;
+    /**
+     * 事件历史记录
+     */
+    private eventHistory;
+    /**
+     * 事件中间件列表
+     */
+    private middlewares;
+    /**
+     * 事件统计信息
+     */
+    private stats;
+    /**
+     * 配置
+     */
+    private config;
+    /**
+     * 事件计数器（用于生成唯一事件ID）
+     */
+    private eventCounter;
+    /**
+     * 监听器ID计数器
+     */
+    private listenerIdCounter;
+    constructor(config?: AppEventBusConfig);
+    /**
+     * 订阅事件
+     *
+     * @param event - 事件名称
+     * @param listener - 事件监听器
+     * @param options - 监听器选项
+     * @returns 取消订阅函数
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = eventBus.on('user:login', (data, metadata) => {
+     *   console.log('用户登录:', data);
+     * });
+     *
+     * // 取消订阅
+     * unsubscribe();
+     * ```
+     */
+    on<T = unknown>(event: string, listener: EventListener<T>, options?: EventListenerOptions): () => void;
+    /**
+     * 取消订阅事件
+     *
+     * @param event - 事件名称
+     * @param listener - 事件监听器（可选，不提供则取消该事件的所有监听器）
+     */
+    off<T = unknown>(event: string, listener?: EventListener<T>): void;
+    /**
+     * 一次性订阅事件
+     *
+     * @param event - 事件名称
+     * @param listener - 事件监听器
+     * @param options - 监听器选项
+     */
+    once<T = unknown>(event: string, listener: EventListener<T>, options?: Omit<EventListenerOptions, 'once'>): () => void;
+    /**
+     * 发布事件
+     *
+     * @param event - 事件名称
+     * @param data - 事件数据
+     * @param metadata - 事件元数据（可选）
+     *
+     * @example
+     * ```typescript
+     * await eventBus.emit('user:login', {
+     *   userId: '123',
+     *   username: 'john',
+     * });
+     * ```
+     */
+    emit<T = unknown>(event: string, data?: T, metadata?: Partial<EventMetadata>): Promise<void>;
+    /**
+     * 同步发布事件（不等待异步监听器完成）
+     *
+     * @param event - 事件名称
+     * @param data - 事件数据
+     * @param metadata - 事件元数据（可选）
+     */
+    emitSync<T = unknown>(event: string, data?: T, metadata?: Partial<EventMetadata>): void;
+    /**
+     * 注册事件中间件
+     *
+     * @param middleware - 中间件函数
+     * @returns 取消注册函数
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = eventBus.use((event, data, metadata, next) => {
+     *   console.log('事件触发:', event);
+     *   return next();
+     * });
+     * ```
+     */
+    use(middleware: EventMiddleware): () => void;
+    /**
+     * 清空所有事件监听器
+     */
+    clear(): void;
+    /**
+     * 清空事件历史记录
+     */
+    clearHistory(): void;
+    /**
+     * 获取事件监听器数量
+     *
+     * @param event - 事件名称（可选，不提供则返回所有事件的监听器总数）
+     */
+    listenerCount(event?: string): number;
+    /**
+     * 获取所有事件名称
+     */
+    eventNames(): string[];
+    /**
+     * 获取事件历史记录
+     *
+     * @param event - 事件名称（可选，如果提供则只返回该事件的历史）
+     * @param limit - 限制返回的记录数
+     */
+    getEventHistory(event?: string, limit?: number): EventHistoryRecord[];
+    /**
+     * 获取事件统计信息
+     *
+     * @param event - 事件名称（可选，不提供则返回所有事件的统计）
+     */
+    getStats(event?: string): EventStats | Map<string, EventStats>;
+    /**
+     * 获取配置
+     */
+    getConfig(): AppEventBusConfig;
+    /**
+     * 更新配置
+     */
+    updateConfig(config: Partial<AppEventBusConfig>): void;
+    /**
+     * 销毁事件总线（清理所有资源）
+     */
+    destroy(): void;
+    /**
+     * 获取完整事件名称（包含命名空间前缀）
+     */
+    private getFullEventName;
+    /**
+     * 记录事件历史
+     */
+    private recordEventHistory;
+    /**
+     * 更新统计信息
+     */
+    private updateStats;
+}
+export {};
+//# sourceMappingURL=AppEventBus.d.ts.map

package/dist/core/event/AppEventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppEventBus.d.ts","sourceRoot":"","sources":["../../../src/core/event/AppEventBus.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EAEb,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,EACX,MAAM,SAAS,CAAC;AAWjB;;GAEG;AACH,UAAU,kBAAkB;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,aAAa,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB;;;OAGG;IACH,OAAO,CAAC,SAAS,CAAoD;IAErE;;OAEG;IACH,OAAO,CAAC,YAAY,CAA4B;IAEhD;;OAEG;IACH,OAAO,CAAC,WAAW,CAAyB;IAE5C;;OAEG;IACH,OAAO,CAAC,KAAK,CAAsC;IAEnD;;OAEG;IACH,OAAO,CAAC,MAAM,CAA8B;IAE5C;;OAEG;IACH,OAAO,CAAC,YAAY,CAAa;IAEjC;;OAEG;IACH,OAAO,CAAC,iBAAiB,CAAa;gBAE1B,MAAM,GAAE,iBAAsB;IAc1C;;;;;;;;;;;;;;;;;OAiBG;IACH,EAAE,CAAC,CAAC,GAAG,OAAO,EACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,OAAO,GAAE,oBAAyB,GACjC,MAAM,IAAI;IAwCb;;;;;OAKG;IACH,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;IA0BlE;;;;;;OAMG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,GAC3C,MAAM,IAAI;IAIb;;;;;;;;;;;;;;OAcG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,CAAC,EACR,QAAQ,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC;IAqIhB;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,GAAG,OAAO,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,CAAC,EACR,QAAQ,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAChC,IAAI;IAOP;;;;;;;;;;;;;OAaG;IACH,GAAG,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,IAAI;IAW5C;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;;;OAIG;IACH,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAarC;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;;;;OAKG;IACH,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAkBrE;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC;IAe9D;;OAEG;IACH,SAAS,IAAI,iBAAiB;IAI9B;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI;IAOtD;;OAEG;IACH,OAAO,IAAI,IAAI;IAOf;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACH,OAAO,CAAC,WAAW;CA+BpB"}