@kevisual/router 0.0.79 → 0.0.81

package/dist/router-browser.js

@@ -208,18 +208,14 @@ class CustomError extends Error {
   code;
   data;
   message;
-  tips;
-  constructor(code, message, tips) {
-    super(message || String(code));
-    this.name = "CustomError";
-    if (typeof code === "number") {
-      this.code = code;
-      this.message = message;
-    } else {
-      this.code = 500;
-      this.message = code;
-    }
-    this.tips = tips;
+  constructor(code, opts) {
+    let message = opts?.message || String(code);
+    const cause = opts?.cause;
+    super(message, { cause });
+    this.name = "RouterError";
+    let codeNum = opts?.code || (typeof code === "number" ? code : undefined);
+    this.code = codeNum ?? 500;
+    this.message = message;
     Error.captureStackTrace(this, this.constructor);
   }
   static fromCode(code) {
@@ -234,8 +230,7 @@ class CustomError extends Error {
     return {
       code: e?.code,
       data: e?.data,
-      message: e?.message,
-      tips: e?.tips
+      message: e?.message
     };
   }
   static isError(error) {
@@ -249,8 +244,7 @@ class CustomError extends Error {
       return {
         code: e2?.code,
         data: e2?.data,
-        message: e2?.message,
-        tips: e2?.tips
+        message: e2?.message
       };
     }
   }
@@ -13960,6 +13954,92 @@ var randomId = (length = 8, affix = "") => {
   return affix + nanoid3(length);
 };
 
+// src/validator/schema.ts
+var extractArgs = (args) => {
+  if (args && typeof args === "object" && typeof args.shape === "object") {
+    return args.shape;
+  }
+  return args || {};
+};
+var toJSONSchema2 = (args, opts) => {
+  const mergeObject = opts?.mergeObject ?? false;
+  if (!args)
+    return {};
+  const _override = ({ jsonSchema, path, zodSchema }) => {
+    if (Array.isArray(path) && path.length > 0) {
+      return;
+    }
+    const isOptional = zodSchema.isOptional?.();
+    if (isOptional) {
+      jsonSchema.optional = true;
+    }
+  };
+  const isError = (keys2) => {
+    const errorKeys = ["toJSONSchema", "def", "type", "parse"];
+    const hasErrorKeys = errorKeys.every((key) => keys2.includes(key));
+    return hasErrorKeys;
+  };
+  const override = opts?.override || _override;
+  if (mergeObject) {
+    if (typeof args === "object" && typeof args.toJSONSchema === "function") {
+      return args.toJSONSchema();
+    }
+    if (isError(Object.keys(args))) {
+      return {};
+    }
+    const schema = exports_external.object(args);
+    return schema.toJSONSchema();
+  }
+  args = extractArgs(args);
+  let keys = Object.keys(args);
+  if (isError(keys)) {
+    console.error(`[toJSONSchema error]: 解析到的 schema 可能不正确，包含了zod默认的value的schema. 请检查输入的 schema 是否正确。`);
+    args = {};
+    keys = [];
+  }
+  if (mergeObject) {}
+  let newArgs = {};
+  for (let key of keys) {
+    const item = args[key];
+    if (item && typeof item === "object" && typeof item.toJSONSchema === "function") {
+      newArgs[key] = item.toJSONSchema({ override });
+    } else {
+      newArgs[key] = args[key];
+    }
+  }
+  return newArgs;
+};
+var fromJSONSchema2 = (args = {}, opts) => {
+  let resultArgs = null;
+  const mergeObject = opts?.mergeObject ?? false;
+  if (args["$schema"] || args.type === "object" && args.properties && typeof args.properties === "object") {
+    const objectSchema = exports_external.fromJSONSchema(args);
+    const extract = extractArgs(objectSchema);
+    const keys = Object.keys(extract);
+    const newArgs = {};
+    for (let key of keys) {
+      newArgs[key] = extract[key];
+    }
+    resultArgs = newArgs;
+  }
+  if (!resultArgs) {
+    const keys = Object.keys(args);
+    const newArgs = {};
+    for (let key of keys) {
+      const item = args[key];
+      newArgs[key] = exports_external.fromJSONSchema(item);
+      if (item.optional) {
+        newArgs[key] = newArgs[key].optional();
+      }
+    }
+    resultArgs = newArgs;
+  }
+  if (mergeObject) {
+    resultArgs = exports_external.object(resultArgs);
+  }
+  return resultArgs;
+};
+
 // src/route.ts
 var pickValue = ["path", "key", "id", "description", "type", "middleware", "metadata"];
 var tool = {
@@ -14083,82 +14163,15 @@ class Route {
     throw new CustomError(...args);
   }
 }
-var extractArgs = (args) => {
-  if (args && typeof args === "object" && typeof args.shape === "object") {
-    return args.shape;
-  }
-  return args || {};
-};
 var toJSONSchemaRoute = (route) => {
   const pickValues = pick(route, pickValue);
   if (pickValues?.metadata?.args) {
-    let args = pickValues.metadata.args;
-    args = extractArgs(args);
-    const keys = Object.keys(args);
-    const newArgs = {};
-    for (let key of keys) {
-      const item = args[key];
-      if (item && typeof item === "object" && typeof item.toJSONSchema === "function") {
-        newArgs[key] = item.toJSONSchema();
-      } else {
-        newArgs[key] = args[key];
-      }
-    }
-    pickValues.metadata.args = newArgs;
+    pickValues.metadata.args = toJSONSchema3(pickValues?.metadata?.args, { mergeObject: false });
   }
   return pickValues;
 };
-var toJSONSchema2 = (args, opts) => {
-  const mergeObject = opts?.mergeObject ?? true;
-  if (!args)
-    return {};
-  if (mergeObject) {
-    if (typeof args === "object" && typeof args.toJSONSchema === "function") {
-      return args.toJSONSchema();
-    }
-    const schema = exports_external.object(args);
-    return schema.toJSONSchema();
-  }
-  args = extractArgs(args);
-  const keys = Object.keys(args);
-  let newArgs = {};
-  for (let key of keys) {
-    const item = args[key];
-    if (item && typeof item === "object" && typeof item.toJSONSchema === "function") {
-      newArgs[key] = item.toJSONSchema();
-    } else {
-      newArgs[key] = args[key];
-    }
-  }
-  return newArgs;
-};
-var fromJSONSchema2 = (args = {}, opts) => {
-  let resultArgs = null;
-  const mergeObject = opts?.mergeObject ?? true;
-  if (args["$schema"] || args.type === "object" && args.properties && typeof args.properties === "object") {
-    const objectSchema = exports_external.fromJSONSchema(args);
-    const extract = extractArgs(objectSchema);
-    const keys = Object.keys(extract);
-    const newArgs = {};
-    for (let key of keys) {
-      newArgs[key] = extract[key];
-    }
-    resultArgs = newArgs;
-  }
-  if (!resultArgs) {
-    const keys = Object.keys(args);
-    const newArgs = {};
-    for (let key of keys) {
-      const item = args[key];
-      newArgs[key] = exports_external.fromJSONSchema(item).optional();
-    }
-    resultArgs = newArgs;
-  }
-  if (mergeObject) {
-    resultArgs = exports_external.object(resultArgs);
-  }
-  return resultArgs;
-};
+var toJSONSchema3 = toJSONSchema2;
+var fromJSONSchema3 = fromJSONSchema2;
 
 class QueryRouter {
   appId = "";
@@ -14412,20 +14425,6 @@ class QueryRouter {
   getList(filter) {
     return this.routes.filter(filter || (() => true)).map((r) => {
       const pickValues = pick(r, pickValue);
-      if (pickValues?.metadata?.args) {
-        const args = pickValues.metadata.args;
-        const keys = Object.keys(args);
-        const newArgs = {};
-        for (let key of keys) {
-          const item = args[key];
-          if (item && typeof item === "object" && typeof item.toJSONSchema === "function") {
-            newArgs[key] = item.toJSONSchema();
-          } else {
-            newArgs[key] = args[key];
-          }
-        }
-        pickValues.metadata.args = newArgs;
-      }
       return pickValues;
     });
   }
@@ -14513,8 +14512,8 @@ class QueryRouter {
     }
     return listenProcess({ app: this, params, ...opts });
   }
-  toJSONSchema = toJSONSchema2;
-  fromJSONSchema = fromJSONSchema2;
+  toJSONSchema = toJSONSchema3;
+  fromJSONSchema = fromJSONSchema3;
 }
 
 class QueryRouterServer extends QueryRouter {
@@ -14753,8 +14752,8 @@ var App = QueryRouterServer;
 export {
   util,
   tool,
-  toJSONSchema2 as toJSONSchema,
-  fromJSONSchema2 as fromJSONSchema,
+  toJSONSchema3 as toJSONSchema,
+  fromJSONSchema3 as fromJSONSchema,
   define,
   createSkill,
   createSchema,

package/dist/router-define.d.ts

@@ -347,10 +347,15 @@ declare class QueryRouter {
     }): 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 = true>(args?: any, opts?: {
+    fromJSONSchema: <Merge extends boolean = false>(args?: any, opts?: {
         mergeObject?: boolean;
     }) => Merge extends true ? z.ZodObject<{
         [key: string]: any;

package/dist/router.d.ts

@@ -210,17 +210,17 @@ declare class Route<U = {
     }, opts?: AddOpts): void;
     throw(code?: number | string, message?: string, tips?: string): void;
 }
-/**
- * 剥离第一层schema，转换为JSON Schema，无论是skill还是其他的infer比纯粹的zod object schema更合适，因为它可能包含其他的字段，而不仅仅是schema
- * @param args
- * @returns
- */
 declare const toJSONSchema: (args: any, opts?: {
     mergeObject?: boolean;
+    override?: (opts: {
+        jsonSchema: any;
+        path: string[];
+        zodSchema: z.ZodTypeAny;
+    }) => void;
 }) => {
     [key: string]: any;
 };
-declare const fromJSONSchema: <Merge extends boolean = true>(args?: any, opts?: {
+declare const fromJSONSchema: <Merge extends boolean = false>(args?: any, opts?: {
     mergeObject?: boolean;
 }) => Merge extends true ? z.ZodObject<{
     [key: string]: any;
@@ -400,10 +400,15 @@ declare class QueryRouter {
     }): 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 = true>(args?: any, opts?: {
+    fromJSONSchema: <Merge extends boolean = false>(args?: any, opts?: {
         mergeObject?: boolean;
     }) => Merge extends true ? z.ZodObject<{
         [key: string]: any;
@@ -499,20 +504,23 @@ declare const createSchema: (rule: Rule) => z.ZodType<any, any, any>;
 
 type Schema = z.ZodType<any, any, any>;
 
+type CustomErrorOptions = {
+    cause?: Error | string;
+    code?: number;
+    message?: string;
+};
 /** 自定义错误 */
 declare class CustomError extends Error {
     code?: number;
     data?: any;
     message: string;
-    tips?: string;
-    constructor(code?: number | string, message?: string, tips?: string);
+    constructor(code?: number | string, opts?: CustomErrorOptions);
     static fromCode(code?: number): CustomError;
     static fromErrorData(code?: number, data?: any): CustomError;
     static parseError(e: CustomError): {
         code: number;
         data: any;
         message: string;
-        tips: string;
     };
     /**
      * 判断 throw 的错误是否不是当前这个错误
@@ -524,7 +532,6 @@ declare class CustomError extends Error {
         code: number;
         data: any;
         message: string;
-        tips: string;
     };
 }
 

package/dist/router.js

@@ -3019,18 +3019,14 @@ class CustomError extends Error {
   code;
   data;
   message;
-  tips;
-  constructor(code, message, tips) {
-    super(message || String(code));
-    this.name = "CustomError";
-    if (typeof code === "number") {
-      this.code = code;
-      this.message = message;
-    } else {
-      this.code = 500;
-      this.message = code;
-    }
-    this.tips = tips;
+  constructor(code, opts) {
+    let message = opts?.message || String(code);
+    const cause = opts?.cause;
+    super(message, { cause });
+    this.name = "RouterError";
+    let codeNum = opts?.code || (typeof code === "number" ? code : undefined);
+    this.code = codeNum ?? 500;
+    this.message = message;
     Error.captureStackTrace(this, this.constructor);
   }
   static fromCode(code) {
@@ -3045,8 +3041,7 @@ class CustomError extends Error {
     return {
       code: e?.code,
       data: e?.data,
-      message: e?.message,
-      tips: e?.tips
+      message: e?.message
     };
   }
   static isError(error) {
@@ -3060,8 +3055,7 @@ class CustomError extends Error {
       return {
         code: e2?.code,
         data: e2?.data,
-        message: e2?.message,
-        tips: e2?.tips
+        message: e2?.message
       };
     }
   }
@@ -16793,6 +16787,92 @@ var randomId = (length = 8, affix = "") => {
   return affix + nanoid3(length);
 };
 
+// src/validator/schema.ts
+var extractArgs = (args) => {
+  if (args && typeof args === "object" && typeof args.shape === "object") {
+    return args.shape;
+  }
+  return args || {};
+};
+var toJSONSchema2 = (args, opts) => {
+  const mergeObject = opts?.mergeObject ?? false;
+  if (!args)
+    return {};
+  const _override = ({ jsonSchema, path, zodSchema }) => {
+    if (Array.isArray(path) && path.length > 0) {
+      return;
+    }
+    const isOptional = zodSchema.isOptional?.();
+    if (isOptional) {
+      jsonSchema.optional = true;
+    }
+  };
+  const isError = (keys2) => {
+    const errorKeys = ["toJSONSchema", "def", "type", "parse"];
+    const hasErrorKeys = errorKeys.every((key) => keys2.includes(key));
+    return hasErrorKeys;
+  };
+  const override = opts?.override || _override;
+  if (mergeObject) {
+    if (typeof args === "object" && typeof args.toJSONSchema === "function") {
+      return args.toJSONSchema();
+    }
+    if (isError(Object.keys(args))) {
+      return {};
+    }
+    const schema = exports_external.object(args);
+    return schema.toJSONSchema();
+  }
+  args = extractArgs(args);
+  let keys = Object.keys(args);
+  if (isError(keys)) {
+    console.error(`[toJSONSchema error]: 解析到的 schema 可能不正确，包含了zod默认的value的schema. 请检查输入的 schema 是否正确。`);
+    args = {};
+    keys = [];
+  }
+  if (mergeObject) {}
+  let newArgs = {};
+  for (let key of keys) {
+    const item = args[key];
+    if (item && typeof item === "object" && typeof item.toJSONSchema === "function") {
+      newArgs[key] = item.toJSONSchema({ override });
+    } else {
+      newArgs[key] = args[key];
+    }
+  }
+  return newArgs;
+};
+var fromJSONSchema2 = (args = {}, opts) => {
+  let resultArgs = null;
+  const mergeObject = opts?.mergeObject ?? false;
+  if (args["$schema"] || args.type === "object" && args.properties && typeof args.properties === "object") {
+    const objectSchema = exports_external.fromJSONSchema(args);
+    const extract = extractArgs(objectSchema);
+    const keys = Object.keys(extract);
+    const newArgs = {};
+    for (let key of keys) {
+      newArgs[key] = extract[key];
+    }
+    resultArgs = newArgs;
+  }
+  if (!resultArgs) {
+    const keys = Object.keys(args);
+    const newArgs = {};
+    for (let key of keys) {
+      const item = args[key];
+      newArgs[key] = exports_external.fromJSONSchema(item);
+      if (item.optional) {
+        newArgs[key] = newArgs[key].optional();
+      }
+    }
+    resultArgs = newArgs;
+  }
+  if (mergeObject) {
+    resultArgs = exports_external.object(resultArgs);
+  }
+  return resultArgs;
+};
+
 // src/route.ts
 var pickValue = ["path", "key", "id", "description", "type", "middleware", "metadata"];
 var tool = {
@@ -16916,82 +16996,15 @@ class Route {
     throw new CustomError(...args);
   }
 }
-var extractArgs = (args) => {
-  if (args && typeof args === "object" && typeof args.shape === "object") {
-    return args.shape;
-  }
-  return args || {};
-};
 var toJSONSchemaRoute = (route) => {
   const pickValues = pick(route, pickValue);
   if (pickValues?.metadata?.args) {
-    let args = pickValues.metadata.args;
-    args = extractArgs(args);
-    const keys = Object.keys(args);
-    const newArgs = {};
-    for (let key of keys) {
-      const item = args[key];
-      if (item && typeof item === "object" && typeof item.toJSONSchema === "function") {
-        newArgs[key] = item.toJSONSchema();
-      } else {
-        newArgs[key] = args[key];
-      }
-    }
-    pickValues.metadata.args = newArgs;
+    pickValues.metadata.args = toJSONSchema3(pickValues?.metadata?.args, { mergeObject: false });
   }
   return pickValues;
 };
-var toJSONSchema2 = (args, opts) => {
-  const mergeObject = opts?.mergeObject ?? true;
-  if (!args)
-    return {};
-  if (mergeObject) {
-    if (typeof args === "object" && typeof args.toJSONSchema === "function") {
-      return args.toJSONSchema();
-    }
-    const schema = exports_external.object(args);
-    return schema.toJSONSchema();
-  }
-  args = extractArgs(args);
-  const keys = Object.keys(args);
-  let newArgs = {};
-  for (let key of keys) {
-    const item = args[key];
-    if (item && typeof item === "object" && typeof item.toJSONSchema === "function") {
-      newArgs[key] = item.toJSONSchema();
-    } else {
-      newArgs[key] = args[key];
-    }
-  }
-  return newArgs;
-};
-var fromJSONSchema2 = (args = {}, opts) => {
-  let resultArgs = null;
-  const mergeObject = opts?.mergeObject ?? true;
-  if (args["$schema"] || args.type === "object" && args.properties && typeof args.properties === "object") {
-    const objectSchema = exports_external.fromJSONSchema(args);
-    const extract = extractArgs(objectSchema);
-    const keys = Object.keys(extract);
-    const newArgs = {};
-    for (let key of keys) {
-      newArgs[key] = extract[key];
-    }
-    resultArgs = newArgs;
-  }
-  if (!resultArgs) {
-    const keys = Object.keys(args);
-    const newArgs = {};
-    for (let key of keys) {
-      const item = args[key];
-      newArgs[key] = exports_external.fromJSONSchema(item).optional();
-    }
-    resultArgs = newArgs;
-  }
-  if (mergeObject) {
-    resultArgs = exports_external.object(resultArgs);
-  }
-  return resultArgs;
-};
+var toJSONSchema3 = toJSONSchema2;
+var fromJSONSchema3 = fromJSONSchema2;
 
 class QueryRouter {
   appId = "";
@@ -17245,20 +17258,6 @@ class QueryRouter {
   getList(filter) {
     return this.routes.filter(filter || (() => true)).map((r) => {
       const pickValues = pick(r, pickValue);
-      if (pickValues?.metadata?.args) {
-        const args = pickValues.metadata.args;
-        const keys = Object.keys(args);
-        const newArgs = {};
-        for (let key of keys) {
-          const item = args[key];
-          if (item && typeof item === "object" && typeof item.toJSONSchema === "function") {
-            newArgs[key] = item.toJSONSchema();
-          } else {
-            newArgs[key] = args[key];
-          }
-        }
-        pickValues.metadata.args = newArgs;
-      }
       return pickValues;
     });
   }
@@ -17346,8 +17345,8 @@ class QueryRouter {
     }
     return listenProcess({ app: this, params, ...opts });
   }
-  toJSONSchema = toJSONSchema2;
-  fromJSONSchema = fromJSONSchema2;
+  toJSONSchema = toJSONSchema3;
+  fromJSONSchema = fromJSONSchema3;
 }
 
 class QueryRouterServer extends QueryRouter {
@@ -18545,9 +18544,9 @@ class App extends QueryRouter {
 export {
   util,
   tool,
-  toJSONSchema2 as toJSONSchema,
+  toJSONSchema3 as toJSONSchema,
   handleServer,
-  fromJSONSchema2 as fromJSONSchema,
+  fromJSONSchema3 as fromJSONSchema,
   define,
   createSkill,
   createSchema,

package/dist/ws.d.ts

@@ -397,10 +397,15 @@ declare class QueryRouter {
     }): 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 = true>(args?: any, opts?: {
+    fromJSONSchema: <Merge extends boolean = false>(args?: any, opts?: {
         mergeObject?: boolean;
     }) => Merge extends true ? z.ZodObject<{
         [key: string]: any;

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@kevisual/router",
-  "version": "0.0.79",
+  "version": "0.0.81",
   "description": "",
   "type": "module",
   "main": "./dist/router.js",
@@ -23,21 +23,21 @@
   "license": "MIT",
   "devDependencies": {
     "@kevisual/code-builder": "^0.0.6",
-    "@kevisual/context": "^0.0.6",
+    "@kevisual/context": "^0.0.8",
     "@kevisual/dts": "^0.0.4",
     "@kevisual/js-filter": "^0.0.5",
     "@kevisual/local-proxy": "^0.0.8",
-    "@kevisual/query": "^0.0.47",
+    "@kevisual/query": "^0.0.49",
     "@kevisual/use-config": "^1.0.30",
-    "@opencode-ai/plugin": "^1.2.6",
+    "@opencode-ai/plugin": "^1.2.10",
     "@types/bun": "^1.3.9",
-    "@types/node": "^25.2.3",
+    "@types/node": "^25.3.0",
     "@types/send": "^1.2.1",
     "@types/ws": "^8.18.1",
     "@types/xml2js": "^0.4.14",
     "eventemitter3": "^5.0.4",
     "fast-glob": "^3.3.3",
-    "hono": "^4.11.9",
+    "hono": "^4.12.0",
     "nanoid": "^5.1.6",
     "path-to-regexp": "^8.3.0",
     "send": "^1.2.1",