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);
}
```
72 lines
3.1 KiB
Rust
72 lines
3.1 KiB
Rust
/// Observer notified by file services when a file record is created, copied,
|
|
/// updated, or permanently deleted.
|
|
///
|
|
/// Register with [`FileLifecycleService`] during DI wiring; it fans out to all
|
|
/// registered hooks. Every implementor **must** provide all four 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 FileLifecycleHook: Send + Sync {
|
|
/// Called after a new file record has been persisted.
|
|
///
|
|
/// `file_id` — opaque file UUID string.
|
|
/// `blob_hash` — BLAKE3 hex of the content blob.
|
|
/// `content_type` — MIME type.
|
|
/// `is_new_blob` — `true` if the blob was stored for the first time (no
|
|
/// dedup hit); `false` if the blob already existed (re-upload of identical
|
|
/// content). Implementors can use this to skip re-generating artefacts that
|
|
/// are keyed by `blob_hash` and already exist on disk.
|
|
///
|
|
/// For explicit file copies use [`on_file_copied`] instead — it supplies
|
|
/// the source file id so per-file metadata can be cloned directly.
|
|
fn on_file_created(
|
|
&self,
|
|
file_id: &str,
|
|
blob_hash: &str,
|
|
content_type: &str,
|
|
is_new_blob: bool,
|
|
);
|
|
|
|
/// Called after a file has been created as an explicit copy of an existing file.
|
|
///
|
|
/// `file_id` — opaque file UUID string of the **new** copy.
|
|
/// `blob_hash` — BLAKE3 hex of the shared content blob.
|
|
/// `content_type` — MIME type.
|
|
/// `source_file_id` — opaque file UUID string of the **original** file.
|
|
///
|
|
/// Implementors may use `source_file_id` to efficiently clone per-file
|
|
/// metadata (audio tags, etc.) from the original rather than re-deriving
|
|
/// it from the blob. If the original has not yet been processed, fall back
|
|
/// to a blob-hash-based lookup or schedule a retry — the implementor owns
|
|
/// race handling.
|
|
fn on_file_copied(
|
|
&self,
|
|
file_id: &str,
|
|
blob_hash: &str,
|
|
content_type: &str,
|
|
source_file_id: &str,
|
|
);
|
|
|
|
/// Called after an existing file's blob has been replaced (WebDAV PUT
|
|
/// overwrite, WOPI PutFile, Nextcloud chunked upload finalization).
|
|
///
|
|
/// `file_id` — opaque file UUID string.
|
|
/// `blob_hash` — BLAKE3 hex of the **new** blob.
|
|
/// `content_type` — MIME type of the new content.
|
|
fn on_file_updated(&self, file_id: &str, blob_hash: &str, content_type: &str);
|
|
|
|
/// Called after a file record has been permanently removed (direct delete
|
|
/// or emptied from trash).
|
|
///
|
|
/// NOTE: due to deduplication the blob may still exist if other files
|
|
/// reference it. Use [`BlobLifecycleHook::on_blob_deleted`] when your
|
|
/// side-effect is content-addressed (e.g. removing blob-keyed thumbnails).
|
|
///
|
|
/// `file_id` — opaque file UUID string.
|
|
fn on_file_deleted(&self, file_id: &str);
|
|
}
|