Skip to main content
Version: 1.x

RateLimitHooks

RateLimitHooks​

Optional lifecycle hooks used by the plugin to surface rate limit events.

Signature
interface RateLimitHooks {
onRateLimited?: (info: RateLimitHookContext) => void | Promise<void>;
onAllowed?: (info: RateLimitHookContext) => void | Promise<void>;
onReset?: (key: string) => void | Promise<void>;
onViolation?: (key: string, count: number) => void | Promise<void>;
onStorageError?: (
error: unknown,
fallbackUsed: boolean,
) => void | Promise<void>;
}

onRateLimited​

property
(info: RateLimitHookContext) => void | Promise<void>

onAllowed​

property
(info: RateLimitHookContext) => void | Promise<void>

onReset​

property
(key: string) => void | Promise<void>

onViolation​

property
(key: string, count: number) => void | Promise<void>

onStorageError​

property
( error: unknown, fallbackUsed: boolean, ) => void | Promise<void>