Struct GraphqlSelect 

pub struct GraphqlSelect {
    pub root_field: Option<String>,
    pub operation_name: Option<String>,
    pub fields: Vec<String>,
    pub sub_selections: Vec<(String, GraphqlSelect)>,
    pub conditions: Vec<GraphqlCondition>,
    pub sort: Vec<(String, Order)>,
    pub group_by: Vec<String>,
    pub limit: Option<i64>,
    pub skip: Option<i64>,
    pub distinct: bool,
    pub dialect: FilterDialect,
    pub filter_arg_name: Option<String>,
}

GraphQL query builder — produces a query document + variables map.

Construct via GraphqlSelect::new() and the chainable builders, or via Selectable::with_* methods. Designed to be generic in shape: most servers wrap their list-field with a filter arg (where:, find:, …) plus pagination args, and the renderer handles both dialects we ship with.

Fields

root_field: Option<String>

Root field on the Query type — launches, usersList, etc.

operation_name: Option<String>

Optional operation name (e.g. query GetLaunches { … }).

fields: Vec<String>

Selected scalar fields. Empty = use the schema’s id field as a fallback so we at least get something back.

sub_selections: Vec<(String, GraphqlSelect)>

Nested selection sets for relationship traversal. Built up by the Phase 6 with_many/with_one paths.

conditions: Vec<GraphqlCondition>

Conditions combined into the filter argument.

sort: Vec<(String, Order)>

Ordering specification. Hasura renders these as order_by:; other dialects ignore them (or error) until the schema map provides a per-table override.

group_by: Vec<String>

GROUP BY fields. Most GraphQL servers don’t expose grouping at the query level — we record these for round-trip and let the renderer decide whether to surface them.

limit: Option<i64>

LIMIT. Emitted as a $limit: Int variable.

skip: Option<i64>

Offset. Emitted as a $offset: Int variable.

distinct: bool

Distinct flag — meaningful only when the schema supports it (Hasura’s distinct_on:). Plumbed through but ignored by the default renderer until a per-dialect path is added.

dialect: FilterDialect

Filter dialect — drives how conditions get rendered into a GraphQL argument. Defaults to Generic so the cheapest schemas work without configuration.

filter_arg_name: Option<String>

Override for the filter argument name. Defaults to where (Hasura) or find (Generic).

Implementations

impl GraphqlSelect

pub fn with_root_field(self, name: impl Into<String>) -> Self

pub fn with_operation_name(self, name: impl Into<String>) -> Self

pub fn with_dialect(self, dialect: FilterDialect) -> Self

pub fn with_filter_arg_name(self, name: impl Into<String>) -> Self

pub fn with_field(self, name: impl Into<String>) -> Self

Add a terminal (scalar) field to the selection set.

pub fn with_sub_selection( self, name: impl Into<String>, child: GraphqlSelect, ) -> Self

Add a sub-selection — used for nested relationships in Phase 6.

pub fn with_condition(self, condition: GraphqlCondition) -> Self

pub fn with_order(self, field: impl Into<String>, order: Order) -> Self

pub fn with_limit(self, limit: Option<i64>, skip: Option<i64>) -> Self

impl GraphqlSelect

pub async fn render(&self) -> Result<RenderedQuery>

Produce a (query, variables) pair. Async because conditions may carry Deferred branches that resolve at fetch time.

pub fn preview(&self) -> String

Human-readable preview — same shape as render() but synchronous and lossy (skips Deferred resolution). Useful for logs and tests.

impl GraphqlSelect

pub fn new() -> Self

Trait Implementations

impl Clone for GraphqlSelect

fn clone(&self) -> GraphqlSelect

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GraphqlSelect

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

Formats the value using the given formatter.

impl Default for GraphqlSelect

fn default() -> Self

Returns the “default value” for a type.

impl Expressive<AnyGraphqlType> for GraphqlSelect

fn expr(&self) -> Expression<AnyGraphqlType>

Convert this construct into an Expression<T>.

fn preview(&self) -> String

where T: Debug + Display,

Preview the expression as a formatted string.

impl Selectable<AnyGraphqlType, GraphqlCondition> for GraphqlSelect

