@kevisual/router 0.2.5 → 0.2.6

package/dist/router.d.ts

@@ -22,7 +22,7 @@ declare class CustomError extends Error {
     static fromCode(code?: number): CustomError;
     static fromErrorData(code?: number, data?: any): CustomError;
     static parseError(e: CustomError): {
-        code: number | undefined;
+        code: number;
         data: any;
         message: string;
     };
@@ -36,7 +36,7 @@ declare class CustomError extends Error {
     static throw(code?: number | string, opts?: CustomErrorOptions): void;
     static throw(opts?: CustomErrorOptions): void;
     parse(e?: CustomError): {
-        code: number | undefined;
+        code: number;
         data: any;
         message: string;
     };
@@ -59,22 +59,6 @@ declare class MockProcess {
     on(fn: (msg?: any) => any): void;
     desctroy(): void;
 }
-type ListenProcessParams = {
-    message?: RunMessage;
-    context?: any;
-};
-type ListenProcessResponse = {
-    success?: boolean;
-    data?: {
-        code?: number;
-        data?: any;
-        message?: string;
-        [key: string]: any;
-    };
-    error?: any;
-    timestamp?: string;
-    [key: string]: any;
-};
 
 type RouterContextT = {
     code?: number;
@@ -232,7 +216,7 @@ declare class Route<M extends SimpleObject$1 = SimpleObject$1, U extends SimpleO
     description?: string;
     metadata?: M;
     middleware?: RouteMiddleware[];
-    type?: string | undefined;
+    type?: string;
     /**
      * 是否开启debug，开启后会打印错误信息
      */
@@ -325,6 +309,7 @@ declare class QueryRouter<T extends SimpleObject$1 = SimpleObject$1> implements
         path: string;
         key?: string;
         payload?: any;
+        args?: any;
     }, ctx?: RouteContext<T> & {
         [key: string]: any;
     }): Promise<RouteContext<T, {}, {
@@ -341,13 +326,14 @@ declare class QueryRouter<T extends SimpleObject$1 = SimpleObject$1> implements
         path?: string;
         key?: string;
         payload?: any;
+        args?: any;
     }, ctx?: RouteContext<T> & {
         [key: string]: any;
     }): Promise<RouteContext<T, {}, {
         [key: string]: any;
     }> | {
         code: number;
-        body: null;
+        body: any;
         message: string;
     }>;
     /**
@@ -362,12 +348,13 @@ declare class QueryRouter<T extends SimpleObject$1 = SimpleObject$1> implements
         path: string;
         key?: string;
         payload?: any;
+        args?: any;
     }, ctx?: RouteContext & {
         [key: string]: any;
     }): Promise<{
-        code: number | undefined;
-        data: string | number | Object | null | undefined;
-        message: string | undefined;
+        code: number;
+        data: any;
+        message: string;
     }>;
     /**
      * Router Run获取数据
@@ -380,12 +367,13 @@ declare class QueryRouter<T extends SimpleObject$1 = SimpleObject$1> implements
         path?: string;
         key?: string;
         payload?: any;
+        args?: any;
     }, ctx?: RouteContext<T> & {
         [key: string]: any;
     }): Promise<{
-        code: number | undefined;
-        data: string | number | Object | null | undefined;
-        message: string | undefined;
+        code: number;
+        data: any;
+        message: string;
     }>;
     /**
      * 设置上下文
@@ -420,12 +408,12 @@ declare class QueryRouter<T extends SimpleObject$1 = SimpleObject$1> implements
     importRoutes(routes: Route[]): void;
     importRouter(router: QueryRouter): void;
     throw(...args: any[]): void;
-    hasRoute(path: string, key?: string): Route<SimpleObject$1, SimpleObject$1> | undefined;
+    hasRoute(path: string, key?: string): Route<SimpleObject$1, SimpleObject$1>;
     findRoute(opts?: {
         path?: string;
         key?: string;
         rid?: string;
-    }): Route<SimpleObject$1, SimpleObject$1> | undefined;
+    }): Route<SimpleObject$1, SimpleObject$1>;
     createRouteList(opts?: {
         force?: boolean;
         filter?: (route: Route) => boolean;
@@ -519,6 +507,7 @@ declare class QueryRouterServer<C extends SimpleObject$1 = SimpleObject$1> exten
         path?: string;
         key?: string;
         payload?: any;
+        args?: any;
         token?: string;
         data?: any;
     }, ctx?: Partial<RouteContext<C>>): Promise<any>;
@@ -534,7 +523,9 @@ declare class QueryRouterServer<C extends SimpleObject$1 = SimpleObject$1> exten
      * 创建认证相关的中间件，默认是 auth, auth-admin, auth-can 三个中间件
      * @param fun 认证函数，接收 RouteContext 和认证类型
      */
