Expand description
PostgreSQL renderer and sqlx executor for SiftQuery.
Re-exports§
pub use web::PublicError;pub use web::QueryParams;pub use web::SearchParamConfig;pub use web::SearchParams;pub use web::WebError;pub use web::public_error;pub use sift_query_core as core;
Modules§
- postgres
- PostgreSQL bindings, result decoding and opt-in query capabilities.
- web
- PostgreSQL web adapter primitives shared by axum, actix-web, and poem.
Structs§
- CsvColumn
- A server-owned export column and optional trusted formatter.
- CsvExport
Policy - CsvExporter
- Cursor
Page - A cursor page fetched without a count or cluster query.
- Decode
Error - Diagnostic
Stage - Dictionary
Label Loader - Enum/local dictionaries share the same one-batch loader contract as remote services.
- Enrich
Context - Context passed to post-query, whole-page enrichers.
- Facet
Bucket - Facet
Page - A page plus server-declared facet buckets.
- Facet
Request - A server-declared facet over one entity field.
- Facet
Result - Facet
Result Set - Named result wrapper useful when facets are fetched independently.
- Index
Advice - A conservative, server-side index hint. It is advisory only and never creates or changes database indexes.
- Label
- Label
Enricher - Page
- Partition
Name - PgExecution
Policy - PgPool
Router - Immutable server-owned entity-to-pool routing table.
- PgRenderer
- PgSift
Query - Query
Context - Query
Diagnostic Report - Query
Observation - Query
Shape Cache - Bounded LRU cache for SQL templates and value-free bind instructions.
- Query
Shape Id - Rendered
PgQuery - Result
Context - Scan
Policy - Server-owned single-statement scan budget. PostgreSQL provides one statement
snapshot;
batch_sizecontrols cooperative handoff, not cursor pagination. - Schema
Validation Error - Schema
Validation Report - Shape
Cache Stats - Cumulative observations for a bounded SQL-shape cache.
- SqlContext
- Summary
Value
Enums§
- Count
Strategy - Execution
Strategy - Extension
Error - Label
Failure Policy - Missing
Label Policy - PgBind
Value - PgSearch
Error - Pool
Route Error - Render
Error - Result
Filter Decision - Schema
Validation Target - What the schema contract validator checked.
- Snapshot
Isolation - Timeout
Stage
Traits§
- Label
Loader - Label
Target - Typed opt-in: implementations explicitly name the source fields and writable
label fields.
set_labelmust not modify database fields or ordering keys. - Page
Enricher - Asynchronous page-level result enhancement. Implementations should batch external lookups and must not change count, summaries, or cursor metadata.
- Partition
Resolver - PgPool
Selector - Application-owned, nonblocking resolver for trusted request context. Client query parameters are never supplied to this hook.
- PgSum
Type - PgSummary
Value - Query
Observer - Metrics/event bridge. Called once per completed or cancelled operation; panics are isolated. The callback must be nonblocking and cannot see SQL, binds, raw input, tenant identifiers, or cursor tokens.
- Result
Filter - SqlInterceptor
- Typed
Page Enricher - Explicit typed opt-in: implementers declare which presentation fields may be filled and preserve database fields and ordering keys.