Struct TimerState 

pub struct TimerState { /* private fields */ }

Manages timer state for one execution context.

Implementations

impl TimerState

pub fn new() -> Self

pub fn register( &mut self, delay_ms: u32, is_interval: bool, callback_source: String, ) -> Option<u32>

Register a new timer. Returns Some(timer_id) on success, or None if the timer ID space is exhausted or the pending timer cap is reached.

pub fn cancel(&mut self, id: u32)

Cancel a timer by ID.

pub fn drain_next(&mut self) -> Option<String>

Drain the next ready timer callback.

Returns the callback source code to eval, or None if no timers are ready. For “drain immediately” mode, all timers are considered ready.

CRITICAL FIX: Tracks unique callbacks to prevent fingerprinting via timer drain patterns. Returns None if this exact callback was already drained (prevents duplicate execution).

pub fn is_callback_drained(&self, callback_source: &str) -> bool

Check if a callback source has been drained before. CRITICAL FIX: Used to prevent fingerprinting via timer drain patterns.

pub fn unique_drained_count(&self) -> usize

Number of unique callbacks that have been drained. CRITICAL FIX: Use this instead of iteration count for drain limits.

pub fn reset_drained_tracking(&mut self)

Reset the drained callbacks tracking. CRITICAL FIX: Allows intentional re-draining in new analysis phases.

pub fn fast_forward(&mut self, advance_ms: u64) -> Vec<String>

Advance simulated time and drain all timers that have elapsed. Returns callback source codes in firing order.

pub fn pending_count(&self) -> usize

Number of pending (non-cancelled) timers.

pub fn simulated_time_ms(&self) -> u64

Current simulated time in milliseconds.

Trait Implementations

impl Debug for TimerState

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

Formats the value using the given formatter.

impl Default for TimerState

fn default() -> TimerState

Returns the “default value” for a type.