@lsby/net-core 0.12.3 → 0.13.3

package/dist/cjs/plugin/parse-path.cjs

@@ -0,0 +1,100 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/plugin/parse-path.ts
+var parse_path_exports = {};
+__export(parse_path_exports, {
+  \u8DEF\u5F84\u89E3\u6790\u63D2\u4EF6: () => \u8DEF\u5F84\u89E3\u6790\u63D2\u4EF6
+});
+module.exports = __toCommonJS(parse_path_exports);
+var import_ts_fp_data = require("@lsby/ts-fp-data");
+var import_node_path = __toESM(require("path"), 1);
+var import_zod = require("zod");
+
+// src/help/interior.ts
+function \u622A\u65AD\u5B57\u7B26\u4E32(\u5185\u5BB9) {
+  let \u6700\u5927\u65E5\u5FD7\u957F\u5EA6 = 1e3;
+  if (\u5185\u5BB9.length > \u6700\u5927\u65E5\u5FD7\u957F\u5EA6) return \u5185\u5BB9.slice(0, \u6700\u5927\u65E5\u5FD7\u957F\u5EA6) + "...";
+  return \u5185\u5BB9;
+}
+function \u9012\u5F52\u622A\u65AD\u5B57\u7B26\u4E32(\u6570\u636E) {
+  if (typeof \u6570\u636E === "string") return \u622A\u65AD\u5B57\u7B26\u4E32(\u6570\u636E);
+  if (Array.isArray(\u6570\u636E)) return \u6570\u636E.map((\u9879) => \u9012\u5F52\u622A\u65AD\u5B57\u7B26\u4E32(\u9879));
+  if (typeof \u6570\u636E === "object" && \u6570\u636E !== null) {
+    let \u65B0\u6570\u636E = {};
+    for (let key in \u6570\u636E) {
+      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;
+}
+
+// src/interface/interface-plugin.ts
+var \u63D2\u4EF6 = class {
+  constructor(\u9519\u8BEF\u7C7B\u578B\u63CF\u8FF02, \u6B63\u786E\u7C7B\u578B\u63CF\u8FF02, \u5B9E\u73B0) {
+    this.\u9519\u8BEF\u7C7B\u578B\u63CF\u8FF0 = \u9519\u8BEF\u7C7B\u578B\u63CF\u8FF02;
+    this.\u6B63\u786E\u7C7B\u578B\u63CF\u8FF0 = \u6B63\u786E\u7C7B\u578B\u63CF\u8FF02;
+    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);
+  }
+};
+
+// src/plugin/parse-path.ts
+var \u9519\u8BEF\u7C7B\u578B\u63CF\u8FF0 = import_zod.z.never();
+var \u6B63\u786E\u7C7B\u578B\u63CF\u8FF0 = import_zod.z.object({
+  path: import_zod.z.object({ rawPath: import_zod.z.string(), dir: import_zod.z.string(), file: import_zod.z.string(), ext: import_zod.z.string() })
+});
+var \u8DEF\u5F84\u89E3\u6790\u63D2\u4EF6 = class _\u8DEF\u5F84\u89E3\u6790\u63D2\u4EF6 extends \u63D2\u4EF6 {
+  constructor() {
+    super(\u9519\u8BEF\u7C7B\u578B\u63CF\u8FF0, \u6B63\u786E\u7C7B\u578B\u63CF\u8FF0, async (req, res, \u9644\u52A0\u53C2\u6570) => {
+      let log = \u9644\u52A0\u53C2\u6570.log.extend(_\u8DEF\u5F84\u89E3\u6790\u63D2\u4EF6.name);
+      let rawPath = decodeURIComponent(req.path);
+      await log.debug("\u539F\u59CB\u8DEF\u5F84: %s", rawPath);
+      let dir = import_node_path.default.dirname(rawPath);
+      let file = import_node_path.default.basename(rawPath);
+      let ext = import_node_path.default.extname(rawPath);
+      let parsedPath = { rawPath, dir, file, ext };
+      await log.debug("\u89E3\u6790\u540E\u7684\u8DEF\u5F84: %o", JSON.stringify(\u9012\u5F52\u622A\u65AD\u5B57\u7B26\u4E32(parsedPath)));
+      return new import_ts_fp_data.Right({ path: parsedPath });
+    });
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  \u8DEF\u5F84\u89E3\u6790\u63D2\u4EF6
+});

package/dist/cjs/plugin/parse-path.d.cts

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import { 插件 as __ } from '../interface/interface-plugin.cjs';
+import '@lsby/ts-fp-data';
+import 'express';
+import '../types/types.cjs';
+import '@lsby/ts-log';
+import '../global/model/web-socket.cjs';
+import 'ws';
+import '../global/model/hub.cjs';
+
+declare let 错误类型描述: z.ZodNever;
+declare let 正确类型描述: z.ZodObject<{
+    path: z.ZodObject<{
+        rawPath: z.ZodString;
+        dir: z.ZodString;
+        file: z.ZodString;
+        ext: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        rawPath: string;
+        dir: string;
+        file: string;
+        ext: string;
+    }, {
+        rawPath: string;
+        dir: string;
+        file: string;
+        ext: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    path: {
+        rawPath: string;
+        dir: string;
+        file: string;
+        ext: string;
+    };
+}, {
+    path: {
+        rawPath: string;
+        dir: string;
+        file: string;
+        ext: string;
+    };
+}>;
+/**
+ * 路径解析插件 - 用于解析和分析 HTTP 请求的路径
+ *
+ * 功能说明：
+ * - 对请求路径进行 URL 解码
+ * - 解析路径的各个组成部分：目录、文件名、扩展名
+ *
+ * 返回数据结构：
+ * - rawPath: 解码后的完整路径
+ * - dir: 目录部分
+ * - file: 文件名（含扩展名）
+ * - ext: 文件扩展名（包括点号）
+ *
+ * 使用示例：
+ * 请求 URL: /api/users/profile.json?id=123
+ * 返回结果:
+ * {
+ *   path: {
+ *     rawPath: "/api/users/profile.json",
+ *     dir: "/api/users",
+ *     file: "profile.json",
+ *     ext: ".json"
+ *   }
+ * }
+ */
+declare class 路径解析插件 extends __<typeof 错误类型描述, typeof 正确类型描述> {
+    constructor();
+}
+
+export { 路径解析插件 };

package/dist/cjs/plugin/{extend/query.cjs → query.cjs}

@@ -17,12 +17,13 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/plugin/extend/query.ts
+// src/plugin/query.ts
 var query_exports = {};
 __export(query_exports, {
-  GET\u53C2\u6570\u89E3\u6790\u63D2\u4EF6: () => GET\u53C2\u6570\u89E3\u6790\u63D2\u4EF6
+  Query\u53C2\u6570\u89E3\u6790\u63D2\u4EF6: () => Query\u53C2\u6570\u89E3\u6790\u63D2\u4EF6
 });
 module.exports = __toCommonJS(query_exports);
+var import_ts_fp_data = require("@lsby/ts-fp-data");
 var import_node_util = require("util");
 var import_zod = require("zod");
 
@@ -38,46 +39,49 @@ 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;
 }
 
-// src/plugin/plug.ts
+// src/interface/interface-plugin.ts
 var \u63D2\u4EF6 = class {
-  constructor(\u7C7B\u578B, \u5B9E\u73B0) {
-    this.\u7C7B\u578B = \u7C7B\u578B;
+  constructor(\u9519\u8BEF\u7C7B\u578B\u63CF\u8FF02, \u6B63\u786E\u7C7B\u578B\u63CF\u8FF0, \u5B9E\u73B0) {
+    this.\u9519\u8BEF\u7C7B\u578B\u63CF\u8FF0 = \u9519\u8BEF\u7C7B\u578B\u63CF\u8FF02;
+    this.\u6B63\u786E\u7C7B\u578B\u63CF\u8FF0 = \u6B63\u786E\u7C7B\u578B\u63CF\u8FF0;
     this.\u5B9E\u73B0 = \u5B9E\u73B0;
   }
-  \u83B7\u5F97\u7C7B\u578B() {
-    return this.\u7C7B\u578B;
+  \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);
   }
 };
 
-// src/plugin/extend/query.ts
-var \u70D9\u5370 = Symbol();
-var GET\u53C2\u6570\u89E3\u6790\u63D2\u4EF6 = class extends \u63D2\u4EF6 {
-  [\u70D9\u5370] = ["GET\u53C2\u6570\u89E3\u6790\u63D2\u4EF6"];
+// src/plugin/query.ts
+var \u9519\u8BEF\u7C7B\u578B\u63CF\u8FF0 = import_zod.z.object({ code: import_zod.z.literal(400), data: import_zod.z.string() });
+var Query\u53C2\u6570\u89E3\u6790\u63D2\u4EF6 = class _Query\u53C2\u6570\u89E3\u6790\u63D2\u4EF6 extends \u63D2\u4EF6 {
   constructor(t) {
-    super(import_zod.z.object({ query: t }), async (req, _res, \u9644\u52A0\u53C2\u6570) => {
-      let log = \u9644\u52A0\u53C2\u6570.log.extend("GET\u53C2\u6570\u89E3\u6790\u63D2\u4EF6");
-      await log.debug("\u51C6\u5907\u89E3\u6790 GET \u53C2\u6570\uFF1A%o", JSON.stringify(\u9012\u5F52\u622A\u65AD\u5B57\u7B26\u4E32(req.query)));
+    super(\u9519\u8BEF\u7C7B\u578B\u63CF\u8FF0, import_zod.z.object({ query: t }), async (req, _res, \u9644\u52A0\u53C2\u6570) => {
+      let log = \u9644\u52A0\u53C2\u6570.log.extend(_Query\u53C2\u6570\u89E3\u6790\u63D2\u4EF6.name);
+      await log.debug("\u51C6\u5907\u89E3\u6790 Query \u53C2\u6570\uFF1A%o", JSON.stringify(\u9012\u5F52\u622A\u65AD\u5B57\u7B26\u4E32(req.query)));
       let parseResult = t.safeParse(req.query);
       if (parseResult.success === false) {
-        await log.error("\u89E3\u6790 GET \u53C2\u6570\u5931\u8D25\uFF1A%o", parseResult.error);
-        throw new Error((0, import_node_util.format)("\u89E3\u6790 GET \u53C2\u6570\u5931\u8D25: %o", parseResult.error));
+        await log.error("\u89E3\u6790 Query \u53C2\u6570\u5931\u8D25\uFF1A%o", JSON.stringify(parseResult.error));
+        return new import_ts_fp_data.Left({ code: 400, data: (0, import_node_util.format)("\u89E3\u6790 Query \u53C2\u6570\u5931\u8D25: %o", JSON.stringify(parseResult.error)) });
       }
-      await log.debug("\u6210\u529F\u89E3\u6790 GET \u53C2\u6570");
-      return { query: parseResult.data };
+      await log.debug("\u6210\u529F\u89E3\u6790 Query \u53C2\u6570");
+      return new import_ts_fp_data.Right({ query: parseResult.data });
     });
   }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  GET\u53C2\u6570\u89E3\u6790\u63D2\u4EF6
+  Query\u53C2\u6570\u89E3\u6790\u63D2\u4EF6
 });

package/dist/cjs/plugin/query.d.cts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { 严格递归合并对象 as ________ } from '../help/help.cjs';
+import { 获得接口逻辑插件类型 as __________ } from '../interface/interface-logic.cjs';
+import { 插件 as __, 任意插件 as ____, 取插件正确ts类型 as _____ts__ } from '../interface/interface-plugin.cjs';
+import '../types/types.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';
+
+declare let 错误类型描述: z.ZodObject<{
+    code: z.ZodLiteral<400>;
+    data: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    code: 400;
+    data: string;
+}, {
+    code: 400;
+    data: string;
+}>;
+declare class Query参数解析插件<Result extends z.AnyZodObject> extends __<typeof 错误类型描述, z.ZodObject<{
+    query: Result;
+}>> {
+    constructor(t: Result);
+}
+type 任意Query参数解析插件 = Query参数解析插件<any>;
+type 任意Query参数解析插件项 = 任意Query参数解析插件;
+type 合并Query插件结果<Arr extends Array<____>> = Arr extends [] ? {} : Arr extends [infer x, ...infer xs] ? x extends infer 插件项 ? xs extends Array<____> ? 插件项 extends 任意Query参数解析插件项 ? ________<{
+    query: _____ts__<插件项>['query'];
+}, 合并Query插件结果<xs>> : 合并Query插件结果<xs> : {} : {} : {};
+type 计算接口逻辑Query参数<接口逻辑> = 合并Query插件结果<__________<接口逻辑>>;
+
+export { Query参数解析插件, type 任意Query参数解析插件, type 任意Query参数解析插件项, type 合并Query插件结果, type 计算接口逻辑Query参数 };

package/dist/cjs/plugin/urlencoded.cjs

@@ -0,0 +1,103 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/plugin/urlencoded.ts
+var urlencoded_exports = {};
+__export(urlencoded_exports, {
+  UrlEncoded\u53C2\u6570\u89E3\u6790\u63D2\u4EF6: () => UrlEncoded\u53C2\u6570\u89E3\u6790\u63D2\u4EF6
+});
+module.exports = __toCommonJS(urlencoded_exports);
+var import_ts_fp_data = require("@lsby/ts-fp-data");
+var import_express = __toESM(require("express"), 1);
+var import_node_util = require("util");
+var import_zod = require("zod");
+
+// src/help/interior.ts
+function \u622A\u65AD\u5B57\u7B26\u4E32(\u5185\u5BB9) {
+  let \u6700\u5927\u65E5\u5FD7\u957F\u5EA6 = 1e3;
+  if (\u5185\u5BB9.length > \u6700\u5927\u65E5\u5FD7\u957F\u5EA6) return \u5185\u5BB9.slice(0, \u6700\u5927\u65E5\u5FD7\u957F\u5EA6) + "...";
+  return \u5185\u5BB9;
+}
+function \u9012\u5F52\u622A\u65AD\u5B57\u7B26\u4E32(\u6570\u636E) {
+  if (typeof \u6570\u636E === "string") return \u622A\u65AD\u5B57\u7B26\u4E32(\u6570\u636E);
+  if (Array.isArray(\u6570\u636E)) return \u6570\u636E.map((\u9879) => \u9012\u5F52\u622A\u65AD\u5B57\u7B26\u4E32(\u9879));
+  if (typeof \u6570\u636E === "object" && \u6570\u636E !== null) {
+    let \u65B0\u6570\u636E = {};
+    for (let key in \u6570\u636E) {
+      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;
+}
+
+// src/interface/interface-plugin.ts
+var \u63D2\u4EF6 = class {
+  constructor(\u9519\u8BEF\u7C7B\u578B\u63CF\u8FF02, \u6B63\u786E\u7C7B\u578B\u63CF\u8FF0, \u5B9E\u73B0) {
+    this.\u9519\u8BEF\u7C7B\u578B\u63CF\u8FF0 = \u9519\u8BEF\u7C7B\u578B\u63CF\u8FF02;
+    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);
+  }
+};
+
+// src/plugin/urlencoded.ts
+var \u9519\u8BEF\u7C7B\u578B\u63CF\u8FF0 = import_zod.z.object({ code: import_zod.z.literal(400), data: import_zod.z.string() });
+var UrlEncoded\u53C2\u6570\u89E3\u6790\u63D2\u4EF6 = class _UrlEncoded\u53C2\u6570\u89E3\u6790\u63D2\u4EF6 extends \u63D2\u4EF6 {
+  constructor(t, opt) {
+    super(\u9519\u8BEF\u7C7B\u578B\u63CF\u8FF0, import_zod.z.object({ urlencoded: t }), async (req, res, \u9644\u52A0\u53C2\u6570) => {
+      let log = \u9644\u52A0\u53C2\u6570.log.extend(_UrlEncoded\u53C2\u6570\u89E3\u6790\u63D2\u4EF6.name);
+      await new Promise(
+        (pRes, _rej) => import_express.default.urlencoded({ extended: true, ...opt })(req, res, () => {
+          pRes(null);
+        })
+      );
+      await log.debug("\u51C6\u5907\u89E3\u6790UrlEncoded\u6570\u636E\uFF1A%o", JSON.stringify(\u9012\u5F52\u622A\u65AD\u5B57\u7B26\u4E32(req.body)));
+      let parseResult = t.safeParse(req.body);
+      if (parseResult.success === false) {
+        await log.error("\u89E3\u6790UrlEncoded\u6570\u636E\u5931\u8D25\uFF1A%o", JSON.stringify(parseResult.error));
+        return new import_ts_fp_data.Left({ code: 400, data: (0, import_node_util.format)("\u89E3\u6790UrlEncoded\u6570\u636E\u5931\u8D25: %o", JSON.stringify(parseResult.error)) });
+      }
+      await log.debug("\u6210\u529F\u89E3\u6790UrlEncoded\u6570\u636E");
+      return new import_ts_fp_data.Right({ urlencoded: parseResult.data });
+    });
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  UrlEncoded\u53C2\u6570\u89E3\u6790\u63D2\u4EF6
+});

package/dist/cjs/plugin/urlencoded.d.cts

@@ -0,0 +1,36 @@
+import express from 'express';
+import { z } from 'zod';
+import { 严格递归合并对象 as ________ } from '../help/help.cjs';
+import { 获得接口逻辑插件类型 as __________ } from '../interface/interface-logic.cjs';
+import { 插件 as __, 任意插件 as ____, 取插件正确ts类型 as _____ts__ } from '../interface/interface-plugin.cjs';
+import '../types/types.cjs';
+import '@lsby/ts-log';
+import '../global/model/web-socket.cjs';
+import 'ws';
+import '../global/model/hub.cjs';
+import '@lsby/ts-fp-data';
+import '../help/interior.cjs';
+
+declare let 错误类型描述: z.ZodObject<{
+    code: z.ZodLiteral<400>;
+    data: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    code: 400;
+    data: string;
+}, {
+    code: 400;
+    data: string;
+}>;
+declare class UrlEncoded参数解析插件<Result extends z.AnyZodObject> extends __<typeof 错误类型描述, z.ZodObject<{
+    urlencoded: Result;
+}>> {
+    constructor(t: Result, opt: Parameters<typeof express.urlencoded>[0]);
+}
+type 任意UrlEncoded参数解析插件 = UrlEncoded参数解析插件<any>;
+type 任意UrlEncoded参数解析插件项 = 任意UrlEncoded参数解析插件;
+type 合并UrlEncoded参数解析插件结果<Arr extends Array<____>> = Arr extends [] ? {} : Arr extends [infer x, ...infer xs] ? x extends infer 插件项 ? xs extends Array<____> ? 插件项 extends 任意UrlEncoded参数解析插件项 ? ________<{
+    urlencoded: _____ts__<插件项>['urlencoded'];
+}, 合并UrlEncoded参数解析插件结果<xs>> : 合并UrlEncoded参数解析插件结果<xs> : {} : {} : {};
+type 计算接口逻辑UrlEncoded参数<接口逻辑> = 合并UrlEncoded参数解析插件结果<__________<接口逻辑>>;
+
+export { UrlEncoded参数解析插件, type 任意UrlEncoded参数解析插件, type 任意UrlEncoded参数解析插件项, type 合并UrlEncoded参数解析插件结果, type 计算接口逻辑UrlEncoded参数 };

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

@@ -0,0 +1,183 @@
+"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/plugin/web-socket.ts
+var web_socket_exports = {};
+__export(web_socket_exports, {
+  WebSocket\u63D2\u4EF6: () => WebSocket\u63D2\u4EF6
+});
+module.exports = __toCommonJS(web_socket_exports);
+var import_ts_fp_data = require("@lsby/ts-fp-data");
+var import_ws = require("ws");
+var import_zod = require("zod");
+
+// 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/interface/interface-plugin.ts
+var \u63D2\u4EF6 = class {
+  constructor(\u9519\u8BEF\u7C7B\u578B\u63CF\u8FF02, \u6B63\u786E\u7C7B\u578B\u63CF\u8FF0, \u5B9E\u73B0) {
+    this.\u9519\u8BEF\u7C7B\u578B\u63CF\u8FF0 = \u9519\u8BEF\u7C7B\u578B\u63CF\u8FF02;
+    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);
+  }
+};
+
+// src/plugin/web-socket.ts
+var \u9519\u8BEF\u7C7B\u578B\u63CF\u8FF0 = import_zod.z.never();
+var WebSocket\u63D2\u4EF6 = class _WebSocket\u63D2\u4EF6 extends \u63D2\u4EF6 {
+  constructor(\u540E\u63A8\u524D\u4FE1\u606F\u63CF\u8FF0, \u524D\u63A8\u540E\u4FE1\u606F\u63CF\u8FF0, wsKey = "ws-client-id") {
+    super(
+      \u9519\u8BEF\u7C7B\u578B\u63CF\u8FF0,
+      import_zod.z.object({
+        ws\u64CD\u4F5C: import_zod.z.object({
+          \u53D1\u9001ws\u4FE1\u606F: import_zod.z.function(import_zod.z.tuple([\u540E\u63A8\u524D\u4FE1\u606F\u63CF\u8FF0]), import_zod.z.promise(import_zod.z.void())),
+          \u76D1\u542Cws\u4FE1\u606F: import_zod.z.function(
+            import_zod.z.tuple([import_zod.z.function(import_zod.z.tuple([\u524D\u63A8\u540E\u4FE1\u606F\u63CF\u8FF0]), import_zod.z.promise(import_zod.z.void()))]),
+            import_zod.z.promise(import_zod.z.union([import_zod.z.instanceof(\u96C6\u7EBF\u5668\u76D1\u542C\u5668\u6301\u6709\u8005), import_zod.z.null()]))
+          ),
+          \u5173\u95EDws\u8FDE\u63A5: import_zod.z.function(import_zod.z.tuple([]), import_zod.z.promise(import_zod.z.void())),
+          \u8BBE\u7F6E\u6E05\u7406\u51FD\u6570: import_zod.z.function(import_zod.z.tuple([import_zod.z.function(import_zod.z.tuple([]), import_zod.z.promise(import_zod.z.void()))]), import_zod.z.promise(import_zod.z.void()))
+        }).or(import_zod.z.null())
+      }),
+      async (req, _res, \u9644\u52A0\u53C2\u6570) => {
+        let log = \u9644\u52A0\u53C2\u6570.log.extend(_WebSocket\u63D2\u4EF6.name);
+        let WebSocket\u7BA1\u7406\u5668 = \u9644\u52A0\u53C2\u6570.webSocket\u7BA1\u7406\u5668;
+        let ws\u53E5\u67C4 = null;
+        let wsId = req.headers[wsKey];
+        await log.debug("\u68C0\u67E5\u5934\u4FE1\u606F", { wsId });
+        if (typeof wsId !== "string") {
+          await log.error("\u672A\u80FD\u83B7\u53D6\u5230\u6709\u6548\u7684 WebSocket Id");
+          return new import_ts_fp_data.Right({ ws\u64CD\u4F5C: null });
+        }
+        await log.debug("\u5DF2\u83B7\u5F97 WebSocket Id: %o", wsId);
+        return new import_ts_fp_data.Right({
+          ws\u64CD\u4F5C: {
+            async \u53D1\u9001ws\u4FE1\u606F(\u4FE1\u606F) {
+              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;
+              }
+              if (ws\u53E5\u67C4.readyState !== import_ws.WebSocket.OPEN) {
+                await log.warn("WebSocket \u672A\u6253\u5F00\uFF0C\u65E0\u6CD5\u53D1\u9001\u6D88\u606F", { wsId });
+                return;
+              }
+              await new Promise((resolve, reject) => {
+                ws\u53E5\u67C4?.send(JSON.stringify(\u4FE1\u606F), (err) => {
+                  if (err !== void 0 && err !== null) {
+                    log.warn("\u53D1\u9001 WebSocket \u4FE1\u606F\u5931\u8D25", { \u9519\u8BEF: err }).catch((a) => `\u65E5\u5FD7\u8F93\u51FA\u9519\u8BEF: ${a}: \u65E5\u5FD7\u5185\u5BB9: ${`\u53D1\u9001 WebSocket \u4FE1\u606F\u5931\u8D25: ${err}`}`);
+                    return reject(err);
+                  }
+                  resolve();
+                });
+              });
+            },
+            async \u5173\u95EDws\u8FDE\u63A5() {
+              await log.debug("\u5173\u95ED WebSocket \u8FDE\u63A5", { wsId });
+              WebSocket\u7BA1\u7406\u5668.\u5220\u9664\u8FDE\u63A5(wsId);
+            },
+            async \u8BBE\u7F6E\u6E05\u7406\u51FD\u6570(\u6E05\u7406\u51FD\u6570) {
+              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) {
+              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;
+              }
+              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);
+            }
+          }
+        });
+      }
+    );
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WebSocket\u63D2\u4EF6
+});

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

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { 集线器监听器持有者 as _________ } from '../global/model/hub.cjs';
+import { 插件 as __, 任意插件 as ____ } from '../interface/interface-plugin.cjs';
+import '@lsby/ts-fp-data';
+import 'express';
+import '../types/types.cjs';
+import '@lsby/ts-log';
+import '../global/model/web-socket.cjs';
+import 'ws';
+
+declare let 错误类型描述: z.ZodNever;
+declare class WebSocket插件<后推前信息 extends z.AnyZodObject | z.ZodNever | z.ZodUnion<any>, 前推后信息 extends z.AnyZodObject | z.ZodNever | z.ZodUnion<any>> extends __<typeof 错误类型描述, z.ZodObject<{
+    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<[], null>, z.ZodPromise<z.ZodVoid>>;
+            设置清理函数: z.ZodFunction<z.ZodTuple<[z.ZodFunction<z.ZodTuple<[], null>, z.ZodPromise<z.ZodVoid>>], null>, z.ZodPromise<z.ZodVoid>>;
+        }>,
+        z.ZodNull
+    ]>;
+}>> {
+    constructor(后推前信息描述: 后推前信息, 前推后信息描述: 前推后信息, wsKey?: string);
+}
+type 任意WS插件 = WebSocket插件<any, any>;
+type 任意WS插件项 = 任意WS插件;
+type 取WS插件泛型<A> = A extends WebSocket插件<infer x, infer y> ? [x, y] : never;
+type 取第一个WS插件输出<Arr extends Array<____>> = Arr extends [] ? {} : Arr extends [infer x, ...infer xs] ? x extends infer 插件项 ? xs extends Array<____> ? 插件项 extends 任意WS插件项 ? z.infer<取WS插件泛型<插件项>[0]> : 取第一个WS插件输出<xs> : {} : {} : {};
+type 取第一个WS插件输入<Arr extends Array<____>> = Arr extends [] ? {} : Arr extends [infer x, ...infer xs] ? x extends infer 插件项 ? xs extends Array<____> ? 插件项 extends 任意WS插件项 ? z.infer<取WS插件泛型<插件项>[1]> : 取第一个WS插件输入<xs> : {} : {} : {};
+
+export { WebSocket插件, type 任意WS插件, type 任意WS插件项, type 取WS插件泛型, type 取第一个WS插件输入, type 取第一个WS插件输出 };