Crate fraiseql_server 

FraiseQL HTTP Server

HTTP server for FraiseQL v2 compiled GraphQL execution engine.

Architecture

The server exposes a GraphQL HTTP endpoint that:

1. Receives GraphQL queries via POST
2. Executes queries using the runtime Executor
3. Returns GraphQL-compliant JSON responses

Features

• GraphQL endpoint (/graphql)
• Health check endpoint (/health)
• Schema introspection endpoint (/introspection)
• CORS support
• Compression (gzip, br, zstd)
• Request tracing
• APQ (Automatic Persisted Queries)
• Query caching
• Authentication middleware (optional)

Re-exports

pub use logging::ErrorDetails;

pub use logging::LogLevel;

pub use logging::LogMetrics;

pub use logging::RequestContext;

pub use logging::RequestId;

pub use logging::RequestLogger;

pub use logging::SourceLocation;

pub use logging::StructuredLogEntry;

pub use metrics_server::MetricsCollector;

pub use metrics_server::PrometheusMetrics;

pub use performance::OperationProfile;

pub use performance::PerformanceMonitor;

pub use performance::PerformanceStats;

pub use performance::PerformanceTimer;

pub use performance::QueryPerformance;

pub use schema::CompiledSchemaLoader;

pub use secrets::SecretManager;

pub use server::Server;

pub use server_config::ServerConfig;

pub use tls::TlsSetup;

pub use tracing_server::SpanStatus;

pub use tracing_server::TraceContext;

pub use tracing_server::TraceEvent;

pub use tracing_server::TraceParseError;

pub use tracing_server::TraceSpan;

pub use validation::RequestValidator;

pub use validation::ValidationError;

pub use fraiseql_webhooks as webhooks;

pub use fraiseql_auth as auth;

Modules

api

API endpoints for FraiseQL Server

api_key

API key authentication.

backup

Backup and Disaster Recovery System

config

encryption

Encryption for sensitive database fields using AES-256-GCM

error

GraphQL error response handling.

extractors

Custom extractors for GraphQL handlers.

federation

Federation support modules for Apollo Federation v2.

files

FraiseQL File Runtime

lifecycle

logging

Structured JSON logging for observability.

metrics_server

Prometheus metrics for observability.

middleware

HTTP middleware.

observability

Observability infrastructure for FraiseQL server

operational

Operational tools for FraiseQL server

performance

Performance monitoring and tracking for query execution.

resilience

routes

HTTP routes.

runtime_state

Application state with dependency injection traits.

schema

Schema loading and management.

secrets

Secrets management with KMS-backed encryption and database schemas.

secrets_manager

Abstraction layer for multiple secrets backends (Vault, Environment Variables, File)

server

HTTP server implementation.

server_config

Server configuration.

subscriptions

Subscription infrastructure for FraiseQL

tls

TLS/SSL server configuration and enforcement.

tls_listener

TLS listener utilities for accepting both plain and encrypted connections.

token_revocation

Token revocation — reject JWTs whose jti claim has been revoked.

tracing_server

Distributed tracing support for request correlation and debugging.

tracing_utils

Utilities for distributed tracing support.

trusted_documents

Trusted documents / query allowlist.

validation

GraphQL request validation module.

Enums

ServerError

Server error type.

Type Aliases

Result

Server result type.