Struct ProgressionManager 

pub struct ProgressionManager { /* private fields */ }

Progressive challenge escalation manager

Implementations

impl ProgressionManager

pub fn new( cookie_manager: Arc<CookieManager>, js_manager: Arc<JsChallengeManager>, captcha_manager: Arc<CaptchaManager>, tarpit_manager: Arc<TarpitManager>, config: ProgressionConfig, ) -> Self

Create a new progression manager

pub fn config(&self) -> &ProgressionConfig

Get configuration

pub fn stats(&self) -> &ProgressionStats

Get current statistics

pub fn get_challenge( &self, actor_id: &str, risk_score: f64, ) -> ChallengeResponse

Get appropriate challenge for actor based on risk score and history

pub fn record_failure(&self, actor_id: &str)

Record a failed challenge attempt

pub fn record_success(&self, actor_id: &str)

Record a successful challenge completion

pub fn escalate(&self, actor_id: &str) -> ChallengeLevel

Manually escalate an actor

pub fn de_escalate(&self, actor_id: &str) -> ChallengeLevel

Manually de-escalate an actor

pub fn reset(&self, actor_id: &str)

Reset actor to no challenge

pub fn get_level(&self, actor_id: &str) -> ChallengeLevel

Get current level for actor

pub fn get_actor_state(&self, actor_id: &str) -> Option<ActorChallengeState>

Get actor state

pub fn list_actors_at_level( &self, level: ChallengeLevel, ) -> Vec<ActorChallengeState>

List actors at a specific challenge level

pub fn list_all_actors(&self) -> Vec<ActorChallengeState>

List all tracked actors

pub fn start_background_tasks(self: Arc<Self>)

Start background tasks (de-escalation, cleanup)

Spawns a background task that periodically runs maintenance. The task will exit cleanly when shutdown() is called.

pub fn shutdown(&self)

Signal shutdown for background tasks.

This method signals the background maintenance task to stop. The task will exit after completing any in-progress work.

pub fn run_maintenance(&self)

Run maintenance tasks (de-escalation, cleanup)

pub fn len(&self) -> usize

Get number of tracked actors

pub fn cookie_name(&self) -> &str

Get cookie challenge name for validation.

pub fn is_empty(&self) -> bool

Check if no actors are tracked

pub fn clear(&self)

Clear all state

pub fn validate_challenge( &self, actor_id: &str, response: &str, ) -> ValidationResult

Validate a challenge response for an actor