fraiseql-core 2.15.0

Core execution engine for FraiseQL v2 - Compiled GraphQL over SQL
Documentation 
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

//! Automatic Persisted Queries (APQ) infrastructure.
//!
//! APQ is a GraphQL optimization technique that allows clients to:
//! 1. Hash queries and send only the hash on subsequent requests
//! 2. Server responds with original query if not cached
//! 3. Reduces bandwidth for frequently-used queries
//!
//! # Security Considerations
//!
//! Cache keys MUST include variables to prevent data leakage between requests
//! with different variable values.
//!
//! # Module Contents
//!
//! - **hasher**: Query hashing with SHA-256 (pure Rust implementation)
//! - **storage**: APQ result storage and retrieval
//! - **metrics**: APQ performance metrics and monitoring

pub mod hasher; // Pure Rust query hasher
pub mod memory_storage;
pub mod metrics;
#[cfg(feature = "redis-apq")]
pub mod redis_storage;
pub mod storage;

// Re-export key types for convenience
pub use hasher::{
    hash_query, hash_query_with_variables, normalize_json_value, verify_hash,
    verify_hash_with_variables,
};
pub use memory_storage::InMemoryApqStorage;
pub use metrics::ApqMetrics;
#[cfg(feature = "redis-apq")]
pub use redis_storage::RedisApqStorage;
pub use storage::{ApqError, ApqStats, ApqStorage, ArcApqStorage};

#[cfg(test)]
mod tests;