Struct Store 

pub struct Store { /* private fields */ }

The SQLite database, and every query the server makes against it.

Implementations

impl Store

pub fn open(path: impl AsRef<Path>) -> Result<Self>

Opens (creating if needed) the database at path.

pub fn open_in_memory() -> Result<Self>

An in-memory database, for tests.

pub fn get( &self, project_key: &str, file_path: &str, ) -> Result<Option<Existing>>

Reads one row.

pub fn upsert( &self, project_key: &str, file_path: &str, content: &str, source_env: &str, updated_at: &str, ) -> Result<()>

Writes content, clearing any tombstone.

pub fn tombstone( &self, project_key: &str, file_path: &str, source_env: &str, updated_at: &str, ) -> Result<()>

Marks a file deleted while deliberately leaving its content in place: a mistaken delete stays recoverable at the database level, even though nothing in the app surfaces an undo yet. Store::list withholds the content so a pull can’t resurrect it.

pub fn list(&self, project_key: &str) -> Result<Vec<File>>

Every file for a project, tombstones included so a pulling client knows what to remove locally — but with the deleted content withheld.

pub fn last_sync_at(&self) -> Result<String>

The most recent write across all projects, for /health. Empty when nothing has ever been synced.

pub fn admin_stats(&self) -> Result<(Vec<ProjectStats>, AdminTotals)>

Aggregates per project for the admin page.

pub fn backup(&self, dir: impl AsRef<Path>, keep: usize) -> Result<PathBuf>

Writes a consistent snapshot via VACUUM INTO, which is safe against a live database — unlike copying the file — then prunes the oldest snapshots beyond keep.