v8r 5.1.0 → 6.0.0

package/CHANGELOG.md

@@ -1,9 +1,17 @@
 # Changelog
 
+## 📦 [6.0.0](https://www.npmjs.com/package/v8r/v/6.0.0) - 2026-02-21
+
+* **Breaking:** Drop compatibility with node 20
+* This release adds a new installation option: standalone binaries.
+  Moving forwards, standalone binaries for Linux, Windows and MacOS available
+  for download from https://github.com/chris48s/v8r/releases/latest .
+* Upgrade to latest major versions of core packages (glob, minimatch, p-limit)
+
 ## 📦 [5.1.0](https://www.npmjs.com/package/v8r/v/5.1.0) - 2025-07-20
 
 * v8r now pre-warms the cache and fetches schemas in parallel.
-  This will improve decrease total run time for any run that involves fetching
+  This will decrease total run time for any run that involves fetching
   more than one remote schema, or involves a schema with remote `$ref`s.
 * Improve handling of empty yaml files.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "v8r",
-  "version": "5.1.0",
+  "version": "6.0.0",
   "description": "A command-line JSON, YAML and TOML validator that's on your wavelength",
   "scripts": {
     "test": "V8R_CACHE_NAME=v8r-test c8 --reporter=text mocha \"src/**/*.spec.js\"",
@@ -8,7 +8,9 @@
     "coverage": "c8 report --reporter=cobertura",
     "prettier": "prettier --write \"**/*.{js,cjs,mjs}\"",
     "prettier:check": "prettier --check \"**/*.{js,cjs,mjs}\"",
-    "v8r": "src/index.js"
+    "v8r": "src/index.js",
+    "build:bin": "node sea/build.js && $npm_node_execpath --build-sea sea/config.json",
+    "build:exe": "node sea/build.js && %npm_node_execpath% --build-sea sea/config-win.json"
   },
   "bin": {
     "v8r": "src/index.js"
@@ -34,7 +36,7 @@
     "cosmiconfig": "^9.0.0",
     "decamelize": "^6.0.0",
     "flat-cache": "^6.1.4",
-    "glob": "^11.0.0",
+    "glob": "^13.0.0",
     "global-agent": "^3.0.0",
     "got": "^14.0.0",
     "ignore": "^7.0.0",
@@ -42,16 +44,18 @@
     "js-yaml": "^4.0.0",
     "json5": "^2.2.0",
     "minimatch": "^10.0.0",
-    "p-limit": "^6.2.0",
+    "p-limit": "^7.0.0",
     "p-mutex": "^1.0.0",
     "smol-toml": "^1.0.1",
     "yargs": "^18.0.0"
   },
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
     "c8": "^10.1.2",
-    "eslint": "^9.9.0",
+    "esbuild": "^0.27.3",
+    "eslint": "^10.0.1",
     "eslint-config-prettier": "^10.1.2",
-    "eslint-plugin-jsdoc": "^51.4.1",
+    "eslint-plugin-jsdoc": "^62.7.0",
     "eslint-plugin-mocha": "^11.0.0",
     "eslint-plugin-prettier": "^5.0.0",
     "mocha": "^11.0.1",
