/* * SPDX-FileCopyrightText: 2020 Stalwart Labs Ltd * * SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-SEL */ use std::{ sync::atomic::{AtomicU64, Ordering}, time::{Duration, SystemTime}, }; #[derive(Debug)] pub struct SnowflakeIdGenerator { epoch: SystemTime, node_id: u64, sequence: AtomicU64, } const SEQUENCE_LEN: u64 = 12; const NODE_ID_LEN: u64 = 9; const SEQUENCE_MASK: u64 = (1 << SEQUENCE_LEN) - 1; const NODE_ID_MASK: u64 = (1 << NODE_ID_LEN) - 1; /* ID characteristics: - 43 bits for milliseconds since January 1st, 2022: 2^43 / (1000 * 60 * 60 * 24 * 365) = 278.92 years - 9 bits for a node id: 2^9 = 512 nodes - 12 bits for a sequence number: 2^12 = 4096 ids per millisecond */ impl SnowflakeIdGenerator { pub fn new() -> Self { Self::with_node_id(rand::random::()) } pub fn from_duration(period: Duration) -> Option { (SystemTime::UNIX_EPOCH + Duration::from_secs(1632280000)) .elapsed() .ok() .and_then(|elapsed| elapsed.checked_sub(period)) .map(|elapsed| (elapsed.as_millis() as u64) << (SEQUENCE_LEN + NODE_ID_LEN)) } pub fn from_timestamp(timestamp: u64) -> Option { SystemTime::now() .duration_since(SystemTime::UNIX_EPOCH) .ok() .and_then(|now| now.as_secs().checked_sub(timestamp)) .and_then(|diff| Self::from_duration(Duration::from_secs(diff))) } pub fn with_node_id(node_id: u64) -> Self { Self { epoch: SystemTime::UNIX_EPOCH + Duration::from_secs(1632280000), // 52 years after UNIX_EPOCH node_id, sequence: 0.into(), } } #[inline(always)] pub fn past_id(&self, period: Duration) -> Option { self.epoch .elapsed() .ok() .and_then(|elapsed| elapsed.checked_sub(period)) .map(|elapsed| (elapsed.as_millis() as u64) << (SEQUENCE_LEN + NODE_ID_LEN)) } #[inline(always)] pub fn generate(&self) -> Option { let elapsed = self.epoch.elapsed().ok()?.as_millis() as u64; let sequence = self.sequence.fetch_add(1, Ordering::Relaxed); (elapsed << (SEQUENCE_LEN + NODE_ID_LEN) | (self.node_id & NODE_ID_MASK) << SEQUENCE_LEN | (sequence & SEQUENCE_MASK)) .into() } } impl Default for SnowflakeIdGenerator { fn default() -> Self { Self::new() } } impl Clone for SnowflakeIdGenerator { fn clone(&self) -> Self { Self { epoch: self.epoch, node_id: self.node_id, sequence: 0.into(), } } }