Struct QueryBuilder 

pub struct QueryBuilder { /* private fields */ }

Builder for GraphQL collection queries.

Produces Relay-style connection queries against pg_graphql.

Example

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

Implementations

impl QueryBuilder

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

Set the fields to select in each node.

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

Set a filter condition.

pub fn order_by(self, column: &str, direction: OrderByDirection) -> Self

Add an order-by clause.

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

Limit results to the first N items (forward pagination).

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

Limit results to the last N items (backward pagination).

pub fn after(self, cursor: &str) -> Self

Set the cursor for forward pagination.

pub fn before(self, cursor: &str) -> Self

Set the cursor for backward pagination.

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

Set the offset for pagination.

pub fn total_count(self) -> Self

Include the totalCount field in the response.

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

Build the query string and variables without executing.

Returns (query_string, variables) for inspection or debugging.

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

Execute the query and return a typed Connection<T>.

The response data field is expected to have the shape: { "collectionName": { "edges": [...], "pageInfo": {...}, "totalCount": ... } }

Trait Implementations

impl Debug for QueryBuilder

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

Formats the value using the given formatter.