@vlian/framework 1.2.61 → 1.2.63

package/dist/core/error/ErrorHandler.d.ts

@@ -1,171 +0,0 @@
-/**
- * 统一错误处理器
- *
- * 优化：
- * 1. 统一错误处理策略：记录、上报、恢复、降级
- * 2. 错误分类：致命、可恢复、警告
- * 3. 错误恢复机制：自动重试、降级方案
- */
-import { ErrorSeverity, ErrorType, FrameworkError } from '@vlian/utils';
-import type { MonitoringService } from '@vlian/monitoring';
-/**
- * 错误处理策略
- */
-export declare enum ErrorHandlingStrategy {
-    /**
-     * 记录错误（日志）
-     */
-    LOG = "LOG",
-    /**
-     * 上报错误（监控服务）
-     */
-    REPORT = "REPORT",
-    /**
-     * 尝试恢复错误
-     */
-    RECOVER = "RECOVER",
-    /**
-     * 降级处理
-     */
-    FALLBACK = "FALLBACK",
-    /**
-     * 忽略错误
-     */
-    IGNORE = "IGNORE"
-}
-/**
- * 错误恢复选项
- */
-export interface ErrorRecoveryOptions {
-    /**
-     * 最大重试次数
-     * @default 3
-     */
-    maxRetries?: number;
-    /**
-     * 重试延迟（毫秒）
-     * @default 1000
-     */
-    retryDelay?: number;
-    /**
-     * 是否启用指数退避
-     * @default true
-     */
-    exponentialBackoff?: boolean;
-    /**
-     * 重试条件函数
-     */
-    shouldRetry?: (error: unknown, attempt: number) => boolean;
-    /**
-     * 降级方案函数
-     */
-    fallback?: () => Promise<unknown> | unknown;
-}
-/**
- * 错误处理配置
- */
-export interface ErrorHandlerConfig {
-    /**
-     * 监控服务实例（可选）
-     */
-    monitoring?: MonitoringService;
-    /**
-     * 默认错误处理策略
-     * @default [ErrorHandlingStrategy.LOG, ErrorHandlingStrategy.REPORT]
-     */
-    defaultStrategies?: ErrorHandlingStrategy[];
-    /**
-     * 错误严重程度对应的处理策略
-     */
-    severityStrategies?: Partial<Record<ErrorSeverity, ErrorHandlingStrategy[]>>;
-    /**
-     * 错误类型对应的处理策略
-     */
-    typeStrategies?: Partial<Record<ErrorType, ErrorHandlingStrategy[]>>;
-    /**
-     * 错误恢复选项
-     */
-    recoveryOptions?: ErrorRecoveryOptions;
-    /**
-     * 是否在开发环境显示详细错误信息
-     * @default true
-     */
-    showDetailedErrorsInDev?: boolean;
-}
-/**
- * 错误处理结果
- */
-export interface ErrorHandleResult {
-    /**
-     * 是否已处理
-     */
-    handled: boolean;
-    /**
-     * 是否可恢复
-     */
-    recoverable: boolean;
-    /**
-     * 恢复后的结果（如果已恢复）
-     */
-    recoveredValue?: unknown;
-    /**
-     * 使用的处理策略
-     */
-    strategies: ErrorHandlingStrategy[];
-    /**
-     * 错误信息
-     */
-    error: FrameworkError;
-}
-/**
- * 统一错误处理器
- */
-export declare class ErrorHandler {
-    private config;
-    private monitoring?;
-    constructor(config?: ErrorHandlerConfig);
-    /**
-     * 设置监控服务
-     */
-    setMonitoring(monitoring: MonitoringService): void;
-    /**
-     * 处理错误
-     *
-     * @param error - 错误对象
-     * @param context - 错误上下文
-     * @returns 错误处理结果
-     */
-    handleError(error: unknown, context?: Record<string, unknown>): Promise<ErrorHandleResult>;
-    /**
-     * 确定错误处理策略
-     */
-    private determineStrategies;
-    /**
-     * 执行处理策略
-     */
-    private executeStrategies;
-    /**
-     * 记录错误
-     */
-    private logError;
-    /**
-     * 上报错误
-     */
-    private reportError;
-    /**
-     * 尝试恢复错误
-     */
-    private attemptRecovery;
-    /**
-     * 创建错误处理器的便捷方法
-     */
-    static create(config?: ErrorHandlerConfig): ErrorHandler;
-}
-/**
- * 获取默认错误处理器
- */
-export declare function getDefaultErrorHandler(): ErrorHandler;
-/**
- * 设置默认错误处理器
- */
-export declare function setDefaultErrorHandler(handler: ErrorHandler): void;

