@kevisual/router 0.1.2 → 0.1.4

package/dist/ws.d.ts

@@ -1,860 +0,0 @@
-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';
-
-type ReconnectConfig = {
-    /**
-     * 重连配置选项, 最大重试次数，默认无限
-     */
-    maxRetries?: number;
-    /**
-     * 重连配置选项, 重试延迟(ms)，默认1000
-     */
-    retryDelay?: number;
-    /**
-     * 重连配置选项, 最大延迟(ms)，默认30000
-     */
-    maxDelay?: number;
-    /**
-     * 重连配置选项, 退避倍数，默认2
-     */
-    backoffMultiplier?: number;
-};
-/**
- * 一个支持自动重连的 WebSocket 客户端。
- * 在连接断开时会根据配置进行重连尝试，支持指数退避。
- */
-declare class ReconnectingWebSocket {
-    private ws;
-    private url;
-    private config;
-    private retryCount;
-    private reconnectTimer;
-    private isManualClose;
-    private messageHandlers;
-    private openHandlers;
-    private closeHandlers;
-    private errorHandlers;
-    constructor(url: string, config?: ReconnectConfig);
-    log(...args: any[]): void;
-    error(...args: any[]): void;
-    connect(): void;
-    private scheduleReconnect;
-    send(data: any): boolean;
-    onMessage(handler: (data: any) => void): void;
-    onOpen(handler: () => void): void;
-    onClose(handler: (code: number, reason: Buffer) => void): void;
-    onError(handler: (error: Error) => void): void;
-    close(): void;
-    getReadyState(): number;
-    getRetryCount(): number;
-}
-
-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 handleCallWsApp: (ws: ReconnectingWebSocket, app: App, message: any) => Promise<void>;
-declare const handleCallApp: (send: (data: any) => void, app: App, message: any) => Promise<void>;
-declare class Ws {
-    wsClient: ReconnectingWebSocket;
-    app: App;
-    showLog: boolean;
-    constructor(opts?: ReconnectConfig & {
-        url: string;
-        app: App;
-        showLog?: boolean;
-        handleMessage?: (ws: ReconnectingWebSocket, app: App, message: any) => void;
-    });
-    send(data: any): boolean;
-    log(...args: any[]): void;
-}
-
-export { ReconnectingWebSocket, Ws, handleCallApp, handleCallWsApp };
-export type { ReconnectConfig };