@lsby/net-core 0.11.2 → 0.13.3

package/dist/cjs/index.d.cts

@@ -1,24 +1,33 @@
-export { 严格递归合并对象, 普通对象深合并, 构造元组, 构造对象 } from './help/help.cjs';
-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 直接形式转换器, 空 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-gRngpxki.cjs';
-export { 任意接口结果返回器, 常用返回器, 接口结果返回器, 自定义返回器 } from './interface/interface-retuen.cjs';
-export { 接口测试 } from './interface/interface-test.cjs';
-export { 自定义数据插件 } from './plugin/extend/custom-data.cjs';
-export { JSON解析插件, 任意JSON解析插件, 任意JSON解析插件项, 合并JSON插件结果, 计算接口逻辑JSON参数 } from './plugin/extend/json.cjs';
-export { 调试请求头插件 } from './plugin/extend/log-headers.cjs';
-export { GET参数解析插件, 任意GET参数解析插件, 任意GET参数解析插件项, 合并GET插件结果, 计算接口逻辑GET参数 } from './plugin/extend/query.cjs';
-export { 表单解析插件 } from './plugin/extend/urlencoded.cjs';
-export { WebSocket插件, 任意WS插件, 任意WS插件项, 取WS插件泛型, 取第一个WS插件结果 } from './plugin/extend/web-socket.cjs';
+export { 严格递归合并对象, 普通对象深合并, 构造元组, 构造对象, 默认请求附加参数 } from './help/help.cjs';
+export { 任意接口, 接口, 接口方法类型, 接口路径类型, 获得接口方法类型, 获得接口路径类型, 获得接口返回器类型, 获得接口逻辑类型 } from './interface/interface-base.cjs';
+export { 任意接口逻辑, 接口逻辑, 接口逻辑Base, 接口逻辑正确类型, 接口逻辑错误类型, 接口逻辑附加参数类型, 清理函数类型, 获得接口逻辑上游接口类型, 获得接口逻辑插件类型, 获得接口逻辑最后接口类型, 获得接口逻辑正确类型, 获得接口逻辑错误类型, 获得接口逻辑附加参数类型, 计算接口逻辑参数, 计算接口逻辑正确结果, 计算接口逻辑错误结果 } from './interface/interface-logic.cjs';
+export { 任意插件, 取插件正确ts类型, 取插件错误ts类型, 合并插件正确结果, 插件 } from './interface/interface-plugin.cjs';
+export { 任意接口返回器, 接口返回器, 获得接口返回器实现正确类型, 获得接口返回器实现错误类型, 获得接口返回器接口正确类型, 获得接口返回器接口错误类型 } from './interface/interface-returner.cjs';
+export { 任意接口测试, 接口测试, 接口逻辑测试 } from './interface/interface-test.cjs';
+export { 自定义插件 } from './plugin/custom.cjs';
+export { 自定义数据插件 } from './plugin/custom-data.cjs';
+export { JSON参数解析插件, 任意JSON参数解析插件, 任意JSON参数解析插件项, 合并JSON插件结果, 计算接口逻辑JSON参数 } from './plugin/json.cjs';
+export { 调试请求头插件 } from './plugin/log-headers.cjs';
+export { 路径解析插件 } from './plugin/parse-path.cjs';
+export { Query参数解析插件, 任意Query参数解析插件, 任意Query参数解析插件项, 合并Query插件结果, 计算接口逻辑Query参数 } from './plugin/query.cjs';
+export { UrlEncoded参数解析插件, 任意UrlEncoded参数解析插件, 任意UrlEncoded参数解析插件项, 合并UrlEncoded参数解析插件结果, 计算接口逻辑UrlEncoded参数 } from './plugin/urlencoded.cjs';
+export { WebSocket插件, 任意WS插件, 任意WS插件项, 取WS插件泛型, 取第一个WS插件输入, 取第一个WS插件输出 } from './plugin/web-socket.cjs';
+export { 常用接口返回器 } from './returner/common.cjs';
+export { 自定义接口返回器 } from './returner/custom.cjs';
+export { 文件流式下载返回器 } from './returner/file-stream-download.cjs';
+export { 静态文件返回器 } from './returner/static-file.cjs';
+export { 虚拟文件返回器 } from './returner/virtual-file.cjs';
+export { 日志回调类型, 服务器 } from './server/server.cjs';
 export { EXPORT_TYPE } from './symbol/export-type.cjs';
 export { GetNetCoreExportTypeDefine, GetNetCoreExportTypeName, NetCoreExportType } from './types/export-type.cjs';
-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';
+export { 兼容空对象, 可序列化类型, 基本类型, 空对象, 请求附加参数类型, 递归基本类型, 非空基本类型 } from './types/types.cjs';
 import '@lsby/ts-fp-data';
 import 'express';
 import './help/interior.cjs';
-import '@lsby/ts-log';
+import 'zod';
+import './global/model/hub.cjs';
+import 'node:stream';
 import 'node:http';
-import 'node:fs';
+import '@lsby/ts-log';
+import './global/model/web-socket.cjs';
+import 'ws';

package/dist/cjs/interface/interface-base.cjs

