fix: allow saving media after a focal point change

[InnerDesires]

Problem

Saving a media document after changing its focal point in the admin image editor failed with a generic Something went wrong. toast. The underlying response was a 500:

ERROR: There was an error while uploading files corresponding to the collection media with filename image-hero1-1.webp:
ERROR: Vercel Blob: This blob already exists, use `allowOverwrite: true` if you want to overwrite it.
    at uploadFile → Object.handleUpload → updateDocument → updateByIDOperation
PATCH /api/media/5?...uploadEdits[focalPoint][x]=65&uploadEdits[focalPoint][y]=20  500

Root cause

Not a focal-point bug — a blob re-upload bug.

The admin sends uploadEdits[crop] alongside the focal point on save, which makes Payload regenerate the original file plus all 7 image sizes and re-upload them under the same filenames. @payloadcms/storage-vercel-blob@3.86.0 calls @vercel/blob's put() without allowOverwrite, and that defaults to false in @vercel/blob v2 — so every re-upload was rejected.

This affected production as well, since prod also has BLOB_READ_WRITE_TOKEN set.

Fix

Upstream fixed this in 3.87.0 by passing allowOverwrite: true in uploadFile.ts. Version 3.86.0 exposes no config option to set it, so the whole Payload suite is bumped 3.86.0 → 3.87.0 — the storage adapter pins payload exactly as a peer dependency, so a partial bump would drift.

src/payload-types.ts and src/app/(payload)/admin/importMap.js are regenerated output. The type churn is purely structural (MediaBlock/ArchiveBlock hoisted from inline definitions to named interfaces, payload-mcp-api-keys reordered) — no interfaces or fields added or removed.

No migration needed

Verified by diffing the published tarballs for both versions:

• payload/dist/database — identical
• @payloadcms/db-postgres/dist — byte-identical

Verification

• Reproduced the 500 before the fix, in the real admin UI.
• After the fix, the full admin flow (open editor → set X/Y → Застосувати зміни → Зберегти) returns 200, and re-reading /api/media/5 confirms focalX/focalY persisted 65/20 → 25/80 with sizes regenerated under the same filenames.
• Fresh upload still works (201, 7 sizes generated), and a focal edit on that new doc also returns 200.
• pnpm exec tsc --noEmit — clean
• pnpm lint — clean
• pnpm test:int — 95/95 passing
• pnpm build — succeeds

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
learning-platform	Ignored		Aug 6, 2026 3:52pm