@lsby/net-core 0.13.10 → 0.14.1

package/dist/esm/{chunk-MRTIZDKN.js → chunk-AFK5ATXH.js}

@@ -1,6 +1,6 @@
 import {
   集线器模型
-} from "./chunk-NTDDPUP7.js";
+} from "./chunk-IONVNCYO.js";
 import {
   全局日志单例
 } from "./chunk-F5IAX56T.js";
@@ -10,8 +10,6 @@ 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);
@@ -24,15 +22,11 @@ var WebSocket\u7BA1\u7406\u5668 = class {
       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) {
+    if (ws === void 0) return;
+    if (ws !== null) {
       ws.onmessage = null;
       ws.once("error", (err) => void this.log.error(`WebSocket \u5F02\u6B65\u9519\u8BEF, id: ${id}, \u9519\u8BEF: ${err}`));
       ws.once(
@@ -50,11 +44,6 @@ var WebSocket\u7BA1\u7406\u5668 = class {
     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) => {
@@ -76,10 +65,10 @@ var WebSocket\u7BA1\u7406\u5668 = class {
   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) {
+  \u8BBE\u7F6E\u6D88\u606F\u76D1\u542C(id, \u56DE\u8C03\u51FD\u6570, \u5BBF\u4E3B) {
     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);
+    if (\u6A21\u578B === void 0) return;
+    \u6A21\u578B.\u6DFB\u52A0\u76D1\u542C\u5668(\u56DE\u8C03\u51FD\u6570, \u5BBF\u4E3B);
   }
 };
 

package/dist/esm/{chunk-AB35ZHL3.js → chunk-F3TAHAJB.js}

@@ -1,6 +1,6 @@
 import {
   全局WebSocket管理器单例
-} from "./chunk-P23ZAK4I.js";
+} from "./chunk-MPNYB4TQ.js";
 import {
   全局日志单例
 } from "./chunk-F5IAX56T.js";

package/dist/esm/chunk-IONVNCYO.js

@@ -0,0 +1,67 @@
+// src/global/model/hub.ts
+var \u96C6\u7EBF\u5668\u76D1\u542C\u5668\u5BBF\u4E3B = class {
+  \u89E3\u9664\u56DE\u8C03 = null;
+  /** @internal */
+  \u7ED1\u5B9A\u56DE\u8C03(\u56DE\u8C03) {
+    if (this.\u89E3\u9664\u56DE\u8C03 !== null) {
+      throw new Error("\u6B64\u5BBF\u4E3B\u5DF2\u88AB\u7ED1\u5B9A\u5230\u4E00\u4E2A\u76D1\u542C\u5668\uFF0C\u4E0D\u53EF\u91CD\u590D\u7ED1\u5B9A");
+    }
+    this.\u89E3\u9664\u56DE\u8C03 = \u56DE\u8C03;
+  }
+  \u89E3\u7ED1() {
+    if (this.\u89E3\u9664\u56DE\u8C03 !== null) {
+      this.\u89E3\u9664\u56DE\u8C03();
+      this.\u89E3\u9664\u56DE\u8C03 = null;
+    }
+  }
+};
+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;
+    \u5B9E\u4F8B.\u76D1\u542C\u5668\u96C6\u5408.delete(\u76D1\u542C\u5668);
+  });
+  \u76D1\u542C\u5668\u96C6\u5408 = /* @__PURE__ */ new Set();
+  \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;
+  }
+  /**
+   * 注册监听器。
+   * 必须提供一个 `集线器监听器宿主` 实例。若宿主对象不被持有并被回收，监听器会在未来自动回收。
+   *
+   * ⚠️ 危险警告: 即使在该方法的同一逻辑层面的词法作用域内，若未显式调用 `宿主.解绑` 或保留长期强引用使用痕迹，
+   * 那么随着控制权转交和可达性缩减，仍然存在被 V8 提前进行垃圾回收而突然导致监听失效的极大风险。
+   * 建议详细阅读 `集线器监听器宿主` 类的文档备注以此警醒。
+   */
+  \u6DFB\u52A0\u76D1\u542C\u5668(\u76D1\u542C\u5668, \u5BBF\u4E3B) {
+    let \u5B9E\u4F8B\u5F31\u5F15\u7528 = new WeakRef(this);
+    \u5BBF\u4E3B.\u7ED1\u5B9A\u56DE\u8C03(() => {
+      let \u5B9E\u4F8B = \u5B9E\u4F8B\u5F31\u5F15\u7528.deref();
+      if (\u5B9E\u4F8B !== void 0) {
+        \u5B9E\u4F8B.\u76D1\u542C\u5668\u96C6\u5408.delete(\u76D1\u542C\u5668);
+      }
+      _\u96C6\u7EBF\u5668\u6A21\u578B.\u6E05\u7406\u6CE8\u518C\u5668.unregister(\u5BBF\u4E3B);
+    });
+    this.\u76D1\u542C\u5668\u96C6\u5408.add(\u76D1\u542C\u5668);
+    _\u96C6\u7EBF\u5668\u6A21\u578B.\u6E05\u7406\u6CE8\u518C\u5668.register(\u5BBF\u4E3B, { \u5B9E\u4F8B\u5F15\u7528: \u5B9E\u4F8B\u5F31\u5F15\u7528, \u76D1\u542C\u5668 }, \u5BBF\u4E3B);
+  }
+  async \u5E7F\u64AD(\u6570\u636E) {
+    let snapshot = [...this.\u76D1\u542C\u5668\u96C6\u5408];
+    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));
+      }
+    }
+  }
+};
+
+export {
+  集线器监听器宿主,
+  集线器模型
+};

