🔁 retryx

A tiny, flexible, Promise-based retry utility with support for delays, exponential backoff, per-attempt timeouts, and custom retry conditions.

🚀 Features

• Retry any async function
• Delay and exponential backoff
• Timeout per attempt
• Custom retry filters
• onRetry logging hook
• Zero dependencies, TypeScript-ready

📦 Installation

npm install retryx
# or
yarn add retryx

💡 Usage

import { retry } from 'retryx'

const result = await retry(() => fetch('https://api.example.com'), {
  maxAttempts: 3,
  delay: 500,
  backoff: true,
  onRetry: (err, attempt) =>
    console.log(`Attempt ${attempt} failed: ${err.message}`),
})

🔧 Options

| Option | Type | Default | Description | |--------------|-------------------------------|-------------|-------------------------------------------| | maxAttempts| number | 3 | Max number of attempts (including the first) | | delay | number | 0 | Delay in ms between attempts | | backoff | boolean | false | Exponential backoff (delay × 2ⁿ) | | timeout | number | undefined | Timeout per attempt in ms | | onRetry | (error, attempt) => void | undefined | Callback after each failed attempt | | retryOn | (error) => boolean | Always | Custom error filter to allow/disallow retries |

❌ Example: Reject after timeout

await retry(
  () => new Promise((res) => setTimeout(() => res('done'), 300)),
  { timeout: 100 }
)
// ➡️ throws: Retry attempt timed out

✅ TypeScript Support

Built in — no extra types needed.

🛡️ License

MIT — build cool things with it!