@tier0/opcua-client 0.1.0 → 0.4.0

package/lib/points.js

@@ -11,6 +11,32 @@ function positiveNumber(value, fallback) {
   return Number.isFinite(number) && number > 0 ? number : fallback;
 }
 
+function booleanValue(value, fallback) {
+  if (value == null || value === '') return fallback;
+  if (typeof value === 'boolean') return value;
+  if (value === 1 || /^(true|1)$/i.test(String(value))) return true;
+  if (value === 0 || /^(false|0)$/i.test(String(value))) return false;
+  throw new Error(`Invalid Boolean value: ${value}`);
+}
+
+function normalizeIndexRange(value, fallback = '') {
+  const source = value == null || value === '' ? fallback : value;
+  const text = String(source == null ? '' : source).trim();
+  if (!text) return '';
+  const dimensions = text.split(',').map((dimension) => dimension.trim());
+  for (const dimension of dimensions) {
+    if (!/^\d+(?::\d+)?$/.test(dimension)) {
+      throw new Error(`Invalid OPC UA IndexRange: ${text}`);
+    }
+    const bounds = dimension.split(':').map(Number);
+    if (bounds.some((bound) => !Number.isSafeInteger(bound) || bound > 0xffffffff) ||
+        (bounds.length === 2 && bounds[0] > bounds[1])) {
+      throw new Error(`Invalid OPC UA IndexRange: ${text}`);
+    }
+  }
+  return dimensions.join(',');
+}
+
 function normalizePoint(input, defaults = {}) {
   const source = typeof input === 'string' ? { nodeId: input } : { ...(input || {}) };
   const nodeId = String(source.nodeId || source.topic || '').trim();
@@ -27,14 +53,44 @@ function normalizePoint(input, defaults = {}) {
       source.queueSize,
       positiveNumber(defaults.queueSize, DEFAULTS.queueSize)
     )),
-    discardOldest: source.discardOldest == null
-      ? defaults.discardOldest !== false
-      : source.discardOldest !== false,
+    discardOldest: booleanValue(
+      source.discardOldest,
+      booleanValue(defaults.discardOldest, true)
+    ),
   };
 
+  const indexRange = normalizeIndexRange(
+    source.indexRange ?? source.range,
+    defaults.indexRange ?? defaults.range
+  );
+  if (indexRange) point.indexRange = indexRange;
+  else {
+    delete point.indexRange;
+  }
+  delete point.range;
+
   if (point.alias != null) point.alias = String(point.alias);
+  else delete point.alias;
   if (point.dataType != null) point.dataType = String(point.dataType);
-  if (point.enabled == null) point.enabled = true;
+  else delete point.dataType;
+  if (point.deadbandType == null || point.deadbandType === '') delete point.deadbandType;
+  else {
+    const deadbandType = String(point.deadbandType).toLowerCase();
+    const normalizedDeadbandType = deadbandType === 'a' ? 'absolute' :
+      (deadbandType === 'p' ? 'percent' : deadbandType);
+    if (!['none', 'absolute', 'percent'].includes(normalizedDeadbandType)) {
+      throw new Error(`Invalid OPC UA deadband type: ${point.deadbandType}`);
+    }
+    point.deadbandType = normalizedDeadbandType;
+  }
+  if (point.deadbandValue == null || point.deadbandValue === '') delete point.deadbandValue;
+  else {
+    point.deadbandValue = Number(point.deadbandValue);
+    if (!Number.isFinite(point.deadbandValue) || point.deadbandValue < 0) {
+      throw new Error(`Invalid OPC UA deadband value: ${source.deadbandValue}`);
+    }
+  }
+  point.enabled = booleanValue(point.enabled, true);
   return point;
 }
 
@@ -94,20 +150,38 @@ function parseCsvLine(line) {
   return fields;
 }
 
