Struct TypeDBRuntime 

pub struct TypeDBRuntime { /* private fields */ }

Real TypeDB backend wrapping an internal band-tagged driver handle.

Implementations

impl TypeDBRuntime

pub fn force_close(&self) -> Result<()>

Make the selected driver terminal and dispatch upstream shutdown.

Bindings call this at their public connection-close boundary instead of relying on field drop ordering. While any transaction handle is retained, close returns resource_in_use and leaves the connection available. After those handles are released, the first call prevents new operations, invalidates in-flight work through upstream shutdown, and leaves the runtime permanently unavailable even if shutdown reports an error. A later call retries incomplete upstream dispatch without reopening the connection; calls after successful dispatch are harmless. Final callback-worker release remains lease-aware and occurs when the last driver handle drops.

impl TypeDBRuntime

pub async fn connect( address: &str, username: &str, password: &str, options: ConnectOptions, ) -> Result<Self>

Connect to a TypeDB server.

Validates the supplied server version, or probes via HTTP before opening any gRPC connection when no version is supplied. Returns RuntimeError::UnsupportedVersion when the server is outside the supported window or on a different protocol band than the driver.

pub async fn connect_secure( address: &str, username: &str, password: &str, options: SecureConnectOptions, ) -> SecureResult<Self>

Connect using an explicit typed TLS policy.

Custom trust material is validated before the HTTP version probe or any gRPC host is constructed. An enabled mode remains enabled through HTTP failure, driver-band discovery, and native-band upgrade.

pub fn server_version(&self) -> Option<Version>

The server version detected by the connect gate, when known.

When this is None, callers must use the negotiated driver band rather than inferring a server version from a failed HTTP probe.

pub fn supports_given_rows(&self) -> bool

Return whether the connection actually negotiated a driver that can transport given input rows.

This is deliberately separate from the reported server version. A 3.12 server may accept the band-8 discovery connection when a later band-9 upgrade fails; advertising given in that state would select an execution path the active driver cannot carry.

impl TypeDBRuntime

pub fn open_transaction( &self, database: &str, tx_type: TxType, ) -> BoxFuture<'_, Result<RuntimeTransaction>>

Open a TypeDB transaction against database.

pub fn open_transaction_with_timeout( &self, database: &str, tx_type: TxType, timeout: Duration, ) -> BoxFuture<'_, Result<RuntimeTransaction>>

Open a TypeDB transaction with an explicit server-side lifetime bound.

Higher layers use this for transactions that hold schema exclusion: a lost client must not leave the server-side fence unbounded while the transport is still detecting terminal closure.

pub fn is_open(&self) -> bool

Check whether the underlying driver is open.

pub fn database_exists(&self, database: &str) -> BoxFuture<'_, Result<bool>>

Check whether a database exists.

pub fn create_database(&self, database: &str) -> BoxFuture<'_, Result<()>>

Create a database.

pub fn delete_database(&self, database: &str) -> BoxFuture<'_, Result<()>>

Delete a database.

pub fn schema_text(&self, database: &str) -> BoxFuture<'_, Result<String>>

Export a database schema as TypeQL text.