package/dist/core/error/ErrorHandler.js

@@ -1 +0,0 @@
-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{logger}from"@vlian/logger";import{errorUtils,ErrorSeverity,FrameworkError}from"@vlian/utils";export var ErrorHandlingStrategy=/*#__PURE__*/function(ErrorHandlingStrategy){ErrorHandlingStrategy["LOG"]="LOG";ErrorHandlingStrategy["REPORT"]="REPORT";ErrorHandlingStrategy["RECOVER"]="RECOVER";ErrorHandlingStrategy["FALLBACK"]="FALLBACK";ErrorHandlingStrategy["IGNORE"]="IGNORE";return ErrorHandlingStrategy}({});export class ErrorHandler{setMonitoring(monitoring){this.monitoring=monitoring}async handleError(error,context){const normalizedError=errorUtils.normalizeError(error);const errorWithContext=context?new FrameworkError(normalizedError.message,normalizedError.type,normalizedError.severity,{code:normalizedError.code,originalError:normalizedError.originalError,context:{...normalizedError.context,...context},recoverable:normalizedError.recoverable}):normalizedError;const strategies=this.determineStrategies(errorWithContext);const handled=await this.executeStrategies(errorWithContext,strategies);let recoveredValue;let recoverable=false;if(handled&&errorWithContext.recoverable&&this.config.recoveryOptions){const recoveryResult=await this.attemptRecovery(errorWithContext);recoverable=recoveryResult.recoverable;recoveredValue=recoveryResult.value}return{handled,recoverable,recoveredValue,strategies,error:errorWithContext}}determineStrategies(error){if(this.config.typeStrategies[error.type]){return this.config.typeStrategies[error.type]}if(this.config.severityStrategies[error.severity]){return this.config.severityStrategies[error.severity]}return this.config.defaultStrategies}async executeStrategies(error,strategies){let handled=false;for(const strategy of strategies){try{switch(strategy){case"LOG":this.logError(error);handled=true;break;case"REPORT":await this.reportError(error);handled=true;break;case"RECOVER":handled=true;break;case"FALLBACK":handled=true;break;case"IGNORE":handled=true;break}}catch(strategyError){logger.warn(`错误处理策略 ${strategy} 执行失败:`,strategyError)}}return handled}logError(error){const errorInfo=errorUtils.extractErrorInfo(error);switch(error.severity){case ErrorSeverity.CRITICAL:case ErrorSeverity.HIGH:logger.error("错误:",errorInfo);break;case ErrorSeverity.MEDIUM:logger.warn("警告:",errorInfo);break;case ErrorSeverity.LOW:logger.info("信息:",errorInfo);break}if(this.config.showDetailedErrorsInDev&&process.env.NODE_ENV==="development"){const detailedError=errorUtils.formatErrorForDev(error);console.error(detailedError)}}async reportError(error){if(!this.monitoring){logger.debug("监控服务未配置，跳过错误上报");return}try{this.monitoring.captureError(error,{severity:error.severity,type:error.type,code:error.code,context:error.context})}catch(reportError){logger.warn("错误上报失败:",reportError)}}async attemptRecovery(error){const options=this.config.recoveryOptions;if(!options){return{recoverable:false}}const maxRetries=options.maxRetries??3;const retryDelay=options.retryDelay??1e3;const exponentialBackoff=options.exponentialBackoff??true;const shouldRetry=options.shouldRetry??(()=>true);if(options.fallback){try{const fallbackValue=await Promise.resolve(options.fallback());logger.info("错误已通过降级方案恢复");return{recoverable:true,value:fallbackValue}}catch(fallbackError){logger.warn("降级方案执行失败:",fallbackError)}}if(error.recoverable&&shouldRetry(error,0)){for(let attempt=0;attempt<maxRetries;attempt++){if(!shouldRetry(error,attempt)){break}const delay=exponentialBackoff?retryDelay*Math.pow(2,attempt):retryDelay;logger.debug(`错误恢复重试 ${attempt+1}/${maxRetries}，${delay}ms 后重试...`);await new Promise(resolve=>setTimeout(resolve,delay))}}return{recoverable:error.recoverable}}static create(config){return new ErrorHandler(config)}constructor(config={}){_define_property(this,"config",void 0);_define_property(this,"monitoring",void 0);this.monitoring=config.monitoring;this.config={defaultStrategies:config.defaultStrategies??["LOG","REPORT"],severityStrategies:config.severityStrategies??{},typeStrategies:config.typeStrategies??{},recoveryOptions:config.recoveryOptions??{},showDetailedErrorsInDev:config.showDetailedErrorsInDev??true}}}let defaultErrorHandler=null;export function getDefaultErrorHandler(){if(!defaultErrorHandler){defaultErrorHandler=new ErrorHandler}return defaultErrorHandler}export function setDefaultErrorHandler(handler){defaultErrorHandler=handler}