-function parseCsv(text) {
-  const lines = String(text)
-    .replace(/^\uFEFF/, '')
-    .split(/\r?\n/)
-    .filter((line) => line.trim() && !line.trimStart().startsWith('#'));
-  if (!lines.length) return [];
-
-  const headers = parseCsvLine(lines.shift()).map((header) => header.trim());
-  if (!headers.includes('nodeId')) throw new Error('CSV header must contain nodeId');
+function forEachCsvLine(text, callback) {
+  const source = String(text).replace(/^\uFEFF/, '');
+  let start = 0;
+  let lineNumber = 0;
+  while (start <= source.length) {
+    let end = source.indexOf('\n', start);
+    if (end === -1) end = source.length;
+    const line = source.slice(start, end).replace(/\r$/, '');
+    lineNumber += 1;
+    if (line.trim() && !line.trimStart().startsWith('#')) callback(line, lineNumber);
+    if (end === source.length) break;
+    start = end + 1;
+  }
+}
 
-  return lines.map((line) => {
+function parseCsv(text) {
+  let headers;
+  const rows = [];
+  forEachCsvLine(text, (line) => {
+    if (!headers) {
+      headers = parseCsvLine(line).map((header) => header.trim());
+      if (!headers.includes('nodeId')) throw new Error('CSV header must contain nodeId');
+      return;
+    }
     const values = parseCsvLine(line);
-    return Object.fromEntries(headers.map((header, index) => [header, values[index] ?? '']));
+    const row = {};
+    for (let index = 0; index < headers.length; index += 1) {
+      row[headers[index]] = values[index] ?? '';
+    }
+    rows.push(row);
   });
+  return rows;
 }
 
 function parsePointPayload(payload, format = 'auto') {
@@ -157,7 +231,17 @@ function messagePoints(msg, staticNodeId, defaults = {}, options = {}) {
 
   const nodeId = staticNodeId || msg.nodeId || msg.topic;
   if (!nodeId) throw new Error('Missing OPC UA nodeId or point list');
-  return [normalizePoint({ nodeId, alias: msg.alias, dataType: msg.dataType }, defaults)];
+  return [normalizePoint({
+    nodeId,
+    alias: msg.alias,
+    dataType: msg.dataType,
+    indexRange: msg.indexRange ?? msg.range ?? msg.opcua?.indexRange,
+    samplingInterval: msg.samplingInterval ?? msg.interval,
+    queueSize: msg.queueSize,
+    discardOldest: msg.discardOldest,
+    deadbandType: msg.deadbandType,
+    deadbandValue: msg.deadbandValue,
+  }, defaults)];
 }
 
 function coerceWriteValue(value, dataType) {
@@ -176,20 +260,101 @@ function coerceWriteValue(value, dataType) {
   return value;
 }
 
+function parseWriteCsvPayload(payload, msg, config) {
+  const text = Buffer.isBuffer(payload) ? payload.toString('utf8') : String(payload);
+  let headers;
+  let nodeIdIndex = -1;
+  let valueIndex = -1;
+  let dataTypeIndex = -1;
+  let indexRangeIndex = -1;
+  let invalid = 0;
+  const points = new Map();
+
+  forEachCsvLine(text, (line) => {
+    if (!headers) {
+      headers = parseCsvLine(line).map((header) => header.trim());
+      nodeIdIndex = headers.indexOf('nodeId');
+      valueIndex = headers.indexOf('value');
+      dataTypeIndex = headers.indexOf('dataType');
+      indexRangeIndex = headers.indexOf('indexRange');
+      if (indexRangeIndex < 0) indexRangeIndex = headers.indexOf('range');
+      if (nodeIdIndex < 0) throw new Error('CSV header must contain nodeId');
+      return;
+    }
+
+    const values = parseCsvLine(line);
+    const nodeId = String(values[nodeIdIndex] || '').trim();
+    if (!nodeId) {
+      invalid += 1;
+      return;
+    }
+    const dataType = String(
+      (dataTypeIndex >= 0 ? values[dataTypeIndex] : '') ||
+      msg.dataType || config.dataType || 'String'
+    );
+    const value = valueIndex >= 0 ? values[valueIndex] : undefined;
+    const defaultIndexRange = msg.indexRange ?? msg.range ??
+      msg.opcua?.indexRange ?? config.indexRange;
+    const indexRange = normalizeIndexRange(
+      indexRangeIndex >= 0 ? values[indexRangeIndex] : undefined,
+      defaultIndexRange
+    );
+    points.set(nodeId, {
+      nodeId,
+      dataType,
+      value: coerceWriteValue(value, dataType),
+      ...(indexRange ? { indexRange } : {}),
+    });
+  });
+
+  if (invalid) throw new Error(`Invalid point list: ${invalid} item(s) failed validation`);
+  return [...points.values()];
+}
+
 function messageWritePoints(msg, config = {}) {
   let points;
   let configuredPoints = false;
-  if (looksLikePointList(msg.payload)) {
-    points = normalizePointPayload(msg.payload, {}, { format: config.inputFormat || 'auto' }).points;
+  let configuredPointList;
+  const defaultIndexRange = msg.indexRange ?? msg.range ??
+    msg.opcua?.indexRange ?? config.indexRange;
+  if (config.pointList && Array.isArray(msg.payload)) {
+    configuredPointList = normalizePointPayload(
+      config.pointList, { indexRange: defaultIndexRange }, { format: 'auto' }
+    ).points;
+  }
+  const directNodeId = config.nodeId || msg.nodeId || msg.topic;
+  const arrayValue = Array.isArray(msg.payload) && msg.opcua?.pointList !== true && (
+    msg.opcua?.arrayValue === true || directNodeId ||
+    (configuredPointList?.length === 1 && configuredPointList[0].useInput)
+  );
+  if (!arrayValue && looksLikePointList(msg.payload)) {
+    const inputFormat = config.inputFormat || 'auto';
+    const hasTextPayload = typeof msg.payload === 'string' || Buffer.isBuffer(msg.payload);
+    const text = Buffer.isBuffer(msg.payload)
+      ? msg.payload.toString('utf8').trimStart()
+      : typeof msg.payload === 'string' ? msg.payload.trimStart() : '';
+    const isCsv = hasTextPayload && (inputFormat === 'csv' ||
+      (inputFormat === 'auto' && text && !text.startsWith('[') && !text.startsWith('{')));
+    if (isCsv) return parseWriteCsvPayload(msg.payload, msg, config);
+    points = normalizePointPayload(
+      msg.payload, { indexRange: defaultIndexRange }, { format: inputFormat }
+    ).points;
   } else if (msg.payload && typeof msg.payload === 'object' && msg.payload.nodeId) {
-    points = normalizePoints([msg.payload]).points;
+    points = normalizePoints([msg.payload], { indexRange: defaultIndexRange }).points;
   } else if (config.pointList) {
-    points = normalizePointPayload(config.pointList, {}, { format: 'auto' }).points;
+    points = configuredPointList ||
+      normalizePointPayload(
+        config.pointList, { indexRange: defaultIndexRange }, { format: 'auto' }
+      ).points;
     configuredPoints = true;
   } else {
     const nodeId = config.nodeId || msg.nodeId || msg.topic;
     if (!nodeId) throw new Error('Missing OPC UA nodeId or point list');
-    points = normalizePoints([{ nodeId, value: msg.payload }]).points;
+    points = normalizePoints([{
+      nodeId,
+      value: msg.payload,
+      indexRange: defaultIndexRange,
+    }]).points;
   }
 
   return points.map((point) => {
@@ -223,6 +388,7 @@ module.exports = {
   looksLikePointList,
   messagePoints,
   messageWritePoints,
+  normalizeIndexRange,
   normalizePoint,
   normalizePointPayload,
   normalizePoints,

package/lib/prebuild.js

@@ -0,0 +1,42 @@
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+function linuxLibc(report) {
+  if (report?.header?.glibcVersionRuntime || report?.header?.glibcVersionCompiler) {
+    return 'glibc';
+  }
+  return 'musl';
+}
+
+function runtimeReport() {
+  try {
+    return process.report?.getReport?.();
+  } catch {
+    return undefined;
+  }
+}
+
+function prebuildKey(options = {}) {
+  const platform = options.platform || process.platform;
+  const arch = options.arch || process.arch;
+  if (platform !== 'linux') return `${platform}-${arch}`;
+  return `${platform}-${arch}-${linuxLibc(options.report || runtimeReport())}`;
+}
+
+function prebuildPath(packageRoot, options = {}) {
+  return path.join(
+    packageRoot,
+    'prebuilds',
+    prebuildKey(options),
+    'opcua_open62541.node'
+  );
+}
+
+function resolvePrebuilt(packageRoot, options = {}) {
+  const candidate = prebuildPath(packageRoot, options);
+  return fs.existsSync(candidate) ? candidate : undefined;
+}
+
+module.exports = { linuxLibc, prebuildKey, prebuildPath, resolvePrebuilt };

package/lib/security-file-store.js

@@ -0,0 +1,119 @@
+'use strict';
+
+const crypto = require('node:crypto');
+const fs = require('node:fs/promises');
+const path = require('node:path');
+
+const MAX_SECURITY_FILE_SIZE = 2 * 1024 * 1024;
+
+const FILE_KINDS = Object.freeze({
+  clientCertificate: {
+    prefix: 'client-certificate',
+    extensions: new Set(['.der', '.pem', '.crt', '.cer']),
+  },
+  privateKey: {
+    prefix: 'client-private-key',
+    extensions: new Set(['.der', '.pem', '.key']),
+  },
+  trustedCertificate: {
+    prefix: 'trusted-certificate',
+    extensions: new Set(['.der', '.pem', '.crt', '.cer']),
+  },
+  revocationList: {
+    prefix: 'revocation-list',
+    extensions: new Set(['.der', '.pem', '.crl']),
+  },
+});
+
+function storageError(message, code = 'OPCUA_SECURITY_FILE_INVALID') {
+  const error = new Error(message);
+  error.code = code;
+  return error;
+}
+
+function decodeBase64(value) {
+  const encoded = String(value || '').trim();
+  if (!encoded || encoded.length % 4 !== 0 ||
+      !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) {
+    throw storageError('Security file content must be valid base64');
+  }
+  const decoded = Buffer.from(encoded, 'base64');
+  if (!decoded.length || decoded.toString('base64') !== encoded) {
+    throw storageError('Security file content must be valid base64');
+  }
+  return decoded;
+}
+
+function connectionDirectoryName(connectionId) {
+  const value = String(connectionId || '').trim();
+  if (!value || value.length > 256) {
+    throw storageError('A valid Connection node id is required');
+  }
+  return crypto.createHash('sha256').update(value).digest('hex').slice(0, 32);
+}
+
+class SecurityFileStore {
+  constructor(options = {}) {
+    const userDir = path.resolve(String(options.userDir || process.cwd()));
+    this.root = path.join(userDir, 'opcua-pki');
+    this.maxFileSize = Number(options.maxFileSize) || MAX_SECURITY_FILE_SIZE;
+  }
+
+  connectionDirectory(connectionId) {
+    return path.join(this.root, connectionDirectoryName(connectionId));
+  }
+
+  async save({ connectionId, kind, fileName, contentBase64 }) {
+    const definition = FILE_KINDS[kind];
+    if (!definition) throw storageError(`Unsupported OPC UA security file kind: ${kind}`);
+
+    const extension = path.extname(String(fileName || '')).toLowerCase();
+    if (!definition.extensions.has(extension)) {
+      throw storageError(
+        `Unsupported ${kind} file extension; allowed: ${[...definition.extensions].join(', ')}`
+      );
+    }
+
+    const content = decodeBase64(contentBase64);
+    if (content.length > this.maxFileSize) {
+      throw storageError(
+        `Security file exceeds the ${this.maxFileSize} byte limit`,
+        'OPCUA_SECURITY_FILE_TOO_LARGE'
+      );
+    }
+
+    const directory = this.connectionDirectory(connectionId);
+    const sha256 = crypto.createHash('sha256').update(content).digest('hex');
+    const managedName = `${definition.prefix}-${sha256.slice(0, 24)}${extension}`;
+    const managedPath = path.join(directory, managedName);
+    await fs.mkdir(directory, { recursive: true, mode: 0o700 });
+    try {
+      await fs.writeFile(managedPath, content, { flag: 'wx', mode: 0o600 });
+    } catch (error) {
+      if (error.code !== 'EEXIST') throw error;
+    }
+    await fs.chmod(managedPath, 0o600);
+
+    return {
+      kind,
+      name: path.basename(String(fileName || '')),
+      path: managedPath,
+      size: content.length,
+      sha256,
+      managed: true,
+    };
+  }
+
+  async removeConnection(connectionId) {
+    const directory = this.connectionDirectory(connectionId);
+    await fs.rm(directory, { recursive: true, force: true });
+  }
+}
+
+module.exports = {
+  FILE_KINDS,
+  MAX_SECURITY_FILE_SIZE,
+  SecurityFileStore,
+  connectionDirectoryName,
+  decodeBase64,
+};

package/lib/security.js

@@ -0,0 +1,96 @@
+'use strict';
+
+const SECURITY_POLICY_URIS = Object.freeze({
+  None: 'http://opcfoundation.org/UA/SecurityPolicy#None',
+  Basic256Sha256: 'http://opcfoundation.org/UA/SecurityPolicy#Basic256Sha256',
+});
+
+const SECURITY_MODES = new Set(['None', 'Sign', 'SignAndEncrypt']);
+
+function configurationError(message) {
+  const error = new Error(message);
+  error.code = 'OPCUA_INVALID_SECURITY_CONFIGURATION';
+  return error;
+}
+
+function normalizePathList(value) {
+  const source = Array.isArray(value)
+    ? value
+    : String(value || '').split(/\r?\n|;/);
+  return [...new Set(source.map((entry) => String(entry || '').trim()).filter(Boolean))];
+}
+
+function securityPolicyName(value) {
+  const policy = String(value || 'None').trim();
+  if (SECURITY_POLICY_URIS[policy]) return policy;
+  const match = Object.entries(SECURITY_POLICY_URIS).find(([, uri]) => uri === policy);
+  return match?.[0] || policy;
+}
+
+function normalizeConnectionOptions(options = {}) {
+  const normalized = {
+    ...options,
+    endpoint: String(options.endpoint || '').trim(),
+    securityMode: String(options.securityMode || 'None').trim(),
+    securityPolicy: securityPolicyName(options.securityPolicy),
+    certificate: String(options.certificate || '').trim(),
+    privateKey: String(options.privateKey || '').trim(),
+    applicationUri: String(options.applicationUri || '').trim(),
+    trustedCertificates: normalizePathList(
+      options.trustedCertificates ?? options.trustList
+    ),
+    revocationList: normalizePathList(options.revocationList),
+  };
+
+  if (!normalized.endpoint) throw configurationError('OPC UA endpoint is required');
+  if (!SECURITY_MODES.has(normalized.securityMode)) {
+    throw configurationError(`Unsupported OPC UA security mode: ${normalized.securityMode}`);
+  }
+  if (!SECURITY_POLICY_URIS[normalized.securityPolicy]) {
+    throw configurationError(`Unsupported OPC UA security policy: ${normalized.securityPolicy}`);
+  }
+  if (normalized.securityMode === 'None') {
+    if (normalized.securityPolicy !== 'None') {
+      throw configurationError('SecurityMode None requires SecurityPolicy None');
+    }
+  } else {
+    if (normalized.securityPolicy === 'None') {
+      throw configurationError(`${normalized.securityMode} requires a non-None security policy`);
+    }
+    if (!normalized.certificate) {
+      throw configurationError('Secure OPC UA connections require a client certificate');
+    }
+    if (!normalized.privateKey) {
+      throw configurationError('Secure OPC UA connections require a client private key');
+    }
+    if (!normalized.trustedCertificates.length) {
+      throw configurationError('Secure OPC UA connections require at least one trusted server or CA certificate');
+    }
+  }
+
+  normalized.securityPolicyUri = SECURITY_POLICY_URIS[normalized.securityPolicy];
+  return normalized;
+}
+
+function endpointIdentityTypes(endpoint) {
+  return [...new Set((endpoint?.userIdentityTokens || []).map((token) => token.tokenType))];
+}
+
+function matchingEndpoints(endpoints, options = {}) {
+  const mode = String(options.securityMode || 'None');
+  const policy = securityPolicyName(options.securityPolicy);
+  const identityType = String(options.identityType || (options.user ? 'Username' : 'Anonymous'));
+  return (Array.isArray(endpoints) ? endpoints : []).filter((endpoint) => (
+    endpoint.securityMode === mode &&
+    securityPolicyName(endpoint.securityPolicyUri || endpoint.securityPolicy) === policy &&
+    endpointIdentityTypes(endpoint).includes(identityType)
+  ));
+}
+
+module.exports = {
+  SECURITY_POLICY_URIS,
+  matchingEndpoints,
+  normalizeConnectionOptions,
+  normalizePathList,
+  securityPolicyName,
+};

package/node_modules/node-addon-api/LICENSE.md

@@ -0,0 +1,9 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 [Node.js API collaborators](https://github.com/nodejs/node-addon-api#collaborators)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/node_modules/node-addon-api/README.md

@@ -0,0 +1,95 @@
+# **node-addon-api module**
+
+[![codecov](https://codecov.io/gh/nodejs/node-addon-api/branch/main/graph/badge.svg)](https://app.codecov.io/gh/nodejs/node-addon-api/tree/main)
+
+[![NPM](https://nodei.co/npm/node-addon-api.png?downloads=true&downloadRank=true)](https://nodei.co/npm/node-addon-api/) [![NPM](https://nodei.co/npm-dl/node-addon-api.png?months=6&height=1)](https://nodei.co/npm/node-addon-api/)
+
+This module contains  **header-only C++ wrapper classes** which simplify
+the use of the C based [Node-API](https://nodejs.org/dist/latest/docs/api/n-api.html)
+provided by Node.js when using C++. It provides a C++ object model
+and exception handling semantics with low overhead.
+
+- [API References](doc/README.md)
+- [Badges](#badges)
+- [Contributing](#contributing)
+- [License](#license)
+
+## API References
+
+API references are available in the [doc](doc/README.md) directory.
+
+<!-- x-release-please-start-version -->
+## Current version: 8.9.1
+<!-- x-release-please-end -->
+
+(See [CHANGELOG.md](CHANGELOG.md) for complete Changelog)
+
+node-addon-api is based on [Node-API](https://nodejs.org/api/n-api.html) and supports using different Node-API versions.
+This allows addons built with it to run with Node.js versions which support the targeted Node-API version.
+**However** the node-addon-api support model is to support only the active LTS Node.js versions. This means that
+every year there will be a new major which drops support for the Node.js LTS version which has gone out of service.
+
+The oldest Node.js version supported by the current version of node-addon-api is Node.js 18.x.
+
+## Badges
+
+The use of badges is recommended to indicate the minimum version of Node-API
+required for the module. This helps to determine which Node.js major versions are
+supported. Addon maintainers can consult the [Node-API support matrix][] to determine
+which Node.js versions provide a given Node-API version. The following badges are
+available:
+
+![Node-API v1 Badge](https://github.com/nodejs/abi-stable-node/blob/doc/assets/Node-API%20v1%20Badge.svg)
+![Node-API v2 Badge](https://github.com/nodejs/abi-stable-node/blob/doc/assets/Node-API%20v2%20Badge.svg)
+![Node-API v3 Badge](https://github.com/nodejs/abi-stable-node/blob/doc/assets/Node-API%20v3%20Badge.svg)
+![Node-API v4 Badge](https://github.com/nodejs/abi-stable-node/blob/doc/assets/Node-API%20v4%20Badge.svg)
+![Node-API v5 Badge](https://github.com/nodejs/abi-stable-node/blob/doc/assets/Node-API%20v5%20Badge.svg)
+![Node-API v6 Badge](https://github.com/nodejs/abi-stable-node/blob/doc/assets/Node-API%20v6%20Badge.svg)
+![Node-API v7 Badge](https://github.com/nodejs/abi-stable-node/blob/doc/assets/Node-API%20v7%20Badge.svg)
+![Node-API v8 Badge](https://github.com/nodejs/abi-stable-node/blob/doc/assets/Node-API%20v8%20Badge.svg)
+![Node-API v9 Badge](https://github.com/nodejs/abi-stable-node/blob/doc/assets/Node-API%20v9%20Badge.svg)
+![Node-API Experimental Version Badge](https://github.com/nodejs/abi-stable-node/blob/doc/assets/Node-API%20Experimental%20Version%20Badge.svg)
+
+## Contributing
+
+We love contributions from the community to **node-addon-api**!
+See [CONTRIBUTING.md](CONTRIBUTING.md) for more details on our philosophy around extending this module.
+
+## Team members
+
+### Active
+
+| Name                | GitHub Link                                           |
+| ------------------- | ----------------------------------------------------- |
+| Anna Henningsen     | [addaleax](https://github.com/addaleax)               |
+| Chengzhong Wu       | [legendecas](https://github.com/legendecas)           |
+| Jack Xia            | [JckXia](https://github.com/JckXia)                   |
+| Kevin Eady          | [KevinEady](https://github.com/KevinEady)             |
+| Michael Dawson      | [mhdawson](https://github.com/mhdawson)               |
+| Nicola Del Gobbo    | [NickNaso](https://github.com/NickNaso)               |
+| Vladimir Morozov    | [vmoroz](https://github.com/vmoroz)                   |
+
+<details>
+
+<summary>Emeritus</summary>
+
+### Emeritus
+
+| Name                | GitHub Link                                           |
+| ------------------- | ----------------------------------------------------- |
+| Arunesh Chandra     | [aruneshchandra](https://github.com/aruneshchandra)   |
+| Benjamin Byholm     | [kkoopa](https://github.com/kkoopa)                   |
+| Gabriel Schulhof    | [gabrielschulhof](https://github.com/gabrielschulhof) |
+| Hitesh Kanwathirtha | [digitalinfinity](https://github.com/digitalinfinity) |
+| Jason Ginchereau    | [jasongin](https://github.com/jasongin)               |
+| Jim Schlight        | [jschlight](https://github.com/jschlight)             |
+| Sampson Gao         | [sampsongao](https://github.com/sampsongao)           |
+| Taylor Woll         | [boingoing](https://github.com/boingoing)             |
+
+</details>
+
+## License
+
+Licensed under [MIT](./LICENSE.md)
+
+[Node-API support matrix]: https://nodejs.org/dist/latest/docs/api/n-api.html#node-api-version-matrix

package/node_modules/node-addon-api/common.gypi

@@ -0,0 +1,21 @@
+{
+  'variables': {
+    'NAPI_VERSION%': "<!(node -p \"process.env.NAPI_VERSION || process.versions.napi\")",
+    'disable_deprecated': "<!(node -p \"process.env['npm_config_disable_deprecated']\")"
+  },
+  'conditions': [
+    ['NAPI_VERSION!=""', { 'defines': ['NAPI_VERSION=<@(NAPI_VERSION)'] } ],
+    ['NAPI_VERSION==2147483647', { 'defines': ['NAPI_EXPERIMENTAL', 'NODE_API_EXPERIMENTAL_NO_WARNING'] } ],
+    ['disable_deprecated=="true"', {
+      'defines': ['NODE_ADDON_API_DISABLE_DEPRECATED']
+    }],
+    ['OS=="mac"', {
+      'cflags+': ['-fvisibility=hidden'],
+      'xcode_settings': {
+        'OTHER_CFLAGS': ['-fvisibility=hidden']
+      }
+    }]
+  ],
+  'cflags': [ '-Werror', '-Wall', '-Wextra', '-Wpedantic', '-Wunused-parameter' ],
+  'cflags_cc': [ '-Werror', '-Wall', '-Wextra', '-Wpedantic', '-Wunused-parameter' ]
+}

package/node_modules/node-addon-api/except.gypi

@@ -0,0 +1,25 @@
+{
+  'defines': [ 'NAPI_CPP_EXCEPTIONS' ],
+  'cflags!': [ '-fno-exceptions' ],
+  'cflags_cc!': [ '-fno-exceptions' ],
+  'conditions': [
+    ["OS=='win'", {
+      "defines": [
+        "_HAS_EXCEPTIONS=1"
+      ],
+      "msvs_settings": {
+        "VCCLCompilerTool": {
+          "ExceptionHandling": 1,
+          'EnablePREfast': 'true',
+        },
+      },
+    }],
+    ["OS=='mac'", {
+      'xcode_settings': {
+        'GCC_ENABLE_CPP_EXCEPTIONS': 'YES',
+        'CLANG_CXX_LIBRARY': 'libc++',
+        'MACOSX_DEPLOYMENT_TARGET': '10.7',
+      },
+    }],
+  ],
+}