koffi 2.16.0-beta.2 → 2.16.1

package/vendor/node-api-headers/CREATING_A_RELEASE.md

@@ -1,68 +0,0 @@
-# Creating a release
-
-Only collaborators in npm for **node-api-headers** can create releases. If you
-want to be able to do releases ask one of the existing collaborators to add
-you. If necessary you can ask the build Working Group who manages the Node.js
-npm user to add you if there are no other active collaborators.
-
-Generally, the release is handled by the
-[release-please](https://github.com/nodejs/node-api-headers/blob/main/.github/workflows/release-please.yml)
-GitHub action. It will bump the version in `package.json` and publish
-node-api-headers to npm.
-
-In cases that the release-please action is not working, please follow the steps
-below to publish node-api-headers manually.
-
-## Publish new release manually
-
-### Prerequisites
-
-Before to start creating a new release check if you have installed the following
-tools:
-
-* [Changelog maker](https://www.npmjs.com/package/changelog-maker)
-
-If not please follow the instruction reported in the tool's documentation to
-install it.
-
-### Steps
-
-These are the steps to follow to create a new release:
-
-* Open an issue in the **node-api-headers** repo documenting the intent to
-create a new release. Give people some time to comment or suggest PRs that
-should land first.
-
-* Update the version in **package.json** appropriately.
-
-* Update the [README.md][] to show the latest stable version of Node-API.
-
-* Generate the changelog for the new version using **changelog maker** tool.
-From the root folder of the repo launch the following command:
-
-```bash
-> changelog-maker --format=markdown
-```
-
-* Use the output generated by **changelog maker** to update the
-[CHANGELOG.md][] following the style used in publishing the previous release.
-
-* Add any new contributors to the "contributors" section in the
-**package.json**.
-
-* Do a clean checkout of `node-api-headers`.
-
-* Login and then run `npm publish`.
-
-* Create a release in Github (look at existing releases for an example).
-
-* Validate that you can run `npm install node-api-headers` successfully
-and that the correct version is installed.
-
-* Comment on the issue opened in the first step that the release has been created
-and close the issue.
-
-* Tweet that the release has been created.
-
-[README.md]: ./README.md
-[CHANGELOG.md]: ./CHANGELOG.md

package/vendor/node-api-headers/index.js

@@ -1,17 +0,0 @@
-'use strict'
-
-const path = require('path');
-const symbols = require('./symbols');
-
-const include_dir = path.resolve(__dirname, 'include');
-const defRoot = path.resolve(__dirname, 'def')
-const def_paths = {
-    js_native_api_def: path.join(defRoot, 'js_native_api.def'),
-    node_api_def: path.join(defRoot, 'node_api.def')
-}
-
-module.exports = {
-    include_dir,
-    def_paths,
-    symbols
-}

package/vendor/node-api-headers/lib/clang-utils.js

@@ -1,50 +0,0 @@
-'use strict';
-
-const { spawn } = require('child_process');
-
-/**
- * @param {Array<string>} [args]
- * @returns {Promise<{exitCode: number | null, stdout: string, stderr: string}>}
- */
-async function runClang(args = []) {
-    try {
-        const { exitCode, stdout, stderr } = await new Promise((resolve, reject) => {
-            const spawned = spawn('clang',
-                ['-Xclang', ...args]
-            );
-
-            let stdout = '';
-            let stderr = '';
-
-            spawned.stdout?.on('data', (data) => {
-                stdout += data.toString('utf-8');
-            });
-            spawned.stderr?.on('data', (data) => {
-                stderr += data.toString('utf-8');
-            });
-
-            spawned.on('exit', function (exitCode) {
-                resolve({ exitCode, stdout, stderr });
-            });
-
-            spawned.on('error', function (err) {
-                reject(err);
-            });
-        });
-
-        if (exitCode !== 0) {
-            throw new Error(`clang exited with non-zero exit code ${exitCode}. stderr: ${stderr ? stderr : '<empty>'}`);
-        }
-
-        return { exitCode, stdout, stderr };
-    } catch (err) {
-        if (err.code === 'ENOENT') {
-            throw new Error('This tool requires clang to be installed.');
-        }
-        throw err;
-    }
-}
-
-module.exports = {
-    runClang
-};

package/vendor/node-api-headers/lib/parse-utils.js

@@ -1,92 +0,0 @@
-const parser = require("acorn");
-
-/**
- * @param {string} text Code to evaluate
- * @returns {boolean | undefined} The result of the evaluation, `undefined` if
- * parsing failed or the result is unknown.
- */
-function evaluate(text) {
-    try {
-        const ast = parser.parse(text, { ecmaVersion: 2020 });
-
-        const expressionStatement = ast.body[0];
-
-        if (expressionStatement.type !== "ExpressionStatement") {
-            throw new Error("Expected an ExpressionStatement");
-        }
-
-        return visitExpression(expressionStatement.expression);
-    } catch {
-        // Return an unknown result if parsing failed
-        return undefined;
-    }
-}
-
-/**
- * @param {import("acorn").Expression} node
- */
-const visitExpression = (node) => {
-    if (node.type === "LogicalExpression") {
-        return visitLogicalExpression(node);
-    } else if (node.type === "UnaryExpression") {
-        return visitUnaryExpression(node);
-    } else if (node.type === "CallExpression") {
-        return visitCallExpression(node);
-    } else {
-        throw new Error(`Unknown node type: ${node.type} ${JSON.stringify(node)}`);
-    }
-};
-
-/**
- * @param {import("acorn").LogicalExpression} node
- */
-const visitLogicalExpression = (node) => {
-    const left = visitExpression(node.left);
-    const right = visitExpression(node.right);
-
-    if (node.operator === "&&") {
-        // We can shortcircuit regardless of `unknown` if either are false.
-        if (left === false || right === false) {
-            return false;
-        } else if (left === undefined || right === undefined) {
-            return undefined;
-        } else {
-            return left && right;
-        }
-    } else if (node.operator === "||") {
-        if (left === undefined || right === undefined) {
-            return undefined;
-        } else {
-            return left || right;
-        }
-    }
-};
-
-/**
- * @param {import("acorn").UnaryExpression} node
- */
-const visitUnaryExpression = (node) => {
-    const argument = visitExpression(node.argument);
-    if (typeof argument === 'boolean') {
-        return !argument;
-    }
-};
-
-/**
- * @param {import("acorn").CallExpression} node
- */
-const visitCallExpression = (node) => {
-    const isDefinedExperimentalCall =
-        // is `defined(arg)` call
-        node.callee.type === 'Identifier' && node.callee.name === 'defined' && node.arguments.length == 1
-        // and that arg is `NAPI_EXPERIMENTAL`
-        && node.arguments[0].type === 'Identifier' && node.arguments[0].name === 'NAPI_EXPERIMENTAL';
-
-    if (isDefinedExperimentalCall) {
-        return false;
-    }
-};
-
-module.exports = {
-    evaluate
-};

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

@@ -1,59 +0,0 @@
-{
-  "bugs": {
-    "url": "https://github.com/nodejs/node-api-headers/issues"
-  },
-  "contributors": [
-    {
-      "name": "Gabriel Schulhof",
-      "url": "https://github.com/gabrielschulhof"
-    },
-    {
-      "name": "Jim Schlight",
-      "url": "https://github.com/jschlight"
-    },
-    {
-      "name": "Kevin Eady",
-      "url": "https://github.com/KevinEady"
-    },
-    {
-      "name": "legendecas",
-      "url": "https://github.com/legendecas"
-    },
-    {
-      "name": "Leonid Pospelov",
-      "url": "https://github.com/Pospelove"
-    },
-    {
-      "name": "Michael Dawson",
-      "url": "https://github.com/mhdawson"
-    },
-    {
-      "name": "Nicola Del Gobbo",
-      "url": "https://github.com/NickNaso"
-    }
-  ],
-  "description": "Node-API headers",
-  "devDependencies": {
-    "acorn": "^8.12.1"
-  },
-  "directories": {},
-  "gypfile": false,
-  "homepage": "https://github.com/nodejs/node-api-headers",
-  "keywords": [],
-  "license": "MIT",
-  "main": "index.js",
-  "name": "node-api-headers",
-  "readme": "README.md",
-  "repository": {
-    "type": "git",
-    "url": "git://github.com/nodejs/node-api-headers.git"
-  },
-  "scripts": {
-    "update-headers": "node --no-warnings scripts/update-headers.js",
-    "write-symbols": "node --no-warnings scripts/write-symbols.js",
-    "write-win32-def": "node --no-warnings scripts/write-win32-def.js",
-    "test": "node test/parse-utils.js "
-  },
-  "version": "1.8.0",
-  "support": true
-}

package/vendor/node-api-headers/release-please-config.json

@@ -1,12 +0,0 @@
-{
-    "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
-    "release-type": "node",
-    "pull-request-title-pattern": "chore: release v${version}",
-    "bootstrap-sha": "9d78c7da25c5f90617600e23d2a8e7a23288f1ae",
-    "packages": {
-        ".": {
-            "include-component-in-tag": false,
-            "changelog-path": "CHANGELOG.md"
-        }
-    }
-}

package/vendor/node-api-headers/scripts/update-headers.js

@@ -1,246 +0,0 @@
-'use strict';
-
-const { writeFile } = require('fs/promises');
-const { Readable } = require('stream');
-const { resolve } = require('path');
-const { parseArgs } = require('util')
-const { createInterface } = require('readline');
-const { inspect } = require('util');
-const { runClang } = require('../lib/clang-utils');
-const { evaluate } = require('../lib/parse-utils');
-
-/**
- * @returns {Promise<string>} Version string, eg. `'v19.6.0'`.
- */
-async function getLatestReleaseVersion() {
-    const response = await fetch('https://nodejs.org/download/release/index.json');
-    const json = await response.json();
-    return json[0].version;
-}
-
-/**
- * @param {NodeJS.ReadableStream} stream
- * @param {string} destination
- * @param {boolean} verbose
- * @returns {Promise<void>} The `writeFile` Promise.
- */
-function removeExperimentals(stream, destination, verbose = false) {
-    return new Promise((resolve, reject) => {
-        const debug = (...args) => {
-            if (verbose) {
-                console.log(...args);
-            }
-        };
-        const rl = createInterface(stream);
-
-        /** @type {Array<'write' | 'ignore' | 'preprocessor'>} */
-        const mode = ['write'];
-
-        /** @type {Array<string>} */
-        const preprocessor = [];
-
-        /** @type {Array<string>} */
-        const macroStack = [];
-
-        /** @type {RegExpMatchArray | null} */
-        let matches;
-
-        let lineNumber = 0;
-        let toWrite = '';
-
-        const handlePreprocessor = (expression) => {
-            const result = evaluate(expression);
-
-            macroStack.push(expression);
-
-            if (result === false) {
-                debug(`Line ${lineNumber} Ignored '${expression}'`);
-                mode.push('ignore');
-                return false;
-            } else {
-                debug(`Line ${lineNumber} Pushed '${expression}'`);
-                mode.push('write');
-                return true;
-            }
-        };
-
-        rl.on('line', function lineHandler(line) {
-            ++lineNumber;
-            if (matches = line.match(/^\s*#if(n)?def\s+([A-Za-z_][A-Za-z0-9_]*)/)) {
-                const negated = Boolean(matches[1]);
-                const identifier = matches[2];
-                macroStack.push(identifier);
-
-                if (mode.length && mode[mode.length - 1] === 'ignore') {
-                    debug(`Line ${lineNumber} Continued-Ignored ${identifier}`);
-                    mode.push('ignore');
-                    return;
-                }
-
-                debug(`Line ${lineNumber} Pushed ${identifier}`);
-
-                if (identifier === 'NAPI_EXPERIMENTAL') {
-                    if (negated) {
-                        mode.push('write');
-                    } else {
-                        mode.push('ignore');
-                    }
-                    return;
-                } else {
-                    mode.push('write');
-                }
-            }
-            else if (matches = line.match(/^\s*#if\s+(.+)$/)) {
-                const expression = matches[1];
-                if (expression.endsWith('\\')) {
-                    if (preprocessor.length) {
-                        reject(new Error(`Unexpected preprocessor continuation on line ${lineNumber}`));
-                        return;
-                    }
-                    preprocessor.push(expression.substring(0, expression.length - 1));
-
-                    mode.push('preprocessor');
-                    return;
-                } else {
-                    if (!handlePreprocessor(expression)) {
-                        return;
-                    }
-                }
-            }
-            else if (line.match(/^#else(?:\s+|$)/)) {
-                const identifier = macroStack[macroStack.length - 1];
-
-                debug(`Line ${lineNumber} Peeked ${identifier}`);
-
-                if (!identifier) {
-                    rl.off('line', lineHandler);
-                    reject(new Error(`Macro stack is empty handling #else on line ${lineNumber}`));
-                    return;
-                }
-
-                if (identifier.indexOf('NAPI_EXPERIMENTAL') > -1) {
-                    const lastMode = mode[mode.length - 1];
-                    mode[mode.length - 1] = (lastMode === 'ignore') ? 'write' : 'ignore';
-                    return;
-                }
-            }
-            else if (line.match(/^\s*#endif(?:\s+|$)/)) {
-                const identifier = macroStack.pop();
-                mode.pop();
-
-                debug(`Line ${lineNumber} Popped ${identifier}`);
-
-                if (!identifier) {
-                    rl.off('line', lineHandler);
-                    reject(new Error(`Macro stack is empty handling #endif on line ${lineNumber}`));
-                    return;
-                }
-
-                if (identifier.indexOf('NAPI_EXPERIMENTAL') > -1) {
-                    return;
-                }
-            }
-
-            if (mode.length === 0) {
-                rl.off('line', lineHandler);
-                reject(new Error(`Write mode empty handling #endif on line ${lineNumber}`));
-                return;
-            }
-
-            if (mode[mode.length - 1] === 'write') {
-                toWrite += `${line}\n`;
-            } else if (mode[mode.length - 1] === 'preprocessor') {
-                if (!preprocessor) {
-                    reject(new Error(`Preprocessor mode without preprocessor on line ${lineNumber}`));
-                    return;
-                }
-
-                if (line.endsWith('\\')) {
-                    preprocessor.push(line.substring(0, line.length - 1));
-                    return;
-                }
-
-                preprocessor.push(line);
-
-                const expression = preprocessor.join('');
-                preprocessor.length = 0;
-                mode.pop();
-
-                if (!handlePreprocessor(expression)) {
-                    return;
-                }
-            }
-
-        });
-
-        rl.on('close', () => {
-            if (macroStack.length > 0) {
-                reject(new Error(`Macro stack is not empty at EOF: ${inspect(macroStack)}`));
-            }
-            else if (mode.length > 1) {
-                reject(new Error(`Write mode greater than 1 at EOF: ${inspect(mode)}`));
-            }
-            else if (toWrite.match(/^\s*#if(?:n)?def\s+NAPI_EXPERIMENTAL/m)) {
-                reject(new Error(`Output has match for NAPI_EXPERIMENTAL`));
-            }
-            else {
-                resolve(writeFile(destination, toWrite));
-            }
-        });
-    });
-}
-
-/**
- * Validate syntax for a file using clang.
- * @param {string} path Path for file to validate with clang.
- */
-async function validateSyntax(path) {
-    try {
-        await runClang(['-fsyntax-only', path]);
-    } catch (e) {
-        throw new Error(`Syntax validation failed for ${path}: ${e}`);
-    }
-}
-
-async function main() {
-    const { values: { tag, verbose } } = parseArgs({
-        options: {
-            tag: {
-                type: 'string',
-                short: 't',
-                default: await getLatestReleaseVersion()
-            },
-            verbose: {
-                type: 'boolean',
-                short: 'v',
-            },
-        },
-    });
-
-    console.log(`feat: update headers from nodejs/node tag ${tag}`);
-
-    const files = ['js_native_api_types.h', 'js_native_api.h', 'node_api_types.h', 'node_api.h'];
-
-    for (const filename of files) {
-        const url = `https://raw.githubusercontent.com/nodejs/node/${tag}/src/${filename}`;
-        const path = resolve(__dirname, '..', 'include', filename);
-
-        if (verbose) {
-            console.log(`  ${url} -> ${path}`);
-        }
-
-        const response = await fetch(url);
-        if (!response.ok) {
-            throw new Error(`Fetch of ${url} returned ${response.status} ${response.statusText}`);
-        }
-
-        await removeExperimentals(Readable.fromWeb(response.body), path, verbose);
-
-        await validateSyntax(path);
-    }
-}
-
-main().catch(e => {
-    console.error(e);
-    process.exitCode = 1;
-});

package/vendor/node-api-headers/scripts/write-symbols.js

@@ -1,154 +0,0 @@
-'use strict';
-
-const { resolve: resolvePath } = require('path');
-const { writeFile } = require('fs/promises');
-const { runClang } = require('../lib/clang-utils');
-
-/** @typedef {{ js_native_api_symbols: string[]; node_api_symbols: string[]; }} SymbolInfo */
-
-/**
- * @param {number} [version]
- * @returns {Promise<SymbolInfo>}
- */
-async function getSymbolsForVersion(version) {
-    try {
-        const { stdout } = await runClang([ '-ast-dump=json', '-fsyntax-only', '-fno-diagnostics-color', `-DNAPI_VERSION=${version}`, resolvePath(__dirname, '..', 'include', 'node_api.h')])
-
-        const ast = JSON.parse(stdout);
-
-        /** @type {SymbolInfo} */
-        const symbols = { js_native_api_symbols: [], node_api_symbols: [] };
-
-        for (const statement of ast.inner) {
-            if (statement.kind !== 'FunctionDecl') {
-                continue;
-            }
-
-            const name = statement.name;
-            const file = statement.loc.includedFrom?.file;
-
-            if (file) {
-                symbols.js_native_api_symbols.push(name);
-            } else {
-                symbols.node_api_symbols.push(name);
-            }
-        }
-
-        symbols.js_native_api_symbols.sort();
-        symbols.node_api_symbols.sort();
-
-        return symbols;
-    } catch (err) {
-        if (err.code === 'ENOENT') {
-            throw new Error('This tool requires clang to be installed.');
-        }
-        throw err;
-    }
-}
-
-/** @returns {Promise<{maxVersion: number, symbols: {[x: string]: SymbolInfo}}>} */
-async function getAllSymbols() {
-    /** @type {{[x: string]: SymbolInfo}} */
-    const allSymbols = {};
-    let version = 1;
-
-    console.log('Processing symbols from clang:')
-    while (true) {
-        const symbols = await getSymbolsForVersion(version);
-
-        if (version > 1) {
-            const previousSymbols = allSymbols[`v${version - 1}`];
-            if (previousSymbols.js_native_api_symbols.length == symbols.js_native_api_symbols.length && previousSymbols.node_api_symbols.length === symbols.node_api_symbols.length) {
-                --version;
-                break;
-            }
-        }
-        allSymbols[`v${version}`] = symbols;
-        console.log(`  v${version}: ${symbols.js_native_api_symbols.length} js_native_api_symbols, ${symbols.node_api_symbols.length} node_api_symbols`);
-        ++version;
-    }
-
-    return {
-        maxVersion: version,
-        symbols: allSymbols
-    };
-}
-
-/**
- * @param {SymbolInfo} previousSymbols
- * @param {SymbolInfo} currentSymbols
- * @returns {SymbolInfo}
- */
-function getUniqueSymbols(previousSymbols, currentSymbols) {
-    /** @type {SymbolInfo} */
-    const symbols = { js_native_api_symbols: [], node_api_symbols: [] };
-    for (const symbol of currentSymbols.js_native_api_symbols) {
-        if (!previousSymbols.js_native_api_symbols.includes(symbol)) {
-            symbols.js_native_api_symbols.push(symbol);
-        }
-    }
-    for (const symbol of currentSymbols.node_api_symbols) {
-        if (!previousSymbols.node_api_symbols.includes(symbol)) {
-            symbols.node_api_symbols.push(symbol);
-        }
-    }
-    return symbols;
-}
-
-/**
- * @param {string[]} strings
- */
-function joinStrings(strings, prependNewLine = false) {
-    if (strings.length === 0) return '';
-    return `${prependNewLine ? ',\n        ' : ''}'${strings.join("',\n        '")}'`;
-}
-
-async function getSymbolData() {
-    const { maxVersion, symbols } = await getAllSymbols();
-
-    let data = `'use strict'
-
-const v1 = {
-    js_native_api_symbols: [
-        ${joinStrings(symbols.v1.js_native_api_symbols)}
-    ],
-    node_api_symbols: [
-        ${joinStrings(symbols.v1.node_api_symbols)}
-    ]
-}
-`;
-
-    for (let version = 2; version <= maxVersion; ++version) {
-        const newSymbols = getUniqueSymbols(symbols[`v${version - 1}`], symbols[`v${version}`]);
-
-        data += `
-const v${version} = {
-    js_native_api_symbols: [
-        ...v${version - 1}.js_native_api_symbols${joinStrings(newSymbols.js_native_api_symbols, true)}
-    ],
-    node_api_symbols: [
-        ...v${version - 1}.node_api_symbols${joinStrings(newSymbols.node_api_symbols, true)}
-    ]
-}
-`;
-    }
-
-    data += `
-module.exports = {
-    ${new Array(maxVersion).fill(undefined).map((_, i) => `v${i + 1}`).join(',\n    ')}
-}
-`
-    return data;
-}
-
-async function main() {
-    const path = resolvePath(__dirname, '../symbols.js');
-    const data = await getSymbolData();
-    console.log(`Writing symbols to ${path}`)
-    return writeFile(path, data);
-}
-
-main().catch(e => {
-    console.error(e);
-    process.exitCode = 1;
-});