Enum IngestOutcome 

pub enum IngestOutcome {
    UnknownSource {
        source: String,
    },
    SecretMissing,
    InvalidSignature,
    SpoolFailed {
        reason: String,
    },
    Accepted {
        delivery_id: String,
        relay: RelayOutcome,
        bookkeeping_error: Option<String>,
    },
}

Result of one ingress attempt, before it becomes an HTTP response.

Why: keeping the decision separate from axum lets every arm — including the two that must never produce a 202 — be asserted directly, without a router. What: one variant per outcome the ADR distinguishes. Test: the ingest_* cases in tests.rs.

Variants

UnknownSource

{source} names no configured target.

Fields

source: String

The path segment that did not resolve.

SecretMissing

No secret is configured. Fail closed.

InvalidSignature

A secret is configured and the signature did not verify.

SpoolFailed

The durable write failed. The caller MUST return 5xx and MUST NOT ack.

Fields

reason: String

Why the write failed.

Accepted

The delivery is durably recorded. Safe to acknowledge GitHub.

Fields

delivery_id: String

The delivery id the entry is filed under.

relay: RelayOutcome

What the relay attempt established. Not a precondition of the ack.

bookkeeping_error: Option<String>

Set when the post-relay bookkeeping write failed. The delivery is still durable — this only means the attempt count or the deletion did not land, both of which are recoverable by the retry sweep.

Trait Implementations

impl Clone for IngestOutcome

fn clone(&self) -> IngestOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IngestOutcome

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

Formats the value using the given formatter.

impl Eq for IngestOutcome

impl PartialEq for IngestOutcome

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for IngestOutcome