@lsby/net-core 0.9.3 → 0.10.1

package/dist/cjs/{interface-base-_3j8cNEe.d.cts → interface-base-CyfrfgWu.d.cts}

@@ -137,6 +137,15 @@ declare abstract class 接口结果转换器<实现错误类型 extends 接口
     abstract 实现(数据: Either<实现错误类型, 实现正确类型>): 接口错误形式 | 接口正确形式;
 }
 type 任意接口结果转换器 = 接口结果转换器<any, any, any, any>;
+/**
+ * 常用形式转换器
+ *
+ * 将业务逻辑返回的 Either<错误, 成功> 转换为前端友好的统一格式:
+ * - 成功时: { status: 'success', data: ... }
+ * - 失败时: { status: 'fail', data: ... }
+ *
+ * 这种格式让前端可以通过 status 字段统一判断请求是否成功
+ */
 declare class 常用形式转换器<实现错误类型 extends 接口逻辑错误类型, 实现正确类型 extends 接口逻辑正确类型> extends 接口结果转换器<实现错误类型, 实现正确类型, {
     status: 'fail';
     data: 实现错误类型;
@@ -152,8 +161,27 @@ declare class 常用形式转换器<实现错误类型 extends 接口逻辑错
         data: 实现正确类型;
     };
 }
