@lsby/net-core 0.10.0 → 0.10.2

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/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-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-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/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,4 +1,4 @@
-export { 构造元组, 构造对象 } from './help/help.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';

package/dist/esm/index.js

@@ -1,3 +1,6 @@
+import {
+  WebSocket插件
+} from "./chunk-C5FED6EO.js";
 import {
   自定义数据插件
 } from "./chunk-VMCAX3QH.js";
@@ -13,21 +16,18 @@ import {
 import {
   表单解析插件
 } from "./chunk-3XRAG6DM.js";
-import {
-  WebSocket插件
-} from "./chunk-C5FED6EO.js";
 import {
   常用直接形式接口封装
 } from "./chunk-NB2QNDI2.js";
 import {
   接口测试
 } from "./chunk-N7TPWCQ5.js";
-import {
-  服务器
-} from "./chunk-3ZQFVYIR.js";
 import {
   插件
 } from "./chunk-43GZE5YL.js";
+import {
+  服务器
+} from "./chunk-3ZQFVYIR.js";
 import {
   EXPORT_TYPE
 } from "./chunk-ZF7EC2OM.js";
@@ -44,10 +44,6 @@ import {
   自定义返回器
 } from "./chunk-XBAKTT6S.js";
 import "./chunk-NJKBRPN7.js";
-import {
-  构造元组,
-  构造对象
-} from "./chunk-YMH6HJJF.js";
 import "./chunk-ZIVQ3WZA.js";
 import {
   接口
@@ -55,7 +51,12 @@ import {
 import {
   接口逻辑,
   接口逻辑Base
-} from "./chunk-ITCALAYE.js";
+} from "./chunk-E23EZWBE.js";
+import {
+  普通对象深合并,
+  构造元组,
+  构造对象
+} from "./chunk-7LQRWJ3X.js";
 import {
   常用形式转换器,
   接口结果转换器,
@@ -78,6 +79,7 @@ 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,

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/plugin/extend/json.d.ts

@@ -1,5 +1,6 @@
 import express from 'express';
 import { AnyZodObject, z } from 'zod';
+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';
@@ -16,9 +17,9 @@ declare class JSON解析插件<Result extends AnyZodObject> extends __<z.ZodObje
 }
 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解析插件项 ? {
+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> : {} : {} : {};
+}, 合并JSON插件结果<xs>> : 合并JSON插件结果<xs> : {} : {} : {};
 type 计算接口逻辑JSON参数<接口逻辑> = 合并JSON插件结果<__________<接口逻辑>>;
 
 export { JSON解析插件, type 任意JSON解析插件, type 任意JSON解析插件项, type 合并JSON插件结果, type 计算接口逻辑JSON参数 };

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

@@ -1,4 +1,5 @@
 import { AnyZodObject, z } from 'zod';
+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';
@@ -16,9 +17,9 @@ declare class GET参数解析插件<Result extends AnyZodObject> extends __<z.Zo
 }
 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参数解析插件项 ? {
+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> : {} : {} : {};
+}, 合并GET插件结果<xs>> : 合并GET插件结果<xs> : {} : {} : {};
 type 计算接口逻辑GET参数<接口逻辑> = 合并GET插件结果<__________<接口逻辑>>;
 
 export { GET参数解析插件, type 任意GET参数解析插件, type 任意GET参数解析插件项, type 合并GET插件结果, type 计算接口逻辑GET参数 };

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,54 @@
+import {
+  接口结果返回器
+} from "../chunk-XBAKTT6S.js";
+import {
+  接口
+} from "../chunk-MDUWXEQ7.js";
+import {
+  接口逻辑Base
+} from "../chunk-E23EZWBE.js";
+import "../chunk-7LQRWJ3X.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\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 文件数据类型 };