koffi 1.1.0-beta.1 → 1.1.0-beta.4

package/vendor/node-addon-api/package.json

@@ -0,0 +1,415 @@
+{
+  "bugs": {
+    "url": "https://github.com/nodejs/node-addon-api/issues"
+  },
+  "contributors": [
+    {
+      "name": "Abhishek Kumar Singh",
+      "url": "https://github.com/abhi11210646"
+    },
+    {
+      "name": "Alba Mendez",
+      "url": "https://github.com/jmendeth"
+    },
+    {
+      "name": "Alexander Floh",
+      "url": "https://github.com/alexanderfloh"
+    },
+    {
+      "name": "András Timár, Dr",
+      "url": "https://github.com/timarandras"
+    },
+    {
+      "name": "Andrew Petersen",
+      "url": "https://github.com/kirbysayshi"
+    },
+    {
+      "name": "Anisha Rohra",
+      "url": "https://github.com/anisha-rohra"
+    },
+    {
+      "name": "Anna Henningsen",
+      "url": "https://github.com/addaleax"
+    },
+    {
+      "name": "Arnaud Botella",
+      "url": "https://github.com/BotellaA"
+    },
+    {
+      "name": "Arunesh Chandra",
+      "url": "https://github.com/aruneshchandra"
+    },
+    {
+      "name": "Azlan Mukhtar",
+      "url": "https://github.com/azlan"
+    },
+    {
+      "name": "Ben Berman",
+      "url": "https://github.com/rivertam"
+    },
+    {
+      "name": "Benjamin Byholm",
+      "url": "https://github.com/kkoopa"
+    },
+    {
+      "name": "Bill Gallafent",
+      "url": "https://github.com/gallafent"
+    },
+    {
+      "name": "blagoev",
+      "url": "https://github.com/blagoev"
+    },
+    {
+      "name": "Bruce A. MacNaughton",
+      "url": "https://github.com/bmacnaughton"
+    },
+    {
+      "name": "Cory Mickelson",
+      "url": "https://github.com/corymickelson"
+    },
+    {
+      "name": "Daniel Bevenius",
+      "url": "https://github.com/danbev"
+    },
+    {
+      "name": "Darshan Sen",
+      "url": "https://github.com/RaisinTen"
+    },
+    {
+      "name": "David Halls",
+      "url": "https://github.com/davedoesdev"
+    },
+    {
+      "name": "Deepak Rajamohan",
+      "url": "https://github.com/deepakrkris"
+    },
+    {
+      "name": "Dmitry Ashkadov",
+      "url": "https://github.com/dmitryash"
+    },
+    {
+      "name": "Dongjin Na",
+      "url": "https://github.com/nadongguri"
+    },
+    {
+      "name": "Doni Rubiagatra",
+      "url": "https://github.com/rubiagatra"
+    },
+    {
+      "name": "Eric Bickle",
+      "url": "https://github.com/ebickle"
+    },
+    {
+      "name": "extremeheat",
+      "url": "https://github.com/extremeheat"
+    },
+    {
+      "name": "Ferdinand Holzer",
+      "url": "https://github.com/fholzer"
+    },
+    {
+      "name": "Gabriel Schulhof",
+      "url": "https://github.com/gabrielschulhof"
+    },
+    {
+      "name": "Guenter Sandner",
+      "url": "https://github.com/gms1"
+    },
+    {
+      "name": "Gus Caplan",
+      "url": "https://github.com/devsnek"
+    },
+    {
+      "name": "Helio Frota",
+      "url": "https://github.com/helio-frota"
+    },
+    {
+      "name": "Hitesh Kanwathirtha",
+      "url": "https://github.com/digitalinfinity"
+    },
+    {
+      "name": "ikokostya",
+      "url": "https://github.com/ikokostya"
+    },
+    {
+      "name": "Jack Xia",
+      "url": "https://github.com/JckXia"
+    },
+    {
+      "name": "Jake Barnes",
+      "url": "https://github.com/DuBistKomisch"
+    },
+    {
+      "name": "Jake Yoon",
+      "url": "https://github.com/yjaeseok"
+    },
+    {
+      "name": "Jason Ginchereau",
+      "url": "https://github.com/jasongin"
+    },
+    {
+      "name": "Jeroen Janssen",
+      "url": "https://github.com/japj"
+    },
+    {
+      "name": "Jim Schlight",
+      "url": "https://github.com/jschlight"
+    },
+    {
+      "name": "Jinho Bang",
+      "url": "https://github.com/romandev"
+    },
+    {
+      "name": "José Expósito",
+      "url": "https://github.com/JoseExposito"
+    },
+    {
+      "name": "joshgarde",
+      "url": "https://github.com/joshgarde"
+    },
+    {
+      "name": "Kasumi Hanazuki",
+      "url": "https://github.com/hanazuki"
+    },
+    {
+      "name": "Kelvin",
+      "url": "https://github.com/kelvinhammond"
+    },
+    {
+      "name": "Kevin Eady",
+      "url": "https://github.com/KevinEady"
+    },
+    {
+      "name": "Kévin VOYER",
+      "url": "https://github.com/kecsou"
+    },
+    {
+      "name": "kidneysolo",
+      "url": "https://github.com/kidneysolo"
+    },
+    {
+      "name": "Koki Nishihara",
+      "url": "https://github.com/Nishikoh"
+    },
+    {
+      "name": "Konstantin Tarkus",
+      "url": "https://github.com/koistya"
+    },
+    {
+      "name": "Kyle Farnung",
+      "url": "https://github.com/kfarnung"
+    },
+    {
+      "name": "legendecas",
+      "url": "https://github.com/legendecas"
+    },
+    {
+      "name": "LongYinan",
+      "url": "https://github.com/Brooooooklyn"
+    },
+    {
+      "name": "Lovell Fuller",
+      "url": "https://github.com/lovell"
+    },
+    {
+      "name": "Luciano Martorella",
+      "url": "https://github.com/lmartorella"
+    },
+    {
+      "name": "mastergberry",
+      "url": "https://github.com/mastergberry"
+    },
+    {
+      "name": "Mathias Küsel",
+      "url": "https://github.com/mathiask88"
+    },
+    {
+      "name": "Matteo Collina",
+      "url": "https://github.com/mcollina"
+    },
+    {
+      "name": "Michael Dawson",
+      "url": "https://github.com/mhdawson"
+    },
+    {
+      "name": "Michael Price",
+      "url": "https://github.com/mikepricedev"
+    },
+    {
+      "name": "Michele Campus",
+      "url": "https://github.com/kYroL01"
+    },
+    {
+      "name": "Mikhail Cheshkov",
+      "url": "https://github.com/mcheshkov"
+    },
+    {
+      "name": "nempoBu4",
+      "url": "https://github.com/nempoBu4"
+    },
+    {
+      "name": "Nicola Del Gobbo",
+      "url": "https://github.com/NickNaso"
+    },
+    {
+      "name": "Nick Soggin",
+      "url": "https://github.com/iSkore"
+    },
+    {
+      "name": "Nikolai Vavilov",
+      "url": "https://github.com/seishun"
+    },
+    {
+      "name": "Nurbol Alpysbayev",
+      "url": "https://github.com/anurbol"
+    },
+    {
+      "name": "pacop",
+      "url": "https://github.com/pacop"
+    },
+    {
+      "name": "Philipp Renoth",
+      "url": "https://github.com/DaAitch"
+    },
+    {
+      "name": "rgerd",
+      "url": "https://github.com/rgerd"
+    },
+    {
+      "name": "Rolf Timmermans",
+      "url": "https://github.com/rolftimmermans"
+    },
+    {
+      "name": "Ross Weir",
+      "url": "https://github.com/ross-weir"
+    },
+    {
+      "name": "Ryuichi Okumura",
+      "url": "https://github.com/okuryu"
+    },
+    {
+      "name": "Sampson Gao",
+      "url": "https://github.com/sampsongao"
+    },
+    {
+      "name": "Sam Roberts",
+      "url": "https://github.com/sam-github"
+    },
+    {
+      "name": "strager",
+      "url": "https://github.com/strager"
+    },
+    {
+      "name": "Taylor Woll",
+      "url": "https://github.com/boingoing"
+    },
+    {
+      "name": "Thomas Gentilhomme",
+      "url": "https://github.com/fraxken"
+    },
+    {
+      "name": "Tim Rach",
+      "url": "https://github.com/timrach"
+    },
+    {
+      "name": "Tobias Nießen",
+      "url": "https://github.com/tniessen"
+    },
+    {
+      "name": "todoroff",
+      "url": "https://github.com/todoroff"
+    },
+    {
+      "name": "Tux3",
+      "url": "https://github.com/tux3"
+    },
+    {
+      "name": "Vlad Velmisov",
+      "url": "https://github.com/Velmisov"
+    },
+    {
+      "name": "Vladimir Morozov",
+      "url": "https://github.com/vmoroz"
+
+    },
+    {
+      "name": "WenheLI",
+      "url": "https://github.com/WenheLI"
+    },
+    {
+      "name": "Xuguang Mei",
+      "url": "https://github.com/meixg"
+    },
+    {
+      "name": "Yohei Kishimoto",
+      "url": "https://github.com/morokosi"
+    },
+    {
+      "name": "Yulong Wang",
+      "url": "https://github.com/fs-eire"
+    },
+    {
+      "name": "Ziqiu Zhao",
+      "url": "https://github.com/ZzqiZQute"
+    }
+  ],
+  "description": "Node.js API (Node-API)",
+  "devDependencies": {
+    "benchmark": "^2.1.4",
+    "bindings": "^1.5.0",
+    "clang-format": "^1.4.0",
+    "eslint": "^7.32.0",
+    "eslint-config-semistandard": "^16.0.0",
+    "eslint-config-standard": "^16.0.3",
+    "eslint-plugin-import": "^2.24.2",
+    "eslint-plugin-node": "^11.1.0",
+    "eslint-plugin-promise": "^5.1.0",
+    "fs-extra": "^9.0.1",
+    "path": "^0.12.7",
+    "pre-commit": "^1.2.2",
+    "safe-buffer": "^5.1.1"
+  },
+  "directories": {},
+  "gypfile": false,
+  "homepage": "https://github.com/nodejs/node-addon-api",
+  "keywords": [
+    "n-api",
+    "napi",
+    "addon",
+    "native",
+    "bindings",
+    "c",
+    "c++",
+    "nan",
+    "node-addon-api"
+  ],
+  "license": "MIT",
+  "main": "index.js",
+  "name": "node-addon-api",
+  "readme": "README.md",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/nodejs/node-addon-api.git"
+  },
+  "files": [
+    "*.{c,h,gyp,gypi}",
+    "package-support.json",
+    "tools/"
+  ],
+  "scripts": {
+    "prebenchmark": "node-gyp rebuild -C benchmark",
+    "benchmark": "node benchmark",
+    "pretest": "node-gyp rebuild -C test",
+    "test": "node test",
+    "predev": "node-gyp rebuild -C test --debug",
+    "dev": "node test",
+    "predev:incremental": "node-gyp configure build -C test --debug",
+    "dev:incremental": "node test",
+    "doc": "doxygen doc/Doxyfile",
+    "lint": "node tools/eslint-format && node tools/clang-format",
+    "lint:fix": "node tools/clang-format --fix && node tools/eslint-format --fix"
+  },
+  "pre-commit": "lint",
+  "version": "5.0.0",
+  "support": true
+}

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

