@lsby/net-core 0.3.12 → 0.3.13

package/dist/cjs/interface/inst/interface-abstract.cjs

@@ -23,7 +23,129 @@ __export(interface_abstract_exports, {
   API\u63A5\u53E3\u57FA\u7C7B: () => API\u63A5\u53E3\u57FA\u7C7B
 });
 module.exports = __toCommonJS(interface_abstract_exports);
-var API\u63A5\u53E3\u57FA\u7C7B = class {
+
+// src/interface/action/action.ts
+var import_ts_fp_data = require("@lsby/ts-fp-data");
+var \u4E1A\u52A1\u884C\u4E3A = class _\u4E1A\u52A1\u884C\u4E3A {
+  // ================================= 静态 =================================
+  static \u901A\u8FC7\u5B9E\u73B0\u6784\u9020(\u5B9E\u73B0, \u4E1A\u52A1\u884C\u4E3A\u540D\u79F0) {
+    return new class extends _\u4E1A\u52A1\u884C\u4E3A {
+      async \u4E1A\u52A1\u884C\u4E3A\u5B9E\u73B0(\u53C2\u6570) {
+        return \u5B9E\u73B0(\u53C2\u6570);
+      }
+    }(\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0);
+  }
+  static \u6D41\u5F0F\u7EC4\u5408(a, b) {
+    return a.\u6D41\u5F0F\u7EC4\u5408(b);
+  }
+  static \u6DF7\u5408\u7EC4\u5408(a, b) {
+    return a.\u6DF7\u5408\u7EC4\u5408(b);
+  }
+  /**
+   * 对多个项混合组合
+   */
+  static \u6DF7\u5408\u7EC4\u5408\u591A\u9879(arr) {
+    return arr.reduce((s, a) => s.\u6DF7\u5408\u7EC4\u5408(a));
+  }
+  /**
+   * 同时运行多个模型, 并提供一个函数处理它们的结果
+   * 如果其中任何一个模型发生错误, 则最终模型输出第一个错误
+   * 处理函数的类型是: 所有模型的结果合并 => 泛型A
+   * 新模型的类型是:
+   * - 参数: 所有模型的参数合并
+   * - 错误: 所有模型的错误合并
+   * - 返回值: 泛型A
+   */
+  static \u5E76\u884C\u7EC4\u5408(arr, f) {
+    return _\u4E1A\u52A1\u884C\u4E3A.\u901A\u8FC7\u5B9E\u73B0\u6784\u9020(
+      async (\u53C2\u6570) => {
+        var \u6240\u6709\u7ED3\u679C = await Promise.all(arr.map((a) => a.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u53C2\u6570)));
+        var \u9519\u8BEF = \u6240\u6709\u7ED3\u679C.filter((a) => a.isLeft())[0];
+        if (\u9519\u8BEF) return \u9519\u8BEF;
+        var \u6B63\u786E\u7ED3\u679C\u5408\u5E76 = \u6240\u6709\u7ED3\u679C.map((a) => a.assertRight().getRight()).reduce((s, a) => Object.assign(s, a), {});
+        return new import_ts_fp_data.Right(await f(\u6B63\u786E\u7ED3\u679C\u5408\u5E76));
+      },
+      `\u5E76\u884C\u7EC4\u5408(${arr.map((a) => a.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0).join(", ")})`
+    );
+  }
+  // ================================= 私有 =================================
+  \u4E1A\u52A1\u884C\u4E3A\u540D\u79F0;
+  constructor(\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0) {
+    if (!\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0) this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0 = this.constructor.name || "<\u533F\u540D>";
+    else this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0 = \u4E1A\u52A1\u884C\u4E3A\u540D\u79F0;
+  }
+  // ================================= 设置 =================================
+  \u8BBE\u7F6E\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0(\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0) {
+    this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0 = \u4E1A\u52A1\u884C\u4E3A\u540D\u79F0;
+    return this;
+  }
+  \u8BBE\u7F6E\u53C2\u6570(\u8BBE\u7F6E\u53C2\u6570) {
+    return _\u4E1A\u52A1\u884C\u4E3A.\u901A\u8FC7\u5B9E\u73B0\u6784\u9020(async (\u53C2\u6570) => {
+      return await this.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A({ ...\u8BBE\u7F6E\u53C2\u6570, ...\u53C2\u6570 });
+    }, this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0);
+  }
+  // ================================= 运行 =================================
+  async \u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u53C2\u6570) {
+    try {
+      return await this.\u4E1A\u52A1\u884C\u4E3A\u5B9E\u73B0(\u53C2\u6570);
+    } catch (e) {
+      throw e;
+    }
+  }
+  // ================================= 组合 =================================
+  /**
+   * 将两个模型串接, 得到一个新模型, 新模型的类型是:
+   * - 参数: a模型的参数
+   * - 错误: a模型的错误+b模型的错误
+   * - 返回值: b模型的返回值
+   */
+  \u6D41\u5F0F\u7EC4\u5408(b) {
+    return _\u4E1A\u52A1\u884C\u4E3A.\u901A\u8FC7\u5B9E\u73B0\u6784\u9020(async (\u53C2\u6570) => {
+      const \u6211\u7684\u7ED3\u679C = await this.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u53C2\u6570);
+      if (\u6211\u7684\u7ED3\u679C.isLeft()) return new import_ts_fp_data.Left(\u6211\u7684\u7ED3\u679C.assertLeft().getLeft());
+      return b.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u6211\u7684\u7ED3\u679C.assertRight().getRight());
+    }, `\u6D41\u5F0F\u7EC4\u5408(${this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0}, ${b.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0})`);
+  }
+  /**
+   * 将两个模型串接, 得到一个新的模型
+   * 相比流式组合, 本函数不要求串联位置参数匹配, 缺少的参数将在调用时补全
+   * 新模型的类型是:
+   * - 参数: a模型的参数+(b模型的参数-a模型的返回值)
+   * - 错误: a模型的错误+b模型的错误
+   * - 返回值: a模型的返回值+b模型的返回值
+   */
+  \u6DF7\u5408\u7EC4\u5408(b) {
+    return _\u4E1A\u52A1\u884C\u4E3A.\u901A\u8FC7\u5B9E\u73B0\u6784\u9020(async (\u53C2\u6570) => {
+      const \u6211\u7684\u7ED3\u679C = await this.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u53C2\u6570);
+      if (\u6211\u7684\u7ED3\u679C.isLeft()) return new import_ts_fp_data.Left(\u6211\u7684\u7ED3\u679C.assertLeft().getLeft());
+      var \u5BF9\u65B9\u7ED3\u679C = await b.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A({ ...\u53C2\u6570, ...\u6211\u7684\u7ED3\u679C.assertRight().getRight() });
+      return \u5BF9\u65B9\u7ED3\u679C.map((a) => Object.assign(a, \u6211\u7684\u7ED3\u679C.assertRight().getRight()));
+    }, `\u6DF7\u5408\u7EC4\u5408(${this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0}, ${b.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0})`);
+  }
+  // ================================= 映射 =================================
+  \u6620\u5C04\u7ED3\u679C(f) {
+    return _\u4E1A\u52A1\u884C\u4E3A.\u901A\u8FC7\u5B9E\u73B0\u6784\u9020(async (\u53C2\u6570) => {
+      const \u6211\u7684\u7ED3\u679C = await this.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u53C2\u6570);
+      if (\u6211\u7684\u7ED3\u679C.isLeft()) return new import_ts_fp_data.Left(\u6211\u7684\u7ED3\u679C.assertLeft().getLeft());
+      return import_ts_fp_data.Either.pure(f(\u6211\u7684\u7ED3\u679C.assertRight().getRight()));
+    }, this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0);
+  }
+  \u6620\u5C04\u9519\u8BEF(f) {
+    return _\u4E1A\u52A1\u884C\u4E3A.\u901A\u8FC7\u5B9E\u73B0\u6784\u9020(async (\u53C2\u6570) => {
+      const \u6211\u7684\u7ED3\u679C = await this.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u53C2\u6570);
+      if (\u6211\u7684\u7ED3\u679C.isLeft()) return new import_ts_fp_data.Left(f(\u6211\u7684\u7ED3\u679C.assertLeft().getLeft()));
+      return import_ts_fp_data.Either.pure(\u6211\u7684\u7ED3\u679C.assertRight().getRight());
+    }, this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0);
+  }
+};
+
+// src/interface/inst/interface-abstract.ts
+var API\u63A5\u53E3\u57FA\u7C7B = class extends \u4E1A\u52A1\u884C\u4E3A {
+  async API\u5B9E\u73B0(\u53C2\u6570) {
+    var c = await this.\u4E1A\u52A1\u884C\u4E3A\u5B9E\u73B0(\u53C2\u6570);
+    if (c.isLeft()) return this.\u5305\u88C5\u9519\u8BEF\u7ED3\u679C(c.assertLeft().getLeft());
+    return this.\u5305\u88C5\u6B63\u786E\u7ED3\u679C(c.assertRight().getRight());
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/cjs/interface/inst/interface-abstract.d.cts

@@ -1,19 +1,20 @@
 import { z } from 'zod';
-import { 正确结果 as ____, 错误结果 as ____$1 } from '../../result/result.cjs';
+import { Either } from '@lsby/ts-fp-data';
+import { 正确结果 as ____$1, 错误结果 as ____$2 } from '../../result/result.cjs';
+import { 业务行为 as ____ } from '../action/action.cjs';
 import { 合并插件结果 as ______ } from '../plug.cjs';
-import { 任意接口类型 as ______$1, 接口类型抽象类 as _______ } from '../type/interface-type-abstract.cjs';
+import { 接口类型插件们 as _______, 接口类型错误结果 as ________, 接口类型正确结果 as ________$1, 任意接口类型 as ______$1 } from '../type/interface-type-abstract.cjs';
 import 'express';
-import '@lsby/ts-fp-data';
 
-type F3<A> = A extends _______<infer _A1, infer _A2, infer A3, infer _A4, infer _A5> ? A3 : never;
-type F4<A> = A extends _______<infer _A1, infer _A2, infer _A3, infer A4, infer _A5> ? A4 : never;
-type F5<A> = A extends _______<infer _A1, infer _A2, infer _A3, infer _A4, infer A5> ? A5 : never;
-type 计算实现参数<接口类型定义> = ______<F3<接口类型定义>>;
-type 计算实现结果<接口类型定义> = Promise<____<z.infer<F4<接口类型定义>>> | ____$1<z.infer<F5<接口类型定义>>>>;
-declare abstract class API接口基类<接口类型描述 extends ______$1> {
+type 计算实现参数<接口类型描述> = ______<_______<接口类型描述>>;
+type 计算实现返回<接口类型描述> = Promise<Either<z.infer<________<接口类型描述>>, z.infer<________$1<接口类型描述>>>>;
+declare abstract class API接口基类<接口类型描述 extends ______$1> extends ____<计算实现参数<接口类型描述>, z.infer<________<接口类型描述>>, z.infer<________$1<接口类型描述>>> {
+    protected abstract 业务行为实现(参数: 计算实现参数<接口类型描述>): 计算实现返回<接口类型描述>;
+    protected abstract 包装正确结果(数据: z.infer<________$1<接口类型描述>>): ____$1<z.infer<________$1<接口类型描述>>>;
+    protected abstract 包装错误结果(数据: z.infer<________<接口类型描述>>): ____$2<z.infer<________<接口类型描述>>>;
     abstract 获得API类型(): 接口类型描述;
-    abstract API实现(ctx: ______<F3<接口类型描述>>): Promise<____<z.infer<F4<接口类型描述>>> | ____$1<z.infer<F5<接口类型描述>>>>;
+    API实现(参数: 计算实现参数<接口类型描述>): Promise<____$1<z.infer<________$1<接口类型描述>>> | ____$2<z.infer<________<接口类型描述>>>>;
 }
 type 任意接口 = API接口基类<any>;
 
-export { API接口基类, type 任意接口, type 计算实现参数, type 计算实现结果 };
+export { API接口基类, type 任意接口, type 计算实现参数, type 计算实现返回 };

package/dist/cjs/interface/inst/interface.cjs

@@ -24,23 +24,151 @@ __export(interface_exports, {
 });
 module.exports = __toCommonJS(interface_exports);
 
+// src/interface/action/action.ts
+var import_ts_fp_data = require("@lsby/ts-fp-data");
+var \u4E1A\u52A1\u884C\u4E3A = class _\u4E1A\u52A1\u884C\u4E3A {
+  // ================================= 静态 =================================
+  static \u901A\u8FC7\u5B9E\u73B0\u6784\u9020(\u5B9E\u73B0, \u4E1A\u52A1\u884C\u4E3A\u540D\u79F0) {
+    return new class extends _\u4E1A\u52A1\u884C\u4E3A {
+      async \u4E1A\u52A1\u884C\u4E3A\u5B9E\u73B0(\u53C2\u6570) {
+        return \u5B9E\u73B0(\u53C2\u6570);
+      }
+    }(\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0);
+  }
+  static \u6D41\u5F0F\u7EC4\u5408(a, b) {
+    return a.\u6D41\u5F0F\u7EC4\u5408(b);
+  }
+  static \u6DF7\u5408\u7EC4\u5408(a, b) {
+    return a.\u6DF7\u5408\u7EC4\u5408(b);
+  }
+  /**
+   * 对多个项混合组合
+   */
+  static \u6DF7\u5408\u7EC4\u5408\u591A\u9879(arr) {
+    return arr.reduce((s, a) => s.\u6DF7\u5408\u7EC4\u5408(a));
+  }
+  /**
+   * 同时运行多个模型, 并提供一个函数处理它们的结果
+   * 如果其中任何一个模型发生错误, 则最终模型输出第一个错误
+   * 处理函数的类型是: 所有模型的结果合并 => 泛型A
+   * 新模型的类型是:
+   * - 参数: 所有模型的参数合并
+   * - 错误: 所有模型的错误合并
+   * - 返回值: 泛型A
+   */
+  static \u5E76\u884C\u7EC4\u5408(arr, f) {
+    return _\u4E1A\u52A1\u884C\u4E3A.\u901A\u8FC7\u5B9E\u73B0\u6784\u9020(
+      async (\u53C2\u6570) => {
+        var \u6240\u6709\u7ED3\u679C = await Promise.all(arr.map((a) => a.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u53C2\u6570)));
+        var \u9519\u8BEF = \u6240\u6709\u7ED3\u679C.filter((a) => a.isLeft())[0];
+        if (\u9519\u8BEF) return \u9519\u8BEF;
+        var \u6B63\u786E\u7ED3\u679C\u5408\u5E76 = \u6240\u6709\u7ED3\u679C.map((a) => a.assertRight().getRight()).reduce((s, a) => Object.assign(s, a), {});
+        return new import_ts_fp_data.Right(await f(\u6B63\u786E\u7ED3\u679C\u5408\u5E76));
+      },
+      `\u5E76\u884C\u7EC4\u5408(${arr.map((a) => a.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0).join(", ")})`
+    );
+  }
+  // ================================= 私有 =================================
+  \u4E1A\u52A1\u884C\u4E3A\u540D\u79F0;
+  constructor(\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0) {
+    if (!\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0) this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0 = this.constructor.name || "<\u533F\u540D>";
+    else this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0 = \u4E1A\u52A1\u884C\u4E3A\u540D\u79F0;
+  }
+  // ================================= 设置 =================================
+  \u8BBE\u7F6E\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0(\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0) {
+    this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0 = \u4E1A\u52A1\u884C\u4E3A\u540D\u79F0;
+    return this;
+  }
+  \u8BBE\u7F6E\u53C2\u6570(\u8BBE\u7F6E\u53C2\u6570) {
+    return _\u4E1A\u52A1\u884C\u4E3A.\u901A\u8FC7\u5B9E\u73B0\u6784\u9020(async (\u53C2\u6570) => {
+      return await this.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A({ ...\u8BBE\u7F6E\u53C2\u6570, ...\u53C2\u6570 });
+    }, this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0);
+  }
+  // ================================= 运行 =================================
+  async \u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u53C2\u6570) {
+    try {
+      return await this.\u4E1A\u52A1\u884C\u4E3A\u5B9E\u73B0(\u53C2\u6570);
+    } catch (e) {
+      throw e;
+    }
+  }
+  // ================================= 组合 =================================
+  /**
+   * 将两个模型串接, 得到一个新模型, 新模型的类型是:
+   * - 参数: a模型的参数
+   * - 错误: a模型的错误+b模型的错误
+   * - 返回值: b模型的返回值
+   */
+  \u6D41\u5F0F\u7EC4\u5408(b) {
+    return _\u4E1A\u52A1\u884C\u4E3A.\u901A\u8FC7\u5B9E\u73B0\u6784\u9020(async (\u53C2\u6570) => {
+      const \u6211\u7684\u7ED3\u679C = await this.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u53C2\u6570);
+      if (\u6211\u7684\u7ED3\u679C.isLeft()) return new import_ts_fp_data.Left(\u6211\u7684\u7ED3\u679C.assertLeft().getLeft());
+      return b.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u6211\u7684\u7ED3\u679C.assertRight().getRight());
+    }, `\u6D41\u5F0F\u7EC4\u5408(${this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0}, ${b.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0})`);
+  }
+  /**
+   * 将两个模型串接, 得到一个新的模型
+   * 相比流式组合, 本函数不要求串联位置参数匹配, 缺少的参数将在调用时补全
+   * 新模型的类型是:
+   * - 参数: a模型的参数+(b模型的参数-a模型的返回值)
+   * - 错误: a模型的错误+b模型的错误
+   * - 返回值: a模型的返回值+b模型的返回值
+   */
+  \u6DF7\u5408\u7EC4\u5408(b) {
+    return _\u4E1A\u52A1\u884C\u4E3A.\u901A\u8FC7\u5B9E\u73B0\u6784\u9020(async (\u53C2\u6570) => {
+      const \u6211\u7684\u7ED3\u679C = await this.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u53C2\u6570);
+      if (\u6211\u7684\u7ED3\u679C.isLeft()) return new import_ts_fp_data.Left(\u6211\u7684\u7ED3\u679C.assertLeft().getLeft());
+      var \u5BF9\u65B9\u7ED3\u679C = await b.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A({ ...\u53C2\u6570, ...\u6211\u7684\u7ED3\u679C.assertRight().getRight() });
+      return \u5BF9\u65B9\u7ED3\u679C.map((a) => Object.assign(a, \u6211\u7684\u7ED3\u679C.assertRight().getRight()));
+    }, `\u6DF7\u5408\u7EC4\u5408(${this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0}, ${b.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0})`);
+  }
+  // ================================= 映射 =================================
+  \u6620\u5C04\u7ED3\u679C(f) {
+    return _\u4E1A\u52A1\u884C\u4E3A.\u901A\u8FC7\u5B9E\u73B0\u6784\u9020(async (\u53C2\u6570) => {
+      const \u6211\u7684\u7ED3\u679C = await this.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u53C2\u6570);
+      if (\u6211\u7684\u7ED3\u679C.isLeft()) return new import_ts_fp_data.Left(\u6211\u7684\u7ED3\u679C.assertLeft().getLeft());
+      return import_ts_fp_data.Either.pure(f(\u6211\u7684\u7ED3\u679C.assertRight().getRight()));
+    }, this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0);
+  }
+  \u6620\u5C04\u9519\u8BEF(f) {
+    return _\u4E1A\u52A1\u884C\u4E3A.\u901A\u8FC7\u5B9E\u73B0\u6784\u9020(async (\u53C2\u6570) => {
+      const \u6211\u7684\u7ED3\u679C = await this.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u53C2\u6570);
+      if (\u6211\u7684\u7ED3\u679C.isLeft()) return new import_ts_fp_data.Left(f(\u6211\u7684\u7ED3\u679C.assertLeft().getLeft()));
+      return import_ts_fp_data.Either.pure(\u6211\u7684\u7ED3\u679C.assertRight().getRight());
+    }, this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0);
+  }
+};
+
 // src/interface/inst/interface-abstract.ts
