Struct ValenceBuilder 

pub struct ValenceBuilder { /* private fields */ }

Builder for constructing a Valence runtime.

Storage

Method	Use
Self::add_backend	Primary API; key from backend.engine_id()
Self::add_backend_key	Explicit compound key
Self::database_router	Inject a pre-built DatabaseRouter
Self::default_backend_key	Active backend when models omit per-table routing
Self::build	Requires ≥1 backend — no silent mem fallback

Host ports

Optional: Self::telemetry_sink, Self::secret_provider, Self::actor_factory, Self::endpoint_resolver. See crate::ports for the port table and reference impls.

Privacy policies are schema-attached (crate::PolicyEvaluator), not registered here.

Examples

use std::sync::Arc;
use valence_backend_mem::InMemoryBackend;
use valence_core::Valence;

let valence = Valence::builder()
    .add_backend("default", Arc::new(InMemoryBackend::new()))
    .build()
    .expect("build");
assert!(valence.active_backend().is_ok());

Implementations

impl ValenceBuilder

pub fn new() -> ValenceBuilder

Start with an empty router; call Self::add_backend before Self::build.

pub fn add_backend( self, logical_name: impl AsRef<str>, backend: Arc<dyn DatabaseBackend>, ) -> ValenceBuilder

Register a backend under router_key(logical_name, backend.engine_id()).

Examples

use std::sync::Arc;
use valence_backend_mem::InMemoryBackend;
use valence_core::ValenceBuilder;

let builder = ValenceBuilder::new()
    .add_backend("default", Arc::new(InMemoryBackend::new()));
let _ = builder.build().expect("build");

pub fn add_backend_key( self, key: impl Into<String>, backend: Arc<dyn DatabaseBackend>, ) -> ValenceBuilder

Register a backend under an explicit router key (for pre-built heterogeneous routers).

pub fn database_router(self, router: Arc<DatabaseRouter>) -> ValenceBuilder

Inject a fully built router instead of registering backends on this builder.

Contract: mutually exclusive with Self::add_backend / Self::add_backend_key.

pub fn default_backend_key(self, key: impl Into<String>) -> ValenceBuilder

Set the active backend key used by generated models without per-table routing.

Contract: required when more than one backend is registered; optional when exactly one.

pub fn telemetry_sink(self, sink: Arc<dyn TelemetrySink>) -> ValenceBuilder

Install a process-global telemetry sink (also stored on the built Valence).

pub fn secret_provider( self, provider: Arc<dyn SecretProvider>, ) -> ValenceBuilder

Provide secret lookup for host-owned credential resolution.

pub fn actor_factory(self, factory: Arc<dyn ActorFactory>) -> ValenceBuilder

Build request-scoped crate::ActorContext values from JSON actor payloads.

pub fn endpoint_resolver( self, resolver: Arc<dyn DatabaseEndpointResolver>, ) -> ValenceBuilder

Resolve physical database URLs from logical names at bootstrap.

pub fn with_actor(self, actor: Actor) -> ValenceBuilder

Set the default actor for this runtime (defaults to anonymous).

pub fn build(self) -> Result<Valence, Error>

Construct a Valence runtime from the configured router and ports.

Errors: when no backends are registered, when both injected and local routers are used, or when multiple backends are registered without Self::default_backend_key.

Trait Implementations

impl Default for ValenceBuilder

fn default() -> ValenceBuilder

Returns the “default value” for a type.