Struct ServerConfig 

pub struct ServerConfig { /* private fields */ }

Public server configuration.

Implementations

impl ServerConfig

pub fn new( bind_addr: SocketAddr, public_base_url: String, root_dir: PathBuf, chunk_size: NonZeroUsize, ) -> Self

Creates server configuration.

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

Loads server configuration from environment variables.

Errors

Returns ServerConfigError when an environment value cannot be parsed or when the configured chunk size is zero.

pub const fn bind_addr(&self) -> SocketAddr

Returns the socket address the server binds to.

pub const fn server_role(&self) -> ServerRole

Returns the configured server role.

pub fn server_frontends(&self) -> &[ServerFrontend]

Returns the enabled runtime protocol frontends.

pub fn public_base_url(&self) -> &str

Returns the public base URL used in reconstruction responses.

pub fn root_dir(&self) -> &Path

Returns the local deployment root directory.

pub const fn max_request_body_bytes(&self) -> NonZeroUsize

Returns the maximum request body size accepted by body-buffering extractors.

pub const fn shard_metadata_limits(&self) -> ShardMetadataLimits

Returns the bounded-parser limits for native Xet shard metadata.

pub const fn chunk_size(&self) -> NonZeroUsize

Returns the content chunk size in bytes.

pub const fn with_chunk_size(self, chunk_size: NonZeroUsize) -> Self

Overrides the content chunk size in bytes.

pub const fn upload_max_in_flight_chunks(&self) -> NonZeroUsize

Returns the maximum in-flight upload chunks per file upload stream.

pub const fn transfer_max_in_flight_chunks(&self) -> NonZeroUsize

Returns the maximum concurrent transfer budget measured in chunk-equivalent permits.

pub fn with_root_dir(self, root_dir: PathBuf) -> Self

Overrides the local deployment root directory.

pub fn with_object_storage( self, adapter: ObjectStorageAdapter, s3_config: Option<S3ObjectStoreConfig>, ) -> Self

Selects object storage for immutable CAS objects.

pub const fn with_max_request_body_bytes( self, max_request_body_bytes: NonZeroUsize, ) -> Self

Overrides the maximum request body size accepted by body-buffering extractors.

pub const fn with_shard_metadata_limits( self, shard_metadata_limits: ShardMetadataLimits, ) -> Self

Overrides bounded-parser limits for native Xet shard metadata.

pub const fn with_server_role(self, server_role: ServerRole) -> Self

Selects the server role.

pub fn with_server_frontends( self, server_frontends: impl IntoIterator<Item = ServerFrontend>, ) -> Result<Self, ServerConfigError>

Selects the enabled runtime protocol frontends.

Errors

Returns ServerConfigError::MissingServerFrontends when the supplied frontend list is empty after deduplication.

pub const fn with_upload_max_in_flight_chunks( self, upload_max_in_flight_chunks: NonZeroUsize, ) -> Self

Overrides the per-upload chunk processing window.

pub const fn with_transfer_max_in_flight_chunks( self, transfer_max_in_flight_chunks: NonZeroUsize, ) -> Self

Overrides the transfer concurrency budget measured in chunk-equivalent permits.

pub fn with_reconstruction_cache_disabled(self) -> Self

Selects the disabled reconstruction-cache adapter.

pub fn with_reconstruction_cache_memory( self, reconstruction_cache_ttl_seconds: NonZeroU64, reconstruction_cache_memory_max_entries: NonZeroUsize, ) -> Self

Selects the bounded in-memory reconstruction-cache adapter.

pub const fn with_oci_upload_session_ttl_seconds( self, oci_upload_session_ttl_seconds: NonZeroU64, ) -> Self

Overrides the maximum idle lifetime for OCI upload sessions.

pub const fn with_oci_upload_max_active_sessions( self, oci_upload_max_active_sessions: NonZeroUsize, ) -> Self

Overrides the maximum number of live OCI upload sessions per server root.

pub const fn with_oci_registry_token_ttl_seconds( self, oci_registry_token_ttl_seconds: NonZeroU64, ) -> Self