-var API\u63A5\u53E3\u57FA\u7C7B = class {
+var API\u63A5\u53E3\u57FA\u7C7B = class extends \u4E1A\u52A1\u884C\u4E3A {
+  async API\u5B9E\u73B0(\u53C2\u6570) {
+    var c = await this.\u4E1A\u52A1\u884C\u4E3A\u5B9E\u73B0(\u53C2\u6570);
+    if (c.isLeft()) return this.\u5305\u88C5\u9519\u8BEF\u7ED3\u679C(c.assertLeft().getLeft());
+    return this.\u5305\u88C5\u6B63\u786E\u7ED3\u679C(c.assertRight().getRight());
+  }
 };
 
 // src/interface/inst/interface.ts
 var \u63A5\u53E3 = class extends API\u63A5\u53E3\u57FA\u7C7B {
-  constructor(\u63A5\u53E3\u7C7B\u578B, \u5B9E\u73B0) {
+  constructor(\u63A5\u53E3\u7C7B\u578B, \u6B63\u786E\u7ED3\u679C\u5305\u88C5\u5668, \u9519\u8BEF\u7ED3\u679C\u5305\u88C5\u5668, \u5B9E\u73B0) {
     super();
     this.\u63A5\u53E3\u7C7B\u578B = \u63A5\u53E3\u7C7B\u578B;
+    this.\u6B63\u786E\u7ED3\u679C\u5305\u88C5\u5668 = \u6B63\u786E\u7ED3\u679C\u5305\u88C5\u5668;
+    this.\u9519\u8BEF\u7ED3\u679C\u5305\u88C5\u5668 = \u9519\u8BEF\u7ED3\u679C\u5305\u88C5\u5668;
     this.\u5B9E\u73B0 = \u5B9E\u73B0;
   }
+  \u5305\u88C5\u6B63\u786E\u7ED3\u679C(a) {
+    return this.\u6B63\u786E\u7ED3\u679C\u5305\u88C5\u5668(a);
+  }
+  \u5305\u88C5\u9519\u8BEF\u7ED3\u679C(a) {
+    return this.\u9519\u8BEF\u7ED3\u679C\u5305\u88C5\u5668(a);
+  }
+  \u4E1A\u52A1\u884C\u4E3A\u5B9E\u73B0(\u53C2\u6570) {
+    return this.\u5B9E\u73B0(\u53C2\u6570);
+  }
   \u83B7\u5F97API\u7C7B\u578B() {
     return this.\u63A5\u53E3\u7C7B\u578B;
   }
-  API\u5B9E\u73B0(ctx) {
-    return this.\u5B9E\u73B0(ctx);
-  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/cjs/interface/inst/interface.d.cts

@@ -1,18 +1,22 @@
 import { z } from 'zod';
+import { Either } from '@lsby/ts-fp-data';
 import { 正确结果 as ____, 错误结果 as ____$1 } from '../../result/result.cjs';
 import { 插件项类型 as _____, 合并插件结果 as ______ } from '../plug.cjs';
-import { 接口类型抽象类 as _______ } from '../type/interface-type-abstract.cjs';
+import { 接口类型抽象类 as _______, 接口类型错误结果 as ________, 接口类型正确结果 as ________$1 } from '../type/interface-type-abstract.cjs';
 import { API接口基类 as API____ } from './interface-abstract.cjs';
 import 'express';
-import '@lsby/ts-fp-data';
+import '../action/action.cjs';
 
 declare class 接口<路径 extends string, 方法 extends 'get' | 'post', 插件们 extends Array<_____>, 正确返回类型 extends z.ZodTypeAny, 错误返回类型 extends z.ZodTypeAny> extends API____<_______<路径, 方法, 插件们, 正确返回类型, 错误返回类型>> {
     private 接口类型;
+    private 正确结果包装器;
+    private 错误结果包装器;
     private 实现;
-    protected readonly __类型保持符号?: [路径, 方法, 插件们, 正确返回类型, 错误返回类型];
-    constructor(接口类型: _______<路径, 方法, 插件们, 正确返回类型, 错误返回类型>, 实现: (插件结果: ______<插件们>) => Promise<____<z.infer<正确返回类型>> | ____$1<z.infer<错误返回类型>>>);
+    constructor(接口类型: _______<路径, 方法, 插件们, 正确返回类型, 错误返回类型>, 正确结果包装器: (a: z.infer<________<_______<路径, 方法, 插件们, 正确返回类型, 错误返回类型>>>) => ____<z.infer<________$1<_______<路径, 方法, 插件们, 正确返回类型, 错误返回类型>>>>, 错误结果包装器: (a: z.infer<________$1<_______<路径, 方法, 插件们, 正确返回类型, 错误返回类型>>>) => ____$1<z.infer<________<_______<路径, 方法, 插件们, 正确返回类型, 错误返回类型>>>>, 实现: (插件结果: ______<插件们>) => Promise<Either<z.infer<错误返回类型>, z.infer<正确返回类型>>>);
+    protected 包装正确结果(a: z.infer<错误返回类型>): ____<z.infer<正确返回类型>>;
+    protected 包装错误结果(a: z.infer<正确返回类型>): ____$1<z.infer<错误返回类型>>;
+    protected 业务行为实现(参数: ______<插件们>): Promise<Either<z.infer<错误返回类型>, z.infer<正确返回类型>>>;
     获得API类型(): _______<路径, 方法, 插件们, 正确返回类型, 错误返回类型>;
-    API实现(ctx: ______<插件们>): Promise<____<z.TypeOf<正确返回类型>> | ____$1<z.TypeOf<错误返回类型>>>;
 }
 
 export { 接口 };

package/dist/cjs/interface/type/interface-type-abstract.d.cts

@@ -3,6 +3,11 @@ import { 插件项类型 as _____ } from '../plug.cjs';
 import 'express';
 import '@lsby/ts-fp-data';
 
+type 接口类型路径<A> = A extends 接口类型抽象类<infer A1, infer _A2, infer _A3, infer _A4, infer _A5> ? A1 : never;
+type 接口类型方法<A> = A extends 接口类型抽象类<infer _A1, infer A2, infer _A3, infer _A4, infer _A5> ? A2 : never;
+type 接口类型插件们<A> = A extends 接口类型抽象类<infer _A1, infer _A2, infer A3, infer _A4, infer _A5> ? A3 : never;
+type 接口类型正确结果<A> = A extends 接口类型抽象类<infer _A1, infer _A2, infer _A3, infer A4, infer _A5> ? A4 : never;
+type 接口类型错误结果<A> = A extends 接口类型抽象类<infer _A1, infer _A2, infer _A3, infer _A4, infer A5> ? A5 : never;
 declare abstract class 接口类型抽象类<路径 extends string, 方法 extends 'get' | 'post', 插件们 extends Array<_____>, 正确结果类型 extends z.ZodTypeAny, 错误结果类型 extends z.ZodTypeAny> {
     abstract 获得路径(): 路径;
     abstract 获得方法(): 方法;
@@ -13,4 +18,4 @@ declare abstract class 接口类型抽象类<路径 extends string, 方法 exten
 type 任意接口类型 = 接口类型抽象类<any, any, any, any, any>;
 type 获得接口插件们<接口类型描述> = 接口类型描述 extends 接口类型抽象类<any, any, infer 插件, any, any> ? 插件 : never;
 
-export { type 任意接口类型, 接口类型抽象类, type 获得接口插件们 };
+export { type 任意接口类型, 接口类型抽象类, type 接口类型插件们, type 接口类型方法, type 接口类型正确结果, type 接口类型路径, type 接口类型错误结果, type 获得接口插件们 };

package/dist/cjs/plugin/urlencoded.cjs

@@ -60,8 +60,7 @@ var \u8868\u5355\u89E3\u6790\u63D2\u4EF6 = class extends \u63D2\u4EF6 {
         })
       );
       const parseResult = t.safeParse({ body: req.body });
-      if (!parseResult.success)
-        throw new Error((0, import_node_util.format)("parse url encoded body failed: %O", parseResult.error));
+      if (!parseResult.success) throw new Error((0, import_node_util.format)("parse url encoded body failed: %O", parseResult.error));
       return { body: parseResult.data.body };
     });
   }

