supabase-client-graphql

GraphQL client for supabase-client, powered by the pg_graphql PostgreSQL extension.

Note: This crate is part of the supabase-client-sdk workspace. Most users should depend on supabase-client-sdk with the graphql feature rather than using this crate directly.

Key Features

• SupabaseClientGraphqlExt extension trait — adds .graphql() to SupabaseClient
• GraphqlClient — HTTP client for the /graphql/v1 endpoint
• Raw query execution with variables and operation names
• Fluent QueryBuilder for Relay-style collection queries with filtering, ordering, pagination, and total count
• Fluent MutationBuilder for insert, update, and delete mutations
• Rich filter support: eq, neq, gt, gte, lt, lte, in, is, like, ilike, startsWith, and composable and/or/not
• Cursor-based (first/after, last/before) and offset pagination
• set_auth() to override the default token for subsequent requests

Usage

Raw Query

use supabase_client_graphql::SupabaseClientGraphqlExt;

let graphql = client.graphql()?;

let response = graphql.execute_raw(
    "query { blogCollection { edges { node { id title } } } }",
    None,
    None,
).await?;

Collection Query (Builder)

use supabase_client_graphql::{SupabaseClientGraphqlExt, GqlFilter, OrderByDirection};
use serde_json::json;

let graphql = client.graphql()?;

let connection = graphql.collection("blogCollection")
    .select(&["id", "title", "createdAt"])
    .filter(GqlFilter::eq("status", json!("published")))
    .order_by("createdAt", OrderByDirection::DescNullsLast)
    .first(10)
    .total_count()
    .execute::<BlogRow>().await?;

for edge in &connection.edges {
    println!("{}: {}", edge.node.id, edge.node.title);
}

Insert Mutation

use supabase_client_graphql::SupabaseClientGraphqlExt;
use serde_json::json;

let graphql = client.graphql()?;

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

Update Mutation

use supabase_client_graphql::{SupabaseClientGraphqlExt, GqlFilter};

let graphql = client.graphql()?;

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

Delete Mutation

use supabase_client_graphql::{SupabaseClientGraphqlExt, GqlFilter};

let graphql = client.graphql()?;

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

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.