package/dist/esm/{chunk-MVMDWJTB.js → chunk-L37E7HVL.js}

@@ -1,6 +1,6 @@
 import {
   全局WebSocket管理器单例
-} from "./chunk-P23ZAK4I.js";
+} from "./chunk-MPNYB4TQ.js";
 import {
   全局日志单例
 } from "./chunk-F5IAX56T.js";

package/dist/esm/{chunk-7GT72IUT.js → chunk-LGDSCDOJ.js}

@@ -1,6 +1,6 @@
 import {
-  集线器监听器持有者
-} from "./chunk-NTDDPUP7.js";
+  集线器监听器宿主
+} from "./chunk-IONVNCYO.js";
 import {
   插件
 } from "./chunk-EGIJQJFI.js";
@@ -18,8 +18,8 @@ var WebSocket\u63D2\u4EF6 = class _WebSocket\u63D2\u4EF6 extends \u63D2\u4EF6 {
         ws\u64CD\u4F5C: z.object({
           \u53D1\u9001ws\u4FE1\u606F: z.function(z.tuple([\u540E\u63A8\u524D\u4FE1\u606F\u63CF\u8FF0]), z.promise(z.void())),
           \u76D1\u542Cws\u4FE1\u606F: z.function(
-            z.tuple([z.function(z.tuple([\u524D\u63A8\u540E\u4FE1\u606F\u63CF\u8FF0]), z.promise(z.void()))]),
-            z.promise(z.union([z.instanceof(\u96C6\u7EBF\u5668\u76D1\u542C\u5668\u6301\u6709\u8005), z.null()]))
+            z.tuple([z.function(z.tuple([\u524D\u63A8\u540E\u4FE1\u606F\u63CF\u8FF0]), z.promise(z.void())), z.instanceof(\u96C6\u7EBF\u5668\u76D1\u542C\u5668\u5BBF\u4E3B)]),
+            z.promise(z.void())
           ),
           \u5173\u95EDws\u8FDE\u63A5: z.function(z.tuple([]), z.promise(z.void())),
           \u8BBE\u7F6E\u6E05\u7406\u51FD\u6570: z.function(z.tuple([z.function(z.tuple([]), z.promise(z.void()))]), z.promise(z.void()))
@@ -68,16 +68,28 @@ var WebSocket\u63D2\u4EF6 = class _WebSocket\u63D2\u4EF6 extends \u63D2\u4EF6 {
               await log.debug("\u8BBE\u7F6E WebSocket \u6E05\u7406\u51FD\u6570", { wsId });
               await WebSocket\u7BA1\u7406\u5668.\u8BBE\u7F6E\u6E05\u7406\u51FD\u6570(wsId, \u6E05\u7406\u51FD\u6570);
             },
-            async \u76D1\u542Cws\u4FE1\u606F(\u56DE\u8C03\u51FD\u6570) {
+            async \u76D1\u542Cws\u4FE1\u606F(\u56DE\u8C03\u51FD\u6570, \u5BBF\u4E3B) {
               if (ws\u53E5\u67C4 === null) {
                 ws\u53E5\u67C4 = await WebSocket\u7BA1\u7406\u5668.\u83B7\u5F97ws\u53E5\u67C4(wsId);
               }
               if (ws\u53E5\u67C4 === null) {
                 await log.error("\u672A\u80FD\u83B7\u53D6\u5230\u6709\u6548\u7684 WebSocket \u53E5\u67C4");
-                return null;
+                return;
+              }
+              let \u79C1\u6709\u5C5E\u6027\u53E5\u67C4 = ws\u53E5\u67C4;
+              let \u5173\u8054\u5BBF\u4E3B\u96C6\u5408 = \u79C1\u6709\u5C5E\u6027\u53E5\u67C4.__hosts;
+              if (\u5173\u8054\u5BBF\u4E3B\u96C6\u5408 === void 0) {
+                \u5173\u8054\u5BBF\u4E3B\u96C6\u5408 = /* @__PURE__ */ new Set();
+                \u79C1\u6709\u5C5E\u6027\u53E5\u67C4.__hosts = \u5173\u8054\u5BBF\u4E3B\u96C6\u5408;
               }
+              \u5173\u8054\u5BBF\u4E3B\u96C6\u5408.add(\u5BBF\u4E3B);
+              let \u539F\u59CB\u89E3\u7ED1 = \u5BBF\u4E3B.\u89E3\u7ED1.bind(\u5BBF\u4E3B);
+              \u5BBF\u4E3B.\u89E3\u7ED1 = () => {
+                \u539F\u59CB\u89E3\u7ED1();
+                \u5173\u8054\u5BBF\u4E3B\u96C6\u5408.delete(\u5BBF\u4E3B);
+              };
               await log.debug("\u6CE8\u518C WebSocket \u6D88\u606F\u76D1\u542C", { wsId });
-              return WebSocket\u7BA1\u7406\u5668.\u8BBE\u7F6E\u6D88\u606F\u76D1\u542C(wsId, \u56DE\u8C03\u51FD\u6570);
+              WebSocket\u7BA1\u7406\u5668.\u8BBE\u7F6E\u6D88\u606F\u76D1\u542C(wsId, \u56DE\u8C03\u51FD\u6570, \u5BBF\u4E3B);
             }
           }
         });

package/dist/esm/{chunk-P23ZAK4I.js → chunk-MPNYB4TQ.js}

@@ -1,6 +1,6 @@
 import {
   WebSocket管理器
-} from "./chunk-MRTIZDKN.js";
+} from "./chunk-AFK5ATXH.js";
 
 // src/global/web-socket.ts
 var \u5168\u5C40WebSocket\u7BA1\u7406\u5668\u5355\u4F8B = new WebSocket\u7BA1\u7406\u5668();