package/dist/cjs/server/server.cjs

@@ -105,8 +105,7 @@ var \u670D\u52A1\u5668 = class {
     await new Promise((res, _rej) => {
       server = app.listen(this.\u7AEF\u53E3, () => res());
     });
-    if (server == null)
-      throw new Error("\u542F\u52A8\u670D\u52A1\u5668\u5931\u8D25");
+    if (server == null) throw new Error("\u542F\u52A8\u670D\u52A1\u5668\u5931\u8D25");
     return {
       ip: Object.values((0, import_node_os.networkInterfaces)()).flat().flatMap((address) => address !== void 0 ? [address] : []).map((wrappedAddress) => wrappedAddress.address).map((address) => `http://${address}:${this.\u7AEF\u53E3}`),
       server

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

@@ -1,10 +1,11 @@
 import * as http from 'node:http';
 import { 任意接口 as ____ } from '../interface/inst/interface-abstract.cjs';
 import 'zod';
+import '@lsby/ts-fp-data';
 import '../result/result.cjs';
 import 'express';
+import '../interface/action/action.cjs';
 import '../interface/plug.cjs';
-import '@lsby/ts-fp-data';
 import '../interface/type/interface-type-abstract.cjs';
 
 declare class 服务器 {

package/dist/esm/bin/gen-list/bin.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   main
-} from "../../chunk-YYOST4AX.js";
+} from "../../chunk-FLDJE3PK.js";
 
 // src/bin/gen-list/bin.ts
 import path from "node:path";

package/dist/esm/bin/gen-list/index.js

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

package/dist/esm/bin/gen-test/bin.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   main
-} from "../../chunk-CSZNLNB5.js";
+} from "../../chunk-NCSYD5GL.js";
 
 // src/bin/gen-test/bin.ts
 import path from "node:path";