@@ -24,35 +24,33 @@ __export(interface_base_exports, {
 });
 module.exports = __toCommonJS(interface_base_exports);
 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) {
+  constructor(\u8BF7\u6C42\u8DEF\u5F84, \u8BF7\u6C42\u65B9\u6CD5, \u63A5\u53E3\u903B\u8F91, \u63A5\u53E3\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;
+    this.\u63A5\u53E3\u8FD4\u56DE\u5668 = \u63A5\u53E3\u8FD4\u56DE\u5668;
   }
   \u83B7\u5F97\u8DEF\u5F84() {
     return this.\u8BF7\u6C42\u8DEF\u5F84;
   }
+  \u5339\u914D\u8DEF\u5F84(\u8DEF\u5F84) {
+    let \u89C4\u5219 = this.\u8BF7\u6C42\u8DEF\u5F84;
+    if (typeof \u89C4\u5219 === "string") {
+      return \u89C4\u5219 === \u8DEF\u5F84;
+    }
+    if (\u89C4\u5219 instanceof RegExp) {
+      return \u89C4\u5219.test(\u8DEF\u5F84);
+    }
+    return false;
+  }
   \u83B7\u5F97\u65B9\u6CD5() {
     return this.\u8BF7\u6C42\u65B9\u6CD5;
   }
-  \u83B7\u5F97\u903B\u8F91() {
+  \u83B7\u5F97\u63A5\u53E3\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;
+  \u83B7\u5F97\u63A5\u53E3\u8FD4\u56DE\u5668() {
+    return this.\u63A5\u53E3\u8FD4\u56DE\u5668;
   }
 };
 // Annotate the CommonJS export names for ESM import in node:

package/dist/cjs/interface/interface-base.d.cts

@@ -1,8 +1,46 @@
-import 'zod';
-export { 任 as 任意接口, b as 接口, a as 接口方法类型, 接 as 接口路径类型, c as 获得接口方法类型, f as 获得接口正确形式, g as 获得接口结果转换器类型, h as 获得接口结果返回器类型, 获 as 获得接口路径类型, d as 获得接口逻辑类型, e as 获得接口错误形式 } from '../interface-base-gRngpxki.cjs';
-import './interface-retuen.cjs';
+import { 空对象 as ___ } from '../types/types.cjs';
+import { 接口逻辑Base as ____Base } from './interface-logic.cjs';
+import { 获得接口返回器实现错误类型 as _____________, 获得接口返回器实现正确类型 as _____________$1, 任意接口返回器 as _______ } from './interface-returner.cjs';
+import '@lsby/ts-log';
+import '../global/model/web-socket.cjs';
+import 'ws';
+import '../global/model/hub.cjs';
 import '@lsby/ts-fp-data';
 import 'express';
 import '../help/interior.cjs';
-import '@lsby/ts-log';
-import 'node:http';
+import './interface-plugin.cjs';
+import 'zod';
+
+type 接口路径类型 = string | RegExp;
+type 接口方法类型 = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'head' | 'options';
+/**
+ * ### 接口
+ *
+ * 一个HTTP接口, 它由以下部分组成:
+ * - 请求路径: 例如 /api/xxx 或正则表达式 /^\/api\/.+/
+ * - 请求方法: get 或 post
+ * - 接口逻辑: 接口的实际逻辑行为, 见 {@link 接口逻辑}
+ * - 接口返回器: 决定如何将接口逻辑的返回值返回给客户端的逻辑, 见 {@link 接口返回器}
+ *
+ * 推荐将接口作为文件的默认导出, 这样可以让类型工具对齐进行静态分析, 生成索引和类型
+ */
+declare class 接口<路径类型 extends 接口路径类型, 方法类型 extends 接口方法类型, 接口逻辑类型 extends ____Base<any, ___, _____________<接口返回器类型>, _____________$1<接口返回器类型>, any, any>, 接口返回器类型 extends _______> {
+    private 请求路径;
+    private 请求方法;
+    private 接口逻辑;
+    private 接口返回器;
+    protected readonly __类型保持符号?: [路径类型, 方法类型, 接口逻辑类型, 接口返回器类型];
+    constructor(请求路径: 路径类型, 请求方法: 方法类型, 接口逻辑: 接口逻辑类型, 接口返回器: 接口返回器类型);
+    获得路径(): 路径类型;
+    匹配路径(路径: string): boolean;
+    获得方法(): 方法类型;
+    获得接口逻辑(): 接口逻辑类型;
+    获得接口返回器(): 接口返回器类型;
+}
+type 任意接口 = 接口<any, any, any, any>;
+type 获得接口路径类型<A> = A extends 接口<infer X, any, any, any> ? X : never;
+type 获得接口方法类型<A> = A extends 接口<any, infer X, any, any> ? X : never;
+type 获得接口逻辑类型<A> = A extends 接口<any, any, infer X, any> ? X : never;
+type 获得接口返回器类型<A> = A extends 接口<any, any, any, infer X> ? X : never;
+
+export { type 任意接口, 接口, type 接口方法类型, type 接口路径类型, type 获得接口方法类型, type 获得接口路径类型, type 获得接口返回器类型, type 获得接口逻辑类型 };

package/dist/cjs/interface/interface-logic.cjs

@@ -26,6 +26,146 @@ __export(interface_logic_exports, {
 module.exports = __toCommonJS(interface_logic_exports);
 var import_ts_fp_data = require("@lsby/ts-fp-data");
 
+// src/global/log.ts
+var import_ts_log = require("@lsby/ts-log");
+var \u5168\u5C40\u65E5\u5FD7\u5355\u4F8B = new import_ts_log.Log("@lsby:net-core");
+
+// src/global/model/hub.ts
+var \u96C6\u7EBF\u5668\u76D1\u542C\u5668\u6301\u6709\u8005 = class {
+  constructor(\u76D1\u542C\u5668) {
+    this.\u76D1\u542C\u5668 = \u76D1\u542C\u5668;
+  }
+};
+var \u96C6\u7EBF\u5668\u6A21\u578B = class _\u96C6\u7EBF\u5668\u6A21\u578B {
+  // 使用 WeakRef + FinalizationRegistry 防止"反向持有" this
+  static \u6E05\u7406\u6CE8\u518C\u5668 = new FinalizationRegistry(({ \u5B9E\u4F8B\u5F15\u7528, \u76D1\u542C\u5668 }) => {
+    let \u5B9E\u4F8B = \u5B9E\u4F8B\u5F15\u7528.deref();
+    if (\u5B9E\u4F8B === void 0) return;
+    let \u7D22\u5F15 = \u5B9E\u4F8B.\u76D1\u542C\u5668\u5217\u8868.indexOf(\u76D1\u542C\u5668);
+    if (\u7D22\u5F15 !== -1) \u5B9E\u4F8B.\u76D1\u542C\u5668\u5217\u8868.splice(\u7D22\u5F15, 1);
+  });
+  \u76D1\u542C\u5668\u5217\u8868 = [];
+  \u6301\u6709\u8005\u6620\u5C04 = /* @__PURE__ */ new WeakMap();
+  \u9519\u8BEF\u5904\u7406\u5668 = null;
+  /**
+   * 设置广播错误时的处理器。
+   */
+  \u8BBE\u7F6E\u9519\u8BEF\u5904\u7406\u5668(\u5904\u7406\u5668) {
+    this.\u9519\u8BEF\u5904\u7406\u5668 = \u5904\u7406\u5668;
+  }
+  /**
+   * 注册监听器。
+   * 若外部不再持有返回的 `监听器持有者`，监听器会在未来某个时间自动移除。
+   * ⚠️ 自动清理是非确定性的，不能依赖它实现实时释放。
+   */
+  \u6DFB\u52A0\u76D1\u542C\u5668(\u76D1\u542C\u5668) {
+    this.\u76D1\u542C\u5668\u5217\u8868.push(\u76D1\u542C\u5668);
+    let \u6301\u6709\u8005 = new \u96C6\u7EBF\u5668\u76D1\u542C\u5668\u6301\u6709\u8005(\u76D1\u542C\u5668);
+    this.\u6301\u6709\u8005\u6620\u5C04.set(\u6301\u6709\u8005, \u76D1\u542C\u5668);
+    let \u5B9E\u4F8B\u5F31\u5F15\u7528 = new WeakRef(this);
+    _\u96C6\u7EBF\u5668\u6A21\u578B.\u6E05\u7406\u6CE8\u518C\u5668.register(\u6301\u6709\u8005, { \u5B9E\u4F8B\u5F15\u7528: \u5B9E\u4F8B\u5F31\u5F15\u7528, \u76D1\u542C\u5668 }, \u6301\u6709\u8005);
+    return \u6301\u6709\u8005;
+  }
+  \u79FB\u9664\u76D1\u542C\u5668(\u6301\u6709\u8005) {
+    let \u76D1\u542C\u5668 = this.\u6301\u6709\u8005\u6620\u5C04.get(\u6301\u6709\u8005);
+    if (\u76D1\u542C\u5668 === void 0) return;
+    let \u7D22\u5F15 = this.\u76D1\u542C\u5668\u5217\u8868.indexOf(\u76D1\u542C\u5668);
+    if (\u7D22\u5F15 !== -1) this.\u76D1\u542C\u5668\u5217\u8868.splice(\u7D22\u5F15, 1);
+    _\u96C6\u7EBF\u5668\u6A21\u578B.\u6E05\u7406\u6CE8\u518C\u5668.unregister(\u6301\u6709\u8005);
+    this.\u6301\u6709\u8005\u6620\u5C04.delete(\u6301\u6709\u8005);
+  }
+  async \u5E7F\u64AD(\u6570\u636E) {
+    let snapshot = [...this.\u76D1\u542C\u5668\u5217\u8868];
+    let \u7ED3\u679C = await Promise.allSettled(snapshot.map((l) => l(\u6570\u636E)));
+    for (let [\u7D22\u5F15, \u7ED3\u679C\u9879] of \u7ED3\u679C.entries()) {
+      if (\u7ED3\u679C\u9879.status === "rejected" && this.\u9519\u8BEF\u5904\u7406\u5668 !== null) {
+        await Promise.resolve(this.\u9519\u8BEF\u5904\u7406\u5668(\u6570\u636E, \u7D22\u5F15, \u7ED3\u679C\u9879.reason));
+      }
+    }
+  }
+};
+
+// src/global/model/web-socket.ts
+var WebSocket\u7BA1\u7406\u5668 = class {
+  log = \u5168\u5C40\u65E5\u5FD7\u5355\u4F8B.extend("WebSocket\u7BA1\u7406\u5668");
+  \u8FDE\u63A5\u8868 = {};
+  \u6D88\u606F\u76D1\u542C\u8868 = {};
+  \u8FDE\u63A5\u6E05\u7406\u6A21\u578B = new \u96C6\u7EBF\u5668\u6A21\u578B();
+  \u8FDE\u63A5\u6301\u6709\u8005\u8868 = {};
+  \u6E05\u7406\u51FD\u6570\u8868 = {};
+  \u589E\u52A0\u8FDE\u63A5(id, ws\u53E5\u67C4) {
+    if (id in this.\u8FDE\u63A5\u8868) this.\u5220\u9664\u8FDE\u63A5(id);
+    this.\u8FDE\u63A5\u8868[id] = ws\u53E5\u67C4;
+    if (!(id in this.\u6D88\u606F\u76D1\u542C\u8868)) {
+      let \u6A21\u578B = new \u96C6\u7EBF\u5668\u6A21\u578B();
+      \u6A21\u578B.\u8BBE\u7F6E\u9519\u8BEF\u5904\u7406\u5668(async (\u6570\u636E, \u7D22\u5F15, \u9519\u8BEF) => {
+        await this.log.warn(`WebSocket \u76D1\u542C\u5668\u6267\u884C\u5931\u8D25, id: ${id}, \u7D22\u5F15: ${\u7D22\u5F15}, \u9519\u8BEF: ${\u9519\u8BEF}`);
+      });
+      this.\u6D88\u606F\u76D1\u542C\u8868[id] = \u6A21\u578B;
+    }
+    this.\u6CE8\u518Conmessage(id, ws\u53E5\u67C4);
+    let \u6301\u6709\u8005 = this.\u8FDE\u63A5\u6E05\u7406\u6A21\u578B.\u6DFB\u52A0\u76D1\u542C\u5668(async () => {
+      if (id in this.\u8FDE\u63A5\u8868) this.\u5220\u9664\u8FDE\u63A5(id);
+    });
+    this.\u8FDE\u63A5\u6301\u6709\u8005\u8868[id] = \u6301\u6709\u8005;
+    return \u6301\u6709\u8005;
+  }
+  \u5220\u9664\u8FDE\u63A5(id) {
+    let ws = this.\u8FDE\u63A5\u8868[id];
+    if (ws !== null && ws !== void 0) {
+      ws.onmessage = null;
+      ws.once("error", (err) => void this.log.error(`WebSocket \u5F02\u6B65\u9519\u8BEF, id: ${id}, \u9519\u8BEF: ${err}`));
+      ws.once(
+        "close",
+        (code, reason) => void this.log.debug(`WebSocket \u5DF2\u5173\u95ED, id: ${id}, \u5173\u95ED\u7801: ${code}, \u539F\u56E0: ${reason}`)
+      );
+      try {
+        ws.close(1e3, "\u670D\u52A1\u5668\u4E3B\u52A8\u5173\u95ED");
+      } catch (err) {
+        void this.log.error(`WebSocket \u540C\u6B65\u5173\u95ED\u5931\u8D25, id: ${id}, \u9519\u8BEF: ${err}`);
+      }
+    }
+    let \u6E05\u7406\u51FD\u6570 = this.\u6E05\u7406\u51FD\u6570\u8868[id];
+    if (\u6E05\u7406\u51FD\u6570 !== void 0) void \u6E05\u7406\u51FD\u6570().catch((err) => this.log.error(`\u6E05\u7406\u8FDE\u63A5\u5931\u8D25, id: ${id}, \u9519\u8BEF: ${err}`));
+    delete this.\u8FDE\u63A5\u8868[id];
+    delete this.\u6E05\u7406\u51FD\u6570\u8868[id];
+    delete this.\u6D88\u606F\u76D1\u542C\u8868[id];
+    let \u6301\u6709\u8005 = this.\u8FDE\u63A5\u6301\u6709\u8005\u8868[id];
+    if (\u6301\u6709\u8005 !== void 0) {
+      this.\u8FDE\u63A5\u6E05\u7406\u6A21\u578B.\u79FB\u9664\u76D1\u542C\u5668(\u6301\u6709\u8005);
+      delete this.\u8FDE\u63A5\u6301\u6709\u8005\u8868[id];
+    }
+  }
+  \u6CE8\u518Conmessage(id, ws\u53E5\u67C4) {
+    ws\u53E5\u67C4.onmessage = async (event) => {
+      try {
+        let \u6570\u636E = JSON.parse(event.data.toString());
+        let \u6A21\u578B = this.\u6D88\u606F\u76D1\u542C\u8868[id];
+        if (\u6A21\u578B !== void 0) await \u6A21\u578B.\u5E7F\u64AD(\u6570\u636E);
+      } catch (err) {
+        await this.log.warn(`WebSocket \u6D88\u606F\u5904\u7406\u5931\u8D25, id: ${id}, \u9519\u8BEF: ${err}`);
+      }
+    };
+  }
+  \u67E5\u8BE2\u8FDE\u63A5\u5B58\u5728(id) {
+    return id in this.\u8FDE\u63A5\u8868;
+  }
+  async \u83B7\u5F97ws\u53E5\u67C4(id) {
+    return this.\u8FDE\u63A5\u8868[id] ?? null;
+  }
+  async \u8BBE\u7F6E\u6E05\u7406\u51FD\u6570(id, \u6E05\u7406\u51FD\u6570) {
+    if (id in this.\u8FDE\u63A5\u8868) this.\u6E05\u7406\u51FD\u6570\u8868[id] = \u6E05\u7406\u51FD\u6570;
+  }
+  \u8BBE\u7F6E\u6D88\u606F\u76D1\u542C(id, \u56DE\u8C03\u51FD\u6570) {
+    let \u6A21\u578B = this.\u6D88\u606F\u76D1\u542C\u8868[id];
+    if (\u6A21\u578B === void 0) return null;
+    return \u6A21\u578B.\u6DFB\u52A0\u76D1\u542C\u5668(\u56DE\u8C03\u51FD\u6570);
+  }
+};
+
+// src/global/web-socket.ts
+var \u5168\u5C40WebSocket\u7BA1\u7406\u5668\u5355\u4F8B = new WebSocket\u7BA1\u7406\u5668();
+
 // 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) {
@@ -57,7 +197,7 @@ var \u63A5\u53E3\u903B\u8F91Base = class _\u63A5\u53E3\u903B\u8F91Base {
     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 {
+    return new class extends _\u63A5\u53E3\u903B\u8F91Base {
       \u83B7\u5F97\u6E05\u7406\u51FD\u6570() {
         return \u6E05\u7406\u51FD\u6570;
       }
@@ -68,7 +208,6 @@ var \u63A5\u53E3\u903B\u8F91Base = class _\u63A5\u53E3\u903B\u8F91Base {
         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);
@@ -78,12 +217,13 @@ var \u63A5\u53E3\u903B\u8F91Base = class _\u63A5\u53E3\u903B\u8F91Base {
     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);
+      if (\u63D2\u4EF6\u8FD4\u56DE.isLeft()) return \u63D2\u4EF6\u8FD4\u56DE;
+      \u6240\u6709\u63D2\u4EF6\u7ED3\u679C.push(\u63D2\u4EF6\u8FD4\u56DE.assertRight().getRight());
     }
     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;
+    return new import_ts_fp_data.Right(\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) {
+  async \u8C03\u7528(\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 {
@@ -92,16 +232,12 @@ var \u63A5\u53E3\u903B\u8F91Base = class _\u63A5\u53E3\u903B\u8F91Base {
       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);
+        let \u4E0A\u5C42\u7ED1\u5B9A\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\u7ED1\u5B9A\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) {
+  \u7ED1\u5B9A(\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;

package/dist/cjs/interface/interface-logic.d.cts

@@ -1,8 +1,132 @@
-import '@lsby/ts-fp-data';
-import 'express';
-import '../help/interior.cjs';
-export { n as 任意接口逻辑, 兼 as 兼容空对象, 可 as 可调用接口逻辑, m as 接口逻辑, l as 接口逻辑Base, j as 接口逻辑正确类型, i as 接口逻辑错误类型, k as 接口逻辑附加参数类型, 清 as 清理函数类型, 空 as 空对象, s as 获得接口逻辑上游接口类型, o as 获得接口逻辑插件类型, t as 获得接口逻辑最后接口类型, r as 获得接口逻辑正确类型, q as 获得接口逻辑错误类型, p as 获得接口逻辑附加参数类型, 计 as 计算接口逻辑参数, v as 计算接口逻辑正确结果, u as 计算接口逻辑错误结果 } from '../interface-base-gRngpxki.cjs';
-import 'zod';
+import { Either } from '@lsby/ts-fp-data';
+import { Request, Response } from 'express';
+import { 联合转元组 as _____ } from '../help/interior.cjs';
+import { 空对象 as ___, 请求附加参数类型 as ________$1 } from '../types/types.cjs';
+import { 任意插件 as ____, 合并插件正确结果 as ________ } from './interface-plugin.cjs';
 import '@lsby/ts-log';
-import 'node:http';
-import './interface-retuen.cjs';
+import '../global/model/web-socket.cjs';
+import 'ws';
+import '../global/model/hub.cjs';
+import 'zod';
+
+type 清理函数类型<插件类型 extends ____[], 逻辑附加参数类型 extends 接口逻辑附加参数类型> = (参数: ________<插件类型>, 逻辑附加参数: 逻辑附加参数类型, 请求附加参数: ________$1) => Promise<void>;
+type 接口逻辑错误类型 = Record<string, any> | string | never;
+type 接口逻辑正确类型 = Record<string, any>;
+type 接口逻辑附加参数类型 = Record<string, any>;
+/**
+ * ### 接口逻辑
+ *
+ * 接口逻辑是接口的实际行为, 它由以下部分组成:
+ * - 插件: 业务逻辑的前置行为, 通过与req句柄交互, 获得接口需要的信息, 见 {@link 插件}
+ * - 业务逻辑: 实际的运行逻辑, 是一个函数
+ *   - 业务逻辑的参数是:
+ *     - 参数: 当前接口逻辑的插件提供的数据
+ *     - 逻辑附加参数: 上游接口逻辑提供的数据和能力
+ *     - 请求附加参数: 框架提供的信息, 例如请求id
+ *   - 业务逻辑应当返回 Either 值, 表示执行成功还是失败
+ *   - 业务逻辑应当尽可能是纯的, 便于单独测试和调用
+ *
+ * #### 两用性
+ *
+ * 接口逻辑可以被两种不同的方法使用:
+ * - 组成接口: 将其作为 {@link 接口} 的一部分.
+ *   此时, 插件会被执行, 插件将从HTTP上下文中获得信息, 提供给业务逻辑.
+ * - 内部调用: 使用 .实现 方法, 在其他代码中调用接口逻辑.
+ *   此时, 插件会被跳过, 不会从HTTP上下文中获取任何信息(因为根本就不存在HTTP上下文).
+ *   而本来由插件提供的信息将改为需要通过调用参数提供(是类型安全的).
+ * 这意味着大部分接口逻辑的实现是纯的, 并且可以独立被调用, 非常容易被测试
+ *
+ * #### 组合
+ *
+ * 允许将多个接口逻辑进行组合, 形成新的接口逻辑
+ * - 目前只提供"绑定"一种组合方式
+ * - 未来可能提供更多组合方法
+ *
+ * ##### 绑定
+ *
+ * 这种组合方式将接口逻辑看作一个类monad结构的Either
+ *
+ * 考虑这样的代码:
+ *
+ * ```typescript
+ * 接口逻辑.空逻辑()
+ *   .绑定(A)
+ *   .绑定(B) // B中可以调用A的返回结果
+ *   .绑定(C) // C中可以调用A和B的返回结果
+ * ```
+ *
+ * 这类似于:
+ *
+ * ```haskell
+ * do
+ *   a <- A
+ *   b <- B // B中可以调用a
+ *   c <- C // C中可以调用a和b
+ *   pure {a, b, c}
+ * ```
+ *
+ * 注意: 上面的A, B, C的结果皆为Either, 如果返回左值, 后续过程将直接被跳过
+ *
+ * ## 复用性和代数效应
+ *
+ * 推荐抽象通用组件, 并构造纯代数效应链:
+ *
+ * 考虑这样的代码:
+ *
+ * ```typescript
+ * 接口逻辑.空逻辑()
+ *   .绑定(用户鉴权)      // 通用, 可通过参数与业务解耦, 实现跨项目复用
+ *   .绑定(缓存)          // 通用, 可通过参数与业务解耦, 实现跨项目复用
+ *   .绑定(限流)          // 通用, 可通过参数与业务解耦, 实现跨项目复用
+ *   .绑定(业务相关逻辑)  // 业务相关逻辑, 但不触发副作用, 而是返回"描述副作用的数据"
+ *   .绑定(操作数据库)    // 业务相关逻辑, 解析"描述副作用的数据", 并实际执行
+ * ```
+ *
+ * 这样的好处是:
+ * - 跨项目复用的逻辑块
+ * - 业务逻辑可以保持是纯的, 非常方便独立测试
+ */
+declare abstract class 接口逻辑Base<插件类型 extends ____[], in 逻辑附加参数类型 extends 接口逻辑附加参数类型, 错误类型 extends 接口逻辑错误类型, 正确类型 extends 接口逻辑正确类型, 上游接口类型 extends 任意接口逻辑 | null = null, 最后接口类型 extends 任意接口逻辑 | null = null> {
+    private 上游接口;
+    private 最后接口;
+    static 空逻辑(): 接口逻辑Base<[], ___, never, {}, null, null>;
+    static 完整构造<插件类型 extends ____[], 逻辑附加参数类型 extends 接口逻辑附加参数类型, 错误类型 extends 接口逻辑错误类型, 返回类型 extends 接口逻辑正确类型, 上游接口类型 extends 任意接口逻辑 | null, 最后接口类型 extends 任意接口逻辑 | null>(插件们: [...插件类型], 实现: (参数: ________<插件类型>, 逻辑附加参数: 逻辑附加参数类型, 请求附加参数: ________$1) => Promise<Either<错误类型, 返回类型>>, 清理函数: 清理函数类型<插件类型, 逻辑附加参数类型> | undefined, 上游接口逻辑: 上游接口类型, 最后接口逻辑: 最后接口类型): 接口逻辑Base<插件类型, 逻辑附加参数类型, 错误类型, 返回类型, 上游接口类型, 最后接口类型>;
+    static 构造<插件类型 extends ____[], 逻辑附加参数类型 extends 接口逻辑附加参数类型, 错误类型 extends 接口逻辑错误类型, 返回类型 extends 接口逻辑正确类型>(插件们: [...插件类型], 实现: (参数: ________<插件类型>, 逻辑附加参数: 逻辑附加参数类型, 请求附加参数: ________$1) => Promise<Either<错误类型, 返回类型>>, 清理函数?: 清理函数类型<插件类型, 逻辑附加参数类型> | undefined): 接口逻辑Base<插件类型, 逻辑附加参数类型, 错误类型, 返回类型, null, null>;
+    protected readonly __类型保持符号_协变?: [插件类型, 错误类型, 正确类型];
+    protected readonly __类型保持符号_逆变?: (a: 逻辑附加参数类型) => void;
+    constructor(上游接口: 上游接口类型, 最后接口: 最后接口类型);
+    计算插件结果(req: Request, res: Response, 请求附加参数: ________$1): Promise<Either<{
+        code: number;
+        data: any;
+    }, ________<插件类型>>>;
+    abstract 获得插件们(): [...插件类型];
+    abstract 实现(参数: ________<插件类型>, 逻辑附加参数: 逻辑附加参数类型, 请求附加参数: ________$1): Promise<Either<错误类型, 正确类型>>;
+    获得清理函数?(): 清理函数类型<插件类型, 逻辑附加参数类型> | undefined;
+    调用(合并插件结果: ________<插件类型>, 传入的逻辑附加参数: 逻辑附加参数类型, 传入的请求附加参数: ________$1): Promise<Either<错误类型, 正确类型>>;
+    绑定<输入的插件类型 extends ____[], 输入的错误类型 extends 接口逻辑错误类型, 输入的返回类型 extends 接口逻辑正确类型, 输入的上游接口逻辑类型 extends 任意接口逻辑 | null, 输入的最后接口逻辑类型 extends 任意接口逻辑 | null>(输入: 接口逻辑Base<输入的插件类型, 正确类型, 输入的错误类型, 输入的返回类型, 输入的上游接口逻辑类型, 输入的最后接口逻辑类型>): 接口逻辑Base<[
+        ...插件类型,
+        ...输入的插件类型
+    ], 逻辑附加参数类型, 错误类型 | 输入的错误类型, 正确类型 & 输入的返回类型, typeof this, typeof 输入>;
+    获得上游接口(): 上游接口类型;
+    获得最后接口(): 最后接口类型;
+}
+/**
+ * 详情见 {@link 接口逻辑Base}
+ */
+declare abstract class 接口逻辑<插件类型 extends ____[], 逻辑附加参数类型 extends 接口逻辑附加参数类型, 错误类型 extends 接口逻辑错误类型, 正确类型 extends 接口逻辑正确类型> extends 接口逻辑Base<插件类型, 逻辑附加参数类型, 错误类型, 正确类型, null, null> {
+    constructor();
+}
+type 任意接口逻辑 = 接口逻辑Base<any, any, any, any, any, any>;
+type 获得接口逻辑插件类型<A> = A extends 接口逻辑Base<infer X, any, any, any, any, any> ? X : never;
+type 获得接口逻辑附加参数类型<A> = A extends 接口逻辑Base<any, infer X, any, any, any, any> ? X : never;
+type 获得接口逻辑错误类型<A> = A extends 接口逻辑Base<any, any, infer X, any, any, any> ? X : never;
+type 获得接口逻辑正确类型<A> = A extends 接口逻辑Base<any, any, any, infer X, any, any> ? X : never;
+type 获得接口逻辑上游接口类型<A> = A extends 接口逻辑Base<any, any, any, any, infer X, any> ? X : never;
+type 获得接口逻辑最后接口类型<A> = A extends 接口逻辑Base<any, any, any, any, any, infer X> ? X : never;
+type 计算接口逻辑参数<接口逻辑> = ________<获得接口逻辑插件类型<接口逻辑>>;
+type 计算接口逻辑错误结果<接口逻辑> = _____<获得接口逻辑错误类型<接口逻辑>>;
+type 计算接口逻辑正确结果<接口逻辑> = {
+    [k in keyof 获得接口逻辑正确类型<接口逻辑>]: 获得接口逻辑正确类型<接口逻辑>[k];
+};
+
+export { type 任意接口逻辑, 接口逻辑, 接口逻辑Base, type 接口逻辑正确类型, type 接口逻辑错误类型, type 接口逻辑附加参数类型, type 清理函数类型, type 获得接口逻辑上游接口类型, type 获得接口逻辑插件类型, type 获得接口逻辑最后接口类型, type 获得接口逻辑正确类型, type 获得接口逻辑错误类型, type 获得接口逻辑附加参数类型, type 计算接口逻辑参数, type 计算接口逻辑正确结果, type 计算接口逻辑错误结果 };

package/dist/cjs/interface/interface-plugin.cjs

@@ -0,0 +1,45 @@
+"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/interface/interface-plugin.ts
+var interface_plugin_exports = {};
+__export(interface_plugin_exports, {
+  \u63D2\u4EF6: () => \u63D2\u4EF6
+});
+module.exports = __toCommonJS(interface_plugin_exports);
+var \u63D2\u4EF6 = class {
+  constructor(\u9519\u8BEF\u7C7B\u578B\u63CF\u8FF0, \u6B63\u786E\u7C7B\u578B\u63CF\u8FF0, \u5B9E\u73B0) {
+    this.\u9519\u8BEF\u7C7B\u578B\u63CF\u8FF0 = \u9519\u8BEF\u7C7B\u578B\u63CF\u8FF0;
+    this.\u6B63\u786E\u7C7B\u578B\u63CF\u8FF0 = \u6B63\u786E\u7C7B\u578B\u63CF\u8FF0;
+    this.\u5B9E\u73B0 = \u5B9E\u73B0;
+  }
+  \u83B7\u5F97\u9519\u8BEF\u7C7B\u578B\u63CF\u8FF0() {
+    return this.\u9519\u8BEF\u7C7B\u578B\u63CF\u8FF0;
+  }
+  \u83B7\u5F97\u6B63\u786E\u7C7B\u578B\u63CF\u8FF0() {
+    return this.\u6B63\u786E\u7C7B\u578B\u63CF\u8FF0;
+  }
+  \u8FD0\u884C(req, res, \u9644\u52A0\u53C2\u6570) {
+    return this.\u5B9E\u73B0(req, res, \u9644\u52A0\u53C2\u6570);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  \u63D2\u4EF6
+});

package/dist/cjs/interface/interface-plugin.d.cts

@@ -0,0 +1,37 @@
+import { Either } from '@lsby/ts-fp-data';
+import { Request, Response } from 'express';
+import { z } from 'zod';
+import { 请求附加参数类型 as ________ } from '../types/types.cjs';
+import '@lsby/ts-log';
+import '../global/model/web-socket.cjs';
+import 'ws';
+import '../global/model/hub.cjs';
+
+/**
+ * ### 插件
+ *
+ * 插件是 {@link 接口逻辑} 的一部分, 是"业务逻辑"的前置逻辑
+ * - 可以获得原始的req, res对象, 但res对象仅仅是为了兼容express的某些插件添加的, 不要使用res返回数据
+ * - 插件的定位是, 从HTTP上下文中获得信息, 使后续逻辑能正确运行
+ *   - 插件提供的信息是必要的, 如果插件无法获取到信息, 意味着接口逻辑不能正常运行
+ *   - 插件提供错误处理能力, 可以在插件中返回左值来拒绝请求, 此时, 服务器会直接返回错误信息, 不会进入后续逻辑
+ */
+declare class 插件<错误结果 extends z.ZodObject<{
+    code: z.ZodLiteral<number>;
+    data: z.ZodTypeAny;
+}> | z.ZodNever, 正确结果 extends z.AnyZodObject> {
+    private 错误类型描述;
+    private 正确类型描述;
+    private 实现;
+    protected readonly __类型保持符号?: [错误结果, 正确结果];
+    constructor(错误类型描述: 错误结果, 正确类型描述: 正确结果, 实现: (req: Request, res: Response, 附加参数: ________) => Promise<Either<z.infer<错误结果>, z.infer<正确结果>>>);
+    获得错误类型描述(): 错误结果;
+    获得正确类型描述(): 正确结果;
+    运行(req: Request, res: Response, 附加参数: ________): Promise<Either<z.infer<错误结果>, z.infer<正确结果>>>;
+}
+type 任意插件 = 插件<any, any>;
+type 取插件错误ts类型<A> = A extends 插件<infer x, any> ? z.infer<x> : never;
+type 取插件正确ts类型<A> = A extends 插件<any, infer x> ? z.infer<x> : never;
+type 合并插件正确结果<Arr extends Array<任意插件>> = Arr extends [] ? {} : Arr extends [infer x, ...infer xs] ? x extends infer 插件项 ? xs extends Array<任意插件> ? 取插件正确ts类型<插件项> & 合并插件正确结果<xs> : {} : {} : {};
+
+export { type 任意插件, type 取插件正确ts类型, type 取插件错误ts类型, type 合并插件正确结果, 插件 };

package/dist/cjs/{plugin/plug.cjs → interface/interface-returner.cjs}

@@ -17,25 +17,15 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/plugin/plug.ts
-var plug_exports = {};
-__export(plug_exports, {
-  \u63D2\u4EF6: () => \u63D2\u4EF6
+// src/interface/interface-returner.ts
+var interface_returner_exports = {};
+__export(interface_returner_exports, {
+  \u63A5\u53E3\u8FD4\u56DE\u5668: () => \u63A5\u53E3\u8FD4\u56DE\u5668
 });
-module.exports = __toCommonJS(plug_exports);
-var \u63D2\u4EF6 = class {
-  constructor(\u7C7B\u578B, \u5B9E\u73B0) {
-    this.\u7C7B\u578B = \u7C7B\u578B;
-    this.\u5B9E\u73B0 = \u5B9E\u73B0;
-  }
-  \u83B7\u5F97\u7C7B\u578B() {
-    return this.\u7C7B\u578B;
-  }
-  \u8FD0\u884C(req, res, \u9644\u52A0\u53C2\u6570) {
-    return this.\u5B9E\u73B0(req, res, \u9644\u52A0\u53C2\u6570);
-  }
+module.exports = __toCommonJS(interface_returner_exports);
+var \u63A5\u53E3\u8FD4\u56DE\u5668 = class {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  \u63D2\u4EF6
+  \u63A5\u53E3\u8FD4\u56DE\u5668
 });