Struct MutationBuilder 

pub struct MutationBuilder { /* private fields */ }

Builder for GraphQL mutations (insert, update, delete).

Examples

// Insert
let result = client.insert_into("blogCollection")
    .objects(vec![json!({"title": "New", "body": "Content"})])
    .returning(&["id", "title"])
    .execute::<BlogRow>().await?;

// Update
let result = client.update("blogCollection")
    .set(json!({"title": "Updated"}))
    .filter(GqlFilter::eq("id", 1))
    .at_most(1)
    .returning(&["id", "title"])
    .execute::<BlogRow>().await?;

// Delete
let result = client.delete_from("blogCollection")
    .filter(GqlFilter::eq("id", 1))
    .at_most(1)
    .returning(&["id"])
    .execute::<BlogRow>().await?;

Implementations

impl MutationBuilder

pub fn returning(self, fields: &[&str]) -> Self

Set the fields to return in the mutation result.

pub fn filter(self, filter: GqlFilter) -> Self

Set a filter condition (for update/delete).

pub fn set(self, values: Value) -> Self

Set the values to update (for update mutations).

The value should be a JSON object with field names and new values.

pub fn objects(self, objects: Vec<Value>) -> Self

Set the objects to insert (for insert mutations).

The value should be a JSON array of objects.

pub fn at_most(self, n: i64) -> Self

Limit the number of affected rows (for update/delete).

pub fn build(&self) -> (String, Value)

Build the mutation string and variables without executing.

Returns (query_string, variables) for inspection or debugging.

pub async fn execute<T: DeserializeOwned>( self, ) -> Result<MutationResult<T>, GraphqlError>

Execute the mutation and return a typed MutationResult<T>.

The response is expected to have the shape: { "mutationField": { "affectedCount": N, "records": [...] } }

Trait Implementations

impl Debug for MutationBuilder

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

Formats the value using the given formatter.