🎯 Why one-request-4-all?

Tired of heavy HTTP libraries? one-request-4-all is a lightweight, native Node.js fetch implementation that provides the exact same interface as axios. Just change the import and enjoy a smaller bundle size!

✨ Key Features

📦 Installation

# npm
npm install r3q

# yarn
yarn add r3q

# bun
bun add r3q

🚀 Quick Start

Basic Usage

import reqify from "r3q";

// GET request
const response = await reqify.get("https://api.example.com/users");
console.log(response.data);

// POST request
const newUser = await reqify.post("https://api.example.com/users", {
  name: "John Doe",
  email: "[email protected]",
});

Drop-in Replacement for Axios

// Before (with axios)
import axios from "axios";

// After (with reqify)
import reqify from "r3q";

// Same interface, same usage!
const response = await reqify.get("/api/users", {
  headers: {
    Authorization: "Bearer token",
  },
});

📚 API Reference

Request Methods

// GET, DELETE, HEAD, OPTIONS
await reqify.get<T>(url, config?)
await reqify.delete<T>(url, config?)
await reqify.head<T>(url, config?)
await reqify.options<T>(url, config?)

// POST, PUT, PATCH
await reqify.post<T>(url, data?, config?)
await reqify.put<T>(url, data?, config?)
await reqify.patch<T>(url, data?, config?)

// Generic request
await reqify<T>(config)
await reqify<T>(url, config)

Request Configuration

interface reqify<D = any> {
  url: string;
  method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
  headers?: Record<string, string>;
  data?: D;
  params?: Record<string, string | number | boolean>;
  responseType?: 'json' | 'text' | 'stream';
}

Response Object

interface one-request-4-allResponse<T = any, D = any> {
  data: T;
  status: number;
  statusText: string;
  headers: Headers;
  config: reqify<D>;
  request: Response;
}

🔧 Auto-Healing

one-request-4-all includes a powerful auto-healing system that automatically detects and recovers from common HTTP errors:

// Auto-healing is enabled by default
const response = await reqify.get("https://api.example.com/data", {
  maxRetries: 3, // Number of retry attempts (default: 3)
  timeout: 5000, // Initial timeout in ms (default: 5000)
  autoHeal: true, // Enable auto-healing (default: true)
});

// Check if the request was healed
if (response.healed) {
  console.log("✅ Request was automatically healed!");
  console.log("Message:", response.healMessage);
  // Example: "Rate limited - retry after 1000ms"
}

Supported Error Recovery

• 401 Unauthorized: Increases timeout and retries
• 403 Forbidden: Adjusts timeout for permission checks
• 413 Payload Too Large: Removes optional fields from payload (description, metadata, avatar, etc.)
• 422 Validation Error: Creates values based on expected types
• 429 Rate Limit: Respects Retry-After header or uses exponential backoff
• Timeout: Progressively increases timeout (max 30s)
• Network Errors: Retries with increased timeout
• Parse Errors: Handles malformed JSON responses

Value Creation Heuristic

When validation fails (422 error), one-request-4-all automatically creates values based on the expected type:

import { createValueFromType } from "r3q";

createValueFromType("expected email"); // "[email protected]"
createValueFromType("must be number"); // 0
createValueFromType("expected uuid"); // "00000000-0000-0000-0000-000000000000"

📖 Read the full Auto-Healing documentation

💡 Advanced Usage

Query Parameters

const response = await reqify.get("https://api.example.com/users", {
  params: {
    page: 1,
    limit: 10,
    active: true,
  },
});
// GET https://api.example.com/users?page=1&limit=10&active=true

Custom Headers

const response = await reqify.post("https://api.example.com/users", userData, {
  headers: {
    Authorization: "Bearer token123",
    "Content-Type": "application/json",
    "X-API-Key": "your-api-key",
  },
});

Different Response Types

// JSON (default)
const jsonData = await reqify.get("/api/data");

// Text response
const textData = await reqify.get("/api/text", {
  responseType: "text",
});

// Stream response
const streamData = await reqify.get("/api/file", {
  responseType: "stream",
});

Error Handling

try {
  const response = await reqify.get("/api/users/123");
  console.log(response.data);
} catch (error) {
  if (error.response) {
    // Server responded with error status
    console.log(error.response.status);
    console.log(error.response.data);
  } else if (error.request) {
    // Network error
    console.log("Network error");
  } else {
    // Other error
    console.log("Error:", error.message);
  }
}

🔄 Migration from Axios

Step 1: Change the import

// Before
import axios from "axios";

// After
import reqify from "r3q";

Step 2: Change the usage (if needed)

// Before
const response = await axios.get("/api/users");

// After (same syntax works!)
const response = await reqify.get("/api/users");

Compatibility Notes

• ✅ Same method signatures
• ✅ Same response structure
• ✅ Same error handling
• ✅ Same configuration options
• ✅ Full TypeScript support
• ⚠️ Some advanced axios features may not be implemented yet

🧪 Testing

npm test

🔧 Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

📄 License

MIT License - see the LICENSE file for details.