rclnodejs 0.32.5 → 1.0.0

package/README.md

@@ -43,9 +43,9 @@ npm i rclnodejs@x.y.z
 
 #### RCLNODEJS - ROS 2 Version Compatibility
 
-|                                      RCLNODEJS Version                                       |                                                             Compatible ROS 2 LTS                                                             |
-| :------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------: |
-| latest version (currently [v0.32.5](https://github.com/RobotWebTools/rclnodejs/tree/0.32.5)) | [Humble](https://github.com/RobotWebTools/rclnodejs/tree/humble-hawksbill)<br>[Jazzy](https://github.com/RobotWebTools/rclnodejs/tree/jazzy) |
+|                                     RCLNODEJS Version                                      |                                                             Compatible ROS 2 LTS                                                             |
+| :----------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------: |
+| latest version (currently [v1.0.0](https://github.com/RobotWebTools/rclnodejs/tree/1.0.0)) | [Humble](https://github.com/RobotWebTools/rclnodejs/tree/humble-hawksbill)<br>[Jazzy](https://github.com/RobotWebTools/rclnodejs/tree/jazzy) |
 
 ## Documentation
 

package/binding.gyp

@@ -21,17 +21,31 @@
         './src/addon.cpp',
         './src/executor.cpp',
         './src/handle_manager.cpp',
-        './src/rcl_action_bindings.cpp',
+        './src/rcl_action_client_bindings.cpp',
+        './src/rcl_action_goal_bindings.cpp',
+        './src/rcl_action_server_bindings.cpp',
         './src/rcl_bindings.cpp',
+        './src/rcl_client_bindings.cpp',
+        './src/rcl_context_bindings.cpp',
+        './src/rcl_graph_bindings.cpp',
+        './src/rcl_guard_condition_bindings.cpp',
         './src/rcl_handle.cpp',
         './src/rcl_lifecycle_bindings.cpp',
+        './src/rcl_logging_bindings.cpp',
+        './src/rcl_names_bindings.cpp',
+        './src/rcl_node_bindings.cpp',
+        './src/rcl_publisher_bindings.cpp',
+        './src/rcl_service_bindings.cpp',
+        './src/rcl_subscription_bindings.cpp',
+        './src/rcl_time_point_bindings.cpp',
+        './src/rcl_timer_bindings.cpp',
         './src/rcl_utilities.cpp',
         './src/shadow_node.cpp',
       ],
       'include_dirs': [
         '.',
-        "<!(node -e \"require('nan')\")",
         '<(ros_include_root)',
+        "<!@(node -p \"require('node-addon-api').include\")",
       ],
       'cflags!': [
         '-fno-exceptions'
@@ -51,6 +65,7 @@
         '-lrcl_lifecycle',
         '-lrcutils',
         '-lrcl_yaml_param_parser',
+        '-lrcpputils',
         '-lrmw',
         '-lrosidl_runtime_c',
       ],

package/lib/client.js

@@ -147,15 +147,14 @@ class Client extends Entity {
     }
 
     let type = this.typeClass.type();
-    rclnodejs.configureServiceIntrospection(
+    rclnodejs.configureClientIntrospection(
       this.handle,
       this._nodeHandle,
       clock.handle,
       type.interfaceName,
       type.pkgName,
       qos,
-      introspectionState,
-      false
+      introspectionState
     );
   }
 }

package/lib/context.js

@@ -219,6 +219,14 @@ class Context {
     }
     return defaultContext;
   }
+
+  /**
+   * Get the domain ID of this context.
+   * @returns {Number} domain ID of this context
+   */
+  get domainId() {
+    return rclnodejs.getDomainId(this.handle);
+  }
 }
 
 Context._instances = [];

package/lib/logging.js

