Struct Asset 

pub struct Asset { /* private fields */ }

A record in the assets table representing one user’s ownership of a blob.

The server stores files by their BLAKE3 hash (CAS semantics). Multiple users can upload identical files — each gets their own Asset row pointing to the same hash. When a user deletes their asset, only their row is removed. The physical blob is only deleted when no Asset rows reference its hash anymore. This mirrors Unix hard-link semantics.

Implementations

impl Asset

pub async fn exists(pool: &SqlitePool, hash: Vec<u8>) -> Result<bool>

Returns whether asset exists with given hash

Errors

• Fails with [sqlx::Error] if fails to work with database

pub async fn create( pool: &SqlitePool, user: i64, tag: AssetTag, metadata: &Metadata, ) -> Result<()>

Registers an asset entry to the assets entity

Errors

• Returns [sqlx::Error::Database] for uniqueness violation, because of uuid being PRIMARY KEY, which happens very (very) rarely.
• Otherwise, this can fail on querrying databases

pub async fn delete(pool: &SqlitePool, user: i64, hash: &[u8]) -> Result<()>

Deletes user’s ownership over an asset

• Returns Ok(true), if no other user owns same asset. Good signal to wipe that asset physically off the server.
• Return Ok(false), if user doesn’t own the file, or other users have own the same file.

Errors

Returns [sqlx::Error] if a database transaction fails.

pub async fn owned_by(pool: &SqlitePool, user: i64, hash: &[u8]) -> Result<bool>

Checks if any Asset with provided hash exists, and is owned by the specified user as well

It’s different from Asset::exists, because it checks for ownership. Required for situations where user tries to access an asset, this returns the proof of it.

Errors

Returns [sqlx::Error] if the database query fails.

impl Asset

pub async fn list( pool: &SqlitePool, user_id: i64, tag_filter: Option<i16>, ) -> Result<Vec<AssetMetadataRow>>

Trait Implementations

impl<'a, R: Row> FromRow<'a, R> for Asset

where &'a str: ColumnIndex<R>, Uuid: Decode<'a, R::Database> + Type<R::Database>, Vec<u8>: Decode<'a, R::Database> + Type<R::Database>, i64: Decode<'a, R::Database> + Type<R::Database>, AssetTag: Decode<'a, R::Database> + Type<R::Database>,

fn from_row(__row: &'a R) -> Result<Self>