Update gitignore (sorry)

electron/node_modules/node-api-version/README.md

@@ -0,0 +1,14 @@
+# node-api-version
+
+Get the maximum Node-API version supported for a specific version of node or Electron.
+
+```js
+const { fromNodeVersion, fromElectronVersion } = require("node-api-version");
+
+fromNodeVersion("9.0.0"); // undefined
+fromNodeVersion("12.13.0"); // 5
+
+fromElectronVersion("2.0.0"); // undefined
+fromElectronVersion("13.0.0"); // 7
+fromElectronVersion("15.0.0-nightly.20210629"); // 8
+```

electron/node_modules/node-api-version/electron-versions.js

@@ -0,0 +1,37 @@
+const got = require("got");
+const semver = require("semver");
+const { fromNodeVersion } = require(".");
+const { readFileSync, writeFileSync } = require("fs");
+
+got(`https://cdn.jsdelivr.net/gh/electron/releases/lite.json`).then(
+  (response) => {
+    const releases = JSON.parse(response.body).reverse();
+
+    const versionChanges = [];
+
+    let prevNapi = "";
+    for (const release of releases) {
+      const version = semver.parse(release.version);
+      if (version.major < 3) {
+        continue;
+      }
+
+      const thisNapi = fromNodeVersion(release.deps.node);
+      if (thisNapi !== prevNapi) {
+        prevNapi = thisNapi;
+        versionChanges.push([release.version, prevNapi]);
+      }
+    }
+
+    const objStr = JSON.stringify(versionChanges.reverse(), null, "  ");
+    const origFile = readFileSync("index.js", { encoding: "utf-8" });
+    const newFile = origFile.replace(
+      /\/\/ replace-start[\S\s]*\/\/ replace-end/g,
+      `// replace-start
+    ${objStr};
+    // replace-end`
+    );
+
+    writeFileSync("index.js", newFile);
+  }
+);

electron/node_modules/node-api-version/index.js

@@ -0,0 +1,57 @@
+const semver = require("semver");
+
+// These are sourced from here:
+// https://nodejs.org/api/n-api.html#n_api_node_api_version_matrix
+const nodeApiVersionRanges = [
+  [">=16 || ^15.12 || ^12.22", 8],
+  [">=15 || ^14.12 || ^12.19 || ^10.23", 7],
+  [">=14 || ^12.17 || ^10.20", 6],
+  [">=13 || ^12.11 || ^10.17", 5],
+  [">=12 || ^11.8 || ^10.16", 4],
+  [">=10", 3],
+];
+
+function fromNodeVersion(nodeVersion) {
+  for (const [range, version] of nodeApiVersionRanges) {
+    if (semver.satisfies(nodeVersion, range)) {
+      return version;
+    }
+  }
+
+  return undefined;
+}
+
+exports.fromNodeVersion = fromNodeVersion;
+
+// These are populated via `yarn electron-versions`
+const electronNapiVersions =
+  // replace-start
+  [
+    ["15.0.0-nightly.20210617", 8],
+    ["12.0.0-nightly.20201013", 7],
+    ["12.0.0-nightly.20200827", 6],
+    ["12.0.0-beta.1", 7],
+    ["11.0.0-nightly.20200618", 6],
+    ["11.0.0-nightly.20200525", 5],
+    ["11.0.0-beta.1", 6],
+    ["8.0.0-nightly.20191019", 5],
+    ["8.0.0-nightly.20190801", 4],
+    ["8.0.0-beta.1", 5],
+    ["5.0.0-nightly.20190121", 4],
+    ["5.0.0-nightly.20190107", 3],
+    ["5.0.0-beta.1", 4],
+    ["3.0.0-beta.1", 3],
+  ];
+// replace-end
+
+function fromElectronVersion(electronVersion) {
+  for (const [change, version] of electronNapiVersions) {
+    if (semver.gte(electronVersion, change)) {
+      return version;
+    }
+  }
+
+  return undefined;
+}
+
+exports.fromElectronVersion = fromElectronVersion;

electron/node_modules/node-api-version/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "node-api-version",
+  "version": "0.1.4",
+  "author": "Tim Fish <tim@timfish.uk>",
+  "main": "index.js",
+  "types": "types.d.ts",
+  "description": "Gets the supported Node-API version for a specific node or electron version",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/timfish/node-api-version"
+  },
+  "scripts": {
+    "electron-versions": "node ./electron-versions.js",
+    "test": "node ./test.js"
+  },
+  "dependencies": {
+    "semver": "^7.3.5"
+  },
+  "devDependencies": {
+    "got": "^11.8.2"
+  }
+}

electron/node_modules/node-api-version/test.js

@@ -0,0 +1,33 @@
+const assert = require("assert");
+const nodeApi = require(".");
+
+assert.strictEqual(nodeApi.fromNodeVersion("0.0.1"), undefined);
+assert.strictEqual(nodeApi.fromNodeVersion("9.0.0"), undefined);
+assert.strictEqual(nodeApi.fromNodeVersion("10.0.0"), 3);
+assert.strictEqual(nodeApi.fromNodeVersion("10.16.0"), 4);
+assert.strictEqual(nodeApi.fromNodeVersion("10.17.0"), 5);
+assert.strictEqual(nodeApi.fromNodeVersion("12.13.0"), 5);
+assert.strictEqual(nodeApi.fromNodeVersion("10.20.0"), 6);
+assert.strictEqual(nodeApi.fromNodeVersion("10.23.0"), 7);
+assert.strictEqual(nodeApi.fromNodeVersion("16.0.0"), 8);
+assert.strictEqual(nodeApi.fromNodeVersion("18.0.0"), 8);
+
+assert.strictEqual(nodeApi.fromElectronVersion("0.25.0"), undefined);
+assert.strictEqual(nodeApi.fromElectronVersion("1.0.0"), undefined);
+assert.strictEqual(nodeApi.fromElectronVersion("2.0.0"), undefined);
+assert.strictEqual(nodeApi.fromElectronVersion("3.0.0"), 3);
+assert.strictEqual(nodeApi.fromElectronVersion("4.0.0"), 3);
+assert.strictEqual(nodeApi.fromElectronVersion("5.0.0"), 4);
+assert.strictEqual(nodeApi.fromElectronVersion("6.0.0"), 4);
+assert.strictEqual(nodeApi.fromElectronVersion("7.0.0"), 4);
+assert.strictEqual(nodeApi.fromElectronVersion("8.0.0"), 5);
+assert.strictEqual(nodeApi.fromElectronVersion("9.0.0"), 5);
+assert.strictEqual(nodeApi.fromElectronVersion("10.0.0"), 5);
+assert.strictEqual(nodeApi.fromElectronVersion("11.0.0"), 6);
+assert.strictEqual(nodeApi.fromElectronVersion("12.0.0-nightly.20200827"), 6);
+assert.strictEqual(nodeApi.fromElectronVersion("12.0.0"), 7);
+assert.strictEqual(nodeApi.fromElectronVersion("13.0.0"), 7);
+assert.strictEqual(nodeApi.fromElectronVersion("14.0.0"), 7);
+assert.strictEqual(nodeApi.fromElectronVersion("15.0.0"), 8);
+assert.strictEqual(nodeApi.fromElectronVersion("16.0.0"), 8);
+assert.strictEqual(nodeApi.fromElectronVersion("28.0.0"), 8);

electron/node_modules/node-api-version/types.d.ts

@@ -0,0 +1,4 @@
+export declare function fromNodeVersion(version: string): number | undefined;
+export declare function fromElectronVersion(
+  version: string
+): number | undefined;