@payloadcms/storage-vercel-blob 3.91.0-internal.c1569dc → 4.0.0-beta.0

package/dist/generateURL.d.ts

@@ -5,7 +5,7 @@ interface GenerateURLArgs {
     prefix: string;
     useCompositePrefixes?: boolean;
 }
-export declare function buildBlobUrl(baseUrl: string, fileKey: string): string;
+export declare function buildBlobUrl(baseUrl: string, storageFilePath: string): string;
 export declare function generateURL({ baseUrl, collectionPrefix, filename, prefix, useCompositePrefixes, }: GenerateURLArgs): string;
 export {};
 //# sourceMappingURL=generateURL.d.ts.map

package/dist/generateURL.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateURL.d.ts","sourceRoot":"","sources":["../src/generateURL.ts"],"names":[],"mappings":"AAGA,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAGD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAUrE;AAED,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,gBAAqB,EACrB,QAAQ,EACR,MAAM,EACN,oBAA4B,GAC7B,EAAE,eAAe,GAAG,MAAM,CAS1B"}
+{"version":3,"file":"generateURL.d.ts","sourceRoot":"","sources":["../src/generateURL.ts"],"names":[],"mappings":"AAGA,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAGD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAU7E;AAED,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,gBAAqB,EACrB,QAAQ,EACR,MAAM,EACN,oBAA4B,GAC7B,EAAE,eAAe,GAAG,MAAM,CAS1B"}

package/dist/generateURL.js

@@ -1,14 +1,14 @@
 import { buildStoragePathData } from '@payloadcms/plugin-cloud-storage/utilities';
 import path from 'path';