@@ -0,0 +1,91 @@
+# Writing Tests
+
+There are multiple flavors of node-addon-api test builds that cover different
+build flags defined in `napi.h`:
+
+1. c++ exceptions enabled,
+2. c++ exceptions disabled,
+3. c++ exceptions disabled, and `NODE_ADDON_API_ENABLE_MAYBE` defined.
+
+Functions in node-addon-api that call into JavaScript can have different
+declared return types to reflect build flavor settings. For example,
+`Napi::Object::Set` returns `bool` when `NODE_ADDON_API_ENABLE_MAYBE`
+is not defined, and `Napi::Maybe<bool>` when `NODE_ADDON_API_ENABLE_MAYBE`
+is defined. In source code, return type variants are defined as
+`Napi::MaybeOrValue<>` to prevent the duplication of most of the code base.
+
+To properly test these build flavors, all values returned by a function defined
+to return `Napi::MaybeOrValue<>` should be tested by using one of the following
+test helpers to handle possible JavaScript exceptions.
+
+There are three test helper functions to conveniently convert
+`Napi::MaybeOrValue<>` values to raw values.
+
+## MaybeUnwrap
+
+```cpp
+template <typename T>
+T MaybeUnwrap(MaybeOrValue<T> maybe);
+```
+
+Converts `MaybeOrValue<T>` to `T` by checking that `MaybeOrValue` is NOT an
+empty `Maybe`.
+
+Returns the original value if `NODE_ADDON_API_ENABLE_MAYBE` is not defined.
+
+Example:
+
+```cpp
+Object obj = info[0].As<Object>();
+// we are sure the parameters should not throw
+Value value = MaybeUnwrap(obj->Get("foobar"));
+```
+
+## MaybeUnwrapOr
+
+```cpp
+template <typename T>
+T MaybeUnwrapOr(MaybeOrValue<T> maybe, const T& default_value = T());
+```
+
+Converts `MaybeOrValue<T>` to `T` by getting the value that wrapped by the
+`Maybe` or return the `default_value` if the `Maybe` is empty.
+
+Returns the original value if `NODE_ADDON_API_ENABLE_MAYBE` is not defined.
+
+Example:
+
+```cpp
+Value CallWithArgs(const CallbackInfo& info) {
+  Function func = info[0].As<Function>();
+  // We don't care if the operation is throwing or not, just return it back to node-addon-api
+  return MaybeUnwrapOr(
+      func.Call(std::initializer_list<napi_value>{info[1], info[2], info[3]}));
+}
+```
+
+## MaybeUnwrapTo
+
+```cpp
+template <typename T>
+bool MaybeUnwrapTo(MaybeOrValue<T> maybe, T* out);
+```
+
+Converts `MaybeOrValue<T>` to `T` by getting the value that wrapped by the
+e`Maybe` or return `false` if the Maybe is empty
+
+Copies the `value` to `out` when `NODE_ADDON_API_ENABLE_MAYBE` is not defined
+
+Example:
+
+```cpp
+Object opts = info[0].As<Object>();
+bool hasProperty = false;
+// The check may throw, but we are going to suppress that.
+if (MaybeUnwrapTo(opts.Has("blocking"), &hasProperty)) {
+  isBlocking = hasProperty &&
+                MaybeUnwrap(MaybeUnwrap(opts.Get("blocking")).ToBoolean());
+} else {
+  env.GetAndClearPendingException();
+}
+```

