@lsby/net-core 0.11.2 → 0.13.3

package/dist/cjs/global/model/web-socket.cjs

@@ -0,0 +1,166 @@
+"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/global/model/web-socket.ts
+var web_socket_exports = {};
+__export(web_socket_exports, {
+  WebSocket\u7BA1\u7406\u5668: () => WebSocket\u7BA1\u7406\u5668
+});
+module.exports = __toCommonJS(web_socket_exports);
+
+// 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);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WebSocket\u7BA1\u7406\u5668
+});

package/dist/cjs/global/model/web-socket.d.cts

@@ -0,0 +1,21 @@
+import { WebSocket } from 'ws';
+import { 集线器监听器持有者 as _________ } from './hub.cjs';
+
+type id = string;
+declare class WebSocket管理器 {
+    private log;
+    private 连接表;
+    private 消息监听表;
+    private 连接清理模型;
+    private 连接持有者表;
+    private 清理函数表;
+    增加连接(id: id, ws句柄: WebSocket): _________<void>;
+    删除连接(id: string): void;
+    private 注册onmessage;
+    查询连接存在(id: string): boolean;
+    获得ws句柄(id: id): Promise<WebSocket | null>;
+    设置清理函数(id: string, 清理函数: () => Promise<void>): Promise<void>;
+    设置消息监听(id: string, 回调函数: (数据: any) => Promise<void>): _________<unknown> | null;
+}
+
+export { WebSocket管理器 };

package/dist/cjs/global/web-socket.cjs

@@ -0,0 +1,169 @@
+"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/global/web-socket.ts
+var web_socket_exports = {};
+__export(web_socket_exports, {
+  \u5168\u5C40WebSocket\u7BA1\u7406\u5668\u5355\u4F8B: () => \u5168\u5C40WebSocket\u7BA1\u7406\u5668\u5355\u4F8B
+});
+module.exports = __toCommonJS(web_socket_exports);
+
+// 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();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  \u5168\u5C40WebSocket\u7BA1\u7406\u5668\u5355\u4F8B
+});

package/dist/cjs/global/web-socket.d.cts

@@ -0,0 +1,7 @@
+import { WebSocket管理器 as WebSocket___ } from './model/web-socket.cjs';
+import 'ws';
+import './model/hub.cjs';
+
+declare let 全局WebSocket管理器单例: WebSocket___;
+
+export { 全局WebSocket管理器单例 };

package/dist/cjs/help/help.cjs

@@ -22,9 +22,152 @@ var help_exports = {};
 __export(help_exports, {
   \u666E\u901A\u5BF9\u8C61\u6DF1\u5408\u5E76: () => \u666E\u901A\u5BF9\u8C61\u6DF1\u5408\u5E76,
   \u6784\u9020\u5143\u7EC4: () => \u6784\u9020\u5143\u7EC4,
-  \u6784\u9020\u5BF9\u8C61: () => \u6784\u9020\u5BF9\u8C61
+  \u6784\u9020\u5BF9\u8C61: () => \u6784\u9020\u5BF9\u8C61,
+  \u9ED8\u8BA4\u8BF7\u6C42\u9644\u52A0\u53C2\u6570: () => \u9ED8\u8BA4\u8BF7\u6C42\u9644\u52A0\u53C2\u6570
 });
 module.exports = __toCommonJS(help_exports);
+
+// 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 \u6784\u9020\u5143\u7EC4(args) {
   return args;
 }
@@ -50,9 +193,15 @@ function \u666E\u901A\u5BF9\u8C61\u6DF1\u5408\u5E76(target, source) {
   }
   return result;
 }
+var \u9ED8\u8BA4\u8BF7\u6C42\u9644\u52A0\u53C2\u6570 = {
+  log: \u5168\u5C40\u65E5\u5FD7\u5355\u4F8B,
+  \u8BF7\u6C42id: "",
+  webSocket\u7BA1\u7406\u5668: \u5168\u5C40WebSocket\u7BA1\u7406\u5668\u5355\u4F8B
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   \u666E\u901A\u5BF9\u8C61\u6DF1\u5408\u5E76,
   \u6784\u9020\u5143\u7EC4,
-  \u6784\u9020\u5BF9\u8C61
+  \u6784\u9020\u5BF9\u8C61,
+  \u9ED8\u8BA4\u8BF7\u6C42\u9644\u52A0\u53C2\u6570
 });

package/dist/cjs/help/help.d.cts

@@ -1,13 +1,20 @@
+import { 请求附加参数类型 as ________ } from '../types/types.cjs';
+import '@lsby/ts-log';
+import '../global/model/web-socket.cjs';
+import 'ws';
+import '../global/model/hub.cjs';
+
 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>;
