Skip to main content

reifydb_core/key/
system_sequence.rs

1// SPDX-License-Identifier: Apache-2.0
2// Copyright (c) 2026 ReifyDB
3
4use reifydb_codec::key::{
5	deserializer::KeyDeserializer,
6	encoded::{EncodedKey, EncodedKeyRange},
7	serializer::KeySerializer,
8};
9
10use super::{EncodableKey, KeyKind};
11use crate::interface::catalog::id::SequenceId;
12
13#[derive(Debug, Clone, PartialEq)]
14pub struct SystemSequenceKey {
15	pub sequence: SequenceId,
16}
17
18impl EncodableKey for SystemSequenceKey {
19	const KIND: KeyKind = KeyKind::SystemSequence;
20
21	fn encode(&self) -> EncodedKey {
22		let mut serializer = KeySerializer::with_capacity(9);
23		serializer.extend_u8(Self::KIND as u8).extend_u64(self.sequence.0);
24		serializer.to_encoded_key()
25	}
26
27	fn decode(key: &EncodedKey) -> Option<Self> {
28		let mut de = KeyDeserializer::from_bytes(key.as_slice());
29
30		let kind: KeyKind = de.read_u8().ok()?.try_into().ok()?;
31		if kind != Self::KIND {
32			return None;
33		}
34
35		let sequence = de.read_u64().ok()?;
36
37		Some(Self {
38			sequence: SequenceId(sequence),
39		})
40	}
41}
42
43impl SystemSequenceKey {
44	pub fn encoded(sequence: impl Into<SequenceId>) -> EncodedKey {
45		Self {
46			sequence: sequence.into(),
47		}
48		.encode()
49	}
50
51	pub fn full_scan() -> EncodedKeyRange {
52		EncodedKeyRange::start_end(Some(Self::sequence_start()), Some(Self::sequence_end()))
53	}
54
55	fn sequence_start() -> EncodedKey {
56		let mut serializer = KeySerializer::with_capacity(1);
57		serializer.extend_u8(Self::KIND as u8);
58		serializer.to_encoded_key()
59	}
60
61	fn sequence_end() -> EncodedKey {
62		let mut serializer = KeySerializer::with_capacity(1);
63		serializer.extend_u8(Self::KIND as u8 - 1);
64		serializer.to_encoded_key()
65	}
66}
67
68#[cfg(test)]
69pub mod tests {
70	use super::{EncodableKey, SystemSequenceKey};
71	use crate::interface::catalog::id::SequenceId;
72
73	#[test]
74	fn test_encode_decode() {
75		let key = SystemSequenceKey {
76			sequence: SequenceId(0xABCD),
77		};
78		let encoded = key.encode();
79		let expected = vec![0xFA, 0x3F, 0x54, 0x32];
80		assert_eq!(encoded.as_slice(), expected);
81
82		let key = SystemSequenceKey::decode(&encoded).unwrap();
83		assert_eq!(key.sequence.0, 0xABCD);
84	}
85}