package/vendor/node-addon-api/test/addon.cc

@@ -0,0 +1,36 @@
+#if (NAPI_VERSION > 5)
+#include <stdio.h>
+#include "napi.h"
+
+namespace {
+
+class TestAddon : public Napi::Addon<TestAddon> {
+ public:
+  inline TestAddon(Napi::Env env, Napi::Object exports) {
+    DefineAddon(exports, {
+      InstanceMethod("increment", &TestAddon::Increment),
+      InstanceValue("subObject", DefineProperties(Napi::Object::New(env), {
+        InstanceMethod("decrement", &TestAddon::Decrement)
+      }))
+    });
+  }
+
+ private:
+  Napi::Value Increment(const Napi::CallbackInfo& info) {
+    return Napi::Number::New(info.Env(), ++value);
+  }
+
+  Napi::Value Decrement(const Napi::CallbackInfo& info) {
+    return Napi::Number::New(info.Env(), --value);
+  }
+
+  uint32_t value = 42;
+};
+
+}  // end of anonymous namespace
+
+Napi::Object InitAddon(Napi::Env env) {
+  return TestAddon::Init(env, Napi::Object::New(env));
+}
+
+#endif  // (NAPI_VERSION > 5)

package/vendor/node-addon-api/test/addon.js

@@ -0,0 +1,11 @@
+'use strict';
+
+const assert = require('assert');
+
+module.exports = require('./common').runTest(test);
+
+function test (binding) {
+  assert.strictEqual(binding.addon.increment(), 43);
+  assert.strictEqual(binding.addon.increment(), 44);
+  assert.strictEqual(binding.addon.subObject.decrement(), 43);
+}

