payload-mcp-toolkit 0.3.3 → 0.7.0

package/dist/__tests__/patch-global-layout.test.js

@@ -0,0 +1,474 @@
+import { describe, it, expect, vi } from 'vitest';
+import { introspectBlocks, buildBlockNestingMap } from '../introspection';
+import { createPatchGlobalLayoutTool } from '../tools/patch-global-layout';
+const Heading = {
+    slug: 'heading',
+    fields: [
+        {
+            name: 'text',
+            type: 'text'
+        }
+    ]
+};
+const CtaBanner = {
+    slug: 'ctaBanner',
+    fields: [
+        {
+            name: 'label',
+            type: 'text'
+        }
+    ]
+};
+const Container = {
+    slug: 'container',
+    fields: [
+        {
+            name: 'sections',
+            type: 'blocks',
+            blocks: [
+                Heading,
+                CtaBanner
+            ]
+        }
+    ]
+};
+const FooterGlobal = {
+    slug: 'footer',
+    versions: {
+        drafts: true
+    },
+    fields: [
+        {
+            name: 'sections',
+            type: 'blocks',
+            blocks: [
+                Heading,
+                CtaBanner,
+                Container
+            ]
+        }
+    ]
+};
+const PlainSettings = {
+    slug: 'plain',
+    fields: [
+        {
+            name: 'siteName',
+            type: 'text'
+        }
+    ]
+};
+function buildReq() {
+    return {
+        payload: {
+            findGlobal: vi.fn(),
+            updateGlobal: vi.fn(),
+            logger: {
+                info: vi.fn(),
+                warn: vi.fn(),
+                error: vi.fn()
+            }
+        },
+        context: {},
+        user: null
+    };
+}
+const allBlocks = [
+    Heading,
+    CtaBanner,
+    Container
+];
+const catalog = introspectBlocks(allBlocks);
+const nesting = buildBlockNestingMap([], [
+    FooterGlobal
+], allBlocks);
+const drafts = new Set([
+    'footer'
+]);
+describe('patchGlobalLayout', ()=>{
+    it('returns null when no global has a blocks field (factory short-circuit)', ()=>{
+        const emptyNesting = buildBlockNestingMap([], [
+            PlainSettings
+        ], allBlocks);
+        const tool = createPatchGlobalLayoutTool(catalog, emptyNesting, new Set());
+        expect(tool).toBeNull();
+    });
+    it('registers when at least one global has a blocks field', ()=>{
+        const tool = createPatchGlobalLayoutTool(catalog, nesting, drafts);
+        expect(tool).not.toBeNull();
+        expect(tool.name).toBe('patchGlobalLayout');
+    });
+    it('append: writes existing + new blocks back via updateGlobal', async ()=>{
+        const tool = createPatchGlobalLayoutTool(catalog, nesting, drafts);
+        const req = buildReq();
+        req.payload.findGlobal.mockResolvedValue({
+            sections: [
+                {
+                    blockType: 'heading',
+                    text: 'a'
+                }
+            ]
+        });
+        req.payload.updateGlobal.mockResolvedValue({});
+        await tool.handler({
+            slug: 'footer',
+            layoutField: 'sections',
+            blocks: [
+                {
+                    blockType: 'ctaBanner',
+                    label: 'Buy'
+                }
+            ],
+            operation: 'append'
+        }, req, {});
+        expect(req.payload.updateGlobal).toHaveBeenCalledWith(expect.objectContaining({
+            slug: 'footer',
+            draft: true,
+            data: {
+                sections: [
+                    {
+                        blockType: 'heading',
+                        text: 'a'
+                    },
+                    {
+                        blockType: 'ctaBanner',
+                        label: 'Buy'
+                    }
+                ]
+            }
+        }));
+    });
+    it('replaceAt index 0 swaps the first block', async ()=>{
+        const tool = createPatchGlobalLayoutTool(catalog, nesting, drafts);
+        const req = buildReq();
+        req.payload.findGlobal.mockResolvedValue({
+            sections: [
+                {
+                    blockType: 'heading',
+                    text: 'a'
+                },
+                {
+                    blockType: 'ctaBanner',
+                    label: 'old'
+                }
+            ]
+        });
+        req.payload.updateGlobal.mockResolvedValue({});
+        await tool.handler({
+            slug: 'footer',
+            layoutField: 'sections',
+            blocks: [
+                {
+                    blockType: 'heading',
+                    text: 'new-first'
+                }
+            ],
+            operation: 'replaceAt',
+            insertIndex: 0
+        }, req, {});
+        expect(req.payload.updateGlobal).toHaveBeenCalledWith(expect.objectContaining({
+            data: {
+                sections: [
+                    {
+                        blockType: 'heading',
+                        text: 'new-first'
+                    },
+                    {
+                        blockType: 'ctaBanner',
+                        label: 'old'
+                    }
+                ]
+            }
+        }));
+    });
+    it('rejects blocks whose slug is not in the field allow-list', async ()=>{
+        const tool = createPatchGlobalLayoutTool(catalog, nesting, drafts);
+        const req = buildReq();
+        const result = await tool.handler({
+            slug: 'footer',
+            layoutField: 'sections',
+            // ImageBlock is not in the FooterGlobal allow list.
+            blocks: [
+                {
+                    blockType: 'image',
+                    src: 'x'
+                }
+            ],
+            operation: 'full'
+        }, req, {});
+        const text = result.content[0].text;
+        expect(text).toMatch(/unknown blockType/i);
+        expect(text).toContain('image');
+        expect(req.payload.updateGlobal).not.toHaveBeenCalled();
+    });
+    it('validates nested blocks fields with breadcrumb path on failure', async ()=>{
+        const tool = createPatchGlobalLayoutTool(catalog, nesting, drafts);
+        const req = buildReq();
+        const result = await tool.handler({
+            slug: 'footer',
+            layoutField: 'sections',
+            // Container.sections allows only heading + ctaBanner, but here we shove
+            // a non-existent slug to ensure the nested breadcrumb is reported.
+            blocks: [
+                {
+                    blockType: 'container',
+                    sections: [
+                        {
+                            blockType: 'mystery',
+                            foo: 1
+                        }
+                    ]
+                }
+            ],
+            operation: 'full'
+        }, req, {});
+        const text = result.content[0].text;
+        expect(text).toMatch(/sections\[0\]\.sections\[0\]/);
+        expect(text).toMatch(/mystery/);
+        expect(req.payload.updateGlobal).not.toHaveBeenCalled();
+    });
+    it('dotted layoutField preserves sibling fields in the parent group', async ()=>{
+        // Reg test for the sibling-wipe bug: a dotted layoutField like
+        // "sections.layout" used to write {sections: {layout: [...]}} which
+        // Payload merges at the top level only — silently wiping
+        // sections.copyright. writePath now reads the existing parent group
+        // off the fetched global and merges siblings in.
+        const NestedFooter = {
+            slug: 'nestedFooter',
+            versions: {
+                drafts: true
+            },
+            fields: [
+                {
+                    name: 'sections',
+                    type: 'group',
+                    fields: [
+                        {
+                            name: 'copyright',
+                            type: 'text'
+                        },
+                        {
+                            name: 'layout',
+                            type: 'blocks',
+                            blocks: [
+                                Heading,
+                                CtaBanner
+                            ]
+                        }
+                    ]
+                }
+            ]
+        };
+        const nestedNesting = buildBlockNestingMap([], [
+            NestedFooter
+        ], allBlocks);
+        const tool = createPatchGlobalLayoutTool(catalog, nestedNesting, new Set([
+            'nestedFooter'
+        ]));
+        const req = buildReq();
+        req.payload.findGlobal.mockResolvedValue({
+            sections: {
+                copyright: 'do-not-wipe',
+                layout: [
+                    {
+                        blockType: 'heading',
+                        text: 'a'
+                    }
+                ]
+            }
+        });
+        req.payload.updateGlobal.mockResolvedValue({});
+        await tool.handler({
+            slug: 'nestedFooter',
+            layoutField: 'sections.layout',
+            blocks: [
+                {
+                    blockType: 'ctaBanner',
+                    label: 'Buy'
+                }
+            ],
+            operation: 'append'
+        }, req, {});
+        expect(req.payload.updateGlobal).toHaveBeenCalledWith(expect.objectContaining({
+            data: {
+                sections: {
+                    copyright: 'do-not-wipe',
+                    layout: [
+                        {
+                            blockType: 'heading',
+                            text: 'a'
+                        },
+                        {
+                            blockType: 'ctaBanner',
+                            label: 'Buy'
+                        }
+                    ]
+                }
+            }
+        }));
+    });
+    it('multi-level dotted layoutField preserves siblings at every depth', async ()=>{
+        const DeepFooter = {
+            slug: 'deepFooter',
+            versions: {
+                drafts: true
+            },
+            fields: [
+                {
+                    name: 'a',
+                    type: 'group',
+                    fields: [
+                        {
+                            name: 'keepA',
+                            type: 'text'
+                        },
+                        {
+                            name: 'b',
+                            type: 'group',
+                            fields: [
+                                {
+                                    name: 'keepB',
+                                    type: 'text'
+                                },
+                                {
+                                    name: 'layout',
+                                    type: 'blocks',
+                                    blocks: [
+                                        Heading
+                                    ]
+                                }
+                            ]
+                        }
+                    ]
+                }
+            ]
+        };
+        const deepNesting = buildBlockNestingMap([], [
+            DeepFooter
+        ], allBlocks);
+        const tool = createPatchGlobalLayoutTool(catalog, deepNesting, new Set([
+            'deepFooter'
+        ]));
+        const req = buildReq();
+        req.payload.findGlobal.mockResolvedValue({
+            a: {
+                keepA: 'A-survives',
+                b: {
+                    keepB: 'B-survives',
+                    layout: []
+                }
+            }
+        });
+        req.payload.updateGlobal.mockResolvedValue({});
+        await tool.handler({
+            slug: 'deepFooter',
+            layoutField: 'a.b.layout',
+            blocks: [
+                {
+                    blockType: 'heading',
+                    text: 'new'
+                }
+            ],
+            operation: 'full'
+        }, req, {});
+        expect(req.payload.updateGlobal).toHaveBeenCalledWith(expect.objectContaining({
+            data: {
+                a: {
+                    keepA: 'A-survives',
+                    b: {
+                        keepB: 'B-survives',
+                        layout: [
+                            {
+                                blockType: 'heading',
+                                text: 'new'
+                            }
+                        ]
+                    }
+                }
+            }
+        }));
+    });
+    it('expectedUpdatedAt mismatch rejects the patch without writing', async ()=>{
+        const tool = createPatchGlobalLayoutTool(catalog, nesting, drafts);
+        const req = buildReq();
+        req.payload.findGlobal.mockResolvedValue({
+            sections: [],
+            updatedAt: '2026-01-02T00:00:00.000Z'
+        });
+        const result = await tool.handler({
+            slug: 'footer',
+            layoutField: 'sections',
+            blocks: [
+                {
+                    blockType: 'heading',
+                    text: 'a'
+                }
+            ],
+            operation: 'append',
+            expectedUpdatedAt: '2026-01-01T00:00:00.000Z'
+        }, req, {});
+        expect(result.content[0].text).toMatch(/conflict/i);
+        expect(req.payload.updateGlobal).not.toHaveBeenCalled();
+    });
+    it('expectedUpdatedAt match proceeds with the patch', async ()=>{
+        const tool = createPatchGlobalLayoutTool(catalog, nesting, drafts);
+        const req = buildReq();
+        req.payload.findGlobal.mockResolvedValue({
+            sections: [],
+            updatedAt: '2026-01-02T00:00:00.000Z'
+        });
+        req.payload.updateGlobal.mockResolvedValue({});
+        await tool.handler({
+            slug: 'footer',
+            layoutField: 'sections',
+            blocks: [
+                {
+                    blockType: 'heading',
+                    text: 'a'
+                }
+            ],
+            operation: 'append',
+            expectedUpdatedAt: '2026-01-02T00:00:00.000Z'
+        }, req, {});
+        expect(req.payload.updateGlobal).toHaveBeenCalled();
+    });
+    it('locale arg is forwarded to findGlobal and updateGlobal', async ()=>{
+        const tool = createPatchGlobalLayoutTool(catalog, nesting, drafts);
+        const req = buildReq();
+        req.payload.findGlobal.mockResolvedValue({
+            sections: []
+        });
+        req.payload.updateGlobal.mockResolvedValue({});
+        await tool.handler({
+            slug: 'footer',
+            layoutField: 'sections',
+            blocks: [
+                {
+                    blockType: 'heading',
+                    text: 'a'
+                }
+            ],
+            operation: 'append',
+            locale: 'fr'
+        }, req, {});
+        expect(req.payload.findGlobal).toHaveBeenCalledWith(expect.objectContaining({
+            locale: 'fr'
+        }));
+        expect(req.payload.updateGlobal).toHaveBeenCalledWith(expect.objectContaining({
+            locale: 'fr'
+        }));
+    });
+    it('returns an error when layoutField is not a blocks field on the global', async ()=>{
+        const tool = createPatchGlobalLayoutTool(catalog, nesting, drafts);
+        const req = buildReq();
+        const result = await tool.handler({
+            slug: 'footer',
+            layoutField: 'definitely-not-a-field',
+            blocks: [],
+            operation: 'full'
+        }, req, {});
+        expect(result.content[0].text).toMatch(/not a blocks-typed field/i);
+    });
+});
+
+//# sourceMappingURL=patch-global-layout.test.js.map