-// Builds the public blob URL for a storage key, URL-encoding only the filename segment.
-export function buildBlobUrl(baseUrl, fileKey) {
+// Builds the public blob URL for a storage path, URL-encoding only the filename segment.
+export function buildBlobUrl(baseUrl, storageFilePath) {
     // example: "my-collection/my-doc/my file.jpg" -> "my-collection/my-doc"
-    const dir = path.posix.dirname(fileKey);
+    const dir = path.posix.dirname(storageFilePath);
     // example: "my file.jpg" -> "my%20file.jpg"
-    const encodedFilename = encodeURIComponent(path.posix.basename(fileKey));
+    const encodedFilename = encodeURIComponent(path.posix.basename(storageFilePath));
     // example: "my-collection/my-doc/my%20file.jpg"
-    const fileKeyWithEncodedFilename = dir === '.' ? encodedFilename : path.posix.join(dir, encodedFilename);
-    return `${baseUrl}/${fileKeyWithEncodedFilename}`;
+    const storageFilePathWithEncodedFilename = dir === '.' ? encodedFilename : path.posix.join(dir, encodedFilename);
+    return `${baseUrl}/${storageFilePathWithEncodedFilename}`;
 }
 export function generateURL({ baseUrl, collectionPrefix = '', filename, prefix, useCompositePrefixes = false }) {
     const { storageFilePath } = buildStoragePathData({

package/dist/generateURL.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/generateURL.ts"],"sourcesContent":["import { buildStoragePathData } from '@payloadcms/plugin-cloud-storage/utilities'\nimport path from 'path'\n\ninterface GenerateURLArgs {\n  baseUrl: string\n  collectionPrefix?: string\n  filename: string\n  prefix: string\n  useCompositePrefixes?: boolean\n}\n\n// Builds the public blob URL for a storage key, URL-encoding only the filename segment.\nexport function buildBlobUrl(baseUrl: string, fileKey: string): string {\n  // example: \"my-collection/my-doc/my file.jpg\" -> \"my-collection/my-doc\"\n  const dir = path.posix.dirname(fileKey)\n  // example: \"my file.jpg\" -> \"my%20file.jpg\"\n  const encodedFilename = encodeURIComponent(path.posix.basename(fileKey))\n  // example: \"my-collection/my-doc/my%20file.jpg\"\n  const fileKeyWithEncodedFilename =\n    dir === '.' ? encodedFilename : path.posix.join(dir, encodedFilename)\n\n  return `${baseUrl}/${fileKeyWithEncodedFilename}`\n}\n\nexport function generateURL({\n  baseUrl,\n  collectionPrefix = '',\n  filename,\n  prefix,\n  useCompositePrefixes = false,\n}: GenerateURLArgs): string {\n  const { storageFilePath } = buildStoragePathData({\n    collectionPrefix,\n    docPrefix: prefix,\n    filename,\n    useCompositePrefixes,\n  })\n\n  return buildBlobUrl(baseUrl, storageFilePath)\n}\n"],"names":["buildStoragePathData","path","buildBlobUrl","baseUrl","fileKey","dir","posix","dirname","encodedFilename","encodeURIComponent","basename","fileKeyWithEncodedFilename","join","generateURL","collectionPrefix","filename","prefix","useCompositePrefixes","storageFilePath","docPrefix"],"mappings":"AAAA,SAASA,oBAAoB,QAAQ,6CAA4C;AACjF,OAAOC,UAAU,OAAM;AAUvB,wFAAwF;AACxF,OAAO,SAASC,aAAaC,OAAe,EAAEC,OAAe;IAC3D,wEAAwE;IACxE,MAAMC,MAAMJ,KAAKK,KAAK,CAACC,OAAO,CAACH;IAC/B,4CAA4C;IAC5C,MAAMI,kBAAkBC,mBAAmBR,KAAKK,KAAK,CAACI,QAAQ,CAACN;IAC/D,gDAAgD;IAChD,MAAMO,6BACJN,QAAQ,MAAMG,kBAAkBP,KAAKK,KAAK,CAACM,IAAI,CAACP,KAAKG;IAEvD,OAAO,GAAGL,QAAQ,CAAC,EAAEQ,4BAA4B;AACnD;AAEA,OAAO,SAASE,YAAY,EAC1BV,OAAO,EACPW,mBAAmB,EAAE,EACrBC,QAAQ,EACRC,MAAM,EACNC,uBAAuB,KAAK,EACZ;IAChB,MAAM,EAAEC,eAAe,EAAE,GAAGlB,qBAAqB;QAC/Cc;QACAK,WAAWH;QACXD;QACAE;IACF;IAEA,OAAOf,aAAaC,SAASe;AAC/B"}
+{"version":3,"sources":["../src/generateURL.ts"],"sourcesContent":["import { buildStoragePathData } from '@payloadcms/plugin-cloud-storage/utilities'\nimport path from 'path'\n\ninterface GenerateURLArgs {\n  baseUrl: string\n  collectionPrefix?: string\n  filename: string\n  prefix: string\n  useCompositePrefixes?: boolean\n}\n\n// Builds the public blob URL for a storage path, URL-encoding only the filename segment.\nexport function buildBlobUrl(baseUrl: string, storageFilePath: string): string {\n  // example: \"my-collection/my-doc/my file.jpg\" -> \"my-collection/my-doc\"\n  const dir = path.posix.dirname(storageFilePath)\n  // example: \"my file.jpg\" -> \"my%20file.jpg\"\n  const encodedFilename = encodeURIComponent(path.posix.basename(storageFilePath))\n  // example: \"my-collection/my-doc/my%20file.jpg\"\n  const storageFilePathWithEncodedFilename =\n    dir === '.' ? encodedFilename : path.posix.join(dir, encodedFilename)\n\n  return `${baseUrl}/${storageFilePathWithEncodedFilename}`\n}\n\nexport function generateURL({\n  baseUrl,\n  collectionPrefix = '',\n  filename,\n  prefix,\n  useCompositePrefixes = false,\n}: GenerateURLArgs): string {\n  const { storageFilePath } = buildStoragePathData({\n    collectionPrefix,\n    docPrefix: prefix,\n    filename,\n    useCompositePrefixes,\n  })\n\n  return buildBlobUrl(baseUrl, storageFilePath)\n}\n"],"names":["buildStoragePathData","path","buildBlobUrl","baseUrl","storageFilePath","dir","posix","dirname","encodedFilename","encodeURIComponent","basename","storageFilePathWithEncodedFilename","join","generateURL","collectionPrefix","filename","prefix","useCompositePrefixes","docPrefix"],"mappings":"AAAA,SAASA,oBAAoB,QAAQ,6CAA4C;AACjF,OAAOC,UAAU,OAAM;AAUvB,yFAAyF;AACzF,OAAO,SAASC,aAAaC,OAAe,EAAEC,eAAuB;IACnE,wEAAwE;IACxE,MAAMC,MAAMJ,KAAKK,KAAK,CAACC,OAAO,CAACH;IAC/B,4CAA4C;IAC5C,MAAMI,kBAAkBC,mBAAmBR,KAAKK,KAAK,CAACI,QAAQ,CAACN;IAC/D,gDAAgD;IAChD,MAAMO,qCACJN,QAAQ,MAAMG,kBAAkBP,KAAKK,KAAK,CAACM,IAAI,CAACP,KAAKG;IAEvD,OAAO,GAAGL,QAAQ,CAAC,EAAEQ,oCAAoC;AAC3D;AAEA,OAAO,SAASE,YAAY,EAC1BV,OAAO,EACPW,mBAAmB,EAAE,EACrBC,QAAQ,EACRC,MAAM,EACNC,uBAAuB,KAAK,EACZ;IAChB,MAAM,EAAEb,eAAe,EAAE,GAAGJ,qBAAqB;QAC/Cc;QACAI,WAAWF;QACXD;QACAE;IACF;IAEA,OAAOf,aAAaC,SAASC;AAC/B"}

package/dist/getCollectionSources.d.ts

@@ -0,0 +1,20 @@
+import type { StorageAdapter } from 'payload';
+import type { VercelBlobCollectionSource } from './authorizeFileOverwrite.js';
+type VercelBlobStorageMetadata = {
+    collections: Record<string, {
+        prefix?: string;
+    } | true | undefined>;
+    enabled: boolean;
+    storeId?: string;
+    useCompositePrefixes: boolean;
+};
+export declare const vercelBlobStorageMetadata: unique symbol;
+export type InternalVercelBlobStorageAdapter = {
+    [vercelBlobStorageMetadata]: VercelBlobStorageMetadata;
+} & StorageAdapter;
+export declare const getCollectionSources: ({ currentAdapter, storageAdapters, }: {
+    currentAdapter: InternalVercelBlobStorageAdapter;
+    storageAdapters?: StorageAdapter[];
+}) => VercelBlobCollectionSource[];
+export {};
+//# sourceMappingURL=getCollectionSources.d.ts.map

package/dist/getCollectionSources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCollectionSources.d.ts","sourceRoot":"","sources":["../src/getCollectionSources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAA;AAE7E,KAAK,yBAAyB,GAAG;IAC/B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;IACnE,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oBAAoB,EAAE,OAAO,CAAA;CAC9B,CAAA;AAED,eAAO,MAAM,yBAAyB,eAAsC,CAAA;AAE5E,MAAM,MAAM,gCAAgC,GAAG;IAC7C,CAAC,yBAAyB,CAAC,EAAE,yBAAyB,CAAA;CACvD,GAAG,cAAc,CAAA;AAMlB,eAAO,MAAM,oBAAoB,yCAG9B;IACD,cAAc,EAAE,gCAAgC,CAAA;IAChD,eAAe,CAAC,EAAE,cAAc,EAAE,CAAA;CACnC,KAAG,0BAA0B,EAoB7B,CAAA"}

package/dist/getCollectionSources.js

@@ -0,0 +1,27 @@
+export const vercelBlobStorageMetadata = Symbol('vercelBlobStorageMetadata');
+const isInternalVercelBlobStorageAdapter = (adapter)=>vercelBlobStorageMetadata in adapter;
+export const getCollectionSources = ({ currentAdapter, storageAdapters = [] })=>{
+    const currentMetadata = currentAdapter[vercelBlobStorageMetadata];
+    const adapters = new Set([
+        currentAdapter,
+        ...storageAdapters
+    ]);
+    return [
+        ...adapters
+    ].flatMap((adapter)=>{
+        if (!isInternalVercelBlobStorageAdapter(adapter)) {
+            return [];
+        }
+        const metadata = adapter[vercelBlobStorageMetadata];
+        if (!metadata.enabled || metadata.storeId !== currentMetadata.storeId) {
+            return [];
+        }
+        return Object.entries(metadata.collections).map(([collectionSlug, options])=>({
+                collectionPrefix: options === true ? '' : options?.prefix || '',
+                collectionSlug,
+                useCompositePrefixes: metadata.useCompositePrefixes
+            }));
+    });
+};
+
+//# sourceMappingURL=getCollectionSources.js.map

package/dist/getCollectionSources.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/getCollectionSources.ts"],"sourcesContent":["import type { StorageAdapter } from 'payload'\n\nimport type { VercelBlobCollectionSource } from './authorizeFileOverwrite.js'\n\ntype VercelBlobStorageMetadata = {\n  collections: Record<string, { prefix?: string } | true | undefined>\n  enabled: boolean\n  storeId?: string\n  useCompositePrefixes: boolean\n}\n\nexport const vercelBlobStorageMetadata = Symbol('vercelBlobStorageMetadata')\n\nexport type InternalVercelBlobStorageAdapter = {\n  [vercelBlobStorageMetadata]: VercelBlobStorageMetadata\n} & StorageAdapter\n\nconst isInternalVercelBlobStorageAdapter = (\n  adapter: StorageAdapter,\n): adapter is InternalVercelBlobStorageAdapter => vercelBlobStorageMetadata in adapter\n\nexport const getCollectionSources = ({\n  currentAdapter,\n  storageAdapters = [],\n}: {\n  currentAdapter: InternalVercelBlobStorageAdapter\n  storageAdapters?: StorageAdapter[]\n}): VercelBlobCollectionSource[] => {\n  const currentMetadata = currentAdapter[vercelBlobStorageMetadata]\n  const adapters = new Set([currentAdapter, ...storageAdapters])\n\n  return [...adapters].flatMap((adapter) => {\n    if (!isInternalVercelBlobStorageAdapter(adapter)) {\n      return []\n    }\n\n    const metadata = adapter[vercelBlobStorageMetadata]\n    if (!metadata.enabled || metadata.storeId !== currentMetadata.storeId) {\n      return []\n    }\n\n    return Object.entries(metadata.collections).map(([collectionSlug, options]) => ({\n      collectionPrefix: options === true ? '' : options?.prefix || '',\n      collectionSlug,\n      useCompositePrefixes: metadata.useCompositePrefixes,\n    }))\n  })\n}\n"],"names":["vercelBlobStorageMetadata","Symbol","isInternalVercelBlobStorageAdapter","adapter","getCollectionSources","currentAdapter","storageAdapters","currentMetadata","adapters","Set","flatMap","metadata","enabled","storeId","Object","entries","collections","map","collectionSlug","options","collectionPrefix","prefix","useCompositePrefixes"],"mappings":"AAWA,OAAO,MAAMA,4BAA4BC,OAAO,6BAA4B;AAM5E,MAAMC,qCAAqC,CACzCC,UACgDH,6BAA6BG;AAE/E,OAAO,MAAMC,uBAAuB,CAAC,EACnCC,cAAc,EACdC,kBAAkB,EAAE,EAIrB;IACC,MAAMC,kBAAkBF,cAAc,CAACL,0BAA0B;IACjE,MAAMQ,WAAW,IAAIC,IAAI;QAACJ;WAAmBC;KAAgB;IAE7D,OAAO;WAAIE;KAAS,CAACE,OAAO,CAAC,CAACP;QAC5B,IAAI,CAACD,mCAAmCC,UAAU;YAChD,OAAO,EAAE;QACX;QAEA,MAAMQ,WAAWR,OAAO,CAACH,0BAA0B;QACnD,IAAI,CAACW,SAASC,OAAO,IAAID,SAASE,OAAO,KAAKN,gBAAgBM,OAAO,EAAE;YACrE,OAAO,EAAE;QACX;QAEA,OAAOC,OAAOC,OAAO,CAACJ,SAASK,WAAW,EAAEC,GAAG,CAAC,CAAC,CAACC,gBAAgBC,QAAQ,GAAM,CAAA;gBAC9EC,kBAAkBD,YAAY,OAAO,KAAKA,SAASE,UAAU;gBAC7DH;gBACAI,sBAAsBX,SAASW,oBAAoB;YACrD,CAAA;IACF;AACF,EAAC"}

package/dist/getFile.d.ts

@@ -1,17 +1,18 @@
-import type { CollectionConfig, PayloadRequest, TypeWithID } from 'payload';
+import type { CollectionConfig, FileHandlerOperation, PayloadRequest, TypeWithID } from 'payload';
 interface GetFileArgs {
     baseUrl: string;
     cacheControlMaxAge: number;
-    clientUploadContext?: unknown;
     collection: CollectionConfig;
     collectionPrefix?: string;
     doc?: TypeWithID;
     filename: string;
     incomingHeaders?: Headers;
+    operation?: FileHandlerOperation;
     req: PayloadRequest;
     token: string;
+    uploadReference?: unknown;
     useCompositePrefixes?: boolean;
 }
-export declare function getFile({ baseUrl, cacheControlMaxAge, clientUploadContext, collection, collectionPrefix, doc, filename, incomingHeaders, req, token, useCompositePrefixes, }: GetFileArgs): Promise<Response>;
+export declare function getFile({ baseUrl, cacheControlMaxAge, collection, collectionPrefix, doc, filename, incomingHeaders, operation, req, token, uploadReference, useCompositePrefixes, }: GetFileArgs): Promise<Response>;
 export {};
 //# sourceMappingURL=getFile.d.ts.map

package/dist/getFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getFile.d.ts","sourceRoot":"","sources":["../src/getFile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAY3E,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB,EAAE,MAAM,CAAA;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,UAAU,EAAE,gBAAgB,CAAA;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,GAAG,CAAC,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,GAAG,EAAE,cAAc,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED,wBAAsB,OAAO,CAAC,EAC5B,OAAO,EACP,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,EACV,gBAAqB,EACrB,GAAG,EACH,QAAQ,EACR,eAAe,EACf,GAAG,EACH,KAAK,EACL,oBAA4B,GAC7B,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAgGjC"}
+{"version":3,"file":"getFile.d.ts","sourceRoot":"","sources":["../src/getFile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAQjG,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB,EAAE,MAAM,CAAA;IAC1B,UAAU,EAAE,gBAAgB,CAAA;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,GAAG,CAAC,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,SAAS,CAAC,EAAE,oBAAoB,CAAA;IAChC,GAAG,EAAE,cAAc,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED,wBAAsB,OAAO,CAAC,EAC5B,OAAO,EACP,kBAAkB,EAClB,UAAU,EACV,gBAAqB,EACrB,GAAG,EACH,QAAQ,EACR,eAAe,EACf,SAAkB,EAClB,GAAG,EACH,KAAK,EACL,eAAe,EACf,oBAA4B,GAC7B,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsGjC"}

package/dist/getFile.js

@@ -1,16 +1,17 @@
 import { getFilePrefix as getDocPrefix } from '@payloadcms/plugin-cloud-storage/utilities';
 import { BlobNotFoundError, head } from '@vercel/blob';
-import { getRangeRequestInfo, isXmlMimeType, UPLOAD_CONTENT_SECURITY_POLICY } from 'payload/internal';
+import { getRangeRequestInfo, isXmlMimeType, uploadContentSecurityPolicy } from 'payload/internal';
 import { generateURL } from './generateURL.js';
-export async function getFile({ baseUrl, cacheControlMaxAge, clientUploadContext, collection, collectionPrefix = '', doc, filename, incomingHeaders, req, token, useCompositePrefixes = false }) {
+export async function getFile({ baseUrl, cacheControlMaxAge, collection, collectionPrefix = '', doc, filename, incomingHeaders, operation = 'read', req, token, uploadReference, useCompositePrefixes = false }) {
+    const isTransformSource = operation === 'transform';
     try {
         const docPrefix = await getDocPrefix({
-            clientUploadContext,
             collection,
             collectionPrefix,
             doc,
             filename,
             req,
+            uploadReference,
             useCompositePrefixes
         });
         const fileUrl = generateURL({
@@ -28,8 +29,7 @@ export async function getFile({ baseUrl, cacheControlMaxAge, clientUploadContext
         const uploadedAtString = uploadedAt.toISOString();
         const fileKeyForETag = fileUrl.replace(`${baseUrl}/`, '');
         const ETag = `"${fileKeyForETag}-${uploadedAtString}"`;
-        // Handle range request
-        const rangeHeader = req.headers.get('range');
+        const rangeHeader = isTransformSource ? null : req.headers.get('range');
         const rangeResult = getRangeRequestInfo({
             fileSize: size,
             rangeHeader
@@ -41,7 +41,6 @@ export async function getFile({ baseUrl, cacheControlMaxAge, clientUploadContext
             });
         }
         let headers = new Headers(incomingHeaders);
-        // Add range-related headers from the result
         for (const [key, value] of Object.entries(rangeResult.headers)){
             headers.append(key, value);
         }
@@ -49,16 +48,16 @@ export async function getFile({ baseUrl, cacheControlMaxAge, clientUploadContext
         headers.append('Content-Disposition', contentDisposition);
         headers.append('Content-Type', contentType);
         headers.append('ETag', ETag);
-        // Add Content-Security-Policy header for XML-family files
+        // Apply a restrictive policy to XML-family responses served through Payload.
         if (isXmlMimeType(contentType)) {
-            headers.append('Content-Security-Policy', UPLOAD_CONTENT_SECURITY_POLICY);
+            headers.append('Content-Security-Policy', uploadContentSecurityPolicy);
         }
-        if (collection.upload && typeof collection.upload === 'object' && typeof collection.upload.modifyResponseHeaders === 'function') {
+        if (!isTransformSource && collection.upload && typeof collection.upload === 'object' && typeof collection.upload.modifyResponseHeaders === 'function') {
             headers = collection.upload.modifyResponseHeaders({
                 headers
             }) || headers;
         }
-        if (etagFromHeaders && etagFromHeaders === ETag) {
+        if (!isTransformSource && etagFromHeaders && etagFromHeaders === ETag) {
             return new Response(null, {
                 headers,
                 status: 304
@@ -74,6 +73,13 @@ export async function getFile({ baseUrl, cacheControlMaxAge, clientUploadContext
             }
         });
         if (!response.ok || !response.body) {
+            // A transformer needs the real failure status; masking it as 204 is only safe for a plain download.
+            if (isTransformSource) {
+                return new Response(null, {
+                    status: response.status,
+                    statusText: response.statusText
+                });
+            }
             return new Response(null, {
                 status: 204,
                 statusText: 'No Content'

package/dist/getFile.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/getFile.ts"],"sourcesContent":["import type { CollectionConfig, PayloadRequest, TypeWithID } from 'payload'\n\nimport { getFilePrefix as getDocPrefix } from '@payloadcms/plugin-cloud-storage/utilities'\nimport { BlobNotFoundError, head } from '@vercel/blob'\nimport {\n  getRangeRequestInfo,\n  isXmlMimeType,\n  UPLOAD_CONTENT_SECURITY_POLICY,\n} from 'payload/internal'\n\nimport { generateURL } from './generateURL.js'\n\ninterface GetFileArgs {\n  baseUrl: string\n  cacheControlMaxAge: number\n  clientUploadContext?: unknown\n  collection: CollectionConfig\n  collectionPrefix?: string\n  doc?: TypeWithID\n  filename: string\n  incomingHeaders?: Headers\n  req: PayloadRequest\n  token: string\n  useCompositePrefixes?: boolean\n}\n\nexport async function getFile({\n  baseUrl,\n  cacheControlMaxAge,\n  clientUploadContext,\n  collection,\n  collectionPrefix = '',\n  doc,\n  filename,\n  incomingHeaders,\n  req,\n  token,\n  useCompositePrefixes = false,\n}: GetFileArgs): Promise<Response> {\n  try {\n    const docPrefix = await getDocPrefix({\n      clientUploadContext,\n      collection,\n      collectionPrefix,\n      doc,\n      filename,\n      req,\n      useCompositePrefixes,\n    })\n\n    const fileUrl = generateURL({\n      baseUrl,\n      collectionPrefix,\n      filename,\n      prefix: docPrefix,\n      useCompositePrefixes,\n    })\n    const etagFromHeaders = req.headers.get('etag') || req.headers.get('if-none-match')\n    const blobMetadata = await head(fileUrl, { token })\n    const { contentDisposition, contentType, size, uploadedAt } = blobMetadata\n    const uploadedAtString = uploadedAt.toISOString()\n    const fileKeyForETag = fileUrl.replace(`${baseUrl}/`, '')\n    const ETag = `\"${fileKeyForETag}-${uploadedAtString}\"`\n\n    // Handle range request\n    const rangeHeader = req.headers.get('range')\n    const rangeResult = getRangeRequestInfo({ fileSize: size, rangeHeader })\n\n    if (rangeResult.type === 'invalid') {\n      return new Response(null, {\n        headers: new Headers(rangeResult.headers),\n        status: rangeResult.status,\n      })\n    }\n\n    let headers = new Headers(incomingHeaders)\n\n    // Add range-related headers from the result\n    for (const [key, value] of Object.entries(rangeResult.headers)) {\n      headers.append(key, value)\n    }\n\n    headers.append('Cache-Control', `public, max-age=${cacheControlMaxAge}`)\n    headers.append('Content-Disposition', contentDisposition)\n    headers.append('Content-Type', contentType)\n    headers.append('ETag', ETag)\n\n    // Add Content-Security-Policy header for XML-family files\n    if (isXmlMimeType(contentType)) {\n      headers.append('Content-Security-Policy', UPLOAD_CONTENT_SECURITY_POLICY)\n    }\n\n    if (\n      collection.upload &&\n      typeof collection.upload === 'object' &&\n      typeof collection.upload.modifyResponseHeaders === 'function'\n    ) {\n      headers = collection.upload.modifyResponseHeaders({ headers }) || headers\n    }\n\n    if (etagFromHeaders && etagFromHeaders === ETag) {\n      return new Response(null, {\n        headers,\n        status: 304,\n      })\n    }\n\n    const response = await fetch(`${fileUrl}?${uploadedAtString}`, {\n      headers: {\n        'Cache-Control': 'no-store, no-cache, must-revalidate',\n        Pragma: 'no-cache',\n        ...(rangeResult.type === 'partial' && {\n          Range: `bytes=${rangeResult.rangeStart}-${rangeResult.rangeEnd}`,\n        }),\n      },\n    })\n\n    if (!response.ok || !response.body) {\n      return new Response(null, { status: 204, statusText: 'No Content' })\n    }\n\n    headers.append('Last-Modified', uploadedAtString)\n\n    return new Response(response.body, {\n      headers,\n      status: rangeResult.status,\n    })\n  } catch (err: unknown) {\n    if (err instanceof BlobNotFoundError) {\n      return new Response(null, { status: 404, statusText: 'Not Found' })\n    }\n    req.payload.logger.error({ err, msg: 'Unexpected error in staticHandler' })\n    return new Response('Internal Server Error', { status: 500 })\n  }\n}\n"],"names":["getFilePrefix","getDocPrefix","BlobNotFoundError","head","getRangeRequestInfo","isXmlMimeType","UPLOAD_CONTENT_SECURITY_POLICY","generateURL","getFile","baseUrl","cacheControlMaxAge","clientUploadContext","collection","collectionPrefix","doc","filename","incomingHeaders","req","token","useCompositePrefixes","docPrefix","fileUrl","prefix","etagFromHeaders","headers","get","blobMetadata","contentDisposition","contentType","size","uploadedAt","uploadedAtString","toISOString","fileKeyForETag","replace","ETag","rangeHeader","rangeResult","fileSize","type","Response","Headers","status","key","value","Object","entries","append","upload","modifyResponseHeaders","response","fetch","Pragma","Range","rangeStart","rangeEnd","ok","body","statusText","err","payload","logger","error","msg"],"mappings":"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"}
+{"version":3,"sources":["../src/getFile.ts"],"sourcesContent":["import type { CollectionConfig, FileHandlerOperation, PayloadRequest, TypeWithID } from 'payload'\n\nimport { getFilePrefix as getDocPrefix } from '@payloadcms/plugin-cloud-storage/utilities'\nimport { BlobNotFoundError, head } from '@vercel/blob'\nimport { getRangeRequestInfo, isXmlMimeType, uploadContentSecurityPolicy } from 'payload/internal'\n\nimport { generateURL } from './generateURL.js'\n\ninterface GetFileArgs {\n  baseUrl: string\n  cacheControlMaxAge: number\n  collection: CollectionConfig\n  collectionPrefix?: string\n  doc?: TypeWithID\n  filename: string\n  incomingHeaders?: Headers\n  operation?: FileHandlerOperation\n  req: PayloadRequest\n  token: string\n  uploadReference?: unknown\n  useCompositePrefixes?: boolean\n}\n\nexport async function getFile({\n  baseUrl,\n  cacheControlMaxAge,\n  collection,\n  collectionPrefix = '',\n  doc,\n  filename,\n  incomingHeaders,\n  operation = 'read',\n  req,\n  token,\n  uploadReference,\n  useCompositePrefixes = false,\n}: GetFileArgs): Promise<Response> {\n  const isTransformSource = operation === 'transform'\n\n  try {\n    const docPrefix = await getDocPrefix({\n      collection,\n      collectionPrefix,\n      doc,\n      filename,\n      req,\n      uploadReference,\n      useCompositePrefixes,\n    })\n\n    const fileUrl = generateURL({\n      baseUrl,\n      collectionPrefix,\n      filename,\n      prefix: docPrefix,\n      useCompositePrefixes,\n    })\n    const etagFromHeaders = req.headers.get('etag') || req.headers.get('if-none-match')\n    const blobMetadata = await head(fileUrl, { token })\n    const { contentDisposition, contentType, size, uploadedAt } = blobMetadata\n    const uploadedAtString = uploadedAt.toISOString()\n    const fileKeyForETag = fileUrl.replace(`${baseUrl}/`, '')\n    const ETag = `\"${fileKeyForETag}-${uploadedAtString}\"`\n\n    const rangeHeader = isTransformSource ? null : req.headers.get('range')\n    const rangeResult = getRangeRequestInfo({ fileSize: size, rangeHeader })\n\n    if (rangeResult.type === 'invalid') {\n      return new Response(null, {\n        headers: new Headers(rangeResult.headers),\n        status: rangeResult.status,\n      })\n    }\n\n    let headers = new Headers(incomingHeaders)\n\n    for (const [key, value] of Object.entries(rangeResult.headers)) {\n      headers.append(key, value)\n    }\n\n    headers.append('Cache-Control', `public, max-age=${cacheControlMaxAge}`)\n    headers.append('Content-Disposition', contentDisposition)\n    headers.append('Content-Type', contentType)\n    headers.append('ETag', ETag)\n\n    // Apply a restrictive policy to XML-family responses served through Payload.\n    if (isXmlMimeType(contentType)) {\n      headers.append('Content-Security-Policy', uploadContentSecurityPolicy)\n    }\n\n    if (\n      !isTransformSource &&\n      collection.upload &&\n      typeof collection.upload === 'object' &&\n      typeof collection.upload.modifyResponseHeaders === 'function'\n    ) {\n      headers = collection.upload.modifyResponseHeaders({ headers }) || headers\n    }\n\n    if (!isTransformSource && etagFromHeaders && etagFromHeaders === ETag) {\n      return new Response(null, {\n        headers,\n        status: 304,\n      })\n    }\n\n    const response = await fetch(`${fileUrl}?${uploadedAtString}`, {\n      headers: {\n        'Cache-Control': 'no-store, no-cache, must-revalidate',\n        Pragma: 'no-cache',\n        ...(rangeResult.type === 'partial' && {\n          Range: `bytes=${rangeResult.rangeStart}-${rangeResult.rangeEnd}`,\n        }),\n      },\n    })\n\n    if (!response.ok || !response.body) {\n      // A transformer needs the real failure status; masking it as 204 is only safe for a plain download.\n      if (isTransformSource) {\n        return new Response(null, { status: response.status, statusText: response.statusText })\n      }\n\n      return new Response(null, { status: 204, statusText: 'No Content' })\n    }\n\n    headers.append('Last-Modified', uploadedAtString)\n\n    return new Response(response.body, {\n      headers,\n      status: rangeResult.status,\n    })\n  } catch (err: unknown) {\n    if (err instanceof BlobNotFoundError) {\n      return new Response(null, { status: 404, statusText: 'Not Found' })\n    }\n    req.payload.logger.error({ err, msg: 'Unexpected error in staticHandler' })\n    return new Response('Internal Server Error', { status: 500 })\n  }\n}\n"],"names":["getFilePrefix","getDocPrefix","BlobNotFoundError","head","getRangeRequestInfo","isXmlMimeType","uploadContentSecurityPolicy","generateURL","getFile","baseUrl","cacheControlMaxAge","collection","collectionPrefix","doc","filename","incomingHeaders","operation","req","token","uploadReference","useCompositePrefixes","isTransformSource","docPrefix","fileUrl","prefix","etagFromHeaders","headers","get","blobMetadata","contentDisposition","contentType","size","uploadedAt","uploadedAtString","toISOString","fileKeyForETag","replace","ETag","rangeHeader","rangeResult","fileSize","type","Response","Headers","status","key","value","Object","entries","append","upload","modifyResponseHeaders","response","fetch","Pragma","Range","rangeStart","rangeEnd","ok","body","statusText","err","payload","logger","error","msg"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import type { ClientUploadsConfig, CollectionOptions } from '@payloadcms/plugin-cloud-storage/types';
-import type { Plugin, UploadCollectionSlug } from 'payload';
+import type { StorageAdapter, UploadCollectionSlug } from 'payload';
 export type VercelBlobStorageOptions = {
     /**
      * Access control level. Currently, only 'public' is supported.
@@ -9,21 +9,12 @@ export type VercelBlobStorageOptions = {
      */
     access?: 'public';
     /**
-     * Add a random suffix to the uploaded file name in Vercel Blob storage
+     * Must be false or omitted for enabled adapters with configured collections.
+     * Payload requires exact storage paths and allocates unique object folders.
      *
      * @default false
      */
     addRandomSuffix?: boolean;
-    /**
-     * When enabled, fields (like the prefix field) will always be inserted into
-     * the collection schema regardless of whether the plugin is enabled. This
-     * ensures a consistent schema across all environments.
-     *
-     * This will be enabled by default in Payload v4.
-     *
-     * @default false
-     */
-    alwaysInsertFields?: boolean;
     /**
      * Cache-Control max-age in seconds
      *
@@ -31,7 +22,7 @@ export type VercelBlobStorageOptions = {
      */
     cacheControlMaxAge?: number;
     /**
-     * Do uploads directly on the client, to bypass limits on Vercel.
+     * Upload directly to Vercel Blob instead of through Payload.
      */
     clientUploads?: ClientUploadsConfig;
     /**
@@ -68,7 +59,7 @@ export type VercelBlobStorageOptions = {
      */
     useCompositePrefixes?: boolean;
 };
-type VercelBlobStoragePlugin = (vercelBlobStorageOpts: VercelBlobStorageOptions) => Plugin;
-export declare const vercelBlobStorage: VercelBlobStoragePlugin;
+type VercelBlobStorageFactory = (vercelBlobStorageOpts: VercelBlobStorageOptions) => StorageAdapter;
+export declare const vercelBlobStorage: VercelBlobStorageFactory;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EAEnB,iBAAiB,EAClB,MAAM,wCAAwC,CAAA;AAC/C,OAAO,KAAK,EAAU,MAAM,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAUnE,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAA;IAEjB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IAEzB;;;;;;;;OAQG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAE5B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAE3B;;OAEG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAA;IAEnC;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,CAAA;IAE7F;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAEzB;;;;;;;;;;;;;OAaG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B,CAAA;AASD,KAAK,uBAAuB,GAAG,CAAC,qBAAqB,EAAE,wBAAwB,KAAK,MAAM,CAAA;AAE1F,eAAO,MAAM,iBAAiB,EAAE,uBAwH7B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EAEnB,iBAAiB,EAClB,MAAM,wCAAwC,CAAA;AAC/C,OAAO,KAAK,EAAU,cAAc,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAW3E,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAA;IAEjB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IAEzB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAE3B;;OAEG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAA;IAEnC;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,CAAA;IAE7F;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAEzB;;;;;;;;;;;;;OAaG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B,CAAA;AASD,KAAK,wBAAwB,GAAG,CAAC,qBAAqB,EAAE,wBAAwB,KAAK,cAAc,CAAA;AAEnG,eAAO,MAAM,iBAAiB,EAAE,wBA8G/B,CAAA"}

package/dist/index.js

@@ -1,49 +1,31 @@
 import { cloudStoragePlugin } from '@payloadcms/plugin-cloud-storage';
-import { initClientUploads } from '@payloadcms/plugin-cloud-storage/utilities';
 import { createVercelBlobAdapter } from './adapter.js';
-import { getClientUploadRoute } from './getClientUploadRoute.js';
+import { getCollectionSources, vercelBlobStorageMetadata } from './getCollectionSources.js';
 const defaultUploadOptions = {
     access: 'public',
     addRandomSuffix: false,
     cacheControlMaxAge: 60 * 60 * 24 * 365,
     enabled: true
 };
-export const vercelBlobStorage = (options)=>(incomingConfig)=>{
-        // Parse storeId from token
-        const storeId = options.token?.match(/^vercel_blob_rw_([a-z\d]+)_[a-z\d]+$/i)?.[1]?.toLowerCase();
-        const isPluginDisabled = options.enabled === false || !options.token;
-        // Don't throw if the plugin is disabled
-        if (!storeId && !isPluginDisabled) {
-            throw new Error('Invalid token format for Vercel Blob adapter. Should be vercel_blob_rw_<store_id>_<random_string>.');
-        }
-        const optionsWithDefaults = {
-            ...defaultUploadOptions,
-            ...options
-        };
-        // support overriding the base URL for emulator https://github.com/payloadcms/vercel-blob-emulator
-        const baseUrl = process.env.STORAGE_VERCEL_BLOB_BASE_URL || `https://${storeId}.${optionsWithDefaults.access}.blob.vercel-storage.com`;
-        initClientUploads({
-            clientHandler: '@payloadcms/storage-vercel-blob/client#VercelBlobClientUploadHandler',
-            collections: options.collections,
-            config: incomingConfig,
-            enabled: !isPluginDisabled && Boolean(options.clientUploads),
-            extraClientHandlerProps: ()=>({
-                    addRandomSuffix: !!optionsWithDefaults.addRandomSuffix,
-                    useCompositePrefixes: !!options.useCompositePrefixes
-                }),
-            serverHandler: getClientUploadRoute({
-                access: typeof options.clientUploads === 'object' ? options.clientUploads.access : undefined,
-                addRandomSuffix: optionsWithDefaults.addRandomSuffix,
-                cacheControlMaxAge: options.cacheControlMaxAge,
-                collections: options.collections,
-                token: options.token ?? '',
-                useCompositePrefixes: optionsWithDefaults.useCompositePrefixes
-            }),
-            serverHandlerPath: '/vercel-blob-client-upload-route'
-        });
-        // If the plugin is disabled or no token is provided, do not enable the plugin
-        if (isPluginDisabled) {
-            if (options.alwaysInsertFields) {
+export const vercelBlobStorage = (options)=>{
+    const storeId = options.token?.match(/^vercel_blob_rw_([a-z\d]+)_[a-z\d]+$/i)?.[1]?.toLowerCase();
+    const isPluginDisabled = options.enabled === false || !options.token;
+    const storageAdapter = {
+        name: 'vercel-blob',
+        collections: Object.keys(options.collections),
+        init: (incomingConfig)=>{
+            // Don't throw if the plugin is disabled
+            if (!storeId && !isPluginDisabled) {
+                throw new Error('Invalid token format for Vercel Blob adapter. Should be vercel_blob_rw_<store_id>_<random_string>.');
+            }
+            const optionsWithDefaults = {
+                ...defaultUploadOptions,
+                ...options
+            };
+            // support overriding the base URL for emulator https://github.com/payloadcms/vercel-blob-emulator
+            const baseUrl = process.env.STORAGE_VERCEL_BLOB_BASE_URL || `https://${storeId}.${optionsWithDefaults.access}.blob.vercel-storage.com`;
+            // If the plugin is disabled or no token is provided, do not enable the plugin
+            if (isPluginDisabled) {
                 const collectionsWithoutAdapter = Object.entries(options.collections).reduce((acc, [slug, collOptions])=>({
                         ...acc,
                         [slug]: {
@@ -52,52 +34,64 @@ export const vercelBlobStorage = (options)=>(incomingConfig)=>{
                         }
                     }), {});
                 return cloudStoragePlugin({
-                    alwaysInsertFields: true,
                     collections: collectionsWithoutAdapter,
                     enabled: false,
                     useCompositePrefixes: options.useCompositePrefixes
                 })(incomingConfig);
             }
-            return incomingConfig;
-        }
-        const adapter = createVercelBlobAdapter({
-            access: optionsWithDefaults.access ?? 'public',
-            addRandomSuffix: optionsWithDefaults.addRandomSuffix,
-            baseUrl,
-            cacheControlMaxAge: optionsWithDefaults.cacheControlMaxAge ?? 60 * 60 * 24 * 365,
-            clientUploads: optionsWithDefaults.clientUploads,
-            token: options.token,
-            useCompositePrefixes: options.useCompositePrefixes
-        });
-        // Add adapter to each collection option object
-        const collectionsWithAdapter = Object.entries(options.collections).reduce((acc, [slug, collOptions])=>({
-                ...acc,
-                [slug]: {
-                    ...collOptions === true ? {} : collOptions,
-                    adapter
-                }
-            }), {});
-        // Set disableLocalStorage: true for collections specified in the plugin options
-        const config = {
-            ...incomingConfig,
-            collections: (incomingConfig.collections || []).map((collection)=>{
-                if (!collectionsWithAdapter[collection.slug]) {
-                    return collection;
-                }
-                return {
-                    ...collection,
-                    upload: {
-                        ...typeof collection.upload === 'object' ? collection.upload : {},
-                        disableLocalStorage: true
+            if (options.addRandomSuffix && storageAdapter.collections.length > 0) {
+                throw new Error('Vercel Blob addRandomSuffix must be false. Payload requires exact storage paths and already allocates unique object folders.');
+            }
+            const adapter = createVercelBlobAdapter({
+                access: optionsWithDefaults.access ?? 'public',
+                addRandomSuffix: optionsWithDefaults.addRandomSuffix,
+                baseUrl,
+                cacheControlMaxAge: optionsWithDefaults.cacheControlMaxAge ?? 60 * 60 * 24 * 365,
+                clientUploads: optionsWithDefaults.clientUploads,
+                collectionSources: getCollectionSources({
+                    currentAdapter: storageAdapter,
+                    storageAdapters: incomingConfig.storage
+                }),
+                token: options.token,
+                useCompositePrefixes: options.useCompositePrefixes
+            });
+            // Add adapter to each collection option object
+            const collectionsWithAdapter = Object.entries(options.collections).reduce((acc, [slug, collOptions])=>({
+                    ...acc,
+                    [slug]: {
+                        ...collOptions === true ? {} : collOptions,
+                        adapter
                     }
-                };
-            })
-        };
-        return cloudStoragePlugin({
-            alwaysInsertFields: options.alwaysInsertFields,
-            collections: collectionsWithAdapter,
-            useCompositePrefixes: options.useCompositePrefixes
-        })(config);
+                }), {});
+            // Set disableLocalStorage: true for collections specified in the plugin options
+            const config = {
+                ...incomingConfig,
+                collections: (incomingConfig.collections || []).map((collection)=>{
+                    if (!collectionsWithAdapter[collection.slug]) {
+                        return collection;
+                    }
+                    return {
+                        ...collection,
+                        upload: {
+                            ...typeof collection.upload === 'object' ? collection.upload : {},
+                            disableLocalStorage: true
+                        }
+                    };
+                })
+            };
+            return cloudStoragePlugin({
+                collections: collectionsWithAdapter,
+                useCompositePrefixes: options.useCompositePrefixes
+            })(config);
+        },
+        [vercelBlobStorageMetadata]: {
+            collections: options.collections,
+            enabled: !isPluginDisabled,
+            storeId,
+            useCompositePrefixes: Boolean(options.useCompositePrefixes)
+        }
     };
+    return storageAdapter;
+};
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type {\n  ClientUploadsConfig,\n  PluginOptions as CloudStoragePluginOptions,\n  CollectionOptions,\n} from '@payloadcms/plugin-cloud-storage/types'\nimport type { Config, Plugin, UploadCollectionSlug } from 'payload'\n\nimport { cloudStoragePlugin } from '@payloadcms/plugin-cloud-storage'\nimport { initClientUploads } from '@payloadcms/plugin-cloud-storage/utilities'\n\nimport type { VercelBlobClientUploadHandlerExtra } from './client/VercelBlobClientUploadHandler.js'\n\nimport { createVercelBlobAdapter } from './adapter.js'\nimport { getClientUploadRoute } from './getClientUploadRoute.js'\n\nexport type VercelBlobStorageOptions = {\n  /**\n   * Access control level. Currently, only 'public' is supported.\n   * Vercel plans on adding support for private blobs in the future.\n   *\n   * @default 'public'\n   */\n  access?: 'public'\n\n  /**\n   * Add a random suffix to the uploaded file name in Vercel Blob storage\n   *\n   * @default false\n   */\n  addRandomSuffix?: boolean\n\n  /**\n   * When enabled, fields (like the prefix field) will always be inserted into\n   * the collection schema regardless of whether the plugin is enabled. This\n   * ensures a consistent schema across all environments.\n   *\n   * This will be enabled by default in Payload v4.\n   *\n   * @default false\n   */\n  alwaysInsertFields?: boolean\n\n  /**\n   * Cache-Control max-age in seconds\n   *\n   * @default 365 * 24 * 60 * 60 // (1 Year)\n   */\n  cacheControlMaxAge?: number\n\n  /**\n   * Do uploads directly on the client, to bypass limits on Vercel.\n   */\n  clientUploads?: ClientUploadsConfig\n\n  /**\n   * Collections to apply the Vercel Blob adapter to\n   */\n  collections: Partial<Record<UploadCollectionSlug, Omit<CollectionOptions, 'adapter'> | true>>\n\n  /**\n   * Whether or not to enable the plugin\n   *\n   * Default: true\n   */\n  enabled?: boolean\n  /**\n   * Vercel Blob storage read/write token\n   *\n   * Usually process.env.BLOB_READ_WRITE_TOKEN set by Vercel\n   *\n   * If unset, the plugin will be disabled and will fallback to local storage\n   */\n  token: string | undefined\n\n  /**\n   * When true, the collection-level prefix and document-level prefix are combined\n   * (compositional). When false (default), a document prefix already within the\n   * collection prefix is used as-is for new uploads; otherwise it is nested beneath it.\n   * Existing files retain their stored prefixes for reads, URLs, and cleanup.\n   *\n   * Example with a document prefix already contained by the collection prefix:\n   * - collection prefix: `uploads/`\n   * - document prefix: `uploads/documents/`\n   * - resulting prefix with useCompositePrefixes=true: `uploads/uploads/documents/`\n   * - resulting prefix with useCompositePrefixes=false: `uploads/documents/`\n   *\n   * @default false\n   */\n  useCompositePrefixes?: boolean\n}\n\nconst defaultUploadOptions: Partial<VercelBlobStorageOptions> = {\n  access: 'public',\n  addRandomSuffix: false,\n  cacheControlMaxAge: 60 * 60 * 24 * 365, // 1 year\n  enabled: true,\n}\n\ntype VercelBlobStoragePlugin = (vercelBlobStorageOpts: VercelBlobStorageOptions) => Plugin\n\nexport const vercelBlobStorage: VercelBlobStoragePlugin =\n  (options: VercelBlobStorageOptions) =>\n  (incomingConfig: Config): Config => {\n    // Parse storeId from token\n    const storeId = options.token\n      ?.match(/^vercel_blob_rw_([a-z\\d]+)_[a-z\\d]+$/i)?.[1]\n      ?.toLowerCase()\n\n    const isPluginDisabled = options.enabled === false || !options.token\n\n    // Don't throw if the plugin is disabled\n    if (!storeId && !isPluginDisabled) {\n      throw new Error(\n        'Invalid token format for Vercel Blob adapter. Should be vercel_blob_rw_<store_id>_<random_string>.',\n      )\n    }\n\n    const optionsWithDefaults = {\n      ...defaultUploadOptions,\n      ...options,\n    }\n\n    // support overriding the base URL for emulator https://github.com/payloadcms/vercel-blob-emulator\n    const baseUrl =\n      process.env.STORAGE_VERCEL_BLOB_BASE_URL ||\n      `https://${storeId}.${optionsWithDefaults.access}.blob.vercel-storage.com`\n\n    initClientUploads<\n      VercelBlobClientUploadHandlerExtra,\n      VercelBlobStorageOptions['collections'][string]\n    >({\n      clientHandler: '@payloadcms/storage-vercel-blob/client#VercelBlobClientUploadHandler',\n      collections: options.collections,\n      config: incomingConfig,\n      enabled: !isPluginDisabled && Boolean(options.clientUploads),\n      extraClientHandlerProps: () => ({\n        addRandomSuffix: !!optionsWithDefaults.addRandomSuffix,\n        useCompositePrefixes: !!options.useCompositePrefixes,\n      }),\n      serverHandler: getClientUploadRoute({\n        access:\n          typeof options.clientUploads === 'object' ? options.clientUploads.access : undefined,\n        addRandomSuffix: optionsWithDefaults.addRandomSuffix,\n        cacheControlMaxAge: options.cacheControlMaxAge,\n        collections: options.collections,\n        token: options.token ?? '',\n        useCompositePrefixes: optionsWithDefaults.useCompositePrefixes,\n      }),\n      serverHandlerPath: '/vercel-blob-client-upload-route',\n    })\n\n    // If the plugin is disabled or no token is provided, do not enable the plugin\n    if (isPluginDisabled) {\n      if (options.alwaysInsertFields) {\n        const collectionsWithoutAdapter: CloudStoragePluginOptions['collections'] = Object.entries(\n          options.collections,\n        ).reduce(\n          (acc, [slug, collOptions]) => ({\n            ...acc,\n            [slug]: { ...(collOptions === true ? {} : collOptions), adapter: null },\n          }),\n          {} as Record<string, CollectionOptions>,\n        )\n        return cloudStoragePlugin({\n          alwaysInsertFields: true,\n          collections: collectionsWithoutAdapter,\n          enabled: false,\n          useCompositePrefixes: options.useCompositePrefixes,\n        })(incomingConfig)\n      }\n      return incomingConfig\n    }\n\n    const adapter = createVercelBlobAdapter({\n      access: optionsWithDefaults.access ?? 'public',\n      addRandomSuffix: optionsWithDefaults.addRandomSuffix,\n      baseUrl,\n      cacheControlMaxAge: optionsWithDefaults.cacheControlMaxAge ?? 60 * 60 * 24 * 365,\n      clientUploads: optionsWithDefaults.clientUploads,\n      token: options.token!,\n      useCompositePrefixes: options.useCompositePrefixes,\n    })\n\n    // Add adapter to each collection option object\n    const collectionsWithAdapter: CloudStoragePluginOptions['collections'] = Object.entries(\n      options.collections,\n    ).reduce(\n      (acc, [slug, collOptions]) => ({\n        ...acc,\n        [slug]: {\n          ...(collOptions === true ? {} : collOptions),\n          adapter,\n        },\n      }),\n      {} as Record<string, CollectionOptions>,\n    )\n\n    // Set disableLocalStorage: true for collections specified in the plugin options\n    const config = {\n      ...incomingConfig,\n      collections: (incomingConfig.collections || []).map((collection) => {\n        if (!collectionsWithAdapter[collection.slug]) {\n          return collection\n        }\n\n        return {\n          ...collection,\n          upload: {\n            ...(typeof collection.upload === 'object' ? collection.upload : {}),\n            disableLocalStorage: true,\n          },\n        }\n      }),\n    }\n\n    return cloudStoragePlugin({\n      alwaysInsertFields: options.alwaysInsertFields,\n      collections: collectionsWithAdapter,\n      useCompositePrefixes: options.useCompositePrefixes,\n    })(config)\n  }\n"],"names":["cloudStoragePlugin","initClientUploads","createVercelBlobAdapter","getClientUploadRoute","defaultUploadOptions","access","addRandomSuffix","cacheControlMaxAge","enabled","vercelBlobStorage","options","incomingConfig","storeId","token","match","toLowerCase","isPluginDisabled","Error","optionsWithDefaults","baseUrl","process","env","STORAGE_VERCEL_BLOB_BASE_URL","clientHandler","collections","config","Boolean","clientUploads","extraClientHandlerProps","useCompositePrefixes","serverHandler","undefined","serverHandlerPath","alwaysInsertFields","collectionsWithoutAdapter","Object","entries","reduce","acc","slug","collOptions","adapter","collectionsWithAdapter","map","collection","upload","disableLocalStorage"],"mappings":"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"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type {\n  ClientUploadsConfig,\n  PluginOptions as CloudStoragePluginOptions,\n  CollectionOptions,\n} from '@payloadcms/plugin-cloud-storage/types'\nimport type { Config, StorageAdapter, UploadCollectionSlug } from 'payload'\n\nimport { cloudStoragePlugin } from '@payloadcms/plugin-cloud-storage'\n\nimport { createVercelBlobAdapter } from './adapter.js'\nimport {\n  getCollectionSources,\n  type InternalVercelBlobStorageAdapter,\n  vercelBlobStorageMetadata,\n} from './getCollectionSources.js'\n\nexport type VercelBlobStorageOptions = {\n  /**\n   * Access control level. Currently, only 'public' is supported.\n   * Vercel plans on adding support for private blobs in the future.\n   *\n   * @default 'public'\n   */\n  access?: 'public'\n\n  /**\n   * Must be false or omitted for enabled adapters with configured collections.\n   * Payload requires exact storage paths and allocates unique object folders.\n   *\n   * @default false\n   */\n  addRandomSuffix?: boolean\n\n  /**\n   * Cache-Control max-age in seconds\n   *\n   * @default 365 * 24 * 60 * 60 // (1 Year)\n   */\n  cacheControlMaxAge?: number\n\n  /**\n   * Upload directly to Vercel Blob instead of through Payload.\n   */\n  clientUploads?: ClientUploadsConfig\n\n  /**\n   * Collections to apply the Vercel Blob adapter to\n   */\n  collections: Partial<Record<UploadCollectionSlug, Omit<CollectionOptions, 'adapter'> | true>>\n\n  /**\n   * Whether or not to enable the plugin\n   *\n   * Default: true\n   */\n  enabled?: boolean\n  /**\n   * Vercel Blob storage read/write token\n   *\n   * Usually process.env.BLOB_READ_WRITE_TOKEN set by Vercel\n   *\n   * If unset, the plugin will be disabled and will fallback to local storage\n   */\n  token: string | undefined\n\n  /**\n   * When true, the collection-level prefix and document-level prefix are combined\n   * (compositional). When false (default), a document prefix already within the\n   * collection prefix is used as-is for new uploads; otherwise it is nested beneath it.\n   * Existing files retain their stored prefixes for reads, URLs, and cleanup.\n   *\n   * Example with a document prefix already contained by the collection prefix:\n   * - collection prefix: `uploads/`\n   * - document prefix: `uploads/documents/`\n   * - resulting prefix with useCompositePrefixes=true: `uploads/uploads/documents/`\n   * - resulting prefix with useCompositePrefixes=false: `uploads/documents/`\n   *\n   * @default false\n   */\n  useCompositePrefixes?: boolean\n}\n\nconst defaultUploadOptions: Partial<VercelBlobStorageOptions> = {\n  access: 'public',\n  addRandomSuffix: false,\n  cacheControlMaxAge: 60 * 60 * 24 * 365, // 1 year\n  enabled: true,\n}\n\ntype VercelBlobStorageFactory = (vercelBlobStorageOpts: VercelBlobStorageOptions) => StorageAdapter\n\nexport const vercelBlobStorage: VercelBlobStorageFactory = (\n  options: VercelBlobStorageOptions,\n): StorageAdapter => {\n  const storeId = options.token?.match(/^vercel_blob_rw_([a-z\\d]+)_[a-z\\d]+$/i)?.[1]?.toLowerCase()\n  const isPluginDisabled = options.enabled === false || !options.token\n  const storageAdapter: InternalVercelBlobStorageAdapter = {\n    name: 'vercel-blob',\n    collections: Object.keys(options.collections),\n    init: (incomingConfig: Config): Config => {\n      // Don't throw if the plugin is disabled\n      if (!storeId && !isPluginDisabled) {\n        throw new Error(\n          'Invalid token format for Vercel Blob adapter. Should be vercel_blob_rw_<store_id>_<random_string>.',\n        )\n      }\n\n      const optionsWithDefaults = {\n        ...defaultUploadOptions,\n        ...options,\n      }\n\n      // support overriding the base URL for emulator https://github.com/payloadcms/vercel-blob-emulator\n      const baseUrl =\n        process.env.STORAGE_VERCEL_BLOB_BASE_URL ||\n        `https://${storeId}.${optionsWithDefaults.access}.blob.vercel-storage.com`\n\n      // If the plugin is disabled or no token is provided, do not enable the plugin\n      if (isPluginDisabled) {\n        const collectionsWithoutAdapter: CloudStoragePluginOptions['collections'] = Object.entries(\n          options.collections,\n        ).reduce(\n          (acc, [slug, collOptions]) => ({\n            ...acc,\n            [slug]: { ...(collOptions === true ? {} : collOptions), adapter: null },\n          }),\n          {} as Record<string, CollectionOptions>,\n        )\n        return cloudStoragePlugin({\n          collections: collectionsWithoutAdapter,\n          enabled: false,\n          useCompositePrefixes: options.useCompositePrefixes,\n        })(incomingConfig)\n      }\n\n      if (options.addRandomSuffix && storageAdapter.collections.length > 0) {\n        throw new Error(\n          'Vercel Blob addRandomSuffix must be false. Payload requires exact storage paths and already allocates unique object folders.',\n        )\n      }\n\n      const adapter = createVercelBlobAdapter({\n        access: optionsWithDefaults.access ?? 'public',\n        addRandomSuffix: optionsWithDefaults.addRandomSuffix,\n        baseUrl,\n        cacheControlMaxAge: optionsWithDefaults.cacheControlMaxAge ?? 60 * 60 * 24 * 365,\n        clientUploads: optionsWithDefaults.clientUploads,\n        collectionSources: getCollectionSources({\n          currentAdapter: storageAdapter,\n          storageAdapters: incomingConfig.storage,\n        }),\n        token: options.token!,\n        useCompositePrefixes: options.useCompositePrefixes,\n      })\n\n      // Add adapter to each collection option object\n      const collectionsWithAdapter: CloudStoragePluginOptions['collections'] = Object.entries(\n        options.collections,\n      ).reduce(\n        (acc, [slug, collOptions]) => ({\n          ...acc,\n          [slug]: {\n            ...(collOptions === true ? {} : collOptions),\n            adapter,\n          },\n        }),\n        {} as Record<string, CollectionOptions>,\n      )\n\n      // Set disableLocalStorage: true for collections specified in the plugin options\n      const config = {\n        ...incomingConfig,\n        collections: (incomingConfig.collections || []).map((collection) => {\n          if (!collectionsWithAdapter[collection.slug]) {\n            return collection\n          }\n\n          return {\n            ...collection,\n            upload: {\n              ...(typeof collection.upload === 'object' ? collection.upload : {}),\n              disableLocalStorage: true,\n            },\n          }\n        }),\n      }\n\n      return cloudStoragePlugin({\n        collections: collectionsWithAdapter,\n        useCompositePrefixes: options.useCompositePrefixes,\n      })(config)\n    },\n    [vercelBlobStorageMetadata]: {\n      collections: options.collections,\n      enabled: !isPluginDisabled,\n      storeId,\n      useCompositePrefixes: Boolean(options.useCompositePrefixes),\n    },\n  }\n\n  return storageAdapter\n}\n"],"names":["cloudStoragePlugin","createVercelBlobAdapter","getCollectionSources","vercelBlobStorageMetadata","defaultUploadOptions","access","addRandomSuffix","cacheControlMaxAge","enabled","vercelBlobStorage","options","storeId","token","match","toLowerCase","isPluginDisabled","storageAdapter","name","collections","Object","keys","init","incomingConfig","Error","optionsWithDefaults","baseUrl","process","env","STORAGE_VERCEL_BLOB_BASE_URL","collectionsWithoutAdapter","entries","reduce","acc","slug","collOptions","adapter","useCompositePrefixes","length","clientUploads","collectionSources","currentAdapter","storageAdapters","storage","collectionsWithAdapter","config","map","collection","upload","disableLocalStorage","Boolean"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/storage-vercel-blob",
-  "version": "3.91.0-internal.c1569dc",
+  "version": "4.0.0-beta.0",
   "description": "Payload storage adapter for Vercel Blob Storage",
   "homepage": "https://payloadcms.com",
   "repository": {
@@ -38,16 +38,16 @@
   ],
   "dependencies": {
     "@vercel/blob": "2.3.1",
-    "@payloadcms/plugin-cloud-storage": "3.91.0-internal.c1569dc"
+    "@payloadcms/plugin-cloud-storage": "4.0.0-beta.0"
   },
   "devDependencies": {
-    "payload": "3.91.0-internal.c1569dc"
+    "payload": "4.0.0-beta.0"
   },
   "peerDependencies": {
-    "payload": "3.91.0-internal.c1569dc"
+    "payload": "4.0.0-beta.0"
   },
   "engines": {
-    "node": "^18.20.2 || >=20.9.0"
+    "node": ">=24.15.0"
   },
   "scripts": {
     "build": "pnpm build:types && pnpm build:swc",