Struct RuntimeConfig 

pub struct RuntimeConfig {

    pub server: HttpServerConfig,
    pub database: DatabaseConfig,
    pub webhooks: HashMap<String, WebhookRouteConfig>,
    pub files: HashMap<String, FileConfig>,
    pub auth: Option<AuthConfig>,
    pub notifications: Option<NotificationsConfig>,
    pub observers: HashMap<String, ObserverConfig>,
    pub interceptors: HashMap<String, Vec<String>>,
    pub rate_limiting: Option<RateLimitingConfig>,
    pub cors: Option<CorsConfig>,
    pub metrics: Option<MetricsConfig>,
    pub tracing: Option<TracingConfig>,
    pub logging: Option<LoggingConfig>,
    pub storage: HashMap<String, StorageConfig>,
    pub search: Option<SearchConfig>,
    pub cache: Option<CacheConfig>,
    pub queues: Option<QueueConfig>,
    pub realtime: Option<RealtimeConfig>,
    pub custom_endpoints: Option<CustomEndpointsConfig>,
    pub lifecycle: Option<LifecycleConfig>,
}

Root configuration structure loaded from fraiseql.toml.

Fields

server: HttpServerConfig

HTTP server binding, TLS, and connection-limit settings.

database: DatabaseConfig

Primary database connection and pool settings.

webhooks: HashMap<String, WebhookRouteConfig>

Named webhook route configurations, keyed by route name.

files: HashMap<String, FileConfig>

Named file-upload route configurations, keyed by route name.

auth: Option<AuthConfig>

Optional JWT authentication and OAuth provider configuration.

notifications: Option<NotificationsConfig>

Reserved: placeholder for future notification system configuration.

observers: HashMap<String, ObserverConfig>

Event observer configurations, keyed by observer name.

interceptors: HashMap<String, Vec<String>>

Request interceptor chains, keyed by interceptor name.

rate_limiting: Option<RateLimitingConfig>

Optional rate-limiting rules and backpressure thresholds.

cors: Option<CorsConfig>

Optional CORS origin and header policy.

metrics: Option<MetricsConfig>

Optional Prometheus metrics and SLO tracking configuration.

tracing: Option<TracingConfig>

Optional distributed-tracing (OTLP/Jaeger) configuration.

logging: Option<LoggingConfig>

Optional structured-logging configuration.

storage: HashMap<String, StorageConfig>

Named object-storage backend configurations, keyed by storage name.

search: Option<SearchConfig>

Reserved: placeholder for future search-indexing configuration.

cache: Option<CacheConfig>

Reserved: placeholder for future advanced caching strategy configuration.

queues: Option<QueueConfig>

Reserved: placeholder for future job-queue configuration.

realtime: Option<RealtimeConfig>

Reserved: placeholder for future real-time update configuration.

custom_endpoints: Option<CustomEndpointsConfig>

Reserved: placeholder for future custom-endpoint configuration.

lifecycle: Option<LifecycleConfig>

Graceful-shutdown timing and health-check endpoint paths.

Implementations

impl RuntimeConfig

pub fn from_file(path: impl AsRef<Path>) -> Result<Self, ConfigError>

Load configuration from file with full validation

Errors

Returns ConfigError::ReadError if the file cannot be read. Returns ConfigError::ParseError if the file content is not valid TOML. Returns ConfigError if validation fails or required environment variables are missing.

pub fn load() -> Result<Self, ConfigError>

Load configuration from default locations

Errors

Returns ConfigError::NotFound if no configuration file is found in any default location. Returns ConfigError if the found file cannot be read, parsed, or fails validation.

pub fn load_with_path(path: Option<&Path>) -> Result<Self, ConfigError>

Load configuration with optional file path (CLI argument)

Errors

Returns ConfigError if loading from the given path or from default locations fails.

pub fn validate_syntax(content: &str) -> Result<(), ConfigError>

Validate configuration without loading env vars (for dry-run/testing)

Errors

Returns ConfigError::ParseError if the content is not valid TOML or cannot be deserialized.

Trait Implementations

impl Clone for RuntimeConfig

fn clone(&self) -> RuntimeConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RuntimeConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RuntimeConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.