Struct OdoIDGenerator 

pub struct OdoIDGenerator {
    pub namespace: String,
    pub length: usize,
    pub capacity: u64,
    /* private fields */
}

A distributed monotonic generator that produces OdoID strings driven by a namespace-scoped, time-seeded pseudo-random integer.

The generator guarantees that rapid successive calls within the same millisecond tick produce distinct values via a monotonically incrementing sequence counter. Output is always in [0, capacity) so encode never returns OdoError::Overflow internally.

Fields

namespace: String

length: usize

capacity: u64

Implementations

impl OdoIDGenerator

pub fn new(config: GeneratorConfig) -> Result<Self, UnsupportedLengthError>

Creates a new OdoIDGenerator from config.

Errors

Returns UnsupportedLengthError if config.length is not 6, 7, or 8.

pub fn next_n(&mut self) -> u64

Returns the next raw integer n in [0, capacity). Exposed for testing and low-level use.

pub fn next(&mut self) -> Result<OdoIDResult, OdoError>

Generates and returns the next OdoID.

pub fn encode(&self, n: u64) -> Result<String, OdoError>

Encodes n using this generator’s configured length.

pub fn decode(&self, id: &str) -> Result<u64, OdoError>

Decodes an OdoID string to its originating integer.