@payloadcms/plugin-import-export 4.0.0-internal.38b7f1d → 4.0.0-internal.3b50481

package/dist/utilities/getImportFieldFunctions.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/getImportFieldFunctions.ts"],"sourcesContent":["import type { FlattenedField } from 'payload'\n\nimport type { FieldBeforeImportHook, ImportFieldHookEntry } from '../types.js'\n\nimport { registerFieldHooks } from './flattenedFields.js'\n\ntype Args = {\n  fields: FlattenedField[]\n}\n\n/**\n * Builds a map from logical field path (e.g. `content_textBlock_body`) to\n * the import hook entry. Paths include block slugs but never array indices.\n */\nexport const getImportFieldFunctions = ({ fields }: Args): Record<string, ImportFieldHookEntry> => {\n  const result: Record<string, ImportFieldHookEntry> = {}\n  registerFieldHooks(fields, '', result, registerImportHandler)\n  return result\n}\n\nconst registerImportHandler = (\n  field: FlattenedField,\n  fullKey: string,\n  result: Record<string, ImportFieldHookEntry>,\n): void => {\n  const beforeImport = field.custom?.['plugin-import-export']?.hooks?.beforeImport\n\n  const fromCSV = field.custom?.['plugin-import-export']?.fromCSV\n\n  if (typeof beforeImport === 'function') {\n    result[fullKey] = { type: 'beforeImport', fn: beforeImport }\n    return\n  }\n\n  if (typeof fromCSV === 'function') {\n    result[fullKey] = { type: 'fromCSV', fn: fromCSV }\n    return\n  }\n\n  const registerBeforeImport = (fn: FieldBeforeImportHook) => {\n    result[fullKey] = { type: 'beforeImport', fn }\n  }\n\n  if (field.type === 'relationship' || field.type === 'upload') {\n    if (field.hasMany !== true) {\n      if (!Array.isArray(field.relationTo)) {\n        registerBeforeImport(({ value }) => value)\n      }\n    } else if (!Array.isArray(field.relationTo)) {\n      registerBeforeImport(({ value }) => value)\n    }\n    return\n  }\n\n  if (field.type === 'number') {\n    if (field.hasMany) {\n      registerBeforeImport(({ value }) => value)\n      return\n    }\n    registerBeforeImport(({ value }) => {\n      if (isEmptyImportValue(value)) {\n        return undefined\n      }\n      if (typeof value === 'number') {\n        return value\n      }\n      if (typeof value === 'string') {\n        const parsed = parseFloat(value)\n        return isNaN(parsed) ? undefined : parsed\n      }\n      return value\n    })\n    return\n  }\n\n  if (field.type === 'checkbox') {\n    registerBeforeImport(({ value }) => {\n      if (isEmptyImportValue(value)) {\n        return undefined\n      }\n      if (typeof value === 'boolean') {\n        return value\n      }\n      if (typeof value === 'string') {\n        return value.toLowerCase() === 'true' || value === '1'\n      }\n      return Boolean(value)\n    })\n    return\n  }\n\n  if (field.type === 'date') {\n    registerBeforeImport(({ value }) => {\n      if (isEmptyImportValue(value)) {\n        return undefined\n      }\n      if (typeof value === 'string' && !isNaN(Date.parse(value))) {\n        return value\n      }\n      try {\n        const date = new Date(value as string)\n        return isNaN(date.getTime()) ? value : date.toISOString()\n      } catch {\n        return value\n      }\n    })\n    return\n  }\n\n  if (field.type === 'json' || field.type === 'richText') {\n    registerBeforeImport(({ value }) => {\n      if (isEmptyImportValue(value)) {\n        return undefined\n      }\n      if (typeof value === 'object') {\n        return value\n      }\n      if (typeof value === 'string') {\n        try {\n          return JSON.parse(value)\n        } catch {\n          return value\n        }\n      }\n      return value\n    })\n  }\n}\n\nconst isEmptyImportValue = (value: unknown): boolean =>\n  value === '' || value === null || value === undefined\n"],"names":["registerFieldHooks","getImportFieldFunctions","fields","result","registerImportHandler","field","fullKey","beforeImport","custom","hooks","fromCSV","type","fn","registerBeforeImport","hasMany","Array","isArray","relationTo","value","isEmptyImportValue","undefined","parsed","parseFloat","isNaN","toLowerCase","Boolean","Date","parse","date","getTime","toISOString","JSON"],"mappings":"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"}
+{"version":3,"sources":["../../src/utilities/getImportFieldFunctions.ts"],"sourcesContent":["import type { FlattenedField } from 'payload'\n\nimport type { FieldBeforeImportHook, ImportFieldHookEntry } from '../types.js'\n\nimport { registerFieldHooks } from './flattenedFields.js'\n\ntype Args = {\n  fields: FlattenedField[]\n}\n\n/**\n * Builds a map from logical field path (e.g. `content_textBlock_body`) to\n * the import hook entry. Paths include block slugs but never array indices.\n */\nexport const getImportFieldFunctions = ({ fields }: Args): Record<string, ImportFieldHookEntry> => {\n  const result: Record<string, ImportFieldHookEntry> = {}\n  registerFieldHooks(fields, '', result, registerImportHandler)\n  return result\n}\n\nconst registerImportHandler = (\n  field: FlattenedField,\n  fullKey: string,\n  result: Record<string, ImportFieldHookEntry>,\n): void => {\n  const beforeImport = field.custom?.['plugin-import-export']?.hooks?.beforeImport\n\n  if (typeof beforeImport === 'function') {\n    result[fullKey] = { type: 'beforeImport', fn: beforeImport }\n    return\n  }\n\n  const registerBeforeImport = (fn: FieldBeforeImportHook) => {\n    result[fullKey] = { type: 'beforeImport', fn }\n  }\n\n  if (field.type === 'relationship' || field.type === 'upload') {\n    if (field.hasMany !== true) {\n      if (!Array.isArray(field.relationTo)) {\n        registerBeforeImport(({ value }) => value)\n      }\n    } else if (!Array.isArray(field.relationTo)) {\n      registerBeforeImport(({ value }) => value)\n    }\n    return\n  }\n\n  if (field.type === 'number') {\n    if (field.hasMany) {\n      registerBeforeImport(({ value }) => value)\n      return\n    }\n    registerBeforeImport(({ value }) => {\n      if (isEmptyImportValue(value)) {\n        return undefined\n      }\n      if (typeof value === 'number') {\n        return value\n      }\n      if (typeof value === 'string') {\n        const parsed = parseFloat(value)\n        return isNaN(parsed) ? undefined : parsed\n      }\n      return value\n    })\n    return\n  }\n\n  if (field.type === 'checkbox') {\n    registerBeforeImport(({ value }) => {\n      if (isEmptyImportValue(value)) {\n        return undefined\n      }\n      if (typeof value === 'boolean') {\n        return value\n      }\n      if (typeof value === 'string') {\n        return value.toLowerCase() === 'true' || value === '1'\n      }\n      return Boolean(value)\n    })\n    return\n  }\n\n  if (field.type === 'date') {\n    registerBeforeImport(({ value }) => {\n      if (isEmptyImportValue(value)) {\n        return undefined\n      }\n      if (typeof value === 'string' && !isNaN(Date.parse(value))) {\n        return value\n      }\n      try {\n        const date = new Date(value as string)\n        return isNaN(date.getTime()) ? value : date.toISOString()\n      } catch {\n        return value\n      }\n    })\n    return\n  }\n\n  if (field.type === 'json' || field.type === 'richText') {\n    registerBeforeImport(({ value }) => {\n      if (isEmptyImportValue(value)) {\n        return undefined\n      }\n      if (typeof value === 'object') {\n        return value\n      }\n      if (typeof value === 'string') {\n        try {\n          return JSON.parse(value)\n        } catch {\n          return value\n        }\n      }\n      return value\n    })\n  }\n}\n\nconst isEmptyImportValue = (value: unknown): boolean =>\n  value === '' || value === null || value === undefined\n"],"names":["registerFieldHooks","getImportFieldFunctions","fields","result","registerImportHandler","field","fullKey","beforeImport","custom","hooks","type","fn","registerBeforeImport","hasMany","Array","isArray","relationTo","value","isEmptyImportValue","undefined","parsed","parseFloat","isNaN","toLowerCase","Boolean","Date","parse","date","getTime","toISOString","JSON"],"mappings":"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"}

