mm_socket_server 1.0.1 → 1.0.2

package/README.md

@@ -1,6 +1,6 @@
 # mm_socket_server
 
-TCP/UDP 套接字服务器入站端口模块。继承 [mm_corejs](https://gitee.com/qiuwenwu91/mm_corejs) 的 `Mod` 基类，提供连接管理、消息处理管道与 JSON-RPC 2.0 消息插件，可脱离完整框架独立运行。
+TCP/UDP 套接字服务器入站适配器模块。继承 [mm_corejs](https://gitee.com/qiuwenwu91/mm_corejs) 的 `Mod` 基类，提供连接管理、消息处理管道与 JSON-RPC 2.0 消息插件，可脱离完整框架独立运行。
 
 - 入口：`index.js`（CommonJS）
 - 导出：`SocketServer`（服务器模块）、`MessagePlugin`（JSON-RPC 消息插件）

package/index.js

@@ -2,8 +2,25 @@
 
 const SocketServer = require('./lib/socket');
 const MessagePlugin = require('./lib/message');
+const Admin = require('mm_corejs').Admin;
+
+let admin = new Admin();
+admin.setClass(SocketServer);
 
 module.exports = {
   SocketServer,
-  MessagePlugin
+  MessagePlugin,
+  admin,
+  /**
+   * 获取指定作用域的 Socket 服务器
+   * @param {string} [scope='sys'] 作用域名称
+   * @param {object} [config] 配置参数
+   * @returns {SocketServer} Socket 服务器实例
+   */
+  socketServerAdmin(scope, config) {
+    if (!scope) {
+      scope = 'os';
+    }
+    return admin.get(scope, { name: scope, ...config });
+  }
 };

package/lib/message.js

@@ -50,8 +50,8 @@ class MessagePlugin {
       throw new TypeError('[MessagePlugin] server must provide getHandle()');
     }
     this.#server = server;
-    server.getHandle().on('main', (ctx, params, options) => {
-      return this._execute(ctx, params, options);
+    server.getHandle().on('main', (params, ctx, options) => {
+      return this._execute(params, ctx, options);
     }, 100, 'json_rpc');
     return this;
   }
@@ -127,7 +127,7 @@ class MessagePlugin {
    * @param {Object} [options] 管道请求选项（连接级，如 user_id / device_id / agent_id），透传给处理函数
    * @returns {Promise<Object|string|undefined>} 响应对象或 JSON 字符串；反馈、透传与无结果通知时为 undefined
    */
-  async _execute(ctx, params, options) {
+  async _execute(params, ctx, options) {
     if (this.#rpc.acceptResponse(params.data)) return undefined;
     const extra = { client_id: params.client_id };
     const response = await this.#rpc.handle(params.data, extra, options);

package/lib/socket.js

@@ -2,7 +2,8 @@
 
 const net = require('net');
 const dgram = require('dgram');
-const { Mod, Handle, Store } = require('mm_corejs');
+const { Mod, Store } = require('mm_corejs');
+const { Handle } = require('mm_handle');
 
 /**
  * 服务器设置校验 schema（校验对象为顶层 config，而非 run 时选项）
@@ -19,7 +20,7 @@ const SERVER_SCHEMA = {
 };
 
 /**
- * SocketServer —— TCP/UDP 套接字服务器（入站端口模块）。
+ * SocketServer —— TCP/UDP 套接字服务器（入站适配器模块）。
  *
  * 继承 mm_corejs 的 Mod：生命周期由 Lifecycle 模板方法驱动，
  * 调用参数校验由 config.params 声明式定义；
@@ -46,7 +47,7 @@ class SocketServer extends Mod {
    * 模块默认配置
    */
   static config = {
-    name: 'socket',
+    name: 'os',
     title: 'Socket服务器模块',
     description: 'TCP/UDP 套接字服务器，管理连接并分发消息',
     version: '1.0.0',
@@ -80,6 +81,7 @@ class SocketServer extends Mod {
 
   /**
    * 消息处理管道（before/check/main/render/error/success/after）
+   * 每个实例独立 Handle，避免多实例共享管道导致钩子泄漏
    */
   #handle = new Handle();
 
@@ -127,12 +129,12 @@ class SocketServer extends Mod {
   // ---------- 执行入口 ----------
   /**
    * 模块主逻辑：按 action 派发操作
-   * @param {Object} ctx 执行上下文
    * @param {Object} params 调用参数，含 action 及操作所需字段
+   * @param {Object} ctx 执行上下文
    * @param {Object} options 合并后的选项
    * @returns {Promise<Object>} 操作结果
    */
-  async main(ctx, params, options) {
+  async main(params, ctx, options) {
     const action = params.action;
     if (action === 'send') return this._actionSend(params);
     if (action === 'broadcast') return this._actionBroadcast(params);
@@ -532,7 +534,7 @@ class SocketServer extends Mod {
    * 不返回值，业务钩子产出的 result 由 _handleData 统一回发）
    */
   _initHandle() {
-    this.#handle.on('main', (ctx, params) => {
+    this.#handle.on('main', (params, ctx) => {
       this._safeEmit('message', params.client_id, params.data);
     }, 1000, 'emit_message');
   }

package/package.json

@@ -1,18 +1,21 @@
 {
   "name": "mm_socket_server",
-  "version": "1.0.1",
-  "description": "TCP/UDP 套接字服务器入站端口模块，继承 mm_corejs 的 Mod 基类，支持独立运行。",
+  "version": "1.0.2",
+  "description": "TCP/UDP 套接字服务器入站适配器模块，继承 mm_corejs 的 Mod 基类，支持独立运行。",
   "keywords": [
     "超级美眉",
-    "入站端口",
+    "入站适配器",
     "mm_mod",
-    "mm_in_port",
+    "mm_adapter",
+    "mm_in_adapter",
     "mm_receiver",
     "socket",
     "tcp",
     "udp",
     "server"
   ],
+  "layer": "adapter",
+  "group": "in_adapter",
   "license": "ISC",
   "author": "qww",
   "type": "commonjs",
@@ -38,7 +41,7 @@
     "test": "jest --coverage"
   },
   "dependencies": {
-    "mm_corejs": "^1.1.0"
+    "mm_corejs": "^1.1.4"
   },
   "devDependencies": {
     "jest": "^30.5.2"