Struct SqlBindingConfig 

pub struct SqlBindingConfig {
    pub dir: Option<PathBuf>,
    pub url: Option<String>,
    pub admin_url: Option<String>,
    pub replica_url: Option<String>,
    pub token_env: Option<String>,
    pub admin_token_env: Option<String>,
    pub preview_mode: Option<String>,
    pub preview_init: Option<PathBuf>,
    pub databases: BTreeMap<String, ExternalDatabaseConfig>,
}

libsql settings for the handler sql binding — the single SQL backend. Each site gets a real database boundary (an embedded file per site, or a sqld namespace per site), never schema separation (which arbitrary guest SQL escapes). Setting url switches from single-node to a shared sqld cluster; everything else stays identical.

Fields

dir: Option<PathBuf>

Single-node: root directory for the per-site embedded database files (default <data-dir>/handlers-sql). Ignored when url is set.

url: Option<String>

Cluster: base sqld data URL (e.g. http://sqld:8080). When set, each site is a sqld namespace addressed as a subdomain of this URL; admin_url is then required.

admin_url: Option<String>

Cluster: sqld admin API base URL (e.g. http://sqld:9090) for creating per-site namespaces. Required when url is set.

replica_url: Option<String>

Cluster: optional sqld read-replica data URL. When set, handlers’ read-only sql transactions (open-read-only) route to this endpoint while writes stay on url (reads → replicas, writes → primary). Reads may lag (eventually consistent). Ignored in single-node mode (no url).

token_env: Option<String>

Name of the env var holding the sqld data auth token (optional; never the token itself in-file).

admin_token_env: Option<String>

Name of the env var holding the sqld admin API auth key (optional).

preview_mode: Option<String>

How preview deployments get their SQL database: empty (default — a fresh isolated db), branch (a consistent copy of the site’s live db; single-node only), or shared (the site’s live db). See boatramp_core::sql::PreviewSqlMode.

preview_init: Option<PathBuf>

Path to an idempotent SQL script run when an empty preview database is first opened (e.g. schema/seed). Ignored in branch/shared modes.

databases: BTreeMap<String, ExternalDatabaseConfig>

handlers.bindings.sql.databases — external bring-your-own databases, each opened by name via sql.open("<name>"). An operator-configured Postgres/MySQL whose isolation is the operator’s (it’s their database), so these bypass the per-site libsql boundary and are reachable by any handler/function granted the sql binding. Needs the sql-postgres / sql-mysql build feature for the engine. A name here shadows the same name on the managed libsql default.

Trait Implementations

impl Clone for SqlBindingConfig

fn clone(&self) -> SqlBindingConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SqlBindingConfig

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

Formats the value using the given formatter.

impl Default for SqlBindingConfig

fn default() -> SqlBindingConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SqlBindingConfig

where SqlBindingConfig: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.