Enum MutationOutcome 

#[non_exhaustive]
pub enum MutationOutcome {
    Success {
        entity: Value,
        entity_type: Option<String>,
        entity_id: Option<String>,
        cascade: Option<Value>,
    },
    Error {
        status: String,
        message: String,
        metadata: Value,
    },
}

Outcome of parsing a single mutation_response row.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Success

The mutation succeeded; the result entity is available.

Fields

entity: Value

The entity JSONB returned by the function.

entity_type: Option<String>

GraphQL type name for the entity (from the entity_type column).

entity_id: Option<String>

UUID string of the mutated entity (from the entity_id column).

Present for UPDATE and DELETE mutations. Used for entity-aware cache invalidation: only cache entries containing this UUID are evicted, leaving unrelated entries warm.

cascade: Option<Value>

Cascade operations associated with this mutation.

Error

The mutation failed; error metadata is available.

Fields

status: String

Status code (e.g. "failed:validation", "conflict:duplicate").

message: String

Human-readable error message.

metadata: Value

Structured metadata JSONB containing error-type field values.

Trait Implementations

impl Clone for MutationOutcome

fn clone(&self) -> MutationOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MutationOutcome

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

Formats the value using the given formatter.