@robinpath/semver

Parse, compare, validate, and manipulate semantic version strings (semver 2.0.0 compliant)

Why use this module?

The semver module lets you:

• Parse a semver version string into its components (major, minor, patch, prerelease, build)
• Check whether a string is a valid semver version
• Compare two semver versions, returning -1 (v1 < v2), 0 (equal), or 1 (v1 > v2)
• Check if the first version is greater than the second
• Check if the first version is less than the second

All functions are callable directly from RobinPath scripts with a simple, consistent API.

Installation

npm install @robinpath/semver

Quick Start

No credentials needed — start using it right away:

semver.isValid "1.2.3"

Available Functions

| Function | Description | |----------|-------------| | semver.parse | Parse a semver version string into its components (major, minor, patch, prerelease, build) | | semver.isValid | Check whether a string is a valid semver version | | semver.compare | Compare two semver versions, returning -1 (v1 < v2), 0 (equal), or 1 (v1 > v2) | | semver.gt | Check if the first version is greater than the second | | semver.lt | Check if the first version is less than the second | | semver.eq | Check if two versions are equal (ignoring build metadata) | | semver.gte | Check if the first version is greater than or equal to the second | | semver.lte | Check if the first version is less than or equal to the second | | semver.satisfies | Check if a version satisfies a semver range (supports ^, ~, >=, <=, >, <, =, x wildcard, | | semver.inc | Increment a version by the specified release type (major, minor, patch, or prerelease) | | semver.major | Extract the major version number from a semver string | | semver.minor | Extract the minor version number from a semver string | | semver.patch | Extract the patch version number from a semver string | | semver.coerce | Coerce a loose version string into a clean semver string (e.g. "v1" becomes "1.0.0") | | semver.diff | Determine the type of difference between two versions (major, minor, patch, prerelease, or null) |

Examples

Check whether a string is a valid semver version

semver.isValid "1.2.3"

Compare two semver versions, returning -1 (v1 < v2), 0 (equal), or 1 (v1 > v2)

semver.compare "1.2.3" "1.3.0"

Check if the first version is greater than the second

semver.gt "2.0.0" "1.9.9"

Integration with RobinPath

import { RobinPath } from "@wiredwp/robinpath";
import Module from "@robinpath/semver";

const rp = new RobinPath();
rp.registerModule(Module.name, Module.functions);
rp.registerModuleMeta(Module.name, Module.functionMetadata);

const result = await rp.executeScript(`
  semver.isValid "1.2.3"
`);

Full API Reference

See MODULE.md for complete documentation including all parameters, return types, error handling, and advanced examples.

Related Modules

• @robinpath/json — JSON module for complementary functionality

License

MIT