@vlian/framework 1.2.62 → 2.0.1

package/dist/core/router/plugin/RouterPluginManager.d.ts

@@ -1,74 +0,0 @@
-/**
- * 路由插件管理器
- * 负责插件的注册、执行和生命周期管理
- */
-import type { RouterPlugin, PluginContext, PluginRegisterOptions } from './types';
-import { PluginLifecycleStage } from './types';
-/**
- * 路由插件管理器
- */
-export declare class RouterPluginManager {
-    private plugins;
-    /**
-     * 注册插件
-     *
-     * @param plugin - 插件实例
-     * @param options - 注册选项
-     * @returns 取消注册函数
-     */
-    register(plugin: RouterPlugin, options?: PluginRegisterOptions): () => void;
-    /**
-     * 批量注册插件
-     *
-     * @param plugins - 插件数组
-     * @param options - 注册选项
-     */
-    registerBatch(plugins: RouterPlugin[], options?: PluginRegisterOptions): void;
-    /**
-     * 按依赖关系排序插件（拓扑排序）
-     */
-    private sortByDependencies;
-    /**
-     * 取消注册插件
-     *
-     * @param name - 插件名称
-     */
-    unregister(name: string): void;
-    /**
-     * 执行插件钩子
-     *
-     * @param stage - 生命周期阶段
-     * @param context - 插件上下文
-     */
-    executeHooks(stage: PluginLifecycleStage, context: PluginContext): Promise<void>;
-    /**
-     * 获取插件
-     *
-     * @param name - 插件名称
-     * @returns 插件实例，如果不存在返回 undefined
-     */
-    getPlugin(name: string): RouterPlugin | undefined;
-    /**
-     * 获取所有插件
-     *
-     * @returns 插件数组
-     */
-    getAllPlugins(): RouterPlugin[];
-    /**
-     * 获取启用的插件
-     *
-     * @returns 启用的插件数组
-     */
-    getEnabledPlugins(): RouterPlugin[];
-    /**
-     * 清空所有插件
-     */
-    clear(): void;
-    /**
-     * 获取插件数量
-     *
-     * @returns 插件数量
-     */
-    getCount(): number;
-}
-export declare function getRouterPluginManager(): RouterPluginManager;

