@prenta/core 0.118.0

package/dist/sections/migrate.d.ts

@@ -0,0 +1,42 @@
+/**
+ * One-off data migration: backfill canonical `data.sections` for LEGACY
+ * page-builder documents (ADR 0002).
+ *
+ * Pages authored in the visual page builder before compile-on-save shipped have
+ * a `data._layout` tree but no flat `data.sections`. The `/resolve` read-time
+ * bridge keeps them rendering, but every OTHER reader (SDK list/get, MCP,
+ * search index, content graph) only sees `sections`, so those docs look empty.
+ *
+ * This walks every non-deleted document, and for each one that has a `_layout`
+ * but no non-empty `sections`, compiles the tree with {@link layoutTreeToSections}
+ * and persists the result through {@link updateDocument} (so the write is
+ * versioned + audited like any other edit). It is **idempotent**: a document
+ * that already has `sections` is skipped, so re-running is safe.
+ *
+ * DB-paged so it scales past the in-memory document count.
+ */
+import type { ActionContext } from '../actions.js';
+export interface MigratePageBuilderSectionsOptions {
+    /** Report what would change without writing. Defaults to `false`. */
+    dryRun?: boolean;
+    /** Page size for the DB scan. Defaults to 100. */
+    batchSize?: number;
+}
+export interface MigratePageBuilderSectionsResult {
+    /** Documents inspected. */
+    scanned: number;
+    /** Documents that received freshly-compiled sections. */
+    migrated: number;
+    /** Documents skipped (no `_layout`, already had sections, or empty layout). */
+    skipped: number;
+    /** IDs of the migrated documents (useful for logs / verification). */
+    migratedIds: string[];
+}
+/**
+ * Backfill `data.sections` for legacy `_layout`-only documents.
+ *
+ * @param ctx  An admin {@link ActionContext} (role must be allowed to update the
+ *   target collections — use a system/admin user).
+ */
+export declare function migratePageBuilderSections(ctx: ActionContext, options?: MigratePageBuilderSectionsOptions): Promise<MigratePageBuilderSectionsResult>;
+//# sourceMappingURL=migrate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/sections/migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAIlD,MAAM,WAAW,iCAAiC;IAChD,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,gCAAgC;IAC/C,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAA;IAChB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAA;IACf,sEAAsE;IACtE,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB;AAWD;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,aAAa,EAClB,OAAO,GAAE,iCAAsC,GAC9C,OAAO,CAAC,gCAAgC,CAAC,CAwD3C"}

package/dist/sections/migrate.js

@@ -0,0 +1,66 @@
+import { updateDocument } from '../actions.js';
+import { layoutTreeToSections } from './bridge.js';
+function isPlainObject(v) {
+    return !!v && typeof v === 'object' && !Array.isArray(v);
+}
+/** A document already has authoritative sections when the array is non-empty. */
+function hasStoredSections(data) {
+    return Array.isArray(data.sections) && data.sections.length > 0;
+}
+/**
+ * Backfill `data.sections` for legacy `_layout`-only documents.
+ *
+ * @param ctx  An admin {@link ActionContext} (role must be allowed to update the
+ *   target collections — use a system/admin user).
+ */
+export async function migratePageBuilderSections(ctx, options = {}) {
+    const dryRun = options.dryRun ?? false;
+    const batchSize = options.batchSize && options.batchSize > 0 ? options.batchSize : 100;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Prisma client is intentionally untyped at the core/config boundary (see ActionContext).
+    const db = ctx.db;
+    const result = {
+        scanned: 0,
+        migrated: 0,
+        skipped: 0,
+        migratedIds: [],
+    };
+    let cursor;
+    // Keyset pagination on the primary key keeps memory flat and is stable even
+    // as we mutate rows mid-scan (we only ever move forward past `cursor`).
+    for (;;) {
+        const batch = await db.document.findMany({
+            where: { deletedAt: null },
+            orderBy: { id: 'asc' },
+            take: batchSize,
+            ...(cursor ? { skip: 1, cursor: { id: cursor } } : {}),
+            select: { id: true, collection: true, data: true },
+        });
+        if (batch.length === 0)
+            break;
+        cursor = batch[batch.length - 1].id;
+        for (const doc of batch) {
+            result.scanned++;
+            const data = isPlainObject(doc.data) ? doc.data : null;
+            if (!data || !isPlainObject(data._layout) || hasStoredSections(data)) {
+                result.skipped++;
+                continue;
+            }
+            const sections = layoutTreeToSections(data._layout);
+            if (sections.length === 0) {
+                // A layout that compiles to nothing (empty/unmappable) — leave it for the
+                // read-time bridge rather than persisting an empty array.
+                result.skipped++;
+                continue;
+            }
+            if (!dryRun) {
+                await updateDocument(doc.collection, doc.id, { sections }, ctx);
+            }
+            result.migrated++;
+            result.migratedIds.push(doc.id);
+        }
+        if (batch.length < batchSize)
+            break;
+    }
+    return result;
+}
+//# sourceMappingURL=migrate.js.map

package/dist/sections/migrate.js.map

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

package/dist/sections/registry.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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 { CustomSectionTypeInput, SectionScope, SectionsConfig, 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[];
+/**
+ * Register (or replace) config-declared custom section types, application-wide.
+ * Built-in types always win on an id collision, so a custom type can never
+ * shadow a core type. Invalid entries (missing/blank id) are skipped.
+ */
+export declare function registerSectionTypes(inputs: CustomSectionTypeInput[] | undefined): void;
+/** Remove all registered custom types. Called before re-registering at boot. */
+export declare function resetCustomSectionTypes(): void;
+/**
+ * Resolve the effective custom section types from `config.sections`, honoring
+ * the canonical `sections.types` key and falling back to the deprecated
+ * `sections.customTypes` alias. `types` wins outright when present so the
+ * precedence is predictable. Both server boot (handler-factory) and admin boot
+ * (AdminRoot) call this so the two surfaces never diverge.
+ */
+export declare function resolveCustomSectionTypes(sections: SectionsConfig | undefined): CustomSectionTypeInput[] | undefined;
+/** All known section types (built-ins first, then customs in registration order). */
+export declare function getAllSectionTypes(): 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. Config-declared custom
+ * types that include the scope are included.
+ */
+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 (built-in or custom). */
+export declare function isKnownSectionType(id: string): boolean;
+//# 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,EACV,sBAAsB,EACtB,YAAY,EAEZ,cAAc,EACd,cAAc,EACd,aAAa,EACd,MAAM,YAAY,CAAA;AAInB,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,cAAc,CA+e/D,CAAA;AAED,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,EAAE,cAAc,EAc7C,CAAA;AAmCD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,sBAAsB,EAAE,GAAG,SAAS,GAAG,IAAI,CAOvF;AAED,gFAAgF;AAChF,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,cAAc,GAAG,SAAS,GACnC,sBAAsB,EAAE,GAAG,SAAS,CAGtC;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,IAAI,cAAc,EAAE,CAErD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAErE;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,EAAE,CAE7E;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEtD"}