@actuate-media/cms-core 0.49.0 → 0.50.0

package/dist/__tests__/api/resolve-layout-bridge.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolve-layout-bridge.test.d.ts.map

package/dist/__tests__/api/resolve-layout-bridge.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-layout-bridge.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/api/resolve-layout-bridge.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/api/resolve-layout-bridge.test.js

@@ -0,0 +1,165 @@
+import { beforeEach, describe, expect, it } from 'vitest';
+import { handleActuateAPI } from '../../api/index.js';
+import { initDB } from '../../db.js';
+function createMockDB(docs) {
+    const rows = docs.map((d) => ({ ...d, deletedAt: d.deletedAt ?? null }));
+    const matches = (d, where) => {
+        if (!where)
+            return true;
+        if (where.id && d.id !== where.id)
+            return false;
+        if (where.collection && d.collection !== where.collection)
+            return false;
+        if (where.status && d.status !== where.status)
+            return false;
+        if (where.deletedAt === null && d.deletedAt)
+            return false;
+        if (where.OR && Array.isArray(where.OR)) {
+            return where.OR.some((clause) => {
+                if (clause.slug !== undefined)
+                    return d.slug === clause.slug;
+                if (clause.data?.path && clause.data?.equals !== undefined) {
+                    return d.data?.[clause.data.path[0]] === clause.data.equals;
+                }
+                return false;
+            });
+        }
+        return true;
+    };
+    return {
+        apiKey: { findMany: async () => [], findUnique: async () => null },
+        document: {
+            findMany: async ({ where } = {}) => rows.filter((d) => matches(d, where)),
+            findFirst: async ({ where }) => rows.find((d) => matches(d, where ?? {})) ?? null,
+            count: async () => rows.length,
+        },
+        version: { create: async () => ({}), findMany: async () => [], count: async () => 0 },
+        auditLog: { create: async () => ({}) },
+        webhook: { findMany: async () => [] },
+        webhookDelivery: { create: async () => ({}) },
+        user: {},
+        session: {},
+        media: {},
+    };
+}
+const pagesCollection = {
+    slug: 'pages',
+    labels: { singular: 'Page', plural: 'Pages' },
+    type: 'page',
+    urlPrefix: '',
+    fields: {
+        title: { type: 'text', label: 'Title', required: true },
+        slug: { type: 'slug', label: 'Slug', required: true },
+        sections: { type: 'json', label: 'Sections' },
+    },
+};
+const cmsConfig = { collections: { pages: pagesCollection } };
+// A page-builder tree (page → section → row → column → hero block) with no
+// flat `sections` array of its own.
+const layoutTree = {
+    id: 'page',
+    type: 'page',
+    children: [
+        {
+            id: 'sec',
+            type: 'section',
+            settings: { htmlId: 'top' },
+            children: [
+                {
+                    id: 'row',
+                    type: 'row',
+                    settings: {},
+                    children: [
+                        {
+                            id: 'col',
+                            type: 'column',
+                            settings: { width: 12 },
+                            children: [
+                                {
+                                    id: 'blk',
+                                    type: 'block',
+                                    settings: { blockType: 'hero' },
+                                    data: { title: 'Welcome home', subtitle: 'Built in the page builder' },
+                                },
+                            ],
+                        },
+                    ],
+                },
+            ],
+        },
+    ],
+};
+beforeEach(() => {
+    delete globalThis.__actuateConfig;
+    process.env.CMS_SECRET = 'a'.repeat(48);
+});
+describe('GET /resolve — page-builder (_layout) → sections bridge', () => {
+    it('derives data.sections from _layout when the page has no flat sections', async () => {
+        const docs = [
+            {
+                id: 'doc-1',
+                collection: 'pages',
+                slug: 'home',
+                status: 'PUBLISHED',
+                data: { title: 'Home', slug: 'home', _layout: layoutTree },
+                publishedAt: new Date('2026-01-01T00:00:00Z'),
+                updatedAt: new Date('2026-01-01T00:00:00Z'),
+            },
+        ];
+        const db = createMockDB(docs);
+        initDB(db);
+        const handler = handleActuateAPI({ prismaClient: db, config: cmsConfig });
+        const res = await handler(new Request('https://example.com/api/cms/resolve?path=/home'));
+        expect(res.status).toBe(200);
+        const body = await res.json();
+        const sections = body.data.data.sections;
+        expect(Array.isArray(sections)).toBe(true);
+        expect(sections).toHaveLength(1);
+        expect(sections[0].sectionType).toBe('hero');
+        expect(sections[0].content).toMatchObject({
+            heading: 'Welcome home',
+            body: 'Built in the page builder',
+        });
+        expect(sections[0].settings.anchorId).toBe('top');
+        // The raw tree is never exposed to the client.
+        expect(body.data.data._layout).toBeUndefined();
+    });
+    it('does not overwrite an existing flat sections array', async () => {
+        const docs = [
+            {
+                id: 'doc-2',
+                collection: 'pages',
+                slug: 'about',
+                status: 'PUBLISHED',
+                data: {
+                    title: 'About',
+                    slug: 'about',
+                    _layout: layoutTree,
+                    sections: [
+                        {
+                            id: 's1',
+                            sectionType: 'text',
+                            name: 'Text Block',
+                            visible: true,
+                            content: { heading: 'Hand-authored', body: 'wins' },
+                            settings: {},
+                        },
+                    ],
+                },
+                publishedAt: new Date('2026-01-01T00:00:00Z'),
+                updatedAt: new Date('2026-01-01T00:00:00Z'),
+            },
+        ];
+        const db = createMockDB(docs);
+        initDB(db);
+        const handler = handleActuateAPI({ prismaClient: db, config: cmsConfig });
+        const res = await handler(new Request('https://example.com/api/cms/resolve?path=/about'));
+        expect(res.status).toBe(200);
+        const body = await res.json();
+        const sections = body.data.data.sections;
+        expect(sections).toHaveLength(1);
+        expect(sections[0].sectionType).toBe('text');
+        expect(sections[0].content.heading).toBe('Hand-authored');
+    });
+});
+//# sourceMappingURL=resolve-layout-bridge.test.js.map