package/dist/core/router/plugin/RouterPluginManager.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{PluginLifecycleStage}from"./types";export class RouterPluginManager{register(plugin,options={}){if(!plugin.name){throw new Error("插件必须提供名称")}if(this.plugins.has(plugin.name)&&!options.overwrite){throw new Error(`插件 "${plugin.name}" 已存在`)}const pluginWithDefaults={priority:100,enabled:true,...plugin};if(pluginWithDefaults.dependencies){const missingDeps=pluginWithDefaults.dependencies.filter(dep=>!this.plugins.has(dep));if(missingDeps.length>0){throw new Error(`插件 "${plugin.name}" 缺少依赖: ${missingDeps.join(", ")}`)}}this.plugins.set(plugin.name,{plugin:pluginWithDefaults,status:"registered",registeredAt:Date.now()});logger.debug(`路由插件已注册: ${plugin.name}`);if(pluginWithDefaults.hooks?.onRegister){try{const context={config:{},meta:{stage:PluginLifecycleStage.REGISTER}};pluginWithDefaults.hooks.onRegister(context)}catch(error){logger.error(`插件注册钩子执行失败: ${plugin.name}`,error)}}return()=>{this.unregister(plugin.name)}}registerBatch(plugins,options={}){const sortedPlugins=this.sortByDependencies(plugins);sortedPlugins.forEach(plugin=>{this.register(plugin,options)})}sortByDependencies(plugins){const sorted=[];const visited=new Set;const visiting=new Set;const visit=plugin=>{if(visiting.has(plugin.name||"")){throw new Error(`检测到循环依赖: ${plugin.name}`)}if(visited.has(plugin.name||"")){return}visiting.add(plugin.name||"");if(plugin.dependencies){plugin.dependencies.forEach(depName=>{const dep=plugins.find(p=>p.name===depName);if(dep){visit(dep)}})}visiting.delete(plugin.name||"");visited.add(plugin.name||"");sorted.push(plugin)};plugins.forEach(plugin=>{if(!visited.has(plugin.name||"")){visit(plugin)}});return sorted}unregister(name){const registration=this.plugins.get(name);if(!registration){return}if(registration.plugin.hooks?.onDestroy){try{const context={config:{},meta:{stage:PluginLifecycleStage.DESTROY}};registration.plugin.hooks.onDestroy(context)}catch(error){logger.error(`插件销毁钩子执行失败: ${name}`,error)}}this.plugins.delete(name);logger.debug(`路由插件已取消注册: ${name}`)}async executeHooks(stage,context){const enabledPlugins=Array.from(this.plugins.values()).filter(reg=>reg.plugin.enabled!==false).sort((a,b)=>(a.plugin.priority||100)-(b.plugin.priority||100));const hookMap={[PluginLifecycleStage.REGISTER]:"onRegister",[PluginLifecycleStage.BEFORE_INIT]:"onBeforeInit",[PluginLifecycleStage.AFTER_INIT]:"onAfterInit",[PluginLifecycleStage.BEFORE_TRANSFORM]:"onBeforeTransform",[PluginLifecycleStage.AFTER_TRANSFORM]:"onAfterTransform",[PluginLifecycleStage.BEFORE_MATCH]:"onBeforeMatch",[PluginLifecycleStage.AFTER_MATCH]:"onAfterMatch",[PluginLifecycleStage.DESTROY]:"onDestroy"};const hookName=hookMap[stage];if(!hookName){return}for(const registration of enabledPlugins){const hook=registration.plugin.hooks?.[hookName];if(hook){try{await hook(context)}catch(error){logger.error(`插件钩子执行失败: ${registration.plugin.name}.${hookName}`,error)}}}}getPlugin(name){return this.plugins.get(name)?.plugin}getAllPlugins(){return Array.from(this.plugins.values()).map(reg=>reg.plugin)}getEnabledPlugins(){return Array.from(this.plugins.values()).filter(reg=>reg.plugin.enabled!==false).map(reg=>reg.plugin)}clear(){for(const[name,registration]of this.plugins.entries()){if(registration.plugin.hooks?.onDestroy){try{const context={config:{},meta:{stage:PluginLifecycleStage.DESTROY}};registration.plugin.hooks.onDestroy(context)}catch(error){logger.error(`插件销毁钩子执行失败: ${name}`,error)}}}this.plugins.clear();logger.debug("所有路由插件已清空")}getCount(){return this.plugins.size}constructor(){_define_property(this,"plugins",new Map)}}let pluginManagerInstance=null;export function getRouterPluginManager(){if(!pluginManagerInstance){pluginManagerInstance=new RouterPluginManager}return pluginManagerInstance}

package/dist/core/router/plugin/index.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});_export_star(require("./types"),exports);_export_star(require("./RouterPluginManager"),exports);function _export_star(from,to){Object.keys(from).forEach(function(k){if(k!=="default"&&!Object.prototype.hasOwnProperty.call(to,k)){Object.defineProperty(to,k,{enumerable:true,get:function(){return from[k]}})}});return from}

package/dist/core/router/plugin/index.d.ts

@@ -1,5 +0,0 @@
-/**
- * 路由插件模块入口
- */
-export * from './types';
-export * from './RouterPluginManager';

package/dist/core/router/plugin/index.js

@@ -1 +0,0 @@
-export*from"./types";export*from"./RouterPluginManager";

package/dist/core/router/plugin/types.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"PluginLifecycleStage",{enumerable:true,get:function(){return PluginLifecycleStage}});var PluginLifecycleStage=/*#__PURE__*/function(PluginLifecycleStage){PluginLifecycleStage["REGISTER"]="register";PluginLifecycleStage["BEFORE_INIT"]="before-init";PluginLifecycleStage["AFTER_INIT"]="after-init";PluginLifecycleStage["BEFORE_TRANSFORM"]="before-transform";PluginLifecycleStage["AFTER_TRANSFORM"]="after-transform";PluginLifecycleStage["BEFORE_MATCH"]="before-match";PluginLifecycleStage["AFTER_MATCH"]="after-match";PluginLifecycleStage["DESTROY"]="destroy";return PluginLifecycleStage}({});

package/dist/core/router/plugin/types.d.ts