-    createAuth(fun: (ctx: RouteContext<C>, type?: 'auth' | 'auth-admin' | 'auth-can') => any): Promise<void>;
+    createAuth(fun?: (ctx: RouteContext<C>, type?: 'auth' | 'auth-admin' | 'auth-can') => any, opts?: {
+        overwrite?: boolean;
+    }): Promise<void>;
 }
 declare class Mini extends QueryRouterServer {
 }
@@ -628,8 +619,8 @@ declare class Chain {
     object: RouteOpts;
     app?: QueryRouterServer;
     constructor(object: RouteOpts, opts?: ChainOptions);
-    get key(): string | undefined;
-    get path(): string | undefined;
+    get key(): string;
+    get path(): string;
     setDescription(desc: string): this;
     setMeta(metadata: {
         [key: string]: any;
@@ -1031,7 +1022,10 @@ declare class ServerNode extends ServerBase implements ServerType {
  * @param res
  * @returns
  */
-declare const handleServer: (req: IncomingMessage, res: ServerResponse) => Promise<any>;
+declare const handleServer: (req: IncomingMessage, res: ServerResponse) => Promise<{
+    cookies: Record<string, string>;
+    token: string;
+}>;
 
 type RouterHandle = (msg: {
     path: string;
@@ -1073,9 +1067,12 @@ declare class App<U = {}> extends QueryRouterServer<AppRouteContext<U>> {
     listen(handle: any, backlog?: number, listeningListener?: () => void): void;
     listen(handle: any, listeningListener?: () => void): void;
     Route: typeof Route;
-    static handleRequest(req: IncomingMessage$1, res: ServerResponse$1): Promise<any>;
+    static handleRequest(req: IncomingMessage$1, res: ServerResponse$1): Promise<{
+        cookies: Record<string, string>;
+        token: string;
+    }>;
     onServerRequest(fn: (req: IncomingMessage$1, res: ServerResponse$1) => void): void;
 }
 
-export { App, CustomError, Mini, MockProcess, QueryRouter, QueryRouterServer, QueryUtil, Route, ServerNode, createSchema, createSkill, define, fromJSONSchema, handleServer, toJSONSchema, tool, util };
-export type { HttpListenerFun, ListenProcessParams, ListenProcessResponse, Listener, OnListener, OnWebSocketFn, RouteArray, RouteContext, RouteInfo, RouteMiddleware, RouteObject, RouteOpts, RouterReq, RouterRes, Rule, Run, Schema, Skill, WS, WebSocketListenerFun, WebSocketReq, WebSocketRes };
+export { App, CustomError, Mini, QueryRouter, QueryRouterServer, QueryUtil, Route, ServerNode, createSchema, createSkill, define, fromJSONSchema, handleServer, toJSONSchema, tool, util };
+export type { HttpListenerFun, Listener, OnListener, OnWebSocketFn, RouteArray, RouteContext, RouteInfo, RouteMiddleware, RouteObject, RouteOpts, RouterReq, RouterRes, Rule, Run, Schema, Skill, WS, WebSocketListenerFun, WebSocketReq, WebSocketRes };

package/dist/router.js

@@ -3691,7 +3691,7 @@ var listenProcess = async ({ app, mockProcess, params = {}, timeout: timeout2 =
     const ctx = mergeParams?.context || {};
     if (!msg.path && !msg.id) {
       const route = app.routes.find((r) => r.path !== "router");
-      msg.id = route?.id;
+      msg.id = route?.rid;
     }
     const result = await app.run(msg, ctx);
     const response = {
@@ -17704,9 +17704,9 @@ class QueryRouter {
     if (!message?.path) {
       return Promise.resolve({ code: 404, body: null, message: "Not found path" });
     }
-    const { path, key = "", payload = {}, ...query } = message;
+    const { path, key = "", payload = {}, args = {}, ...query } = message;
     ctx = ctx || {};
-    ctx.query = { ...ctx.query, ...query, ...payload };
+    ctx.query = { ...ctx.query, ...query, ...payload, ...args };
     ctx.args = ctx.query;
     ctx.state = { ...ctx?.state };
     ctx.throw = this.throw;
@@ -17916,7 +17916,8 @@ class QueryRouterServer extends QueryRouter {
     const { path, key, rid } = api2;
     return this.run({ path, key, rid, payload }, ctx);
   }
-  async createAuth(fun) {
+  async createAuth(fun, opts) {
+    const overwrite = opts?.overwrite ?? false;
     this.route({
       path: "auth",
       key: "auth",
@@ -17926,7 +17927,7 @@ class QueryRouterServer extends QueryRouter {
       if (fun) {
         await fun(ctx, "auth");
       }
-    }).addTo(this, { overwrite: false });
+    }).addTo(this, { overwrite });
     this.route({
       path: "auth-admin",
       key: "auth-admin",
@@ -17937,7 +17938,7 @@ class QueryRouterServer extends QueryRouter {
       if (fun) {
         await fun(ctx, "auth-admin");
       }
-    }).addTo(this, { overwrite: false });
+    }).addTo(this, { overwrite });
     this.route({
       path: "auth-can",
       key: "auth-can",
@@ -17947,7 +17948,7 @@ class QueryRouterServer extends QueryRouter {
       if (fun) {
         await fun(ctx, "auth-can");
       }
-    }).addTo(this, { overwrite: false });
+    }).addTo(this, { overwrite });
   }
 }
 
@@ -19085,7 +19086,6 @@ export {
   QueryUtil,
   QueryRouterServer,
   QueryRouter,
-  MockProcess,
   Mini,
   CustomError,
   App

package/dist/ws.d.ts

@@ -218,7 +218,7 @@ declare class Route<M extends SimpleObject = SimpleObject, U extends SimpleObjec
     description?: string;
     metadata?: M;
     middleware?: RouteMiddleware[];
-    type?: string | undefined;
+    type?: string;
     /**
      * 是否开启debug，开启后会打印错误信息
      */
@@ -294,6 +294,7 @@ declare class QueryRouter<T extends SimpleObject = SimpleObject> implements thro
         path: string;
         key?: string;
         payload?: any;
+        args?: any;
     }, ctx?: RouteContext<T> & {
         [key: string]: any;
     }): Promise<RouteContext<T, {}, {
@@ -310,13 +311,14 @@ declare class QueryRouter<T extends SimpleObject = SimpleObject> implements thro
         path?: string;
         key?: string;
         payload?: any;
+        args?: any;
     }, ctx?: RouteContext<T> & {
         [key: string]: any;
     }): Promise<RouteContext<T, {}, {
         [key: string]: any;
     }> | {
         code: number;
-        body: null;
+        body: any;
         message: string;
     }>;
     /**
@@ -331,12 +333,13 @@ declare class QueryRouter<T extends SimpleObject = SimpleObject> implements thro
         path: string;
         key?: string;
         payload?: any;
+        args?: any;
     }, ctx?: RouteContext & {
         [key: string]: any;
     }): Promise<{
-        code: number | undefined;
-        data: string | number | Object | null | undefined;
-        message: string | undefined;
+        code: number;
+        data: any;
+        message: string;
     }>;
     /**
      * Router Run获取数据
@@ -349,12 +352,13 @@ declare class QueryRouter<T extends SimpleObject = SimpleObject> implements thro
         path?: string;
         key?: string;
         payload?: any;
+        args?: any;
     }, ctx?: RouteContext<T> & {
         [key: string]: any;
     }): Promise<{
-        code: number | undefined;
-        data: string | number | Object | null | undefined;
-        message: string | undefined;
+        code: number;
+        data: any;
+        message: string;
     }>;
     /**
      * 设置上下文
@@ -389,12 +393,12 @@ declare class QueryRouter<T extends SimpleObject = SimpleObject> implements thro
     importRoutes(routes: Route[]): void;
     importRouter(router: QueryRouter): void;
     throw(...args: any[]): void;
-    hasRoute(path: string, key?: string): Route<SimpleObject, SimpleObject> | undefined;
+    hasRoute(path: string, key?: string): Route<SimpleObject, SimpleObject>;
     findRoute(opts?: {
         path?: string;
         key?: string;
         rid?: string;
-    }): Route<SimpleObject, SimpleObject> | undefined;
+    }): Route<SimpleObject, SimpleObject>;
     createRouteList(opts?: {
         force?: boolean;
         filter?: (route: Route) => boolean;
@@ -488,6 +492,7 @@ declare class QueryRouterServer<C extends SimpleObject = SimpleObject> extends Q
         path?: string;
         key?: string;
         payload?: any;
+        args?: any;
         token?: string;
         data?: any;
     }, ctx?: Partial<RouteContext<C>>): Promise<any>;
@@ -503,7 +508,9 @@ declare class QueryRouterServer<C extends SimpleObject = SimpleObject> extends Q
      * 创建认证相关的中间件，默认是 auth, auth-admin, auth-can 三个中间件
      * @param fun 认证函数，接收 RouteContext 和认证类型
      */
-    createAuth(fun: (ctx: RouteContext<C>, type?: 'auth' | 'auth-admin' | 'auth-can') => any): Promise<void>;
+    createAuth(fun?: (ctx: RouteContext<C>, type?: 'auth' | 'auth-admin' | 'auth-can') => any, opts?: {
+        overwrite?: boolean;
+    }): Promise<void>;
 }
 /** JSON Schema 基本类型映射到 TypeScript 类型 */
 type JsonSchemaTypeToTS<T> = T extends {
@@ -838,7 +845,10 @@ declare class App<U = {}> extends QueryRouterServer<AppRouteContext<U>> {
     listen(handle: any, backlog?: number, listeningListener?: () => void): void;
     listen(handle: any, listeningListener?: () => void): void;
     Route: typeof Route;
-    static handleRequest(req: IncomingMessage$1, res: ServerResponse$1): Promise<any>;
+    static handleRequest(req: IncomingMessage$1, res: ServerResponse$1): Promise<{
+        cookies: Record<string, string>;
+        token: string;
+    }>;
     onServerRequest(fn: (req: IncomingMessage$1, res: ServerResponse$1) => void): void;
 }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@kevisual/router",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "",
   "type": "module",
   "main": "./dist/router.js",
@@ -22,18 +22,18 @@
   "author": "abearxiong",
   "license": "MIT",
   "devDependencies": {
-    "@kevisual/code-builder": "^0.0.6",
-    "@kevisual/context": "^0.0.8",
+    "@kevisual/code-builder": "^0.0.7",
+    "@kevisual/context": "^0.0.10",
     "@kevisual/dts": "^0.0.4",
     "@kevisual/js-filter": "^0.0.6",
     "@kevisual/local-proxy": "^0.0.8",
     "@kevisual/query": "^0.0.55",
     "@kevisual/remote-app": "^0.0.7",
     "@kevisual/use-config": "^1.0.30",
-    "@opencode-ai/plugin": "^1.3.2",
-    "@types/bun": "^1.3.11",
+    "@opencode-ai/plugin": "^1.4.6",
+    "@types/bun": "^1.3.12",
     "@types/crypto-js": "^4.2.2",
-    "@types/node": "^25.5.0",
+    "@types/node": "^25.6.0",
     "@types/send": "^1.2.1",
     "@types/ws": "^8.18.1",
     "@types/xml2js": "^0.4.14",
@@ -43,7 +43,7 @@
     "eventemitter3": "^5.0.4",
     "fast-glob": "^3.3.3",
     "nanoid": "^5.1.7",
-    "path-to-regexp": "^8.3.0",
+    "path-to-regexp": "^8.4.2",
     "send": "^1.2.1",
     "typescript": "^6.0.2",
     "ws": "npm:@kevisual/ws",

package/src/auto/listen/server-time.ts

@@ -23,7 +23,7 @@ export class ServerTimer {
         clearInterval(that.timer);
         that.timer = null;
       }
-    }, that.interval);
+    }, that.interval).unref?.();
   }
 
   run(): number {

package/src/browser.ts

@@ -13,6 +13,4 @@ export { createSkill, tool, fromJSONSchema, toJSONSchema } from './route.ts';
 export { CustomError } from './result/error.ts';
 
 export * from './router-define.ts';
-
-export { MockProcess, type ListenProcessParams, type ListenProcessResponse } from './utils/listen-process.ts'
 // --- 以上同步更新至 browser.ts ---

package/src/commander.ts

@@ -2,6 +2,7 @@ import { Command, program } from 'commander';
 import { App } from './app.ts';
 import { RemoteApp } from '@kevisual/remote-app'
 import z from 'zod';
+import { create } from 'node:domain';
 export const groupByPath = (routes: App['routes']) => {
   return routes.reduce((acc, route) => {
     const path = route.path || 'default';
@@ -68,7 +69,7 @@ export const parseDescription = (route: App['routes'][number]) => {
   }
   return desc;
 }
-export const createCommand = (opts: { app: any, program: Command }) => {
+export const createCommandList = (opts: { app: any, program: Command }) => {
   const { program } = opts;
   const app = opts.app as App;
   const routes = app.routes;
@@ -76,45 +77,53 @@ export const createCommand = (opts: { app: any, program: Command }) => {
   const groupRoutes = groupByPath(routes);
   for (const path in groupRoutes) {
     const routeList = groupRoutes[path];
-    const keys = routeList.map(route => route.key).filter(Boolean);
+    if (!routeList) continue;
+    const keys = routeList.map(route => route.key)
     const subProgram = program.command(path).description(`路由[${path}] ${keys.length > 0 ? ': ' + keys.join(', ') : ''}`);
     routeList.forEach(route => {
-      if (!route.key) return;
       const description = parseDescription(route);
-      subProgram.command(route.key)
-        .description(description || '')
-        .option('--args <args>', '命令参数，支持 JSON 格式或 key=value 形式，例如: --args \'{"a":1}\' 或 --args \'a=1 b=2\'')
-        .argument('[args...]', '位置参数（推荐通过 -- 分隔传入），支持 JSON 或 key=value 格式，例如: -- a=1 b=2 或 -- \'{"a":1}\'')
-        .action(async (passedArgs: string[], options, _command) => {
-          const output = (data: any) => {
-            if (typeof data === 'object') {
-              process.stdout.write(JSON.stringify(data, null, 2) + '\n');
-            } else {
-              process.stdout.write(String(data) + '\n');
-            }
-          }
-          try {
-            let args: Record<string, any> = {};
-            if (options.args) {
-              args = parseArgs(options.args);
-            } else if (passedArgs.length > 0) {
-              args = parseArgs(passedArgs.join(' '));
-            }
-            // 这里可以添加实际的命令执行逻辑，例如调用对应的路由处理函数
-            const res = await app.run({ path, key: route.key, payload: args }, { appId: app.appId });
-            if (res.code === 200) {
-              output(res.data);
-            } else {
-              output(`Error: ${res.message}`);
-            }
-          } catch (error) {
-            output(`Execution error: ${error instanceof Error ? error.message : String(error)}`);
-          }
-        });
+      if (!route.key) {
+        createCommand(subProgram, { description, app, route });
+        return;
+      }
+      const _sumCommandy = subProgram.command(route.key)
+      createCommand(_sumCommandy, { description, app, route });
     });
   }
 }
-
+export const createCommand = (command: Command, opts: { description?: string, app: App, route: any }) => {
+  const { description, app, route } = opts;
+  const path = route.path;
+  command.description(description || '')
+    .option('--args <args>', '命令参数，支持 JSON 格式或 key=value 形式，例如: --args \'{"a":1}\' 或 --args \'a=1 b=2\'')
+    .argument('[args...]', '位置参数（推荐通过 -- 分隔传入），支持 JSON 或 key=value 格式，例如: -- a=1 b=2 或 -- \'{"a":1}\'')
+    .action(async (passedArgs: string[], options, _command) => {
+      const output = (data: any) => {
+        if (typeof data === 'object') {
+          process.stdout.write(JSON.stringify(data, null, 2) + '\n');
+        } else {
+          process.stdout.write(String(data) + '\n');
+        }
+      }
+      try {
+        let args: Record<string, any> = {};
+        if (options.args) {
+          args = parseArgs(options.args);
+        } else if (passedArgs.length > 0) {
+          args = parseArgs(passedArgs.join(' '));
+        }
+        // 这里可以添加实际的命令执行逻辑，例如调用对应的路由处理函数
+        const res = await app.run({ path, key: route.key, payload: args }, { appId: app.appId });
+        if (res.code === 200) {
+          output(res.data);
+        } else {
+          output(`Error: ${res.message}`);
+        }
+      } catch (error) {
+        output(`Execution error: ${error instanceof Error ? error.message : String(error)}`);
+      }
+    });
+}
 export const parse = async (opts: {
   app: any,
   description?: string,
@@ -130,7 +139,7 @@ export const parse = async (opts: {
   },
   exitOnEnd?: boolean,
 }) => {
-  const { description, parse = true, version, exitOnEnd = true } = opts;
+  const { description, parse = true, version, exitOnEnd = false } = opts;
   const app = opts.app as App;
   const _program = opts.program || program;
   _program.description(description || 'Router 命令行工具');
@@ -140,10 +149,10 @@ export const parse = async (opts: {
   app.createRouteList();
 
   createCliList(app);
-  createCommand({ app: app as App, program: _program });
+  createCommandList({ app: app as App, program: _program });
 
   if (opts.remote) {
-    const { token, username, id , url } = opts.remote;
+    const { token, username, id, url } = opts.remote;
     const remoteApp = new RemoteApp({
       app,
       token,

package/src/index.ts

@@ -13,8 +13,6 @@ export { createSkill, tool, fromJSONSchema, toJSONSchema } from './route.ts';
 export { CustomError } from './result/error.ts';
 
 export * from './router-define.ts';
-
-export { MockProcess, type ListenProcessParams, type ListenProcessResponse } from './utils/listen-process.ts'
 // --- 以上同步更新至 browser.ts ---
 
 export { ServerNode, handleServer } from './server/index.ts';

package/src/route.ts

@@ -490,13 +490,13 @@ export class QueryRouter<T extends SimpleObject = SimpleObject> implements throw
    * @param ctx
    * @returns
    */
-  async parse(message: { path: string; key?: string; payload?: any }, ctx?: RouteContext<T> & { [key: string]: any }) {
+  async parse(message: { path: string; key?: string; payload?: any, args?: any }, ctx?: RouteContext<T> & { [key: string]: any }) {
     if (!message?.path) {
       return Promise.resolve({ code: 404, body: null, message: 'Not found path' } as RouteContext<T>);
     }
-    const { path, key = '', payload = {}, ...query } = message;
+    const { path, key = '', payload = {}, args = {}, ...query } = message;
     ctx = ctx || {} as RouteContext<T>;
-    ctx.query = { ...ctx.query, ...query, ...payload };
+    ctx.query = { ...ctx.query, ...query, ...payload, ...args };
     ctx.args = ctx.query;
     ctx.state = { ...ctx?.state };
     ctx.throw = this.throw;
@@ -529,7 +529,7 @@ export class QueryRouter<T extends SimpleObject = SimpleObject> implements throw
    * @param ctx
    * @returns
    */
-  async call(message: { rid?: string; path?: string; key?: string; payload?: any }, ctx?: RouteContext<T> & { [key: string]: any }) {
+  async call(message: { rid?: string; path?: string; key?: string; payload?: any, args?: any }, ctx?: RouteContext<T> & { [key: string]: any }) {
     let path = message.path;
     let key = message.key;
     // 优先 path + key
@@ -556,7 +556,7 @@ export class QueryRouter<T extends SimpleObject = SimpleObject> implements throw
    * @deprecated use run or call instead
    * @returns
    */
-  async queryRoute(message: { id?: string; path: string; key?: string; payload?: any }, ctx?: RouteContext & { [key: string]: any }) {
+  async queryRoute(message: { id?: string; path: string; key?: string; payload?: any, args?: any }, ctx?: RouteContext & { [key: string]: any }) {
     const res = await this.call(message, { ...this.context, ...ctx });
     return {
       code: res.code,
@@ -570,7 +570,7 @@ export class QueryRouter<T extends SimpleObject = SimpleObject> implements throw
    * @param ctx 
    * @returns 
    */
-  async run(message: { id?: string; path?: string; key?: string; payload?: any }, ctx?: RouteContext<T> & { [key: string]: any }) {
+  async run(message: { id?: string; path?: string; key?: string; payload?: any, args?: any }, ctx?: RouteContext<T> & { [key: string]: any }) {
     const res = await this.call(message, { ...this.context, ...ctx });
     return {
       code: res.code,
@@ -766,7 +766,7 @@ export class QueryRouterServer<C extends SimpleObject = SimpleObject> extends Qu
    * @param param0
    * @returns
    */
-  async run(msg: { rid?: string; path?: string; key?: string; payload?: any, token?: string, data?: any }, ctx?: Partial<RouteContext<C>>) {
+  async run(msg: { rid?: string; path?: string; key?: string; payload?: any, args?: any, token?: string, data?: any }, ctx?: Partial<RouteContext<C>>) {
     const handle = this.handle;
     if (handle) {
       return handle(msg, ctx);
@@ -786,7 +786,8 @@ export class QueryRouterServer<C extends SimpleObject = SimpleObject> extends Qu
    * 创建认证相关的中间件，默认是 auth, auth-admin, auth-can 三个中间件
    * @param fun 认证函数，接收 RouteContext 和认证类型
    */
-  async createAuth(fun: (ctx: RouteContext<C>, type?: 'auth' | 'auth-admin' | 'auth-can') => any) {
+  async createAuth(fun?: (ctx: RouteContext<C>, type?: 'auth' | 'auth-admin' | 'auth-can') => any, opts?: { overwrite?: boolean }) {
+    const overwrite = opts?.overwrite ?? false;
     this.route({
       path: 'auth',
       key: 'auth',
@@ -796,7 +797,7 @@ export class QueryRouterServer<C extends SimpleObject = SimpleObject> extends Qu
       if (fun) {
         await fun(ctx, 'auth');
       }
-    }).addTo(this, { overwrite: false });
+    }).addTo(this, { overwrite: overwrite });
 
     this.route({
       path: 'auth-admin',
@@ -808,7 +809,7 @@ export class QueryRouterServer<C extends SimpleObject = SimpleObject> extends Qu
       if (fun) {
         await fun(ctx, 'auth-admin');
       }
-    }).addTo(this, { overwrite: false });
+    }).addTo(this, { overwrite: overwrite });
 
     this.route({
       path: 'auth-can',
@@ -819,7 +820,7 @@ export class QueryRouterServer<C extends SimpleObject = SimpleObject> extends Qu
       if (fun) {
         await fun(ctx, 'auth-can');
       }
-    }).addTo(this, { overwrite: false });
+    }).addTo(this, { overwrite: overwrite });
   }
 }
 

package/src/router-simple.ts

@@ -277,7 +277,7 @@ export class HttpChain {
       // 每隔 2 秒发送一个空行，保持连接
       setInterval(() => {
         res.write('\n'); // 发送一个空行，保持连接
-      }, 3000);
+      }, 3000).unref?.();
       // 客户端断开连接时清理
       req.on('close', () => {
         clearInterval(intervalId);