fn add_source( &mut self, source: impl Into<SourceRef<AnyGraphqlType>>, _alias: Option<String>, )

Adds a data source to the FROM clause (table name, subquery, etc.). This is additive — calling it multiple times adds comma-separated sources.

fn add_field(&mut self, field: impl Into<String>)

Adds a column name to the SELECT clause.

fn add_expression(&mut self, _expression: impl Expressive<AnyGraphqlType>)

Adds a complex expression to the SELECT clause.

fn add_where_condition(&mut self, condition: impl Into<GraphqlCondition>)

Adds a condition to the WHERE clause.

fn set_distinct(&mut self, distinct: bool)

Sets whether the query should return distinct results.

fn add_order_by(&mut self, order: impl Into<GraphqlCondition>, direction: Order)

Adds an ORDER BY clause with direction and optional null handling.

fn add_group_by(&mut self, expression: impl Expressive<AnyGraphqlType>)

Adds a GROUP BY clause.

fn set_limit(&mut self, limit: Option<i64>, skip: Option<i64>)

Sets LIMIT and OFFSET for result pagination.

fn clear_fields(&mut self)

Removes all fields from the SELECT clause.

fn clear_where_conditions(&mut self)

Removes all WHERE conditions.

fn clear_order_by(&mut self)

Removes all ORDER BY clauses.

fn clear_group_by(&mut self)

Removes all GROUP BY clauses.

fn has_fields(&self) -> bool

Returns true if any fields have been added to SELECT clause.

fn has_where_conditions(&self) -> bool

Returns true if any WHERE conditions have been added.

fn has_order_by(&self) -> bool

Returns true if any ORDER BY clauses have been added.

fn has_group_by(&self) -> bool

Returns true if any GROUP BY clauses have been added.

fn is_distinct(&self) -> bool

Returns true if DISTINCT mode is enabled.

fn get_limit(&self) -> Option<i64>

Returns the current LIMIT value, if set.

fn get_skip(&self) -> Option<i64>

Returns the current OFFSET/SKIP value, if set.

fn as_field(&self, _field: impl Into<String>) -> Expression<AnyGraphqlType>

Creates a single-field subquery expression from this query configuration.

fn as_count(&self) -> Expression<AnyGraphqlType>

Creates a COUNT(*) expression from this query configuration.

fn as_sum( &self, column: impl Expressive<AnyGraphqlType>, ) -> Expression<AnyGraphqlType>

Creates a SUM(column) expression from this query configuration.

fn as_max( &self, column: impl Expressive<AnyGraphqlType>, ) -> Expression<AnyGraphqlType>

Creates a MAX(column) expression from this query configuration.

fn as_min( &self, column: impl Expressive<AnyGraphqlType>, ) -> Expression<AnyGraphqlType>

Creates a MIN(column) expression from this query configuration.

fn with_source(self, source: impl Into<SourceRef<T>>) -> Self

where Self: Sized,

Builder pattern method identical to Self::add_source without alias.

fn with_source_as( self, source: impl Into<SourceRef<T>>, alias: impl Into<String>, ) -> Self

where Self: Sized,

Builder pattern method identical to Self::add_source with alias.

fn with_condition(self, condition: impl Into<C>) -> Self

where Self: Sized,

Builder pattern method identical to Self::add_where_condition.

fn with_order(self, order: impl Into<C>, direction: Order) -> Self

where Self: Sized,

Builder pattern method identical to Self::add_order_by.

fn with_field(self, field: impl Into<String>) -> Self

where Self: Sized,

Builder pattern method identical to Self::add_field.

fn with_expression(self, expression: impl Expressive<T>) -> Self

where Self: Sized,

Builder pattern method identical to Self::add_expression.

fn with_group_by(self, expression: impl Expressive<T>) -> Self

where Self: Sized,

Builder pattern method identical to Self::add_group_by.

fn with_distinct(self, distinct: bool) -> Self

where Self: Sized,

Builder pattern method identical to Self::set_distinct.

fn with_limit(self, limit: Option<i64>, skip: Option<i64>) -> Self

where Self: Sized,

Builder pattern method identical to Self::set_limit.