package/dist/esm/{chunk-TE6CG2FF.js → chunk-ON373JA4.js}

@@ -1,6 +1,6 @@
 import {
   普通对象深合并
-} from "./chunk-MVMDWJTB.js";
+} from "./chunk-L37E7HVL.js";
 
 // src/interface/interface-logic.ts
 import { Right } from "@lsby/ts-fp-data";

package/dist/esm/global/model/hub.d.ts

@@ -1,13 +1,27 @@
 type 集线器监听器<T> = (数据: T) => Promise<void>;
 type 广播错误处理<T> = (数据: T, 索引: number, 错误: unknown) => Promise<void> | void;
-declare class 集线器监听器持有者<T> {
-    readonly 监听器: 集线器监听器<T>;
-    constructor(监听器: 集线器监听器<T>);
+/**
+ * 集线器监听器的生命周期宿主。
+ *
+ * ⚠️ 极其关键的生命周期警告 (基于可达性分析的 GC 陷阱)：
+ * 就算该宿主对象是在某个函数/代码块内部用 `let` 定义的，
+ * 只要在传入并绑定后，后续的块级执行代码逻辑中再也没有明确使用过这个变量（哪怕依然在同一个作用域中，只隔了几个 `await` 导致挂起），
+ * V8 的可达性分析 (Reachability Analysis) 机制就有可能直接将它判定为"死亡实例"，并毫无预兆地将其提早垃圾回收。
+ * 一旦它被回收，底层基于 FinalizationRegistry 机制的监听器必定会被默默注销销毁，进而引发不可捉摸的幽灵 Bug。
+ *
+ * 因此强烈建议对宿主的处理必须做到以下做法之一以防止"同作用域幽灵断联"：
+ * 1. 最稳妥的做法：在你期待的监听生命周期末尾，务必显式并手动调用一次 `宿主.解绑()` 操作 (它同时也是维持该变量存活的必要证明)。
+ * 2. 绑定在长期实体生存期：把它强行关联进拥有对应生存期的实体内 (例如直接作为一个持久化句柄的强引用缓存属性对象存在)。
+ */
+declare class 集线器监听器宿主 {
+    private 解除回调;
+    /** @internal */
+    绑定回调(回调: () => void): void;
+    解绑(): void;
 }
 declare class 集线器模型<T> {
     private static 清理注册器;
-    private 监听器列表;
-    private 持有者映射;
+    private 监听器集合;
     private 错误处理器;
     /**
      * 设置广播错误时的处理器。
@@ -15,12 +29,14 @@ declare class 集线器模型<T> {
     设置错误处理器(处理器: 广播错误处理<T>): void;
     /**
      * 注册监听器。
-     * 若外部不再持有返回的 `监听器持有者`，监听器会在未来某个时间自动移除。
-     * ⚠️ 自动清理是非确定性的，不能依赖它实现实时释放。
+     * 必须提供一个 `集线器监听器宿主` 实例。若宿主对象不被持有并被回收，监听器会在未来自动回收。
+     *
+     * ⚠️ 危险警告: 即使在该方法的同一逻辑层面的词法作用域内，若未显式调用 `宿主.解绑` 或保留长期强引用使用痕迹，
+     * 那么随着控制权转交和可达性缩减，仍然存在被 V8 提前进行垃圾回收而突然导致监听失效的极大风险。
+     * 建议详细阅读 `集线器监听器宿主` 类的文档备注以此警醒。
      */
-    添加监听器(监听器: 集线器监听器<T>): 集线器监听器持有者<T>;
-    移除监听器(持有者: 集线器监听器持有者<T>): void;
+    添加监听器(监听器: 集线器监听器<T>, 宿主: 集线器监听器宿主): void;
     广播(数据: T): Promise<void>;
 }
 
-export { type 广播错误处理, 集线器模型, type 集线器监听器, 集线器监听器持有者 };
+export { type 广播错误处理, 集线器模型, type 集线器监听器, 集线器监听器宿主 };

package/dist/esm/global/model/hub.js

@@ -1,8 +1,8 @@
 import {
   集线器模型,
-  集线器监听器持有者
-} from "../../chunk-NTDDPUP7.js";
+  集线器监听器宿主
+} from "../../chunk-IONVNCYO.js";
 export {
   \u96C6\u7EBF\u5668\u6A21\u578B,
-  \u96C6\u7EBF\u5668\u76D1\u542C\u5668\u6301\u6709\u8005
+  \u96C6\u7EBF\u5668\u76D1\u542C\u5668\u5BBF\u4E3B
 };

