Integrate rclnodejs/ref-napi into rclnodejs (#1285)

This PR integrates the `ref-napi` package directly into the rclnodejs native module as a third-party dependency, eliminating the need for separate npm package installation.

- Vendors the ref-napi package into `third_party/ref-napi/` directory
- Adds native C++ bindings integration into the main addon module
- Updates all module references to use the vendored version instead of external package

Fix: #1284

Author: minggangw

binding.gyp

@@ -42,9 +42,11 @@
         './src/rcl_timer_bindings.cpp',
         './src/rcl_utilities.cpp',
         './src/shadow_node.cpp',
+        './third_party/ref-napi/src/ref_napi_bindings.cpp',
       ],
       'include_dirs': [
         '.',
+        './third_party/ref-napi/src',
         '<(ros_include_root)',
         "<!@(node -p \"require('node-addon-api').include\")",
       ],

package.json

@@ -72,7 +72,6 @@
   },
   "dependencies": {
     "@rclnodejs/ref-array-di": "^1.2.2",
-    "@rclnodejs/ref-napi": "^4.0.0",
     "@rclnodejs/ref-struct-di": "^1.1.1",
     "bindings": "^1.5.0",
     "compare-versions": "^6.1.1",

rosidl_gen/primitive_types.js

@@ -14,7 +14,7 @@
 
 'use strict';
 
-const ref = require('@rclnodejs/ref-napi');
+const ref = require('../third_party/ref-napi');
 const StructType = require('@rclnodejs/ref-struct-di')(ref);
 const rclnodejs = require('bindings')('rclnodejs');
 

rosidl_gen/templates/message.dot

@@ -226,7 +226,7 @@ function extractMemberNames(fields) {
 {{? willUseTypedArray}}
 const rclnodejs = require('bindings')('rclnodejs');
 {{?}}
-const ref = require('@rclnodejs/ref-napi');
+const ref = require('../../third_party/ref-napi');
 const StructType = require('@rclnodejs/ref-struct-di')(ref);
 const ArrayType = require('@rclnodejs/ref-array-di')(ref);
 const primitiveTypes = require('../../rosidl_gen/primitive_types.js');

src/addon.cpp

@@ -40,6 +40,7 @@
 #include "rcl_type_description_service_bindings.h"
 #endif
 #include "rcl_utilities.h"
+#include "ref_napi_bindings.h"
 #include "shadow_node.h"
 
 bool IsRunningInElectronRenderer(const Napi::Env& env) {
@@ -93,6 +94,8 @@ Napi::Object InitModule(Napi::Env env, Napi::Object exports) {
   rclnodejs::ShadowNode::Init(env, exports);
   rclnodejs::RclHandle::Init(env, exports);
 
+  exports.Set("ref", rclnodejs::InitRefNapi(env));
+
 #ifdef DEBUG_ON
   int result = rcutils_logging_set_logger_level(PACKAGE_NAME,
                                                 RCUTILS_LOG_SEVERITY_DEBUG);

third_party/ref-napi/index.js

@@ -0,0 +1,15 @@
+// Copyright (c) 2025, The Robot Web Tools Contributors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+module.exports = require('./lib/ref');