catalog / services

File Upload Service

Multipart uploads, validation, storage backends and signed URLs.

13 capabilities 2 sections reference specification

Build against it

# give your agent the catalog — no account, no install
claude mcp add provespec -- npx -y provespec-mcp

# then, from any agent session
spec_get(slug: "file-uploader-service")                → the capability tree
spec_checklist(slug: "file-uploader-service")          → the questions to answer
spec_grade(slug: "file-uploader-service", grades: [...])  → parity % + the gap list

# or just fetch it
curl https://provespec.com/catalog/file-uploader-service/spec.json

Grade every capability below as yes · partial · no · na, with a file reference as evidence. Whatever you leave ungraded counts as missing — the gap list is the work queue.

Or just paste this to your agent

Use the ProveSpec MCP server. Fetch the "file-uploader-service" spec with
spec_get, then walk spec_checklist and grade this repository against it —
one verdict per capability, each with a file reference as the note.
Call spec_grade with the results and give me the gap list as the plan.

If the server is not registered, add it first:
  claude mcp add provespec -- npx -y provespec-mcp

The specification

AI 10

Upload
  • Multipart upload endpoint POST /api/files size limit enforced with clear error
  • Resumable/chunked upload resume after connection loss
  • Type allowlist + content sniffing extension alone not trusted
  • Deduplication by content hash SHA-256 same bytes stored once
Files
  • Download with correct headers content-type, disposition range requests supported
  • Expiring share links signed URL revocable
  • Delete with grace period purge job after retention
Images
  • Thumbnail generation async sizes configurable
Ops
  • Storage quota per owner clear over-quota error
  • Metadata listing API paginated name, size, hash, created

UI 3

Upload
  • Drag-and-drop zone with progress per-file bars cancel per file
Files
  • File list with previews and actions copy link, delete
  • Quota usage indicator
Download spec.json All 53 specs