payload-mcp-toolkit 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 payload-mcp-toolkit contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,133 @@
+# payload-mcp-toolkit
+
+> Schema-aware MCP toolkit for Payload CMS — wraps the official [`@payloadcms/plugin-mcp`](https://github.com/payloadcms/payload/tree/main/packages/plugin-mcp) with introspected prompts, resources, draft workflow, and AI-friendly tools so non-technical editors can manage content via AI chat.
+
+## What it does
+
+The official Payload MCP plugin gives every collection a generic CRUD surface. That works, but an LLM driving it has no idea:
+
+- which collections support drafts vs publish-immediately,
+- which block types are valid inside which sections,
+- which fields are searchable for resolving relationships,
+- how to compose a page layout without trial and error.
+
+`payload-mcp-toolkit` introspects the Payload config at boot, then layers schema-aware **prompts**, **resources**, and **tools** on top of the official plugin so an AI client (Claude Desktop, Claude API, any MCP-compatible chat) can drive your CMS confidently.
+
+## What it adds
+
+**Auto-generated prompts** (no setup required):
+- `contentModelOverview` — every collection, fields, and relationships.
+- `blockCompositionGuide` — section/leaf hierarchy and nesting rules.
+- `draftWorkflowGuide` — which collections need `publishDraft` to go live.
+
+**Auto-generated resources** (machine-readable JSON for the LLM):
+- `blocks://catalog`, `collections://schema`, `collections://relationships`.
+
+**Custom tools** (11 total):
+
+*Authoring*
+- `composePageLayout` — build a validated page layout from sections + leaves.
+- `patchLayout` — surgically append/prepend/insertAt/replaceAt sections on a doc's block-array field without round-tripping the whole array. Safer than `updateDocument` for incremental layout edits.
+- `updateDocument` — Local-API based update that survives the upload-field bug in the official plugin.
+- `uploadMedia` — fetch a public HTTPS image, validate (SSRF-safe), create a Media doc.
+
+*Discovery*
+- `resolveReference` — search collections by name/title/slug for relationship IDs.
+- `searchContent` — natural-language editor triage. Filter by `status`, `olderThanDays` / `newerThanDays`, `missingFields`, free-text `query`, scoped to one collection or all.
+
+*Lifecycle / safety*
+- `publishDraft` — flip `_status` from draft to published.
+- `schedulePublish` — **bring your own scheduler.** Stamps a future `publishedAt` on a draft and leaves `_status: 'draft'`; it does **not** itself flip status at the appointed time. Auto-registered only for collections that have both drafts AND a `publishedAt` date field. To actually publish on schedule, you must wire up one of: a [Payload Jobs Queue scheduled task](https://payloadcms.com/docs/jobs-queue/scheduled-jobs), an external cron worker, or a `beforeRead` hook that resolves status on the fly. Without one of those, scheduled drafts stay drafts forever — the tool says so in its response, but it's still a footgun if you skim past it.
+- `listVersions` — recent saved versions of a draft document with id/status/timestamp/displayName.
+- `restoreVersion` — roll a document back to a saved version (creates a new version on top, so itself reversible).
+- `safeDelete` — relationship-aware delete. Walks the introspected relationship graph, refuses with a structured impact summary if other documents reference the target. Override with `confirm: true` after reviewing.
+
+**Draft workflow** wired into the official plugin's `mcpCollections`:
+- Disables raw `update` for `always-draft` collections so clients go through `publishDraft` (or `patchLayout` / `updateDocument`, both of which preserve draft semantics).
+- Appends preview URLs to draft responses (path prefixes are configurable via `previewPaths`).
+
+## Install
+
+```bash
+pnpm add payload-mcp-toolkit @payloadcms/plugin-mcp
+```
+
+Peer dependencies: `payload` ^3, `@payloadcms/plugin-mcp` ^3, `zod` ^3.
+
+## Use
+
+```ts
+// payload.config.ts
+import { contentToolkitPlugin } from 'payload-mcp-toolkit'
+
+export default buildConfig({
+  // ...your collections, blocks, globals
+  plugins: [
+    contentToolkitPlugin({
+      siteUrl: process.env.SITE_URL!,
+      previewSecret: process.env.PREVIEW_SECRET!,
+      previewPaths: {
+        pages: '',          // pages live at /
+        posts: '/blog',     // posts live at /blog/:slug
+      },
+      draftBehavior: {
+        pages: 'always-draft',
+        posts: 'always-draft',
+      },
+      domainPrompts: [
+        // Optional site-specific vocabulary — see examples/
+      ],
+    }),
+  ],
+})
+```
+
+That's it. The toolkit reads your Payload config and registers everything against the official MCP plugin. Connect any MCP client to your Payload server and the LLM will see the prompts, resources, and tools.
+
+See `examples/angels-config.example.ts` for a fully-worked domain-prompt setup from a real-world site.
+
+## Configuration reference
+
+| Option | Type | Description |
+|---|---|---|
+| `siteUrl` | `string` | Base URL used to construct preview URLs. |
+| `previewSecret` | `string` | Secret embedded in the preview URL query. |
+| `previewPaths` | `Record<string, string>` | Per-collection URL path prefix. Defaults to `/{slug}` if omitted. Use `''` for collections at the site root. |
+| `draftBehavior` | `Record<string, 'always-draft' \| 'always-publish'>` | Override the default draft behavior per collection. |
+| `domainPrompts` | `DomainPrompt[]` | Custom prompts that teach the AI site-specific vocabulary. |
+| `mediaUpload.maxFileSize` | `number` | Max bytes for `uploadMedia` (default 10MB). |
+| `mediaUpload.collectionSlug` | `string` | Media collection slug (default `media`). |
+| `excludeCollections` | `string[]` | Collection slugs to hide from MCP. |
+| `excludeGlobals` | `string[]` | Global slugs to hide from MCP. |
+
+## Development
+
+This package follows the [official Payload 3 plugin template](https://github.com/payloadcms/payload/tree/main/templates/plugin) layout: source in `src/`, a fully-working Payload + Next.js app in `dev/`, source-export `package.json` so the dev harness consumes the plugin directly without a build step.
+
+```bash
+pnpm install
+cp dev/.env.example dev/.env
+pnpm dev          # boot dev/ Next.js + Payload at http://localhost:3000
+pnpm test         # vitest — runs introspection unit tests
+pnpm build        # produce dist/ for npm publish
+```
+
+The dev harness ships with a realistic CMS schema:
+- `Pages` — block-based layout (FullWidth, TwoColumn, CtaBanner, HeadingOnly), drafts enabled.
+- `Posts` — title/slug/excerpt/content/cover/category/authors/tags/SEO, drafts enabled.
+- `Authors`, `Categories`, `Media`, `Users` — taxonomy + auth.
+- `SiteSettings` — global with site name, logo, social, footer.
+- 5 leaf blocks (Heading, RichText, Image, ButtonGroup, Quote) and 4 section blocks.
+
+Seed sample content:
+
+```bash
+# Generate the admin import map first time:
+pnpm dev:generate-importmap
+
+# Then visit http://localhost:3000/admin and create your first user.
+```
+
+## License
+
+MIT

package/dist/__tests__/introspection.test.js

@@ -0,0 +1,364 @@
+import { describe, it, expect } from 'vitest';
+import { introspectCollection, introspectCollections, introspectBlocks, buildRelationshipGraph } from '../introspection';
+// ─── Sample schema (kept inline so the test is self-contained) ─────
+const Media = {
+    slug: 'media',
+    upload: true,
+    fields: [
+        {
+            name: 'alt',
+            type: 'text',
+            required: true
+        }
+    ]
+};
+const Categories = {
+    slug: 'categories',
+    fields: [
+        {
+            name: 'name',
+            type: 'text',
+            required: true
+        },
+        {
+            name: 'slug',
+            type: 'text',
+            required: true
+        }
+    ]
+};
+const Authors = {
+    slug: 'authors',
+    fields: [
+        {
+            name: 'name',
+            type: 'text',
+            required: true
+        },
+        {
+            name: 'slug',
+            type: 'text',
+            required: true
+        },
+        {
+            name: 'avatar',
+            type: 'upload',
+            relationTo: 'media'
+        }
+    ]
+};
+// Leaf blocks
+const Heading = {
+    slug: 'heading',
+    fields: [
+        {
+            name: 'text',
+            type: 'text',
+            required: true
+        },
+        {
+            name: 'level',
+            type: 'select',
+            options: [
+                'h1',
+                'h2',
+                'h3'
+            ],
+            defaultValue: 'h2'
+        },
+        {
+            name: 'align',
+            type: 'select',
+            options: [
+                'left',
+                'center',
+                'right'
+            ],
+            defaultValue: 'left'
+        }
+    ]
+};
+const RichText = {
+    slug: 'richText',
+    fields: [
+        {
+            name: 'content',
+            type: 'richText'
+        }
+    ]
+};
+const ImageBlock = {
+    slug: 'image',
+    fields: [
+        {
+            name: 'image',
+            type: 'upload',
+            relationTo: 'media',
+            required: true
+        },
+        {
+            name: 'caption',
+            type: 'text'
+        }
+    ]
+};
+const allLeafBlocks = [
+    Heading,
+    RichText,
+    ImageBlock
+];
+// Section blocks
+const FullWidth = {
+    slug: 'fullWidth',
+    fields: [
+        {
+            name: 'content',
+            type: 'blocks',
+            blocks: allLeafBlocks
+        }
+    ]
+};
+const HeadingOnly = {
+    slug: 'headingOnly',
+    fields: [
+        {
+            name: 'content',
+            type: 'blocks',
+            maxRows: 1,
+            blocks: [
+                Heading
+            ]
+        }
+    ]
+};
+const CtaBanner = {
+    slug: 'ctaBanner',
+    fields: [
+        {
+            name: 'headline',
+            type: 'text',
+            required: true
+        },
+        {
+            name: 'buttonLabel',
+            type: 'text'
+        },
+        {
+            name: 'buttonHref',
+            type: 'text'
+        }
+    ]
+};
+const allSectionBlocks = [
+    FullWidth,
+    HeadingOnly,
+    CtaBanner
+];
+const Posts = {
+    slug: 'posts',
+    versions: {
+        drafts: true
+    },
+    fields: [
+        {
+            name: 'title',
+            type: 'text',
+            required: true
+        },
+        {
+            name: 'slug',
+            type: 'text',
+            required: true
+        },
+        {
+            name: 'featured',
+            type: 'checkbox'
+        },
+        {
+            name: 'category',
+            type: 'relationship',
+            relationTo: 'categories'
+        },
+        {
+            name: 'authors',
+            type: 'relationship',
+            relationTo: 'authors',
+            hasMany: true
+        },
+        {
+            name: 'coverImage',
+            type: 'upload',
+            relationTo: 'media'
+        },
+        {
+            name: 'tags',
+            type: 'array',
+            fields: [
+                {
+                    name: 'tag',
+                    type: 'text'
+                }
+            ]
+        }
+    ]
+};
+const Pages = {
+    slug: 'pages',
+    versions: {
+        drafts: true
+    },
+    fields: [
+        {
+            type: 'tabs',
+            tabs: [
+                {
+                    name: 'hero',
+                    label: 'Hero',
+                    fields: [
+                        {
+                            name: 'heroTitle',
+                            type: 'text'
+                        },
+                        {
+                            name: 'heroSize',
+                            type: 'select',
+                            options: [
+                                'small',
+                                'medium',
+                                'large'
+                            ],
+                            defaultValue: 'medium'
+                        }
+                    ]
+                },
+                {
+                    label: 'Content',
+                    fields: [
+                        {
+                            name: 'slug',
+                            type: 'text',
+                            required: true
+                        },
+                        {
+                            name: 'layout',
+                            type: 'blocks',
+                            blocks: allSectionBlocks
+                        }
+                    ]
+                }
+            ]
+        }
+    ]
+};
+// ─── Tests ─────────────────────────────────────────────────────────
+describe('introspectCollection', ()=>{
+    it('extracts Posts collection fields, relationships, and draft status', ()=>{
+        const schema = introspectCollection(Posts);
+        expect(schema.slug).toBe('posts');
+        expect(schema.hasDrafts).toBe(true);
+        const fieldNames = schema.fields.map((f)=>f.name);
+        expect(fieldNames).toContain('title');
+        expect(fieldNames).toContain('slug');
+        expect(fieldNames).toContain('featured');
+        expect(fieldNames).toContain('tags');
+        const relFieldNames = schema.relationships.map((r)=>r.fieldName);
+        expect(relFieldNames).toContain('category');
+        expect(relFieldNames).toContain('authors');
+        const cover = schema.relationships.find((r)=>r.fieldName === 'coverImage');
+        expect(cover).toBeDefined();
+        expect(cover.relationTo).toBe('media');
+        expect(schema.searchableFields).toContain('title');
+        expect(schema.searchableFields).toContain('slug');
+    });
+    it('extracts Pages collection with tab-nested fields', ()=>{
+        const schema = introspectCollection(Pages);
+        expect(schema.slug).toBe('pages');
+        expect(schema.hasDrafts).toBe(true);
+        const fieldNames = schema.fields.map((f)=>f.name);
+        expect(fieldNames).toContain('heroTitle');
+        expect(fieldNames).toContain('slug');
+        expect(fieldNames).toContain('layout');
+    });
+    it('detects collections without draft support', ()=>{
+        const schema = introspectCollection(Categories);
+        expect(schema.hasDrafts).toBe(false);
+    });
+    it('extracts select field options from Pages heroSize', ()=>{
+        const schema = introspectCollection(Pages);
+        const heroSize = schema.fields.find((f)=>f.name === 'heroSize');
+        expect(heroSize).toBeDefined();
+        expect(heroSize.type).toBe('select');
+        expect(heroSize.options).toBeDefined();
+        expect(heroSize.options.length).toBe(3);
+    });
+});
+describe('introspectBlocks', ()=>{
+    it('discovers fullWidth accepts all leaf blocks (composable)', ()=>{
+        const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks);
+        const fullWidth = catalog.sections.find((s)=>s.slug === 'fullWidth');
+        expect(fullWidth).toBeDefined();
+        expect(fullWidth.nestingType).toBe('composable');
+        expect(fullWidth.acceptedLeafSlugs.length).toBe(allLeafBlocks.length);
+    });
+    it('marks ctaBanner as fixed (no nested blocks)', ()=>{
+        const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks);
+        const ctaBanner = catalog.sections.find((s)=>s.slug === 'ctaBanner');
+        expect(ctaBanner).toBeDefined();
+        expect(ctaBanner.nestingType).toBe('fixed');
+        expect(ctaBanner.acceptedLeafSlugs).toHaveLength(0);
+    });
+    it('marks headingOnly as constrained (single leaf type, maxRows: 1)', ()=>{
+        const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks);
+        const headingOnly = catalog.sections.find((s)=>s.slug === 'headingOnly');
+        expect(headingOnly).toBeDefined();
+        expect(headingOnly.nestingType).toBe('constrained');
+        expect(headingOnly.acceptedLeafSlugs).toEqual([
+            'heading'
+        ]);
+        expect(headingOnly.maxRows).toBe(1);
+    });
+    it('extracts all leaf blocks', ()=>{
+        const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks);
+        expect(catalog.leaves).toHaveLength(3);
+        const leafSlugs = catalog.leaves.map((l)=>l.slug);
+        expect(leafSlugs).toEqual([
+            'heading',
+            'richText',
+            'image'
+        ]);
+    });
+    it('extracts leaf block fields including select options', ()=>{
+        const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks);
+        const heading = catalog.leaves.find((l)=>l.slug === 'heading');
+        expect(heading).toBeDefined();
+        const headingFieldNames = heading.fields.map((f)=>f.name);
+        expect(headingFieldNames).toEqual([
+            'text',
+            'level',
+            'align'
+        ]);
+        const level = heading.fields.find((f)=>f.name === 'level');
+        expect(level.options).toBeDefined();
+    });
+});
+describe('buildRelationshipGraph', ()=>{
+    it('builds correct graph from sample collections', ()=>{
+        const schemas = introspectCollections([
+            Posts,
+            Pages,
+            Categories,
+            Authors,
+            Media
+        ]);
+        const edges = buildRelationshipGraph(schemas);
+        const postEdges = edges.filter((e)=>e.fromCollection === 'posts');
+        const postTargets = postEdges.map((e)=>e.toCollection);
+        expect(postTargets).toContain('categories');
+        expect(postTargets).toContain('authors');
+        expect(postTargets).toContain('media');
+        const authorEdges = edges.filter((e)=>e.fromCollection === 'authors');
+        expect(authorEdges.map((e)=>e.toCollection)).toContain('media');
+    });
+});
+
+//# sourceMappingURL=introspection.test.js.map

