@payloadcms/plugin-import-export 3.84.1 → 3.85.0

package/dist/utilities/flattenObject.js

@@ -1,119 +1,139 @@
 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)=>{
+        if (entry.type === 'beforeExport') {
+            return entry.fn({
+                columnName,
+                data,
+                format,
+                siblingData: row,
+                siblingDoc: siblingSource,
+                value
+            });
+        }
+        return entry.fn({
+            columnName,
+            data: row,
+            doc: data,
+            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    if (entry.type === 'beforeExport') {\n      return entry.fn({\n        columnName,\n        data,\n        format,\n        siblingData: row,\n        siblingDoc: siblingSource,\n        value,\n      })\n    }\n    return entry.fn({\n      columnName,\n      data: row,\n      doc: data,\n      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","type","fn","siblingData","siblingDoc","doc","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/flattenObject.spec.js

@@ -0,0 +1,158 @@
+import { describe, expect, it, vi } from 'vitest';
+import { flattenObject } from './flattenObject.js';
+const mockReq = {
+    payload: {
+        logger: {
+            error: vi.fn()
+        }
+    }
+};
+describe('flattenObject parent + child traversal', ()=>{
+    it('should run a parent group hook and still apply child field hooks against the transformed value', ()=>{
+        const exportFieldHooks = {
+            meta: {
+                type: 'beforeExport',
+                fn: ({ value })=>{
+                    const obj = value ?? {};
+                    return {
+                        ...obj,
+                        slug: `${obj.slug ?? ''}-from-parent`
+                    };
+                }
+            },
+            meta_slug: {
+                type: 'beforeExport',
+                fn: ({ value })=>`${value}-from-child`
+            }
+        };
+        const row = flattenObject({
+            data: {
+                meta: {
+                    slug: 'raw'
+                }
+            },
+            exportFieldHooks,
+            format: 'csv',
+            req: mockReq
+        });
+        expect(row.meta_slug).toBe('raw-from-parent-from-child');
+    });
+    it('should still recurse into children when the parent group hook returns undefined', ()=>{
+        const childCalls = [];
+        const exportFieldHooks = {
+            meta: {
+                type: 'beforeExport',
+                fn: ()=>undefined
+            },
+            meta_slug: {
+                type: 'beforeExport',
+                fn: ({ value })=>{
+                    childCalls.push(value);
+                    return `${value}-from-child`;
+                }
+            }
+        };
+        const row = flattenObject({
+            data: {
+                meta: {
+                    slug: 'raw'
+                }
+            },
+            exportFieldHooks,
+            format: 'csv',
+            req: mockReq
+        });
+        expect(childCalls).toEqual([
+            'raw'
+        ]);
+        expect(row.meta_slug).toBe('raw-from-child');
+    });
+    it('should not recurse into children when the parent hook returns a primitive', ()=>{
+        const childFn = vi.fn(({ value })=>`${value}-from-child`);
+        const exportFieldHooks = {
+            meta: {
+                type: 'beforeExport',
+                fn: ()=>'serialized'
+            },
+            meta_slug: {
+                type: 'beforeExport',
+                fn: childFn
+            }
+        };
+        const row = flattenObject({
+            data: {
+                meta: {
+                    slug: 'raw'
+                }
+            },
+            exportFieldHooks,
+            format: 'csv',
+            req: mockReq
+        });
+        expect(row.meta).toBe('serialized');
+        expect(row.meta_slug).toBeUndefined();
+        expect(childFn).not.toHaveBeenCalled();
+    });
+    it('should fall back to default array flattening when an undefined-returning hook did not write any keys, even if a sibling key with a matching prefix exists', ()=>{
+        const exportFieldHooks = {
+            tag: {
+                type: 'beforeExport',
+                fn: ()=>undefined
+            }
+        };
+        const row = flattenObject({
+            data: {
+                tag_meta: 'sibling-set-first',
+                tag: [
+                    'a',
+                    'b'
+                ]
+            },
+            exportFieldHooks,
+            format: 'csv',
+            req: mockReq
+        });
+        expect(row.tag_meta).toBe('sibling-set-first');
+        expect(row.tag_0).toBe('a');
+        expect(row.tag_1).toBe('b');
+    });
+    it('should run a parent array hook then child hooks for each item', ()=>{
+        const exportFieldHooks = {
+            items: {
+                type: 'beforeExport',
+                fn: ({ value })=>{
+                    if (!Array.isArray(value)) {
+                        return value;
+                    }
+                    return value.map((item)=>({
+                            ...item,
+                            note: `${item.note ?? ''}-parent`
+                        }));
+                }
+            },
+            items_note: {
+                type: 'beforeExport',
+                fn: ({ value })=>`${value}-child`
+            }
+        };
+        const row = flattenObject({
+            data: {
+                items: [
+                    {
+                        note: 'a'
+                    },
+                    {
+                        note: 'b'
+                    }
+                ]
+            },
+            exportFieldHooks,
+            format: 'csv',
+            req: mockReq
+        });
+        expect(row.items_0_note).toBe('a-parent-child');
+        expect(row.items_1_note).toBe('b-parent-child');
+    });
+});
+
+//# sourceMappingURL=flattenObject.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/flattenObject.spec.ts"],"sourcesContent":["import { PayloadRequest } from 'payload'\n\nimport type { ExportFieldHookEntry } from '../types.js'\n\nimport { describe, expect, it, vi } from 'vitest'\n\nimport { flattenObject } from './flattenObject.js'\n\nconst mockReq = {\n  payload: {\n    logger: {\n      error: vi.fn(),\n    },\n  },\n} as unknown as PayloadRequest\n\ndescribe('flattenObject parent + child traversal', () => {\n  it('should run a parent group hook and still apply child field hooks against the transformed value', () => {\n    const exportFieldHooks: Record<string, ExportFieldHookEntry> = {\n      meta: {\n        type: 'beforeExport',\n        fn: ({ value }) => {\n          const obj = (value ?? {}) as Record<string, unknown>\n          return { ...obj, slug: `${obj.slug ?? ''}-from-parent` }\n        },\n      },\n      meta_slug: {\n        type: 'beforeExport',\n        fn: ({ value }) => `${value}-from-child`,\n      },\n    }\n\n    const row = flattenObject({\n      data: { meta: { slug: 'raw' } },\n      exportFieldHooks,\n      format: 'csv',\n      req: mockReq,\n    })\n\n    expect(row.meta_slug).toBe('raw-from-parent-from-child')\n  })\n\n  it('should still recurse into children when the parent group hook returns undefined', () => {\n    const childCalls: unknown[] = []\n    const exportFieldHooks: Record<string, ExportFieldHookEntry> = {\n      meta: {\n        type: 'beforeExport',\n        fn: () => undefined,\n      },\n      meta_slug: {\n        type: 'beforeExport',\n        fn: ({ value }) => {\n          childCalls.push(value)\n          return `${value}-from-child`\n        },\n      },\n    }\n\n    const row = flattenObject({\n      data: { meta: { slug: 'raw' } },\n      exportFieldHooks,\n      format: 'csv',\n      req: mockReq,\n    })\n\n    expect(childCalls).toEqual(['raw'])\n    expect(row.meta_slug).toBe('raw-from-child')\n  })\n\n  it('should not recurse into children when the parent hook returns a primitive', () => {\n    const childFn = vi.fn(({ value }: { value: unknown }) => `${value}-from-child`)\n    const exportFieldHooks: Record<string, ExportFieldHookEntry> = {\n      meta: {\n        type: 'beforeExport',\n        fn: () => 'serialized',\n      },\n      meta_slug: {\n        type: 'beforeExport',\n        fn: childFn,\n      },\n    }\n\n    const row = flattenObject({\n      data: { meta: { slug: 'raw' } },\n      exportFieldHooks,\n      format: 'csv',\n      req: mockReq,\n    })\n\n    expect(row.meta).toBe('serialized')\n    expect(row.meta_slug).toBeUndefined()\n    expect(childFn).not.toHaveBeenCalled()\n  })\n\n  it('should fall back to default array flattening when an undefined-returning hook did not write any keys, even if a sibling key with a matching prefix exists', () => {\n    const exportFieldHooks: Record<string, ExportFieldHookEntry> = {\n      tag: {\n        type: 'beforeExport',\n        fn: () => undefined,\n      },\n    }\n\n    const row = flattenObject({\n      data: { tag_meta: 'sibling-set-first', tag: ['a', 'b'] },\n      exportFieldHooks,\n      format: 'csv',\n      req: mockReq,\n    })\n\n    expect(row.tag_meta).toBe('sibling-set-first')\n    expect(row.tag_0).toBe('a')\n    expect(row.tag_1).toBe('b')\n  })\n\n  it('should run a parent array hook then child hooks for each item', () => {\n    const exportFieldHooks: Record<string, ExportFieldHookEntry> = {\n      items: {\n        type: 'beforeExport',\n        fn: ({ value }) => {\n          if (!Array.isArray(value)) {\n            return value\n          }\n          return value.map((item) => ({\n            ...(item as Record<string, unknown>),\n            note: `${(item as Record<string, unknown>).note ?? ''}-parent`,\n          }))\n        },\n      },\n      items_note: {\n        type: 'beforeExport',\n        fn: ({ value }) => `${value}-child`,\n      },\n    }\n\n    const row = flattenObject({\n      data: { items: [{ note: 'a' }, { note: 'b' }] },\n      exportFieldHooks,\n      format: 'csv',\n      req: mockReq,\n    })\n\n    expect(row.items_0_note).toBe('a-parent-child')\n    expect(row.items_1_note).toBe('b-parent-child')\n  })\n})\n"],"names":["describe","expect","it","vi","flattenObject","mockReq","payload","logger","error","fn","exportFieldHooks","meta","type","value","obj","slug","meta_slug","row","data","format","req","toBe","childCalls","undefined","push","toEqual","childFn","toBeUndefined","not","toHaveBeenCalled","tag","tag_meta","tag_0","tag_1","items","Array","isArray","map","item","note","items_note","items_0_note","items_1_note"],"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,IA0BF,CAAA"}

package/dist/utilities/flattenedFields.js

@@ -0,0 +1,34 @@
+/**
+ * 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 ?? []){
+                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        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;gBACtCR,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"}