package/dist/core/error/index.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});function _export(target,all){for(var name in all)Object.defineProperty(target,name,{enumerable:true,get:Object.getOwnPropertyDescriptor(all,name).get})}_export(exports,{get ErrorBoundary(){return _ErrorBoundary.ErrorBoundary},get ErrorHandler(){return _ErrorHandler.ErrorHandler},get getDefaultErrorHandler(){return _ErrorHandler.getDefaultErrorHandler},get setDefaultErrorHandler(){return _ErrorHandler.setDefaultErrorHandler},get useErrorHandler(){return _ErrorBoundary.useErrorHandler},get withErrorBoundary(){return _ErrorBoundary.withErrorBoundary}});const _ErrorBoundary=require("./ErrorBoundary");const _ErrorHandler=require("./ErrorHandler");

package/dist/core/error/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * 错误处理模块统一导出
- */
-export { ErrorBoundary, withErrorBoundary, useErrorHandler } from './ErrorBoundary';
-export type { ErrorBoundaryProps } from './ErrorBoundary';
-export { ErrorHandler, getDefaultErrorHandler, setDefaultErrorHandler } from './ErrorHandler';
-export type { ErrorHandlingStrategy, ErrorHandlerConfig, ErrorHandleResult, ErrorRecoveryOptions, } from './ErrorHandler';

package/dist/core/error/index.js

@@ -1 +0,0 @@
-export{ErrorBoundary,withErrorBoundary,useErrorHandler}from"./ErrorBoundary";export{ErrorHandler,getDefaultErrorHandler,setDefaultErrorHandler}from"./ErrorHandler";

package/dist/core/event/AppEventBus.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"AppEventBus",{enumerable:true,get:function(){return AppEventBus}});const _logger=require("@vlian/logger");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{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)}}}}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)}}once(event,listener,options){return this.on(event,listener,{...options,once:true})}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)){_logger.logger.warn(`事件 ${fullEventName} 验证失败，已忽略`);return}if(this.config.enableSecurityMode&&metadata?.source){if(!this.config.allowedSources.includes(metadata.source)){_logger.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));if(!nextCalled){return}}};await executeMiddleware();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){_logger.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)}emitSync(event,data,metadata){this.emit(event,data,metadata).catch(error=>{_logger.logger.error(`同步发布事件 ${event} 失败:`,error)})}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=[]}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())}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]}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={}){_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);_define_property(this,"eventCounter",0);_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??[]}}};

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

