Struct CheckpointGuard 

pub struct CheckpointGuard<'pool> { /* private fields */ }

A zero-wait checkout that can run only the fixed checkpoint recovery pragmas. The connection remains private: exposing it would let a caller execute logical writes without disk-reserve admission (ADR-154 §5).

Ordinary SQL is deliberately unavailable through this capability:

use khive_db::{ConnectionPool, PoolConfig};
let pool = ConnectionPool::new(PoolConfig::default()).unwrap();
pool.try_checkpoint_nowait().unwrap().execute_batch("CREATE TABLE bypass (id INTEGER)");

Implementations

impl CheckpointGuard<'_>

pub fn passive(&self) -> Result<CheckpointResult, SqliteError>

Run a PASSIVE checkpoint without disk-reserve admission.

pub fn truncate(&self) -> Result<CheckpointResult, SqliteError>

Run a TRUNCATE checkpoint without disk-reserve admission.