1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
//! QQL executor and Qdrant transport adapters (published as the `qql` crate).
//!
//! One executor API over three transports:
//!
//! ```text
//! source text
//! → qql-core: parse + semantic validation
//! → prepare: schema USING resolution + embedding inference (qql-embed)
//! → qql-plan: plan() → PlannedOperation (transport-neutral IR)
//! → batch classification / dispatch
//! → REST (rest) | gRPC (grpc) | in-process edge (qql-edge)
//! ```
//!
//! Backends implement the [`client::QdrantOps`] contract (11 methods); the
//! [`executor::Executor`] drives it. DDL flows through the same planner as
//! DML. The gRPC path converts typed plan structs directly to protobuf —
//! query vectors, point IDs, DDL request configs, and formula expressions
//! never take a JSON detour.
//!
//! # Features
//!
//! - `rest` (default) — HTTP transport adapter ([`rest::RestQdrant`])
//! - `grpc` (default) — tonic-based gRPC transport ([`grpc::GrpcQdrant`])
//! - With both disabled, custom [`client::QdrantOps`] implementations still
//! compile against the executor with no transport dependency.
//!
//! # Public API re-exports
//!
//! Types named in this crate's signatures — [`QqlError`], [`Stmt`],
//! [`PlannedOperation`], the batch and DDL request types — plus the policy
//! flow ([`Parser`], [`inject_filter`], [`ComparisonOp`], [`Value`]) are
//! re-exported here, so `QdrantOps` implementors and policy authors depend on
//! `qql` alone. Deeper IR introspection is advanced territory; add
//! `qql-plan` / `qql-core` directly when you need it.
//!
//! # Errors
//!
//! Execution failures are structured `QqlError` values from `qql-core` with
//! stable codes (`QQL-EXECUTION-*`, `QQL-TRANSPORT-*`, `QQL-BACKEND`, …).
/// The `QdrantOps` backend contract plus REST/gRPC client plumbing shared by
/// the transport adapters.
/// Endpoint, API key, and timeout configuration ([`QqlConfig`](config::QqlConfig)).
/// Remote embedding-server adapter ([`HttpEmbedder`](embedder::HttpEmbedder))
/// implementing the `qql-embed` [`Embedder`](embedder::Embedder) trait.
/// Reqwest `HttpEmbedder` client, split from [`embedder`].
/// The executor: parse → prepare → plan → batch → dispatch.
/// Tonic channel client and typed protobuf conversions for the gRPC transport.
/// gRPC route execution: typed plan structs converted directly to protobuf.
/// Typify-generated REST wire types from `openapi.json` (build-time output;
/// do not edit).
/// Tonic-generated protobuf types from `proto/` (build-time output; do not
/// edit).
/// REST transport adapter ([`RestQdrant`](rest::RestQdrant)) implementing
/// `QdrantOps` over JSON HTTP.
/// REST client construction (`RestQdrant` constructors), split from [`rest`].
/// Strict per-operation REST response parsing (OpenAPI shapes only, no
/// fallbacks). Used exclusively by the REST transport.
/// Remote shard-snapshot client for edge bootstrap (REST only, not part of
/// the `QdrantOps` contract).
/// Sparse vector helpers re-exported from `qql-embed` (wire-compatible BM25).
// Public-API re-exports (Rust API guidelines C-REEXPORT): every type named in
// this crate's public signatures, plus the parse → inject policy flow, is
// reachable through `qql` alone — backend and policy authors need no direct
// `qql-core` / `qql-plan` dependency.
pub use PreparedStatement;
pub use ;
pub use ;
pub use Parser;
pub use ;
// Sparse unit tests live in `qql-embed` (shared implementation).
// Contract tests exercise the typed gRPC route converters alongside the
// OpenAPI REST schemas; gRPC is required for the parity half.