Struct FileOverlay 

pub struct FileOverlay { /* private fields */ }

Concurrent, overlay-based file store for a single workspace.

Reads are lock-free via DashMap. Writes are O(1) in memory and issue a single INSERT … ON CONFLICT UPDATE to PostgreSQL.

Implementations

impl FileOverlay

pub fn new(workspace_id: Uuid, db: PgPool) -> Self

Create a new, empty overlay for the given workspace.

pub fn get(&self, path: &str) -> Option<Ref<'_, String, OverlayEntry>>

Get a reference to an overlay entry by path.

pub fn contains(&self, path: &str) -> bool

Check whether the overlay contains an entry for path.

pub async fn write( &self, path: &str, content: Vec<u8>, is_new: bool, ) -> Result<String>

Write (or overwrite) a file in the overlay.

is_new indicates whether the file did not previously exist in the base tree — it controls whether the entry is Added vs Modified.

The write is persisted to the database before returning.

pub async fn delete(&self, path: &str) -> Result<()>

Mark a file as deleted in the overlay.

The deletion is persisted to the database.

pub async fn revert(&self, path: &str) -> Result<()>

Revert a file in the overlay, removing it from both memory and DB.

pub fn list_changes(&self) -> Vec<(String, OverlayEntry)>

Return a snapshot of all changed paths and their entries.

pub fn list_paths(&self) -> Vec<String>

Returns just the file paths in the overlay without cloning content.

pub fn len(&self) -> usize

Number of entries (files touched) in the overlay.

pub fn is_empty(&self) -> bool

Whether the overlay is empty.

pub fn total_bytes(&self) -> usize

Total bytes stored in the overlay (excluding deleted entries).

pub async fn restore_from_db(&self) -> Result<()>

Restore overlay state from the database.

Used when recovering a workspace after a process restart.