@lsby/net-core 0.10.1 → 0.10.3

package/dist/cjs/index.cjs

@@ -31,6 +31,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   EXPORT_TYPE: () => EXPORT_TYPE,
+  Express\u517C\u5BB9\u63A5\u53E3\u5C01\u88C5: () => Express\u517C\u5BB9\u63A5\u53E3\u5C01\u88C5,
   GET\u53C2\u6570\u89E3\u6790\u63D2\u4EF6: () => GET\u53C2\u6570\u89E3\u6790\u63D2\u4EF6,
   JSON\u89E3\u6790\u63D2\u4EF6: () => JSON\u89E3\u6790\u63D2\u4EF6,
   WebSocket\u63D2\u4EF6: () => WebSocket\u63D2\u4EF6,
@@ -46,6 +47,7 @@ __export(index_exports, {
   \u63A5\u53E3\u903B\u8F91: () => \u63A5\u53E3\u903B\u8F91,
   \u63A5\u53E3\u903B\u8F91Base: () => \u63A5\u53E3\u903B\u8F91Base,
   \u63D2\u4EF6: () => \u63D2\u4EF6,
+  \u6587\u4EF6\u4E0B\u8F7D\u63A5\u53E3\u5C01\u88C5: () => \u6587\u4EF6\u4E0B\u8F7D\u63A5\u53E3\u5C01\u88C5,
   \u666E\u901A\u5BF9\u8C61\u6DF1\u5408\u5E76: () => \u666E\u901A\u5BF9\u8C61\u6DF1\u5408\u5E76,
   \u670D\u52A1\u5668: () => \u670D\u52A1\u5668,
   \u6784\u9020\u5143\u7EC4: () => \u6784\u9020\u5143\u7EC4,
@@ -732,9 +734,96 @@ var \u5E38\u7528\u76F4\u63A5\u5F62\u5F0F\u63A5\u53E3\u5C01\u88C5 = class extends
     super(\u8BF7\u6C42\u8DEF\u5F84, \u8BF7\u6C42\u65B9\u6CD5, \u63A5\u53E3\u903B\u8F912, \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());
   }
 };
