mm_socket_server 1.0.2 → 3.0.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mm_socket_server",
-  "version": "1.0.2",
-  "description": "TCP/UDP 套接字服务器入站适配器模块，继承 mm_corejs 的 Mod 基类，支持独立运行。",
+  "version": "3.0.0",
+  "description": "最薄的 TCP/UDP 套接字服务器入站适配器：按 topic 分帧后直达 mm_event 事件管理器，不做路由与插件。",
   "keywords": [
     "超级美眉",
     "入站适配器",
@@ -22,7 +22,8 @@
   "main": "index.js",
   "files": [
     "index.js",
-    "lib"
+    "lib",
+    "example"
   ],
   "engines": {
     "node": ">=22.5.0"
@@ -38,12 +39,11 @@
   "scripts": {
     "start": "node example/demo.js",
     "demo": "node example/demo.js",
-    "test": "jest --coverage"
+    "test": "node --test \"test/*.test.js\""
   },
   "dependencies": {
-    "mm_corejs": "^1.1.4"
-  },
-  "devDependencies": {
-    "jest": "^30.5.2"
+    "mm_corejs": "^1.1.4",
+    "mm_event": "^2.2.2",
+    "mm_mod": "^1.0.1"
   }
 }

package/lib/message.js

@@ -1,150 +0,0 @@
-'use strict';
-
-const { JsonRpc } = require('mm_corejs');
-
-/**
- * MessagePlugin —— JSON-RPC 2.0 消息插件（mm_socket_server 的可选业务组件）。
- *
- * 职责：
- *   1. 方法表：内部持有 JsonRpc 核心，addMethod / delMethod / listMethods 登记可调用方法；
- *   2. 管道挂载：bind(socket) 后向消息管道注册 main 钩子 "json_rpc"（sort 100，
- *      先于内置 emit_message 执行），命中 JSON-RPC 请求时以响应对象作为管道 result，
- *      由 SocketServer 自动回发来源客户端；
- *   3. 通知回推：通知（无 id）处理函数返回非 undefined 结果时，产出服务器发起的
- *      通知对象 { jsonrpc, method, params: result } 回推来源客户端；无结果或出错时
- *      不产出；非 JSON-RPC 消息（解析失败、缺 jsonrpc 字段）透传，控制权交还管道；
- *   4. 主动推送：push(client_id, data) 委托 SocketServer.send，处理函数或服务器代码
- *      可在任意时刻（如异步任务完成后）向指定客户端回推结果；
- *   5. 反向调用：call(client_id, method, params, options) 向客户端发起 JSON-RPC 请求
- *      并等待其反馈；入站消息为响应形态（含 result/error、无 method）时被优先识别
- *      并结算待响应调用，实现服务器实时调用客户端方法；
- *   6. 编码适配：json 模式产出对象（由 send 序列化），文本模式字符串原样、其余 JSON 序列化。
- *
- * 用法：
- *   const socket = new SocketServer({ name: 'socket', port: 9100, json: true }, server);
- *   const rpc = new MessagePlugin();
- *   socket.use(rpc);
- *   rpc.addMethod('echo', (params) => params);
- *   await socket.init();
- *   await socket.start();
- */
-class MessagePlugin {
-  /**
-   * JSON-RPC 协议核心
-   */
-  #rpc = new JsonRpc();
-
-  /**
-   * 已挂载的 SocketServer 实例，未挂载时为 null
-   */
-  #server = null;
-
-  /**
-   * 挂载到 SocketServer 的消息管道，注册内置 main 钩子
-   * @param {Object} server 具备 getHandle() 的 SocketServer 实例
-   * @returns {MessagePlugin} 当前实例
-   * @throws {TypeError} server 不具备 getHandle 方法时
-   */
-  bind(server) {
-    if (!server || typeof server.getHandle !== 'function') {
-      throw new TypeError('[MessagePlugin] server must provide getHandle()');
-    }
-    this.#server = server;
-    server.getHandle().on('main', (params, ctx, options) => {
-      return this._execute(params, ctx, options);
-    }, 100, 'json_rpc');
-    return this;
-  }
-
-  /**
-   * 判断是否已挂载
-   * @returns {boolean} 是否已挂载到 SocketServer
-   */
-  isBound() {
-    return this.#server !== null;
-  }
-
-  /**
-   * 登记 RPC 方法
-   * @param {string} name 方法名
-   * @param {Function} handler 处理函数，签名 handler(params, extra, options)，extra 含 client_id，options 为管道请求选项
-   * @returns {MessagePlugin} 当前实例
-   */
-  addMethod(name, handler) {
-    this.#rpc.addMethod(name, handler);
-    return this;
-  }
-
-  /**
-   * 删除 RPC 方法
-   * @param {string} name 方法名
-   * @returns {boolean} 是否删除成功
-   */
-  delMethod(name) {
-    return this.#rpc.delMethod(name);
-  }
-
-  /**
-   * 列出 RPC 方法（支持 Store 条件查询与分页）
-   * @param {Object} [query] 查询条件，缺省时列出全部
-   * @returns {Array<Object>} 方法列表，含 name
-   */
-  listMethods(query) {
-    return this.#rpc.listMethods(query);
-  }
-
-  /**
-   * 主动推送：向指定客户端回推数据（可用于异步任务完成后通知）
-   * @param {string} client_id 目标客户端 ID
-   * @param {string|Object} data 待推送数据，对象时按编码模式序列化
-   * @returns {boolean} 是否发送成功
-   * @throws {Error} 插件尚未挂载到服务器时
-   */
-  push(client_id, data) {
-    if (!this.#server) throw new Error('[MessagePlugin] not bound to a server');
-    const payload = this._format(data);
-    return this.#server.send(client_id, payload);
-  }
-
-  /**
-   * 实时调用客户端方法：发送 JSON-RPC 请求并等待客户端反馈 result
-   * @param {string} client_id 目标客户端 ID
-   * @param {string} method 客户端方法名
-   * @param {*} [params] 调用参数
-   * @param {Object} [options] 选项，含 timeout_ms（缺省 30000，0 为不超时）
-   * @returns {Promise<*>} 客户端反馈的 result；错误响应、送达失败或超时时 reject
-   * @throws {Error} 插件尚未挂载到服务器时
-   */
-  call(client_id, method, params, options = {}) {
-    if (!this.#server) throw new Error('[MessagePlugin] not bound to a server');
-    return this.#rpc.call((request) => this.#server.send(client_id, this._format(request)), method, params, options);
-  }
-
-  /**
-   * 内置 main 钩子逻辑：优先识别客户端反馈，其次执行 RPC 请求并格式化响应
-   * @param {Object} ctx 执行上下文
-   * @param {Object} params 消息参数，含 client_id 与 data
-   * @param {Object} [options] 管道请求选项（连接级，如 user_id / device_id / agent_id），透传给处理函数
-   * @returns {Promise<Object|string|undefined>} 响应对象或 JSON 字符串；反馈、透传与无结果通知时为 undefined
-   */
-  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);
-    if (response === undefined) return undefined;
-    return this._format(response);
-  }
-
-  /**
-   * 按服务器 json 配置格式化数据
-   * @param {Object|string} data 响应对象或待推送数据
-   * @returns {Object|string} json 模式返回原值，文本模式字符串原样、其余 JSON 序列化
-   */
-  _format(data) {
-    if (this.#server.config.json) return data;
-    if (typeof data === 'string') return data;
-    return JSON.stringify(data);
-  }
-}
-
-module.exports = MessagePlugin;