roslib-ts 0.1.0 → 1.0.0-beta.1

package/dist/index.cjs.js

@@ -61,13 +61,11 @@ class EventEmitter {
 }
 
 class Ros extends EventEmitter {
-    // private reconnectDelay = 1000;
     constructor(options = {}) {
         super();
         this.socket = null;
         this._isConnected = false;
         this.idCounter = 0;
-        this.reconnectTimer = null;
         this.options = options;
         if (options.url) {
             this.connect(options.url);
@@ -90,11 +88,6 @@ class Ros extends EventEmitter {
             this.socket.onopen = () => {
                 this._isConnected = true;
                 this.emit('connection');
-                // 清除重连定时器
-                if (this.reconnectTimer) {
-                    clearTimeout(this.reconnectTimer);
-                    this.reconnectTimer = null;
-                }
             };
             this.socket.onclose = () => {
                 this._isConnected = false;
@@ -117,10 +110,6 @@ class Ros extends EventEmitter {
             this.socket = null;
         }
         this._isConnected = false;
-        if (this.reconnectTimer) {
-            clearTimeout(this.reconnectTimer);
-            this.reconnectTimer = null;
-        }
     }
     handleMessage(data) {
         try {
@@ -166,11 +155,361 @@ class Ros extends EventEmitter {
     }
 }
 
+/**
+ * 事件发射器，用于内部实现
+ */
+/**
+ * 连接状态枚举
+ */
+exports.EnhancedRosState = void 0;
+(function (EnhancedRosState) {
+    /** 空闲/初始状态 */
+    EnhancedRosState["IDLE"] = "IDLE";
+    /** 正在连接 */
+    EnhancedRosState["CONNECTING"] = "CONNECTING";
+    /** 已连接 */
+    EnhancedRosState["CONNECTED"] = "CONNECTED";
+    /** 正在重连 */
+    EnhancedRosState["RECONNECTING"] = "RECONNECTING";
+    /** 已手动关闭 */
+    EnhancedRosState["CLOSED"] = "CLOSED";
+    /** 发生错误 */
+    EnhancedRosState["ERROR"] = "ERROR";
+})(exports.EnhancedRosState || (exports.EnhancedRosState = {}));
+/**
+ * 增强版 ROS 连接封装
+ * 支持自动重连、心跳保活、消息队列、状态管理
+ */
+class EnhancedRos extends EventEmitter {
+    /**
+     * 构造函数
+     * @param options 配置项
+     */
+    constructor(options = {}) {
+        var _a, _b, _c;
+        super();
+        /** WebSocket 实例 */
+        this.socket = null;
+        /** 自增 ID 计数器，用于请求-响应匹配 */
+        this.idCounter = 0;
+        /** 当前连接状态 */
+        this._state = exports.EnhancedRosState.IDLE;
+        /** 当前/最近一次连接地址 */
+        this.currentUrl = null;
+        /** 离线消息队列，连接成功后自动发送 */
+        this.messageQueue = [];
+        /** 重连定时器句柄 */
+        this.reconnectTimer = null;
+        /** 心跳定时器句柄 */
+        this.heartbeatTimer = null;
+        /** 最近一次收到服务端消息的时间戳 */
+        this.lastServerMessageAtMs = null;
+        /** 标记是否为用户主动关闭（影响重连策略） */
+        this.manualClose = false;
+        /** 连接代际，用于丢弃过期的重连任务 */
+        this.connectGeneration = 0;
+        this.options = options;
+        // 初始化重连退避参数
+        this.reconnectMinDelayMs = (_a = options.reconnect_min_delay) !== null && _a !== void 0 ? _a : 1000;
+        this.reconnectMaxDelayMs = (_b = options.reconnect_max_delay) !== null && _b !== void 0 ? _b : 30000;
+        this.reconnectDelayMs = this.reconnectMinDelayMs;
+        // 初始化心跳参数 开启的话12000ms，不开启0ms
+        this.heartbeatIntervalMs = (_c = options.heartbeat_interval_ms) !== null && _c !== void 0 ? _c : 0;
+        this.heartbeatFn = options.heartbeat_fn;
+        // 如果提供了 url，立即开始连接
+        if (options.url) {
+            this.connect(options.url);
+        }
+    }
+    /** 获取当前状态 */
+    get state() {
+        return this._state;
+    }
+    /** 是否已连接 */
+    get isConnected() {
+        return this._state === exports.EnhancedRosState.CONNECTED;
+    }
+    /**
+     * 建立连接（如已连接相同地址则忽略）
+     * @param url WebSocket 地址，例如 ws://localhost:9090
+     */
+    connect(url) {
+        // 避免重复连接相同地址
+        if (this.currentUrl === url &&
+            (this._state === exports.EnhancedRosState.CONNECTING || this._state === exports.EnhancedRosState.CONNECTED)) {
+            return;
+        }
+        // 进入新一轮连接生命周期
+        this.connectGeneration += 1;
+        this.cleanupForConnect();
+        this.currentUrl = url;
+        this.manualClose = false;
+        this.setState(exports.EnhancedRosState.IDLE);
+        this.setState(exports.EnhancedRosState.CONNECTING);
+        this.openSocket(url);
+    }
+    /**
+     * 手动关闭连接（不会触发自动重连）
+     */
+    close() {
+        this.connectGeneration += 1;
+        this.manualClose = true;
+        this.clearReconnectTimer();
+        this.stopHeartbeat();
+        this.messageQueue = [];
+        this.setState(exports.EnhancedRosState.CLOSED);
+        this.closeSocket();
+    }
+    /**
+     * 发送消息（离线时自动入队）
+     * @param message 任意 JSON 兼容对象
+     */
+    callOnConnection(message) {
+        if (this._state !== exports.EnhancedRosState.CONNECTED || !this.socket || this.socket.readyState !== WebSocket.OPEN) {
+            this.messageQueue.push(message);
+            return;
+        }
+        this.send(message);
+    }
+    /**
+     * 获取下一个自增 ID（字符串形式）
+     */
+    getNextId() {
+        return (++this.idCounter).toString();
+    }
+    /* ===================== 私有方法 ===================== */
+    /** 状态变更并对外广播 */
+    setState(next) {
+        if (this._state === next)
+            return;
+        this._state = next;
+        this.emit('state', next);
+    }
+    /** 连接前清理资源 */
+    cleanupForConnect() {
+        this.clearReconnectTimer();
+        this.stopHeartbeat();
+        this.closeSocket();
+        this.messageQueue = [];
+        this.reconnectDelayMs = this.reconnectMinDelayMs;
+        this.lastServerMessageAtMs = null;
+    }
+    /** 清除重连定时器 */
+    clearReconnectTimer() {
+        if (!this.reconnectTimer)
+            return;
+        clearTimeout(this.reconnectTimer);
+        this.reconnectTimer = null;
+    }
+    /** 创建并绑定 WebSocket 事件 */
+    openSocket(url) {
+        var _a, _b;
+        try {
+            const WS = (_b = (_a = this.options) === null || _a === void 0 ? void 0 : _a.WebSocket) !== null && _b !== void 0 ? _b : WebSocket;
+            this.socket = new WS(url);
+            const generation = this.connectGeneration; // 捕获当前代际
+            this.socket.onopen = () => {
+                // 连接成功，重置退避
+                this.reconnectDelayMs = this.reconnectMinDelayMs;
+                this.lastServerMessageAtMs = Date.now();
+                this.setState(exports.EnhancedRosState.CONNECTED);
+                this.emit('connection');
+                this.startHeartbeat();
+                this.flushQueue();
+            };
+            this.socket.onclose = () => {
+                if (generation !== this.connectGeneration)
+                    return;
+                console.log('socket close');
+                this.stopHeartbeat();
+                this.socket = null;
+                this.emit('close');
+                if (this.manualClose) {
+                    // 用户主动关闭，不再重连
+                    this.setState(exports.EnhancedRosState.CLOSED);
+                    return;
+                }
+                // 异常断开，进入重连逻辑
+                this.setState(exports.EnhancedRosState.RECONNECTING);
+                this.scheduleReconnect();
+            };
+            this.socket.onerror = (error) => {
+                this.emit('error', error);
+                if (!this.manualClose && this._state === exports.EnhancedRosState.CONNECTING) {
+                    // 连接阶段出错，准备重连
+                    this.setState(exports.EnhancedRosState.RECONNECTING);
+                }
+            };
+            this.socket.onmessage = (event) => {
+                this.lastServerMessageAtMs = Date.now();
+                this.handleMessage(event.data);
+            };
+        }
+        catch (error) {
+            this.emit('error', error);
+            this.setState(exports.EnhancedRosState.ERROR);
+        }
+    }
+    /** 安全关闭 WebSocket */
+    closeSocket() {
+        if (!this.socket)
+            return;
+        try {
+            this.socket.close();
+        }
+        finally {
+            this.socket = null;
+        }
+    }
+    /** 调度下一次重连（退避策略，达到最大后固定） */
+    scheduleReconnect() {
+        if (!this.currentUrl) {
+            this.setState(exports.EnhancedRosState.ERROR);
+            return;
+        }
+        const generation = this.connectGeneration;
+        const delayMs = this.reconnectDelayMs;
+        this.clearReconnectTimer();
+        this.reconnectTimer = setTimeout(() => {
+            if (this.manualClose)
+                return;
+            if (generation !== this.connectGeneration)
+                return; // 连接已过期
+            if (this._state !== exports.EnhancedRosState.RECONNECTING)
+                return;
+            if (!this.currentUrl) {
+                this.setState(exports.EnhancedRosState.ERROR);
+                return;
+            }
+            // 进入新一轮连接生命周期
+            // this.connectGeneration += 1;
+            // 不能 this.cleanupForConnect(); 
+            // 关闭定时器、清除socket在close时候已经处理； 连接上后自然会重置 this.reconnectDelayMs = this.reconnectMinDelayMs; this.lastServerMessageAtMs = null;
+            // 现在讨论是否要不要connectGeneration++ ，我认为是有必要的，每一次重连都是一个新的socket
+            // 不能 清空messageQueue，messageQueue还等着重连成功自动重发
+            this.connectGeneration += 1;
+            this.setState(exports.EnhancedRosState.CONNECTING);
+            this.openSocket(this.currentUrl);
+            // 退避：下次等待时间翻倍，直到上限后固定
+            if (this.reconnectDelayMs < this.reconnectMaxDelayMs) {
+                this.reconnectDelayMs = Math.min(this.reconnectMaxDelayMs, this.reconnectDelayMs * 2);
+            }
+            // 已达上限，保持最大延迟不变，持续重试
+        }, delayMs);
+    }
+    /** 启动心跳定时器 */
+    startHeartbeat() {
+        this.stopHeartbeat();
+        if (this.heartbeatIntervalMs <= 0)
+            return;
+        this.heartbeatTimer = setInterval(() => {
+            if (this._state !== exports.EnhancedRosState.CONNECTED)
+                return;
+            if (!this.socket || this.socket.readyState !== WebSocket.OPEN)
+                return;
+            const now = Date.now();
+            const last = this.lastServerMessageAtMs;
+            // 超过两倍心跳间隔未收到消息，认为连接失效
+            if (last && now - last > this.heartbeatIntervalMs * 2) {
+                this.setState(exports.EnhancedRosState.RECONNECTING);
+                try {
+                    this.closeSocket();
+                }
+                catch (_a) { }
+                // if (!this.reconnectTimer) {
+                //   this.scheduleReconnect();
+                // }
+                return;
+            }
+            // 发送 ping 保活
+            if (this.heartbeatFn) {
+                this.heartbeatFn();
+            }
+            else {
+                /// 默认心跳：调用 /rosapi/get_time 服务
+                this.cast({ op: "call_service", id: this.getNextId(), service: "/rosapi/get_time", type: "rosapi/GetTime", args: {} });
+            }
+        }, this.heartbeatIntervalMs);
+    }
+    /** 停止心跳定时器 */
+    stopHeartbeat() {
+        if (!this.heartbeatTimer)
+            return;
+        clearInterval(this.heartbeatTimer);
+        this.heartbeatTimer = null;
+    }
+    /** 将离线队列全部发出 */
+    flushQueue() {
+        if (this._state !== exports.EnhancedRosState.CONNECTED || !this.socket || this.socket.readyState !== WebSocket.OPEN) {
+            return;
+        }
+        if (this.messageQueue.length === 0)
+            return;
+        const pending = this.messageQueue;
+        this.messageQueue = [];
+        for (const msg of pending) {
+            this.send(msg);
+        }
+    }
+    /** 真正发送 JSON 字符串 */
+    send(message) {
+        if (!this.socket || this.socket.readyState !== WebSocket.OPEN) {
+            // 兜底：万一状态不一致，重新入队
+            this.messageQueue.push(message);
+            return;
+        }
+        const messageStr = JSON.stringify(message);
+        this.socket.send(messageStr);
+    }
+    cast(message) {
+        if (!this.socket || this.socket.readyState !== WebSocket.OPEN) {
+            return;
+        }
+        const messageStr = JSON.stringify(message);
+        this.socket.send(messageStr);
+    }
+    /** 解析并分发服务端消息 */
+    handleMessage(data) {
+        try {
+            const message = JSON.parse(data);
+            if (message.op === 'publish') {
+                // 普通话题消息
+                this.emit(message.topic, message.msg);
+            }
+            else if (message.op === 'service_response') {
+                // 服务响应，用 id 匹配请求
+                this.emit(message.id, message);
+            }
+            else if (message.op === 'status') {
+                // 状态消息，可选带 id
+                if (message.id) {
+                    this.emit('status:' + message.id, message);
+                }
+                else {
+                    this.emit('status', message);
+                }
+            }
+            else if (message.op === 'service_request') {
+                // 服务请求（作为服务端角色时）
+                this.emit('service_request:' + message.service, message);
+            }
+        }
+        catch (error) {
+            console.error('Error parsing message:', error);
+        }
+    }
+}
+
 class Topic extends EventEmitter {
     constructor(options) {
         super();
         this.isSubscribed = false;
         this.isAdvertised = false;
+        /** 内部状态处理：连接关闭时重置标志位 */
+        this._handleClose = () => {
+            this.isSubscribed = false;
+            this.isAdvertised = false;
+        };
         this.ros = options.ros;
         this.name = options.name;
         this.messageType = options.messageType;
@@ -179,72 +518,93 @@ class Topic extends EventEmitter {
         this.queue_size = options.queue_size;
         this.latch = options.latch;
         this.queue_length = options.queue_length;
+        // 预定义重连逻辑
+        this._reconnectHandler = () => {
+            if (this.isSubscribed) {
+                this._sendSubscribe();
+            }
+            if (this.isAdvertised) {
+                this._sendAdvertise();
+            }
+        };
     }
-    subscribe(callback) {
-        if (this.isSubscribed) {
-            return;
-        }
+    /** 发送底层的订阅协议包 */
+    _sendSubscribe() {
+        this.isSubscribed = true;
         const subscribeMessage = Object.assign(Object.assign(Object.assign({ op: 'subscribe', topic: this.name, type: this.messageType }, (this.compression && { compression: this.compression })), (this.throttle_rate && { throttle_rate: this.throttle_rate })), (this.queue_length && { queue_length: this.queue_length }));
         this.ros.callOnConnection(subscribeMessage);
-        this.isSubscribed = true;
-        // 监听来自 ROS 的消息
+    }
+    /** 发送底层的公告协议包 */
+    _sendAdvertise() {
+        this.isAdvertised = true;
+        const advertiseMessage = Object.assign(Object.assign({ op: 'advertise', topic: this.name, type: this.messageType }, (this.latch && { latch: this.latch })), (this.queue_size && { queue_size: this.queue_size }));
+        this.ros.callOnConnection(advertiseMessage);
+    }
+    /**
+     * 订阅话题
+     * @param callback 接收消息的回调函数
+     */
+    subscribe(callback) {
+        if (this.isSubscribed)
+            return;
+        // 1. 先尝试移除已有的监听，防止重复挂载
+        this.ros.off('connection', this._reconnectHandler);
+        this.ros.off('close', this._handleClose);
+        // 2. 挂载监听
+        this.ros.on('connection', this._reconnectHandler);
+        this.ros.on('close', this._handleClose);
+        // 3. 执行物理订阅
+        this._sendSubscribe();
+        // 4. 监听来自 ROS 的消息分发
         this.ros.on(this.name, (message) => {
             this.emit('message', message);
-            if (callback) {
+            if (callback)
                 callback(message);
-            }
-        });
-        // 监听连接关闭事件，重新订阅
-        this.ros.on('close', () => {
-            this.isSubscribed = false;
-        });
-        this.ros.on('connection', () => {
-            if (!this.isSubscribed) {
-                this.subscribe(callback);
-            }
         });
     }
+    /** 取消订阅 */
     unsubscribe() {
-        if (!this.isSubscribed) {
+        if (!this.isSubscribed)
             return;
-        }
         const unsubscribeMessage = {
             op: 'unsubscribe',
-            topic: this.name
+            topic: this.name,
         };
         this.ros.callOnConnection(unsubscribeMessage);
         this.isSubscribed = false;
-        // 移除事件监听器
+        // 彻底清理：移除重连监听和消息监听
         this.ros.off(this.name);
+        if (!this.isAdvertised) {
+            this.ros.off('connection', this._reconnectHandler);
+            this.ros.off('close', this._handleClose);
+        }
     }
+    /** 公告话题（作为发布者） */
     advertise() {
-        if (this.isAdvertised) {
+        if (this.isAdvertised)
             return;
-        }
-        const advertiseMessage = Object.assign(Object.assign({ op: 'advertise', topic: this.name, type: this.messageType }, (this.latch && { latch: this.latch })), (this.queue_size && { queue_size: this.queue_size }));
-        this.ros.callOnConnection(advertiseMessage);
-        this.isAdvertised = true;
-        // 监听连接关闭事件
-        this.ros.on('close', () => {
-            this.isAdvertised = false;
-        });
-        this.ros.on('connection', () => {
-            if (!this.isAdvertised) {
-                this.advertise();
-            }
-        });
+        this.ros.off('connection', this._reconnectHandler);
+        this.ros.on('connection', this._reconnectHandler);
+        this.ros.on('close', this._handleClose);
+        this._sendAdvertise();
     }
+    /** 取消公告 */
     unadvertise() {
-        if (!this.isAdvertised) {
+        if (!this.isAdvertised)
             return;
-        }
         const unadvertiseMessage = {
             op: 'unadvertise',
-            topic: this.name
+            topic: this.name,
         };
         this.ros.callOnConnection(unadvertiseMessage);
         this.isAdvertised = false;
+        // 如果当前也没有订阅，则可以安全移除重连处理器
+        if (!this.isSubscribed) {
+            this.ros.off('connection', this._reconnectHandler);
+            this.ros.off('close', this._handleClose);
+        }
     }
+    /** 发布消息 */
     publish(message) {
         if (!this.isAdvertised) {
             this.advertise();
@@ -252,7 +612,7 @@ class Topic extends EventEmitter {
         const publishMessage = {
             op: 'publish',
             topic: this.name,
-            msg: message
+            msg: message,
         };
         this.ros.callOnConnection(publishMessage);
     }
@@ -277,9 +637,21 @@ class Service extends EventEmitter {
     constructor(options) {
         super();
         this.isAdvertised = false;
+        /** 存储服务请求处理函数，便于卸载 */
+        this._currentServiceCallback = null;
+        /** 内部状态处理：连接关闭时重置标志位 */
+        this._handleClose = () => {
+            this.isAdvertised = false;
+        };
         this.ros = options.ros;
         this.name = options.name;
         this.serviceType = options.serviceType;
+        // 预定义重连恢复逻辑
+        this._reconnectHandler = () => {
+            if (this.isAdvertised && this._currentServiceCallback) {
+                this._sendAdvertise();
+            }
+        };
     }
     callService(request, callback, failedCallback) {
         return new Promise((resolve, reject) => {
@@ -320,18 +692,32 @@ class Service extends EventEmitter {
             this.ros.callOnConnection(serviceMessage);
         });
     }
-    advertise(callback) {
-        if (this.isAdvertised) {
-            return;
-        }
+    /** 发送底层的服务公告协议 */
+    _sendAdvertise() {
+        this.isAdvertised = true;
         const advertiseMessage = {
             op: 'advertise_service',
-            service: this.name,
-            type: this.serviceType
+            type: this.serviceType,
+            service: this.name
         };
         this.ros.callOnConnection(advertiseMessage);
-        this.isAdvertised = true;
-        // 监听服务请求
+    }
+    /**
+     * 公告服务（服务端模式）
+     * @param callback 处理请求并返回结果的回调
+     */
+    advertise(callback) {
+        if (this.isAdvertised)
+            return;
+        this._currentServiceCallback = callback;
+        // 1. 防御性卸载旧监听
+        this.ros.off('connection', this._reconnectHandler);
+        this.ros.off('close', this._handleClose);
+        this.ros.off('service_request:' + this.name);
+        // 2. 挂载生命周期监听
+        this.ros.on('connection', this._reconnectHandler);
+        this.ros.on('close', this._handleClose);
+        // 3. 监听服务请求
         this.ros.on('service_request:' + this.name, (message) => {
             const request = new ServiceRequest(message.args);
             const response = new ServiceResponse();
@@ -357,28 +743,26 @@ class Service extends EventEmitter {
                 this.ros.callOnConnection(errorMessage);
             }
         });
-        // 监听连接关闭事件
-        this.ros.on('close', () => {
-            this.isAdvertised = false;
-        });
-        this.ros.on('connection', () => {
-            if (!this.isAdvertised) {
-                this.advertise(callback);
-            }
-        });
+        // 4. 执行物理公告
+        this._sendAdvertise();
     }
+    /**
+     * 取消服务公告
+     */
     unadvertise() {
-        if (!this.isAdvertised) {
+        if (!this.isAdvertised)
             return;
-        }
         const unadvertiseMessage = {
             op: 'unadvertise_service',
             service: this.name
         };
         this.ros.callOnConnection(unadvertiseMessage);
         this.isAdvertised = false;
-        // 移除事件监听器
+        this._currentServiceCallback = null;
+        // 彻底清理资源：移除所有相关监听
         this.ros.off('service_request:' + this.name);
+        this.ros.off('connection', this._reconnectHandler);
+        this.ros.off('close', this._handleClose);
     }
 }
 
@@ -448,11 +832,219 @@ class Param {
     }
 }
 
+class TopicManager {
+    constructor(ros) {
+        this.topics = new Map();
+        this.ros = ros;
+    }
+    subscribe(name, messageType, callback) {
+        if (!this.ros) {
+            throw new Error('ros instance is not initialized');
+        }
+        if (!this.ros.isConnected) {
+            console.warn(`ROS not connected, cannot subscribe to ${name}, ${name} in messageQueue when ros reconnected`);
+        }
+        // 已存在，添加回调即可
+        if (this.topics.has(name)) {
+            const managed = this.topics.get(name);
+            managed.callbacks.add(callback);
+            return;
+        }
+        // 创建新 topic
+        const topic = new Topic({ ros: this.ros, name, messageType });
+        const callbacks = new Set();
+        callbacks.add(callback);
+        topic.subscribe((msg) => {
+            callbacks.forEach((cb) => cb(msg));
+        });
+        this.topics.set(name, { topic, callbacks, messageType });
+    }
+    unsubscribe(name, callback) {
+        const managed = this.topics.get(name);
+        if (!managed)
+            return;
+        if (callback) {
+            managed.callbacks.delete(callback);
+            // 如果没有回调了，取消订阅
+            if (managed.callbacks.size === 0) {
+                managed.topic.unsubscribe();
+                this.topics.delete(name);
+            }
+        }
+        else {
+            // 取消所有订阅
+            managed.topic.unsubscribe();
+            this.topics.delete(name);
+        }
+    }
+    clearAll() {
+        this.topics.forEach((managed) => {
+            managed.topic.unsubscribe();
+        });
+        this.topics.clear();
+    }
+    resubscribeAll(ros) {
+        this.topics.forEach((managed, name) => {
+            const topic = new Topic({ ros, name, messageType: managed.messageType });
+            managed.topic = topic;
+            topic.subscribe((msg) => {
+                managed.callbacks.forEach((cb) => cb(msg));
+            });
+        });
+    }
+    publish(name, messageType, data) {
+        if (!this.ros) {
+            throw new Error('ros instance is not initialized');
+        }
+        if (!this.ros.isConnected) {
+            console.warn(`ROS not connected, cannot publish to ${name}, ${name} in messageQueue when ros reconnected`);
+        }
+        const chatter = new Topic({
+            ros: this.ros,
+            name,
+            messageType
+        });
+        chatter.publish({ data: data });
+    }
+}
+class ServiceManager {
+    constructor(ros, timeout = 10000) {
+        this.defaultTimeout = 10000; // 默认超时 10s
+        this.ros = ros;
+        this.defaultTimeout = timeout;
+    }
+    /**
+     * 调用服务（每次直接创建 Service 实例，带统一超时）
+     */
+    call(name, serviceType, request, timeout = this.defaultTimeout) {
+        return new Promise((resolve, reject) => {
+            if (!this.ros) {
+                return reject(new Error('ros instance is not initialized'));
+            }
+            if (!this.ros.isConnected) {
+                return reject(new Error(`ROS not connected, cannot call service ${name}`));
+            }
+            let timer = null;
+            const cleanup = () => {
+                if (timer) {
+                    clearTimeout(timer);
+                    timer = null;
+                }
+            };
+            timer = setTimeout(() => {
+                cleanup();
+                reject(new Error(`Service call ${name} timeout after ${timeout}ms`));
+            }, timeout);
+            try {
+                const service = new Service({
+                    ros: this.ros,
+                    name,
+                    serviceType,
+                });
+                const serviceRequest = new ServiceRequest(request);
+                service.callService(serviceRequest, (result) => {
+                    cleanup();
+                    resolve(result);
+                }, (error) => {
+                    cleanup();
+                    reject(error);
+                });
+            }
+            catch (error) {
+                cleanup();
+                reject(error);
+            }
+        });
+    }
+}
+class ParamManager {
+    constructor(ros, timeout = 10000) {
+        this.defaultTimeout = 10000; // 默认超时 10s
+        this.ros = ros;
+        this.defaultTimeout = timeout;
+    }
+    /**
+     * 获取参数值
+     */
+    get(name, timeout = this.defaultTimeout) {
+        return new Promise((resolve, reject) => {
+            const ros = this.ros;
+            if (!this.ros) {
+                return reject(new Error('ros instance is not initialized'));
+            }
+            if (!this.ros.isConnected) {
+                return reject(new Error(`ROS not connected, cannot get param ${name}`));
+            }
+            const param = new Param({ ros, name });
+            const timer = setTimeout(() => {
+                reject(new Error(`Get param ${name} timeout`));
+            }, timeout);
+            param
+                .get((value) => {
+                clearTimeout(timer);
+                resolve(value);
+            })
+                .catch((error) => {
+                clearTimeout(timer);
+                reject(error);
+            });
+        });
+    }
+    /**
+     * 设置参数值
+     */
+    set(name, value) {
+        return new Promise((resolve, reject) => {
+            const ros = this.ros;
+            if (!this.ros) {
+                return reject(new Error('ros instance is not initialized'));
+            }
+            if (!this.ros.isConnected) {
+                return reject(new Error(`ROS not connected, cannot set param ${name}`));
+            }
+            const param = new Param({ ros, name });
+            param
+                .set(value, () => {
+                resolve();
+            })
+                .catch((error) => {
+                reject(error);
+            });
+        });
+    }
+    /**
+     * 删除参数
+     */
+    delete(name) {
+        return new Promise((resolve, reject) => {
+            const ros = this.ros;
+            if (!this.ros) {
+                return reject(new Error('ros instance is not initialized'));
+            }
+            if (!this.ros.isConnected) {
+                return reject(new Error(`ROS not connected, cannot delete param ${name}`));
+            }
+            const param = new Param({ ros, name });
+            param
+                .delete(() => {
+                resolve();
+            })
+                .catch((error) => {
+                reject(error);
+            });
+        });
+    }
+}
+
+exports.EnhancedRos = EnhancedRos;
 exports.EventEmitter = EventEmitter;
 exports.Param = Param;
+exports.ParamManager = ParamManager;
 exports.Ros = Ros;
 exports.Service = Service;
+exports.ServiceManager = ServiceManager;
 exports.ServiceRequest = ServiceRequest;
 exports.ServiceResponse = ServiceResponse;
 exports.Topic = Topic;
+exports.TopicManager = TopicManager;
 //# sourceMappingURL=index.cjs.js.map