herolib-sid 0.1.0

SmartID - Short, human-readable, collision-free identifiers
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

//! SmartID (SID) - Distributed, Human-Readable Identifiers
//!
//! SmartID provides short, human-readable identifiers for distributed systems.
//! This module is used internally by the Context module for ID generation.
//!
//! # Design Targets
//!
//! - Human-friendly (chat, voice, memory)
//! - Deterministic & auditable
//! - Collision-free
//! - Offline-capable
//! - Scalable (up to 999 contributors)
//!
//! # Alphabet
//!
//! Base-36: `0123456789abcdefghijklmnopqrstuvwxyz`
//!
//! # Formula
//!
//! ```text
//! global_id = local_counter * num_contributors + contributor_id + 1
//! ```

pub mod base36;
mod contributor;
mod error;
mod smartid;

pub use contributor::MAX_CONTRIBUTORS;
pub use error::{Result, SidError};
pub use smartid::SmartId;