reqforge 0.7.0 → 0.8.0

package/README.md

@@ -11,19 +11,32 @@ npm install reqforge
 ## Quick Start
 
 ```javascript
-const { config, request, auth, errors } = require('reqforge');
-
-// Make a request with error handling
-request.get('/users')
-  .then(res => res.json())
-  .then(data => console.log(data))
-  .catch(err => {
-    if (err instanceof errors.NetworkError) {
-      console.error('Network issue:', err.message);
-    }
-  });
+const { config, request, retry } = require('reqforge');
+
+// Make a request with automatic retry
+retry.withRetry(() => {
+  return request.get('/users')
+    .then(res => res.json());
+}, { maxRetries: 3, delay: 1000 })
+  .then(data => console.log(data));
 ```
 
+## Retry Mechanism
+
+The `retry` module provides:
+
+- `withRetry(fn, options)` - Execute function with automatic retry
+- `calculateBackoff(attempt, baseDelay, maxDelay)` - Calculate exponential backoff delay
+
+### Retry Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `maxRetries` | 3 | Maximum number of retry attempts |
+| `delay` | 1000 | Initial delay in milliseconds |
+| `backoff` | 2 | Backoff multiplier |
+| `shouldRetry` | `() => true` | Function to determine if retry should occur |
+
 ## Error Handling
 
 The `errors` module provides:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reqforge",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "A lightweight, flexible HTTP client library with request interception, automatic retry, and logging capabilities, designed for modern web applications.",
   "main": "src/index.js",
   "scripts": {

package/src/index.js

@@ -9,6 +9,7 @@ const request = require('./request');
 const Logger = require('./logger');
 const auth = require('./auth');
 const errors = require('./errors');
+const retry = require('./retry');
 
 module.exports = {
   config,
@@ -16,5 +17,6 @@ module.exports = {
   request,
   Logger,
   auth,
-  errors
+  errors,
+  retry
 };

package/src/retry.js

@@ -0,0 +1,56 @@
+/**
+ * Retry mechanism module for ReqForge
+ * @module retry
+ */
+
+/**
+ * Execute function with retry
+ * @param {Function} fn - Function to execute
+ * @param {Object} options - Retry options
+ * @returns {Promise} Result of the function
+ */
+async function withRetry(fn, options = {}) {
+  const {
+    maxRetries = 3,
+    delay = 1000,
+    backoff = 2,
+    shouldRetry = () => true
+  } = options;
+
+  let lastError;
+  let currentDelay = delay;
+
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      lastError = error;
+
+      if (attempt === maxRetries || !shouldRetry(error)) {
+        throw error;
+      }
+
+      await new Promise(resolve => setTimeout(resolve, currentDelay));
+      currentDelay *= backoff;
+    }
+  }
+
+  throw lastError;
+}
+
+/**
+ * Calculate exponential backoff delay
+ * @param {number} attempt - Current attempt number
+ * @param {number} baseDelay - Base delay in ms
+ * @param {number} maxDelay - Maximum delay in ms
+ * @returns {number} Delay in ms
+ */
+function calculateBackoff(attempt, baseDelay = 1000, maxDelay = 30000) {
+  const delay = baseDelay * Math.pow(2, attempt);
+  return Math.min(delay, maxDelay);
+}
+
+module.exports = {
+  withRetry,
+  calculateBackoff
+};