@payloadcms/plugin-cloud-storage 4.0.0-canary.32 → 4.0.0-canary.34

package/dist/types.d.ts

@@ -10,11 +10,25 @@ export interface File {
 export type ClientUploadsConfig = {
     access?: UploadInstructionsAccess;
 } | boolean;
+/**
+ * Reference to a client-uploaded object, returned by an upload handler and
+ * submitted with the document. Always carries the signed receipt; `prefix`
+ * locates the stored object.
+ */
+export type UploadReference = {
+    _objectKey?: string;
+    prefix: string;
+    signedReceipt: `${string}.${string}`;
+};
 export type HandleUpload = (args: {
     collection: CollectionConfig;
     data: any;
     file: File;
     req: PayloadRequest;
+    /**
+     * Pre-resolved storage path (`_objectKey` folded in, contained beneath the collection prefix).
+     */
+    storageFilePath: string;
 }) => Partial<FileData & TypeWithID> | Promise<Partial<FileData & TypeWithID>> | Promise<void> | void;
 export interface TypeWithPrefix {
     prefix?: string;
@@ -24,6 +38,10 @@ export type HandleDelete = (args: {
     doc: FileData & TypeWithID & TypeWithPrefix;
     filename: string;
     req: PayloadRequest;
+    /**
+     * Pre-resolved storage path of the object to delete.
+     */
+    storageFilePath: string;
 }) => Promise<void> | void;
 export type GenerateURL = (args: {
     collection: CollectionConfig;
@@ -53,7 +71,7 @@ export interface GeneratedAdapter {
     handleDelete: HandleDelete;
     handleUpload: HandleUpload;
     name: string;
-    onInit?: () => void;
+    onInit?: () => Promise<void> | void;
     staticHandler: StaticHandler;
     /** Generates upload instructions when supported. */
     uploadInstructions?: {

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type {\n  CollectionConfig,\n  Field,\n  FileData,\n  ImageSize,\n  PayloadHandler,\n  PayloadRequest,\n  TypeWithID,\n  UploadCollectionSlug,\n  UploadInstructionsAccess,\n  UploadInstructionsCapability,\n} from 'payload'\n\nexport interface File {\n  buffer: Buffer\n  filename: string\n  filesize: number\n  mimeType: string\n  tempFilePath?: string\n  uploadReference?: unknown\n}\n\nexport type ClientUploadsConfig = { access?: UploadInstructionsAccess } | boolean\n\nexport type HandleUpload = (args: {\n  collection: CollectionConfig\n  data: any\n  file: File\n  req: PayloadRequest\n}) =>\n  | Partial<FileData & TypeWithID>\n  | Promise<Partial<FileData & TypeWithID>>\n  | Promise<void>\n  | void\n\nexport interface TypeWithPrefix {\n  prefix?: string\n}\n\nexport type HandleDelete = (args: {\n  collection: CollectionConfig\n  doc: FileData & TypeWithID & TypeWithPrefix\n  filename: string\n  req: PayloadRequest\n}) => Promise<void> | void\n\nexport type GenerateURL = (args: {\n  collection: CollectionConfig\n  data: any\n  filename: string\n  prefix?: string\n}) => Promise<string> | string\n\nexport type StaticHandler = (\n  req: PayloadRequest,\n  args: {\n    doc?: TypeWithID\n    headers?: Headers\n    params: { collection: string; filename: string; prefix?: string; uploadReference?: unknown }\n  },\n) => Promise<Response> | Response\n\nexport interface GeneratedAdapter {\n  /**\n   * Additional fields to be injected into the base collection and image sizes\n   */\n  fields?: Field[]\n  /**\n   * Generates the public URL for a file\n   */\n  generateURL?: GenerateURL\n  handleDelete: HandleDelete\n  handleUpload: HandleUpload\n  name: string\n  onInit?: () => void\n  staticHandler: StaticHandler\n  /** Generates upload instructions when supported. */\n  uploadInstructions?: {\n    adminHandler?: {\n      path: string\n      props?: Record<string, unknown>\n    }\n    enabled: boolean\n    endpoint?: {\n      handler: PayloadHandler\n      path: `/${string}`\n    }\n  } & UploadInstructionsCapability\n}\n\nexport type Adapter = (args: { collection: CollectionConfig; prefix?: string }) => GeneratedAdapter\n\nexport type AllowList = Array<{\n  hostname: string\n  pathname?: string\n  port?: string\n  protocol?: 'http' | 'https'\n  search?: string\n}>\n\nexport type GenerateFileURL = (args: {\n  collection: CollectionConfig\n  filename: string\n  prefix?: string\n  size?: ImageSize\n}) => Promise<string> | string\n\nexport interface CollectionOptions {\n  adapter: Adapter | null\n  disableLocalStorage?: boolean\n  disablePayloadAccessControl?: true\n  generateFileURL?: GenerateFileURL\n  prefix?: string\n}\n\nexport interface PluginOptions {\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  collections: Partial<Record<UploadCollectionSlug, CollectionOptions>>\n  /**\n   * Whether or not to enable the plugin\n   *\n   * Default: true\n   */\n  enabled?: boolean\n  /**\n   * When true (compositional prefixes), the stored `prefix` field is only the\n   * document-level segment; the collection prefix comes from plugin options and\n   * must not be pre-filled as the field default.\n   *\n   * Set by storage adapters that support compositional prefixes (e.g. S3, Azure, R2, Vercel Blob, GCS).\n   *\n   * @default false\n   */\n  useCompositePrefixes?: boolean\n}\n"],"names":[],"mappings":"AAmHA,WA4BC"}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type {\n  CollectionConfig,\n  Field,\n  FileData,\n  ImageSize,\n  PayloadHandler,\n  PayloadRequest,\n  TypeWithID,\n  UploadCollectionSlug,\n  UploadInstructionsAccess,\n  UploadInstructionsCapability,\n} from 'payload'\n\nexport interface File {\n  buffer: Buffer\n  filename: string\n  filesize: number\n  mimeType: string\n  tempFilePath?: string\n  uploadReference?: unknown\n}\n\nexport type ClientUploadsConfig = { access?: UploadInstructionsAccess } | boolean\n\n/**\n * Reference to a client-uploaded object, returned by an upload handler and\n * submitted with the document. Always carries the signed receipt; `prefix`\n * locates the stored object.\n */\nexport type UploadReference = {\n  _objectKey?: string\n  prefix: string\n  signedReceipt: `${string}.${string}`\n}\n\nexport type HandleUpload = (args: {\n  collection: CollectionConfig\n  data: any\n  file: File\n  req: PayloadRequest\n  /**\n   * Pre-resolved storage path (`_objectKey` folded in, contained beneath the collection prefix).\n   */\n  storageFilePath: string\n}) =>\n  | Partial<FileData & TypeWithID>\n  | Promise<Partial<FileData & TypeWithID>>\n  | Promise<void>\n  | void\n\nexport interface TypeWithPrefix {\n  prefix?: string\n}\n\nexport type HandleDelete = (args: {\n  collection: CollectionConfig\n  doc: FileData & TypeWithID & TypeWithPrefix\n  filename: string\n  req: PayloadRequest\n  /**\n   * Pre-resolved storage path of the object to delete.\n   */\n  storageFilePath: string\n}) => Promise<void> | void\n\nexport type GenerateURL = (args: {\n  collection: CollectionConfig\n  data: any\n  filename: string\n  prefix?: string\n}) => Promise<string> | string\n\nexport type StaticHandler = (\n  req: PayloadRequest,\n  args: {\n    doc?: TypeWithID\n    headers?: Headers\n    params: { collection: string; filename: string; prefix?: string; uploadReference?: unknown }\n  },\n) => Promise<Response> | Response\n\nexport interface GeneratedAdapter {\n  /**\n   * Additional fields to be injected into the base collection and image sizes\n   */\n  fields?: Field[]\n  /**\n   * Generates the public URL for a file\n   */\n  generateURL?: GenerateURL\n  handleDelete: HandleDelete\n  handleUpload: HandleUpload\n  name: string\n  onInit?: () => Promise<void> | void\n  staticHandler: StaticHandler\n  /** Generates upload instructions when supported. */\n  uploadInstructions?: {\n    adminHandler?: {\n      path: string\n      props?: Record<string, unknown>\n    }\n    enabled: boolean\n    endpoint?: {\n      handler: PayloadHandler\n      path: `/${string}`\n    }\n  } & UploadInstructionsCapability\n}\n\nexport type Adapter = (args: { collection: CollectionConfig; prefix?: string }) => GeneratedAdapter\n\nexport type AllowList = Array<{\n  hostname: string\n  pathname?: string\n  port?: string\n  protocol?: 'http' | 'https'\n  search?: string\n}>\n\nexport type GenerateFileURL = (args: {\n  collection: CollectionConfig\n  filename: string\n  prefix?: string\n  size?: ImageSize\n}) => Promise<string> | string\n\nexport interface CollectionOptions {\n  adapter: Adapter | null\n  disableLocalStorage?: boolean\n  disablePayloadAccessControl?: true\n  generateFileURL?: GenerateFileURL\n  prefix?: string\n}\n\nexport interface PluginOptions {\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  collections: Partial<Record<UploadCollectionSlug, CollectionOptions>>\n  /**\n   * Whether or not to enable the plugin\n   *\n   * Default: true\n   */\n  enabled?: boolean\n  /**\n   * When true (compositional prefixes), the stored `prefix` field is only the\n   * document-level segment; the collection prefix comes from plugin options and\n   * must not be pre-filled as the field default.\n   *\n   * Set by storage adapters that support compositional prefixes (e.g. S3, Azure, R2, Vercel Blob, GCS).\n   *\n   * @default false\n   */\n  useCompositePrefixes?: boolean\n}\n"],"names":[],"mappings":"AAsIA,WA4BC"}

package/dist/utilities/buildPrefixWithObjectKey.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Joins the semantic prefix and the `_objectKey` segment into the object's folder; either may be empty.
+ */
+export declare const buildPrefixWithObjectKey: ({ objectKey, prefix, }: {
+    objectKey?: string;
+    prefix?: string;
+}) => string;
+//# sourceMappingURL=buildPrefixWithObjectKey.d.ts.map

package/dist/utilities/buildPrefixWithObjectKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildPrefixWithObjectKey.d.ts","sourceRoot":"","sources":["../../src/utilities/buildPrefixWithObjectKey.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,wBAAwB,2BAGlC;IACD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,KAAG,MASH,CAAA"}

package/dist/utilities/buildPrefixWithObjectKey.js

@@ -0,0 +1,13 @@
+import { sanitizePrefix } from './sanitizePrefix.js';
+/**
+ * Joins the semantic prefix and the `_objectKey` segment into the object's folder; either may be empty.
+ */ export const buildPrefixWithObjectKey = ({ objectKey, prefix })=>{
+    const safePrefix = sanitizePrefix(prefix ?? '');
+    const safeObjectKey = sanitizePrefix(objectKey ?? '');
+    if (safePrefix && safeObjectKey) {
+        return `${safePrefix}/${safeObjectKey}`;
+    }
+    return safePrefix || safeObjectKey;
+};
+
+//# sourceMappingURL=buildPrefixWithObjectKey.js.map

package/dist/utilities/buildPrefixWithObjectKey.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/buildPrefixWithObjectKey.ts"],"sourcesContent":["import { sanitizePrefix } from './sanitizePrefix.js'\n\n/**\n * Joins the semantic prefix and the `_objectKey` segment into the object's folder; either may be empty.\n */\nexport const buildPrefixWithObjectKey = ({\n  objectKey,\n  prefix,\n}: {\n  objectKey?: string\n  prefix?: string\n}): string => {\n  const safePrefix = sanitizePrefix(prefix ?? '')\n  const safeObjectKey = sanitizePrefix(objectKey ?? '')\n\n  if (safePrefix && safeObjectKey) {\n    return `${safePrefix}/${safeObjectKey}`\n  }\n\n  return safePrefix || safeObjectKey\n}\n"],"names":["sanitizePrefix","buildPrefixWithObjectKey","objectKey","prefix","safePrefix","safeObjectKey"],"mappings":"AAAA,SAASA,cAAc,QAAQ,sBAAqB;AAEpD;;CAEC,GACD,OAAO,MAAMC,2BAA2B,CAAC,EACvCC,SAAS,EACTC,MAAM,EAIP;IACC,MAAMC,aAAaJ,eAAeG,UAAU;IAC5C,MAAME,gBAAgBL,eAAeE,aAAa;IAElD,IAAIE,cAAcC,eAAe;QAC/B,OAAO,GAAGD,WAAW,CAAC,EAAEC,eAAe;IACzC;IAEA,OAAOD,cAAcC;AACvB,EAAC"}

package/dist/utilities/buildStoragePathData.d.ts

@@ -0,0 +1,49 @@
+type BuildFilePathDataArgs = {
+    collectionPrefix?: string;
+    docPrefix?: string;
+    filename: string;
+    useCompositePrefixes?: boolean;
+};
+type BuildFilePathDataResult = {
+    sanitizedCollectionPrefix: string;
+    sanitizedDocPrefix: string;
+    sanitizedFilename: string;
+    /**
+     * The full path to the file within the storage backend.
+     */
+    storageFilePath: string;
+};
+export declare function isStoragePathWithinCollectionPrefix({ collectionPrefix, docPrefix, }: {
+    collectionPrefix?: string;
+    docPrefix: string;
+}): boolean;
+/**
+ * Resolves where a new upload must be stored, without needing a filename.
+ *
+ * In non-composite mode (useCompositePrefixes: false), docPrefix is treated as a complete prefix
+ * when it is already within collectionPrefix and is otherwise nested beneath collectionPrefix.
+ * In composite mode (useCompositePrefixes: true), the collection prefix is joined when the key is
+ * built, so the persisted document prefix stays relative to it.
+ *
+ * Prefix-only callers (such as the upload prefix hooks) use this directly; use
+ * {@link buildUploadStoragePathData} when a full object key is needed.
+ */
+export declare function buildUploadPrefix({ collectionPrefix, docPrefix, useCompositePrefixes, }: Omit<BuildFilePathDataArgs, 'filename'>): {
+    sanitizedCollectionPrefix: string;
+    sanitizedDocPrefix: string;
+    uploadPrefix: string;
+};
+/**
+ * Resolves a new upload destination beneath the configured collection prefix.
+ * Both prefixes are passed through {@link sanitizePrefix} so keys stay normalized.
+ */
+export declare function buildUploadStoragePathData({ collectionPrefix, docPrefix, filename, useCompositePrefixes, }: BuildFilePathDataArgs): BuildFilePathDataResult;
+/**
+ * Resolves the exact location represented by persisted upload metadata.
+ * Non-composite document prefixes historically override the collection prefix;
+ * keep that behavior for reads, URLs, and cleanup of pre-upgrade files.
+ * New writes must use buildUploadStoragePathData instead.
+ */
+export declare function buildStoragePathData({ collectionPrefix, docPrefix, filename, useCompositePrefixes, }: BuildFilePathDataArgs): BuildFilePathDataResult;
+export {};
+//# sourceMappingURL=buildStoragePathData.d.ts.map

package/dist/utilities/buildStoragePathData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildStoragePathData.d.ts","sourceRoot":"","sources":["../../src/utilities/buildStoragePathData.ts"],"names":[],"mappings":"AAKA,KAAK,qBAAqB,GAAG;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B,CAAA;AAED,KAAK,uBAAuB,GAAG;IAC7B,yBAAyB,EAAE,MAAM,CAAA;IACjC,kBAAkB,EAAE,MAAM,CAAA;IAC1B,iBAAiB,EAAE,MAAM,CAAA;IACzB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,wBAAgB,mCAAmC,CAAC,EAClD,gBAAgB,EAChB,SAAS,GACV,EAAE;IACD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,OAAO,CAQV;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,gBAAgB,EAChB,SAAS,EACT,oBAA4B,GAC7B,EAAE,IAAI,CAAC,qBAAqB,EAAE,UAAU,CAAC,GAAG;IAC3C,yBAAyB,EAAE,MAAM,CAAA;IACjC,kBAAkB,EAAE,MAAM,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;CACrB,CAiBA;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,oBAA4B,GAC7B,EAAE,qBAAqB,GAAG,uBAAuB,CAkBjD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,oBAA4B,GAC7B,EAAE,qBAAqB,GAAG,uBAAuB,CAcjD"}

package/dist/utilities/buildStoragePathData.js

@@ -0,0 +1,67 @@
+import path from 'path';
+import { sanitizeFilename } from 'payload/shared';
+import { sanitizePrefix } from './sanitizePrefix.js';
+export function isStoragePathWithinCollectionPrefix({ collectionPrefix, docPrefix }) {
+    const safeCollectionPrefix = sanitizePrefix(collectionPrefix || '');
+    return !safeCollectionPrefix || docPrefix === safeCollectionPrefix || docPrefix.startsWith(`${safeCollectionPrefix}/`);
+}
+/**
+ * Resolves where a new upload must be stored, without needing a filename.
+ *
+ * In non-composite mode (useCompositePrefixes: false), docPrefix is treated as a complete prefix
+ * when it is already within collectionPrefix and is otherwise nested beneath collectionPrefix.
+ * In composite mode (useCompositePrefixes: true), the collection prefix is joined when the key is
+ * built, so the persisted document prefix stays relative to it.
+ *
+ * Prefix-only callers (such as the upload prefix hooks) use this directly; use
+ * {@link buildUploadStoragePathData} when a full object key is needed.
+ */ export function buildUploadPrefix({ collectionPrefix, docPrefix, useCompositePrefixes = false }) {
+    const safeCollectionPrefix = sanitizePrefix(collectionPrefix || '');
+    const safeDocPrefix = sanitizePrefix(docPrefix || '');
+    const uploadPrefix = safeDocPrefix && !isStoragePathWithinCollectionPrefix({
+        collectionPrefix: safeCollectionPrefix,
+        docPrefix: safeDocPrefix
+    }) ? path.posix.join(safeCollectionPrefix, safeDocPrefix) : safeDocPrefix || safeCollectionPrefix;
+    return {
+        sanitizedCollectionPrefix: safeCollectionPrefix,
+        sanitizedDocPrefix: !useCompositePrefixes && safeDocPrefix ? uploadPrefix : safeDocPrefix,
+        uploadPrefix
+    };
+}
+/**
+ * Resolves a new upload destination beneath the configured collection prefix.
+ * Both prefixes are passed through {@link sanitizePrefix} so keys stay normalized.
+ */ export function buildUploadStoragePathData({ collectionPrefix, docPrefix, filename, useCompositePrefixes = false }) {
+    const { sanitizedCollectionPrefix, sanitizedDocPrefix, uploadPrefix } = buildUploadPrefix({
+        collectionPrefix,
+        docPrefix,
+        useCompositePrefixes
+    });
+    const safeFilename = sanitizeFilename(filename);
+    const storageFilePath = useCompositePrefixes ? path.posix.join(sanitizedCollectionPrefix, sanitizedDocPrefix, safeFilename) : path.posix.join(uploadPrefix, safeFilename);
+    return {
+        sanitizedCollectionPrefix,
+        sanitizedDocPrefix,
+        sanitizedFilename: safeFilename,
+        storageFilePath
+    };
+}
+/**
+ * Resolves the exact location represented by persisted upload metadata.
+ * Non-composite document prefixes historically override the collection prefix;
+ * keep that behavior for reads, URLs, and cleanup of pre-upgrade files.
+ * New writes must use buildUploadStoragePathData instead.
+ */ export function buildStoragePathData({ collectionPrefix, docPrefix, filename, useCompositePrefixes = false }) {
+    const sanitizedCollectionPrefix = sanitizePrefix(collectionPrefix || '');
+    const sanitizedDocPrefix = sanitizePrefix(docPrefix || '');
+    const sanitizedFilename = sanitizeFilename(filename);
+    const storageFilePath = useCompositePrefixes ? path.posix.join(sanitizedCollectionPrefix, sanitizedDocPrefix, sanitizedFilename) : path.posix.join(sanitizedDocPrefix || sanitizedCollectionPrefix, sanitizedFilename);
+    return {
+        sanitizedCollectionPrefix,
+        sanitizedDocPrefix,
+        sanitizedFilename,
+        storageFilePath
+    };
+}
+
+//# sourceMappingURL=buildStoragePathData.js.map

package/dist/utilities/buildStoragePathData.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/buildStoragePathData.ts"],"sourcesContent":["import path from 'path'\nimport { sanitizeFilename } from 'payload/shared'\n\nimport { sanitizePrefix } from './sanitizePrefix.js'\n\ntype BuildFilePathDataArgs = {\n  collectionPrefix?: string\n  docPrefix?: string\n  filename: string\n  useCompositePrefixes?: boolean\n}\n\ntype BuildFilePathDataResult = {\n  sanitizedCollectionPrefix: string\n  sanitizedDocPrefix: string\n  sanitizedFilename: string\n  /**\n   * The full path to the file within the storage backend.\n   */\n  storageFilePath: string\n}\n\nexport function isStoragePathWithinCollectionPrefix({\n  collectionPrefix,\n  docPrefix,\n}: {\n  collectionPrefix?: string\n  docPrefix: string\n}): boolean {\n  const safeCollectionPrefix = sanitizePrefix(collectionPrefix || '')\n\n  return (\n    !safeCollectionPrefix ||\n    docPrefix === safeCollectionPrefix ||\n    docPrefix.startsWith(`${safeCollectionPrefix}/`)\n  )\n}\n\n/**\n * Resolves where a new upload must be stored, without needing a filename.\n *\n * In non-composite mode (useCompositePrefixes: false), docPrefix is treated as a complete prefix\n * when it is already within collectionPrefix and is otherwise nested beneath collectionPrefix.\n * In composite mode (useCompositePrefixes: true), the collection prefix is joined when the key is\n * built, so the persisted document prefix stays relative to it.\n *\n * Prefix-only callers (such as the upload prefix hooks) use this directly; use\n * {@link buildUploadStoragePathData} when a full object key is needed.\n */\nexport function buildUploadPrefix({\n  collectionPrefix,\n  docPrefix,\n  useCompositePrefixes = false,\n}: Omit<BuildFilePathDataArgs, 'filename'>): {\n  sanitizedCollectionPrefix: string\n  sanitizedDocPrefix: string\n  uploadPrefix: string\n} {\n  const safeCollectionPrefix = sanitizePrefix(collectionPrefix || '')\n  const safeDocPrefix = sanitizePrefix(docPrefix || '')\n  const uploadPrefix =\n    safeDocPrefix &&\n    !isStoragePathWithinCollectionPrefix({\n      collectionPrefix: safeCollectionPrefix,\n      docPrefix: safeDocPrefix,\n    })\n      ? path.posix.join(safeCollectionPrefix, safeDocPrefix)\n      : safeDocPrefix || safeCollectionPrefix\n\n  return {\n    sanitizedCollectionPrefix: safeCollectionPrefix,\n    sanitizedDocPrefix: !useCompositePrefixes && safeDocPrefix ? uploadPrefix : safeDocPrefix,\n    uploadPrefix,\n  }\n}\n\n/**\n * Resolves a new upload destination beneath the configured collection prefix.\n * Both prefixes are passed through {@link sanitizePrefix} so keys stay normalized.\n */\nexport function buildUploadStoragePathData({\n  collectionPrefix,\n  docPrefix,\n  filename,\n  useCompositePrefixes = false,\n}: BuildFilePathDataArgs): BuildFilePathDataResult {\n  const { sanitizedCollectionPrefix, sanitizedDocPrefix, uploadPrefix } = buildUploadPrefix({\n    collectionPrefix,\n    docPrefix,\n    useCompositePrefixes,\n  })\n  const safeFilename = sanitizeFilename(filename)\n\n  const storageFilePath = useCompositePrefixes\n    ? path.posix.join(sanitizedCollectionPrefix, sanitizedDocPrefix, safeFilename)\n    : path.posix.join(uploadPrefix, safeFilename)\n\n  return {\n    sanitizedCollectionPrefix,\n    sanitizedDocPrefix,\n    sanitizedFilename: safeFilename,\n    storageFilePath,\n  }\n}\n\n/**\n * Resolves the exact location represented by persisted upload metadata.\n * Non-composite document prefixes historically override the collection prefix;\n * keep that behavior for reads, URLs, and cleanup of pre-upgrade files.\n * New writes must use buildUploadStoragePathData instead.\n */\nexport function buildStoragePathData({\n  collectionPrefix,\n  docPrefix,\n  filename,\n  useCompositePrefixes = false,\n}: BuildFilePathDataArgs): BuildFilePathDataResult {\n  const sanitizedCollectionPrefix = sanitizePrefix(collectionPrefix || '')\n  const sanitizedDocPrefix = sanitizePrefix(docPrefix || '')\n  const sanitizedFilename = sanitizeFilename(filename)\n  const storageFilePath = useCompositePrefixes\n    ? path.posix.join(sanitizedCollectionPrefix, sanitizedDocPrefix, sanitizedFilename)\n    : path.posix.join(sanitizedDocPrefix || sanitizedCollectionPrefix, sanitizedFilename)\n\n  return {\n    sanitizedCollectionPrefix,\n    sanitizedDocPrefix,\n    sanitizedFilename,\n    storageFilePath,\n  }\n}\n"],"names":["path","sanitizeFilename","sanitizePrefix","isStoragePathWithinCollectionPrefix","collectionPrefix","docPrefix","safeCollectionPrefix","startsWith","buildUploadPrefix","useCompositePrefixes","safeDocPrefix","uploadPrefix","posix","join","sanitizedCollectionPrefix","sanitizedDocPrefix","buildUploadStoragePathData","filename","safeFilename","storageFilePath","sanitizedFilename","buildStoragePathData"],"mappings":"AAAA,OAAOA,UAAU,OAAM;AACvB,SAASC,gBAAgB,QAAQ,iBAAgB;AAEjD,SAASC,cAAc,QAAQ,sBAAqB;AAmBpD,OAAO,SAASC,oCAAoC,EAClDC,gBAAgB,EAChBC,SAAS,EAIV;IACC,MAAMC,uBAAuBJ,eAAeE,oBAAoB;IAEhE,OACE,CAACE,wBACDD,cAAcC,wBACdD,UAAUE,UAAU,CAAC,GAAGD,qBAAqB,CAAC,CAAC;AAEnD;AAEA;;;;;;;;;;CAUC,GACD,OAAO,SAASE,kBAAkB,EAChCJ,gBAAgB,EAChBC,SAAS,EACTI,uBAAuB,KAAK,EACY;IAKxC,MAAMH,uBAAuBJ,eAAeE,oBAAoB;IAChE,MAAMM,gBAAgBR,eAAeG,aAAa;IAClD,MAAMM,eACJD,iBACA,CAACP,oCAAoC;QACnCC,kBAAkBE;QAClBD,WAAWK;IACb,KACIV,KAAKY,KAAK,CAACC,IAAI,CAACP,sBAAsBI,iBACtCA,iBAAiBJ;IAEvB,OAAO;QACLQ,2BAA2BR;QAC3BS,oBAAoB,CAACN,wBAAwBC,gBAAgBC,eAAeD;QAC5EC;IACF;AACF;AAEA;;;CAGC,GACD,OAAO,SAASK,2BAA2B,EACzCZ,gBAAgB,EAChBC,SAAS,EACTY,QAAQ,EACRR,uBAAuB,KAAK,EACN;IACtB,MAAM,EAAEK,yBAAyB,EAAEC,kBAAkB,EAAEJ,YAAY,EAAE,GAAGH,kBAAkB;QACxFJ;QACAC;QACAI;IACF;IACA,MAAMS,eAAejB,iBAAiBgB;IAEtC,MAAME,kBAAkBV,uBACpBT,KAAKY,KAAK,CAACC,IAAI,CAACC,2BAA2BC,oBAAoBG,gBAC/DlB,KAAKY,KAAK,CAACC,IAAI,CAACF,cAAcO;IAElC,OAAO;QACLJ;QACAC;QACAK,mBAAmBF;QACnBC;IACF;AACF;AAEA;;;;;CAKC,GACD,OAAO,SAASE,qBAAqB,EACnCjB,gBAAgB,EAChBC,SAAS,EACTY,QAAQ,EACRR,uBAAuB,KAAK,EACN;IACtB,MAAMK,4BAA4BZ,eAAeE,oBAAoB;IACrE,MAAMW,qBAAqBb,eAAeG,aAAa;IACvD,MAAMe,oBAAoBnB,iBAAiBgB;IAC3C,MAAME,kBAAkBV,uBACpBT,KAAKY,KAAK,CAACC,IAAI,CAACC,2BAA2BC,oBAAoBK,qBAC/DpB,KAAKY,KAAK,CAACC,IAAI,CAACE,sBAAsBD,2BAA2BM;IAErE,OAAO;QACLN;QACAC;QACAK;QACAD;IACF;AACF"}

package/dist/utilities/buildStoragePathData.spec.js

@@ -0,0 +1,241 @@
+import { buildStoragePathData, buildUploadStoragePathData, isStoragePathWithinCollectionPrefix } from './buildStoragePathData.js';
+import { describe, expect, it } from 'vitest';
+describe('buildFileKey', ()=>{
+    describe('non-composite mode (useCompositePrefixes: false)', ()=>{
+        it('should preserve the key of a legacy document outside the collection prefix', ()=>{
+            const result = buildStoragePathData({
+                collectionPrefix: 'media/',
+                docPrefix: 'media-archive',
+                filename: 'test.png',
+                useCompositePrefixes: false
+            });
+            expect(result).toEqual({
+                sanitizedCollectionPrefix: 'media',
+                sanitizedDocPrefix: 'media-archive',
+                sanitizedFilename: 'test.png',
+                storageFilePath: 'media-archive/test.png'
+            });
+        });
+        it('should fallback to collectionPrefix when docPrefix is empty', ()=>{
+            const result = buildStoragePathData({
+                collectionPrefix: 'collection',
+                docPrefix: '',
+                filename: 'test.png',
+                useCompositePrefixes: false
+            });
+            expect(result).toEqual({
+                sanitizedCollectionPrefix: 'collection',
+                sanitizedDocPrefix: '',
+                sanitizedFilename: 'test.png',
+                storageFilePath: 'collection/test.png'
+            });
+        });
+        it('should fallback to collectionPrefix when docPrefix is undefined', ()=>{
+            const result = buildStoragePathData({
+                collectionPrefix: 'collection',
+                filename: 'test.png',
+                useCompositePrefixes: false
+            });
+            expect(result).toEqual({
+                sanitizedCollectionPrefix: 'collection',
+                sanitizedDocPrefix: '',
+                sanitizedFilename: 'test.png',
+                storageFilePath: 'collection/test.png'
+            });
+        });
+        it('should return only filename when both prefixes are empty', ()=>{
+            const result = buildStoragePathData({
+                filename: 'test.png',
+                useCompositePrefixes: false
+            });
+            expect(result).toEqual({
+                sanitizedCollectionPrefix: '',
+                sanitizedDocPrefix: '',
+                sanitizedFilename: 'test.png',
+                storageFilePath: 'test.png'
+            });
+        });
+    });
+    describe('composite mode (useCompositePrefixes: true)', ()=>{
+        it('should combine collectionPrefix and docPrefix', ()=>{
+            const result = buildStoragePathData({
+                collectionPrefix: 'collection',
+                docPrefix: 'document',
+                filename: 'test.png',
+                useCompositePrefixes: true
+            });
+            expect(result).toEqual({
+                sanitizedCollectionPrefix: 'collection',
+                sanitizedDocPrefix: 'document',
+                sanitizedFilename: 'test.png',
+                storageFilePath: 'collection/document/test.png'
+            });
+        });
+        it('should work with only collectionPrefix', ()=>{
+            const result = buildStoragePathData({
+                collectionPrefix: 'collection',
+                filename: 'test.png',
+                useCompositePrefixes: true
+            });
+            expect(result).toEqual({
+                sanitizedCollectionPrefix: 'collection',
+                sanitizedDocPrefix: '',
+                sanitizedFilename: 'test.png',
+                storageFilePath: 'collection/test.png'
+            });
+        });
+        it('should work with only docPrefix', ()=>{
+            const result = buildStoragePathData({
+                docPrefix: 'document',
+                filename: 'test.png',
+                useCompositePrefixes: true
+            });
+            expect(result).toEqual({
+                sanitizedCollectionPrefix: '',
+                sanitizedDocPrefix: 'document',
+                sanitizedFilename: 'test.png',
+                storageFilePath: 'document/test.png'
+            });
+        });
+        it('should return only filename when both prefixes are empty', ()=>{
+            const result = buildStoragePathData({
+                filename: 'test.png',
+                useCompositePrefixes: true
+            });
+            expect(result).toEqual({
+                sanitizedCollectionPrefix: '',
+                sanitizedDocPrefix: '',
+                sanitizedFilename: 'test.png',
+                storageFilePath: 'test.png'
+            });
+        });
+    });
+    describe('collection prefix boundaries', ()=>{
+        it('should accept a file key within a slash-terminated collection prefix', ()=>{
+            expect(isStoragePathWithinCollectionPrefix({
+                collectionPrefix: 'media/',
+                docPrefix: 'media/documents/test.png'
+            })).toBe(true);
+        });
+    });
+    describe('sanitization', ()=>{
+        it.each([
+            './media/./images',
+            'media\\images',
+            '/media//images'
+        ])('should canonicalize equivalent prefix paths', (docPrefix)=>{
+            const result = buildStoragePathData({
+                docPrefix,
+                filename: 'test.png'
+            });
+            expect(result).toEqual({
+                sanitizedCollectionPrefix: '',
+                sanitizedDocPrefix: 'media/images',
+                sanitizedFilename: 'test.png',
+                storageFilePath: 'media/images/test.png'
+            });
+        });
+        it('should remove path traversal segments from collectionPrefix', ()=>{
+            const result = buildStoragePathData({
+                collectionPrefix: '../../../etc',
+                filename: 'test.png',
+                useCompositePrefixes: false
+            });
+            expect(result).toEqual({
+                sanitizedCollectionPrefix: 'etc',
+                sanitizedDocPrefix: '',
+                sanitizedFilename: 'test.png',
+                storageFilePath: 'etc/test.png'
+            });
+            expect(result.storageFilePath).not.toContain('..');
+        });
+        it('should remove path traversal segments from docPrefix', ()=>{
+            const result = buildStoragePathData({
+                docPrefix: 'a/../../outside',
+                filename: 'test.png',
+                useCompositePrefixes: false
+            });
+            expect(result).toEqual({
+                sanitizedCollectionPrefix: '',
+                sanitizedDocPrefix: 'a/outside',
+                sanitizedFilename: 'test.png',
+                storageFilePath: 'a/outside/test.png'
+            });
+            expect(result.storageFilePath).not.toContain('..');
+        });
+        it('should remove control characters from prefixes', ()=>{
+            const result = buildStoragePathData({
+                collectionPrefix: 'test\x00\x1fprefix',
+                filename: 'test.png',
+                useCompositePrefixes: false
+            });
+            expect(result).toEqual({
+                sanitizedCollectionPrefix: 'testprefix',
+                sanitizedDocPrefix: '',
+                sanitizedFilename: 'test.png',
+                storageFilePath: 'testprefix/test.png'
+            });
+            expect(result.storageFilePath).not.toMatch(/[\x00-\x1f]/);
+        });
+        it('should normalize both prefixes after removing control characters in composite mode', ()=>{
+            const result = buildStoragePathData({
+                collectionPrefix: '.\x00./collection',
+                docPrefix: '.\x00./doc',
+                filename: 'test.png',
+                useCompositePrefixes: true
+            });
+            expect(result).toEqual({
+                sanitizedCollectionPrefix: 'collection',
+                sanitizedDocPrefix: 'doc',
+                sanitizedFilename: 'test.png',
+                storageFilePath: 'collection/doc/test.png'
+            });
+            expect(result.storageFilePath).not.toContain('..');
+        });
+    });
+});
+describe('buildUploadStoragePathData', ()=>{
+    it.each([
+        [
+            'invoices',
+            false,
+            'media/invoices/file.png',
+            'media/invoices'
+        ],
+        [
+            'media/invoices',
+            false,
+            'media/invoices/file.png',
+            'media/invoices'
+        ],
+        [
+            '',
+            false,
+            'media/file.png',
+            ''
+        ],
+        [
+            'invoices',
+            true,
+            'media/invoices/file.png',
+            'invoices'
+        ]
+    ])('should persist a readable destination for %s (composite %s)', (docPrefix, useCompositePrefixes, fileKey, storedPrefix)=>{
+        const result = buildUploadStoragePathData({
+            collectionPrefix: 'media',
+            docPrefix,
+            filename: 'file.png',
+            useCompositePrefixes
+        });
+        expect(result.storageFilePath).toBe(fileKey);
+        expect(result.sanitizedDocPrefix).toBe(storedPrefix);
+        expect(buildStoragePathData({
+            collectionPrefix: 'media',
+            docPrefix: result.sanitizedDocPrefix,
+            filename: 'file.png',
+            useCompositePrefixes
+        }).storageFilePath).toBe(fileKey);
+    });
+});
+
+//# sourceMappingURL=buildStoragePathData.spec.js.map

package/dist/utilities/buildStoragePathData.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/buildStoragePathData.spec.ts"],"sourcesContent":["import {\n  buildStoragePathData,\n  buildUploadStoragePathData,\n  isStoragePathWithinCollectionPrefix,\n} from './buildStoragePathData.js'\nimport { describe, expect, it } from 'vitest'\n\ndescribe('buildFileKey', () => {\n  describe('non-composite mode (useCompositePrefixes: false)', () => {\n    it('should preserve the key of a legacy document outside the collection prefix', () => {\n      const result = buildStoragePathData({\n        collectionPrefix: 'media/',\n        docPrefix: 'media-archive',\n        filename: 'test.png',\n        useCompositePrefixes: false,\n      })\n\n      expect(result).toEqual({\n        sanitizedCollectionPrefix: 'media',\n        sanitizedDocPrefix: 'media-archive',\n        sanitizedFilename: 'test.png',\n        storageFilePath: 'media-archive/test.png',\n      })\n    })\n\n    it('should fallback to collectionPrefix when docPrefix is empty', () => {\n      const result = buildStoragePathData({\n        collectionPrefix: 'collection',\n        docPrefix: '',\n        filename: 'test.png',\n        useCompositePrefixes: false,\n      })\n      expect(result).toEqual({\n        sanitizedCollectionPrefix: 'collection',\n        sanitizedDocPrefix: '',\n        sanitizedFilename: 'test.png',\n        storageFilePath: 'collection/test.png',\n      })\n    })\n\n    it('should fallback to collectionPrefix when docPrefix is undefined', () => {\n      const result = buildStoragePathData({\n        collectionPrefix: 'collection',\n        filename: 'test.png',\n        useCompositePrefixes: false,\n      })\n      expect(result).toEqual({\n        sanitizedCollectionPrefix: 'collection',\n        sanitizedDocPrefix: '',\n        sanitizedFilename: 'test.png',\n        storageFilePath: 'collection/test.png',\n      })\n    })\n\n    it('should return only filename when both prefixes are empty', () => {\n      const result = buildStoragePathData({\n        filename: 'test.png',\n        useCompositePrefixes: false,\n      })\n      expect(result).toEqual({\n        sanitizedCollectionPrefix: '',\n        sanitizedDocPrefix: '',\n        sanitizedFilename: 'test.png',\n        storageFilePath: 'test.png',\n      })\n    })\n  })\n\n  describe('composite mode (useCompositePrefixes: true)', () => {\n    it('should combine collectionPrefix and docPrefix', () => {\n      const result = buildStoragePathData({\n        collectionPrefix: 'collection',\n        docPrefix: 'document',\n        filename: 'test.png',\n        useCompositePrefixes: true,\n      })\n      expect(result).toEqual({\n        sanitizedCollectionPrefix: 'collection',\n        sanitizedDocPrefix: 'document',\n        sanitizedFilename: 'test.png',\n        storageFilePath: 'collection/document/test.png',\n      })\n    })\n\n    it('should work with only collectionPrefix', () => {\n      const result = buildStoragePathData({\n        collectionPrefix: 'collection',\n        filename: 'test.png',\n        useCompositePrefixes: true,\n      })\n      expect(result).toEqual({\n        sanitizedCollectionPrefix: 'collection',\n        sanitizedDocPrefix: '',\n        sanitizedFilename: 'test.png',\n        storageFilePath: 'collection/test.png',\n      })\n    })\n\n    it('should work with only docPrefix', () => {\n      const result = buildStoragePathData({\n        docPrefix: 'document',\n        filename: 'test.png',\n        useCompositePrefixes: true,\n      })\n      expect(result).toEqual({\n        sanitizedCollectionPrefix: '',\n        sanitizedDocPrefix: 'document',\n        sanitizedFilename: 'test.png',\n        storageFilePath: 'document/test.png',\n      })\n    })\n\n    it('should return only filename when both prefixes are empty', () => {\n      const result = buildStoragePathData({\n        filename: 'test.png',\n        useCompositePrefixes: true,\n      })\n      expect(result).toEqual({\n        sanitizedCollectionPrefix: '',\n        sanitizedDocPrefix: '',\n        sanitizedFilename: 'test.png',\n        storageFilePath: 'test.png',\n      })\n    })\n  })\n\n  describe('collection prefix boundaries', () => {\n    it('should accept a file key within a slash-terminated collection prefix', () => {\n      expect(\n        isStoragePathWithinCollectionPrefix({\n          collectionPrefix: 'media/',\n          docPrefix: 'media/documents/test.png',\n        }),\n      ).toBe(true)\n    })\n  })\n\n  describe('sanitization', () => {\n    it.each(['./media/./images', 'media\\\\images', '/media//images'])(\n      'should canonicalize equivalent prefix paths',\n      (docPrefix) => {\n        const result = buildStoragePathData({ docPrefix, filename: 'test.png' })\n\n        expect(result).toEqual({\n          sanitizedCollectionPrefix: '',\n          sanitizedDocPrefix: 'media/images',\n          sanitizedFilename: 'test.png',\n          storageFilePath: 'media/images/test.png',\n        })\n      },\n    )\n\n    it('should remove path traversal segments from collectionPrefix', () => {\n      const result = buildStoragePathData({\n        collectionPrefix: '../../../etc',\n        filename: 'test.png',\n        useCompositePrefixes: false,\n      })\n      expect(result).toEqual({\n        sanitizedCollectionPrefix: 'etc',\n        sanitizedDocPrefix: '',\n        sanitizedFilename: 'test.png',\n        storageFilePath: 'etc/test.png',\n      })\n      expect(result.storageFilePath).not.toContain('..')\n    })\n\n    it('should remove path traversal segments from docPrefix', () => {\n      const result = buildStoragePathData({\n        docPrefix: 'a/../../outside',\n        filename: 'test.png',\n        useCompositePrefixes: false,\n      })\n      expect(result).toEqual({\n        sanitizedCollectionPrefix: '',\n        sanitizedDocPrefix: 'a/outside',\n        sanitizedFilename: 'test.png',\n        storageFilePath: 'a/outside/test.png',\n      })\n      expect(result.storageFilePath).not.toContain('..')\n    })\n\n    it('should remove control characters from prefixes', () => {\n      const result = buildStoragePathData({\n        collectionPrefix: 'test\\x00\\x1fprefix',\n        filename: 'test.png',\n        useCompositePrefixes: false,\n      })\n      expect(result).toEqual({\n        sanitizedCollectionPrefix: 'testprefix',\n        sanitizedDocPrefix: '',\n        sanitizedFilename: 'test.png',\n        storageFilePath: 'testprefix/test.png',\n      })\n      expect(result.storageFilePath).not.toMatch(/[\\x00-\\x1f]/)\n    })\n\n    it('should normalize both prefixes after removing control characters in composite mode', () => {\n      const result = buildStoragePathData({\n        collectionPrefix: '.\\x00./collection',\n        docPrefix: '.\\x00./doc',\n        filename: 'test.png',\n        useCompositePrefixes: true,\n      })\n      expect(result).toEqual({\n        sanitizedCollectionPrefix: 'collection',\n        sanitizedDocPrefix: 'doc',\n        sanitizedFilename: 'test.png',\n        storageFilePath: 'collection/doc/test.png',\n      })\n      expect(result.storageFilePath).not.toContain('..')\n    })\n  })\n})\n\ndescribe('buildUploadStoragePathData', () => {\n  it.each([\n    ['invoices', false, 'media/invoices/file.png', 'media/invoices'],\n    ['media/invoices', false, 'media/invoices/file.png', 'media/invoices'],\n    ['', false, 'media/file.png', ''],\n    ['invoices', true, 'media/invoices/file.png', 'invoices'],\n  ] as const)(\n    'should persist a readable destination for %s (composite %s)',\n    (docPrefix, useCompositePrefixes, fileKey, storedPrefix) => {\n      const result = buildUploadStoragePathData({\n        collectionPrefix: 'media',\n        docPrefix,\n        filename: 'file.png',\n        useCompositePrefixes,\n      })\n\n      expect(result.storageFilePath).toBe(fileKey)\n      expect(result.sanitizedDocPrefix).toBe(storedPrefix)\n      expect(\n        buildStoragePathData({\n          collectionPrefix: 'media',\n          docPrefix: result.sanitizedDocPrefix,\n          filename: 'file.png',\n          useCompositePrefixes,\n        }).storageFilePath,\n      ).toBe(fileKey)\n    },\n  )\n})\n"],"names":["buildStoragePathData","buildUploadStoragePathData","isStoragePathWithinCollectionPrefix","describe","expect","it","result","collectionPrefix","docPrefix","filename","useCompositePrefixes","toEqual","sanitizedCollectionPrefix","sanitizedDocPrefix","sanitizedFilename","storageFilePath","toBe","each","not","toContain","toMatch","fileKey","storedPrefix"],"mappings":"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"}

package/dist/utilities/getFilePrefix.d.ts

@@ -1,20 +1,28 @@
-import type { CollectionConfig, PayloadRequest } from 'payload';
+import type { CollectionConfig, PayloadRequest, TypeWithID } from 'payload';
 /**
- * Resolves the file prefix from the highest-priority available source and
- * always returns a sanitized value.
+ * Resolves the folder a stored object lives under (semantic `prefix` plus `_objectKey`).
  *
- * Resolution order:
- * 1. `prefixQueryParam`
- * 2. `uploadReference.prefix`
- * 3. Stored document `prefix` from the database
- *
- * Resolved values are passed through `sanitizePrefix`.
+ * An already-authorized `doc` wins outright. Otherwise an `uploadReference` is used (its
+ * `prefix` re-contained with {@link buildUploadStoragePathData}, since it hasn't been verified against
+ * a signed receipt by every adapter). Otherwise the document is resolved with
+ * `overrideAccess: false`, any query-param prefix only narrows that lookup, and `_objectKey`
+ * is read from the resolved document via `showHiddenFields`.
  */
-export declare function getFilePrefix({ collection, filename, prefixQueryParam, req, uploadReference, }: {
+export declare function getFilePrefix({ collection, collectionPrefix, doc, filename, prefixQueryParam, req, uploadReference, useCompositePrefixes, }: {
     collection: CollectionConfig;
+    collectionPrefix?: string;
+    doc?: {
+        _objectKey?: string;
+        prefix?: string;
+    } & TypeWithID;
     filename: string;
+    /**
+     * Only narrows the access-controlled fallback lookup below; never trusted or
+     * returned directly. Prefer passing the access-checked document as `doc` instead.
+     */
     prefixQueryParam?: string;
     req: PayloadRequest;
     uploadReference?: unknown;
+    useCompositePrefixes?: boolean;
 }): Promise<string>;
 //# sourceMappingURL=getFilePrefix.d.ts.map

package/dist/utilities/getFilePrefix.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getFilePrefix.d.ts","sourceRoot":"","sources":["../../src/utilities/getFilePrefix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAgB,MAAM,SAAS,CAAA;AAI7E;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,EAClC,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,GAAG,EACH,eAAe,GAChB,EAAE;IACD,UAAU,EAAE,gBAAgB,CAAA;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,GAAG,EAAE,cAAc,CAAA;IACnB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CAoClB"}
+{"version":3,"file":"getFilePrefix.d.ts","sourceRoot":"","sources":["../../src/utilities/getFilePrefix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAgB,MAAM,SAAS,CAAA;AAMzF;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,EAClC,UAAU,EACV,gBAAgB,EAChB,GAAG,EACH,QAAQ,EACR,gBAAgB,EAChB,GAAG,EACH,eAAe,EACf,oBAA4B,GAC7B,EAAE;IACD,UAAU,EAAE,gBAAgB,CAAA;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,GAAG,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU,CAAA;IAC3D,QAAQ,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,GAAG,EAAE,cAAc,CAAA;IACnB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B,GAAG,OAAO,CAAC,MAAM,CAAC,CAqElB"}