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 schema::CompiledSchemaLoader;

pub use server::Server;

pub use server_config::ServerConfig;

pub use tls::TlsSetup;

pub use fraiseql_auth as auth;

Modules

api

API endpoints for FraiseQL Server

api_key

API key authentication.

config

Runtime configuration types loaded from fraiseql.toml or environment variables. Runtime configuration types for the FraiseQL server.

error

GraphQL error response handling.

extractors

Custom extractors for GraphQL handlers.

logging

Structured JSON logging for observability.

metrics_server

Canonical metrics implementation for fraiseql-server.

middleware

HTTP middleware.

pool

Connection pool management.

prelude

Convenience re-exports for common server types.

resilience

Resilience primitives: backpressure and retry policies. Resilience primitives for the FraiseQL server.

routes

HTTP routes.

schema

Schema loading and management.

server

HTTP server implementation.

server_config

Server configuration (*Config types).

storage

Object storage backends for file upload and download.

subscriptions

Subscription infrastructure for FraiseQL

tls

TLS/SSL server configuration and enforcement.

token_revocation

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

tracing_utils

Stub tracing utilities when federation is disabled.

trusted_documents

Trusted documents / query allowlist.

validation

GraphQL request validation — re-exported from fraiseql-core.

Structs

RequestValidator

AST-based GraphQL request validator.

Enums

ComplexityValidationError

GraphQL query validation error types (depth, complexity, aliases).

ServerError

Server error type.

Type Aliases

Result

Server result type.