use serde::Deserialize;
use crate::config::CompatibilityProfile;
use crate::error::{NasaRedisError, Result};
const MAX_LEDGER_SHARDS: u32 = 4_096;
const MAX_BUCKET_COUNT: u64 = 512;
const DEFAULT_NONCE_TTL_MS: u64 = 7 * 24 * 60 * 60 * 1_000;
const DEFAULT_BUCKET_SPAN_MS: u64 = 24 * 60 * 60 * 1_000;
#[derive(Debug, Clone, Copy, PartialEq, Eq, Deserialize)]
#[serde(rename_all = "SCREAMING_SNAKE_CASE")]
pub enum IdempotentTtlMode {
Auto,
HashField,
HashBucket,
}
impl IdempotentTtlMode {
pub(crate) fn marker_token(self) -> &'static str {
match self {
Self::Auto => "AUTO",
Self::HashField => "HASH_FIELD",
Self::HashBucket => "HASH_BUCKET",
}
}
pub(crate) fn resolved_from_marker(token: &str) -> Option<Self> {
match token {
"HASH_FIELD" => Some(Self::HashField),
"HASH_BUCKET" => Some(Self::HashBucket),
_ => None,
}
}
}
#[derive(Debug, Clone, Deserialize)]
#[serde(default, deny_unknown_fields)]
pub struct IdempotentCounterCfg {
pub ledger_key_prefix: String,
pub layout_marker_id: String,
pub nonce_ttl_ms: u64,
pub ttl_mode: IdempotentTtlMode,
pub bucket_span_ms: u64,
pub ledger_shards: u32,
}
impl Default for IdempotentCounterCfg {
fn default() -> Self {
Self {
ledger_key_prefix: "rpidem".to_owned(),
layout_marker_id: "primary".to_owned(),
nonce_ttl_ms: DEFAULT_NONCE_TTL_MS,
ttl_mode: IdempotentTtlMode::Auto,
bucket_span_ms: DEFAULT_BUCKET_SPAN_MS,
ledger_shards: 256,
}
}
}
impl IdempotentCounterCfg {
pub(crate) fn snapshot(
&self,
profile: CompatibilityProfile,
) -> Result<IdempotentLayoutSnapshot> {
let prefix = self.ledger_key_prefix.trim();
if prefix.is_empty() || prefix.len() > 128 {
return Err(cfg(
"idempotent_counter.ledger_key_prefix 必须为 1..=128 字节的非空文本",
));
}
if !prefix
.bytes()
.all(|b| b.is_ascii_alphanumeric() || matches!(b, b'.' | b'_' | b':' | b'-'))
{
return Err(cfg(
"idempotent_counter.ledger_key_prefix 只能包含 ASCII 字母数字与 '.' '_' ':' '-'",
));
}
if profile == CompatibilityProfile::LegacyV1 && prefix != "rpidem" {
return Err(cfg(
"LegacyV1 的 idempotent_counter.ledger_key_prefix 必须为 rpidem",
));
}
let marker_id = self.layout_marker_id.trim();
if marker_id.is_empty() || marker_id.len() > 128 {
return Err(cfg(
"idempotent_counter.layout_marker_id 必须为 1..=128 字节的非空文本",
));
}
if self.nonce_ttl_ms < 1 || self.nonce_ttl_ms > i64::MAX as u64 {
return Err(cfg("idempotent_counter.nonce_ttl_ms 必须位于 1..=i64::MAX"));
}
if self.bucket_span_ms < 1 {
return Err(cfg("idempotent_counter.bucket_span_ms 必须大于 0"));
}
if self.ledger_shards < 1
|| self.ledger_shards > MAX_LEDGER_SHARDS
|| (self.ledger_shards & (self.ledger_shards - 1)) != 0
{
return Err(cfg(
"idempotent_counter.ledger_shards 必须为 1..=4096 的 2 的幂",
));
}
let complete_spans = (self.nonce_ttl_ms - 1) / self.bucket_span_ms;
if complete_spans > MAX_BUCKET_COUNT - 2 {
return Err(cfg(
"idempotent_counter.nonce_ttl_ms 与 bucket_span_ms 组合需要超过 512 个环形桶",
));
}
let bucket_count = (complete_spans + 2) as u32;
Ok(IdempotentLayoutSnapshot {
ledger_key_prefix: prefix.to_owned(),
layout_marker_id: marker_id.to_owned(),
profile,
nonce_ttl_ms: self.nonce_ttl_ms,
ttl_mode: self.ttl_mode,
bucket_span_ms: self.bucket_span_ms,
ledger_shards: self.ledger_shards,
bucket_count,
})
}
}
#[derive(Debug, Clone, PartialEq, Eq)]
pub(crate) struct IdempotentLayoutSnapshot {
pub(crate) ledger_key_prefix: String,
pub(crate) layout_marker_id: String,
pub(crate) profile: CompatibilityProfile,
pub(crate) nonce_ttl_ms: u64,
pub(crate) ttl_mode: IdempotentTtlMode,
pub(crate) bucket_span_ms: u64,
pub(crate) ledger_shards: u32,
pub(crate) bucket_count: u32,
}
impl IdempotentLayoutSnapshot {
pub(crate) fn marker_value(&self, resolved: IdempotentTtlMode) -> String {
match self.profile {
CompatibilityProfile::LegacyV1 => format!(
"1|{}|{}|{}|{}",
resolved.marker_token(),
self.nonce_ttl_ms,
self.bucket_span_ms,
self.ledger_shards
),
CompatibilityProfile::RustV2 => format!(
"2|{}|record-sha256-v1|{}|{}|{}|{}",
self.ledger_key_prefix,
resolved.marker_token(),
self.nonce_ttl_ms,
self.bucket_span_ms,
self.ledger_shards
),
}
}
pub(crate) fn marker_key(&self) -> String {
match self.profile {
CompatibilityProfile::LegacyV1 => {
format!(
"{}:layout:{}",
self.ledger_key_prefix, self.layout_marker_id
)
}
CompatibilityProfile::RustV2 => {
format!("nasa:idempotent-counter:layout:{}", self.layout_marker_id)
}
}
}
}
fn cfg(message: &str) -> NasaRedisError {
NasaRedisError::Config(message.to_owned())
}