n8n-nodes-liverecover

Custom nodes package for n8n workflow automation that provides advanced timing and routing capabilities for Live Recover workflows.

🎯 Overview

This package contains custom n8n nodes designed to enhance workflow automation with sophisticated delay mechanisms and probabilistic routing features:

• Delay Node: Pause workflow execution with flexible timing options
• Split Node: Route items to different outputs based on weighted probability

📦 Included Nodes

Delay Node

A versatile timing control node that can:

• Delay execution for a specific duration (seconds, minutes, hours, days)
• Wait until a specific time on selected weekdays
• Combine scheduled timing with additional buffer delays
• Handle both short-term (< 65 seconds) and long-term delays efficiently

View detailed Delay Node documentation

Split Node

A probabilistic routing node that can:

• Distribute workflow items across multiple outputs based on weighted probability
• Support both form-based and JSON configuration
• Enable A/B testing, load balancing, and data sampling scenarios
• Dynamically create outputs based on configured weights

View detailed Split Node documentation

🚀 Installation

In n8n (Recommended)

1. Open your n8n instance
2. Go to Settings > Community Nodes
3. Click Install a community node
4. Enter n8n-nodes-liverecover
5. Click Install

Manual Installation

If you're running n8n via Docker:

docker exec -it <your_n8n_container> npm install n8n-nodes-liverecover

For npm-based installations:

npm install n8n-nodes-liverecover

Development Installation

For local development and testing:

# Clone the repository
git clone https://github.com/voyagemobile/vyg.git
cd n8n-nodes-delay

# Install dependencies
npm install

# Build the nodes
npm run build

# Link to your n8n installation
npm link

# In your n8n custom nodes folder
cd ~/.n8n/nodes
npm link n8n-nodes-liverecover

📖 Usage Examples

Delay Node Example: API Rate Limiting

// Workflow: Process API requests with rate limiting
1. HTTP Request Node → 
2. Delay Node (After Time Interval: 1 second) → 
3. Process Response

Split Node Example: A/B Testing

// Workflow: Split traffic for A/B testing
1. Webhook Trigger → 
2. Split Node (A: 70%, B: 30%) → 
3a. Version A Processing
3b. Version B Processing

Combined Example: Scheduled Batch Processing

// Workflow: Process batches at scheduled times with load distribution
1. Trigger → 
2. Delay Node (At Specific Time: 02:00) → 
3. Get Items → 
4. Split Node (Server1: 60%, Server2: 40%) → 
5a. Process on Server 1
5b. Process on Server 2

⚙️ Configuration

Node Requirements

• n8n version: >= 0.193.0
• Node.js: >= 20.15

Environment Variables

No special environment variables are required. The nodes use n8n's built-in execution context.

🏗️ Architecture

Delay Node Features

• Smart delay handling: Automatically chooses between setTimeout (< 65s) and n8n's wait system (>= 65s)
• Execution state persistence: Long delays survive n8n restarts
• Weekday filtering: Built-in business day logic
• Time validation: Comprehensive input validation with helpful error messages

Split Node Features

• Dynamic outputs: Automatically creates output connectors based on weights
• Dual configuration modes: User-friendly form or advanced JSON input
• Item tracking: Maintains pairedItem references for debugging
• Probability accuracy: Distribution becomes more accurate with larger item sets

🧪 Testing

Test your nodes in n8n:

1. Create a new workflow
2. Add the Delay or Split node from the nodes panel
3. Configure the node parameters
4. Connect to other nodes
5. Execute the workflow

Test Scenarios

Delay Node Testing:

• Test with various time units (seconds to days)
• Verify weekday filtering works correctly
• Confirm specific time execution
• Test workflow cancellation during delays

Split Node Testing:

• Run with 100+ items to verify distribution
• Test with different weight ratios
• Verify all outputs receive appropriate items
• Test edge cases (zero weights, single output)

🤝 Support

Documentation

• Delay Node Usage Guide
• Split Node Usage Guide
• Contributing Guide

Getting Help

• Check the usage guides for detailed examples
• Review n8n's custom nodes documentation
• Open an issue on GitHub

📄 License

MIT License - see LICENSE.md for details

🙏 Acknowledgments

Built for the n8n community by Live Recover. Special thanks to the n8n team for providing an excellent workflow automation platform.

Note: These nodes are designed to work within n8n's execution context. They cannot be used as standalone Node.js modules.