Struct QueryBuilder 

pub struct QueryBuilder { /* private fields */ }

Fluent builder for constructing a QueryAst.

Start with QueryBuilder::nodes and chain filtering, traversal, and expansion steps before calling compile or compile_grouped.

Implementations

impl QueryBuilder

pub fn nodes(kind: impl Into<String>) -> Self

Create a builder that queries nodes of the given kind.

pub fn vector_search(self, query: impl Into<String>, limit: usize) -> Self

Add a vector similarity search step.

pub fn text_search(self, query: impl Into<String>, limit: usize) -> Self

Add a full-text search step.

pub fn traverse( self, direction: TraverseDirection, label: impl Into<String>, max_depth: usize, ) -> Self

Add a graph traversal step following edges of the given label.

pub fn filter_logical_id_eq(self, logical_id: impl Into<String>) -> Self

Filter results to a single logical ID.

pub fn filter_kind_eq(self, kind: impl Into<String>) -> Self

Filter results to nodes matching the given kind.

pub fn filter_source_ref_eq(self, source_ref: impl Into<String>) -> Self

Filter results to nodes matching the given source_ref.

pub fn filter_json_text_eq( self, path: impl Into<String>, value: impl Into<String>, ) -> Self

Filter results where a JSON property at path equals the given text value.

pub fn filter_json_bool_eq(self, path: impl Into<String>, value: bool) -> Self

Filter results where a JSON property at path equals the given boolean value.

pub fn filter_json_integer_gt(self, path: impl Into<String>, value: i64) -> Self

Filter results where a JSON integer at path is greater than value.

pub fn filter_json_integer_gte( self, path: impl Into<String>, value: i64, ) -> Self

Filter results where a JSON integer at path is greater than or equal to value.

pub fn filter_json_integer_lt(self, path: impl Into<String>, value: i64) -> Self

Filter results where a JSON integer at path is less than value.

pub fn filter_json_integer_lte( self, path: impl Into<String>, value: i64, ) -> Self

Filter results where a JSON integer at path is less than or equal to value.

pub fn filter_json_timestamp_gt( self, path: impl Into<String>, value: i64, ) -> Self

Filter results where a JSON timestamp at path is after value (epoch seconds).

pub fn filter_json_timestamp_gte( self, path: impl Into<String>, value: i64, ) -> Self

Filter results where a JSON timestamp at path is at or after value.

pub fn filter_json_timestamp_lt( self, path: impl Into<String>, value: i64, ) -> Self

Filter results where a JSON timestamp at path is before value.

pub fn filter_json_timestamp_lte( self, path: impl Into<String>, value: i64, ) -> Self

Filter results where a JSON timestamp at path is at or before value.

pub fn expand( self, slot: impl Into<String>, direction: TraverseDirection, label: impl Into<String>, max_depth: usize, ) -> Self

Add an expansion slot that traverses edges of the given label for each root result.

pub fn limit(self, limit: usize) -> Self

Set the maximum number of result rows.

pub fn ast(&self) -> &QueryAst

Borrow the underlying QueryAst.

pub fn into_ast(self) -> QueryAst

Consume the builder and return the underlying QueryAst.

pub fn compile(&self) -> Result<CompiledQuery, CompileError>

Compile this builder’s AST into an executable CompiledQuery.

Errors

Returns CompileError if the query violates structural constraints (e.g. too many traversal steps or too many bind parameters).

pub fn compile_grouped(&self) -> Result<CompiledGroupedQuery, CompileError>

Compile this builder’s AST into an executable grouped query.

Errors

Returns CompileError if the query violates grouped-query structural constraints such as duplicate slot names or excessive depth.

Trait Implementations

impl Clone for QueryBuilder

fn clone(&self) -> QueryBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QueryBuilder

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

Formats the value using the given formatter.

impl PartialEq for QueryBuilder

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for QueryBuilder

impl StructuralPartialEq for QueryBuilder