reqforge

ReqForge

A lightweight, flexible HTTP client library with request interception, automatic retry, and logging capabilities, designed for modern web applications.

Installation

npm install reqforge

Quick Start

const { request, interceptor } = require('reqforge');

// Add a request interceptor
const reqInterceptor = interceptor.createRequestInterceptor();
reqInterceptor.use((config) => {
  console.log('Request:', config.url);
  return config;
});

// Make a request
request.get('/users')
  .then(res => res.json())
  .then(data => console.log(data));

Interceptors

The interceptor module provides request and response interception:

• createRequestInterceptor() - Create request interceptor manager
• createResponseInterceptor() - Create response interceptor manager

InterceptorManager Methods

• use(fulfilled, rejected) - Add interceptor handler
• eject(id) - Remove interceptor handler
• clear() - Clear all handlers

Retry Mechanism

The retry module provides:

• withRetry(fn, options) - Execute function with automatic retry
• calculateBackoff(attempt, baseDelay, maxDelay) - Calculate exponential backoff delay

Error Handling

The errors module provides:

• ReqForgeError - Base error class
• NetworkError - Network request failures
• TimeoutError - Request timeout errors
• AuthError - Authentication failures
• ValidationError - Validation errors
• ErrorCodes - Error code constants

Authentication

The auth module provides:

• login(username, password) - Login and store token
• logout() - Logout and clear token
• getToken() - Get current auth token
• setToken(token) - Set auth token manually
• isAuthenticated() - Check if authenticated

Request Methods

The request module provides:

• sendRequest(endpoint, data, options) - Generic request method
• get(endpoint, options) - GET request
• post(endpoint, data, options) - POST request
• put(endpoint, data, options) - PUT request
• del(endpoint, options) - DELETE request

Logger

The Logger class provides:

• log(message) - Log a message
• info(message) - Log an info message
• warn(message) - Log a warning message
• error(message) - Log an error message

Configuration

The config module provides:

• getBaseURL() - Get the base URL for API requests
• API_VERSION - Current API version
• defaultConfig - Default configuration object
• mergeConfig(customConfig) - Merge custom configuration with defaults

Utilities

The utils module provides:

• buildURL(baseURL, params) - Build URL with query parameters
• serializeQuery(obj) - Serialize object to query string
• parseQuery(queryString) - Parse query string to object
• deepMerge(target, source) - Deep merge objects
• isPlainObject(value) - Check if value is a plain object
• delay(ms) - Delay execution

License

MIT