koffi 2.16.0-beta.2 → 2.16.0

package/vendor/node-addon-api/CODE_OF_CONDUCT.md

@@ -1,4 +0,0 @@
-# Code of Conduct
-
-The Node.js Code of Conduct, which applies to this project, can be found at
-https://github.com/nodejs/admin/blob/HEAD/CODE_OF_CONDUCT.md.

package/vendor/node-addon-api/CONTRIBUTING.md

@@ -1,203 +0,0 @@
-# Contributing to **node-addon-api**
-
-* [Code of Conduct](#code-of-conduct)
-* [Developer's Certificate of Origin 1.1](#developers-certificate-of-origin)
-* [Tests](#tests)
-* [Debug](#debug)
-* [Benchmarks](#benchmarks)
-* [node-addon-api Contribution Philosophy](#node-addon-api-contribution-philosophy)
-
-## Code of Conduct
-
-The Node.js project has a
-[Code of Conduct](https://github.com/nodejs/admin/blob/HEAD/CODE_OF_CONDUCT.md)
-to which all contributors must adhere.
-
-See [details on our policy on Code of Conduct](https://github.com/nodejs/node/blob/main/doc/contributing/code-of-conduct.md).
-
-<a id="developers-certificate-of-origin"></a>
-
-## Developer's Certificate of Origin 1.1
-
-<pre>
-By making a contribution to this project, I certify that:
-
- (a) The contribution was created in whole or in part by me and I
-     have the right to submit it under the open source license
-     indicated in the file; or
-
- (b) The contribution is based upon previous work that, to the best
-     of my knowledge, is covered under an appropriate open source
-     license and I have the right under that license to submit that
-     work with modifications, whether created in whole or in part
-     by me, under the same open source license (unless I am
-     permitted to submit under a different license), as indicated
-     in the file; or
-
- (c) The contribution was provided directly to me by some other
-     person who certified (a), (b) or (c) and I have not modified
-     it.
-
- (d) I understand and agree that this project and the contribution
-     are public and that a record of the contribution (including all
-     personal information I submit with it, including my sign-off) is
-     maintained indefinitely and may be redistributed consistent with
-     this project or the open source license(s) involved.
-</pre>
-
-
-## Tests
-
-To run the **node-addon-api** tests do:
-
-```
-npm install
-npm test
-```
-
-To avoid testing the deprecated portions of the API run
-```
-npm install
-npm test --disable-deprecated
-```
-
-To run the tests targeting a specific version of Node-API run
-```
-npm install
-export NAPI_VERSION=X
-npm test --NAPI_VERSION=X
-```
-
-where X is the version of Node-API you want to target.
-
-To run a specific unit test, filter conditions are available
-
-**Example:**
-  compile and run only tests on objectwrap.cc and objectwrap.js
-  ```
-    npm run unit --filter=objectwrap
-  ```
-
-Multiple unit tests cane be selected with wildcards
-
-**Example:**
-compile and run all test files ending with "reference" -> function_reference.cc, object_reference.cc, reference.cc
- ```
-    npm run unit --filter=*reference
- ```
-
-Multiple filter conditions can be joined to broaden the test selection
-
-**Example:**
- compile and run all tests under folders threadsafe_function and typed_threadsafe_function and also the objectwrap.cc file
-    npm run unit --filter='*function objectwrap'
-
-## Debug
-
-To run the **node-addon-api** tests with `--debug` option:
-
-```
-npm run-script dev
-```
-
-If you want a faster build, you might use the following option:
-
-```
-npm run-script dev:incremental
-```
-
-Take a look and get inspired by our **[test suite](https://github.com/nodejs/node-addon-api/tree/HEAD/test)**
-
-## Benchmarks
-
-You can run the available benchmarks using the following command:
-
-```
-npm run-script benchmark
-```
-
-See [benchmark/README.md](benchmark/README.md) for more details about running and adding benchmarks.
-
-## **node-addon-api** Contribution Philosophy
-
-The **node-addon-api** team loves contributions. There are many ways in which you can
-contribute to **node-addon-api**:
-- [New APIs](#new-apis)
-- [Source code fixes](#source-changes)
-- Additional tests
-- Documentation improvements
-- Joining the Node-API working group and participating in meetings
-
-### New APIs
-
-As new APIs are added to Node-API, node-addon-api must be updated to provide
-wrappers for those new APIs. For this reason, node-addon-api provides
-methods that allow callers to obtain the underlying Node-API handles so
-direct calls to Node-API and the use of the objects/methods provided by
-node-addon-api can be used together. For example, in order to be able
-to use an API for which the node-addon-api does not yet provide a wrapper.
-
-APIs exposed by node-addon-api are generally used to create and
-manipulate JavaScript values. Concepts and operations generally map
-to ideas specified in the **ECMA262 Language Specification**.
-
-### Source changes
-
-**node-addon-api** is meant to be a thin convenience wrapper around Node-API. With this
-in mind, contributions of any new APIs that wrap around a core Node-API API will
-be considered for merging. However, changes that wrap existing **node-addon-api**
-APIs are encouraged to instead be provided as an ecosystem module. The
-**node-addon-api** team is happy to link to a curated set of modules that build on
-top of **node-addon-api** if they have broad usefulness to the community and promote
-a recommended idiom or pattern.
-
-### Rationale
-
-The Node-API team considered a couple of different approaches with regard to changes
-extending **node-addon-api**
-- Larger core module - Incorporate these helpers and patterns into **node-addon-api**
-- Extras package - Create a new package (strawman name '**node-addon-api**-extras')
-that contain utility classes and methods that help promote good patterns and
-idioms while writing native addons with **node-addon-api**.
-- Ecosystem - Encourage the creation of a module ecosystem around **node-addon-api**
-where folks can build on top of it.
-
-#### Larger Core
-
-This is probably our simplest option in terms of immediate action needed. It
-would involve landing any open PRs against **node-addon-api**, and continuing to
-encourage folks to make PRs for utility helpers against the same repository.
-
-The downside of the approach is the following:
-- Less coherency for our API set
-- More maintenance burden on the Node-API WG core team.
-
-#### Extras Package
-
-This involves us spinning up a new package that contains the utility classes
-and methods. This has the benefit of having a separate module where helpers
-make it easier to implement certain patterns and idioms for native addons
-easier.
-
-The downside of this approach is the following:
-- Potential for confusion - we'll need to provide clear documentation to help the
-community understand where a particular contribution should be directed to (what
-belongs in **node-addon-api** vs **node-addon-api-extras**)
-- Need to define the level of support/API guarantees
-- Unclear if the maintenance burden on the Node-API WG is reduced or not
-
-#### Ecosystem
-
-This doesn't require a ton of up-front work from the Node-API WG. Instead of
-accepting utility PRs into **node-addon-api** or creating and maintaining a new
-module, the WG will encourage the creation of an ecosystem of modules that
-build on top of **node-addon-api**, and provide some level of advertising for these
-modules (listing them out on the repository/wiki, using them in workshops/tutorials
-etc).
-
-The downside of this approach is the following:
-- Potential for lack of visibility. Evangelism and education are hard, and module
-authors might not find the right patterns and instead implement things themselves
-- There might be greater friction for the Node-API WG in evolving APIs since the
-ecosystem would have taken dependencies on the API shape of **node-addon-api**
-

package/vendor/node-addon-api/appveyor.yml

@@ -1,37 +0,0 @@
-environment:
-  # https://github.com/jasongin/nvs/blob/HEAD/doc/CI.md
-  NVS_VERSION: 1.4.2
-  matrix:
-    - NODEJS_VERSION: node/10
-    - NODEJS_VERSION: node/12
-    - NODEJS_VERSION: node/14
-    - NODEJS_VERSION: nightly
-
-os: Visual Studio 2017
-platform:
-  - x86
-  - x64
-
-install:
-  # nvs
-  - git clone --branch v%NVS_VERSION% --depth 1 https://github.com/jasongin/nvs %LOCALAPPDATA%\nvs
-  - set PATH=%LOCALAPPDATA%\nvs;%PATH%
-  - nvs --version
-  # node.js
-  - nvs add %NODEJS_VERSION%/%PLATFORM%
-  - nvs use %NODEJS_VERSION%/%PLATFORM%
-  - node --version
-  - node -p process.arch
-  - npm --version
-  # app
-  - npm install
-
-test_script:
-  - npm test
-
-build: off
-
-version: "{build}"
-
-cache:
-  - node_modules

package/vendor/node-addon-api/benchmark/README.md

@@ -1,47 +0,0 @@
-# Benchmarks
-
-## Running the benchmarks
-
-From the parent directory, run
-
-```bash
-npm run-script benchmark
-```
-
-The above script supports the following arguments:
-
-* `--benchmarks=...`: A semicolon-separated list of benchmark names. These names
-    will be mapped to file names in this directory by appending `.js`.
-
-## Adding benchmarks
-
-The steps below should be followed when adding new benchmarks.
-
-0. Decide on a name for the benchmark. This name will be used in several places.
-   This example will use the name `new_benchmark`.
-
-0. Create files `new_benchmark.cc` and `new_benchmark.js` in this directory.
-
-0. Copy an existing benchmark in `binding.gyp` and change the target name prefix
-    and the source file name to `new_benchmark`. This should result in two new
-    targets which look like this:
-
-    ```gyp
-      {
-        'target_name': 'new_benchmark',
-        'sources': [ 'new_benchmark.cc' ],
-        'includes': [ '../except.gypi' ],
-      },
-      {
-        'target_name': 'new_benchmark_noexcept',
-        'sources': [ 'new_benchmark.cc' ],
-        'includes': [ '../noexcept.gypi' ],
-      },
-    ```
-
-    There should always be a pair of targets: one bearing the name of the
-    benchmark and configured with C++ exceptions enabled, and one bearing the
-    same name followed by the suffix `_noexcept` and configured with C++
-    exceptions disabled. This will ensure that the benchmark can be written to
-    cover both the case where C++ exceptions are enabled and the case where they
-    are disabled.

package/vendor/node-addon-api/benchmark/binding.gyp

@@ -1,25 +0,0 @@
-{
-  'target_defaults': { 'includes': ['../common.gypi'] },
-  'targets': [
-    {
-      'target_name': 'function_args',
-      'sources': [ 'function_args.cc' ],
-      'dependencies': ['../node_addon_api.gyp:node_addon_api_except'],
-    },
-    {
-      'target_name': 'function_args_noexcept',
-      'sources': [ 'function_args.cc' ],
-      'dependencies': ['../node_addon_api.gyp:node_addon_api'],
-    },
-    {
-      'target_name': 'property_descriptor',
-      'sources': [ 'property_descriptor.cc' ],
-      'dependencies': ['../node_addon_api.gyp:node_addon_api_except'],
-    },
-    {
-      'target_name': 'property_descriptor_noexcept',
-      'sources': [ 'property_descriptor.cc' ],
-      'dependencies': ['../node_addon_api.gyp:node_addon_api'],
-    },
-  ]
-}

package/vendor/node-addon-api/benchmark/function_args.cc

@@ -1,250 +0,0 @@
-#include "napi.h"
-
-static napi_value NoArgFunction_Core(napi_env env, napi_callback_info info) {
-  (void)env;
-  (void)info;
-  return nullptr;
-}
-
-static napi_value OneArgFunction_Core(napi_env env, napi_callback_info info) {
-  size_t argc = 1;
-  napi_value argv;
-  if (napi_get_cb_info(env, info, &argc, &argv, nullptr, nullptr) != napi_ok) {
-    return nullptr;
-  }
-  (void)argv;
-  return nullptr;
-}
-
-static napi_value TwoArgFunction_Core(napi_env env, napi_callback_info info) {
-  size_t argc = 2;
-  napi_value argv[2];
-  if (napi_get_cb_info(env, info, &argc, argv, nullptr, nullptr) != napi_ok) {
-    return nullptr;
-  }
-  (void)argv[0];
-  (void)argv[1];
-  return nullptr;
-}
-
-static napi_value ThreeArgFunction_Core(napi_env env, napi_callback_info info) {
-  size_t argc = 3;
-  napi_value argv[3];
-  if (napi_get_cb_info(env, info, &argc, argv, nullptr, nullptr) != napi_ok) {
-    return nullptr;
-  }
-  (void)argv[0];
-  (void)argv[1];
-  (void)argv[2];
-  return nullptr;
-}
-
-static napi_value FourArgFunction_Core(napi_env env, napi_callback_info info) {
-  size_t argc = 4;
-  napi_value argv[4];
-  if (napi_get_cb_info(env, info, &argc, argv, nullptr, nullptr) != napi_ok) {
-    return nullptr;
-  }
-  (void)argv[0];
-  (void)argv[1];
-  (void)argv[2];
-  (void)argv[3];
-  return nullptr;
-}
-
-static void NoArgFunction(const Napi::CallbackInfo& info) {
-  (void)info;
-}
-
-static void OneArgFunction(const Napi::CallbackInfo& info) {
-  Napi::Value argv0 = info[0];
-  (void)argv0;
-}
-
-static void TwoArgFunction(const Napi::CallbackInfo& info) {
-  Napi::Value argv0 = info[0];
-  (void)argv0;
-  Napi::Value argv1 = info[1];
-  (void)argv1;
-}
-
-static void ThreeArgFunction(const Napi::CallbackInfo& info) {
-  Napi::Value argv0 = info[0];
-  (void)argv0;
-  Napi::Value argv1 = info[1];
-  (void)argv1;
-  Napi::Value argv2 = info[2];
-  (void)argv2;
-}
-
-static void FourArgFunction(const Napi::CallbackInfo& info) {
-  Napi::Value argv0 = info[0];
-  (void)argv0;
-  Napi::Value argv1 = info[1];
-  (void)argv1;
-  Napi::Value argv2 = info[2];
-  (void)argv2;
-  Napi::Value argv3 = info[3];
-  (void)argv3;
-}
-
-#if NAPI_VERSION > 5
-class FunctionArgsBenchmark : public Napi::Addon<FunctionArgsBenchmark> {
- public:
-  FunctionArgsBenchmark(Napi::Env env, Napi::Object exports) {
-    DefineAddon(
-        exports,
-        {
-            InstanceValue(
-                "addon",
-                DefineProperties(
-                    Napi::Object::New(env),
-                    {
-                        InstanceMethod("noArgFunction",
-                                       &FunctionArgsBenchmark::NoArgFunction),
-                        InstanceMethod("oneArgFunction",
-                                       &FunctionArgsBenchmark::OneArgFunction),
-                        InstanceMethod("twoArgFunction",
-                                       &FunctionArgsBenchmark::TwoArgFunction),
-                        InstanceMethod(
-                            "threeArgFunction",
-                            &FunctionArgsBenchmark::ThreeArgFunction),
-                        InstanceMethod("fourArgFunction",
-                                       &FunctionArgsBenchmark::FourArgFunction),
-                    }),
-                napi_enumerable),
-            InstanceValue(
-                "addon_templated",
-                DefineProperties(
-                    Napi::Object::New(env),
-                    {
-                        InstanceMethod<&FunctionArgsBenchmark::NoArgFunction>(
-                            "noArgFunction"),
-                        InstanceMethod<&FunctionArgsBenchmark::OneArgFunction>(
-                            "oneArgFunction"),
-                        InstanceMethod<&FunctionArgsBenchmark::TwoArgFunction>(
-                            "twoArgFunction"),
-                        InstanceMethod<
-                            &FunctionArgsBenchmark::ThreeArgFunction>(
-                            "threeArgFunction"),
-                        InstanceMethod<&FunctionArgsBenchmark::FourArgFunction>(
-                            "fourArgFunction"),
-                    }),
-                napi_enumerable),
-        });
-  }
-
- private:
-  void NoArgFunction(const Napi::CallbackInfo& info) { (void)info; }
-
-  void OneArgFunction(const Napi::CallbackInfo& info) {
-    Napi::Value argv0 = info[0];
-    (void)argv0;
-  }
-
-  void TwoArgFunction(const Napi::CallbackInfo& info) {
-    Napi::Value argv0 = info[0];
-    (void)argv0;
-    Napi::Value argv1 = info[1];
-    (void)argv1;
-  }
-
-  void ThreeArgFunction(const Napi::CallbackInfo& info) {
-    Napi::Value argv0 = info[0];
-    (void)argv0;
-    Napi::Value argv1 = info[1];
-    (void)argv1;
-    Napi::Value argv2 = info[2];
-    (void)argv2;
-  }
-
-  void FourArgFunction(const Napi::CallbackInfo& info) {
-    Napi::Value argv0 = info[0];
-    (void)argv0;
-    Napi::Value argv1 = info[1];
-    (void)argv1;
-    Napi::Value argv2 = info[2];
-    (void)argv2;
-    Napi::Value argv3 = info[3];
-    (void)argv3;
-  }
-};
-#endif  // NAPI_VERSION > 5
-
-static Napi::Object Init(Napi::Env env, Napi::Object exports) {
-  napi_value no_arg_function, one_arg_function, two_arg_function,
-      three_arg_function, four_arg_function;
-  napi_status status;
-
-  status = napi_create_function(env,
-                                "noArgFunction",
-                                NAPI_AUTO_LENGTH,
-                                NoArgFunction_Core,
-                                nullptr,
-                                &no_arg_function);
-  NAPI_THROW_IF_FAILED(env, status, Napi::Object());
-
-  status = napi_create_function(env,
-                                "oneArgFunction",
-                                NAPI_AUTO_LENGTH,
-                                OneArgFunction_Core,
-                                nullptr,
-                                &one_arg_function);
-  NAPI_THROW_IF_FAILED(env, status, Napi::Object());
-
-  status = napi_create_function(env,
-                                "twoArgFunction",
-                                NAPI_AUTO_LENGTH,
-                                TwoArgFunction_Core,
-                                nullptr,
-                                &two_arg_function);
-  NAPI_THROW_IF_FAILED(env, status, Napi::Object());
-
-  status = napi_create_function(env,
-                                "threeArgFunction",
-                                NAPI_AUTO_LENGTH,
-                                ThreeArgFunction_Core,
-                                nullptr,
-                                &three_arg_function);
-  NAPI_THROW_IF_FAILED(env, status, Napi::Object());
-
-  status = napi_create_function(env,
-                                "fourArgFunction",
-                                NAPI_AUTO_LENGTH,
-                                FourArgFunction_Core,
-                                nullptr,
-                                &four_arg_function);
-  NAPI_THROW_IF_FAILED(env, status, Napi::Object());
-
-  Napi::Object core = Napi::Object::New(env);
-  core["noArgFunction"] = Napi::Value(env, no_arg_function);
-  core["oneArgFunction"] = Napi::Value(env, one_arg_function);
-  core["twoArgFunction"] = Napi::Value(env, two_arg_function);
-  core["threeArgFunction"] = Napi::Value(env, three_arg_function);
-  core["fourArgFunction"] = Napi::Value(env, four_arg_function);
-  exports["core"] = core;
-
-  Napi::Object cplusplus = Napi::Object::New(env);
-  cplusplus["noArgFunction"] = Napi::Function::New(env, NoArgFunction);
-  cplusplus["oneArgFunction"] = Napi::Function::New(env, OneArgFunction);
-  cplusplus["twoArgFunction"] = Napi::Function::New(env, TwoArgFunction);
-  cplusplus["threeArgFunction"] = Napi::Function::New(env, ThreeArgFunction);
-  cplusplus["fourArgFunction"] = Napi::Function::New(env, FourArgFunction);
-  exports["cplusplus"] = cplusplus;
-
-  Napi::Object templated = Napi::Object::New(env);
-  templated["noArgFunction"] = Napi::Function::New<NoArgFunction>(env);
-  templated["oneArgFunction"] = Napi::Function::New<OneArgFunction>(env);
-  templated["twoArgFunction"] = Napi::Function::New<TwoArgFunction>(env);
-  templated["threeArgFunction"] = Napi::Function::New<ThreeArgFunction>(env);
-  templated["fourArgFunction"] = Napi::Function::New<FourArgFunction>(env);
-  exports["templated"] = templated;
-
-#if NAPI_VERSION > 5
-  FunctionArgsBenchmark::Init(env, exports);
-#endif  // NAPI_VERSION > 5
-
-  return exports;
-}
-
-NODE_API_MODULE(NODE_GYP_MODULE_NAME, Init)

package/vendor/node-addon-api/benchmark/function_args.js

@@ -1,60 +0,0 @@
-const path = require('path');
-const Benchmark = require('benchmark');
-const addonName = path.basename(__filename, '.js');
-
-[addonName, addonName + '_noexcept']
-  .forEach((addonName) => {
-    const rootAddon = require('bindings')({
-      bindings: addonName,
-      module_root: __dirname
-    });
-    delete rootAddon.path;
-    const implems = Object.keys(rootAddon);
-    const maxNameLength =
-      implems.reduce((soFar, value) => Math.max(soFar, value.length), 0);
-    const anObject = {};
-
-    console.log(`\n${addonName}: `);
-
-    console.log('no arguments:');
-    implems.reduce((suite, implem) => {
-      const fn = rootAddon[implem].noArgFunction;
-      return suite.add(implem.padStart(maxNameLength, ' '), () => fn());
-    }, new Benchmark.Suite())
-      .on('cycle', (event) => console.log(String(event.target)))
-      .run();
-
-    console.log('one argument:');
-    implems.reduce((suite, implem) => {
-      const fn = rootAddon[implem].oneArgFunction;
-      return suite.add(implem.padStart(maxNameLength, ' '), () => fn('x'));
-    }, new Benchmark.Suite())
-      .on('cycle', (event) => console.log(String(event.target)))
-      .run();
-
-    console.log('two arguments:');
-    implems.reduce((suite, implem) => {
-      const fn = rootAddon[implem].twoArgFunction;
-      return suite.add(implem.padStart(maxNameLength, ' '), () => fn('x', 12));
-    }, new Benchmark.Suite())
-      .on('cycle', (event) => console.log(String(event.target)))
-      .run();
-
-    console.log('three arguments:');
-    implems.reduce((suite, implem) => {
-      const fn = rootAddon[implem].threeArgFunction;
-      return suite.add(implem.padStart(maxNameLength, ' '),
-        () => fn('x', 12, true));
-    }, new Benchmark.Suite())
-      .on('cycle', (event) => console.log(String(event.target)))
-      .run();
-
-    console.log('four arguments:');
-    implems.reduce((suite, implem) => {
-      const fn = rootAddon[implem].fourArgFunction;
-      return suite.add(implem.padStart(maxNameLength, ' '),
-        () => fn('x', 12, true, anObject));
-    }, new Benchmark.Suite())
-      .on('cycle', (event) => console.log(String(event.target)))
-      .run();
-  });

package/vendor/node-addon-api/benchmark/index.js

@@ -1,34 +0,0 @@
-'use strict';
-
-const { readdirSync } = require('fs');
-const { spawnSync } = require('child_process');
-const path = require('path');
-
-let benchmarks = [];
-
-if (process.env.npm_config_benchmarks) {
-  benchmarks = process.env.npm_config_benchmarks
-    .split(';')
-    .map((item) => (item + '.js'));
-}
-
-// Run each file in this directory or the list given on the command line except
-// index.js as a Node.js process.
-(benchmarks.length > 0 ? benchmarks : readdirSync(__dirname))
-  .filter((item) => (item !== 'index.js' && item.match(/\.js$/)))
-  .map((item) => path.join(__dirname, item))
-  .forEach((item) => {
-    const child = spawnSync(process.execPath, [
-      '--expose-gc',
-      item
-    ], { stdio: 'inherit' });
-    if (child.signal) {
-      console.error(`Tests aborted with ${child.signal}`);
-      process.exitCode = 1;
-    } else {
-      process.exitCode = child.status;
-    }
-    if (child.status !== 0) {
-      process.exit(process.exitCode);
-    }
-  });