-declare class 常用延时直接形式转换器<实现最终返回类型, 实现错误类型 extends 接口逻辑错误类型, 实现正确类型 extends {
-    fn: () => 实现最终返回类型;
+/**
+ * 直接形式转换器
+ *
+ * 将业务逻辑返回的 Either<错误, {data: ...}> 转换为直接格式:
+ * - 成功时: 直接的 data 内容
+ * - 失败时: { status: 'fail', data: ... }
+ *
+ * 用于需要直接返回的场景:
+ * - 因为接口逻辑需要组合, 所以返回值必须是对象, 但有时候需要返回一个非对象数据
+ * - 这个转换器就约定了一个模式, 用于返回直接结果
+ * - 业务逻辑需要返回 Either<错误, 成功>, 其中成功部分必须是 { data: 真正的返回值 }
+ * - 如果返回左值，返回标准错误格式 { status: 'fail', data: ... }
+ * - 如果返回右值，直接返回 data 部分
+ *
+ * 典型应用场景:
+ * - 文件下载: 直接返回文件流
+ * - 图片/视频: 直接返回二进制数据
+ * - SSE/WebSocket: 建立长连接
+ */
+declare class 直接形式转换器<实现最终返回类型, 实现错误类型 extends 接口逻辑错误类型, 实现正确类型 extends {
+    data: 实现最终返回类型;
 }> extends 接口结果转换器<实现错误类型, 实现正确类型, {
     status: 'fail';
     data: 实现错误类型;
@@ -203,4 +231,4 @@ type 获得接口正确形式<A> = A extends 接口<any, any, any, any, infer X,
 type 获得接口结果转换器类型<A> = A extends 接口<any, any, any, any, any, infer X, any> ? X : never;
 type 获得接口结果返回器类型<A> = A extends 接口<any, any, any, any, any, any, infer X> ? X : never;
 
-export { type 插件项类型 as A, type 取插件内部ts类型 as B, type 接口方法类型 as a, 接口 as b, type 获得接口方法类型 as c, type 获得接口逻辑类型 as d, type 获得接口错误形式 as e, type 获得接口正确形式 as f, type 获得接口结果转换器类型 as g, type 获得接口结果返回器类型 as h, type 接口逻辑错误类型 as i, type 接口逻辑正确类型 as j, type 接口逻辑附加参数类型 as k, 接口逻辑Base as l, 接口逻辑 as m, type 任意接口逻辑 as n, type 获得接口逻辑插件类型 as o, type 获得接口逻辑附加参数类型 as p, type 获得接口逻辑错误类型 as q, type 获得接口逻辑正确类型 as r, type 获得接口逻辑上游接口类型 as s, type 获得接口逻辑最后接口类型 as t, type 计算接口逻辑错误结果 as u, type 计算接口逻辑正确结果 as v, 接口结果转换器 as w, type 任意接口结果转换器 as x, 常用延时直接形式转换器 as y, type 任意插件 as z, type 任意接口 as 任, type 兼容空对象 as 兼, type 取插件内部类型 as 取, type 可调用接口逻辑 as 可, type 合并插件结果 as 合, 常用形式转换器 as 常, type 接口路径类型 as 接, 插件 as 插, 服务器 as 服, type 清理函数类型 as 清, type 空对象 as 空, type 获得接口路径类型 as 获, type 计算接口逻辑参数 as 计, type 请求附加参数类型 as 请 };
+export { type 取插件内部ts类型 as A, type 接口方法类型 as a, 接口 as b, type 获得接口方法类型 as c, type 获得接口逻辑类型 as d, type 获得接口错误形式 as e, type 获得接口正确形式 as f, type 获得接口结果转换器类型 as g, type 获得接口结果返回器类型 as h, type 接口逻辑错误类型 as i, type 接口逻辑正确类型 as j, type 接口逻辑附加参数类型 as k, 接口逻辑Base as l, 接口逻辑 as m, type 任意接口逻辑 as n, type 获得接口逻辑插件类型 as o, type 获得接口逻辑附加参数类型 as p, type 获得接口逻辑错误类型 as q, type 获得接口逻辑正确类型 as r, type 获得接口逻辑上游接口类型 as s, type 获得接口逻辑最后接口类型 as t, type 计算接口逻辑错误结果 as u, type 计算接口逻辑正确结果 as v, 接口结果转换器 as w, type 任意接口结果转换器 as x, type 任意插件 as y, type 插件项类型 as z, type 任意接口 as 任, type 兼容空对象 as 兼, type 取插件内部类型 as 取, type 可调用接口逻辑 as 可, type 合并插件结果 as 合, 常用形式转换器 as 常, type 接口路径类型 as 接, 插件 as 插, 服务器 as 服, type 清理函数类型 as 清, 直接形式转换器 as 直, type 空对象 as 空, type 获得接口路径类型 as 获, type 计算接口逻辑参数 as 计, type 请求附加参数类型 as 请 };

package/dist/cjs/plugin/extend/custom-data.d.cts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { 插 as __ } from '../../interface-base-_3j8cNEe.cjs';
+import { 插 as __ } from '../../interface-base-CyfrfgWu.cjs';
 import '@lsby/ts-fp-data';
 import 'express';
 import '../../help/interior.cjs';
@@ -7,6 +7,9 @@ import '@lsby/ts-log';
 import 'node:http';
 import '../../interface/interface-retuen.cjs';
 
+/**
+ * 该插件允许使用者给定任意的数据, 该数据将作为该插件的返回值, 最终传入到接口逻辑中
+ */
 declare class 自定义数据插件<Data extends z.AnyZodObject> extends __<Data> {
     constructor(t: Data, data: z.infer<Data>);
 }

package/dist/cjs/plugin/extend/json.cjs

@@ -35,6 +35,7 @@ __export(json_exports, {
 module.exports = __toCommonJS(json_exports);
 var import_express = __toESM(require("express"), 1);
 var import_node_util = require("util");
+var import_zod = require("zod");
 
 // src/help/interior.ts
 function \u622A\u65AD\u5B57\u7B26\u4E32(\u5185\u5BB9) {
@@ -74,7 +75,7 @@ var \u70D9\u5370 = Symbol();
 var JSON\u89E3\u6790\u63D2\u4EF6 = class extends \u63D2\u4EF6 {
   [\u70D9\u5370] = ["JSON\u89E3\u6790\u63D2\u4EF6"];
   constructor(t, opt) {
-    super(t, async (req, res, \u9644\u52A0\u53C2\u6570) => {
+    super(import_zod.z.object({ body: t }), async (req, res, \u9644\u52A0\u53C2\u6570) => {
       let log = \u9644\u52A0\u53C2\u6570.log.extend("JSON\u89E3\u6790\u63D2\u4EF6");
       await new Promise(
         (pRes, _rej) => import_express.default.json(opt)(req, res, () => {
@@ -88,7 +89,7 @@ var JSON\u89E3\u6790\u63D2\u4EF6 = class extends \u63D2\u4EF6 {
         throw new Error((0, import_node_util.format)("\u89E3\u6790 JSON \u5931\u8D25: %o", parseResult.error));
       }
       await log.debug("\u6210\u529F\u89E3\u6790 JSON");
-      return parseResult.data;
+      return { body: parseResult.data };
     });
   }
 };

package/dist/cjs/plugin/extend/json.d.cts

@@ -1,6 +1,7 @@
 import express from 'express';
 import { AnyZodObject, z } from 'zod';
-import { 插 as __, A as _____, 取 as _______, o as __________ } from '../../interface-base-_3j8cNEe.cjs';
+import { 严格递归合并对象 as ________ } from '../../help/help.cjs';
+import { 插 as __, z as _____, 取 as _______, o as __________ } from '../../interface-base-CyfrfgWu.cjs';
 import '@lsby/ts-fp-data';
 import '../../help/interior.cjs';
 import '@lsby/ts-log';
@@ -8,13 +9,17 @@ import 'node:http';
 import '../../interface/interface-retuen.cjs';
 
 declare const 烙印: unique symbol;
-declare class JSON解析插件<Result extends AnyZodObject> extends __<Result> {
+declare class JSON解析插件<Result extends AnyZodObject> extends __<z.ZodObject<{
+    body: Result;
+}>> {
     private [烙印];
     constructor(t: Result, opt: Parameters<typeof express.json>[0]);
 }
 type 任意JSON解析插件 = JSON解析插件<any>;
 type 任意JSON解析插件项 = 任意JSON解析插件;
-type 合并JSON插件结果<Arr extends Array<_____>> = Arr extends [] ? {} : Arr extends [infer x, ...infer xs] ? x extends infer 插件项 ? xs extends Array<_____> ? 插件项 extends 任意JSON解析插件项 ? z.infer<_______<插件项>> & 合并JSON插件结果<xs> : 合并JSON插件结果<xs> : {} : {} : {};
+type 合并JSON插件结果<Arr extends Array<_____>> = Arr extends [] ? {} : Arr extends [infer x, ...infer xs] ? x extends infer 插件项 ? xs extends Array<_____> ? 插件项 extends 任意JSON解析插件项 ? ________<{
+    body: z.infer<_______<插件项>>['body'];
+}, 合并JSON插件结果<xs>> : 合并JSON插件结果<xs> : {} : {} : {};
 type 计算接口逻辑JSON参数<接口逻辑> = 合并JSON插件结果<__________<接口逻辑>>;
 
 export { JSON解析插件, type 任意JSON解析插件, type 任意JSON解析插件项, type 合并JSON插件结果, type 计算接口逻辑JSON参数 };

package/dist/cjs/plugin/extend/log-headers.d.cts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { 插 as __ } from '../../interface-base-_3j8cNEe.cjs';
+import { 插 as __ } from '../../interface-base-CyfrfgWu.cjs';
 import '@lsby/ts-fp-data';
 import 'express';
 import '../../help/interior.cjs';

package/dist/cjs/plugin/extend/query.cjs

@@ -24,6 +24,7 @@ __export(query_exports, {
 });
 module.exports = __toCommonJS(query_exports);
 var import_node_util = require("util");
+var import_zod = require("zod");
 
 // src/help/interior.ts
 function \u622A\u65AD\u5B57\u7B26\u4E32(\u5185\u5BB9) {
@@ -63,7 +64,7 @@ var \u70D9\u5370 = Symbol();
 var GET\u53C2\u6570\u89E3\u6790\u63D2\u4EF6 = class extends \u63D2\u4EF6 {
   [\u70D9\u5370] = ["GET\u53C2\u6570\u89E3\u6790\u63D2\u4EF6"];
   constructor(t) {
-    super(t, async (req, _res, \u9644\u52A0\u53C2\u6570) => {
+    super(import_zod.z.object({ query: t }), async (req, _res, \u9644\u52A0\u53C2\u6570) => {
       let log = \u9644\u52A0\u53C2\u6570.log.extend("GET\u53C2\u6570\u89E3\u6790\u63D2\u4EF6");
       await log.debug("\u51C6\u5907\u89E3\u6790 GET \u53C2\u6570\uFF1A%o", JSON.stringify(\u9012\u5F52\u622A\u65AD\u5B57\u7B26\u4E32(req.query)));
       let parseResult = t.safeParse(req.query);
@@ -72,7 +73,7 @@ var GET\u53C2\u6570\u89E3\u6790\u63D2\u4EF6 = class extends \u63D2\u4EF6 {
         throw new Error((0, import_node_util.format)("\u89E3\u6790 GET \u53C2\u6570\u5931\u8D25: %o", parseResult.error));
       }
       await log.debug("\u6210\u529F\u89E3\u6790 GET \u53C2\u6570");
-      return parseResult.data;
+      return { query: parseResult.data };
     });
   }
 };

package/dist/cjs/plugin/extend/query.d.cts

@@ -1,5 +1,6 @@
 import { AnyZodObject, z } from 'zod';
-import { 插 as __, A as _____, 取 as _______, o as __________ } from '../../interface-base-_3j8cNEe.cjs';
+import { 严格递归合并对象 as ________ } from '../../help/help.cjs';
+import { 插 as __, z as _____, 取 as _______, o as __________ } from '../../interface-base-CyfrfgWu.cjs';
 import '@lsby/ts-fp-data';
 import 'express';
 import '../../help/interior.cjs';
@@ -8,13 +9,17 @@ import 'node:http';
 import '../../interface/interface-retuen.cjs';
 
 declare const 烙印: unique symbol;
-declare class GET参数解析插件<Result extends AnyZodObject> extends __<Result> {
+declare class GET参数解析插件<Result extends AnyZodObject> extends __<z.ZodObject<{
+    query: Result;
+}>> {
     private [烙印];
     constructor(t: Result);
 }
 type 任意GET参数解析插件 = GET参数解析插件<any>;
 type 任意GET参数解析插件项 = 任意GET参数解析插件;
-type 合并GET插件结果<Arr extends Array<_____>> = Arr extends [] ? {} : Arr extends [infer x, ...infer xs] ? x extends infer 插件项 ? xs extends Array<_____> ? 插件项 extends 任意GET参数解析插件项 ? z.infer<_______<插件项>> & 合并GET插件结果<xs> : 合并GET插件结果<xs> : {} : {} : {};
+type 合并GET插件结果<Arr extends Array<_____>> = Arr extends [] ? {} : Arr extends [infer x, ...infer xs] ? x extends infer 插件项 ? xs extends Array<_____> ? 插件项 extends 任意GET参数解析插件项 ? ________<{
+    query: z.infer<_______<插件项>>['query'];
+}, 合并GET插件结果<xs>> : 合并GET插件结果<xs> : {} : {} : {};
 type 计算接口逻辑GET参数<接口逻辑> = 合并GET插件结果<__________<接口逻辑>>;
 
 export { GET参数解析插件, type 任意GET参数解析插件, type 任意GET参数解析插件项, type 合并GET插件结果, type 计算接口逻辑GET参数 };

package/dist/cjs/plugin/extend/urlencoded.cjs

@@ -35,6 +35,7 @@ __export(urlencoded_exports, {
 module.exports = __toCommonJS(urlencoded_exports);
 var import_express = __toESM(require("express"), 1);
 var import_node_util = require("util");
+var import_zod = require("zod");
 
 // src/plugin/plug.ts
 var \u63D2\u4EF6 = class {
@@ -53,8 +54,8 @@ var \u63D2\u4EF6 = class {
 // src/plugin/extend/urlencoded.ts
 var \u8868\u5355\u89E3\u6790\u63D2\u4EF6 = class extends \u63D2\u4EF6 {
   constructor(t, opt) {
-    super(t, async (req, res, \u9644\u52A0\u53C2\u6570) => {
-      let log = \u9644\u52A0\u53C2\u6570.log.extend("JSON\u89E3\u6790\u63D2\u4EF6");
+    super(import_zod.z.object({ form: t }), async (req, res, \u9644\u52A0\u53C2\u6570) => {
+      let log = \u9644\u52A0\u53C2\u6570.log.extend("\u8868\u5355\u89E3\u6790\u63D2\u4EF6");
       await new Promise(
         (pRes, _rej) => import_express.default.urlencoded({ extended: true, ...opt })(req, res, () => {
           pRes(null);
@@ -65,7 +66,7 @@ var \u8868\u5355\u89E3\u6790\u63D2\u4EF6 = class extends \u63D2\u4EF6 {
         await log.error("\u89E3\u6790url\u7F16\u7801\u6B63\u6587\u5931\u8D25: %o", parseResult.error);
         throw new Error((0, import_node_util.format)("\u89E3\u6790url\u7F16\u7801\u6B63\u6587\u5931\u8D25: %o", parseResult.error));
       }
-      return parseResult.data;
+      return { form: parseResult.data };
     });
   }
 };

package/dist/cjs/plugin/extend/urlencoded.d.cts

@@ -1,13 +1,15 @@
 import express from 'express';
 import { z } from 'zod';
-import { 插 as __ } from '../../interface-base-_3j8cNEe.cjs';
+import { 插 as __ } from '../../interface-base-CyfrfgWu.cjs';
 import '@lsby/ts-fp-data';
 import '../../help/interior.cjs';
 import '@lsby/ts-log';
 import 'node:http';
 import '../../interface/interface-retuen.cjs';
 
-declare class 表单解析插件<Result extends z.AnyZodObject> extends __<Result> {
+declare class 表单解析插件<Result extends z.AnyZodObject> extends __<z.ZodObject<{
+    form: Result;
+}>> {
     constructor(t: Result, opt: Parameters<typeof express.urlencoded>[0]);
 }
 

package/dist/cjs/plugin/extend/web-socket.cjs

@@ -34,11 +34,14 @@ var log = new import_ts_log.Log("@lsby:net-core");
 var WebSocket\u7BA1\u7406\u5668 = class {
   constructor(\u8FDE\u63A5\u8868) {
     this.\u8FDE\u63A5\u8868 = \u8FDE\u63A5\u8868;
-    this.\u5B9A\u65F6\u5668ID = setInterval(() => {
-      this.\u6E05\u7406\u65E0\u6548\u8FDE\u63A5().catch((err) => {
-        this.log.error(`\u6E05\u7406\u65E0\u6548\u8FDE\u63A5\u5931\u8D25: ${err}`).catch((a) => `\u65E5\u5FD7\u8F93\u51FA\u9519\u8BEF: ${a}: \u65E5\u5FD7\u5185\u5BB9: ${`\u6E05\u7406\u65E0\u6548\u8FDE\u63A5\u5931\u8D25: ${err}`}`);
-      });
-    }, 3e4);
+    this.\u5B9A\u65F6\u5668ID = setInterval(
+      () => {
+        this.\u6E05\u7406\u65E0\u6548\u8FDE\u63A5().catch((err) => {
+          this.log.error(`\u6E05\u7406\u65E0\u6548\u8FDE\u63A5\u5931\u8D25: ${err}`).catch((a) => `\u65E5\u5FD7\u8F93\u51FA\u9519\u8BEF: ${a}: \u65E5\u5FD7\u5185\u5BB9: ${`\u6E05\u7406\u65E0\u6548\u8FDE\u63A5\u5931\u8D25: ${err}`}`);
+        });
+      },
+      5 * 60 * 1e3
+    );
   }
   log = log.extend("@lsby:net-core").extend("WebSocket\u7BA1\u7406\u5668");
   \u6E05\u7406\u51FD\u6570\u8868 = {};

package/dist/cjs/plugin/extend/web-socket.d.cts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { 插 as __, A as _____ } from '../../interface-base-_3j8cNEe.cjs';
+import { 插 as __, z as _____ } from '../../interface-base-CyfrfgWu.cjs';
 import '@lsby/ts-fp-data';
 import 'express';
 import '../../help/interior.cjs';

package/dist/cjs/plugin/plug.d.cts

@@ -1,6 +1,6 @@
 import 'express';
 import 'zod';
-export { z as 任意插件, B as 取插件内部ts类型, 取 as 取插件内部类型, 合 as 合并插件结果, 插 as 插件, A as 插件项类型 } from '../interface-base-_3j8cNEe.cjs';
+export { y as 任意插件, A as 取插件内部ts类型, 取 as 取插件内部类型, 合 as 合并插件结果, 插 as 插件, z as 插件项类型 } from '../interface-base-CyfrfgWu.cjs';
 import '@lsby/ts-fp-data';
 import '../help/interior.cjs';
 import '@lsby/ts-log';

package/dist/cjs/server/server.cjs

@@ -47,11 +47,14 @@ var log = new import_ts_log.Log("@lsby:net-core");
 var WebSocket\u7BA1\u7406\u5668 = class {
   constructor(\u8FDE\u63A5\u8868) {
     this.\u8FDE\u63A5\u8868 = \u8FDE\u63A5\u8868;
-    this.\u5B9A\u65F6\u5668ID = setInterval(() => {
-      this.\u6E05\u7406\u65E0\u6548\u8FDE\u63A5().catch((err) => {
-        this.log.error(`\u6E05\u7406\u65E0\u6548\u8FDE\u63A5\u5931\u8D25: ${err}`).catch((a) => `\u65E5\u5FD7\u8F93\u51FA\u9519\u8BEF: ${a}: \u65E5\u5FD7\u5185\u5BB9: ${`\u6E05\u7406\u65E0\u6548\u8FDE\u63A5\u5931\u8D25: ${err}`}`);
-      });
-    }, 3e4);
+    this.\u5B9A\u65F6\u5668ID = setInterval(
+      () => {
+        this.\u6E05\u7406\u65E0\u6548\u8FDE\u63A5().catch((err) => {
+          this.log.error(`\u6E05\u7406\u65E0\u6548\u8FDE\u63A5\u5931\u8D25: ${err}`).catch((a) => `\u65E5\u5FD7\u8F93\u51FA\u9519\u8BEF: ${a}: \u65E5\u5FD7\u5185\u5BB9: ${`\u6E05\u7406\u65E0\u6548\u8FDE\u63A5\u5931\u8D25: ${err}`}`);
+        });
+      },
+      5 * 60 * 1e3
+    );
   }
   log = log.extend("@lsby:net-core").extend("WebSocket\u7BA1\u7406\u5668");
   \u6E05\u7406\u51FD\u6570\u8868 = {};

package/dist/cjs/server/server.d.cts

@@ -1,6 +1,6 @@
 import '@lsby/ts-log';
 import 'node:http';
-export { 服 as 服务器, 请 as 请求附加参数类型 } from '../interface-base-_3j8cNEe.cjs';
+export { 服 as 服务器, 请 as 请求附加参数类型 } from '../interface-base-CyfrfgWu.cjs';
 import 'zod';
 import '@lsby/ts-fp-data';
 import 'express';

package/dist/cjs/wrapper/common-wrapper-return.cjs

@@ -20,7 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/wrapper/common-wrapper-return.ts
 var common_wrapper_return_exports = {};
 __export(common_wrapper_return_exports, {
-  \u5E38\u7528\u5F62\u5F0F\u5E76\u81EA\u5B9A\u4E49\u8FD4\u56DE\u63A5\u53E3\u5C01\u88C5: () => \u5E38\u7528\u5F62\u5F0F\u5E76\u81EA\u5B9A\u4E49\u8FD4\u56DE\u63A5\u53E3\u5C01\u88C5
+  \u5E38\u7528\u5F62\u5F0F\u5E76\u81EA\u5B9A\u4E49\u8FD4\u56DE\u5668\u63A5\u53E3\u5C01\u88C5: () => \u5E38\u7528\u5F62\u5F0F\u5E76\u81EA\u5B9A\u4E49\u8FD4\u56DE\u5668\u63A5\u53E3\u5C01\u88C5
 });
 module.exports = __toCommonJS(common_wrapper_return_exports);
 var import_zod = require("zod");
@@ -92,7 +92,7 @@ var \u81EA\u5B9A\u4E49\u8FD4\u56DE\u5668 = class extends \u63A5\u53E3\u7ED3\u679
 };
 
 // src/wrapper/common-wrapper-return.ts
-var \u5E38\u7528\u5F62\u5F0F\u5E76\u81EA\u5B9A\u4E49\u8FD4\u56DE\u63A5\u53E3\u5C01\u88C5 = class extends \u63A5\u53E3 {
+var \u5E38\u7528\u5F62\u5F0F\u5E76\u81EA\u5B9A\u4E49\u8FD4\u56DE\u5668\u63A5\u53E3\u5C01\u88C5 = class extends \u63A5\u53E3 {
   constructor(\u8BF7\u6C42\u8DEF\u5F84, \u8BF7\u6C42\u65B9\u6CD5, \u63A5\u53E3\u903B\u8F91, \u903B\u8F91\u9519\u8BEF\u7C7B\u578BZod, \u903B\u8F91\u6B63\u786E\u7C7B\u578BZod, \u8FD4\u56DE\u5668\u5B9E\u73B0) {
     let \u63A5\u53E3\u9519\u8BEF\u8F93\u51FA\u5F62\u5F0F = import_zod.z.object({ status: import_zod.z.literal("fail"), data: \u903B\u8F91\u9519\u8BEF\u7C7B\u578BZod });
     let \u63A5\u53E3\u6B63\u786E\u8F93\u51FA\u5F62\u5F0F = import_zod.z.object({ status: import_zod.z.literal("success"), data: \u903B\u8F91\u6B63\u786E\u7C7B\u578BZod });
@@ -102,5 +102,5 @@ var \u5E38\u7528\u5F62\u5F0F\u5E76\u81EA\u5B9A\u4E49\u8FD4\u56DE\u63A5\u53E3\u5C
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  \u5E38\u7528\u5F62\u5F0F\u5E76\u81EA\u5B9A\u4E49\u8FD4\u56DE\u63A5\u53E3\u5C01\u88C5
+  \u5E38\u7528\u5F62\u5F0F\u5E76\u81EA\u5B9A\u4E49\u8FD4\u56DE\u5668\u63A5\u53E3\u5C01\u88C5
 });

package/dist/cjs/wrapper/common-wrapper-return.d.cts

@@ -1,13 +1,22 @@
 import { Request, Response } from 'express';
 import { z } from 'zod';
-import { 接 as ______, a as ______$1, l as ____Base, 空 as ___, b as __, 常 as _______, q as __________, r as __________$1 } from '../interface-base-_3j8cNEe.cjs';
+import { 接 as ______, a as ______$1, l as ____Base, 空 as ___, b as __, 常 as _______, q as __________, r as __________$1 } from '../interface-base-CyfrfgWu.cjs';
 import { 自定义返回器 as ______$2 } from '../interface/interface-retuen.cjs';
 import '@lsby/ts-fp-data';
 import '../help/interior.cjs';
 import '@lsby/ts-log';
 import 'node:http';
 
-declare class 常用形式并自定义返回接口封装<路径类型 extends ______, 方法类型 extends ______$1, 逻辑类型 extends ____Base<any, ___, z.infer<接口错误形式Zod>, z.infer<接口正确形式Zod>, any, any>, 接口错误形式Zod extends z.ZodTypeAny, 接口正确形式Zod extends z.ZodTypeAny> extends __<路径类型, 方法类型, 逻辑类型, z.ZodObject<{
+/**
+ * 常用形式并自定义返回器接口封装
+ *
+ * 类似于 常用形式接口封装, 但允许自定义返回逻辑
+ *
+ * 组合了:
+ * - 常用形式转换器: 将逻辑结果转换为 { status: 'success/fail', data: ... } 格式
+ * - 自定义返回器: 自定义的返回器
+ */
+declare class 常用形式并自定义返回器接口封装<路径类型 extends ______, 方法类型 extends ______$1, 逻辑类型 extends ____Base<any, ___, z.infer<接口错误形式Zod>, z.infer<接口正确形式Zod>, any, any>, 接口错误形式Zod extends z.ZodTypeAny, 接口正确形式Zod extends z.ZodTypeAny> extends __<路径类型, 方法类型, 逻辑类型, z.ZodObject<{
     status: z.ZodLiteral<'fail'>;
     data: 接口错误形式Zod;
 }>, z.ZodObject<{
@@ -17,4 +26,4 @@ declare class 常用形式并自定义返回接口封装<路径类型 extends __
     constructor(请求路径: 路径类型, 请求方法: 方法类型, 接口逻辑: 逻辑类型, 逻辑错误类型Zod: 接口错误形式Zod, 逻辑正确类型Zod: 接口正确形式Zod, 返回器实现: (req: Request, res: Response, 结果: __________$1<逻辑类型>) => void | Promise<void>);
 }
 
-export { 常用形式并自定义返回接口封装 };
+export { 常用形式并自定义返回器接口封装 };

package/dist/cjs/wrapper/common-wrapper.d.cts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { 接 as ______, a as ______$1, l as ____Base, 空 as ___, b as __, 常 as _______, q as __________, r as __________$1 } from '../interface-base-_3j8cNEe.cjs';
+import { 接 as ______, a as ______$1, l as ____Base, 空 as ___, b as __, 常 as _______, q as __________, r as __________$1 } from '../interface-base-CyfrfgWu.cjs';
 import { 常用返回器 as _____ } from '../interface/interface-retuen.cjs';
 import '@lsby/ts-fp-data';
 import 'express';
@@ -7,6 +7,13 @@ import '../help/interior.cjs';
 import '@lsby/ts-log';
 import 'node:http';
 
+/**
+ * 常用形式接口封装
+ *
+ * 组合了:
+ * - 常用形式转换器: 将逻辑结果转换为 { status: 'success/fail', data: ... } 格式
+ * - 常用返回器: 使用 res.send 发送 JSON 结果
+ */
 declare class 常用形式接口封装<路径类型 extends ______, 方法类型 extends ______$1, 逻辑类型 extends ____Base<any, ___, z.infer<接口错误形式Zod>, z.infer<接口正确形式Zod>, any, any>, 接口错误形式Zod extends z.ZodTypeAny, 接口正确形式Zod extends z.ZodTypeAny> extends __<路径类型, 方法类型, 逻辑类型, z.ZodObject<{
     status: z.ZodLiteral<'fail'>;
     data: 接口错误形式Zod;

package/dist/cjs/wrapper/deferred-result-wrapper.cjs

@@ -20,7 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/wrapper/deferred-result-wrapper.ts
 var deferred_result_wrapper_exports = {};
 __export(deferred_result_wrapper_exports, {
-  \u5E38\u7528\u5EF6\u65F6\u76F4\u63A5\u5F62\u5F0F\u63A5\u53E3\u5C01\u88C5: () => \u5E38\u7528\u5EF6\u65F6\u76F4\u63A5\u5F62\u5F0F\u63A5\u53E3\u5C01\u88C5
+  \u5E38\u7528\u76F4\u63A5\u5F62\u5F0F\u63A5\u53E3\u5C01\u88C5: () => \u5E38\u7528\u76F4\u63A5\u5F62\u5F0F\u63A5\u53E3\u5C01\u88C5
 });
 module.exports = __toCommonJS(deferred_result_wrapper_exports);
 var import_zod = require("zod");
@@ -62,14 +62,14 @@ var \u63A5\u53E3 = class {
 // src/interface/interface-result.ts
 var \u63A5\u53E3\u7ED3\u679C\u8F6C\u6362\u5668 = class {
 };
-var \u5E38\u7528\u5EF6\u65F6\u76F4\u63A5\u5F62\u5F0F\u8F6C\u6362\u5668 = class extends \u63A5\u53E3\u7ED3\u679C\u8F6C\u6362\u5668 {
+var \u76F4\u63A5\u5F62\u5F0F\u8F6C\u6362\u5668 = class extends \u63A5\u53E3\u7ED3\u679C\u8F6C\u6362\u5668 {
   \u5B9E\u73B0(\u6570\u636E) {
     switch (\u6570\u636E.getTag()) {
       case "Left": {
         return { status: "fail", data: \u6570\u636E.assertLeft().getLeft() };
       }
       case "Right": {
-        return \u6570\u636E.assertRight().getRight().fn();
+        return \u6570\u636E.assertRight().getRight().data;
       }
       default: {
         throw new Error("\u610F\u5916\u7684\u6570\u636E\u6807\u8BB0");
@@ -88,15 +88,15 @@ var \u5E38\u7528\u8FD4\u56DE\u5668 = class extends \u63A5\u53E3\u7ED3\u679C\u8FD
 };
 
 // src/wrapper/deferred-result-wrapper.ts
-var \u5E38\u7528\u5EF6\u65F6\u76F4\u63A5\u5F62\u5F0F\u63A5\u53E3\u5C01\u88C5 = class extends \u63A5\u53E3 {
+var \u5E38\u7528\u76F4\u63A5\u5F62\u5F0F\u63A5\u53E3\u5C01\u88C5 = class extends \u63A5\u53E3 {
   constructor(\u8BF7\u6C42\u8DEF\u5F84, \u8BF7\u6C42\u65B9\u6CD5, \u63A5\u53E3\u903B\u8F91, \u903B\u8F91\u9519\u8BEF\u7C7B\u578BZod, \u903B\u8F91\u6B63\u786E\u7C7B\u578BZod) {
     let \u63A5\u53E3\u9519\u8BEF\u8F93\u51FA\u5F62\u5F0F = import_zod.z.object({ status: import_zod.z.literal("fail"), data: \u903B\u8F91\u9519\u8BEF\u7C7B\u578BZod });
     let \u63A5\u53E3\u6B63\u786E\u8F93\u51FA\u5F62\u5F0F = \u903B\u8F91\u6B63\u786E\u7C7B\u578BZod;
-    let \u63A5\u53E3\u8F6C\u6362\u5668 = new \u5E38\u7528\u5EF6\u65F6\u76F4\u63A5\u5F62\u5F0F\u8F6C\u6362\u5668();
+    let \u63A5\u53E3\u8F6C\u6362\u5668 = new \u76F4\u63A5\u5F62\u5F0F\u8F6C\u6362\u5668();
     super(\u8BF7\u6C42\u8DEF\u5F84, \u8BF7\u6C42\u65B9\u6CD5, \u63A5\u53E3\u903B\u8F91, \u63A5\u53E3\u9519\u8BEF\u8F93\u51FA\u5F62\u5F0F, \u63A5\u53E3\u6B63\u786E\u8F93\u51FA\u5F62\u5F0F, \u63A5\u53E3\u8F6C\u6362\u5668, new \u5E38\u7528\u8FD4\u56DE\u5668());
   }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  \u5E38\u7528\u5EF6\u65F6\u76F4\u63A5\u5F62\u5F0F\u63A5\u53E3\u5C01\u88C5
+  \u5E38\u7528\u76F4\u63A5\u5F62\u5F0F\u63A5\u53E3\u5C01\u88C5
 });

package/dist/cjs/wrapper/deferred-result-wrapper.d.cts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { 接 as ______, a as ______$1, l as ____Base, 空 as ___, b as __, y as ___________, q as __________, r as __________$1 } from '../interface-base-_3j8cNEe.cjs';
+import { 接 as ______, a as ______$1, l as ____Base, 空 as ___, b as __, 直 as _______, q as __________, r as __________$1 } from '../interface-base-CyfrfgWu.cjs';
 import { 常用返回器 as _____ } from '../interface/interface-retuen.cjs';
 import '@lsby/ts-fp-data';
 import 'express';
@@ -7,13 +7,20 @@ import '../help/interior.cjs';
 import '@lsby/ts-log';
 import 'node:http';
 
-declare class 常用延时直接形式接口封装<路径类型 extends ______, 方法类型 extends ______$1, 逻辑类型 extends ____Base<any, ___, z.infer<接口错误形式Zod>, {
-    fn: () => z.infer<接口正确形式Zod>;
+/**
+ * 常用直接形式接口封装
+ *
+ * 组合了:
+ * - 直接形式转换器: 将逻辑结果转换为直接的数据格式
+ * - 常用返回器: 使用 res.send 发送 JSON 结果
+ */
+declare class 常用直接形式接口封装<路径类型 extends ______, 方法类型 extends ______$1, 逻辑类型 extends ____Base<any, ___, z.infer<接口错误形式Zod>, {
+    data: z.infer<接口正确形式Zod>;
 }, any, any>, 接口错误形式Zod extends z.ZodTypeAny, 接口正确形式Zod extends z.ZodTypeAny> extends __<路径类型, 方法类型, 逻辑类型, z.ZodObject<{
     status: z.ZodLiteral<'fail'>;
     data: 接口错误形式Zod;
-}>, 接口正确形式Zod, ___________<接口正确形式Zod, __________<逻辑类型>, __________$1<逻辑类型>>, _____<z.infer<接口正确形式Zod>>> {
+}>, 接口正确形式Zod, _______<接口正确形式Zod, __________<逻辑类型>, __________$1<逻辑类型>>, _____<z.infer<接口正确形式Zod>>> {
     constructor(请求路径: 路径类型, 请求方法: 方法类型, 接口逻辑: 逻辑类型, 逻辑错误类型Zod: 接口错误形式Zod, 逻辑正确类型Zod: 接口正确形式Zod);
 }
 
-export { 常用延时直接形式接口封装 };
+export { 常用直接形式接口封装 };

package/dist/esm/bin/gen-api-type/bin.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   main
-} from "../../chunk-REQ5ZXOQ.js";
+} from "../../chunk-B5DKJ5AV.js";
 
 // src/bin/gen-api-type/bin.ts
 import { Command } from "commander";

package/dist/esm/bin/gen-api-type/index.js

@@ -1,6 +1,6 @@
 import {
   main
-} from "../../chunk-REQ5ZXOQ.js";
+} from "../../chunk-B5DKJ5AV.js";
 export {
   main
 };

package/dist/esm/{chunk-XEV5RHGZ.js → chunk-3XRAG6DM.js}

@@ -5,10 +5,11 @@ import {
 // src/plugin/extend/urlencoded.ts
 import express from "express";
 import { format } from "util";
+import { z } from "zod";
 var \u8868\u5355\u89E3\u6790\u63D2\u4EF6 = class extends \u63D2\u4EF6 {
   constructor(t, opt) {
-    super(t, async (req, res, \u9644\u52A0\u53C2\u6570) => {
-      let log = \u9644\u52A0\u53C2\u6570.log.extend("JSON\u89E3\u6790\u63D2\u4EF6");
+    super(z.object({ form: t }), async (req, res, \u9644\u52A0\u53C2\u6570) => {
+      let log = \u9644\u52A0\u53C2\u6570.log.extend("\u8868\u5355\u89E3\u6790\u63D2\u4EF6");
       await new Promise(
         (pRes, _rej) => express.urlencoded({ extended: true, ...opt })(req, res, () => {
           pRes(null);
@@ -19,7 +20,7 @@ var \u8868\u5355\u89E3\u6790\u63D2\u4EF6 = class extends \u63D2\u4EF6 {
         await log.error("\u89E3\u6790url\u7F16\u7801\u6B63\u6587\u5931\u8D25: %o", parseResult.error);
         throw new Error(format("\u89E3\u6790url\u7F16\u7801\u6B63\u6587\u5931\u8D25: %o", parseResult.error));
       }
-      return parseResult.data;
+      return { form: parseResult.data };
     });
   }
 };

package/dist/esm/{chunk-3KWXQ7TQ.js → chunk-3ZQFVYIR.js}

@@ -1,9 +1,9 @@
+import {
+  Global
+} from "./chunk-NJKBRPN7.js";
 import {
   递归截断字符串
 } from "./chunk-ZIVQ3WZA.js";
-import {
-  Global
-} from "./chunk-OUDYK6TE.js";
 
 // src/server/server.ts
 import express from "express";

package/dist/esm/chunk-7LQRWJ3X.js

@@ -0,0 +1,32 @@
+// src/help/help.ts
+function \u6784\u9020\u5143\u7EC4(args) {
+  return args;
+}
+function \u6784\u9020\u5BF9\u8C61(key, value) {
+  return { [key]: value };
+}
+function \u666E\u901A\u5BF9\u8C61\u6DF1\u5408\u5E76(target, source) {
+  if (typeof source !== "object" || source === null || Object.getPrototypeOf(source) !== Object.prototype) {
+    return source;
+  }
+  if (typeof target !== "object" || target === null || Object.getPrototypeOf(target) !== Object.prototype) {
+    return source;
+  }
+  let result = { ...target };
+  for (let key in source) {
+    if (Object.prototype.hasOwnProperty.call(source, key)) {
+      if (typeof source[key] === "object" && source[key] !== null && Object.getPrototypeOf(source[key]) === Object.prototype && typeof target[key] === "object" && target[key] !== null && Object.getPrototypeOf(target[key]) === Object.prototype) {
+        result[key] = \u666E\u901A\u5BF9\u8C61\u6DF1\u5408\u5E76(target[key], source[key]);
+      } else {
+        result[key] = source[key];
+      }
+    }
+  }
+  return result;
+}
+
+export {
+  构造元组,
+  构造对象,
+  普通对象深合并
+};

package/dist/esm/{chunk-REQ5ZXOQ.js → chunk-B5DKJ5AV.js}

@@ -74,7 +74,7 @@ async function main(tsconfig\u8DEF\u5F84, \u76EE\u6807\u8DEF\u5F84, \u8F93\u51FA
                       ? {
                           path: jsonPath
                           method: jsonMethod
-                          input: jsonMethod extends 'post' ? jsonInput : jsonMethod extends 'get' ? getInput : {}
+                          input: jsonMethod extends 'post' ? jsonInput['body'] : jsonMethod extends 'get' ? getInput['query'] : {}
                           errorOutput: jsonErrorOutput
                           successOutput: jsonSuccessOutput
                           webSocketData: wsData

package/dist/esm/{chunk-OH6PZFGR.js → chunk-C5FED6EO.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-43GZE5YL.js";
 import {
   Global
-} from "./chunk-OUDYK6TE.js";
+} from "./chunk-NJKBRPN7.js";
 
 // src/plugin/extend/web-socket.ts
 import { WebSocket } from "ws";

package/dist/esm/{chunk-AEG7V7QY.js → chunk-DNJQGD5M.js}

@@ -16,14 +16,14 @@ var \u5E38\u7528\u5F62\u5F0F\u8F6C\u6362\u5668 = class extends \u63A5\u53E3\u7ED
     }
   }
 };
-var \u5E38\u7528\u5EF6\u65F6\u76F4\u63A5\u5F62\u5F0F\u8F6C\u6362\u5668 = class extends \u63A5\u53E3\u7ED3\u679C\u8F6C\u6362\u5668 {
+var \u76F4\u63A5\u5F62\u5F0F\u8F6C\u6362\u5668 = class extends \u63A5\u53E3\u7ED3\u679C\u8F6C\u6362\u5668 {
   \u5B9E\u73B0(\u6570\u636E) {
     switch (\u6570\u636E.getTag()) {
       case "Left": {
         return { status: "fail", data: \u6570\u636E.assertLeft().getLeft() };
       }
       case "Right": {
-        return \u6570\u636E.assertRight().getRight().fn();
+        return \u6570\u636E.assertRight().getRight().data;
       }
       default: {
         throw new Error("\u610F\u5916\u7684\u6570\u636E\u6807\u8BB0");
@@ -35,5 +35,5 @@ var \u5E38\u7528\u5EF6\u65F6\u76F4\u63A5\u5F62\u5F0F\u8F6C\u6362\u5668 = class e
 export {
   接口结果转换器,
   常用形式转换器,
-  常用延时直接形式转换器
+  直接形式转换器
 };