v8r - npm Package Versions

📦 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 more than one remote schema, or involves a schema with remote $refs.
• Improve handling of empty yaml files.

📦 5.0.0 - 2025-05-10

Following on from the deprecations in version 4.4.0, version 5.0.0 contains a number of breaking changes:

• The --format CLI argument and format config file key have been removed. Switch to using --output-format and outputFormat.
• v8r now ignores patterns in .gitignore by default.
• The fileLocation argument of getSingleResultLogMessage has been removed. The signature is now getSingleResultLogMessage(result, format). Plugins implementing the getSingleResultLogMessage hook will need to to update the signature. If you are using fileLocation in the getSingleResultLogMessage function body, switch to using result.fileLocation.
• File paths are no longer passed to plugins in dot-relative notation. Plugins implementing the getSingleResultLogMessage, getAllResultsLogMessage and parseInputFile plugin hooks may need to be updated.
• The minimum compatible node version is now Node 20.

Other changes in this release:

• v8r is now tested on node 24
• Upgrade to latest major versions of core packages (got, glob, minimatch, etc)

📦 4.4.0 - 2025-04-26

Version 4.4.0 is a deprecation release. This release adds deprecation warnings for upcoming breaking changes that will be made in version 5.0

• This release adds the --output-format CLI argument and outputFormat config file key. In v8r 4.4.0 --format and format can still be used as aliases. In version 5 --format and format will be removed. It is recommended to switch to using --output-format and outputFormat now.
• Starting from v8r version 5, v8r will ignore patterns in .gitignore by default.
• In v8r version 5 the fileLocation argument of getSingleResultLogMessage will be removed. The signature will become getSingleResultLogMessage(result, format). Plugins implementing the getSingleResultLogMessage plugin hook will need to to update the signature to be compatible with version 5. If you are using fileLocation in the getSingleResultLogMessage function body, switch to using result.fileLocation.
• Starting from v8r version 5 file paths will no longer be passed to plugins in dot-relative notation. Plugins implementing the getSingleResultLogMessage, getAllResultsLogMessage and parseInputFile plugin hooks may need to be updated.

📦 4.3.0 - 2025-04-21

• Add ignore patern files. v8r now looks for ignore patterns in .v8rignore by default. More info: https://chris48s.github.io/v8r/ignoring-files/
• Include the prop name in additionalProperty log message.
• Allow config file to contain $schema key.
• Fix: Clear the cache on init if TTL is 0.

📦 4.2.1 - 2024-12-14

• Upgrade to flat-cache 6. This release revamps how cache is stored and invalidated internally but should have no user-visible impact

📦 4.2.0 - 2024-10-24

• Add V8R_CONFIG_FILE environment variable. This allows loading a config file from a location other than the directory v8r is invoked from. More info: https://chris48s.github.io/v8r/configuration/

📦 4.1.0 - 2024-08-25

• v8r can now parse and validate files that contain multiple yaml documents More info: https://chris48s.github.io/v8r/usage-examples/#files-containing-multiple-documents
• The parseInputFile() plugin hook may now conditionally return an array of Document objects
• The ValidationResult object now contains a documentIndex property. This identifies the document when a multi-doc file has been validated.

📦 4.0.1 - 2024-08-19

• De-duplicate and sort files before validating

📦 4.0.0 - 2024-08-19

• Breaking: Change to the JSON output format. The results key is now an array instead of an object. In v8r <4, results was an object mapping filename to result object. For example:

  {
    "results": {
      "./package.json": {
        "fileLocation": "./package.json",
        "schemaLocation": "https://json.schemastore.org/package.json",
        "valid": true,
        "errors": [],
        "code": 0
      }
    }
  }
  

  In v8r >=4 results is now an array of result objects. For example:

  {
    "results": [
      {
        "fileLocation": "./package.json",
        "schemaLocation": "https://json.schemastore.org/package.json",
        "valid": true,
        "errors": [],
        "code": 0
      }
    ]
  }
  

• Plugin system: It is now possible to extend the functionality of v8r by using or writing plugins. See https://chris48s.github.io/v8r/category/plugins/ for further information

• Documentation improvements

📦 3.1.1 - 2024-08-03

• Allow 'toml' as an allowed value for parser in custom catalog