Skip to main content

EventContentState

Enum EventContentState 

Source
pub enum EventContentState {
    Missing {
        last_fetch_attempt: Option<Timestamp>,
        fetch_attempt_count: u16,
        next_fetch_attempt: Timestamp,
    },
    Deleted {
        deleted_by: ShortEventId,
    },
    Pruned,
    Invalid,
}
Expand description

Per-event content processing state stored in events_content_state table.

This enum tracks the content processing lifecycle for each event:

§State Transitions

Event inserted ──► Missing ──► (no entry) ──► Deleted/Pruned
                      │             │
                      │             └─ Content processed successfully
                      │                (side effects applied)
                      │
                      ├─ Can also go directly to Deleted/Pruned
                      │
                      └─► Invalid ──► Deleted

Note: Events with content_len == 0 skip the Missing state entirely. They go straight to “no entry” (processed) unless they start in Deleted.

§Interpretation

  • No entry in table: Content has been processed for this event. This is the normal state after successful content processing. Side effects (reply counts, follow updates, etc.) have been applied. Also the state for events with no content (content_len == 0) unless they start in Deleted.

  • Missing: Event was inserted but content hasn’t been received or processed yet. The event’s content side effects have NOT been applied.

  • Invalid: Content was received but failed validation (e.g. CBOR deserialization). RC has been decremented. Content bytes are discarded.

  • Deleted / Pruned: Content is unwanted. RC has been decremented. An eligible Deleted social-post edit may still contribute immutable replacement metadata without ordinary content processing.

§Idempotency Guarantee

The Missing state ensures content processing is idempotent:

  • process_event_content_tx checks for Missing before processing
  • If Missing → process content, then remove the marker
  • If no entry → skip (already processed)
  • If Deleted/Pruned/Invalid → skip ordinary processing; the narrow Deleted social-post lineage exception remains idempotent table insertion

This prevents duplicate side effects (e.g., incrementing reply_count twice) when the same content is received multiple times for the same event.

Variants§

§

Missing

Content has not been received/processed yet for this event.

This state is set when an event with content_len > 0 is inserted (in insert_event_tx). Events with content_len == 0 skip this state, going directly to processed or Deleted.

When process_event_content_tx runs and sees this state:

  1. It processes the content (applies side effects)
  2. Stores content in content_store if not already there
  3. Removes this Missing marker (deletes entry from table)

After processing, the event will have NO entry in events_content_state, indicating content was successfully processed.

When the event has a current events_content_missing row, the next_fetch_attempt field mirrors the Timestamp component of that canonical at-most-one (Timestamp, ShortEventId) key, enabling removal from the table (which requires the full composite key).

Fields

§last_fetch_attempt: Option<Timestamp>

When we last attempted to fetch this content from peers.

§fetch_attempt_count: u16

Number of times we’ve attempted to fetch this content.

§next_fetch_attempt: Timestamp

Scheduled time for next fetch attempt.

§

Deleted

Content was deleted by the author via a deletion event.

When a deletion event targets this event’s content:

  • This state is set with a reference to the deleting event
  • RC is decremented in content_rc
  • Content may be garbage collected if RC reaches 0

Fields

§deleted_by: ShortEventId

Canonical direct deleter: maximum (event.timestamp, ShortEventId).

§

Pruned

Content was pruned locally (e.g., too large to store).

Unlike Deleted, this is a local decision, not an author request. Used when content exceeds size limits or for storage management.

§

Invalid

Content was received but failed validation.

The content bytes could not be deserialized for the event’s kind. RC has been decremented and content bytes are not stored. A later author deletion can supersede this with Deleted without another RC decrement.

Trait Implementations§

Source§

impl<'__de, __Context> BorrowDecode<'__de, __Context> for EventContentState

Source§

fn borrow_decode<__D: BorrowDecoder<'__de, Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given BorrowDecode.
Source§

impl Clone for EventContentState

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Copy for EventContentState

Source§

impl Debug for EventContentState

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<__Context> Decode<__Context> for EventContentState

Source§

fn decode<__D: Decoder<Context = __Context>>( decoder: &mut __D, ) -> Result<Self, DecodeError>

Attempt to decode this type with the given Decode.
Source§

impl Encode for EventContentState

Source§

fn encode<__E: Encoder>(&self, encoder: &mut __E) -> Result<(), EncodeError>

Encode a given type.
Source§

impl Eq for EventContentState

Source§

impl PartialEq for EventContentState

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl Serialize for EventContentState

Source§

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

Serialize this value into the given Serde serializer. Read more
Source§

impl StructuralPartialEq for EventContentState

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<F, I> CastInto<I> for F
where I: CastFrom<F>,

Source§

fn cast_into(self) -> I

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> CompatExt for T

Source§

fn compat(self) -> Compat<T> ⓘ
where T: Sized,

Applies the Compat adapter by value. Read more
Source§

fn compat_ref(&self) -> Compat<&T> ⓘ

Applies the Compat adapter by shared reference. Read more
Source§

fn compat_mut(&mut self) -> Compat<&mut T> ⓘ

Applies the Compat adapter by mutable reference. Read more
Source§

impl<T> DynClone for T
where T: Clone,

Source§

fn __clone_box(&self, _: Private) -> *mut ()

Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<F, T> ExpectFrom<F> for T
where T: TryFrom<F>, <T as TryFrom<F>>::Error: Debug,

Source§

fn expect_from(other: F) -> T

Source§

impl<F, I> ExpectInto<I> for F
where I: ExpectFrom<F>,

Source§

fn expect_into(self) -> I

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more