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

package/dist/utilities/getExportFieldFunctions.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/getExportFieldFunctions.ts"],"sourcesContent":["import { type FlattenedField, traverseFields, type TraverseFieldsCallback } from 'payload'\n\nimport type { ToCSVFunction } from '../types.js'\n\ntype Args = {\n  fields: FlattenedField[]\n}\n\n/**\n * Gets custom toCSV field functions for export.\n * These functions transform field values when flattening documents for CSV export.\n */\nexport const getExportFieldFunctions = ({ fields }: Args): Record<string, ToCSVFunction> => {\n  const result: Record<string, ToCSVFunction> = {}\n\n  const buildCustomFunctions: TraverseFieldsCallback = ({ field, parentRef, ref }) => {\n    // @ts-expect-error ref is untyped\n    ref.prefix = parentRef.prefix || ''\n    if (field.type === 'group' || field.type === 'tab') {\n      // @ts-expect-error ref is untyped\n      const parentPrefix = parentRef?.prefix ? `${parentRef.prefix}_` : ''\n      // @ts-expect-error ref is untyped\n      ref.prefix = `${parentPrefix}${field.name}_`\n    }\n\n    if (typeof field.custom?.['plugin-import-export']?.toCSV === 'function') {\n      // @ts-expect-error ref is untyped\n      result[`${ref.prefix}${field.name}`] = field.custom['plugin-import-export']?.toCSV\n    } else if (field.type === 'json' || field.type === 'richText') {\n      // Serialize JSON and richText fields as JSON strings in a single column\n      // This prevents them from being flattened into multiple columns\n      // @ts-expect-error ref is untyped\n      result[`${ref.prefix}${field.name}`] = ({ value }) => {\n        if (value === null || value === undefined) {\n          return value\n        }\n        if (typeof value === 'object') {\n          return JSON.stringify(value)\n        }\n        return value\n      }\n    } else if (field.type === 'date') {\n      // Handle date fields - return value as-is (ISO string format)\n      // This prevents the flattener from treating the document as having\n      // nested sibling properties like _tz that shouldn't be auto-included\n      // @ts-expect-error ref is untyped\n      const fieldKey = `${ref.prefix}${field.name}`\n\n      result[fieldKey] = ({ value }) => value\n    } else if (field.type === 'relationship' || field.type === 'upload') {\n      if (field.hasMany !== true) {\n        if (!Array.isArray(field.relationTo)) {\n          // monomorphic single\n          // @ts-expect-error ref is untyped\n          result[`${ref.prefix}${field.name}`] = ({ value }) =>\n            typeof value === 'object' && value && 'id' in value ? value.id : value\n        } else {\n          // polymorphic single\n          // @ts-expect-error ref is untyped\n          result[`${ref.prefix}${field.name}`] = ({ data, value }) => {\n            if (value && typeof value === 'object' && 'relationTo' in value && 'value' in value) {\n              const relationTo = (value as { relationTo: string; value: { id: number | string } })\n                .relationTo\n              const relatedDoc = (value as { relationTo: string; value: { id: number | string } })\n                .value\n              if (relatedDoc && typeof relatedDoc === 'object') {\n                // @ts-expect-error ref is untyped\n                data[`${ref.prefix}${field.name}_id`] = relatedDoc.id\n                // @ts-expect-error ref is untyped\n                data[`${ref.prefix}${field.name}_relationTo`] = relationTo\n              }\n            }\n            return undefined // prevents further flattening\n          }\n        }\n      } else {\n        if (!Array.isArray(field.relationTo)) {\n          // monomorphic many\n          // @ts-expect-error ref is untyped\n          result[`${ref.prefix}${field.name}`] = ({\n            data,\n            value,\n          }: {\n            data: Record<string, unknown>\n            value: Array<number | Record<string, any> | string> | undefined\n          }) => {\n            if (Array.isArray(value)) {\n              value.forEach((val, i) => {\n                const id = typeof val === 'object' && val ? val.id : val\n                // @ts-expect-error ref is untyped\n                data[`${ref.prefix}${field.name}_${i}_id`] = id\n              })\n            }\n            return undefined // prevents further flattening\n          }\n        } else {\n          // polymorphic many\n          // @ts-expect-error ref is untyped\n          result[`${ref.prefix}${field.name}`] = ({\n            data,\n            value,\n          }: {\n            data: Record<string, unknown>\n            value: Array<Record<string, any>> | undefined\n          }) => {\n            if (Array.isArray(value)) {\n              value.forEach((val, i) => {\n                if (val && typeof val === 'object') {\n                  const relationTo = val.relationTo\n                  const relatedDoc = val.value\n                  if (relationTo && relatedDoc && typeof relatedDoc === 'object') {\n                    // @ts-expect-error ref is untyped\n                    data[`${ref.prefix}${field.name}_${i}_id`] = relatedDoc.id\n                    // @ts-expect-error ref is untyped\n                    data[`${ref.prefix}${field.name}_${i}_relationTo`] = relationTo\n                  }\n                }\n              })\n            }\n            return undefined\n          }\n        }\n      }\n    }\n  }\n\n  traverseFields({ callback: buildCustomFunctions, fields })\n\n  return result\n}\n"],"names":["traverseFields","getExportFieldFunctions","fields","result","buildCustomFunctions","field","parentRef","ref","prefix","type","parentPrefix","name","custom","toCSV","value","undefined","JSON","stringify","fieldKey","hasMany","Array","isArray","relationTo","id","data","relatedDoc","forEach","val","i","callback"],"mappings":"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"}
+{"version":3,"sources":["../../src/utilities/getExportFieldFunctions.ts"],"sourcesContent":["import type { FlattenedField } from 'payload'\n\nimport type { ExportFieldHookEntry, FieldBeforeExportHook } from '../types.js'\n\nimport { registerFieldHooks } from './flattenedFields.js'\nimport { getPolymorphicRelId, isPolymorphicRelValue } from './polymorphicRel.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 export hook entry. Paths include block slugs but never array indices.\n */\nexport const getExportFieldFunctions = ({ fields }: Args): Record<string, ExportFieldHookEntry> => {\n  const result: Record<string, ExportFieldHookEntry> = {}\n  registerFieldHooks(fields, '', result, registerExportHandler)\n  return result\n}\n\nconst registerExportHandler = (\n  field: FlattenedField,\n  fullKey: string,\n  result: Record<string, ExportFieldHookEntry>,\n): void => {\n  const beforeExport = field.custom?.['plugin-import-export']?.hooks?.beforeExport\n\n  if (typeof beforeExport === 'function') {\n    result[fullKey] = { type: 'beforeExport', fn: beforeExport }\n    return\n  }\n\n  const registerHandler = (handler: FieldBeforeExportHook) => {\n    result[fullKey] = { type: 'beforeExport', fn: handler }\n  }\n\n  if (field.type === 'json' || field.type === 'richText') {\n    registerHandler(({ format, value }) => {\n      if (format === 'json') {\n        return value\n      }\n      if (value === null || value === undefined) {\n        return value\n      }\n      if (typeof value === 'object') {\n        return JSON.stringify(value)\n      }\n      return value\n    })\n    return\n  }\n\n  if (field.type === 'date') {\n    registerHandler(({ value }) => value)\n    return\n  }\n\n  if (field.type !== 'relationship' && field.type !== 'upload') {\n    return\n  }\n\n  if (field.hasMany !== true) {\n    if (!Array.isArray(field.relationTo)) {\n      registerHandler(({ value }) =>\n        typeof value === 'object' && value && 'id' in value ? value.id : value,\n      )\n      return\n    }\n\n    registerHandler(({ format, siblingData, value }) => {\n      // A shape this handler does not recognize is left untouched for JSON, which holds the\n      // source value verbatim. CSV still clears it, since its id/relationTo would otherwise\n      // land in sibling columns.\n      if (!isPolymorphicRelValue(value)) {\n        return format === 'json' ? undefined : null\n      }\n\n      // A recognized reference that resolves to no id is dangling, and a dangling reference\n      // cannot be imported back — clear it for both formats.\n      const id = getPolymorphicRelId(value)\n      if (id === undefined) {\n        return null\n      }\n\n      if (format === 'json') {\n        return { relationTo: value.relationTo, value: id }\n      }\n      siblingData[`${fullKey}_id`] = id\n      siblingData[`${fullKey}_relationTo`] = value.relationTo\n      return null\n    })\n    return\n  }\n\n  if (!Array.isArray(field.relationTo)) {\n    registerHandler(({ format, siblingData, value }) => {\n      if (!Array.isArray(value)) {\n        return undefined\n      }\n      const ids = value.map((val) =>\n        typeof val === 'object' && val ? (val as { id: unknown }).id : val,\n      )\n      // Bare null entries fail relationship validation when the JSON is imported, so drop\n      // references that could not be resolved. CSV keeps source indexes in its column names;\n      // unflattening those columns collapses any gaps on import.\n      if (format === 'json') {\n        return ids.filter((id) => id !== null && id !== undefined)\n      }\n      ids.forEach((id, i) => {\n        siblingData[`${fullKey}_${i}_id`] = id\n      })\n      return null\n    })\n    return\n  }\n\n  registerHandler(({ format, siblingData, value }) => {\n    if (!Array.isArray(value)) {\n      return undefined\n    }\n    // `index` is carried so CSV columns stay pinned to the source position: an entry\n    // that cannot be resolved to an id leaves a gap rather than shifting its siblings.\n    const rels = value.flatMap((val, index) => {\n      if (!isPolymorphicRelValue(val)) {\n        return []\n      }\n      const id = getPolymorphicRelId(val)\n      return id === undefined ? [] : [{ id, index, relationTo: val.relationTo }]\n    })\n\n    if (format === 'json') {\n      // Bare null entries fail relationship validation when the JSON is imported, so return\n      // only references that resolved to an id.\n      return rels.map(({ id, relationTo }) => ({ relationTo, value: id }))\n    }\n    rels.forEach(({ id, index, relationTo }) => {\n      siblingData[`${fullKey}_${index}_id`] = id\n      siblingData[`${fullKey}_${index}_relationTo`] = relationTo\n    })\n    return null\n  })\n}\n"],"names":["registerFieldHooks","getPolymorphicRelId","isPolymorphicRelValue","getExportFieldFunctions","fields","result","registerExportHandler","field","fullKey","beforeExport","custom","hooks","type","fn","registerHandler","handler","format","value","undefined","JSON","stringify","hasMany","Array","isArray","relationTo","id","siblingData","ids","map","val","filter","forEach","i","rels","flatMap","index"],"mappings":"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"}

package/dist/utilities/getFileFromDoc.js

@@ -1,5 +1,5 @@
 import { FileRetrievalError, getFileByPath } from 'payload';
-import { getExternalFile } from 'payload/internal';
+import { downloadFileToBuffer } from 'payload/internal';
 import { formatAdminURL } from 'payload/shared';
 /**
  * Retrieves file data from an uploaded document, handling both local storage
@@ -33,7 +33,7 @@ import { formatAdminURL } from 'payload/shared';
     }
     if (doc.filename && doc.url) {
         // Cloud storage or external - fetch via Payload's file endpoint
-        // getExternalFile constructs full URL, includes cookies for auth, and
+        // downloadFileToBuffer constructs full URL, includes cookies for auth, and
         // the request goes through Payload's handler chain (including storage adapter)
         // For relative URLs, construct a full URL using formatAdminURL which properly
         // handles serverURL, basePath, and other config. This is important in job contexts
@@ -44,7 +44,7 @@ import { formatAdminURL } from 'payload/shared';
             path: doc.url,
             serverURL: serverURL || req.origin
         });
-        const file = await getExternalFile({
+        const file = await downloadFileToBuffer({
             data: {
                 filename: doc.filename,
                 url: fileUrl

package/dist/utilities/getFileFromDoc.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/getFileFromDoc.ts"],"sourcesContent":["import type { CollectionConfig, FileData, PayloadRequest, UploadConfig } from 'payload'\n\nimport { FileRetrievalError, getFileByPath } from 'payload'\nimport { getExternalFile } from 'payload/internal'\nimport { formatAdminURL } from 'payload/shared'\n\ntype Args = {\n  collectionConfig: CollectionConfig\n  doc: { filename: string; mimeType?: string; url?: string }\n  req: PayloadRequest\n}\n\ntype Result = {\n  data: Buffer\n  mimetype: string\n}\n\n/**\n * Retrieves file data from an uploaded document, handling both local storage\n * and cloud storage (S3, Azure, GCS, etc.) scenarios correctly.\n *\n * This function uses the same pattern as Payload's internal file retrieval:\n * - For local storage: reads directly from disk (efficient, no HTTP roundtrip)\n * - For cloud storage: fetches via Payload's file endpoint, which triggers\n *   the storage adapter's staticHandler to serve the file\n */\nexport const getFileFromDoc = async ({ collectionConfig, doc, req }: Args): Promise<Result> => {\n  const uploadConfig: UploadConfig =\n    typeof collectionConfig.upload === 'object' ? collectionConfig.upload : {}\n  const disableLocalStorage = uploadConfig.disableLocalStorage ?? false\n  const staticDir = uploadConfig.staticDir || collectionConfig.slug\n\n  const serverURL = req.payload.config.serverURL\n  const isLocalFile = (serverURL && doc.url?.startsWith(serverURL)) || doc.url?.startsWith('/')\n\n  if (!disableLocalStorage && isLocalFile && doc.filename) {\n    // Local storage enabled - read directly from disk (efficient, no HTTP roundtrip)\n    const filePath = `${staticDir}/${doc.filename}`\n    const file = await getFileByPath(filePath)\n\n    if (!file) {\n      throw new Error(`File not found at path: ${filePath}`)\n    }\n\n    const mimetype = file.mimetype || doc.mimeType\n\n    if (!mimetype) {\n      throw new FileRetrievalError(req.t, `Unable to determine mimetype for file: ${doc.filename}`)\n    }\n\n    return {\n      data: file.data,\n      mimetype,\n    }\n  }\n\n  if (doc.filename && doc.url) {\n    // Cloud storage or external - fetch via Payload's file endpoint\n    // getExternalFile constructs full URL, includes cookies for auth, and\n    // the request goes through Payload's handler chain (including storage adapter)\n\n    // For relative URLs, construct a full URL using formatAdminURL which properly\n    // handles serverURL, basePath, and other config. This is important in job contexts\n    // where request headers may not be available for URL construction.\n    // Use serverURL from config, falling back to req.origin for local/job requests.\n    const fileUrl = doc.url.startsWith('http')\n      ? doc.url\n      : formatAdminURL({\n          apiRoute: '',\n          path: doc.url as `/${string}`,\n          serverURL: serverURL || req.origin,\n        })\n\n    const file = await getExternalFile({\n      data: { filename: doc.filename, url: fileUrl } as FileData,\n      req,\n      uploadConfig,\n    })\n\n    const mimetype = file.mimetype || doc.mimeType\n\n    if (!mimetype) {\n      throw new FileRetrievalError(req.t, `Unable to determine mimetype for file: ${doc.filename}`)\n    }\n\n    return {\n      data: file.data,\n      mimetype,\n    }\n  }\n\n  throw new Error('Unable to retrieve file: missing filename or url')\n}\n"],"names":["FileRetrievalError","getFileByPath","getExternalFile","formatAdminURL","getFileFromDoc","collectionConfig","doc","req","uploadConfig","upload","disableLocalStorage","staticDir","slug","serverURL","payload","config","isLocalFile","url","startsWith","filename","filePath","file","Error","mimetype","mimeType","t","data","fileUrl","apiRoute","path","origin"],"mappings":"AAEA,SAASA,kBAAkB,EAAEC,aAAa,QAAQ,UAAS;AAC3D,SAASC,eAAe,QAAQ,mBAAkB;AAClD,SAASC,cAAc,QAAQ,iBAAgB;AAa/C;;;;;;;;CAQC,GACD,OAAO,MAAMC,iBAAiB,OAAO,EAAEC,gBAAgB,EAAEC,GAAG,EAAEC,GAAG,EAAQ;IACvE,MAAMC,eACJ,OAAOH,iBAAiBI,MAAM,KAAK,WAAWJ,iBAAiBI,MAAM,GAAG,CAAC;IAC3E,MAAMC,sBAAsBF,aAAaE,mBAAmB,IAAI;IAChE,MAAMC,YAAYH,aAAaG,SAAS,IAAIN,iBAAiBO,IAAI;IAEjE,MAAMC,YAAYN,IAAIO,OAAO,CAACC,MAAM,CAACF,SAAS;IAC9C,MAAMG,cAAc,AAACH,aAAaP,IAAIW,GAAG,EAAEC,WAAWL,cAAeP,IAAIW,GAAG,EAAEC,WAAW;IAEzF,IAAI,CAACR,uBAAuBM,eAAeV,IAAIa,QAAQ,EAAE;QACvD,iFAAiF;QACjF,MAAMC,WAAW,GAAGT,UAAU,CAAC,EAAEL,IAAIa,QAAQ,EAAE;QAC/C,MAAME,OAAO,MAAMpB,cAAcmB;QAEjC,IAAI,CAACC,MAAM;YACT,MAAM,IAAIC,MAAM,CAAC,wBAAwB,EAAEF,UAAU;QACvD;QAEA,MAAMG,WAAWF,KAAKE,QAAQ,IAAIjB,IAAIkB,QAAQ;QAE9C,IAAI,CAACD,UAAU;YACb,MAAM,IAAIvB,mBAAmBO,IAAIkB,CAAC,EAAE,CAAC,uCAAuC,EAAEnB,IAAIa,QAAQ,EAAE;QAC9F;QAEA,OAAO;YACLO,MAAML,KAAKK,IAAI;YACfH;QACF;IACF;IAEA,IAAIjB,IAAIa,QAAQ,IAAIb,IAAIW,GAAG,EAAE;QAC3B,gEAAgE;QAChE,sEAAsE;QACtE,+EAA+E;QAE/E,8EAA8E;QAC9E,mFAAmF;QACnF,mEAAmE;QACnE,gFAAgF;QAChF,MAAMU,UAAUrB,IAAIW,GAAG,CAACC,UAAU,CAAC,UAC/BZ,IAAIW,GAAG,GACPd,eAAe;YACbyB,UAAU;YACVC,MAAMvB,IAAIW,GAAG;YACbJ,WAAWA,aAAaN,IAAIuB,MAAM;QACpC;QAEJ,MAAMT,OAAO,MAAMnB,gBAAgB;YACjCwB,MAAM;gBAAEP,UAAUb,IAAIa,QAAQ;gBAAEF,KAAKU;YAAQ;YAC7CpB;YACAC;QACF;QAEA,MAAMe,WAAWF,KAAKE,QAAQ,IAAIjB,IAAIkB,QAAQ;QAE9C,IAAI,CAACD,UAAU;YACb,MAAM,IAAIvB,mBAAmBO,IAAIkB,CAAC,EAAE,CAAC,uCAAuC,EAAEnB,IAAIa,QAAQ,EAAE;QAC9F;QAEA,OAAO;YACLO,MAAML,KAAKK,IAAI;YACfH;QACF;IACF;IAEA,MAAM,IAAID,MAAM;AAClB,EAAC"}
+{"version":3,"sources":["../../src/utilities/getFileFromDoc.ts"],"sourcesContent":["import type { CollectionConfig, FileData, PayloadRequest, UploadConfig } from 'payload'\n\nimport { FileRetrievalError, getFileByPath } from 'payload'\nimport { downloadFileToBuffer } from 'payload/internal'\nimport { formatAdminURL } from 'payload/shared'\n\ntype Args = {\n  collectionConfig: CollectionConfig\n  doc: { filename: string; mimeType?: string; url?: string }\n  req: PayloadRequest\n}\n\ntype Result = {\n  data: Buffer\n  mimetype: string\n}\n\n/**\n * Retrieves file data from an uploaded document, handling both local storage\n * and cloud storage (S3, Azure, GCS, etc.) scenarios correctly.\n *\n * This function uses the same pattern as Payload's internal file retrieval:\n * - For local storage: reads directly from disk (efficient, no HTTP roundtrip)\n * - For cloud storage: fetches via Payload's file endpoint, which triggers\n *   the storage adapter's staticHandler to serve the file\n */\nexport const getFileFromDoc = async ({ collectionConfig, doc, req }: Args): Promise<Result> => {\n  const uploadConfig: UploadConfig =\n    typeof collectionConfig.upload === 'object' ? collectionConfig.upload : {}\n  const disableLocalStorage = uploadConfig.disableLocalStorage ?? false\n  const staticDir = uploadConfig.staticDir || collectionConfig.slug\n\n  const serverURL = req.payload.config.serverURL\n  const isLocalFile = (serverURL && doc.url?.startsWith(serverURL)) || doc.url?.startsWith('/')\n\n  if (!disableLocalStorage && isLocalFile && doc.filename) {\n    // Local storage enabled - read directly from disk (efficient, no HTTP roundtrip)\n    const filePath = `${staticDir}/${doc.filename}`\n    const file = await getFileByPath(filePath)\n\n    if (!file) {\n      throw new Error(`File not found at path: ${filePath}`)\n    }\n\n    const mimetype = file.mimetype || doc.mimeType\n\n    if (!mimetype) {\n      throw new FileRetrievalError(req.t, `Unable to determine mimetype for file: ${doc.filename}`)\n    }\n\n    return {\n      data: file.data,\n      mimetype,\n    }\n  }\n\n  if (doc.filename && doc.url) {\n    // Cloud storage or external - fetch via Payload's file endpoint\n    // downloadFileToBuffer constructs full URL, includes cookies for auth, and\n    // the request goes through Payload's handler chain (including storage adapter)\n\n    // For relative URLs, construct a full URL using formatAdminURL which properly\n    // handles serverURL, basePath, and other config. This is important in job contexts\n    // where request headers may not be available for URL construction.\n    // Use serverURL from config, falling back to req.origin for local/job requests.\n    const fileUrl = doc.url.startsWith('http')\n      ? doc.url\n      : formatAdminURL({\n          apiRoute: '',\n          path: doc.url as `/${string}`,\n          serverURL: serverURL || req.origin,\n        })\n\n    const file = await downloadFileToBuffer({\n      data: { filename: doc.filename, url: fileUrl } as FileData,\n      req,\n      uploadConfig,\n    })\n\n    const mimetype = file.mimetype || doc.mimeType\n\n    if (!mimetype) {\n      throw new FileRetrievalError(req.t, `Unable to determine mimetype for file: ${doc.filename}`)\n    }\n\n    return {\n      data: file.data,\n      mimetype,\n    }\n  }\n\n  throw new Error('Unable to retrieve file: missing filename or url')\n}\n"],"names":["FileRetrievalError","getFileByPath","downloadFileToBuffer","formatAdminURL","getFileFromDoc","collectionConfig","doc","req","uploadConfig","upload","disableLocalStorage","staticDir","slug","serverURL","payload","config","isLocalFile","url","startsWith","filename","filePath","file","Error","mimetype","mimeType","t","data","fileUrl","apiRoute","path","origin"],"mappings":"AAEA,SAASA,kBAAkB,EAAEC,aAAa,QAAQ,UAAS;AAC3D,SAASC,oBAAoB,QAAQ,mBAAkB;AACvD,SAASC,cAAc,QAAQ,iBAAgB;AAa/C;;;;;;;;CAQC,GACD,OAAO,MAAMC,iBAAiB,OAAO,EAAEC,gBAAgB,EAAEC,GAAG,EAAEC,GAAG,EAAQ;IACvE,MAAMC,eACJ,OAAOH,iBAAiBI,MAAM,KAAK,WAAWJ,iBAAiBI,MAAM,GAAG,CAAC;IAC3E,MAAMC,sBAAsBF,aAAaE,mBAAmB,IAAI;IAChE,MAAMC,YAAYH,aAAaG,SAAS,IAAIN,iBAAiBO,IAAI;IAEjE,MAAMC,YAAYN,IAAIO,OAAO,CAACC,MAAM,CAACF,SAAS;IAC9C,MAAMG,cAAc,AAACH,aAAaP,IAAIW,GAAG,EAAEC,WAAWL,cAAeP,IAAIW,GAAG,EAAEC,WAAW;IAEzF,IAAI,CAACR,uBAAuBM,eAAeV,IAAIa,QAAQ,EAAE;QACvD,iFAAiF;QACjF,MAAMC,WAAW,GAAGT,UAAU,CAAC,EAAEL,IAAIa,QAAQ,EAAE;QAC/C,MAAME,OAAO,MAAMpB,cAAcmB;QAEjC,IAAI,CAACC,MAAM;YACT,MAAM,IAAIC,MAAM,CAAC,wBAAwB,EAAEF,UAAU;QACvD;QAEA,MAAMG,WAAWF,KAAKE,QAAQ,IAAIjB,IAAIkB,QAAQ;QAE9C,IAAI,CAACD,UAAU;YACb,MAAM,IAAIvB,mBAAmBO,IAAIkB,CAAC,EAAE,CAAC,uCAAuC,EAAEnB,IAAIa,QAAQ,EAAE;QAC9F;QAEA,OAAO;YACLO,MAAML,KAAKK,IAAI;YACfH;QACF;IACF;IAEA,IAAIjB,IAAIa,QAAQ,IAAIb,IAAIW,GAAG,EAAE;QAC3B,gEAAgE;QAChE,2EAA2E;QAC3E,+EAA+E;QAE/E,8EAA8E;QAC9E,mFAAmF;QACnF,mEAAmE;QACnE,gFAAgF;QAChF,MAAMU,UAAUrB,IAAIW,GAAG,CAACC,UAAU,CAAC,UAC/BZ,IAAIW,GAAG,GACPd,eAAe;YACbyB,UAAU;YACVC,MAAMvB,IAAIW,GAAG;YACbJ,WAAWA,aAAaN,IAAIuB,MAAM;QACpC;QAEJ,MAAMT,OAAO,MAAMnB,qBAAqB;YACtCwB,MAAM;gBAAEP,UAAUb,IAAIa,QAAQ;gBAAEF,KAAKU;YAAQ;YAC7CpB;YACAC;QACF;QAEA,MAAMe,WAAWF,KAAKE,QAAQ,IAAIjB,IAAIkB,QAAQ;QAE9C,IAAI,CAACD,UAAU;YACb,MAAM,IAAIvB,mBAAmBO,IAAIkB,CAAC,EAAE,CAAC,uCAAuC,EAAEnB,IAAIa,QAAQ,EAAE;QAC9F;QAEA,OAAO;YACLO,MAAML,KAAKK,IAAI;YACfH;QACF;IACF;IAEA,MAAM,IAAID,MAAM;AAClB,EAAC"}

package/dist/utilities/getImportFieldFunctions.d.ts

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

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

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

package/dist/utilities/getImportFieldFunctions.js

@@ -1,116 +1,108 @@
-import { traverseFields } from 'payload';
+import { registerFieldHooks } from './flattenedFields.js';
 /**
- * Gets custom fromCSV field functions for import.
- * These functions transform field values when unflattening CSV data for import.
+ * Builds a map from logical field path (e.g. `content_textBlock_body`) to
+ * the import hook entry. Paths include block slugs but never array indices.
  */ export const getImportFieldFunctions = ({ fields })=>{
     const result = {};
-    const buildCustomFunctions = ({ field, parentRef, ref })=>{
-        // @ts-expect-error ref is untyped
-        ref.prefix = parentRef.prefix || '';
-        if (field.type === 'group' || field.type === 'tab') {
-            // @ts-expect-error ref is untyped
-            const parentPrefix = parentRef?.prefix ? `${parentRef.prefix}_` : '';
-            // @ts-expect-error ref is untyped
-            ref.prefix = `${parentPrefix}${field.name}_`;
+    registerFieldHooks(fields, '', result, registerImportHandler);
+    return result;
+};
+const registerImportHandler = (field, fullKey, result)=>{
+    const beforeImport = field.custom?.['plugin-import-export']?.hooks?.beforeImport;
+    if (typeof beforeImport === 'function') {
+        result[fullKey] = {
+            type: 'beforeImport',
+            fn: beforeImport
+        };
+        return;
+    }
+    const registerBeforeImport = (fn)=>{
+        result[fullKey] = {
+            type: 'beforeImport',
+            fn
+        };
+    };
+    if (field.type === 'relationship' || field.type === 'upload') {
+        if (field.hasMany !== true) {
+            if (!Array.isArray(field.relationTo)) {
+                registerBeforeImport(({ value })=>value);
+            }
+        } else if (!Array.isArray(field.relationTo)) {
+            registerBeforeImport(({ value })=>value);
         }
-        if (typeof field.custom?.['plugin-import-export']?.fromCSV === 'function') {
-            // @ts-expect-error ref is untyped
-            result[`${ref.prefix}${field.name}`] = field.custom['plugin-import-export']?.fromCSV;
-        } else if (field.type === 'relationship' || field.type === 'upload') {
-            if (field.hasMany !== true) {
-                if (!Array.isArray(field.relationTo)) {
-                    // monomorphic single relationship - simple ID to value conversion
-                    // @ts-expect-error ref is untyped
-                    result[`${ref.prefix}${field.name}`] = ({ value })=>{
-                        // If it's already an object (from JSON import), return as-is
-                        if (typeof value === 'object' && value !== null) {
-                            return value;
-                        }
-                        // Convert string/number ID to relationship value
-                        return value;
-                    };
-                } else {
-                // Polymorphic single: handled in unflattenObject via _id/_relationTo columns
-                }
-            } else {
-                if (!Array.isArray(field.relationTo)) {
-                    // @ts-expect-error ref is untyped
-                    result[`${ref.prefix}${field.name}`] = ({ value })=>{
-                        if (Array.isArray(value)) {
-                            return value;
-                        }
-                        return value;
-                    };
-                } else {
-                // Polymorphic many: handled in unflattenObject
-                }
+        return;
+    }
+    if (field.type === 'number') {
+        if (field.hasMany) {
+            registerBeforeImport(({ value })=>value);
+            return;
+        }
+        registerBeforeImport(({ value })=>{
+            if (isEmptyImportValue(value)) {
+                return undefined;
             }
-        } else if (field.type === 'number') {
-            if (field.hasMany) {
-                // @ts-expect-error ref is untyped
-                result[`${ref.prefix}${field.name}`] = ({ value })=>value;
-            } else {
-                // @ts-expect-error ref is untyped
-                result[`${ref.prefix}${field.name}`] = ({ value })=>{
-                    if (typeof value === 'number') {
-                        return value;
-                    }
-                    if (typeof value === 'string') {
-                        const parsed = parseFloat(value);
-                        return isNaN(parsed) ? 0 : parsed;
-                    }
-                    return value;
-                };
+            if (typeof value === 'number') {
+                return value;
             }
-        } else if (field.type === 'checkbox') {
-            // @ts-expect-error ref is untyped
-            result[`${ref.prefix}${field.name}`] = ({ value })=>{
-                if (typeof value === 'boolean') {
-                    return value;
-                }
-                if (typeof value === 'string') {
-                    return value.toLowerCase() === 'true' || value === '1';
-                }
-                return Boolean(value);
-            };
-        } else if (field.type === 'date') {
-            // @ts-expect-error ref is untyped
-            result[`${ref.prefix}${field.name}`] = ({ value })=>{
-                if (!value) {
-                    return value;
-                }
-                if (typeof value === 'string' && !isNaN(Date.parse(value))) {
-                    return value;
-                }
+            if (typeof value === 'string') {
+                const parsed = parseFloat(value);
+                return isNaN(parsed) ? undefined : parsed;
+            }
+            return value;
+        });
+        return;
+    }
+    if (field.type === 'checkbox') {
+        registerBeforeImport(({ value })=>{
+            if (isEmptyImportValue(value)) {
+                return undefined;
+            }
+            if (typeof value === 'boolean') {
+                return value;
+            }
+            if (typeof value === 'string') {
+                return value.toLowerCase() === 'true' || value === '1';
+            }
+            return Boolean(value);
+        });
+        return;
+    }
+    if (field.type === 'date') {
+        registerBeforeImport(({ value })=>{
+            if (isEmptyImportValue(value)) {
+                return undefined;
+            }
+            if (typeof value === 'string' && !isNaN(Date.parse(value))) {
+                return value;
+            }
+            try {
+                const date = new Date(value);
+                return isNaN(date.getTime()) ? value : date.toISOString();
+            } catch  {
+                return value;
+            }
+        });
+        return;
+    }
+    if (field.type === 'json' || field.type === 'richText') {
+        registerBeforeImport(({ value })=>{
+            if (isEmptyImportValue(value)) {
+                return undefined;
+            }
+            if (typeof value === 'object') {
+                return value;
+            }
+            if (typeof value === 'string') {
                 try {
-                    const date = new Date(value);
-                    return isNaN(date.getTime()) ? value : date.toISOString();
+                    return JSON.parse(value);
                 } catch  {
                     return value;
                 }
-            };
-        } else if (field.type === 'json' || field.type === 'richText') {
-            // @ts-expect-error ref is untyped
-            result[`${ref.prefix}${field.name}`] = ({ value })=>{
-                if (typeof value === 'object') {
-                    return value;
-                }
-                if (typeof value === 'string') {
-                    try {
-                        return JSON.parse(value);
-                    } catch  {
-                        return value;
-                    }
-                }
-                return value;
-            };
-        }
-    };
-    traverseFields({
-        callback: buildCustomFunctions,
-        fields
-    });
-    return result;
+            }
+            return value;
+        });
+    }
 };
+const isEmptyImportValue = (value)=>value === '' || value === null || value === undefined;
 
 //# sourceMappingURL=getImportFieldFunctions.js.map

package/dist/utilities/getImportFieldFunctions.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utilities/getImportFieldFunctions.ts"],"sourcesContent":["import { type FlattenedField, traverseFields, type TraverseFieldsCallback } from 'payload'\n\nimport type { FromCSVFunction } from '../types.js'\n\ntype Args = {\n  fields: FlattenedField[]\n}\n\n/**\n * Gets custom fromCSV field functions for import.\n * These functions transform field values when unflattening CSV data for import.\n */\nexport const getImportFieldFunctions = ({ fields }: Args): Record<string, FromCSVFunction> => {\n  const result: Record<string, FromCSVFunction> = {}\n\n  const buildCustomFunctions: TraverseFieldsCallback = ({ field, parentRef, ref }) => {\n    // @ts-expect-error ref is untyped\n    ref.prefix = parentRef.prefix || ''\n    if (field.type === 'group' || field.type === 'tab') {\n      // @ts-expect-error ref is untyped\n      const parentPrefix = parentRef?.prefix ? `${parentRef.prefix}_` : ''\n      // @ts-expect-error ref is untyped\n      ref.prefix = `${parentPrefix}${field.name}_`\n    }\n\n    if (typeof field.custom?.['plugin-import-export']?.fromCSV === 'function') {\n      // @ts-expect-error ref is untyped\n      result[`${ref.prefix}${field.name}`] = field.custom['plugin-import-export']?.fromCSV\n    } else if (field.type === 'relationship' || field.type === 'upload') {\n      if (field.hasMany !== true) {\n        if (!Array.isArray(field.relationTo)) {\n          // monomorphic single relationship - simple ID to value conversion\n          // @ts-expect-error ref is untyped\n          result[`${ref.prefix}${field.name}`] = ({ value }) => {\n            // If it's already an object (from JSON import), return as-is\n            if (typeof value === 'object' && value !== null) {\n              return value\n            }\n            // Convert string/number ID to relationship value\n            return value\n          }\n        } else {\n          // Polymorphic single: handled in unflattenObject via _id/_relationTo columns\n        }\n      } else {\n        if (!Array.isArray(field.relationTo)) {\n          // @ts-expect-error ref is untyped\n          result[`${ref.prefix}${field.name}`] = ({ value }) => {\n            if (Array.isArray(value)) {\n              return value\n            }\n            return value\n          }\n        } else {\n          // Polymorphic many: handled in unflattenObject\n        }\n      }\n    } else if (field.type === 'number') {\n      if (field.hasMany) {\n        // @ts-expect-error ref is untyped\n        result[`${ref.prefix}${field.name}`] = ({ value }) => value\n      } else {\n        // @ts-expect-error ref is untyped\n        result[`${ref.prefix}${field.name}`] = ({ value }) => {\n          if (typeof value === 'number') {\n            return value\n          }\n          if (typeof value === 'string') {\n            const parsed = parseFloat(value)\n            return isNaN(parsed) ? 0 : parsed\n          }\n          return value\n        }\n      }\n    } else if (field.type === 'checkbox') {\n      // @ts-expect-error ref is untyped\n      result[`${ref.prefix}${field.name}`] = ({ value }) => {\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    } else if (field.type === 'date') {\n      // @ts-expect-error ref is untyped\n      result[`${ref.prefix}${field.name}`] = ({ value }) => {\n        if (!value) {\n          return value\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    } else if (field.type === 'json' || field.type === 'richText') {\n      // @ts-expect-error ref is untyped\n      result[`${ref.prefix}${field.name}`] = ({ value }) => {\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\n  traverseFields({ callback: buildCustomFunctions, fields })\n\n  return result\n}\n"],"names":["traverseFields","getImportFieldFunctions","fields","result","buildCustomFunctions","field","parentRef","ref","prefix","type","parentPrefix","name","custom","fromCSV","hasMany","Array","isArray","relationTo","value","parsed","parseFloat","isNaN","toLowerCase","Boolean","Date","parse","date","getTime","toISOString","JSON","callback"],"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"}