@lsby/net-core 0.9.2 → 0.10.0

package/dist/esm/index.js

@@ -3,50 +3,47 @@ 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";
+import {
+  服务器
+} from "./chunk-3ZQFVYIR.js";
 import {
   插件
 } from "./chunk-43GZE5YL.js";
-import {
-  服务器
-} from "./chunk-75CPTXGZ.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 "./chunk-OUDYK6TE.js";
+import "./chunk-NJKBRPN7.js";
 import {
   构造元组,
   构造对象
@@ -60,21 +57,19 @@ import {
   接口逻辑Base
 } from "./chunk-ITCALAYE.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,
@@ -86,6 +81,7 @@ export {
   \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-CKPWT5C9.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-CKPWT5C9.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-result.d.ts

@@ -1,5 +1,5 @@
 import '@lsby/ts-fp-data';
-export { x as 任意接口结果转换器, y as 常用延时直接形式转换器, 常 as 常用形式转换器, w as 接口结果转换器 } from '../interface-base-CKPWT5C9.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-CKPWT5C9.d.ts → interface-base-C1ZNSMJz.d.ts}

@@ -10,8 +10,8 @@ type 请求附加参数类型 = {
     log: Log;
 };
 declare class 服务器 {
-    private 系统log;
     private 接口log;
+    private 系统log;
     private 接口们;
     private 端口;
     private 静态资源路径;
@@ -21,7 +21,8 @@ declare class 服务器 {
         端口: number;
         静态资源路径?: string;
         默认get文件路径?: string;
-        log?: Log;
+        系统log?: Log;
+        接口log?: Log;
     });
     run(): Promise<{
         ip: string[];
@@ -136,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: 实现错误类型;
@@ -151,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: 实现错误类型;
@@ -202,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-CKPWT5C9.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,6 @@
 import express from 'express';
 import { AnyZodObject, z } from 'zod';
-import { 插 as __, A as _____, 取 as _______, o as __________ } from '../../interface-base-CKPWT5C9.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 +8,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-CKPWT5C9.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,5 @@
 import { AnyZodObject, z } from 'zod';
-import { 插 as __, A as _____, 取 as _______, o as __________ } from '../../interface-base-CKPWT5C9.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 +8,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-CKPWT5C9.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-CKPWT5C9.js';
+import { 插 as __, z as _____ } from '../../interface-base-C1ZNSMJz.js';
 import '@lsby/ts-fp-data';
 import 'express';
 import '../../help/interior.js';

package/dist/esm/plugin/extend/web-socket.js

@@ -1,8 +1,8 @@
 import {
   WebSocket插件
-} from "../../chunk-OH6PZFGR.js";
+} from "../../chunk-C5FED6EO.js";
 import "../../chunk-43GZE5YL.js";
-import "../../chunk-OUDYK6TE.js";
+import "../../chunk-NJKBRPN7.js";
 export {
   WebSocket\u63D2\u4EF6
 };

package/dist/esm/plugin/plug.d.ts

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

package/dist/esm/server/server.d.ts

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

package/dist/esm/server/server.js

@@ -1,7 +1,7 @@
 import {
   服务器
-} from "../chunk-75CPTXGZ.js";
-import "../chunk-OUDYK6TE.js";
+} from "../chunk-3ZQFVYIR.js";
+import "../chunk-NJKBRPN7.js";
 import "../chunk-ZIVQ3WZA.js";
 export {
   \u670D\u52A1\u5668

package/dist/esm/wrapper/common-wrapper-return.d.ts

@@ -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-CKPWT5C9.js';
+import { 接 as ______, a as ______$1, l as ____Base, 空 as ___, b as __, 常 as _______, q as __________, r as __________$1 } from '../interface-base-C1ZNSMJz.js';
 import { 自定义返回器 as ______$2 } from '../interface/interface-retuen.js';
 import '@lsby/ts-fp-data';
 import '../help/interior.js';
 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/esm/wrapper/common-wrapper-return.js

@@ -1,9 +1,9 @@
 import {
-  常用形式并自定义返回接口封装
-} from "../chunk-LZOZF4CS.js";
+  常用形式并自定义返回器接口封装
+} from "../chunk-H7LZCHCE.js";
 import "../chunk-XBAKTT6S.js";
 import "../chunk-MDUWXEQ7.js";
-import "../chunk-AEG7V7QY.js";
+import "../chunk-DNJQGD5M.js";
 export {
-  \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/esm/wrapper/common-wrapper.d.ts

@@ -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-CKPWT5C9.js';
+import { 接 as ______, a as ______$1, l as ____Base, 空 as ___, b as __, 常 as _______, q as __________, r as __________$1 } from '../interface-base-C1ZNSMJz.js';
 import { 常用返回器 as _____ } from '../interface/interface-retuen.js';
 import '@lsby/ts-fp-data';
 import 'express';
@@ -7,6 +7,13 @@ import '../help/interior.js';
 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/esm/wrapper/common-wrapper.js

@@ -1,9 +1,9 @@
 import {
   常用形式接口封装
-} from "../chunk-WECMWUFB.js";
+} from "../chunk-HDPEZW7H.js";
 import "../chunk-XBAKTT6S.js";
 import "../chunk-MDUWXEQ7.js";
-import "../chunk-AEG7V7QY.js";
+import "../chunk-DNJQGD5M.js";
 export {
   \u5E38\u7528\u5F62\u5F0F\u63A5\u53E3\u5C01\u88C5
 };

package/dist/esm/wrapper/deferred-result-wrapper.d.ts

@@ -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-CKPWT5C9.js';
+import { 接 as ______, a as ______$1, l as ____Base, 空 as ___, b as __, 直 as _______, q as __________, r as __________$1 } from '../interface-base-C1ZNSMJz.js';
 import { 常用返回器 as _____ } from '../interface/interface-retuen.js';
 import '@lsby/ts-fp-data';
 import 'express';
@@ -7,13 +7,20 @@ import '../help/interior.js';
 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/wrapper/deferred-result-wrapper.js

@@ -1,9 +1,9 @@
 import {
-  常用延时直接形式接口封装
-} from "../chunk-JXTWTY2S.js";
+  常用直接形式接口封装
+} from "../chunk-NB2QNDI2.js";
 import "../chunk-XBAKTT6S.js";
 import "../chunk-MDUWXEQ7.js";
