RateLimiterDO

Durable Object that maintains an atomic rate limit counter.

Each unique rate limit key maps to one DO instance via idFromName(key). The counter auto-expires using the DO alarm API.

Consumer setup: Export this class from your Worker entry point and reference it in wrangler.jsonc:

{
  "durable_objects": {
    "bindings": [
      {
        "name": "RATE_LIMITER",
        "class_name": "RateLimiterDO"
      }
    ]
  }
}

// worker entry
export { RateLimiterDO } from "@homegrower-club/stoma/adapters";

Implements

new RateLimiterDO(state): RateLimiterDO

DurableObjectState

RateLimiterDO

alarm(): Promise<void>

Promise<void>

DurableObject.alarm

fetch(request): Promise<Response>

Request

Promise<Response>

DurableObject.fetch