Struct IntermediateMutation 

pub struct IntermediateMutation {

    pub name: String,
    pub return_type: String,
    pub returns_list: bool,
    pub nullable: bool,
    pub arguments: Vec<IntermediateArgument>,
    pub description: Option<String>,
    pub sql_source: Option<String>,
    pub operation: Option<String>,
    pub deprecated: Option<IntermediateDeprecation>,
    pub inject: IndexMap<String, String>,
    pub exclude_inject_defaults: Vec<String>,
    pub requires_role: Option<String>,
    pub requires_actor: Vec<String>,
    pub invalidates_fact_tables: Vec<String>,
    pub invalidates_views: Vec<String>,
    pub changelog: bool,
    pub input_style: InputStyle,
    pub changelog_pre_image: bool,
    pub cascade: bool,
    pub success_fields: Vec<IntermediateField>,
    pub cascade_source: CascadeSource,
    pub rest: Option<IntermediateRest>,
}

Mutation definition in intermediate format

Fields

name: String

Mutation name (e.g., “createUser”)

return_type: String

Return type name (e.g., “User”)

returns_list: bool

Returns a list?

nullable: bool

Result is nullable?

arguments: Vec<IntermediateArgument>

Mutation arguments

description: Option<String>

Mutation description (from docstring)

sql_source: Option<String>

SQL source (function name)

operation: Option<String>

Operation type (CREATE, UPDATE, DELETE, CUSTOM)

deprecated: Option<IntermediateDeprecation>

Deprecation info (from @deprecated directive)

inject: IndexMap<String, String>

Server-injected parameters: SQL parameter name → source expression (e.g. "jwt:org_id"). Not exposed as GraphQL arguments.

Wire key is inject_params, matching the compiled schema. The two names were unified because the split is what let three SDKs emit a key that bound to nothing (#806); see the inject_params_serde module for the full reasoning.

exclude_inject_defaults: Vec<String>

Project [inject_defaults] keys this operation opts out of (#1383).

Reviewable next to the operation it applies to: a catalogue query declares here that the tenant default does not apply to it. Each key must name a default that would otherwise apply, and must not also be declared in inject_params.

requires_role: Option<String>

Role required to execute this mutation and see it in introspection.

Mirrors IntermediateQuery::requires_role. Enforced at runtime with the same enumeration-hiding “not found” response as the query gate — a principal lacking the role cannot distinguish a forbidden mutation from a nonexistent one.

requires_actor: Vec<String>

Actor classes permitted to execute this mutation — an allow-list (#966).

Mirrors IntermediateQuery::requires_actor.

invalidates_fact_tables: Vec<String>

Fact tables whose version counter should be bumped after this mutation succeeds.

Used for correct invalidation of analytic/aggregate cache entries.

invalidates_views: Vec<String>

View names whose cached query results should be invalidated after this mutation succeeds.

changelog: bool

Whether this mutation writes a Change-Spine change-log row (default true).

Set false (via the authoring SDK’s @fraiseql.mutation(changelog=False)) to opt a single mutation out of the in-transaction change-log outbox while the rest of the schema keeps logging. Defaults to true so a schema authored before this field existed keeps logging.

input_style: InputStyle

How the GraphQL input argument is passed to the SQL function: "flatten" (positional columns, the default) or "jsonb" (the whole input as one jsonb arg). See InputStyle.

Orthogonal to operation: set "jsonb" (via the authoring SDK’s @fraiseql.mutation(input_style="jsonb")) so a backend using the single-jsonb-wrapper convention can register the real DML verb and still receive the whole input as one argument. Defaults to "flatten", byte-identical to a schema authored before this field existed.

changelog_pre_image: bool

Whether a successful, state-changing run of this mutation also records the changed entity’s pre-image (before-state) into the Change-Spine object_data_before column, sourced from an optional entity_before on the mutation’s app.mutation_response.

Set true (via the authoring SDK’s @fraiseql.mutation(changelog_pre_image=True) or TOML changelog_pre_image = true) to opt an audit-sensitive mutation into an inline Debezium-style {before, after}. Defaults to false, byte-identical to a schema authored before this field existed.

cascade: bool

Whether this mutation exposes the typed graphql-cascade cascade field on its success payload.

Set true via the authoring SDK’s @fraiseql.type(crud=True, cascade=True) / @fraiseql.mutation(cascade=True), or TOML cascade = true. Defaults to false, byte-identical to a schema authored before this field existed. Before this field, the compiler silently dropped the SDK flag.

success_fields: Vec<IntermediateField>

Typed facts about the operation, served on the cascade payload (#1397): the function returns them in its response row’s result jsonb column. Only on a cascade mutation, only leaf types (a scalar or an enum).

cascade_source: CascadeSource

Where the cascade comes from (#1391): "function" (the default) or "pg_tviews", which also merges the TVIEW rows pg_tviews reports the transaction changed. Only on a cascade mutation.

rest: Option<IntermediateRest>

REST route override for this mutation. See IntermediateRest.

Trait Implementations

impl Clone for IntermediateMutation

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IntermediateMutation

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

Formats the value using the given formatter.

impl Default for IntermediateMutation

fn default() -> Self

Hand-written so changelog defaults to true (matching the serde default), not bool’s false. A #[derive(Default)] would silently opt ..Default::default()-built mutations out of the change log.

impl<'de> Deserialize<'de> for IntermediateMutation

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for IntermediateMutation

impl PartialEq for IntermediateMutation

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for IntermediateMutation

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for IntermediateMutation