@@ -1,153 +0,0 @@
-/**
- * 路由插件类型定义
- */
-import type { RouterConfig, RouteConfig } from '../types';
-import type { RouterMiddlewareContext } from '../middleware/types';
-/**
- * 插件生命周期阶段
- */
-export declare enum PluginLifecycleStage {
-    /**
-     * 插件注册阶段
-     */
-    REGISTER = "register",
-    /**
-     * 路由初始化前
-     */
-    BEFORE_INIT = "before-init",
-    /**
-     * 路由初始化后
-     */
-    AFTER_INIT = "after-init",
-    /**
-     * 路由转换前
-     */
-    BEFORE_TRANSFORM = "before-transform",
-    /**
-     * 路由转换后
-     */
-    AFTER_TRANSFORM = "after-transform",
-    /**
-     * 路由匹配前
-     */
-    BEFORE_MATCH = "before-match",
-    /**
-     * 路由匹配后
-     */
-    AFTER_MATCH = "after-match",
-    /**
-     * 插件销毁阶段
-     */
-    DESTROY = "destroy"
-}
-/**
- * 插件上下文
- */
-export interface PluginContext {
-    /**
-     * 路由配置
-     */
-    config: RouterConfig;
-    /**
-     * 转换后的路由
-     */
-    routes?: RouteConfig[];
-    /**
-     * 中间件上下文（在路由匹配时可用）
-     */
-    middlewareContext?: RouterMiddlewareContext;
-    /**
-     * 插件元数据
-     */
-    meta?: Record<string, unknown>;
-}
-/**
- * 插件钩子函数
- */
-export type PluginHook = (context: PluginContext) => void | Promise<void>;
-/**
- * 路由插件接口
- */
-export interface RouterPlugin {
-    /**
-     * 插件名称（唯一标识）
-     */
-    name: string;
-    /**
-     * 插件版本
-     */
-    version?: string;
-    /**
-     * 插件描述
-     */
-    description?: string;
-    /**
-     * 插件优先级（数字越小优先级越高）
-     * @default 100
-     */
-    priority?: number;
-    /**
-     * 是否启用
-     * @default true
-     */
-    enabled?: boolean;
-    /**
-     * 插件依赖（其他插件名称列表）
-     */
-    dependencies?: string[];
-    /**
-     * 插件配置
-     */
-    config?: Record<string, unknown>;
-    /**
-     * 生命周期钩子
-     */
-    hooks?: {
-        /**
-         * 插件注册时调用
-         */
-        onRegister?: PluginHook;
-        /**
-         * 路由初始化前调用
-         */
-        onBeforeInit?: PluginHook;
-        /**
-         * 路由初始化后调用
-         */
-        onAfterInit?: PluginHook;
-        /**
-         * 路由转换前调用
-         */
-        onBeforeTransform?: PluginHook;
-        /**
-         * 路由转换后调用
-         */
-        onAfterTransform?: PluginHook;
-        /**
-         * 路由匹配前调用
-         */
-        onBeforeMatch?: PluginHook;
-        /**
-         * 路由匹配后调用
-         */
-        onAfterMatch?: PluginHook;
-        /**
-         * 插件销毁时调用
-         */
-        onDestroy?: PluginHook;
-    };
-}
-/**
- * 插件注册选项
- */
-export interface PluginRegisterOptions {
-    /**
-     * 是否覆盖已存在的插件
-     * @default false
-     */
-    overwrite?: boolean;
-    /**
-     * 插件配置
-     */
-    config?: Record<string, unknown>;
-}

package/dist/core/router/plugin/types.js

@@ -1 +0,0 @@
-export var PluginLifecycleStage=/*#__PURE__*/function(PluginLifecycleStage){PluginLifecycleStage["REGISTER"]="register";PluginLifecycleStage["BEFORE_INIT"]="before-init";PluginLifecycleStage["AFTER_INIT"]="after-init";PluginLifecycleStage["BEFORE_TRANSFORM"]="before-transform";PluginLifecycleStage["AFTER_TRANSFORM"]="after-transform";PluginLifecycleStage["BEFORE_MATCH"]="before-match";PluginLifecycleStage["AFTER_MATCH"]="after-match";PluginLifecycleStage["DESTROY"]="destroy";return PluginLifecycleStage}({});

package/dist/core/router/types.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});