+
+// src/wrapper/express-compatible-wrapper.ts
+var import_ts_fp_data2 = require("@lsby/ts-fp-data");
+var import_zod9 = require("zod");
+var Express\u517C\u5BB9\u63A5\u53E3\u5C01\u88C5 = class extends \u63A5\u53E3 {
+  constructor(\u8BF7\u6C42\u8DEF\u5F84, \u8BF7\u6C42\u65B9\u6CD5, \u5904\u7406\u51FD\u6570) {
+    let \u903B\u8F91 = \u63A5\u53E3\u903B\u8F91Base.\u6784\u9020([], async () => {
+      return new import_ts_fp_data2.Right({});
+    });
+    let \u8F6C\u6362\u5668 = new Express\u517C\u5BB9\u7ED3\u679C\u8F6C\u6362\u5668();
+    let \u8FD4\u56DE\u5668 = new Express\u517C\u5BB9\u8FD4\u56DE\u5668(\u5904\u7406\u51FD\u6570);
+    super(
+      \u8BF7\u6C42\u8DEF\u5F84,
+      \u8BF7\u6C42\u65B9\u6CD5,
+      \u903B\u8F91,
+      import_zod9.z.any(),
+      // 错误形式不做限制
+      import_zod9.z.any(),
+      // 正确形式不做限制
+      \u8F6C\u6362\u5668,
+      \u8FD4\u56DE\u5668
+    );
+  }
+};
+var Express\u517C\u5BB9\u7ED3\u679C\u8F6C\u6362\u5668 = class extends \u63A5\u53E3\u7ED3\u679C\u8F6C\u6362\u5668 {
+  \u5B9E\u73B0(\u6570\u636E) {
+    return \u6570\u636E;
+  }
+};
+var Express\u517C\u5BB9\u8FD4\u56DE\u5668 = class extends \u63A5\u53E3\u7ED3\u679C\u8FD4\u56DE\u5668 {
+  constructor(\u5904\u7406\u51FD\u6570) {
+    super();
+    this.\u5904\u7406\u51FD\u6570 = \u5904\u7406\u51FD\u6570;
+  }
+  \u8FD4\u56DE(req, res, _\u7ED3\u679C) {
+    return this.\u5904\u7406\u51FD\u6570(req, res);
+  }
+};
+
+// src/wrapper/file-download-wrapper.ts
+var import_node_fs = require("fs");
+var import_zod10 = require("zod");
+var \u6587\u4EF6\u4E0B\u8F7D\u63A5\u53E3\u5C01\u88C5 = class extends \u63A5\u53E3 {
+  constructor(\u8BF7\u6C42\u8DEF\u5F84, \u8BF7\u6C42\u65B9\u6CD5, \u63A5\u53E3\u903B\u8F912, \u903B\u8F91\u9519\u8BEF\u7C7B\u578BZod, \u6587\u4EF6\u540D, MIME\u7C7B\u578B) {
+    let \u63A5\u53E3\u9519\u8BEF\u8F93\u51FA\u5F62\u5F0F = import_zod10.z.object({ status: import_zod10.z.literal("fail"), data: \u903B\u8F91\u9519\u8BEF\u7C7B\u578BZod });
+    let \u63A5\u53E3\u8F6C\u6362\u5668 = new \u76F4\u63A5\u5F62\u5F0F\u8F6C\u6362\u5668();
+    let \u8FD4\u56DE\u5668 = new \u6587\u4EF6\u4E0B\u8F7D\u8FD4\u56DE\u5668(\u6587\u4EF6\u540D, MIME\u7C7B\u578B);
+    super(
+      \u8BF7\u6C42\u8DEF\u5F84,
+      \u8BF7\u6C42\u65B9\u6CD5,
+      \u63A5\u53E3\u903B\u8F912,
+      \u63A5\u53E3\u9519\u8BEF\u8F93\u51FA\u5F62\u5F0F,
+      import_zod10.z.any(),
+      // 正确形式任意
+      \u63A5\u53E3\u8F6C\u6362\u5668,
+      \u8FD4\u56DE\u5668
+    );
+  }
+};
+var \u6587\u4EF6\u4E0B\u8F7D\u8FD4\u56DE\u5668 = class extends \u63A5\u53E3\u7ED3\u679C\u8FD4\u56DE\u5668 {
+  constructor(\u6587\u4EF6\u540D, MIME\u7C7B\u578B) {
+    super();
+    this.\u6587\u4EF6\u540D = \u6587\u4EF6\u540D;
+    this.MIME\u7C7B\u578B = MIME\u7C7B\u578B;
+  }
+  async \u8FD4\u56DE(req, res, \u7ED3\u679C) {
+    if (this.MIME\u7C7B\u578B !== void 0) {
+      res.setHeader("Content-Type", this.MIME\u7C7B\u578B);
+    }
+    if (this.\u6587\u4EF6\u540D !== void 0) {
+      let encodedFilename = encodeURIComponent(this.\u6587\u4EF6\u540D);
+      res.setHeader("Content-Disposition", `attachment; filename*=UTF-8''${encodedFilename}`);
+    }
+    if (Buffer.isBuffer(\u7ED3\u679C)) {
+      res.setHeader("Content-Length", \u7ED3\u679C.length);
+      res.send(\u7ED3\u679C);
+    } else if (typeof \u7ED3\u679C === "string") {
+      let \u6D41 = (0, import_node_fs.createReadStream)(\u7ED3\u679C);
+      \u6D41.pipe(res);
+    } else if (typeof \u7ED3\u679C.pipe === "function") {
+      \u7ED3\u679C.pipe(res);
+    } else {
+      res.status(400).send("Invalid file data");
+    }
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   EXPORT_TYPE,
+  Express\u517C\u5BB9\u63A5\u53E3\u5C01\u88C5,
   GET\u53C2\u6570\u89E3\u6790\u63D2\u4EF6,
   JSON\u89E3\u6790\u63D2\u4EF6,
   WebSocket\u63D2\u4EF6,
@@ -750,6 +839,7 @@ var \u5E38\u7528\u76F4\u63A5\u5F62\u5F0F\u63A5\u53E3\u5C01\u88C5 = class extends
   \u63A5\u53E3\u903B\u8F91,
   \u63A5\u53E3\u903B\u8F91Base,
   \u63D2\u4EF6,
+  \u6587\u4EF6\u4E0B\u8F7D\u63A5\u53E3\u5C01\u88C5,
   \u666E\u901A\u5BF9\u8C61\u6DF1\u5408\u5E76,
   \u670D\u52A1\u5668,
   \u6784\u9020\u5143\u7EC4,

package/dist/cjs/index.d.cts

@@ -13,9 +13,12 @@ export { GetNetCoreExportTypeDefine, GetNetCoreExportTypeName, NetCoreExportType
 export { 常用形式接口封装 } from './wrapper/common-wrapper.cjs';
 export { 常用形式并自定义返回器接口封装 } from './wrapper/common-wrapper-return.cjs';
 export { 常用直接形式接口封装 } from './wrapper/deferred-result-wrapper.cjs';
+export { Express兼容接口封装 } from './wrapper/express-compatible-wrapper.cjs';
+export { 文件下载接口封装, 文件数据类型 } from './wrapper/file-download-wrapper.cjs';
 import 'zod';
 import '@lsby/ts-fp-data';
 import 'express';
 import './help/interior.cjs';
 import '@lsby/ts-log';
 import 'node:http';
+import 'node:fs';

package/dist/cjs/wrapper/express-compatible-wrapper.cjs

@@ -0,0 +1,228 @@
+"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/wrapper/express-compatible-wrapper.ts
+var express_compatible_wrapper_exports = {};
+__export(express_compatible_wrapper_exports, {
+  Express\u517C\u5BB9\u63A5\u53E3\u5C01\u88C5: () => Express\u517C\u5BB9\u63A5\u53E3\u5C01\u88C5
+});
+module.exports = __toCommonJS(express_compatible_wrapper_exports);
+var import_ts_fp_data2 = require("@lsby/ts-fp-data");
+var import_zod = require("zod");
+
+// src/interface/interface-base.ts
+var \u63A5\u53E3 = class {
+  constructor(\u8BF7\u6C42\u8DEF\u5F84, \u8BF7\u6C42\u65B9\u6CD5, \u63A5\u53E3\u903B\u8F91, \u63A5\u53E3\u9519\u8BEF\u5F62\u5F0FZod, \u63A5\u53E3\u6B63\u786E\u5F62\u5F0FZod, \u7ED3\u679C\u8F6C\u6362\u5668, \u7ED3\u679C\u8FD4\u56DE\u5668) {
+    this.\u8BF7\u6C42\u8DEF\u5F84 = \u8BF7\u6C42\u8DEF\u5F84;
+    this.\u8BF7\u6C42\u65B9\u6CD5 = \u8BF7\u6C42\u65B9\u6CD5;
+    this.\u63A5\u53E3\u903B\u8F91 = \u63A5\u53E3\u903B\u8F91;
+    this.\u63A5\u53E3\u9519\u8BEF\u5F62\u5F0FZod = \u63A5\u53E3\u9519\u8BEF\u5F62\u5F0FZod;
+    this.\u63A5\u53E3\u6B63\u786E\u5F62\u5F0FZod = \u63A5\u53E3\u6B63\u786E\u5F62\u5F0FZod;
+    this.\u7ED3\u679C\u8F6C\u6362\u5668 = \u7ED3\u679C\u8F6C\u6362\u5668;
+    this.\u7ED3\u679C\u8FD4\u56DE\u5668 = \u7ED3\u679C\u8FD4\u56DE\u5668;
+  }
+  \u83B7\u5F97\u8DEF\u5F84() {
+    return this.\u8BF7\u6C42\u8DEF\u5F84;
+  }
+  \u83B7\u5F97\u65B9\u6CD5() {
+    return this.\u8BF7\u6C42\u65B9\u6CD5;
+  }
+  \u83B7\u5F97\u903B\u8F91() {
+    return this.\u63A5\u53E3\u903B\u8F91;
+  }
+  \u83B7\u5F97\u63A5\u53E3\u9519\u8BEF\u5F62\u5F0FZod() {
+    return this.\u63A5\u53E3\u9519\u8BEF\u5F62\u5F0FZod;
+  }
+  \u83B7\u5F97\u63A5\u53E3\u6B63\u786E\u5F62\u5F0FZod() {
+    return this.\u63A5\u53E3\u6B63\u786E\u5F62\u5F0FZod;
+  }
+  \u83B7\u5F97\u7ED3\u679C\u8F6C\u6362\u5668() {
+    return this.\u7ED3\u679C\u8F6C\u6362\u5668;
+  }
+  \u83B7\u5F97\u7ED3\u679C\u8FD4\u56DE\u5668() {
+    return this.\u7ED3\u679C\u8FD4\u56DE\u5668;
+  }
+};
+
+// src/interface/interface-logic.ts
+var import_ts_fp_data = require("@lsby/ts-fp-data");
+
+// src/help/help.ts
+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;
+}
+
+// src/interface/interface-logic.ts
+var \u63A5\u53E3\u903B\u8F91Base = class _\u63A5\u53E3\u903B\u8F91Base {
+  constructor(\u4E0A\u6E38\u63A5\u53E3, \u6700\u540E\u63A5\u53E3) {
+    this.\u4E0A\u6E38\u63A5\u53E3 = \u4E0A\u6E38\u63A5\u53E3;
+    this.\u6700\u540E\u63A5\u53E3 = \u6700\u540E\u63A5\u53E3;
+  }
+  static \u7A7A\u903B\u8F91() {
+    return _\u63A5\u53E3\u903B\u8F91Base.\u6784\u9020([], async () => new import_ts_fp_data.Right({}));
+  }
+  static \u5B8C\u6574\u6784\u9020(\u63D2\u4EF6\u4EEC, \u5B9E\u73B0, \u6E05\u7406\u51FD\u6570, \u4E0A\u6E38\u63A5\u53E3\u903B\u8F91, \u6700\u540E\u63A5\u53E3\u903B\u8F91) {
+    let c = new class extends _\u63A5\u53E3\u903B\u8F91Base {
+      \u83B7\u5F97\u6E05\u7406\u51FD\u6570() {
+        return \u6E05\u7406\u51FD\u6570;
+      }
+      \u83B7\u5F97\u63D2\u4EF6\u4EEC() {
+        return \u63D2\u4EF6\u4EEC;
+      }
+      \u5B9E\u73B0(\u53C2\u6570, \u903B\u8F91\u9644\u52A0\u53C2\u6570, \u8BF7\u6C42\u9644\u52A0\u53C2\u6570) {
+        return \u5B9E\u73B0(\u53C2\u6570, \u903B\u8F91\u9644\u52A0\u53C2\u6570, \u8BF7\u6C42\u9644\u52A0\u53C2\u6570);
+      }
+    }(\u4E0A\u6E38\u63A5\u53E3\u903B\u8F91, \u6700\u540E\u63A5\u53E3\u903B\u8F91);
+    return c;
+  }
+  static \u6784\u9020(\u63D2\u4EF6\u4EEC, \u5B9E\u73B0, \u6E05\u7406\u51FD\u6570) {
+    return this.\u5B8C\u6574\u6784\u9020(\u63D2\u4EF6\u4EEC, \u5B9E\u73B0, \u6E05\u7406\u51FD\u6570, null, null);
+  }
+  async \u8BA1\u7B97\u63D2\u4EF6\u7ED3\u679C(req, res, \u8BF7\u6C42\u9644\u52A0\u53C2\u6570) {
+    let \u63D2\u4EF6\u4EEC = this.\u83B7\u5F97\u63D2\u4EF6\u4EEC();
+    let \u6240\u6709\u63D2\u4EF6\u7ED3\u679C = [];
+    for (let \u63D2\u4EF6 of \u63D2\u4EF6\u4EEC) {
+      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) => \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) {
+    let \u6E05\u7406\u51FD\u6570 = this.\u83B7\u5F97\u6E05\u7406\u51FD\u6570?.();
+    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) => \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) {
+        let \u4E0A\u5C42\u6DF7\u5408\u7ED3\u679C = \u6700\u7EC8\u7ED3\u679C !== void 0 && \u6700\u7EC8\u7ED3\u679C.isRight() === true ? \u6700\u7EC8\u7ED3\u679C.assertRight().getRight() : \u4F20\u5165\u7684\u903B\u8F91\u9644\u52A0\u53C2\u6570;
+        await \u6E05\u7406\u51FD\u6570(\u5408\u5E76\u63D2\u4EF6\u7ED3\u679C, \u4E0A\u5C42\u6DF7\u5408\u7ED3\u679C, \u4F20\u5165\u7684\u8BF7\u6C42\u9644\u52A0\u53C2\u6570);
+      }
+    }
+  }
+  async \u8FD0\u884C(req, res, \u4F20\u5165\u7684\u903B\u8F91\u9644\u52A0\u53C2\u6570, \u4F20\u5165\u7684\u63D2\u4EF6\u9644\u52A0\u53C2\u6570) {
+    let \u5408\u5E76\u63D2\u4EF6\u7ED3\u679C = await this.\u8BA1\u7B97\u63D2\u4EF6\u7ED3\u679C(req, res, \u4F20\u5165\u7684\u63D2\u4EF6\u9644\u52A0\u53C2\u6570);
+    return this.\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\u63D2\u4EF6\u9644\u52A0\u53C2\u6570);
+  }
+  \u6DF7\u5408(\u8F93\u5165) {
+    let \u4E0A\u6E05\u7406 = this.\u83B7\u5F97\u6E05\u7406\u51FD\u6570?.();
+    let \u4E0B\u6E05\u7406 = \u8F93\u5165.\u83B7\u5F97\u6E05\u7406\u51FD\u6570?.();
+    let \u5408\u5E76\u6E05\u7406 = void 0;
+    if (\u4E0A\u6E05\u7406 !== void 0 && \u4E0B\u6E05\u7406 !== void 0) {
+      \u5408\u5E76\u6E05\u7406 = async (\u53C2\u6570, \u903B\u8F91\u9644\u52A0\u53C2\u6570, \u8BF7\u6C42\u9644\u52A0\u53C2\u6570) => {
+        await \u4E0A\u6E05\u7406(\u53C2\u6570, \u903B\u8F91\u9644\u52A0\u53C2\u6570, \u8BF7\u6C42\u9644\u52A0\u53C2\u6570);
+        await \u4E0B\u6E05\u7406(\u53C2\u6570, \u903B\u8F91\u9644\u52A0\u53C2\u6570, \u8BF7\u6C42\u9644\u52A0\u53C2\u6570);
+      };
+    } else if (\u4E0A\u6E05\u7406 !== void 0) {
+      \u5408\u5E76\u6E05\u7406 = async (\u53C2\u6570, \u903B\u8F91\u9644\u52A0\u53C2\u6570, \u8BF7\u6C42\u9644\u52A0\u53C2\u6570) => {
+        await \u4E0A\u6E05\u7406(\u53C2\u6570, \u903B\u8F91\u9644\u52A0\u53C2\u6570, \u8BF7\u6C42\u9644\u52A0\u53C2\u6570);
+      };
+    } else if (\u4E0B\u6E05\u7406 !== void 0) {
+      \u5408\u5E76\u6E05\u7406 = async (\u53C2\u6570, \u903B\u8F91\u9644\u52A0\u53C2\u6570, \u8BF7\u6C42\u9644\u52A0\u53C2\u6570) => {
+        await \u4E0B\u6E05\u7406(\u53C2\u6570, \u903B\u8F91\u9644\u52A0\u53C2\u6570, \u8BF7\u6C42\u9644\u52A0\u53C2\u6570);
+      };
+    }
+    return _\u63A5\u53E3\u903B\u8F91Base.\u5B8C\u6574\u6784\u9020(
+      [...this.\u83B7\u5F97\u63D2\u4EF6\u4EEC(), ...\u8F93\u5165.\u83B7\u5F97\u63D2\u4EF6\u4EEC()],
+      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 = \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) => \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,
+      this,
+      \u8F93\u5165
+    );
+  }
+  \u83B7\u5F97\u4E0A\u6E38\u63A5\u53E3() {
+    return this.\u4E0A\u6E38\u63A5\u53E3;
+  }
+  \u83B7\u5F97\u6700\u540E\u63A5\u53E3() {
+    return this.\u6700\u540E\u63A5\u53E3;
+  }
+};
+
+// src/interface/interface-result.ts
+var \u63A5\u53E3\u7ED3\u679C\u8F6C\u6362\u5668 = class {
+};
+
+// src/interface/interface-retuen.ts
+var \u63A5\u53E3\u7ED3\u679C\u8FD4\u56DE\u5668 = class {
+};
+
+// src/wrapper/express-compatible-wrapper.ts
+var Express\u517C\u5BB9\u63A5\u53E3\u5C01\u88C5 = class extends \u63A5\u53E3 {
+  constructor(\u8BF7\u6C42\u8DEF\u5F84, \u8BF7\u6C42\u65B9\u6CD5, \u5904\u7406\u51FD\u6570) {
+    let \u903B\u8F91 = \u63A5\u53E3\u903B\u8F91Base.\u6784\u9020([], async () => {
+      return new import_ts_fp_data2.Right({});
+    });
+    let \u8F6C\u6362\u5668 = new Express\u517C\u5BB9\u7ED3\u679C\u8F6C\u6362\u5668();
+    let \u8FD4\u56DE\u5668 = new Express\u517C\u5BB9\u8FD4\u56DE\u5668(\u5904\u7406\u51FD\u6570);
+    super(
+      \u8BF7\u6C42\u8DEF\u5F84,
+      \u8BF7\u6C42\u65B9\u6CD5,
+      \u903B\u8F91,
+      import_zod.z.any(),
+      // 错误形式不做限制
+      import_zod.z.any(),
+      // 正确形式不做限制
+      \u8F6C\u6362\u5668,
+      \u8FD4\u56DE\u5668
+    );
+  }
+};
+var Express\u517C\u5BB9\u7ED3\u679C\u8F6C\u6362\u5668 = class extends \u63A5\u53E3\u7ED3\u679C\u8F6C\u6362\u5668 {
+  \u5B9E\u73B0(\u6570\u636E) {
+    return \u6570\u636E;
+  }
+};
+var Express\u517C\u5BB9\u8FD4\u56DE\u5668 = class extends \u63A5\u53E3\u7ED3\u679C\u8FD4\u56DE\u5668 {
+  constructor(\u5904\u7406\u51FD\u6570) {
+    super();
+    this.\u5904\u7406\u51FD\u6570 = \u5904\u7406\u51FD\u6570;
+  }
+  \u8FD4\u56DE(req, res, _\u7ED3\u679C) {
+    return this.\u5904\u7406\u51FD\u6570(req, res);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Express\u517C\u5BB9\u63A5\u53E3\u5C01\u88C5
+});

