koffi 0.9.34 → 0.9.37

package/src/parser.hh

@@ -0,0 +1,63 @@
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see https://www.gnu.org/licenses/.
+
+#pragma once
+
+#include "vendor/libcc/libcc.hh"
+#include "util.hh"
+
+#include <napi.h>
+
+namespace RG {
+
+struct InstanceData;
+struct TypeInfo;
+struct FunctionInfo;
+
+class PrototypeParser {
+    Napi::Env env;
+    InstanceData *instance;
+
+    // All these members are relevant to the current parse only, and get resetted each time
+    HeapArray<Span<const char>> tokens;
+    Size offset;
+    bool valid;
+
+public:
+    PrototypeParser(Napi::Env env) : env(env), instance(env.GetInstanceData<InstanceData>()) {}
+
+    bool Parse(Napi::String proto, FunctionInfo *func);
+
+private:
+    void Tokenize(const char *str);
+
+    const TypeInfo *ParseType();
+    const char *ParseIdentifier();
+
+    bool Consume(const char *expect);
+    bool Match(const char *expect);
+
+    bool IsIdentifier(Span<const char> tok) const;
+
+    template <typename... Args>
+    void MarkError(const char *fmt, Args... args)
+    {
+        if (valid) {
+            ThrowError<Napi::Error>(env, fmt, args...);
+            valid = false;
+        }
+        valid = false;
+    }
+};
+
+}

package/src/util.cc

@@ -54,6 +54,29 @@ const TypeInfo *ResolveType(const InstanceData *instance, Napi::Value value, int
     }
 }
 