@@ -61,7 +65,7 @@
     "prettier-plugin-jsdoc": "^1.3.0"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "type": "module",
   "keywords": [

package/src/ajv.js

@@ -1,13 +1,9 @@
-import { createRequire } from "node:module";
-// TODO: once JSON modules is stable these requires could become imports
-// https://nodejs.org/api/esm.html#esm_experimental_json_modules
-const require = createRequire(import.meta.url);
-
 import AjvDraft4 from "ajv-draft-04";
 import Ajv from "ajv";
 import Ajv2019 from "ajv/dist/2019.js";
 import Ajv2020 from "ajv/dist/2020.js";
 import addFormats from "ajv-formats";
+import draft06 from "ajv/lib/refs/json-schema-draft-06.json" with { type: "json" };
 
 function _ajvFactory(
   schema,
@@ -26,9 +22,7 @@ function _ajvFactory(
       return new AjvDraft4(opts);
     } else if (schema["$schema"].includes("json-schema.org/draft-06/schema")) {
       const ajvDraft06 = new Ajv(opts);
-      ajvDraft06.addMetaSchema(
-        require("ajv/lib/refs/json-schema-draft-06.json"),
-      );
+      ajvDraft06.addMetaSchema(draft06);
       return ajvDraft06;
     } else if (schema["$schema"].includes("json-schema.org/draft-07/schema")) {
       return new Ajv(opts);
@@ -45,7 +39,7 @@ function _ajvFactory(
 
   // hedge our bets as best we can
   const ajv = new Ajv(opts);
-  ajv.addMetaSchema(require("ajv/lib/refs/json-schema-draft-06.json"));
+  ajv.addMetaSchema(draft06);
   return ajv;
 
   /* TODO:

package/src/bootstrap.js

@@ -1,8 +1,3 @@
-import { createRequire } from "node:module";
-// TODO: once JSON modules is stable these requires could become imports
-// https://nodejs.org/api/esm.html#esm_experimental_json_modules
-const require = createRequire(import.meta.url);
-
 import fs from "node:fs";
 import path from "node:path";
 import { cosmiconfig } from "cosmiconfig";
@@ -15,7 +10,8 @@ import {
   validateConfigOutputFormats,
 } from "./config-validators.js";
 import logger from "./logger.js";
-import { loadAllPlugins, resolveUserPlugins } from "./plugins.js";
+import { loadAllPlugins, resolveUserPlugins } from "./plugin-loader.js";
+import manifest from "../package.json" with { type: "json" };
 
 async function getCosmiConfig(cosmiconfigOptions) {
   let configFile;
@@ -127,7 +123,7 @@ function parseArgs(argv, config, documentFormats, outputFormats) {
     .version(
       // Workaround for https://github.com/yargs/yargs/issues/1934
       // TODO: remove once fixed
-      require("../package.json").version,
+      manifest.version,
     )
     .option("verbose", {
       alias: "v",

package/src/cache.js

@@ -73,9 +73,11 @@ class Cache {
       return parsedBody;
     } catch (error) {
       if (error.response) {
-        throw new Error(`Failed fetching ${url}\n${error.response.body}`);
+        throw new Error(`Failed fetching ${url}\n${error.response.body}`, {
+          cause: error,
+        });
       }
-      throw new Error(`Failed fetching ${url}`);
+      throw new Error(`Failed fetching ${url}`, { cause: error });
     }
   }
 

package/src/cli.js

@@ -169,7 +169,7 @@ function resultsToStatusCode(results, ignoreErrors) {
 
 function Validator() {
   return async function (config, plugins) {
-    let filenames = [];
+    let filenames;
     try {
       filenames = await getFiles(config.patterns, config.ignorePatternFiles);
     } catch (e) {

package/src/config-validators.js

@@ -1,16 +1,11 @@
-import { createRequire } from "node:module";
-// TODO: once JSON modules is stable these requires could become imports
-// https://nodejs.org/api/esm.html#esm_experimental_json_modules
-const require = createRequire(import.meta.url);
-
 import Ajv2019 from "ajv/dist/2019.js";
 import logger from "./logger.js";
 import { formatErrors } from "./output-formatters.js";
+import configSchema from "../config-schema.json" with { type: "json" };
 
 function validateConfigAgainstSchema(configFile) {
   const ajv = new Ajv2019({ allErrors: true, strict: false });
-  const schema = require("../config-schema.json");
-  const validateFn = ajv.compile(schema);
+  const validateFn = ajv.compile(configSchema);
   const valid = validateFn(configFile.config);
   if (!valid) {
     logger.log(

package/src/index.js

@@ -5,5 +5,4 @@ import { cli } from "./cli.js";
 import { bootstrap } from "global-agent";
 bootstrap();
 
-const exitCode = await cli();
-process.exit(exitCode);
+cli().then((exitCode) => process.exit(exitCode));

package/src/plugin-loader.js

@@ -0,0 +1,99 @@
+import path from "node:path";
+import { isSea } from "node:sea";
+import logger from "./logger.js";
+import { BasePlugin } from "./plugins.js";
+import ParserJson from "./plugins/parser-json.js";
+import ParserJson5 from "./plugins/parser-json5.js";
+import ParserToml from "./plugins/parser-toml.js";
+import ParserYaml from "./plugins/parser-yaml.js";
+import OutputText from "./plugins/output-text.js";
+import OutputJson from "./plugins/output-json.js";
+
+function validatePlugin(plugin) {
+  if (
+    typeof plugin.name !== "string" ||
+    !plugin.name.startsWith("v8r-plugin-")
+  ) {
+    throw new Error(`Plugin ${plugin.name} does not declare a valid name`);
+  }
+
+  if (!(plugin.prototype instanceof BasePlugin)) {
+    throw new Error(`Plugin ${plugin.name} does not extend BasePlugin`);
+  }
+
+  for (const prop of Object.getOwnPropertyNames(BasePlugin.prototype)) {
+    const method = plugin.prototype[prop];
+    const argCount = plugin.prototype[prop].length;
+    if (typeof method !== "function") {
+      throw new Error(
+        `Error loading plugin ${plugin.name}: must have a method called ${method}`,
+      );
+    }
+    const expectedArgs = BasePlugin.prototype[prop].length;
+    if (expectedArgs !== argCount) {
+      throw new Error(
+        `Error loading plugin ${plugin.name}: ${prop} must take exactly ${expectedArgs} arguments`,
+      );
+    }
+  }
+}
+
+function resolveUserPlugins(userPlugins) {
+  let plugins = [];
+  for (let plugin of userPlugins) {
+    if (plugin.startsWith("package:")) {
+      plugins.push(plugin.slice(8));
+    }
+    if (plugin.startsWith("file:")) {
+      plugins.push(path.resolve(process.cwd(), plugin.slice(5)));
+    }
+  }
+  return plugins;
+}
+
+function loadCorePlugins(plugins) {
+  plugins.forEach((plugin) => validatePlugin(plugin));
+  const loadedPlugins = plugins.map((plugin) => new plugin());
+  return loadedPlugins;
+}
+
+async function loadUserPlugins(plugins) {
+  let loadedPlugins = [];
+  for (const plugin of plugins) {
+    loadedPlugins.push(await import(plugin));
+  }
+  loadedPlugins = loadedPlugins.map((plugin) => plugin.default);
+
+  loadedPlugins.forEach((plugin) => validatePlugin(plugin));
+  loadedPlugins = loadedPlugins.map((plugin) => new plugin());
+  return loadedPlugins;
+}
+
+async function loadAllPlugins(userPlugins) {
+  let loadedUserPlugins = [];
+  if (isSea() && userPlugins.length > 0) {
+    logger.warning(
+      "loading plugins is not supported when running as a standalone binary",
+    );
+  } else {
+    loadedUserPlugins = await loadUserPlugins(userPlugins);
+  }
+
+  const corePlugins = [
+    ParserJson,
+    ParserJson5,
+    ParserToml,
+    ParserYaml,
+    OutputText,
+    OutputJson,
+  ];
+  const loadedCorePlugins = loadCorePlugins(corePlugins);
+
+  return {
+    allLoadedPlugins: loadedUserPlugins.concat(loadedCorePlugins),
+    loadedCorePlugins,
+    loadedUserPlugins,
+  };
+}
+
+export { loadAllPlugins, resolveUserPlugins };

package/src/plugins.js

@@ -1,5 +1,3 @@
-import path from "node:path";
-
 /**
  * Base class for all v8r plugins.
  *
@@ -105,90 +103,19 @@ class BasePlugin {
 }
 
 class Document {
+  /* eslint-disable jsdoc/reject-any-type */
   /**
    * Document is a thin wrapper class for a document we want to validate after
    * parsing a file
    *
    * @param {any} document - The object to be wrapped
    */
+  /* eslint-enable jsdoc/reject-any-type */
   constructor(document) {
     this.document = document;
   }
 }
 
-function validatePlugin(plugin) {
-  if (
-    typeof plugin.name !== "string" ||
-    !plugin.name.startsWith("v8r-plugin-")
-  ) {
-    throw new Error(`Plugin ${plugin.name} does not declare a valid name`);
-  }
-
-  if (!(plugin.prototype instanceof BasePlugin)) {
-    throw new Error(`Plugin ${plugin.name} does not extend BasePlugin`);
-  }
-
-  for (const prop of Object.getOwnPropertyNames(BasePlugin.prototype)) {
-    const method = plugin.prototype[prop];
-    const argCount = plugin.prototype[prop].length;
-    if (typeof method !== "function") {
-      throw new Error(
-        `Error loading plugin ${plugin.name}: must have a method called ${method}`,
-      );
-    }
-    const expectedArgs = BasePlugin.prototype[prop].length;
-    if (expectedArgs !== argCount) {
-      throw new Error(
-        `Error loading plugin ${plugin.name}: ${prop} must take exactly ${expectedArgs} arguments`,
-      );
-    }
-  }
-}
-
-function resolveUserPlugins(userPlugins) {
-  let plugins = [];
-  for (let plugin of userPlugins) {
-    if (plugin.startsWith("package:")) {
-      plugins.push(plugin.slice(8));
-    }
-    if (plugin.startsWith("file:")) {
-      plugins.push(path.resolve(process.cwd(), plugin.slice(5)));
-    }
-  }
-  return plugins;
-}
-
-async function loadPlugins(plugins) {
-  let loadedPlugins = [];
-  for (const plugin of plugins) {
-    loadedPlugins.push(await import(plugin));
-  }
-  loadedPlugins = loadedPlugins.map((plugin) => plugin.default);
-  loadedPlugins.forEach((plugin) => validatePlugin(plugin));
-  loadedPlugins = loadedPlugins.map((plugin) => new plugin());
-  return loadedPlugins;
-}
-
-async function loadAllPlugins(userPlugins) {
-  const loadedUserPlugins = await loadPlugins(userPlugins);
-
-  const corePlugins = [
-    "./plugins/parser-json.js",
-    "./plugins/parser-json5.js",
-    "./plugins/parser-toml.js",
-    "./plugins/parser-yaml.js",
-    "./plugins/output-text.js",
-    "./plugins/output-json.js",
-  ];
-  const loadedCorePlugins = await loadPlugins(corePlugins);
-
-  return {
-    allLoadedPlugins: loadedUserPlugins.concat(loadedCorePlugins),
-    loadedCorePlugins,
-    loadedUserPlugins,
-  };
-}
-
 /**
  * @typedef {object} ValidationResult
  * @property {string} fileLocation - Path of the document that was validated.
@@ -213,4 +140,4 @@ async function loadAllPlugins(userPlugins) {
  * @see https://ajv.js.org/api.html#error-objects
  */
 
-export { BasePlugin, Document, loadAllPlugins, resolveUserPlugins };
+export { BasePlugin, Document };