@kevisual/router 0.1.4 → 0.1.5

package/dist/opencode.d.ts

@@ -0,0 +1,811 @@
+import { EventEmitter } from 'eventemitter3';
+import { z } from 'zod';
+import * as http from 'node:http';
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { IncomingMessage as IncomingMessage$1, ServerResponse as ServerResponse$1 } from 'http';
+import { PluginInput, Hooks, Plugin } from '@opencode-ai/plugin';
+
+type CustomErrorOptions = {
+    cause?: Error | string;
+    code?: number;
+    message?: string;
+};
+interface throwError {
+    throw(code?: number | string, message?: string): void;
+    throw(code?: number | string, opts?: CustomErrorOptions): void;
+    throw(opts?: CustomErrorOptions): void;
+}
+
+declare class MockProcess {
+    emitter?: EventEmitter;
+    process?: NodeJS.Process;
+    constructor(opts?: {
+        emitter?: EventEmitter;
+        isNode?: boolean;
+    });
+    send(data?: any, callback?: (err?: Error) => void): void;
+    exit(flag?: number): void;
+    on(fn: (msg?: any) => any): void;
+    desctroy(): void;
+}
+
+type RouterContextT = {
+    code?: number;
+    [key: string]: any;
+};
+type BuildRouteContext<M, U> = M extends {
+    args?: infer A;
+} ? A extends z.ZodObject<any> ? RouteContext<{
+    args?: z.infer<A>;
+}, U> : A extends Record<string, z.ZodTypeAny> ? RouteContext<{
+    args?: {
+        [K in keyof A]: z.infer<A[K]>;
+    };
+}, U> : RouteContext<U> : RouteContext<U>;
+type RouteContext<T = {
+    code?: number;
+}, U extends SimpleObject = {}, S = {
+    [key: string]: any;
+}> = {
+    /**
+     * 本地自己调用的时候使用，可以标识为当前自调用，那么 auth 就不许重复的校验
+     * 或者不需要登录的，直接调用
+     */
+    appId?: string;
+    query?: {
+        [key: string]: any;
+    };
+    args?: {
+        [key: string]: any;
+    };
+    /** return body */
+    body?: number | string | Object;
+    forward?: (response: {
+        code: number;
+        data?: any;
+        message?: any;
+    }) => void;
+    /** return code */
+    code?: number;
+    /** return msg */
+    message?: string;
+    /**
+     * 传递状态
+     */
+    state?: S;
+    /**
+     * 当前routerId
+     */
+    currentId?: string;
+    /**
+     * 当前路径
+     */
+    currentPath?: string;
+    /**
+     * 当前key
+     */
+    currentKey?: string;
+    /**
+     * 当前route
+     */
+    currentRoute?: Route;
+    /**
+     * 进度
+     */
+    progress?: [string, string][];
+    nextQuery?: {
+        [key: string]: any;
+    };
+    end?: boolean;
+    app?: QueryRouter;
+    error?: any;
+    /** 请求 route的返回结果，不解析body为data */
+    call?: (message: {
+        path: string;
+        key?: string;
+        payload?: any;
+        [key: string]: any;
+    } | {
+        id: string;
+        apyload?: any;
+        [key: string]: any;
+    }, ctx?: RouteContext & {
+        [key: string]: any;
+    }) => Promise<any>;
+    /** 请求 route的返回结果，解析了body为data，就类同于 query.post获取的数据*/
+    run?: (message: {
+        path: string;
+        key?: string;
+        payload?: any;
+    }, ctx?: RouteContext) => Promise<any>;
+    index?: number;
+    throw?: throwError['throw'];
+    /** 是否需要序列化, 使用JSON.stringify和JSON.parse */
+    needSerialize?: boolean;
+} & T & U;
+type SimpleObject = Record<string, any>;
+type Run<T extends SimpleObject = {}> = (ctx: Required<RouteContext<T>>) => Promise<typeof ctx | null | void>;
+type RunMessage = {
+    path?: string;
+    key?: string;
+    id?: string;
+    payload?: any;
+};
+type NextRoute = Pick<Route, 'id' | 'path' | 'key'>;
+type RouteMiddleware = {
+    path?: string;
+    key?: string;
+    id?: string;
+} | string;
+type RouteOpts<U = {}, T = SimpleObject> = {
+    path?: string;
+    key?: string;
+    id?: string;
+    run?: Run<U>;
+    nextRoute?: NextRoute;
+    description?: string;
+    metadata?: T;
+    middleware?: RouteMiddleware[];
+    type?: 'route' | 'middleware' | 'compound';
+    isDebug?: boolean;
+};
+type DefineRouteOpts = Omit<RouteOpts, 'idUsePath' | 'nextRoute'>;
+declare const pickValue: readonly ["path", "key", "id", "description", "type", "middleware", "metadata"];
+type RouteInfo = Pick<Route, (typeof pickValue)[number]>;
+/**
+ * @M 是 route的 metadate的类型，默认是 SimpleObject
+ * @U 是 RouteContext 里 state的类型
+ */
+declare class Route<M extends SimpleObject = SimpleObject, U extends SimpleObject = SimpleObject> implements throwError {
+    /**
+     * 一级路径
+     */
+    path?: string;
+    /**
+     * 二级路径
+     */
+    key?: string;
+    id?: string;
+    run?: Run<BuildRouteContext<M, U>>;
+    nextRoute?: NextRoute;
+    description?: string;
+    metadata?: M;
+    middleware?: RouteMiddleware[];
+    type?: string;
+    /**
+     * 是否开启debug，开启后会打印错误信息
+     */
+    isDebug?: boolean;
+    constructor(path?: string, key?: string, opts?: RouteOpts);
+    prompt(description: string): this;
+    prompt(description: Function): this;
+    define<T extends {
+        [key: string]: any;
+    } = RouterContextT>(opts: DefineRouteOpts): this;
+    define<T extends {
+        [key: string]: any;
+    } = RouterContextT>(fn: Run<T & BuildRouteContext<M, U>>): this;
+    define<T extends {
+        [key: string]: any;
+    } = RouterContextT>(key: string, fn: Run<T & BuildRouteContext<M, U>>): this;
+    define<T extends {
+        [key: string]: any;
+    } = RouterContextT>(path: string, key: string, fn: Run<T & BuildRouteContext<M, U>>): this;
+    update(opts: DefineRouteOpts, onlyUpdateList?: string[]): this;
+    addTo(router: QueryRouter | {
+        add: (route: Route) => void;
+        [key: string]: any;
+    }, opts?: AddOpts): void;
+    throw(...args: any[]): void;
+}
+/**
+ * @parmas overwrite 是否覆盖已存在的route，默认true
+ */
+type AddOpts = {
+    overwrite?: boolean;
+};
+declare class QueryRouter<T extends SimpleObject = SimpleObject> implements throwError {
+    appId: string;
+    routes: Route[];
+    maxNextRoute: number;
+    context?: RouteContext<T>;
+    constructor();
+    /**
+     * add route
+     * @param route
+     * @param opts
+     */
+    add(route: Route, opts?: AddOpts): void;
+    /**
+     * remove route by path and key
+     * @param route
+     */
+    remove(route: Route | {
+        path: string;
+        key?: string;
+    }): void;
+    /**
+     * remove route by id
+     * @param uniqueId
+     */
+    removeById(uniqueId: string): void;
+    /**
+     * 执行route
+     * @param path
+     * @param key
+     * @param ctx
+     * @returns
+     */
+    runRoute(path: string, key: string, ctx?: RouteContext<T>): Promise<RouteContext<T>>;
+    /**
+     * 第一次执行
+     * @param message
+     * @param ctx
+     * @returns
+     */
+    parse(message: {
+        path: string;
+        key?: string;
+        payload?: any;
+    }, ctx?: RouteContext<T> & {
+        [key: string]: any;
+    }): Promise<RouteContext<T, {}, {
+        [key: string]: any;
+    }>>;
+    /**
+     * 返回的数据包含所有的context的请求返回的内容，可做其他处理
+     * @param message
+     * @param ctx
+     * @returns
+     */
+    call(message: {
+        id?: string;
+        path?: string;
+        key?: string;
+        payload?: any;
+    }, ctx?: RouteContext<T> & {
+        [key: string]: any;
+    }): Promise<RouteContext<T, {}, {
+        [key: string]: any;
+    }> | {
+        code: number;
+        body: any;
+        message: string;
+    }>;
+    /**
+     * 请求 result 的数据
+     * @param message
+     * @param ctx
+     * @deprecated use run or call instead
+     * @returns
+     */
+    queryRoute(message: {
+        id?: string;
+        path: string;
+        key?: string;
+        payload?: any;
+    }, ctx?: RouteContext & {
+        [key: string]: any;
+    }): Promise<{
+        code: number;
+        data: any;
+        message: string;
+    }>;
+    /**
+     * Router Run获取数据
+     * @param message
+     * @param ctx
+     * @returns
+     */
+    run(message: {
+        id?: string;
+        path?: string;
+        key?: string;
+        payload?: any;
+    }, ctx?: RouteContext<T> & {
+        [key: string]: any;
+    }): Promise<{
+        code: number;
+        data: any;
+        message: string;
+    }>;
+    /**
+     * 设置上下文
+     * @description 这里的上下文是为了在handle函数中使用
+     * @param ctx
+     */
+    setContext(ctx: RouteContext): void;
+    getList(filter?: (route: Route) => boolean): RouteInfo[];
+    /**
+     * 获取handle函数, 这里会去执行parse函数
+     */
+    getHandle<T = any>(router: QueryRouter, wrapperFn?: HandleFn, ctx?: RouteContext): (msg: {
+        id?: string;
+        path?: string;
+        key?: string;
+        [key: string]: any;
+    }, handleContext?: RouteContext<T>) => Promise<{
+        [key: string]: any;
+        code: string;
+        data?: any;
+        message?: string;
+    } | {
+        code: any;
+        data: any;
+        message: any;
+    } | {
+        code: number;
+        message: any;
+        data?: undefined;
+    }>;
+    exportRoutes(): Route<SimpleObject, SimpleObject>[];
+    importRoutes(routes: Route[]): void;
+    importRouter(router: QueryRouter): void;
+    throw(...args: any[]): void;
+    hasRoute(path: string, key?: string): Route<SimpleObject, SimpleObject>;
+    findRoute(opts?: {
+        path?: string;
+        key?: string;
+        id?: string;
+    }): Route<SimpleObject, SimpleObject>;
+    createRouteList(opts?: {
+        force?: boolean;
+        filter?: (route: Route) => boolean;
+        middleware?: string[];
+    }): void;
+    /**
+     * 等待程序运行, 获取到message的数据,就执行
+     * params 是预设参数
+     * emitter = process
+     * -- .exit
+     * -- .on
+     * -- .send
+     */
+    wait(params?: {
+        message: RunMessage;
+    }, opts?: {
+        mockProcess?: MockProcess;
+        timeout?: number;
+        getList?: boolean;
+        force?: boolean;
+        filter?: (route: Route) => boolean;
+        routeListMiddleware?: string[];
+    }): Promise<void>;
+    toJSONSchema: (args: any, opts?: {
+        mergeObject?: boolean;
+        override?: (opts: {
+            jsonSchema: any;
+            path: string[];
+            zodSchema: z.ZodTypeAny;
+        }) => void;
+    }) => {
+        [key: string]: any;
+    };
+    fromJSONSchema: <Merge extends boolean = false>(args?: any, opts?: {
+        mergeObject?: boolean;
+    }) => Merge extends true ? z.ZodObject<{
+        [key: string]: any;
+    }, z.core.$strip> : {
+        [key: string]: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    };
+}
+type QueryRouterServerOpts<C extends SimpleObject = SimpleObject> = {
+    handleFn?: HandleFn;
+    context?: RouteContext<C>;
+    appId?: string;
+    initHandle?: boolean;
+};
+interface HandleFn<T = any> {
+    (msg: {
+        path: string;
+        [key: string]: any;
+    }, ctx?: any): {
+        code: string;
+        data?: any;
+        message?: string;
+        [key: string]: any;
+    };
+    (res: RouteContext<T>): any;
+}
+/**
+ * QueryRouterServer
+ * @description 移除server相关的功能，只保留router相关的功能，和http.createServer不相关，独立
+ * @template C 自定义 RouteContext 类型
+ */
+declare class QueryRouterServer<C extends SimpleObject = SimpleObject> extends QueryRouter<C> {
+    appId: string;
+    handle: any;
+    context: RouteContext<C>;
+    constructor(opts?: QueryRouterServerOpts<C>);
+    setHandle(wrapperFn?: HandleFn, ctx?: RouteContext): void;
+    addRoute(route: Route, opts?: AddOpts): void;
+    Route: typeof Route;
+    route<M extends SimpleObject = SimpleObject>(opts: RouteOpts & {
+        metadata?: M;
+    }): Route<M, Required<RouteContext<C>>>;
+    route<M extends SimpleObject = SimpleObject>(path: string, opts?: RouteOpts & {
+        metadata?: M;
+    }): Route<M, Required<RouteContext<C>>>;
+    route<M extends SimpleObject = SimpleObject>(path: string, key?: string): Route<M, Required<RouteContext<C>>>;
+    route<M extends SimpleObject = SimpleObject>(path: string, key?: string, opts?: RouteOpts & {
+        metadata?: M;
+    }): Route<M, Required<RouteContext<C>>>;
+    prompt(description: string): Route<SimpleObject, SimpleObject>;
+    /**
+     * 调用了handle
+     * @param param0
+     * @returns
+     */
+    run(msg: {
+        id?: string;
+        path?: string;
+        key?: string;
+        payload?: any;
+        token?: string;
+        data?: any;
+    }, ctx?: Partial<RouteContext<C>>): Promise<any>;
+    runAction<T extends {
+        id?: string;
+        path?: string;
+        key?: string;
+        metadata?: {
+            args?: any;
+        };
+    } = {}>(api: T, payload: RunActionPayload<T>, ctx?: RouteContext<C>): Promise<any>;
+}
+/** JSON Schema 基本类型映射到 TypeScript 类型 */
+type JsonSchemaTypeToTS<T> = T extends {
+    type: "string";
+} ? string : T extends {
+    type: "boolean";
+} ? boolean : T extends {
+    type: "number";
+} ? number : T extends {
+    type: "integer";
+} ? number : T extends {
+    type: "object";
+} ? object : T extends {
+    type: "array";
+} ? any[] : any;
+/** 将 args shape（key -> JSON Schema 类型）转换为 payload 类型，支持 optional: true 的字段为可选 */
+type ArgsShapeToPayload<T> = {
+    [K in keyof T as T[K] extends {
+        optional: true;
+    } ? never : K]: JsonSchemaTypeToTS<T[K]>;
+} & {
+    [K in keyof T as T[K] extends {
+        optional: true;
+    } ? K : never]?: JsonSchemaTypeToTS<T[K]>;
+};
+/** 处理两种 args 格式：完整 JSON Schema（含 properties）或简单 key->type 映射 */
+type ArgsToPayload<T> = T extends {
+    type: "object";
+    properties: infer P;
+} ? ArgsShapeToPayload<P> : ArgsShapeToPayload<T>;
+/** 从 API 定义中提取 metadata.args */
+type ExtractArgs<T> = T extends {
+    metadata: {
+        args: infer A;
+    };
+} ? A : {};
+/** runAction 第二个参数的类型，根据第一个参数的 metadata.args 推断 */
+type RunActionPayload<T> = ArgsToPayload<ExtractArgs<T>>;
+
+type Cors = {
+    /**
+     * @default '*''
+     */
+    origin?: string | undefined;
+};
+type ServerOpts<T = {}> = {
+    /**path default `/api/router` */
+    path?: string;
+    /**handle Fn */
+    handle?: (msg?: {
+        path: string;
+        key?: string;
+        [key: string]: any;
+    }, ctx?: {
+        req: http.IncomingMessage;
+        res: http.ServerResponse;
+    }) => any;
+    cors?: Cors;
+    io?: boolean;
+    showConnected?: boolean;
+} & T;
+interface ServerType {
+    path?: string;
+    server?: any;
+    handle: ServerOpts['handle'];
+    setHandle(handle?: any): void;
+    listeners: Listener[];
+    listen(port: number, hostname?: string, backlog?: number, listeningListener?: () => void): void;
+    listen(port: number, hostname?: string, listeningListener?: () => void): void;
+    listen(port: number, backlog?: number, listeningListener?: () => void): void;
+    listen(port: number, listeningListener?: () => void): void;
+    listen(path: string, backlog?: number, listeningListener?: () => void): void;
+    listen(path: string, listeningListener?: () => void): void;
+    listen(handle: any, backlog?: number, listeningListener?: () => void): void;
+    listen(handle: any, listeningListener?: () => void): void;
+    /**
+     * 兜底监听，当除开 `/api/router` 之外的请求，框架只监听一个api，所以有其他的请求都执行其他的监听
+     * @description 主要是为了兼容其他的监听
+     * @param listener
+     */
+    on(listener: OnListener): void;
+    onWebSocket({ ws, message, pathname, token, id }: OnWebSocketOptions): void;
+    onWsClose<T = {}>(ws: WS<T>): void;
+    sendConnected<T = {}>(ws: WS<T>): void;
+}
+type OnWebSocketOptions<T = {}> = {
+    ws: WS<T>;
+    message: string | Buffer;
+    pathname: string;
+    token?: string;
+    /** data 的id提取出来 */
+    id?: string;
+};
+type WS<T = {}> = {
+    send: (data: any) => void;
+    close: (code?: number, reason?: string) => void;
+    /**
+   * ws 自己生成的一个id，主要是为了区分不同的ws连接，方便在onWebSocket中使用
+   */
+    wsId?: string;
+    data?: {
+        /**
+         * ws连接时的url，包含pathname和searchParams
+         */
+        url: URL;
+        /**
+         * ws连接时的pathname
+         */
+        pathname: string;
+        /**
+         * ws连接时的url中的token参数
+         */
+        token?: string;
+        /**
+         * ws连接时的url中的id参数.
+         */
+        id?: string;
+        /**
+         * 鉴权后的获取的信息
+         */
+        userApp?: string;
+    } & T;
+};
+type Listener = {
+    id?: string;
+    io?: boolean;
+    path?: string;
+    func: WebSocketListenerFun | HttpListenerFun;
+    /**
+   * @description 是否默认解析为 JSON，如果为 true，则 message 会被 JSON.parse 处理，默认是 true
+   */
+    json?: boolean;
+};
+type WebSocketListenerFun = (req: WebSocketReq, res: WebSocketRes) => Promise<void> | void;
+type HttpListenerFun = (req: RouterReq, res: RouterRes) => Promise<void> | void;
+type WebSocketReq<T = {}, U = Record<string, any>> = {
+    emitter?: EventEmitter;
+    ws: WS<T>;
+    data?: U;
+    message?: string | Buffer;
+    pathname?: string;
+    token?: string;
+    id?: string;
+};
+type WebSocketRes = {
+    end: (data: any) => void;
+};
+type ListenerFun = WebSocketListenerFun | HttpListenerFun;
+type OnListener = Listener | ListenerFun | (Listener | ListenerFun)[];
+type RouterReq<T = {}> = {
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    socket?: {
+        remoteAddress?: string;
+        remotePort?: number;
+    };
+    body?: string;
+    cookies?: Record<string, string>;
+    bun?: {
+        request: Bun.BunRequest;
+        server: Bun.Server<{}>;
+        resolve: (response: Response) => void;
+    };
+    on: (event: 'close', listener: Function) => void;
+} & T;
+type RouterRes<T = {}> = {
+    statusCode: number;
+    headersSent: boolean;
+    _headers: Record<string, string | string[]>;
+    _bodyChunks: any[];
+    writableEnded: boolean;
+    writeHead: (statusCode: number, headers?: Record<string, string>) => void;
+    setHeader: (name: string, value: string | string[]) => void;
+    cookie: (name: string, value: string, options?: any) => void;
+    write: (chunk: any) => void;
+    pipe: (stream: ReadableStream) => void;
+    end: (data?: any) => void;
+} & T;
+
+interface StringifyOptions {
+    /**
+     * Specifies a function that will be used to encode a [cookie-value](https://datatracker.ietf.org/doc/html/rfc6265#section-4.1.1).
+     * Since value of a cookie has a limited character set (and must be a simple string), this function can be used to encode
+     * a value into a string suited for a cookie's value, and should mirror `decode` when parsing.
+     *
+     * @default encodeURIComponent
+     */
+    encode?: (str: string) => string;
+}
+/**
+ * Set-Cookie object.
+ */
+interface SetCookie {
+    /**
+     * Specifies the name of the cookie.
+     */
+    name: string;
+    /**
+     * Specifies the string to be the value for the cookie.
+     */
+    value: string | undefined;
+    /**
+     * Specifies the `number` (in seconds) to be the value for the [`Max-Age` `Set-Cookie` attribute](https://tools.ietf.org/html/rfc6265#section-5.2.2).
+     *
+     * The [cookie storage model specification](https://tools.ietf.org/html/rfc6265#section-5.3) states that if both `expires` and
+     * `maxAge` are set, then `maxAge` takes precedence, but it is possible not all clients by obey this,
+     * so if both are set, they should point to the same date and time.
+     */
+    maxAge?: number;
+    /**
+     * Specifies the `Date` object to be the value for the [`Expires` `Set-Cookie` attribute](https://tools.ietf.org/html/rfc6265#section-5.2.1).
+     * When no expiration is set, clients consider this a "non-persistent cookie" and delete it when the current session is over.
+     *
+     * The [cookie storage model specification](https://tools.ietf.org/html/rfc6265#section-5.3) states that if both `expires` and
+     * `maxAge` are set, then `maxAge` takes precedence, but it is possible not all clients by obey this,
+     * so if both are set, they should point to the same date and time.
+     */
+    expires?: Date;
+    /**
+     * Specifies the value for the [`Domain` `Set-Cookie` attribute](https://tools.ietf.org/html/rfc6265#section-5.2.3).
+     * When no domain is set, clients consider the cookie to apply to the current domain only.
+     */
+    domain?: string;
+    /**
+     * Specifies the value for the [`Path` `Set-Cookie` attribute](https://tools.ietf.org/html/rfc6265#section-5.2.4).
+     * When no path is set, the path is considered the ["default path"](https://tools.ietf.org/html/rfc6265#section-5.1.4).
+     */
+    path?: string;
+    /**
+     * Enables the [`HttpOnly` `Set-Cookie` attribute](https://tools.ietf.org/html/rfc6265#section-5.2.6).
+     * When enabled, clients will not allow client-side JavaScript to see the cookie in `document.cookie`.
+     */
+    httpOnly?: boolean;
+    /**
+     * Enables the [`Secure` `Set-Cookie` attribute](https://tools.ietf.org/html/rfc6265#section-5.2.5).
+     * When enabled, clients will only send the cookie back if the browser has an HTTPS connection.
+     */
+    secure?: boolean;
+    /**
+     * Enables the [`Partitioned` `Set-Cookie` attribute](https://tools.ietf.org/html/draft-cutler-httpbis-partitioned-cookies/).
+     * When enabled, clients will only send the cookie back when the current domain _and_ top-level domain matches.
+     *
+     * This is an attribute that has not yet been fully standardized, and may change in the future.
+     * This also means clients may ignore this attribute until they understand it. More information
+     * about can be found in [the proposal](https://github.com/privacycg/CHIPS).
+     */
+    partitioned?: boolean;
+    /**
+     * Specifies the value for the [`Priority` `Set-Cookie` attribute](https://tools.ietf.org/html/draft-west-cookie-priority-00#section-4.1).
+     *
+     * - `'low'` will set the `Priority` attribute to `Low`.
+     * - `'medium'` will set the `Priority` attribute to `Medium`, the default priority when not set.
+     * - `'high'` will set the `Priority` attribute to `High`.
+     *
+     * More information about priority levels can be found in [the specification](https://tools.ietf.org/html/draft-west-cookie-priority-00#section-4.1).
+     */
+    priority?: "low" | "medium" | "high";
+    /**
+     * Specifies the value for the [`SameSite` `Set-Cookie` attribute](https://tools.ietf.org/html/draft-ietf-httpbis-rfc6265bis-09#section-5.4.7).
+     *
+     * - `true` will set the `SameSite` attribute to `Strict` for strict same site enforcement.
+     * - `'lax'` will set the `SameSite` attribute to `Lax` for lax same site enforcement.
+     * - `'none'` will set the `SameSite` attribute to `None` for an explicit cross-site cookie.
+     * - `'strict'` will set the `SameSite` attribute to `Strict` for strict same site enforcement.
+     *
+     * More information about enforcement levels can be found in [the specification](https://tools.ietf.org/html/draft-ietf-httpbis-rfc6265bis-09#section-5.4.7).
+     */
+    sameSite?: boolean | "lax" | "strict" | "none";
+}
+/**
+ * Backward compatibility serialize options.
+ */
+type SerializeOptions = StringifyOptions & Omit<SetCookie, "name" | "value">;
+
+type CookieFn = (name: string, value: string, options?: SerializeOptions, end?: boolean) => void;
+type HandleCtx = {
+    req: IncomingMessage & {
+        cookies: Record<string, string>;
+    };
+    res: ServerResponse & {
+        /**
+         * cookie 函数， end 参数用于设置是否立即设置到响应头，设置了后面的cookie再设置会覆盖前面的
+         */
+        cookie: CookieFn;
+    };
+};
+
+type ServerNodeOpts = ServerOpts<{
+    httpType?: 'http' | 'https' | 'http2';
+    httpsKey?: string;
+    httpsCert?: string;
+}>;
+
+type RouterHandle = (msg: {
+    path: string;
+    [key: string]: any;
+}) => {
+    code: string;
+    data?: any;
+    message?: string;
+    [key: string]: any;
+};
+type AppOptions<T = {}> = {
+    router?: QueryRouterServer;
+    server?: ServerType;
+    /** handle msg 关联 */
+    routerHandle?: RouterHandle;
+    routerContext?: RouteContext<T>;
+    serverOptions?: ServerNodeOpts;
+    appId?: string;
+};
+type AppRouteContext<T> = HandleCtx & RouteContext<T> & {
+    app: App<T>;
+};
+/**
+ *  封装了 Router 和 Server 的 App 模块，处理http的请求和响应，内置了 Cookie 和 Token 和 res 的处理
+ *  U - Route Context的扩展类型
+ */
+declare class App<U = {}> extends QueryRouterServer<AppRouteContext<U>> {
+    appId: string;
+    router: QueryRouterServer;
+    server: ServerType;
+    context: AppRouteContext<U>;
+    constructor(opts?: AppOptions<U>);
+    listen(port: number, hostname?: string, backlog?: number, listeningListener?: () => void): void;
+    listen(port: number, hostname?: string, listeningListener?: () => void): void;
+    listen(port: number, backlog?: number, listeningListener?: () => void): void;
+    listen(port: number, listeningListener?: () => void): void;
+    listen(path: string, backlog?: number, listeningListener?: () => void): void;
+    listen(path: string, listeningListener?: () => void): void;
+    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<{
+        cookies: Record<string, string>;
+        token: string;
+    }>;
+    onServerRequest(fn: (req: IncomingMessage$1, res: ServerResponse$1) => void): void;
+}
+
+declare const addCallFn: (app: App) => void;
+declare const createRouterAgentPluginFn: (opts?: {
+    router?: App | QueryRouterServer;
+    query?: string;
+    hooks?: (plugin: PluginInput) => Promise<Hooks>;
+}) => Plugin;
+declare const usePluginInput: () => PluginInput;
+/**
+ * 如果args是z.object类型，拆分第一个Object的属性，比如z.object({ name: z.string(), age: z.number() })，拆分成{name: z.string(), age: z.number()}
+ * 如果args是普通对象，直接返回
+ * @param args
+ * @returns
+ */
+declare const extractArgs: (args: any) => any;
+
+export { addCallFn, createRouterAgentPluginFn, extractArgs, usePluginInput };