@actuate-media/cms-core 0.25.1 → 0.27.0

package/dist/sections/helpers.d.ts

@@ -0,0 +1,62 @@
+import type { PageSection, PostHeaderConfig, PostTemplate, SectionSettings, SectionTypeId } from './types.js';
+/** Generate a unique section id (UUID when available, monotonic fallback). */
+export declare function generateSectionId(): string;
+/** Create a fresh section of the given type, seeded with registry defaults. */
+export declare function createSection(type: SectionTypeId): PageSection;
+/** Insert a section at `index` (defaults to the end). Returns a new array. */
+export declare function addSection(sections: PageSection[], section: PageSection, index?: number): PageSection[];
+export declare function removeSection(sections: PageSection[], id: string): PageSection[];
+/** Duplicate a section (new id, "(Copy)" suffix), inserted right after the original. */
+export declare function duplicateSection(sections: PageSection[], id: string): PageSection[];
+export declare function toggleSectionVisibility(sections: PageSection[], id: string): PageSection[];
+/** Explicitly set a section's visibility (used by the API toggle endpoint). */
+export declare function setSectionVisibility(sections: PageSection[], id: string, visible: boolean): PageSection[];
+/** Move the section with `id` to a new index (clamped). Returns a new array. */
+export declare function moveSection(sections: PageSection[], id: string, toIndex: number): PageSection[];
+/** Reorder to an explicit id order (used by drag-and-drop drop handlers). */
+export declare function reorderSections(sections: PageSection[], orderedIds: string[]): PageSection[];
+export declare function updateSectionContent(sections: PageSection[], id: string, patch: Record<string, unknown>): PageSection[];
+export declare function updateSectionSettings(sections: PageSection[], id: string, patch: Partial<SectionSettings>): PageSection[];
+export declare function updateSectionMeta(sections: PageSection[], id: string, patch: {
+    name?: string;
+    internalLabel?: string;
+}): PageSection[];
+/**
+ * Normalize arbitrary JSON into a clean `PageSection[]`.
+ *
+ * Drops entries with an unknown `sectionType` (rather than rendering a
+ * blank), backfills missing ids/names, and coerces visibility. Used when
+ * reading `data.sections` from the DB and when accepting an AI/agent
+ * payload that may be partially shaped.
+ */
+export declare function coerceSections(raw: unknown): PageSection[];
+/**
+ * Build a fully-formed section from a (possibly partial) AI/agent payload:
+ * start from the registry defaults for `type`, then shallow-merge the
+ * provided `content` / `settings` and apply an optional display name.
+ * The returned section always has a fresh id + valid shape.
+ */
+export declare function buildSection(type: SectionTypeId, input?: {
+    name?: string;
+    internalLabel?: string;
+    visible?: boolean;
+    content?: Record<string, unknown>;
+    settings?: Partial<SectionSettings>;
+}): PageSection;
+/** Sensible default header layout for a brand-new post type template. */
+export declare function defaultPostHeader(): PostHeaderConfig;
+/**
+ * Normalize arbitrary JSON into a clean {@link PostHeaderConfig}, falling
+ * back to {@link defaultPostHeader} for any missing/invalid keys. Used when
+ * reading a `post-templates` document or accepting an agent payload.
+ */
+export declare function coercePostHeader(raw: unknown): PostHeaderConfig;
+/**
+ * Build a default template for a post type: a centered header plus an
+ * article body and a related-posts block — a usable starting point an
+ * author or AI agent can then alter.
+ */
+export declare function createPostTemplate(postType: string): PostTemplate;
+/** Normalize a raw `post-templates` document's data into a {@link PostTemplate}. */
+export declare function coercePostTemplate(postType: string, raw: unknown): PostTemplate;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/sections/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/sections/helpers.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAA;AAMnB,8EAA8E;AAC9E,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C;AAID,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,WAAW,CAW9D;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CACxB,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,EAAE,WAAW,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,WAAW,EAAE,CAKf;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,EAAE,CAEhF;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,EAAE,CAYnF;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,EAAE,CAE1F;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,WAAW,EAAE,EACvB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,GACf,WAAW,EAAE,CAEf;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAQ/F;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAM5F;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,WAAW,EAAE,EACvB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,WAAW,EAAE,CAEf;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,WAAW,EAAE,EACvB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,GAC9B,WAAW,EAAE,CAEf;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,WAAW,EAAE,EACvB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,WAAW,EAAE,CAEf;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,EAAE,CAoB1D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,aAAa,EACnB,KAAK,GAAE;IACL,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAA;CAC/B,GACL,WAAW,CAUb;AAID,yEAAyE;AACzE,wBAAgB,iBAAiB,IAAI,gBAAgB,CAUpD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAmB/D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAMjE;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,YAAY,CAO/E"}