package/dist/cjs/wrapper/express-compatible-wrapper.d.cts

@@ -0,0 +1,55 @@
+import { Request, Response } from 'express';
+import { z } from 'zod';
+import { b as __, 接 as ______, a as ______$1, l as ____Base, 空 as ___, w as _______ } from '../interface-base-CyfrfgWu.cjs';
+import { 接口结果返回器 as _______$1 } from '../interface/interface-retuen.cjs';
+import '@lsby/ts-fp-data';
+import '../help/interior.cjs';
+import '@lsby/ts-log';
+import 'node:http';
+
+/**
+ * Express 兼容接口封装
+ *
+ * 为熟悉 Express 的用户提供快速迁移方案
+ *
+ * 特点:
+ * - 接收 Express 风格的处理函数 (req, res) => Promise<void>
+ * - 输入输出类型均为 any，不支持类型推断
+ * - 不支持插件系统和复用
+ * - 最大化简化，最小化学习曲线
+ *
+ * 示例:
+ * ```ts
+ * const api = new Express兼容接口封装(
+ *   '/api/user',
+ *   'post',
+ *   async (req, res) => {
+ *     const data = req.body
+ *     res.send({ success: true, data })
+ *   }
+ * )
+ * ```
+ */
+declare class Express兼容接口封装 extends __<______, ______$1, ____Base<[], ___, string, {}, null, null>, z.ZodType<any>, z.ZodType<any>, Express兼容结果转换器, Express兼容返回器> {
+    constructor(请求路径: ______, 请求方法: ______$1, 处理函数: (req: Request, res: Response) => Promise<void>);
+}
+/**
+ * Express 兼容结果转换器
+ *
+ * 直接通过，不做任何转换
+ */
+declare class Express兼容结果转换器 extends _______<string, {}, any, any> {
+    实现(数据: any): any;
+}
+/**
+ * Express 兼容返回器
+ *
+ * 直接执行用户提供的处理函数
+ */
+declare class Express兼容返回器 extends _______$1<any> {
+    private 处理函数;
+    constructor(处理函数: (req: Request, res: Response) => Promise<void>);
+    返回(req: Request, res: Response, _结果: any): Promise<void>;
+}
+
+export { Express兼容接口封装 };

