Struct SequenceGenerator 

pub struct SequenceGenerator { /* private fields */ }

Per-workspace sequence and wall-clock generator.

Guarantees:

• seq is strictly monotonically increasing (starts at 1).
• wall_clock_ms is non-decreasing: max(now_ms, last_seen + 1).

Usage

let mut seq_gen = SequenceGenerator::new();
let (seq, wall_ms) = seq_gen.next(); // (1, now_ms)
let (seq, wall_ms) = seq_gen.next(); // (2, max(now_ms, prev+1))

Implementations

impl SequenceGenerator

pub const fn new() -> Self

Create a new generator starting at seq=0 (next call returns 1).

pub const fn resume(last_seq: u64, last_wall_clock_ms: u64) -> Self

Resume from a known state (e.g., loaded from persistent storage).

pub fn next(&mut self) -> (u64, u64)

Generate the next (seq, wall_clock_ms) pair.

Wall clock is clamped: if the system clock went backward (NTP step, VM resume), we use last_seen + 1 instead of going backward.

pub fn next_with_clock(&mut self, now_ms: u64) -> (u64, u64)

Generate the next (seq, wall_clock_ms) pair using a provided wall clock.

This is primarily for testing — in production use Self::next().

pub const fn last_seq(&self) -> u64

The last sequence number generated (0 if none yet).

pub const fn last_wall_clock_ms(&self) -> u64

The last wall-clock value generated (0 if none yet).

Trait Implementations

impl Clone for SequenceGenerator

fn clone(&self) -> SequenceGenerator

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SequenceGenerator

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

Formats the value using the given formatter.

impl Default for SequenceGenerator

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SequenceGenerator

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SequenceGenerator

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.