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

package/dist/utilities/getPluginCollections.js

@@ -0,0 +1,102 @@
+import { getExportCollection } from '../export/getExportCollection.js';
+import { getImportCollection } from '../import/getImportCollection.js';
+/**
+ * Processes the plugin config and returns export/import collections.
+ *
+ * - Creates the base export and import collections
+ * - Applies top-level overrideExportCollection/overrideImportCollection if provided
+ * - For each collection in `pluginConfig.collections` that has a function override
+ *   for `export` or `import`, applies the override to create customized collections
+ *
+ * @param config - The Payload config
+ * @param pluginConfig - The import/export plugin config
+ * @returns Object containing arrays of export and import collections
+ */ export const getPluginCollections = async ({ config, pluginConfig })=>{
+    // Get the base export and import collections with default configs (no per-collection settings)
+    let baseExportCollection = getExportCollection({
+        config,
+        pluginConfig
+    });
+    let baseImportCollection = getImportCollection({
+        config,
+        pluginConfig
+    });
+    // Apply top-level collection overrides if provided
+    if (pluginConfig.overrideExportCollection && typeof pluginConfig.overrideExportCollection === 'function') {
+        baseExportCollection = await pluginConfig.overrideExportCollection({
+            collection: baseExportCollection
+        });
+    }
+    if (pluginConfig.overrideImportCollection && typeof pluginConfig.overrideImportCollection === 'function') {
+        baseImportCollection = await pluginConfig.overrideImportCollection({
+            collection: baseImportCollection
+        });
+    }
+    const exportCollections = [];
+    const importCollections = [];
+    // Maps from target collection slug to the export/import collection slug to use
+    const customExportSlugMap = new Map();
+    const customImportSlugMap = new Map();
+    // Process each collection config for custom collection overrides
+    if (pluginConfig.collections && pluginConfig.collections.length > 0) {
+        for (const collectionConfig of pluginConfig.collections){
+            // Handle export config - only process if overrideCollection is provided
+            // Settings like disableJobsQueue require a custom slug to work properly
+            const exportConfig = typeof collectionConfig.export === 'object' ? collectionConfig.export : undefined;
+            if (exportConfig?.overrideCollection) {
+                // Generate a collection with this export config's settings (like disableJobsQueue)
+                const collectionWithSettings = getExportCollection({
+                    config,
+                    exportConfig,
+                    pluginConfig
+                });
+                const customExport = await exportConfig.overrideCollection({
+                    collection: collectionWithSettings
+                });
+                // If the slug changed, this is a separate collection; otherwise it modifies the base
+                if (customExport.slug !== baseExportCollection.slug) {
+                    exportCollections.push(customExport);
+                    // Map this target collection to its custom export collection
+                    customExportSlugMap.set(collectionConfig.slug, customExport.slug);
+                } else {
+                    // Full override - replace the base
+                    baseExportCollection = customExport;
+                }
+            }
+            // Handle import config - only process if overrideCollection is provided
+            // Settings like disableJobsQueue require a custom slug to work properly
+            const importConf = typeof collectionConfig.import === 'object' ? collectionConfig.import : undefined;
+            if (importConf?.overrideCollection) {
+                // Generate a collection with this import config's settings (like disableJobsQueue)
+                const collectionWithSettings = getImportCollection({
+                    config,
+                    importConfig: importConf,
+                    pluginConfig
+                });
+                const customImport = await importConf.overrideCollection({
+                    collection: collectionWithSettings
+                });
+                // If the slug changed, this is a separate collection; otherwise it modifies the base
+                if (customImport.slug !== baseImportCollection.slug) {
+                    importCollections.push(customImport);
+                    // Map this target collection to its custom import collection
+                    customImportSlugMap.set(collectionConfig.slug, customImport.slug);
+                } else {
+                    // Full override - replace the base
+                    baseImportCollection = customImport;
+                }
+            }
+        }
+    }
+    // Add base collections to the front of the arrays
+    exportCollections.unshift(baseExportCollection);
+    importCollections.unshift(baseImportCollection);
+    return {
+        customExportSlugMap,
+        customImportSlugMap,
+        exportCollections,
+        importCollections
+    };
+};
+
+//# sourceMappingURL=getPluginCollections.js.map

