advance-rate-limiter

• sliding window counter algorithm is used

advance-rate-limiter is a sophisticated middleware for Express.js applications that provides rate limiting using Redis and a sliding window counter algorithm. Configure rate limits dynamically through a JSON file and integrate seamlessly into your Express application.

🚀 Features

• Dynamic Rate Limiting: Configure rate limits for different endpoints using a JSON configuration file.
• Sliding Window Algorithm: Implement precise rate limiting with the sliding window approach.
• Redis Integration: Utilize Redis for efficient request tracking and storage.
• Flexible Setup: Easily configure Redis and apply rate limiting in your Express app.

📦 Installation

Install advance-rate-limiter via npm:

1npm install advance-rate-limiter

🛠️ Setup and Configuration

1. Initialize Redis Client

📋 Redis Configuration

To set up the Redis client with the advance-rate-limiter package, use the following code:

1import { setupRedisClient } from 'advance-rate-limiter';
2
3// Configuration object for Redis
4const redisConfig = {
5    host: 'your-redis-host',
6    port: 'your-redis-port',
7    password: 'your-redis-password', // Optional: Include if your Redis instance requires authentication
8};
9
10// Initialize Redis client with the configuration
11setupRedisClient(redisConfig);

2. Configure Rate Limits Create a rateLimitConfig.json file in your project’s root directory. Define your rate limits for different endpoints as follows: for rateLimiter method

1{
2    "/api/endpoint1": { "limit": 2, "windowTime": 60 }, // 2 requests per minute
3    "/api/endpoint2": { "limit": 5, "windowTime": 120 } // 5 requests per 2 minutes
4}

for globalRateLimiter method

1{
2    "limit": 10, // allow 10 request
3    "windowTime" : 60 // time limit is 1 minutes
4}

3. Apply Middleware for rateLimiter Use the rateLimiter middleware in your Express application by passing the rate limit configuration loaded from the JSON file.

1import express from 'express';
2import rateLimiter, { setupRedisClient } from 'advance-rate-limiter';
3import * as fs from 'fs';
4import * as path from 'path';
5
6const app = express();
7
8// Load rate limit configuration from JSON file
9const rateLimitConfigPath = path.join(__dirname, 'rateLimitConfig.json');
10const rateLimitConfig = JSON.parse(fs.readFileSync(rateLimitConfigPath, 'utf8'));
11
12// Initialize Redis client
13const redisConfig = {
14    host: 'your-redis-host',
15    port: 'your-redis-port',
16    password: 'your-redis-password',
17};
18
19setupRedisClient(redisConfig);
20
21// Apply rate limiter middleware
22app.use(rateLimiter(rateLimitConfig));
23
24app.get('/api/endpoint1', (req, res) => {
25    res.send('API endpoint 1 is working');
26});
27
28app.get('/api/endpoint2', (req, res) => {
29    res.send('API endpoint 2 is working');
30});
31
32app.listen(3000, () => {
33    console.log('Server is running on port 3000');
34});

4. Apply middleware for globalRateLimiter

1import express from 'express';
2import { setupRedisClient, globalRateLimiter } from 'advance-rate-limiter';
3import globalRateLimitConfig from './globalRateLimitConfig.json' assert {type : 'json'};
4
5
6const app = express();
7
8
9console.log("this is rate-limit- config", globalRateLimitConfig);
10
11// Initialize Redis client
12const redisConfig = {
13    host: 'your-redis-host',
14    port: 'your-redis-port',
15    password: 'your-redis-password',
16};
17
18setupRedisClient(redisConfig);
19
20// Apply rate limiter middleware
21app.use(globalRateLimiter(globalRateLimitConfig));
22
23app.get('/api/endpoint1', (req, res) => {
24    res.send('API endpoint 1 is working');
25});
26
27app.get('/api/endpoint2', (req, res) => {
28    res.send('API endpoint 2 is working');
29});
30
31app.listen(3000, () => {
32    console.log('Server is running on port 3000');
33});

⚙️ Options

• rateLimits: An object or JSON file defining rate limits for different routes.

  • Key: The API endpoint (e.g., /api/endpoint1).
  • Value: An object with limit (maximum number of requests) and windowTime (time window in seconds).

• redisConfig: Configuration object for Redis.

  • host: The Redis server hostname.
  • port: The Redis server port (default is 6379).
  • password: Optional Redis password.

🔍 Keywords

• Express Rate Limiter
• Redis Rate Limiting
• Sliding Window Algorithm
• API Rate Limiting Middleware
• Express Middleware

📈Metrics

• NPM Downloads:
• Version:
• License:

🧪 Testing

To run the tests for this package, ensure you have jest installed and run: npm test

📜 License

This project is licensed under the MIT License.

functions

Configuration Details

Function	Configuration	Remark
setupRedisClient	{ host: 'your-redis-host', port: 'your-redis-port', password: 'your-redis-password' }	Sets up the Redis connection. Include the password field if your Redis instance requires authentication.
rateLimiter	{ "/api/endpoint1": { "limit": 2, "windowTime": 60 }, "/api/endpoint2": { "limit": 5, "windowTime": 120 } }	1. /api/endpoint1: Allows a maximum of 2 requests per minute (60 seconds). 2. /api/endpoint2: Allows a maximum of 5 requests per 2 minutes (120 seconds). These rate limits help prevent abuse by limiting the number of requests that can be made to each endpoint within a specified time window.
globalRateLimiter	{ "limit": 10, "windowTime" : 60 }	1. limit: The total number of requests allowed. 2. windowTime: The time frame (in seconds) within which the specified number of requests is allowed. This global rate limit applies across your entire project if implemented at the entry point of your application (e.g., in the index.js file).