rlimit.com rate limiting storage

A distributed rate limiting store for the hono-rate-limiter and express-rate-limit middleware.

Prerequisites

Sign up for a free account at rlimit.com and create a namespace, or use example as namespace ID to test the functionality.

Installation

From the npm registry:

1# Using npm
2> npm install @rlimit/storage
3# Using yarn or pnpm
4> yarn/pnpm add @rlimit/storage

Usage

Importing

This library is provided in ESM as well as CJS forms, and works with both Javascript and Typescript projects.

This package requires you to use Node 16 or above.

Import it in a CommonJS project (type: commonjs or no type field in package.json) as follows:

1const { Store } = require("@rlimit/storage");

Import it in a ESM project (type: module in package.json) as follows:

1import { Store } from "@rlimit/storage";

Examples

To use it with a hono-rate-limiter middleware:

Interactive demo on ratelimit.new/hono-rate-limiter

1import { serve } from "@hono/node-server";
2import { Hono } from "hono";
3import { Store } from "@rlimit/storage";
4
5import honoRateLimiter from "hono-rate-limiter";
6
7const limiter = honoRateLimiter.rateLimiter({
8  windowMs: 60 * 1000, // 1 minute
9  limit: 20, // Limit each key (from keyGenerator) to 20 requests per `window` (here, per 1 minute)
10  standardHeaders: "draft-6", // draft-6: `RateLimit-*` headers; draft-7: combined `RateLimit` header
11  keyGenerator: () => "<unique_key>", // Method to generate custom identifiers for clients, default to IP address
12  store: new Store({
13    namespace: "example", // your rlimit.com namespace ID
14  }),
15});
16
17const app = new Hono();
18
19app.use(limiter);
20
21app.get("/", (c) => {
22  // your application logic here
23  return c.json({ message: "Hello Hono!" });
24});
25
26serve(app);

To use it with a express-rate-limit middleware:

Interactive demo on rlimit.com/demos/nodejs-express

1import express from "express";
2import { rateLimit } from "express-rate-limit";
3import { Store } from "@rlimit/storage";
4
5const app = express();
6
7let rlimit = rateLimit({
8  // limit IP address to 3 requests every 5 seconds
9  limit: 3,
10  windowMs: 5_000,
11  store: new Store({
12    namespace: "example", // your rlimit.com namespace ID
13  }),
14});
15
16app.use(rlimit);
17app.get("/", async (req, res) => {
18  res.send("Hello World!");
19});
20
21app.listen(3000, () => {
22  console.log("Express application started");
23});