JSPM

resolve-version-number

1.0.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 19
  • Score
    100M100P100Q55106F
  • License ISC

A lightweight Node.js CLI utility for resolving and calculating semantic version numbers. Perfect for CI/CD pipelines, release automation, and version management workflows.

Package Exports

  • resolve-version-number
  • resolve-version-number/src/resolve-version-number.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (resolve-version-number) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

resolve-version-number

A lightweight Node.js utility for resolving and calculating semantic version numbers. Perfect for CI/CD pipelines, release automation, and version management workflows.

Features

  • ๐ŸŽฏ Smart Version Resolution - Supports semantic versioning with prerelease support
  • ๐Ÿ”„ Multiple Bump Types - major, minor, patch, and custom bump for prerelease increments
  • ๐Ÿ“ฆ Package.json Integration - Automatically reads from your package.json
  • ๐Ÿงช Testing Support - Override current version for testing scenarios
  • โœ… Semver Validation - Ensures all versions follow semantic versioning standards
  • ๐Ÿ“ค JSON Output - Machine-readable output perfect for CI/CD pipelines
  • ๐Ÿšซ Non-Destructive - Never modifies your package.json (uses --no-git-tag-version)

Installation

As a Standalone Script

Copy resolve-version-number.js to your project's scripts/ directory:

curl -o scripts/resolve-version-number.js https://raw.githubusercontent.com/yourusername/resolve-version-number/main/resolve-version-number.js chmod +x scripts/resolve-version-number.js### As an npm Package (Coming Soon)

npm install resolve-version-number## Requirements

  • Node.js 16+ (ES modules support)
  • npm (for version calculations)

Usage

Basic Usage

Bump minor version (reads from package.json)

node scripts/resolve-version-number.js minor

Output: {"original":"1.0.8","version":"1.1.0"}

Use specific version

node scripts/resolve-version-number.js 1.2.3

Output: {"original":"1.0.8","version":"1.2.3"}

Simple patch bump

node scripts/resolve-version-number.js bump

Output: {"original":"1.0.8","version":"1.0.9"}### With Version Override (for testing)

Test with a different starting version

node scripts/resolve-version-number.js minor 2.5.0

Output: {"original":"2.5.0","version":"2.6.0"}

Version Input Types

Semantic Version Bumps

  • major - Increment major version (1.0.8 โ†’ 2.0.0)
  • minor - Increment minor version (1.0.8 โ†’ 1.1.0)
  • patch - Increment patch version (1.0.8 โ†’ 1.0.9)

Custom Bump

  • bump - Smart increment:
    • Regular versions: Increment patch (1.0.8 โ†’ 1.0.9)
    • Prerelease with number: Increment prerelease (1.0.8-rc.1 โ†’ 1.0.8-rc.2)
    • Prerelease without number: Increment patch (1.0.8-alpha โ†’ 1.0.9-alpha)

Specific Version

  • x.y.z - Use exact version (e.g., 1.2.3)
  • x.y.z-prerelease - Use exact prerelease version (e.g., 1.2.3-rc.1)

Examples

Prerelease Version Handling

Increment prerelease number

node scripts/resolve-version-number.js bump 1.0.8-rc.1

Output: {"o