@@ -1,178 +0,0 @@
-/**
- * 应用级事件总线
- * 提供高性能、类型安全、可观测的事件通信能力
- */
-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 {};

package/dist/core/event/AppEventBus.js

@@ -1 +0,0 @@
-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{logger}from"@vlian/logger";export class AppEventBus{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)}}}}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)}}once(event,listener,options){return this.on(event,listener,{...options,once:true})}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)){logger.warn(`事件 ${fullEventName} 验证失败，已忽略`);return}if(this.config.enableSecurityMode&&metadata?.source){if(!this.config.allowedSources.includes(metadata.source)){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));if(!nextCalled){return}}};await executeMiddleware();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){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)}emitSync(event,data,metadata){this.emit(event,data,metadata).catch(error=>{logger.error(`同步发布事件 ${event} 失败:`,error)})}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=[]}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())}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]}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={}){_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);_define_property(this,"eventCounter",0);_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??[]}}}

package/dist/core/event/frameworkEvents.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"FrameworkEventManager",{enumerable:true,get:function(){return FrameworkEventManager}});const _types=require("./types");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 FrameworkEventManager=class FrameworkEventManager{emitAppStart(instanceId){this.eventBus.emitSync(_types.FrameworkEventType.APP_START,{instanceId})}emitAppStarted(instanceId,duration){this.eventBus.emitSync(_types.FrameworkEventType.APP_STARTED,{instanceId,duration})}emitAppInitStart(instanceId){this.eventBus.emitSync(_types.FrameworkEventType.APP_INIT_START,{instanceId})}emitAppInitComplete(instanceId,context,duration){this.eventBus.emitSync(_types.FrameworkEventType.APP_INIT_COMPLETE,{instanceId,context,duration})}emitAppInitError(instanceId,error){this.eventBus.emitSync(_types.FrameworkEventType.APP_INIT_ERROR,{instanceId,error})}emitAppRenderStart(instanceId){this.eventBus.emitSync(_types.FrameworkEventType.APP_RENDER_START,{instanceId})}emitAppRenderComplete(instanceId,duration){this.eventBus.emitSync(_types.FrameworkEventType.APP_RENDER_COMPLETE,{instanceId,duration})}emitRouteChange(from,to,params){this.eventBus.emitSync(_types.FrameworkEventType.ROUTE_CHANGE,{from,to,params})}emitRouteNavigateStart(to,options){this.eventBus.emitSync(_types.FrameworkEventType.ROUTE_NAVIGATE_START,{to,options})}emitRouteNavigateComplete(to,duration){this.eventBus.emitSync(_types.FrameworkEventType.ROUTE_NAVIGATE_COMPLETE,{to,duration})}emitErrorOccurred(error,context){this.eventBus.emitSync(_types.FrameworkEventType.ERROR_OCCURRED,{error,context})}emitInstanceCreated(instanceId){this.eventBus.emitSync(_types.FrameworkEventType.INSTANCE_CREATED,{instanceId})}emitInstanceDestroyed(instanceId){this.eventBus.emitSync(_types.FrameworkEventType.INSTANCE_DESTROYED,{instanceId})}emitPerformanceUpdate(metrics){this.eventBus.emitSync(_types.FrameworkEventType.PERFORMANCE_UPDATE,{metrics})}constructor(eventBus){_define_property(this,"eventBus",void 0);this.eventBus=eventBus}};

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

