Skip to main content

AppendOutcome

Enum AppendOutcome 

Source
pub enum AppendOutcome {
    Appended {
        seq: u64,
    },
    IdempotentReplay {
        prior: PriorEvent,
    },
    Conflict {
        prior: PriorEvent,
    },
}
Expand description

The three observable outcomes of an append_and_apply_idempotent call — the shared --idempotency-key contract that event create, discussion resolve, and future keyed verbs (spinoff approve|reject, run create, node report) all answer to, lifted out of each CLI’s private log scan.

The discriminator is whether a prior event with the same kind + key already exists, and — if so — whether the call’s (node_id, data) identity matches that prior event:

  • AppendOutcome::Appended — no prior event carried this key: a fresh event was appended and folded into the projections. seq is its sequence.
  • AppendOutcome::IdempotentReplay — a prior event carried this key and the same node_id + data: a true retry. Nothing was appended; the prior event (its seq / node_id / data) is returned so the caller can surface the original sequence.
  • AppendOutcome::Conflict — a prior event carried this key but with a different node_id or data: the key was reused for a different request (a client bug, Stripe-style). Nothing was appended; prior is returned so the caller can build a precise conflict error (e.g. diff the payload vs. the node id).

Variants§

§

Appended

A fresh event was appended and applied; seq is its sequence number.

Fields

§seq: u64

The appended event’s seq.

§

IdempotentReplay

The key matched a prior event with identical node_id + data. No new event was written; prior.seq is the original sequence to surface.

Fields

§prior: PriorEvent

The pre-existing matching event (its seq, node_id, and data).

§

Conflict

The key matched a prior event whose node_id or data differs from this request. No new event was written; the caller should reject the reuse.

Fields

§prior: PriorEvent

The pre-existing event recorded under the same key, for the caller’s conflict diagnostics (prior.seq is the original sequence).

Trait Implementations§

Source§

impl Debug for AppendOutcome

Source§

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

Formats the value using the given formatter. Read more

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<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

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> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

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

Source§

type Error = Infallible

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

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

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