Struct SlashReconcileState 

pub struct SlashReconcileState {
    pub app_id: Option<String>,
    pub fingerprint: Option<u64>,
    pub last_success_at: Option<i64>,
    pub retry_after_until: Option<i64>,
}

Persisted reconcile state for one Discord application.

Fields

app_id: Option<String>

Application id this state belongs to. State recorded for a different application (e.g. a swapped bot token) is ignored on load, degrading to a full reconcile rather than trusting a stale fingerprint.

fingerprint: Option<u64>

Fingerprint of the last successfully reconciled command set.

last_success_at: Option<i64>

Unix seconds of the last successful reconcile (diagnostic).

retry_after_until: Option<i64>

Unix-seconds deadline before which no reconcile should be attempted, recorded from a 429 Retry-After. None once a reconcile succeeds.

Implementations

impl SlashReconcileState

pub fn load(workspace_dir: Option<&Path>, app_id: &str) -> Self

Load persisted state for app_id. Returns the default (empty) state — which forces a full reconcile — when no workspace dir is configured, the file is absent or unreadable, or the recorded application id does not match. Never fails; a corrupt or foreign file simply yields “no state”.

pub fn record_success( workspace_dir: Option<&Path>, app_id: &str, fingerprint: u64, now: i64, )

Record a successful reconcile: store the fingerprint, clear any Retry-After cooldown. Best-effort — a write failure is logged at debug and otherwise ignored (the in-process flow already succeeded).

pub fn record_retry_after( workspace_dir: Option<&Path>, app_id: &str, prev: &Self, until: i64, )

Record a rate-limit cooldown observed during reconcile. The prior fingerprint is preserved (the desired set did not change, only the server asked us to wait), so the cooldown — not a forced re-diff — gates the next attempt.

pub fn rate_limited(&self, now: i64) -> bool

True when a recorded Retry-After cooldown is still in the future.

Trait Implementations

impl Clone for SlashReconcileState

fn clone(&self) -> SlashReconcileState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SlashReconcileState

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SlashReconcileState

fn default() -> SlashReconcileState

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SlashReconcileState

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for SlashReconcileState

fn eq(&self, other: &SlashReconcileState) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for SlashReconcileState

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SlashReconcileState