Description

n8n-nodes-semver

A comprehensive n8n community node for semantic versioning operations, providing a complete wrapper around the popular semver npm package.

🚀 Features

This node covers 99% of semver functions with 8 comprehensive resource categories:

📋 Available Resources

✨ Key Capabilities

• ✅ Complete semver API coverage – Access to nearly all semver functions
• ✅ TypeScript support – Full type safety and IntelliSense
• ✅ English interface – International standard compliance
• ✅ Flexible options – Loose parsing, prerelease handling, and more
• ✅ Error handling – Graceful error management with continue-on-fail support
• ✅ Production ready – Thoroughly tested and optimized

📦 Installation

Prerequisites

• n8n version 0.190.0 or higher
• Node.js 18.0 or higher

Install via n8n Community Nodes

1. Go to Settings → Community Nodes in your n8n instance
2. Enter the package name: @luka-cat-mimi/n8n-nodes-semver
3. Click Install

Install via npm

npm install @luka-cat-mimi/n8n-nodes-semver

🎯 Usage Examples

Basic Version Validation

{
  "resource": "validation",
  "operation": "valid",
  "version": "1.2.3"
}

Output:

{
  "operation": "valid",
  "version": "1.2.3",
  "isValid": true,
  "parsedVersion": "1.2.3"
}

Version Comparison

{
  "resource": "comparison",
  "operation": "gt",
  "version1": "2.0.0",
  "version2": "1.9.0"
}

Output:

{
  "operation": "gt",
  "version1": "2.0.0",
  "version2": "1.9.0",
  "result": true
}

Range Satisfaction

{
  "resource": "range",
  "operation": "satisfies",
  "version": "1.2.3",
  "range": "^1.0.0"
}

Output:

{
  "operation": "satisfies",
  "version": "1.2.3",
  "range": "^1.0.0",
  "result": true
}

Version Increment

{
  "resource": "increment",
  "operation": "inc",
  "version": "1.2.3",
  "releaseType": "minor",
  "identifier": "alpha",
  "identifierBase": "0"
}

Output:

{
  "operation": "inc",
  "version": "1.2.3",
  "releaseType": "minor",
  "identifier": "alpha",
  "identifierBase": "0",
  "result": "1.3.0"
}

Array Sorting

{
  "resource": "sorting",
  "operation": "sort",
  "versions": "2.0.0,1.0.0,1.5.0,1.0.1"
}

Output:

{
  "operation": "sort",
  "versions": ["2.0.0", "1.0.0", "1.5.0", "1.0.1"],
  "result": ["1.0.0", "1.0.1", "1.5.0", "2.0.0"]
}

🔧 Configuration Options

Global Options

Release Types (for increment operations)

• major – 1.0.0 → 2.0.0
• minor – 1.0.0 → 1.1.0
• patch – 1.0.0 → 1.0.1
• premajor – 1.0.0 → 2.0.0-0
• preminor – 1.0.0 → 1.1.0-0
• prepatch – 1.0.0 → 1.0.1-0
• prerelease – 1.0.0 → 1.0.1-0 or 1.0.1-0 → 1.0.1-1
• release – 1.0.1-0 → 1.0.1

📚 API Reference

Validation Operations

Comparison Operations

Range Operations

🏗️ Common Workflows

1. Version Validation Pipeline

Input Data → Semver (valid) → Filter (isValid=true) → Continue Processing

2. Version Comparison Chain

Input Data → Semver (compare) → Switch (based on result) → Different Paths

3. Dependency Range Checking

Package List → Semver (satisfies) → Filter Compliant → Update Action

4. Release Version Bumping

Current Version → Semver (inc) → New Version → Tag Creation

🐛 Error Handling

The node includes comprehensive error handling:

• Invalid version strings – Returns null or false based on operation
• Malformed ranges – Graceful fallback with error details
• Type mismatches – Clear error messages
• Continue on fail – Option to proceed despite errors

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Development Setup

# Clone the repository
git clone https://github.com/luka-mimi/n8n-nodes-semver.git

# Install dependencies
npm install

# Build the project
npm run build

# Run linter
npm run lint

📄 License

This project is licensed under the MIT License – see the LICENSE file for details.

🔗 Related Links

• n8n Community Nodes Documentation
• semver npm package
• Semantic Versioning Specification

📞 Support

• Issues: GitHub Issues
• Community: n8n Community Forum

If this project helps you, please give it a ⭐️!