@payloadcms/plugin-import-export 4.0.0-internal.d28e9fb → 4.0.0-internal.d7d662c

package/dist/utilities/parseCSV.spec.js

@@ -1,195 +0,0 @@
-import { parseCSV } from './parseCSV.js';
-import { describe, it, expect, vi } from 'vitest';
-describe('parseCSV', ()=>{
-    const mockReq = {
-        payload: {
-            logger: {
-                error: vi.fn()
-            }
-        }
-    };
-    describe('cast function behavior', ()=>{
-        it('should preserve comma-separated values as strings', async ()=>{
-            const csvData = Buffer.from('numbers,ids\n"1,2,3,5,8","id1,id2,id3"');
-            const result = await parseCSV({
-                data: csvData,
-                req: mockReq
-            });
-            expect(result).toEqual([
-                {
-                    numbers: '1,2,3,5,8',
-                    ids: 'id1,id2,id3'
-                }
-            ]);
-        });
-        it('should convert single numbers to numbers', async ()=>{
-            const csvData = Buffer.from('single,decimal\n"42","3.14"');
-            const result = await parseCSV({
-                data: csvData,
-                req: mockReq
-            });
-            expect(result).toEqual([
-                {
-                    single: 42,
-                    decimal: 3.14
-                }
-            ]);
-        });
-        it('should handle booleans correctly', async ()=>{
-            const csvData = Buffer.from('bool1,bool2,notBool\n"true","false","True"');
-            const result = await parseCSV({
-                data: csvData,
-                req: mockReq
-            });
-            expect(result).toEqual([
-                {
-                    bool1: true,
-                    bool2: false,
-                    notBool: 'True'
-                }
-            ]);
-        });
-        it('should convert empty strings to undefined', async ()=>{
-            const csvData = Buffer.from('field1,field2\n"","value"');
-            const result = await parseCSV({
-                data: csvData,
-                req: mockReq
-            });
-            expect(result).toEqual([
-                {
-                    // field1 is undefined (not present) - empty cells don't update fields
-                    field2: 'value'
-                }
-            ]);
-        });
-        it('should handle null strings', async ()=>{
-            const csvData = Buffer.from('field1,field2,field3\n"null","NULL","Null"');
-            const result = await parseCSV({
-                data: csvData,
-                req: mockReq
-            });
-            expect(result).toEqual([
-                {
-                    field1: null,
-                    field2: null,
-                    field3: 'Null'
-                }
-            ]);
-        });
-        it('should preserve spaces in comma-separated values', async ()=>{
-            const csvData = Buffer.from('numbers\n" 10 , 20 , 30 "');
-            const result = await parseCSV({
-                data: csvData,
-                req: mockReq
-            });
-            expect(result).toEqual([
-                {
-                    numbers: ' 10 , 20 , 30 '
-                }
-            ]);
-        });
-        it('should handle mixed comma-separated values with empty entries', async ()=>{
-            const csvData = Buffer.from('mixed\n"1,,3,,5"');
-            const result = await parseCSV({
-                data: csvData,
-                req: mockReq
-            });
-            expect(result).toEqual([
-                {
-                    mixed: '1,,3,,5'
-                }
-            ]);
-        });
-        it('should handle MongoDB ObjectIds as strings', async ()=>{
-            const csvData = Buffer.from('id\n"507f1f77bcf86cd799439011"');
-            const result = await parseCSV({
-                data: csvData,
-                req: mockReq
-            });
-            expect(result).toEqual([
-                {
-                    id: '507f1f77bcf86cd799439011'
-                }
-            ]);
-        });
-        it('should handle multiple rows with various data types', async ()=>{
-            const csvData = Buffer.from('title,count,tags,active\n' + '"Item 1","5","tag1,tag2,tag3","true"\n' + '"Item 2","","","false"\n' + '"Item 3","10","single",""\n');
-            const result = await parseCSV({
-                data: csvData,
-                req: mockReq
-            });
-            expect(result).toEqual([
-                {
-                    title: 'Item 1',
-                    count: 5,
-                    tags: 'tag1,tag2,tag3',
-                    active: true
-                },
-                {
-                    title: 'Item 2',
-                    // count is undefined (empty cell - field not updated)
-                    // tags is undefined (empty cell - field not updated)
-                    active: false
-                },
-                {
-                    title: 'Item 3',
-                    count: 10,
-                    tags: 'single'
-                }
-            ]);
-        });
-        it('should skip empty lines', async ()=>{
-            const csvData = Buffer.from('field\n"value1"\n\n"value2"\n\n');
-            const result = await parseCSV({
-                data: csvData,
-                req: mockReq
-            });
-            expect(result).toEqual([
-                {
-                    field: 'value1'
-                },
-                {
-                    field: 'value2'
-                }
-            ]);
-        });
-        it('should strip UTF-8 BOM from column names', async ()=>{
-            // UTF-8 BOM is 0xEF 0xBB 0xBF
-            const bomBytes = Buffer.from([
-                0xef,
-                0xbb,
-                0xbf
-            ]);
-            const csvContent = Buffer.from('id,title,createdAt\ntesssst,test,2026-02-11T21:03:39.020Z');
-            const csvWithBOM = Buffer.concat([
-                bomBytes,
-                csvContent
-            ]);
-            const result = await parseCSV({
-                data: csvWithBOM,
-                req: mockReq
-            });
-            expect(result).toEqual([
-                {
-                    id: 'tesssst',
-                    title: 'test',
-                    createdAt: '2026-02-11T21:03:39.020Z'
-                }
-            ]);
-            // Verify the column name is exactly "id" without BOM character
-            expect(Object.keys(result[0])[0]).toBe('id');
-        });
-    });
-    describe('error handling', ()=>{
-        it('should handle parsing errors', async ()=>{
-            const invalidCsv = Buffer.from('field1,field2\n"value1');
-            await expect(parseCSV({
-                data: invalidCsv,
-                req: mockReq
-            })).rejects.toThrow();
-            expect(mockReq.payload.logger.error).toHaveBeenCalled();
-        });
-    });
-});
-
-//# sourceMappingURL=parseCSV.spec.js.map

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utilities/parseCSV.spec.ts"],"sourcesContent":["import { PayloadRequest } from 'payload'\n\nimport { parseCSV } from './parseCSV.js'\nimport { describe, it, expect, vi } from 'vitest'\n\ndescribe('parseCSV', () => {\n  const mockReq = {\n    payload: {\n      logger: {\n        error: vi.fn(),\n      },\n    },\n  } as unknown as PayloadRequest\n\n  describe('cast function behavior', () => {\n    it('should preserve comma-separated values as strings', async () => {\n      const csvData = Buffer.from('numbers,ids\\n\"1,2,3,5,8\",\"id1,id2,id3\"')\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([\n        {\n          numbers: '1,2,3,5,8',\n          ids: 'id1,id2,id3',\n        },\n      ])\n    })\n\n    it('should convert single numbers to numbers', async () => {\n      const csvData = Buffer.from('single,decimal\\n\"42\",\"3.14\"')\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([\n        {\n          single: 42,\n          decimal: 3.14,\n        },\n      ])\n    })\n\n    it('should handle booleans correctly', async () => {\n      const csvData = Buffer.from('bool1,bool2,notBool\\n\"true\",\"false\",\"True\"')\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([\n        {\n          bool1: true,\n          bool2: false,\n          notBool: 'True', // Case-sensitive\n        },\n      ])\n    })\n\n    it('should convert empty strings to undefined', async () => {\n      const csvData = Buffer.from('field1,field2\\n\"\",\"value\"')\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([\n        {\n          // field1 is undefined (not present) - empty cells don't update fields\n          field2: 'value',\n        },\n      ])\n    })\n\n    it('should handle null strings', async () => {\n      const csvData = Buffer.from('field1,field2,field3\\n\"null\",\"NULL\",\"Null\"')\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([\n        {\n          field1: null,\n          field2: null,\n          field3: 'Null', // Case-sensitive for mixed case\n        },\n      ])\n    })\n\n    it('should preserve spaces in comma-separated values', async () => {\n      const csvData = Buffer.from('numbers\\n\" 10 , 20 , 30 \"')\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([\n        {\n          numbers: ' 10 , 20 , 30 ', // CSV parser trims outer quotes but preserves the content\n        },\n      ])\n    })\n\n    it('should handle mixed comma-separated values with empty entries', async () => {\n      const csvData = Buffer.from('mixed\\n\"1,,3,,5\"')\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([\n        {\n          mixed: '1,,3,,5',\n        },\n      ])\n    })\n\n    it('should handle MongoDB ObjectIds as strings', async () => {\n      const csvData = Buffer.from('id\\n\"507f1f77bcf86cd799439011\"')\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([\n        {\n          id: '507f1f77bcf86cd799439011',\n        },\n      ])\n    })\n\n    it('should handle multiple rows with various data types', async () => {\n      const csvData = Buffer.from(\n        'title,count,tags,active\\n' +\n          '\"Item 1\",\"5\",\"tag1,tag2,tag3\",\"true\"\\n' +\n          '\"Item 2\",\"\",\"\",\"false\"\\n' +\n          '\"Item 3\",\"10\",\"single\",\"\"\\n',\n      )\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([\n        {\n          title: 'Item 1',\n          count: 5,\n          tags: 'tag1,tag2,tag3',\n          active: true,\n        },\n        {\n          title: 'Item 2',\n          // count is undefined (empty cell - field not updated)\n          // tags is undefined (empty cell - field not updated)\n          active: false,\n        },\n        {\n          title: 'Item 3',\n          count: 10,\n          tags: 'single',\n          // active is undefined (empty cell - field not updated)\n        },\n      ])\n    })\n\n    it('should skip empty lines', async () => {\n      const csvData = Buffer.from('field\\n\"value1\"\\n\\n\"value2\"\\n\\n')\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([{ field: 'value1' }, { field: 'value2' }])\n    })\n\n    it('should strip UTF-8 BOM from column names', async () => {\n      // UTF-8 BOM is 0xEF 0xBB 0xBF\n      const bomBytes = Buffer.from([0xef, 0xbb, 0xbf])\n      const csvContent = Buffer.from('id,title,createdAt\\ntesssst,test,2026-02-11T21:03:39.020Z')\n      const csvWithBOM = Buffer.concat([bomBytes, csvContent])\n\n      const result = await parseCSV({ data: csvWithBOM, req: mockReq })\n\n      expect(result).toEqual([\n        {\n          id: 'tesssst',\n          title: 'test',\n          createdAt: '2026-02-11T21:03:39.020Z',\n        },\n      ])\n\n      // Verify the column name is exactly \"id\" without BOM character\n      expect(Object.keys(result[0])[0]).toBe('id')\n    })\n  })\n\n  describe('error handling', () => {\n    it('should handle parsing errors', async () => {\n      const invalidCsv = Buffer.from('field1,field2\\n\"value1')\n\n      await expect(parseCSV({ data: invalidCsv, req: mockReq })).rejects.toThrow()\n      expect(mockReq.payload.logger.error).toHaveBeenCalled()\n    })\n  })\n})\n"],"names":["parseCSV","describe","it","expect","vi","mockReq","payload","logger","error","fn","csvData","Buffer","from","result","data","req","toEqual","numbers","ids","single","decimal","bool1","bool2","notBool","field2","field1","field3","mixed","id","title","count","tags","active","field","bomBytes","csvContent","csvWithBOM","concat","createdAt","Object","keys","toBe","invalidCsv","rejects","toThrow","toHaveBeenCalled"],"mappings":"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"}

package/dist/utilities/siblingDoc.spec.js

@@ -1,278 +0,0 @@
-import { applyFieldHooks } from './applyFieldHooks.js';
-import { flattenObject } from './flattenObject.js';
-import { getExportFieldFunctions } from './getExportFieldFunctions.js';
-import { getImportFieldFunctions } from './getImportFieldFunctions.js';
-import { unflattenObject } from './unflattenObject.js';
-import { describe, expect, it, vi } from 'vitest';
-const mockReq = {
-    payload: {
-        logger: {
-            error: vi.fn()
-        }
-    }
-};
-describe('beforeExport / beforeImport siblingDoc arg', ()=>{
-    describe('CSV export (flattenObject)', ()=>{
-        it('passes the source doc at the current nesting level as siblingDoc', ()=>{
-            const received = [];
-            const fields = [
-                {
-                    name: 'title',
-                    type: 'text'
-                },
-                {
-                    name: 'group',
-                    type: 'group',
-                    flattenedFields: [
-                        {
-                            name: 'inner',
-                            type: 'text',
-                            custom: {
-                                'plugin-import-export': {
-                                    hooks: {
-                                        beforeExport: ({ columnName, siblingData, siblingDoc, value })=>{
-                                            received.push({
-                                                columnName,
-                                                isSiblingDocSource: siblingDoc && typeof siblingDoc === 'object' && siblingDoc.inner === value,
-                                                isSiblingDocRow: siblingDoc === siblingData
-                                            });
-                                            return value;
-                                        }
-                                    }
-                                }
-                            }
-                        }
-                    ]
-                }
-            ];
-            const exportFieldHooks = getExportFieldFunctions({
-                fields
-            });
-            flattenObject({
-                data: {
-                    group: {
-                        inner: 'deep'
-                    },
-                    title: 'Top'
-                },
-                exportFieldHooks,
-                format: 'csv',
-                req: mockReq
-            });
-            expect(received).toEqual([
-                {
-                    columnName: 'group_inner',
-                    isSiblingDocSource: true,
-                    isSiblingDocRow: false
-                }
-            ]);
-        });
-        it('lets a hook read another sibling by reading siblingDoc', ()=>{
-            const fields = [
-                {
-                    name: 'firstName',
-                    type: 'text'
-                },
-                {
-                    name: 'fullName',
-                    type: 'text',
-                    custom: {
-                        'plugin-import-export': {
-                            hooks: {
-                                beforeExport: ({ siblingDoc, value })=>{
-                                    const last = siblingDoc.lastName;
-                                    const first = siblingDoc.firstName;
-                                    if (first && last) {
-                                        return `${first} ${last}`;
-                                    }
-                                    return value;
-                                }
-                            }
-                        }
-                    }
-                },
-                {
-                    name: 'lastName',
-                    type: 'text'
-                }
-            ];
-            const exportFieldHooks = getExportFieldFunctions({
-                fields
-            });
-            const result = flattenObject({
-                data: {
-                    firstName: 'Ada',
-                    fullName: '(computed)',
-                    lastName: 'Lovelace'
-                },
-                exportFieldHooks,
-                format: 'csv',
-                req: mockReq
-            });
-            expect(result.fullName).toBe('Ada Lovelace');
-        });
-    });
-    describe('JSON export (applyFieldHooks)', ()=>{
-        it('passes the untouched source sibling as siblingDoc and the mutable output as siblingData', ()=>{
-            let capturedSiblingDoc = null;
-            let capturedSiblingData = null;
-            const fields = [
-                {
-                    name: 'outer',
-                    type: 'group',
-                    flattenedFields: [
-                        {
-                            name: 'tracked',
-                            type: 'text',
-                            custom: {
-                                'plugin-import-export': {
-                                    hooks: {
-                                        beforeExport: ({ siblingData, siblingDoc, value })=>{
-                                            capturedSiblingDoc = siblingDoc;
-                                            capturedSiblingData = siblingData;
-                                            siblingData.injected = 'written-into-output';
-                                            return String(value) + '_changed';
-                                        }
-                                    }
-                                }
-                            }
-                        }
-                    ]
-                }
-            ];
-            const exportFieldHooks = getExportFieldFunctions({
-                fields
-            });
-            const source = {
-                outer: {
-                    tracked: 'original'
-                }
-            };
-            applyFieldHooks({
-                data: source,
-                fieldHooks: exportFieldHooks,
-                fields,
-                format: 'json',
-                operation: 'export',
-                req: mockReq,
-                type: 'beforeExport'
-            });
-            expect(capturedSiblingDoc).toEqual({
-                tracked: 'original'
-            });
-            // The hook's mutation lives on siblingData, not siblingDoc
-            expect(capturedSiblingData?.injected).toBe('written-into-output');
-            expect(capturedSiblingDoc?.injected).toBeUndefined();
-            // And the source object itself is not mutated
-            expect(source).toEqual({
-                outer: {
-                    tracked: 'original'
-                }
-            });
-        });
-    });
-    describe('CSV import (unflattenObject)', ()=>{
-        it('passes the full flat row as siblingDoc (equal to data)', ()=>{
-            const received = [];
-            const fields = [
-                {
-                    name: 'title',
-                    type: 'text'
-                },
-                {
-                    name: 'note',
-                    type: 'text',
-                    custom: {
-                        'plugin-import-export': {
-                            hooks: {
-                                beforeImport: ({ data, siblingDoc, value })=>{
-                                    received.push({
-                                        siblingDocIsData: siblingDoc === data
-                                    });
-                                    return value;
-                                }
-                            }
-                        }
-                    }
-                }
-            ];
-            const importFieldHooks = getImportFieldFunctions({
-                fields
-            });
-            unflattenObject({
-                data: {
-                    note: 'hello',
-                    title: 'Top'
-                },
-                fields,
-                format: 'csv',
-                importFieldHooks,
-                req: mockReq
-            });
-            expect(received).toEqual([
-                {
-                    siblingDocIsData: true
-                }
-            ]);
-        });
-    });
-    describe('JSON import (applyFieldHooks)', ()=>{
-        it('passes the untouched source sibling as siblingDoc and the mutable output as siblingData', ()=>{
-            let capturedSiblingDoc = null;
-            let capturedSiblingData = null;
-            const fields = [
-                {
-                    name: 'outer',
-                    type: 'group',
-                    flattenedFields: [
-                        {
-                            name: 'tracked',
-                            type: 'text',
-                            custom: {
-                                'plugin-import-export': {
-                                    hooks: {
-                                        beforeImport: ({ siblingData, siblingDoc, value })=>{
-                                            capturedSiblingDoc = siblingDoc;
-                                            capturedSiblingData = siblingData;
-                                            siblingData.injected = 'written-into-output';
-                                            return value;
-                                        }
-                                    }
-                                }
-                            }
-                        }
-                    ]
-                }
-            ];
-            const importFieldHooks = getImportFieldFunctions({
-                fields
-            });
-            const source = {
-                outer: {
-                    tracked: 'original'
-                }
-            };
-            applyFieldHooks({
-                data: source,
-                fieldHooks: importFieldHooks,
-                fields,
-                format: 'json',
-                operation: 'import',
-                req: mockReq,
-                type: 'beforeImport'
-            });
-            expect(capturedSiblingDoc).toEqual({
-                tracked: 'original'
-            });
-            expect(capturedSiblingData?.injected).toBe('written-into-output');
-            expect(capturedSiblingDoc?.injected).toBeUndefined();
-            expect(source).toEqual({
-                outer: {
-                    tracked: 'original'
-                }
-            });
-        });
-    });
-});
-
-//# sourceMappingURL=siblingDoc.spec.js.map

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utilities/siblingDoc.spec.ts"],"sourcesContent":["import { FlattenedField, PayloadRequest } from 'payload'\n\nimport type { FieldBeforeExportHook, FieldBeforeImportHook } from '../types.js'\n\nimport { applyFieldHooks } from './applyFieldHooks.js'\nimport { flattenObject } from './flattenObject.js'\nimport { getExportFieldFunctions } from './getExportFieldFunctions.js'\nimport { getImportFieldFunctions } from './getImportFieldFunctions.js'\nimport { unflattenObject } from './unflattenObject.js'\n\nimport { describe, expect, it, vi } from 'vitest'\n\nconst mockReq = {\n  payload: {\n    logger: {\n      error: vi.fn(),\n    },\n  },\n} as unknown as PayloadRequest\n\ndescribe('beforeExport / beforeImport siblingDoc arg', () => {\n  describe('CSV export (flattenObject)', () => {\n    it('passes the source doc at the current nesting level as siblingDoc', () => {\n      const received: Array<{\n        columnName: string\n        isSiblingDocSource: boolean\n        isSiblingDocRow: boolean\n      }> = []\n\n      const fields: FlattenedField[] = [\n        { name: 'title', type: 'text' } as FlattenedField,\n        {\n          name: 'group',\n          type: 'group',\n          flattenedFields: [\n            {\n              name: 'inner',\n              type: 'text',\n              custom: {\n                'plugin-import-export': {\n                  hooks: {\n                    beforeExport: (({ columnName, siblingData, siblingDoc, value }) => {\n                      received.push({\n                        columnName,\n                        isSiblingDocSource:\n                          siblingDoc &&\n                          typeof siblingDoc === 'object' &&\n                          siblingDoc.inner === value,\n                        isSiblingDocRow: siblingDoc === siblingData,\n                      })\n                      return value\n                    }) satisfies FieldBeforeExportHook,\n                  },\n                },\n              },\n            },\n          ],\n        } as unknown as FlattenedField,\n      ]\n\n      const exportFieldHooks = getExportFieldFunctions({ fields })\n\n      flattenObject({\n        data: { group: { inner: 'deep' }, title: 'Top' },\n        exportFieldHooks,\n        format: 'csv',\n        req: mockReq,\n      })\n\n      expect(received).toEqual([\n        {\n          columnName: 'group_inner',\n          isSiblingDocSource: true,\n          isSiblingDocRow: false,\n        },\n      ])\n    })\n\n    it('lets a hook read another sibling by reading siblingDoc', () => {\n      const fields: FlattenedField[] = [\n        { name: 'firstName', type: 'text' } as FlattenedField,\n        {\n          name: 'fullName',\n          type: 'text',\n          custom: {\n            'plugin-import-export': {\n              hooks: {\n                beforeExport: (({ siblingDoc, value }) => {\n                  const last = siblingDoc.lastName as string | undefined\n                  const first = siblingDoc.firstName as string | undefined\n                  if (first && last) {\n                    return `${first} ${last}`\n                  }\n                  return value\n                }) satisfies FieldBeforeExportHook,\n              },\n            },\n          },\n        } as FlattenedField,\n        { name: 'lastName', type: 'text' } as FlattenedField,\n      ]\n\n      const exportFieldHooks = getExportFieldFunctions({ fields })\n\n      const result = flattenObject({\n        data: { firstName: 'Ada', fullName: '(computed)', lastName: 'Lovelace' },\n        exportFieldHooks,\n        format: 'csv',\n        req: mockReq,\n      })\n\n      expect(result.fullName).toBe('Ada Lovelace')\n    })\n  })\n\n  describe('JSON export (applyFieldHooks)', () => {\n    it('passes the untouched source sibling as siblingDoc and the mutable output as siblingData', () => {\n      let capturedSiblingDoc: Record<string, unknown> | null = null\n      let capturedSiblingData: Record<string, unknown> | null = null\n\n      const fields: FlattenedField[] = [\n        {\n          name: 'outer',\n          type: 'group',\n          flattenedFields: [\n            {\n              name: 'tracked',\n              type: 'text',\n              custom: {\n                'plugin-import-export': {\n                  hooks: {\n                    beforeExport: (({ siblingData, siblingDoc, value }) => {\n                      capturedSiblingDoc = siblingDoc\n                      capturedSiblingData = siblingData\n                      siblingData.injected = 'written-into-output'\n                      return String(value) + '_changed'\n                    }) satisfies FieldBeforeExportHook,\n                  },\n                },\n              },\n            },\n          ],\n        } as unknown as FlattenedField,\n      ]\n\n      const exportFieldHooks = getExportFieldFunctions({ fields })\n\n      const source = { outer: { tracked: 'original' } }\n\n      applyFieldHooks({\n        data: source,\n        fieldHooks: exportFieldHooks,\n        fields,\n        format: 'json',\n        operation: 'export',\n        req: mockReq,\n        type: 'beforeExport',\n      })\n\n      expect(capturedSiblingDoc).toEqual({ tracked: 'original' })\n      // The hook's mutation lives on siblingData, not siblingDoc\n      expect((capturedSiblingData as unknown as Record<string, unknown>)?.injected).toBe(\n        'written-into-output',\n      )\n      expect((capturedSiblingDoc as unknown as Record<string, unknown>)?.injected).toBeUndefined()\n      // And the source object itself is not mutated\n      expect(source).toEqual({ outer: { tracked: 'original' } })\n    })\n  })\n\n  describe('CSV import (unflattenObject)', () => {\n    it('passes the full flat row as siblingDoc (equal to data)', () => {\n      const received: Array<{ siblingDocIsData: boolean }> = []\n\n      const fields: FlattenedField[] = [\n        { name: 'title', type: 'text' } as FlattenedField,\n        {\n          name: 'note',\n          type: 'text',\n          custom: {\n            'plugin-import-export': {\n              hooks: {\n                beforeImport: (({ data, siblingDoc, value }) => {\n                  received.push({ siblingDocIsData: siblingDoc === data })\n                  return value\n                }) satisfies FieldBeforeImportHook,\n              },\n            },\n          },\n        } as FlattenedField,\n      ]\n\n      const importFieldHooks = getImportFieldFunctions({ fields })\n\n      unflattenObject({\n        data: { note: 'hello', title: 'Top' },\n        fields,\n        format: 'csv',\n        importFieldHooks,\n        req: mockReq,\n      })\n\n      expect(received).toEqual([{ siblingDocIsData: true }])\n    })\n  })\n\n  describe('JSON import (applyFieldHooks)', () => {\n    it('passes the untouched source sibling as siblingDoc and the mutable output as siblingData', () => {\n      let capturedSiblingDoc: Record<string, unknown> | null = null\n      let capturedSiblingData: Record<string, unknown> | null = null\n\n      const fields: FlattenedField[] = [\n        {\n          name: 'outer',\n          type: 'group',\n          flattenedFields: [\n            {\n              name: 'tracked',\n              type: 'text',\n              custom: {\n                'plugin-import-export': {\n                  hooks: {\n                    beforeImport: (({ siblingData, siblingDoc, value }) => {\n                      capturedSiblingDoc = siblingDoc\n                      capturedSiblingData = siblingData\n                      siblingData.injected = 'written-into-output'\n                      return value\n                    }) satisfies FieldBeforeImportHook,\n                  },\n                },\n              },\n            },\n          ],\n        } as unknown as FlattenedField,\n      ]\n\n      const importFieldHooks = getImportFieldFunctions({ fields })\n\n      const source = { outer: { tracked: 'original' } }\n\n      applyFieldHooks({\n        data: source,\n        fieldHooks: importFieldHooks,\n        fields,\n        format: 'json',\n        operation: 'import',\n        req: mockReq,\n        type: 'beforeImport',\n      })\n\n      expect(capturedSiblingDoc).toEqual({ tracked: 'original' })\n      expect((capturedSiblingData as unknown as Record<string, unknown>)?.injected).toBe(\n        'written-into-output',\n      )\n      expect((capturedSiblingDoc as unknown as Record<string, unknown>)?.injected).toBeUndefined()\n      expect(source).toEqual({ outer: { tracked: 'original' } })\n    })\n  })\n})\n"],"names":["applyFieldHooks","flattenObject","getExportFieldFunctions","getImportFieldFunctions","unflattenObject","describe","expect","it","vi","mockReq","payload","logger","error","fn","received","fields","name","type","flattenedFields","custom","hooks","beforeExport","columnName","siblingData","siblingDoc","value","push","isSiblingDocSource","inner","isSiblingDocRow","exportFieldHooks","data","group","title","format","req","toEqual","last","lastName","first","firstName","result","fullName","toBe","capturedSiblingDoc","capturedSiblingData","injected","String","source","outer","tracked","fieldHooks","operation","toBeUndefined","beforeImport","siblingDocIsData","importFieldHooks","note"],"mappings":"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"}