package/dist/esm/global/model/web-socket.d.ts

@@ -1,21 +1,19 @@
 import { WebSocket } from 'ws';
-import { 集线器监听器持有者 as _________ } from './hub.js';
+import { 集线器监听器宿主 as ________ } from './hub.js';
 
 type id = string;
 declare class WebSocket管理器 {
     private log;
     private 连接表;
     private 消息监听表;
-    private 连接清理模型;
-    private 连接持有者表;
     private 清理函数表;
-    增加连接(id: id, ws句柄: WebSocket): _________<void>;
+    增加连接(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;
+    设置消息监听(id: string, 回调函数: (数据: any) => Promise<void>, 宿主: ________): void;
 }
 
 export { WebSocket管理器 };

package/dist/esm/global/model/web-socket.js

@@ -1,7 +1,7 @@
 import {
   WebSocket管理器
-} from "../../chunk-MRTIZDKN.js";
-import "../../chunk-NTDDPUP7.js";
+} from "../../chunk-AFK5ATXH.js";
+import "../../chunk-IONVNCYO.js";
 import "../../chunk-F5IAX56T.js";
 export {
   WebSocket\u7BA1\u7406\u5668

package/dist/esm/global/web-socket.js

@@ -1,8 +1,8 @@
 import {
   全局WebSocket管理器单例
-} from "../chunk-P23ZAK4I.js";
-import "../chunk-MRTIZDKN.js";
-import "../chunk-NTDDPUP7.js";
+} from "../chunk-MPNYB4TQ.js";
+import "../chunk-AFK5ATXH.js";
+import "../chunk-IONVNCYO.js";
 import "../chunk-F5IAX56T.js";
 export {
   \u5168\u5C40WebSocket\u7BA1\u7406\u5668\u5355\u4F8B

package/dist/esm/help/help.js

@@ -3,10 +3,10 @@ import {
   构造元组,
   构造对象,
   默认请求附加参数
-} from "../chunk-MVMDWJTB.js";
-import "../chunk-P23ZAK4I.js";
-import "../chunk-MRTIZDKN.js";
-import "../chunk-NTDDPUP7.js";
+} from "../chunk-L37E7HVL.js";
+import "../chunk-MPNYB4TQ.js";
+import "../chunk-AFK5ATXH.js";
+import "../chunk-IONVNCYO.js";
 import "../chunk-F5IAX56T.js";
 export {
   \u666E\u901A\u5BF9\u8C61\u6DF1\u5408\u5E76,

package/dist/esm/index.d.ts

@@ -1,4 +1,5 @@
 export { 严格递归合并对象, 普通对象深合并, 构造元组, 构造对象, 默认请求附加参数 } from './help/help.js';
+export { 广播错误处理, 集线器模型, 集线器监听器, 集线器监听器宿主 } from './global/model/hub.js';
 export { 任意接口, 接口, 接口方法类型, 接口路径类型, 获得接口方法类型, 获得接口路径类型, 获得接口返回器类型, 获得接口逻辑类型 } from './interface/interface-base.js';
 export { 任意接口逻辑, 接口逻辑, 接口逻辑Base, 接口逻辑正确类型, 接口逻辑错误类型, 接口逻辑附加参数类型, 清理函数类型, 获得接口逻辑上游接口类型, 获得接口逻辑插件类型, 获得接口逻辑最后接口类型, 获得接口逻辑正确类型, 获得接口逻辑错误类型, 获得接口逻辑附加参数类型, 计算接口逻辑参数, 计算接口逻辑正确结果, 计算接口逻辑错误结果 } from './interface/interface-logic.js';
 export { 任意插件, 取插件正确ts类型, 取插件错误ts类型, 合并插件正确结果, 插件 } from './interface/interface-plugin.js';
@@ -27,7 +28,6 @@ import 'express';
 import './help/interior.js';
 import 'zod';
 import 'multer';
-import './global/model/hub.js';
 import 'node:stream';
 import 'node:http';
 import '@lsby/ts-log';

package/dist/esm/index.js

@@ -1,9 +1,9 @@
 import {
-  静态文件返回器
-} from "./chunk-RWEYJ3T7.js";
+  服务器
+} from "./chunk-F3TAHAJB.js";
 import {
-  虚拟文件返回器
-} from "./chunk-WXTNTK3M.js";
+  EXPORT_TYPE
+} from "./chunk-HT7VG4BT.js";
 import "./chunk-XPFEAXE4.js";
 import "./chunk-BWFSM5FK.js";
 import {
@@ -14,13 +14,7 @@ import {
 } from "./chunk-UK5TCQXV.js";
 import {
   WebSocket插件
-} from "./chunk-7GT72IUT.js";
-import {
-  EXPORT_TYPE
-} from "./chunk-HT7VG4BT.js";
-import {
-  服务器
-} from "./chunk-AB35ZHL3.js";
+} from "./chunk-LGDSCDOJ.js";
 import {
   常用接口返回器
 } from "./chunk-AOZ3QFOM.js";
