Expand description
Transport-neutral planning: AST → PlannedOperation.
Architecture:
plan::planis the sole statement → IR entry point.plan::to_rest_routeis an optional REST projection (proxies / offline compile).- Embeddings are owned by
qql-embed, not this crate.
Re-exports§
pub use batch::BatchGrouper;pub use plan::BatchFamily;pub use plan::BatchKey;pub use plan::BatchOpts;pub use plan::PlannedOperation;pub use plan::RestProjectionError;pub use plan::batch_item_error;pub use plan::build_query_batch;pub use plan::build_update_batch;pub use plan::ensure_no_unbound_params;pub use plan::into_query_batch;pub use plan::into_update_batch;pub use plan::parse_and_plan;pub use plan::plan;pub use plan::plan_template;pub use plan::statement_batch_key;pub use plan::statement_wait;pub use plan::to_rest_route;pub use plan::try_route;pub use plan::verify_batch_cardinality;pub use routing::CompiledStatement;pub use routing::compile_statement;pub use semantic::PlanFacetValue;pub use semantic::PlanGroupId;pub use semantic::PlanPointId;pub use semantic::PlanPointVectors;pub use semantic::PlanQueryInput;pub use semantic::PlanShardKey;pub use semantic::PlanVectorStruct;pub use semantic::PlanVectorValue;pub use types::*;
Modules§
- batch
- Batch grouping, extraction, and validation for multi-statement execution. Batch grouping, extraction, and validation for multi-statement execution.
- ddl
- DDL lowering: collection, index, and shard-key statements into plan requests. DDL lowering: collection/index/shard/quota statements to plan requests.
- filter
- Filter lowering into OpenAPI-shaped
Filtercondition structures. - mutation
- Mutation lowering: upsert, delete, and payload/vector updates into wire bodies.
- plan
- Canonical fallible planner: AST →
PlannedOperation. - query
- Query lowering:
QUERYstatements into/points/queryrequest bodies. - routing
- Optional REST route projection and the offline
compile_statemententry point. - semantic
- Typed semantic primitives for the plan layer.
- types
- Wire and plan-IR request types shared by the REST projection and gRPC conversion.
Enums§
- Formula
Default - One
DEFAULTS (name = …)binding value. - Plan
Decay Kind - Decay curve family of a
PlanFormula::Decaynode. - Plan
Formula - Transport-neutral formula expression tree (
QUERY FORMULA <expr>).
Functions§
- value_
error_ text - Render a scalar AST value exactly as the old
serde_jsonpipeline did, for error messages that pin value text ("1.5","true","9223372036854775808"). Non-scalars fall back to AST debug shape; only human-facing message text ever flows through here, never the wire.