+declare let 默认请求附加参数: ________;
+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;
 
-export { type 严格递归合并对象, 普通对象深合并, 构造元组, 构造对象 };
+export { type 严格递归合并对象, 普通对象深合并, 构造元组, 构造对象, 默认请求附加参数 };

package/dist/cjs/help/interior.cjs

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var interior_exports = {};
 __export(interior_exports, {
   \u622A\u65AD\u5B57\u7B26\u4E32: () => \u622A\u65AD\u5B57\u7B26\u4E32,
+  \u6570\u7EC4\u5408\u5E76: () => \u6570\u7EC4\u5408\u5E76,
   \u9012\u5F52\u622A\u65AD\u5B57\u7B26\u4E32: () => \u9012\u5F52\u622A\u65AD\u5B57\u7B26\u4E32
 });
 module.exports = __toCommonJS(interior_exports);
@@ -35,14 +36,24 @@ function \u9012\u5F52\u622A\u65AD\u5B57\u7B26\u4E32(\u6570\u636E) {
   if (typeof \u6570\u636E === "object" && \u6570\u636E !== null) {
     let \u65B0\u6570\u636E = {};
     for (let key in \u6570\u636E) {
-      if (\u6570\u636E.hasOwnProperty(key) === true) \u65B0\u6570\u636E[key] = \u9012\u5F52\u622A\u65AD\u5B57\u7B26\u4E32(\u6570\u636E[key]);
+      if (Object.prototype.hasOwnProperty.call(\u6570\u636E, key)) \u65B0\u6570\u636E[key] = \u9012\u5F52\u622A\u65AD\u5B57\u7B26\u4E32(\u6570\u636E[key]);
     }
     return \u65B0\u6570\u636E;
   }
   return \u6570\u636E;
 }
+function \u6570\u7EC4\u5408\u5E76(...\u6570\u7EC4\u4EEC) {
+  if (\u6570\u7EC4\u4EEC.length === 0) return [];
+  let \u6700\u5927\u957F\u5EA6 = Math.max(...\u6570\u7EC4\u4EEC.map((a) => a.length));
+  let \u7ED3\u679C = [];
+  for (let i = 0; i < \u6700\u5927\u957F\u5EA6; i++) {
+    \u7ED3\u679C.push(\u6570\u7EC4\u4EEC.map((a) => a[i]));
+  }
+  return \u7ED3\u679C;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   \u622A\u65AD\u5B57\u7B26\u4E32,
+  \u6570\u7EC4\u5408\u5E76,
   \u9012\u5F52\u622A\u65AD\u5B57\u7B26\u4E32
 });

package/dist/cjs/help/interior.d.cts

@@ -1,7 +1,10 @@
-type 去除只读<T> = T extends readonly [...infer U] ? U : never;
-type 类型相等<X, Y> = (<T>() => T extends X ? 1 : 2) extends <T>() => T extends Y ? 1 : 2 ? true : false;
 declare function 截断字符串(内容: string): string;
 declare function 递归截断字符串(数据: any): any;
+declare function 数组合并<T extends readonly any[][]>(...数组们: T): Array<{
+    [K in keyof T]: T[K] extends (infer U)[] ? U : never;
+}>;
+type 去除只读<T> = T extends readonly [...infer U] ? U : never;
+type 类型相等<X, Y> = (<T>() => T extends X ? 1 : 2) extends <T>() => T extends Y ? 1 : 2 ? true : false;
 type UnionToIntersection<T> = (T extends any ? (x: T) => any : never) extends (x: infer U) => any ? U : never;
 type LastUnion<T> = UnionToIntersection<T extends any ? (x: T) => any : never> extends (x: infer L) => any ? L : never;
 type 联合转元组<T, Last = LastUnion<T>> = [T] extends [never] ? [] : [...联合转元组<Exclude<T, Last>>, Last];
@@ -14,4 +17,4 @@ type 数组去重<T extends readonly any[], 结果 extends readonly any[] = []>
     ...infer 剩余
 ] ? 数组包含<结果, 第一个> extends true ? 数组去重<剩余, 结果> : 数组去重<剩余, [...结果, 第一个]> : 结果;
 
-export { type 去除只读, type 对象去重, 截断字符串, type 数组包含, type 数组去重, type 类型相等, type 联合转元组, 递归截断字符串 };
+export { type 去除只读, type 对象去重, 截断字符串, type 数组包含, type 数组去重, 数组合并, type 类型相等, type 联合转元组, 递归截断字符串 };