package/dist/esm/bin/gen-test/index.js

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

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

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   main
-} from "../../chunk-DQX4L6GK.js";
+} from "../../chunk-GAVKGLRL.js";
 import "../../chunk-FLIKJZGI.js";
 
 // src/bin/gen-type/bin.ts

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

@@ -1,6 +1,6 @@
 import {
   main
-} from "../../chunk-DQX4L6GK.js";
+} from "../../chunk-GAVKGLRL.js";
 import "../../chunk-FLIKJZGI.js";
 export {
   main

package/dist/esm/{chunk-N7VWAPFU.js → chunk-6NX5P6CE.js}

@@ -64,8 +64,7 @@ var \u670D\u52A1\u5668 = class {
     await new Promise((res, _rej) => {
       server = app.listen(this.\u7AEF\u53E3, () => res());
     });
-    if (server == null)
-      throw new Error("\u542F\u52A8\u670D\u52A1\u5668\u5931\u8D25");
+    if (server == null) throw new Error("\u542F\u52A8\u670D\u52A1\u5668\u5931\u8D25");
     return {
       ip: Object.values(networkInterfaces()).flat().flatMap((address) => address !== void 0 ? [address] : []).map((wrappedAddress) => wrappedAddress.address).map((address) => `http://${address}:${this.\u7AEF\u53E3}`),
       server

package/dist/esm/{chunk-YYOST4AX.js → chunk-FLDJE3PK.js}

@@ -33,8 +33,7 @@ async function main(tsconfigPath, interfaceFolderPath, outFilePath) {
   const \u4EE3\u7801\u533A = [];
   for (var i = 0; i < \u63A5\u53E3\u5B9E\u73B0\u6587\u4EF6\u4EEC.length; i++) {
     var \u63A5\u53E3\u5B9E\u73B0\u6587\u4EF6 = \u63A5\u53E3\u5B9E\u73B0\u6587\u4EF6\u4EEC[i];
-    if (\u63A5\u53E3\u5B9E\u73B0\u6587\u4EF6 == null)
-      throw new Error("\u975E\u9884\u671F\u7684\u6570\u7EC4\u8D8A\u754C");
+    if (\u63A5\u53E3\u5B9E\u73B0\u6587\u4EF6 == null) throw new Error("\u975E\u9884\u671F\u7684\u6570\u7EC4\u8D8A\u754C");
     const filenameRelativeToApiFolder = path.relative(interfaceFolderPath, \u63A5\u53E3\u5B9E\u73B0\u6587\u4EF6.fileName).replaceAll("\\", "/");
     const importName = filenameRelativeToApiFolder.replaceAll("/", "_").replaceAll(".ts", "").replaceAll("./", "").replaceAll("-", "_");
     const filenameRelativeToProjectRoot = path.relative(\u9879\u76EE\u6839\u8DEF\u5F84, \u63A5\u53E3\u5B9E\u73B0\u6587\u4EF6.fileName).replaceAll("\\", "/").replaceAll(".ts", "");

package/dist/esm/{chunk-DQX4L6GK.js → chunk-GAVKGLRL.js}

@@ -58,8 +58,7 @@ async function main(tsconfigPath, apiFolderPath, outputPath) {
   const result = [];
   for (var index = 0; index < apiSourceFiles.length; index++) {
     var apiSourceFile = apiSourceFiles[index];
-    if (apiSourceFile == null)
-      throw new Error("\u975E\u9884\u671F\u7684\u6570\u7EC4\u8D8A\u754C");
+    if (apiSourceFile == null) throw new Error("\u975E\u9884\u671F\u7684\u6570\u7EC4\u8D8A\u754C");
     await log.info(`\u5904\u7406\uFF08${index + 1} / ${apiSourceFiles.length}\uFF09\uFF1A${apiSourceFile.fileName}`);
     const apiCalcSourceFile = apiTypeCalcFiles[index]?.sourceFile;
     if (apiCalcSourceFile === void 0) {

package/dist/esm/chunk-HOO4TK2L.js

@@ -0,0 +1,118 @@
+// src/interface/action/action.ts
+import { Either, Left, Right } from "@lsby/ts-fp-data";
+var \u4E1A\u52A1\u884C\u4E3A = class _\u4E1A\u52A1\u884C\u4E3A {
+  // ================================= 静态 =================================
+  static \u901A\u8FC7\u5B9E\u73B0\u6784\u9020(\u5B9E\u73B0, \u4E1A\u52A1\u884C\u4E3A\u540D\u79F0) {
+    return new class extends _\u4E1A\u52A1\u884C\u4E3A {
+      async \u4E1A\u52A1\u884C\u4E3A\u5B9E\u73B0(\u53C2\u6570) {
+        return \u5B9E\u73B0(\u53C2\u6570);
+      }
+    }(\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0);
+  }
+  static \u6D41\u5F0F\u7EC4\u5408(a, b) {
+    return a.\u6D41\u5F0F\u7EC4\u5408(b);
+  }
+  static \u6DF7\u5408\u7EC4\u5408(a, b) {
+    return a.\u6DF7\u5408\u7EC4\u5408(b);
+  }
+  /**
+   * 对多个项混合组合
+   */
+  static \u6DF7\u5408\u7EC4\u5408\u591A\u9879(arr) {
+    return arr.reduce((s, a) => s.\u6DF7\u5408\u7EC4\u5408(a));
+  }
+  /**
+   * 同时运行多个模型, 并提供一个函数处理它们的结果
+   * 如果其中任何一个模型发生错误, 则最终模型输出第一个错误
+   * 处理函数的类型是: 所有模型的结果合并 => 泛型A
+   * 新模型的类型是:
+   * - 参数: 所有模型的参数合并
+   * - 错误: 所有模型的错误合并
+   * - 返回值: 泛型A
+   */
+  static \u5E76\u884C\u7EC4\u5408(arr, f) {
+    return _\u4E1A\u52A1\u884C\u4E3A.\u901A\u8FC7\u5B9E\u73B0\u6784\u9020(
+      async (\u53C2\u6570) => {
+        var \u6240\u6709\u7ED3\u679C = await Promise.all(arr.map((a) => a.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u53C2\u6570)));
+        var \u9519\u8BEF = \u6240\u6709\u7ED3\u679C.filter((a) => a.isLeft())[0];
+        if (\u9519\u8BEF) return \u9519\u8BEF;
+        var \u6B63\u786E\u7ED3\u679C\u5408\u5E76 = \u6240\u6709\u7ED3\u679C.map((a) => a.assertRight().getRight()).reduce((s, a) => Object.assign(s, a), {});
+        return new Right(await f(\u6B63\u786E\u7ED3\u679C\u5408\u5E76));
+      },
+      `\u5E76\u884C\u7EC4\u5408(${arr.map((a) => a.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0).join(", ")})`
+    );
+  }
+  // ================================= 私有 =================================
+  \u4E1A\u52A1\u884C\u4E3A\u540D\u79F0;
+  constructor(\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0) {
+    if (!\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0) this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0 = this.constructor.name || "<\u533F\u540D>";
+    else this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0 = \u4E1A\u52A1\u884C\u4E3A\u540D\u79F0;
+  }
+  // ================================= 设置 =================================
+  \u8BBE\u7F6E\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0(\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0) {
+    this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0 = \u4E1A\u52A1\u884C\u4E3A\u540D\u79F0;
+    return this;
+  }
+  \u8BBE\u7F6E\u53C2\u6570(\u8BBE\u7F6E\u53C2\u6570) {
+    return _\u4E1A\u52A1\u884C\u4E3A.\u901A\u8FC7\u5B9E\u73B0\u6784\u9020(async (\u53C2\u6570) => {
+      return await this.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A({ ...\u8BBE\u7F6E\u53C2\u6570, ...\u53C2\u6570 });
+    }, this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0);
+  }
+  // ================================= 运行 =================================
+  async \u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u53C2\u6570) {
+    try {
+      return await this.\u4E1A\u52A1\u884C\u4E3A\u5B9E\u73B0(\u53C2\u6570);
+    } catch (e) {
+      throw e;
+    }
+  }
+  // ================================= 组合 =================================
+  /**
+   * 将两个模型串接, 得到一个新模型, 新模型的类型是:
+   * - 参数: a模型的参数
+   * - 错误: a模型的错误+b模型的错误
+   * - 返回值: b模型的返回值
+   */
+  \u6D41\u5F0F\u7EC4\u5408(b) {
+    return _\u4E1A\u52A1\u884C\u4E3A.\u901A\u8FC7\u5B9E\u73B0\u6784\u9020(async (\u53C2\u6570) => {
+      const \u6211\u7684\u7ED3\u679C = await this.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u53C2\u6570);
+      if (\u6211\u7684\u7ED3\u679C.isLeft()) return new Left(\u6211\u7684\u7ED3\u679C.assertLeft().getLeft());
+      return b.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u6211\u7684\u7ED3\u679C.assertRight().getRight());
+    }, `\u6D41\u5F0F\u7EC4\u5408(${this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0}, ${b.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0})`);
+  }
+  /**
+   * 将两个模型串接, 得到一个新的模型
+   * 相比流式组合, 本函数不要求串联位置参数匹配, 缺少的参数将在调用时补全
+   * 新模型的类型是:
+   * - 参数: a模型的参数+(b模型的参数-a模型的返回值)
+   * - 错误: a模型的错误+b模型的错误
+   * - 返回值: a模型的返回值+b模型的返回值
+   */
+  \u6DF7\u5408\u7EC4\u5408(b) {
+    return _\u4E1A\u52A1\u884C\u4E3A.\u901A\u8FC7\u5B9E\u73B0\u6784\u9020(async (\u53C2\u6570) => {
+      const \u6211\u7684\u7ED3\u679C = await this.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u53C2\u6570);
+      if (\u6211\u7684\u7ED3\u679C.isLeft()) return new Left(\u6211\u7684\u7ED3\u679C.assertLeft().getLeft());
+      var \u5BF9\u65B9\u7ED3\u679C = await b.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A({ ...\u53C2\u6570, ...\u6211\u7684\u7ED3\u679C.assertRight().getRight() });
+      return \u5BF9\u65B9\u7ED3\u679C.map((a) => Object.assign(a, \u6211\u7684\u7ED3\u679C.assertRight().getRight()));
+    }, `\u6DF7\u5408\u7EC4\u5408(${this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0}, ${b.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0})`);
+  }
+  // ================================= 映射 =================================
+  \u6620\u5C04\u7ED3\u679C(f) {
+    return _\u4E1A\u52A1\u884C\u4E3A.\u901A\u8FC7\u5B9E\u73B0\u6784\u9020(async (\u53C2\u6570) => {
+      const \u6211\u7684\u7ED3\u679C = await this.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u53C2\u6570);
+      if (\u6211\u7684\u7ED3\u679C.isLeft()) return new Left(\u6211\u7684\u7ED3\u679C.assertLeft().getLeft());
+      return Either.pure(f(\u6211\u7684\u7ED3\u679C.assertRight().getRight()));
+    }, this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0);
+  }
+  \u6620\u5C04\u9519\u8BEF(f) {
+    return _\u4E1A\u52A1\u884C\u4E3A.\u901A\u8FC7\u5B9E\u73B0\u6784\u9020(async (\u53C2\u6570) => {
+      const \u6211\u7684\u7ED3\u679C = await this.\u8FD0\u884C\u4E1A\u52A1\u884C\u4E3A(\u53C2\u6570);
+      if (\u6211\u7684\u7ED3\u679C.isLeft()) return new Left(f(\u6211\u7684\u7ED3\u679C.assertLeft().getLeft()));
+      return Either.pure(\u6211\u7684\u7ED3\u679C.assertRight().getRight());
+    }, this.\u4E1A\u52A1\u884C\u4E3A\u540D\u79F0);
+  }
+};
+
+export {
+  业务行为
+};

package/dist/esm/chunk-I5QXSZQU.js

@@ -0,0 +1,21 @@
+import {
+  API接口基类
+} from "./chunk-PA2HBZKY.js";
+import {
+  正确JSON结果,
+  错误JSON结果
+} from "./chunk-IPDMEQ3O.js";
+
+// src/extend/api-json-base.ts
+var JSON\u63A5\u53E3\u57FA\u7C7B = class extends API\u63A5\u53E3\u57FA\u7C7B {
+  \u5305\u88C5\u6B63\u786E\u7ED3\u679C(\u6570\u636E) {
+    return new \u6B63\u786EJSON\u7ED3\u679C(\u6570\u636E);
+  }
+  \u5305\u88C5\u9519\u8BEF\u7ED3\u679C(\u6570\u636E) {
+    return new \u9519\u8BEFJSON\u7ED3\u679C(\u6570\u636E);
+  }
+};
+
+export {
+  JSON接口基类
+};