IRateLimiter

Sliding-window rate limiting keyed by caller-built strings, available as core.rateLimitercore.rateLimiter.

Async so one interface spans the in-memory default and durable store backends. The in-memory implementation resolves synchronously, so the awaitawait costs no event-loop yield.

interface IRateLimiter

interface IRateLimiter

Methods

charge()
peek()
reset()

charge()

Records a use of keykey if the window has a free slot, in one atomic step.

async charge(
    key: string,
    window: RateLimitWindow
): Promise<RateLimitResult>

async charge(
    key: string,
    window: RateLimitWindow
): Promise<RateLimitResult>

Parameter: key

The bucket to charge. Build it from your own scope, or with buildKeybuildKey from @seedcord/rate-limiter@seedcord/rate-limiter.

Parameter: window

The usage window to apply.

peek()

Reports keykey's limited state without recording a use.

The read half of a peek-then-commit. The CooldownCooldown gate peeks in its check and charges in its commit, so a refusal elsewhere in the gate set never burns the slot.

async peek(
    key: string,
    window: RateLimitWindow
): Promise<RateLimitResult>

async peek(
    key: string,
    window: RateLimitWindow
): Promise<RateLimitResult>

reset()

Clears keykey's recorded uses.

async reset(key: string): Promise<void>

async reset(key: string): Promise<void>