@@ -1,69 +0,0 @@
-/**
- * 框架生命周期事件集成
- * 自动在框架关键节点触发事件
- */
-import type { AppEventBus } from './AppEventBus';
-import type { InitializationContext } from '../initialization';
-/**
- * 框架事件管理器
- */
-export declare class FrameworkEventManager {
-    private eventBus;
-    constructor(eventBus: AppEventBus);
-    /**
-     * 触发应用启动事件
-     */
-    emitAppStart(instanceId?: string): void;
-    /**
-     * 触发应用启动完成事件
-     */
-    emitAppStarted(instanceId: string, duration: number): void;
-    /**
-     * 触发应用初始化开始事件
-     */
-    emitAppInitStart(instanceId?: string): void;
-    /**
-     * 触发应用初始化完成事件
-     */
-    emitAppInitComplete(instanceId: string, context: InitializationContext, duration: number): void;
-    /**
-     * 触发应用初始化错误事件
-     */
-    emitAppInitError(instanceId: string, error: Error): void;
-    /**
-     * 触发应用渲染开始事件
-     */
-    emitAppRenderStart(instanceId?: string): void;
-    /**
-     * 触发应用渲染完成事件
-     */
-    emitAppRenderComplete(instanceId: string, duration: number): void;
-    /**
-     * 触发路由变化事件
-     */
-    emitRouteChange(from: string, to: string, params?: Record<string, unknown>): void;
-    /**
-     * 触发路由导航开始事件
-     */
-    emitRouteNavigateStart(to: string, options?: unknown): void;
-    /**
-     * 触发路由导航完成事件
-     */
-    emitRouteNavigateComplete(to: string, duration: number): void;
-    /**
-     * 触发错误发生事件
-     */
-    emitErrorOccurred(error: Error, context?: unknown): void;
-    /**
-     * 触发实例创建事件
-     */
-    emitInstanceCreated(instanceId: string): void;
-    /**
-     * 触发实例销毁事件
-     */
-    emitInstanceDestroyed(instanceId: string): void;
-    /**
-     * 触发性能指标更新事件
-     */
-    emitPerformanceUpdate(metrics: Record<string, number>): void;
-}

package/dist/core/event/frameworkEvents.js

@@ -1 +0,0 @@
-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{FrameworkEventType}from"./types";export class FrameworkEventManager{emitAppStart(instanceId){this.eventBus.emitSync(FrameworkEventType.APP_START,{instanceId})}emitAppStarted(instanceId,duration){this.eventBus.emitSync(FrameworkEventType.APP_STARTED,{instanceId,duration})}emitAppInitStart(instanceId){this.eventBus.emitSync(FrameworkEventType.APP_INIT_START,{instanceId})}emitAppInitComplete(instanceId,context,duration){this.eventBus.emitSync(FrameworkEventType.APP_INIT_COMPLETE,{instanceId,context,duration})}emitAppInitError(instanceId,error){this.eventBus.emitSync(FrameworkEventType.APP_INIT_ERROR,{instanceId,error})}emitAppRenderStart(instanceId){this.eventBus.emitSync(FrameworkEventType.APP_RENDER_START,{instanceId})}emitAppRenderComplete(instanceId,duration){this.eventBus.emitSync(FrameworkEventType.APP_RENDER_COMPLETE,{instanceId,duration})}emitRouteChange(from,to,params){this.eventBus.emitSync(FrameworkEventType.ROUTE_CHANGE,{from,to,params})}emitRouteNavigateStart(to,options){this.eventBus.emitSync(FrameworkEventType.ROUTE_NAVIGATE_START,{to,options})}emitRouteNavigateComplete(to,duration){this.eventBus.emitSync(FrameworkEventType.ROUTE_NAVIGATE_COMPLETE,{to,duration})}emitErrorOccurred(error,context){this.eventBus.emitSync(FrameworkEventType.ERROR_OCCURRED,{error,context})}emitInstanceCreated(instanceId){this.eventBus.emitSync(FrameworkEventType.INSTANCE_CREATED,{instanceId})}emitInstanceDestroyed(instanceId){this.eventBus.emitSync(FrameworkEventType.INSTANCE_DESTROYED,{instanceId})}emitPerformanceUpdate(metrics){this.eventBus.emitSync(FrameworkEventType.PERFORMANCE_UPDATE,{metrics})}constructor(eventBus){_define_property(this,"eventBus",void 0);this.eventBus=eventBus}}