package/vendor/node-addon-api/test/addon_build/index.js

@@ -0,0 +1,49 @@
+'use strict';
+
+const { promisify } = require('util');
+const exec = promisify(require('child_process').exec);
+const { copy, remove } = require('fs-extra');
+const path = require('path');
+const assert = require('assert')
+
+const ADDONS_FOLDER = path.join(__dirname, 'addons');
+
+const addons = [
+  'echo addon',
+  'echo-addon'
+]
+
+async function beforeAll(addons) {
+  console.log('   >Preparing native addons to build')
+  for (const addon of addons) {
+    await remove(path.join(ADDONS_FOLDER, addon));
+    await copy(path.join(__dirname, 'tpl'), path.join(ADDONS_FOLDER, addon));
+  }
+}
+
+async function test(addon) {
+  console.log(`   >Building addon: '${addon}'`);
+  const { stderr, stdout } = await exec('npm install', {
+    cwd: path.join(ADDONS_FOLDER, addon)
+  })
+  console.log(`   >Running test for: '${addon}'`);
+  // Disabled the checks on stderr and stdout because of this issue on npm:
+  // Stop using process.umask(): https://github.com/npm/cli/issues/1103
+  // We should enable the following checks again after the resolution of
+  // the reported issue.
+  // assert.strictEqual(stderr, '');
+  // assert.ok(stderr.length === 0);
+  // assert.ok(stdout.length > 0);
+  const binding = require(`${ADDONS_FOLDER}/${addon}`);
+  assert.strictEqual(binding.except.echo('except'), 'except');
+  assert.strictEqual(binding.except.echo(101), 101);
+  assert.strictEqual(binding.noexcept.echo('noexcept'), 'noexcept');
+  assert.strictEqual(binding.noexcept.echo(103), 103);
+}
+
+module.exports = (async function() {
+  await beforeAll(addons);
+  for (const addon of addons) {
+    await test(addon);
+  }
+})()