+const TypeInfo *GetPointerType(InstanceData *instance, const TypeInfo *ref)
+{
+    char name_buf[256];
+    Fmt(name_buf, "%1%2*", ref->name, ref->primitive == PrimitiveKind::Pointer ? "" : " ");
+
+    TypeInfo *type = instance->types_map.FindValue(name_buf, nullptr);
+
+    if (!type) {
+        type = instance->types.AppendDefault();
+
+        type->name = DuplicateString(name_buf, &instance->str_alloc).ptr;
+
+        type->primitive = PrimitiveKind::Pointer;
+        type->size = RG_SIZE(void *);
+        type->align = RG_SIZE(void *);
+        type->ref = ref;
+
+        instance->types_map.Set(type);
+    }
+
+    return type;
+}
+
 const char *GetValueType(const InstanceData *instance, Napi::Value value)
 {
     for (const TypeInfo &type: instance->types) {

package/src/util.hh

@@ -20,6 +20,8 @@
 namespace RG {
 
 struct InstanceData;
+struct TypeInfo;
+struct FunctionInfo;
 
 template <typename T, typename... Args>
 void ThrowError(Napi::Env env, const char *msg, Args... args)
@@ -52,6 +54,7 @@ static inline T *AlignDown(T *ptr, Size align)
 }
 
 const TypeInfo *ResolveType(const InstanceData *instance, Napi::Value value, int *out_directions = nullptr);
+const TypeInfo *GetPointerType(InstanceData *instance, const TypeInfo *type);
 
 // Can be slow, only use for error messages
 const char *GetValueType(const InstanceData *instance, Napi::Value value);

package/test/registry/machines.json

@@ -21,6 +21,13 @@
             "shutdown": "sudo poweroff"
         },
 
+        "builds": {
+            "Linux ARM32": {
+                "directory": "/home/debian/luigi",
+                "build": "node ../cnoke/cnoke.js"
+            }
+        },
+
         "tests": {
             "Linux ARM32": {
                 "directory": "/home/debian/luigi",
@@ -58,6 +65,13 @@
             "shutdown": "sudo poweroff"
         },
 
+        "builds": {
+            "Linux ARM64": {
+                "directory": "/home/debian/luigi",
+                "build": "node ../cnoke/cnoke.js"
+            }
+        },
+
         "tests": {
             "Linux ARM64": {
                 "directory": "/home/debian/luigi",
@@ -95,6 +109,13 @@
             "shutdown": "sudo poweroff"
         },
 
+        "builds": {
+            "Linux i386": {
+                "directory": "/home/debian/luigi",
+                "build": "node ../cnoke/cnoke.js"
+            }
+        },
+
         "tests": {
             "Linux i386": {
                 "directory": "/home/debian/luigi",
@@ -132,6 +153,13 @@
             "shutdown": "sudo poweroff"
         },
 
+        "builds": {
+            "Linux x64": {
+                "directory": "/home/debian/luigi",
+                "build": "node ../cnoke/cnoke.js"
+            }
+        },
+
         "tests": {
             "Linux x64": {
                 "directory": "/home/debian/luigi",
@@ -169,6 +197,20 @@
             "shutdown": "shutdown -s -t 0"
         },
 
+        "builds": {
+            "Windows i386": {
+                "arch": "ia32",
+                "directory": "C:/Users/windows/Desktop/luigi32",
+                "build": "C:\\Node32\\node32.cmd node ../cnoke/cnoke.js"
+            },
+
+            "Windows x64": {
+                "arch": "x64",
+                "directory": "C:/Users/windows/Desktop/luigi64",
+                "build": "C:\\Node64\\node64.cmd node ../cnoke/cnoke.js"
+            }
+        },
+
         "tests": {
             "Windows i386": {
                 "directory": "C:/Users/windows/Desktop/luigi32",
@@ -218,6 +260,13 @@
             "shutdown": "sudo poweroff"
         },
 
+        "builds": {
+            "FreeBSD x64": {
+                "directory": "/home/freebsd/luigi",
+                "build": "node ../cnoke/cnoke.js"
+            }
+        },
+
         "tests": {
             "FreeBSD x64": {
                 "directory": "/home/freebsd/luigi",
@@ -255,6 +304,13 @@
             "shutdown": "sudo poweroff"
         },
 
+        "builds": {
+            "FreeBSD i386": {
+                "directory": "/home/freebsd/luigi",
+                "build": "node ../cnoke/cnoke.js"
+            }
+        },
+
         "tests": {
             "FreeBSD i386": {
                 "directory": "/home/freebsd/luigi",
@@ -292,6 +348,13 @@
             "shutdown": "sudo poweroff"
         },
 
+        "builds": {
+            "FreeBSD ARM64": {
+                "directory": "/home/freebsd/luigi",
+                "build": "node ../cnoke/cnoke.js"
+            }
+        },
+
         "tests": {
             "FreeBSD ARM64": {
                 "directory": "/home/freebsd/luigi",
@@ -329,6 +392,13 @@
             "shutdown": "sudo shutdown -h now"
         },
 
+        "builds": {
+            "macOS x64": {
+                "directory": "/Users/macos/luigi",
+                "build": "PATH=/usr/local/bin:/usr/bin:/bin SDKROOT=/Library/Developer/CommandLineTools/SDKs/MacOSX11.3.sdk node ../cnoke/cnoke.js"
+            }
+        },
+
         "tests": {
             "macOS x64": {
                 "directory": "/Users/macos/luigi",

package/test/test.js

@@ -24,6 +24,7 @@ const { spawn, spawnSync } = require('child_process');
 const { NodeSSH } = require('node-ssh');
 const chalk = require('chalk');
 const minimatch = require('minimatch');
+const tar = require('tar');
 
 // Globals
 
@@ -56,6 +57,7 @@ async function main() {
 
         if (process.argv.length >= 3 && process.argv[2][0] != '-') {
             switch (process.argv[2]) {
+                case 'pack': { command = pack; i++ } break;
                 case 'test': { command = test; i++; } break;
                 case 'start': { command = start; i++; } break;
                 case 'stop': { command = stop; i++; } break;
@@ -189,6 +191,7 @@ function print_usage() {
 
 Commands:
     test                         Run the machines and perform the tests (default)
+    pack                         Use machines to package prebuilt Koffi binaries
     start                        Start the machines but don't run anythingh
     stop                         Stop running machines
     info                         Print basic information about machine
@@ -261,10 +264,109 @@ async function start(detach = true) {
     return success;
 }
 
-async function test() {
+async function pack() {
+    let success = true;
+
+    success &= await start(false);
+    success &= await copy(machine => Object.values(machine.builds).map(build => build.directory));
+
+    console.log('>> Run build commands...');
+    await Promise.all(machines.map(async machine => {
+        if (ignore.has(machine))
+            return;
+
+        await Promise.all(Object.keys(machine.builds).map(async suite => {
+            let build = machine.builds[suite];
+
+            let cmd = build.build;
+            let cwd = build.directory + '/koffi';
+
+            let start = process.hrtime.bigint();
+            let ret = await exec_remote(machine, cmd, cwd);
+            let time = Number((process.hrtime.bigint() - start) / 1000000n);
+
+            if (ret.code == 0) {
+                log(machine, `${suite} > Build`, chalk.bold.green(`[${(time / 1000).toFixed(2)}s]`));
+            } else {
+                log(machine, `${suite} > Build`, chalk.bold.red('[error]'));
+
+                if (ret.stdout || ret.stderr)
+                    console.error('');
+
+                let align = log.align + 9;
+                if (ret.stdout) {
+                    let str = ' '.repeat(align) + 'Standard output:\n' +
+                              chalk.yellow(ret.stdout.replace(/^/gm, ' '.repeat(align + 4))) + '\n';
+                    console.error(str);
+                }
+                if (ret.stderr) {
+                    let str = ' '.repeat(align) + 'Standard error:\n' +
+                              chalk.yellow(ret.stderr.replace(/^/gm, ' '.repeat(align + 4))) + '\n';
+                    console.error(str);
+                }
+
+                success = false;
+            }
+        }));
+    }));
+
+    console.log('>> Get build artifacts');
+    {
+        let json = fs.readFileSync(root_dir + '/koffi/package.json', { encoding: 'utf-8' });
+        let version = JSON.parse(json).version;
+
+        await Promise.all(machines.map(async machine => {
+            if (ignore.has(machine))
+                return;
+
+            let copied = true;
+
+            await Promise.all(Object.keys(machine.builds).map(async suite => {
+                let build = machine.builds[suite];
+
+                let platform = build.platform || machine.info.platform;
+                let arch = build.arch || machine.info.arch;
+
+                let src_dir = build.directory + '/koffi/build';
+                let dest_dir = root_dir + `/koffi/build/qemu/${version}/koffi_${platform}_${arch}`;
+
+                fs.mkdirSync(dest_dir + '/build', { mode: 0o755, recursive: true });
+
+                try {
+                    await machine.ssh.getDirectory(dest_dir + '/build', src_dir, {
+                        recursive: false,
+                        concurrency: 4
+                    });
+
+                    tar.c({
+                        gzip: true,
+                        file: dest_dir + '.tar.gz',
+                        sync: true,
+                        cwd: dest_dir + '/..'
+                    }, [path.basename(dest_dir)]);
+                } catch (err) {
+                    console.log(err);
+                    ignore.add(machine);
+                    success = false;
+                    copied = false;
+                }
+            }));
+
+            let status = copied ? chalk.bold.green('[ok]') : chalk.bold.red('[error]');
+            log(machine, 'Download', status);
+        }));
+    }
+
+    if (machines.some(machine => machine.started))
+        success &= await stop(false);
+
+    return success;
+}
+
+async function copy(func) {
     let success = true;
 
-    let snapshot_dir = fs.mkdtempSync(path.join(os.tmpdir(), 'luigi-'));
+    let snapshot_dir = fs.mkdtempSync(path.join(os.tmpdir(), 'luigi_'));
     process.on('exit', () => unlink_recursive(snapshot_dir));
 
     console.log('>> Snapshot code...');
@@ -279,8 +381,6 @@ async function test() {
                basename !== 'luiggi';
     });
 
-    success &= await start(false);
-
     console.log('>> Copy source code...');
     await Promise.all(machines.map(async machine => {
         if (ignore.has(machine))
@@ -288,15 +388,15 @@ async function test() {
 
         let copied = true;
 
-        for (let test of Object.values(machine.tests)) {
+        for (let directory of func(machine)) {
             try {
-                await machine.ssh.exec('rm', ['-rf', test.directory]);
+                await machine.ssh.exec('rm', ['-rf', directory]);
             } catch (err) {
                 // Fails often on Windows (busy directory or whatever), but rarely a problem
             }
 
             try {
-                await machine.ssh.putDirectory(snapshot_dir, test.directory, {
+                await machine.ssh.putDirectory(snapshot_dir, directory, {
                     recursive: true,
                     concurrency: 4
                 });
@@ -311,6 +411,15 @@ async function test() {
         log(machine, 'Copy', status);
     }));
 
+    return success;
+}
+
+async function test() {
+    let success = true;
+
+    success &= await start(false);
+    success &= await copy(machine => Object.values(machine.tests).map(test => test.directory));
+
     console.log('>> Run test commands...');
     await Promise.all(machines.map(async machine => {
         if (ignore.has(machine))

package/test/tests/misc.js

@@ -69,25 +69,25 @@ async function test() {
     let lib_filename = path.dirname(__filename) + '/../build/misc' + koffi.extension;
     let lib = koffi.load(lib_filename);
 
-    const FillPack1 = lib.cdecl('FillPack1', 'void', ['int', koffi.out(koffi.pointer(Pack1))]);
-    const RetPack1 = lib.cdecl('RetPack1', Pack1, ['int']);
+    const FillPack1 = lib.func('FillPack1', 'void', ['int', koffi.out(koffi.pointer(Pack1))]);
+    const RetPack1 = lib.func('RetPack1', Pack1, ['int']);
     const AddPack1 = lib.fastcall('AddPack1', 'void', ['int', koffi.inout(koffi.pointer(Pack1))]);
-    const FillPack2 = lib.cdecl('FillPack2', 'void', ['int', 'int', koffi.out(koffi.pointer(Pack2))]);
-    const RetPack2 = lib.cdecl('RetPack2', Pack2, ['int', 'int']);
+    const FillPack2 = lib.func('FillPack2', 'void', ['int', 'int', koffi.out(koffi.pointer(Pack2))]);
+    const RetPack2 = lib.func('RetPack2', Pack2, ['int', 'int']);
     const AddPack2 = lib.fastcall('AddPack2', 'void', ['int', 'int', koffi.inout(koffi.pointer(Pack2))]);
-    const FillPack3 = lib.cdecl('FillPack3', 'void', ['int', 'int', 'int', koffi.out(koffi.pointer(Pack3))]);
-    const RetPack3 = lib.cdecl('RetPack3', Pack3, ['int', 'int', 'int']);
+    const FillPack3 = lib.func('FillPack3', 'void', ['int', 'int', 'int', koffi.out(koffi.pointer(Pack3))]);
+    const RetPack3 = lib.func('RetPack3', Pack3, ['int', 'int', 'int']);
     const AddPack3 = lib.fastcall('AddPack3', 'void', ['int', 'int', 'int', koffi.inout(koffi.pointer(Pack3))]);
-    const ConcatenateToInt1 = lib.cdecl('ConcatenateToInt1', 'int64_t', Array(12).fill('int8_t'));
-    const ConcatenateToInt4 = lib.cdecl('ConcatenateToInt4', 'int64_t', Array(12).fill('int32_t'));
-    const ConcatenateToInt8 = lib.cdecl('ConcatenateToInt8', 'int64_t', Array(12).fill('int64_t'));
-    const ConcatenateToStr1 = lib.cdecl('ConcatenateToStr1', 'string', [...Array(8).fill('int8_t'), koffi.struct('IJK1', {i: 'int8_t', j: 'int8_t', k: 'int8_t'}), 'int8_t']);
-    const ConcatenateToStr4 = lib.cdecl('ConcatenateToStr4', 'string', [...Array(8).fill('int32_t'), koffi.pointer(koffi.struct('IJK4', {i: 'int32_t', j: 'int32_t', k: 'int32_t'})), 'int32_t']);
-    const ConcatenateToStr8 = lib.cdecl('ConcatenateToStr8', 'string', [...Array(8).fill('int64_t'), koffi.struct('IJK8', {i: 'int64_t', j: 'int64_t', k: 'int64_t'}), 'int64_t']);
-    const MakeBFG = lib.stdcall('MakeBFG', BFG, [koffi.out(koffi.pointer(BFG)), 'int', 'double', 'string']);
-    const MakePackedBFG = lib.fastcall('MakePackedBFG', PackedBFG, ['int', 'double', koffi.out(koffi.pointer(PackedBFG)), 'string']);
-    const ReturnBigString = lib.stdcall('ReturnBigString', 'string', ['string']);
-    const PrintFmt = lib.cdecl('PrintFmt', 'string', ['string', '...']);
+    const ConcatenateToInt1 = lib.func('ConcatenateToInt1', 'int64_t', Array(12).fill('int8_t'));
+    const ConcatenateToInt4 = lib.func('ConcatenateToInt4', 'int64_t', Array(12).fill('int32_t'));
+    const ConcatenateToInt8 = lib.func('ConcatenateToInt8', 'int64_t', Array(12).fill('int64_t'));
+    const ConcatenateToStr1 = lib.func('ConcatenateToStr1', 'string', [...Array(8).fill('int8_t'), koffi.struct('IJK1', {i: 'int8_t', j: 'int8_t', k: 'int8_t'}), 'int8_t']);
+    const ConcatenateToStr4 = lib.func('ConcatenateToStr4', 'string', [...Array(8).fill('int32_t'), koffi.pointer(koffi.struct('IJK4', {i: 'int32_t', j: 'int32_t', k: 'int32_t'})), 'int32_t']);
+    const ConcatenateToStr8 = lib.func('ConcatenateToStr8', 'string', [...Array(8).fill('int64_t'), koffi.struct('IJK8', {i: 'int64_t', j: 'int64_t', k: 'int64_t'}), 'int64_t']);
+    const MakeBFG = lib.func('BFG __stdcall MakeBFG(_Out_ BFG *p, int x, double y, const char *str)');
+    const MakePackedBFG = lib.func('PackedBFG __fastcall MakePackedBFG(int x, double y, _Out_ PackedBFG *p, const char *str)');
+    const ReturnBigString = lib.func('const char * __stdcall ReturnBigString(const char *str)');
+    const PrintFmt = lib.func('const char *PrintFmt(const char *fmt, ...)');
 
     // Simple tests with Pack1
     {

package/test/tests/raylib.js

@@ -86,14 +86,14 @@ async function test() {
     let lib_filename = path.dirname(__filename) + '/../build/raylib' + koffi.extension;
     let lib = koffi.load(lib_filename);
 
-    const InitWindow = lib.cdecl('InitWindow', 'void', ['int', 'int', 'string']);
-    const SetTraceLogLevel = lib.cdecl('SetTraceLogLevel', 'void', ['int']);
-    const SetWindowState = lib.cdecl('SetWindowState', 'void', ['uint']);
-    const GenImageColor = lib.cdecl('GenImageColor', Image, ['int', 'int', Color]);
-    const GetFontDefault = lib.cdecl('GetFontDefault', Font, []);
-    const MeasureTextEx = lib.cdecl('MeasureTextEx', Vector2, [Font, 'string', 'float', 'float']);
-    const ImageDrawTextEx = lib.cdecl('ImageDrawTextEx', 'void', [koffi.pointer(Image), Font, 'string', Vector2, 'float', 'float', Color]);
-    const ExportImage = lib.cdecl('ExportImage', 'bool', [Image, 'string']);
+    const InitWindow = lib.func('InitWindow', 'void', ['int', 'int', 'string']);
+    const SetTraceLogLevel = lib.func('SetTraceLogLevel', 'void', ['int']);
+    const SetWindowState = lib.func('SetWindowState', 'void', ['uint']);
+    const GenImageColor = lib.func('GenImageColor', Image, ['int', 'int', Color]);
+    const GetFontDefault = lib.func('GetFontDefault', Font, []);
+    const MeasureTextEx = lib.func('MeasureTextEx', Vector2, [Font, 'string', 'float', 'float']);
+    const ImageDrawTextEx = lib.func('ImageDrawTextEx', 'void', [koffi.pointer(Image), Font, 'string', Vector2, 'float', 'float', Color]);
+    const ExportImage = lib.func('ExportImage', 'bool', [Image, 'string']);
 
     // We need to call InitWindow before using anything else (such as fonts)
     SetTraceLogLevel(4); // Warnings

package/test/tests/sqlite.js

@@ -39,15 +39,15 @@ async function test() {
     let lib_filename = path.dirname(__filename) + '/../build/sqlite3' + koffi.extension;
     let lib = koffi.load(lib_filename);
 
-    const sqlite3_open_v2 = lib.cdecl('sqlite3_open_v2', 'int', ['string', koffi.out(koffi.pointer(sqlite3_db)), 'int', 'string']);
-    const sqlite3_exec = lib.cdecl('sqlite3_exec', 'int', [sqlite3_db, 'string', 'void *', 'void *', 'void *']);
-    const sqlite3_prepare_v2 = lib.cdecl('sqlite3_prepare_v2', 'int', [sqlite3_db, 'string', 'int', koffi.out(koffi.pointer(sqlite3_stmt)), 'string']);
-    const sqlite3_reset = lib.cdecl('sqlite3_reset', 'int', [sqlite3_stmt]);
-    const sqlite3_bind_text = lib.cdecl('sqlite3_bind_text', 'int', [sqlite3_stmt, 'int', 'string', 'int', 'void *']);
-    const sqlite3_bind_int = lib.cdecl('sqlite3_bind_int', 'int', [sqlite3_stmt, 'int', 'int']);
-    const sqlite3_step = lib.cdecl('sqlite3_step', 'int', [sqlite3_stmt]);
-    const sqlite3_finalize = lib.cdecl('sqlite3_finalize', 'int', [sqlite3_stmt]);
-    const sqlite3_close_v2 = lib.cdecl('sqlite3_close_v2', 'int', [sqlite3_db]);
+    const sqlite3_open_v2 = lib.func('sqlite3_open_v2', 'int', ['string', koffi.out(koffi.pointer(sqlite3_db)), 'int', 'string']);
+    const sqlite3_exec = lib.func('sqlite3_exec', 'int', [sqlite3_db, 'string', 'void *', 'void *', 'void *']);
+    const sqlite3_prepare_v2 = lib.func('sqlite3_prepare_v2', 'int', [sqlite3_db, 'string', 'int', koffi.out(koffi.pointer(sqlite3_stmt)), 'string']);
+    const sqlite3_reset = lib.func('sqlite3_reset', 'int', [sqlite3_stmt]);
+    const sqlite3_bind_text = lib.func('sqlite3_bind_text', 'int', [sqlite3_stmt, 'int', 'string', 'int', 'void *']);
+    const sqlite3_bind_int = lib.func('sqlite3_bind_int', 'int', [sqlite3_stmt, 'int', 'int']);
+    const sqlite3_step = lib.func('sqlite3_step', 'int', [sqlite3_stmt]);
+    const sqlite3_finalize = lib.func('sqlite3_finalize', 'int', [sqlite3_stmt]);
+    const sqlite3_close_v2 = lib.func('sqlite3_close_v2', 'int', [sqlite3_db]);
 
     let filename = await create_temporary_file(path.join(os.tmpdir(), 'test_sqlite'));
     let db = {};

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

@@ -0,0 +1,4 @@
+# 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

@@ -0,0 +1,93 @@
+
+# Developer's Certificate of Origin 1.1
+
+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.
+
+# **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**:
+- Source code fixes
+- Additional tests
+- Documentation improvements
+- Joining the Node-API working group and participating in meetings
+
+## 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 merge. 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 different approaches with regards 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 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 which contains the utility classes
+and methods. This has the benefit of having a separate module where helpers
+which 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 is hard, and module
+authors might not find 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

@@ -0,0 +1,37 @@
+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