Struct Valence 

pub struct Valence { /* private fields */ }

Host-assembled Valence handle.

Implementations

impl Valence

pub fn builder() -> ValenceBuilder

pub fn database_router(&self) -> &Arc<DatabaseRouter>

pub fn active_backend(&self) -> Result<Arc<dyn DatabaseBackend>, Error>

Errors

Returns an error when the requested operation cannot be completed.

pub fn backend_for_table( &self, table: &str, ) -> Result<Arc<dyn DatabaseBackend>, Error>

Errors

Returns an error when the requested operation cannot be completed.

pub fn telemetry_sink(&self) -> &Arc<dyn TelemetrySink>

pub fn secret_provider(&self) -> &Arc<dyn SecretProvider>

pub fn actor_factory(&self) -> &Arc<dyn ActorFactory>

pub fn endpoint_resolver(&self) -> &Arc<dyn DatabaseEndpointResolver>

pub fn actor(&self) -> &Actor

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

Clone this handle with a different actor.

Security

Privileged: hosts must not expose raw with_actor(Actor::System) (or other elevated actors) from untrusted client input. Bind actors from session/JWT at the host edge.

pub fn with_owner_override(&self, owner: OwnerRef) -> Valence

Clone this handle with an ownership override.

Security

Privileged: do not accept client-supplied owner overrides without host authorization.

pub fn owner_override(&self) -> Option<&OwnerRef>

pub fn permission_cache(&self) -> Option<&RequestPermissionCache>

Request-scoped permission check cache, when enabled on the builder.

pub async fn get_many_to_many_target_record_ids( &self, from: &RecordId, edge_table: &str, ) -> Result<Vec<RecordId>, Error>

Navigate ManyToMany edges and return target RecordId values.

Security

Raw edge read — no schema privacy. Do not expose as a client API without host authz.

Errors

Returns an error when the requested operation cannot be completed.

pub async fn relate_edge( &self, edge_table: &str, from: &RecordId, to: &RecordId, ) -> Result<(), Error>

Create a graph edge between two records in edge_table.

Security

Raw edge write — no schema privacy. Hosts must authorize before calling.

Errors

Returns an error when the requested operation cannot be completed.

pub async fn unrelate_edge( &self, edge_table: &str, from: &RecordId, to: &RecordId, ) -> Result<(), Error>

Delete a graph edge between two records in edge_table.

Security

Raw edge delete — no schema privacy. Hosts must authorize before calling.

Errors

Returns an error when the requested operation cannot be completed.

pub async fn ensure_unique_field_index( &self, table: &str, field: &str, ) -> Result<(), Error>

Errors

Returns an error when the requested operation cannot be completed.

pub async fn ensure_ttl_for_all(&self) -> Result<(), Error>

Apply native TTL (or warn once) for every schema that declares ttl:.

Primary host wire-up after backends are registered. Scrapes crate::SchemaRegistry (inventory / auto_discover) — no hand list of tables.

Errors

See crate::ttl::ensure_ttl_for_all.

pub async fn ensure_ttl_for_table(&self, table: &str) -> Result<(), Error>

Apply native TTL for table, or warn once when the backend is Deferred/Unsupported.

Prefer Self::ensure_ttl_for_all at boot; use this for incremental/single-table cases.

Errors

See crate::ttl::ensure_ttl_for_table.

pub async fn ensure_typed_tables_from_registry(&self) -> Result<(), Error>

Create typed physical tables for every schema in crate::SchemaRegistry.

Errors

See crate::storage_layout::ensure_typed_tables_from_registry.

pub async fn sync_typed_tables_from_registry(&self) -> Result<(), Error>

Additive-sync typed tables for every schema in crate::SchemaRegistry.

Errors

See crate::storage_layout::sync_typed_tables_from_registry.

pub fn is_system(&self) -> bool

Trait Implementations

impl Clone for Valence

fn clone(&self) -> Valence

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Valence

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

Formats the value using the given formatter.