rol-websocket-channel 1.4.2 → 1.4.8

package/dist/src/admin/types.js

@@ -1 +1 @@
-export {};
+export {};

package/dist/src/mqtt/connection-manager.js

@@ -1,209 +1,209 @@
-// MQTT 全局连接管理器
-// 全局共享单一连接（随机 clientId，从 topic 解析用户名，支持测试注入）
-// ─────────────────────────────────────────────
-// 全局单例连接
-// ─────────────────────────────────────────────
-let globalConnection = null;
-// ─────────────────────────────────────────────
-// 可注入的 mqtt connect 工厂（用于测试 mock）
-// ─────────────────────────────────────────────
-let _mqttConnectFn = null;
-/**
- * 注入自定义 mqtt connect 函数（测试用）
- * 传入 null 恢复默认行为（使用真实 mqtt 库）
- */
-export function _setMqttConnectFn(fn) {
-    _mqttConnectFn = fn;
-}
-async function getMqttConnect() {
-    if (_mqttConnectFn) {
-        return _mqttConnectFn;
-    }
-    const mqtt = await import("mqtt");
-    return mqtt.default.connect.bind(mqtt.default);
-}
-// ─────────────────────────────────────────────
-// 工具函数（纯函数，便于单元测试）
-// ─────────────────────────────────────────────
-/**
- * 从 MQTT topic 中解析用户名
- *
- * 模式：announcement/{user_name}/{agent_id}/...
- * 例如：announcement/0b9a784d-e044-4c6f-9024-ef8799c131d1/ce627d3d-9e22-47f7-b1c6-a6ab69570fef/bot
- *  → user_name = "0b9a784d-e044-4c6f-9024-ef8799c131d1"
- *
- * 若无法解析则返回 "default_name"
- */
-export function parseUsernameFromTopic(topic) {
-    if (!topic || typeof topic !== "string")
-        return "default_name";
-    const parts = topic.split("/");
-    if (parts[0] === "announcement" && parts[1] && parts[1].trim() !== "") {
-        return parts[1].trim();
-    }
-    return "default_name";
-}
-/**
- * 根据 topic 生成通配符订阅路径
- *
- * 若能解析到 user_name：announcement/{user_name}/#（不区分 agent_id）
- * 否则：原始 topic 末尾补 /# 若无通配符
- */
-export function getSubscribeTopic(topic) {
-    const username = parseUsernameFromTopic(topic);
-    // if (username !== "default_name") {
-    //   return `announcement/${username}/#`;
-    // }
-    // if (topic.endsWith("#")) return topic;
-    return topic;
-}
-/**
- * 生成随机 MQTT 客户端 ID
- * 格式：mqtt_client_{8位随机字符}{时间戳36进制}
- */
-export function generateClientId() {
-    const rand = Math.random().toString(36).slice(2, 10).padEnd(8, "0");
-    const ts = Date.now().toString(36);
-    return `mqtt_client_${rand}${ts}`;
-}
-// ─────────────────────────────────────────────
-// 全局连接 API
-// ─────────────────────────────────────────────
-/**
- * 获取当前全局连接（可能为 null）
- */
-export function getGlobalConnection() {
-    return globalConnection;
-}
-/**
- * 检查全局连接是否处于已连接状态
- */
-export function isGlobalConnected() {
-    return !!globalConnection?.ws?.connected;
-}
-/**
- * 创建全局 MQTT 连接（若已连接则复用）
- *
- * @param mqttUrl    Broker 地址，如 ws://192.168.1.152:8083/mqtt
- * @param mqttTopic  原始 topic，用于解析用户名和作为发布目标
- * @param callbacks  连接事件回调
- */
-export async function createGlobalMqttConnection(mqttUrl, mqttTopic, callbacks) {
-    const username = parseUsernameFromTopic(mqttTopic);
-    const subscribeTopic = getSubscribeTopic(mqttTopic);
-    const clientId = generateClientId();
-    console.log(`[MQTT] createGlobalMqttConnection: url=${mqttUrl}`);
-    console.log(`[MQTT] createGlobalMqttConnection: username=${username}, clientId=${clientId}`);
-    console.log(`[MQTT] createGlobalMqttConnection: subscribeTopic=${subscribeTopic}`);
-    // 已有活跃连接，直接复用
-    if (globalConnection?.ws?.connected) {
-        console.log("[MQTT] createGlobalMqttConnection: reusing existing active connection");
-        return globalConnection;
-    }
-    // 存在断开的旧连接，先清理
-    if (globalConnection) {
-        console.log("[MQTT] createGlobalMqttConnection: closing stale connection");
-        const stale = globalConnection;
-        globalConnection = null;
-        try {
-            stale.ws.end(true);
-        }
-        catch {
-            // ignore
-        }
-    }
-    // 获取 connect 函数（真实或 mock）
-    const mqttConnect = await getMqttConnect();
-    console.log("[MQTT] createGlobalMqttConnection: calling mqtt.connect...");
-    const client = mqttConnect(mqttUrl, {
-        clientId,
-        username,
-        reconnectPeriod: 5000, // 5 秒自动重连
-        connectTimeout: 30000, // 30 秒连接超时
-        keepalive: 30, // 30 秒心跳
-        clean: true,
-    });
-    globalConnection = {
-        ws: client,
-        topic: mqttTopic,
-        subscribeTopic,
-        username,
-    };
-    setupEventHandlers(client, subscribeTopic, callbacks);
-    console.log("[MQTT] createGlobalMqttConnection: connection object created, waiting for broker...");
-    return globalConnection;
-}
-/**
- * 关闭全局连接
- * 先置空再调用 end()，防止 close 事件同步触发时重入
- */
-export function closeGlobalConnection() {
-    if (globalConnection) {
-        console.log("[MQTT] closeGlobalConnection: force-closing...");
-        const conn = globalConnection;
-        globalConnection = null;
-        try {
-            conn.ws.end(true);
-        }
-        catch {
-            // ignore
-        }
-        console.log("[MQTT] closeGlobalConnection: done");
-    }
-    else {
-        console.log("[MQTT] closeGlobalConnection: no active connection");
-    }
-}
-/**
- * 向指定 topic 发布消息（使用全局连接）
- * @returns 发布成功返回 true，未连接返回 false
- */
-export function publishGlobalMessage(topic, message) {
-    if (!isGlobalConnected()) {
-        console.error("[MQTT] ❌ publishGlobalMessage: no connected global connection");
-        return false;
-    }
-    globalConnection.ws.publish(topic, message);
-    console.log(`[MQTT] publishGlobalMessage: published to ${topic}`);
-    return true;
-}
-// ─────────────────────────────────────────────
-// 内部：事件处理
-// ─────────────────────────────────────────────
-function setupEventHandlers(client, subscribeTopic, callbacks) {
-    const { onConnect, onDisconnect, onError, onClose, onMessage } = callbacks;
-    client.on("connect", () => {
-        console.log("[MQTT] ✅ Global connection established");
-        client.subscribe(subscribeTopic, (err) => {
-            if (err) {
-                console.error(`[MQTT] ❌ Subscribe failed: ${err.message}`);
-            }
-            else {
-                console.log(`[MQTT] ✅ Subscribed to: ${subscribeTopic}`);
-            }
-        });
-        onConnect?.();
-    });
-    client.on("message", (topic, payload) => {
-        console.log(`[MQTT] 📨 Message received on: ${topic} (${payload.length} bytes)`);
-        onMessage?.(topic, payload);
-    });
-    client.on("error", (err) => {
-        console.error(`[MQTT] ❌ Global connection error: ${err.message}`);
-        onError?.(err);
-    });
-    client.on("disconnect", () => {
-        console.log("[MQTT] 🔴 Global connection disconnected");
-        onDisconnect?.();
-    });
-    client.on("close", () => {
-        console.log("[MQTT] 🔴 Global connection closed");
-        onClose?.();
-    });
-    client.on("reconnect", () => {
-        console.log("[MQTT] 🔄 Global connection reconnecting...");
-    });
-    client.on("offline", () => {
-        console.log("[MQTT] 😴 Global connection offline");
-    });
-}
+// MQTT 全局连接管理器
+// 全局共享单一连接（随机 clientId，从 topic 解析用户名，支持测试注入）
+// ─────────────────────────────────────────────
+// 全局单例连接
+// ─────────────────────────────────────────────
+let globalConnection = null;
+// ─────────────────────────────────────────────
+// 可注入的 mqtt connect 工厂（用于测试 mock）
+// ─────────────────────────────────────────────
+let _mqttConnectFn = null;
+/**
+ * 注入自定义 mqtt connect 函数（测试用）
+ * 传入 null 恢复默认行为（使用真实 mqtt 库）
+ */
+export function _setMqttConnectFn(fn) {
+    _mqttConnectFn = fn;
+}
+async function getMqttConnect() {
+    if (_mqttConnectFn) {
+        return _mqttConnectFn;
+    }
+    const mqtt = await import("mqtt");
+    return mqtt.default.connect.bind(mqtt.default);
+}
+// ─────────────────────────────────────────────
+// 工具函数（纯函数，便于单元测试）
+// ─────────────────────────────────────────────
+/**
+ * 从 MQTT topic 中解析用户名
+ *
+ * 模式：announcement/{user_name}/{agent_id}/...
+ * 例如：announcement/0b9a784d-e044-4c6f-9024-ef8799c131d1/ce627d3d-9e22-47f7-b1c6-a6ab69570fef/bot
+ *  → user_name = "0b9a784d-e044-4c6f-9024-ef8799c131d1"
+ *
+ * 若无法解析则返回 "default_name"
+ */
+export function parseUsernameFromTopic(topic) {
+    if (!topic || typeof topic !== "string")
+        return "default_name";
+    const parts = topic.split("/");
+    if (parts[0] === "announcement" && parts[1] && parts[1].trim() !== "") {
+        return parts[1].trim();
+    }
+    return "default_name";
+}
+/**
+ * 根据 topic 生成通配符订阅路径
+ *
+ * 若能解析到 user_name：announcement/{user_name}/#（不区分 agent_id）
+ * 否则：原始 topic 末尾补 /# 若无通配符
+ */
+export function getSubscribeTopic(topic) {
+    const username = parseUsernameFromTopic(topic);
+    // if (username !== "default_name") {
+    //   return `announcement/${username}/#`;
+    // }
+    // if (topic.endsWith("#")) return topic;
+    return topic;
+}
+/**
+ * 生成随机 MQTT 客户端 ID
+ * 格式：mqtt_client_{8位随机字符}{时间戳36进制}
+ */
+export function generateClientId() {
+    const rand = Math.random().toString(36).slice(2, 10).padEnd(8, "0");
+    const ts = Date.now().toString(36);
+    return `mqtt_client_${rand}${ts}`;
+}
+// ─────────────────────────────────────────────
+// 全局连接 API
+// ─────────────────────────────────────────────
+/**
+ * 获取当前全局连接（可能为 null）
+ */
+export function getGlobalConnection() {
+    return globalConnection;
+}
+/**
+ * 检查全局连接是否处于已连接状态
+ */
+export function isGlobalConnected() {
+    return !!globalConnection?.ws?.connected;
+}
+/**
+ * 创建全局 MQTT 连接（若已连接则复用）
+ *
+ * @param mqttUrl    Broker 地址，如 ws://192.168.1.152:8083/mqtt
+ * @param mqttTopic  原始 topic，用于解析用户名和作为发布目标
+ * @param callbacks  连接事件回调
+ */
+export async function createGlobalMqttConnection(mqttUrl, mqttTopic, callbacks) {
+    const username = parseUsernameFromTopic(mqttTopic);
+    const subscribeTopic = getSubscribeTopic(mqttTopic);
+    const clientId = generateClientId();
+    console.log(`[MQTT] createGlobalMqttConnection: url=${mqttUrl}`);
+    console.log(`[MQTT] createGlobalMqttConnection: username=${username}, clientId=${clientId}`);
+    console.log(`[MQTT] createGlobalMqttConnection: subscribeTopic=${subscribeTopic}`);
+    // 已有活跃连接，直接复用
+    if (globalConnection?.ws?.connected) {
+        console.log("[MQTT] createGlobalMqttConnection: reusing existing active connection");
+        return globalConnection;
+    }
+    // 存在断开的旧连接，先清理
+    if (globalConnection) {
+        console.log("[MQTT] createGlobalMqttConnection: closing stale connection");
+        const stale = globalConnection;
+        globalConnection = null;
+        try {
+            stale.ws.end(true);
+        }
+        catch {
+            // ignore
+        }
+    }
+    // 获取 connect 函数（真实或 mock）
+    const mqttConnect = await getMqttConnect();
+    console.log("[MQTT] createGlobalMqttConnection: calling mqtt.connect...");
+    const client = mqttConnect(mqttUrl, {
+        clientId,
+        username,
+        reconnectPeriod: 5000, // 5 秒自动重连
+        connectTimeout: 30000, // 30 秒连接超时
+        keepalive: 30, // 30 秒心跳
+        clean: true,
+    });
+    globalConnection = {
+        ws: client,
+        topic: mqttTopic,
+        subscribeTopic,
+        username,
+    };
+    setupEventHandlers(client, subscribeTopic, callbacks);
+    console.log("[MQTT] createGlobalMqttConnection: connection object created, waiting for broker...");
+    return globalConnection;
+}
+/**
+ * 关闭全局连接
+ * 先置空再调用 end()，防止 close 事件同步触发时重入
+ */
+export function closeGlobalConnection() {
+    if (globalConnection) {
+        console.log("[MQTT] closeGlobalConnection: force-closing...");
+        const conn = globalConnection;
+        globalConnection = null;
+        try {
+            conn.ws.end(true);
+        }
+        catch {
+            // ignore
+        }
+        console.log("[MQTT] closeGlobalConnection: done");
+    }
+    else {
+        console.log("[MQTT] closeGlobalConnection: no active connection");
+    }
+}
+/**
+ * 向指定 topic 发布消息（使用全局连接）
+ * @returns 发布成功返回 true，未连接返回 false
+ */
+export function publishGlobalMessage(topic, message) {
+    if (!isGlobalConnected()) {
+        console.error("[MQTT] ❌ publishGlobalMessage: no connected global connection");
+        return false;
+    }
+    globalConnection.ws.publish(topic, message);
+    console.log(`[MQTT] publishGlobalMessage: published to ${topic}`);
+    return true;
+}
+// ─────────────────────────────────────────────
+// 内部：事件处理
+// ─────────────────────────────────────────────
+function setupEventHandlers(client, subscribeTopic, callbacks) {
+    const { onConnect, onDisconnect, onError, onClose, onMessage } = callbacks;
+    client.on("connect", () => {
+        console.log("[MQTT] ✅ Global connection established");
+        client.subscribe(subscribeTopic, (err) => {
+            if (err) {
+                console.error(`[MQTT] ❌ Subscribe failed: ${err.message}`);
+            }
+            else {
+                console.log(`[MQTT] ✅ Subscribed to: ${subscribeTopic}`);
+            }
+        });
+        onConnect?.();
+    });
+    client.on("message", (topic, payload) => {
+        console.log(`[MQTT] 📨 Message received on: ${topic} (${payload.length} bytes)`);
+        onMessage?.(topic, payload);
+    });
+    client.on("error", (err) => {
+        console.error(`[MQTT] ❌ Global connection error: ${err.message}`);
+        onError?.(err);
+    });
+    client.on("disconnect", () => {
+        console.log("[MQTT] 🔴 Global connection disconnected");
+        onDisconnect?.();
+    });
+    client.on("close", () => {
+        console.log("[MQTT] 🔴 Global connection closed");
+        onClose?.();
+    });
+    client.on("reconnect", () => {
+        console.log("[MQTT] 🔄 Global connection reconnecting...");
+    });
+    client.on("offline", () => {
+        console.log("[MQTT] 😴 Global connection offline");
+    });
+}