package/dist/core/event/hooks.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});function _export(target,all){for(var name in all)Object.defineProperty(target,name,{enumerable:true,get:Object.getOwnPropertyDescriptor(all,name).get})}_export(exports,{get useAppEvent(){return useAppEvent},get useAppEventEmitter(){return useAppEventEmitter},get useAppEventOnce(){return useAppEventOnce}});const _react=require("react");function useAppEvent(eventBus,event,listener,options){const listenerRef=(0,_react.useRef)(listener);listenerRef.current=listener;const optionsRef=(0,_react.useRef)(options);optionsRef.current=options;(0,_react.useEffect)(()=>{const wrappedListener=(data,metadata)=>{return listenerRef.current(data,metadata)};const unsubscribe=eventBus.on(event,wrappedListener,optionsRef.current);return unsubscribe},[eventBus,event])}function useAppEventOnce(eventBus,event,listener,options){const listenerRef=(0,_react.useRef)(listener);listenerRef.current=listener;const optionsRef=(0,_react.useRef)(options);optionsRef.current=options;(0,_react.useEffect)(()=>{const wrappedListener=(data,metadata)=>{return listenerRef.current(data,metadata)};const unsubscribe=eventBus.once(event,wrappedListener,optionsRef.current);return unsubscribe},[eventBus,event])}function useAppEventEmitter(eventBus){return(0,_react.useCallback)((event,data,metadata)=>{return eventBus.emit(event,data,metadata)},[eventBus])}

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

@@ -1,57 +0,0 @@
-/**
- * React Hooks 支持
- * 提供便捷的 React 组件事件订阅能力
- */
-import type { EventListener, EventListenerOptions } from './types';
-import type { AppEventBus } from './AppEventBus';
-/**
- * 使用事件总线的 Hook
- *
- * @param eventBus - 事件总线实例
- * @param event - 事件名称
- * @param listener - 事件监听器
- * @param options - 监听器选项
- *
- * @example
- * ```tsx
- * import { useAppEventBus } from '@vlian/framework';
- *
- * function MyComponent() {
- *   useAppEvent('user:login', (data, metadata) => {
- *     console.log('用户登录:', data);
- *   });
- *
- *   return <div>My Component</div>;
- * }
- * ```
- */
-export declare function useAppEvent<T = unknown>(eventBus: AppEventBus, event: string, listener: EventListener<T>, options?: EventListenerOptions): void;
-/**
- * 一次性事件订阅 Hook
- *
- * @param eventBus - 事件总线实例
- * @param event - 事件名称
- * @param listener - 事件监听器
- * @param options - 监听器选项
- */
-export declare function useAppEventOnce<T = unknown>(eventBus: AppEventBus, event: string, listener: EventListener<T>, options?: Omit<EventListenerOptions, 'once'>): void;
-/**
- * 创建事件发射器 Hook
- *
- * @param eventBus - 事件总线实例
- * @returns 事件发射函数
- *
- * @example
- * ```tsx
- * function MyComponent() {
- *   const emit = useAppEventEmitter(eventBus);
- *
- *   const handleClick = () => {
- *     emit('button:click', { buttonId: 'submit' });
- *   };
- *
- *   return <button onClick={handleClick}>Click</button>;
- * }
- * ```
- */
-export declare function useAppEventEmitter(eventBus: AppEventBus): <T = unknown>(event: string, data?: T, metadata?: Partial<import("./types").EventMetadata>) => Promise<void>;

package/dist/core/event/hooks.js