package/dist/__tests__/api/resolve-layout-bridge.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-layout-bridge.test.js","sourceRoot":"","sources":["../../../src/__tests__/api/resolve-layout-bridge.test.ts"],"names":[],"mappings":"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"}

package/dist/api/handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/api/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AA+lC5C,iFAAiF;AACjF,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AA8JD,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAS9E;AAiVD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsvYzD"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/api/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAgmC5C,iFAAiF;AACjF,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AA8JD,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAS9E;AAiVD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqwYzD"}

package/dist/api/handlers.js

@@ -45,7 +45,7 @@ import { createSSEPresenceAdapter } from '../presence/index.js';
 import { BUILT_IN_TEMPLATES } from '../page-builder/templates.js';
 import { validateTree } from '../page-builder/validate.js';
 import { auditAccessibility, fixAccessibility } from '../page-builder/a11y-fix.js';
-import { SECTION_TYPE_LIST, getSectionType, getSectionTypesForScope, buildSection, coerceSections, coercePostHeader, defaultPostHeader, createPostTemplate, addSection as addSectionToList, removeSection as removeSectionFromList, reorderSections as reorderSectionList, setSectionVisibility, updateSectionContent as updateSectionContentInList, updateSectionSettings as updateSectionSettingsInList, updateSectionMeta as updateSectionMetaInList, validateSectionContent, } from '../sections/index.js';
+import { SECTION_TYPE_LIST, getSectionType, getSectionTypesForScope, buildSection, coerceSections, coercePostHeader, layoutTreeToSections, defaultPostHeader, createPostTemplate, addSection as addSectionToList, removeSection as removeSectionFromList, reorderSections as reorderSectionList, setSectionVisibility, updateSectionContent as updateSectionContentInList, updateSectionSettings as updateSectionSettingsInList, updateSectionMeta as updateSectionMetaInList, validateSectionContent, } from '../sections/index.js';
 import { buildPostsOrderBy, buildPostsWhere, extractSeoScore as extractPostSeoScore, resolveQueryCollections, } from '../posts/query.js';
 import { getClientIp, isResolvedIp } from '../security/client-ip.js';
 import { safeFetch, SsrfBlockedError } from '../security/safe-fetch.js';
@@ -8771,7 +8771,20 @@ export function registerCMSRoutes(router) {
                     }
                 }
                 const layout = await resolveLayout(pathParam, docData, matchedCollection);
-                const { _layout: _omit, ...cleanData } = docData;
+                const { _layout: layoutTree, ...cleanData } = docData;
+                // WS-A5 compat bridge (ADR 0001): a document authored only in the
+                // page-builder tree (`_layout`, Model B) still renders through the
+                // canonical sections path. When it has no flat `sections` of its own,
+                // derive a best-effort PageSection[] from the tree at read time so
+                // page-builder content is never stranded. Non-destructive — the stored
+                // document is untouched; only the response is enriched.
+                if ((!Array.isArray(cleanData.sections) || cleanData.sections.length === 0) &&
+                    layoutTree &&
+                    typeof layoutTree === 'object') {
+                    const bridged = layoutTreeToSections(layoutTree);
+                    if (bridged.length > 0)
+                        cleanData.sections = bridged;
+                }
                 // Compose page meta + JSON-LD up front so client renderers (Next.js
                 // generateMetadata, plain SSR, MCP agents) don't have to re-derive
                 // schema, OG tags, and canonical URLs from raw doc data. Reads the