package/dist/src/mqtt/index.js

@@ -1,5 +1,5 @@
-// MQTT 模块入口
-// 导出所有 MQTT 相关的类型和功能
-export * from "./types.js";
-export * from "./connection-manager.js";
-export * from "./mqtt-client.js";
+// MQTT 模块入口
+// 导出所有 MQTT 相关的类型和功能
+export * from "./types.js";
+export * from "./connection-manager.js";
+export * from "./mqtt-client.js";

package/dist/src/mqtt/mqtt-client.js

@@ -1,110 +1,110 @@
-// MQTT 全局客户端
-// 封装全局 MQTT 连接逻辑（使用 MQTT.js 自带的重连功能）
-// 全进程共享单一连接，随机生成 clientId，从 topic 解析用户名
-import * as ConnectionManager from "./connection-manager.js";
-// ─────────────────────────────────────────────
-// GlobalMqttClient
-// ─────────────────────────────────────────────
-/**
- * 全局共享 MQTT 客户端
- *
- * 全进程只维护一个 MQTT 连接：
- *  - clientId 每次启动随机生成
- *  - MQTT username 从 mqttTopic 中解析（announcement/{user_name}/...），默认 "default_name"
- *  - 订阅通配符 topic（announcement/{user_name}/#），不区分 agent_id
- *  - 多处调用 connect() 时复用同一连接
- */
-export class GlobalMqttClient {
-    constructor(options) {
-        this.mqttUrl = options.mqttUrl;
-        this.mqttTopic = options.mqttTopic;
-        this.abortSignal = options.abortSignal;
-        this.onMessageCb = options.onMessage;
-        this.onConnectCb = options.onConnect;
-        this.onDisconnectCb = options.onDisconnect;
-        this.onErrorCb = options.onError;
-    }
-    /**
-     * 建立全局 MQTT 连接并等待 AbortSignal
-     *
-     * 若全局连接已存在且已连接则直接复用。
-     * 方法持续挂起直到 abortSignal 触发，触发后自动断开并 resolve。
-     */
-    async connect() {
-        const username = ConnectionManager.parseUsernameFromTopic(this.mqttTopic);
-        const subscribeTopic = ConnectionManager.getSubscribeTopic(this.mqttTopic);
-        console.log(`[MQTT] GlobalMqttClient.connect(): url=${this.mqttUrl}, username=${username}, subscribeTopic=${subscribeTopic}`);
-        if (this.abortSignal.aborted) {
-            console.log("[MQTT] GlobalMqttClient.connect(): aborted before starting");
-            return;
-        }
-        await ConnectionManager.createGlobalMqttConnection(this.mqttUrl, this.mqttTopic, {
-            onConnect: () => {
-                console.log("[MQTT] GlobalMqttClient: onConnect");
-                this.onConnectCb?.();
-            },
-            onDisconnect: () => {
-                console.log("[MQTT] GlobalMqttClient: onDisconnect");
-                this.onDisconnectCb?.();
-            },
-            onError: (err) => {
-                console.error(`[MQTT] GlobalMqttClient: onError - ${err.message}`);
-                this.onErrorCb?.(err);
-            },
-            onClose: () => {
-                console.log("[MQTT] GlobalMqttClient: onClose");
-                // MQTT.js 会自动重连；仅在 abort 触发时才真正清理全局连接
-                if (this.abortSignal.aborted) {
-                    ConnectionManager.closeGlobalConnection();
-                }
-            },
-            onMessage: this.onMessageCb,
-        });
-        console.log("[MQTT] GlobalMqttClient.connect(): connection created, waiting for abort signal...");
-        // 挂起，直到 AbortSignal 触发
-        await new Promise((resolve) => {
-            const handleAbort = () => {
-                console.log("[MQTT] GlobalMqttClient: abort signal received, disconnecting");
-                this.disconnect();
-                resolve();
-            };
-            this.abortSignal.addEventListener("abort", handleAbort, { once: true });
-        });
-        console.log("[MQTT] GlobalMqttClient.connect(): connection loop ended");
-    }
-    /**
-     * 手动断开全局连接
-     */
-    disconnect() {
-        console.log("[MQTT] GlobalMqttClient.disconnect(): closing global connection");
-        ConnectionManager.closeGlobalConnection();
-    }
-    /**
-     * 向指定 topic 发布消息
-     * @returns 发布成功返回 true，未连接返回 false
-     */
-    publish(topic, message) {
-        console.log(`[MQTT] GlobalMqttClient.publish(): topic=${topic}`);
-        return ConnectionManager.publishGlobalMessage(topic, message);
-    }
-    /**
-     * 检查全局连接是否处于已连接状态
-     */
-    isConnected() {
-        return ConnectionManager.isGlobalConnected();
-    }
-    /**
-     * 获取当前解析的订阅 topic（通配符形式）
-     * 例：announcement/0b9a784d-e044-4c6f-9024-ef8799c131d1/#
-     */
-    getSubscribeTopic() {
-        return ConnectionManager.getSubscribeTopic(this.mqttTopic);
-    }
-    /**
-     * 获取从 topic 中解析的用户名
-     * 例：announcement/myuser/agent/bot → "myuser"
-     */
-    getUsername() {
-        return ConnectionManager.parseUsernameFromTopic(this.mqttTopic);
-    }
-}
+// MQTT 全局客户端
+// 封装全局 MQTT 连接逻辑（使用 MQTT.js 自带的重连功能）
+// 全进程共享单一连接，随机生成 clientId，从 topic 解析用户名
+import * as ConnectionManager from "./connection-manager.js";
+// ─────────────────────────────────────────────
+// GlobalMqttClient
+// ─────────────────────────────────────────────
+/**
+ * 全局共享 MQTT 客户端
+ *
+ * 全进程只维护一个 MQTT 连接：
+ *  - clientId 每次启动随机生成
+ *  - MQTT username 从 mqttTopic 中解析（announcement/{user_name}/...），默认 "default_name"
+ *  - 订阅通配符 topic（announcement/{user_name}/#），不区分 agent_id
+ *  - 多处调用 connect() 时复用同一连接
+ */
+export class GlobalMqttClient {
+    constructor(options) {
+        this.mqttUrl = options.mqttUrl;
+        this.mqttTopic = options.mqttTopic;
+        this.abortSignal = options.abortSignal;
+        this.onMessageCb = options.onMessage;
+        this.onConnectCb = options.onConnect;
+        this.onDisconnectCb = options.onDisconnect;
+        this.onErrorCb = options.onError;
+    }
+    /**
+     * 建立全局 MQTT 连接并等待 AbortSignal
+     *
+     * 若全局连接已存在且已连接则直接复用。
+     * 方法持续挂起直到 abortSignal 触发，触发后自动断开并 resolve。
+     */
+    async connect() {
+        const username = ConnectionManager.parseUsernameFromTopic(this.mqttTopic);
+        const subscribeTopic = ConnectionManager.getSubscribeTopic(this.mqttTopic);
+        console.log(`[MQTT] GlobalMqttClient.connect(): url=${this.mqttUrl}, username=${username}, subscribeTopic=${subscribeTopic}`);
+        if (this.abortSignal.aborted) {
+            console.log("[MQTT] GlobalMqttClient.connect(): aborted before starting");
+            return;
+        }
+        await ConnectionManager.createGlobalMqttConnection(this.mqttUrl, this.mqttTopic, {
+            onConnect: () => {
+                console.log("[MQTT] GlobalMqttClient: onConnect");
+                this.onConnectCb?.();
+            },
+            onDisconnect: () => {
+                console.log("[MQTT] GlobalMqttClient: onDisconnect");
+                this.onDisconnectCb?.();
+            },
+            onError: (err) => {
+                console.error(`[MQTT] GlobalMqttClient: onError - ${err.message}`);
+                this.onErrorCb?.(err);
+            },
+            onClose: () => {
+                console.log("[MQTT] GlobalMqttClient: onClose");
+                // MQTT.js 会自动重连；仅在 abort 触发时才真正清理全局连接
+                if (this.abortSignal.aborted) {
+                    ConnectionManager.closeGlobalConnection();
+                }
+            },
+            onMessage: this.onMessageCb,
+        });
+        console.log("[MQTT] GlobalMqttClient.connect(): connection created, waiting for abort signal...");
+        // 挂起，直到 AbortSignal 触发
+        await new Promise((resolve) => {
+            const handleAbort = () => {
+                console.log("[MQTT] GlobalMqttClient: abort signal received, disconnecting");
+                this.disconnect();
+                resolve();
+            };
+            this.abortSignal.addEventListener("abort", handleAbort, { once: true });
+        });
+        console.log("[MQTT] GlobalMqttClient.connect(): connection loop ended");
+    }
+    /**
+     * 手动断开全局连接
+     */
+    disconnect() {
+        console.log("[MQTT] GlobalMqttClient.disconnect(): closing global connection");
+        ConnectionManager.closeGlobalConnection();
+    }
+    /**
+     * 向指定 topic 发布消息
+     * @returns 发布成功返回 true，未连接返回 false
+     */
+    publish(topic, message) {
+        console.log(`[MQTT] GlobalMqttClient.publish(): topic=${topic}`);
+        return ConnectionManager.publishGlobalMessage(topic, message);
+    }
+    /**
+     * 检查全局连接是否处于已连接状态
+     */
+    isConnected() {
+        return ConnectionManager.isGlobalConnected();
+    }
+    /**
+     * 获取当前解析的订阅 topic（通配符形式）
+     * 例：announcement/0b9a784d-e044-4c6f-9024-ef8799c131d1/#
+     */
+    getSubscribeTopic() {
+        return ConnectionManager.getSubscribeTopic(this.mqttTopic);
+    }
+    /**
+     * 获取从 topic 中解析的用户名
+     * 例：announcement/myuser/agent/bot → "myuser"
+     */
+    getUsername() {
+        return ConnectionManager.parseUsernameFromTopic(this.mqttTopic);
+    }
+}