Struct ProjectStorage 

pub struct ProjectStorage { /* private fields */ }

Handle to the project storage subsystem.

Wraps the registry and the filesystem root where project data is stored. Methods that modify the registry save it to disk atomically after each mutation.

Implementations

impl ProjectStorage

pub fn new(config: ServerConfig) -> Result<Self, String>

Create or load the project storage.

If the storage directory does not exist, it is created along with an empty registry. If it exists, the registry is loaded and validated.

pub fn add_project(&mut self, project: StoredProject) -> Result<(), String>

Add a new project to the registry.

Returns an error if a project with the same UUID already exists.

pub fn remove_project(&mut self, uuid: &Uuid) -> Result<(), String>

Remove a project from the registry and delete its files.

pub fn get_project(&self, uuid: &Uuid) -> Option<&StoredProject>

Get a project by UUID.

pub fn list_projects(&self) -> Vec<&StoredProject>

List all projects in the registry.

pub fn update_project(&mut self, project: StoredProject) -> Result<(), String>

Update a project’s metadata in the registry.

pub fn archive_path(&self, uuid: &Uuid) -> PathBuf

Return the path where a project’s archive blob is stored.

pub fn meta_path(&self, uuid: &Uuid) -> PathBuf

Return the path where a project’s metadata TOML is stored.

pub fn write_archive( &self, uuid: &Uuid, reader: &mut impl Read, ) -> Result<u64, String>

Write a project’s archive blob to disk using streaming I/O.

Data is read from the provided reader and written to the archive path. The caller is responsible for encryption — the server stores whatever bytes it receives.

pub fn read_archive(&self, uuid: &Uuid) -> Result<BufReader<File>, String>

Open a project’s archive blob for reading.

Returns a buffered reader positioned at the start of the file.

pub fn archive_exists(&self, uuid: &Uuid) -> bool

Check whether an archive blob exists for a project.

pub fn write_meta( &self, uuid: &Uuid, project: &StoredProject, ) -> Result<(), String>

Write a project’s per-project metadata TOML file.

pub fn check_size_limit(&self, additional_bytes: u64) -> Result<(), String>

Check that the total stored size does not exceed the configured limit.