@@ -30,6 +24,12 @@ import {
 import {
   文件流式下载返回器
 } from "./chunk-QRJ6A4DG.js";
+import {
+  静态文件返回器
+} from "./chunk-RWEYJ3T7.js";
+import {
+  虚拟文件返回器
+} from "./chunk-WXTNTK3M.js";
 import {
   接口返回器
 } from "./chunk-FP6Q65NN.js";
@@ -62,16 +62,19 @@ import {
 import {
   接口逻辑,
   接口逻辑Base
-} from "./chunk-TE6CG2FF.js";
+} from "./chunk-ON373JA4.js";
 import {
   普通对象深合并,
   构造元组,
   构造对象,
   默认请求附加参数
-} from "./chunk-MVMDWJTB.js";
-import "./chunk-P23ZAK4I.js";
-import "./chunk-MRTIZDKN.js";
-import "./chunk-NTDDPUP7.js";
+} from "./chunk-L37E7HVL.js";
+import "./chunk-MPNYB4TQ.js";
+import "./chunk-AFK5ATXH.js";
+import {
+  集线器模型,
+  集线器监听器宿主
+} from "./chunk-IONVNCYO.js";
 import "./chunk-F5IAX56T.js";
 import {
   插件
@@ -102,6 +105,8 @@ export {
   \u865A\u62DF\u6587\u4EF6\u8FD4\u56DE\u5668,
   \u8C03\u8BD5\u8BF7\u6C42\u5934\u63D2\u4EF6,
   \u8DEF\u5F84\u89E3\u6790\u63D2\u4EF6,
+  \u96C6\u7EBF\u5668\u6A21\u578B,
+  \u96C6\u7EBF\u5668\u76D1\u542C\u5668\u5BBF\u4E3B,
   \u9759\u6001\u6587\u4EF6\u8FD4\u56DE\u5668,
   \u9ED8\u8BA4\u8BF7\u6C42\u9644\u52A0\u53C2\u6570
 };

package/dist/esm/interface/interface-logic.js

@@ -1,11 +1,11 @@
 import {
   接口逻辑,
   接口逻辑Base
-} from "../chunk-TE6CG2FF.js";
-import "../chunk-MVMDWJTB.js";
-import "../chunk-P23ZAK4I.js";
-import "../chunk-MRTIZDKN.js";
-import "../chunk-NTDDPUP7.js";
+} from "../chunk-ON373JA4.js";
+import "../chunk-L37E7HVL.js";
+import "../chunk-MPNYB4TQ.js";
+import "../chunk-AFK5ATXH.js";
+import "../chunk-IONVNCYO.js";
 import "../chunk-F5IAX56T.js";
 export {
   \u63A5\u53E3\u903B\u8F91,

package/dist/esm/plugin/web-socket.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { 集线器监听器持有者 as _________ } from '../global/model/hub.js';
+import { 集线器监听器宿主 as ________ } from '../global/model/hub.js';
 import { 插件 as __, 任意插件 as ____ } from '../interface/interface-plugin.js';
 import '@lsby/ts-fp-data';
 import 'express';
@@ -13,7 +13,10 @@ declare class WebSocket插件<后推前信息 extends z.AnyZodObject | z.ZodNeve
     ws操作: z.ZodUnion<[
         z.ZodObject<{
             发送ws信息: z.ZodFunction<z.ZodTuple<[后推前信息], null>, z.ZodPromise<z.ZodVoid>>;
-            监听ws信息: z.ZodFunction<z.ZodTuple<[z.ZodFunction<z.ZodTuple<[前推后信息], null>, z.ZodPromise<z.ZodVoid>>], null>, z.ZodPromise<z.ZodUnion<[z.ZodType<_________<unknown>>, z.ZodNull]>>>;
+            监听ws信息: z.ZodFunction<z.ZodTuple<[
+                z.ZodFunction<z.ZodTuple<[前推后信息], null>, z.ZodPromise<z.ZodVoid>>,
+                z.ZodType<________>
+            ], null>, z.ZodPromise<z.ZodVoid>>;
             关闭ws连接: z.ZodFunction<z.ZodTuple<[], null>, z.ZodPromise<z.ZodVoid>>;
             设置清理函数: z.ZodFunction<z.ZodTuple<[z.ZodFunction<z.ZodTuple<[], null>, z.ZodPromise<z.ZodVoid>>], null>, z.ZodPromise<z.ZodVoid>>;
         }>,

package/dist/esm/plugin/web-socket.js

@@ -1,7 +1,7 @@
 import {
   WebSocket插件
-} from "../chunk-7GT72IUT.js";
-import "../chunk-NTDDPUP7.js";
+} from "../chunk-LGDSCDOJ.js";
+import "../chunk-IONVNCYO.js";
 import "../chunk-EGIJQJFI.js";
 export {
   WebSocket\u63D2\u4EF6

package/dist/esm/server/server.js

@@ -1,9 +1,9 @@
 import {
   服务器
-} from "../chunk-AB35ZHL3.js";
-import "../chunk-P23ZAK4I.js";
-import "../chunk-MRTIZDKN.js";
-import "../chunk-NTDDPUP7.js";
+} from "../chunk-F3TAHAJB.js";
+import "../chunk-MPNYB4TQ.js";
+import "../chunk-AFK5ATXH.js";
+import "../chunk-IONVNCYO.js";
 import "../chunk-F5IAX56T.js";
 export {
   \u670D\u52A1\u5668

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lsby/net-core",
-  "version": "0.13.10",
+  "version": "0.14.1",
   "repository": {
     "type": "git",
     "url": "https://github.com/lsby/net-core.git"

package/dist/esm/chunk-NTDDPUP7.js

@@ -1,59 +0,0 @@
-// 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));
-      }
-    }
-  }
-};
-
-export {
-  集线器监听器持有者,
-  集线器模型
-};