pub const fn with_oci_registry_token_max_in_flight_requests( self, oci_registry_token_max_in_flight_requests: NonZeroUsize, ) -> Self

pub fn with_reconstruction_cache_redis( self, reconstruction_cache_redis_url: String, reconstruction_cache_ttl_seconds: NonZeroU64, ) -> Result<Self, ServerConfigError>

Selects the Redis reconstruction-cache adapter.

Errors

Returns ServerConfigError::EmptyReconstructionCacheRedisUrl when the URL is empty.

pub fn index_postgres_url(&self) -> Option<&str>

Returns the optional Postgres metadata URL.

pub const fn auth_provider(&self) -> AuthProviderKind

Returns the configured auth provider kind.

pub fn auth_oidc_issuer(&self) -> Option<&str>

Returns the optional OIDC issuer URL.

pub fn auth_jwks_url(&self) -> Option<&str>

Returns the optional JWKS endpoint URL.

pub fn auth_jwks_issuer(&self) -> Option<&str>

Returns the optional JWKS issuer for token validation.

pub fn token_signing_key(&self) -> Option<&[u8]>

Returns the optional token signing key.

pub fn metrics_token(&self) -> Option<&[u8]>

Returns the optional metrics bearer token.

pub fn provider_config_path(&self) -> Option<&Path>

Returns the optional provider configuration path.

pub fn provider_api_key(&self) -> Option<&[u8]>

Returns the optional provider bootstrap key.

pub fn provider_token_issuer(&self) -> Option<&str>

Returns the provider token issuer identity when provider issuance is enabled.

pub const fn provider_token_ttl_seconds(&self) -> Option<NonZeroU64>

Returns the provider token lifetime when provider issuance is enabled.

pub fn with_index_postgres_url( self, index_postgres_url: String, ) -> Result<Self, ServerConfigError>

Sets the PostgreSQL connection URL for the index store.

Errors

Returns ServerConfigError::EmptyIndexPostgresUrl when the URL is empty.

pub fn with_token_signing_key( self, token_signing_key: Vec<u8>, ) -> Result<Self, ServerConfigError>

Enables local bearer-token verification with the supplied signing key.

Errors

Returns ServerConfigError::EmptyTokenSigningKey when the signing key is empty.

pub const fn with_auth_provider(self, auth_provider: AuthProviderKind) -> Self

Selects the authentication provider.

pub fn with_auth_oidc_issuer(self, issuer: String) -> Self

Sets the OIDC issuer URL for the OIDC auth provider.

pub fn with_auth_jwks_url(self, url: String) -> Self

Sets the JWKS endpoint URL for the JWKS auth provider.

pub fn with_auth_jwks_issuer(self, issuer: String) -> Self

Sets the JWKS issuer for token validation.

pub fn with_metrics_token( self, metrics_token: Vec<u8>, ) -> Result<Self, ServerConfigError>

Enables bearer-token verification for /metrics.

Errors

Returns ServerConfigError::EmptyMetricsToken when the metrics token is empty.

pub fn with_provider_runtime( self, provider_config_path: PathBuf, provider_api_key: Vec<u8>, issuer_identity: String, ttl_seconds: NonZeroU64, ) -> Result<Self, ServerConfigError>

Enables the provider-facing token issuance surface.

Errors

Returns ServerConfigError when the provider bootstrap key or issuer identity is empty, or when token signing is not configured.

pub const fn validate_runtime_requirements( &self, ) -> Result<(), ServerConfigError>

Validates runtime requirements implied by the selected route surface.

Errors

Returns ServerConfigError::MissingTokenSigningKeyForServedRoutes when the selected role would expose authenticated CAS routes without a signing key.

Trait Implementations

impl Clone for ServerConfig

fn clone(&self) -> ServerConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServerConfig

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

Formats the value using the given formatter.

impl Eq for ServerConfig

impl PartialEq for ServerConfig

fn eq(&self, other: &ServerConfig) -> 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 StructuralPartialEq for ServerConfig