@payloadcms/plugin-import-export 4.0.0-internal.5b1e7cd → 4.0.0-internal.5e065b3

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

@@ -1 +1 @@
-{"version":3,"file":"flattenObject.d.ts","sourceRoot":"","sources":["../../src/utilities/flattenObject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAEvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAIhD,KAAK,IAAI,GAAG;IACV,GAAG,EAAE,QAAQ,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CAC9C,CAAA;AAED,eAAO,MAAM,aAAa,6CAKvB,IAAI,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAoK/B,CAAA"}
+{"version":3,"file":"flattenObject.d.ts","sourceRoot":"","sources":["../../src/utilities/flattenObject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAMvD,KAAK,IAAI,GAAG;IACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;IACtD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,CAAA;IACtC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,cAAc,CAAA;CACpB,CAAA;AAED,eAAO,MAAM,aAAa,2DAOvB,IAAI,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CA2K/B,CAAA"}

package/dist/utilities/flattenObject.js

@@ -1,119 +1,129 @@
 import { fieldToRegex } from './fieldToRegex.js';
-export const flattenObject = ({ doc, fields, prefix, toCSVFunctions })=>{
+import { isPlainObject } from './isPlainObject.js';
+import { getPolymorphicRelId, isPolymorphicRelValue } from './polymorphicRel.js';
+export const flattenObject = ({ data, exportFieldHooks, fields, format, path, req })=>{
     const row = {};
-    // Helper to get toCSV function by full path or base field name
-    // This allows functions registered for field names (e.g., 'richText') to work
-    // even when the field is nested in arrays/blocks (e.g., 'blocks_0_content_richText')
-    const getToCSVFunction = (fullPath, baseFieldName)=>{
-        return toCSVFunctions?.[fullPath] ?? toCSVFunctions?.[baseFieldName];
+    const invokeHook = (entry, columnName, value, siblingSource)=>{
+        return entry.fn({
+            columnName,
+            data,
+            format,
+            siblingData: row,
+            siblingDoc: siblingSource,
+            value
+        });
     };
-    // When fields are selected, build a set of top-level document keys to process.
-    // This prevents sibling fields with similar prefixes from being included
-    // (e.g. selecting 'dateWithTimezone' won't pull in 'dateWithTimezone_tz')
     const selectedTopLevelKeys = Array.isArray(fields) && fields.length > 0 ? new Set(fields.map((f)=>f.split('.')[0])) : undefined;
-    const flattenWithFilter = (siblingDoc, currentPrefix)=>{
-        Object.entries(siblingDoc).forEach(([key, value])=>{
-            // At the document root, skip keys that don't match any selected field
-            if (!currentPrefix && selectedTopLevelKeys && !selectedTopLevelKeys.has(key)) {
+    const flattenWithFilter = (siblingSource, currentPath, currentSchemaPath)=>{
+        Object.entries(siblingSource).forEach(([key, value])=>{
+            if (!currentPath && selectedTopLevelKeys && !selectedTopLevelKeys.has(key)) {
                 return;
             }
-            const newKey = currentPrefix ? `${currentPrefix}_${key}` : key;
-            const toCSVFn = getToCSVFunction(newKey, key);
+            const fieldPath = currentPath ? `${currentPath}_${key}` : key;
+            const fieldSchemaPath = currentSchemaPath ? `${currentSchemaPath}_${key}` : key;
+            const hookEntry = exportFieldHooks?.[fieldSchemaPath];
+            const flattenArray = (items, arrayPath, arraySchemaPath)=>{
+                items.forEach((item, index)=>{
+                    if (!isPlainObject(item)) {
+                        row[`${arrayPath}_${index}`] = item;
+                        return;
+                    }
+                    const blockType = typeof item.blockType === 'string' ? item.blockType : undefined;
+                    const itemPath = blockType ? `${arrayPath}_${index}_${blockType}` : `${arrayPath}_${index}`;
+                    const itemSchemaPath = blockType ? `${arraySchemaPath}_${blockType}` : arraySchemaPath;
+                    if (isPolymorphicRelValue(item) && isPlainObject(item.value)) {
+                        const id = getPolymorphicRelId(item);
+                        if (id !== undefined) {
+                            row[`${itemPath}_relationTo`] = item.relationTo;
+                            row[`${itemPath}_id`] = id;
+                            return;
+                        }
+                    }
+                    flattenWithFilter(item, itemPath, itemSchemaPath);
+                });
+            };
             if (Array.isArray(value)) {
-                if (toCSVFn) {
+                if (hookEntry) {
                     try {
-                        const result = toCSVFn({
-                            columnName: newKey,
-                            data: row,
-                            doc,
-                            row,
-                            siblingDoc,
-                            value
-                        });
-                        if (typeof result !== 'undefined') {
-                            row[newKey] = result;
+                        const result = invokeHook(hookEntry, fieldPath, value, siblingSource);
+                        if (result === null) {
                             return;
                         }
-                        for(const k in row){
-                            if (k === newKey || k.startsWith(`${newKey}_`)) {
-                                return;
-                            }
+                        if (Array.isArray(result)) {
+                            flattenArray(result, fieldPath, fieldSchemaPath);
+                            return;
                         }
-                    } catch (error) {
-                        throw new Error(`Error in toCSVFunction for array "${newKey}": ${JSON.stringify(value)}\n${error.message}`);
-                    }
-                }
-                value.forEach((item, index)=>{
-                    if (typeof item === 'object' && item !== null) {
-                        const blockType = typeof item.blockType === 'string' ? item.blockType : undefined;
-                        const itemPrefix = blockType ? `${newKey}_${index}_${blockType}` : `${newKey}_${index}`;
-                        if ('relationTo' in item && 'value' in item && typeof item.value === 'object' && item.value !== null) {
-                            row[`${itemPrefix}_relationTo`] = item.relationTo;
-                            row[`${itemPrefix}_id`] = item.value.id;
+                        if (typeof result !== 'undefined') {
+                            row[fieldPath] = result;
                             return;
                         }
-                        flattenWithFilter(item, itemPrefix);
-                    } else {
-                        row[`${newKey}_${index}`] = item;
+                    } catch (error) {
+                        req.payload.logger.error({
+                            err: error,
+                            msg: `[plugin-import-export] Field-level beforeExport hook for "${fieldPath}" threw — falling back to default flattening`
+                        });
                     }
-                });
+                }
+                flattenArray(value, fieldPath, fieldSchemaPath);
             } else if (typeof value === 'object' && value !== null) {
-                if (!toCSVFn) {
-                    flattenWithFilter(value, newKey);
+                if (!hookEntry) {
+                    flattenWithFilter(value, fieldPath, fieldSchemaPath);
                 } else {
+                    const keysBeforeHook = new Set(Object.keys(row));
                     try {
-                        const result = toCSVFn({
-                            columnName: newKey,
-                            data: row,
-                            doc,
-                            row,
-                            siblingDoc,
-                            value
-                        });
-                        if (typeof result !== 'undefined') {
-                            row[newKey] = result;
+                        const result = invokeHook(hookEntry, fieldPath, value, siblingSource);
+                        if (result === null) {
+                            return;
+                        }
+                        if (typeof result === 'undefined') {
+                            const hookWroteForField = Object.keys(row).some((k)=>!keysBeforeHook.has(k) && (k === fieldPath || k.startsWith(`${fieldPath}_`)));
+                            if (hookWroteForField) {
+                                return;
+                            }
+                            flattenWithFilter(value, fieldPath, fieldSchemaPath);
+                        } else if (typeof result === 'object' && !Array.isArray(result)) {
+                            flattenWithFilter(result, fieldPath, fieldSchemaPath);
+                        } else {
+                            row[fieldPath] = result;
                         }
                     } catch (error) {
-                        throw new Error(`Error in toCSVFunction for nested object "${newKey}": ${JSON.stringify(value)}\n${error.message}`);
+                        req.payload.logger.error({
+                            err: error,
+                            msg: `[plugin-import-export] Field-level beforeExport hook for "${fieldPath}" threw — falling back to default flattening`
+                        });
+                        flattenWithFilter(value, fieldPath, fieldSchemaPath);
                     }
                 }
             } else {
-                if (toCSVFn) {
+                if (hookEntry) {
                     try {
-                        const result = toCSVFn({
-                            columnName: newKey,
-                            data: row,
-                            doc,
-                            row,
-                            siblingDoc,
-                            value
-                        });
+                        const result = invokeHook(hookEntry, fieldPath, value, siblingSource);
                         if (typeof result !== 'undefined') {
-                            row[newKey] = result;
+                            row[fieldPath] = result;
                         }
                     } catch (error) {
-                        throw new Error(`Error in toCSVFunction for field "${newKey}": ${JSON.stringify(value)}\n${error.message}`);
+                        req.payload.logger.error({
+                            err: error,
+                            msg: `[plugin-import-export] Field-level beforeExport hook for "${fieldPath}" threw — falling back to original value`
+                        });
+                        row[fieldPath] = value;
                     }
                 } else {
-                    row[newKey] = value;
+                    row[fieldPath] = value;
                 }
             }
         });
     };
-    flattenWithFilter(doc, prefix);
+    flattenWithFilter(data, path, path);
     if (Array.isArray(fields) && fields.length > 0) {
         const orderedResult = {};
-        // Build all field regexes once
         const fieldPatterns = fields.map((field)=>({
                 field,
                 regex: fieldToRegex(field)
             }));
-        // Single pass through row keys - O(keys * fields) regex tests but only one iteration
         const rowKeys = Object.keys(row);
-        // Process in field order to maintain user's specified ordering
         for (const { regex } of fieldPatterns){
             for (const key of rowKeys){
-                // Skip if already added (a key might match multiple field patterns)
                 if (key in orderedResult) {
                     continue;
                 }

package/dist/utilities/flattenObject.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/flattenObject.ts"],"sourcesContent":["import type { Document } from 'payload'\n\nimport type { ToCSVFunction } from '../types.js'\n\nimport { fieldToRegex } from './fieldToRegex.js'\n\ntype Args = {\n  doc: Document\n  fields?: string[]\n  prefix?: string\n  toCSVFunctions: Record<string, ToCSVFunction>\n}\n\nexport const flattenObject = ({\n  doc,\n  fields,\n  prefix,\n  toCSVFunctions,\n}: Args): Record<string, unknown> => {\n  const row: Record<string, unknown> = {}\n\n  // Helper to get toCSV function by full path or base field name\n  // This allows functions registered for field names (e.g., 'richText') to work\n  // even when the field is nested in arrays/blocks (e.g., 'blocks_0_content_richText')\n  const getToCSVFunction = (fullPath: string, baseFieldName: string): ToCSVFunction | undefined => {\n    return toCSVFunctions?.[fullPath] ?? toCSVFunctions?.[baseFieldName]\n  }\n\n  // When fields are selected, build a set of top-level document keys to process.\n  // This prevents sibling fields with similar prefixes from being included\n  // (e.g. selecting 'dateWithTimezone' won't pull in 'dateWithTimezone_tz')\n  const selectedTopLevelKeys =\n    Array.isArray(fields) && fields.length > 0\n      ? new Set(fields.map((f) => f.split('.')[0]))\n      : undefined\n\n  const flattenWithFilter = (siblingDoc: Document, currentPrefix?: string) => {\n    Object.entries(siblingDoc).forEach(([key, value]) => {\n      // At the document root, skip keys that don't match any selected field\n      if (!currentPrefix && selectedTopLevelKeys && !selectedTopLevelKeys.has(key)) {\n        return\n      }\n\n      const newKey = currentPrefix ? `${currentPrefix}_${key}` : key\n      const toCSVFn = getToCSVFunction(newKey, key)\n\n      if (Array.isArray(value)) {\n        if (toCSVFn) {\n          try {\n            const result = toCSVFn({\n              columnName: newKey,\n              data: row,\n              doc,\n              row,\n              siblingDoc,\n              value,\n            })\n\n            if (typeof result !== 'undefined') {\n              row[newKey] = result\n              return\n            }\n\n            for (const k in row) {\n              if (k === newKey || k.startsWith(`${newKey}_`)) {\n                return\n              }\n            }\n          } catch (error) {\n            throw new Error(\n              `Error in toCSVFunction for array \"${newKey}\": ${JSON.stringify(value)}\\n${\n                (error as Error).message\n              }`,\n            )\n          }\n        }\n\n        value.forEach((item, index) => {\n          if (typeof item === 'object' && item !== null) {\n            const blockType = typeof item.blockType === 'string' ? item.blockType : undefined\n            const itemPrefix = blockType ? `${newKey}_${index}_${blockType}` : `${newKey}_${index}`\n\n            if (\n              'relationTo' in item &&\n              'value' in item &&\n              typeof item.value === 'object' &&\n              item.value !== null\n            ) {\n              row[`${itemPrefix}_relationTo`] = item.relationTo\n              row[`${itemPrefix}_id`] = item.value.id\n              return\n            }\n\n            flattenWithFilter(item, itemPrefix)\n          } else {\n            row[`${newKey}_${index}`] = item\n          }\n        })\n      } else if (typeof value === 'object' && value !== null) {\n        if (!toCSVFn) {\n          flattenWithFilter(value, newKey)\n        } else {\n          try {\n            const result = toCSVFn({\n              columnName: newKey,\n              data: row,\n              doc,\n              row,\n              siblingDoc,\n              value,\n            })\n            if (typeof result !== 'undefined') {\n              row[newKey] = result\n            }\n          } catch (error) {\n            throw new Error(\n              `Error in toCSVFunction for nested object \"${newKey}\": ${JSON.stringify(value)}\\n${\n                (error as Error).message\n              }`,\n            )\n          }\n        }\n      } else {\n        if (toCSVFn) {\n          try {\n            const result = toCSVFn({\n              columnName: newKey,\n              data: row,\n              doc,\n              row,\n              siblingDoc,\n              value,\n            })\n            if (typeof result !== 'undefined') {\n              row[newKey] = result\n            }\n          } catch (error) {\n            throw new Error(\n              `Error in toCSVFunction for field \"${newKey}\": ${JSON.stringify(value)}\\n${\n                (error as Error).message\n              }`,\n            )\n          }\n        } else {\n          row[newKey] = value\n        }\n      }\n    })\n  }\n\n  flattenWithFilter(doc, prefix)\n\n  if (Array.isArray(fields) && fields.length > 0) {\n    const orderedResult: Record<string, unknown> = {}\n\n    // Build all field regexes once\n    const fieldPatterns = fields.map((field) => ({\n      field,\n      regex: fieldToRegex(field),\n    }))\n\n    // Single pass through row keys - O(keys * fields) regex tests but only one iteration\n    const rowKeys = Object.keys(row)\n\n    // Process in field order to maintain user's specified ordering\n    for (const { regex } of fieldPatterns) {\n      for (const key of rowKeys) {\n        // Skip if already added (a key might match multiple field patterns)\n        if (key in orderedResult) {\n          continue\n        }\n\n        if (regex.test(key)) {\n          orderedResult[key] = row[key]\n        }\n      }\n    }\n\n    return orderedResult\n  }\n\n  return row\n}\n"],"names":["fieldToRegex","flattenObject","doc","fields","prefix","toCSVFunctions","row","getToCSVFunction","fullPath","baseFieldName","selectedTopLevelKeys","Array","isArray","length","Set","map","f","split","undefined","flattenWithFilter","siblingDoc","currentPrefix","Object","entries","forEach","key","value","has","newKey","toCSVFn","result","columnName","data","k","startsWith","error","Error","JSON","stringify","message","item","index","blockType","itemPrefix","relationTo","id","orderedResult","fieldPatterns","field","regex","rowKeys","keys","test"],"mappings":"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"}
+{"version":3,"sources":["../../src/utilities/flattenObject.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\n\nimport type { ExportFieldHookEntry } from '../types.js'\n\nimport { fieldToRegex } from './fieldToRegex.js'\nimport { isPlainObject } from './isPlainObject.js'\nimport { getPolymorphicRelId, isPolymorphicRelValue } from './polymorphicRel.js'\n\ntype Args = {\n  data: Record<string, unknown>\n  exportFieldHooks: Record<string, ExportFieldHookEntry>\n  fields?: string[]\n  format: 'csv' | 'json' | ({} & string)\n  path?: string\n  req: PayloadRequest\n}\n\nexport const flattenObject = ({\n  data,\n  exportFieldHooks,\n  fields,\n  format,\n  path,\n  req,\n}: Args): Record<string, unknown> => {\n  const row: Record<string, unknown> = {}\n\n  const invokeHook = (\n    entry: ExportFieldHookEntry,\n    columnName: string,\n    value: unknown,\n    siblingSource: Record<string, unknown>,\n  ): unknown => {\n    return entry.fn({\n      columnName,\n      data,\n      format,\n      siblingData: row,\n      siblingDoc: siblingSource,\n      value,\n    })\n  }\n\n  const selectedTopLevelKeys =\n    Array.isArray(fields) && fields.length > 0\n      ? new Set(fields.map((f) => f.split('.')[0]))\n      : undefined\n\n  const flattenWithFilter = (\n    siblingSource: Record<string, unknown>,\n    currentPath: string | undefined,\n    currentSchemaPath: string | undefined,\n  ) => {\n    Object.entries(siblingSource).forEach(([key, value]) => {\n      if (!currentPath && selectedTopLevelKeys && !selectedTopLevelKeys.has(key)) {\n        return\n      }\n\n      const fieldPath = currentPath ? `${currentPath}_${key}` : key\n      const fieldSchemaPath = currentSchemaPath ? `${currentSchemaPath}_${key}` : key\n      const hookEntry = exportFieldHooks?.[fieldSchemaPath]\n\n      const flattenArray = (items: unknown[], arrayPath: string, arraySchemaPath: string): void => {\n        items.forEach((item, index) => {\n          if (!isPlainObject(item)) {\n            row[`${arrayPath}_${index}`] = item\n            return\n          }\n\n          const blockType = typeof item.blockType === 'string' ? item.blockType : undefined\n          const itemPath = blockType\n            ? `${arrayPath}_${index}_${blockType}`\n            : `${arrayPath}_${index}`\n          const itemSchemaPath = blockType ? `${arraySchemaPath}_${blockType}` : arraySchemaPath\n\n          if (isPolymorphicRelValue(item) && isPlainObject(item.value)) {\n            const id = getPolymorphicRelId(item)\n            if (id !== undefined) {\n              row[`${itemPath}_relationTo`] = item.relationTo\n              row[`${itemPath}_id`] = id\n              return\n            }\n          }\n\n          flattenWithFilter(item, itemPath, itemSchemaPath)\n        })\n      }\n\n      if (Array.isArray(value)) {\n        if (hookEntry) {\n          try {\n            const result = invokeHook(hookEntry, fieldPath, value, siblingSource)\n\n            if (result === null) {\n              return\n            }\n\n            if (Array.isArray(result)) {\n              flattenArray(result, fieldPath, fieldSchemaPath)\n              return\n            }\n\n            if (typeof result !== 'undefined') {\n              row[fieldPath] = result\n              return\n            }\n          } catch (error) {\n            req.payload.logger.error({\n              err: error,\n              msg: `[plugin-import-export] Field-level beforeExport hook for \"${fieldPath}\" threw — falling back to default flattening`,\n            })\n          }\n        }\n\n        flattenArray(value, fieldPath, fieldSchemaPath)\n      } else if (typeof value === 'object' && value !== null) {\n        if (!hookEntry) {\n          flattenWithFilter(value as Record<string, unknown>, fieldPath, fieldSchemaPath)\n        } else {\n          const keysBeforeHook = new Set(Object.keys(row))\n          try {\n            const result = invokeHook(hookEntry, fieldPath, value, siblingSource)\n            if (result === null) {\n              return\n            }\n            if (typeof result === 'undefined') {\n              const hookWroteForField = Object.keys(row).some(\n                (k) => !keysBeforeHook.has(k) && (k === fieldPath || k.startsWith(`${fieldPath}_`)),\n              )\n              if (hookWroteForField) {\n                return\n              }\n              flattenWithFilter(value as Record<string, unknown>, fieldPath, fieldSchemaPath)\n            } else if (typeof result === 'object' && !Array.isArray(result)) {\n              flattenWithFilter(result as Record<string, unknown>, fieldPath, fieldSchemaPath)\n            } else {\n              row[fieldPath] = result\n            }\n          } catch (error) {\n            req.payload.logger.error({\n              err: error,\n              msg: `[plugin-import-export] Field-level beforeExport hook for \"${fieldPath}\" threw — falling back to default flattening`,\n            })\n            flattenWithFilter(value as Record<string, unknown>, fieldPath, fieldSchemaPath)\n          }\n        }\n      } else {\n        if (hookEntry) {\n          try {\n            const result = invokeHook(hookEntry, fieldPath, value, siblingSource)\n            if (typeof result !== 'undefined') {\n              row[fieldPath] = result\n            }\n          } catch (error) {\n            req.payload.logger.error({\n              err: error,\n              msg: `[plugin-import-export] Field-level beforeExport hook for \"${fieldPath}\" threw — falling back to original value`,\n            })\n            row[fieldPath] = value\n          }\n        } else {\n          row[fieldPath] = value\n        }\n      }\n    })\n  }\n\n  flattenWithFilter(data, path, path)\n\n  if (Array.isArray(fields) && fields.length > 0) {\n    const orderedResult: Record<string, unknown> = {}\n\n    const fieldPatterns = fields.map((field) => ({\n      field,\n      regex: fieldToRegex(field),\n    }))\n\n    const rowKeys = Object.keys(row)\n\n    for (const { regex } of fieldPatterns) {\n      for (const key of rowKeys) {\n        if (key in orderedResult) {\n          continue\n        }\n\n        if (regex.test(key)) {\n          orderedResult[key] = row[key]\n        }\n      }\n    }\n\n    return orderedResult\n  }\n\n  return row\n}\n"],"names":["fieldToRegex","isPlainObject","getPolymorphicRelId","isPolymorphicRelValue","flattenObject","data","exportFieldHooks","fields","format","path","req","row","invokeHook","entry","columnName","value","siblingSource","fn","siblingData","siblingDoc","selectedTopLevelKeys","Array","isArray","length","Set","map","f","split","undefined","flattenWithFilter","currentPath","currentSchemaPath","Object","entries","forEach","key","has","fieldPath","fieldSchemaPath","hookEntry","flattenArray","items","arrayPath","arraySchemaPath","item","index","blockType","itemPath","itemSchemaPath","id","relationTo","result","error","payload","logger","err","msg","keysBeforeHook","keys","hookWroteForField","some","k","startsWith","orderedResult","fieldPatterns","field","regex","rowKeys","test"],"mappings":"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"}

package/dist/utilities/flattenedFields.d.ts

@@ -0,0 +1,21 @@
+import type { FlattenedField } from 'payload';
+/**
+ * Returns the `flattenedFields` of a group/tab/array field, or undefined for
+ * field types that don't carry nested fields. Concentrates the cast for the
+ * Payload core typing oversight (`FlattenedField` doesn't expose
+ * `flattenedFields` on every variant).
+ */
+export declare const getNestedFlattenedFields: (field: FlattenedField) => FlattenedField[] | undefined;
+/**
+ * Returns the `flattenedFields` of a `BlocksField` block (always an array).
+ */
+export declare const getBlockFlattenedFields: (block: {
+    flattenedFields?: FlattenedField[];
+}) => FlattenedField[];
+/**
+ * Traverses a flattened field schema and calls `registerHandler` for each
+ * named field. Handles blocks (keyed by block slug), groups, tabs, and arrays.
+ * Shared by `getExportFieldFunctions` and `getImportFieldFunctions`.
+ */
+export declare const registerFieldHooks: <TEntry>(fields: FlattenedField[], parentPath: string, result: Record<string, TEntry>, registerHandler: (field: FlattenedField, fullKey: string, result: Record<string, TEntry>) => void) => void;
+//# sourceMappingURL=flattenedFields.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flattenedFields.d.ts","sourceRoot":"","sources":["../../src/utilities/flattenedFields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,UAAW,cAAc,KAAG,cAAc,EAAE,GAAG,SACjB,CAAA;AAEnE;;GAEG;AACH,eAAO,MAAM,uBAAuB,UAAW;IAC7C,eAAe,CAAC,EAAE,cAAc,EAAE,CAAA;CACnC,KAAG,cAAc,EAAiC,CAAA;AAEnD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,UAC/B,cAAc,EAAE,cACZ,MAAM,UACV,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,mBACb,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,KAChG,IA6BF,CAAA"}

package/dist/utilities/flattenedFields.js

@@ -0,0 +1,37 @@
+/**
+ * Returns the `flattenedFields` of a group/tab/array field, or undefined for
+ * field types that don't carry nested fields. Concentrates the cast for the
+ * Payload core typing oversight (`FlattenedField` doesn't expose
+ * `flattenedFields` on every variant).
+ */ export const getNestedFlattenedFields = (field)=>field.flattenedFields;
+/**
+ * Returns the `flattenedFields` of a `BlocksField` block (always an array).
+ */ export const getBlockFlattenedFields = (block)=>block.flattenedFields ?? [];
+/**
+ * Traverses a flattened field schema and calls `registerHandler` for each
+ * named field. Handles blocks (keyed by block slug), groups, tabs, and arrays.
+ * Shared by `getExportFieldFunctions` and `getImportFieldFunctions`.
+ */ export const registerFieldHooks = (fields, parentPath, result, registerHandler)=>{
+    for (const field of fields){
+        if (!('name' in field) || !field.name) {
+            continue;
+        }
+        if (field.type === 'blocks') {
+            const base = parentPath ? `${parentPath}_${field.name}` : field.name;
+            for (const block of field.blocks ?? []){
+                if (typeof block === 'string') {
+                    continue;
+                }
+                registerFieldHooks(getBlockFlattenedFields(block), `${base}_${block.slug}`, result, registerHandler);
+            }
+            continue;
+        }
+        const fullKey = parentPath ? `${parentPath}_${field.name}` : field.name;
+        registerHandler(field, fullKey, result);
+        if (field.type === 'group' || field.type === 'tab' || field.type === 'array') {
+            registerFieldHooks(getNestedFlattenedFields(field) ?? [], fullKey, result, registerHandler);
+        }
+    }
+};
+
+//# sourceMappingURL=flattenedFields.js.map

package/dist/utilities/flattenedFields.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/flattenedFields.ts"],"sourcesContent":["import type { FlattenedField } from 'payload'\n\n/**\n * Returns the `flattenedFields` of a group/tab/array field, or undefined for\n * field types that don't carry nested fields. Concentrates the cast for the\n * Payload core typing oversight (`FlattenedField` doesn't expose\n * `flattenedFields` on every variant).\n */\nexport const getNestedFlattenedFields = (field: FlattenedField): FlattenedField[] | undefined =>\n  (field as { flattenedFields?: FlattenedField[] }).flattenedFields\n\n/**\n * Returns the `flattenedFields` of a `BlocksField` block (always an array).\n */\nexport const getBlockFlattenedFields = (block: {\n  flattenedFields?: FlattenedField[]\n}): FlattenedField[] => block.flattenedFields ?? []\n\n/**\n * Traverses a flattened field schema and calls `registerHandler` for each\n * named field. Handles blocks (keyed by block slug), groups, tabs, and arrays.\n * Shared by `getExportFieldFunctions` and `getImportFieldFunctions`.\n */\nexport const registerFieldHooks = <TEntry>(\n  fields: FlattenedField[],\n  parentPath: string,\n  result: Record<string, TEntry>,\n  registerHandler: (field: FlattenedField, fullKey: string, result: Record<string, TEntry>) => void,\n): void => {\n  for (const field of fields) {\n    if (!('name' in field) || !field.name) {\n      continue\n    }\n\n    if (field.type === 'blocks') {\n      const base = parentPath ? `${parentPath}_${field.name}` : field.name\n      for (const block of field.blocks ?? []) {\n        if (typeof block === 'string') {\n          continue\n        }\n        registerFieldHooks(\n          getBlockFlattenedFields(block),\n          `${base}_${block.slug}`,\n          result,\n          registerHandler,\n        )\n      }\n      continue\n    }\n\n    const fullKey = parentPath ? `${parentPath}_${field.name}` : field.name\n    registerHandler(field, fullKey, result)\n\n    if (field.type === 'group' || field.type === 'tab' || field.type === 'array') {\n      registerFieldHooks(getNestedFlattenedFields(field) ?? [], fullKey, result, registerHandler)\n    }\n  }\n}\n"],"names":["getNestedFlattenedFields","field","flattenedFields","getBlockFlattenedFields","block","registerFieldHooks","fields","parentPath","result","registerHandler","name","type","base","blocks","slug","fullKey"],"mappings":"AAEA;;;;;CAKC,GACD,OAAO,MAAMA,2BAA2B,CAACC,QACvC,AAACA,MAAiDC,eAAe,CAAA;AAEnE;;CAEC,GACD,OAAO,MAAMC,0BAA0B,CAACC,QAEhBA,MAAMF,eAAe,IAAI,EAAE,CAAA;AAEnD;;;;CAIC,GACD,OAAO,MAAMG,qBAAqB,CAChCC,QACAC,YACAC,QACAC;IAEA,KAAK,MAAMR,SAASK,OAAQ;QAC1B,IAAI,CAAE,CAAA,UAAUL,KAAI,KAAM,CAACA,MAAMS,IAAI,EAAE;YACrC;QACF;QAEA,IAAIT,MAAMU,IAAI,KAAK,UAAU;YAC3B,MAAMC,OAAOL,aAAa,GAAGA,WAAW,CAAC,EAAEN,MAAMS,IAAI,EAAE,GAAGT,MAAMS,IAAI;YACpE,KAAK,MAAMN,SAASH,MAAMY,MAAM,IAAI,EAAE,CAAE;gBACtC,IAAI,OAAOT,UAAU,UAAU;oBAC7B;gBACF;gBACAC,mBACEF,wBAAwBC,QACxB,GAAGQ,KAAK,CAAC,EAAER,MAAMU,IAAI,EAAE,EACvBN,QACAC;YAEJ;YACA;QACF;QAEA,MAAMM,UAAUR,aAAa,GAAGA,WAAW,CAAC,EAAEN,MAAMS,IAAI,EAAE,GAAGT,MAAMS,IAAI;QACvED,gBAAgBR,OAAOc,SAASP;QAEhC,IAAIP,MAAMU,IAAI,KAAK,WAAWV,MAAMU,IAAI,KAAK,SAASV,MAAMU,IAAI,KAAK,SAAS;YAC5EN,mBAAmBL,yBAAyBC,UAAU,EAAE,EAAEc,SAASP,QAAQC;QAC7E;IACF;AACF,EAAC"}

package/dist/utilities/getExportFieldFunctions.d.ts

@@ -1,12 +1,12 @@
-import { type FlattenedField } from 'payload';
-import type { ToCSVFunction } from '../types.js';
+import type { FlattenedField } from 'payload';
+import type { ExportFieldHookEntry } from '../types.js';
 type Args = {
     fields: FlattenedField[];
 };
 /**
- * Gets custom toCSV field functions for export.
- * These functions transform field values when flattening documents for CSV export.
+ * Builds a map from logical field path (e.g. `content_textBlock_body`) to
+ * the export hook entry. Paths include block slugs but never array indices.
  */
-export declare const getExportFieldFunctions: ({ fields }: Args) => Record<string, ToCSVFunction>;
+export declare const getExportFieldFunctions: ({ fields }: Args) => Record<string, ExportFieldHookEntry>;
 export {};
 //# sourceMappingURL=getExportFieldFunctions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getExportFieldFunctions.d.ts","sourceRoot":"","sources":["../../src/utilities/getExportFieldFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAA+C,MAAM,SAAS,CAAA;AAE1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,KAAK,IAAI,GAAG;IACV,MAAM,EAAE,cAAc,EAAE,CAAA;CACzB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,eAAgB,IAAI,KAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAqHtF,CAAA"}
+{"version":3,"file":"getExportFieldFunctions.d.ts","sourceRoot":"","sources":["../../src/utilities/getExportFieldFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C,OAAO,KAAK,EAAE,oBAAoB,EAAyB,MAAM,aAAa,CAAA;AAK9E,KAAK,IAAI,GAAG;IACV,MAAM,EAAE,cAAc,EAAE,CAAA;CACzB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,eAAgB,IAAI,KAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAI7F,CAAA"}

package/dist/utilities/getExportFieldFunctions.js

@@ -1,109 +1,132 @@
-import { traverseFields } from 'payload';
+import { registerFieldHooks } from './flattenedFields.js';
+import { getPolymorphicRelId, isPolymorphicRelValue } from './polymorphicRel.js';
 /**
- * Gets custom toCSV field functions for export.
- * These functions transform field values when flattening documents for CSV export.
+ * Builds a map from logical field path (e.g. `content_textBlock_body`) to
+ * the export hook entry. Paths include block slugs but never array indices.
  */ export const getExportFieldFunctions = ({ fields })=>{
     const result = {};
-    const buildCustomFunctions = ({ field, parentRef, ref })=>{
-        // @ts-expect-error ref is untyped
-        ref.prefix = parentRef.prefix || '';
-        if (field.type === 'group' || field.type === 'tab') {
-            // @ts-expect-error ref is untyped
-            const parentPrefix = parentRef?.prefix ? `${parentRef.prefix}_` : '';
-            // @ts-expect-error ref is untyped
-            ref.prefix = `${parentPrefix}${field.name}_`;
-        }
-        if (typeof field.custom?.['plugin-import-export']?.toCSV === 'function') {
-            // @ts-expect-error ref is untyped
-            result[`${ref.prefix}${field.name}`] = field.custom['plugin-import-export']?.toCSV;
-        } else if (field.type === 'json' || field.type === 'richText') {
-            // Serialize JSON and richText fields as JSON strings in a single column
-            // This prevents them from being flattened into multiple columns
-            // @ts-expect-error ref is untyped
-            result[`${ref.prefix}${field.name}`] = ({ value })=>{
-                if (value === null || value === undefined) {
-                    return value;
-                }
-                if (typeof value === 'object') {
-                    return JSON.stringify(value);
-                }
+    registerFieldHooks(fields, '', result, registerExportHandler);
+    return result;
+};
+const registerExportHandler = (field, fullKey, result)=>{
+    const beforeExport = field.custom?.['plugin-import-export']?.hooks?.beforeExport;
+    if (typeof beforeExport === 'function') {
+        result[fullKey] = {
+            type: 'beforeExport',
+            fn: beforeExport
+        };
+        return;
+    }
+    const registerHandler = (handler)=>{
+        result[fullKey] = {
+            type: 'beforeExport',
+            fn: handler
+        };
+    };
+    if (field.type === 'json' || field.type === 'richText') {
+        registerHandler(({ format, value })=>{
+            if (format === 'json') {
                 return value;
-            };
-        } else if (field.type === 'date') {
-            // Handle date fields - return value as-is (ISO string format)
-            // This prevents the flattener from treating the document as having
-            // nested sibling properties like _tz that shouldn't be auto-included
-            // @ts-expect-error ref is untyped
-            const fieldKey = `${ref.prefix}${field.name}`;
-            result[fieldKey] = ({ value })=>value;
-        } else if (field.type === 'relationship' || field.type === 'upload') {
-            if (field.hasMany !== true) {
-                if (!Array.isArray(field.relationTo)) {
-                    // monomorphic single
-                    // @ts-expect-error ref is untyped
-                    result[`${ref.prefix}${field.name}`] = ({ value })=>typeof value === 'object' && value && 'id' in value ? value.id : value;
-                } else {
-                    // polymorphic single
-                    // @ts-expect-error ref is untyped
-                    result[`${ref.prefix}${field.name}`] = ({ data, value })=>{
-                        if (value && typeof value === 'object' && 'relationTo' in value && 'value' in value) {
-                            const relationTo = value.relationTo;
-                            const relatedDoc = value.value;
-                            if (relatedDoc && typeof relatedDoc === 'object') {
-                                // @ts-expect-error ref is untyped
-                                data[`${ref.prefix}${field.name}_id`] = relatedDoc.id;
-                                // @ts-expect-error ref is untyped
-                                data[`${ref.prefix}${field.name}_relationTo`] = relationTo;
-                            }
-                        }
-                        return undefined // prevents further flattening
-                        ;
-                    };
-                }
-            } else {
-                if (!Array.isArray(field.relationTo)) {
-                    // monomorphic many
-                    // @ts-expect-error ref is untyped
-                    result[`${ref.prefix}${field.name}`] = ({ data, value })=>{
-                        if (Array.isArray(value)) {
-                            value.forEach((val, i)=>{
-                                const id = typeof val === 'object' && val ? val.id : val;
-                                // @ts-expect-error ref is untyped
-                                data[`${ref.prefix}${field.name}_${i}_id`] = id;
-                            });
-                        }
-                        return undefined // prevents further flattening
-                        ;
-                    };
-                } else {
-                    // polymorphic many
-                    // @ts-expect-error ref is untyped
-                    result[`${ref.prefix}${field.name}`] = ({ data, value })=>{
-                        if (Array.isArray(value)) {
-                            value.forEach((val, i)=>{
-                                if (val && typeof val === 'object') {
-                                    const relationTo = val.relationTo;
-                                    const relatedDoc = val.value;
-                                    if (relationTo && relatedDoc && typeof relatedDoc === 'object') {
-                                        // @ts-expect-error ref is untyped
-                                        data[`${ref.prefix}${field.name}_${i}_id`] = relatedDoc.id;
-                                        // @ts-expect-error ref is untyped
-                                        data[`${ref.prefix}${field.name}_${i}_relationTo`] = relationTo;
-                                    }
-                                }
-                            });
-                        }
-                        return undefined;
-                    };
-                }
             }
+            if (value === null || value === undefined) {
+                return value;
+            }
+            if (typeof value === 'object') {
+                return JSON.stringify(value);
+            }
+            return value;
+        });
+        return;
+    }
+    if (field.type === 'date') {
+        registerHandler(({ value })=>value);
+        return;
+    }
+    if (field.type !== 'relationship' && field.type !== 'upload') {
+        return;
+    }
+    if (field.hasMany !== true) {
+        if (!Array.isArray(field.relationTo)) {
+            registerHandler(({ value })=>typeof value === 'object' && value && 'id' in value ? value.id : value);
+            return;
         }
-    };
-    traverseFields({
-        callback: buildCustomFunctions,
-        fields
+        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(({ format, siblingData, value })=>{
+            if (!Array.isArray(value)) {
+                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(({ 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
+                }
+            ];
+        });
+        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
+                }));
+        }
+        rels.forEach(({ id, index, relationTo })=>{
+            siblingData[`${fullKey}_${index}_id`] = id;
+            siblingData[`${fullKey}_${index}_relationTo`] = relationTo;
+        });
+        return null;
     });
-    return result;
 };
 
 //# sourceMappingURL=getExportFieldFunctions.js.map