@kevisual/router 0.2.10 → 0.2.12

package/dist/router-define.d.ts

@@ -26,6 +26,57 @@ declare class MockProcess {
     desctroy(): void;
 }
 
+/** 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 : {};
+/** 从 API 定义中提取 metadata.returns */
+type ExtractReturns<T> = T extends {
+    metadata: {
+        returns: infer R;
+    };
+} ? R : unknown;
+/** runAction 第二个参数的类型，根据第一个参数的 metadata.args 推断 */
+type RunActionPayload<T> = ArgsToPayload<ExtractArgs<T>>;
+/** runAction 的返回类型，根据 API 定义中的 metadata.returns 推断 data 字段类型 */
+type RunActionReturns<T> = {
+    code: number | string;
+    data?: unknown extends ExtractReturns<T> ? any : ArgsToPayload<ExtractReturns<T>>;
+    message?: string;
+    [key: string]: any;
+};
+
 type RouterContextT = {
     code?: number;
     [key: string]: any;
@@ -466,8 +517,9 @@ declare class QueryRouterServer<C extends SimpleObject$1 = SimpleObject$1> exten
         key?: string;
         metadata?: {
             args?: any;
+            returns?: any;
         };
-    } = {}>(api: T, payload: RunActionPayload<T>, ctx?: RouteContext<C>): Promise<any>;
+    } = {}>(api: T, payload: RunActionPayload<T>, ctx?: RouteContext<C>): Promise<RunActionReturns<T>>;
     /**
      * 创建认证相关的中间件，默认是 auth, auth-admin, auth-can 三个中间件
      * @param fun 认证函数，接收 RouteContext 和认证类型
@@ -476,43 +528,6 @@ declare class QueryRouterServer<C extends SimpleObject$1 = SimpleObject$1> exten
         overwrite?: boolean;
     }): Promise<void>;
 }
-/** 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 RouteObject = {
     [key: string]: RouteOpts;

package/dist/router-simple.js

@@ -30,7 +30,7 @@ var __toESM = (mod, isNodeMode, target) => {
 };
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 
-// node_modules/path-to-regexp/dist/index.js
+// node_modules/.pnpm/path-to-regexp@8.4.2/node_modules/path-to-regexp/dist/index.js
 var require_dist = __commonJS((exports) => {
   Object.defineProperty(exports, "__esModule", { value: true });
   exports.PathError = exports.TokenData = undefined;

package/dist/router.d.ts

@@ -59,6 +59,80 @@ 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 ListenProcessOptions = {
+    app?: QueryRouterServer;
+    mockProcess?: MockProcess;
+    params?: ListenProcessParams;
+    timeout?: number;
+};
+declare const listenProcess: ({ app, mockProcess, params, timeout }: ListenProcessOptions) => Promise<void>;
+
+/** 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 : {};
+/** 从 API 定义中提取 metadata.returns */
+type ExtractReturns<T> = T extends {
+    metadata: {
+        returns: infer R;
+    };
+} ? R : unknown;
+/** runAction 第二个参数的类型，根据第一个参数的 metadata.args 推断 */
+type RunActionPayload<T> = ArgsToPayload<ExtractArgs<T>>;
+/** runAction 的返回类型，根据 API 定义中的 metadata.returns 推断 data 字段类型 */
+type RunActionReturns<T> = {
+    code: number | string;
+    data?: unknown extends ExtractReturns<T> ? any : ArgsToPayload<ExtractReturns<T>>;
+    message?: string;
+    [key: string]: any;
+};
 
 type RouterContextT = {
     code?: number;
@@ -531,8 +605,9 @@ declare class QueryRouterServer<C extends SimpleObject$1 = SimpleObject$1> exten
         key?: string;
         metadata?: {
             args?: any;
+            returns?: any;
         };
-    } = {}>(api: T, payload: RunActionPayload<T>, ctx?: RouteContext<C>): Promise<any>;
+    } = {}>(api: T, payload: RunActionPayload<T>, ctx?: RouteContext<C>): Promise<RunActionReturns<T>>;
     /**
      * 创建认证相关的中间件，默认是 auth, auth-admin, auth-can 三个中间件
      * @param fun 认证函数，接收 RouteContext 和认证类型
@@ -543,43 +618,6 @@ declare class QueryRouterServer<C extends SimpleObject$1 = SimpleObject$1> exten
 }
 declare class Mini extends QueryRouterServer {
 }
-/** 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 BaseRule = {
     value?: any;
@@ -1088,5 +1126,5 @@ declare class App<U = {}> extends QueryRouterServer<AppRouteContext<U>> {
     onServerRequest(fn: (req: IncomingMessage$1, res: ServerResponse$1) => void): void;
 }
 
-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 };
+export { App, CustomError, Mini, MockProcess, QueryRouter, QueryRouterServer, QueryUtil, Route, ServerNode, createSchema, createSkill, define, fromJSONSchema, handleServer, listenProcess, toJSONSchema, tool, util };
+export type { HttpListenerFun, ListenProcessOptions, ListenProcessParams, ListenProcessResponse, Listener, OnListener, OnWebSocketFn, RouteArray, RouteContext, RouteInfo, RouteMiddleware, RouteObject, RouteOpts, RouterReq, RouterRes, Rule, Run, Schema, Skill, WS, WebSocketListenerFun, WebSocketReq, WebSocketRes };