Struct RateLimit 

pub struct RateLimit { /* private fields */ }

Rate limiter plugin / route middleware.

Implementations

impl RateLimit

pub fn new(max: usize, window: Duration) -> Self

Local process sliding window (default).

pub fn per_minute(max: usize) -> Self

pub fn max_entries(self, n: usize) -> Self

Cap distinct client keys retained for local sliding (default 10_000).

pub fn message(self, msg: impl Into<String>) -> Self

429 response body (default "Too Many Requests").

pub fn key(self, key: RateLimitKey) -> Self

Built-in key strategy (default RateLimitKey::Ip).

pub fn prefix(self, prefix: &'static str) -> Self

Prefix prepended to the resolved key (login:…, forgot:…).

pub fn key_fn<F>(self, f: F) -> Self

where F: Fn(&Request) -> String + Send + Sync + 'static,

Custom rate-limit key (overrides Self::key).

pub fn skip<F>(self, f: F) -> Self

where F: Fn(&Request) -> bool + Send + Sync + 'static,

Skip limiting when this returns true.

pub fn fixed_window( store: Arc<dyn KvStore>, max: usize, window: Duration, ) -> Self

Multi-process / shared store: fixed window via atomic incr.

pub fn shared(app: &App, max: usize, window: Duration) -> Self

Like Self::fixed_window, using an installed sova_store::AppStore (rl namespace).

pub fn login() -> Self

Login POST throttle: 5 / 60s, key = IP + email.

pub fn forgot() -> Self

Forgot-password throttle: 5 / 60s, IP + email.

pub fn challenge() -> Self

2FA challenge throttle: 5 / 60s, IP.

pub fn resend() -> Self

Email verification resend: 6 / 60s, IP + email.

pub fn middleware(self) -> MwEntry

Route / mount middleware (same check as the plugin).

Trait Implementations

impl Plugin for RateLimit

fn id(&self) -> &'static str

Stable plugin identifier used for dependency checks and crate::App::has_plugin.

fn meta(&self) -> PluginMeta

Display name, description, and declared PluginMeta::sdk version.

fn install(self, app: &mut App)

Register middleware, state, routes, and hooks on app.

fn requires(&self) -> &'static [&'static str]

Required plugin ids that must be installed beforehand.