@lsby/net-core 0.9.3 → 0.10.1

package/dist/esm/{chunk-ITCALAYE.js → chunk-E23EZWBE.js}

@@ -1,3 +1,7 @@
+import {
+  普通对象深合并
+} from "./chunk-7LQRWJ3X.js";
+
 // src/interface/interface-logic.ts
 import { Right } from "@lsby/ts-fp-data";
 var \u63A5\u53E3\u903B\u8F91Base = class _\u63A5\u53E3\u903B\u8F91Base {
@@ -32,7 +36,7 @@ var \u63A5\u53E3\u903B\u8F91Base = class _\u63A5\u53E3\u903B\u8F91Base {
       let \u63D2\u4EF6\u8FD4\u56DE = await \u63D2\u4EF6.\u8FD0\u884C(req, res, \u8BF7\u6C42\u9644\u52A0\u53C2\u6570);
       \u6240\u6709\u63D2\u4EF6\u7ED3\u679C.push(\u63D2\u4EF6\u8FD4\u56DE);
     }
-    let \u5408\u5E76\u7ED3\u679C = \u6240\u6709\u63D2\u4EF6\u7ED3\u679C.reduce((s, a) => ({ ...s, ...a }), {});
+    let \u5408\u5E76\u7ED3\u679C = \u6240\u6709\u63D2\u4EF6\u7ED3\u679C.reduce((s, a) => \u666E\u901A\u5BF9\u8C61\u6DF1\u5408\u5E76(s, a), {});
     return \u5408\u5E76\u7ED3\u679C;
   }
   async \u901A\u8FC7\u63D2\u4EF6\u7ED3\u679C\u8FD0\u884C(\u5408\u5E76\u63D2\u4EF6\u7ED3\u679C, \u4F20\u5165\u7684\u903B\u8F91\u9644\u52A0\u53C2\u6570, \u4F20\u5165\u7684\u8BF7\u6C42\u9644\u52A0\u53C2\u6570) {
@@ -40,7 +44,7 @@ var \u63A5\u53E3\u903B\u8F91Base = class _\u63A5\u53E3\u903B\u8F91Base {
     let \u6700\u7EC8\u7ED3\u679C = void 0;
     try {
       let \u5B9E\u73B0\u7ED3\u679C = await this.\u5B9E\u73B0(\u5408\u5E76\u63D2\u4EF6\u7ED3\u679C, \u4F20\u5165\u7684\u903B\u8F91\u9644\u52A0\u53C2\u6570, \u4F20\u5165\u7684\u8BF7\u6C42\u9644\u52A0\u53C2\u6570);
-      \u6700\u7EC8\u7ED3\u679C = \u5B9E\u73B0\u7ED3\u679C.map((a) => ({ ...\u4F20\u5165\u7684\u903B\u8F91\u9644\u52A0\u53C2\u6570, ...a }));
+      \u6700\u7EC8\u7ED3\u679C = \u5B9E\u73B0\u7ED3\u679C.map((a) => \u666E\u901A\u5BF9\u8C61\u6DF1\u5408\u5E76(\u4F20\u5165\u7684\u903B\u8F91\u9644\u52A0\u53C2\u6570, a));
       return \u6700\u7EC8\u7ED3\u679C;
     } finally {
       if (\u6E05\u7406\u51FD\u6570 !== void 0) {
@@ -76,9 +80,9 @@ var \u63A5\u53E3\u903B\u8F91Base = class _\u63A5\u53E3\u903B\u8F91Base {
       async (\u53C2\u6570, \u903B\u8F91\u9644\u52A0\u53C2\u6570, \u8BF7\u6C42\u9644\u52A0\u53C2\u6570) => {
         let \u4E0A\u5C42\u8C03\u7528\u7ED3\u679C = await this.\u5B9E\u73B0(\u53C2\u6570, \u903B\u8F91\u9644\u52A0\u53C2\u6570, \u8BF7\u6C42\u9644\u52A0\u53C2\u6570);
         if (\u4E0A\u5C42\u8C03\u7528\u7ED3\u679C.isLeft()) return \u4E0A\u5C42\u8C03\u7528\u7ED3\u679C;
-        let \u4F20\u7ED9\u4E0B\u4E00\u5C42\u7684 = { ...\u903B\u8F91\u9644\u52A0\u53C2\u6570, ...\u4E0A\u5C42\u8C03\u7528\u7ED3\u679C.assertRight().getRight() };
+        let \u4F20\u7ED9\u4E0B\u4E00\u5C42\u7684 = \u666E\u901A\u5BF9\u8C61\u6DF1\u5408\u5E76(\u903B\u8F91\u9644\u52A0\u53C2\u6570, \u4E0A\u5C42\u8C03\u7528\u7ED3\u679C.assertRight().getRight());
         let \u4E0B\u5C42\u8C03\u7528\u7ED3\u679C = await \u8F93\u5165.\u5B9E\u73B0(\u53C2\u6570, \u4F20\u7ED9\u4E0B\u4E00\u5C42\u7684, \u8BF7\u6C42\u9644\u52A0\u53C2\u6570);
-        let \u6700\u7EC8\u8FD4\u56DE\u7ED3\u679C = \u4E0B\u5C42\u8C03\u7528\u7ED3\u679C.map((a) => ({ ...\u4F20\u7ED9\u4E0B\u4E00\u5C42\u7684, ...a }));
+        let \u6700\u7EC8\u8FD4\u56DE\u7ED3\u679C = \u4E0B\u5C42\u8C03\u7528\u7ED3\u679C.map((a) => \u666E\u901A\u5BF9\u8C61\u6DF1\u5408\u5E76(\u4F20\u7ED9\u4E0B\u4E00\u5C42\u7684, a));
         return \u6700\u7EC8\u8FD4\u56DE\u7ED3\u679C;
       },
       \u5408\u5E76\u6E05\u7406,

package/dist/esm/{chunk-LZOZF4CS.js → chunk-H7LZCHCE.js}

@@ -6,11 +6,11 @@ import {
 } from "./chunk-MDUWXEQ7.js";
 import {
   常用形式转换器
-} from "./chunk-AEG7V7QY.js";
+} from "./chunk-DNJQGD5M.js";
 
 // src/wrapper/common-wrapper-return.ts
 import { z } from "zod";
-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 = z.object({ status: z.literal("fail"), data: \u903B\u8F91\u9519\u8BEF\u7C7B\u578BZod });
     let \u63A5\u53E3\u6B63\u786E\u8F93\u51FA\u5F62\u5F0F = z.object({ status: z.literal("success"), data: \u903B\u8F91\u6B63\u786E\u7C7B\u578BZod });
@@ -20,5 +20,5 @@ var \u5E38\u7528\u5F62\u5F0F\u5E76\u81EA\u5B9A\u4E49\u8FD4\u56DE\u63A5\u53E3\u5C
 };
 
 export {
-  常用形式并自定义返回接口封装
+  常用形式并自定义返回器接口封装
 };

package/dist/esm/{chunk-WECMWUFB.js → chunk-HDPEZW7H.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-MDUWXEQ7.js";
 import {
   常用形式转换器
-} from "./chunk-AEG7V7QY.js";
+} from "./chunk-DNJQGD5M.js";
 
 // src/wrapper/common-wrapper.ts
 import { z } from "zod";

package/dist/esm/{chunk-JXTWTY2S.js → chunk-NB2QNDI2.js}

@@ -5,20 +5,20 @@ import {
   接口
 } from "./chunk-MDUWXEQ7.js";
 import {
-  常用延时直接形式转换器
-} from "./chunk-AEG7V7QY.js";
+  直接形式转换器
+} from "./chunk-DNJQGD5M.js";
 
 // src/wrapper/deferred-result-wrapper.ts
 import { z } from "zod";
-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 = z.object({ status: 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());
   }
 };
 
 export {
-  常用延时直接形式接口封装
+  常用直接形式接口封装
 };

package/dist/esm/{chunk-OUDYK6TE.js → chunk-NJKBRPN7.js}

@@ -6,11 +6,14 @@ var log = new 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/esm/{chunk-GMYXAJS3.js → chunk-TSDOOGHG.js}

@@ -8,11 +8,12 @@ import {
 // src/plugin/extend/json.ts
 import express from "express";
 import { format } from "util";
+import { z } from "zod";
 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(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) => express.json(opt)(req, res, () => {
@@ -26,7 +27,7 @@ var JSON\u89E3\u6790\u63D2\u4EF6 = class extends \u63D2\u4EF6 {
         throw new Error(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/esm/{chunk-AY6KWNWX.js → chunk-UUXGAK5S.js}

@@ -7,11 +7,12 @@ import {
 
 // src/plugin/extend/query.ts
 import { format } from "util";
+import { z } from "zod";
 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(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);
@@ -20,7 +21,7 @@ var GET\u53C2\u6570\u89E3\u6790\u63D2\u4EF6 = class extends \u63D2\u4EF6 {
         throw new Error(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/esm/global/global.js

@@ -1,7 +1,7 @@
 import {
   Global,
   WebSocket管理器
-} from "../chunk-OUDYK6TE.js";
+} from "../chunk-NJKBRPN7.js";
 export {
   Global,
   WebSocket\u7BA1\u7406\u5668

package/dist/esm/help/help.d.ts

@@ -1,4 +1,13 @@
 declare function 构造元组<T extends any[]>(args: [...T]): T;
 declare function 构造对象<K extends string, V>(key: K, value: V): Record<K, V>;
+type 普通对象 = Record<any, any>;
+type 严格递归合并对象<A, B> = A extends 普通对象 ? B extends 普通对象 ? {
+    [K in keyof A | keyof B]: K extends keyof A ? K extends keyof B ? A[K] extends 普通对象 ? B[K] extends 普通对象 ? 严格递归合并对象<A[K], B[K]> : never : never : A[K] : K extends keyof B ? B[K] : never;
+} : never : never;
+/**
+ * 深合并两个对象，如果两个值都是普通对象，则递归合并，否则用后者覆盖
+ * 只有直接上游是对象原型的对象才算是普通对象
+ */
+declare function 普通对象深合并(target: Record<any, any>, source: Record<any, any>): Record<string, any>;
 
-export { 构造元组, 构造对象 };
+export { type 严格递归合并对象, 普通对象深合并, 构造元组, 构造对象 };

package/dist/esm/help/help.js

@@ -1,8 +1,10 @@
 import {
+  普通对象深合并,
   构造元组,
   构造对象
-} from "../chunk-YMH6HJJF.js";
+} from "../chunk-7LQRWJ3X.js";
 export {
+  \u666E\u901A\u5BF9\u8C61\u6DF1\u5408\u5E76,
   \u6784\u9020\u5143\u7EC4,
   \u6784\u9020\u5BF9\u8C61
 };

package/dist/esm/index.d.ts

@@ -1,19 +1,18 @@
-export { 构造元组, 构造对象 } from './help/help.js';
-export { 任 as 任意接口, x as 任意接口结果转换器, n as 任意接口逻辑, z as 任意插件, 兼 as 兼容空对象, B as 取插件内部ts类型, 取 as 取插件内部类型, 可 as 可调用接口逻辑, 合 as 合并插件结果, y as 常用延时直接形式转换器, 常 as 常用形式转换器, b as 接口, a as 接口方法类型, w as 接口结果转换器, 接 as 接口路径类型, m as 接口逻辑, l as 接口逻辑Base, j as 接口逻辑正确类型, i as 接口逻辑错误类型, k as 接口逻辑附加参数类型, 插 as 插件, A as 插件项类型, 服 as 服务器, 清 as 清理函数类型, 空 as 空对象, c as 获得接口方法类型, f as 获得接口正确形式, g as 获得接口结果转换器类型, h as 获得接口结果返回器类型, 获 as 获得接口路径类型, s as 获得接口逻辑上游接口类型, o as 获得接口逻辑插件类型, t as 获得接口逻辑最后接口类型, r as 获得接口逻辑正确类型, d as 获得接口逻辑类型, q as 获得接口逻辑错误类型, p as 获得接口逻辑附加参数类型, e as 获得接口错误形式, 计 as 计算接口逻辑参数, v as 计算接口逻辑正确结果, u as 计算接口逻辑错误结果, 请 as 请求附加参数类型 } from './interface-base-CxLIUGsx.js';
+export { 严格递归合并对象, 普通对象深合并, 构造元组, 构造对象 } from './help/help.js';
+export { 任 as 任意接口, x as 任意接口结果转换器, n as 任意接口逻辑, y as 任意插件, 兼 as 兼容空对象, A as 取插件内部ts类型, 取 as 取插件内部类型, 可 as 可调用接口逻辑, 合 as 合并插件结果, 常 as 常用形式转换器, b as 接口, a as 接口方法类型, w as 接口结果转换器, 接 as 接口路径类型, m as 接口逻辑, l as 接口逻辑Base, j as 接口逻辑正确类型, i as 接口逻辑错误类型, k as 接口逻辑附加参数类型, 插 as 插件, z as 插件项类型, 服 as 服务器, 清 as 清理函数类型, 直 as 直接形式转换器, 空 as 空对象, c as 获得接口方法类型, f as 获得接口正确形式, g as 获得接口结果转换器类型, h as 获得接口结果返回器类型, 获 as 获得接口路径类型, s as 获得接口逻辑上游接口类型, o as 获得接口逻辑插件类型, t as 获得接口逻辑最后接口类型, r as 获得接口逻辑正确类型, d as 获得接口逻辑类型, q as 获得接口逻辑错误类型, p as 获得接口逻辑附加参数类型, e as 获得接口错误形式, 计 as 计算接口逻辑参数, v as 计算接口逻辑正确结果, u as 计算接口逻辑错误结果, 请 as 请求附加参数类型 } from './interface-base-C1ZNSMJz.js';
 export { 任意接口结果返回器, 常用返回器, 接口结果返回器, 自定义返回器 } from './interface/interface-retuen.js';
 export { 接口测试 } from './interface/interface-test.js';
 export { 自定义数据插件 } from './plugin/extend/custom-data.js';
 export { JSON解析插件, 任意JSON解析插件, 任意JSON解析插件项, 合并JSON插件结果, 计算接口逻辑JSON参数 } from './plugin/extend/json.js';
 export { 调试请求头插件 } from './plugin/extend/log-headers.js';
 export { GET参数解析插件, 任意GET参数解析插件, 任意GET参数解析插件项, 合并GET插件结果, 计算接口逻辑GET参数 } from './plugin/extend/query.js';
-export { 发送文件插件 } from './plugin/extend/send-file-plugin.js';
 export { 表单解析插件 } from './plugin/extend/urlencoded.js';
 export { WebSocket插件, 任意WS插件, 任意WS插件项, 取WS插件泛型, 取第一个WS插件结果 } from './plugin/extend/web-socket.js';
 export { EXPORT_TYPE } from './symbol/export-type.js';
 export { GetNetCoreExportTypeDefine, GetNetCoreExportTypeName, NetCoreExportType } from './types/export-type.js';
 export { 常用形式接口封装 } from './wrapper/common-wrapper.js';
-export { 常用形式并自定义返回接口封装 } from './wrapper/common-wrapper-return.js';
-export { 常用延时直接形式接口封装 } from './wrapper/deferred-result-wrapper.js';
+export { 常用形式并自定义返回器接口封装 } from './wrapper/common-wrapper-return.js';
+export { 常用直接形式接口封装 } from './wrapper/deferred-result-wrapper.js';
 import 'zod';
 import '@lsby/ts-fp-data';
 import 'express';

package/dist/esm/index.js

@@ -3,25 +3,22 @@ import {
 } from "./chunk-VMCAX3QH.js";
 import {
   JSON解析插件
-} from "./chunk-GMYXAJS3.js";
+} from "./chunk-TSDOOGHG.js";
 import {
   调试请求头插件
 } from "./chunk-7MHKNSNT.js";
 import {
   GET参数解析插件
-} from "./chunk-AY6KWNWX.js";
-import {
-  发送文件插件
-} from "./chunk-RRUUWHTF.js";
+} from "./chunk-UUXGAK5S.js";
 import {
   表单解析插件
-} from "./chunk-XEV5RHGZ.js";
+} from "./chunk-3XRAG6DM.js";
 import {
   WebSocket插件
-} from "./chunk-OH6PZFGR.js";
+} from "./chunk-C5FED6EO.js";
 import {
-  常用延时直接形式接口封装
-} from "./chunk-JXTWTY2S.js";
+  常用直接形式接口封装
+} from "./chunk-NB2QNDI2.js";
 import {
   接口测试
 } from "./chunk-N7TPWCQ5.js";
@@ -30,51 +27,50 @@ import {
 } from "./chunk-43GZE5YL.js";
 import {
   服务器
-} from "./chunk-3KWXQ7TQ.js";
+} from "./chunk-3ZQFVYIR.js";
 import {
   EXPORT_TYPE
 } from "./chunk-ZF7EC2OM.js";
 import "./chunk-XPFEAXE4.js";
 import {
-  常用形式并自定义返回接口封装
-} from "./chunk-LZOZF4CS.js";
+  常用形式并自定义返回器接口封装
+} from "./chunk-H7LZCHCE.js";
 import {
   常用形式接口封装
-} from "./chunk-WECMWUFB.js";
+} from "./chunk-HDPEZW7H.js";
 import {
   常用返回器,
   接口结果返回器,
   自定义返回器
 } from "./chunk-XBAKTT6S.js";
