@inoo-ch/payload-image-optimizer 1.6.1 → 1.7.1

package/AGENT_DOCS.md

@@ -60,6 +60,7 @@ imageOptimizer({
   generateThumbHash: true,                          // generate blur placeholders
   replaceOriginal: true,                            // convert main file to primary format
   clientOptimization: true,                         // pre-resize in browser before upload
+  uniqueFileNames: false,                           // replace filenames with UUIDs
   disabled: false,                                  // keep fields but skip all processing
 })
 ```
@@ -70,6 +71,7 @@ imageOptimizer({
 | `formats` | `{ format: 'webp' \| 'avif', quality: number }[]` | `[{ format: 'webp', quality: 80 }]` | Output formats to generate. |
 | `maxDimensions` | `{ width: number, height: number }` | `{ width: 2560, height: 2560 }` | Maximum image dimensions (fit inside, no upscaling). |
 | `stripMetadata` | `boolean` | `true` | Strip EXIF, ICC, XMP metadata. |
+| `uniqueFileNames` | `boolean` | `false` | Replace filenames with UUIDs. Prevents Vercel Blob collisions and hides original filenames. |
 | `generateThumbHash` | `boolean` | `true` | Generate ThumbHash blur placeholder. |
 | `replaceOriginal` | `boolean` | `true` | Replace the original file with the primary format. |
 | `clientOptimization` | `boolean` | `true` | Pre-resize images in browser via Canvas API before upload. Reduces upload size 90%+ for large images. |
@@ -97,6 +99,7 @@ collections: {
 When an image is uploaded to an optimized collection:
 
 1. **`beforeChange` hook** (in-memory processing):
+   - If `uniqueFileNames: true`: renames file to UUID (e.g., `photo.jpg` → `a1b2c3d4.jpg`)
    - Auto-rotates based on EXIF orientation
    - Resizes to fit within `maxDimensions`
    - Strips metadata (if enabled)
@@ -119,6 +122,7 @@ When an image is uploaded to an optimized collection:
 | File | Naming Pattern | Example |
 |------|---------------|---------|
 | Main file (replaceOriginal) | `{name}.{primaryFormat}` | `photo.webp` |
+| Main file (uniqueFileNames) | `{uuid}.{primaryFormat}` | `a1b2c3d4-5e6f-7890.webp` |
 | Variant files | `{name}-optimized.{format}` | `photo-optimized.avif` |
 
 ### Format Behavior
@@ -462,6 +466,30 @@ vercelBlobStorage({
 })
 ```
 
