payload-mcp-toolkit 0.7.0 → 0.7.4

package/dist/__tests__/index-integration.test.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/__tests__/index-integration.test.ts"],"sourcesContent":["import { describe, it, expect } from 'vitest'\r\nimport type { Config } from 'payload'\r\nimport { mcpToolkitPlugin } from '../index'\r\n\r\nfunction baseConfig(): Config {\r\n  return {\r\n    serverURL: 'https://app.example.com',\r\n    secret: 'test-secret',\r\n    admin: { user: 'users' },\r\n    collections: [\r\n      {\r\n        slug: 'users',\r\n        auth: true,\r\n        fields: [{ name: 'email', type: 'email', required: true }],\r\n      },\r\n      {\r\n        slug: 'posts',\r\n        fields: [\r\n          { name: 'title', type: 'text' },\r\n          { name: 'slug', type: 'text' },\r\n        ],\r\n      },\r\n    ],\r\n    endpoints: [],\r\n  } as never\r\n}\r\n\r\ndescribe('mcpToolkitPlugin integration', () => {\r\n  it('appends the api-keys collection and the MCP endpoints additively', () => {\r\n    const cfg = mcpToolkitPlugin()(baseConfig())\r\n    const slugs = (cfg.collections ?? []).map((c) => c.slug)\r\n    expect(slugs).toContain('payload-mcp-api-keys')\r\n    expect(slugs).toContain('users')\r\n    expect(slugs).toContain('posts')\r\n    const endpointPaths = (cfg.endpoints ?? []).map((e) => `${e.method.toUpperCase()} ${e.path}`)\r\n    expect(endpointPaths).toEqual(expect.arrayContaining(['POST /mcp', 'GET /mcp']))\r\n  })\r\n\r\n  it('attaches the bearer strategy to the user collection without losing existing auth config', () => {\r\n    const cfg = mcpToolkitPlugin()(baseConfig())\r\n    const users = (cfg.collections ?? []).find((c) => c.slug === 'users') as {\r\n      auth: { strategies?: Array<{ name: string }> }\r\n    }\r\n    expect(users).toBeDefined()\r\n    const names = users.auth.strategies?.map((s) => s.name) ?? []\r\n    expect(names).toContain('mcp-toolkit-bearer')\r\n  })\r\n\r\n  it('preserves existing auth.strategies on the user collection', () => {\r\n    const cfg = baseConfig() as Config & {\r\n      collections: Array<{ slug: string; auth?: unknown; fields: unknown[] }>\r\n    }\r\n    const otherStrategy = { name: 'tenant-shared-strategy', authenticate: async () => ({ user: null }) }\r\n    cfg.collections[0]!.auth = { strategies: [otherStrategy] } as never\r\n    const out = mcpToolkitPlugin()(cfg as never)\r\n    const users = (out.collections ?? []).find((c) => c.slug === 'users') as {\r\n      auth: { strategies: Array<{ name: string }> }\r\n    }\r\n    const names = users.auth.strategies.map((s) => s.name)\r\n    expect(names).toEqual(['tenant-shared-strategy', 'mcp-toolkit-bearer'])\r\n  })\r\n\r\n  it('respects a custom user collection slug from incomingConfig.admin.user', () => {\r\n    const cfg = baseConfig() as Config & {\r\n      collections: Array<{ slug: string; auth?: unknown; fields: unknown[] }>\r\n      admin?: { user?: string }\r\n    }\r\n    cfg.admin = { user: 'admins' }\r\n    cfg.collections[0]!.slug = 'admins'\r\n    const out = mcpToolkitPlugin()(cfg as never)\r\n    const admins = (out.collections ?? []).find((c) => c.slug === 'admins') as {\r\n      auth: { strategies?: Array<{ name: string }> }\r\n    }\r\n    expect(admins.auth.strategies?.some((s) => s.name === 'mcp-toolkit-bearer')).toBe(true)\r\n  })\r\n\r\n  it('throws when @payloadcms/plugin-mcp appears to also be registered', () => {\r\n    const cfg = baseConfig() as Config\r\n    function mcpPlugin() {}\r\n    ;(cfg as { plugins: unknown[] }).plugins = [mcpPlugin as never]\r\n    expect(() => mcpToolkitPlugin()(cfg)).toThrow(/standalone successor/)\r\n  })\r\n\r\n  it('throws when an existing collection takes the api-keys slug', () => {\r\n    const cfg = baseConfig() as Config & {\r\n      collections: Array<{ slug: string; fields: unknown[] }>\r\n    }\r\n    cfg.collections.push({ slug: 'payload-mcp-api-keys', fields: [] })\r\n    expect(() => mcpToolkitPlugin()(cfg as never)).toThrow(/payload-mcp-api-keys/)\r\n  })\r\n\r\n  it('honours a custom apiKeyCollection.slug', () => {\r\n    const cfg = mcpToolkitPlugin({ apiKeyCollection: { slug: 'my-keys' } })(baseConfig())\r\n    const slugs = (cfg.collections ?? []).map((c) => c.slug)\r\n    expect(slugs).toContain('my-keys')\r\n    expect(slugs).not.toContain('payload-mcp-api-keys')\r\n  })\r\n\r\n  it('a host config with no globals still registers the globalScopes field (matrix shows empty state)', () => {\r\n    const cfg = mcpToolkitPlugin()(baseConfig())\r\n    // The field always renders under Custom; the matrix component reports\r\n    // the absence via its own empty-state copy when availableGlobals is [].\r\n    const apiKeys = (cfg.collections ?? []).find((c) => c.slug === 'payload-mcp-api-keys') as {\r\n      fields: Array<{\r\n        name?: string\r\n        admin?: {\r\n          condition?: (data: unknown) => boolean\r\n          components?: { Field?: { clientProps?: { availableGlobals?: string[] } } }\r\n        }\r\n      }>\r\n    }\r\n    const globalScopes = apiKeys.fields.find((f) => f.name === 'globalScopes')!\r\n    expect(globalScopes.admin?.condition?.({ preset: 'custom' })).toBe(true)\r\n    expect(globalScopes.admin?.condition?.({ preset: 'editor' })).toBe(false)\r\n    expect(globalScopes.admin?.components?.Field?.clientProps?.availableGlobals).toEqual([])\r\n  })\r\n\r\n  it('a host config with one plain global makes globalScopes UI render under Custom', () => {\r\n    const cfg = baseConfig() as Config & { globals?: unknown[] }\r\n    cfg.globals = [\r\n      { slug: 'site-settings', fields: [{ name: 'siteName', type: 'text' }] },\r\n    ] as never\r\n    const out = mcpToolkitPlugin()(cfg)\r\n    const apiKeys = (out.collections ?? []).find((c) => c.slug === 'payload-mcp-api-keys') as {\r\n      fields: Array<{\r\n        name?: string\r\n        admin?: {\r\n          condition?: (data: unknown) => boolean\r\n          components?: { Field?: { clientProps?: { availableGlobals?: string[] } } }\r\n        }\r\n      }>\r\n    }\r\n    const globalScopes = apiKeys.fields.find((f) => f.name === 'globalScopes')!\r\n    expect(globalScopes.admin?.condition?.({ preset: 'custom' })).toBe(true)\r\n    expect(globalScopes.admin?.components?.Field?.clientProps?.availableGlobals).toEqual([\r\n      'site-settings',\r\n    ])\r\n  })\r\n\r\n  it('excluded globals are filtered out of availableGlobals at registration time', () => {\r\n    const cfg = baseConfig() as Config & { globals?: unknown[] }\r\n    cfg.globals = [\r\n      { slug: 'site-settings', fields: [{ name: 'siteName', type: 'text' }] },\r\n      { slug: 'secret-config', fields: [{ name: 'token', type: 'text' }] },\r\n    ] as never\r\n    const out = mcpToolkitPlugin({ exclude: { globals: ['secret-config'] } })(cfg)\r\n    const apiKeys = (out.collections ?? []).find((c) => c.slug === 'payload-mcp-api-keys') as {\r\n      fields: Array<{\r\n        name?: string\r\n        admin?: { components?: { Field?: { clientProps?: { availableGlobals?: string[] } } } }\r\n      }>\r\n    }\r\n    const globalScopes = apiKeys.fields.find((f) => f.name === 'globalScopes')!\r\n    expect(globalScopes.admin?.components?.Field?.clientProps?.availableGlobals).toEqual([\r\n      'site-settings',\r\n    ])\r\n  })\r\n})\r\n"],"names":["describe","it","expect","mcpToolkitPlugin","baseConfig","serverURL","secret","admin","user","collections","slug","auth","fields","name","type","required","endpoints","cfg","slugs","map","c","toContain","endpointPaths","e","method","toUpperCase","path","toEqual","arrayContaining","users","find","toBeDefined","names","strategies","s","otherStrategy","authenticate","out","admins","some","toBe","mcpPlugin","plugins","toThrow","push","apiKeyCollection","not","apiKeys","globalScopes","f","condition","preset","components","Field","clientProps","availableGlobals","globals","exclude"],"mappings":"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"}

package/dist/__tests__/introspection.test.js

@@ -1,659 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { introspectCollection, introspectCollections, introspectBlocks, buildBlockNestingMap, buildRelationshipGraph, hasGlobalDrafts, introspectGlobal, introspectGlobals } 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-style 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'
-        }
-    ]
-};
-// Container-style blocks (have nested blocks fields)
-const FullWidth = {
-    slug: 'fullWidth',
-    fields: [
-        {
-            name: 'content',
-            type: 'blocks',
-            blocks: [
-                Heading,
-                RichText,
-                ImageBlock
-            ]
-        }
-    ]
-};
-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'
-        }
-    ]
-};
-// Deeply-nestable container — exercises the recursive path
-const Accordion = {
-    slug: 'accordion',
-    fields: [
-        {
-            name: 'panels',
-            type: 'array',
-            fields: [
-                {
-                    name: 'title',
-                    type: 'text'
-                },
-                {
-                    name: 'body',
-                    type: 'blocks',
-                    blocks: [
-                        Heading,
-                        RichText,
-                        FullWidth
-                    ]
-                }
-            ]
-        }
-    ]
-};
-const allBlocks = [
-    Heading,
-    RichText,
-    ImageBlock,
-    FullWidth,
-    HeadingOnly,
-    CtaBanner,
-    Accordion
-];
-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: [
-                                FullWidth,
-                                HeadingOnly,
-                                CtaBanner,
-                                Accordion
-                            ]
-                        }
-                    ]
-                }
-            ]
-        }
-    ]
-};
-// ─── introspectCollection ──────────────────────────────────────────
-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);
-    });
-});
-// ─── introspectBlocks (flat catalog) ───────────────────────────────
-describe('introspectBlocks', ()=>{
-    it('returns a flat catalog of every block with no section/leaf split', ()=>{
-        const catalog = introspectBlocks(allBlocks);
-        const slugs = catalog.blocks.map((b)=>b.slug);
-        expect(slugs).toEqual([
-            'heading',
-            'richText',
-            'image',
-            'fullWidth',
-            'headingOnly',
-            'ctaBanner',
-            'accordion'
-        ]);
-    });
-    it('extracts each block\'s fields including select options', ()=>{
-        const catalog = introspectBlocks(allBlocks);
-        const heading = catalog.blocks.find((b)=>b.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();
-    });
-});
-// ─── buildBlockNestingMap ──────────────────────────────────────────
-describe('buildBlockNestingMap', ()=>{
-    it('records the layout field on Pages with the slugs it accepts', ()=>{
-        const map = buildBlockNestingMap([
-            Pages,
-            Posts
-        ], allBlocks);
-        const pageLayout = map.find((e)=>e.ownerType === 'collection' && e.owner === 'pages' && e.fieldPath === 'layout');
-        expect(pageLayout).toBeDefined();
-        expect(pageLayout.acceptedBlockSlugs).toEqual([
-            'fullWidth',
-            'headingOnly',
-            'ctaBanner',
-            'accordion'
-        ]);
-    });
-    it('records nested blocks fields inside container blocks', ()=>{
-        const map = buildBlockNestingMap([
-            Pages
-        ], allBlocks);
-        const fullWidthContent = map.find((e)=>e.ownerType === 'block' && e.owner === 'fullWidth' && e.fieldPath === 'content');
-        expect(fullWidthContent).toBeDefined();
-        expect(fullWidthContent.acceptedBlockSlugs).toEqual([
-            'heading',
-            'richText',
-            'image'
-        ]);
-        const headingOnly = map.find((e)=>e.ownerType === 'block' && e.owner === 'headingOnly' && e.fieldPath === 'content');
-        expect(headingOnly.acceptedBlockSlugs).toEqual([
-            'heading'
-        ]);
-        expect(headingOnly.maxRows).toBe(1);
-    });
-    it('handles arbitrarily-deep nesting via array fields inside blocks', ()=>{
-        const map = buildBlockNestingMap([
-            Pages
-        ], allBlocks);
-        const accordionPanelBody = map.find((e)=>e.ownerType === 'block' && e.owner === 'accordion' && e.fieldPath === 'panels[].body');
-        expect(accordionPanelBody).toBeDefined();
-        expect(accordionPanelBody.acceptedBlockSlugs).toEqual([
-            'heading',
-            'richText',
-            'fullWidth'
-        ]);
-    });
-    it('omits unknown slugs not present in the block list', ()=>{
-        const Stray = {
-            slug: 'stray',
-            fields: [
-                {
-                    name: 'layout',
-                    type: 'blocks',
-                    blocks: [
-                        Heading,
-                        {
-                            slug: 'mystery',
-                            fields: []
-                        }
-                    ]
-                }
-            ]
-        };
-        const map = buildBlockNestingMap([
-            Stray
-        ], [
-            Heading
-        ]) // mystery not in catalog
-        ;
-        const stray = map.find((e)=>e.owner === 'stray' && e.fieldPath === 'layout');
-        expect(stray.acceptedBlockSlugs).toEqual([
-            'heading'
-        ]);
-    });
-    it('omits fixed blocks (no nested blocks fields) from the map', ()=>{
-        const map = buildBlockNestingMap([
-            Pages
-        ], allBlocks);
-        const ctaEntries = map.filter((e)=>e.owner === 'ctaBanner');
-        expect(ctaEntries).toHaveLength(0);
-    });
-});
-// ─── buildRelationshipGraph ────────────────────────────────────────
-// ─── Global introspection ──────────────────────────────────────────
-const SiteSettings = {
-    slug: 'site-settings',
-    fields: [
-        {
-            name: 'siteName',
-            type: 'text',
-            required: true
-        },
-        {
-            name: 'tagline',
-            type: 'text'
-        },
-        {
-            name: 'social',
-            type: 'group',
-            fields: [
-                {
-                    name: 'twitter',
-                    type: 'text'
-                },
-                {
-                    name: 'instagram',
-                    type: 'text'
-                }
-            ]
-        }
-    ]
-};
-const FooterGlobal = {
-    slug: 'footer',
-    versions: {
-        drafts: true
-    },
-    fields: [
-        {
-            name: 'layout',
-            type: 'blocks',
-            blocks: [
-                Heading,
-                CtaBanner
-            ]
-        }
-    ]
-};
-const HeaderGlobal = {
-    slug: 'header',
-    fields: [
-        {
-            name: 'menu',
-            type: 'group',
-            fields: [
-                {
-                    name: 'label',
-                    type: 'text'
-                },
-                {
-                    name: 'links',
-                    type: 'blocks',
-                    blocks: [
-                        Heading
-                    ]
-                }
-            ]
-        }
-    ]
-};
-describe('hasGlobalDrafts', ()=>{
-    it('returns true for { versions: { drafts: true } }', ()=>{
-        expect(hasGlobalDrafts({
-            slug: 'g',
-            versions: {
-                drafts: true
-            },
-            fields: []
-        })).toBe(true);
-    });
-    it('returns false for { versions: { drafts: false } }', ()=>{
-        expect(hasGlobalDrafts({
-            slug: 'g',
-            versions: {
-                drafts: false
-            },
-            fields: []
-        })).toBe(false);
-    });
-    it('returns false when versions is undefined', ()=>{
-        expect(hasGlobalDrafts({
-            slug: 'g',
-            fields: []
-        })).toBe(false);
-    });
-    it('returns false for versions without drafts key', ()=>{
-        expect(hasGlobalDrafts({
-            slug: 'g',
-            versions: {
-                maxPerDoc: 10
-            },
-            fields: []
-        })).toBe(false);
-    });
-});
-describe('introspectGlobal', ()=>{
-    it('extracts SiteSettings fields and draft/live-preview flags', ()=>{
-        const schema = introspectGlobal(SiteSettings);
-        expect(schema.slug).toBe('site-settings');
-        expect(schema.hasDrafts).toBe(false);
-        expect(schema.hasLivePreview).toBe(false);
-        const names = schema.fields.map((f)=>f.name);
-        expect(names).toContain('siteName');
-        expect(names).toContain('tagline');
-        const social = schema.fields.find((f)=>f.name === 'social');
-        expect(social?.type).toBe('group');
-        expect(social?.fields?.map((f)=>f.name)).toEqual([
-            'twitter',
-            'instagram'
-        ]);
-    });
-    it('reports hasDrafts: true when versions.drafts is set', ()=>{
-        expect(introspectGlobal(FooterGlobal).hasDrafts).toBe(true);
-    });
-});
-describe('introspectGlobals', ()=>{
-    it('returns an empty Map for []', ()=>{
-        expect(introspectGlobals([]).size).toBe(0);
-    });
-    it('keys the map by slug', ()=>{
-        const map = introspectGlobals([
-            SiteSettings,
-            FooterGlobal
-        ]);
-        expect(map.has('site-settings')).toBe(true);
-        expect(map.has('footer')).toBe(true);
-    });
-});
-describe('buildBlockNestingMap with globals', ()=>{
-    it('emits an edge with ownerType "global" for a top-level blocks field', ()=>{
-        const map = buildBlockNestingMap([], [
-            FooterGlobal
-        ], allBlocks);
-        const edge = map.find((e)=>e.ownerType === 'global' && e.owner === 'footer' && e.fieldPath === 'layout');
-        expect(edge).toBeDefined();
-        expect(edge.acceptedBlockSlugs).toEqual([
-            'heading',
-            'ctaBanner'
-        ]);
-    });
-    it('walks group-nested blocks fields under a global with the dotted path', ()=>{
-        const map = buildBlockNestingMap([], [
-            HeaderGlobal
-        ], allBlocks);
-        const edge = map.find((e)=>e.ownerType === 'global' && e.owner === 'header' && e.fieldPath === 'menu.links');
-        expect(edge).toBeDefined();
-        expect(edge.acceptedBlockSlugs).toEqual([
-            'heading'
-        ]);
-    });
-    it('two-arg call (no globals) produces the same edges as before — regression guard', ()=>{
-        const before = buildBlockNestingMap([
-            Pages
-        ], allBlocks);
-        const after = buildBlockNestingMap([
-            Pages
-        ], [], allBlocks);
-        expect(after).toEqual(before);
-    });
-    it('invariant: throws when (owner, fieldPath) appears with different ownerTypes', ()=>{
-        const ClashCollection = {
-            slug: 'site-settings',
-            fields: [
-                {
-                    name: 'layout',
-                    type: 'blocks',
-                    blocks: [
-                        Heading
-                    ]
-                }
-            ]
-        };
-        const ClashGlobal = {
-            slug: 'site-settings',
-            fields: [
-                {
-                    name: 'layout',
-                    type: 'blocks',
-                    blocks: [
-                        Heading
-                    ]
-                }
-            ]
-        };
-        expect(()=>buildBlockNestingMap([
-                ClashCollection
-            ], [
-                ClashGlobal
-            ], [
-                Heading
-            ])).toThrow(/invariant violated/i);
-    });
-});
-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