-import {
-  构造元组,
-  构造对象
-} from "./chunk-YMH6HJJF.js";
+import "./chunk-NJKBRPN7.js";
 import "./chunk-ZIVQ3WZA.js";
-import "./chunk-OUDYK6TE.js";
 import {
   接口
 } from "./chunk-MDUWXEQ7.js";
 import {
   接口逻辑,
   接口逻辑Base
-} from "./chunk-ITCALAYE.js";
+} from "./chunk-E23EZWBE.js";
+import {
+  普通对象深合并,
+  构造元组,
+  构造对象
+} from "./chunk-7LQRWJ3X.js";
 import {
-  常用延时直接形式转换器,
   常用形式转换器,
-  接口结果转换器
-} from "./chunk-AEG7V7QY.js";
+  接口结果转换器,
+  直接形式转换器
+} from "./chunk-DNJQGD5M.js";
 export {
   EXPORT_TYPE,
   GET\u53C2\u6570\u89E3\u6790\u63D2\u4EF6,
   JSON\u89E3\u6790\u63D2\u4EF6,
   WebSocket\u63D2\u4EF6,
-  \u53D1\u9001\u6587\u4EF6\u63D2\u4EF6,
-  \u5E38\u7528\u5EF6\u65F6\u76F4\u63A5\u5F62\u5F0F\u63A5\u53E3\u5C01\u88C5,
-  \u5E38\u7528\u5EF6\u65F6\u76F4\u63A5\u5F62\u5F0F\u8F6C\u6362\u5668,
-  \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\u63A5\u53E3\u5C01\u88C5,
   \u5E38\u7528\u5F62\u5F0F\u8F6C\u6362\u5668,
+  \u5E38\u7528\u76F4\u63A5\u5F62\u5F0F\u63A5\u53E3\u5C01\u88C5,
   \u5E38\u7528\u8FD4\u56DE\u5668,
   \u63A5\u53E3,
   \u63A5\u53E3\u6D4B\u8BD5,
@@ -83,9 +79,11 @@ export {
   \u63A5\u53E3\u903B\u8F91,
   \u63A5\u53E3\u903B\u8F91Base,
   \u63D2\u4EF6,
+  \u666E\u901A\u5BF9\u8C61\u6DF1\u5408\u5E76,
   \u670D\u52A1\u5668,
   \u6784\u9020\u5143\u7EC4,
   \u6784\u9020\u5BF9\u8C61,
+  \u76F4\u63A5\u5F62\u5F0F\u8F6C\u6362\u5668,
   \u81EA\u5B9A\u4E49\u6570\u636E\u63D2\u4EF6,
   \u81EA\u5B9A\u4E49\u8FD4\u56DE\u5668,
   \u8868\u5355\u89E3\u6790\u63D2\u4EF6,

package/dist/esm/interface/interface-base.d.ts

@@ -1,5 +1,5 @@
 import 'zod';
-export { 任 as 任意接口, b as 接口, a as 接口方法类型, 接 as 接口路径类型, c as 获得接口方法类型, f as 获得接口正确形式, g as 获得接口结果转换器类型, h as 获得接口结果返回器类型, 获 as 获得接口路径类型, d as 获得接口逻辑类型, e as 获得接口错误形式 } from '../interface-base-CxLIUGsx.js';
+export { 任 as 任意接口, b as 接口, a as 接口方法类型, 接 as 接口路径类型, c as 获得接口方法类型, f as 获得接口正确形式, g as 获得接口结果转换器类型, h as 获得接口结果返回器类型, 获 as 获得接口路径类型, d as 获得接口逻辑类型, e as 获得接口错误形式 } from '../interface-base-C1ZNSMJz.js';
 import './interface-retuen.js';
 import '@lsby/ts-fp-data';
 import 'express';

package/dist/esm/interface/interface-logic.d.ts

@@ -1,7 +1,7 @@
 import '@lsby/ts-fp-data';
 import 'express';
 import '../help/interior.js';
-export { n as 任意接口逻辑, 兼 as 兼容空对象, 可 as 可调用接口逻辑, m as 接口逻辑, l as 接口逻辑Base, j as 接口逻辑正确类型, i as 接口逻辑错误类型, k as 接口逻辑附加参数类型, 清 as 清理函数类型, 空 as 空对象, s as 获得接口逻辑上游接口类型, o as 获得接口逻辑插件类型, t as 获得接口逻辑最后接口类型, r as 获得接口逻辑正确类型, q as 获得接口逻辑错误类型, p as 获得接口逻辑附加参数类型, 计 as 计算接口逻辑参数, v as 计算接口逻辑正确结果, u as 计算接口逻辑错误结果 } from '../interface-base-CxLIUGsx.js';
+export { n as 任意接口逻辑, 兼 as 兼容空对象, 可 as 可调用接口逻辑, m as 接口逻辑, l as 接口逻辑Base, j as 接口逻辑正确类型, i as 接口逻辑错误类型, k as 接口逻辑附加参数类型, 清 as 清理函数类型, 空 as 空对象, s as 获得接口逻辑上游接口类型, o as 获得接口逻辑插件类型, t as 获得接口逻辑最后接口类型, r as 获得接口逻辑正确类型, q as 获得接口逻辑错误类型, p as 获得接口逻辑附加参数类型, 计 as 计算接口逻辑参数, v as 计算接口逻辑正确结果, u as 计算接口逻辑错误结果 } from '../interface-base-C1ZNSMJz.js';
 import 'zod';
 import '@lsby/ts-log';
 import 'node:http';

package/dist/esm/interface/interface-logic.js

@@ -1,7 +1,8 @@
 import {
   接口逻辑,
   接口逻辑Base
-} from "../chunk-ITCALAYE.js";
+} from "../chunk-E23EZWBE.js";
+import "../chunk-7LQRWJ3X.js";
 export {
   \u63A5\u53E3\u903B\u8F91,
   \u63A5\u53E3\u903B\u8F91Base

package/dist/esm/interface/interface-result.d.ts

@@ -1,5 +1,5 @@
 import '@lsby/ts-fp-data';
-export { x as 任意接口结果转换器, y as 常用延时直接形式转换器, 常 as 常用形式转换器, w as 接口结果转换器 } from '../interface-base-CxLIUGsx.js';
+export { x as 任意接口结果转换器, 常 as 常用形式转换器, w as 接口结果转换器, 直 as 直接形式转换器 } from '../interface-base-C1ZNSMJz.js';
 import 'zod';
 import 'express';
 import '../help/interior.js';

package/dist/esm/interface/interface-result.js

@@ -1,10 +1,10 @@
 import {
-  常用延时直接形式转换器,
   常用形式转换器,
-  接口结果转换器
-} from "../chunk-AEG7V7QY.js";
+  接口结果转换器,
+  直接形式转换器
+} from "../chunk-DNJQGD5M.js";
 export {
-  \u5E38\u7528\u5EF6\u65F6\u76F4\u63A5\u5F62\u5F0F\u8F6C\u6362\u5668,
   \u5E38\u7528\u5F62\u5F0F\u8F6C\u6362\u5668,
-  \u63A5\u53E3\u7ED3\u679C\u8F6C\u6362\u5668
+  \u63A5\u53E3\u7ED3\u679C\u8F6C\u6362\u5668,
+  \u76F4\u63A5\u5F62\u5F0F\u8F6C\u6362\u5668
 };

package/dist/esm/interface/interface-retuen.d.ts

@@ -1,12 +1,26 @@
 import { Request, Response } from 'express';
 
+/**
+ * 描述接口如何将转换器转换后的数据发送给客户端
+ *
+ * 这一层的存在使得数据格式和传输方式完全解耦:
+ * - 相同的数据可以通过 JSON, XML, Protobuf 等不同格式发送
+ * - 可以选择不同的传输方式: HTTP 响应, WebSocket, SSE, 文件下载等
+ * - 可以设置相应头等数据
+ */
 declare abstract class 接口结果返回器<接口正确形式> {
     abstract 返回(req: Request, res: Response, 结果: 接口正确形式): void | Promise<void>;
 }
 type 任意接口结果返回器 = 接口结果返回器<any>;
+/**
+ * 常用返回器: 直接使用 res.send 发送数据
+ */
 declare class 常用返回器<正确形式> extends 接口结果返回器<正确形式> {
     返回(req: Request, res: Response, 结果: 正确形式): void;
 }
+/**
+ * 自定义返回器: 支持任意自定义的返回逻辑
+ */
 declare class 自定义返回器<正确形式> extends 接口结果返回器<正确形式> {
     private 实现函数;
     constructor(实现函数: (req: Request, res: Response, 结果: 正确形式) => void | Promise<void>);

package/dist/esm/{interface-base-CxLIUGsx.d.ts → interface-base-C1ZNSMJz.d.ts}

@@ -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/esm/plugin/extend/custom-data.d.ts

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

package/dist/esm/plugin/extend/json.d.ts

@@ -1,6 +1,7 @@
 import express from 'express';
 import { AnyZodObject, z } from 'zod';
-import { 插 as __, A as _____, 取 as _______, o as __________ } from '../../interface-base-CxLIUGsx.js';
+import { 严格递归合并对象 as ________ } from '../../help/help.js';
+import { 插 as __, z as _____, 取 as _______, o as __________ } from '../../interface-base-C1ZNSMJz.js';
 import '@lsby/ts-fp-data';
 import '../../help/interior.js';
 import '@lsby/ts-log';
@@ -8,13 +9,17 @@ import 'node:http';
 import '../../interface/interface-retuen.js';
 
 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/esm/plugin/extend/json.js

@@ -1,6 +1,6 @@
 import {
   JSON解析插件
-} from "../../chunk-GMYXAJS3.js";
+} from "../../chunk-TSDOOGHG.js";
 import "../../chunk-43GZE5YL.js";
 import "../../chunk-ZIVQ3WZA.js";
 export {

package/dist/esm/plugin/extend/log-headers.d.ts

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

package/dist/esm/plugin/extend/query.d.ts

@@ -1,5 +1,6 @@
 import { AnyZodObject, z } from 'zod';
-import { 插 as __, A as _____, 取 as _______, o as __________ } from '../../interface-base-CxLIUGsx.js';
+import { 严格递归合并对象 as ________ } from '../../help/help.js';
+import { 插 as __, z as _____, 取 as _______, o as __________ } from '../../interface-base-C1ZNSMJz.js';
 import '@lsby/ts-fp-data';
 import 'express';
 import '../../help/interior.js';
@@ -8,13 +9,17 @@ import 'node:http';
 import '../../interface/interface-retuen.js';
 
 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/esm/plugin/extend/query.js

@@ -1,6 +1,6 @@
 import {
   GET参数解析插件
-} from "../../chunk-AY6KWNWX.js";
+} from "../../chunk-UUXGAK5S.js";
 import "../../chunk-43GZE5YL.js";
 import "../../chunk-ZIVQ3WZA.js";
 export {

package/dist/esm/plugin/extend/urlencoded.d.ts

@@ -1,13 +1,15 @@
 import express from 'express';
 import { z } from 'zod';
-import { 插 as __ } from '../../interface-base-CxLIUGsx.js';
+import { 插 as __ } from '../../interface-base-C1ZNSMJz.js';
 import '@lsby/ts-fp-data';
 import '../../help/interior.js';
 import '@lsby/ts-log';
 import 'node:http';
 import '../../interface/interface-retuen.js';
 
-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/esm/plugin/extend/urlencoded.js

@@ -1,6 +1,6 @@
 import {
   表单解析插件
-} from "../../chunk-XEV5RHGZ.js";
+} from "../../chunk-3XRAG6DM.js";
 import "../../chunk-43GZE5YL.js";
 export {
   \u8868\u5355\u89E3\u6790\u63D2\u4EF6

package/dist/esm/plugin/extend/web-socket.d.ts

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