Struct Config 

pub struct Config {
    pub server: ServerConfig,
    pub limits: LimitsConfig,
    pub http: HttpConfig,
    pub storage: StorageConfig,
    pub transport: TransportConfig,
    pub proxy: ProxyConfig,
    pub observability: ObservabilityConfig,
}

Server configuration resolved after all layering and defaults.

Fields

server: ServerConfig

Listener settings.

limits: LimitsConfig

Stream and storage size limits.

http: HttpConfig

HTTP protocol surface configuration.

storage: StorageConfig

Persistence backend configuration.

transport: TransportConfig

Transport and connection behaviour.

proxy: ProxyConfig

Reverse-proxy trust and identity handoff.

observability: ObservabilityConfig

Logging and tracing defaults.

Implementations

impl Config

pub fn from_env() -> Result<Self, ConfigLoadError>

Load configuration from DS_* environment variables with sensible defaults.

Used by tests and as a simple entry point when TOML layering is not needed.

Errors

Returns an error when any DS_* environment variable is present but invalid.

pub fn from_sources( options: &ConfigLoadOptions, ) -> Result<Self, ConfigLoadError>

Load configuration from layered TOML files plus environment overrides.

Order (later wins):

1. built-in defaults
2. built-in profile defaults
3. config/default.toml (if present)
4. config/<profile>.toml (if present)
5. config/local.toml (if present)
6. --config <path> override file (if provided)
7. DS_* env vars

Errors

Returns an error when config files cannot be parsed or an explicit override file path does not exist/read.

pub fn validate(&self) -> Result<(), ConfigValidationError>

Validate configuration invariants before server startup.

Errors

Returns a typed validation error when config is internally inconsistent.

pub fn validate_profile( &self, profile: &DeploymentProfile, ) -> Result<(), ConfigValidationError>

Deployment-profile-specific validation run after Config::validate.

Production profiles (prod, prod-tls, prod-mtls) reject wildcard CORS unless the operator has explicitly set http.allow_wildcard_cors.

Errors

Returns ConfigValidationError::WildcardCorsOriginsProd when a production profile is active with cors_origins = "*" and the escape hatch is not set.

pub fn warnings(&self) -> Vec<String>

Non-fatal advisories about the current configuration.

Returns human-readable warning strings that should be logged at startup but do not block the server from starting. Currently checks for wildcard CORS without an explicit opt-in via http.allow_wildcard_cors.

pub fn tls_enabled(&self) -> bool

True when direct TLS termination is enabled on this server.

pub fn bind_socket_addr(&self) -> Result<SocketAddr, ConfigValidationError>

Parsed bind address used by the runtime.

Errors

Returns the same validation error that Config::validate would emit for an invalid bind address.

pub fn long_poll_timeout(&self) -> Duration

Long-poll timeout as a typed Duration.

pub fn render_effective_json(&self) -> Result<String, Error>

Render the effective merged configuration as pretty JSON.

Errors

Returns an error when the effective config cannot be serialized.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for Config

fn eq(&self, other: &Config) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Config

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Config

impl StructuralPartialEq for Config