mm_mqtt_server 1.0.1 → 1.0.2

package/README.md

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

package/index.js

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

package/lib/message.js

@@ -85,8 +85,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;
   }
@@ -164,12 +164,12 @@ class MessagePlugin {
 
   /**
    * 内置 main 钩子逻辑：优先识别客户端反馈，其次执行 RPC 请求并产出应答重发描述
-   * @param {Object} ctx 执行上下文
    * @param {Object} params 消息参数，含 client_id / topic / payload
+   * @param {Object} ctx 执行上下文
    * @param {Object} [options] 管道请求选项（连接级，如 user_id / device_id / agent_id），透传给处理函数
    * @returns {Promise<Object|undefined>} 重发描述 { topic, payload, qos, retain }；反馈、透传与无结果通知时为 undefined
    */
-  async _execute(ctx, params, options) {
+  async _execute(params, ctx, options) {
     if (this.#rpc.acceptResponse(params.payload)) return undefined;
     const extra = { client_id: params.client_id, topic: params.topic };
     const response = await this.#rpc.handle(params.payload, extra, options);

package/lib/mqtt_server.js

@@ -2,7 +2,8 @@
 
 const net = require('net');
 const { Aedes } = require('aedes');
-const { Mod, Handle, Store } = require('mm_corejs');
+const { Mod, Store } = require('mm_corejs');
+const { Handle } = require('mm_handle');
 
 /**
  * 服务器设置校验 schema（校验对象为顶层 config）
@@ -19,7 +20,7 @@ const SERVER_SCHEMA = {
 };
 
 /**
- * MqttServer —— MQTT 代理服务器（入站端口模块）。
+ * MqttServer —— MQTT 代理服务器（入站适配器模块）。
  *
  * 继承 mm_corejs 的 Mod：生命周期由 Lifecycle 模板方法驱动，
  * 调用参数校验由 config.params 声明式定义；
@@ -50,7 +51,7 @@ class MqttServer extends Mod {
    * 模块默认配置
    */
   static config = {
-    name: 'mqtt_server',
+    name: 'os',
     title: 'MQTT代理服务器模块',
     description: '基于 aedes 的 MQTT 代理：管理客户端连接、主题订阅与消息路由',
     version: '1.0.0',
@@ -92,6 +93,7 @@ class MqttServer extends Mod {
 
   /**
    * 消息处理管道（before/check/main/render/error/success/after）
+   * 每个实例独立 Handle，避免多实例共享管道导致钩子泄漏
    */
   #handle = new Handle();
 
@@ -136,12 +138,12 @@ class MqttServer 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 === 'publish') return this._actionPublish(params);
     if (action === 'close_client') return this._actionCloseClient(params);
@@ -525,7 +527,7 @@ class MqttServer extends Mod {
    * 装配内置管道钩子：main 发 message 事件保持向后兼容
    */
   _initHandle() {
-    this.#handle.on('main', (ctx, params) => {
+    this.#handle.on('main', (params, ctx) => {
       this._safeEmit('message', params.client_id, {
         topic: params.topic,
         payload: params.payload,

package/package.json

@@ -1,18 +1,21 @@
 {
   "name": "mm_mqtt_server",
-  "version": "1.0.1",
-  "description": "MQTT 代理服务器入站端口模块，基于 aedes，继承 mm_corejs 的 Mod 基类，支持独立运行。",
+  "version": "1.0.2",
+  "description": "MQTT 代理服务器入站适配器模块，基于 aedes，继承 mm_corejs 的 Mod 基类，支持独立运行。",
   "keywords": [
     "超级美眉",
-    "入站端口",
+    "入站适配器",
     "mm_mod",
-    "mm_in_port",
+    "mm_adapter",
+    "mm_in_adapter",
     "mm_receiver",
     "mqtt",
     "broker",
     "aedes",
     "server"
   ],
+  "layer": "adapter",
+  "group": "in_adapter",
   "license": "ISC",
   "author": "qww",
   "type": "commonjs",
@@ -39,7 +42,7 @@
   },
   "dependencies": {
     "aedes": "^1.2.0",
-    "mm_corejs": "^1.1.0"
+    "mm_corejs": "^1.1.4"
   },
   "devDependencies": {
     "jest": "^30.5.2"