Struct DebouncedCheckpointStore 

pub struct DebouncedCheckpointStore { /* private fields */ }

Debouncing decorator over a KeyedCheckpointStore (#784, keyed in #1092). Buffers record_checkpoint in memory per CheckpointKey and forwards a durable write for a key only when its buffered block is at least flush_blocks ahead of that key’s last persisted value or at least flush_interval has elapsed since that key’s last durable write — cutting the per-block fsync amplification a watcher’s live tail would otherwise pay on a backlog drain.

Durability contract preserved (per key). The persisted value is only ever a floor for the resume backfill (the resumable watcher rewinds it by REORG_MARGIN_BLOCKS and every sink is idempotent), so a buffered-but-not-yet-fsynced advance that a crash loses merely widens the next rescan — never narrows it. record_checkpoint only raises a key’s pending, so the forwarded value stays monotonic. Self::flush_checkpoint forces the buffered value out and is wired into graceful shutdown.

Implementations

impl DebouncedCheckpointStore

pub fn new(inner: Arc<dyn KeyedCheckpointStore>) -> Self

Wrap inner with the production debounce thresholds (CHECKPOINT_FLUSH_BLOCKS / CHECKPOINT_FLUSH_INTERVAL) and the real wall clock.

Trait Implementations

impl Debug for DebouncedCheckpointStore

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

Formats the value using the given formatter.

impl KeyedCheckpointStore for DebouncedCheckpointStore

fn load_checkpoint(&self, key: CheckpointKey) -> Result<Option<u64>, StoreError>

The last block scanned for key, or None on a never-written key (first-ever boot for that watcher — the caller applies its configured none-fallback floor).

fn record_checkpoint( &self, key: CheckpointKey, block: u64, ) -> Result<(), StoreError>

Persist the last block scanned for key. Overwrites the prior value. Called as each backfill window and live tick advances, so the next boot resumes from here.

fn flush_checkpoint(&self, key: CheckpointKey) -> Result<(), StoreError>

Force any buffered checkpoint for key to durable storage. The default is a no-op: implementations that already commit durably inside record_checkpoint have nothing buffered. A debouncing decorator overrides this to fsync the latest deferred block, and the runtime calls it on graceful shutdown so the most recent scan progress is not lost to the next boot’s rescan.