@@ -1 +0,0 @@
-import{useEffect,useRef,useCallback}from"react";export function useAppEvent(eventBus,event,listener,options){const listenerRef=useRef(listener);listenerRef.current=listener;const optionsRef=useRef(options);optionsRef.current=options;useEffect(()=>{const wrappedListener=(data,metadata)=>{return listenerRef.current(data,metadata)};const unsubscribe=eventBus.on(event,wrappedListener,optionsRef.current);return unsubscribe},[eventBus,event])}export function useAppEventOnce(eventBus,event,listener,options){const listenerRef=useRef(listener);listenerRef.current=listener;const optionsRef=useRef(options);optionsRef.current=options;useEffect(()=>{const wrappedListener=(data,metadata)=>{return listenerRef.current(data,metadata)};const unsubscribe=eventBus.once(event,wrappedListener,optionsRef.current);return unsubscribe},[eventBus,event])}export function useAppEventEmitter(eventBus){return useCallback((event,data,metadata)=>{return eventBus.emit(event,data,metadata)},[eventBus])}

package/dist/core/event/index.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});function _export(target,all){for(var name in all)Object.defineProperty(target,name,{enumerable:true,get:Object.getOwnPropertyDescriptor(all,name).get})}_export(exports,{get AppEventBus(){return _AppEventBus.AppEventBus},get FrameworkEventManager(){return _frameworkEvents.FrameworkEventManager},get FrameworkEventType(){return _types.FrameworkEventType},get useAppEvent(){return _hooks.useAppEvent},get useAppEventEmitter(){return _hooks.useAppEventEmitter},get useAppEventOnce(){return _hooks.useAppEventOnce},get useEventBus(){return _useEventBus.useEventBus}});const _AppEventBus=require("./AppEventBus");const _frameworkEvents=require("./frameworkEvents");const _hooks=require("./hooks");const _useEventBus=require("./useEventBus");const _types=require("./types");

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

@@ -1,10 +0,0 @@
-/**
- * 应用级事件系统
- * 提供高性能、类型安全、可观测的事件通信能力
- */
-export { AppEventBus } from './AppEventBus';
-export { FrameworkEventManager } from './frameworkEvents';
-export { useAppEvent, useAppEventOnce, useAppEventEmitter, } from './hooks';
-export { useEventBus } from './useEventBus';
-export type { EventListener, EventMetadata, EventWrapper, EventMiddleware, EventListenerOptions, AppEventBusConfig, EventStats, FrameworkEventData, } from './types';
-export { FrameworkEventType } from './types';

package/dist/core/event/index.js

@@ -1 +0,0 @@
-export{AppEventBus}from"./AppEventBus";export{FrameworkEventManager}from"./frameworkEvents";export{useAppEvent,useAppEventOnce,useAppEventEmitter}from"./hooks";export{useEventBus}from"./useEventBus";export{FrameworkEventType}from"./types";

package/dist/core/event/types.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"FrameworkEventType",{enumerable:true,get:function(){return FrameworkEventType}});var FrameworkEventType=/*#__PURE__*/function(FrameworkEventType){FrameworkEventType["APP_START"]="framework:app:start";FrameworkEventType["APP_STARTED"]="framework:app:started";FrameworkEventType["APP_INIT_START"]="framework:app:init:start";FrameworkEventType["APP_INIT_COMPLETE"]="framework:app:init:complete";FrameworkEventType["APP_INIT_ERROR"]="framework:app:init:error";FrameworkEventType["APP_RENDER_START"]="framework:app:render:start";FrameworkEventType["APP_RENDER_COMPLETE"]="framework:app:render:complete";FrameworkEventType["ROUTE_CHANGE"]="framework:route:change";FrameworkEventType["ROUTE_NAVIGATE_START"]="framework:route:navigate:start";FrameworkEventType["ROUTE_NAVIGATE_COMPLETE"]="framework:route:navigate:complete";FrameworkEventType["ERROR_OCCURRED"]="framework:error:occurred";FrameworkEventType["INSTANCE_CREATED"]="framework:instance:created";FrameworkEventType["INSTANCE_DESTROYED"]="framework:instance:destroyed";FrameworkEventType["PERFORMANCE_UPDATE"]="framework:performance:update";return FrameworkEventType}({});