Struct WaveTracker 

pub struct WaveTracker { /* private fields */ }

Central state machine for tracking active waves.

Implementations

impl WaveTracker

pub fn new() -> Self

Creates a new empty wave tracker.

pub fn register_wave(&mut self, wave_id: String, expected_total: u32)

Register a new wave.

Warns and overwrites if a wave with the same ID is already active.

pub fn record_result( &mut self, wave_id: &str, index: u32, events: Vec<Event>, ) -> WaveProgress

Record result events for a wave instance. Returns the wave progress after recording.

pub fn record_failure( &mut self, wave_id: &str, index: u32, error: String, duration: Duration, ) -> WaveProgress

Record a failure for a wave instance. Returns the wave progress after recording.

pub fn is_complete(&self, wave_id: &str) -> bool

Check if a wave is complete (all results + failures == expected total).

pub fn take_wave_results(&mut self, wave_id: &str) -> Option<CompletedWave>

Consume a completed wave, removing it from tracking.

pub fn has_active_waves(&self) -> bool

Check if any wave is currently active.

pub fn timed_out_waves(&self, timeout: Duration) -> Vec<&str>

Returns wave IDs that have exceeded the given timeout since registration.

Useful for enforcing aggregate timeouts — callers can force-complete these waves with partial results.

Trait Implementations

impl Debug for WaveTracker

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for WaveTracker

fn default() -> WaveTracker

Returns the “default value” for a type.