package/dist/__tests__/patch-global-layout.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/__tests__/patch-global-layout.test.ts"],"sourcesContent":["import { describe, it, expect, vi } from 'vitest'\r\nimport type { Block, GlobalConfig } from 'payload'\r\nimport { introspectBlocks, buildBlockNestingMap } from '../introspection'\r\nimport { createPatchGlobalLayoutTool } from '../tools/patch-global-layout'\r\n\r\nconst Heading: Block = { slug: 'heading', fields: [{ name: 'text', type: 'text' }] }\r\nconst CtaBanner: Block = { slug: 'ctaBanner', fields: [{ name: 'label', type: 'text' }] }\r\nconst Container: Block = {\r\n  slug: 'container',\r\n  fields: [\r\n    {\r\n      name: 'sections',\r\n      type: 'blocks',\r\n      blocks: [Heading, CtaBanner],\r\n    },\r\n  ],\r\n}\r\n\r\nconst FooterGlobal: GlobalConfig = {\r\n  slug: 'footer',\r\n  versions: { drafts: true },\r\n  fields: [\r\n    {\r\n      name: 'sections',\r\n      type: 'blocks',\r\n      blocks: [Heading, CtaBanner, Container],\r\n    },\r\n  ],\r\n}\r\n\r\nconst PlainSettings: GlobalConfig = {\r\n  slug: 'plain',\r\n  fields: [{ name: 'siteName', type: 'text' }],\r\n}\r\n\r\nfunction buildReq() {\r\n  return {\r\n    payload: {\r\n      findGlobal: vi.fn(),\r\n      updateGlobal: vi.fn(),\r\n      logger: { info: vi.fn(), warn: vi.fn(), error: vi.fn() },\r\n    },\r\n    context: {},\r\n    user: null,\r\n  }\r\n}\r\n\r\nconst allBlocks = [Heading, CtaBanner, Container]\r\nconst catalog = introspectBlocks(allBlocks)\r\nconst nesting = buildBlockNestingMap([], [FooterGlobal], allBlocks)\r\nconst drafts = new Set(['footer'])\r\n\r\ndescribe('patchGlobalLayout', () => {\r\n  it('returns null when no global has a blocks field (factory short-circuit)', () => {\r\n    const emptyNesting = buildBlockNestingMap([], [PlainSettings], allBlocks)\r\n    const tool = createPatchGlobalLayoutTool(catalog, emptyNesting, new Set())\r\n    expect(tool).toBeNull()\r\n  })\r\n\r\n  it('registers when at least one global has a blocks field', () => {\r\n    const tool = createPatchGlobalLayoutTool(catalog, nesting, drafts)\r\n    expect(tool).not.toBeNull()\r\n    expect(tool!.name).toBe('patchGlobalLayout')\r\n  })\r\n\r\n  it('append: writes existing + new blocks back via updateGlobal', async () => {\r\n    const tool = createPatchGlobalLayoutTool(catalog, nesting, drafts)!\r\n    const req = buildReq()\r\n    req.payload.findGlobal.mockResolvedValue({\r\n      sections: [{ blockType: 'heading', text: 'a' }],\r\n    })\r\n    req.payload.updateGlobal.mockResolvedValue({})\r\n\r\n    await tool.handler(\r\n      {\r\n        slug: 'footer',\r\n        layoutField: 'sections',\r\n        blocks: [{ blockType: 'ctaBanner', label: 'Buy' }],\r\n        operation: 'append',\r\n      },\r\n      req as never,\r\n      {},\r\n    )\r\n\r\n    expect(req.payload.updateGlobal).toHaveBeenCalledWith(\r\n      expect.objectContaining({\r\n        slug: 'footer',\r\n        draft: true,\r\n        data: {\r\n          sections: [\r\n            { blockType: 'heading', text: 'a' },\r\n            { blockType: 'ctaBanner', label: 'Buy' },\r\n          ],\r\n        },\r\n      }),\r\n    )\r\n  })\r\n\r\n  it('replaceAt index 0 swaps the first block', async () => {\r\n    const tool = createPatchGlobalLayoutTool(catalog, nesting, drafts)!\r\n    const req = buildReq()\r\n    req.payload.findGlobal.mockResolvedValue({\r\n      sections: [\r\n        { blockType: 'heading', text: 'a' },\r\n        { blockType: 'ctaBanner', label: 'old' },\r\n      ],\r\n    })\r\n    req.payload.updateGlobal.mockResolvedValue({})\r\n\r\n    await tool.handler(\r\n      {\r\n        slug: 'footer',\r\n        layoutField: 'sections',\r\n        blocks: [{ blockType: 'heading', text: 'new-first' }],\r\n        operation: 'replaceAt',\r\n        insertIndex: 0,\r\n      },\r\n      req as never,\r\n      {},\r\n    )\r\n\r\n    expect(req.payload.updateGlobal).toHaveBeenCalledWith(\r\n      expect.objectContaining({\r\n        data: {\r\n          sections: [\r\n            { blockType: 'heading', text: 'new-first' },\r\n            { blockType: 'ctaBanner', label: 'old' },\r\n          ],\r\n        },\r\n      }),\r\n    )\r\n  })\r\n\r\n  it('rejects blocks whose slug is not in the field allow-list', async () => {\r\n    const tool = createPatchGlobalLayoutTool(catalog, nesting, drafts)!\r\n    const req = buildReq()\r\n    const result = await tool.handler(\r\n      {\r\n        slug: 'footer',\r\n        layoutField: 'sections',\r\n        // ImageBlock is not in the FooterGlobal allow list.\r\n        blocks: [{ blockType: 'image', src: 'x' }],\r\n        operation: 'full',\r\n      },\r\n      req as never,\r\n      {},\r\n    )\r\n    const text = result.content[0]!.text\r\n    expect(text).toMatch(/unknown blockType/i)\r\n    expect(text).toContain('image')\r\n    expect(req.payload.updateGlobal).not.toHaveBeenCalled()\r\n  })\r\n\r\n  it('validates nested blocks fields with breadcrumb path on failure', async () => {\r\n    const tool = createPatchGlobalLayoutTool(catalog, nesting, drafts)!\r\n    const req = buildReq()\r\n    const result = await tool.handler(\r\n      {\r\n        slug: 'footer',\r\n        layoutField: 'sections',\r\n        // Container.sections allows only heading + ctaBanner, but here we shove\r\n        // a non-existent slug to ensure the nested breadcrumb is reported.\r\n        blocks: [\r\n          {\r\n            blockType: 'container',\r\n            sections: [{ blockType: 'mystery', foo: 1 }],\r\n          },\r\n        ],\r\n        operation: 'full',\r\n      },\r\n      req as never,\r\n      {},\r\n    )\r\n    const text = result.content[0]!.text\r\n    expect(text).toMatch(/sections\\[0\\]\\.sections\\[0\\]/)\r\n    expect(text).toMatch(/mystery/)\r\n    expect(req.payload.updateGlobal).not.toHaveBeenCalled()\r\n  })\r\n\r\n  it('dotted layoutField preserves sibling fields in the parent group', async () => {\r\n    // Reg test for the sibling-wipe bug: a dotted layoutField like\r\n    // \"sections.layout\" used to write {sections: {layout: [...]}} which\r\n    // Payload merges at the top level only — silently wiping\r\n    // sections.copyright. writePath now reads the existing parent group\r\n    // off the fetched global and merges siblings in.\r\n    const NestedFooter: GlobalConfig = {\r\n      slug: 'nestedFooter',\r\n      versions: { drafts: true },\r\n      fields: [\r\n        {\r\n          name: 'sections',\r\n          type: 'group',\r\n          fields: [\r\n            { name: 'copyright', type: 'text' },\r\n            { name: 'layout', type: 'blocks', blocks: [Heading, CtaBanner] },\r\n          ],\r\n        },\r\n      ],\r\n    }\r\n    const nestedNesting = buildBlockNestingMap([], [NestedFooter], allBlocks)\r\n    const tool = createPatchGlobalLayoutTool(catalog, nestedNesting, new Set(['nestedFooter']))!\r\n    const req = buildReq()\r\n    req.payload.findGlobal.mockResolvedValue({\r\n      sections: {\r\n        copyright: 'do-not-wipe',\r\n        layout: [{ blockType: 'heading', text: 'a' }],\r\n      },\r\n    })\r\n    req.payload.updateGlobal.mockResolvedValue({})\r\n\r\n    await tool.handler(\r\n      {\r\n        slug: 'nestedFooter',\r\n        layoutField: 'sections.layout',\r\n        blocks: [{ blockType: 'ctaBanner', label: 'Buy' }],\r\n        operation: 'append',\r\n      },\r\n      req as never,\r\n      {},\r\n    )\r\n\r\n    expect(req.payload.updateGlobal).toHaveBeenCalledWith(\r\n      expect.objectContaining({\r\n        data: {\r\n          sections: {\r\n            copyright: 'do-not-wipe',\r\n            layout: [\r\n              { blockType: 'heading', text: 'a' },\r\n              { blockType: 'ctaBanner', label: 'Buy' },\r\n            ],\r\n          },\r\n        },\r\n      }),\r\n    )\r\n  })\r\n\r\n  it('multi-level dotted layoutField preserves siblings at every depth', async () => {\r\n    const DeepFooter: GlobalConfig = {\r\n      slug: 'deepFooter',\r\n      versions: { drafts: true },\r\n      fields: [\r\n        {\r\n          name: 'a',\r\n          type: 'group',\r\n          fields: [\r\n            { name: 'keepA', type: 'text' },\r\n            {\r\n              name: 'b',\r\n              type: 'group',\r\n              fields: [\r\n                { name: 'keepB', type: 'text' },\r\n                { name: 'layout', type: 'blocks', blocks: [Heading] },\r\n              ],\r\n            },\r\n          ],\r\n        },\r\n      ],\r\n    }\r\n    const deepNesting = buildBlockNestingMap([], [DeepFooter], allBlocks)\r\n    const tool = createPatchGlobalLayoutTool(catalog, deepNesting, new Set(['deepFooter']))!\r\n    const req = buildReq()\r\n    req.payload.findGlobal.mockResolvedValue({\r\n      a: {\r\n        keepA: 'A-survives',\r\n        b: {\r\n          keepB: 'B-survives',\r\n          layout: [],\r\n        },\r\n      },\r\n    })\r\n    req.payload.updateGlobal.mockResolvedValue({})\r\n\r\n    await tool.handler(\r\n      {\r\n        slug: 'deepFooter',\r\n        layoutField: 'a.b.layout',\r\n        blocks: [{ blockType: 'heading', text: 'new' }],\r\n        operation: 'full',\r\n      },\r\n      req as never,\r\n      {},\r\n    )\r\n\r\n    expect(req.payload.updateGlobal).toHaveBeenCalledWith(\r\n      expect.objectContaining({\r\n        data: {\r\n          a: {\r\n            keepA: 'A-survives',\r\n            b: {\r\n              keepB: 'B-survives',\r\n              layout: [{ blockType: 'heading', text: 'new' }],\r\n            },\r\n          },\r\n        },\r\n      }),\r\n    )\r\n  })\r\n\r\n  it('expectedUpdatedAt mismatch rejects the patch without writing', async () => {\r\n    const tool = createPatchGlobalLayoutTool(catalog, nesting, drafts)!\r\n    const req = buildReq()\r\n    req.payload.findGlobal.mockResolvedValue({\r\n      sections: [],\r\n      updatedAt: '2026-01-02T00:00:00.000Z',\r\n    })\r\n\r\n    const result = await tool.handler(\r\n      {\r\n        slug: 'footer',\r\n        layoutField: 'sections',\r\n        blocks: [{ blockType: 'heading', text: 'a' }],\r\n        operation: 'append',\r\n        expectedUpdatedAt: '2026-01-01T00:00:00.000Z',\r\n      },\r\n      req as never,\r\n      {},\r\n    )\r\n\r\n    expect(result.content[0]!.text).toMatch(/conflict/i)\r\n    expect(req.payload.updateGlobal).not.toHaveBeenCalled()\r\n  })\r\n\r\n  it('expectedUpdatedAt match proceeds with the patch', async () => {\r\n    const tool = createPatchGlobalLayoutTool(catalog, nesting, drafts)!\r\n    const req = buildReq()\r\n    req.payload.findGlobal.mockResolvedValue({\r\n      sections: [],\r\n      updatedAt: '2026-01-02T00:00:00.000Z',\r\n    })\r\n    req.payload.updateGlobal.mockResolvedValue({})\r\n\r\n    await tool.handler(\r\n      {\r\n        slug: 'footer',\r\n        layoutField: 'sections',\r\n        blocks: [{ blockType: 'heading', text: 'a' }],\r\n        operation: 'append',\r\n        expectedUpdatedAt: '2026-01-02T00:00:00.000Z',\r\n      },\r\n      req as never,\r\n      {},\r\n    )\r\n\r\n    expect(req.payload.updateGlobal).toHaveBeenCalled()\r\n  })\r\n\r\n  it('locale arg is forwarded to findGlobal and updateGlobal', async () => {\r\n    const tool = createPatchGlobalLayoutTool(catalog, nesting, drafts)!\r\n    const req = buildReq()\r\n    req.payload.findGlobal.mockResolvedValue({ sections: [] })\r\n    req.payload.updateGlobal.mockResolvedValue({})\r\n\r\n    await tool.handler(\r\n      {\r\n        slug: 'footer',\r\n        layoutField: 'sections',\r\n        blocks: [{ blockType: 'heading', text: 'a' }],\r\n        operation: 'append',\r\n        locale: 'fr',\r\n      },\r\n      req as never,\r\n      {},\r\n    )\r\n\r\n    expect(req.payload.findGlobal).toHaveBeenCalledWith(expect.objectContaining({ locale: 'fr' }))\r\n    expect(req.payload.updateGlobal).toHaveBeenCalledWith(expect.objectContaining({ locale: 'fr' }))\r\n  })\r\n\r\n  it('returns an error when layoutField is not a blocks field on the global', async () => {\r\n    const tool = createPatchGlobalLayoutTool(catalog, nesting, drafts)!\r\n    const req = buildReq()\r\n    const result = await tool.handler(\r\n      {\r\n        slug: 'footer',\r\n        layoutField: 'definitely-not-a-field',\r\n        blocks: [],\r\n        operation: 'full',\r\n      },\r\n      req as never,\r\n      {},\r\n    )\r\n    expect(result.content[0]!.text).toMatch(/not a blocks-typed field/i)\r\n  })\r\n})\r\n"],"names":["describe","it","expect","vi","introspectBlocks","buildBlockNestingMap","createPatchGlobalLayoutTool","Heading","slug","fields","name","type","CtaBanner","Container","blocks","FooterGlobal","versions","drafts","PlainSettings","buildReq","payload","findGlobal","fn","updateGlobal","logger","info","warn","error","context","user","allBlocks","catalog","nesting","Set","emptyNesting","tool","toBeNull","not","toBe","req","mockResolvedValue","sections","blockType","text","handler","layoutField","label","operation","toHaveBeenCalledWith","objectContaining","draft","data","insertIndex","result","src","content","toMatch","toContain","toHaveBeenCalled","foo","NestedFooter","nestedNesting","copyright","layout","DeepFooter","deepNesting","a","keepA","b","keepB","updatedAt","expectedUpdatedAt","locale"],"mappings":"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"}

package/dist/__tests__/patch-layout.test.js

@@ -0,0 +1,171 @@
+import { describe, it, expect, vi } from 'vitest';
+import { introspectBlocks, buildBlockNestingMap } from '../introspection';
+import { createPatchLayoutTool } from '../tools/patch-layout';
+const Heading = {
+    slug: 'heading',
+    fields: [
+        {
+            name: 'text',
+            type: 'text'
+        }
+    ]
+};
+const CtaBanner = {
+    slug: 'ctaBanner',
+    fields: [
+        {
+            name: 'label',
+            type: 'text'
+        }
+    ]
+};
+const Pages = {
+    slug: 'pages',
+    versions: {
+        drafts: true
+    },
+    fields: [
+        {
+            name: 'layout',
+            type: 'blocks',
+            blocks: [
+                Heading,
+                CtaBanner
+            ]
+        }
+    ]
+};
+function buildReq() {
+    return {
+        payload: {
+            findByID: vi.fn(),
+            update: vi.fn(),
+            logger: {
+                info: vi.fn(),
+                warn: vi.fn(),
+                error: vi.fn()
+            }
+        },
+        context: {},
+        user: null
+    };
+}
+const allBlocks = [
+    Heading,
+    CtaBanner
+];
+const catalog = introspectBlocks(allBlocks);
+const nesting = buildBlockNestingMap([
+    Pages
+], [], allBlocks);
+const drafts = new Set([
+    'pages'
+]);
+describe('patchLayout', ()=>{
+    it('flat layoutField writes {[layoutField]: finalLayout} — no regression from shared writePath', async ()=>{
+        // After extracting writePath into _layout-helpers, the collection tool
+        // doesn't itself use writePath, but this is the canonical regression
+        // check that the flat-path shape stays a single top-level key so
+        // Payload's `update` merges normally.
+        const tool = createPatchLayoutTool(catalog, nesting, drafts);
+        const req = buildReq();
+        req.payload.findByID.mockResolvedValue({
+            id: '1',
+            layout: [
+                {
+                    blockType: 'heading',
+                    text: 'a'
+                }
+            ]
+        });
+        req.payload.update.mockResolvedValue({
+            id: '1',
+            title: 'p'
+        });
+        await tool.handler({
+            collection: 'pages',
+            documentId: '1',
+            layoutField: 'layout',
+            blocks: [
+                {
+                    blockType: 'ctaBanner',
+                    label: 'Buy'
+                }
+            ],
+            operation: 'append'
+        }, req, {});
+        expect(req.payload.update).toHaveBeenCalledWith(expect.objectContaining({
+            collection: 'pages',
+            id: '1',
+            data: {
+                layout: [
+                    {
+                        blockType: 'heading',
+                        text: 'a'
+                    },
+                    {
+                        blockType: 'ctaBanner',
+                        label: 'Buy'
+                    }
+                ]
+            }
+        }));
+    });
+    it('full operation replaces the array wholesale', async ()=>{
+        const tool = createPatchLayoutTool(catalog, nesting, drafts);
+        const req = buildReq();
+        req.payload.findByID.mockResolvedValue({
+            id: '1',
+            layout: [
+                {
+                    blockType: 'heading',
+                    text: 'old'
+                }
+            ]
+        });
+        req.payload.update.mockResolvedValue({
+            id: '1'
+        });
+        await tool.handler({
+            collection: 'pages',
+            documentId: '1',
+            layoutField: 'layout',
+            blocks: [
+                {
+                    blockType: 'heading',
+                    text: 'new'
+                }
+            ],
+            operation: 'full'
+        }, req, {});
+        expect(req.payload.update).toHaveBeenCalledWith(expect.objectContaining({
+            data: {
+                layout: [
+                    {
+                        blockType: 'heading',
+                        text: 'new'
+                    }
+                ]
+            }
+        }));
+    });
+    it('rejects unknown blockType with validation error', async ()=>{
+        const tool = createPatchLayoutTool(catalog, nesting, drafts);
+        const req = buildReq();
+        const result = await tool.handler({
+            collection: 'pages',
+            documentId: '1',
+            layoutField: 'layout',
+            blocks: [
+                {
+                    blockType: 'mystery'
+                }
+            ],
+            operation: 'full'
+        }, req, {});
+        expect(result.content[0].text).toMatch(/unknown blockType/i);
+        expect(req.payload.update).not.toHaveBeenCalled();
+    });
+});
+
+//# sourceMappingURL=patch-layout.test.js.map