@@ -39,14 +39,31 @@ let LoggingSeverity = {
 
 class Caller {
   constructor() {
-    this._info = {};
-    let frame = new Error().stack.split('\n').slice(4, 5)[0];
-    let results = frame.match(/at\s+(.*)\s+\((.*):(\d*):(\d*)\)/i);
-
-    if (results && results.length === 5) {
-      this._info['functionName'] = results[1];
-      this._info['lineNumber'] = results[3];
-      this._info['fileName'] = path.basename(results[2]);
+    this._info = {
+      functionName: 'unknown',
+      fileName: 'unknown',
+      lineNumber: 'unknown',
+    };
+
+    const stackLines = new Error().stack.split('\n');
+
+    // Adjust the index (usually 3 or 4) to correctly point to the caller frame.
+    const callerFrame = stackLines[4] || stackLines[3];
+    // Match both named and anonymous function stack frames.
+    const frameRegex = /^\s*at\s+(?:(.+)\s+\()?(.+):(\d+):(\d+)\)?$/;
+    const match = callerFrame.match(frameRegex);
+    if (match && match.length === 5) {
+      this._info.functionName = match[1] || '(anonymous)';
+      this._info.fileName = path.basename(match[2]);
+      this._info.lineNumber = match[3];
+    } else {
+      // Handle anonymous functions or different stack formats.
+      const altMatch = callerFrame.match(/at\s+(.*):(\d+):(\d+)/i);
+      if (altMatch && altMatch.length >= 4) {
+        this._info.functionName = '(anonymous)';
+        this._info.fileName = path.basename(altMatch[1]);
+        this._info.lineNumber = altMatch[2];
+      }
     }
   }
 
@@ -156,7 +173,7 @@ class Logging {
       severity,
       message,
       caller.functionName,
-      caller.lineNumber,
+      parseInt(caller.lineNumber, 10),
       caller.fileName
     );
   }

package/lib/node.js

@@ -21,6 +21,7 @@ const Client = require('./client.js');
 const Clock = require('./clock.js');
 const Context = require('./context.js');
 const debug = require('debug')('rclnodejs:node');
+const DistroUtils = require('./distro.js');
 const GuardCondition = require('./guard_condition.js');
 const loader = require('./interface_loader.js');
 const Logging = require('./logging.js');
@@ -969,7 +970,7 @@ class Node extends rclnodejs.ShadowNode {
   }
 
   /**
-   * Get the list of service topics discovered by the provided node for the remote node name.
+   * Get service names and types for which a remote node has servers.
    * @param {string} nodeName - The name of the node.
    * @param {string} namespace - The name of the namespace.
    * @return {Array<{name: string, types: Array<string>}>} - An array of the names and types.
@@ -982,6 +983,20 @@ class Node extends rclnodejs.ShadowNode {
     );
   }
 
+  /**
+   * Get service names and types for which a remote node has clients.
+   * @param {string} nodeName - The name of the node.
+   * @param {string} namespace - The name of the namespace.
+   * @return {Array<{name: string, types: Array<string>}>} - An array of the names and types.
+   */
+  getClientNamesAndTypesByNode(nodeName, namespace) {
+    return rclnodejs.getClientNamesAndTypesByNode(
+      this.handle,
+      nodeName,
+      namespace
+    );
+  }
+
   /**
    * Get the list of topics discovered by the provided node.
    * @param {boolean} noDemangle - If true topic names and types returned will not be demangled, default: false.
@@ -999,6 +1014,32 @@ class Node extends rclnodejs.ShadowNode {
     return rclnodejs.getServiceNamesAndTypes(this.handle);
   }
 
+  /**
+   * Get a list of publishers on a given topic.
+   * @param {string} topic - the topic name to get the publishers for.
+   * @param {boolean} noDemangle - if `true`, `topic_name` needs to be a valid middleware topic name,
+   *       otherwise it should be a valid ROS topic name.
+   * @returns {Array} - list of publishers
+   */
+  getPublishersInfoByTopic(topic, noDemangle) {
+    return rclnodejs.getPublishersInfoByTopic(this.handle, topic, noDemangle);
+  }
+
+  /**
+   * Get a list of subscriptions on a given topic.
+   * @param {string} topic - the topic name to get the subscriptions for.
+   * @param {boolean} noDemangle - if `true`, `topic_name` needs to be a valid middleware topic name,
+   *       otherwise it should be a valid ROS topic name.
+   * @returns {Array} - list of subscriptions
+   */
+  getSubscriptionsInfoByTopic(topic, noDemangle) {
+    return rclnodejs.getSubscriptionsInfoByTopic(
+      this.handle,
+      topic,
+      noDemangle
+    );
+  }
+
   /**
    * Get the list of nodes discovered by the provided node.
    * @return {Array<string>} - An array of the names.
@@ -1047,6 +1088,32 @@ class Node extends rclnodejs.ShadowNode {
     return rclnodejs.countSubscribers(this.handle, expandedTopic);
   }
 
+  /**
+   * Get the number of clients on a given service name.
+   * @param {string} serviceName - the service name
+   * @returns {Number}
+   */
+  countClients(serviceName) {
+    if (DistroUtils.getDistroId() <= DistroUtils.getDistroId('humble')) {
+      console.warn('countClients is not supported by this version of ROS 2');
+      return null;
+    }
+    return rclnodejs.countClients(this.handle, serviceName);
+  }
+
+  /**
+   * Get the number of services on a given service name.
+   * @param {string} serviceName - the service name
+   * @returns {Number}
+   */
+  countServices(serviceName) {
+    if (DistroUtils.getDistroId() <= DistroUtils.getDistroId('humble')) {
+      console.warn('countServices is not supported by this version of ROS 2');
+      return null;
+    }
+    return rclnodejs.countServices(this.handle, serviceName);
+  }
+
   /**
    * Get the list of parameter-overrides found on the commandline and
    * in the NodeOptions.parameter_overrides property.

package/lib/publisher.js

@@ -72,6 +72,14 @@ class Publisher extends Entity {
     );
     return new Publisher(handle, typeClass, topic, options);
   }
+
+  /**
+   * Get the number of subscriptions to this publisher.
+   * @returns {number} The number of subscriptions
+   */
+  get subscriptionCount() {
+    return rclnodejs.getSubscriptionCount(this._handle);
+  }
 }
 
 module.exports = Publisher;

package/lib/service.js

@@ -138,10 +138,17 @@ class Service extends Entity {
       type.interfaceName,
       type.pkgName,
       qos,
-      introspectionState,
-      true
+      introspectionState
     );
   }
