🆕 @kurone-kito/is-prerelease

A simple CLI app based on Node.js that determines whether a given version is a pre-release version using semver.

Features

• Detects pre-release versions (e.g., 1.0.0-alpha.1, 2.0.0-beta.3)
• Returns exit codes for easy CI/CD integration
• Zero configuration required

Requirements

• Node.js ^20.11 || ^22 || >=24

Installation

npm i -D @kurone-kito/is-prerelease

Usage

Command Syntax

is-prerelease <version> [pre]

Arguments

| Argument | Required | Description | | --------- | -------- | ------------------------------------------------------------------------------- | | version | Yes | The version string to check (JSON format, e.g., "1.0.0" or "1.0.0-alpha.1") | | pre | No | If provided, the command expects a pre-release version |

Exit Codes

| Condition | Exit Code | | ------------------------------------------------------ | ------------- | | Pre-release version and pre argument provided | 0 (success) | | Stable version and pre argument not provided | 0 (success) | | Otherwise | 1 (failure) |

Examples

Check if a version is a pre-release

# Returns exit code 0 if pre-release
is-prerelease '"1.0.0-alpha.1"' pre

# Returns exit code 0 if stable release
is-prerelease '"1.0.0"'

Integration with npm scripts

{
  "scripts": {
    "is:prerelease": "is-prerelease $(npm pkg get version) pre",
    "is:release": "is-prerelease $(npm pkg get version)"
  }
}

Note: npm pkg get version outputs a JSON-formatted string (e.g., "1.0.0"), which is the expected input format.

CI/CD Usage Example

# Publish to npm only if it's a pre-release version
if npm run is:prerelease; then
  npm publish --tag next
fi

# Publish to npm only if it's a stable release
if npm run is:release; then
  npm publish --tag latest
fi

How It Works

This CLI uses the prerelease() function from the semver package to detect pre-release identifiers in version strings.

• 1.0.0 → Stable release (no pre-release identifier)
• 1.0.0-alpha.1 → Pre-release (identifier: ['alpha', 1])
• 2.0.0-beta.3 → Pre-release (identifier: ['beta', 3])

Contributing

Welcome to contribute to this repository! For more details, please refer to CONTRIBUTING.md.

License

MIT