pub struct SessionRecorder<M: Model> { /* private fields */ }Expand description
Records a WASM session for deterministic replay.
Wraps a StepProgram and intercepts all input operations, recording
them as TraceRecords. Frame checksums are computed after each render
using the same FNV-1a algorithm as the render trace system.
Implementations§
Source§impl<M: Model> SessionRecorder<M>
impl<M: Model> SessionRecorder<M>
Sourcepub fn new(model: M, width: u16, height: u16, seed: u64) -> Self
pub fn new(model: M, width: u16, height: u16, seed: u64) -> Self
Create a new recorder with the given model, initial size, and seed.
Sourcepub fn init(&mut self) -> Result<(), WebBackendError>
pub fn init(&mut self) -> Result<(), WebBackendError>
Record initialization and its frame checkpoint, if it renders.
Sourcepub fn push_event(
&mut self,
ts_ns: u64,
event: Event,
) -> Result<(), WebBackendError>
pub fn push_event( &mut self, ts_ns: u64, event: Event, ) -> Result<(), WebBackendError>
Record an input event at the given timestamp (nanoseconds since start).
Sourcepub fn resize(
&mut self,
ts_ns: u64,
width: u16,
height: u16,
) -> Result<(), WebBackendError>
pub fn resize( &mut self, ts_ns: u64, width: u16, height: u16, ) -> Result<(), WebBackendError>
Record a resize at the given timestamp.
Sourcepub fn advance_time(&mut self, ts_ns: u64, dt: Duration)
pub fn advance_time(&mut self, ts_ns: u64, dt: Duration)
Record a time advancement (tick) at the given timestamp.
Sourcepub fn step(&mut self) -> Result<StepResult, WebBackendError>
pub fn step(&mut self) -> Result<StepResult, WebBackendError>
Record an actual step, including non-rendering outcomes and pending input.
Sourcepub fn finish(self) -> SessionTrace
pub fn finish(self) -> SessionTrace
Finish recording and return the completed trace.
Does not step or flush pending input. Validation rejects a recording whose final admissions or time advance lack an observed step boundary.
Sourcepub fn program(&self) -> &StepProgram<M>
pub fn program(&self) -> &StepProgram<M>
Access the underlying program.
Sourcepub fn program_mut(&mut self) -> &mut StepProgram<M>
pub fn program_mut(&mut self) -> &mut StepProgram<M>
Mutably access the underlying program.
Direct input, stepping, or queue recovery bypasses recording. Use the recorder methods for operations that must be captured in the trace.