@jfungus/ratelimit-h3

@jfungus/ratelimit-h3

Rate limiting middleware for H3 and Nitro.

Installation

npm install @jfungus/ratelimit-h3

Usage

H3

import { createApp, createRouter, eventHandler } from "h3";
import { rateLimiter } from "@jfungus/ratelimit-h3";

const app = createApp();

// Apply rate limiting globally
app.use(
  rateLimiter({
    limit: 100,
    windowMs: 60 * 1000, // 1 minute
  }),
);

const router = createRouter();
router.get(
  "/",
  eventHandler(() => "Hello!"),
);

app.use(router);

Nitro

// server/middleware/ratelimit.ts
import { rateLimiter } from "@jfungus/ratelimit-h3";

export default rateLimiter({
  limit: 100,
  windowMs: 60 * 1000, // 1 minute
});

Options

Custom Key Generator

import { getHeader } from "h3";

app.use(
  rateLimiter({
    limit: 100,
    windowMs: 60 * 1000,
    keyGenerator: (event) => {
      // Rate limit by API key
      return getHeader(event, "x-api-key") || "anonymous";
    },
  }),
);

Distributed Storage

For multi-instance deployments, use @jfungus/ratelimit-unstorage:

import { createStorage } from "unstorage";
import redisDriver from "unstorage/drivers/redis";
import { createUnstorageStore } from "@jfungus/ratelimit-unstorage";

const storage = createStorage({
  driver: redisDriver({ url: "redis://localhost:6379" }),
});

app.use(
  rateLimiter({
    limit: 100,
    windowMs: 60 * 1000,
    store: createUnstorageStore({ storage }),
  }),
);

Nuxt

For Nuxt applications, use the dedicated module @jfungus/ratelimit-nuxt instead.

Documentation

Full documentation

License

MIT