@payloadcms/plugin-import-export 4.0.0-internal.e55ccef → 4.0.0-internal.ea6e8f8

package/dist/import/handlePreview.js

@@ -2,6 +2,7 @@ import { addDataAndFileToRequest } from 'payload';
 import { DEFAULT_PREVIEW_LIMIT, MAX_PREVIEW_LIMIT, MIN_PREVIEW_LIMIT, MIN_PREVIEW_PAGE } from '../constants.js';
 import { applyFieldHooks } from '../utilities/applyFieldHooks.js';
 import { getImportFieldFunctions } from '../utilities/getImportFieldFunctions.js';
+import { getSubmittedFormValues } from '../utilities/getSubmittedFormValues.js';
 import { parseCSV } from '../utilities/parseCSV.js';
 import { parseJSON } from '../utilities/parseJSON.js';
 import { removeDisabledFields } from '../utilities/removeDisabledFields.js';
@@ -9,7 +10,7 @@ import { resolveLimit } from '../utilities/resolveLimit.js';
 import { unflattenObject } from '../utilities/unflattenObject.js';
 export const handlePreview = async (req)=>{
     await addDataAndFileToRequest(req);
-    const { collectionSlug, fileData, format, previewLimit: rawPreviewLimit = DEFAULT_PREVIEW_LIMIT, previewPage: rawPreviewPage = 1 } = req.data;
+    const { collectionSlug, fileData, format, formData, previewLimit: rawPreviewLimit = DEFAULT_PREVIEW_LIMIT, previewPage: rawPreviewPage = 1 } = req.data;
     // Validate and clamp pagination values to safe bounds
     const previewLimit = Math.max(MIN_PREVIEW_LIMIT, Math.min(rawPreviewLimit, MAX_PREVIEW_LIMIT));
     const previewPage = Math.max(MIN_PREVIEW_PAGE, rawPreviewPage);
@@ -82,6 +83,9 @@ export const handlePreview = async (req)=>{
                 batchNumber: 1,
                 data: parsedData,
                 format: format ?? 'csv',
+                importDoc: getSubmittedFormValues({
+                    formData: formData ?? {}
+                }),
                 originalData: originalDocs,
                 req,
                 totalBatches: 1

package/dist/import/handlePreview.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/import/handlePreview.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\n\nimport { addDataAndFileToRequest } from 'payload'\n\nimport type { ImportPreviewResponse } from '../types.js'\n\nimport {\n  DEFAULT_PREVIEW_LIMIT,\n  MAX_PREVIEW_LIMIT,\n  MIN_PREVIEW_LIMIT,\n  MIN_PREVIEW_PAGE,\n} from '../constants.js'\nimport { applyFieldHooks } from '../utilities/applyFieldHooks.js'\nimport { getImportFieldFunctions } from '../utilities/getImportFieldFunctions.js'\nimport { parseCSV } from '../utilities/parseCSV.js'\nimport { parseJSON } from '../utilities/parseJSON.js'\nimport { removeDisabledFields } from '../utilities/removeDisabledFields.js'\nimport { resolveLimit } from '../utilities/resolveLimit.js'\nimport { unflattenObject } from '../utilities/unflattenObject.js'\n\nexport const handlePreview = async (req: PayloadRequest): Promise<Response> => {\n  await addDataAndFileToRequest(req)\n\n  const {\n    collectionSlug,\n    fileData,\n    format,\n    previewLimit: rawPreviewLimit = DEFAULT_PREVIEW_LIMIT,\n    previewPage: rawPreviewPage = 1,\n  } = req.data as {\n    collectionSlug: string\n    fileData?: string\n    format?: 'csv' | 'json'\n    previewLimit?: number\n    previewPage?: number\n  }\n\n  // Validate and clamp pagination values to safe bounds\n  const previewLimit = Math.max(MIN_PREVIEW_LIMIT, Math.min(rawPreviewLimit, MAX_PREVIEW_LIMIT))\n  const previewPage = Math.max(MIN_PREVIEW_PAGE, rawPreviewPage)\n\n  const targetCollection = req.payload.collections[collectionSlug]\n  if (!targetCollection) {\n    return Response.json(\n      { error: `Collection with slug ${collectionSlug} not found` },\n      { status: 400 },\n    )\n  }\n\n  // Resolve max limit from the collection config\n  const pluginConfig = targetCollection.config.custom?.['plugin-import-export']\n  const maxLimit = await resolveLimit({\n    limit: pluginConfig?.importLimit,\n    req,\n  })\n\n  if (!fileData) {\n    return Response.json({ error: 'No file data provided' }, { status: 400 })\n  }\n\n  try {\n    // Parse the file data\n    let parsedData: Record<string, unknown>[]\n    let originalDocs: Record<string, unknown>[] = []\n    const buffer = Buffer.from(fileData, 'base64')\n\n    const importFieldHooks = getImportFieldFunctions({\n      fields: targetCollection.config.flattenedFields || [],\n    })\n\n    if (format === 'csv') {\n      const rawData = await parseCSV({ data: buffer, req })\n      originalDocs = rawData\n\n      // Unflatten CSV data\n      parsedData = rawData\n        .map((doc) => {\n          const unflattened = unflattenObject({\n            data: doc,\n            fields: targetCollection.config.flattenedFields ?? [],\n            format: 'csv',\n            importFieldHooks,\n            req,\n          })\n          return unflattened ?? {}\n        })\n        .filter((doc) => doc && Object.keys(doc).length > 0)\n    } else {\n      const parsedDocs = parseJSON({ data: buffer, req })\n      originalDocs = parsedDocs\n      // Apply field-level import hooks for JSON format\n      parsedData = parsedDocs.map((doc) =>\n        applyFieldHooks({\n          type: 'beforeImport',\n          data: doc,\n          fieldHooks: importFieldHooks,\n          fields: targetCollection.config.flattenedFields ?? [],\n          format: 'json',\n          operation: 'import',\n          req,\n        }),\n      )\n    }\n\n    const importHooks = targetCollection.config.custom?.['plugin-import-export']?.importHooks\n    if (importHooks?.before && parsedData.length > 0) {\n      const result = await importHooks.before({\n        batchNumber: 1,\n        data: parsedData as unknown as Parameters<typeof importHooks.before>[0]['data'],\n        format: format ?? 'csv',\n        originalData: originalDocs,\n        req,\n        totalBatches: 1,\n      })\n      parsedData = result as unknown as Record<string, unknown>[]\n    }\n\n    // Remove disabled fields from the documents\n    const disabledFields =\n      targetCollection.config.admin?.custom?.['plugin-import-export']?.disabledFields ?? []\n\n    if (disabledFields.length > 0) {\n      parsedData = parsedData.map((doc) => removeDisabledFields(doc, disabledFields))\n    }\n\n    // Calculate pagination\n    const totalDocs = parsedData.length\n    const totalPages = totalDocs === 0 ? 0 : Math.ceil(totalDocs / previewLimit)\n    const startIndex = (previewPage - 1) * previewLimit\n    const endIndex = startIndex + previewLimit\n    const paginatedDocs = parsedData.slice(startIndex, endIndex)\n\n    const hasNextPage = previewPage < totalPages\n    const hasPrevPage = previewPage > 1\n\n    // Check if the file exceeds the max limit\n    const limitExceeded = typeof maxLimit === 'number' && maxLimit > 0 && totalDocs > maxLimit\n\n    const response: ImportPreviewResponse = {\n      docs: paginatedDocs,\n      hasNextPage,\n      hasPrevPage,\n      limit: previewLimit,\n      limitExceeded,\n      maxLimit,\n      page: previewPage,\n      totalDocs,\n      totalPages,\n    }\n\n    return Response.json(response)\n  } catch (error) {\n    req.payload.logger.error({ err: error, msg: 'Error parsing import preview data' })\n    return Response.json({ error: 'Failed to parse file data' }, { status: 500 })\n  }\n}\n"],"names":["addDataAndFileToRequest","DEFAULT_PREVIEW_LIMIT","MAX_PREVIEW_LIMIT","MIN_PREVIEW_LIMIT","MIN_PREVIEW_PAGE","applyFieldHooks","getImportFieldFunctions","parseCSV","parseJSON","removeDisabledFields","resolveLimit","unflattenObject","handlePreview","req","collectionSlug","fileData","format","previewLimit","rawPreviewLimit","previewPage","rawPreviewPage","data","Math","max","min","targetCollection","payload","collections","Response","json","error","status","pluginConfig","config","custom","maxLimit","limit","importLimit","parsedData","originalDocs","buffer","Buffer","from","importFieldHooks","fields","flattenedFields","rawData","map","doc","unflattened","filter","Object","keys","length","parsedDocs","type","fieldHooks","operation","importHooks","before","result","batchNumber","originalData","totalBatches","disabledFields","admin","totalDocs","totalPages","ceil","startIndex","endIndex","paginatedDocs","slice","hasNextPage","hasPrevPage","limitExceeded","response","docs","page","logger","err","msg"],"mappings":"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"}
+{"version":3,"sources":["../../src/import/handlePreview.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\n\nimport { addDataAndFileToRequest } from 'payload'\n\nimport type { ImportDoc, ImportPreviewResponse } from '../types.js'\n\nimport {\n  DEFAULT_PREVIEW_LIMIT,\n  MAX_PREVIEW_LIMIT,\n  MIN_PREVIEW_LIMIT,\n  MIN_PREVIEW_PAGE,\n} from '../constants.js'\nimport { applyFieldHooks } from '../utilities/applyFieldHooks.js'\nimport { getImportFieldFunctions } from '../utilities/getImportFieldFunctions.js'\nimport { getSubmittedFormValues } from '../utilities/getSubmittedFormValues.js'\nimport { parseCSV } from '../utilities/parseCSV.js'\nimport { parseJSON } from '../utilities/parseJSON.js'\nimport { removeDisabledFields } from '../utilities/removeDisabledFields.js'\nimport { resolveLimit } from '../utilities/resolveLimit.js'\nimport { unflattenObject } from '../utilities/unflattenObject.js'\n\nexport const handlePreview = async (req: PayloadRequest): Promise<Response> => {\n  await addDataAndFileToRequest(req)\n\n  const {\n    collectionSlug,\n    fileData,\n    format,\n    formData,\n    previewLimit: rawPreviewLimit = DEFAULT_PREVIEW_LIMIT,\n    previewPage: rawPreviewPage = 1,\n  } = req.data as {\n    collectionSlug: string\n    fileData?: string\n    format?: 'csv' | 'json'\n    formData?: Record<string, unknown>\n    previewLimit?: number\n    previewPage?: number\n  }\n\n  // Validate and clamp pagination values to safe bounds\n  const previewLimit = Math.max(MIN_PREVIEW_LIMIT, Math.min(rawPreviewLimit, MAX_PREVIEW_LIMIT))\n  const previewPage = Math.max(MIN_PREVIEW_PAGE, rawPreviewPage)\n\n  const targetCollection = req.payload.collections[collectionSlug]\n  if (!targetCollection) {\n    return Response.json(\n      { error: `Collection with slug ${collectionSlug} not found` },\n      { status: 400 },\n    )\n  }\n\n  // Resolve max limit from the collection config\n  const pluginConfig = targetCollection.config.custom?.['plugin-import-export']\n  const maxLimit = await resolveLimit({\n    limit: pluginConfig?.importLimit,\n    req,\n  })\n\n  if (!fileData) {\n    return Response.json({ error: 'No file data provided' }, { status: 400 })\n  }\n\n  try {\n    // Parse the file data\n    let parsedData: Record<string, unknown>[]\n    let originalDocs: Record<string, unknown>[] = []\n    const buffer = Buffer.from(fileData, 'base64')\n\n    const importFieldHooks = getImportFieldFunctions({\n      fields: targetCollection.config.flattenedFields || [],\n    })\n\n    if (format === 'csv') {\n      const rawData = await parseCSV({ data: buffer, req })\n      originalDocs = rawData\n\n      // Unflatten CSV data\n      parsedData = rawData\n        .map((doc) => {\n          const unflattened = unflattenObject({\n            data: doc,\n            fields: targetCollection.config.flattenedFields ?? [],\n            format: 'csv',\n            importFieldHooks,\n            req,\n          })\n          return unflattened ?? {}\n        })\n        .filter((doc) => doc && Object.keys(doc).length > 0)\n    } else {\n      const parsedDocs = parseJSON({ data: buffer, req })\n      originalDocs = parsedDocs\n      // Apply field-level import hooks for JSON format\n      parsedData = parsedDocs.map((doc) =>\n        applyFieldHooks({\n          type: 'beforeImport',\n          data: doc,\n          fieldHooks: importFieldHooks,\n          fields: targetCollection.config.flattenedFields ?? [],\n          format: 'json',\n          operation: 'import',\n          req,\n        }),\n      )\n    }\n\n    const importHooks = targetCollection.config.custom?.['plugin-import-export']?.importHooks\n    if (importHooks?.before && parsedData.length > 0) {\n      const result = await importHooks.before({\n        batchNumber: 1,\n        data: parsedData as unknown as Parameters<typeof importHooks.before>[0]['data'],\n        format: format ?? 'csv',\n        importDoc: getSubmittedFormValues({\n          formData: formData ?? {},\n        }) as ImportDoc,\n        originalData: originalDocs,\n        req,\n        totalBatches: 1,\n      })\n      parsedData = result as unknown as Record<string, unknown>[]\n    }\n\n    // Remove disabled fields from the documents\n    const disabledFields =\n      targetCollection.config.admin?.custom?.['plugin-import-export']?.disabledFields ?? []\n\n    if (disabledFields.length > 0) {\n      parsedData = parsedData.map((doc) => removeDisabledFields(doc, disabledFields))\n    }\n\n    // Calculate pagination\n    const totalDocs = parsedData.length\n    const totalPages = totalDocs === 0 ? 0 : Math.ceil(totalDocs / previewLimit)\n    const startIndex = (previewPage - 1) * previewLimit\n    const endIndex = startIndex + previewLimit\n    const paginatedDocs = parsedData.slice(startIndex, endIndex)\n\n    const hasNextPage = previewPage < totalPages\n    const hasPrevPage = previewPage > 1\n\n    // Check if the file exceeds the max limit\n    const limitExceeded = typeof maxLimit === 'number' && maxLimit > 0 && totalDocs > maxLimit\n\n    const response: ImportPreviewResponse = {\n      docs: paginatedDocs,\n      hasNextPage,\n      hasPrevPage,\n      limit: previewLimit,\n      limitExceeded,\n      maxLimit,\n      page: previewPage,\n      totalDocs,\n      totalPages,\n    }\n\n    return Response.json(response)\n  } catch (error) {\n    req.payload.logger.error({ err: error, msg: 'Error parsing import preview data' })\n    return Response.json({ error: 'Failed to parse file data' }, { status: 500 })\n  }\n}\n"],"names":["addDataAndFileToRequest","DEFAULT_PREVIEW_LIMIT","MAX_PREVIEW_LIMIT","MIN_PREVIEW_LIMIT","MIN_PREVIEW_PAGE","applyFieldHooks","getImportFieldFunctions","getSubmittedFormValues","parseCSV","parseJSON","removeDisabledFields","resolveLimit","unflattenObject","handlePreview","req","collectionSlug","fileData","format","formData","previewLimit","rawPreviewLimit","previewPage","rawPreviewPage","data","Math","max","min","targetCollection","payload","collections","Response","json","error","status","pluginConfig","config","custom","maxLimit","limit","importLimit","parsedData","originalDocs","buffer","Buffer","from","importFieldHooks","fields","flattenedFields","rawData","map","doc","unflattened","filter","Object","keys","length","parsedDocs","type","fieldHooks","operation","importHooks","before","result","batchNumber","importDoc","originalData","totalBatches","disabledFields","admin","totalDocs","totalPages","ceil","startIndex","endIndex","paginatedDocs","slice","hasNextPage","hasPrevPage","limitExceeded","response","docs","page","logger","err","msg"],"mappings":"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"}

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { CollectionConfig, CollectionSlug, DataFromCollectionSlug, PayloadRequest } from 'payload';
+import type { CollectionConfig, CollectionSlug, DataFromCollectionSlug, JsonObject, PayloadRequest } from 'payload';
 /**
  * Function to dynamically determine the limit based on request context
  */
@@ -29,6 +29,14 @@ export type ImportResult = {
     total: number;
     updated: number;
 };
+/** Export document or unsaved form values. `id` indicates a saved document. Treat as read-only. */
+export type ExportDoc = {
+    id?: number | string;
+} & JsonObject;
+/** Import document or unsaved preview form values. `id` indicates a saved document. Treat as read-only. */
+export type ImportDoc = {
+    id?: number | string;
+} & JsonObject;
 /**
  * Hook called before each export batch is written to file.
  * Receives the transformed batch data and the original DB documents.
@@ -39,6 +47,8 @@ export type ExportBeforeHook<TSlug extends CollectionSlug = CollectionSlug> = (a
     batchNumber: number;
     /** Transformed batch — flat rows for CSV, nested docs for JSON. Modify and return this. */
     data: Record<string, unknown>[];
+    /** See {@link ExportDoc}. */
+    exportDoc: ExportDoc;
     /** Export format. Open-ended to support custom formats in the future. */
     format: 'csv' | 'json' | ({} & string);
     /**
@@ -63,6 +73,8 @@ export type ExportAfterHook = (args: {
     batchNumber: number;
     /** The batch data that was written */
     data: Record<string, unknown>[];
+    /** See {@link ExportDoc}. */
+    exportDoc: ExportDoc;
     /** Export format */
     format: 'csv' | 'json' | ({} & string);
     /** Raw DB documents before transformation */
@@ -88,6 +100,8 @@ export type ImportBeforeHook<TSlug extends CollectionSlug = CollectionSlug> = (a
     data: Partial<DataFromCollectionSlug<TSlug>>[];
     /** Import format. Open-ended to support custom formats in the future. */
     format: 'csv' | 'json' | ({} & string);
+    /** See {@link ImportDoc}. */
+    importDoc: ImportDoc;
     /** Raw parsed file rows before unflattening. Read-only reference. */
     originalData: Record<string, unknown>[];
     req: PayloadRequest;
@@ -103,6 +117,8 @@ export type ImportAfterHook = (args: {
     batchNumber: number;
     /** Import format */
     format: 'csv' | 'json' | ({} & string);
+    /** See {@link ImportDoc}. */
+    importDoc: ImportDoc;
     /**
      * Raw parsed file rows for this batch before unflattening and before-hook
      * transformation. For CSV this is the flat key/value row; for JSON this is

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  CollectionSlug,\n  DataFromCollectionSlug,\n  PayloadRequest,\n} from 'payload'\n\n/**\n * Function to dynamically determine the limit based on request context\n */\nexport type LimitFunction = (args: { req: PayloadRequest }) => number | Promise<number>\n\n/**\n * Limit configuration - either a hard number or a function.\n * Set to 0 for unlimited (no restriction). Default is 0.\n */\nexport type Limit = LimitFunction | number\n\n/**\n * Type for overriding import/export collection configurations\n */\nexport type CollectionOverride = ({\n  collection,\n}: {\n  collection: CollectionConfig\n}) => CollectionConfig | Promise<CollectionConfig>\n\n/**\n * Result of a completed import operation (or a single batch within one)\n */\nexport type ImportResult = {\n  errors: Array<{\n    doc: Record<string, unknown>\n    error: string\n    index: number\n  }>\n  imported: number\n  total: number\n  updated: number\n}\n\n/**\n * Hook called before each export batch is written to file.\n * Receives the transformed batch data and the original DB documents.\n * Return the modified data array — it replaces `data` for the write step.\n */\nexport type ExportBeforeHook<TSlug extends CollectionSlug = CollectionSlug> = (args: {\n  /** Current batch number, starting at 1 */\n  batchNumber: number\n  /** Transformed batch — flat rows for CSV, nested docs for JSON. Modify and return this. */\n  data: Record<string, unknown>[]\n  /** Export format. Open-ended to support custom formats in the future. */\n  format: 'csv' | 'json' | ({} & string)\n  /**\n   * Raw DB documents before format-specific transformation. Read-only reference.\n   *\n   * Typed as a union so call sites that don't know the collection slug at\n   * compile time (e.g. job tasks) don't need `as any` casts. To get the\n   * narrower typed shape, declare your hook with a slug:\n   * `const hook: ExportBeforeHook<'posts'> = (args) => { ... }`.\n   */\n  originalData: DataFromCollectionSlug<TSlug>[] | Record<string, unknown>[]\n  req: PayloadRequest\n  /** Total number of batches for this export operation */\n  totalBatches: number\n}) => Promise<Record<string, unknown>[]> | Record<string, unknown>[]\n\n/**\n * Hook called after each export batch has been written to file.\n * For logging and observability only — return value is ignored.\n */\nexport type ExportAfterHook = (args: {\n  /** Current batch number, starting at 1 */\n  batchNumber: number\n  /** The batch data that was written */\n  data: Record<string, unknown>[]\n  /** Export format */\n  format: 'csv' | 'json' | ({} & string)\n  /** Raw DB documents before transformation */\n  originalData: Record<string, unknown>[]\n  req: PayloadRequest\n  /** Total number of batches for this export operation */\n  totalBatches: number\n}) => Promise<void> | void\n\n/**\n * Hook called before each import batch is written to the database.\n * Receives the processed (unflattened) documents and the raw file rows.\n * Return the modified documents array — it replaces `data` for the DB write step.\n */\nexport type ImportBeforeHook<TSlug extends CollectionSlug = CollectionSlug> = (args: {\n  /** Current batch number, starting at 1 */\n  batchNumber: number\n  /**\n   * Unflattened documents ready to be written to the database. Modify and\n   * return this. Typed as `Partial<...>` because rows from a CSV or JSON\n   * import are not guaranteed to include every required field of the\n   * collection — required fields are validated at write time.\n   */\n  data: Partial<DataFromCollectionSlug<TSlug>>[]\n  /** Import format. Open-ended to support custom formats in the future. */\n  format: 'csv' | 'json' | ({} & string)\n  /** Raw parsed file rows before unflattening. Read-only reference. */\n  originalData: Record<string, unknown>[]\n  req: PayloadRequest\n  /** Total number of batches for this import operation */\n  totalBatches: number\n}) => Partial<DataFromCollectionSlug<TSlug>>[] | Promise<Partial<DataFromCollectionSlug<TSlug>>[]>\n\n/**\n * Hook called after each import batch has been written to the database.\n * For logging and observability only — return value is ignored.\n */\nexport type ImportAfterHook = (args: {\n  /** Current batch number, starting at 1 */\n  batchNumber: number\n  /** Import format */\n  format: 'csv' | 'json' | ({} & string)\n  /**\n   * Raw parsed file rows for this batch before unflattening and before-hook\n   * transformation. For CSV this is the flat key/value row; for JSON this is\n   * the top-level parsed document. Read-only reference.\n   */\n  originalData: Record<string, unknown>[]\n  req: PayloadRequest\n  /** Result of this batch — counts and errors. Not the cumulative total. */\n  result: ImportResult\n  /** Total number of batches for this import operation */\n  totalBatches: number\n}) => Promise<void> | void\n\n/**\n * Per-collection export configuration. Set on each entry of\n * ```\n * importExportPlugin({ collections: [{ slug, export: { ... } }] })\n * ```\n */\nexport type ExportConfig<TSlug extends CollectionSlug = CollectionSlug> = {\n  /**\n   * Number of documents to process in each batch during export. This config is applied to both jobs and synchronous exports.\n   *\n   * @default 100\n   */\n  batchSize?: number\n  /**\n   * If true, disables the download button in the export preview UI\n   * @default false\n   */\n  disableDownload?: boolean\n  /**\n   * If true, disables the jobs queue for exports and runs them synchronously.\n   * @default false\n   */\n  disableJobsQueue?: boolean\n  /**\n   * If true, disables the save button in the export preview UI\n   * @default false\n   */\n  disableSave?: boolean\n  /**\n   * Forces a specific export format (`csv` or `json`) and hides the format dropdown from the UI.\n   * When defined, this overrides the user's ability to choose a format manually.\n   * If not set, the user can choose between CSV and JSON in the export UI.\n   * @default undefined\n   */\n  format?: 'csv' | 'json'\n  /**\n   * Lifecycle hooks for export operations on this collection.\n   * Hooks fire once per batch.\n   */\n  hooks?: {\n    /**\n     * Called after each batch is written to file. For logging/observability only.\n     * Return value is ignored.\n     */\n    after?: ExportAfterHook\n    /**\n     * Called before each batch is written to file.\n     * Return value replaces the batch data for the write step.\n     */\n    before?: ExportBeforeHook<TSlug>\n  }\n  /**\n   * Maximum number of documents that can be exported in a single operation.\n   * Can be a number or a function that returns a number based on request context.\n   * Set to 0 for unlimited (default). Overrides the global exportLimit if set.\n   */\n  limit?: Limit\n  /**\n   * Override the export collection for this collection.\n   *\n   * @default true\n   */\n  overrideCollection?: CollectionOverride\n}\n\n/**\n * Per-collection import configuration. Set on each entry of\n * ```\n * importExportPlugin({ collections: [{ slug, import: { ... } }] })\n * ```\n */\nexport type ImportConfig<TSlug extends CollectionSlug = CollectionSlug> = {\n  /**\n   * Number of documents to process in each batch during import. This config is applied to both jobs and synchronous imports.\n   *\n   * @default 100\n   */\n  batchSize?: number\n  /**\n   * Default version status for imported documents when _status field is not provided.\n   * Only applies to collections with versions enabled.\n   * @default 'published'\n   */\n  defaultVersionStatus?: 'draft' | 'published'\n  /**\n   * If true, disables the jobs queue for imports and runs them synchronously.\n   * @default false\n   */\n  disableJobsQueue?: boolean\n  /**\n   * Lifecycle hooks for import operations on this collection.\n   * Hooks fire once per batch.\n   */\n  hooks?: {\n    /**\n     * Called after each batch is written to the database. For logging/observability only.\n     * Return value is ignored.\n     */\n    after?: ImportAfterHook\n    /**\n     * Called before each batch is written to the database.\n     * Return value replaces the batch data for the DB write step.\n     */\n    before?: ImportBeforeHook<TSlug>\n  }\n  /**\n   * Maximum number of documents that can be imported in a single operation.\n   * Can be a number or a function that returns a number based on request context.\n   * Set to 0 for unlimited (default). Overrides the global importLimit if set.\n   */\n  limit?: Limit\n  /**\n   * Override the import collection for this collection.\n   *\n   * @default true\n   */\n  overrideCollection?: CollectionOverride\n}\n\n/**\n * Per-collection plugin entry. Identifies a target collection by `slug` and\n * configures its export/import behavior; either side can be disabled with `false`.\n */\nexport type PluginCollectionConfig<TSlug extends CollectionSlug = CollectionSlug> = {\n  /**\n   * Override the import collection for this collection or disable it entirely with `false`.\n   *\n   * @default true\n   */\n  export?: boolean | ExportConfig<TSlug>\n  /**\n   * Override the export collection for this collection or disable it entirely with `false`.\n   *\n   * @default true\n   */\n  import?: boolean | ImportConfig<TSlug>\n  /**\n   * Target collection's slug for import/export functionality\n   */\n  slug: TSlug\n}\n\n/**\n * Configuration options for the Import/Export plugin\n */\nexport type ImportExportPluginConfig = {\n  /**\n   * Global default batch size for both import and export operations.\n   * Can be overridden at the collection level via `export.batchSize` or `import.batchSize`.\n   * @default 100\n   */\n  batchSize?: number\n\n  /**\n   * Collections to include the Import/Export controls in.\n   * If not specified, all collections will have import/export enabled.\n   * @default undefined (all collections)\n   */\n  collections: PluginCollectionConfig<CollectionSlug>[]\n\n  /**\n   * Enable debug logging for troubleshooting import/export operations\n   * @default false\n   */\n  debug?: boolean\n\n  /**\n   * Global default version status for imported documents when _status field is not provided.\n   * Only applies to collections with versions enabled.\n   * Can be overridden at the collection level via `import.defaultVersionStatus`.\n   * @default 'published'\n   */\n  defaultVersionStatus?: 'draft' | 'published'\n\n  /**\n   * Global maximum for export operations.\n   * Can be a number or a function that returns a number based on request context.\n   * Set to 0 for unlimited (default). Per-collection limits take precedence.\n   */\n  exportLimit?: Limit\n\n  /**\n   * Global maximum for import operations.\n   * Can be a number or a function that returns a number based on request context.\n   * Set to 0 for unlimited (default). Per-collection limits take precedence.\n   */\n  importLimit?: Limit\n\n  /**\n   * Function to override the default export collection configuration.\n   * Takes the default export collection and allows you to modify and return it.\n   * Useful for adding access control, changing upload directory, etc.\n   *\n   * This can also be set at the collection level via `export` config.\n   */\n  overrideExportCollection?: CollectionOverride\n\n  /**\n   * Function to override the default import collection configuration.\n   * Takes the default import collection and allows you to modify and return it.\n   * Useful for adding access control, changing upload directory, etc.\n   *\n   * This can also be set at the collection level via `import` config.\n   */\n  overrideImportCollection?: CollectionOverride\n}\n\n/**\n * Field-level hook that runs before a field value is exported. Works for both\n * CSV and JSON. Return a value to replace the field, or `undefined` to fall\n * back to default behavior. Mutate `siblingData` to add or remove columns at\n * the same level.\n *\n * Return `null` (CSV only) when the hook has already written its replacement\n * columns to `siblingData` and default flattening should be skipped — used by\n * built-in handlers for polymorphic relationships to avoid duplicate columns.\n */\nexport type FieldBeforeExportHook = (args: {\n  /** Runtime column path, underscore-separated (includes array indices, e.g. `items_0_note`). */\n  columnName: string\n  /** The top-level document being exported. */\n  data: Record<string, unknown>\n  format: 'csv' | 'json' | ({} & string)\n  /** Writable output at the current level. CSV: the flat row accumulator. JSON: the sibling output object. */\n  siblingData: Record<string, unknown>\n  /** Read-only source at the current level, before any transformation. */\n  siblingDoc: Record<string, unknown>\n  value: unknown\n}) => unknown\n\n/**\n * Field-level hook that runs before a field value is imported. Works for both\n * CSV and JSON. Return the transformed value to use for this field.\n */\nexport type FieldBeforeImportHook = (args: {\n  columnName: string\n  /** Full flat row (CSV) or top-level parsed document (JSON). */\n  data: Record<string, unknown>\n  format: 'csv' | 'json' | ({} & string)\n  /** Data at the current level. CSV: same reference as `data`. JSON: the parent-level object. */\n  siblingData: Record<string, unknown>\n  /** Read-only source at the current level, before any transformation. CSV: same as `data`. */\n  siblingDoc: Record<string, unknown>\n  value: unknown\n}) => unknown\n\n/** @internal */\nexport type ExportFieldHookEntry = { fn: FieldBeforeExportHook; type: 'beforeExport' }\n\n/** @internal */\nexport type ImportFieldHookEntry = { fn: FieldBeforeImportHook; type: 'beforeImport' }\n\n/**\n * Base pagination data returned from preview endpoints\n */\nexport type PreviewPaginationData = {\n  /**\n   * Whether there is a next page available\n   */\n  hasNextPage: boolean\n  /**\n   * Whether there is a previous page available\n   */\n  hasPrevPage: boolean\n  /**\n   * Number of documents per page\n   */\n  limit: number\n  /**\n   * The resolved max limit value (max documents allowed), if any\n   */\n  maxLimit?: number\n  /**\n   * Current page number (1-indexed)\n   */\n  page: number\n  /**\n   * Total number of documents\n   */\n  totalDocs: number\n  /**\n   * Total number of pages\n   */\n  totalPages: number\n}\n\n/**\n * Response from export preview endpoint\n */\nexport type ExportPreviewResponse = {\n  /**\n   * Column names for CSV format (undefined for JSON)\n   */\n  columns?: string[]\n  /**\n   * Preview documents (transformed for display)\n   */\n  docs: Record<string, unknown>[]\n  /**\n   * Actual count of docs that will be exported (respects export limit)\n   */\n  exportTotalDocs: number\n} & PreviewPaginationData\n\n/**\n * Response from import preview endpoint\n */\nexport type ImportPreviewResponse = {\n  /**\n   * Preview documents parsed from the import file\n   */\n  docs: Record<string, unknown>[]\n  /**\n   * Whether the file exceeds the max limit\n   */\n  limitExceeded?: boolean\n} & PreviewPaginationData\n"],"names":[],"mappings":"AAmbA;;CAEC,GACD,WASyB"}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type {\n  CollectionConfig,\n  CollectionSlug,\n  DataFromCollectionSlug,\n  JsonObject,\n  PayloadRequest,\n} from 'payload'\n\n/**\n * Function to dynamically determine the limit based on request context\n */\nexport type LimitFunction = (args: { req: PayloadRequest }) => number | Promise<number>\n\n/**\n * Limit configuration - either a hard number or a function.\n * Set to 0 for unlimited (no restriction). Default is 0.\n */\nexport type Limit = LimitFunction | number\n\n/**\n * Type for overriding import/export collection configurations\n */\nexport type CollectionOverride = ({\n  collection,\n}: {\n  collection: CollectionConfig\n}) => CollectionConfig | Promise<CollectionConfig>\n\n/**\n * Result of a completed import operation (or a single batch within one)\n */\nexport type ImportResult = {\n  errors: Array<{\n    doc: Record<string, unknown>\n    error: string\n    index: number\n  }>\n  imported: number\n  total: number\n  updated: number\n}\n\n/** Export document or unsaved form values. `id` indicates a saved document. Treat as read-only. */\nexport type ExportDoc = { id?: number | string } & JsonObject\n\n/** Import document or unsaved preview form values. `id` indicates a saved document. Treat as read-only. */\nexport type ImportDoc = { id?: number | string } & JsonObject\n\n/**\n * Hook called before each export batch is written to file.\n * Receives the transformed batch data and the original DB documents.\n * Return the modified data array — it replaces `data` for the write step.\n */\nexport type ExportBeforeHook<TSlug extends CollectionSlug = CollectionSlug> = (args: {\n  /** Current batch number, starting at 1 */\n  batchNumber: number\n  /** Transformed batch — flat rows for CSV, nested docs for JSON. Modify and return this. */\n  data: Record<string, unknown>[]\n  /** See {@link ExportDoc}. */\n  exportDoc: ExportDoc\n  /** Export format. Open-ended to support custom formats in the future. */\n  format: 'csv' | 'json' | ({} & string)\n  /**\n   * Raw DB documents before format-specific transformation. Read-only reference.\n   *\n   * Typed as a union so call sites that don't know the collection slug at\n   * compile time (e.g. job tasks) don't need `as any` casts. To get the\n   * narrower typed shape, declare your hook with a slug:\n   * `const hook: ExportBeforeHook<'posts'> = (args) => { ... }`.\n   */\n  originalData: DataFromCollectionSlug<TSlug>[] | Record<string, unknown>[]\n  req: PayloadRequest\n  /** Total number of batches for this export operation */\n  totalBatches: number\n}) => Promise<Record<string, unknown>[]> | Record<string, unknown>[]\n\n/**\n * Hook called after each export batch has been written to file.\n * For logging and observability only — return value is ignored.\n */\nexport type ExportAfterHook = (args: {\n  /** Current batch number, starting at 1 */\n  batchNumber: number\n  /** The batch data that was written */\n  data: Record<string, unknown>[]\n  /** See {@link ExportDoc}. */\n  exportDoc: ExportDoc\n  /** Export format */\n  format: 'csv' | 'json' | ({} & string)\n  /** Raw DB documents before transformation */\n  originalData: Record<string, unknown>[]\n  req: PayloadRequest\n  /** Total number of batches for this export operation */\n  totalBatches: number\n}) => Promise<void> | void\n\n/**\n * Hook called before each import batch is written to the database.\n * Receives the processed (unflattened) documents and the raw file rows.\n * Return the modified documents array — it replaces `data` for the DB write step.\n */\nexport type ImportBeforeHook<TSlug extends CollectionSlug = CollectionSlug> = (args: {\n  /** Current batch number, starting at 1 */\n  batchNumber: number\n  /**\n   * Unflattened documents ready to be written to the database. Modify and\n   * return this. Typed as `Partial<...>` because rows from a CSV or JSON\n   * import are not guaranteed to include every required field of the\n   * collection — required fields are validated at write time.\n   */\n  data: Partial<DataFromCollectionSlug<TSlug>>[]\n  /** Import format. Open-ended to support custom formats in the future. */\n  format: 'csv' | 'json' | ({} & string)\n  /** See {@link ImportDoc}. */\n  importDoc: ImportDoc\n  /** Raw parsed file rows before unflattening. Read-only reference. */\n  originalData: Record<string, unknown>[]\n  req: PayloadRequest\n  /** Total number of batches for this import operation */\n  totalBatches: number\n}) => Partial<DataFromCollectionSlug<TSlug>>[] | Promise<Partial<DataFromCollectionSlug<TSlug>>[]>\n\n/**\n * Hook called after each import batch has been written to the database.\n * For logging and observability only — return value is ignored.\n */\nexport type ImportAfterHook = (args: {\n  /** Current batch number, starting at 1 */\n  batchNumber: number\n  /** Import format */\n  format: 'csv' | 'json' | ({} & string)\n  /** See {@link ImportDoc}. */\n  importDoc: ImportDoc\n  /**\n   * Raw parsed file rows for this batch before unflattening and before-hook\n   * transformation. For CSV this is the flat key/value row; for JSON this is\n   * the top-level parsed document. Read-only reference.\n   */\n  originalData: Record<string, unknown>[]\n  req: PayloadRequest\n  /** Result of this batch — counts and errors. Not the cumulative total. */\n  result: ImportResult\n  /** Total number of batches for this import operation */\n  totalBatches: number\n}) => Promise<void> | void\n\n/**\n * Per-collection export configuration. Set on each entry of\n * ```\n * importExportPlugin({ collections: [{ slug, export: { ... } }] })\n * ```\n */\nexport type ExportConfig<TSlug extends CollectionSlug = CollectionSlug> = {\n  /**\n   * Number of documents to process in each batch during export. This config is applied to both jobs and synchronous exports.\n   *\n   * @default 100\n   */\n  batchSize?: number\n  /**\n   * If true, disables the download button in the export preview UI\n   * @default false\n   */\n  disableDownload?: boolean\n  /**\n   * If true, disables the jobs queue for exports and runs them synchronously.\n   * @default false\n   */\n  disableJobsQueue?: boolean\n  /**\n   * If true, disables the save button in the export preview UI\n   * @default false\n   */\n  disableSave?: boolean\n  /**\n   * Forces a specific export format (`csv` or `json`) and hides the format dropdown from the UI.\n   * When defined, this overrides the user's ability to choose a format manually.\n   * If not set, the user can choose between CSV and JSON in the export UI.\n   * @default undefined\n   */\n  format?: 'csv' | 'json'\n  /**\n   * Lifecycle hooks for export operations on this collection.\n   * Hooks fire once per batch.\n   */\n  hooks?: {\n    /**\n     * Called after each batch is written to file. For logging/observability only.\n     * Return value is ignored.\n     */\n    after?: ExportAfterHook\n    /**\n     * Called before each batch is written to file.\n     * Return value replaces the batch data for the write step.\n     */\n    before?: ExportBeforeHook<TSlug>\n  }\n  /**\n   * Maximum number of documents that can be exported in a single operation.\n   * Can be a number or a function that returns a number based on request context.\n   * Set to 0 for unlimited (default). Overrides the global exportLimit if set.\n   */\n  limit?: Limit\n  /**\n   * Override the export collection for this collection.\n   *\n   * @default true\n   */\n  overrideCollection?: CollectionOverride\n}\n\n/**\n * Per-collection import configuration. Set on each entry of\n * ```\n * importExportPlugin({ collections: [{ slug, import: { ... } }] })\n * ```\n */\nexport type ImportConfig<TSlug extends CollectionSlug = CollectionSlug> = {\n  /**\n   * Number of documents to process in each batch during import. This config is applied to both jobs and synchronous imports.\n   *\n   * @default 100\n   */\n  batchSize?: number\n  /**\n   * Default version status for imported documents when _status field is not provided.\n   * Only applies to collections with versions enabled.\n   * @default 'published'\n   */\n  defaultVersionStatus?: 'draft' | 'published'\n  /**\n   * If true, disables the jobs queue for imports and runs them synchronously.\n   * @default false\n   */\n  disableJobsQueue?: boolean\n  /**\n   * Lifecycle hooks for import operations on this collection.\n   * Hooks fire once per batch.\n   */\n  hooks?: {\n    /**\n     * Called after each batch is written to the database. For logging/observability only.\n     * Return value is ignored.\n     */\n    after?: ImportAfterHook\n    /**\n     * Called before each batch is written to the database.\n     * Return value replaces the batch data for the DB write step.\n     */\n    before?: ImportBeforeHook<TSlug>\n  }\n  /**\n   * Maximum number of documents that can be imported in a single operation.\n   * Can be a number or a function that returns a number based on request context.\n   * Set to 0 for unlimited (default). Overrides the global importLimit if set.\n   */\n  limit?: Limit\n  /**\n   * Override the import collection for this collection.\n   *\n   * @default true\n   */\n  overrideCollection?: CollectionOverride\n}\n\n/**\n * Per-collection plugin entry. Identifies a target collection by `slug` and\n * configures its export/import behavior; either side can be disabled with `false`.\n */\nexport type PluginCollectionConfig<TSlug extends CollectionSlug = CollectionSlug> = {\n  /**\n   * Override the import collection for this collection or disable it entirely with `false`.\n   *\n   * @default true\n   */\n  export?: boolean | ExportConfig<TSlug>\n  /**\n   * Override the export collection for this collection or disable it entirely with `false`.\n   *\n   * @default true\n   */\n  import?: boolean | ImportConfig<TSlug>\n  /**\n   * Target collection's slug for import/export functionality\n   */\n  slug: TSlug\n}\n\n/**\n * Configuration options for the Import/Export plugin\n */\nexport type ImportExportPluginConfig = {\n  /**\n   * Global default batch size for both import and export operations.\n   * Can be overridden at the collection level via `export.batchSize` or `import.batchSize`.\n   * @default 100\n   */\n  batchSize?: number\n\n  /**\n   * Collections to include the Import/Export controls in.\n   * If not specified, all collections will have import/export enabled.\n   * @default undefined (all collections)\n   */\n  collections: PluginCollectionConfig<CollectionSlug>[]\n\n  /**\n   * Enable debug logging for troubleshooting import/export operations\n   * @default false\n   */\n  debug?: boolean\n\n  /**\n   * Global default version status for imported documents when _status field is not provided.\n   * Only applies to collections with versions enabled.\n   * Can be overridden at the collection level via `import.defaultVersionStatus`.\n   * @default 'published'\n   */\n  defaultVersionStatus?: 'draft' | 'published'\n\n  /**\n   * Global maximum for export operations.\n   * Can be a number or a function that returns a number based on request context.\n   * Set to 0 for unlimited (default). Per-collection limits take precedence.\n   */\n  exportLimit?: Limit\n\n  /**\n   * Global maximum for import operations.\n   * Can be a number or a function that returns a number based on request context.\n   * Set to 0 for unlimited (default). Per-collection limits take precedence.\n   */\n  importLimit?: Limit\n\n  /**\n   * Function to override the default export collection configuration.\n   * Takes the default export collection and allows you to modify and return it.\n   * Useful for adding access control, changing upload directory, etc.\n   *\n   * This can also be set at the collection level via `export` config.\n   */\n  overrideExportCollection?: CollectionOverride\n\n  /**\n   * Function to override the default import collection configuration.\n   * Takes the default import collection and allows you to modify and return it.\n   * Useful for adding access control, changing upload directory, etc.\n   *\n   * This can also be set at the collection level via `import` config.\n   */\n  overrideImportCollection?: CollectionOverride\n}\n\n/**\n * Field-level hook that runs before a field value is exported. Works for both\n * CSV and JSON. Return a value to replace the field, or `undefined` to fall\n * back to default behavior. Mutate `siblingData` to add or remove columns at\n * the same level.\n *\n * Return `null` (CSV only) when the hook has already written its replacement\n * columns to `siblingData` and default flattening should be skipped — used by\n * built-in handlers for polymorphic relationships to avoid duplicate columns.\n */\nexport type FieldBeforeExportHook = (args: {\n  /** Runtime column path, underscore-separated (includes array indices, e.g. `items_0_note`). */\n  columnName: string\n  /** The top-level document being exported. */\n  data: Record<string, unknown>\n  format: 'csv' | 'json' | ({} & string)\n  /** Writable output at the current level. CSV: the flat row accumulator. JSON: the sibling output object. */\n  siblingData: Record<string, unknown>\n  /** Read-only source at the current level, before any transformation. */\n  siblingDoc: Record<string, unknown>\n  value: unknown\n}) => unknown\n\n/**\n * Field-level hook that runs before a field value is imported. Works for both\n * CSV and JSON. Return the transformed value to use for this field.\n */\nexport type FieldBeforeImportHook = (args: {\n  columnName: string\n  /** Full flat row (CSV) or top-level parsed document (JSON). */\n  data: Record<string, unknown>\n  format: 'csv' | 'json' | ({} & string)\n  /** Data at the current level. CSV: same reference as `data`. JSON: the parent-level object. */\n  siblingData: Record<string, unknown>\n  /** Read-only source at the current level, before any transformation. CSV: same as `data`. */\n  siblingDoc: Record<string, unknown>\n  value: unknown\n}) => unknown\n\n/** @internal */\nexport type ExportFieldHookEntry = { fn: FieldBeforeExportHook; type: 'beforeExport' }\n\n/** @internal */\nexport type ImportFieldHookEntry = { fn: FieldBeforeImportHook; type: 'beforeImport' }\n\n/**\n * Base pagination data returned from preview endpoints\n */\nexport type PreviewPaginationData = {\n  /**\n   * Whether there is a next page available\n   */\n  hasNextPage: boolean\n  /**\n   * Whether there is a previous page available\n   */\n  hasPrevPage: boolean\n  /**\n   * Number of documents per page\n   */\n  limit: number\n  /**\n   * The resolved max limit value (max documents allowed), if any\n   */\n  maxLimit?: number\n  /**\n   * Current page number (1-indexed)\n   */\n  page: number\n  /**\n   * Total number of documents\n   */\n  totalDocs: number\n  /**\n   * Total number of pages\n   */\n  totalPages: number\n}\n\n/**\n * Response from export preview endpoint\n */\nexport type ExportPreviewResponse = {\n  /**\n   * Column names for CSV format (undefined for JSON)\n   */\n  columns?: string[]\n  /**\n   * Preview documents (transformed for display)\n   */\n  docs: Record<string, unknown>[]\n  /**\n   * Actual count of docs that will be exported (respects export limit)\n   */\n  exportTotalDocs: number\n} & PreviewPaginationData\n\n/**\n * Response from import preview endpoint\n */\nexport type ImportPreviewResponse = {\n  /**\n   * Preview documents parsed from the import file\n   */\n  docs: Record<string, unknown>[]\n  /**\n   * Whether the file exceeds the max limit\n   */\n  limitExceeded?: boolean\n} & PreviewPaginationData\n"],"names":[],"mappings":"AAkcA;;CAEC,GACD,WASyB"}

package/dist/utilities/getExportFieldFunctions.js

@@ -50,45 +50,82 @@ const registerExportHandler = (field, fullKey, result)=>{
             registerHandler(({ value })=>typeof value === 'object' && value && 'id' in value ? value.id : value);
             return;
         }
-        registerHandler(({ siblingData, value })=>{
-            if (isPolymorphicRelValue(value)) {
-                const id = getPolymorphicRelId(value);
-                if (id !== undefined) {
-                    siblingData[`${fullKey}_id`] = id;
-                    siblingData[`${fullKey}_relationTo`] = value.relationTo;
-                }
+        registerHandler(({ format, siblingData, value })=>{
+            // A shape this handler does not recognize is left untouched for JSON, which holds the
+            // source value verbatim. CSV still clears it, since its id/relationTo would otherwise
+            // land in sibling columns.
+            if (!isPolymorphicRelValue(value)) {
+                return format === 'json' ? undefined : null;
+            }
+            // A recognized reference that resolves to no id is dangling, and a dangling reference
+            // cannot be imported back — clear it for both formats.
+            const id = getPolymorphicRelId(value);
+            if (id === undefined) {
+                return null;
+            }
+            if (format === 'json') {
+                return {
+                    relationTo: value.relationTo,
+                    value: id
+                };
             }
+            siblingData[`${fullKey}_id`] = id;
+            siblingData[`${fullKey}_relationTo`] = value.relationTo;
             return null;
         });
         return;
     }
     if (!Array.isArray(field.relationTo)) {
-        registerHandler(({ siblingData, value })=>{
-            if (Array.isArray(value)) {
-                value.forEach((val, i)=>{
-                    const id = typeof val === 'object' && val ? val.id : val;
-                    siblingData[`${fullKey}_${i}_id`] = id;
-                });
-                return null;
+        registerHandler(({ format, siblingData, value })=>{
+            if (!Array.isArray(value)) {
+                return undefined;
             }
-            return undefined;
+            const ids = value.map((val)=>typeof val === 'object' && val ? val.id : val);
+            // Bare null entries fail relationship validation when the JSON is imported, so drop
+            // references that could not be resolved. CSV keeps source indexes in its column names;
+            // unflattening those columns collapses any gaps on import.
+            if (format === 'json') {
+                return ids.filter((id)=>id !== null && id !== undefined);
+            }
+            ids.forEach((id, i)=>{
+                siblingData[`${fullKey}_${i}_id`] = id;
+            });
+            return null;
         });
         return;
     }
-    registerHandler(({ siblingData, value })=>{
-        if (Array.isArray(value)) {
-            value.forEach((val, i)=>{
-                if (isPolymorphicRelValue(val)) {
-                    const id = getPolymorphicRelId(val);
-                    if (id !== undefined) {
-                        siblingData[`${fullKey}_${i}_id`] = id;
-                        siblingData[`${fullKey}_${i}_relationTo`] = val.relationTo;
-                    }
+    registerHandler(({ format, siblingData, value })=>{
+        if (!Array.isArray(value)) {
+            return undefined;
+        }
+        // `index` is carried so CSV columns stay pinned to the source position: an entry
+        // that cannot be resolved to an id leaves a gap rather than shifting its siblings.
+        const rels = value.flatMap((val, index)=>{
+            if (!isPolymorphicRelValue(val)) {
+                return [];
+            }
+            const id = getPolymorphicRelId(val);
+            return id === undefined ? [] : [
+                {
+                    id,
+                    index,
+                    relationTo: val.relationTo
                 }
-            });
-            return null;
+            ];
+        });
+        if (format === 'json') {
+            // Bare null entries fail relationship validation when the JSON is imported, so return
+            // only references that resolved to an id.
+            return rels.map(({ id, relationTo })=>({
+                    relationTo,
+                    value: id
+                }));
         }
-        return undefined;
+        rels.forEach(({ id, index, relationTo })=>{
+            siblingData[`${fullKey}_${index}_id`] = id;
+            siblingData[`${fullKey}_${index}_relationTo`] = relationTo;
+        });
+        return null;
     });
 };
 

package/dist/utilities/getExportFieldFunctions.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/getExportFieldFunctions.ts"],"sourcesContent":["import type { FlattenedField } from 'payload'\n\nimport type { ExportFieldHookEntry, FieldBeforeExportHook } from '../types.js'\n\nimport { registerFieldHooks } from './flattenedFields.js'\nimport { getPolymorphicRelId, isPolymorphicRelValue } from './polymorphicRel.js'\n\ntype Args = {\n  fields: FlattenedField[]\n}\n\n/**\n * Builds a map from logical field path (e.g. `content_textBlock_body`) to\n * the export hook entry. Paths include block slugs but never array indices.\n */\nexport const getExportFieldFunctions = ({ fields }: Args): Record<string, ExportFieldHookEntry> => {\n  const result: Record<string, ExportFieldHookEntry> = {}\n  registerFieldHooks(fields, '', result, registerExportHandler)\n  return result\n}\n\nconst registerExportHandler = (\n  field: FlattenedField,\n  fullKey: string,\n  result: Record<string, ExportFieldHookEntry>,\n): void => {\n  const beforeExport = field.custom?.['plugin-import-export']?.hooks?.beforeExport\n\n  if (typeof beforeExport === 'function') {\n    result[fullKey] = { type: 'beforeExport', fn: beforeExport }\n    return\n  }\n\n  const registerHandler = (handler: FieldBeforeExportHook) => {\n    result[fullKey] = { type: 'beforeExport', fn: handler }\n  }\n\n  if (field.type === 'json' || field.type === 'richText') {\n    registerHandler(({ format, value }) => {\n      if (format === 'json') {\n        return value\n      }\n      if (value === null || value === undefined) {\n        return value\n      }\n      if (typeof value === 'object') {\n        return JSON.stringify(value)\n      }\n      return value\n    })\n    return\n  }\n\n  if (field.type === 'date') {\n    registerHandler(({ value }) => value)\n    return\n  }\n\n  if (field.type !== 'relationship' && field.type !== 'upload') {\n    return\n  }\n\n  if (field.hasMany !== true) {\n    if (!Array.isArray(field.relationTo)) {\n      registerHandler(({ value }) =>\n        typeof value === 'object' && value && 'id' in value ? value.id : value,\n      )\n      return\n    }\n\n    registerHandler(({ siblingData, value }) => {\n      if (isPolymorphicRelValue(value)) {\n        const id = getPolymorphicRelId(value)\n        if (id !== undefined) {\n          siblingData[`${fullKey}_id`] = id\n          siblingData[`${fullKey}_relationTo`] = value.relationTo\n        }\n      }\n      return null\n    })\n    return\n  }\n\n  if (!Array.isArray(field.relationTo)) {\n    registerHandler(({ siblingData, value }) => {\n      if (Array.isArray(value)) {\n        value.forEach((val, i) => {\n          const id = typeof val === 'object' && val ? (val as { id: unknown }).id : val\n          siblingData[`${fullKey}_${i}_id`] = id\n        })\n        return null\n      }\n      return undefined\n    })\n    return\n  }\n\n  registerHandler(({ siblingData, value }) => {\n    if (Array.isArray(value)) {\n      value.forEach((val, i) => {\n        if (isPolymorphicRelValue(val)) {\n          const id = getPolymorphicRelId(val)\n          if (id !== undefined) {\n            siblingData[`${fullKey}_${i}_id`] = id\n            siblingData[`${fullKey}_${i}_relationTo`] = val.relationTo\n          }\n        }\n      })\n      return null\n    }\n    return undefined\n  })\n}\n"],"names":["registerFieldHooks","getPolymorphicRelId","isPolymorphicRelValue","getExportFieldFunctions","fields","result","registerExportHandler","field","fullKey","beforeExport","custom","hooks","type","fn","registerHandler","handler","format","value","undefined","JSON","stringify","hasMany","Array","isArray","relationTo","id","siblingData","forEach","val","i"],"mappings":"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"}
+{"version":3,"sources":["../../src/utilities/getExportFieldFunctions.ts"],"sourcesContent":["import type { FlattenedField } from 'payload'\n\nimport type { ExportFieldHookEntry, FieldBeforeExportHook } from '../types.js'\n\nimport { registerFieldHooks } from './flattenedFields.js'\nimport { getPolymorphicRelId, isPolymorphicRelValue } from './polymorphicRel.js'\n\ntype Args = {\n  fields: FlattenedField[]\n}\n\n/**\n * Builds a map from logical field path (e.g. `content_textBlock_body`) to\n * the export hook entry. Paths include block slugs but never array indices.\n */\nexport const getExportFieldFunctions = ({ fields }: Args): Record<string, ExportFieldHookEntry> => {\n  const result: Record<string, ExportFieldHookEntry> = {}\n  registerFieldHooks(fields, '', result, registerExportHandler)\n  return result\n}\n\nconst registerExportHandler = (\n  field: FlattenedField,\n  fullKey: string,\n  result: Record<string, ExportFieldHookEntry>,\n): void => {\n  const beforeExport = field.custom?.['plugin-import-export']?.hooks?.beforeExport\n\n  if (typeof beforeExport === 'function') {\n    result[fullKey] = { type: 'beforeExport', fn: beforeExport }\n    return\n  }\n\n  const registerHandler = (handler: FieldBeforeExportHook) => {\n    result[fullKey] = { type: 'beforeExport', fn: handler }\n  }\n\n  if (field.type === 'json' || field.type === 'richText') {\n    registerHandler(({ format, value }) => {\n      if (format === 'json') {\n        return value\n      }\n      if (value === null || value === undefined) {\n        return value\n      }\n      if (typeof value === 'object') {\n        return JSON.stringify(value)\n      }\n      return value\n    })\n    return\n  }\n\n  if (field.type === 'date') {\n    registerHandler(({ value }) => value)\n    return\n  }\n\n  if (field.type !== 'relationship' && field.type !== 'upload') {\n    return\n  }\n\n  if (field.hasMany !== true) {\n    if (!Array.isArray(field.relationTo)) {\n      registerHandler(({ value }) =>\n        typeof value === 'object' && value && 'id' in value ? value.id : value,\n      )\n      return\n    }\n\n    registerHandler(({ format, siblingData, value }) => {\n      // A shape this handler does not recognize is left untouched for JSON, which holds the\n      // source value verbatim. CSV still clears it, since its id/relationTo would otherwise\n      // land in sibling columns.\n      if (!isPolymorphicRelValue(value)) {\n        return format === 'json' ? undefined : null\n      }\n\n      // A recognized reference that resolves to no id is dangling, and a dangling reference\n      // cannot be imported back — clear it for both formats.\n      const id = getPolymorphicRelId(value)\n      if (id === undefined) {\n        return null\n      }\n\n      if (format === 'json') {\n        return { relationTo: value.relationTo, value: id }\n      }\n      siblingData[`${fullKey}_id`] = id\n      siblingData[`${fullKey}_relationTo`] = value.relationTo\n      return null\n    })\n    return\n  }\n\n  if (!Array.isArray(field.relationTo)) {\n    registerHandler(({ format, siblingData, value }) => {\n      if (!Array.isArray(value)) {\n        return undefined\n      }\n      const ids = value.map((val) =>\n        typeof val === 'object' && val ? (val as { id: unknown }).id : val,\n      )\n      // Bare null entries fail relationship validation when the JSON is imported, so drop\n      // references that could not be resolved. CSV keeps source indexes in its column names;\n      // unflattening those columns collapses any gaps on import.\n      if (format === 'json') {\n        return ids.filter((id) => id !== null && id !== undefined)\n      }\n      ids.forEach((id, i) => {\n        siblingData[`${fullKey}_${i}_id`] = id\n      })\n      return null\n    })\n    return\n  }\n\n  registerHandler(({ format, siblingData, value }) => {\n    if (!Array.isArray(value)) {\n      return undefined\n    }\n    // `index` is carried so CSV columns stay pinned to the source position: an entry\n    // that cannot be resolved to an id leaves a gap rather than shifting its siblings.\n    const rels = value.flatMap((val, index) => {\n      if (!isPolymorphicRelValue(val)) {\n        return []\n      }\n      const id = getPolymorphicRelId(val)\n      return id === undefined ? [] : [{ id, index, relationTo: val.relationTo }]\n    })\n\n    if (format === 'json') {\n      // Bare null entries fail relationship validation when the JSON is imported, so return\n      // only references that resolved to an id.\n      return rels.map(({ id, relationTo }) => ({ relationTo, value: id }))\n    }\n    rels.forEach(({ id, index, relationTo }) => {\n      siblingData[`${fullKey}_${index}_id`] = id\n      siblingData[`${fullKey}_${index}_relationTo`] = relationTo\n    })\n    return null\n  })\n}\n"],"names":["registerFieldHooks","getPolymorphicRelId","isPolymorphicRelValue","getExportFieldFunctions","fields","result","registerExportHandler","field","fullKey","beforeExport","custom","hooks","type","fn","registerHandler","handler","format","value","undefined","JSON","stringify","hasMany","Array","isArray","relationTo","id","siblingData","ids","map","val","filter","forEach","i","rels","flatMap","index"],"mappings":"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"}

package/dist/utilities/getFileFromDoc.js

@@ -1,5 +1,5 @@
 import { FileRetrievalError, getFileByPath } from 'payload';
-import { getExternalFile } from 'payload/internal';
+import { downloadFileToBuffer } from 'payload/internal';
 import { formatAdminURL } from 'payload/shared';
 /**
  * Retrieves file data from an uploaded document, handling both local storage
@@ -33,7 +33,7 @@ import { formatAdminURL } from 'payload/shared';
     }
     if (doc.filename && doc.url) {
         // Cloud storage or external - fetch via Payload's file endpoint
-        // getExternalFile constructs full URL, includes cookies for auth, and
+        // downloadFileToBuffer constructs full URL, includes cookies for auth, and
         // the request goes through Payload's handler chain (including storage adapter)
         // For relative URLs, construct a full URL using formatAdminURL which properly
         // handles serverURL, basePath, and other config. This is important in job contexts
@@ -44,7 +44,7 @@ import { formatAdminURL } from 'payload/shared';
             path: doc.url,
             serverURL: serverURL || req.origin
         });
-        const file = await getExternalFile({
+        const file = await downloadFileToBuffer({
             data: {
                 filename: doc.filename,
                 url: fileUrl

package/dist/utilities/getFileFromDoc.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/getFileFromDoc.ts"],"sourcesContent":["import type { CollectionConfig, FileData, PayloadRequest, UploadConfig } from 'payload'\n\nimport { FileRetrievalError, getFileByPath } from 'payload'\nimport { getExternalFile } from 'payload/internal'\nimport { formatAdminURL } from 'payload/shared'\n\ntype Args = {\n  collectionConfig: CollectionConfig\n  doc: { filename: string; mimeType?: string; url?: string }\n  req: PayloadRequest\n}\n\ntype Result = {\n  data: Buffer\n  mimetype: string\n}\n\n/**\n * Retrieves file data from an uploaded document, handling both local storage\n * and cloud storage (S3, Azure, GCS, etc.) scenarios correctly.\n *\n * This function uses the same pattern as Payload's internal file retrieval:\n * - For local storage: reads directly from disk (efficient, no HTTP roundtrip)\n * - For cloud storage: fetches via Payload's file endpoint, which triggers\n *   the storage adapter's staticHandler to serve the file\n */\nexport const getFileFromDoc = async ({ collectionConfig, doc, req }: Args): Promise<Result> => {\n  const uploadConfig: UploadConfig =\n    typeof collectionConfig.upload === 'object' ? collectionConfig.upload : {}\n  const disableLocalStorage = uploadConfig.disableLocalStorage ?? false\n  const staticDir = uploadConfig.staticDir || collectionConfig.slug\n\n  const serverURL = req.payload.config.serverURL\n  const isLocalFile = (serverURL && doc.url?.startsWith(serverURL)) || doc.url?.startsWith('/')\n\n  if (!disableLocalStorage && isLocalFile && doc.filename) {\n    // Local storage enabled - read directly from disk (efficient, no HTTP roundtrip)\n    const filePath = `${staticDir}/${doc.filename}`\n    const file = await getFileByPath(filePath)\n\n    if (!file) {\n      throw new Error(`File not found at path: ${filePath}`)\n    }\n\n    const mimetype = file.mimetype || doc.mimeType\n\n    if (!mimetype) {\n      throw new FileRetrievalError(req.t, `Unable to determine mimetype for file: ${doc.filename}`)\n    }\n\n    return {\n      data: file.data,\n      mimetype,\n    }\n  }\n\n  if (doc.filename && doc.url) {\n    // Cloud storage or external - fetch via Payload's file endpoint\n    // getExternalFile constructs full URL, includes cookies for auth, and\n    // the request goes through Payload's handler chain (including storage adapter)\n\n    // For relative URLs, construct a full URL using formatAdminURL which properly\n    // handles serverURL, basePath, and other config. This is important in job contexts\n    // where request headers may not be available for URL construction.\n    // Use serverURL from config, falling back to req.origin for local/job requests.\n    const fileUrl = doc.url.startsWith('http')\n      ? doc.url\n      : formatAdminURL({\n          apiRoute: '',\n          path: doc.url as `/${string}`,\n          serverURL: serverURL || req.origin,\n        })\n\n    const file = await getExternalFile({\n      data: { filename: doc.filename, url: fileUrl } as FileData,\n      req,\n      uploadConfig,\n    })\n\n    const mimetype = file.mimetype || doc.mimeType\n\n    if (!mimetype) {\n      throw new FileRetrievalError(req.t, `Unable to determine mimetype for file: ${doc.filename}`)\n    }\n\n    return {\n      data: file.data,\n      mimetype,\n    }\n  }\n\n  throw new Error('Unable to retrieve file: missing filename or url')\n}\n"],"names":["FileRetrievalError","getFileByPath","getExternalFile","formatAdminURL","getFileFromDoc","collectionConfig","doc","req","uploadConfig","upload","disableLocalStorage","staticDir","slug","serverURL","payload","config","isLocalFile","url","startsWith","filename","filePath","file","Error","mimetype","mimeType","t","data","fileUrl","apiRoute","path","origin"],"mappings":"AAEA,SAASA,kBAAkB,EAAEC,aAAa,QAAQ,UAAS;AAC3D,SAASC,eAAe,QAAQ,mBAAkB;AAClD,SAASC,cAAc,QAAQ,iBAAgB;AAa/C;;;;;;;;CAQC,GACD,OAAO,MAAMC,iBAAiB,OAAO,EAAEC,gBAAgB,EAAEC,GAAG,EAAEC,GAAG,EAAQ;IACvE,MAAMC,eACJ,OAAOH,iBAAiBI,MAAM,KAAK,WAAWJ,iBAAiBI,MAAM,GAAG,CAAC;IAC3E,MAAMC,sBAAsBF,aAAaE,mBAAmB,IAAI;IAChE,MAAMC,YAAYH,aAAaG,SAAS,IAAIN,iBAAiBO,IAAI;IAEjE,MAAMC,YAAYN,IAAIO,OAAO,CAACC,MAAM,CAACF,SAAS;IAC9C,MAAMG,cAAc,AAACH,aAAaP,IAAIW,GAAG,EAAEC,WAAWL,cAAeP,IAAIW,GAAG,EAAEC,WAAW;IAEzF,IAAI,CAACR,uBAAuBM,eAAeV,IAAIa,QAAQ,EAAE;QACvD,iFAAiF;QACjF,MAAMC,WAAW,GAAGT,UAAU,CAAC,EAAEL,IAAIa,QAAQ,EAAE;QAC/C,MAAME,OAAO,MAAMpB,cAAcmB;QAEjC,IAAI,CAACC,MAAM;YACT,MAAM,IAAIC,MAAM,CAAC,wBAAwB,EAAEF,UAAU;QACvD;QAEA,MAAMG,WAAWF,KAAKE,QAAQ,IAAIjB,IAAIkB,QAAQ;QAE9C,IAAI,CAACD,UAAU;YACb,MAAM,IAAIvB,mBAAmBO,IAAIkB,CAAC,EAAE,CAAC,uCAAuC,EAAEnB,IAAIa,QAAQ,EAAE;QAC9F;QAEA,OAAO;YACLO,MAAML,KAAKK,IAAI;YACfH;QACF;IACF;IAEA,IAAIjB,IAAIa,QAAQ,IAAIb,IAAIW,GAAG,EAAE;QAC3B,gEAAgE;QAChE,sEAAsE;QACtE,+EAA+E;QAE/E,8EAA8E;QAC9E,mFAAmF;QACnF,mEAAmE;QACnE,gFAAgF;QAChF,MAAMU,UAAUrB,IAAIW,GAAG,CAACC,UAAU,CAAC,UAC/BZ,IAAIW,GAAG,GACPd,eAAe;YACbyB,UAAU;YACVC,MAAMvB,IAAIW,GAAG;YACbJ,WAAWA,aAAaN,IAAIuB,MAAM;QACpC;QAEJ,MAAMT,OAAO,MAAMnB,gBAAgB;YACjCwB,MAAM;gBAAEP,UAAUb,IAAIa,QAAQ;gBAAEF,KAAKU;YAAQ;YAC7CpB;YACAC;QACF;QAEA,MAAMe,WAAWF,KAAKE,QAAQ,IAAIjB,IAAIkB,QAAQ;QAE9C,IAAI,CAACD,UAAU;YACb,MAAM,IAAIvB,mBAAmBO,IAAIkB,CAAC,EAAE,CAAC,uCAAuC,EAAEnB,IAAIa,QAAQ,EAAE;QAC9F;QAEA,OAAO;YACLO,MAAML,KAAKK,IAAI;YACfH;QACF;IACF;IAEA,MAAM,IAAID,MAAM;AAClB,EAAC"}
+{"version":3,"sources":["../../src/utilities/getFileFromDoc.ts"],"sourcesContent":["import type { CollectionConfig, FileData, PayloadRequest, UploadConfig } from 'payload'\n\nimport { FileRetrievalError, getFileByPath } from 'payload'\nimport { downloadFileToBuffer } from 'payload/internal'\nimport { formatAdminURL } from 'payload/shared'\n\ntype Args = {\n  collectionConfig: CollectionConfig\n  doc: { filename: string; mimeType?: string; url?: string }\n  req: PayloadRequest\n}\n\ntype Result = {\n  data: Buffer\n  mimetype: string\n}\n\n/**\n * Retrieves file data from an uploaded document, handling both local storage\n * and cloud storage (S3, Azure, GCS, etc.) scenarios correctly.\n *\n * This function uses the same pattern as Payload's internal file retrieval:\n * - For local storage: reads directly from disk (efficient, no HTTP roundtrip)\n * - For cloud storage: fetches via Payload's file endpoint, which triggers\n *   the storage adapter's staticHandler to serve the file\n */\nexport const getFileFromDoc = async ({ collectionConfig, doc, req }: Args): Promise<Result> => {\n  const uploadConfig: UploadConfig =\n    typeof collectionConfig.upload === 'object' ? collectionConfig.upload : {}\n  const disableLocalStorage = uploadConfig.disableLocalStorage ?? false\n  const staticDir = uploadConfig.staticDir || collectionConfig.slug\n\n  const serverURL = req.payload.config.serverURL\n  const isLocalFile = (serverURL && doc.url?.startsWith(serverURL)) || doc.url?.startsWith('/')\n\n  if (!disableLocalStorage && isLocalFile && doc.filename) {\n    // Local storage enabled - read directly from disk (efficient, no HTTP roundtrip)\n    const filePath = `${staticDir}/${doc.filename}`\n    const file = await getFileByPath(filePath)\n\n    if (!file) {\n      throw new Error(`File not found at path: ${filePath}`)\n    }\n\n    const mimetype = file.mimetype || doc.mimeType\n\n    if (!mimetype) {\n      throw new FileRetrievalError(req.t, `Unable to determine mimetype for file: ${doc.filename}`)\n    }\n\n    return {\n      data: file.data,\n      mimetype,\n    }\n  }\n\n  if (doc.filename && doc.url) {\n    // Cloud storage or external - fetch via Payload's file endpoint\n    // downloadFileToBuffer constructs full URL, includes cookies for auth, and\n    // the request goes through Payload's handler chain (including storage adapter)\n\n    // For relative URLs, construct a full URL using formatAdminURL which properly\n    // handles serverURL, basePath, and other config. This is important in job contexts\n    // where request headers may not be available for URL construction.\n    // Use serverURL from config, falling back to req.origin for local/job requests.\n    const fileUrl = doc.url.startsWith('http')\n      ? doc.url\n      : formatAdminURL({\n          apiRoute: '',\n          path: doc.url as `/${string}`,\n          serverURL: serverURL || req.origin,\n        })\n\n    const file = await downloadFileToBuffer({\n      data: { filename: doc.filename, url: fileUrl } as FileData,\n      req,\n      uploadConfig,\n    })\n\n    const mimetype = file.mimetype || doc.mimeType\n\n    if (!mimetype) {\n      throw new FileRetrievalError(req.t, `Unable to determine mimetype for file: ${doc.filename}`)\n    }\n\n    return {\n      data: file.data,\n      mimetype,\n    }\n  }\n\n  throw new Error('Unable to retrieve file: missing filename or url')\n}\n"],"names":["FileRetrievalError","getFileByPath","downloadFileToBuffer","formatAdminURL","getFileFromDoc","collectionConfig","doc","req","uploadConfig","upload","disableLocalStorage","staticDir","slug","serverURL","payload","config","isLocalFile","url","startsWith","filename","filePath","file","Error","mimetype","mimeType","t","data","fileUrl","apiRoute","path","origin"],"mappings":"AAEA,SAASA,kBAAkB,EAAEC,aAAa,QAAQ,UAAS;AAC3D,SAASC,oBAAoB,QAAQ,mBAAkB;AACvD,SAASC,cAAc,QAAQ,iBAAgB;AAa/C;;;;;;;;CAQC,GACD,OAAO,MAAMC,iBAAiB,OAAO,EAAEC,gBAAgB,EAAEC,GAAG,EAAEC,GAAG,EAAQ;IACvE,MAAMC,eACJ,OAAOH,iBAAiBI,MAAM,KAAK,WAAWJ,iBAAiBI,MAAM,GAAG,CAAC;IAC3E,MAAMC,sBAAsBF,aAAaE,mBAAmB,IAAI;IAChE,MAAMC,YAAYH,aAAaG,SAAS,IAAIN,iBAAiBO,IAAI;IAEjE,MAAMC,YAAYN,IAAIO,OAAO,CAACC,MAAM,CAACF,SAAS;IAC9C,MAAMG,cAAc,AAACH,aAAaP,IAAIW,GAAG,EAAEC,WAAWL,cAAeP,IAAIW,GAAG,EAAEC,WAAW;IAEzF,IAAI,CAACR,uBAAuBM,eAAeV,IAAIa,QAAQ,EAAE;QACvD,iFAAiF;QACjF,MAAMC,WAAW,GAAGT,UAAU,CAAC,EAAEL,IAAIa,QAAQ,EAAE;QAC/C,MAAME,OAAO,MAAMpB,cAAcmB;QAEjC,IAAI,CAACC,MAAM;YACT,MAAM,IAAIC,MAAM,CAAC,wBAAwB,EAAEF,UAAU;QACvD;QAEA,MAAMG,WAAWF,KAAKE,QAAQ,IAAIjB,IAAIkB,QAAQ;QAE9C,IAAI,CAACD,UAAU;YACb,MAAM,IAAIvB,mBAAmBO,IAAIkB,CAAC,EAAE,CAAC,uCAAuC,EAAEnB,IAAIa,QAAQ,EAAE;QAC9F;QAEA,OAAO;YACLO,MAAML,KAAKK,IAAI;YACfH;QACF;IACF;IAEA,IAAIjB,IAAIa,QAAQ,IAAIb,IAAIW,GAAG,EAAE;QAC3B,gEAAgE;QAChE,2EAA2E;QAC3E,+EAA+E;QAE/E,8EAA8E;QAC9E,mFAAmF;QACnF,mEAAmE;QACnE,gFAAgF;QAChF,MAAMU,UAAUrB,IAAIW,GAAG,CAACC,UAAU,CAAC,UAC/BZ,IAAIW,GAAG,GACPd,eAAe;YACbyB,UAAU;YACVC,MAAMvB,IAAIW,GAAG;YACbJ,WAAWA,aAAaN,IAAIuB,MAAM;QACpC;QAEJ,MAAMT,OAAO,MAAMnB,qBAAqB;YACtCwB,MAAM;gBAAEP,UAAUb,IAAIa,QAAQ;gBAAEF,KAAKU;YAAQ;YAC7CpB;YACAC;QACF;QAEA,MAAMe,WAAWF,KAAKE,QAAQ,IAAIjB,IAAIkB,QAAQ;QAE9C,IAAI,CAACD,UAAU;YACb,MAAM,IAAIvB,mBAAmBO,IAAIkB,CAAC,EAAE,CAAC,uCAAuC,EAAEnB,IAAIa,QAAQ,EAAE;QAC9F;QAEA,OAAO;YACLO,MAAML,KAAKK,IAAI;YACfH;QACF;IACF;IAEA,MAAM,IAAID,MAAM;AAClB,EAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"getSelect.d.ts","sourceRoot":"","sources":["../../src/utilities/getSelect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,WAAY,MAAM,EAAE,KAAG,iBAoB5C,CAAA"}
+{"version":3,"file":"getSelect.d.ts","sourceRoot":"","sources":["../../src/utilities/getSelect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAOhD;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,WAAY,MAAM,EAAE,KAAG,iBAyB5C,CAAA"}

package/dist/utilities/getSelect.js

@@ -1,3 +1,6 @@
+import { APIError } from 'payload';
+import { hasUnsupportedFieldPathSegment } from 'payload/shared';
+const createSelect = ()=>Object.create(null);
 /**
  * Takes an input of array of string paths in dot notation and returns a select object.
  * Used for both export and import to build Payload's select query format.
@@ -6,16 +9,21 @@
  * getSelect(['id', 'title', 'group.value', 'createdAt', 'updatedAt'])
  * // Returns: { id: true, title: true, group: { value: true }, createdAt: true, updatedAt: true }
  */ export const getSelect = (fields)=>{
-    const select = {};
+    const select = createSelect();
     fields.forEach((field)=>{
         const segments = field.split('.');
+        if (hasUnsupportedFieldPathSegment({
+            segments
+        })) {
+            throw new APIError('Invalid field path.', 400, null, true);
+        }
         let selectRef = select;
         segments.forEach((segment, i)=>{
             if (i === segments.length - 1) {
                 selectRef[segment] = true;
             } else {
-                if (!selectRef[segment]) {
-                    selectRef[segment] = {};
+                if (!Object.prototype.hasOwnProperty.call(selectRef, segment)) {
+                    selectRef[segment] = createSelect();
                 }
                 selectRef = selectRef[segment];
             }

package/dist/utilities/getSelect.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/getSelect.ts"],"sourcesContent":["import type { SelectIncludeType } from 'payload'\n\n/**\n * Takes an input of array of string paths in dot notation and returns a select object.\n * Used for both export and import to build Payload's select query format.\n *\n * @example\n * getSelect(['id', 'title', 'group.value', 'createdAt', 'updatedAt'])\n * // Returns: { id: true, title: true, group: { value: true }, createdAt: true, updatedAt: true }\n */\nexport const getSelect = (fields: string[]): SelectIncludeType => {\n  const select: SelectIncludeType = {}\n\n  fields.forEach((field) => {\n    const segments = field.split('.')\n    let selectRef = select\n\n    segments.forEach((segment, i) => {\n      if (i === segments.length - 1) {\n        selectRef[segment] = true\n      } else {\n        if (!selectRef[segment]) {\n          selectRef[segment] = {}\n        }\n        selectRef = selectRef[segment] as SelectIncludeType\n      }\n    })\n  })\n\n  return select\n}\n"],"names":["getSelect","fields","select","forEach","field","segments","split","selectRef","segment","i","length"],"mappings":"AAEA;;;;;;;CAOC,GACD,OAAO,MAAMA,YAAY,CAACC;IACxB,MAAMC,SAA4B,CAAC;IAEnCD,OAAOE,OAAO,CAAC,CAACC;QACd,MAAMC,WAAWD,MAAME,KAAK,CAAC;QAC7B,IAAIC,YAAYL;QAEhBG,SAASF,OAAO,CAAC,CAACK,SAASC;YACzB,IAAIA,MAAMJ,SAASK,MAAM,GAAG,GAAG;gBAC7BH,SAAS,CAACC,QAAQ,GAAG;YACvB,OAAO;gBACL,IAAI,CAACD,SAAS,CAACC,QAAQ,EAAE;oBACvBD,SAAS,CAACC,QAAQ,GAAG,CAAC;gBACxB;gBACAD,YAAYA,SAAS,CAACC,QAAQ;YAChC;QACF;IACF;IAEA,OAAON;AACT,EAAC"}
+{"version":3,"sources":["../../src/utilities/getSelect.ts"],"sourcesContent":["import type { SelectIncludeType } from 'payload'\n\nimport { APIError } from 'payload'\nimport { hasUnsupportedFieldPathSegment } from 'payload/shared'\n\nconst createSelect = (): SelectIncludeType => Object.create(null) as SelectIncludeType\n\n/**\n * Takes an input of array of string paths in dot notation and returns a select object.\n * Used for both export and import to build Payload's select query format.\n *\n * @example\n * getSelect(['id', 'title', 'group.value', 'createdAt', 'updatedAt'])\n * // Returns: { id: true, title: true, group: { value: true }, createdAt: true, updatedAt: true }\n */\nexport const getSelect = (fields: string[]): SelectIncludeType => {\n  const select = createSelect()\n\n  fields.forEach((field) => {\n    const segments = field.split('.')\n\n    if (hasUnsupportedFieldPathSegment({ segments })) {\n      throw new APIError('Invalid field path.', 400, null, true)\n    }\n\n    let selectRef = select\n\n    segments.forEach((segment, i) => {\n      if (i === segments.length - 1) {\n        selectRef[segment] = true\n      } else {\n        if (!Object.prototype.hasOwnProperty.call(selectRef, segment)) {\n          selectRef[segment] = createSelect()\n        }\n        selectRef = selectRef[segment] as SelectIncludeType\n      }\n    })\n  })\n\n  return select\n}\n"],"names":["APIError","hasUnsupportedFieldPathSegment","createSelect","Object","create","getSelect","fields","select","forEach","field","segments","split","selectRef","segment","i","length","prototype","hasOwnProperty","call"],"mappings":"AAEA,SAASA,QAAQ,QAAQ,UAAS;AAClC,SAASC,8BAA8B,QAAQ,iBAAgB;AAE/D,MAAMC,eAAe,IAAyBC,OAAOC,MAAM,CAAC;AAE5D;;;;;;;CAOC,GACD,OAAO,MAAMC,YAAY,CAACC;IACxB,MAAMC,SAASL;IAEfI,OAAOE,OAAO,CAAC,CAACC;QACd,MAAMC,WAAWD,MAAME,KAAK,CAAC;QAE7B,IAAIV,+BAA+B;YAAES;QAAS,IAAI;YAChD,MAAM,IAAIV,SAAS,uBAAuB,KAAK,MAAM;QACvD;QAEA,IAAIY,YAAYL;QAEhBG,SAASF,OAAO,CAAC,CAACK,SAASC;YACzB,IAAIA,MAAMJ,SAASK,MAAM,GAAG,GAAG;gBAC7BH,SAAS,CAACC,QAAQ,GAAG;YACvB,OAAO;gBACL,IAAI,CAACV,OAAOa,SAAS,CAACC,cAAc,CAACC,IAAI,CAACN,WAAWC,UAAU;oBAC7DD,SAAS,CAACC,QAAQ,GAAGX;gBACvB;gBACAU,YAAYA,SAAS,CAACC,QAAQ;YAChC;QACF;IACF;IAEA,OAAON;AACT,EAAC"}

package/dist/utilities/getSubmittedFormValues.d.ts

@@ -0,0 +1,12 @@
+export declare const getSubmittedFormValues: ({ formData, omit, }: {
+    formData: Record<string, unknown>;
+    omit?: string[];
+}) => Record<string, unknown>;
+/** Tracks value changes, including nested custom fields, without depending on field state identity. */
+export declare const getFormStateSignature: ({ fields, omit, }: {
+    fields: Record<string, {
+        value?: unknown;
+    } | undefined>;
+    omit?: string[];
+}) => string;
+//# sourceMappingURL=getSubmittedFormValues.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getSubmittedFormValues.d.ts","sourceRoot":"","sources":["../../src/utilities/getSubmittedFormValues.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,sBAAsB,wBAGhC;IACD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAIzB,CAAA;AAED,uGAAuG;AACvG,eAAO,MAAM,qBAAqB,sBAG/B;IACD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC,CAAA;IACvD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB,KAAG,MAQH,CAAA"}

package/dist/utilities/getSubmittedFormValues.js

@@ -0,0 +1,24 @@
+/** Unsaved form values must not appear to come from a saved document. */ const serverOwnedFormKeys = new Set([
+    'createdAt',
+    'id',
+    'updatedAt'
+]);
+export const getSubmittedFormValues = ({ formData, omit = [] })=>{
+    const omitKeys = new Set([
+        ...omit,
+        ...serverOwnedFormKeys
+    ]);
+    return Object.fromEntries(Object.entries(formData).filter(([key])=>!omitKeys.has(key)));
+};
+/** Tracks value changes, including nested custom fields, without depending on field state identity. */ export const getFormStateSignature = ({ fields, omit = [] })=>{
+    const omitKeys = new Set([
+        ...omit,
+        ...serverOwnedFormKeys
+    ]);
+    return JSON.stringify(Object.entries(fields).filter(([path])=>!omitKeys.has(path)).map(([path, field])=>[
+            path,
+            field?.value
+        ]));
+};
+
+//# sourceMappingURL=getSubmittedFormValues.js.map

package/dist/utilities/getSubmittedFormValues.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/getSubmittedFormValues.ts"],"sourcesContent":["/** Unsaved form values must not appear to come from a saved document. */\nconst serverOwnedFormKeys = new Set(['createdAt', 'id', 'updatedAt'])\n\nexport const getSubmittedFormValues = ({\n  formData,\n  omit = [],\n}: {\n  formData: Record<string, unknown>\n  omit?: string[]\n}): Record<string, unknown> => {\n  const omitKeys = new Set([...omit, ...serverOwnedFormKeys])\n\n  return Object.fromEntries(Object.entries(formData).filter(([key]) => !omitKeys.has(key)))\n}\n\n/** Tracks value changes, including nested custom fields, without depending on field state identity. */\nexport const getFormStateSignature = ({\n  fields,\n  omit = [],\n}: {\n  fields: Record<string, { value?: unknown } | undefined>\n  omit?: string[]\n}): string => {\n  const omitKeys = new Set([...omit, ...serverOwnedFormKeys])\n\n  return JSON.stringify(\n    Object.entries(fields)\n      .filter(([path]) => !omitKeys.has(path))\n      .map(([path, field]) => [path, field?.value]),\n  )\n}\n"],"names":["serverOwnedFormKeys","Set","getSubmittedFormValues","formData","omit","omitKeys","Object","fromEntries","entries","filter","key","has","getFormStateSignature","fields","JSON","stringify","path","map","field","value"],"mappings":"AAAA,uEAAuE,GACvE,MAAMA,sBAAsB,IAAIC,IAAI;IAAC;IAAa;IAAM;CAAY;AAEpE,OAAO,MAAMC,yBAAyB,CAAC,EACrCC,QAAQ,EACRC,OAAO,EAAE,EAIV;IACC,MAAMC,WAAW,IAAIJ,IAAI;WAAIG;WAASJ;KAAoB;IAE1D,OAAOM,OAAOC,WAAW,CAACD,OAAOE,OAAO,CAACL,UAAUM,MAAM,CAAC,CAAC,CAACC,IAAI,GAAK,CAACL,SAASM,GAAG,CAACD;AACrF,EAAC;AAED,qGAAqG,GACrG,OAAO,MAAME,wBAAwB,CAAC,EACpCC,MAAM,EACNT,OAAO,EAAE,EAIV;IACC,MAAMC,WAAW,IAAIJ,IAAI;WAAIG;WAASJ;KAAoB;IAE1D,OAAOc,KAAKC,SAAS,CACnBT,OAAOE,OAAO,CAACK,QACZJ,MAAM,CAAC,CAAC,CAACO,KAAK,GAAK,CAACX,SAASM,GAAG,CAACK,OACjCC,GAAG,CAAC,CAAC,CAACD,MAAME,MAAM,GAAK;YAACF;YAAME,OAAOC;SAAM;AAElD,EAAC"}

package/dist/utilities/setNestedValue.d.ts

@@ -14,6 +14,7 @@
  * @param obj - The target object to mutate.
  * @param path - A dot-separated string path indicating where to assign the value.
  * @param value - The value to set at the specified path.
+ * @param source - The source object used to validate array boundaries.
  */
-export declare const setNestedValue: (obj: Record<string, unknown>, path: string, value: unknown) => void;
+export declare const setNestedValue: (obj: Record<string, unknown>, path: string, value: unknown, source?: Record<string, unknown>) => void;
 //# sourceMappingURL=setNestedValue.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"setNestedValue.d.ts","sourceRoot":"","sources":["../../src/utilities/setNestedValue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,cAAc,QACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QACtB,MAAM,SACL,OAAO,KACb,IA8CF,CAAA"}
+{"version":3,"file":"setNestedValue.d.ts","sourceRoot":"","sources":["../../src/utilities/setNestedValue.ts"],"names":[],"mappings":"AAoDA;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAO,MAAM,cAAc,QACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QACtB,MAAM,SACL,OAAO,WACL,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,IAyCF,CAAA"}