Enum MutationOutcome 

#[non_exhaustive]
pub enum MutationOutcome {
    Success {
        entity: Value,
        entity_type: Option<String>,
        entity_id: Option<String>,
        cascade: Option<Value>,
        updated_fields: Vec<String>,
    },
    Error {
        error_class: MutationErrorClass,
        message: String,
        http_status: Option<i16>,
        entity_type: Option<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.

updated_fields: Vec<String>

GraphQL field names changed by this mutation (from the updated_fields column; empty on noop). Surfaced selection-gated as updatedFields on the success arm, symmetric with cascade (#433).

Error

The mutation failed; error metadata is available.

Fields

error_class: MutationErrorClass

Typed classification of the failure (mirrors app.mutation_error_class).

message: String

Human-readable error message.

http_status: Option<i16>

Suggested HTTP status code, when the composite supplied one.

entity_type: Option<String>

Concrete GraphQL type name for the failure (from the entity_type column). On the error path a function stamps the declared error type it produced (e.g. "DuplicateEmailError"), letting the executor route the result onto the right is_error union member — symmetric with the success arm’s use of entity_type (#465).

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.