@payloadcms/storage-vercel-blob 4.0.0-internal.b8e7c89 → 4.0.0-internal.bf4bcce

package/dist/deleteFile.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/deleteFile.ts"],"sourcesContent":["import { del } from '@vercel/blob'\n\nimport { generateURL } from './generateURL.js'\n\ninterface DeleteFileArgs {\n  baseUrl: string\n  collectionPrefix?: string\n  docPrefix: string\n  filename: string\n  token: string\n  useCompositePrefixes?: boolean\n}\n\nexport async function deleteFile({\n  baseUrl,\n  collectionPrefix = '',\n  docPrefix,\n  filename,\n  token,\n  useCompositePrefixes = false,\n}: DeleteFileArgs): Promise<void> {\n  const fileUrl = generateURL({\n    baseUrl,\n    collectionPrefix,\n    filename,\n    prefix: docPrefix,\n    useCompositePrefixes,\n  })\n\n  await del(fileUrl, { token })\n}\n"],"names":["del","generateURL","deleteFile","baseUrl","collectionPrefix","docPrefix","filename","token","useCompositePrefixes","fileUrl","prefix"],"mappings":"AAAA,SAASA,GAAG,QAAQ,eAAc;AAElC,SAASC,WAAW,QAAQ,mBAAkB;AAW9C,OAAO,eAAeC,WAAW,EAC/BC,OAAO,EACPC,mBAAmB,EAAE,EACrBC,SAAS,EACTC,QAAQ,EACRC,KAAK,EACLC,uBAAuB,KAAK,EACb;IACf,MAAMC,UAAUR,YAAY;QAC1BE;QACAC;QACAE;QACAI,QAAQL;QACRG;IACF;IAEA,MAAMR,IAAIS,SAAS;QAAEF;IAAM;AAC7B"}
+{"version":3,"sources":["../src/deleteFile.ts"],"sourcesContent":["import { del } from '@vercel/blob'\n\nimport { buildBlobUrl } from './generateURL.js'\n\ninterface DeleteFileArgs {\n  baseUrl: string\n  storageFilePath: string\n  token: string\n}\n\nexport async function deleteFile({\n  baseUrl,\n  storageFilePath,\n  token,\n}: DeleteFileArgs): Promise<void> {\n  await del(buildBlobUrl(baseUrl, storageFilePath), { token })\n}\n"],"names":["del","buildBlobUrl","deleteFile","baseUrl","storageFilePath","token"],"mappings":"AAAA,SAASA,GAAG,QAAQ,eAAc;AAElC,SAASC,YAAY,QAAQ,mBAAkB;AAQ/C,OAAO,eAAeC,WAAW,EAC/BC,OAAO,EACPC,eAAe,EACfC,KAAK,EACU;IACf,MAAML,IAAIC,aAAaE,SAASC,kBAAkB;QAAEC;IAAM;AAC5D"}

package/dist/generateURL.d.ts

@@ -5,6 +5,7 @@ interface GenerateURLArgs {
     prefix: string;
     useCompositePrefixes?: boolean;
 }
