k99 0.7.1 → 0.8.0

package/index.d.ts

@@ -1,6 +1,6 @@
 /*!
- * k99 v0.7.1
- * (c) 2019-2025 猛火Fierflame
+ * k99 v0.8.0
+ * (c) 2019-2026 猛火Fierflame
  * @license MIT
  */
 type Method = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'HEAD' | 'OPTIONS';
@@ -108,16 +108,15 @@ interface Options {
     error?(error: unknown): void;
     catch?(error: unknown): PromiseLike<Response | null> | Response | null;
     environment?: object;
+    replacer?(this: any, key: string, value: any): any;
 }
-type HandlerResult = void | undefined | string | BufferSource | ArrayBufferView | AsyncIterable<string | BufferSource | ArrayBufferView> | Iterable<string | BufferSource | ArrayBufferView> | object | Response | ReadableStream | Blob | FormData | boolean;
+type HandlerResult = void | undefined | string | BufferSource | ArrayBufferView | AsyncIterable<string | BufferSource | ArrayBufferView> | Iterable<string | BufferSource | ArrayBufferView> | object | Response | ReadableStream | Blob | FormData | number | bigint | boolean;
 /** 处理函数定义 */
 interface Handler {
     (ctx: Context): PromiseLike<HandlerResult> | HandlerResult;
-    /** 所属组 */
-    plugin?: string;
 }
 interface FindHandler {
-    (ctx: Context, setParams: (v: Params) => void): PromiseLike<Handler | null> | Handler | null;
+    (ctx: Context, setParams: (v: Params) => void): PromiseLike<Handler | Handler[] | null> | Handler | Handler[] | null;
 }
 
 /**
@@ -129,12 +128,22 @@ declare function onionskin(...handlers: (Onionskin | Onionskin[])[]): Handler;
 type Onionskin = (ctx: Context, next: () => Promise<HandlerResult>) => PromiseLike<HandlerResult> | HandlerResult;
 
 type Guard = (ctx: Context) => PromiseLike<boolean | Handler | void> | boolean | Handler | void;
-type FindItem = [Handler | Router, Record<string | symbol, any>, string[]];
+type FindItem = [Handler | Handler[] | Router, Record<string | symbol, any>, string[]];
 type Finder = (this: Router, method: Method, path: string[], ctx: Context) => AsyncIterable<FindItem> | Iterable<FindItem>;
 /**
  * @abstract
  */
 declare class Router {
+    /**
+     *
+     * @param {Router | Handler[] | Handler} route
+     * @param {string[]} path
+     * @param {Context} ctx
+     * @param {(v: Params) => void} setParams
+     * @param {Params} params
+     * @returns {Promise<Handler[] | null>}
+     */
+    static "__#2@#find"(route: Router | Handler[] | Handler, path: string[], ctx: Context, setParams: (v: Params) => void, params: Params): Promise<Handler[] | null>;
     /**
      *
      * @param {Router[]} routers
@@ -156,16 +165,14 @@ declare class Router {
      * @returns {AsyncIterable<FindItem> | Iterable<FindItem>}
      */
     find(method: Method, path: string[], ctx: Context): AsyncIterable<FindItem> | Iterable<FindItem>;
-    /** @readonly @type {Set<Guard>} */
-    readonly guards: Set<Guard>;
     /**
      *
-     * @param {Handler} h
-     * @returns {Handler}
+     * @param  {...Handler | Handler[]} guards
      */
-    __onionskin: (h: Handler) => Handler;
+    guard(...guards: (Handler | Handler[])[]): void;
     /** @param {Onionskin} os */
     onionskin(os: Onionskin): void;
+    #private;
 }
 
 declare class ApiRouter extends Router {
@@ -230,18 +237,18 @@ declare class ApiRouter extends Router {
     /**
      * 注册 HTTP GET/POST/PUT/DELETE 处理函数
      * @overload
-     * @param {Handler} handler 要注册的处理函数
+     * @param {...Handler} handlers 要注册的处理函数
      * @returns {() => void}
      */
-    match(handler: Handler): () => void;
+    match(...handlers: Handler[]): () => void;
     /**
      * 注册处理函数
      * @overload
      * @param {string} path 要注册的路径
-     * @param {Handler} handler 要注册的处理函数
+     * @param {...Handler} handlers 要注册的处理函数
      * @returns {() => void}
      */
-    match(path: string, handler: Handler): () => void;
+    match(path: string, ...handlers: Handler[]): () => void;
     /**
      * 注册 HTTP GET/POST/PUT/DELETE 处理函数
      * @overload
@@ -260,18 +267,18 @@ declare class ApiRouter extends Router {
     /**
      * 注册 HTTP GET 处理函数
      * @overload
-     * @param {Handler} handler 要注册的处理函数
+     * @param {...Handler} handlers 要注册的处理函数
      * @returns {() => void}
      */
-    get(handler: Handler): () => void;
+    get(...handlers: Handler[]): () => void;
     /**
      * 注册 HTTP GET 处理函数
      * @overload
      * @param {string} path 要注册的路径
-     * @param {Handler} handler 要注册的处理函数
+     * @param {...Handler} handlers 要注册的处理函数
      * @returns {() => void}
      */
-    get(path: string, handler: Handler): () => void;
+    get(path: string, ...handlers: Handler[]): () => void;
     /**
      * 注册 HTTP GET 处理函数
      * @overload
@@ -290,18 +297,18 @@ declare class ApiRouter extends Router {
     /**
      * 注册 HTTP POST 处理函数
      * @overload
-     * @param {Handler} handler 要注册的处理函数
+     * @param {...Handler} handlers 要注册的处理函数
      * @returns {() => void}
      */
-    post(handler: Handler): () => void;
+    post(...handlers: Handler[]): () => void;
     /**
      * 注册 HTTP POST 处理函数
      * @overload
      * @param {string} path 要注册的路径
-     * @param {Handler} handler 要注册的处理函数
+     * @param {...Handler} handlers 要注册的处理函数
      * @returns {() => void}
      */
-    post(path: string, handler: Handler): () => void;
+    post(path: string, ...handlers: Handler[]): () => void;
     /**
      * 注册 HTTP POST 处理函数
      * @overload
@@ -320,18 +327,18 @@ declare class ApiRouter extends Router {
     /**
      * 注册 HTTP PUT 处理函数
      * @overload
-     * @param {Handler} handler 要注册的处理函数
+     * @param {...Handler} handlers 要注册的处理函数
      * @returns {() => void}
      */
-    put(handler: Handler): () => void;
+    put(...handlers: Handler[]): () => void;
     /**
      * 注册 HTTP PUT 处理函数
      * @overload
      * @param {string} path 要注册的路径
-     * @param {Handler} handler 要注册的处理函数
+     * @param {...Handler} handlers 要注册的处理函数
      * @returns {() => void}
      */
-    put(path: string, handler: Handler): () => void;
+    put(path: string, ...handlers: Handler[]): () => void;
     /**
      * 注册 HTTP PUT 处理函数
      * @overload
@@ -350,18 +357,18 @@ declare class ApiRouter extends Router {
     /**
      * 注册 HTTP DELETE 处理函数
      * @overload
-     * @param {Handler} handler 要注册的处理函数
+     * @param {...Handler} handlers 要注册的处理函数
      * @returns {() => void}
      */
-    delete(handler: Handler): () => void;
+    delete(...handlers: Handler[]): () => void;
     /**
      * 注册 HTTP DELETE 处理函数
      * @overload
      * @param {string} path 要注册的路径
-     * @param {Handler} handler 要注册的处理函数
+     * @param {...Handler} handlers 要注册的处理函数
      * @returns {() => void}
      */
-    delete(path: string, handler: Handler): () => void;
+    delete(path: string, ...handlers: Handler[]): () => void;
     /**
      * 注册 HTTP DELETE 处理函数
      * @overload
@@ -380,18 +387,18 @@ declare class ApiRouter extends Router {
     /**
      * 注册 HTTP HEAD 处理函数
      * @overload
-     * @param {Handler} handler 要注册的处理函数
+     * @param {...Handler} handlers 要注册的处理函数
      * @returns {() => void}
      */
-    head(handler: Handler): () => void;
+    head(...handlers: Handler[]): () => void;
     /**
      * 注册 HTTP HEAD 处理函数
      * @overload
      * @param {string} path 要注册的路径
-     * @param {Handler} handler 要注册的处理函数
+     * @param {...Handler} handlers 要注册的处理函数
      * @returns {() => void}
      */
-    head(path: string, handler: Handler): () => void;
+    head(path: string, ...handlers: Handler[]): () => void;
     /**
      * 注册 HTTP HEAD 处理函数
      * @overload
@@ -410,18 +417,18 @@ declare class ApiRouter extends Router {
     /**
      * 注册 HTTP OPTIONS 处理函数
      * @overload
-     * @param {Handler} handler 要注册的处理函数
+     * @param {...Handler} handlers 要注册的处理函数
      * @returns {() => void}
      */
-    options(handler: Handler): () => void;
+    options(...handlers: Handler[]): () => void;
     /**
      * 注册 HTTP OPTIONS 处理函数
      * @overload
      * @param {string} path 要注册的路径
-     * @param {Handler} handler 要注册的处理函数
+     * @param {...Handler} handlers 要注册的处理函数
      * @returns {() => void}
      */
-    options(path: string, handler: Handler): () => void;
+    options(path: string, ...handlers: Handler[]): () => void;
     /**
      * 注册 HTTP OPTIONS 处理函数
      * @overload
@@ -447,14 +454,10 @@ type Route = {
      */
     match?: Match | undefined;
     router?: null | undefined;
-    /**
-     * 所属插件
-     */
-    plugin?: string | undefined;
     /**
      * 处理函数
      */
-    handler: Handler;
+    handlers: Handler[];
     /**
      * 方法列表
      */
@@ -476,7 +479,7 @@ type RouteBinder<T extends Router | Finder = ApiRouter> = (router?: T | undefine
  * @returns {Packer}
  */
 declare function packer(onionskin: Onionskin, packer?: Packer): Packer;
-type Packer = (handler: Handler) => Handler;
+type Packer = (handler: Handler | Handler[]) => Handler | Handler[];
 
 /**
  *
@@ -485,7 +488,7 @@ type Packer = (handler: Handler) => Handler;
  * @param {Options} [options]
  * @returns {Promise<Response | null>}
  */
-declare function main(request: Request, getHandler: FindHandler, { runner, error: echoError, catch: catchError, method: toMethod, environment }?: Options): Promise<Response | null>;
+declare function main(request: Request, getHandler: FindHandler, { runner, error: echoError, catch: catchError, method: toMethod, environment, replacer: JSONReplacer, }?: Options): Promise<Response | null>;
 
 /** @import { FindHandler, Options } from './main/types' */
 /**