@payloadcms/plugin-import-export 3.91.0-internal.c1569dc → 4.0.0-beta.1

package/dist/utilities/setNestedValue.spec.js

@@ -1,214 +0,0 @@
-import { APIError } from 'payload';
-import { describe, expect, it } from 'vitest';
-import { setNestedValue } from './setNestedValue.js';
-const unsupportedSegments = [
-    '__proto__'
-];
-const unsupportedPaths = unsupportedSegments.flatMap((segment)=>[
-        `${segment}.value`,
-        `group.${segment}.value`,
-        `group.${segment}`,
-        `items.${segment}.0.value`,
-        `items.0.${segment}.value`,
-        `items.0.${segment}`
-    ]);
-describe('setNestedValue', ()=>{
-    it.each(unsupportedPaths)('rejects invalid field path %s without changing the target', (path)=>{
-        const target = {
-            stable: {
-                value: true
-            }
-        };
-        const objectPrototypeBefore = Object.getOwnPropertyDescriptors(Object.prototype);
-        const targetPrototypeBefore = Object.getPrototypeOf(target);
-        try {
-            setNestedValue(target, path, true);
-            expect.fail('Expected setNestedValue to reject the invalid field path');
-        } catch (error) {
-            expect(error).toBeInstanceOf(APIError);
-            if (error instanceof APIError) {
-                expect(error.status).toBe(400);
-                expect(error.isPublic).toBe(true);
-            }
-        }
-        expect(target).toEqual({
-            stable: {
-                value: true
-            }
-        });
-        expect(Object.getPrototypeOf(target)).toBe(targetPrototypeBefore);
-        expect(Object.getOwnPropertyDescriptors(Object.prototype)).toEqual(objectPrototypeBefore);
-    });
-    it('should build nested values from owned data', ()=>{
-        const inheritedContainer = 'constrainedNestedContainer';
-        const target = {};
-        const source = {};
-        const objectPrototypeBefore = Object.getOwnPropertyDescriptors(Object.prototype);
-        const originalContainerDescriptor = Object.getOwnPropertyDescriptor(Object.prototype, inheritedContainer);
-        let inheritedGetterCalls = 0;
-        let inheritedSetterCalls = 0;
-        try {
-            Object.defineProperty(Object.prototype, inheritedContainer, {
-                configurable: true,
-                get: ()=>{
-                    inheritedGetterCalls += 1;
-                    return {
-                        value: 'inherited'
-                    };
-                },
-                set: ()=>{
-                    inheritedSetterCalls += 1;
-                }
-            });
-            setNestedValue(target, 'constructor.prototype.value', 'example');
-            setNestedValue(target, 'prototype.value', 'example');
-            setNestedValue(target, `${inheritedContainer}.value`, 'local', source);
-        } finally{
-            if (originalContainerDescriptor) {
-                Object.defineProperty(Object.prototype, inheritedContainer, originalContainerDescriptor);
-            } else {
-                delete Object.prototype[inheritedContainer];
-            }
-        }
-        expect(inheritedGetterCalls).toBe(0);
-        expect(inheritedSetterCalls).toBe(0);
-        expect(Object.hasOwn(target, 'constructor')).toBe(true);
-        expect(Object.hasOwn(target, 'prototype')).toBe(true);
-        expect(target).toEqual({
-            [inheritedContainer]: {
-                value: 'local'
-            },
-            constructor: {
-                prototype: {
-                    value: 'example'
-                }
-            },
-            prototype: {
-                value: 'example'
-            }
-        });
-        expect(Object.getPrototypeOf(target.constructor)).toBeNull();
-        expect(Object.getPrototypeOf(target.prototype)).toBeNull();
-        expect(Object.getOwnPropertyDescriptors(Object.prototype)).toEqual(objectPrototypeBefore);
-    });
-    it('rejects field paths with out-of-range array indexes', ()=>{
-        const source = {
-            items: [
-                {
-                    value: true
-                }
-            ]
-        };
-        const target = {};
-        expect(()=>setNestedValue(target, 'items.4294967294.value', true, source)).toThrow(APIError);
-        expect(target).toEqual({
-            items: []
-        });
-    });
-    it('supports out-of-order array indexes that exist in the source document', ()=>{
-        const source = {
-            items: [
-                {
-                    value: 'first'
-                },
-                {
-                    value: 'second'
-                },
-                {
-                    value: 'third'
-                }
-            ]
-        };
-        const target = {};
-        setNestedValue(target, 'items.2.value', 'third', source);
-        expect(target).toEqual({
-            items: [
-                undefined,
-                undefined,
-                {
-                    value: 'third'
-                }
-            ]
-        });
-    });
-    it.each([
-        '-1',
-        '+1',
-        '01',
-        ' 1',
-        '1 ',
-        '1e2',
-        '0x10',
-        'Infinity',
-        '9007199254740992'
-    ])('treats noncanonical numeric segment %s as an object key', (segment)=>{
-        const target = {};
-        setNestedValue(target, `items.${segment}.value`, 'example');
-        expect(Array.isArray(target.items)).toBe(false);
-        expect(target).toEqual({
-            items: {
-                [segment]: {
-                    value: 'example'
-                }
-            }
-        });
-    });
-    it('builds nested objects and arrays', ()=>{
-        const target = {};
-        setNestedValue(target, 'group.items.0.title', 'first');
-        setNestedValue(target, 'group.items.0.description', 'description');
-        setNestedValue(target, 'group.items.1.title', 'second');
-        expect(target).toEqual({
-            group: {
-                items: [
-                    {
-                        description: 'description',
-                        title: 'first'
-                    },
-                    {
-                        title: 'second'
-                    }
-                ]
-            }
-        });
-        const group = target.group;
-        const items = group.items;
-        expect(Object.getPrototypeOf(group)).toBeNull();
-        expect(Array.isArray(items)).toBe(true);
-        expect(Object.getPrototypeOf(items[0])).toBeNull();
-        expect(Object.getPrototypeOf(items[1])).toBeNull();
-    });
-    it('supports nested arrays using numeric lookahead', ()=>{
-        const target = {};
-        setNestedValue(target, 'matrix.0.1.value', 'nested');
-        expect(target).toEqual({
-            matrix: [
-                [
-                    undefined,
-                    {
-                        value: 'nested'
-                    }
-                ]
-            ]
-        });
-    });
-    it('creates own containers instead of traversing inherited properties', ()=>{
-        const inheritedGroup = {
-            inherited: true
-        };
-        const target = Object.create({
-            group: inheritedGroup
-        });
-        setNestedValue(target, 'group.value', 'own');
-        expect(Object.prototype.hasOwnProperty.call(target, 'group')).toBe(true);
-        expect(target.group).toEqual({
-            value: 'own'
-        });
-        expect(Object.getPrototypeOf(target.group)).toBeNull();
-        expect(inheritedGroup).toEqual({
-            inherited: true
-        });
-    });
-});
-
-//# sourceMappingURL=setNestedValue.spec.js.map

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utilities/setNestedValue.spec.ts"],"sourcesContent":["import { APIError } from 'payload'\nimport { describe, expect, it } from 'vitest'\n\nimport { setNestedValue } from './setNestedValue.js'\n\nconst unsupportedSegments = ['__proto__']\nconst unsupportedPaths = unsupportedSegments.flatMap((segment) => [\n  `${segment}.value`,\n  `group.${segment}.value`,\n  `group.${segment}`,\n  `items.${segment}.0.value`,\n  `items.0.${segment}.value`,\n  `items.0.${segment}`,\n])\n\ndescribe('setNestedValue', () => {\n  it.each(unsupportedPaths)('rejects invalid field path %s without changing the target', (path) => {\n    const target = { stable: { value: true } }\n    const objectPrototypeBefore = Object.getOwnPropertyDescriptors(Object.prototype)\n    const targetPrototypeBefore = Object.getPrototypeOf(target)\n\n    try {\n      setNestedValue(target, path, true)\n      expect.fail('Expected setNestedValue to reject the invalid field path')\n    } catch (error) {\n      expect(error).toBeInstanceOf(APIError)\n\n      if (error instanceof APIError) {\n        expect(error.status).toBe(400)\n        expect(error.isPublic).toBe(true)\n      }\n    }\n\n    expect(target).toEqual({ stable: { value: true } })\n    expect(Object.getPrototypeOf(target)).toBe(targetPrototypeBefore)\n    expect(Object.getOwnPropertyDescriptors(Object.prototype)).toEqual(objectPrototypeBefore)\n  })\n\n  it('should build nested values from owned data', () => {\n    const inheritedContainer = 'constrainedNestedContainer'\n    const target: Record<string, unknown> = {}\n    const source: Record<string, unknown> = {}\n    const objectPrototypeBefore = Object.getOwnPropertyDescriptors(Object.prototype)\n    const originalContainerDescriptor = Object.getOwnPropertyDescriptor(\n      Object.prototype,\n      inheritedContainer,\n    )\n    let inheritedGetterCalls = 0\n    let inheritedSetterCalls = 0\n\n    try {\n      Object.defineProperty(Object.prototype, inheritedContainer, {\n        configurable: true,\n        get: () => {\n          inheritedGetterCalls += 1\n          return { value: 'inherited' }\n        },\n        set: () => {\n          inheritedSetterCalls += 1\n        },\n      })\n\n      setNestedValue(target, 'constructor.prototype.value', 'example')\n      setNestedValue(target, 'prototype.value', 'example')\n      setNestedValue(target, `${inheritedContainer}.value`, 'local', source)\n    } finally {\n      if (originalContainerDescriptor) {\n        Object.defineProperty(Object.prototype, inheritedContainer, originalContainerDescriptor)\n      } else {\n        delete (Object.prototype as Record<string, unknown>)[inheritedContainer]\n      }\n    }\n\n    expect(inheritedGetterCalls).toBe(0)\n    expect(inheritedSetterCalls).toBe(0)\n    expect(Object.hasOwn(target, 'constructor')).toBe(true)\n    expect(Object.hasOwn(target, 'prototype')).toBe(true)\n    expect(target).toEqual({\n      [inheritedContainer]: {\n        value: 'local',\n      },\n      constructor: {\n        prototype: {\n          value: 'example',\n        },\n      },\n      prototype: {\n        value: 'example',\n      },\n    })\n    expect(Object.getPrototypeOf(target.constructor)).toBeNull()\n    expect(Object.getPrototypeOf(target.prototype)).toBeNull()\n    expect(Object.getOwnPropertyDescriptors(Object.prototype)).toEqual(objectPrototypeBefore)\n  })\n\n  it('rejects field paths with out-of-range array indexes', () => {\n    const source = { items: [{ value: true }] }\n    const target: Record<string, unknown> = {}\n\n    expect(() => setNestedValue(target, 'items.4294967294.value', true, source)).toThrow(APIError)\n    expect(target).toEqual({ items: [] })\n  })\n\n  it('supports out-of-order array indexes that exist in the source document', () => {\n    const source = { items: [{ value: 'first' }, { value: 'second' }, { value: 'third' }] }\n    const target: Record<string, unknown> = {}\n\n    setNestedValue(target, 'items.2.value', 'third', source)\n\n    expect(target).toEqual({ items: [undefined, undefined, { value: 'third' }] })\n  })\n\n  it.each(['-1', '+1', '01', ' 1', '1 ', '1e2', '0x10', 'Infinity', '9007199254740992'])(\n    'treats noncanonical numeric segment %s as an object key',\n    (segment) => {\n      const target: Record<string, unknown> = {}\n\n      setNestedValue(target, `items.${segment}.value`, 'example')\n\n      expect(Array.isArray(target.items)).toBe(false)\n      expect(target).toEqual({ items: { [segment]: { value: 'example' } } })\n    },\n  )\n\n  it('builds nested objects and arrays', () => {\n    const target: Record<string, unknown> = {}\n\n    setNestedValue(target, 'group.items.0.title', 'first')\n    setNestedValue(target, 'group.items.0.description', 'description')\n    setNestedValue(target, 'group.items.1.title', 'second')\n\n    expect(target).toEqual({\n      group: {\n        items: [{ description: 'description', title: 'first' }, { title: 'second' }],\n      },\n    })\n\n    const group = target.group as Record<string, unknown>\n    const items = group.items as Record<string, unknown>[]\n\n    expect(Object.getPrototypeOf(group)).toBeNull()\n    expect(Array.isArray(items)).toBe(true)\n    expect(Object.getPrototypeOf(items[0])).toBeNull()\n    expect(Object.getPrototypeOf(items[1])).toBeNull()\n  })\n\n  it('supports nested arrays using numeric lookahead', () => {\n    const target: Record<string, unknown> = {}\n\n    setNestedValue(target, 'matrix.0.1.value', 'nested')\n\n    expect(target).toEqual({\n      matrix: [[undefined, { value: 'nested' }]],\n    })\n  })\n\n  it('creates own containers instead of traversing inherited properties', () => {\n    const inheritedGroup = { inherited: true }\n    const target = Object.create({ group: inheritedGroup }) as Record<string, unknown>\n\n    setNestedValue(target, 'group.value', 'own')\n\n    expect(Object.prototype.hasOwnProperty.call(target, 'group')).toBe(true)\n    expect(target.group).toEqual({ value: 'own' })\n    expect(Object.getPrototypeOf(target.group)).toBeNull()\n    expect(inheritedGroup).toEqual({ inherited: true })\n  })\n})\n"],"names":["APIError","describe","expect","it","setNestedValue","unsupportedSegments","unsupportedPaths","flatMap","segment","each","path","target","stable","value","objectPrototypeBefore","Object","getOwnPropertyDescriptors","prototype","targetPrototypeBefore","getPrototypeOf","fail","error","toBeInstanceOf","status","toBe","isPublic","toEqual","inheritedContainer","source","originalContainerDescriptor","getOwnPropertyDescriptor","inheritedGetterCalls","inheritedSetterCalls","defineProperty","configurable","get","set","hasOwn","toBeNull","items","toThrow","undefined","Array","isArray","group","description","title","matrix","inheritedGroup","inherited","create","hasOwnProperty","call"],"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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"}