@robinpath/retry

Retry with exponential backoff and circuit breaker patterns for resilient automation workflows

Why use this module?

The retry module lets you:

• Execute a function with automatic retry and exponential backoff
• Calculate the delay for a given retry attempt using exponential backoff
• Check if an HTTP status code is retryable (408, 429, 500, 502, 503, 504)
• Wait for a specified number of milliseconds
• Preview the delay schedule for a series of retry attempts

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

Installation

npm install @robinpath/retry

Quick Start

No credentials needed — start using it right away:

retry.withBackoff 3 1000 2 30000

Available Functions

Function	Description
retry.execute	Execute a function with automatic retry and exponential backoff
retry.withBackoff	Calculate the delay for a given retry attempt using exponential backoff
retry.isRetryable	Check if an HTTP status code is retryable (408, 429, 500, 502, 503, 504)
retry.delay	Wait for a specified number of milliseconds
retry.attempts	Preview the delay schedule for a series of retry attempts
retry.createBreaker	Create a named circuit breaker with a failure threshold and reset timeout
retry.breakerState	Get the current state of a named circuit breaker
retry.breakerRecord	Record a success or failure in a circuit breaker
retry.breakerAllow	Check if a circuit breaker allows requests through
retry.breakerReset	Reset a circuit breaker to closed state

Examples

Calculate the delay for a given retry attempt using exponential backoff

retry.withBackoff 3 1000 2 30000

Check if an HTTP status code is retryable (408, 429, 500, 502, 503, 504)

retry.isRetryable 503

Wait for a specified number of milliseconds

retry.delay 2000

Integration with RobinPath

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

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

const result = await rp.executeScript(`
  retry.withBackoff 3 1000 2 30000
`);

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