Edouard Vanbelle
73f0b0fa47
* make more coherent lifecycles
* remove specific implementation on different handlers (they do not need to know existence of ThumbnailSerice nor AudioMetadataService)
* reduce risk of orphean objects
* ensure additional services are correctly wired (ex: Thumbnail generation was not covering all upload cases)
* more details on docs/architecture/file-and-blob-lifecycle.md :
```rust
// application/ports/file_lifecycle.rs
pub trait FileLifecycleHook {
fn on_file_created(file_id, blob_hash, content_type, is_new_blob);
fn on_file_updated(file_id, blob_hash, content_type);
fn on_file_copied(file_id, blob_hash, content_type, source_id)
fn on_file_deleted(file_id);
}
// application/ports/blob_lifecycle.rs
pub trait BlobLifecycleHook {
fn on_blob_created(blob_hash, content_type);
fn on_blob_deleted(blob_hash);
}
```
27 lines
1.3 KiB
Rust
27 lines
1.3 KiB
Rust
/// Observer notified by [`DedupService`] when a blob is stored for the first
|
|
/// time or permanently removed (ref_count reaches zero).
|
|
///
|
|
/// Register with [`BlobLifecycleService`] during DI wiring; it fans out to all
|
|
/// registered hooks. Every implementor **must** provide both methods —
|
|
/// use an explicit one-liner noop for events the implementor does not care about.
|
|
/// This forces conscious acknowledgement of every lifecycle event rather than
|
|
/// silent omission.
|
|
///
|
|
/// All methods are synchronous. Background work must be spawned inside the
|
|
/// implementor via `tokio::spawn`; the calling service never awaits hook
|
|
/// completion.
|
|
pub trait BlobLifecycleHook: Send + Sync {
|
|
/// Called after a genuinely new blob has been written to storage (no dedup
|
|
/// hit — first time this content hash is seen).
|
|
///
|
|
/// `blob_hash` — BLAKE3 hex identifying the blob.
|
|
/// `content_type` — MIME type if known at write time, `None` otherwise.
|
|
fn on_blob_created(&self, blob_hash: &str, content_type: Option<&str>);
|
|
|
|
/// Called after a blob's ref_count reaches zero and it has been permanently
|
|
/// removed from storage.
|
|
///
|
|
/// `blob_hash` — BLAKE3 hex identifying the (now deleted) blob.
|
|
fn on_blob_deleted(&self, blob_hash: &str);
|
|
}
|