@yumerijs/core 1.2.0 → 1.3.0

package/dist/command.d.ts

@@ -1,5 +1,5 @@
 /**
- * @time: 2025/03/25 23:53
+ * @time: 2025/08/14 09:48
  * @author: FireGuo
  * WindyPear-Team All right reserved
  **/

package/dist/command.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * @time: 2025/03/25 23:53
+ * @time: 2025/08/14 09:48
  * @author: FireGuo
  * WindyPear-Team All right reserved
  **/

package/dist/context.d.ts

@@ -1,8 +1,25 @@
+/**
+ * @time: 2025/08/14 19:10
+ * @author: FireGuo
+ * WindyPear-Team All right reserved
+ **/
 import { Core } from './core';
-import { Command } from './command';
 import { Route } from './route';
+import { HookHandler } from './hook';
+/**
+ * 插件上下文对象
+ * 每个插件一个 Context，用于管理插件注册的命令、路由、事件、组件和中间件
+ */
 export declare class Context {
     private core;
+    private routes;
+    private eventlisteners;
+    private components;
+    private middlewares;
+    private hooks;
+    /**
+     * 插件名称
+     */
     pluginname: string;
     /**
      * 创建 Context 实例
@@ -10,14 +27,10 @@ export declare class Context {
      * @param pluginname 插件名称
      */
     constructor(core: Core, pluginname: string);
-    /**
-     * @deprecated Use route() instead.
-     */
-    command(name: string): Command;
     /**
      * 注册路由
      * @param path 路由路径
-     * @returns Route
+     * @returns Route 实例
      */
     route(path: string): Route;
     /**
@@ -33,8 +46,23 @@ export declare class Context {
      */
     use(name: string, callback: Function): void;
     /**
-     * Unless nessesary, do not use core directly
-    */
+     * 注册 Hook 钩子
+     * @param name Hook 点名称
+     * @param hookname 钩子名称
+     * @param callback 钩子回调函数
+     */
+    hook(name: string, hookname: string, callback: HookHandler): void;
+    /**
+     * 执行 Hook 钩子
+     * @param name Hook 点名称
+     * @param args Hook 参数
+     * @returns Promise<any[]>
+     */
+    executeHook(name: string, ...args: any[]): Promise<any[]>;
+    /**
+     * 获取 Core 实例
+     * @returns Core
+     */
     getCore(): Core;
     /**
      * 触发事件
@@ -45,7 +73,7 @@ export declare class Context {
     emit(event: string, ...args: any[]): Promise<void>;
     /**
      * 获取组件实例
-     * @param name  组件名称
+     * @param name 组件名称
      * @returns 组件实例
      */
     getComponent(name: string): any;
@@ -53,7 +81,11 @@ export declare class Context {
      * 注册组件
      * @param name 组件名称
      * @param component 组件实例
-     * @returns void
      */
     registerComponent(name: string, component: any): void;
+    /**
+     * 卸载插件时清理注册的所有资源
+     * 包括组件、路由、中间件和事件监听器
+     */
+    dispose(): void;
 }

package/dist/context.js

@@ -1,9 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Context = void 0;
-const command_1 = require("./command");
+const route_1 = require("./route");
+/**
+ * 插件上下文对象
+ * 每个插件一个 Context，用于管理插件注册的命令、路由、事件、组件和中间件
+ */
 class Context {
     core;
+    routes = [];
+    eventlisteners = [];
+    components = [];
+    middlewares = [];
+    hooks = {};
+    /**
+     * 插件名称
+     */
     pluginname;
     /**
      * 创建 Context 实例
@@ -14,33 +26,18 @@ class Context {
         this.core = core;
         this.pluginname = pluginname;
     }
-    /**
-     * @deprecated Use route() instead.
-     */
-    command(name) {
-        if (this.core.commands[name]) {
-            this.core.logger.warn(`Plugin "${this.pluginname}" attempt to register command "${name}", but it has been registered by plugin "${this.core.cmdtoplu[name]}."`);
-            return new command_1.Command(this.core, name);
-        }
-        else {
-            this.core.cmdtoplu[name] = this.pluginname;
-            return this.core.command(name);
-        }
-    }
     /**
      * 注册路由
      * @param path 路由路径
-     * @returns Route
+     * @returns Route 实例
      */
     route(path) {
         if (this.core.routes[path]) {
-            this.core.logger.warn(`Plugin "${this.pluginname}" attempt to register route "${path}", but it has been registered by plugin "${this.core.routetoplu[path]}."`);
-            return this.core.routes[path];
-        }
-        else {
-            this.core.routetoplu[path] = this.pluginname;
-            return this.core.route(path);
+            this.core.logger.warn(`Plugin "${this.pluginname}" attempt to register route "${path}", but it has already been registered.`);
+            return new route_1.Route(path);
         }
+        this.routes.push(path);
+        return this.core.route(path);
     }
     /**
      * 注册事件
@@ -48,14 +45,9 @@ class Context {
      * @param listener 事件监听器
      */
     on(name, listener) {
-        // 存储该插件监听的事件，需要注意的是一个事件可由多个插件监听
-        if (!this.core.evttoplu[name]) {
-            this.core.evttoplu[name] = {};
-        }
-        if (!this.core.evttoplu[name][this.pluginname]) {
-            this.core.evttoplu[name][this.pluginname] = [];
-        }
-        this.core.evttoplu[name][this.pluginname].push(listener);
+        // 记录插件自己的事件监听器
+        this.eventlisteners.push({ name, listener });
+        // 注册到 core 的全局事件监听器中
         this.core.on(name, listener);
     }
     /**
@@ -64,14 +56,32 @@ class Context {
      * @param callback 中间件回调函数
      */
     use(name, callback) {
-        this.core.mdwtoplu[name] = this.pluginname;
-        this.core.use(name, async (...args) => {
-            return callback(...args);
-        });
+        this.middlewares.push(name);
+        this.core.use(name, async (...args) => callback(...args));
+    }
+    /**
+     * 注册 Hook 钩子
+     * @param name Hook 点名称
+     * @param hookname 钩子名称
+     * @param callback 钩子回调函数
+     */
+    hook(name, hookname, callback) {
+        this.core.hook(name, hookname, callback);
+        this.hooks[name].push(hookname);
     }
     /**
-     * Unless nessesary, do not use core directly
-    */
+     * 执行 Hook 钩子
+     * @param name Hook 点名称
+     * @param args Hook 参数
+     * @returns Promise<any[]>
+     */
+    async executeHook(name, ...args) {
+        return await this.core.hookExecute(name, ...args);
+    }
+    /**
+     * 获取 Core 实例
+     * @returns Core
+     */
     getCore() {
         return this.core;
     }
@@ -86,7 +96,7 @@ class Context {
     }
     /**
      * 获取组件实例
-     * @param name  组件名称
+     * @param name 组件名称
      * @returns 组件实例
      */
     getComponent(name) {
@@ -96,16 +106,50 @@ class Context {
      * 注册组件
      * @param name 组件名称
      * @param component 组件实例
-     * @returns void
      */
     registerComponent(name, component) {
         if (this.core.components[name]) {
-            this.core.logger.warn(`Plugin "${this.pluginname}" attempt to register component "${name}", but it has been registered by plugin "${this.core.comtoplu[name]}."`);
+            this.core.logger.warn(`Plugin "${this.pluginname}" attempt to register component "${name}", but it has already been registered.`);
             return;
         }
-        this.core.comtoplu[name] = this.pluginname;
         this.core.components[name] = component;
-        return;
+        this.components.push(name);
+    }
+    /**
+     * 卸载插件时清理注册的所有资源
+     * 包括组件、路由、中间件和事件监听器
+     */
+    dispose() {
+        // 删除组件
+        this.components.forEach((name) => {
+            delete this.core.components[name];
+        });
+        // 删除路由
+        this.routes.forEach((route) => {
+            delete this.core.routes[route];
+        });
+        // 删除中间件
+        this.middlewares.forEach((middleware) => {
+            delete this.core.globalMiddlewares[middleware];
+        });
+        // 删除事件监听器
+        this.eventlisteners.forEach(({ name, listener }) => {
+            if (this.core.eventListeners?.[name]) {
+                this.core.eventListeners[name] =
+                    this.core.eventListeners[name].filter((l) => l !== listener);
+            }
+        });
+        // 删除钩子
+        for (const hook in this.hooks) {
+            this.hooks.hook.forEach((hookname) => {
+                this.core.unhook(hook, hookname);
+            });
+        }
+        // 清空 Context 内部记录，避免内存泄漏
+        this.components = [];
+        this.routes = [];
+        this.middlewares = [];
+        this.eventlisteners = [];
     }
 }
 exports.Context = Context;

package/dist/core.d.ts

@@ -1,11 +1,11 @@
 import { Config } from './config';
 import { Logger } from './logger';
-import { Command } from './command';
 import { Session } from './session';
-import { Platform } from './platform';
 import { Middleware } from './middleware';
 import { Route } from './route';
 import { Context } from './context';
+import { HookHandler, Hook } from './hook';
+import { Server as CoreServer } from './server';
 interface Plugin {
     apply: (ctx: Context, config: Config) => Promise<void>;
     disable: (ctx: Context) => Promise<void>;
@@ -19,6 +19,13 @@ interface PluginLoader {
     installPluginDependencies(pluginName: string): Promise<void>;
     logger: Logger;
 }
+interface CoreOptions {
+    port: number;
+    host: string;
+    staticDir: string;
+    enableCors: boolean;
+    enableWs: boolean;
+}
 /**
  * 定义插件状态枚举
  */
@@ -35,60 +42,49 @@ export declare class Core {
         };
     };
     config: any;
-    platforms: Platform[];
-    private eventListeners;
+    eventListeners: {
+        [event: string]: ((...args: any[]) => Promise<void>)[];
+    };
     components: {
         [name: string]: any;
     };
-    commands: Record<string, Command>;
     routes: Record<string, Route>;
     pluginLoader: PluginLoader;
     logger: Logger;
     providedComponents: {
         [name: string]: string;
     };
+    globalMiddlewares: Record<string, Middleware>;
+    pluginStatus: Record<string, PluginStatus>;
+    hooks: Record<string, Hook>;
+    coreConfig: CoreOptions;
+    server: CoreServer;
+    private pluginWatchers;
     private pluginModules;
     private configPath;
-    private globalMiddlewares;
     /**
-     * @deprecated 命令与插件对应关系
+     * 插件名 -> Context 映射
      */
-    cmdtoplu: Record<string, string>;
+    private pluginContexts;
+    constructor(pluginLoader?: PluginLoader, coreConfig?: CoreOptions);
     /**
-     * 路由与插件对应关系
+     * 获取或创建插件对应 Context
      */
-    routetoplu: Record<string, string>;
+    getContext(pluginName: string): Context;
     /**
-     * 组件与插件对应关系
-     */
-    comtoplu: Record<string, string>;
-    /**
-     * 事件监听器与插件对应关系
-     */
-    evttoplu: Record<string, Record<string, ((...args: any[]) => Promise<void>)[]>>;
-    /**
-     * 中间件与插件对应关系
-     */
-    mdwtoplu: Record<string, string>;
-    plftoplu: Record<string, string>;
-    /**
-     * 插件状态
-     */
-    pluginStatus: Record<string, PluginStatus>;
-    /**
-     * 插件监听器
-     */
-    private pluginWatchers;
-    /**
-     * 初始化核心
-     * @param pluginLoader 插件加载器
+     * 清理指定插件注册的所有内容
      */
-    constructor(pluginLoader: PluginLoader);
+    unregall(pluginName: string): void;
     /**
      * 加载配置文件
      * @param configPath 配置文件的路径
      */
     loadConfig(configPath: string): Promise<void>;
+    /**
+     * 启动应用
+     * @returns Promise<void>
+     */
+    runCore(): Promise<void>;
     /**
      * 监听配置文件变化，实现热重载
      * @param configPath 配置文件的路径
@@ -175,10 +171,6 @@ export declare class Core {
      * @returns Core 实例
      */
     use(name: string, middleware: Middleware): Core;
-    /**
-     * @deprecated 已更改为路由
-     */
-    command(name: string): Command;
     /**
      * 注册路由
      * @param path 路由路径
@@ -186,10 +178,23 @@ export declare class Core {
      */
     route(path: string): Route;
     /**
-     * 执行命令
-     * @deprecated
+     * 注册 Hook 钩子
+     * @param name Hook 点名称
+     * @param hookname 钩子名称
+     * @param callback 钩子函数
+     */
+    hook(name: string, hookname: string, callback: HookHandler): any;
+    /**
+     * 消除 Hook 钩子
+     */
+    unhook(name: string, hookname: string): any;
+    /**
+     * 执行 Hook 钩子
+     * @param name Hook 点名称
+     * @param args 参数
+     * @return Promise<any[]>
      */
-    executeCommand(name: string, session: any, ...args: any[]): Promise<Session | null>;
+    hookExecute(name: string, ...args: any[]): Promise<any[]>;
     /**
      * 执行路由
      * @param pathname 需要匹配的URL
@@ -198,23 +203,6 @@ export declare class Core {
      * @returns 是否匹配成功
      */
     executeRoute(pathname: string, session: Session, queryParams: URLSearchParams): Promise<boolean>;
-    /**
-     * 注册平台
-     * @param platform 平台实例
-     * @returns 平台启动结果
-     */
-    registerPlatform(platform: Platform): any;
-    /**
-     * 清理指定插件注册的所有内容
-     * @param pluginname 插件名称
-     */
-    unregall(pluginname: string): void;
-    /**
-     * 获取命令
-     * @param name 命令名称
-     * @returns Command 实例或 null
-     */
-    getCommand(name: string): Command | null;
     /**
      * 获取路由
      * @param path 匹配路径

package/dist/core.js

@@ -35,8 +35,8 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Core = void 0;
 /**
- * @time: 2025/07/12 18:14
- * @author: FireGuo & Manus
+ * @time: 2025/08/14 09:48
+ * @author: FireGuo
  * WindyPear-Team All right reserved
  **/
 const yaml = __importStar(require("js-yaml"));
@@ -44,59 +44,54 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const config_1 = require("./config");
 const logger_1 = require("./logger");
-const command_1 = require("./command");
 const chokidar = __importStar(require("chokidar"));
 const route_1 = require("./route");
 const context_1 = require("./context");
+const hook_1 = require("./hook");
+const server_1 = require("./server");
 class Core {
     plugins = {};
     config = null;
-    platforms = [];
     eventListeners = {};
     components = {};
-    commands = {};
     routes = {};
     pluginLoader;
     logger = new logger_1.Logger('core');
     providedComponents = {};
+    globalMiddlewares = {};
+    pluginStatus = {};
+    hooks = {};
+    coreConfig;
+    server;
+    pluginWatchers = {};
     pluginModules = {};
     configPath = '';
-    globalMiddlewares = {};
-    /**
-     * @deprecated 命令与插件对应关系
-     */
-    cmdtoplu = {};
-    /**
-     * 路由与插件对应关系
-     */
-    routetoplu = {};
     /**
-     * 组件与插件对应关系
+     * 插件名 -> Context 映射
      */
-    comtoplu = {};
-    /**
-     * 事件监听器与插件对应关系
-     */
-    evttoplu = {};
-    /**
-     * 中间件与插件对应关系
-     */
-    mdwtoplu = {};
-    plftoplu = {};
-    /**
-     * 插件状态
-     */
-    pluginStatus = {};
+    pluginContexts = {};
+    constructor(pluginLoader, coreConfig) {
+        this.coreConfig = coreConfig;
+        this.pluginLoader = pluginLoader;
+    }
     /**
-     * 插件监听器
+     * 获取或创建插件对应 Context
      */
-    pluginWatchers = {};
+    getContext(pluginName) {
+        if (!this.pluginContexts[pluginName]) {
+            this.pluginContexts[pluginName] = new context_1.Context(this, pluginName);
+        }
+        return this.pluginContexts[pluginName];
+    }
     /**
-     * 初始化核心
-     * @param pluginLoader 插件加载器
+     * 清理指定插件注册的所有内容
      */
-    constructor(pluginLoader) {
-        this.pluginLoader = pluginLoader;
+    unregall(pluginName) {
+        const ctx = this.pluginContexts[pluginName];
+        if (ctx) {
+            ctx.dispose();
+            delete this.pluginContexts[pluginName];
+        }
     }
     /**
      * 加载配置文件
@@ -111,12 +106,28 @@ class Core {
             if (process.env.NODE_ENV === 'development') {
                 this.watchConfig(configPath);
             }
+            this.coreConfig = this.config.core || {};
         }
         catch (e) {
             this.logger.error('Failed to load config:', e);
             throw e;
         }
     }
+    /**
+     * 启动应用
+     * @returns Promise<void>
+     */
+    async runCore() {
+        this.server = new server_1.Server(this, {
+            port: this.coreConfig.port || 14510,
+            host: this.coreConfig.host || '0.0.0.0',
+            enableCors: this.coreConfig.enableCors || false,
+            enableWs: this.coreConfig.enableWs || false,
+            staticDir: this.coreConfig.staticDir || 'public',
+        });
+        await this.server.start();
+        this.logger.info(`Yumeri server started at ${this.coreConfig.host}:${this.coreConfig.port}`);
+    }
     /**
      * 监听配置文件变化，实现热重载
      * @param configPath 配置文件的路径
@@ -255,7 +266,7 @@ class Core {
             this.plugins[pluginName] = pluginInstance;
             if (pluginInstance.apply) {
                 this.pluginLoader.logger.info(`Apply plugin "${pluginName}"`);
-                await pluginInstance.apply(new context_1.Context(this, pluginName), await this.getPluginConfig(pluginName));
+                await pluginInstance.apply(this.getContext(pluginName), await this.getPluginConfig(pluginName));
             }
             // 注册提供的组件
             if (pluginInstance.provide) {
@@ -365,9 +376,8 @@ class Core {
         this.logger.info(`Unloading plugin "${pluginName}"...`);
         try {
             const plugin = this.plugins[pluginName];
-            if (plugin && plugin.disable) {
-                await plugin.disable(new context_1.Context(this, pluginName));
-            }
+            if (plugin && plugin.disable)
+                await plugin.disable(this.getContext(pluginName));
             await this.pluginLoader.unloadPlugin(pluginName);
             this.unregall(pluginName); // 清理该插件注册的所有内容
             delete this.plugins[pluginName];
@@ -465,7 +475,6 @@ class Core {
     unregisterComponent(name) {
         delete this.components[name];
         delete this.providedComponents[name];
-        delete this.comtoplu[name];
     }
     /**
      * 注册事件监听器
@@ -505,14 +514,6 @@ class Core {
         this.globalMiddlewares[name] = middleware;
         return this;
     }
-    /**
-     * @deprecated 已更改为路由
-     */
-    command(name) {
-        const command = new command_1.Command(this, name);
-        this.commands[name] = command;
-        return command;
-    }
     /**
      * 注册路由
      * @param path 路由路径
@@ -524,29 +525,36 @@ class Core {
         return route;
     }
     /**
-     * 执行命令
-     * @deprecated
+     * 注册 Hook 钩子
+     * @param name Hook 点名称
+     * @param hookname 钩子名称
+     * @param callback 钩子函数
      */
-    async executeCommand(name, session, ...args) {
-        const command = this.commands[name];
-        if (command) {
-            const globalMiddlewareList = Object.values(this.globalMiddlewares || {});
-            const commandMiddlewareList = command.middlewares || [];
-            const middlewares = [...globalMiddlewareList, ...commandMiddlewareList];
-            let index = 0;
-            const runner = async () => {
-                if (index < middlewares.length) {
-                    const middleware = middlewares[index++];
-                    await middleware(session, runner);
-                }
-                else {
-                    await command.executeHandler(session, ...args);
-                }
-            };
-            await runner();
-            return session;
+    hook(name, hookname, callback) {
+        if (!this.hooks[name]) {
+            this.hooks[name] = new hook_1.Hook(name);
+        }
+        this.hooks[name].add(hookname, callback);
+    }
+    /**
+     * 消除 Hook 钩子
+     */
+    unhook(name, hookname) {
+        if (this.hooks[name]) {
+            this.hooks[name].remove(hookname);
+        }
+    }
+    /**
+     * 执行 Hook 钩子
+     * @param name Hook 点名称
+     * @param args 参数
+     * @return Promise<any[]>
+     */
+    async hookExecute(name, ...args) {
+        if (this.hooks[name]) {
+            return await this.hooks[name].trigger(...args);
         }
-        return null;
+        return [];
     }
     /**
      * 执行路由
@@ -560,18 +568,13 @@ class Core {
             const route = this.routes[routePath];
             const result = route.match(pathname);
             if (result) {
-                const globalMiddlewareList = Object.values(this.globalMiddlewares || {});
-                const routeMiddlewareList = route.middlewares || [];
-                const middlewares = [...globalMiddlewareList, ...routeMiddlewareList];
+                const middlewares = [...Object.values(this.globalMiddlewares), ...(route.middlewares || [])];
                 let index = 0;
                 const runner = async () => {
-                    if (index < middlewares.length) {
-                        const middleware = middlewares[index++];
-                        await middleware(session, runner);
-                    }
-                    else {
+                    if (index < middlewares.length)
+                        await middlewares[index++](session, runner);
+                    else
                         await route.executeHandler(session, queryParams, result.pathParams);
-                    }
                 };
                 await runner();
                 return true;
@@ -579,74 +582,6 @@ class Core {
         }
         return false;
     }
-    /**
-     * 注册平台
-     * @param platform 平台实例
-     * @returns 平台启动结果
-     */
-    registerPlatform(platform) {
-        this.platforms.push(platform);
-        return platform.startPlatform(this);
-    }
-    /**
-     * 清理指定插件注册的所有内容
-     * @param pluginname 插件名称
-     */
-    unregall(pluginname) {
-        // 清理 commands
-        Object.keys(this.cmdtoplu)
-            .filter(cmd => this.cmdtoplu[cmd] === pluginname)
-            .forEach(cmd => {
-            delete this.cmdtoplu[cmd];
-            delete this.commands[cmd];
-        });
-        // 清理 routes
-        Object.keys(this.routetoplu)
-            .filter(path => this.routetoplu[path] === pluginname)
-            .forEach(path => {
-            delete this.routetoplu[path];
-            delete this.routes[path];
-        });
-        // 清理 components 和 providedComponents
-        Object.keys(this.comtoplu)
-            .filter(comp => this.comtoplu[comp] === pluginname)
-            .forEach(comp => {
-            delete this.comtoplu[comp];
-            delete this.components[comp];
-            delete this.providedComponents[comp];
-        });
-        // 清理由 provide 声明的组件提供关系
-        Object.keys(this.providedComponents)
-            .filter(prov => this.providedComponents[prov] === pluginname)
-            .forEach(prov => {
-            delete this.providedComponents[prov];
-        });
-        // 清理 event listeners
-        for (const evt in this.evttoplu) {
-            if (this.evttoplu[evt][pluginname]) {
-                const pluginListeners = this.evttoplu[evt][pluginname] || [];
-                if (this.eventListeners[evt]) {
-                    this.eventListeners[evt] = this.eventListeners[evt].filter(l => !pluginListeners.includes(l));
-                }
-                delete this.evttoplu[evt][pluginname];
-            }
-        }
-        // 清理 middlewares
-        Object.keys(this.mdwtoplu)
-            .filter(mdw => this.mdwtoplu[mdw] === pluginname)
-            .forEach(mdw => {
-            delete this.mdwtoplu[mdw];
-            delete this.globalMiddlewares[mdw];
-        });
-    }
-    /**
-     * 获取命令
-     * @param name 命令名称
-     * @returns Command 实例或 null
-     */
-    getCommand(name) {
-        return this.commands[name] || null;
-    }
     /**
      * 获取路由
      * @param path 匹配路径

package/dist/hook.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @time: 2025/08/14 18:33
+ * @author: FireGuo
+ * WindyPear-Team All right reserved
+ **/
+/**
+ * Hook 处理器
+ */
+export type HookHandler = (...args: any[]) => Promise<any>;
+/**
+ * Hook 类
+ */
+export declare class Hook {
+    name: string;
+    handlers: Record<string, HookHandler>;
+    /**
+     * 创建 Hook 实例
+     * @param name Hook 名称
+     */
+    constructor(name: string);
+    /**
+     * 添加 Hook 函数
+     * @param name Hook 函数名称
+     * @param handler Hook 函数
+     */
+    add(name: string, handler: HookHandler): void;
+    /**
+     * 删除 Hook 函数
+     * @param name Hook 函数名称
+     */
+    remove(name: string): void;
+    /**
+     * 触发 Hook 函数
+     * @param session 会话
+     * @param args 参数
+     * @returns 执行结果
+     */
+    trigger(...args: any[]): Promise<any[]>;
+}

package/dist/hook.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * @time: 2025/08/14 18:33
+ * @author: FireGuo
+ * WindyPear-Team All right reserved
+ **/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Hook = void 0;
+/**
+ * Hook 类
+ */
+class Hook {
+    name;
+    handlers = {};
+    /**
+     * 创建 Hook 实例
+     * @param name Hook 名称
+     */
+    constructor(name) {
+        this.name = name;
+    }
+    /**
+     * 添加 Hook 函数
+     * @param name Hook 函数名称
+     * @param handler Hook 函数
+     */
+    add(name, handler) {
+        this.handlers[name] = handler;
+    }
+    /**
+     * 删除 Hook 函数
+     * @param name Hook 函数名称
+     */
+    remove(name) {
+        delete this.handlers[name];
+    }
+    /**
+     * 触发 Hook 函数
+     * @param session 会话
+     * @param args 参数
+     * @returns 执行结果
+     */
+    async trigger(...args) {
+        let result;
+        for (const handler of Object.values(this.handlers)) {
+            result.push(handler(...args));
+        }
+        return result;
+    }
+}
+exports.Hook = Hook;

package/dist/index.d.ts

@@ -1,13 +1,12 @@
 /**
- * @time: 2025/03/24 12:26
+ * @time: 2025/08/14 09:48
  * @author: FireGuo
  * WindyPear-Team All right reserved
  **/
 export * from './core';
 export * from './session';
-export * from './command';
 export * from './route';
 export * from './config';
 export * from './logger';
-export * from './platform';
 export * from './context';
+export * from './hook';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * @time: 2025/03/24 12:26
+ * @time: 2025/08/14 09:48
  * @author: FireGuo
  * WindyPear-Team All right reserved
  **/
@@ -21,9 +21,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./core"), exports);
 __exportStar(require("./session"), exports);
-__exportStar(require("./command"), exports);
 __exportStar(require("./route"), exports);
 __exportStar(require("./config"), exports);
 __exportStar(require("./logger"), exports);
-__exportStar(require("./platform"), exports);
 __exportStar(require("./context"), exports);
+__exportStar(require("./hook"), exports);

package/dist/logger.d.ts

@@ -1,8 +1,8 @@
 /**
- * @time: 2025/03/25 18:01
+ * @time: 2025/08/14 09:48
  * @author: FireGuo
  * WindyPear-Team All right reserved
- */
+ **/
 import { Core } from './core';
 export declare class Logger {
     private title;

package/dist/logger.js

@@ -1,15 +1,15 @@
 "use strict";
 /**
- * @time: 2025/03/25 18:01
+ * @time: 2025/08/14 09:48
  * @author: FireGuo
  * WindyPear-Team All right reserved
- */
+ **/
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Logger = void 0;
-const picocolors_1 = __importDefault(require("picocolors")); // 轻量颜色库
+const picocolors_1 = __importDefault(require("picocolors"));
 class Logger {
     title;
     titleColor;

package/dist/middleware.d.ts

@@ -1,2 +1,7 @@
+/**
+ * @time: 2025/08/14 09:48
+ * @author: FireGuo
+ * WindyPear-Team All right reserved
+ **/
 import { Session } from './session';
 export type Middleware = (session: Session, next: () => Promise<void>) => Promise<void>;

package/dist/platform.d.ts

@@ -1,3 +1,8 @@
+/**
+ * @time: 2025/08/14 09:48
+ * @author: FireGuo
+ * WindyPear-Team All right reserved
+ **/
 import { Session } from './session';
 import { Core } from './core';
 import { ConfigSchema } from './config';

package/dist/platform.js

@@ -1,6 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Platform = void 0;
+/**
+ * @time: 2025/08/14 09:48
+ * @author: FireGuo
+ * WindyPear-Team All right reserved
+ **/
 const session_1 = require("./session");
 /**
  * Platform 基类

package/dist/route.d.ts

@@ -1,3 +1,8 @@
+/**
+ * @time: 2025/08/14 09:48
+ * @author: FireGuo
+ * WindyPear-Team All right reserved
+ **/
 import { Session } from './session';
 import { Middleware } from './middleware';
 export type RouteHandler = (session: Session, queryParams: URLSearchParams, ...pathParams: string[]) => Promise<void> | void;

package/dist/server.d.ts

@@ -0,0 +1,26 @@
+import { Core } from './core';
+export interface ServerConfig {
+    port: number;
+    host: string;
+    enableCors: boolean;
+    staticDir: string;
+    enableWs: boolean;
+}
+export declare class Server {
+    private core;
+    private port;
+    private host;
+    private enableCors;
+    private staticDir;
+    private enableWs;
+    private httpServer;
+    private wsServer;
+    constructor(core: Core, config?: Partial<ServerConfig>);
+    private createSession;
+    private parseCookies;
+    private getClientIP;
+    private parseRequestBody;
+    private serveStaticFile;
+    start(): Promise<void>;
+    stop(): void;
+}

package/dist/server.js

@@ -0,0 +1,231 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Server = void 0;
+const logger_1 = require("./logger");
+const session_1 = require("./session");
+const http_1 = __importDefault(require("http"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const url_1 = require("url");
+const ws_1 = __importDefault(require("ws"));
+const formidable = __importStar(require("formidable"));
+const mime = __importStar(require("mime-types"));
+const logger = new logger_1.Logger('server');
+class Server {
+    core;
+    port;
+    host;
+    enableCors;
+    staticDir;
+    enableWs;
+    httpServer = null;
+    wsServer = null;
+    constructor(core, config = {}) {
+        this.core = core;
+        this.port = config.port ?? 14510;
+        this.host = config.host ?? '0.0.0.0';
+        this.enableCors = config.enableCors ?? true;
+        this.staticDir = config.staticDir ?? 'static';
+        this.enableWs = config.enableWs ?? true;
+    }
+    createSession(ip, cookies, res, req, extra = {}) {
+        const session = new session_1.Session(ip, cookies, this, req, res);
+        Object.assign(session.properties, extra);
+        session.protocol = extra.protocol ?? 'http';
+        return session;
+    }
+    parseCookies(req) {
+        const cookieHeader = req.headers.cookie;
+        if (!cookieHeader)
+            return {};
+        const cookies = {};
+        cookieHeader.split(';').forEach(c => {
+            const [k, ...v] = c.split('=');
+            cookies[k.trim()] = v.join('=').trim();
+        });
+        return cookies;
+    }
+    getClientIP(req) {
+        const xff = req.headers['x-forwarded-for'];
+        return xff ? xff.split(',')[0].trim() : req.socket.remoteAddress || '127.0.0.1';
+    }
+    async parseRequestBody(req) {
+        return new Promise((resolve, reject) => {
+            const contentType = (req.headers['content-type'] || '').toLowerCase();
+            if (contentType.includes('application/json') || contentType.includes('application/x-www-form-urlencoded')) {
+                let body = '';
+                req.on('data', chunk => body += chunk.toString());
+                req.on('end', () => {
+                    try {
+                        if (contentType.includes('application/json'))
+                            resolve(JSON.parse(body));
+                        else {
+                            const params = new URLSearchParams(body);
+                            const parsed = {};
+                            params.forEach((v, k) => parsed[k] = v);
+                            resolve(parsed);
+                        }
+                    }
+                    catch (e) {
+                        reject(e);
+                    }
+                });
+            }
+            else if (contentType.includes('multipart/form-data')) {
+                const form = formidable.formidable({});
+                form.parse(req, (err, fields) => {
+                    if (err)
+                        return reject(err);
+                    const parsed = {};
+                    Object.keys(fields).forEach(k => {
+                        const val = fields[k];
+                        parsed[k] = Array.isArray(val) && val.length === 1 ? val[0] : val;
+                    });
+                    resolve(parsed);
+                });
+            }
+            else
+                resolve({});
+            req.on('error', reject);
+        });
+    }
+    serveStaticFile(pathname, res) {
+        const fullPath = path.join(process.cwd(), this.staticDir, pathname);
+        fs.readFile(fullPath, (err, data) => {
+            if (err) {
+                res.writeHead(404, { 'Content-Type': 'text/html' });
+                res.end(`<html><body><h1>404 Not Found</h1></body></html>`);
+            }
+            else {
+                res.writeHead(200, { 'Content-Type': mime.lookup(fullPath) || 'text/plain' });
+                res.end(data);
+            }
+        });
+    }
+    async start() {
+        this.httpServer = http_1.default.createServer(async (req, res) => {
+            if (req.method === 'OPTIONS' && this.enableCors) {
+                res.writeHead(204, {
+                    'Access-Control-Allow-Origin': '*',
+                    'Access-Control-Allow-Methods': 'GET,POST,PUT,DELETE,PATCH,HEAD,OPTIONS',
+                    'Access-Control-Allow-Headers': 'Content-Type',
+                });
+                res.end();
+                return;
+            }
+            const url = new url_1.URL(req.url || '/', `http://${req.headers.host}`);
+            const pathname = url.pathname;
+            const queryParams = url.searchParams;
+            const ip = this.getClientIP(req);
+            const cookies = this.parseCookies(req);
+            const session = this.createSession(ip, cookies, res, req, { protocol: 'http', header: req.headers });
+            if (req.method?.toLowerCase() === 'post') {
+                try {
+                    const body = await this.parseRequestBody(req);
+                    Object.entries(body).forEach(([k, v]) => {
+                        if (typeof v === 'string')
+                            queryParams.set(k, v);
+                        else if (Array.isArray(v))
+                            v.forEach(val => queryParams.append(k, val));
+                    });
+                }
+                catch (err) {
+                    res.writeHead(400, { 'Content-Type': 'text/plain' });
+                    res.end('Invalid request body');
+                    logger.error('Request body parse error:', err);
+                    return;
+                }
+            }
+            const route = this.core.getRoute(pathname);
+            if (route && route.allowedMethods.includes(req.method ?? 'GET')) {
+                const matched = await this.core.executeRoute(pathname, session, queryParams);
+                if (!matched) {
+                    this.serveStaticFile(pathname, res);
+                }
+                else {
+                    let head = session.head;
+                    head['Set-Cookie'] = Object.entries(session.newCookie).map(([k, v]) => `${k}=${v}`);
+                    if (this.enableCors) {
+                        head['Access-Control-Allow-Origin'] = '*';
+                    }
+                    res.writeHead(session.status ?? 200, head);
+                    res.end(session.body);
+                }
+            }
+            else {
+                this.serveStaticFile(pathname, res);
+            }
+        });
+        if (this.enableWs) {
+            this.wsServer = new ws_1.default.Server({ server: this.httpServer });
+            this.wsServer.on('connection', (ws, req) => {
+                const url = new url_1.URL(req.url || '/', `http://${req.headers.host}`);
+                const pathname = url.pathname;
+                const queryParams = url.searchParams;
+                const ip = this.getClientIP(req);
+                const cookies = this.parseCookies(req);
+                const session = this.createSession(ip, cookies, undefined, req, { ws, protocol: 'ws' });
+                ws.on('message', async (msg) => {
+                    try {
+                        const data = JSON.parse(msg.toString());
+                        Object.entries(data).forEach(([k, v]) => queryParams.set(k, v));
+                    }
+                    catch {
+                        queryParams.set('message', msg.toString());
+                    }
+                    await this.core.executeRoute(pathname, session, queryParams);
+                });
+                this.core.executeRoute(pathname, session, queryParams).catch(err => {
+                    logger.error(`WS initial route error for ${pathname}:`, err);
+                    ws.close(1011, 'Internal error');
+                });
+            });
+        }
+        this.httpServer.listen(this.port, this.host, () => {
+            logger.info(`Server listening on ${this.host}:${this.port}`);
+        });
+    }
+    stop() {
+        if (this.wsServer)
+            this.wsServer.close();
+        if (this.httpServer)
+            this.httpServer.close(() => logger.info('Server stopped'));
+    }
+}
+exports.Server = Server;

package/dist/session.d.ts

@@ -3,7 +3,8 @@
  * @author: FireGuo
  * WindyPear-Team All right reserved
  **/
-import { Platform } from './platform';
+import { Server } from './server';
+import { IncomingMessage, ServerResponse } from 'http';
 export declare class Session {
     ip: string;
     cookie: Record<string, string>;
@@ -14,9 +15,12 @@ export declare class Session {
     head: Record<string, any>;
     status: number;
     body: any;
-    platform: Platform;
     properties?: Record<string, any>;
-    constructor(ip: string, cookie: Record<string, string>, platform: Platform, query?: Record<string, string>);
+    res: any;
+    req: any;
+    server: Server;
+    protocol: string;
+    constructor(ip: string, cookie: Record<string, string>, server: Server, req?: IncomingMessage, res?: ServerResponse, query?: Record<string, string>);
     private generateId;
     private md5;
     setData(key: string, value: any): void;

package/dist/session.js

@@ -20,18 +20,23 @@ class Session {
     head = {};
     status = 200;
     body;
-    platform;
     properties = {};
+    res = null;
+    req = null;
+    server;
+    protocol = 'http';
     /*
      *  @ip: string，用户IP
      *  @cookie: string，会话cookie
      *  @query: string，请求字符串
      */
-    constructor(ip, cookie, platform, query) {
+    constructor(ip, cookie, server, req, res, query) {
         this.ip = ip;
         this.cookie = cookie;
         this.query = query;
-        this.platform = platform;
+        this.server = server;
+        this.req = req;
+        this.res = res;
         this.head['Content-Type'] = 'text/plain';
         if (cookie.sessionid) {
             this.sessionid = cookie.sessionid;
@@ -102,10 +107,10 @@ class Session {
         }
     }
     send(data) {
-        return this.platform.sendMessage(this, data);
+        return this.res.send(data);
     }
     endsession(message) {
-        return this.platform.terminationSession(this, message);
+        return this.res.end(message);
     }
 }
 exports.Session = Session;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yumerijs/core",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Core module for yumeri",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -33,7 +33,6 @@
   "dependencies": {
     "@yumerijs/loader": "^1.2.0",
     "chokidar": "^4.0.3",
-    "js-sha256": "^0.11.0",
     "js-yaml": "^4.1.0",
     "picocolors": "^1.1.1"
   },