+### "This blob already exists" error
+
+When `replaceOriginal: true` (default), the plugin changes filenames (e.g., `photo.jpg` → `photo.webp`). If a blob with that name already exists, Vercel Blob throws an error because `@payloadcms/storage-vercel-blob` does not pass `allowOverwrite` to the Vercel Blob SDK.
+
+**Fix (recommended):** Enable `uniqueFileNames` in the plugin config — replaces filenames with UUIDs before the storage adapter sees them. This fixes both initial uploads AND regeneration (the regeneration task also generates a new UUID for cloud storage re-uploads):
+
+```ts
+imageOptimizer({
+  collections: { media: true },
+  uniqueFileNames: true, // photo.jpg → a1b2c3d4-5e6f-7890-abcd-ef1234567890.webp
+})
+```
+
+**Alternative:** Set `addRandomSuffix: true` on the storage adapter (only fixes initial uploads, not regeneration):
+
+```ts
+vercelBlobStorage({
+  collections: { media: true },
+  token: process.env.BLOB_READ_WRITE_TOKEN,
+  clientUploads: true,
+  addRandomSuffix: true,
+})
+```
+
 ## Full Example
 
 ```ts

package/README.md

@@ -102,6 +102,7 @@ imageOptimizer({
 | `maxDimensions` | `{ width: number, height: number }` | `{ width: 2560, height: 2560 }` | Maximum image dimensions. Images are resized to fit within these bounds. |
 | `generateThumbHash` | `boolean` | `true` | Generate ThumbHash blur placeholders for instant image previews. |
 | `stripMetadata` | `boolean` | `true` | Remove EXIF and other metadata from images. |
+| `uniqueFileNames` | `boolean` | `false` | Replace filenames with UUIDs (e.g., `photo.jpg` → `a1b2c3d4.webp`). Prevents Vercel Blob "already exists" errors on uploads and regeneration. |
 | `clientOptimization` | `boolean` | `true` | Pre-resize images in the browser before upload using Canvas API. Reduces upload size by up to 90% for large images. |
 | `disabled` | `boolean` | `false` | Disable optimization while keeping schema fields intact. |
 
@@ -183,6 +184,32 @@ vercelBlobStorage({
 
 With `clientUploads: true`, files upload directly from the browser to Vercel Blob (up to 5TB) and the server only handles the small JSON metadata payload. This eliminates body size limit errors regardless of file size.
 
+#### "This blob already exists" error
+
+When `replaceOriginal: true` (default), the plugin changes filenames during upload (e.g., `photo.jpg` → `photo.webp`). If a blob with that name already exists, Vercel Blob throws an error because `@payloadcms/storage-vercel-blob` does not pass [`allowOverwrite`](https://vercel.com/docs/vercel-blob#overwriting-blobs) to the Vercel Blob SDK.
+
+**Fix:** Enable `uniqueFileNames` in the plugin config — replaces original filenames with UUIDs before the storage adapter sees them:
+
+```ts
+imageOptimizer({
+  collections: { media: true },
+  uniqueFileNames: true, // photo.jpg → a1b2c3d4-5e6f-7890-abcd-ef1234567890.webp
+})
+```
+
+This prevents collisions on both initial uploads and bulk regeneration (the regeneration task also generates a new UUID for cloud storage re-uploads). Payload stores the full URL in the database, so UUID filenames are transparent to your application.
+
+**Alternative:** If you prefer to keep original filenames, set `addRandomSuffix: true` on the storage adapter instead:
+
+```ts
+vercelBlobStorage({
+  collections: { media: true },
+  token: process.env.BLOB_READ_WRITE_TOKEN,
+  clientUploads: true,
+  addRandomSuffix: true,
+})
+```
+
 ## How It Differs from Payload's Default Image Handling
 
 Payload CMS ships with [sharp](https://sharp.pixelplumbing.com/) built-in and can resize images and generate sizes on upload. This plugin **does not double-process your images** — it intercepts the raw upload in a `beforeChange` hook *before* Payload's own sharp pipeline runs, and writes the optimized buffer back to `req.file.data`. When Payload's built-in `uploadFiles` step kicks in to generate your configured sizes, it works from the already-optimized file, not the raw original.

package/dist/defaults.js

@@ -14,7 +14,8 @@ export const resolveConfig = (config)=>({
             height: 2560
         },
         replaceOriginal: config.replaceOriginal ?? true,
-        stripMetadata: config.stripMetadata ?? true
+        stripMetadata: config.stripMetadata ?? true,
+        uniqueFileNames: config.uniqueFileNames ?? false
     });
 export const resolveCollectionConfig = (resolvedConfig, collectionSlug)=>{
     const collectionValue = resolvedConfig.collections[collectionSlug];

package/dist/defaults.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/defaults.ts"],"sourcesContent":["import type { CollectionSlug } from 'payload'\n\nimport type { ImageOptimizerConfig, ResolvedCollectionOptimizerConfig, ResolvedImageOptimizerConfig } from './types.js'\n\nexport const resolveConfig = (config: ImageOptimizerConfig): ResolvedImageOptimizerConfig => ({\n  clientOptimization: config.clientOptimization ?? true,\n  collections: config.collections,\n  disabled: config.disabled ?? false,\n  formats: config.formats ?? [\n    { format: 'webp', quality: 80 },\n  ],\n  generateThumbHash: config.generateThumbHash ?? true,\n  maxDimensions: config.maxDimensions ?? { width: 2560, height: 2560 },\n  replaceOriginal: config.replaceOriginal ?? true,\n  stripMetadata: config.stripMetadata ?? true,\n})\n\nexport const resolveCollectionConfig = (\n  resolvedConfig: ResolvedImageOptimizerConfig,\n  collectionSlug: string,\n): ResolvedCollectionOptimizerConfig => {\n  const collectionValue = resolvedConfig.collections[collectionSlug as CollectionSlug]\n\n  if (!collectionValue || collectionValue === true) {\n    return {\n      formats: resolvedConfig.formats,\n      maxDimensions: resolvedConfig.maxDimensions,\n      replaceOriginal: resolvedConfig.replaceOriginal,\n    }\n  }\n\n  return {\n    formats: collectionValue.formats ?? resolvedConfig.formats,\n    maxDimensions: collectionValue.maxDimensions ?? resolvedConfig.maxDimensions,\n    replaceOriginal: collectionValue.replaceOriginal ?? resolvedConfig.replaceOriginal,\n  }\n}\n"],"names":["resolveConfig","config","clientOptimization","collections","disabled","formats","format","quality","generateThumbHash","maxDimensions","width","height","replaceOriginal","stripMetadata","resolveCollectionConfig","resolvedConfig","collectionSlug","collectionValue"],"mappings":"AAIA,OAAO,MAAMA,gBAAgB,CAACC,SAAgE,CAAA;QAC5FC,oBAAoBD,OAAOC,kBAAkB,IAAI;QACjDC,aAAaF,OAAOE,WAAW;QAC/BC,UAAUH,OAAOG,QAAQ,IAAI;QAC7BC,SAASJ,OAAOI,OAAO,IAAI;YACzB;gBAAEC,QAAQ;gBAAQC,SAAS;YAAG;SAC/B;QACDC,mBAAmBP,OAAOO,iBAAiB,IAAI;QAC/CC,eAAeR,OAAOQ,aAAa,IAAI;YAAEC,OAAO;YAAMC,QAAQ;QAAK;QACnEC,iBAAiBX,OAAOW,eAAe,IAAI;QAC3CC,eAAeZ,OAAOY,aAAa,IAAI;IACzC,CAAA,EAAE;AAEF,OAAO,MAAMC,0BAA0B,CACrCC,gBACAC;IAEA,MAAMC,kBAAkBF,eAAeZ,WAAW,CAACa,eAAiC;IAEpF,IAAI,CAACC,mBAAmBA,oBAAoB,MAAM;QAChD,OAAO;YACLZ,SAASU,eAAeV,OAAO;YAC/BI,eAAeM,eAAeN,aAAa;YAC3CG,iBAAiBG,eAAeH,eAAe;QACjD;IACF;IAEA,OAAO;QACLP,SAASY,gBAAgBZ,OAAO,IAAIU,eAAeV,OAAO;QAC1DI,eAAeQ,gBAAgBR,aAAa,IAAIM,eAAeN,aAAa;QAC5EG,iBAAiBK,gBAAgBL,eAAe,IAAIG,eAAeH,eAAe;IACpF;AACF,EAAC"}
+{"version":3,"sources":["../src/defaults.ts"],"sourcesContent":["import type { CollectionSlug } from 'payload'\n\nimport type { ImageOptimizerConfig, ResolvedCollectionOptimizerConfig, ResolvedImageOptimizerConfig } from './types.js'\n\nexport const resolveConfig = (config: ImageOptimizerConfig): ResolvedImageOptimizerConfig => ({\n  clientOptimization: config.clientOptimization ?? true,\n  collections: config.collections,\n  disabled: config.disabled ?? false,\n  formats: config.formats ?? [\n    { format: 'webp', quality: 80 },\n  ],\n  generateThumbHash: config.generateThumbHash ?? true,\n  maxDimensions: config.maxDimensions ?? { width: 2560, height: 2560 },\n  replaceOriginal: config.replaceOriginal ?? true,\n  stripMetadata: config.stripMetadata ?? true,\n  uniqueFileNames: config.uniqueFileNames ?? false,\n})\n\nexport const resolveCollectionConfig = (\n  resolvedConfig: ResolvedImageOptimizerConfig,\n  collectionSlug: string,\n): ResolvedCollectionOptimizerConfig => {\n  const collectionValue = resolvedConfig.collections[collectionSlug as CollectionSlug]\n\n  if (!collectionValue || collectionValue === true) {\n    return {\n      formats: resolvedConfig.formats,\n      maxDimensions: resolvedConfig.maxDimensions,\n      replaceOriginal: resolvedConfig.replaceOriginal,\n    }\n  }\n\n  return {\n    formats: collectionValue.formats ?? resolvedConfig.formats,\n    maxDimensions: collectionValue.maxDimensions ?? resolvedConfig.maxDimensions,\n    replaceOriginal: collectionValue.replaceOriginal ?? resolvedConfig.replaceOriginal,\n  }\n}\n"],"names":["resolveConfig","config","clientOptimization","collections","disabled","formats","format","quality","generateThumbHash","maxDimensions","width","height","replaceOriginal","stripMetadata","uniqueFileNames","resolveCollectionConfig","resolvedConfig","collectionSlug","collectionValue"],"mappings":"AAIA,OAAO,MAAMA,gBAAgB,CAACC,SAAgE,CAAA;QAC5FC,oBAAoBD,OAAOC,kBAAkB,IAAI;QACjDC,aAAaF,OAAOE,WAAW;QAC/BC,UAAUH,OAAOG,QAAQ,IAAI;QAC7BC,SAASJ,OAAOI,OAAO,IAAI;YACzB;gBAAEC,QAAQ;gBAAQC,SAAS;YAAG;SAC/B;QACDC,mBAAmBP,OAAOO,iBAAiB,IAAI;QAC/CC,eAAeR,OAAOQ,aAAa,IAAI;YAAEC,OAAO;YAAMC,QAAQ;QAAK;QACnEC,iBAAiBX,OAAOW,eAAe,IAAI;QAC3CC,eAAeZ,OAAOY,aAAa,IAAI;QACvCC,iBAAiBb,OAAOa,eAAe,IAAI;IAC7C,CAAA,EAAE;AAEF,OAAO,MAAMC,0BAA0B,CACrCC,gBACAC;IAEA,MAAMC,kBAAkBF,eAAeb,WAAW,CAACc,eAAiC;IAEpF,IAAI,CAACC,mBAAmBA,oBAAoB,MAAM;QAChD,OAAO;YACLb,SAASW,eAAeX,OAAO;YAC/BI,eAAeO,eAAeP,aAAa;YAC3CG,iBAAiBI,eAAeJ,eAAe;QACjD;IACF;IAEA,OAAO;QACLP,SAASa,gBAAgBb,OAAO,IAAIW,eAAeX,OAAO;QAC1DI,eAAeS,gBAAgBT,aAAa,IAAIO,eAAeP,aAAa;QAC5EG,iBAAiBM,gBAAgBN,eAAe,IAAII,eAAeJ,eAAe;IACpF;AACF,EAAC"}

package/dist/hooks/beforeChange.js

@@ -1,3 +1,4 @@
+import crypto from 'crypto';
 import path from 'path';
 import { resolveCollectionConfig } from '../defaults.js';
 import { convertFormat, generateThumbHash, stripAndResize } from '../processing/index.js';
@@ -6,6 +7,15 @@ export const createBeforeChangeHook = (resolvedConfig, collectionSlug)=>{
     return async ({ context, data, req })=>{
         if (context?.imageOptimizer_skip) return data;
         if (!req.file || !req.file.data || !req.file.mimetype?.startsWith('image/')) return data;
+        // Rename file to UUID before any processing, so the storage adapter
+        // never sees the original filename. Prevents Vercel Blob "already exists"
+        // errors and avoids leaking original filenames to storage.
+        if (resolvedConfig.uniqueFileNames) {
+            const ext = path.extname(req.file.name);
+            const uuid = crypto.randomUUID();
+            req.file.name = `${uuid}${ext}`;
+            data.filename = req.file.name;
+        }
         const originalSize = req.file.data.length;
         const perCollectionConfig = resolveCollectionConfig(resolvedConfig, collectionSlug);
         // Process in memory: strip EXIF, resize, generate blur

package/dist/hooks/beforeChange.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/beforeChange.ts"],"sourcesContent":["import path from 'path'\nimport type { CollectionBeforeChangeHook } from 'payload'\n\nimport type { ResolvedImageOptimizerConfig } from '../types.js'\nimport { resolveCollectionConfig } from '../defaults.js'\nimport { convertFormat, generateThumbHash, stripAndResize } from '../processing/index.js'\nimport { isCloudStorage } from '../utilities/storage.js'\n\nexport const createBeforeChangeHook = (\n  resolvedConfig: ResolvedImageOptimizerConfig,\n  collectionSlug: string,\n): CollectionBeforeChangeHook => {\n  return async ({ context, data, req }) => {\n    if (context?.imageOptimizer_skip) return data\n\n    if (!req.file || !req.file.data || !req.file.mimetype?.startsWith('image/')) return data\n\n    const originalSize = req.file.data.length\n\n    const perCollectionConfig = resolveCollectionConfig(resolvedConfig, collectionSlug)\n\n    // Process in memory: strip EXIF, resize, generate blur\n    const processed = await stripAndResize(\n      req.file.data,\n      perCollectionConfig.maxDimensions,\n      resolvedConfig.stripMetadata,\n    )\n\n    let finalBuffer = processed.buffer\n    let finalSize = processed.size\n\n    if (perCollectionConfig.replaceOriginal && perCollectionConfig.formats.length > 0) {\n      // Convert to primary format (first in the formats array)\n      const primaryFormat = perCollectionConfig.formats[0]\n      const converted = await convertFormat(processed.buffer, primaryFormat.format, primaryFormat.quality)\n\n      finalBuffer = converted.buffer\n      finalSize = converted.size\n\n      // Update filename and mimeType so Payload stores the correct metadata\n      const originalFilename = data.filename || req.file.name || ''\n      const newFilename = `${path.parse(originalFilename).name}.${primaryFormat.format}`\n      context.imageOptimizer_originalFilename = originalFilename\n      data.filename = newFilename\n      data.mimeType = converted.mimeType\n      data.filesize = finalSize\n    }\n\n    // Determine if async work (variant generation job) is needed after create.\n    // If not, set status to 'complete' now so afterChange doesn't need a separate\n    // update() call — which fails with 404 on MongoDB due to transaction isolation\n    // when cloud storage adapters are involved.\n    const collectionConfig = req.payload.collections[collectionSlug as keyof typeof req.payload.collections].config\n    const cloudStorage = isCloudStorage(collectionConfig)\n    const needsAsyncJob = !cloudStorage && perCollectionConfig.formats.length > 0 && !(perCollectionConfig.replaceOriginal && perCollectionConfig.formats.length <= 1)\n\n    data.imageOptimizer = {\n      originalSize,\n      optimizedSize: finalSize,\n      status: needsAsyncJob ? 'pending' : 'complete',\n      variants: needsAsyncJob ? undefined : [],\n      error: null,\n    }\n\n    if (!needsAsyncJob) {\n      context.imageOptimizer_statusResolved = true\n    }\n\n    if (resolvedConfig.generateThumbHash) {\n      data.imageOptimizer.thumbHash = await generateThumbHash(finalBuffer)\n    }\n\n    // Write processed buffer back to req.file so cloud storage adapters\n    // (which read req.file in their afterChange hook) upload the optimized version.\n    // Payload's own uploadFiles step does NOT re-read req.file.data for its local\n    // disk write, so we also store the buffer in context for our afterChange hook\n    // to overwrite the local file when local storage is enabled.\n    req.file.data = finalBuffer\n    req.file.size = finalSize\n    if (perCollectionConfig.replaceOriginal && perCollectionConfig.formats.length > 0) {\n      req.file.name = data.filename\n      req.file.mimetype = data.mimeType\n    }\n    context.imageOptimizer_processedBuffer = finalBuffer\n    context.imageOptimizer_hasUpload = true\n\n    return data\n  }\n}\n"],"names":["path","resolveCollectionConfig","convertFormat","generateThumbHash","stripAndResize","isCloudStorage","createBeforeChangeHook","resolvedConfig","collectionSlug","context","data","req","imageOptimizer_skip","file","mimetype","startsWith","originalSize","length","perCollectionConfig","processed","maxDimensions","stripMetadata","finalBuffer","buffer","finalSize","size","replaceOriginal","formats","primaryFormat","converted","format","quality","originalFilename","filename","name","newFilename","parse","imageOptimizer_originalFilename","mimeType","filesize","collectionConfig","payload","collections","config","cloudStorage","needsAsyncJob","imageOptimizer","optimizedSize","status","variants","undefined","error","imageOptimizer_statusResolved","thumbHash","imageOptimizer_processedBuffer","imageOptimizer_hasUpload"],"mappings":"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"}
+{"version":3,"sources":["../../src/hooks/beforeChange.ts"],"sourcesContent":["import crypto from 'crypto'\nimport path from 'path'\nimport type { CollectionBeforeChangeHook } from 'payload'\n\nimport type { ResolvedImageOptimizerConfig } from '../types.js'\nimport { resolveCollectionConfig } from '../defaults.js'\nimport { convertFormat, generateThumbHash, stripAndResize } from '../processing/index.js'\nimport { isCloudStorage } from '../utilities/storage.js'\n\nexport const createBeforeChangeHook = (\n  resolvedConfig: ResolvedImageOptimizerConfig,\n  collectionSlug: string,\n): CollectionBeforeChangeHook => {\n  return async ({ context, data, req }) => {\n    if (context?.imageOptimizer_skip) return data\n\n    if (!req.file || !req.file.data || !req.file.mimetype?.startsWith('image/')) return data\n\n    // Rename file to UUID before any processing, so the storage adapter\n    // never sees the original filename. Prevents Vercel Blob \"already exists\"\n    // errors and avoids leaking original filenames to storage.\n    if (resolvedConfig.uniqueFileNames) {\n      const ext = path.extname(req.file.name)\n      const uuid = crypto.randomUUID()\n      req.file.name = `${uuid}${ext}`\n      data.filename = req.file.name\n    }\n\n    const originalSize = req.file.data.length\n\n    const perCollectionConfig = resolveCollectionConfig(resolvedConfig, collectionSlug)\n\n    // Process in memory: strip EXIF, resize, generate blur\n    const processed = await stripAndResize(\n      req.file.data,\n      perCollectionConfig.maxDimensions,\n      resolvedConfig.stripMetadata,\n    )\n\n    let finalBuffer = processed.buffer\n    let finalSize = processed.size\n\n    if (perCollectionConfig.replaceOriginal && perCollectionConfig.formats.length > 0) {\n      // Convert to primary format (first in the formats array)\n      const primaryFormat = perCollectionConfig.formats[0]\n      const converted = await convertFormat(processed.buffer, primaryFormat.format, primaryFormat.quality)\n\n      finalBuffer = converted.buffer\n      finalSize = converted.size\n\n      // Update filename and mimeType so Payload stores the correct metadata\n      const originalFilename = data.filename || req.file.name || ''\n      const newFilename = `${path.parse(originalFilename).name}.${primaryFormat.format}`\n      context.imageOptimizer_originalFilename = originalFilename\n      data.filename = newFilename\n      data.mimeType = converted.mimeType\n      data.filesize = finalSize\n    }\n\n    // Determine if async work (variant generation job) is needed after create.\n    // If not, set status to 'complete' now so afterChange doesn't need a separate\n    // update() call — which fails with 404 on MongoDB due to transaction isolation\n    // when cloud storage adapters are involved.\n    const collectionConfig = req.payload.collections[collectionSlug as keyof typeof req.payload.collections].config\n    const cloudStorage = isCloudStorage(collectionConfig)\n    const needsAsyncJob = !cloudStorage && perCollectionConfig.formats.length > 0 && !(perCollectionConfig.replaceOriginal && perCollectionConfig.formats.length <= 1)\n\n    data.imageOptimizer = {\n      originalSize,\n      optimizedSize: finalSize,\n      status: needsAsyncJob ? 'pending' : 'complete',\n      variants: needsAsyncJob ? undefined : [],\n      error: null,\n    }\n\n    if (!needsAsyncJob) {\n      context.imageOptimizer_statusResolved = true\n    }\n\n    if (resolvedConfig.generateThumbHash) {\n      data.imageOptimizer.thumbHash = await generateThumbHash(finalBuffer)\n    }\n\n    // Write processed buffer back to req.file so cloud storage adapters\n    // (which read req.file in their afterChange hook) upload the optimized version.\n    // Payload's own uploadFiles step does NOT re-read req.file.data for its local\n    // disk write, so we also store the buffer in context for our afterChange hook\n    // to overwrite the local file when local storage is enabled.\n    req.file.data = finalBuffer\n    req.file.size = finalSize\n    if (perCollectionConfig.replaceOriginal && perCollectionConfig.formats.length > 0) {\n      req.file.name = data.filename\n      req.file.mimetype = data.mimeType\n    }\n    context.imageOptimizer_processedBuffer = finalBuffer\n    context.imageOptimizer_hasUpload = true\n\n    return data\n  }\n}\n"],"names":["crypto","path","resolveCollectionConfig","convertFormat","generateThumbHash","stripAndResize","isCloudStorage","createBeforeChangeHook","resolvedConfig","collectionSlug","context","data","req","imageOptimizer_skip","file","mimetype","startsWith","uniqueFileNames","ext","extname","name","uuid","randomUUID","filename","originalSize","length","perCollectionConfig","processed","maxDimensions","stripMetadata","finalBuffer","buffer","finalSize","size","replaceOriginal","formats","primaryFormat","converted","format","quality","originalFilename","newFilename","parse","imageOptimizer_originalFilename","mimeType","filesize","collectionConfig","payload","collections","config","cloudStorage","needsAsyncJob","imageOptimizer","optimizedSize","status","variants","undefined","error","imageOptimizer_statusResolved","thumbHash","imageOptimizer_processedBuffer","imageOptimizer_hasUpload"],"mappings":"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"}

package/dist/tasks/regenerateDocument.js

@@ -1,3 +1,4 @@
+import crypto from 'crypto';
 import fs from 'fs/promises';
 import path from 'path';
 import { resolveCollectionConfig } from '../defaults.js';
@@ -52,6 +53,12 @@ export const createRegenerateDocumentHandler = (resolvedConfig)=>{
             if (cloudStorage) {
                 // Cloud storage: re-upload the optimized file via Payload's update API.
                 // This triggers the cloud adapter's afterChange hook which uploads to cloud.
+                // When uniqueFileNames is enabled, generate a new UUID filename to avoid
+                // Vercel Blob "already exists" errors (the adapter doesn't support allowOverwrite).
+                if (resolvedConfig.uniqueFileNames) {
+                    const ext = path.extname(newFilename);
+                    newFilename = `${crypto.randomUUID()}${ext}`;
+                }
                 const updateData = {
                     imageOptimizer: {
                         originalSize,

package/dist/tasks/regenerateDocument.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tasks/regenerateDocument.ts"],"sourcesContent":["import fs from 'fs/promises'\nimport path from 'path'\n\nimport type { CollectionSlug } from 'payload'\n\nimport type { ResolvedImageOptimizerConfig } from '../types.js'\nimport { resolveCollectionConfig } from '../defaults.js'\nimport { stripAndResize, generateThumbHash, convertFormat } from '../processing/index.js'\nimport { resolveStaticDir } from '../utilities/resolveStaticDir.js'\nimport { fetchFileBuffer, isCloudStorage } from '../utilities/storage.js'\n\nexport const createRegenerateDocumentHandler = (resolvedConfig: ResolvedImageOptimizerConfig) => {\n  return async ({ input, req }: { input: { collectionSlug: string; docId: string }; req: any }) => {\n    try {\n      const doc = await req.payload.findByID({\n        collection: input.collectionSlug as CollectionSlug,\n        id: input.docId,\n      })\n\n      // Skip non-image documents\n      if (!doc.mimeType || !doc.mimeType.startsWith('image/')) {\n        return { output: { status: 'skipped', reason: 'not-image' } }\n      }\n\n      const collectionConfig = req.payload.collections[input.collectionSlug as keyof typeof req.payload.collections].config\n      const cloudStorage = isCloudStorage(collectionConfig)\n\n      const fileBuffer = await fetchFileBuffer(doc, collectionConfig)\n      const originalSize = fileBuffer.length\n      const perCollectionConfig = resolveCollectionConfig(resolvedConfig, input.collectionSlug)\n\n      // Sanitize filename to prevent path traversal\n      const safeFilename = path.basename(doc.filename)\n\n      // Step 1: Strip metadata + resize\n      const processed = await stripAndResize(\n        fileBuffer,\n        perCollectionConfig.maxDimensions,\n        resolvedConfig.stripMetadata,\n      )\n\n      let mainBuffer = processed.buffer\n      let mainSize = processed.size\n      let newFilename = safeFilename\n      let newMimeType: string | undefined\n\n      // Step 1b: If replaceOriginal, convert main file to primary format\n      if (perCollectionConfig.replaceOriginal && perCollectionConfig.formats.length > 0) {\n        const primaryFormat = perCollectionConfig.formats[0]\n        const converted = await convertFormat(processed.buffer, primaryFormat.format, primaryFormat.quality)\n        mainBuffer = converted.buffer\n        mainSize = converted.size\n        newFilename = `${path.parse(safeFilename).name}.${primaryFormat.format}`\n        newMimeType = converted.mimeType\n      }\n\n      // Step 2: Generate ThumbHash\n      let thumbHash: string | undefined\n      if (resolvedConfig.generateThumbHash) {\n        thumbHash = await generateThumbHash(mainBuffer)\n      }\n\n      // Step 3: Store the optimized file\n      const variants: Array<{\n        filename: string\n        filesize: number\n        format: string\n        height: number\n        mimeType: string\n        url: string\n        width: number\n      }> = []\n\n      if (cloudStorage) {\n        // Cloud storage: re-upload the optimized file via Payload's update API.\n        // This triggers the cloud adapter's afterChange hook which uploads to cloud.\n        const updateData: Record<string, any> = {\n          imageOptimizer: {\n            originalSize,\n            optimizedSize: mainSize,\n            status: 'complete',\n            thumbHash,\n            variants: [],\n            error: null,\n          },\n        }\n\n        if (newFilename !== safeFilename) {\n          updateData.filename = newFilename\n          updateData.filesize = mainSize\n          updateData.mimeType = newMimeType\n        }\n\n        await req.payload.update({\n          collection: input.collectionSlug as CollectionSlug,\n          id: input.docId,\n          data: updateData,\n          file: {\n            data: mainBuffer,\n            mimetype: newMimeType || doc.mimeType,\n            name: newFilename,\n            size: mainSize,\n          },\n          context: { imageOptimizer_skip: true },\n        })\n      } else {\n        // Local storage: write files to disk\n        const staticDir = resolveStaticDir(collectionConfig)\n        const newFilePath = path.join(staticDir, newFilename)\n        await fs.writeFile(newFilePath, mainBuffer)\n\n        // Clean up old file if filename changed\n        if (newFilename !== safeFilename) {\n          const oldFilePath = path.join(staticDir, safeFilename)\n          await fs.unlink(oldFilePath).catch(() => {})\n        }\n\n        // Generate variant files (local storage only)\n        const formatsToGenerate = perCollectionConfig.replaceOriginal && perCollectionConfig.formats.length > 0\n          ? perCollectionConfig.formats.slice(1)\n          : perCollectionConfig.formats\n\n        for (const format of formatsToGenerate) {\n          const result = await convertFormat(mainBuffer, format.format, format.quality)\n          const variantFilename = `${path.parse(newFilename).name}-optimized.${format.format}`\n          await fs.writeFile(path.join(staticDir, variantFilename), result.buffer)\n\n          variants.push({\n            format: format.format,\n            filename: variantFilename,\n            filesize: result.size,\n            width: result.width,\n            height: result.height,\n            mimeType: result.mimeType,\n            url: `/api/${input.collectionSlug}/file/${variantFilename}`,\n          })\n        }\n\n        // Update the document with optimization data\n        const updateData: Record<string, any> = {\n          imageOptimizer: {\n            originalSize,\n            optimizedSize: mainSize,\n            status: 'complete',\n            thumbHash,\n            variants,\n            error: null,\n          },\n        }\n\n        if (newFilename !== safeFilename) {\n          updateData.filename = newFilename\n          updateData.filesize = mainSize\n          updateData.mimeType = newMimeType\n        }\n\n        await req.payload.update({\n          collection: input.collectionSlug as CollectionSlug,\n          id: input.docId,\n          data: updateData,\n          context: { imageOptimizer_skip: true },\n        })\n      }\n\n      return { output: { status: 'complete' } }\n    } catch (err) {\n      const errorMessage = err instanceof Error ? err.message : String(err)\n\n      try {\n        await req.payload.update({\n          collection: input.collectionSlug as CollectionSlug,\n          id: input.docId,\n          data: {\n            imageOptimizer: {\n              status: 'error',\n              error: errorMessage,\n            },\n          },\n          context: { imageOptimizer_skip: true },\n        })\n      } catch (updateErr) {\n        req.payload.logger.error(\n          { err: updateErr, docId: input.docId, collectionSlug: input.collectionSlug },\n          'Failed to persist error status for image optimizer regeneration',\n        )\n      }\n\n      throw err\n    }\n  }\n}\n"],"names":["fs","path","resolveCollectionConfig","stripAndResize","generateThumbHash","convertFormat","resolveStaticDir","fetchFileBuffer","isCloudStorage","createRegenerateDocumentHandler","resolvedConfig","input","req","doc","payload","findByID","collection","collectionSlug","id","docId","mimeType","startsWith","output","status","reason","collectionConfig","collections","config","cloudStorage","fileBuffer","originalSize","length","perCollectionConfig","safeFilename","basename","filename","processed","maxDimensions","stripMetadata","mainBuffer","buffer","mainSize","size","newFilename","newMimeType","replaceOriginal","formats","primaryFormat","converted","format","quality","parse","name","thumbHash","variants","updateData","imageOptimizer","optimizedSize","error","filesize","update","data","file","mimetype","context","imageOptimizer_skip","staticDir","newFilePath","join","writeFile","oldFilePath","unlink","catch","formatsToGenerate","slice","result","variantFilename","push","width","height","url","err","errorMessage","Error","message","String","updateErr","logger"],"mappings":"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"}
+{"version":3,"sources":["../../src/tasks/regenerateDocument.ts"],"sourcesContent":["import crypto from 'crypto'\nimport fs from 'fs/promises'\nimport path from 'path'\n\nimport type { CollectionSlug } from 'payload'\n\nimport type { ResolvedImageOptimizerConfig } from '../types.js'\nimport { resolveCollectionConfig } from '../defaults.js'\nimport { stripAndResize, generateThumbHash, convertFormat } from '../processing/index.js'\nimport { resolveStaticDir } from '../utilities/resolveStaticDir.js'\nimport { fetchFileBuffer, isCloudStorage } from '../utilities/storage.js'\n\nexport const createRegenerateDocumentHandler = (resolvedConfig: ResolvedImageOptimizerConfig) => {\n  return async ({ input, req }: { input: { collectionSlug: string; docId: string }; req: any }) => {\n    try {\n      const doc = await req.payload.findByID({\n        collection: input.collectionSlug as CollectionSlug,\n        id: input.docId,\n      })\n\n      // Skip non-image documents\n      if (!doc.mimeType || !doc.mimeType.startsWith('image/')) {\n        return { output: { status: 'skipped', reason: 'not-image' } }\n      }\n\n      const collectionConfig = req.payload.collections[input.collectionSlug as keyof typeof req.payload.collections].config\n      const cloudStorage = isCloudStorage(collectionConfig)\n\n      const fileBuffer = await fetchFileBuffer(doc, collectionConfig)\n      const originalSize = fileBuffer.length\n      const perCollectionConfig = resolveCollectionConfig(resolvedConfig, input.collectionSlug)\n\n      // Sanitize filename to prevent path traversal\n      const safeFilename = path.basename(doc.filename)\n\n      // Step 1: Strip metadata + resize\n      const processed = await stripAndResize(\n        fileBuffer,\n        perCollectionConfig.maxDimensions,\n        resolvedConfig.stripMetadata,\n      )\n\n      let mainBuffer = processed.buffer\n      let mainSize = processed.size\n      let newFilename = safeFilename\n      let newMimeType: string | undefined\n\n      // Step 1b: If replaceOriginal, convert main file to primary format\n      if (perCollectionConfig.replaceOriginal && perCollectionConfig.formats.length > 0) {\n        const primaryFormat = perCollectionConfig.formats[0]\n        const converted = await convertFormat(processed.buffer, primaryFormat.format, primaryFormat.quality)\n        mainBuffer = converted.buffer\n        mainSize = converted.size\n        newFilename = `${path.parse(safeFilename).name}.${primaryFormat.format}`\n        newMimeType = converted.mimeType\n      }\n\n      // Step 2: Generate ThumbHash\n      let thumbHash: string | undefined\n      if (resolvedConfig.generateThumbHash) {\n        thumbHash = await generateThumbHash(mainBuffer)\n      }\n\n      // Step 3: Store the optimized file\n      const variants: Array<{\n        filename: string\n        filesize: number\n        format: string\n        height: number\n        mimeType: string\n        url: string\n        width: number\n      }> = []\n\n      if (cloudStorage) {\n        // Cloud storage: re-upload the optimized file via Payload's update API.\n        // This triggers the cloud adapter's afterChange hook which uploads to cloud.\n        // When uniqueFileNames is enabled, generate a new UUID filename to avoid\n        // Vercel Blob \"already exists\" errors (the adapter doesn't support allowOverwrite).\n        if (resolvedConfig.uniqueFileNames) {\n          const ext = path.extname(newFilename)\n          newFilename = `${crypto.randomUUID()}${ext}`\n        }\n\n        const updateData: Record<string, any> = {\n          imageOptimizer: {\n            originalSize,\n            optimizedSize: mainSize,\n            status: 'complete',\n            thumbHash,\n            variants: [],\n            error: null,\n          },\n        }\n\n        if (newFilename !== safeFilename) {\n          updateData.filename = newFilename\n          updateData.filesize = mainSize\n          updateData.mimeType = newMimeType\n        }\n\n        await req.payload.update({\n          collection: input.collectionSlug as CollectionSlug,\n          id: input.docId,\n          data: updateData,\n          file: {\n            data: mainBuffer,\n            mimetype: newMimeType || doc.mimeType,\n            name: newFilename,\n            size: mainSize,\n          },\n          context: { imageOptimizer_skip: true },\n        })\n      } else {\n        // Local storage: write files to disk\n        const staticDir = resolveStaticDir(collectionConfig)\n        const newFilePath = path.join(staticDir, newFilename)\n        await fs.writeFile(newFilePath, mainBuffer)\n\n        // Clean up old file if filename changed\n        if (newFilename !== safeFilename) {\n          const oldFilePath = path.join(staticDir, safeFilename)\n          await fs.unlink(oldFilePath).catch(() => {})\n        }\n\n        // Generate variant files (local storage only)\n        const formatsToGenerate = perCollectionConfig.replaceOriginal && perCollectionConfig.formats.length > 0\n          ? perCollectionConfig.formats.slice(1)\n          : perCollectionConfig.formats\n\n        for (const format of formatsToGenerate) {\n          const result = await convertFormat(mainBuffer, format.format, format.quality)\n          const variantFilename = `${path.parse(newFilename).name}-optimized.${format.format}`\n          await fs.writeFile(path.join(staticDir, variantFilename), result.buffer)\n\n          variants.push({\n            format: format.format,\n            filename: variantFilename,\n            filesize: result.size,\n            width: result.width,\n            height: result.height,\n            mimeType: result.mimeType,\n            url: `/api/${input.collectionSlug}/file/${variantFilename}`,\n          })\n        }\n\n        // Update the document with optimization data\n        const updateData: Record<string, any> = {\n          imageOptimizer: {\n            originalSize,\n            optimizedSize: mainSize,\n            status: 'complete',\n            thumbHash,\n            variants,\n            error: null,\n          },\n        }\n\n        if (newFilename !== safeFilename) {\n          updateData.filename = newFilename\n          updateData.filesize = mainSize\n          updateData.mimeType = newMimeType\n        }\n\n        await req.payload.update({\n          collection: input.collectionSlug as CollectionSlug,\n          id: input.docId,\n          data: updateData,\n          context: { imageOptimizer_skip: true },\n        })\n      }\n\n      return { output: { status: 'complete' } }\n    } catch (err) {\n      const errorMessage = err instanceof Error ? err.message : String(err)\n\n      try {\n        await req.payload.update({\n          collection: input.collectionSlug as CollectionSlug,\n          id: input.docId,\n          data: {\n            imageOptimizer: {\n              status: 'error',\n              error: errorMessage,\n            },\n          },\n          context: { imageOptimizer_skip: true },\n        })\n      } catch (updateErr) {\n        req.payload.logger.error(\n          { err: updateErr, docId: input.docId, collectionSlug: input.collectionSlug },\n          'Failed to persist error status for image optimizer regeneration',\n        )\n      }\n\n      throw err\n    }\n  }\n}\n"],"names":["crypto","fs","path","resolveCollectionConfig","stripAndResize","generateThumbHash","convertFormat","resolveStaticDir","fetchFileBuffer","isCloudStorage","createRegenerateDocumentHandler","resolvedConfig","input","req","doc","payload","findByID","collection","collectionSlug","id","docId","mimeType","startsWith","output","status","reason","collectionConfig","collections","config","cloudStorage","fileBuffer","originalSize","length","perCollectionConfig","safeFilename","basename","filename","processed","maxDimensions","stripMetadata","mainBuffer","buffer","mainSize","size","newFilename","newMimeType","replaceOriginal","formats","primaryFormat","converted","format","quality","parse","name","thumbHash","variants","uniqueFileNames","ext","extname","randomUUID","updateData","imageOptimizer","optimizedSize","error","filesize","update","data","file","mimetype","context","imageOptimizer_skip","staticDir","newFilePath","join","writeFile","oldFilePath","unlink","catch","formatsToGenerate","slice","result","variantFilename","push","width","height","url","err","errorMessage","Error","message","String","updateErr","logger"],"mappings":"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"}

package/dist/types.d.ts

@@ -28,6 +28,10 @@ export type ImageOptimizerConfig = {
     };
     replaceOriginal?: boolean;
     stripMetadata?: boolean;
+    /** Replace original filenames with UUIDs (e.g., `photo.jpg` → `a1b2c3d4.webp`).
+     * Prevents Vercel Blob "already exists" errors and avoids leaking original filenames.
+     * Defaults to `false`. */
+    uniqueFileNames?: boolean;
 };
 export type ResolvedCollectionOptimizerConfig = {
     formats: FormatQuality[];
@@ -42,6 +46,7 @@ export type ResolvedImageOptimizerConfig = Required<Pick<ImageOptimizerConfig, '
     collections: ImageOptimizerConfig['collections'];
     disabled: boolean;
     replaceOriginal: boolean;
+    uniqueFileNames: boolean;
 };
 export type ImageOptimizerData = {
     thumbHash?: string | null;

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type { CollectionSlug, Field } from 'payload'\n\nexport type ImageFormat = 'webp' | 'avif'\n\nexport type FormatQuality = {\n  format: ImageFormat\n  quality: number // 1-100\n}\n\nexport type CollectionOptimizerConfig = {\n  formats?: FormatQuality[]\n  maxDimensions?: { width: number; height: number }\n  replaceOriginal?: boolean\n}\n\nexport type FieldsOverride = (args: { defaultFields: Field[] }) => Field[]\n\nexport type ImageOptimizerConfig = {\n  clientOptimization?: boolean\n  collections: Partial<Record<CollectionSlug, true | CollectionOptimizerConfig>>\n  disabled?: boolean\n  fieldsOverride?: FieldsOverride\n  formats?: FormatQuality[]\n  generateThumbHash?: boolean\n  maxDimensions?: { width: number; height: number }\n  replaceOriginal?: boolean\n  stripMetadata?: boolean\n}\n\nexport type ResolvedCollectionOptimizerConfig = {\n  formats: FormatQuality[]\n  maxDimensions: { width: number; height: number }\n  replaceOriginal: boolean\n}\n\nexport type ResolvedImageOptimizerConfig = Required<\n  Pick<ImageOptimizerConfig, 'formats' | 'generateThumbHash' | 'maxDimensions' | 'stripMetadata'>\n> & {\n  clientOptimization: boolean\n  collections: ImageOptimizerConfig['collections']\n  disabled: boolean\n  replaceOriginal: boolean\n}\n\nexport type ImageOptimizerData = {\n  thumbHash?: string | null\n}\n\nexport type MediaSizeVariant = {\n  url?: string | null\n  width?: number | null\n  height?: number | null\n  mimeType?: string | null\n  filesize?: number | null\n  filename?: string | null\n}\n\nexport type MediaResource = {\n  url?: string | null\n  alt?: string | null\n  width?: number | null\n  height?: number | null\n  filename?: string | null\n  focalX?: number | null\n  focalY?: number | null\n  imageOptimizer?: ImageOptimizerData | null\n  updatedAt?: string\n  sizes?: Record<string, MediaSizeVariant | undefined>\n}\n"],"names":[],"mappings":"AAyDA,WAWC"}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type { CollectionSlug, Field } from 'payload'\n\nexport type ImageFormat = 'webp' | 'avif'\n\nexport type FormatQuality = {\n  format: ImageFormat\n  quality: number // 1-100\n}\n\nexport type CollectionOptimizerConfig = {\n  formats?: FormatQuality[]\n  maxDimensions?: { width: number; height: number }\n  replaceOriginal?: boolean\n}\n\nexport type FieldsOverride = (args: { defaultFields: Field[] }) => Field[]\n\nexport type ImageOptimizerConfig = {\n  clientOptimization?: boolean\n  collections: Partial<Record<CollectionSlug, true | CollectionOptimizerConfig>>\n  disabled?: boolean\n  fieldsOverride?: FieldsOverride\n  formats?: FormatQuality[]\n  generateThumbHash?: boolean\n  maxDimensions?: { width: number; height: number }\n  replaceOriginal?: boolean\n  stripMetadata?: boolean\n  /** Replace original filenames with UUIDs (e.g., `photo.jpg` → `a1b2c3d4.webp`).\n   * Prevents Vercel Blob \"already exists\" errors and avoids leaking original filenames.\n   * Defaults to `false`. */\n  uniqueFileNames?: boolean\n}\n\nexport type ResolvedCollectionOptimizerConfig = {\n  formats: FormatQuality[]\n  maxDimensions: { width: number; height: number }\n  replaceOriginal: boolean\n}\n\nexport type ResolvedImageOptimizerConfig = Required<\n  Pick<ImageOptimizerConfig, 'formats' | 'generateThumbHash' | 'maxDimensions' | 'stripMetadata'>\n> & {\n  clientOptimization: boolean\n  collections: ImageOptimizerConfig['collections']\n  disabled: boolean\n  replaceOriginal: boolean\n  uniqueFileNames: boolean\n}\n\nexport type ImageOptimizerData = {\n  thumbHash?: string | null\n}\n\nexport type MediaSizeVariant = {\n  url?: string | null\n  width?: number | null\n  height?: number | null\n  mimeType?: string | null\n  filesize?: number | null\n  filename?: string | null\n}\n\nexport type MediaResource = {\n  url?: string | null\n  alt?: string | null\n  width?: number | null\n  height?: number | null\n  filename?: string | null\n  focalX?: number | null\n  focalY?: number | null\n  imageOptimizer?: ImageOptimizerData | null\n  updatedAt?: string\n  sizes?: Record<string, MediaSizeVariant | undefined>\n}\n"],"names":[],"mappings":"AA8DA,WAWC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inoo-ch/payload-image-optimizer",
-  "version": "1.6.1",
+  "version": "1.7.1",
   "description": "Payload CMS plugin for automatic image optimization — WebP/AVIF conversion, resize, EXIF strip, ThumbHash placeholders, and bulk regeneration",
   "license": "MIT",
   "keywords": [

package/src/defaults.ts

@@ -13,6 +13,7 @@ export const resolveConfig = (config: ImageOptimizerConfig): ResolvedImageOptimi
   maxDimensions: config.maxDimensions ?? { width: 2560, height: 2560 },
   replaceOriginal: config.replaceOriginal ?? true,
   stripMetadata: config.stripMetadata ?? true,
+  uniqueFileNames: config.uniqueFileNames ?? false,
 })
 
 export const resolveCollectionConfig = (

package/src/hooks/beforeChange.ts

@@ -1,3 +1,4 @@
+import crypto from 'crypto'
 import path from 'path'
 import type { CollectionBeforeChangeHook } from 'payload'
 
@@ -15,6 +16,16 @@ export const createBeforeChangeHook = (
 
     if (!req.file || !req.file.data || !req.file.mimetype?.startsWith('image/')) return data
 
+    // Rename file to UUID before any processing, so the storage adapter
+    // never sees the original filename. Prevents Vercel Blob "already exists"
+    // errors and avoids leaking original filenames to storage.
+    if (resolvedConfig.uniqueFileNames) {
+      const ext = path.extname(req.file.name)
+      const uuid = crypto.randomUUID()
+      req.file.name = `${uuid}${ext}`
+      data.filename = req.file.name
+    }
+
     const originalSize = req.file.data.length
 
     const perCollectionConfig = resolveCollectionConfig(resolvedConfig, collectionSlug)

package/src/tasks/regenerateDocument.ts

@@ -1,3 +1,4 @@
+import crypto from 'crypto'
 import fs from 'fs/promises'
 import path from 'path'
 
@@ -74,6 +75,13 @@ export const createRegenerateDocumentHandler = (resolvedConfig: ResolvedImageOpt
       if (cloudStorage) {
         // Cloud storage: re-upload the optimized file via Payload's update API.
         // This triggers the cloud adapter's afterChange hook which uploads to cloud.
+        // When uniqueFileNames is enabled, generate a new UUID filename to avoid
+        // Vercel Blob "already exists" errors (the adapter doesn't support allowOverwrite).
+        if (resolvedConfig.uniqueFileNames) {
+          const ext = path.extname(newFilename)
+          newFilename = `${crypto.randomUUID()}${ext}`
+        }
+
         const updateData: Record<string, any> = {
           imageOptimizer: {
             originalSize,

package/src/types.ts

@@ -25,6 +25,10 @@ export type ImageOptimizerConfig = {
   maxDimensions?: { width: number; height: number }
   replaceOriginal?: boolean
   stripMetadata?: boolean
+  /** Replace original filenames with UUIDs (e.g., `photo.jpg` → `a1b2c3d4.webp`).
+   * Prevents Vercel Blob "already exists" errors and avoids leaking original filenames.
+   * Defaults to `false`. */
+  uniqueFileNames?: boolean
 }
 
 export type ResolvedCollectionOptimizerConfig = {
@@ -40,6 +44,7 @@ export type ResolvedImageOptimizerConfig = Required<
   collections: ImageOptimizerConfig['collections']
   disabled: boolean
   replaceOriginal: boolean
+  uniqueFileNames: boolean
 }
 
 export type ImageOptimizerData = {