Struct Query 

pub struct Query<E: EntityKind> { /* private fields */ }

Query

Typed, declarative query intent for a specific entity type.

This intent is:

• schema-agnostic at construction
• normalized and validated only during planning
• free of access-path decisions

Implementations

impl<E: EntityKind> Query<E>

pub const fn new(consistency: ReadConsistency) -> Self

Create a new intent with an explicit missing-row policy. MissingOk favors idempotency and may mask index/data divergence on deletes. Use Strict to surface missing rows during scan/delete execution.

pub const fn mode(&self) -> QueryMode

Return the intent mode (load vs delete).

pub fn filter(self, predicate: Predicate) -> Self

Add a predicate, implicitly AND-ing with any existing predicate.

pub fn filter_expr(self, expr: FilterExpr) -> Result<Self, QueryError>

Apply a dynamic filter expression.

pub fn sort_expr(self, expr: SortExpr) -> Result<Self, QueryError>

Apply a dynamic sort expression.

pub fn order_by(self, field: impl AsRef<str>) -> Self

Append an ascending sort key.

pub fn order_by_desc(self, field: impl AsRef<str>) -> Self

Append a descending sort key.

pub const fn delete(self) -> Self

Mark this intent as a delete query.

pub const fn limit(self, limit: u32) -> Self

Apply a limit to the current mode.

Load limits bound result size; delete limits bound mutation size.

pub const fn offset(self, offset: u32) -> Self

Apply an offset to a load intent.

pub fn explain(&self) -> Result<ExplainPlan, QueryError>

Explain this intent without executing it.

pub fn plan(&self) -> Result<ExecutablePlan<E>, QueryError>

Plan this intent into an executor-ready plan.

Trait Implementations

impl<E: Debug + EntityKind> Debug for Query<E>

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

Formats the value using the given formatter.