@radzor/retry-handler

Retry failed operations with configurable backoff strategies including exponential, linear, and jitter. Tracks attempt history and provides detailed statistics on retry behaviour.

Automationv0.1.0typescriptpythonUniversalretrybackoffresilienceexponential-backofffault-toleranceerror-handlingby Radzor

Install

View source on GitHub →

$npx radzor@latest add retry-handler

⚠ Constraints: Delays use setTimeout; not suitable for sub-millisecond timing. The retryOn predicate should be a pure function. Stats are in-memory only.

Inputs

Name	Type	Default	Description
maxAttempts	number	3	Maximum number of retry attempts (including the initial call).
strategy	'exponential' \| 'linear' \| 'fixed'	exponential	Backoff strategy to use between retries.
baseDelay	number	1000	Base delay in milliseconds before the first retry.
maxDelay	number	30000	Maximum delay cap in milliseconds.
jitter	boolean	true	Add random jitter to the delay to prevent thundering herd.
retryOn	(error: Error) => boolean	—	Optional predicate to decide whether an error is retryable.

{ "llm": { "constraints": "Delays use setTimeout; not suitable for sub-millisecond timing. The retryOn predicate should be a pure function. Stats are in-memory only.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/retry-handler", "tags": [ "retry", "backoff", "resilience", "exponential-backoff", "fault-tolerance", "error-handling" ], "events": [ { "name": "onRetry", "payload": { "delay": "number", "error": "string", "attempt": "number" }, "description": "Fired before each retry attempt with the computed delay." }, { "name": "onExhausted", "payload": { "attempts": "number", "lastError": "string", "totalTime": "number" }, "description": "Fired when all retry attempts are exhausted." }, { "name": "onSuccess", "payload": { "attempt": "number", "totalTime": "number" }, "description": "Fired when the operation succeeds (on first try or after retries)." } ], "inputs": [ { "name": "maxAttempts", "type": "number", "default": 3, "required": false, "description": "Maximum number of retry attempts (including the initial call)." }, { "name": "strategy", "type": "'exponential' | 'linear' | 'fixed'", "default": "exponential", "required": false, "description": "Backoff strategy to use between retries." }, { "name": "baseDelay", "type": "number", "default": 1000, "required": false, "description": "Base delay in milliseconds before the first retry." }, { "name": "maxDelay", "type": "number", "default": 30000, "required": false, "description": "Maximum delay cap in milliseconds." }, { "name": "jitter", "type": "boolean", "default": true, "required": false, "description": "Add random jitter to the delay to prevent thundering herd." }, { "name": "retryOn", "type": "(error: Error) => boolean", "required": false, "description": "Optional predicate to decide whether an error is retryable." } ], "radzor": "1.0.0", "actions": [ { "name": "execute", "params": [ { "name": "fn", "type": "() => Promise<T>", "description": "The async operation to execute with retry logic." } ], "returns": "Promise<RetryResult<T>>", "description": "Execute a function with retry logic applied." }, { "name": "configure", "params": [ { "name": "options", "type": "Partial<RetryConfig>", "description": "Updated configuration options." } ], "returns": "void", "description": "Update retry configuration at runtime." }, { "name": "getStats", "params": [], "returns": "RetryStats", "description": "Get cumulative statistics across all executions." }, { "name": "reset", "params": [], "returns": "void", "description": "Reset cumulative statistics." } ], "outputs": [ { "name": "retryResult", "type": "RetryResult<T>", "fields": [ { "name": "success", "type": "boolean", "description": "Whether the operation eventually succeeded." }, { "name": "data", "type": "T | undefined", "description": "Return value if successful." }, { "name": "attempts", "type": "number", "description": "Total number of attempts made." }, { "name": "lastError", "type": "Error | null", "description": "Last error encountered, or null if successful." }, { "name": "totalTime", "type": "number", "description": "Total elapsed time in milliseconds." } ], "description": "Result of the retry operation." } ], "runtime": "universal", "version": "0.1.0", "category": "automation", "languages": [ "typescript", "python" ], "description": "Retry failed operations with configurable backoff strategies including exponential, linear, and jitter. Tracks attempt history and provides detailed statistics on retry behaviour.", "dependencies": { "radzor": [], "packages": {} }, "composability": { "connectsTo": [ { "event": "onExhausted", "description": "Alert when all retry attempts exhausted", "compatibleWith": [ "@radzor/error-tracker.action.captureMessage.message", "@radzor/notification-hub.action.send.body", "@radzor/slack-bot.action.sendMessage.text" ] }, { "output": "retryResult", "mapField": "attempts", "compatibleWith": [ "@radzor/log-aggregator.action.info.message" ] } ] } }

@radzor/retry-handler

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json