package/dist/sections/helpers.js

@@ -0,0 +1,202 @@
+/**
+ * Pure helpers over `PageSection[]`.
+ *
+ * Every function is side-effect free and returns a NEW array, so the admin
+ * editor state, the REST section endpoints, the MCP tools, and the unit
+ * tests all share ONE implementation. No DOM, React, or Node APIs here —
+ * keep this module isomorphic so it runs in the browser and on the server.
+ */
+import { SECTION_TYPES, getSectionType } from './registry.js';
+// ─── ID generation ───────────────────────────────────────────────────
+let idCounter = 0;
+/** Generate a unique section id (UUID when available, monotonic fallback). */
+export function generateSectionId() {
+    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+        return crypto.randomUUID();
+    }
+    idCounter += 1;
+    return `sec_${Date.now().toString(36)}_${idCounter}`;
+}
+// ─── Section factory + array helpers ─────────────────────────────────
+/** Create a fresh section of the given type, seeded with registry defaults. */
+export function createSection(type) {
+    const def = SECTION_TYPES[type];
+    return {
+        id: generateSectionId(),
+        sectionType: type,
+        name: def.name,
+        visible: true,
+        // deep clone so two sections never share content/settings references
+        content: structuredClone(def.defaultContent),
+        settings: structuredClone(def.defaultSettings),
+    };
+}
+/** Insert a section at `index` (defaults to the end). Returns a new array. */
+export function addSection(sections, section, index) {
+    const next = sections.slice();
+    const at = index === undefined || index < 0 || index > next.length ? next.length : index;
+    next.splice(at, 0, section);
+    return next;
+}
+export function removeSection(sections, id) {
+    return sections.filter((s) => s.id !== id);
+}
+/** Duplicate a section (new id, "(Copy)" suffix), inserted right after the original. */
+export function duplicateSection(sections, id) {
+    const idx = sections.findIndex((s) => s.id === id);
+    if (idx === -1)
+        return sections;
+    const original = sections[idx];
+    const copy = {
+        ...original,
+        id: generateSectionId(),
+        name: `${original.name} (Copy)`,
+        content: structuredClone(original.content),
+        settings: structuredClone(original.settings),
+    };
+    return addSection(sections, copy, idx + 1);
+}
+export function toggleSectionVisibility(sections, id) {
+    return sections.map((s) => (s.id === id ? { ...s, visible: !s.visible } : s));
+}
+/** Explicitly set a section's visibility (used by the API toggle endpoint). */
+export function setSectionVisibility(sections, id, visible) {
+    return sections.map((s) => (s.id === id ? { ...s, visible } : s));
+}
+/** Move the section with `id` to a new index (clamped). Returns a new array. */
+export function moveSection(sections, id, toIndex) {
+    const from = sections.findIndex((s) => s.id === id);
+    if (from === -1)
+        return sections;
+    const next = sections.slice();
+    const [moved] = next.splice(from, 1);
+    const clamped = Math.max(0, Math.min(toIndex, next.length));
+    next.splice(clamped, 0, moved);
+    return next;
+}
+/** Reorder to an explicit id order (used by drag-and-drop drop handlers). */
+export function reorderSections(sections, orderedIds) {
+    const byId = new Map(sections.map((s) => [s.id, s]));
+    const ordered = orderedIds.map((id) => byId.get(id)).filter((s) => Boolean(s));
+    // append any sections missing from orderedIds (defensive) to avoid data loss
+    for (const s of sections)
+        if (!orderedIds.includes(s.id))
+            ordered.push(s);
+    return ordered;
+}
+export function updateSectionContent(sections, id, patch) {
+    return sections.map((s) => (s.id === id ? { ...s, content: { ...s.content, ...patch } } : s));
+}
+export function updateSectionSettings(sections, id, patch) {
+    return sections.map((s) => (s.id === id ? { ...s, settings: { ...s.settings, ...patch } } : s));
+}
+export function updateSectionMeta(sections, id, patch) {
+    return sections.map((s) => (s.id === id ? { ...s, ...patch } : s));
+}
+/**
+ * Normalize arbitrary JSON into a clean `PageSection[]`.
+ *
+ * Drops entries with an unknown `sectionType` (rather than rendering a
+ * blank), backfills missing ids/names, and coerces visibility. Used when
+ * reading `data.sections` from the DB and when accepting an AI/agent
+ * payload that may be partially shaped.
+ */
+export function coerceSections(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const item of raw) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const s = item;
+        const type = String(s.sectionType ?? '');
+        if (!getSectionType(type))
+            continue; // drop unknown types instead of rendering blanks
+        out.push({
+            id: typeof s.id === 'string' && s.id ? s.id : generateSectionId(),
+            sectionType: type,
+            name: typeof s.name === 'string' ? s.name : SECTION_TYPES[type].name,
+            internalLabel: typeof s.internalLabel === 'string' ? s.internalLabel : undefined,
+            visible: s.visible !== false,
+            content: s.content && typeof s.content === 'object' ? s.content : {},
+            settings: s.settings && typeof s.settings === 'object' ? s.settings : {},
+        });
+    }
+    return out;
+}
+/**
+ * Build a fully-formed section from a (possibly partial) AI/agent payload:
+ * start from the registry defaults for `type`, then shallow-merge the
+ * provided `content` / `settings` and apply an optional display name.
+ * The returned section always has a fresh id + valid shape.
+ */
+export function buildSection(type, input = {}) {
+    const base = createSection(type);
+    return {
+        ...base,
+        name: input.name && input.name.trim() ? input.name : base.name,
+        ...(input.internalLabel !== undefined ? { internalLabel: input.internalLabel } : {}),
+        visible: input.visible !== false,
+        content: { ...base.content, ...(input.content ?? {}) },
+        settings: { ...base.settings, ...(input.settings ?? {}) },
+    };
+}
+// ─── Post templates ──────────────────────────────────────────────────
+/** Sensible default header layout for a brand-new post type template. */
+export function defaultPostHeader() {
+    return {
+        layout: 'centered',
+        showFeaturedImage: true,
+        showExcerpt: true,
+        showAuthor: true,
+        showDate: true,
+        showCategory: true,
+        showReadingTime: false,
+    };
+}
+/**
+ * Normalize arbitrary JSON into a clean {@link PostHeaderConfig}, falling
+ * back to {@link defaultPostHeader} for any missing/invalid keys. Used when
+ * reading a `post-templates` document or accepting an agent payload.
+ */
+export function coercePostHeader(raw) {
+    const base = defaultPostHeader();
+    if (!raw || typeof raw !== 'object')
+        return base;
+    const r = raw;
+    const layout = r.layout === 'centered' || r.layout === 'left' || r.layout === 'overlay'
+        ? r.layout
+        : base.layout;
+    const bool = (key) => typeof r[key] === 'boolean' ? r[key] : base[key];
+    return {
+        layout,
+        showFeaturedImage: bool('showFeaturedImage'),
+        showExcerpt: bool('showExcerpt'),
+        showAuthor: bool('showAuthor'),
+        showDate: bool('showDate'),
+        showCategory: bool('showCategory'),
+        showReadingTime: bool('showReadingTime'),
+    };
+}
+/**
+ * Build a default template for a post type: a centered header plus an
+ * article body and a related-posts block — a usable starting point an
+ * author or AI agent can then alter.
+ */
+export function createPostTemplate(postType) {
+    return {
+        postType,
+        header: defaultPostHeader(),
+        sections: [createSection('article-body'), createSection('related-posts')],
+    };
+}
+/** Normalize a raw `post-templates` document's data into a {@link PostTemplate}. */
+export function coercePostTemplate(postType, raw) {
+    const data = raw && typeof raw === 'object' ? raw : {};
+    return {
+        postType,
+        header: coercePostHeader(data.header),
+        sections: coerceSections(data.sections),
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/sections/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/sections/helpers.ts"],"names":[],"mappings":"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"}

package/dist/sections/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Flat, section-based Page Editor model — shared across the admin editor,
+ * the REST API, and the MCP server.
+ *
+ * Exposed as the `@actuate-media/cms-core/page-sections` subpath (NOT the
+ * package root) to avoid colliding with the page-builder *tree* model,
+ * which already exports `SectionSettings` / `createSection` from the root.
+ */
+export { SECTION_TYPES, SECTION_TYPE_LIST, getSectionType, getSectionTypesForScope, sectionTypeLabel, isKnownSectionType, } from './registry.js';
+export { generateSectionId, createSection, buildSection, addSection, removeSection, duplicateSection, toggleSectionVisibility, setSectionVisibility, moveSection, reorderSections, updateSectionContent, updateSectionSettings, updateSectionMeta, coerceSections, defaultPostHeader, coercePostHeader, createPostTemplate, coercePostTemplate, } from './helpers.js';
+export { validateSectionContent } from './validate.js';
+export type { SectionTypeId, SectionScope, SectionFieldType, SectionFieldDef, SectionSettings, SectionTypeDef, PageSection, PostHeaderConfig, PostTemplate, SectionValidationIssue, SectionValidationResult, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/sections/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sections/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAEtD,YAAY,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,YAAY,CAAA"}

package/dist/sections/index.js

@@ -0,0 +1,12 @@
+/**
+ * Flat, section-based Page Editor model — shared across the admin editor,
+ * the REST API, and the MCP server.
+ *
+ * Exposed as the `@actuate-media/cms-core/page-sections` subpath (NOT the
+ * package root) to avoid colliding with the page-builder *tree* model,
+ * which already exports `SectionSettings` / `createSection` from the root.
+ */
+export { SECTION_TYPES, SECTION_TYPE_LIST, getSectionType, getSectionTypesForScope, sectionTypeLabel, isKnownSectionType, } from './registry.js';
+export { generateSectionId, createSection, buildSection, addSection, removeSection, duplicateSection, toggleSectionVisibility, setSectionVisibility, moveSection, reorderSections, updateSectionContent, updateSectionSettings, updateSectionMeta, coerceSections, defaultPostHeader, coercePostHeader, createPostTemplate, coercePostTemplate, } from './helpers.js';
+export { validateSectionContent } from './validate.js';
+//# sourceMappingURL=index.js.map

package/dist/sections/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sections/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,eAAe,CAAA;AAEtB,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA"}

package/dist/sections/registry.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Section-type registry — the single source of truth for the flat Page
+ * Editor model. The admin editor re-exports this; the REST API and MCP
+ * server read it for discovery + validation.
+ *
+ * Only types listed here can be added/created, so neither the Add Section
+ * gallery nor an AI agent can produce a section without a working renderer
+ * + inspector + schema ("no dead sections").
+ */
+import type { SectionScope, SectionTypeDef, SectionTypeId } from './types.js';
+export declare const SECTION_TYPES: Record<SectionTypeId, SectionTypeDef>;
+/** Ordered list for the Add Section gallery + discovery endpoints. */
+export declare const SECTION_TYPE_LIST: SectionTypeDef[];
+export declare function getSectionType(id: string): SectionTypeDef | undefined;
+/**
+ * Section types available in a given editor context, in registry order.
+ *
+ * The Page editor passes `'page'`, the Post editor + Post Template editor
+ * pass `'post'`, so each Add Section gallery shows only the types that make
+ * sense (and have a working renderer) for that surface.
+ */
+export declare function getSectionTypesForScope(scope: SectionScope): SectionTypeDef[];
+/** Human label for a section type id, with a graceful fallback. */
+export declare function sectionTypeLabel(id: string): string;
+/** True when `id` is a registered, renderable section type. */
+export declare function isKnownSectionType(id: string): id is SectionTypeId;
+//# sourceMappingURL=registry.d.ts.map

package/dist/sections/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/sections/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAmB,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAI9F,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,cAAc,CA0T/D,CAAA;AAED,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,EAAE,cAAc,EAW7C,CAAA;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAErE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,EAAE,CAE7E;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,aAAa,CAElE"}