Introduction

@dimah-s3/db is an optional plugin for dimahS3. It keeps your database aligned with S3 — who owns each file, whether it is still uploading, and when it was removed — without custom SQL on every endpoint.

dimah-s3 works fine without a database. Add this plugin when you need ownership checks, usage totals, file listings, or resumable multipart uploads backed by metadata.

What the plugin does

• Tracks objects — writes and updates a row on presign, confirm, and delete
• Enforces ownership — each file belongs to a scope you define (e.g. user:123); download and delete reject access from another scope
• Lists files — query by scope on the server and in the browser
• Handles multipart — records in-progress uploads so you can resume or purge stale ones

Auth, quotas, and business rules stay in your hooks. The plugin only manages object metadata and scope isolation.

Lifecycle

Each object moves through three statuses:

Typical flow: pending → active → deleted. Aborted multipart uploads and purge clean up rows that never reached active.

Next steps