package/dist/__tests__/introspection.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/__tests__/introspection.test.ts"],"sourcesContent":["import { describe, it, expect } from 'vitest'\nimport type { Block, CollectionConfig } from 'payload'\nimport {\n  introspectCollection,\n  introspectCollections,\n  introspectBlocks,\n  buildRelationshipGraph,\n} from '../introspection'\n\n// ─── Sample schema (kept inline so the test is self-contained) ─────\n\nconst Media: CollectionConfig = {\n  slug: 'media',\n  upload: true,\n  fields: [{ name: 'alt', type: 'text', required: true }],\n}\n\nconst Categories: CollectionConfig = {\n  slug: 'categories',\n  fields: [\n    { name: 'name', type: 'text', required: true },\n    { name: 'slug', type: 'text', required: true },\n  ],\n}\n\nconst Authors: CollectionConfig = {\n  slug: 'authors',\n  fields: [\n    { name: 'name', type: 'text', required: true },\n    { name: 'slug', type: 'text', required: true },\n    { name: 'avatar', type: 'upload', relationTo: 'media' },\n  ],\n}\n\n// Leaf blocks\nconst Heading: Block = {\n  slug: 'heading',\n  fields: [\n    { name: 'text', type: 'text', required: true },\n    {\n      name: 'level',\n      type: 'select',\n      options: ['h1', 'h2', 'h3'],\n      defaultValue: 'h2',\n    },\n    {\n      name: 'align',\n      type: 'select',\n      options: ['left', 'center', 'right'],\n      defaultValue: 'left',\n    },\n  ],\n}\n\nconst RichText: Block = {\n  slug: 'richText',\n  fields: [{ name: 'content', type: 'richText' }],\n}\n\nconst ImageBlock: Block = {\n  slug: 'image',\n  fields: [\n    { name: 'image', type: 'upload', relationTo: 'media', required: true },\n    { name: 'caption', type: 'text' },\n  ],\n}\n\nconst allLeafBlocks: Block[] = [Heading, RichText, ImageBlock]\n\n// Section blocks\nconst FullWidth: Block = {\n  slug: 'fullWidth',\n  fields: [\n    {\n      name: 'content',\n      type: 'blocks',\n      blocks: allLeafBlocks,\n    },\n  ],\n}\n\nconst HeadingOnly: Block = {\n  slug: 'headingOnly',\n  fields: [\n    {\n      name: 'content',\n      type: 'blocks',\n      maxRows: 1,\n      blocks: [Heading],\n    },\n  ],\n}\n\nconst CtaBanner: Block = {\n  slug: 'ctaBanner',\n  fields: [\n    { name: 'headline', type: 'text', required: true },\n    { name: 'buttonLabel', type: 'text' },\n    { name: 'buttonHref', type: 'text' },\n  ],\n}\n\nconst allSectionBlocks: Block[] = [FullWidth, HeadingOnly, CtaBanner]\n\nconst Posts: CollectionConfig = {\n  slug: 'posts',\n  versions: { drafts: true },\n  fields: [\n    { name: 'title', type: 'text', required: true },\n    { name: 'slug', type: 'text', required: true },\n    { name: 'featured', type: 'checkbox' },\n    { name: 'category', type: 'relationship', relationTo: 'categories' },\n    {\n      name: 'authors',\n      type: 'relationship',\n      relationTo: 'authors',\n      hasMany: true,\n    },\n    { name: 'coverImage', type: 'upload', relationTo: 'media' },\n    {\n      name: 'tags',\n      type: 'array',\n      fields: [{ name: 'tag', type: 'text' }],\n    },\n  ],\n}\n\nconst Pages: CollectionConfig = {\n  slug: 'pages',\n  versions: { drafts: true },\n  fields: [\n    {\n      type: 'tabs',\n      tabs: [\n        {\n          name: 'hero',\n          label: 'Hero',\n          fields: [\n            { name: 'heroTitle', type: 'text' },\n            {\n              name: 'heroSize',\n              type: 'select',\n              options: ['small', 'medium', 'large'],\n              defaultValue: 'medium',\n            },\n          ],\n        },\n        {\n          label: 'Content',\n          fields: [\n            { name: 'slug', type: 'text', required: true },\n            { name: 'layout', type: 'blocks', blocks: allSectionBlocks },\n          ],\n        },\n      ],\n    },\n  ],\n}\n\n// ─── Tests ─────────────────────────────────────────────────────────\n\ndescribe('introspectCollection', () => {\n  it('extracts Posts collection fields, relationships, and draft status', () => {\n    const schema = introspectCollection(Posts)\n\n    expect(schema.slug).toBe('posts')\n    expect(schema.hasDrafts).toBe(true)\n\n    const fieldNames = schema.fields.map((f) => f.name)\n    expect(fieldNames).toContain('title')\n    expect(fieldNames).toContain('slug')\n    expect(fieldNames).toContain('featured')\n    expect(fieldNames).toContain('tags')\n\n    const relFieldNames = schema.relationships.map((r) => r.fieldName)\n    expect(relFieldNames).toContain('category')\n    expect(relFieldNames).toContain('authors')\n\n    const cover = schema.relationships.find((r) => r.fieldName === 'coverImage')\n    expect(cover).toBeDefined()\n    expect(cover!.relationTo).toBe('media')\n\n    expect(schema.searchableFields).toContain('title')\n    expect(schema.searchableFields).toContain('slug')\n  })\n\n  it('extracts Pages collection with tab-nested fields', () => {\n    const schema = introspectCollection(Pages)\n\n    expect(schema.slug).toBe('pages')\n    expect(schema.hasDrafts).toBe(true)\n\n    const fieldNames = schema.fields.map((f) => f.name)\n    expect(fieldNames).toContain('heroTitle')\n    expect(fieldNames).toContain('slug')\n    expect(fieldNames).toContain('layout')\n  })\n\n  it('detects collections without draft support', () => {\n    const schema = introspectCollection(Categories)\n    expect(schema.hasDrafts).toBe(false)\n  })\n\n  it('extracts select field options from Pages heroSize', () => {\n    const schema = introspectCollection(Pages)\n    const heroSize = schema.fields.find((f) => f.name === 'heroSize')\n    expect(heroSize).toBeDefined()\n    expect(heroSize!.type).toBe('select')\n    expect(heroSize!.options).toBeDefined()\n    expect(heroSize!.options!.length).toBe(3)\n  })\n})\n\ndescribe('introspectBlocks', () => {\n  it('discovers fullWidth accepts all leaf blocks (composable)', () => {\n    const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks)\n\n    const fullWidth = catalog.sections.find((s) => s.slug === 'fullWidth')\n    expect(fullWidth).toBeDefined()\n    expect(fullWidth!.nestingType).toBe('composable')\n    expect(fullWidth!.acceptedLeafSlugs.length).toBe(allLeafBlocks.length)\n  })\n\n  it('marks ctaBanner as fixed (no nested blocks)', () => {\n    const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks)\n\n    const ctaBanner = catalog.sections.find((s) => s.slug === 'ctaBanner')\n    expect(ctaBanner).toBeDefined()\n    expect(ctaBanner!.nestingType).toBe('fixed')\n    expect(ctaBanner!.acceptedLeafSlugs).toHaveLength(0)\n  })\n\n  it('marks headingOnly as constrained (single leaf type, maxRows: 1)', () => {\n    const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks)\n\n    const headingOnly = catalog.sections.find((s) => s.slug === 'headingOnly')\n    expect(headingOnly).toBeDefined()\n    expect(headingOnly!.nestingType).toBe('constrained')\n    expect(headingOnly!.acceptedLeafSlugs).toEqual(['heading'])\n    expect(headingOnly!.maxRows).toBe(1)\n  })\n\n  it('extracts all leaf blocks', () => {\n    const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks)\n    expect(catalog.leaves).toHaveLength(3)\n    const leafSlugs = catalog.leaves.map((l) => l.slug)\n    expect(leafSlugs).toEqual(['heading', 'richText', 'image'])\n  })\n\n  it('extracts leaf block fields including select options', () => {\n    const catalog = introspectBlocks(allSectionBlocks, allLeafBlocks)\n    const heading = catalog.leaves.find((l) => l.slug === 'heading')\n    expect(heading).toBeDefined()\n    const headingFieldNames = heading!.fields.map((f) => f.name)\n    expect(headingFieldNames).toEqual(['text', 'level', 'align'])\n    const level = heading!.fields.find((f) => f.name === 'level')\n    expect(level!.options).toBeDefined()\n  })\n})\n\ndescribe('buildRelationshipGraph', () => {\n  it('builds correct graph from sample collections', () => {\n    const schemas = introspectCollections([Posts, Pages, Categories, Authors, Media])\n    const edges = buildRelationshipGraph(schemas)\n\n    const postEdges = edges.filter((e) => e.fromCollection === 'posts')\n    const postTargets = postEdges.map((e) => e.toCollection)\n    expect(postTargets).toContain('categories')\n    expect(postTargets).toContain('authors')\n    expect(postTargets).toContain('media')\n\n    const authorEdges = edges.filter((e) => e.fromCollection === 'authors')\n    expect(authorEdges.map((e) => e.toCollection)).toContain('media')\n  })\n})\n"],"names":["describe","it","expect","introspectCollection","introspectCollections","introspectBlocks","buildRelationshipGraph","Media","slug","upload","fields","name","type","required","Categories","Authors","relationTo","Heading","options","defaultValue","RichText","ImageBlock","allLeafBlocks","FullWidth","blocks","HeadingOnly","maxRows","CtaBanner","allSectionBlocks","Posts","versions","drafts","hasMany","Pages","tabs","label","schema","toBe","hasDrafts","fieldNames","map","f","toContain","relFieldNames","relationships","r","fieldName","cover","find","toBeDefined","searchableFields","heroSize","length","catalog","fullWidth","sections","s","nestingType","acceptedLeafSlugs","ctaBanner","toHaveLength","headingOnly","toEqual","leaves","leafSlugs","l","heading","headingFieldNames","level","schemas","edges","postEdges","filter","e","fromCollection","postTargets","toCollection","authorEdges"],"mappings":"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"}