-import "../chunk-AEG7V7QY.js";
+import "../chunk-DNJQGD5M.js";
 export {
-  \u5E38\u7528\u5EF6\u65F6\u76F4\u63A5\u5F62\u5F0F\u63A5\u53E3\u5C01\u88C5
+  \u5E38\u7528\u76F4\u63A5\u5F62\u5F0F\u63A5\u53E3\u5C01\u88C5
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lsby/net-core",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "type": "module",
   "exports": {
     "require": "./dist/cjs/index.cjs",

package/dist/cjs/plugin/extend/send-file-plugin.cjs

@@ -1,58 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/plugin/extend/send-file-plugin.ts
-var send_file_plugin_exports = {};
-__export(send_file_plugin_exports, {
-  \u53D1\u9001\u6587\u4EF6\u63D2\u4EF6: () => \u53D1\u9001\u6587\u4EF6\u63D2\u4EF6
-});
-module.exports = __toCommonJS(send_file_plugin_exports);
-var import_zod = require("zod");
-
-// src/plugin/plug.ts
-var \u63D2\u4EF6 = class {
-  constructor(\u7C7B\u578B, \u5B9E\u73B0) {
-    this.\u7C7B\u578B = \u7C7B\u578B;
-    this.\u5B9E\u73B0 = \u5B9E\u73B0;
-  }
-  \u83B7\u5F97\u7C7B\u578B() {
-    return this.\u7C7B\u578B;
-  }
-  \u8FD0\u884C(req, res, \u9644\u52A0\u53C2\u6570) {
-    return this.\u5B9E\u73B0(req, res, \u9644\u52A0\u53C2\u6570);
-  }
-};
-
-// src/plugin/extend/send-file-plugin.ts
-var zod\u7C7B\u578B\u8868\u793A = import_zod.z.object({ sendFile: import_zod.z.function(import_zod.z.tuple([import_zod.z.instanceof(Buffer)]), import_zod.z.instanceof(Buffer)) });
-var \u53D1\u9001\u6587\u4EF6\u63D2\u4EF6 = class extends \u63D2\u4EF6 {
-  constructor() {
-    super(zod\u7C7B\u578B\u8868\u793A, async (_req, _res) => {
-      return {
-        sendFile: (file) => {
-          return file;
-        }
-      };
-    });
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  \u53D1\u9001\u6587\u4EF6\u63D2\u4EF6
-});