Replacing, Removing and Cleanup
How storage keeps owners on a working image through failures and races, and how deleted owners' images and leftovers are cleaned up.
Replacing
A new upload is stored under a new key first. The owner column moves to it only if it still holds the URL read at the start (a compare-and-set), then the old object is deleted. So:
- R2 fails:
500, the owner keeps the old image. - Two uploads at once: one wins; the other deletes its own object and gets
409 conflict. - The owner was deleted meanwhile: the new object is deleted,
404 not_found. - The old object can't be deleted: still
200; a warning is logged with its key and the sweep removes it.
Removing
DELETE /api/uploads/<kind> clears the column first, then deletes the object, so the owner never points at a missing file. Repeating it, or removing when there is no image, answers 204.
When an Owner Is Deleted
requestPurge (apps/web/lib/cleanup.server.ts), which the kit already calls when an organization or an account is deleted, also enqueues a storage.purge-owner outbox job in the same transaction: every kind's files for that owner are deleted a page at a time, and the count is logged. It never purges an owner that still exists, and a rerun deletes nothing. In delete code you write yourself, call requestPurge in the transaction that deletes the owner (Purge Targets): that one call purges both their rows and their files. The file purge runs on the outbox's next sweep (within about 5 minutes).
The Weekly Sweep
Every Sunday at 04:00 UTC (apps/web/crons/storage-sweep.ts), one storage.sweep job per kind lists its objects and deletes those older than a day that no owner column points at: leftovers of failed deletes. Objects in use, under a day old (an upload may still be writing its owner), or under keys storage never writes are kept. Long listings hand over to a follow-up job; counts are logged.
Images are personal data when they show a face: with the purge and the sweep, a deleted owner's or replaced image is gone from R2 within about 8 days at most.