@kevisual/router 0.2.4 → 0.2.6

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/dist/ws.js

@@ -32,7 +32,7 @@ var __toESM = (mod, isNodeMode, target) => {
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
-// node_modules/ws/lib/constants.js
+// ../../node_modules/.pnpm/@kevisual+ws@8.19.0/node_modules/@kevisual/ws/lib/constants.js
 var require_constants = __commonJS((exports, module) => {
   var BINARY_TYPES = ["nodebuffer", "arraybuffer", "fragments"];
   var hasBlob = typeof Blob !== "undefined";
@@ -40,6 +40,7 @@ var require_constants = __commonJS((exports, module) => {
     BINARY_TYPES.push("blob");
   module.exports = {
     BINARY_TYPES,
+    CLOSE_TIMEOUT: 30000,
     EMPTY_BUFFER: Buffer.alloc(0),
     GUID: "258EAFA5-E914-47DA-95CA-C5AB0DC85B11",
     hasBlob,
@@ -51,7 +52,7 @@ var require_constants = __commonJS((exports, module) => {
   };
 });
 
-// node_modules/ws/lib/buffer-util.js
+// ../../node_modules/.pnpm/@kevisual+ws@8.19.0/node_modules/@kevisual/ws/lib/buffer-util.js
 var require_buffer_util = __commonJS((exports, module) => {
   var { EMPTY_BUFFER } = require_constants();
   var FastBuffer = Buffer[Symbol.species];
@@ -112,7 +113,7 @@ var require_buffer_util = __commonJS((exports, module) => {
   };
 });
 
-// node_modules/ws/lib/limiter.js
+// ../../node_modules/.pnpm/@kevisual+ws@8.19.0/node_modules/@kevisual/ws/lib/limiter.js
 var require_limiter = __commonJS((exports, module) => {
   var kDone = Symbol("kDone");
   var kRun = Symbol("kRun");
@@ -144,7 +145,7 @@ var require_limiter = __commonJS((exports, module) => {
   module.exports = Limiter;
 });
 
-// node_modules/ws/lib/permessage-deflate.js
+// ../../node_modules/.pnpm/@kevisual+ws@8.19.0/node_modules/@kevisual/ws/lib/permessage-deflate.js
 var require_permessage_deflate = __commonJS((exports, module) => {
   var zlib = __require("zlib");
   var bufferUtil = require_buffer_util();
@@ -399,12 +400,16 @@ var require_permessage_deflate = __commonJS((exports, module) => {
   }
   function inflateOnError(err) {
     this[kPerMessageDeflate]._inflate = null;
+    if (this[kError]) {
+      this[kCallback](this[kError]);
+      return;
+    }
     err[kStatusCode] = 1007;
     this[kCallback](err);
   }
 });
 
-// node_modules/ws/lib/validation.js
+// ../../node_modules/.pnpm/@kevisual+ws@8.19.0/node_modules/@kevisual/ws/lib/validation.js
 var require_validation = __commonJS((exports, module) => {
   var { isUtf8 } = __require("buffer");
   var { hasBlob } = require_constants();
@@ -584,7 +589,7 @@ var require_validation = __commonJS((exports, module) => {
   }
 });
 
-// node_modules/ws/lib/receiver.js
+// ../../node_modules/.pnpm/@kevisual+ws@8.19.0/node_modules/@kevisual/ws/lib/receiver.js
 var require_receiver = __commonJS((exports, module) => {
   var { Writable } = __require("stream");
   var PerMessageDeflate = require_permessage_deflate();
@@ -965,7 +970,7 @@ var require_receiver = __commonJS((exports, module) => {
   module.exports = Receiver;
 });
 
-// node_modules/ws/lib/sender.js
+// ../../node_modules/.pnpm/@kevisual+ws@8.19.0/node_modules/@kevisual/ws/lib/sender.js
 var require_sender = __commonJS((exports, module) => {
   var { Duplex } = __require("stream");
   var { randomFillSync } = __require("crypto");
@@ -1319,7 +1324,7 @@ var require_sender = __commonJS((exports, module) => {
   }
 });
 
-// node_modules/ws/lib/event-target.js
+// ../../node_modules/.pnpm/@kevisual+ws@8.19.0/node_modules/@kevisual/ws/lib/event-target.js
 var require_event_target = __commonJS((exports, module) => {
   var { kForOnEventAttribute, kListener } = require_constants();
   var kCode = Symbol("kCode");
@@ -1470,7 +1475,7 @@ var require_event_target = __commonJS((exports, module) => {
   }
 });
 
-// node_modules/ws/lib/extension.js
+// ../../node_modules/.pnpm/@kevisual+ws@8.19.0/node_modules/@kevisual/ws/lib/extension.js
 var require_extension = __commonJS((exports, module) => {
   var { tokenChars } = require_validation();
   function push(dest, name, elem) {
@@ -1635,7 +1640,7 @@ var require_extension = __commonJS((exports, module) => {
   module.exports = { format, parse };
 });
 
-// node_modules/ws/lib/websocket.js
+// ../../node_modules/.pnpm/@kevisual+ws@8.19.0/node_modules/@kevisual/ws/lib/websocket.js
 var require_websocket = __commonJS((exports, module) => {
   var EventEmitter = __require("events");
   var https = __require("https");
@@ -1651,6 +1656,7 @@ var require_websocket = __commonJS((exports, module) => {
   var { isBlob } = require_validation();
   var {
     BINARY_TYPES,
+    CLOSE_TIMEOUT,
     EMPTY_BUFFER,
     GUID,
     kForOnEventAttribute,
@@ -1664,7 +1670,6 @@ var require_websocket = __commonJS((exports, module) => {
   } = require_event_target();
   var { format, parse } = require_extension();
   var { toBuffer } = require_buffer_util();
-  var closeTimeout = 30 * 1000;
   var kAborted = Symbol("kAborted");
   var protocolVersions = [8, 13];
   var readyStates = ["CONNECTING", "OPEN", "CLOSING", "CLOSED"];
@@ -1704,6 +1709,7 @@ var require_websocket = __commonJS((exports, module) => {
         initAsClient(this, address, protocols, options);
       } else {
         this._autoPong = options.autoPong;
+        this._closeTimeout = options.closeTimeout;
         this._isServer = true;
       }
     }
@@ -1995,6 +2001,7 @@ var require_websocket = __commonJS((exports, module) => {
     const opts = {
       allowSynchronousEvents: true,
       autoPong: true,
+      closeTimeout: CLOSE_TIMEOUT,
       protocolVersion: protocolVersions[1],
       maxPayload: 100 * 1024 * 1024,
       skipUTF8Validation: false,
@@ -2012,6 +2019,7 @@ var require_websocket = __commonJS((exports, module) => {
       port: undefined
     };
     websocket._autoPong = opts.autoPong;
+    websocket._closeTimeout = opts.closeTimeout;
     if (!protocolVersions.includes(opts.protocolVersion)) {
       throw new RangeError(`Unsupported protocol version: ${opts.protocolVersion} ` + `(supported versions: ${protocolVersions.join(", ")})`);
     }
@@ -2350,7 +2358,7 @@ var require_websocket = __commonJS((exports, module) => {
     }
   }
   function setCloseTimer(websocket) {
-    websocket._closeTimer = setTimeout(websocket._socket.destroy.bind(websocket._socket), closeTimeout);
+    websocket._closeTimer = setTimeout(websocket._socket.destroy.bind(websocket._socket), websocket._closeTimeout);
   }
   function socketOnClose() {
     const websocket = this[kWebSocket];
@@ -2358,8 +2366,8 @@ var require_websocket = __commonJS((exports, module) => {
     this.removeListener("data", socketOnData);
     this.removeListener("end", socketOnEnd);
     websocket._readyState = WebSocket.CLOSING;
-    let chunk;
-    if (!this._readableState.endEmitted && !websocket._closeFrameReceived && !websocket._receiver._writableState.errorEmitted && (chunk = websocket._socket.read()) !== null) {
+    if (!this._readableState.endEmitted && !websocket._closeFrameReceived && !websocket._receiver._writableState.errorEmitted && this._readableState.length !== 0) {
+      const chunk = this.read(this._readableState.length);
       websocket._receiver.write(chunk);
     }
     websocket._receiver.end();
@@ -2394,7 +2402,7 @@ var require_websocket = __commonJS((exports, module) => {
   }
 });
 
-// node_modules/ws/lib/stream.js
+// ../../node_modules/.pnpm/@kevisual+ws@8.19.0/node_modules/@kevisual/ws/lib/stream.js
 var require_stream = __commonJS((exports, module) => {
   var WebSocket = require_websocket();
   var { Duplex } = __require("stream");
@@ -2497,7 +2505,7 @@ var require_stream = __commonJS((exports, module) => {
   module.exports = createWebSocketStream;
 });
 
-// node_modules/ws/lib/subprotocol.js
+// ../../node_modules/.pnpm/@kevisual+ws@8.19.0/node_modules/@kevisual/ws/lib/subprotocol.js
 var require_subprotocol = __commonJS((exports, module) => {
   var { tokenChars } = require_validation();
   function parse(header) {
@@ -2542,7 +2550,7 @@ var require_subprotocol = __commonJS((exports, module) => {
   module.exports = { parse };
 });
 
-// node_modules/ws/lib/websocket-server.js
+// ../../node_modules/.pnpm/@kevisual+ws@8.19.0/node_modules/@kevisual/ws/lib/websocket-server.js
 var require_websocket_server = __commonJS((exports, module) => {
   var EventEmitter = __require("events");
   var http = __require("http");
@@ -2552,7 +2560,7 @@ var require_websocket_server = __commonJS((exports, module) => {
   var PerMessageDeflate = require_permessage_deflate();
   var subprotocol = require_subprotocol();
   var WebSocket = require_websocket();
-  var { GUID, kWebSocket } = require_constants();
+  var { CLOSE_TIMEOUT, GUID, kWebSocket } = require_constants();
   var keyRegex = /^[+/0-9A-Za-z]{22}==$/;
   var RUNNING = 0;
   var CLOSING = 1;
@@ -2569,6 +2577,7 @@ var require_websocket_server = __commonJS((exports, module) => {
         perMessageDeflate: false,
         handleProtocols: null,
         clientTracking: true,
+        closeTimeout: CLOSE_TIMEOUT,
         verifyClient: null,
         noServer: false,
         backlog: null,
@@ -2689,9 +2698,11 @@ var require_websocket_server = __commonJS((exports, module) => {
         abortHandshakeOrEmitwsClientError(this, req, socket, 400, message);
         return;
       }
-      if (version !== 8 && version !== 13) {
+      if (version !== 13 && version !== 8) {
         const message = "Missing or invalid Sec-WebSocket-Version header";
-        abortHandshakeOrEmitwsClientError(this, req, socket, 400, message);
+        abortHandshakeOrEmitwsClientError(this, req, socket, 400, message, {
+          "Sec-WebSocket-Version": "13, 8"
+        });
         return;
       }
       if (!this.shouldHandle(req)) {
@@ -2830,18 +2841,18 @@ var require_websocket_server = __commonJS((exports, module) => {
 \r
 ` + message);
   }
-  function abortHandshakeOrEmitwsClientError(server, req, socket, code, message) {
+  function abortHandshakeOrEmitwsClientError(server, req, socket, code, message, headers) {
     if (server.listenerCount("wsClientError")) {
       const err = new Error(message);
       Error.captureStackTrace(err, abortHandshakeOrEmitwsClientError);
       server.emit("wsClientError", err, socket, req);
     } else {
-      abortHandshake(socket, code, message);
+      abortHandshake(socket, code, message, headers);
     }
   }
 });
 
-// node_modules/ws/wrapper.mjs
+// ../../node_modules/.pnpm/@kevisual+ws@8.19.0/node_modules/@kevisual/ws/wrapper.mjs
 var import_stream = __toESM(require_stream(), 1);
 var import_receiver = __toESM(require_receiver(), 1);
 var import_sender = __toESM(require_sender(), 1);

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@kevisual/router",
-  "version": "0.2.4",
+  "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,
@@ -125,10 +134,12 @@ export const parse = async (opts: {
     token?: string,
     username?: string,
     id?: string,
+    /** https://kevisual.cn/ws/proxy */
+    url?: string,
   },
   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 命令行工具');
@@ -138,15 +149,16 @@ 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 } = opts.remote;
+    const { token, username, id, url } = opts.remote;
     const remoteApp = new RemoteApp({
       app,
       token,
       username,
       id,
+      url,
     });
     const isConnect = await remoteApp.isConnect();
     if (isConnect) {

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);