package/dist/utilities/getSchemaColumns.d.ts

@@ -37,7 +37,7 @@ export declare const getSchemaColumns: ({ collectionConfig, disabledFields, fiel
 /**
  * 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, derived columns from toCSV).
+ * columns (e.g., array indices beyond 0, dynamic fields, derived columns from beforeExport hooks).
  */
 export declare const mergeColumns: (schemaColumns: string[], dataColumns: string[]) => string[];
 /**

package/dist/utilities/getSchemaColumns.js

@@ -45,7 +45,7 @@ import { getFlattenedFieldKeys } from './getFlattenedFieldKeys.js';
 /**
  * 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, derived columns from toCSV).
+ * columns (e.g., array indices beyond 0, dynamic fields, derived columns from beforeExport hooks).
  */ export const mergeColumns = (schemaColumns, dataColumns)=>{
     const result = [
         ...schemaColumns
@@ -101,7 +101,7 @@ import { getFlattenedFieldKeys } from './getFlattenedFieldKeys.js';
             }
         }
     }
-    // Remove schema columns that were fully replaced by toCSV-derived columns (e.g. "user" → "user_id", "user_email")
+    // Remove schema columns that were fully replaced by beforeExport-derived columns (e.g. "user" → "user_id", "user_email")
     for (const [schemaCol, derivedCols] of insertedDerived){
         if (!dataColumns.includes(schemaCol) && derivedCols.length > 0) {
             const idx = result.indexOf(schemaCol);

package/dist/utilities/getSchemaColumns.js.map

@@ -1 +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 expandLocales = locale === 'all' && localeCodes && localeCodes.length > 0\n\n  let schemaColumns = getFlattenedFieldKeys(\n    collectionConfig.flattenedFields,\n    '',\n    expandLocales ? { localeCodes } : {},\n  )\n\n  // Add id if not present in schema\n  const hasIdField = schemaColumns.includes('id')\n  if (!hasIdField) {\n    schemaColumns = ['id', ...schemaColumns]\n  }\n\n  if (selectedFields && selectedFields.length > 0) {\n    schemaColumns = filterToSelectedFields(schemaColumns, selectedFields)\n  }\n\n  if (disabledFields.length > 0) {\n    const disabledSet = new Set<string>()\n    for (const path of disabledFields) {\n      disabledSet.add(path.replace(/\\./g, '_'))\n    }\n    schemaColumns = schemaColumns.filter((col) => {\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  return schemaColumns\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, derived columns from toCSV).\n */\nexport const mergeColumns = (schemaColumns: string[], dataColumns: string[]): string[] => {\n  const result = [...schemaColumns]\n  const schemaSet = new Set(schemaColumns)\n  const insertedDerived = new Map<string, string[]>()\n\n  for (const col of dataColumns) {\n    if (!schemaSet.has(col)) {\n      let inserted = false\n\n      for (const schemaCol of schemaColumns) {\n        if (col.startsWith(`${schemaCol}_`)) {\n          const suffix = col.slice(schemaCol.length + 1)\n          // Skip if suffix starts with a digit (array index pattern like field_0_*)\n          if (!/^\\d/.test(suffix)) {\n            const baseIdx = result.indexOf(schemaCol)\n            if (baseIdx !== -1) {\n              const derivedList = insertedDerived.get(schemaCol) || []\n              const insertIdx = baseIdx + 1 + derivedList.length\n              result.splice(insertIdx, 0, col)\n              derivedList.push(col)\n              insertedDerived.set(schemaCol, derivedList)\n              schemaSet.add(col)\n              inserted = true\n              break\n            }\n          }\n        }\n      }\n\n      if (!inserted) {\n        // Check 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\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\n  // Remove schema columns that were fully replaced by toCSV-derived columns (e.g. \"user\" → \"user_id\", \"user_email\")\n  for (const [schemaCol, derivedCols] of insertedDerived) {\n    if (!dataColumns.includes(schemaCol) && derivedCols.length > 0) {\n      const idx = result.indexOf(schemaCol)\n      if (idx !== -1) {\n        result.splice(idx, 1)\n      }\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 *\n * Container fields (groups, arrays, blocks) don't produce their own column, so we prefix-expand\n * to find their children (e.g., 'group' → 'group_name', 'group_age').\n * Leaf fields (date, text, select) produce an exact column, so we only match exactly to avoid\n * including siblings with similar prefixes (e.g., 'dateWithTimezone' won't pull 'dateWithTimezone_tz').\n */\nexport function 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    const hasExactColumn = columnsSet.has(pattern.exact)\n\n    if (hasExactColumn && !result.includes(pattern.exact)) {\n      result.push(pattern.exact)\n    }\n\n    // Only prefix-expand if no exact column match exists (containers need expansion, leaves don't)\n    if (!hasExactColumn) {\n      for (const column of columns) {\n        if (column.startsWith(pattern.prefix)) {\n          if (!result.includes(column)) {\n            result.push(column)\n          }\n        }\n      }\n    }\n  }\n\n  return result\n}\n"],"names":["getFlattenedFieldKeys","getSchemaColumns","collectionConfig","disabledFields","fields","selectedFields","locale","localeCodes","expandLocales","length","schemaColumns","flattenedFields","hasIdField","includes","filterToSelectedFields","disabledSet","Set","path","add","replace","filter","col","disabled","startsWith","mergeColumns","dataColumns","result","schemaSet","insertedDerived","Map","has","inserted","schemaCol","suffix","slice","test","baseIdx","indexOf","derivedList","get","insertIdx","splice","push","set","match","basePath","index","prevIndex","parseInt","prevCol","prevIdx","createdAtIdx","derivedCols","idx","columns","columnsSet","patterns","map","field","underscored","exact","original","prefix","pattern","hasExactColumn","column"],"mappings":"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"}
+{"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 expandLocales = locale === 'all' && localeCodes && localeCodes.length > 0\n\n  let schemaColumns = getFlattenedFieldKeys(\n    collectionConfig.flattenedFields,\n    '',\n    expandLocales ? { localeCodes } : {},\n  )\n\n  // Add id if not present in schema\n  const hasIdField = schemaColumns.includes('id')\n  if (!hasIdField) {\n    schemaColumns = ['id', ...schemaColumns]\n  }\n\n  if (selectedFields && selectedFields.length > 0) {\n    schemaColumns = filterToSelectedFields(schemaColumns, selectedFields)\n  }\n\n  if (disabledFields.length > 0) {\n    const disabledSet = new Set<string>()\n    for (const path of disabledFields) {\n      disabledSet.add(path.replace(/\\./g, '_'))\n    }\n    schemaColumns = schemaColumns.filter((col) => {\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  return schemaColumns\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, derived columns from beforeExport hooks).\n */\nexport const mergeColumns = (schemaColumns: string[], dataColumns: string[]): string[] => {\n  const result = [...schemaColumns]\n  const schemaSet = new Set(schemaColumns)\n  const insertedDerived = new Map<string, string[]>()\n\n  for (const col of dataColumns) {\n    if (!schemaSet.has(col)) {\n      let inserted = false\n\n      for (const schemaCol of schemaColumns) {\n        if (col.startsWith(`${schemaCol}_`)) {\n          const suffix = col.slice(schemaCol.length + 1)\n          // Skip if suffix starts with a digit (array index pattern like field_0_*)\n          if (!/^\\d/.test(suffix)) {\n            const baseIdx = result.indexOf(schemaCol)\n            if (baseIdx !== -1) {\n              const derivedList = insertedDerived.get(schemaCol) || []\n              const insertIdx = baseIdx + 1 + derivedList.length\n              result.splice(insertIdx, 0, col)\n              derivedList.push(col)\n              insertedDerived.set(schemaCol, derivedList)\n              schemaSet.add(col)\n              inserted = true\n              break\n            }\n          }\n        }\n      }\n\n      if (!inserted) {\n        // Check 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\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\n  // Remove schema columns that were fully replaced by beforeExport-derived columns (e.g. \"user\" → \"user_id\", \"user_email\")\n  for (const [schemaCol, derivedCols] of insertedDerived) {\n    if (!dataColumns.includes(schemaCol) && derivedCols.length > 0) {\n      const idx = result.indexOf(schemaCol)\n      if (idx !== -1) {\n        result.splice(idx, 1)\n      }\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 *\n * Container fields (groups, arrays, blocks) don't produce their own column, so we prefix-expand\n * to find their children (e.g., 'group' → 'group_name', 'group_age').\n * Leaf fields (date, text, select) produce an exact column, so we only match exactly to avoid\n * including siblings with similar prefixes (e.g., 'dateWithTimezone' won't pull 'dateWithTimezone_tz').\n */\nexport function 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    const hasExactColumn = columnsSet.has(pattern.exact)\n\n    if (hasExactColumn && !result.includes(pattern.exact)) {\n      result.push(pattern.exact)\n    }\n\n    // Only prefix-expand if no exact column match exists (containers need expansion, leaves don't)\n    if (!hasExactColumn) {\n      for (const column of columns) {\n        if (column.startsWith(pattern.prefix)) {\n          if (!result.includes(column)) {\n            result.push(column)\n          }\n        }\n      }\n    }\n  }\n\n  return result\n}\n"],"names":["getFlattenedFieldKeys","getSchemaColumns","collectionConfig","disabledFields","fields","selectedFields","locale","localeCodes","expandLocales","length","schemaColumns","flattenedFields","hasIdField","includes","filterToSelectedFields","disabledSet","Set","path","add","replace","filter","col","disabled","startsWith","mergeColumns","dataColumns","result","schemaSet","insertedDerived","Map","has","inserted","schemaCol","suffix","slice","test","baseIdx","indexOf","derivedList","get","insertIdx","splice","push","set","match","basePath","index","prevIndex","parseInt","prevCol","prevIdx","createdAtIdx","derivedCols","idx","columns","columnsSet","patterns","map","field","underscored","exact","original","prefix","pattern","hasExactColumn","column"],"mappings":"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"}

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

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

package/dist/utilities/getSelect.js

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

package/dist/utilities/getSelect.js.map

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

package/dist/utilities/getSubmittedFormValues.d.ts

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

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

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

package/dist/utilities/getSubmittedFormValues.js

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

package/dist/utilities/getSubmittedFormValues.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"processRichTextField.d.ts","sourceRoot":"","sources":["../../src/utilities/processRichTextField.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,UAAW,OAAO,KAAG,OA4CrD,CAAA"}
+{"version":3,"file":"processRichTextField.d.ts","sourceRoot":"","sources":["../../src/utilities/processRichTextField.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,UAAW,OAAO,KAAG,OAoDrD,CAAA"}

package/dist/utilities/processRichTextField.js

@@ -2,6 +2,13 @@
  * Process rich text fields to ensure proper data types for Lexical editor.
  * Lexical expects certain properties to be numbers, not strings.
  */ export const processRichTextField = (value)=>{
+    if (typeof value === 'string') {
+        try {
+            value = JSON.parse(value);
+        } catch  {
+            return value;
+        }
+    }
     if (!value || typeof value !== 'object') {
         return value;
     }

package/dist/utilities/processRichTextField.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/processRichTextField.ts"],"sourcesContent":["/**\n * Process rich text fields to ensure proper data types for Lexical editor.\n * Lexical expects certain properties to be numbers, not strings.\n */\nexport const processRichTextField = (value: unknown): unknown => {\n  if (!value || typeof value !== 'object') {\n    return value\n  }\n\n  // Properties that should be numbers in Lexical\n  const numericProperties = [\n    'detail',\n    'format',\n    'indent',\n    'version',\n    'value',\n    'start',\n    'textFormat',\n    'textStyle',\n  ]\n\n  const processNode = (node: unknown): unknown => {\n    if (!node || typeof node !== 'object') {\n      return node\n    }\n\n    // Process current node's properties\n    const processed: Record<string, unknown> = {}\n    for (const [key, val] of Object.entries(node as Record<string, unknown>)) {\n      if (numericProperties.includes(key) && typeof val === 'string') {\n        // Convert string numbers to actual numbers\n        const num = parseFloat(val)\n        processed[key] = isNaN(num) ? val : num\n      } else if (key === 'children' && Array.isArray(val)) {\n        // Recursively process children\n        processed[key] = val.map((child) => processNode(child))\n      } else if (typeof val === 'object' && val !== null) {\n        // Recursively process nested objects\n        processed[key] = processNode(val)\n      } else {\n        processed[key] = val\n      }\n    }\n\n    return processed\n  }\n\n  return processNode(value)\n}\n"],"names":["processRichTextField","value","numericProperties","processNode","node","processed","key","val","Object","entries","includes","num","parseFloat","isNaN","Array","isArray","map","child"],"mappings":"AAAA;;;CAGC,GACD,OAAO,MAAMA,uBAAuB,CAACC;IACnC,IAAI,CAACA,SAAS,OAAOA,UAAU,UAAU;QACvC,OAAOA;IACT;IAEA,+CAA+C;IAC/C,MAAMC,oBAAoB;QACxB;QACA;QACA;QACA;QACA;QACA;QACA;QACA;KACD;IAED,MAAMC,cAAc,CAACC;QACnB,IAAI,CAACA,QAAQ,OAAOA,SAAS,UAAU;YACrC,OAAOA;QACT;QAEA,oCAAoC;QACpC,MAAMC,YAAqC,CAAC;QAC5C,KAAK,MAAM,CAACC,KAAKC,IAAI,IAAIC,OAAOC,OAAO,CAACL,MAAkC;YACxE,IAAIF,kBAAkBQ,QAAQ,CAACJ,QAAQ,OAAOC,QAAQ,UAAU;gBAC9D,2CAA2C;gBAC3C,MAAMI,MAAMC,WAAWL;gBACvBF,SAAS,CAACC,IAAI,GAAGO,MAAMF,OAAOJ,MAAMI;YACtC,OAAO,IAAIL,QAAQ,cAAcQ,MAAMC,OAAO,CAACR,MAAM;gBACnD,+BAA+B;gBAC/BF,SAAS,CAACC,IAAI,GAAGC,IAAIS,GAAG,CAAC,CAACC,QAAUd,YAAYc;YAClD,OAAO,IAAI,OAAOV,QAAQ,YAAYA,QAAQ,MAAM;gBAClD,qCAAqC;gBACrCF,SAAS,CAACC,IAAI,GAAGH,YAAYI;YAC/B,OAAO;gBACLF,SAAS,CAACC,IAAI,GAAGC;YACnB;QACF;QAEA,OAAOF;IACT;IAEA,OAAOF,YAAYF;AACrB,EAAC"}
+{"version":3,"sources":["../../src/utilities/processRichTextField.ts"],"sourcesContent":["/**\n * Process rich text fields to ensure proper data types for Lexical editor.\n * Lexical expects certain properties to be numbers, not strings.\n */\nexport const processRichTextField = (value: unknown): unknown => {\n  if (typeof value === 'string') {\n    try {\n      value = JSON.parse(value)\n    } catch {\n      return value\n    }\n  }\n\n  if (!value || typeof value !== 'object') {\n    return value\n  }\n\n  // Properties that should be numbers in Lexical\n  const numericProperties = [\n    'detail',\n    'format',\n    'indent',\n    'version',\n    'value',\n    'start',\n    'textFormat',\n    'textStyle',\n  ]\n\n  const processNode = (node: unknown): unknown => {\n    if (!node || typeof node !== 'object') {\n      return node\n    }\n\n    // Process current node's properties\n    const processed: Record<string, unknown> = {}\n    for (const [key, val] of Object.entries(node as Record<string, unknown>)) {\n      if (numericProperties.includes(key) && typeof val === 'string') {\n        // Convert string numbers to actual numbers\n        const num = parseFloat(val)\n        processed[key] = isNaN(num) ? val : num\n      } else if (key === 'children' && Array.isArray(val)) {\n        // Recursively process children\n        processed[key] = val.map((child) => processNode(child))\n      } else if (typeof val === 'object' && val !== null) {\n        // Recursively process nested objects\n        processed[key] = processNode(val)\n      } else {\n        processed[key] = val\n      }\n    }\n\n    return processed\n  }\n\n  return processNode(value)\n}\n"],"names":["processRichTextField","value","JSON","parse","numericProperties","processNode","node","processed","key","val","Object","entries","includes","num","parseFloat","isNaN","Array","isArray","map","child"],"mappings":"AAAA;;;CAGC,GACD,OAAO,MAAMA,uBAAuB,CAACC;IACnC,IAAI,OAAOA,UAAU,UAAU;QAC7B,IAAI;YACFA,QAAQC,KAAKC,KAAK,CAACF;QACrB,EAAE,OAAM;YACN,OAAOA;QACT;IACF;IAEA,IAAI,CAACA,SAAS,OAAOA,UAAU,UAAU;QACvC,OAAOA;IACT;IAEA,+CAA+C;IAC/C,MAAMG,oBAAoB;QACxB;QACA;QACA;QACA;QACA;QACA;QACA;QACA;KACD;IAED,MAAMC,cAAc,CAACC;QACnB,IAAI,CAACA,QAAQ,OAAOA,SAAS,UAAU;YACrC,OAAOA;QACT;QAEA,oCAAoC;QACpC,MAAMC,YAAqC,CAAC;QAC5C,KAAK,MAAM,CAACC,KAAKC,IAAI,IAAIC,OAAOC,OAAO,CAACL,MAAkC;YACxE,IAAIF,kBAAkBQ,QAAQ,CAACJ,QAAQ,OAAOC,QAAQ,UAAU;gBAC9D,2CAA2C;gBAC3C,MAAMI,MAAMC,WAAWL;gBACvBF,SAAS,CAACC,IAAI,GAAGO,MAAMF,OAAOJ,MAAMI;YACtC,OAAO,IAAIL,QAAQ,cAAcQ,MAAMC,OAAO,CAACR,MAAM;gBACnD,+BAA+B;gBAC/BF,SAAS,CAACC,IAAI,GAAGC,IAAIS,GAAG,CAAC,CAACC,QAAUd,YAAYc;YAClD,OAAO,IAAI,OAAOV,QAAQ,YAAYA,QAAQ,MAAM;gBAClD,qCAAqC;gBACrCF,SAAS,CAACC,IAAI,GAAGH,YAAYI;YAC/B,OAAO;gBACLF,SAAS,CAACC,IAAI,GAAGC;YACnB;QACF;QAEA,OAAOF;IACT;IAEA,OAAOF,YAAYJ;AACrB,EAAC"}

package/dist/utilities/setNestedValue.d.ts

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

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

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

package/dist/utilities/setNestedValue.js

@@ -1,3 +1,34 @@
+import { APIError } from 'payload';
+import { hasUnsupportedFieldPathSegment, setOwnProperty } from 'payload/shared';
+const MAX_UNVERIFIED_SPARSE_ARRAY_GAP = 1;
+const createObject = ()=>Object.create(null);
+const isArrayIndex = (part)=>{
+    if (!/^(?:0|[1-9]\d*)$/.test(part)) {
+        return false;
+    }
+    const index = Number(part);
+    return Number.isSafeInteger(index) && index >= 0;
+};
+const getPathKey = (target, part, source)=>{
+    if (!Array.isArray(target) || !isArrayIndex(part)) {
+        return part;
+    }
+    const index = Number(part);
+    if (Array.isArray(source) && index >= source.length || !Array.isArray(source) && index > target.length + MAX_UNVERIFIED_SPARSE_ARRAY_GAP) {
+        throw new APIError('Invalid field path.', 400, null, true);
+    }
+    return index;
+};
+const getSourceValue = (source, part)=>{
+    if (source === null || typeof source !== 'object') {
+        return undefined;
+    }
+    const key = Array.isArray(source) && isArrayIndex(part) ? Number(part) : part;
+    if (!Object.hasOwn(source, key)) {
+        return undefined;
+    }
+    return source[key];
+};
 /**
  * Sets a value deeply into a nested object or array, based on a dot-notation path.
  *
@@ -14,44 +45,44 @@
  * @param obj - The target object to mutate.
  * @param path - A dot-separated string path indicating where to assign the value.
  * @param value - The value to set at the specified path.
- */ export const setNestedValue = (obj, path, value)=>{
+ * @param source - The source object used to validate array boundaries.
+ */ export const setNestedValue = (obj, path, value, source)=>{
     const parts = path.split('.');
+    if (hasUnsupportedFieldPathSegment({
+        segments: parts
+    })) {
+        throw new APIError('Invalid field path.', 400, null, true);
+    }
+    const lastPart = parts.pop();
+    if (lastPart === undefined) {
+        return;
+    }
     let current = obj;
-    for(let i = 0; i < parts.length; i++){
-        const part = parts[i];
-        const isLast = i === parts.length - 1;
-        const isIndex = !Number.isNaN(Number(part));
-        if (isIndex) {
-            const index = Number(part);
-            // Ensure the current target is an array
-            if (!Array.isArray(current)) {
-                current = [];
-            }
-            const currentArray = current;
-            // Ensure the array slot is initialized
-            if (!currentArray[index]) {
-                currentArray[index] = {};
-            }
-            if (isLast) {
-                currentArray[index] = value;
-            } else {
-                current = currentArray[index];
-            }
-        } else {
-            const currentObj = current;
-            // Ensure the object key exists
-            if (isLast) {
-                if (typeof part === 'string') {
-                    currentObj[part] = value;
-                }
-            } else {
-                if (typeof currentObj[part] !== 'object' || currentObj[part] === null) {
-                    currentObj[part] = {};
-                }
-                current = currentObj[part];
-            }
+    let sourceCurrent = source;
+    for (const [i, part] of parts.entries()){
+        const key = getPathKey(current, part, sourceCurrent);
+        const currentRecord = current;
+        const nextPart = parts[i + 1] ?? lastPart;
+        const nextSource = getSourceValue(sourceCurrent, part);
+        const hasOwnNextValue = Object.hasOwn(currentRecord, key);
+        const nextValue = hasOwnNextValue ? currentRecord[key] : undefined;
+        if (!hasOwnNextValue || typeof nextValue !== 'object' || nextValue === null) {
+            setOwnProperty({
+                key,
+                target: currentRecord,
+                value: isArrayIndex(nextPart) ? [] : createObject()
+            });
         }
+        current = currentRecord[key];
+        sourceCurrent = nextSource;
     }
+    const lastKey = getPathKey(current, lastPart, sourceCurrent);
+    const finalRecord = current;
+    setOwnProperty({
+        key: lastKey,
+        target: finalRecord,
+        value
+    });
 };
 
 //# sourceMappingURL=setNestedValue.js.map

package/dist/utilities/setNestedValue.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/setNestedValue.ts"],"sourcesContent":["/**\n * Sets a value deeply into a nested object or array, based on a dot-notation path.\n *\n * This function:\n * - Supports array indexing (e.g., \"array.0.field1\")\n * - Creates intermediate arrays/objects as needed\n * - Mutates the target object directly\n *\n * @example\n * const obj = {}\n * setNestedValue(obj, 'group.array.0.field1', 'hello')\n * // Result: { group: { array: [ { field1: 'hello' } ] } }\n *\n * @param obj - The target object to mutate.\n * @param path - A dot-separated string path indicating where to assign the value.\n * @param value - The value to set at the specified path.\n */\n\nexport const setNestedValue = (\n  obj: Record<string, unknown>,\n  path: string,\n  value: unknown,\n): void => {\n  const parts = path.split('.')\n  let current: unknown = obj\n\n  for (let i = 0; i < parts.length; i++) {\n    const part = parts[i]\n    const isLast = i === parts.length - 1\n    const isIndex = !Number.isNaN(Number(part))\n\n    if (isIndex) {\n      const index = Number(part)\n\n      // Ensure the current target is an array\n      if (!Array.isArray(current)) {\n        current = []\n      }\n\n      const currentArray = current as unknown[]\n\n      // Ensure the array slot is initialized\n      if (!currentArray[index]) {\n        currentArray[index] = {}\n      }\n\n      if (isLast) {\n        currentArray[index] = value\n      } else {\n        current = currentArray[index]\n      }\n    } else {\n      const currentObj = current as Record<string, unknown>\n\n      // Ensure the object key exists\n      if (isLast) {\n        if (typeof part === 'string') {\n          currentObj[part] = value\n        }\n      } else {\n        if (typeof currentObj[part as string] !== 'object' || currentObj[part as string] === null) {\n          currentObj[part as string] = {}\n        }\n\n        current = currentObj[part as string]\n      }\n    }\n  }\n}\n"],"names":["setNestedValue","obj","path","value","parts","split","current","i","length","part","isLast","isIndex","Number","isNaN","index","Array","isArray","currentArray","currentObj"],"mappings":"AAAA;;;;;;;;;;;;;;;;CAgBC,GAED,OAAO,MAAMA,iBAAiB,CAC5BC,KACAC,MACAC;IAEA,MAAMC,QAAQF,KAAKG,KAAK,CAAC;IACzB,IAAIC,UAAmBL;IAEvB,IAAK,IAAIM,IAAI,GAAGA,IAAIH,MAAMI,MAAM,EAAED,IAAK;QACrC,MAAME,OAAOL,KAAK,CAACG,EAAE;QACrB,MAAMG,SAASH,MAAMH,MAAMI,MAAM,GAAG;QACpC,MAAMG,UAAU,CAACC,OAAOC,KAAK,CAACD,OAAOH;QAErC,IAAIE,SAAS;YACX,MAAMG,QAAQF,OAAOH;YAErB,wCAAwC;YACxC,IAAI,CAACM,MAAMC,OAAO,CAACV,UAAU;gBAC3BA,UAAU,EAAE;YACd;YAEA,MAAMW,eAAeX;YAErB,uCAAuC;YACvC,IAAI,CAACW,YAAY,CAACH,MAAM,EAAE;gBACxBG,YAAY,CAACH,MAAM,GAAG,CAAC;YACzB;YAEA,IAAIJ,QAAQ;gBACVO,YAAY,CAACH,MAAM,GAAGX;YACxB,OAAO;gBACLG,UAAUW,YAAY,CAACH,MAAM;YAC/B;QACF,OAAO;YACL,MAAMI,aAAaZ;YAEnB,+BAA+B;YAC/B,IAAII,QAAQ;gBACV,IAAI,OAAOD,SAAS,UAAU;oBAC5BS,UAAU,CAACT,KAAK,GAAGN;gBACrB;YACF,OAAO;gBACL,IAAI,OAAOe,UAAU,CAACT,KAAe,KAAK,YAAYS,UAAU,CAACT,KAAe,KAAK,MAAM;oBACzFS,UAAU,CAACT,KAAe,GAAG,CAAC;gBAChC;gBAEAH,UAAUY,UAAU,CAACT,KAAe;YACtC;QACF;IACF;AACF,EAAC"}
+{"version":3,"sources":["../../src/utilities/setNestedValue.ts"],"sourcesContent":["import { APIError } from 'payload'\nimport { hasUnsupportedFieldPathSegment, setOwnProperty } from 'payload/shared'\n\nconst MAX_UNVERIFIED_SPARSE_ARRAY_GAP = 1\n\nconst createObject = (): Record<string, unknown> => Object.create(null) as Record<string, unknown>\n\nconst isArrayIndex = (part: string): boolean => {\n  if (!/^(?:0|[1-9]\\d*)$/.test(part)) {\n    return false\n  }\n\n  const index = Number(part)\n\n  return Number.isSafeInteger(index) && index >= 0\n}\n\nconst getPathKey = (\n  target: Record<string, unknown> | unknown[],\n  part: string,\n  source: unknown,\n): number | string => {\n  if (!Array.isArray(target) || !isArrayIndex(part)) {\n    return part\n  }\n\n  const index = Number(part)\n\n  if (\n    (Array.isArray(source) && index >= source.length) ||\n    (!Array.isArray(source) && index > target.length + MAX_UNVERIFIED_SPARSE_ARRAY_GAP)\n  ) {\n    throw new APIError('Invalid field path.', 400, null, true)\n  }\n\n  return index\n}\n\nconst getSourceValue = (source: unknown, part: string): unknown => {\n  if (source === null || typeof source !== 'object') {\n    return undefined\n  }\n\n  const key = Array.isArray(source) && isArrayIndex(part) ? Number(part) : part\n\n  if (!Object.hasOwn(source, key)) {\n    return undefined\n  }\n\n  return (source as Record<number | string, unknown>)[key]\n}\n\n/**\n * Sets a value deeply into a nested object or array, based on a dot-notation path.\n *\n * This function:\n * - Supports array indexing (e.g., \"array.0.field1\")\n * - Creates intermediate arrays/objects as needed\n * - Mutates the target object directly\n *\n * @example\n * const obj = {}\n * setNestedValue(obj, 'group.array.0.field1', 'hello')\n * // Result: { group: { array: [ { field1: 'hello' } ] } }\n *\n * @param obj - The target object to mutate.\n * @param path - A dot-separated string path indicating where to assign the value.\n * @param value - The value to set at the specified path.\n * @param source - The source object used to validate array boundaries.\n */\n\nexport const setNestedValue = (\n  obj: Record<string, unknown>,\n  path: string,\n  value: unknown,\n  source?: Record<string, unknown>,\n): void => {\n  const parts = path.split('.')\n\n  if (hasUnsupportedFieldPathSegment({ segments: parts })) {\n    throw new APIError('Invalid field path.', 400, null, true)\n  }\n\n  const lastPart = parts.pop()\n\n  if (lastPart === undefined) {\n    return\n  }\n\n  let current: Record<string, unknown> | unknown[] = obj\n  let sourceCurrent: unknown = source\n\n  for (const [i, part] of parts.entries()) {\n    const key = getPathKey(current, part, sourceCurrent)\n    const currentRecord = current as Record<number | string, unknown>\n    const nextPart = parts[i + 1] ?? lastPart\n    const nextSource = getSourceValue(sourceCurrent, part)\n\n    const hasOwnNextValue = Object.hasOwn(currentRecord, key)\n    const nextValue = hasOwnNextValue ? currentRecord[key] : undefined\n\n    if (!hasOwnNextValue || typeof nextValue !== 'object' || nextValue === null) {\n      setOwnProperty({\n        key,\n        target: currentRecord,\n        value: isArrayIndex(nextPart) ? [] : createObject(),\n      })\n    }\n\n    current = currentRecord[key] as Record<string, unknown> | unknown[]\n    sourceCurrent = nextSource\n  }\n\n  const lastKey = getPathKey(current, lastPart, sourceCurrent)\n  const finalRecord = current as Record<number | string, unknown>\n\n  setOwnProperty({ key: lastKey, target: finalRecord, value })\n}\n"],"names":["APIError","hasUnsupportedFieldPathSegment","setOwnProperty","MAX_UNVERIFIED_SPARSE_ARRAY_GAP","createObject","Object","create","isArrayIndex","part","test","index","Number","isSafeInteger","getPathKey","target","source","Array","isArray","length","getSourceValue","undefined","key","hasOwn","setNestedValue","obj","path","value","parts","split","segments","lastPart","pop","current","sourceCurrent","i","entries","currentRecord","nextPart","nextSource","hasOwnNextValue","nextValue","lastKey","finalRecord"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,UAAS;AAClC,SAASC,8BAA8B,EAAEC,cAAc,QAAQ,iBAAgB;AAE/E,MAAMC,kCAAkC;AAExC,MAAMC,eAAe,IAA+BC,OAAOC,MAAM,CAAC;AAElE,MAAMC,eAAe,CAACC;IACpB,IAAI,CAAC,mBAAmBC,IAAI,CAACD,OAAO;QAClC,OAAO;IACT;IAEA,MAAME,QAAQC,OAAOH;IAErB,OAAOG,OAAOC,aAAa,CAACF,UAAUA,SAAS;AACjD;AAEA,MAAMG,aAAa,CACjBC,QACAN,MACAO;IAEA,IAAI,CAACC,MAAMC,OAAO,CAACH,WAAW,CAACP,aAAaC,OAAO;QACjD,OAAOA;IACT;IAEA,MAAME,QAAQC,OAAOH;IAErB,IACE,AAACQ,MAAMC,OAAO,CAACF,WAAWL,SAASK,OAAOG,MAAM,IAC/C,CAACF,MAAMC,OAAO,CAACF,WAAWL,QAAQI,OAAOI,MAAM,GAAGf,iCACnD;QACA,MAAM,IAAIH,SAAS,uBAAuB,KAAK,MAAM;IACvD;IAEA,OAAOU;AACT;AAEA,MAAMS,iBAAiB,CAACJ,QAAiBP;IACvC,IAAIO,WAAW,QAAQ,OAAOA,WAAW,UAAU;QACjD,OAAOK;IACT;IAEA,MAAMC,MAAML,MAAMC,OAAO,CAACF,WAAWR,aAAaC,QAAQG,OAAOH,QAAQA;IAEzE,IAAI,CAACH,OAAOiB,MAAM,CAACP,QAAQM,MAAM;QAC/B,OAAOD;IACT;IAEA,OAAO,AAACL,MAA2C,CAACM,IAAI;AAC1D;AAEA;;;;;;;;;;;;;;;;;CAiBC,GAED,OAAO,MAAME,iBAAiB,CAC5BC,KACAC,MACAC,OACAX;IAEA,MAAMY,QAAQF,KAAKG,KAAK,CAAC;IAEzB,IAAI3B,+BAA+B;QAAE4B,UAAUF;IAAM,IAAI;QACvD,MAAM,IAAI3B,SAAS,uBAAuB,KAAK,MAAM;IACvD;IAEA,MAAM8B,WAAWH,MAAMI,GAAG;IAE1B,IAAID,aAAaV,WAAW;QAC1B;IACF;IAEA,IAAIY,UAA+CR;IACnD,IAAIS,gBAAyBlB;IAE7B,KAAK,MAAM,CAACmB,GAAG1B,KAAK,IAAImB,MAAMQ,OAAO,GAAI;QACvC,MAAMd,MAAMR,WAAWmB,SAASxB,MAAMyB;QACtC,MAAMG,gBAAgBJ;QACtB,MAAMK,WAAWV,KAAK,CAACO,IAAI,EAAE,IAAIJ;QACjC,MAAMQ,aAAanB,eAAec,eAAezB;QAEjD,MAAM+B,kBAAkBlC,OAAOiB,MAAM,CAACc,eAAef;QACrD,MAAMmB,YAAYD,kBAAkBH,aAAa,CAACf,IAAI,GAAGD;QAEzD,IAAI,CAACmB,mBAAmB,OAAOC,cAAc,YAAYA,cAAc,MAAM;YAC3EtC,eAAe;gBACbmB;gBACAP,QAAQsB;gBACRV,OAAOnB,aAAa8B,YAAY,EAAE,GAAGjC;YACvC;QACF;QAEA4B,UAAUI,aAAa,CAACf,IAAI;QAC5BY,gBAAgBK;IAClB;IAEA,MAAMG,UAAU5B,WAAWmB,SAASF,UAAUG;IAC9C,MAAMS,cAAcV;IAEpB9B,eAAe;QAAEmB,KAAKoB;QAAS3B,QAAQ4B;QAAahB;IAAM;AAC5D,EAAC"}

package/dist/utilities/sortHelpers.d.ts

@@ -1,6 +1,6 @@
 /** Remove a leading '-' from a sort value (e.g. "-title" -> "title") */
 export declare const stripSortDash: (v?: null | string) => string;
 /** Apply order to a base field (("title","desc") -> "-title") */
-export declare const applySortOrder: (field: string, order: "asc" | "desc") => string;
+export declare const applySortOrder: (field: string, order: 'asc' | 'desc') => string;
 export declare const normalizeQueryParam: (v: unknown) => string | undefined;
 //# sourceMappingURL=sortHelpers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"unflattenObject.d.ts","sourceRoot":"","sources":["../../src/utilities/unflattenObject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAKvD,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,CAAA;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;IACvD,GAAG,EAAE,cAAc,CAAA;CACpB,CAAA;AAiCD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,qDAMzB,aAAa,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAkUxC,CAAA"}
+{"version":3,"file":"unflattenObject.d.ts","sourceRoot":"","sources":["../../src/utilities/unflattenObject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAKvD,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,CAAA;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;IACvD,GAAG,EAAE,cAAc,CAAA;CACpB,CAAA;AAuCD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,qDAMzB,aAAa,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAyUxC,CAAA"}

package/dist/utilities/unflattenObject.js

@@ -1,4 +1,4 @@
-import { getNestedFlattenedFields } from './flattenedFields.js';
+import { getBlockFlattenedFields, getNestedFlattenedFields } from './flattenedFields.js';
 import { postProcessDocument } from './unflattenPostProcess.js';
 const indexSegment = /^\d+$/;
 const collectArrayLikeNames = (fields, into)=>{
@@ -9,6 +9,11 @@ const collectArrayLikeNames = (fields, into)=>{
         if (field.type === 'array' || field.type === 'blocks') {
             into.add(field.name);
         }
+        if (field.type === 'blocks') {
+            for (const block of field.blocks ?? []){
+                collectArrayLikeNames(getBlockFlattenedFields(block), into);
+            }
+        }
         const nested = getNestedFlattenedFields(field);
         if (nested) {
             collectArrayLikeNames(nested, into);
@@ -103,22 +108,14 @@ const collectArrayLikeNames = (fields, into)=>{
         const importHookEntry = importFieldHooks[flatKey] ?? importFieldHooks[toLogicalKey(flatKey, arrayLikeNames)];
         if (importHookEntry) {
             try {
-                if (importHookEntry.type === 'beforeImport') {
-                    value = importHookEntry.fn({
-                        columnName: flatKey,
-                        data,
-                        format,
-                        siblingData: data,
-                        siblingDoc: data,
-                        value
-                    });
-                } else {
-                    value = importHookEntry.fn({
-                        columnName: flatKey,
-                        data,
-                        value
-                    });
-                }
+                value = importHookEntry.fn({
+                    columnName: flatKey,
+                    data,
+                    format,
+                    siblingData: data,
+                    siblingDoc: data,
+                    value
+                });
             } catch (error) {
                 req.payload.logger.error({
                     err: error,
@@ -238,7 +235,9 @@ const collectArrayLikeNames = (fields, into)=>{
                             blockObject[blockFieldName] = value;
                         } else {
                             if (!blockObject[blockFieldName] || typeof blockObject[blockFieldName] !== 'object') {
-                                blockObject[blockFieldName] = {};
+                                const segmentAfterBlockField = pathSegments[i + 4];
+                                const blockFieldIsArray = segmentAfterBlockField !== undefined && indexSegment.test(segmentAfterBlockField);
+                                blockObject[blockFieldName] = blockFieldIsArray ? [] : {};
                             }
                             currentObject = blockObject[blockFieldName];
                             i = i + 3;
@@ -262,6 +261,18 @@ const collectArrayLikeNames = (fields, into)=>{
                     currentObject = arr[arrayIndex];
                     i++;
                 }
+            } else if (Array.isArray(currentObject) && indexSegment.test(segment)) {
+                // currentObject is an array we arrived at via block field traversal — treat the
+                // segment as a numeric index rather than a plain property name.
+                const idx = parseInt(segment, 10);
+                const arr = currentObject;
+                while(arr.length <= idx){
+                    arr.push(null);
+                }
+                if (arr[idx] === null || arr[idx] === undefined) {
+                    arr[idx] = {};
+                }
+                currentObject = arr[idx];
             } else {
                 // Skip if already set to null (polymorphic relationship already processed)
                 if (currentObject[segment] === null && isLast && segment === 'relationTo') {