package/dist/cjs/wrapper/file-download-wrapper.cjs

@@ -0,0 +1,134 @@
+"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/wrapper/file-download-wrapper.ts
+var file_download_wrapper_exports = {};
+__export(file_download_wrapper_exports, {
+  \u6587\u4EF6\u4E0B\u8F7D\u63A5\u53E3\u5C01\u88C5: () => \u6587\u4EF6\u4E0B\u8F7D\u63A5\u53E3\u5C01\u88C5
+});
+module.exports = __toCommonJS(file_download_wrapper_exports);
+var import_node_fs = require("fs");
+var import_zod = require("zod");
+
+// src/interface/interface-base.ts
+var \u63A5\u53E3 = class {
+  constructor(\u8BF7\u6C42\u8DEF\u5F84, \u8BF7\u6C42\u65B9\u6CD5, \u63A5\u53E3\u903B\u8F91, \u63A5\u53E3\u9519\u8BEF\u5F62\u5F0FZod, \u63A5\u53E3\u6B63\u786E\u5F62\u5F0FZod, \u7ED3\u679C\u8F6C\u6362\u5668, \u7ED3\u679C\u8FD4\u56DE\u5668) {
+    this.\u8BF7\u6C42\u8DEF\u5F84 = \u8BF7\u6C42\u8DEF\u5F84;
+    this.\u8BF7\u6C42\u65B9\u6CD5 = \u8BF7\u6C42\u65B9\u6CD5;
+    this.\u63A5\u53E3\u903B\u8F91 = \u63A5\u53E3\u903B\u8F91;
+    this.\u63A5\u53E3\u9519\u8BEF\u5F62\u5F0FZod = \u63A5\u53E3\u9519\u8BEF\u5F62\u5F0FZod;
+    this.\u63A5\u53E3\u6B63\u786E\u5F62\u5F0FZod = \u63A5\u53E3\u6B63\u786E\u5F62\u5F0FZod;
+    this.\u7ED3\u679C\u8F6C\u6362\u5668 = \u7ED3\u679C\u8F6C\u6362\u5668;
+    this.\u7ED3\u679C\u8FD4\u56DE\u5668 = \u7ED3\u679C\u8FD4\u56DE\u5668;
+  }
+  \u83B7\u5F97\u8DEF\u5F84() {
+    return this.\u8BF7\u6C42\u8DEF\u5F84;
+  }
+  \u83B7\u5F97\u65B9\u6CD5() {
+    return this.\u8BF7\u6C42\u65B9\u6CD5;
+  }
+  \u83B7\u5F97\u903B\u8F91() {
+    return this.\u63A5\u53E3\u903B\u8F91;
+  }
+  \u83B7\u5F97\u63A5\u53E3\u9519\u8BEF\u5F62\u5F0FZod() {
+    return this.\u63A5\u53E3\u9519\u8BEF\u5F62\u5F0FZod;
+  }
+  \u83B7\u5F97\u63A5\u53E3\u6B63\u786E\u5F62\u5F0FZod() {
+    return this.\u63A5\u53E3\u6B63\u786E\u5F62\u5F0FZod;
+  }
+  \u83B7\u5F97\u7ED3\u679C\u8F6C\u6362\u5668() {
+    return this.\u7ED3\u679C\u8F6C\u6362\u5668;
+  }
+  \u83B7\u5F97\u7ED3\u679C\u8FD4\u56DE\u5668() {
+    return this.\u7ED3\u679C\u8FD4\u56DE\u5668;
+  }
+};
+
+// src/interface/interface-result.ts
+var \u63A5\u53E3\u7ED3\u679C\u8F6C\u6362\u5668 = class {
+};
+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().data;
+      }
+      default: {
+        throw new Error("\u610F\u5916\u7684\u6570\u636E\u6807\u8BB0");
+      }
+    }
+  }
+};
+
+// src/interface/interface-retuen.ts
+var \u63A5\u53E3\u7ED3\u679C\u8FD4\u56DE\u5668 = class {
+};
+
+// src/wrapper/file-download-wrapper.ts
+var \u6587\u4EF6\u4E0B\u8F7D\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, \u6587\u4EF6\u540D, MIME\u7C7B\u578B) {
+    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\u8F6C\u6362\u5668 = new \u76F4\u63A5\u5F62\u5F0F\u8F6C\u6362\u5668();
+    let \u8FD4\u56DE\u5668 = new \u6587\u4EF6\u4E0B\u8F7D\u8FD4\u56DE\u5668(\u6587\u4EF6\u540D, MIME\u7C7B\u578B);
+    super(
+      \u8BF7\u6C42\u8DEF\u5F84,
+      \u8BF7\u6C42\u65B9\u6CD5,
+      \u63A5\u53E3\u903B\u8F91,
+      \u63A5\u53E3\u9519\u8BEF\u8F93\u51FA\u5F62\u5F0F,
+      import_zod.z.any(),
+      // 正确形式任意
+      \u63A5\u53E3\u8F6C\u6362\u5668,
+      \u8FD4\u56DE\u5668
+    );
+  }
+};
+var \u6587\u4EF6\u4E0B\u8F7D\u8FD4\u56DE\u5668 = class extends \u63A5\u53E3\u7ED3\u679C\u8FD4\u56DE\u5668 {
+  constructor(\u6587\u4EF6\u540D, MIME\u7C7B\u578B) {
+    super();
+    this.\u6587\u4EF6\u540D = \u6587\u4EF6\u540D;
+    this.MIME\u7C7B\u578B = MIME\u7C7B\u578B;
+  }
+  async \u8FD4\u56DE(req, res, \u7ED3\u679C) {
+    if (this.MIME\u7C7B\u578B !== void 0) {
+      res.setHeader("Content-Type", this.MIME\u7C7B\u578B);
+    }
+    if (this.\u6587\u4EF6\u540D !== void 0) {
+      let encodedFilename = encodeURIComponent(this.\u6587\u4EF6\u540D);
+      res.setHeader("Content-Disposition", `attachment; filename*=UTF-8''${encodedFilename}`);
+    }
+    if (Buffer.isBuffer(\u7ED3\u679C)) {
+      res.setHeader("Content-Length", \u7ED3\u679C.length);
+      res.send(\u7ED3\u679C);
+    } else if (typeof \u7ED3\u679C === "string") {
+      let \u6D41 = (0, import_node_fs.createReadStream)(\u7ED3\u679C);
+      \u6D41.pipe(res);
+    } else if (typeof \u7ED3\u679C.pipe === "function") {
+      \u7ED3\u679C.pipe(res);
+    } else {
+      res.status(400).send("Invalid file data");
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  \u6587\u4EF6\u4E0B\u8F7D\u63A5\u53E3\u5C01\u88C5
+});

package/dist/cjs/wrapper/file-download-wrapper.d.cts

@@ -0,0 +1,80 @@
+import { Request, Response } from 'express';
+import { ReadStream } from 'node:fs';
+import { z } from 'zod';
+import { 接 as ______, a as ______$1, l as ____Base, 空 as ___, b as __, 直 as _______, q as __________, r as __________$1 } from '../interface-base-CyfrfgWu.cjs';
+import { 接口结果返回器 as _______$1 } from '../interface/interface-retuen.cjs';
+import '@lsby/ts-fp-data';
+import '../help/interior.cjs';
+import '@lsby/ts-log';
+import 'node:http';
+
+type 文件数据类型 = {
+    data: Buffer | ReadStream | string;
+    filename?: string;
+    mimeType?: string;
+};
+/**
+ * 文件下载接口封装
+ *
+ * 用于提供文件下载能力，支持:
+ * - Buffer 直接发送
+ * - 文件路径（自动创建流）
+ * - 流对象直接传送
+ *
+ * 使用方式:
+ * - 接口逻辑返回 Either<错误, { data: 文件数据 }>
+ * - 文件数据可以是 Buffer、文件路径字符串、或 ReadStream
+ * - 错误返回标准错误格式
+ *
+ * 示例:
+ * ```ts
+ * const 逻辑 = 接口逻辑Base.构造(
+ *   [GET参数解析插件],
+ *   async ({ query }) => {
+ *     const buffer = await fs.readFile(query.filepath)
+ *     return new Right({
+ *       data: buffer,
+ *       filename: 'export.xlsx',
+ *       mimeType: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+ *     })
+ *   }
+ * )
+ *
+ * const api = new 文件下载接口封装(
+ *   '/api/download',
+ *   'get',
+ *   逻辑,
+ *   z.object({ filepath: z.string() }), // 错误类型
+ *   z.object({ data: z.any() })  // 正确类型必须包含 data 字段
+ * )
+ * ```
+ */
+declare class 文件下载接口封装<路径类型 extends ______, 方法类型 extends ______$1, 逻辑类型 extends ____Base<any, ___, z.infer<接口错误形式Zod>, {
+    data: 任意文件数据;
+}, any, any>, 接口错误形式Zod extends z.ZodTypeAny, 任意文件数据 = Buffer | ReadStream | string> extends __<路径类型, 方法类型, 逻辑类型, z.ZodObject<{
+    status: z.ZodLiteral<'fail'>;
+    data: 接口错误形式Zod;
+}>, z.ZodType<any>, _______<任意文件数据, __________<逻辑类型>, __________$1<逻辑类型>>, 文件下载返回器> {
+    constructor(请求路径: 路径类型, 请求方法: 方法类型, 接口逻辑: 逻辑类型, 逻辑错误类型Zod: 接口错误形式Zod, 文件名?: string, MIME类型?: string);
+}
+/**
+ * 文件下载返回器
+ *
+ * 处理文件的发送，支持:
+ * 1. Buffer - 直接设置 Content-Length 后发送
+ * 2. ReadStream - 自动 pipe 到响应
+ * 3. 文件路径字符串 - 创建读流后发送
+ *
+ * 自动设置的响应头:
+ * - Content-Disposition: 用于设置下载文件名
+ * - Content-Type: 根据 MIME 类型设置
+ * - Content-Length: 对于 Buffer 自动计算
+ */
+declare class 文件下载返回器 extends _______$1<Buffer | ReadStream | string> {
+    private 文件名?;
+    private MIME类型?;
+    constructor(文件名?: string | undefined, MIME类型?: string | undefined);
+    返回(req: Request, res: Response, 结果: Buffer | ReadStream | string): Promise<void>;
+}
+
+export { 文件下载接口封装, type 文件数据类型 };

package/dist/esm/chunk-NCYHKHIH.js

@@ -0,0 +1,54 @@
+import {
+  接口结果返回器
+} from "./chunk-XBAKTT6S.js";
+import {
+  接口
+} from "./chunk-MDUWXEQ7.js";
+import {
+  接口逻辑Base
+} from "./chunk-E23EZWBE.js";
+import {
+  接口结果转换器
+} from "./chunk-DNJQGD5M.js";
+
+// src/wrapper/express-compatible-wrapper.ts
+import { Right } from "@lsby/ts-fp-data";
+import { z } from "zod";
+var Express\u517C\u5BB9\u63A5\u53E3\u5C01\u88C5 = class extends \u63A5\u53E3 {
+  constructor(\u8BF7\u6C42\u8DEF\u5F84, \u8BF7\u6C42\u65B9\u6CD5, \u5904\u7406\u51FD\u6570) {
+    let \u903B\u8F91 = \u63A5\u53E3\u903B\u8F91Base.\u6784\u9020([], async () => {
+      return new Right({});
+    });
+    let \u8F6C\u6362\u5668 = new Express\u517C\u5BB9\u7ED3\u679C\u8F6C\u6362\u5668();
+    let \u8FD4\u56DE\u5668 = new Express\u517C\u5BB9\u8FD4\u56DE\u5668(\u5904\u7406\u51FD\u6570);
+    super(
+      \u8BF7\u6C42\u8DEF\u5F84,
+      \u8BF7\u6C42\u65B9\u6CD5,
+      \u903B\u8F91,
+      z.any(),
+      // 错误形式不做限制
+      z.any(),
+      // 正确形式不做限制
+      \u8F6C\u6362\u5668,
+      \u8FD4\u56DE\u5668
+    );
+  }
+};
+var Express\u517C\u5BB9\u7ED3\u679C\u8F6C\u6362\u5668 = class extends \u63A5\u53E3\u7ED3\u679C\u8F6C\u6362\u5668 {
+  \u5B9E\u73B0(\u6570\u636E) {
+    return \u6570\u636E;
+  }
+};
+var Express\u517C\u5BB9\u8FD4\u56DE\u5668 = class extends \u63A5\u53E3\u7ED3\u679C\u8FD4\u56DE\u5668 {
+  constructor(\u5904\u7406\u51FD\u6570) {
+    super();
+    this.\u5904\u7406\u51FD\u6570 = \u5904\u7406\u51FD\u6570;
+  }
+  \u8FD4\u56DE(req, res, _\u7ED3\u679C) {
+    return this.\u5904\u7406\u51FD\u6570(req, res);
+  }
+};
+
+export {
+  Express兼容接口封装
+};

package/dist/esm/chunk-XSYZ5A6R.js

@@ -0,0 +1,61 @@
+import {
+  接口结果返回器
+} from "./chunk-XBAKTT6S.js";
+import {
+  接口
+} from "./chunk-MDUWXEQ7.js";
+import {
+  直接形式转换器
+} from "./chunk-DNJQGD5M.js";
+
+// src/wrapper/file-download-wrapper.ts
+import { createReadStream } from "fs";
+import { z } from "zod";
+var \u6587\u4EF6\u4E0B\u8F7D\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, \u6587\u4EF6\u540D, MIME\u7C7B\u578B) {
+    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\u8F6C\u6362\u5668 = new \u76F4\u63A5\u5F62\u5F0F\u8F6C\u6362\u5668();
+    let \u8FD4\u56DE\u5668 = new \u6587\u4EF6\u4E0B\u8F7D\u8FD4\u56DE\u5668(\u6587\u4EF6\u540D, MIME\u7C7B\u578B);
+    super(
+      \u8BF7\u6C42\u8DEF\u5F84,
+      \u8BF7\u6C42\u65B9\u6CD5,
+      \u63A5\u53E3\u903B\u8F91,
+      \u63A5\u53E3\u9519\u8BEF\u8F93\u51FA\u5F62\u5F0F,
+      z.any(),
+      // 正确形式任意
+      \u63A5\u53E3\u8F6C\u6362\u5668,
+      \u8FD4\u56DE\u5668
+    );
+  }
+};
+var \u6587\u4EF6\u4E0B\u8F7D\u8FD4\u56DE\u5668 = class extends \u63A5\u53E3\u7ED3\u679C\u8FD4\u56DE\u5668 {
+  constructor(\u6587\u4EF6\u540D, MIME\u7C7B\u578B) {
+    super();
+    this.\u6587\u4EF6\u540D = \u6587\u4EF6\u540D;
+    this.MIME\u7C7B\u578B = MIME\u7C7B\u578B;
+  }
+  async \u8FD4\u56DE(req, res, \u7ED3\u679C) {
+    if (this.MIME\u7C7B\u578B !== void 0) {
+      res.setHeader("Content-Type", this.MIME\u7C7B\u578B);
+    }
+    if (this.\u6587\u4EF6\u540D !== void 0) {
+      let encodedFilename = encodeURIComponent(this.\u6587\u4EF6\u540D);
+      res.setHeader("Content-Disposition", `attachment; filename*=UTF-8''${encodedFilename}`);
+    }
+    if (Buffer.isBuffer(\u7ED3\u679C)) {
+      res.setHeader("Content-Length", \u7ED3\u679C.length);
+      res.send(\u7ED3\u679C);
+    } else if (typeof \u7ED3\u679C === "string") {
+      let \u6D41 = createReadStream(\u7ED3\u679C);
+      \u6D41.pipe(res);
+    } else if (typeof \u7ED3\u679C.pipe === "function") {
+      \u7ED3\u679C.pipe(res);
+    } else {
+      res.status(400).send("Invalid file data");
+    }
+  }
+};
+
+export {
+  文件下载接口封装
+};

