NodeVersion

NodeVersion is a software library designed to represent and manipulate Node.js version numbers in tooling, scripts, and deployment pipelines. It provides a canonical, immutable object model for major, minor, and patch components, plus optional pre-release and build metadata, aligned with semantic versioning. The goal is to simplify parsing, formatting, comparison, and range checks across different environments that depend on Node.js versions.

Key features include robust parsing from common formats such as v14.17.0 and 14.17.0-rc.1, normalization to a standard form, rich comparison operators (less than, greater than, equal, etc.), range evaluation, and utilities to bump versions (major, minor, patch) and to render a string representation. It also supports compatibility checks against the engines field in package.json, enabling tooling to assert required Node.js versions before installation or execution.

The library is designed for use in JavaScript and TypeScript projects and is published to npm under an open-source license. It emphasizes immutability, predictable behavior, and clear error handling, with lightweight dependencies and good performance for typical build and CI workloads. NodeVersion can interoperate with existing semver tooling, providing adapters or wrappers for projects that already rely on semver, while offering Node.js-specific semantics where relevant.

Use cases include build pipelines, test matrices, and deployment scripts that need to reason about Node.js version availability, compatibility, or upgrade strategies. The concept of NodeVersion reflects the broader ecosystem's need to manage runtime versions consistently across tools and environments.

See also Node.js, npm, SemVer, version management tools.