package/vendor/node-addon-api/test/addon_build/tpl/addon.cc

@@ -0,0 +1,17 @@
+#include <napi.h>
+
+Napi::Value Echo(const Napi::CallbackInfo& info) {
+  Napi::Env env = info.Env();
+  if (info.Length() != 1) {
+    Napi::TypeError::New(env, "Wrong number of arguments. One argument expected.")
+        .ThrowAsJavaScriptException();
+  }
+  return info[0].As<Napi::Value>();
+}
+
+Napi::Object Init(Napi::Env env, Napi::Object exports) {
+  exports.Set(Napi::String::New(env, "echo"), Napi::Function::New(env, Echo));
+  return exports;
+}
+
+NODE_API_MODULE(NODE_GYP_MODULE_NAME, Init)

package/vendor/node-addon-api/test/addon_build/tpl/binding.gyp

@@ -0,0 +1,62 @@
+{
+  'target_defaults': {
+    'include_dirs': [
+        "<!(node -p \"require('node-addon-api').include_dir\")"
+    ],
+    'variables': {
+      'NAPI_VERSION%': "<!(node -p \"process.versions.napi\")",
+      'disable_deprecated': "<!(node -p \"process.env['npm_config_disable_deprecated']\")"
+    },
+    'conditions': [
+      ['NAPI_VERSION!=""', { 'defines': ['NAPI_VERSION=<@(NAPI_VERSION)'] } ],
+      ['disable_deprecated=="true"', {
+        'defines': ['NODE_ADDON_API_DISABLE_DEPRECATED']
+      }],
+      ['OS=="mac"', {
+        'cflags+': ['-fvisibility=hidden'],
+        'xcode_settings': {
+          'OTHER_CFLAGS': ['-fvisibility=hidden']
+        }
+      }]
+    ],
+    'sources': [
+      'addon.cc',
+    ],
+  },
+  'targets': [
+    {
+      'target_name': 'addon',
+      'defines': [ 'NAPI_CPP_EXCEPTIONS' ],
+      'cflags!': [ '-fno-exceptions' ],
+      'cflags_cc!': [ '-fno-exceptions' ],
+      'msvs_settings': {
+        'VCCLCompilerTool': {
+          'ExceptionHandling': 1,
+          'EnablePREfast': 'true',
+        },
+      },
+      'xcode_settings': {
+        'CLANG_CXX_LIBRARY': 'libc++',
+        'MACOSX_DEPLOYMENT_TARGET': '10.7',
+        'GCC_ENABLE_CPP_EXCEPTIONS': 'YES',
+      },
+    },
+    {
+      'target_name': 'addon_noexcept',
+      'defines': [ 'NAPI_DISABLE_CPP_EXCEPTIONS' ],
+      'cflags': [ '-fno-exceptions' ],
+      'cflags_cc': [ '-fno-exceptions' ],
+      'msvs_settings': {
+        'VCCLCompilerTool': {
+          'ExceptionHandling': 0,
+          'EnablePREfast': 'true',
+        },
+      },
+      'xcode_settings': {
+        'CLANG_CXX_LIBRARY': 'libc++',
+        'MACOSX_DEPLOYMENT_TARGET': '10.7',
+        'GCC_ENABLE_CPP_EXCEPTIONS': 'NO',
+      },
+    },
+  ],
+}

package/vendor/node-addon-api/test/addon_build/tpl/index.js

@@ -0,0 +1,9 @@
+'use strict'
+
+const except = require('bindings')('addon')
+const noexcept = require('bindings')('addon_noexcept')
+
+module.exports = {
+  except,
+  noexcept
+}