package/dist/esm/index.d.ts

@@ -13,9 +13,12 @@ export { GetNetCoreExportTypeDefine, GetNetCoreExportTypeName, NetCoreExportType
 export { 常用形式接口封装 } from './wrapper/common-wrapper.js';
 export { 常用形式并自定义返回器接口封装 } from './wrapper/common-wrapper-return.js';
 export { 常用直接形式接口封装 } from './wrapper/deferred-result-wrapper.js';
+export { Express兼容接口封装 } from './wrapper/express-compatible-wrapper.js';
+export { 文件下载接口封装, 文件数据类型 } from './wrapper/file-download-wrapper.js';
 import 'zod';
 import '@lsby/ts-fp-data';
 import 'express';
 import './help/interior.js';
 import '@lsby/ts-log';
 import 'node:http';
+import 'node:fs';

package/dist/esm/index.js

@@ -1,3 +1,6 @@
+import {
+  WebSocket插件
+} from "./chunk-C5FED6EO.js";
 import {
   自定义数据插件
 } from "./chunk-VMCAX3QH.js";
@@ -13,12 +16,15 @@ import {
 import {
   表单解析插件
 } from "./chunk-3XRAG6DM.js";
-import {
-  WebSocket插件
-} from "./chunk-C5FED6EO.js";
 import {
   常用直接形式接口封装
 } from "./chunk-NB2QNDI2.js";
+import {
+  Express兼容接口封装
+} from "./chunk-NCYHKHIH.js";
+import {
+  文件下载接口封装
+} from "./chunk-XSYZ5A6R.js";
 import {
   接口测试
 } from "./chunk-N7TPWCQ5.js";
@@ -64,6 +70,7 @@ import {
 } from "./chunk-DNJQGD5M.js";
 export {
   EXPORT_TYPE,
+  Express\u517C\u5BB9\u63A5\u53E3\u5C01\u88C5,
   GET\u53C2\u6570\u89E3\u6790\u63D2\u4EF6,
   JSON\u89E3\u6790\u63D2\u4EF6,
   WebSocket\u63D2\u4EF6,
@@ -79,6 +86,7 @@ export {
   \u63A5\u53E3\u903B\u8F91,
   \u63A5\u53E3\u903B\u8F91Base,
   \u63D2\u4EF6,
+  \u6587\u4EF6\u4E0B\u8F7D\u63A5\u53E3\u5C01\u88C5,
   \u666E\u901A\u5BF9\u8C61\u6DF1\u5408\u5E76,
   \u670D\u52A1\u5668,
   \u6784\u9020\u5143\u7EC4,

package/dist/esm/wrapper/express-compatible-wrapper.d.ts

@@ -0,0 +1,55 @@
+import { Request, Response } from 'express';
+import { z } from 'zod';
+import { b as __, 接 as ______, a as ______$1, l as ____Base, 空 as ___, w as _______ } from '../interface-base-C1ZNSMJz.js';
+import { 接口结果返回器 as _______$1 } from '../interface/interface-retuen.js';
+import '@lsby/ts-fp-data';
+import '../help/interior.js';
+import '@lsby/ts-log';
+import 'node:http';
+
+/**
+ * Express 兼容接口封装
+ *
+ * 为熟悉 Express 的用户提供快速迁移方案
+ *
+ * 特点:
+ * - 接收 Express 风格的处理函数 (req, res) => Promise<void>
+ * - 输入输出类型均为 any，不支持类型推断
+ * - 不支持插件系统和复用
+ * - 最大化简化，最小化学习曲线
+ *
+ * 示例:
+ * ```ts
+ * const api = new Express兼容接口封装(
+ *   '/api/user',
+ *   'post',
+ *   async (req, res) => {
+ *     const data = req.body
+ *     res.send({ success: true, data })
+ *   }
+ * )
+ * ```
+ */
+declare class Express兼容接口封装 extends __<______, ______$1, ____Base<[], ___, string, {}, null, null>, z.ZodType<any>, z.ZodType<any>, Express兼容结果转换器, Express兼容返回器> {
+    constructor(请求路径: ______, 请求方法: ______$1, 处理函数: (req: Request, res: Response) => Promise<void>);
+}
+/**
+ * Express 兼容结果转换器
+ *
+ * 直接通过，不做任何转换
+ */
+declare class Express兼容结果转换器 extends _______<string, {}, any, any> {
+    实现(数据: any): any;
+}
+/**
+ * Express 兼容返回器
+ *
+ * 直接执行用户提供的处理函数
+ */
+declare class Express兼容返回器 extends _______$1<any> {
+    private 处理函数;
+    constructor(处理函数: (req: Request, res: Response) => Promise<void>);
+    返回(req: Request, res: Response, _结果: any): Promise<void>;
+}
+
+export { Express兼容接口封装 };

package/dist/esm/wrapper/express-compatible-wrapper.js

@@ -0,0 +1,11 @@
+import {
+  Express兼容接口封装
+} from "../chunk-NCYHKHIH.js";
+import "../chunk-XBAKTT6S.js";
+import "../chunk-MDUWXEQ7.js";
+import "../chunk-E23EZWBE.js";
+import "../chunk-7LQRWJ3X.js";
+import "../chunk-DNJQGD5M.js";
+export {
+  Express\u517C\u5BB9\u63A5\u53E3\u5C01\u88C5
+};

package/dist/esm/wrapper/file-download-wrapper.d.ts

@@ -0,0 +1,80 @@
+import { Request, Response } from 'express';
+import { ReadStream } from 'node:fs';
+import { z } from 'zod';
+import { 接 as ______, a as ______$1, l as ____Base, 空 as ___, b as __, 直 as _______, q as __________, r as __________$1 } from '../interface-base-C1ZNSMJz.js';
+import { 接口结果返回器 as _______$1 } from '../interface/interface-retuen.js';
+import '@lsby/ts-fp-data';
+import '../help/interior.js';
+import '@lsby/ts-log';
+import 'node:http';
+
+type 文件数据类型 = {
+    data: Buffer | ReadStream | string;
+    filename?: string;
+    mimeType?: string;
+};
+/**
+ * 文件下载接口封装
+ *
+ * 用于提供文件下载能力，支持:
+ * - Buffer 直接发送
+ * - 文件路径（自动创建流）
+ * - 流对象直接传送
+ *
+ * 使用方式:
+ * - 接口逻辑返回 Either<错误, { data: 文件数据 }>
+ * - 文件数据可以是 Buffer、文件路径字符串、或 ReadStream
+ * - 错误返回标准错误格式
+ *
+ * 示例:
+ * ```ts
+ * const 逻辑 = 接口逻辑Base.构造(
+ *   [GET参数解析插件],
+ *   async ({ query }) => {
+ *     const buffer = await fs.readFile(query.filepath)
+ *     return new Right({
+ *       data: buffer,
+ *       filename: 'export.xlsx',
+ *       mimeType: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+ *     })
+ *   }
+ * )
+ *
+ * const api = new 文件下载接口封装(
+ *   '/api/download',
+ *   'get',
+ *   逻辑,
+ *   z.object({ filepath: z.string() }), // 错误类型
+ *   z.object({ data: z.any() })  // 正确类型必须包含 data 字段
+ * )
+ * ```
+ */
+declare class 文件下载接口封装<路径类型 extends ______, 方法类型 extends ______$1, 逻辑类型 extends ____Base<any, ___, z.infer<接口错误形式Zod>, {
+    data: 任意文件数据;
+}, any, any>, 接口错误形式Zod extends z.ZodTypeAny, 任意文件数据 = Buffer | ReadStream | string> extends __<路径类型, 方法类型, 逻辑类型, z.ZodObject<{
+    status: z.ZodLiteral<'fail'>;
+    data: 接口错误形式Zod;
+}>, z.ZodType<any>, _______<任意文件数据, __________<逻辑类型>, __________$1<逻辑类型>>, 文件下载返回器> {
+    constructor(请求路径: 路径类型, 请求方法: 方法类型, 接口逻辑: 逻辑类型, 逻辑错误类型Zod: 接口错误形式Zod, 文件名?: string, MIME类型?: string);
+}
+/**
+ * 文件下载返回器
+ *
+ * 处理文件的发送，支持:
+ * 1. Buffer - 直接设置 Content-Length 后发送
+ * 2. ReadStream - 自动 pipe 到响应
+ * 3. 文件路径字符串 - 创建读流后发送
+ *
+ * 自动设置的响应头:
+ * - Content-Disposition: 用于设置下载文件名
+ * - Content-Type: 根据 MIME 类型设置
+ * - Content-Length: 对于 Buffer 自动计算
+ */
+declare class 文件下载返回器 extends _______$1<Buffer | ReadStream | string> {
+    private 文件名?;
+    private MIME类型?;
+    constructor(文件名?: string | undefined, MIME类型?: string | undefined);
+    返回(req: Request, res: Response, 结果: Buffer | ReadStream | string): Promise<void>;
+}
+
+export { 文件下载接口封装, type 文件数据类型 };

package/dist/esm/wrapper/file-download-wrapper.js

@@ -0,0 +1,9 @@
+import {
+  文件下载接口封装
+} from "../chunk-XSYZ5A6R.js";
+import "../chunk-XBAKTT6S.js";
+import "../chunk-MDUWXEQ7.js";
+import "../chunk-DNJQGD5M.js";
+export {
+  \u6587\u4EF6\u4E0B\u8F7D\u63A5\u53E3\u5C01\u88C5
+};

package/package.json

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