rclnodejs 0.22.3 → 0.23.0

package/README.md

@@ -1,4 +1,4 @@
-# rclnodejs [![Build Status](https://travis-ci.org/RobotWebTools/rclnodejs.svg?branch=develop)](https://travis-ci.org/RobotWebTools/rclnodejs)
+# rclnodejs ![GitHub Workflow Status](https://github.com/RobotWebTools/rclnodejs/actions/workflows/linux-build-and-test.yml/badge.svg?branch=iron-irwini)
 
 `rclnodejs` is a Node.js client for the Robot Operating System (ROS 2). It provides a simple and easy JavaScript API for ROS 2 programming. TypeScript declarations are included to support use of rclnodejs in TypeScript projects.
 
@@ -18,7 +18,7 @@ rclnodejs.init().then(() => {
 
 **Node.js**
 
-- [Node.js](https://nodejs.org/en/) version between 10.23 - 17.x.
+- [Node.js](https://nodejs.org/en/) version >= 16.13.0.
 
 **ROS 2 SDK**
 
@@ -43,14 +43,13 @@ npm i rclnodejs@x.y.z
 
 #### RCLNODEJS - ROS 2 Version Compatibility
 
-|                                                            RCLNODEJS Version                                                            |                                                                                                                                                                     Compatible ROS 2 Release                                                                                                                                                                     |
-| :-------------------------------------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
-| [0.21.4 (current)](https://www.npmjs.com/package/rclnodejs/v/0.21.4) ([API](http://robotwebtools.org/rclnodejs/docs/0.21.3/index.html)) | [Humble Hawksbill](https://github.com/ros2/ros2/releases/tag/release-humble-20220523)<br>[Galactic Geochelone](https://github.com/ros2/ros2/releases/tag/release-galactic-20210716)<br>[Foxy Fitzroy](https://github.com/ros2/ros2/releases/tag/release-foxy-20201211)<br>[Eloquent Elusor](https://github.com/ros2/ros2/releases/tag/release-eloquent-20200124) |
-|                                [0.10.3](https://github.com/RobotWebTools/rclnodejs/releases/tag/0.10.3)                                 |                                                                                                                                [Dashing Diademata - Patch 4](https://github.com/ros2/ros2/releases/tag/release-dashing-20191018)                                                                                                                                 |
+|                                      RCLNODEJS Version                                       |                                                               Compatible ROS 2 LTS                                                                |
+| :------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------: |
+| latest version (currently [v0.22.3](https://github.com/RobotWebTools/rclnodejs/tree/0.22.3)) | [Humble](https://github.com/RobotWebTools/rclnodejs/tree/humble-hawksbill)<br>[Iron](https://github.com/RobotWebTools/rclnodejs/tree/iron-irwini) |
 
 ## Documentation
 
-API [documentation](http://robotwebtools.org/rclnodejs/docs/index.html) is available online.
+API [documentation](https://robotwebtools.github.io/rclnodejs/docs/index.html) is available online.
 
 ## JavaScript Examples
 

package/index.js

@@ -52,6 +52,7 @@ const {
   getActionServerNamesAndTypesByNode,
   getActionNamesAndTypes,
 } = require('./lib/action/graph.js');
+const ServiceIntrospectionStates = require('./lib/service_introspection.js');
 
 /**
  * Get the version of the generator that was used for the currently present interfaces.
@@ -143,6 +144,9 @@ let rcl = {
   /** {@link ROSClock} class */
   ROSClock: ROSClock,
 
+  /** {@link ServiceIntrospectionStates} */
+  ServiceIntrospectionStates: ServiceIntrospectionStates,
+
   /** {@link Time} class */
   Time: Time,
 

package/lib/client.js

@@ -15,6 +15,7 @@
 'use strict';
 
 const rclnodejs = require('bindings')('rclnodejs');
+const DistroUtils = require('./distro.js');
 const Entity = require('./entity.js');
 const debug = require('debug')('rclnodejs:client');
 
@@ -129,6 +130,33 @@ class Client extends Entity {
   get serviceName() {
     return this._serviceName;
   }
+
+  /**
+   * Configure introspection.
+   * @param {Clock} clock - Clock to use for service event timestamps
+   * @param {QoS} qos - QoSProfile for the service event publisher
+   * @param {ServiceIntrospectionState} introspectionState - State to set introspection to
+   */
+  configureIntrospection(clock, qos, introspectionState) {
+    if (DistroUtils.getDistroId() <= DistroUtils.getDistroId('humble')) {
+      console.warn(
+        'Service introspection is not supported by this versionof ROS 2'
+      );
+      return;
+    }
+
+    let type = this.typeClass.type();
+    rclnodejs.configureServiceIntrospection(
+      this.handle,
+      this._nodeHandle,
+      clock.handle,
+      type.interfaceName,
+      type.pkgName,
+      qos,
+      introspectionState,
+      false
+    );
+  }
 }
 
 module.exports = Client;

package/lib/lifecycle.js

@@ -308,6 +308,7 @@ class LifecycleNode extends Node {
       'srv_get_state'
     );
     let service = new Service(
+      this.handle,
       srvHandleObj.handle,
       srvHandleObj.name,
       loader.loadInterface('lifecycle_msgs/srv/GetState'),
@@ -321,6 +322,7 @@ class LifecycleNode extends Node {
       'srv_get_available_states'
     );
     service = new Service(
+      this.handle,
       srvHandleObj.handle,
       srvHandleObj.name,
       loader.loadInterface('lifecycle_msgs/srv/GetAvailableStates'),
@@ -334,6 +336,7 @@ class LifecycleNode extends Node {
       'srv_get_available_transitions'
     );
     service = new Service(
+      this.handle,
       srvHandleObj.handle,
       srvHandleObj.name,
       loader.loadInterface('lifecycle_msgs/srv/GetAvailableTransitions'),
@@ -347,6 +350,7 @@ class LifecycleNode extends Node {
       'srv_change_state'
     );
     service = new Service(
+      this.handle,
       srvHandleObj.handle,
       srvHandleObj.name,
       loader.loadInterface('lifecycle_msgs/srv/ChangeState'),
@@ -354,7 +358,6 @@ class LifecycleNode extends Node {
       (request, response) => this._onChangeState(request, response)
     );
     this._services.push(service);
-
     this.syncHandles();
   }
 

package/lib/node_options.js

@@ -88,7 +88,7 @@ class NodeOptions {
   /**
    * Get the automaticallyDeclareParametersFromOverrides.
    *
-   * @returns {boolean} - True indicates that a node shold declare declare parameters from
+   * @returns {boolean} - True indicates that a node should declare parameters from
    *    it's parameter-overrides
    */
   get automaticallyDeclareParametersFromOverrides() {

package/lib/service.js

@@ -15,6 +15,7 @@
 'use strict';
 
 const rclnodejs = require('bindings')('rclnodejs');
+const DistroUtils = require('./distro.js');
 const Entity = require('./entity.js');
 const debug = require('debug')('rclnodejs:service');
 
@@ -63,8 +64,9 @@ class Response {
  */
 
 class Service extends Entity {
-  constructor(handle, serviceName, typeClass, options, callback) {
+  constructor(nodeHandle, handle, serviceName, typeClass, options, callback) {
     super(handle, typeClass, options);
+    this._nodeHandle = nodeHandle;
     this._callback = callback;
   }
 
@@ -95,7 +97,14 @@ class Service extends Entity {
       type.pkgName,
       options.qos
     );
-    return new Service(handle, serviceName, typeClass, options, callback);
+    return new Service(
+      nodeHandle,
+      handle,
+      serviceName,
+      typeClass,
+      options,
+      callback
+    );
   }
 
   /**
@@ -105,6 +114,33 @@ class Service extends Entity {
     const fullServiceName = rclnodejs.getServiceName(this._handle); // returns /my_node/myservice
     return fullServiceName.split('/').pop();
   }
+
+  /**
+   * Configure introspection.
+   * @param {Clock} clock - Clock to use for service event timestamps
+   * @param {QoS} qos - QoSProfile for the service event publisher
+   * @param {ServiceIntrospectionState} introspectionState - State to set introspection to
+   */
+  configureIntrospection(clock, qos, introspectionState) {
+    if (DistroUtils.getDistroId() <= DistroUtils.getDistroId('humble')) {
+      console.warn(
+        'Service introspection is not supported by this versionof ROS 2'
+      );
+      return;
+    }
+
+    let type = this.typeClass.type();
+    rclnodejs.configureServiceIntrospection(
+      this.handle,
+      this._nodeHandle,
+      clock.handle,
+      type.interfaceName,
+      type.pkgName,
+      qos,
+      introspectionState,
+      true
+    );
+  }
 }
 
 module.exports = Service;

package/lib/service_introspection.js

@@ -0,0 +1,30 @@
+// Copyright (c) 2023 Wayne Parrott. All rights reserved.
+//
+// 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.
+
+/**
+ * @typedef {number} ServiceIntrospectionState
+ **/
+
+/**
+ * Enum for service introspection states.
+ * @readonly
+ * @enum {ServiceIntrospectionState}
+ */
+const ServiceIntrospectionStates = {
+  OFF: 0,
+  METADATA: 1,
+  CONTENTS: 2,
+};
+
+module.exports = ServiceIntrospectionStates;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rclnodejs",
-  "version": "0.22.3",
+  "version": "0.23.0",
   "description": "ROS2.0 JavaScript client with Node.js",
   "main": "index.js",
   "types": "types/index.d.ts",
@@ -42,44 +42,44 @@
     "url": "git+https://github.com/RobotWebTools/rclnodejs.git"
   },
   "devDependencies": {
-    "@babel/eslint-parser": "^7.12.1",
-    "@typescript-eslint/eslint-plugin": "^4.5.0",
-    "@typescript-eslint/parser": "^4.5.0",
+    "@babel/eslint-parser": "^7.22.15",
+    "@typescript-eslint/eslint-plugin": "^6.6.0",
+    "@typescript-eslint/parser": "^6.6.0",
     "babel-eslint": "^10.1.0",
-    "clang-format": "^1.4.0",
-    "commander": "^6.0.0",
+    "clang-format": "^1.8.0",
+    "commander": "^11.0.0",
     "deep-equal": "^1.1.1",
-    "eslint": "^7.5.0",
-    "eslint-config-prettier": "^6.11.0",
-    "eslint-plugin-prettier": "^3.1.4",
-    "husky": "^4.2.5",
-    "jsdoc": "^3.6.7",
-    "lint-staged": "^10.2.11",
+    "eslint": "^8.49.0",
+    "eslint-config-prettier": "^9.0.0",
+    "eslint-plugin-prettier": "^5.0.0",
+    "husky": "^8.0.3",
+    "jsdoc": "^4.0.2",
+    "lint-staged": "^14.0.1",
     "mocha": "^10.2.0",
-    "prettier": "^2.0.5",
-    "rimraf": "^3.0.2",
-    "sinon": "^9.0.2",
+    "prettier": "^3.0.3",
+    "rimraf": "^5.0.1",
+    "sinon": "^15.2.0",
     "tree-kill": "^1.2.2",
-    "typescript": "^4.0.3"
+    "typescript": "^4.9.3"
   },
   "dependencies": {
     "@rclnodejs/ref-array-di": "^1.2.2",
     "@rclnodejs/ref-napi": "^4.0.0",
     "@rclnodejs/ref-struct-di": "^1.1.1",
-    "array.prototype.flat": "^1.2.4",
+    "array.prototype.flat": "^1.3.2",
     "bindings": "^1.5.0",
-    "compare-versions": "^3.6.0",
-    "debug": "^4.1.1",
+    "compare-versions": "^6.1.0",
+    "debug": "^4.3.4",
     "dot": "^1.1.3",
     "dtslint": "^4.2.1",
-    "fs-extra": "^10.0.0",
+    "fs-extra": "^11.1.1",
     "int64-napi": "^1.0.2",
     "is-close": "^1.3.3",
-    "mkdirp": "^1.0.4",
+    "mkdirp": "^3.0.1",
     "mz": "^2.7.0",
-    "nan": "^2.14.2",
-    "uuid": "^8.2.0",
-    "walk": "^2.3.14"
+    "nan": "^2.17.0",
+    "uuid": "^9.0.0",
+    "walk": "^2.3.15"
   },
   "husky": {
     "hooks": {

package/rosidl_gen/idl_generator.js

@@ -19,6 +19,7 @@ const fse = require('fs-extra');
 const path = require('path');
 const parser = require('../rosidl_parser/rosidl_parser.js');
 const actionMsgs = require('./action_msgs.js');
+const DistroUtils = require('../lib/distro.js');
 
 dot.templateSettings.strip = false;
 dot.log = process.env.RCLNODEJS_LOG_VERBOSE || false;
@@ -42,7 +43,7 @@ async function writeGeneratedCode(dir, fileName, code) {
   await fse.writeFile(path.join(dir, fileName), code);
 }
 
-function generateServiceJSStruct(serviceInfo, dir) {
+async function generateServiceJSStruct(serviceInfo, dir) {
   dir = path.join(dir, `${serviceInfo.pkgName}`);
   const fileName =
     serviceInfo.pkgName +
@@ -51,10 +52,29 @@ function generateServiceJSStruct(serviceInfo, dir) {
     '__' +
     serviceInfo.interfaceName +
     '.js';
-  const generatedCode = removeEmptyLines(
+  const generatedSrvCode = removeEmptyLines(
     dots.service({ serviceInfo: serviceInfo })
   );
-  return writeGeneratedCode(dir, fileName, generatedCode);
+  let result = writeGeneratedCode(dir, fileName, generatedSrvCode);
+
+  if (DistroUtils.getDistroId() <= DistroUtils.getDistroId('humble')) {
+    return result;
+  }
+
+  // Otherwise, for post-Humble ROS 2 releases generate service_event msgs
+  await result;
+  const eventFileName =
+    serviceInfo.pkgName +
+    '__' +
+    serviceInfo.subFolder +
+    '__' +
+    serviceInfo.interfaceName +
+    '_Event.js';
+  const generatedSrvEventCode = removeEmptyLines(
+    dots.service_event({ serviceInfo: serviceInfo })
+  );
+
+  return writeGeneratedCode(dir, eventFileName, generatedSrvEventCode);
 }
 
 async function generateMessageJSStruct(messageInfo, dir) {

package/rosidl_gen/templates/service_event.dot

@@ -0,0 +1,304 @@
+// This file is automatically generated by Intel rclnodejs
+//
+// *** DO NOT EDIT directly
+//
+'use strict';
+
+{{
+  const interfaceName = it.serviceInfo.interfaceName;
+  const pkgName = it.serviceInfo.pkgName;
+  const subFolder = it.serviceInfo.subFolder;
+
+  const baseName = it.serviceInfo.pkgName + '__' + it.serviceInfo.subFolder + '__' + it.serviceInfo.interfaceName;
+}}
+
+const ref = require('@rclnodejs/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');
+const deallocator = require('../../rosidl_gen/deallocator.js');
+const translator = require('../../rosidl_gen/message_translator.js');
+const ServiceEventInfoWrapper = require('../service_msgs/service_msgs__msg__ServiceEventInfo.js');
+const {{=interfaceName}}_RequestWrapper = require('./{{=pkgName}}__{{=subFolder}}__{{=interfaceName}}_Request.js');
+const {{=interfaceName}}_ResponseWrapper = require('./{{=pkgName}}__{{=subFolder}}__{{=interfaceName}}_Response.js');
+const {{=interfaceName}}_EventRefStruct = StructType({
+  info: ServiceEventInfoWrapper.refObjectType,
+  request: {{=interfaceName}}_RequestWrapper.refObjectArrayType,
+  response: {{=interfaceName}}_ResponseWrapper.refObjectArrayType,
+});
+const {{=interfaceName}}_EventRefArray = ArrayType({{=interfaceName}}_EventRefStruct);
+const {{=interfaceName}}_EventRefStructArray = StructType({
+  data: {{=interfaceName}}_EventRefArray,
+  size: ref.types.size_t,
+  capacity: ref.types.size_t
+});
+// Define the wrapper class.
+class {{=interfaceName}}_EventWrapper {
+  constructor(other) {
+    this._wrapperFields = {};
+    if (typeof other === 'object' && other._refObject) {
+      this._refObject = new {{=interfaceName}}_EventRefStruct(other._refObject.toObject());
+      this._wrapperFields.info =  new ServiceEventInfoWrapper(other._wrapperFields.info);
+      this._wrapperFields.request = {{=interfaceName}}_RequestWrapper.createArray();
+      this._wrapperFields.request.copy(other._wrapperFields.request);
+      this._wrapperFields.response = {{=interfaceName}}_ResponseWrapper.createArray();
+      this._wrapperFields.response.copy(other._wrapperFields.response);
+    } else if (typeof other !== 'undefined') {
+      this._initMembers();
+      translator.constructFromPlanObject(this, other);
+    } else {
+      this._initMembers();
+    }
+    this.freeze();
+  }
+  _initMembers() {
+    this._refObject = new {{=interfaceName}}_EventRefStruct();
+    this._wrapperFields.info = new ServiceEventInfoWrapper();
+    this._wrapperFields.request = {{=interfaceName}}_RequestWrapper.createArray();
+    this._wrapperFields.response = {{=interfaceName}}_ResponseWrapper.createArray();
+  }
+  static createFromRefObject(refObject) {
+    let self = new {{=interfaceName}}_EventWrapper();
+    self.copyRefObject(refObject);
+    return self;
+  }
+  static createArray() {
+    return new {{=interfaceName}}_EventArrayWrapper;
+  }
+  static get ArrayType() {
+    return {{=interfaceName}}_EventArrayWrapper;
+  }
+  static get refObjectArrayType() {
+    return {{=interfaceName}}_EventRefStructArray
+  }
+  static get refObjectType() {
+    return {{=interfaceName}}_EventRefStruct;
+  }
+  toRawROS() {
+    this.freeze(true);
+    return this._refObject.ref();
+  }
+  freeze(own = false, checkConsistency = false) {
+    if (checkConsistency) {
+    }
+    this._wrapperFields.info.freeze(own, checkConsistency);
+    this._refObject.info = this._wrapperFields.info.refObject;
+    this._wrapperFields.request.freeze(own, checkConsistency);
+    this._refObject.request = this._wrapperFields.request.refObject;
+    this._wrapperFields.response.freeze(own, checkConsistency);
+    this._refObject.response = this._wrapperFields.response.refObject;
+  }
+  serialize() {
+    this.freeze(false, true);
+    return this._refObject.ref();
+  }
+  deserialize(refObject) {
+    this._wrapperFields.info.copyRefObject(refObject.info);
+    this._wrapperFields.request.copyRefObject(refObject.request);
+    this._wrapperFields.response.copyRefObject(refObject.response);
+  }
+  toPlainObject(enableTypedArray) {
+    return translator.toPlainObject(this, enableTypedArray);
+  }
+  static freeStruct(refObject) {
+    ServiceEventInfoWrapper.freeStruct(refObject.info);
+    if (refObject.request.size != 0) {
+      {{=interfaceName}}_RequestWrapper.ArrayType.freeArray(refObject.request);
+      if ({{=interfaceName}}_RequestWrapper.ArrayType.useTypedArray) {
+        // Do nothing, the v8 will take the ownership of the ArrayBuffer used by the typed array.
+      } else {
+        deallocator.freeStructMember(refObject.request, {{=interfaceName}}_RequestWrapper.refObjectArrayType, 'data');
+      }
+    }
+    if (refObject.response.size != 0) {
+      {{=interfaceName}}_ResponseWrapper.ArrayType.freeArray(refObject.response);
+      if ({{=interfaceName}}_ResponseWrapper.ArrayType.useTypedArray) {
+        // Do nothing, the v8 will take the ownership of the ArrayBuffer used by the typed array.
+      } else {
+        deallocator.freeStructMember(refObject.response, {{=interfaceName}}_ResponseWrapper.refObjectArrayType, 'data');
+      }
+    }
+  }
+  static destoryRawROS(msg) {
+    {{=interfaceName}}_EventWrapper.freeStruct(msg.refObject);
+  }
+  static type() {
+    return {pkgName: '{{=pkgName}}', subFolder: '{{=subFolder}}', interfaceName: '{{=interfaceName}}_Event'};
+  }
+  static isPrimitive() {
+    return false;
+  }
+  static get isROSArray() {
+    return false;
+  }
+  get refObject() {
+    return this._refObject;
+  }
+  get info() {
+    return this._wrapperFields.info;
+  }
+  set info(value) {
+    if (value instanceof ServiceEventInfoWrapper) {
+      this._wrapperFields.info.copy(value);
+    } else {
+      this._wrapperFields.info.copy(new ServiceEventInfoWrapper(value));
+    }
+  }
+  get request() {
+    return this._wrapperFields.request;
+  }
+  set request(value) {
+    if (value.length > 1) {
+      throw new RangeError('The length of array request must be <= 1.');
+    }
+    this._wrapperFields.request.fill(value);
+  }
+  get response() {
+    return this._wrapperFields.response;
+  }
+  set response(value) {
+    if (value.length > 1) {
+      throw new RangeError('The length of array response must be <= 1.');
+    }
+    this._wrapperFields.response.fill(value);
+  }
+  copyRefObject(refObject) {
+    this._refObject = new {{=interfaceName}}_EventRefStruct(refObject.toObject());
+    this._wrapperFields.info.copyRefObject(this._refObject.info);
+    this._wrapperFields.request.copyRefObject(this._refObject.request);
+    this._wrapperFields.response.copyRefObject(this._refObject.response);
+  }
+  copy(other) {
+    this._refObject = new {{=interfaceName}}_EventRefStruct(other._refObject.toObject());
+    this._wrapperFields.info.copy(other._wrapperFields.info);
+    this._wrapperFields.request.copy(other._wrapperFields.request);
+    this._wrapperFields.response.copy(other._wrapperFields.response);
+  }
+  static get classType() {
+    return {{=interfaceName}}_EventWrapper;
+  }
+  static get ROSMessageDef() {
+    return {"constants":[],"fields":[{"name":"info","type":{"isArray":false,"arraySize":null,"isUpperBound":false,"isDynamicArray":false,"isFixedSizeArray":false,"pkgName":"service_msgs","type":"ServiceEventInfo","stringUpperBound":null,"isPrimitiveType":false},"default_value":null},{"name":"request","type":{"isArray":true,"arraySize":1,"isUpperBound":true,"isDynamicArray":true,"isFixedSizeArray":false,"pkgName":"{{=pkgName}}","type":"{{=interfaceName}}_Request","stringUpperBound":null,"isPrimitiveType":false},"default_value":null},{"name":"response","type":{"isArray":true,"arraySize":1,"isUpperBound":true,"isDynamicArray":true,"isFixedSizeArray":false,"pkgName":"{{=pkgName}}","type":"{{=interfaceName}}_Response","stringUpperBound":null,"isPrimitiveType":false},"default_value":null}],"baseType":{"pkgName":"{{=pkgName}}","type":"{{=interfaceName}}_Event","stringUpperBound":null,"isPrimitiveType":false},"msgName":"{{=interfaceName}}_Event"};
+  }
+  hasMember(name) {
+    let memberNames = ["info","request","response"];
+    return memberNames.indexOf(name) !== -1;
+  }
+}
+// Define the wrapper of array class.
+class {{=interfaceName}}_EventArrayWrapper {
+  constructor(size = 0) {
+    this._resize(size);
+  }
+  toRawROS() {
+    return this._refObject.ref();
+  }
+  fill(values) {
+    const length = values.length;
+    this._resize(length);
+    values.forEach((value, index) => {
+      if (value instanceof {{=interfaceName}}_EventWrapper) {
+        this._wrappers[index].copy(value);
+      } else {
+        this._wrappers[index] = new {{=interfaceName}}_EventWrapper(value);
+      }
+    });
+  }
+  // Put all data currently stored in `this._wrappers` into `this._refObject`
+  freeze(own) {
+    this._wrappers.forEach((wrapper, index) => {
+      wrapper.freeze(own);
+      this._refArray[index] = wrapper.refObject;
+    });
+    this._refObject.size = this._wrappers.length;
+    this._refObject.capacity = this._wrappers.length;
+    if (this._refObject.capacity === 0) {
+      this._refObject.data = null
+    } else {
+    this._refObject.data = this._refArray.buffer;
+    }
+  }
+  get refObject() {
+    return this._refObject;
+  }
+  get data() {
+    return this._wrappers;
+  }
+  get size() {
+    return this._wrappers.length;
+  }
+  set size(value) {
+    if (typeof value != 'number') {
+      throw new TypeError('Invalid argument: should provide a number to {{=interfaceName}}_EventArrayWrapper.size setter');
+      return;
+    }
+    return this._resize(value);
+  }
+  get capacity() {
+    return this._wrappers.length;
+  }
+  set capacity(value) {
+    if (typeof value != 'number') {
+      throw new TypeError('Invalid argument: should provide a number to {{=interfaceName}}_EventArrayWrapper.capacity setter');
+    }
+    return this._resize(value);
+  }
+  get refObject() {
+    return this._refObject;
+  }
+  _resize(size) {
+    if (size < 0) {
+      throw new RangeError('Invalid argument: should provide a positive number');
+      return;
+    }
+    this._refArray = new {{=interfaceName}}_EventRefArray(size);
+    this._refObject = new {{=interfaceName}}_EventRefStructArray();
+    this._refObject.size = size;
+    this._refObject.capacity = size;
+    this._wrappers = new Array();
+    for (let i = 0; i < size; i++) {
+      this._wrappers.push(new {{=interfaceName}}_EventWrapper());
+    }
+  }
+  // Copy all data from `this._refObject` into `this._wrappers`
+  copyRefObject(refObject) {
+    this._refObject = refObject;
+    let refObjectArray = this._refObject.data;
+    refObjectArray.length = this._refObject.size;
+    this._resize(this._refObject.size);
+    for (let index = 0; index < this._refObject.size; index++) {
+      this._wrappers[index].copyRefObject(refObjectArray[index]);
+    }
+  }
+  copy(other) {
+    if (! (other instanceof {{=interfaceName}}_EventArrayWrapper)) {
+      throw new TypeError('Invalid argument: should provide "{{=interfaceName}}_EventArrayWrapper".');
+    }
+    this._resize(other.size);
+    // Array deep copy
+    other._wrappers.forEach((wrapper, index) => {
+      this._wrappers[index].copy(wrapper);
+    });
+  }
+  static freeArray(refObject) {
+    let refObjectArray = refObject.data;
+    refObjectArray.length = refObject.size;
+    for (let index = 0; index < refObject.size; index++) {
+      {{=interfaceName}}_EventWrapper.freeStruct(refObjectArray[index]);
+    }
+  }
+  static get elementType() {
+    return {{=interfaceName}}_EventWrapper;
+  }
+  static get isROSArray() {
+    return true;
+  }
+  static get useTypedArray() {
+    return false;
+  }
+  get classType() {
+    return {{=interfaceName}}_EventArrayWrapper;
+  }
+}
+module.exports = {{=interfaceName}}_EventWrapper;
+