Database Lifecycle Hooks

The db() plugin automatically attaches guards and synchronization actions across upload, download, and delete flows.

Access and scope validationCopy Anchor Link

Route membership is still the server keyPrefix check (INVALID_KEY). These plugin guards do not compare the stored route column to the request route. They look up the row by (bucket, key) and compare scope.

Before an operation runs, @dimah-s3/db resolves the active session scope through resolveScope(request):

---

Lifecycle behavior by operationCopy Anchor Link

• Upload — Upserts a pending row on presign / multipart init.
• Upload confirmation — Verifies pending state (or refreshes an already-active overwrite), records verified contentLength from HeadObject, and returns the active row.
• Download — Enforces that the object has status: "active" and matches the caller's scope.
• Delete — Runs S3 DeleteObjectCommand, then updates row status to "deleted" (soft delete) or removes it (hard delete).

Frequently asked questionsCopy Anchor Link