@payloadcms/plugin-import-export 3.71.0-internal.ef75fa0 → 3.71.0

package/dist/utilities/flattenObject.js

@@ -0,0 +1,129 @@
+export const flattenObject = ({ doc, fields, prefix, toCSVFunctions })=>{
+    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 flatten = (siblingDoc, prefix)=>{
+        Object.entries(siblingDoc).forEach(([key, value])=>{
+            const newKey = prefix ? `${prefix}_${key}` : key;
+            const toCSVFn = getToCSVFunction(newKey, key);
+            if (Array.isArray(value)) {
+                // If a custom toCSV function exists for this array field, run it first.
+                // If it produces output, skip per-item handling; otherwise, fall back.
+                if (toCSVFn) {
+                    try {
+                        const result = toCSVFn({
+                            columnName: newKey,
+                            data: row,
+                            doc,
+                            row,
+                            siblingDoc,
+                            value
+                        });
+                        if (typeof result !== 'undefined') {
+                            // Custom function returned a single value for this array field.
+                            row[newKey] = result;
+                            return;
+                        }
+                        // If the custom function wrote any keys for this field, consider it handled.
+                        for(const k in row){
+                            if (k === newKey || k.startsWith(`${newKey}_`)) {
+                                return;
+                            }
+                        }
+                    // Otherwise, fall through to per-item handling.
+                    } 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}`;
+                        // Case: hasMany polymorphic relationships
+                        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;
+                            return;
+                        }
+                        // Fallback: deep-flatten nested objects
+                        flatten(item, itemPrefix);
+                    } else {
+                        // Primitive array item.
+                        row[`${newKey}_${index}`] = item;
+                    }
+                });
+            } else if (typeof value === 'object' && value !== null) {
+                // Object field: use custom toCSV if present, else recurse.
+                if (!toCSVFn) {
+                    flatten(value, newKey);
+                } else {
+                    try {
+                        const result = toCSVFn({
+                            columnName: newKey,
+                            data: row,
+                            doc,
+                            row,
+                            siblingDoc,
+                            value
+                        });
+                        if (typeof result !== 'undefined') {
+                            row[newKey] = result;
+                        }
+                    } catch (error) {
+                        throw new Error(`Error in toCSVFunction for nested object "${newKey}": ${JSON.stringify(value)}\n${error.message}`);
+                    }
+                }
+            } else {
+                if (toCSVFn) {
+                    try {
+                        const result = toCSVFn({
+                            columnName: newKey,
+                            data: row,
+                            doc,
+                            row,
+                            siblingDoc,
+                            value
+                        });
+                        if (typeof result !== 'undefined') {
+                            row[newKey] = result;
+                        }
+                    } catch (error) {
+                        throw new Error(`Error in toCSVFunction for field "${newKey}": ${JSON.stringify(value)}\n${error.message}`);
+                    }
+                } else {
+                    row[newKey] = value;
+                }
+            }
+        });
+    };
+    flatten(doc, prefix);
+    if (Array.isArray(fields) && fields.length > 0) {
+        const orderedResult = {};
+        const fieldToRegex = (field)=>{
+            const parts = field.split('.').map((part)=>`${part}(?:_\\d+)?`);
+            const pattern = `^${parts.join('_')}`;
+            return new RegExp(pattern);
+        };
+        fields.forEach((field)=>{
+            if (row[field.replace(/\./g, '_')]) {
+                const sanitizedField = field.replace(/\./g, '_');
+                orderedResult[sanitizedField] = row[sanitizedField];
+            } else {
+                const regex = fieldToRegex(field);
+                Object.keys(row).forEach((key)=>{
+                    if (regex.test(key)) {
+                        orderedResult[key] = row[key];
+                    }
+                });
+            }
+        });
+        return orderedResult;
+    }
+    return row;
+};
+
+//# sourceMappingURL=flattenObject.js.map

package/dist/utilities/flattenObject.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/flattenObject.ts"],"sourcesContent":["import type { Document } from 'payload'\n\nimport type { ToCSVFunction } from '../types.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  const flatten = (siblingDoc: Document, prefix?: string) => {\n    Object.entries(siblingDoc).forEach(([key, value]) => {\n      const newKey = prefix ? `${prefix}_${key}` : key\n      const toCSVFn = getToCSVFunction(newKey, key)\n\n      if (Array.isArray(value)) {\n        // If a custom toCSV function exists for this array field, run it first.\n        // If it produces output, skip per-item handling; otherwise, fall back.\n        if (toCSVFn) {\n          try {\n            const result = toCSVFn({\n              columnName: newKey,\n              data: row,\n              doc,\n              row,\n              siblingDoc,\n              value, // whole array\n            })\n\n            if (typeof result !== 'undefined') {\n              // Custom function returned a single value for this array field.\n              row[newKey] = result\n              return\n            }\n\n            // If the custom function wrote any keys for this field, consider it handled.\n            for (const k in row) {\n              if (k === newKey || k.startsWith(`${newKey}_`)) {\n                return\n              }\n            }\n            // Otherwise, fall through to per-item handling.\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            // Case: hasMany polymorphic relationships\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            // Fallback: deep-flatten nested objects\n            flatten(item, itemPrefix)\n          } else {\n            // Primitive array item.\n            row[`${newKey}_${index}`] = item\n          }\n        })\n      } else if (typeof value === 'object' && value !== null) {\n        // Object field: use custom toCSV if present, else recurse.\n        if (!toCSVFn) {\n          flatten(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  flatten(doc, prefix)\n\n  if (Array.isArray(fields) && fields.length > 0) {\n    const orderedResult: Record<string, unknown> = {}\n\n    const fieldToRegex = (field: string): RegExp => {\n      const parts = field.split('.').map((part) => `${part}(?:_\\\\d+)?`)\n      const pattern = `^${parts.join('_')}`\n      return new RegExp(pattern)\n    }\n\n    fields.forEach((field) => {\n      if (row[field.replace(/\\./g, '_')]) {\n        const sanitizedField = field.replace(/\\./g, '_')\n        orderedResult[sanitizedField] = row[sanitizedField]\n      } else {\n        const regex = fieldToRegex(field)\n        Object.keys(row).forEach((key) => {\n          if (regex.test(key)) {\n            orderedResult[key] = row[key]\n          }\n        })\n      }\n    })\n\n    return orderedResult\n  }\n\n  return row\n}\n"],"names":["flattenObject","doc","fields","prefix","toCSVFunctions","row","getToCSVFunction","fullPath","baseFieldName","flatten","siblingDoc","Object","entries","forEach","key","value","newKey","toCSVFn","Array","isArray","result","columnName","data","k","startsWith","error","Error","JSON","stringify","message","item","index","blockType","undefined","itemPrefix","relationTo","id","length","orderedResult","fieldToRegex","field","parts","split","map","part","pattern","join","RegExp","replace","sanitizedField","regex","keys","test"],"mappings":"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"}

package/dist/utilities/getExportFieldFunctions.d.ts

@@ -0,0 +1,12 @@
+import { type FlattenedField } from 'payload';
+import type { ToCSVFunction } 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.
+ */
+export declare const getExportFieldFunctions: ({ fields }: Args) => Record<string, ToCSVFunction>;
+export {};
+//# sourceMappingURL=getExportFieldFunctions.d.ts.map

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

@@ -0,0 +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,CA6GtF,CAAA"}

package/dist/utilities/getExportFieldFunctions.js

@@ -0,0 +1,102 @@
+import { traverseFields } from 'payload';
+/**
+ * Gets custom toCSV field functions for export.
+ * These functions transform field values when flattening documents for CSV export.
+ */ 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);
+                }
+                return 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;
+                    };
+                }
+            }
+        }
+    };
+    traverseFields({
+        callback: buildCustomFunctions,
+        fields
+    });
+    return result;
+};
+
+//# sourceMappingURL=getExportFieldFunctions.js.map

package/dist/utilities/getExportFieldFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/getExportFieldFunctions.ts"],"sourcesContent":["import { type FlattenedField, traverseFields, type TraverseFieldsCallback } from 'payload'\n\nimport type { ToCSVFunction } from '../types.js'\n\ntype Args = {\n  fields: FlattenedField[]\n}\n\n/**\n * Gets custom toCSV field functions for export.\n * These functions transform field values when flattening documents for CSV export.\n */\nexport const getExportFieldFunctions = ({ fields }: Args): Record<string, ToCSVFunction> => {\n  const result: Record<string, ToCSVFunction> = {}\n\n  const buildCustomFunctions: TraverseFieldsCallback = ({ field, parentRef, ref }) => {\n    // @ts-expect-error ref is untyped\n    ref.prefix = parentRef.prefix || ''\n    if (field.type === 'group' || field.type === 'tab') {\n      // @ts-expect-error ref is untyped\n      const parentPrefix = parentRef?.prefix ? `${parentRef.prefix}_` : ''\n      // @ts-expect-error ref is untyped\n      ref.prefix = `${parentPrefix}${field.name}_`\n    }\n\n    if (typeof field.custom?.['plugin-import-export']?.toCSV === 'function') {\n      // @ts-expect-error ref is untyped\n      result[`${ref.prefix}${field.name}`] = field.custom['plugin-import-export']?.toCSV\n    } else if (field.type === 'json' || field.type === 'richText') {\n      // Serialize JSON and richText fields as JSON strings in a single column\n      // This prevents them from being flattened into multiple columns\n      // @ts-expect-error ref is untyped\n      result[`${ref.prefix}${field.name}`] = ({ value }) => {\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    } else if (field.type === 'relationship' || field.type === 'upload') {\n      if (field.hasMany !== true) {\n        if (!Array.isArray(field.relationTo)) {\n          // monomorphic single\n          // @ts-expect-error ref is untyped\n          result[`${ref.prefix}${field.name}`] = ({ value }) =>\n            typeof value === 'object' && value && 'id' in value ? value.id : value\n        } else {\n          // polymorphic single\n          // @ts-expect-error ref is untyped\n          result[`${ref.prefix}${field.name}`] = ({ data, value }) => {\n            if (value && typeof value === 'object' && 'relationTo' in value && 'value' in value) {\n              const relationTo = (value as { relationTo: string; value: { id: number | string } })\n                .relationTo\n              const relatedDoc = (value as { relationTo: string; value: { id: number | string } })\n                .value\n              if (relatedDoc && typeof relatedDoc === 'object') {\n                // @ts-expect-error ref is untyped\n                data[`${ref.prefix}${field.name}_id`] = relatedDoc.id\n                // @ts-expect-error ref is untyped\n                data[`${ref.prefix}${field.name}_relationTo`] = relationTo\n              }\n            }\n            return undefined // prevents further flattening\n          }\n        }\n      } else {\n        if (!Array.isArray(field.relationTo)) {\n          // monomorphic many\n          // @ts-expect-error ref is untyped\n          result[`${ref.prefix}${field.name}`] = ({\n            data,\n            value,\n          }: {\n            data: Record<string, unknown>\n            value: Array<number | Record<string, any> | string> | undefined\n          }) => {\n            if (Array.isArray(value)) {\n              value.forEach((val, i) => {\n                const id = typeof val === 'object' && val ? val.id : val\n                // @ts-expect-error ref is untyped\n                data[`${ref.prefix}${field.name}_${i}_id`] = id\n              })\n            }\n            return undefined // prevents further flattening\n          }\n        } else {\n          // polymorphic many\n          // @ts-expect-error ref is untyped\n          result[`${ref.prefix}${field.name}`] = ({\n            data,\n            value,\n          }: {\n            data: Record<string, unknown>\n            value: Array<Record<string, any>> | undefined\n          }) => {\n            if (Array.isArray(value)) {\n              value.forEach((val, i) => {\n                if (val && typeof val === 'object') {\n                  const relationTo = val.relationTo\n                  const relatedDoc = val.value\n                  if (relationTo && relatedDoc && typeof relatedDoc === 'object') {\n                    // @ts-expect-error ref is untyped\n                    data[`${ref.prefix}${field.name}_${i}_id`] = relatedDoc.id\n                    // @ts-expect-error ref is untyped\n                    data[`${ref.prefix}${field.name}_${i}_relationTo`] = relationTo\n                  }\n                }\n              })\n            }\n            return undefined\n          }\n        }\n      }\n    }\n  }\n\n  traverseFields({ callback: buildCustomFunctions, fields })\n\n  return result\n}\n"],"names":["traverseFields","getExportFieldFunctions","fields","result","buildCustomFunctions","field","parentRef","ref","prefix","type","parentPrefix","name","custom","toCSV","value","undefined","JSON","stringify","hasMany","Array","isArray","relationTo","id","data","relatedDoc","forEach","val","i","callback"],"mappings":"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"}

package/dist/utilities/getFilename.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generates a filename based on current date and time.
+ * Format: "YYYY-MM-DD HH:MM:SS"
+ */
+export declare const getFilename: () => string;
+//# sourceMappingURL=getFilename.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getFilename.d.ts","sourceRoot":"","sources":["../../src/utilities/getFilename.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,WAAW,cAMvB,CAAA"}

package/dist/utilities/getFilename.js

@@ -0,0 +1,13 @@
+/**
+ * Generates a filename based on current date and time.
+ * Format: "YYYY-MM-DD HH:MM:SS"
+ */ export const getFilename = ()=>{
+    const now = new Date();
+    const yyymmdd = now.toISOString().split('T')[0] // "YYYY-MM-DD"
+    ;
+    const hhmmss = now.toTimeString().split(' ')[0] // "HH:MM:SS"
+    ;
+    return `${yyymmdd} ${hhmmss}`;
+};
+
+//# sourceMappingURL=getFilename.js.map

package/dist/utilities/getFilename.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/getFilename.ts"],"sourcesContent":["/**\n * Generates a filename based on current date and time.\n * Format: \"YYYY-MM-DD HH:MM:SS\"\n */\nexport const getFilename = () => {\n  const now = new Date()\n  const yyymmdd = now.toISOString().split('T')[0] // \"YYYY-MM-DD\"\n  const hhmmss = now.toTimeString().split(' ')[0] // \"HH:MM:SS\"\n\n  return `${yyymmdd} ${hhmmss}`\n}\n"],"names":["getFilename","now","Date","yyymmdd","toISOString","split","hhmmss","toTimeString"],"mappings":"AAAA;;;CAGC,GACD,OAAO,MAAMA,cAAc;IACzB,MAAMC,MAAM,IAAIC;IAChB,MAAMC,UAAUF,IAAIG,WAAW,GAAGC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe;;IAC/D,MAAMC,SAASL,IAAIM,YAAY,GAAGF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa;;IAE7D,OAAO,GAAGF,QAAQ,CAAC,EAAEG,QAAQ;AAC/B,EAAC"}

package/dist/utilities/getFlattenedFieldKeys.d.ts

@@ -8,6 +8,17 @@ type FieldWithPresentational = {
     }[];
     type: 'collapsible' | 'row' | 'tabs';
 } | FlattenedField;
-export declare const getFlattenedFieldKeys: (fields: FieldWithPresentational[], prefix?: string) => string[];
+export type GetFlattenedFieldKeysOptions = {
+    /**
+     * When provided, localized fields will be expanded to include locale suffixes.
+     * e.g., 'title' (localized) -> ['title_en', 'title_es']
+     */
+    localeCodes?: string[];
+};
+/**
+ * Recursively traverses fields and generates flattened CSV column keys.
+ * This is schema-based - it derives columns from field definitions, not data.
+ */
+export declare const getFlattenedFieldKeys: (fields: FieldWithPresentational[], prefix?: string, options?: GetFlattenedFieldKeysOptions) => string[];
 export {};
 //# sourceMappingURL=getFlattenedFieldKeys.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getFlattenedFieldKeys.d.ts","sourceRoot":"","sources":["../../src/utilities/getFlattenedFieldKeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C,KAAK,uBAAuB,GACxB;IACE,MAAM,CAAC,EAAE,cAAc,EAAE,CAAA;IACzB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,cAAc,EAAE,CAAA;QACxB,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,EAAE,CAAA;IACH,IAAI,EAAE,aAAa,GAAG,KAAK,GAAG,MAAM,CAAA;CACrC,GACD,cAAc,CAAA;AAElB,eAAO,MAAM,qBAAqB,WAAY,uBAAuB,EAAE,sBAAgB,MAAM,EAyE5F,CAAA"}
+{"version":3,"file":"getFlattenedFieldKeys.d.ts","sourceRoot":"","sources":["../../src/utilities/getFlattenedFieldKeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C,KAAK,uBAAuB,GACxB;IACE,MAAM,CAAC,EAAE,cAAc,EAAE,CAAA;IACzB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,cAAc,EAAE,CAAA;QACxB,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,EAAE,CAAA;IACH,IAAI,EAAE,aAAa,GAAG,KAAK,GAAG,MAAM,CAAA;CACrC,GACD,cAAc,CAAA;AAElB,MAAM,MAAM,4BAA4B,GAAG;IACzC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,WACxB,uBAAuB,EAAE,6BAExB,4BAA4B,KACpC,MAAM,EAuGR,CAAA"}

package/dist/utilities/getFlattenedFieldKeys.js

@@ -1,39 +1,64 @@
-export const getFlattenedFieldKeys = (fields, prefix = '')=>{
+/**
+ * Recursively traverses fields and generates flattened CSV column keys.
+ * This is schema-based - it derives columns from field definitions, not data.
+ */ export const getFlattenedFieldKeys = (fields, prefix = '', options = {})=>{
+    const { localeCodes } = options;
     const keys = [];
     fields.forEach((field)=>{
-        const fieldHasToCSVFunction = 'custom' in field && typeof field.custom === 'object' && 'plugin-import-export' in field.custom && field.custom['plugin-import-export']?.toCSV;
+        // Skip disabled fields
+        const isDisabled = 'custom' in field && typeof field.custom === 'object' && field.custom?.['plugin-import-export']?.disabled === true;
+        if (isDisabled) {
+            return;
+        }
         const name = 'name' in field && typeof field.name === 'string' ? field.name : undefined;
         const fullKey = name && prefix ? `${prefix}_${name}` : name ?? prefix;
+        // Check if field is localized
+        const isLocalized = 'localized' in field && field.localized === true;
+        // Helper to add keys with locale expansion if needed
+        const addKey = (key, fieldIsLocalized)=>{
+            if (fieldIsLocalized && localeCodes && localeCodes.length > 0) {
+                // Expand to locale-specific keys
+                for (const locale of localeCodes){
+                    keys.push(`${key}_${locale}`);
+                }
+            } else {
+                keys.push(key);
+            }
+        };
         switch(field.type){
             case 'array':
                 {
-                    const subKeys = getFlattenedFieldKeys(field.fields, `${fullKey}_0`);
+                    const subKeys = getFlattenedFieldKeys(field.fields, `${fullKey}_0`, options);
                     keys.push(...subKeys);
                     break;
                 }
             case 'blocks':
                 {
                     field.blocks.forEach((block)=>{
+                        if (typeof block === 'string') {
+                            return; // Skip block references
+                        }
                         const blockPrefix = `${fullKey}_0_${block.slug}`;
                         keys.push(`${blockPrefix}_blockType`);
                         keys.push(`${blockPrefix}_id`);
-                        keys.push(...getFlattenedFieldKeys(block.fields, blockPrefix));
+                        keys.push(...getFlattenedFieldKeys(block.flattenedFields ?? block.fields, blockPrefix, options));
                     });
                     break;
                 }
             case 'collapsible':
             case 'group':
             case 'row':
-                keys.push(...getFlattenedFieldKeys(field.fields, fullKey));
+                keys.push(...getFlattenedFieldKeys(field.fields, fullKey, options));
                 break;
             case 'relationship':
+            case 'upload':
                 if (field.hasMany) {
                     if (Array.isArray(field.relationTo)) {
                         // hasMany polymorphic
                         keys.push(`${fullKey}_0_relationTo`, `${fullKey}_0_id`);
                     } else {
                         // hasMany monomorphic
-                        keys.push(`${fullKey}_0_id`);
+                        keys.push(`${fullKey}_0`);
                     }
                 } else {
                     if (Array.isArray(field.relationTo)) {
@@ -41,25 +66,25 @@ export const getFlattenedFieldKeys = (fields, prefix = '')=>{
                         keys.push(`${fullKey}_relationTo`, `${fullKey}_id`);
                     } else {
                         // hasOne monomorphic
-                        keys.push(fullKey);
+                        addKey(fullKey, isLocalized);
                     }
                 }
                 break;
             case 'tabs':
                 field.tabs?.forEach((tab)=>{
                     const tabPrefix = tab.name ? `${fullKey}_${tab.name}` : fullKey;
-                    keys.push(...getFlattenedFieldKeys(tab.fields || [], tabPrefix));
+                    keys.push(...getFlattenedFieldKeys(tab.fields || [], tabPrefix, options));
                 });
                 break;
             default:
-                if (!name || fieldHasToCSVFunction) {
+                if (!name) {
                     break;
                 }
                 if ('hasMany' in field && field.hasMany) {
                     // Push placeholder for first index
                     keys.push(`${fullKey}_0`);
                 } else {
-                    keys.push(fullKey);
+                    addKey(fullKey, isLocalized);
                 }
                 break;
         }

package/dist/utilities/getFlattenedFieldKeys.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/getFlattenedFieldKeys.ts"],"sourcesContent":["import { type FlattenedField } from 'payload'\n\ntype FieldWithPresentational =\n  | {\n      fields?: FlattenedField[]\n      name?: string\n      tabs?: {\n        fields: FlattenedField[]\n        name?: string\n      }[]\n      type: 'collapsible' | 'row' | 'tabs'\n    }\n  | FlattenedField\n\nexport const getFlattenedFieldKeys = (fields: FieldWithPresentational[], prefix = ''): string[] => {\n  const keys: string[] = []\n\n  fields.forEach((field) => {\n    const fieldHasToCSVFunction =\n      'custom' in field &&\n      typeof field.custom === 'object' &&\n      'plugin-import-export' in field.custom &&\n      field.custom['plugin-import-export']?.toCSV\n\n    const name = 'name' in field && typeof field.name === 'string' ? field.name : undefined\n    const fullKey = name && prefix ? `${prefix}_${name}` : (name ?? prefix)\n\n    switch (field.type) {\n      case 'array': {\n        const subKeys = getFlattenedFieldKeys(field.fields as FlattenedField[], `${fullKey}_0`)\n        keys.push(...subKeys)\n        break\n      }\n      case 'blocks': {\n        field.blocks.forEach((block) => {\n          const blockPrefix = `${fullKey}_0_${block.slug}`\n          keys.push(`${blockPrefix}_blockType`)\n          keys.push(`${blockPrefix}_id`)\n          keys.push(...getFlattenedFieldKeys(block.fields as FlattenedField[], blockPrefix))\n        })\n        break\n      }\n      case 'collapsible':\n      case 'group':\n      case 'row':\n        keys.push(...getFlattenedFieldKeys(field.fields as FlattenedField[], fullKey))\n        break\n      case 'relationship':\n        if (field.hasMany) {\n          if (Array.isArray(field.relationTo)) {\n            // hasMany polymorphic\n            keys.push(`${fullKey}_0_relationTo`, `${fullKey}_0_id`)\n          } else {\n            // hasMany monomorphic\n            keys.push(`${fullKey}_0_id`)\n          }\n        } else {\n          if (Array.isArray(field.relationTo)) {\n            // hasOne polymorphic\n            keys.push(`${fullKey}_relationTo`, `${fullKey}_id`)\n          } else {\n            // hasOne monomorphic\n            keys.push(fullKey)\n          }\n        }\n        break\n      case 'tabs':\n        field.tabs?.forEach((tab) => {\n          const tabPrefix = tab.name ? `${fullKey}_${tab.name}` : fullKey\n          keys.push(...getFlattenedFieldKeys(tab.fields || [], tabPrefix))\n        })\n        break\n      default:\n        if (!name || fieldHasToCSVFunction) {\n          break\n        }\n        if ('hasMany' in field && field.hasMany) {\n          // Push placeholder for first index\n          keys.push(`${fullKey}_0`)\n        } else {\n          keys.push(fullKey)\n        }\n        break\n    }\n  })\n\n  return keys\n}\n"],"names":["getFlattenedFieldKeys","fields","prefix","keys","forEach","field","fieldHasToCSVFunction","custom","toCSV","name","undefined","fullKey","type","subKeys","push","blocks","block","blockPrefix","slug","hasMany","Array","isArray","relationTo","tabs","tab","tabPrefix"],"mappings":"AAcA,OAAO,MAAMA,wBAAwB,CAACC,QAAmCC,SAAS,EAAE;IAClF,MAAMC,OAAiB,EAAE;IAEzBF,OAAOG,OAAO,CAAC,CAACC;QACd,MAAMC,wBACJ,YAAYD,SACZ,OAAOA,MAAME,MAAM,KAAK,YACxB,0BAA0BF,MAAME,MAAM,IACtCF,MAAME,MAAM,CAAC,uBAAuB,EAAEC;QAExC,MAAMC,OAAO,UAAUJ,SAAS,OAAOA,MAAMI,IAAI,KAAK,WAAWJ,MAAMI,IAAI,GAAGC;QAC9E,MAAMC,UAAUF,QAAQP,SAAS,GAAGA,OAAO,CAAC,EAAEO,MAAM,GAAIA,QAAQP;QAEhE,OAAQG,MAAMO,IAAI;YAChB,KAAK;gBAAS;oBACZ,MAAMC,UAAUb,sBAAsBK,MAAMJ,MAAM,EAAsB,GAAGU,QAAQ,EAAE,CAAC;oBACtFR,KAAKW,IAAI,IAAID;oBACb;gBACF;YACA,KAAK;gBAAU;oBACbR,MAAMU,MAAM,CAACX,OAAO,CAAC,CAACY;wBACpB,MAAMC,cAAc,GAAGN,QAAQ,GAAG,EAAEK,MAAME,IAAI,EAAE;wBAChDf,KAAKW,IAAI,CAAC,GAAGG,YAAY,UAAU,CAAC;wBACpCd,KAAKW,IAAI,CAAC,GAAGG,YAAY,GAAG,CAAC;wBAC7Bd,KAAKW,IAAI,IAAId,sBAAsBgB,MAAMf,MAAM,EAAsBgB;oBACvE;oBACA;gBACF;YACA,KAAK;YACL,KAAK;YACL,KAAK;gBACHd,KAAKW,IAAI,IAAId,sBAAsBK,MAAMJ,MAAM,EAAsBU;gBACrE;YACF,KAAK;gBACH,IAAIN,MAAMc,OAAO,EAAE;oBACjB,IAAIC,MAAMC,OAAO,CAAChB,MAAMiB,UAAU,GAAG;wBACnC,sBAAsB;wBACtBnB,KAAKW,IAAI,CAAC,GAAGH,QAAQ,aAAa,CAAC,EAAE,GAAGA,QAAQ,KAAK,CAAC;oBACxD,OAAO;wBACL,sBAAsB;wBACtBR,KAAKW,IAAI,CAAC,GAAGH,QAAQ,KAAK,CAAC;oBAC7B;gBACF,OAAO;oBACL,IAAIS,MAAMC,OAAO,CAAChB,MAAMiB,UAAU,GAAG;wBACnC,qBAAqB;wBACrBnB,KAAKW,IAAI,CAAC,GAAGH,QAAQ,WAAW,CAAC,EAAE,GAAGA,QAAQ,GAAG,CAAC;oBACpD,OAAO;wBACL,qBAAqB;wBACrBR,KAAKW,IAAI,CAACH;oBACZ;gBACF;gBACA;YACF,KAAK;gBACHN,MAAMkB,IAAI,EAAEnB,QAAQ,CAACoB;oBACnB,MAAMC,YAAYD,IAAIf,IAAI,GAAG,GAAGE,QAAQ,CAAC,EAAEa,IAAIf,IAAI,EAAE,GAAGE;oBACxDR,KAAKW,IAAI,IAAId,sBAAsBwB,IAAIvB,MAAM,IAAI,EAAE,EAAEwB;gBACvD;gBACA;YACF;gBACE,IAAI,CAAChB,QAAQH,uBAAuB;oBAClC;gBACF;gBACA,IAAI,aAAaD,SAASA,MAAMc,OAAO,EAAE;oBACvC,mCAAmC;oBACnChB,KAAKW,IAAI,CAAC,GAAGH,QAAQ,EAAE,CAAC;gBAC1B,OAAO;oBACLR,KAAKW,IAAI,CAACH;gBACZ;gBACA;QACJ;IACF;IAEA,OAAOR;AACT,EAAC"}
+{"version":3,"sources":["../../src/utilities/getFlattenedFieldKeys.ts"],"sourcesContent":["import { type FlattenedField } from 'payload'\n\ntype FieldWithPresentational =\n  | {\n      fields?: FlattenedField[]\n      name?: string\n      tabs?: {\n        fields: FlattenedField[]\n        name?: string\n      }[]\n      type: 'collapsible' | 'row' | 'tabs'\n    }\n  | FlattenedField\n\nexport type GetFlattenedFieldKeysOptions = {\n  /**\n   * When provided, localized fields will be expanded to include locale suffixes.\n   * e.g., 'title' (localized) -> ['title_en', 'title_es']\n   */\n  localeCodes?: string[]\n}\n\n/**\n * Recursively traverses fields and generates flattened CSV column keys.\n * This is schema-based - it derives columns from field definitions, not data.\n */\nexport const getFlattenedFieldKeys = (\n  fields: FieldWithPresentational[],\n  prefix = '',\n  options: GetFlattenedFieldKeysOptions = {},\n): string[] => {\n  const { localeCodes } = options\n  const keys: string[] = []\n\n  fields.forEach((field) => {\n    // Skip disabled fields\n    const isDisabled =\n      'custom' in field &&\n      typeof field.custom === 'object' &&\n      field.custom?.['plugin-import-export']?.disabled === true\n\n    if (isDisabled) {\n      return\n    }\n\n    const name = 'name' in field && typeof field.name === 'string' ? field.name : undefined\n    const fullKey = name && prefix ? `${prefix}_${name}` : (name ?? prefix)\n\n    // Check if field is localized\n    const isLocalized = 'localized' in field && field.localized === true\n\n    // Helper to add keys with locale expansion if needed\n    const addKey = (key: string, fieldIsLocalized: boolean) => {\n      if (fieldIsLocalized && localeCodes && localeCodes.length > 0) {\n        // Expand to locale-specific keys\n        for (const locale of localeCodes) {\n          keys.push(`${key}_${locale}`)\n        }\n      } else {\n        keys.push(key)\n      }\n    }\n\n    switch (field.type) {\n      case 'array': {\n        const subKeys = getFlattenedFieldKeys(\n          field.fields as FlattenedField[],\n          `${fullKey}_0`,\n          options,\n        )\n        keys.push(...subKeys)\n        break\n      }\n      case 'blocks': {\n        field.blocks.forEach((block) => {\n          if (typeof block === 'string') {\n            return // Skip block references\n          }\n          const blockPrefix = `${fullKey}_0_${block.slug}`\n          keys.push(`${blockPrefix}_blockType`)\n          keys.push(`${blockPrefix}_id`)\n          keys.push(\n            ...getFlattenedFieldKeys(block.flattenedFields ?? block.fields, blockPrefix, options),\n          )\n        })\n        break\n      }\n      case 'collapsible':\n      case 'group':\n      case 'row':\n        keys.push(...getFlattenedFieldKeys(field.fields as FlattenedField[], fullKey, options))\n        break\n      case 'relationship':\n      case 'upload':\n        if (field.hasMany) {\n          if (Array.isArray(field.relationTo)) {\n            // hasMany polymorphic\n            keys.push(`${fullKey}_0_relationTo`, `${fullKey}_0_id`)\n          } else {\n            // hasMany monomorphic\n            keys.push(`${fullKey}_0`)\n          }\n        } else {\n          if (Array.isArray(field.relationTo)) {\n            // hasOne polymorphic\n            keys.push(`${fullKey}_relationTo`, `${fullKey}_id`)\n          } else {\n            // hasOne monomorphic\n            addKey(fullKey, isLocalized)\n          }\n        }\n        break\n      case 'tabs':\n        field.tabs?.forEach((tab) => {\n          const tabPrefix = tab.name ? `${fullKey}_${tab.name}` : fullKey\n          keys.push(...getFlattenedFieldKeys(tab.fields || [], tabPrefix, options))\n        })\n        break\n      default:\n        if (!name) {\n          break\n        }\n        if ('hasMany' in field && field.hasMany) {\n          // Push placeholder for first index\n          keys.push(`${fullKey}_0`)\n        } else {\n          addKey(fullKey, isLocalized)\n        }\n        break\n    }\n  })\n\n  return keys\n}\n"],"names":["getFlattenedFieldKeys","fields","prefix","options","localeCodes","keys","forEach","field","isDisabled","custom","disabled","name","undefined","fullKey","isLocalized","localized","addKey","key","fieldIsLocalized","length","locale","push","type","subKeys","blocks","block","blockPrefix","slug","flattenedFields","hasMany","Array","isArray","relationTo","tabs","tab","tabPrefix"],"mappings":"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"}

package/dist/utilities/getImportFieldFunctions.d.ts

@@ -0,0 +1,12 @@
+import { type FlattenedField } from 'payload';
+import type { FromCSVFunction } from '../types.js';
+type Args = {
+    fields: FlattenedField[];
+};
+/**
+ * Gets custom fromCSV field functions for import.
+ * These functions transform field values when unflattening CSV data for import.
+ */
+export declare const getImportFieldFunctions: ({ fields }: Args) => Record<string, FromCSVFunction>;
+export {};
+//# sourceMappingURL=getImportFieldFunctions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getImportFieldFunctions.d.ts","sourceRoot":"","sources":["../../src/utilities/getImportFieldFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAA+C,MAAM,SAAS,CAAA;AAE1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,KAAK,IAAI,GAAG;IACV,MAAM,EAAE,cAAc,EAAE,CAAA;CACzB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,eAAgB,IAAI,KAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CA4HxF,CAAA"}

package/dist/utilities/getImportFieldFunctions.js

@@ -0,0 +1,130 @@
+import { traverseFields } from 'payload';
+/**
+ * Gets custom fromCSV field functions for import.
+ * These functions transform field values when unflattening CSV data for import.
+ */ export const getImportFieldFunctions = ({ 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']?.fromCSV === 'function') {
+            // @ts-expect-error ref is untyped
+            result[`${ref.prefix}${field.name}`] = field.custom['plugin-import-export']?.fromCSV;
+        } else if (field.type === 'relationship' || field.type === 'upload') {
+            if (field.hasMany !== true) {
+                if (!Array.isArray(field.relationTo)) {
+                    // monomorphic single relationship - simple ID to value conversion
+                    // @ts-expect-error ref is untyped
+                    result[`${ref.prefix}${field.name}`] = ({ value })=>{
+                        // If it's already an object (from JSON import), return as-is
+                        if (typeof value === 'object' && value !== null) {
+                            return value;
+                        }
+                        // Convert string/number ID to relationship value
+                        return value;
+                    };
+                } else {
+                // polymorphic single relationship - needs special handling
+                // The CSV has field_id and field_relationTo columns
+                // We need to combine them back into { relationTo, value } format
+                // This is handled in unflattenObject, so we don't need a fromCSV here
+                }
+            } else {
+                if (!Array.isArray(field.relationTo)) {
+                    // @ts-expect-error ref is untyped
+                    result[`${ref.prefix}${field.name}`] = ({ value })=>{
+                        // If it's already an array (from JSON import), return as-is
+                        if (Array.isArray(value)) {
+                            return value;
+                        }
+                        // For CSV, this is handled by array unflattening in unflattenObject
+                        return value;
+                    };
+                } else {
+                // polymorphic many relationships
+                // Similar to polymorphic single, handled in unflattenObject
+                }
+            }
+        } else if (field.type === 'number') {
+            // For hasMany number fields, preserve comma-separated strings for later processing
+            if (field.hasMany) {
+                // Don't convert - let unflattenObject handle comma-separated values
+                // @ts-expect-error ref is untyped
+                result[`${ref.prefix}${field.name}`] = ({ value })=>value;
+            } else {
+                // Ensure single numbers are parsed correctly from CSV strings
+                // @ts-expect-error ref is untyped
+                result[`${ref.prefix}${field.name}`] = ({ value })=>{
+                    if (typeof value === 'number') {
+                        return value;
+                    }
+                    if (typeof value === 'string') {
+                        const parsed = parseFloat(value);
+                        return isNaN(parsed) ? 0 : parsed;
+                    }
+                    return value;
+                };
+            }
+        } else if (field.type === 'checkbox') {
+            // Convert string boolean values to actual booleans
+            // @ts-expect-error ref is untyped
+            result[`${ref.prefix}${field.name}`] = ({ value })=>{
+                if (typeof value === 'boolean') {
+                    return value;
+                }
+                if (typeof value === 'string') {
+                    return value.toLowerCase() === 'true' || value === '1';
+                }
+                return Boolean(value);
+            };
+        } else if (field.type === 'date') {
+            // Ensure dates are in proper format
+            // @ts-expect-error ref is untyped
+            result[`${ref.prefix}${field.name}`] = ({ value })=>{
+                if (!value) {
+                    return value;
+                }
+                // If it's already a valid date string, return as-is
+                if (typeof value === 'string' && !isNaN(Date.parse(value))) {
+                    return value;
+                }
+                // Try to parse and format
+                try {
+                    const date = new Date(value);
+                    return isNaN(date.getTime()) ? value : date.toISOString();
+                } catch  {
+                    return value;
+                }
+            };
+        } else if (field.type === 'json' || field.type === 'richText') {
+            // Parse JSON strings back to objects (both json and richText fields)
+            // @ts-expect-error ref is untyped
+            result[`${ref.prefix}${field.name}`] = ({ value })=>{
+                if (typeof value === 'object') {
+                    return value;
+                }
+                if (typeof value === 'string') {
+                    try {
+                        return JSON.parse(value);
+                    } catch  {
+                        return value;
+                    }
+                }
+                return value;
+            };
+        }
+    };
+    traverseFields({
+        callback: buildCustomFunctions,
+        fields
+    });
+    return result;
+};
+
+//# sourceMappingURL=getImportFieldFunctions.js.map