package/dist/utilities/getPluginCollections.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/getPluginCollections.ts"],"sourcesContent":["import type { CollectionConfig, Config } from 'payload'\n\nimport type { ExportConfig, ImportConfig, ImportExportPluginConfig } from '../types.js'\n\nimport { getExportCollection } from '../export/getExportCollection.js'\nimport { getImportCollection } from '../import/getImportCollection.js'\n\nexport type PluginCollectionsResult = {\n  /**\n   * Map from target collection slug to the export collection slug to use for it.\n   * Only contains entries for collections with custom export collection overrides.\n   */\n  customExportSlugMap: Map<string, string>\n  /**\n   * Map from target collection slug to the import collection slug to use for it.\n   * Only contains entries for collections with custom import collection overrides.\n   */\n  customImportSlugMap: Map<string, string>\n  /**\n   * All export collections (base + any per-collection overrides)\n   */\n  exportCollections: CollectionConfig[]\n  /**\n   * All import collections (base + any per-collection overrides)\n   */\n  importCollections: CollectionConfig[]\n}\n\n/**\n * Processes the plugin config and returns export/import collections.\n *\n * - Creates the base export and import collections\n * - Applies top-level overrideExportCollection/overrideImportCollection if provided\n * - For each collection in `pluginConfig.collections` that has a function override\n *   for `export` or `import`, applies the override to create customized collections\n *\n * @param config - The Payload config\n * @param pluginConfig - The import/export plugin config\n * @returns Object containing arrays of export and import collections\n */\nexport const getPluginCollections = async ({\n  config,\n  pluginConfig,\n}: {\n  config: Config\n  pluginConfig: ImportExportPluginConfig\n}): Promise<PluginCollectionsResult> => {\n  // Get the base export and import collections with default configs (no per-collection settings)\n  let baseExportCollection = getExportCollection({\n    config,\n    pluginConfig,\n  })\n  let baseImportCollection = getImportCollection({\n    config,\n    pluginConfig,\n  })\n\n  // Apply top-level collection overrides if provided\n  if (\n    pluginConfig.overrideExportCollection &&\n    typeof pluginConfig.overrideExportCollection === 'function'\n  ) {\n    baseExportCollection = await pluginConfig.overrideExportCollection({\n      collection: baseExportCollection,\n    })\n  }\n\n  if (\n    pluginConfig.overrideImportCollection &&\n    typeof pluginConfig.overrideImportCollection === 'function'\n  ) {\n    baseImportCollection = await pluginConfig.overrideImportCollection({\n      collection: baseImportCollection,\n    })\n  }\n\n  const exportCollections: CollectionConfig[] = []\n  const importCollections: CollectionConfig[] = []\n\n  // Maps from target collection slug to the export/import collection slug to use\n  const customExportSlugMap = new Map<string, string>()\n  const customImportSlugMap = new Map<string, string>()\n\n  // Process each collection config for custom collection overrides\n  if (pluginConfig.collections && pluginConfig.collections.length > 0) {\n    for (const collectionConfig of pluginConfig.collections) {\n      // Handle export config - only process if overrideCollection is provided\n      // Settings like disableJobsQueue require a custom slug to work properly\n      const exportConfig =\n        typeof collectionConfig.export === 'object' ? collectionConfig.export : undefined\n      if (exportConfig?.overrideCollection) {\n        // Generate a collection with this export config's settings (like disableJobsQueue)\n        const collectionWithSettings = getExportCollection({\n          config,\n          exportConfig,\n          pluginConfig,\n        })\n\n        const customExport = await exportConfig.overrideCollection({\n          collection: collectionWithSettings,\n        })\n\n        // If the slug changed, this is a separate collection; otherwise it modifies the base\n        if (customExport.slug !== baseExportCollection.slug) {\n          exportCollections.push(customExport)\n          // Map this target collection to its custom export collection\n          customExportSlugMap.set(collectionConfig.slug, customExport.slug)\n        } else {\n          // Full override - replace the base\n          baseExportCollection = customExport\n        }\n      }\n\n      // Handle import config - only process if overrideCollection is provided\n      // Settings like disableJobsQueue require a custom slug to work properly\n      const importConf =\n        typeof collectionConfig.import === 'object' ? collectionConfig.import : undefined\n      if (importConf?.overrideCollection) {\n        // Generate a collection with this import config's settings (like disableJobsQueue)\n        const collectionWithSettings = getImportCollection({\n          config,\n          importConfig: importConf,\n          pluginConfig,\n        })\n\n        const customImport = await importConf.overrideCollection({\n          collection: collectionWithSettings,\n        })\n\n        // If the slug changed, this is a separate collection; otherwise it modifies the base\n        if (customImport.slug !== baseImportCollection.slug) {\n          importCollections.push(customImport)\n          // Map this target collection to its custom import collection\n          customImportSlugMap.set(collectionConfig.slug, customImport.slug)\n        } else {\n          // Full override - replace the base\n          baseImportCollection = customImport\n        }\n      }\n    }\n  }\n\n  // Add base collections to the front of the arrays\n  exportCollections.unshift(baseExportCollection)\n  importCollections.unshift(baseImportCollection)\n\n  return {\n    customExportSlugMap,\n    customImportSlugMap,\n    exportCollections,\n    importCollections,\n  }\n}\n"],"names":["getExportCollection","getImportCollection","getPluginCollections","config","pluginConfig","baseExportCollection","baseImportCollection","overrideExportCollection","collection","overrideImportCollection","exportCollections","importCollections","customExportSlugMap","Map","customImportSlugMap","collections","length","collectionConfig","exportConfig","export","undefined","overrideCollection","collectionWithSettings","customExport","slug","push","set","importConf","import","importConfig","customImport","unshift"],"mappings":"AAIA,SAASA,mBAAmB,QAAQ,mCAAkC;AACtE,SAASC,mBAAmB,QAAQ,mCAAkC;AAuBtE;;;;;;;;;;;CAWC,GACD,OAAO,MAAMC,uBAAuB,OAAO,EACzCC,MAAM,EACNC,YAAY,EAIb;IACC,+FAA+F;IAC/F,IAAIC,uBAAuBL,oBAAoB;QAC7CG;QACAC;IACF;IACA,IAAIE,uBAAuBL,oBAAoB;QAC7CE;QACAC;IACF;IAEA,mDAAmD;IACnD,IACEA,aAAaG,wBAAwB,IACrC,OAAOH,aAAaG,wBAAwB,KAAK,YACjD;QACAF,uBAAuB,MAAMD,aAAaG,wBAAwB,CAAC;YACjEC,YAAYH;QACd;IACF;IAEA,IACED,aAAaK,wBAAwB,IACrC,OAAOL,aAAaK,wBAAwB,KAAK,YACjD;QACAH,uBAAuB,MAAMF,aAAaK,wBAAwB,CAAC;YACjED,YAAYF;QACd;IACF;IAEA,MAAMI,oBAAwC,EAAE;IAChD,MAAMC,oBAAwC,EAAE;IAEhD,+EAA+E;IAC/E,MAAMC,sBAAsB,IAAIC;IAChC,MAAMC,sBAAsB,IAAID;IAEhC,iEAAiE;IACjE,IAAIT,aAAaW,WAAW,IAAIX,aAAaW,WAAW,CAACC,MAAM,GAAG,GAAG;QACnE,KAAK,MAAMC,oBAAoBb,aAAaW,WAAW,CAAE;YACvD,wEAAwE;YACxE,wEAAwE;YACxE,MAAMG,eACJ,OAAOD,iBAAiBE,MAAM,KAAK,WAAWF,iBAAiBE,MAAM,GAAGC;YAC1E,IAAIF,cAAcG,oBAAoB;gBACpC,mFAAmF;gBACnF,MAAMC,yBAAyBtB,oBAAoB;oBACjDG;oBACAe;oBACAd;gBACF;gBAEA,MAAMmB,eAAe,MAAML,aAAaG,kBAAkB,CAAC;oBACzDb,YAAYc;gBACd;gBAEA,qFAAqF;gBACrF,IAAIC,aAAaC,IAAI,KAAKnB,qBAAqBmB,IAAI,EAAE;oBACnDd,kBAAkBe,IAAI,CAACF;oBACvB,6DAA6D;oBAC7DX,oBAAoBc,GAAG,CAACT,iBAAiBO,IAAI,EAAED,aAAaC,IAAI;gBAClE,OAAO;oBACL,mCAAmC;oBACnCnB,uBAAuBkB;gBACzB;YACF;YAEA,wEAAwE;YACxE,wEAAwE;YACxE,MAAMI,aACJ,OAAOV,iBAAiBW,MAAM,KAAK,WAAWX,iBAAiBW,MAAM,GAAGR;YAC1E,IAAIO,YAAYN,oBAAoB;gBAClC,mFAAmF;gBACnF,MAAMC,yBAAyBrB,oBAAoB;oBACjDE;oBACA0B,cAAcF;oBACdvB;gBACF;gBAEA,MAAM0B,eAAe,MAAMH,WAAWN,kBAAkB,CAAC;oBACvDb,YAAYc;gBACd;gBAEA,qFAAqF;gBACrF,IAAIQ,aAAaN,IAAI,KAAKlB,qBAAqBkB,IAAI,EAAE;oBACnDb,kBAAkBc,IAAI,CAACK;oBACvB,6DAA6D;oBAC7DhB,oBAAoBY,GAAG,CAACT,iBAAiBO,IAAI,EAAEM,aAAaN,IAAI;gBAClE,OAAO;oBACL,mCAAmC;oBACnClB,uBAAuBwB;gBACzB;YACF;QACF;IACF;IAEA,kDAAkD;IAClDpB,kBAAkBqB,OAAO,CAAC1B;IAC1BM,kBAAkBoB,OAAO,CAACzB;IAE1B,OAAO;QACLM;QACAE;QACAJ;QACAC;IACF;AACF,EAAC"}

package/dist/utilities/getSchemaColumns.d.ts

@@ -0,0 +1,43 @@
+import type { SanitizedCollectionConfig } from 'payload';
+export type GetSchemaColumnsArgs = {
+    /**
+     * The collection configuration to derive columns from
+     */
+    collectionConfig: SanitizedCollectionConfig;
+    /**
+     * Array of disabled field paths from plugin config
+     */
+    disabledFields?: string[];
+    /**
+     * User-selected fields to export. If provided, only these fields (and their nested fields) will be included.
+     */
+    fields?: string[];
+    /**
+     * The locale to export. When 'all', localized fields are expanded to include all locale suffixes.
+     */
+    locale?: null | string;
+    /**
+     * Available locale codes from config. Required when locale='all'.
+     */
+    localeCodes?: string[];
+};
+/**
+ * Derives CSV column names from the collection schema.
+ * This provides a base set of columns from field definitions.
+ *
+ * Note: For arrays/blocks with multiple items, the schema only generates index 0.
+ * Additional indices from actual data should be merged with these columns.
+ *
+ * Benefits:
+ * - Provides consistent base columns
+ * - Works for empty exports
+ * - Ensures proper column ordering
+ */
+export declare const getSchemaColumns: ({ collectionConfig, disabledFields, fields: selectedFields, locale, localeCodes, }: GetSchemaColumnsArgs) => string[];
+/**
+ * Merges schema-derived columns with data-discovered columns.
+ * Schema columns provide the base ordering, data columns add any additional
+ * columns (e.g., array indices beyond 0, dynamic fields).
+ */
+export declare const mergeColumns: (schemaColumns: string[], dataColumns: string[]) => string[];
+//# sourceMappingURL=getSchemaColumns.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getSchemaColumns.d.ts","sourceRoot":"","sources":["../../src/utilities/getSchemaColumns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAA;AAIxD,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,gBAAgB,EAAE,yBAAyB,CAAA;IAC3C;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB;;OAEG;IACH,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,uFAM1B,oBAAoB,KAAG,MAAM,EA4E/B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,kBAAmB,MAAM,EAAE,eAAe,MAAM,EAAE,KAAG,MAAM,EAoCnF,CAAA"}

package/dist/utilities/getSchemaColumns.js

@@ -0,0 +1,163 @@
+import { getFlattenedFieldKeys } from './getFlattenedFieldKeys.js';
+/**
+ * Derives CSV column names from the collection schema.
+ * This provides a base set of columns from field definitions.
+ *
+ * Note: For arrays/blocks with multiple items, the schema only generates index 0.
+ * Additional indices from actual data should be merged with these columns.
+ *
+ * Benefits:
+ * - Provides consistent base columns
+ * - Works for empty exports
+ * - Ensures proper column ordering
+ */ export const getSchemaColumns = ({ collectionConfig, disabledFields = [], fields: selectedFields, locale, localeCodes })=>{
+    const hasVersions = Boolean(collectionConfig.versions);
+    // Determine if we need locale expansion
+    const expandLocales = locale === 'all' && localeCodes && localeCodes.length > 0;
+    // Get all possible columns from schema (excludes system fields like id, createdAt, updatedAt)
+    let schemaColumns = getFlattenedFieldKeys(collectionConfig.flattenedFields, '', expandLocales ? {
+        localeCodes
+    } : {});
+    // Add system fields that aren't in flattenedFields
+    const systemFields = [
+        'id',
+        'createdAt',
+        'updatedAt'
+    ];
+    schemaColumns = [
+        ...systemFields,
+        ...schemaColumns
+    ];
+    // Filter to user-selected fields if specified
+    if (selectedFields && selectedFields.length > 0) {
+        schemaColumns = filterToSelectedFields(schemaColumns, selectedFields);
+    }
+    // Remove disabled fields
+    if (disabledFields.length > 0) {
+        const disabledSet = new Set();
+        for (const path of disabledFields){
+            // Convert dot notation to underscore and add to set
+            disabledSet.add(path.replace(/\./g, '_'));
+        }
+        schemaColumns = schemaColumns.filter((col)=>{
+            // Check if column matches any disabled path
+            for (const disabled of disabledSet){
+                if (col === disabled || col.startsWith(`${disabled}_`)) {
+                    return false;
+                }
+            }
+            return true;
+        });
+    }
+    // When user has selected specific fields, preserve their ordering
+    // filterToSelectedFields() already returns columns in user's specified order
+    if (selectedFields && selectedFields.length > 0) {
+        return schemaColumns;
+    }
+    // No fields selected - apply default ordering (id first, timestamps last)
+    const orderedColumns = [];
+    // 1. ID always first
+    if (schemaColumns.includes('id')) {
+        orderedColumns.push('id');
+    }
+    // 2. Status field for versioned collections
+    if (hasVersions) {
+        orderedColumns.push('_status');
+    }
+    // 3. All other fields (excluding id, timestamps, status)
+    const excludeFromMiddle = new Set([
+        '_status',
+        'createdAt',
+        'id',
+        'updatedAt'
+    ]);
+    for (const col of schemaColumns){
+        if (!excludeFromMiddle.has(col)) {
+            orderedColumns.push(col);
+        }
+    }
+    // 4. Timestamps at the end
+    if (schemaColumns.includes('createdAt')) {
+        orderedColumns.push('createdAt');
+    }
+    if (schemaColumns.includes('updatedAt')) {
+        orderedColumns.push('updatedAt');
+    }
+    return orderedColumns;
+};
+/**
+ * Merges schema-derived columns with data-discovered columns.
+ * Schema columns provide the base ordering, data columns add any additional
+ * columns (e.g., array indices beyond 0, dynamic fields).
+ */ export const mergeColumns = (schemaColumns, dataColumns)=>{
+    const result = [
+        ...schemaColumns
+    ];
+    const schemaSet = new Set(schemaColumns);
+    // Add any data columns not in schema (preserves schema ordering, appends new ones)
+    for (const col of dataColumns){
+        if (!schemaSet.has(col)) {
+            // Find the best position to insert this column
+            // For array indices (e.g., field_1_*), insert after field_0_*
+            const match = col.match(/^(.+?)_(\d+)(_.*)?$/);
+            if (match) {
+                const [, basePath, index, suffix] = match;
+                if (basePath && index) {
+                    const prevIndex = parseInt(index, 10) - 1;
+                    const prevCol = `${basePath}_${prevIndex}${suffix ?? ''}`;
+                    const prevIdx = result.indexOf(prevCol);
+                    if (prevIdx !== -1) {
+                        // Insert after the previous index column
+                        result.splice(prevIdx + 1, 0, col);
+                        schemaSet.add(col);
+                        continue;
+                    }
+                }
+            }
+            // Otherwise append at the end (before timestamps)
+            const createdAtIdx = result.indexOf('createdAt');
+            if (createdAtIdx !== -1) {
+                result.splice(createdAtIdx, 0, col);
+            } else {
+                result.push(col);
+            }
+            schemaSet.add(col);
+        }
+    }
+    return result;
+};
+/**
+ * Filters schema columns to only include those matching user-selected fields.
+ * Preserves the order specified by the user in selectedFields.
+ * Handles nested field selection (e.g., 'group.value' includes 'group_value' and 'group_value_*')
+ */ function filterToSelectedFields(columns, selectedFields) {
+    const result = [];
+    const columnsSet = new Set(columns);
+    // Convert selected fields to underscore notation patterns
+    const patterns = selectedFields.map((field)=>{
+        const underscored = field.replace(/\./g, '_');
+        return {
+            exact: underscored,
+            original: field,
+            prefix: `${underscored}_`
+        };
+    });
+    // Iterate through user-specified fields in order to preserve their ordering
+    for (const pattern of patterns){
+        // First add the exact match if it exists
+        if (columnsSet.has(pattern.exact)) {
+            result.push(pattern.exact);
+        }
+        // Then add any columns with the prefix (nested fields)
+        for (const column of columns){
+            if (column !== pattern.exact && column.startsWith(pattern.prefix)) {
+                if (!result.includes(column)) {
+                    result.push(column);
+                }
+            }
+        }
+    }
+    return result;
+}
+
+//# sourceMappingURL=getSchemaColumns.js.map

package/dist/utilities/getSchemaColumns.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/getSchemaColumns.ts"],"sourcesContent":["import type { SanitizedCollectionConfig } from 'payload'\n\nimport { getFlattenedFieldKeys } from './getFlattenedFieldKeys.js'\n\nexport type GetSchemaColumnsArgs = {\n  /**\n   * The collection configuration to derive columns from\n   */\n  collectionConfig: SanitizedCollectionConfig\n  /**\n   * Array of disabled field paths from plugin config\n   */\n  disabledFields?: string[]\n  /**\n   * User-selected fields to export. If provided, only these fields (and their nested fields) will be included.\n   */\n  fields?: string[]\n  /**\n   * The locale to export. When 'all', localized fields are expanded to include all locale suffixes.\n   */\n  locale?: null | string\n  /**\n   * Available locale codes from config. Required when locale='all'.\n   */\n  localeCodes?: string[]\n}\n\n/**\n * Derives CSV column names from the collection schema.\n * This provides a base set of columns from field definitions.\n *\n * Note: For arrays/blocks with multiple items, the schema only generates index 0.\n * Additional indices from actual data should be merged with these columns.\n *\n * Benefits:\n * - Provides consistent base columns\n * - Works for empty exports\n * - Ensures proper column ordering\n */\nexport const getSchemaColumns = ({\n  collectionConfig,\n  disabledFields = [],\n  fields: selectedFields,\n  locale,\n  localeCodes,\n}: GetSchemaColumnsArgs): string[] => {\n  const hasVersions = Boolean(collectionConfig.versions)\n\n  // Determine if we need locale expansion\n  const expandLocales = locale === 'all' && localeCodes && localeCodes.length > 0\n\n  // Get all possible columns from schema (excludes system fields like id, createdAt, updatedAt)\n  let schemaColumns = getFlattenedFieldKeys(\n    collectionConfig.flattenedFields,\n    '',\n    expandLocales ? { localeCodes } : {},\n  )\n\n  // Add system fields that aren't in flattenedFields\n  const systemFields = ['id', 'createdAt', 'updatedAt']\n  schemaColumns = [...systemFields, ...schemaColumns]\n\n  // Filter to user-selected fields if specified\n  if (selectedFields && selectedFields.length > 0) {\n    schemaColumns = filterToSelectedFields(schemaColumns, selectedFields)\n  }\n\n  // Remove disabled fields\n  if (disabledFields.length > 0) {\n    const disabledSet = new Set<string>()\n    for (const path of disabledFields) {\n      // Convert dot notation to underscore and add to set\n      disabledSet.add(path.replace(/\\./g, '_'))\n    }\n    schemaColumns = schemaColumns.filter((col) => {\n      // Check if column matches any disabled path\n      for (const disabled of disabledSet) {\n        if (col === disabled || col.startsWith(`${disabled}_`)) {\n          return false\n        }\n      }\n      return true\n    })\n  }\n\n  // When user has selected specific fields, preserve their ordering\n  // filterToSelectedFields() already returns columns in user's specified order\n  if (selectedFields && selectedFields.length > 0) {\n    return schemaColumns\n  }\n\n  // No fields selected - apply default ordering (id first, timestamps last)\n  const orderedColumns: string[] = []\n\n  // 1. ID always first\n  if (schemaColumns.includes('id')) {\n    orderedColumns.push('id')\n  }\n\n  // 2. Status field for versioned collections\n  if (hasVersions) {\n    orderedColumns.push('_status')\n  }\n\n  // 3. All other fields (excluding id, timestamps, status)\n  const excludeFromMiddle = new Set(['_status', 'createdAt', 'id', 'updatedAt'])\n  for (const col of schemaColumns) {\n    if (!excludeFromMiddle.has(col)) {\n      orderedColumns.push(col)\n    }\n  }\n\n  // 4. Timestamps at the end\n  if (schemaColumns.includes('createdAt')) {\n    orderedColumns.push('createdAt')\n  }\n  if (schemaColumns.includes('updatedAt')) {\n    orderedColumns.push('updatedAt')\n  }\n\n  return orderedColumns\n}\n\n/**\n * Merges schema-derived columns with data-discovered columns.\n * Schema columns provide the base ordering, data columns add any additional\n * columns (e.g., array indices beyond 0, dynamic fields).\n */\nexport const mergeColumns = (schemaColumns: string[], dataColumns: string[]): string[] => {\n  const result = [...schemaColumns]\n  const schemaSet = new Set(schemaColumns)\n\n  // Add any data columns not in schema (preserves schema ordering, appends new ones)\n  for (const col of dataColumns) {\n    if (!schemaSet.has(col)) {\n      // Find the best position to insert this column\n      // For array indices (e.g., field_1_*), insert after field_0_*\n      const match = col.match(/^(.+?)_(\\d+)(_.*)?$/)\n      if (match) {\n        const [, basePath, index, suffix] = match\n        if (basePath && index) {\n          const prevIndex = parseInt(index, 10) - 1\n          const prevCol = `${basePath}_${prevIndex}${suffix ?? ''}`\n          const prevIdx = result.indexOf(prevCol)\n          if (prevIdx !== -1) {\n            // Insert after the previous index column\n            result.splice(prevIdx + 1, 0, col)\n            schemaSet.add(col)\n            continue\n          }\n        }\n      }\n      // Otherwise append at the end (before timestamps)\n      const createdAtIdx = result.indexOf('createdAt')\n      if (createdAtIdx !== -1) {\n        result.splice(createdAtIdx, 0, col)\n      } else {\n        result.push(col)\n      }\n      schemaSet.add(col)\n    }\n  }\n\n  return result\n}\n\n/**\n * Filters schema columns to only include those matching user-selected fields.\n * Preserves the order specified by the user in selectedFields.\n * Handles nested field selection (e.g., 'group.value' includes 'group_value' and 'group_value_*')\n */\nfunction filterToSelectedFields(columns: string[], selectedFields: string[]): string[] {\n  const result: string[] = []\n  const columnsSet = new Set(columns)\n\n  // Convert selected fields to underscore notation patterns\n  const patterns = selectedFields.map((field) => {\n    const underscored = field.replace(/\\./g, '_')\n    return {\n      exact: underscored,\n      original: field,\n      prefix: `${underscored}_`,\n    }\n  })\n\n  // Iterate through user-specified fields in order to preserve their ordering\n  for (const pattern of patterns) {\n    // First add the exact match if it exists\n    if (columnsSet.has(pattern.exact)) {\n      result.push(pattern.exact)\n    }\n\n    // Then add any columns with the prefix (nested fields)\n    for (const column of columns) {\n      if (column !== pattern.exact && column.startsWith(pattern.prefix)) {\n        if (!result.includes(column)) {\n          result.push(column)\n        }\n      }\n    }\n  }\n\n  return result\n}\n"],"names":["getFlattenedFieldKeys","getSchemaColumns","collectionConfig","disabledFields","fields","selectedFields","locale","localeCodes","hasVersions","Boolean","versions","expandLocales","length","schemaColumns","flattenedFields","systemFields","filterToSelectedFields","disabledSet","Set","path","add","replace","filter","col","disabled","startsWith","orderedColumns","includes","push","excludeFromMiddle","has","mergeColumns","dataColumns","result","schemaSet","match","basePath","index","suffix","prevIndex","parseInt","prevCol","prevIdx","indexOf","splice","createdAtIdx","columns","columnsSet","patterns","map","field","underscored","exact","original","prefix","pattern","column"],"mappings":"AAEA,SAASA,qBAAqB,QAAQ,6BAA4B;AAyBlE;;;;;;;;;;;CAWC,GACD,OAAO,MAAMC,mBAAmB,CAAC,EAC/BC,gBAAgB,EAChBC,iBAAiB,EAAE,EACnBC,QAAQC,cAAc,EACtBC,MAAM,EACNC,WAAW,EACU;IACrB,MAAMC,cAAcC,QAAQP,iBAAiBQ,QAAQ;IAErD,wCAAwC;IACxC,MAAMC,gBAAgBL,WAAW,SAASC,eAAeA,YAAYK,MAAM,GAAG;IAE9E,8FAA8F;IAC9F,IAAIC,gBAAgBb,sBAClBE,iBAAiBY,eAAe,EAChC,IACAH,gBAAgB;QAAEJ;IAAY,IAAI,CAAC;IAGrC,mDAAmD;IACnD,MAAMQ,eAAe;QAAC;QAAM;QAAa;KAAY;IACrDF,gBAAgB;WAAIE;WAAiBF;KAAc;IAEnD,8CAA8C;IAC9C,IAAIR,kBAAkBA,eAAeO,MAAM,GAAG,GAAG;QAC/CC,gBAAgBG,uBAAuBH,eAAeR;IACxD;IAEA,yBAAyB;IACzB,IAAIF,eAAeS,MAAM,GAAG,GAAG;QAC7B,MAAMK,cAAc,IAAIC;QACxB,KAAK,MAAMC,QAAQhB,eAAgB;YACjC,oDAAoD;YACpDc,YAAYG,GAAG,CAACD,KAAKE,OAAO,CAAC,OAAO;QACtC;QACAR,gBAAgBA,cAAcS,MAAM,CAAC,CAACC;YACpC,4CAA4C;YAC5C,KAAK,MAAMC,YAAYP,YAAa;gBAClC,IAAIM,QAAQC,YAAYD,IAAIE,UAAU,CAAC,GAAGD,SAAS,CAAC,CAAC,GAAG;oBACtD,OAAO;gBACT;YACF;YACA,OAAO;QACT;IACF;IAEA,kEAAkE;IAClE,6EAA6E;IAC7E,IAAInB,kBAAkBA,eAAeO,MAAM,GAAG,GAAG;QAC/C,OAAOC;IACT;IAEA,0EAA0E;IAC1E,MAAMa,iBAA2B,EAAE;IAEnC,qBAAqB;IACrB,IAAIb,cAAcc,QAAQ,CAAC,OAAO;QAChCD,eAAeE,IAAI,CAAC;IACtB;IAEA,4CAA4C;IAC5C,IAAIpB,aAAa;QACfkB,eAAeE,IAAI,CAAC;IACtB;IAEA,yDAAyD;IACzD,MAAMC,oBAAoB,IAAIX,IAAI;QAAC;QAAW;QAAa;QAAM;KAAY;IAC7E,KAAK,MAAMK,OAAOV,cAAe;QAC/B,IAAI,CAACgB,kBAAkBC,GAAG,CAACP,MAAM;YAC/BG,eAAeE,IAAI,CAACL;QACtB;IACF;IAEA,2BAA2B;IAC3B,IAAIV,cAAcc,QAAQ,CAAC,cAAc;QACvCD,eAAeE,IAAI,CAAC;IACtB;IACA,IAAIf,cAAcc,QAAQ,CAAC,cAAc;QACvCD,eAAeE,IAAI,CAAC;IACtB;IAEA,OAAOF;AACT,EAAC;AAED;;;;CAIC,GACD,OAAO,MAAMK,eAAe,CAAClB,eAAyBmB;IACpD,MAAMC,SAAS;WAAIpB;KAAc;IACjC,MAAMqB,YAAY,IAAIhB,IAAIL;IAE1B,mFAAmF;IACnF,KAAK,MAAMU,OAAOS,YAAa;QAC7B,IAAI,CAACE,UAAUJ,GAAG,CAACP,MAAM;YACvB,+CAA+C;YAC/C,8DAA8D;YAC9D,MAAMY,QAAQZ,IAAIY,KAAK,CAAC;YACxB,IAAIA,OAAO;gBACT,MAAM,GAAGC,UAAUC,OAAOC,OAAO,GAAGH;gBACpC,IAAIC,YAAYC,OAAO;oBACrB,MAAME,YAAYC,SAASH,OAAO,MAAM;oBACxC,MAAMI,UAAU,GAAGL,SAAS,CAAC,EAAEG,YAAYD,UAAU,IAAI;oBACzD,MAAMI,UAAUT,OAAOU,OAAO,CAACF;oBAC/B,IAAIC,YAAY,CAAC,GAAG;wBAClB,yCAAyC;wBACzCT,OAAOW,MAAM,CAACF,UAAU,GAAG,GAAGnB;wBAC9BW,UAAUd,GAAG,CAACG;wBACd;oBACF;gBACF;YACF;YACA,kDAAkD;YAClD,MAAMsB,eAAeZ,OAAOU,OAAO,CAAC;YACpC,IAAIE,iBAAiB,CAAC,GAAG;gBACvBZ,OAAOW,MAAM,CAACC,cAAc,GAAGtB;YACjC,OAAO;gBACLU,OAAOL,IAAI,CAACL;YACd;YACAW,UAAUd,GAAG,CAACG;QAChB;IACF;IAEA,OAAOU;AACT,EAAC;AAED;;;;CAIC,GACD,SAASjB,uBAAuB8B,OAAiB,EAAEzC,cAAwB;IACzE,MAAM4B,SAAmB,EAAE;IAC3B,MAAMc,aAAa,IAAI7B,IAAI4B;IAE3B,0DAA0D;IAC1D,MAAME,WAAW3C,eAAe4C,GAAG,CAAC,CAACC;QACnC,MAAMC,cAAcD,MAAM7B,OAAO,CAAC,OAAO;QACzC,OAAO;YACL+B,OAAOD;YACPE,UAAUH;YACVI,QAAQ,GAAGH,YAAY,CAAC,CAAC;QAC3B;IACF;IAEA,4EAA4E;IAC5E,KAAK,MAAMI,WAAWP,SAAU;QAC9B,yCAAyC;QACzC,IAAID,WAAWjB,GAAG,CAACyB,QAAQH,KAAK,GAAG;YACjCnB,OAAOL,IAAI,CAAC2B,QAAQH,KAAK;QAC3B;QAEA,uDAAuD;QACvD,KAAK,MAAMI,UAAUV,QAAS;YAC5B,IAAIU,WAAWD,QAAQH,KAAK,IAAII,OAAO/B,UAAU,CAAC8B,QAAQD,MAAM,GAAG;gBACjE,IAAI,CAACrB,OAAON,QAAQ,CAAC6B,SAAS;oBAC5BvB,OAAOL,IAAI,CAAC4B;gBACd;YACF;QACF;IACF;IAEA,OAAOvB;AACT"}

package/dist/utilities/getSelect.d.ts

@@ -0,0 +1,11 @@
+import type { SelectIncludeType } from 'payload';
+/**
+ * Takes an input of array of string paths in dot notation and returns a select object.
+ * Used for both export and import to build Payload's select query format.
+ *
+ * @example
+ * getSelect(['id', 'title', 'group.value', 'createdAt', 'updatedAt'])
+ * // Returns: { id: true, title: true, group: { value: true }, createdAt: true, updatedAt: true }
+ */
+export declare const getSelect: (fields: string[]) => SelectIncludeType;
+//# sourceMappingURL=getSelect.d.ts.map

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

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

package/dist/{export → utilities}/getSelect.js

@@ -1,6 +1,10 @@
 /**
- * Takes an input of array of string paths in dot notation and returns a select object
- * example args: ['id', 'title', 'group.value', 'createdAt', 'updatedAt']
+ * Takes an input of array of string paths in dot notation and returns a select object.
+ * Used for both export and import to build Payload's select query format.
+ *
+ * @example
+ * getSelect(['id', 'title', 'group.value', 'createdAt', 'updatedAt'])
+ * // Returns: { id: true, title: true, group: { value: true }, createdAt: true, updatedAt: true }
  */ export const getSelect = (fields)=>{
     const select = {};
     fields.forEach((field)=>{

package/dist/utilities/getSelect.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/getSelect.ts"],"sourcesContent":["import type { SelectIncludeType } from 'payload'\n\n/**\n * Takes an input of array of string paths in dot notation and returns a select object.\n * Used for both export and import to build Payload's select query format.\n *\n * @example\n * getSelect(['id', 'title', 'group.value', 'createdAt', 'updatedAt'])\n * // Returns: { id: true, title: true, group: { value: true }, createdAt: true, updatedAt: true }\n */\nexport const getSelect = (fields: string[]): SelectIncludeType => {\n  const select: SelectIncludeType = {}\n\n  fields.forEach((field) => {\n    const segments = field.split('.')\n    let selectRef = select\n\n    segments.forEach((segment, i) => {\n      if (i === segments.length - 1) {\n        selectRef[segment] = true\n      } else {\n        if (!selectRef[segment]) {\n          selectRef[segment] = {}\n        }\n        selectRef = selectRef[segment] as SelectIncludeType\n      }\n    })\n  })\n\n  return select\n}\n"],"names":["getSelect","fields","select","forEach","field","segments","split","selectRef","segment","i","length"],"mappings":"AAEA;;;;;;;CAOC,GACD,OAAO,MAAMA,YAAY,CAACC;IACxB,MAAMC,SAA4B,CAAC;IAEnCD,OAAOE,OAAO,CAAC,CAACC;QACd,MAAMC,WAAWD,MAAME,KAAK,CAAC;QAC7B,IAAIC,YAAYL;QAEhBG,SAASF,OAAO,CAAC,CAACK,SAASC;YACzB,IAAIA,MAAMJ,SAASK,MAAM,GAAG,GAAG;gBAC7BH,SAAS,CAACC,QAAQ,GAAG;YACvB,OAAO;gBACL,IAAI,CAACD,SAAS,CAACC,QAAQ,EAAE;oBACvBD,SAAS,CAACC,QAAQ,GAAG,CAAC;gBACxB;gBACAD,YAAYA,SAAS,CAACC,QAAQ;YAChC;QACF;IACF;IAEA,OAAON;AACT,EAAC"}

package/dist/utilities/parseCSV.d.ts

@@ -0,0 +1,11 @@
+import type { PayloadRequest } from 'payload';
+export type ParseCSVArgs = {
+    data: Buffer | string;
+    req: PayloadRequest;
+};
+/**
+ * Parses CSV data into an array of record objects.
+ * Handles type coercion for booleans, numbers, and null values.
+ */
+export declare const parseCSV: ({ data, req }: ParseCSVArgs) => Promise<Record<string, unknown>[]>;
+//# sourceMappingURL=parseCSV.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parseCSV.d.ts","sourceRoot":"","sources":["../../src/utilities/parseCSV.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAI7C,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IACrB,GAAG,EAAE,cAAc,CAAA;CACpB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,kBAAyB,YAAY,KAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAmE7F,CAAA"}

package/dist/utilities/parseCSV.js

@@ -0,0 +1,67 @@
+import { parse } from 'csv-parse';
+/**
+ * Parses CSV data into an array of record objects.
+ * Handles type coercion for booleans, numbers, and null values.
+ */ export const parseCSV = async ({ data, req })=>{
+    return new Promise((resolve, reject)=>{
+        const records = [];
+        const parser = parse({
+            cast: (value, _context)=>{
+                // Empty strings should be undefined (field not present in update)
+                // This preserves existing data instead of overwriting with null
+                if (value === '') {
+                    return undefined;
+                }
+                // Handle booleans
+                if (value === 'true') {
+                    return true;
+                }
+                if (value === 'false') {
+                    return false;
+                }
+                // Handle explicit null - user must type "null" to set field to null
+                if (value === 'null' || value === 'NULL') {
+                    return null;
+                }
+                // Don't auto-convert to numbers if the value contains a comma
+                // This allows hasMany fields to use comma-separated values
+                if (value.includes(',')) {
+                    return value // Keep as string for comma-separated values
+                    ;
+                }
+                // Handle numbers (only after checking for commas)
+                if (!isNaN(Number(value)) && value !== '') {
+                    const num = Number(value);
+                    if (String(num) === value || value.includes('.')) {
+                        return num;
+                    }
+                }
+                // Return as string
+                return value;
+            },
+            columns: true,
+            skip_empty_lines: true,
+            trim: true
+        });
+        parser.on('readable', ()=>{
+            let record;
+            while((record = parser.read()) !== null){
+                records.push(record);
+            }
+        });
+        parser.on('error', (err)=>{
+            req.payload.logger.error({
+                err,
+                msg: 'Error parsing CSV'
+            });
+            reject(err);
+        });
+        parser.on('end', ()=>{
+            resolve(records);
+        });
+        parser.write(data);
+        parser.end();
+    });
+};
+
+//# sourceMappingURL=parseCSV.js.map

package/dist/utilities/parseCSV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/parseCSV.ts"],"sourcesContent":["import type { PayloadRequest } from 'payload'\n\nimport { parse } from 'csv-parse'\n\nexport type ParseCSVArgs = {\n  data: Buffer | string\n  req: PayloadRequest\n}\n\n/**\n * Parses CSV data into an array of record objects.\n * Handles type coercion for booleans, numbers, and null values.\n */\nexport const parseCSV = async ({ data, req }: ParseCSVArgs): Promise<Record<string, unknown>[]> => {\n  return new Promise((resolve, reject) => {\n    const records: Record<string, unknown>[] = []\n\n    const parser = parse({\n      cast: (value, _context) => {\n        // Empty strings should be undefined (field not present in update)\n        // This preserves existing data instead of overwriting with null\n        if (value === '') {\n          return undefined\n        }\n\n        // Handle booleans\n        if (value === 'true') {\n          return true\n        }\n        if (value === 'false') {\n          return false\n        }\n\n        // Handle explicit null - user must type \"null\" to set field to null\n        if (value === 'null' || value === 'NULL') {\n          return null\n        }\n\n        // Don't auto-convert to numbers if the value contains a comma\n        // This allows hasMany fields to use comma-separated values\n        if (value.includes(',')) {\n          return value // Keep as string for comma-separated values\n        }\n\n        // Handle numbers (only after checking for commas)\n        if (!isNaN(Number(value)) && value !== '') {\n          const num = Number(value)\n\n          if (String(num) === value || value.includes('.')) {\n            return num\n          }\n        }\n\n        // Return as string\n        return value\n      },\n      columns: true,\n      skip_empty_lines: true,\n      trim: true,\n    })\n\n    parser.on('readable', () => {\n      let record\n      while ((record = parser.read()) !== null) {\n        records.push(record)\n      }\n    })\n\n    parser.on('error', (err) => {\n      req.payload.logger.error({ err, msg: 'Error parsing CSV' })\n      reject(err)\n    })\n\n    parser.on('end', () => {\n      resolve(records)\n    })\n\n    parser.write(data)\n    parser.end()\n  })\n}\n"],"names":["parse","parseCSV","data","req","Promise","resolve","reject","records","parser","cast","value","_context","undefined","includes","isNaN","Number","num","String","columns","skip_empty_lines","trim","on","record","read","push","err","payload","logger","error","msg","write","end"],"mappings":"AAEA,SAASA,KAAK,QAAQ,YAAW;AAOjC;;;CAGC,GACD,OAAO,MAAMC,WAAW,OAAO,EAAEC,IAAI,EAAEC,GAAG,EAAgB;IACxD,OAAO,IAAIC,QAAQ,CAACC,SAASC;QAC3B,MAAMC,UAAqC,EAAE;QAE7C,MAAMC,SAASR,MAAM;YACnBS,MAAM,CAACC,OAAOC;gBACZ,kEAAkE;gBAClE,gEAAgE;gBAChE,IAAID,UAAU,IAAI;oBAChB,OAAOE;gBACT;gBAEA,kBAAkB;gBAClB,IAAIF,UAAU,QAAQ;oBACpB,OAAO;gBACT;gBACA,IAAIA,UAAU,SAAS;oBACrB,OAAO;gBACT;gBAEA,oEAAoE;gBACpE,IAAIA,UAAU,UAAUA,UAAU,QAAQ;oBACxC,OAAO;gBACT;gBAEA,8DAA8D;gBAC9D,2DAA2D;gBAC3D,IAAIA,MAAMG,QAAQ,CAAC,MAAM;oBACvB,OAAOH,MAAM,4CAA4C;;gBAC3D;gBAEA,kDAAkD;gBAClD,IAAI,CAACI,MAAMC,OAAOL,WAAWA,UAAU,IAAI;oBACzC,MAAMM,MAAMD,OAAOL;oBAEnB,IAAIO,OAAOD,SAASN,SAASA,MAAMG,QAAQ,CAAC,MAAM;wBAChD,OAAOG;oBACT;gBACF;gBAEA,mBAAmB;gBACnB,OAAON;YACT;YACAQ,SAAS;YACTC,kBAAkB;YAClBC,MAAM;QACR;QAEAZ,OAAOa,EAAE,CAAC,YAAY;YACpB,IAAIC;YACJ,MAAO,AAACA,CAAAA,SAASd,OAAOe,IAAI,EAAC,MAAO,KAAM;gBACxChB,QAAQiB,IAAI,CAACF;YACf;QACF;QAEAd,OAAOa,EAAE,CAAC,SAAS,CAACI;YAClBtB,IAAIuB,OAAO,CAACC,MAAM,CAACC,KAAK,CAAC;gBAAEH;gBAAKI,KAAK;YAAoB;YACzDvB,OAAOmB;QACT;QAEAjB,OAAOa,EAAE,CAAC,OAAO;YACfhB,QAAQE;QACV;QAEAC,OAAOsB,KAAK,CAAC5B;QACbM,OAAOuB,GAAG;IACZ;AACF,EAAC"}