+
+  /**
+   * Get the options of this service.
+   * @return {object} The options of this service.
+   */
+  getOptions() {
+    return rclnodejs.getOptions(this._handle);
+  }
 }
 
 module.exports = Service;

package/lib/subscription.js

@@ -116,6 +116,14 @@ class Subscription extends Entity {
       ? rclnodejs.clearContentFilter(this.handle)
       : true;
   }
+
+  /**
+   * Get the number of publishers to this subscription.
+   * @returns {number} The number of publishers
+   */
+  get publisherCount() {
+    return rclnodejs.getPublisherCount(this._handle);
+  }
 }
 
 module.exports = Subscription;

package/lib/timer.js

@@ -15,6 +15,7 @@
 'use strict';
 
 const rclnodejs = require('bindings')('rclnodejs');
+const DistroUtils = require('./distro.js');
 
 /**
  * @class - Class representing a Timer in ROS
@@ -86,6 +87,37 @@ class Timer {
   timeUntilNextCall() {
     return rclnodejs.timerGetTimeUntilNextCall(this._handle);
   }
+
+  /**
+   * Change the timer period.
+   * @param {bigint} period - The new period in nanoseconds.
+   * @return {undefined}
+   */
+  changeTimerPeriod(period) {
+    rclnodejs.changeTimerPeriod(this._handle, period);
+  }
+
+  /**
+   * Get the timer period.
+   * @return {bigint} - The period in nanoseconds.
+   */
+  get timerPeriod() {
+    return rclnodejs.getTimerPeriod(this._handle);
+  }
+
+  /**
+   * Call a timer and starts counting again, retrieves actual and expected call time.
+   * @return {object} - The timer information.
+   */
+  callTimerWithInfo() {
+    if (DistroUtils.getDistroId() <= DistroUtils.getDistroId('humble')) {
+      console.warn(
+        'callTimerWithInfo is not supported by this version of ROS 2'
+      );
+      return;
+    }
+    return rclnodejs.callTimerWithInfo(this._handle);
+  }
 }
 
 module.exports = Timer;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rclnodejs",
-  "version": "0.32.5",
+  "version": "1.0.0",
   "description": "ROS2.0 JavaScript client with Node.js",
   "main": "index.js",
   "types": "types/index.d.ts",
@@ -26,7 +26,7 @@
     "docs": "cd docs && make",
     "test": "nyc node --expose-gc ./scripts/run_test.js && tsd",
     "lint": "eslint && node ./scripts/cpplint.js",
-    "format": "clang-format -i -style=file ./src/*.cpp ./src/*.hpp && npx --yes prettier --write \"{lib,rosidl_gen,rostsd_gen,rosidl_parser,types,example,test,scripts,benchmark,rostsd_gen}/**/*.{js,md,ts}\" ./*.{js,md,ts}",
+    "format": "clang-format -i -style=file ./src/*.cpp ./src/*.h && npx --yes prettier --write \"{lib,rosidl_gen,rostsd_gen,rosidl_parser,types,example,test,scripts,benchmark,rostsd_gen}/**/*.{js,md,ts}\" ./*.{js,md,ts}",
     "prepare": "husky",
     "coverage": "cat ./coverage/lcov.info | ./node_modules/coveralls/bin/coveralls.js"
   },
@@ -79,9 +79,9 @@
     "fs-extra": "^11.2.0",
     "is-close": "^1.3.3",
     "json-bigint": "^1.0.0",
-    "nan": "^2.22.0",
     "terser": "^5.39.0",
-    "walk": "^2.3.15"
+    "walk": "^2.3.15",
+    "node-addon-api": "^8.3.1"
   },
   "husky": {
     "hooks": {