+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;AAED,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,gBAAqB,EACrB,QAAQ,EACR,MAAM,EACN,oBAA4B,GAC7B,EAAE,eAAe,GAAG,MAAM,CAgB1B"}
+{"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,19 +1,23 @@
-import { getFileKey } from '@payloadcms/plugin-cloud-storage/utilities';
+import { buildStoragePathData } from '@payloadcms/plugin-cloud-storage/utilities';
 import path from 'path';
+// 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(storageFilePath);
+    // example: "my file.jpg" -> "my%20file.jpg"
+    const encodedFilename = encodeURIComponent(path.posix.basename(storageFilePath));
+    // example: "my-collection/my-doc/my%20file.jpg"
+    const storageFilePathWithEncodedFilename = dir === '.' ? encodedFilename : path.posix.join(dir, encodedFilename);
+    return `${baseUrl}/${storageFilePathWithEncodedFilename}`;
+}
 export function generateURL({ baseUrl, collectionPrefix = '', filename, prefix, useCompositePrefixes = false }) {
-    const { fileKey: fileKeyWithPrefix } = getFileKey({
+    const { storageFilePath } = buildStoragePathData({
         collectionPrefix,
         docPrefix: prefix,
         filename,
         useCompositePrefixes
     });
-    // example: "my-collection/my-doc/my file.jpg" -> "my-collection/my-doc"
-    const dir = path.posix.dirname(fileKeyWithPrefix);
-    // example: "my file.jpg" -> "my%20file.jpg"
-    const encodedFilename = encodeURIComponent(path.posix.basename(fileKeyWithPrefix));
-    // example: "my-collection/my-doc/my%20file.jpg"
-    const fileKeyWithEncodedFilename = dir === '.' ? encodedFilename : path.posix.join(dir, encodedFilename);
-    return `${baseUrl}/${fileKeyWithEncodedFilename}`;
+    return buildBlobUrl(baseUrl, storageFilePath);
 }
 
 //# sourceMappingURL=generateURL.js.map

package/dist/generateURL.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/generateURL.ts"],"sourcesContent":["import { getFileKey } 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\nexport function generateURL({\n  baseUrl,\n  collectionPrefix = '',\n  filename,\n  prefix,\n  useCompositePrefixes = false,\n}: GenerateURLArgs): string {\n  const { fileKey: fileKeyWithPrefix } = getFileKey({\n    collectionPrefix,\n    docPrefix: prefix,\n    filename,\n    useCompositePrefixes,\n  })\n  // example: \"my-collection/my-doc/my file.jpg\" -> \"my-collection/my-doc\"\n  const dir = path.posix.dirname(fileKeyWithPrefix)\n  // example: \"my file.jpg\" -> \"my%20file.jpg\"\n  const encodedFilename = encodeURIComponent(path.posix.basename(fileKeyWithPrefix))\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"],"names":["getFileKey","path","generateURL","baseUrl","collectionPrefix","filename","prefix","useCompositePrefixes","fileKey","fileKeyWithPrefix","docPrefix","dir","posix","dirname","encodedFilename","encodeURIComponent","basename","fileKeyWithEncodedFilename","join"],"mappings":"AAAA,SAASA,UAAU,QAAQ,6CAA4C;AACvE,OAAOC,UAAU,OAAM;AAUvB,OAAO,SAASC,YAAY,EAC1BC,OAAO,EACPC,mBAAmB,EAAE,EACrBC,QAAQ,EACRC,MAAM,EACNC,uBAAuB,KAAK,EACZ;IAChB,MAAM,EAAEC,SAASC,iBAAiB,EAAE,GAAGT,WAAW;QAChDI;QACAM,WAAWJ;QACXD;QACAE;IACF;IACA,wEAAwE;IACxE,MAAMI,MAAMV,KAAKW,KAAK,CAACC,OAAO,CAACJ;IAC/B,4CAA4C;IAC5C,MAAMK,kBAAkBC,mBAAmBd,KAAKW,KAAK,CAACI,QAAQ,CAACP;IAC/D,gDAAgD;IAChD,MAAMQ,6BACJN,QAAQ,MAAMG,kBAAkBb,KAAKW,KAAK,CAACM,IAAI,CAACP,KAAKG;IAEvD,OAAO,GAAGX,QAAQ,CAAC,EAAEc,4BAA4B;AACnD"}
+{"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 } from 'payload';
+import type { CollectionConfig, FileHandlerOperation, PayloadRequest, TypeWithID } from 'payload';
 interface GetFileArgs {
     baseUrl: string;
     cacheControlMaxAge: number;
     collection: CollectionConfig;
     collectionPrefix?: string;
+    doc?: TypeWithID;
     filename: string;
     incomingHeaders?: Headers;
-    prefixQueryParam?: string;
+    operation?: FileHandlerOperation;
     req: PayloadRequest;
     token: string;
     uploadReference?: unknown;
     useCompositePrefixes?: boolean;
 }
-export declare function getFile({ baseUrl, cacheControlMaxAge, collection, collectionPrefix, filename, incomingHeaders, prefixQueryParam, req, token, uploadReference, 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,MAAM,SAAS,CAAA;AAQ/D,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB,EAAE,MAAM,CAAA;IAC1B,UAAU,EAAE,gBAAgB,CAAA;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,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,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,GAAG,EACH,KAAK,EACL,eAAe,EACf,oBAA4B,GAC7B,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CA8FjC"}
+{"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,15 +1,18 @@
 import { getFilePrefix as getDocPrefix } from '@payloadcms/plugin-cloud-storage/utilities';
 import { BlobNotFoundError, head } from '@vercel/blob';
-import { getRangeRequestInfo } from 'payload/internal';
+import { getRangeRequestInfo, isXmlMimeType, uploadContentSecurityPolicy } from 'payload/internal';
 import { generateURL } from './generateURL.js';
-export async function getFile({ baseUrl, cacheControlMaxAge, collection, collectionPrefix = '', filename, incomingHeaders, prefixQueryParam, req, token, uploadReference, 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({
             collection,
+            collectionPrefix,
+            doc,
             filename,
-            prefixQueryParam,
             req,
-            uploadReference
+            uploadReference,
+            useCompositePrefixes
         });
         const fileUrl = generateURL({
             baseUrl,
@@ -26,8 +29,7 @@ export async function getFile({ baseUrl, cacheControlMaxAge, collection, collect
         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
@@ -39,7 +41,6 @@ export async function getFile({ baseUrl, cacheControlMaxAge, collection, collect
             });
         }
         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);
         }
@@ -47,16 +48,16 @@ export async function getFile({ baseUrl, cacheControlMaxAge, collection, collect
         headers.append('Content-Disposition', contentDisposition);
         headers.append('Content-Type', contentType);
         headers.append('ETag', ETag);
-        // Add Content-Security-Policy header for SVG files to prevent executable code
-        if (contentType === 'image/svg+xml') {
-            headers.append('Content-Security-Policy', "script-src 'none'");
+        // Apply a restrictive policy to XML-family responses served through Payload.
+        if (isXmlMimeType(contentType)) {
+            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
@@ -72,6 +73,13 @@ export async function getFile({ baseUrl, cacheControlMaxAge, collection, collect
             }
         });
         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 } from 'payload'\n\nimport { getFilePrefix as getDocPrefix } from '@payloadcms/plugin-cloud-storage/utilities'\nimport { BlobNotFoundError, head } from '@vercel/blob'\nimport { getRangeRequestInfo } 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  filename: string\n  incomingHeaders?: Headers\n  prefixQueryParam?: string\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  filename,\n  incomingHeaders,\n  prefixQueryParam,\n  req,\n  token,\n  uploadReference,\n  useCompositePrefixes = false,\n}: GetFileArgs): Promise<Response> {\n  try {\n    const docPrefix = await getDocPrefix({\n      collection,\n      filename,\n      prefixQueryParam,\n      req,\n      uploadReference,\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 SVG files to prevent executable code\n    if (contentType === 'image/svg+xml') {\n      headers.append('Content-Security-Policy', \"script-src 'none'\")\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","generateURL","getFile","baseUrl","cacheControlMaxAge","collection","collectionPrefix","filename","incomingHeaders","prefixQueryParam","req","token","uploadReference","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

@@ -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
      *
@@ -54,14 +45,15 @@ export type VercelBlobStorageOptions = {
     token: string | undefined;
     /**
      * When true, the collection-level prefix and document-level prefix are combined
-     * (compositional). When false (default), document prefix overrides collection
-     * prefix entirely.
+     * (compositional). When false (default), a document prefix already within the
+     * collection prefix is used as-is for new uploads; otherwise it is nested beneath it.
+     * Existing files retain their stored prefixes for reads, URLs, and cleanup.
      *
-     * Example:
-     * - collection prefix: `collection-prefix/`
-     * - document prefix: `document-prefix/`
-     * - resulting prefix with useCompositePrefixes=true: `collection-prefix/document-prefix/`
-     * - resulting prefix with useCompositePrefixes=false: `document-prefix/`
+     * Example with a document prefix already contained by the collection prefix:
+     * - collection prefix: `uploads/`
+     * - document prefix: `uploads/documents/`
+     * - resulting prefix with useCompositePrefixes=true: `uploads/uploads/documents/`
+     * - resulting prefix with useCompositePrefixes=false: `uploads/documents/`
      *
      * @default false
      */

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,cAAc,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAM3E,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;;;;;;;;;;;;OAYG;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,wBAoG9B,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,18 +1,19 @@
 import { cloudStoragePlugin } from '@payloadcms/plugin-cloud-storage';
 import { createVercelBlobAdapter } from './adapter.js';
+import { getCollectionSources, vercelBlobStorageMetadata } from './getCollectionSources.js';
 const defaultUploadOptions = {
     access: 'public',
     addRandomSuffix: false,
     cacheControlMaxAge: 60 * 60 * 24 * 365,
     enabled: true
 };
-export const vercelBlobStorage = (options)=>({
+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)=>{
-            // 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>.');
@@ -25,22 +26,21 @@ export const vercelBlobStorage = (options)=>({
             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) {
-                if (options.alwaysInsertFields) {
-                    const collectionsWithoutAdapter = Object.entries(options.collections).reduce((acc, [slug, collOptions])=>({
-                            ...acc,
-                            [slug]: {
-                                ...collOptions === true ? {} : collOptions,
-                                adapter: null
-                            }
-                        }), {});
-                    return cloudStoragePlugin({
-                        alwaysInsertFields: true,
-                        collections: collectionsWithoutAdapter,
-                        enabled: false,
-                        useCompositePrefixes: options.useCompositePrefixes
-                    })(incomingConfig);
-                }
-                return incomingConfig;
+                const collectionsWithoutAdapter = Object.entries(options.collections).reduce((acc, [slug, collOptions])=>({
+                        ...acc,
+                        [slug]: {
+                            ...collOptions === true ? {} : collOptions,
+                            adapter: null
+                        }
+                    }), {});
+                return cloudStoragePlugin({
+                    collections: collectionsWithoutAdapter,
+                    enabled: false,
+                    useCompositePrefixes: options.useCompositePrefixes
+                })(incomingConfig);
+            }
+            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',
@@ -48,6 +48,10 @@ export const vercelBlobStorage = (options)=>({
                 baseUrl,
                 cacheControlMaxAge: optionsWithDefaults.cacheControlMaxAge ?? 60 * 60 * 24 * 365,
                 clientUploads: optionsWithDefaults.clientUploads,
+                collectionSources: getCollectionSources({
+                    currentAdapter: storageAdapter,
+                    storageAdapters: incomingConfig.storage
+                }),
                 token: options.token,
                 useCompositePrefixes: options.useCompositePrefixes
             });
@@ -76,11 +80,18 @@ export const vercelBlobStorage = (options)=>({
                 })
             };
             return cloudStoragePlugin({
-                alwaysInsertFields: options.alwaysInsertFields,
                 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, StorageAdapter, UploadCollectionSlug } from 'payload'\n\nimport { cloudStoragePlugin } from '@payloadcms/plugin-cloud-storage'\n\nimport { createVercelBlobAdapter } from './adapter.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   * 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), document prefix overrides collection\n   * prefix entirely.\n   *\n   * Example:\n   * - collection prefix: `collection-prefix/`\n   * - document prefix: `document-prefix/`\n   * - resulting prefix with useCompositePrefixes=true: `collection-prefix/document-prefix/`\n   * - resulting prefix with useCompositePrefixes=false: `document-prefix/`\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  name: 'vercel-blob',\n  collections: Object.keys(options.collections),\n  init: (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    // 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})\n"],"names":["cloudStoragePlugin","createVercelBlobAdapter","defaultUploadOptions","access","addRandomSuffix","cacheControlMaxAge","enabled","vercelBlobStorage","options","name","collections","Object","keys","init","incomingConfig","storeId","token","match","toLowerCase","isPluginDisabled","Error","optionsWithDefaults","baseUrl","process","env","STORAGE_VERCEL_BLOB_BASE_URL","alwaysInsertFields","collectionsWithoutAdapter","entries","reduce","acc","slug","collOptions","adapter","useCompositePrefixes","clientUploads","collectionsWithAdapter","config","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/dist/uploadFile.d.ts

@@ -3,16 +3,13 @@ interface UploadFileArgs {
     addRandomSuffix?: boolean;
     buffer: Buffer;
     cacheControlMaxAge?: number;
-    collectionPrefix?: string;
-    docPrefix?: string;
-    filename: string;
     mimeType: string;
+    storageFilePath: string;
     token: string;
-    useCompositePrefixes?: boolean;
 }
 interface UploadFileResult {
     filename?: string;
 }
-export declare function uploadFile({ access, addRandomSuffix, buffer, cacheControlMaxAge, collectionPrefix, docPrefix, filename, mimeType, token, useCompositePrefixes, }: UploadFileArgs): Promise<UploadFileResult>;
+export declare function uploadFile({ access, addRandomSuffix, buffer, cacheControlMaxAge, mimeType, storageFilePath, token, }: UploadFileArgs): Promise<UploadFileResult>;
 export {};
 //# sourceMappingURL=uploadFile.d.ts.map

package/dist/uploadFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uploadFile.d.ts","sourceRoot":"","sources":["../src/uploadFile.ts"],"names":[],"mappings":"AAIA,UAAU,cAAc;IACtB,MAAM,EAAE,QAAQ,CAAA;IAChB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,wBAAsB,UAAU,CAAC,EAC/B,MAAM,EACN,eAAe,EACf,MAAM,EACN,kBAAkB,EAClB,gBAAqB,EACrB,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,oBAA4B,GAC7B,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwB5C"}
+{"version":3,"file":"uploadFile.d.ts","sourceRoot":"","sources":["../src/uploadFile.ts"],"names":[],"mappings":"AAGA,UAAU,cAAc;IACtB,MAAM,EAAE,QAAQ,CAAA;IAChB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,wBAAsB,UAAU,CAAC,EAC/B,MAAM,EACN,eAAe,EACf,MAAM,EACN,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,KAAK,GACN,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiB5C"}

package/dist/uploadFile.js

@@ -1,14 +1,7 @@
-import { getFileKey } from '@payloadcms/plugin-cloud-storage/utilities';
 import { put } from '@vercel/blob';
 import path from 'path';
-export async function uploadFile({ access, addRandomSuffix, buffer, cacheControlMaxAge, collectionPrefix = '', docPrefix, filename, mimeType, token, useCompositePrefixes = false }) {
-    const { fileKey } = getFileKey({
-        collectionPrefix,
-        docPrefix,
-        filename,
-        useCompositePrefixes
-    });
-    const result = await put(fileKey, buffer, {
+export async function uploadFile({ access, addRandomSuffix, buffer, cacheControlMaxAge, mimeType, storageFilePath, token }) {
+    const result = await put(storageFilePath, buffer, {
         access,
         addRandomSuffix,
         allowOverwrite: true,

package/dist/uploadFile.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/uploadFile.ts"],"sourcesContent":["import { getFileKey } from '@payloadcms/plugin-cloud-storage/utilities'\nimport { put } from '@vercel/blob'\nimport path from 'path'\n\ninterface UploadFileArgs {\n  access: 'public'\n  addRandomSuffix?: boolean\n  buffer: Buffer\n  cacheControlMaxAge?: number\n  collectionPrefix?: string\n  docPrefix?: string\n  filename: string\n  mimeType: string\n  token: string\n  useCompositePrefixes?: boolean\n}\n\ninterface UploadFileResult {\n  filename?: string\n}\n\nexport async function uploadFile({\n  access,\n  addRandomSuffix,\n  buffer,\n  cacheControlMaxAge,\n  collectionPrefix = '',\n  docPrefix,\n  filename,\n  mimeType,\n  token,\n  useCompositePrefixes = false,\n}: UploadFileArgs): Promise<UploadFileResult> {\n  const { fileKey } = getFileKey({\n    collectionPrefix,\n    docPrefix,\n    filename,\n    useCompositePrefixes,\n  })\n\n  const result = await put(fileKey, buffer, {\n    access,\n    addRandomSuffix,\n    allowOverwrite: true,\n    cacheControlMaxAge,\n    contentType: mimeType,\n    token,\n  })\n\n  if (addRandomSuffix) {\n    const pathname = result.pathname.replace(/^\\/+/, '')\n    const basename = path.posix.basename(pathname)\n    return { filename: decodeURIComponent(basename) }\n  }\n\n  return {}\n}\n"],"names":["getFileKey","put","path","uploadFile","access","addRandomSuffix","buffer","cacheControlMaxAge","collectionPrefix","docPrefix","filename","mimeType","token","useCompositePrefixes","fileKey","result","allowOverwrite","contentType","pathname","replace","basename","posix","decodeURIComponent"],"mappings":"AAAA,SAASA,UAAU,QAAQ,6CAA4C;AACvE,SAASC,GAAG,QAAQ,eAAc;AAClC,OAAOC,UAAU,OAAM;AAmBvB,OAAO,eAAeC,WAAW,EAC/BC,MAAM,EACNC,eAAe,EACfC,MAAM,EACNC,kBAAkB,EAClBC,mBAAmB,EAAE,EACrBC,SAAS,EACTC,QAAQ,EACRC,QAAQ,EACRC,KAAK,EACLC,uBAAuB,KAAK,EACb;IACf,MAAM,EAAEC,OAAO,EAAE,GAAGd,WAAW;QAC7BQ;QACAC;QACAC;QACAG;IACF;IAEA,MAAME,SAAS,MAAMd,IAAIa,SAASR,QAAQ;QACxCF;QACAC;QACAW,gBAAgB;QAChBT;QACAU,aAAaN;QACbC;IACF;IAEA,IAAIP,iBAAiB;QACnB,MAAMa,WAAWH,OAAOG,QAAQ,CAACC,OAAO,CAAC,QAAQ;QACjD,MAAMC,WAAWlB,KAAKmB,KAAK,CAACD,QAAQ,CAACF;QACrC,OAAO;YAAER,UAAUY,mBAAmBF;QAAU;IAClD;IAEA,OAAO,CAAC;AACV"}
+{"version":3,"sources":["../src/uploadFile.ts"],"sourcesContent":["import { put } from '@vercel/blob'\nimport path from 'path'\n\ninterface UploadFileArgs {\n  access: 'public'\n  addRandomSuffix?: boolean\n  buffer: Buffer\n  cacheControlMaxAge?: number\n  mimeType: string\n  storageFilePath: string\n  token: string\n}\n\ninterface UploadFileResult {\n  filename?: string\n}\n\nexport async function uploadFile({\n  access,\n  addRandomSuffix,\n  buffer,\n  cacheControlMaxAge,\n  mimeType,\n  storageFilePath,\n  token,\n}: UploadFileArgs): Promise<UploadFileResult> {\n  const result = await put(storageFilePath, buffer, {\n    access,\n    addRandomSuffix,\n    allowOverwrite: true,\n    cacheControlMaxAge,\n    contentType: mimeType,\n    token,\n  })\n\n  if (addRandomSuffix) {\n    const pathname = result.pathname.replace(/^\\/+/, '')\n    const basename = path.posix.basename(pathname)\n    return { filename: decodeURIComponent(basename) }\n  }\n\n  return {}\n}\n"],"names":["put","path","uploadFile","access","addRandomSuffix","buffer","cacheControlMaxAge","mimeType","storageFilePath","token","result","allowOverwrite","contentType","pathname","replace","basename","posix","filename","decodeURIComponent"],"mappings":"AAAA,SAASA,GAAG,QAAQ,eAAc;AAClC,OAAOC,UAAU,OAAM;AAgBvB,OAAO,eAAeC,WAAW,EAC/BC,MAAM,EACNC,eAAe,EACfC,MAAM,EACNC,kBAAkB,EAClBC,QAAQ,EACRC,eAAe,EACfC,KAAK,EACU;IACf,MAAMC,SAAS,MAAMV,IAAIQ,iBAAiBH,QAAQ;QAChDF;QACAC;QACAO,gBAAgB;QAChBL;QACAM,aAAaL;QACbE;IACF;IAEA,IAAIL,iBAAiB;QACnB,MAAMS,WAAWH,OAAOG,QAAQ,CAACC,OAAO,CAAC,QAAQ;QACjD,MAAMC,WAAWd,KAAKe,KAAK,CAACD,QAAQ,CAACF;QACrC,OAAO;YAAEI,UAAUC,mBAAmBH;QAAU;IAClD;IAEA,OAAO,CAAC;AACV"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/storage-vercel-blob",
-  "version": "4.0.0-internal.b8e7c89",
+  "version": "4.0.0-internal.bf4bcce",
   "description": "Payload storage adapter for Vercel Blob Storage",
   "homepage": "https://payloadcms.com",
   "repository": {
@@ -38,13 +38,13 @@
   ],
   "dependencies": {
     "@vercel/blob": "2.3.1",
-    "@payloadcms/plugin-cloud-storage": "4.0.0-internal.b8e7c89"
+    "@payloadcms/plugin-cloud-storage": "4.0.0-internal.bf4bcce"
   },
   "devDependencies": {
-    "payload": "4.0.0-internal.b8e7c89"
+    "payload": "4.0.0-internal.bf4bcce"
   },
   "peerDependencies": {
-    "payload": "4.0.0-internal.b8e7c89"
+    "payload": "4.0.0-internal.bf4bcce"
   },
   "engines": {
     "node": ">=24.15.0"