@beechcms/core 0.8.1 → 0.9.1

package/dist/dashboard-layout/seed-layout.d.ts

@@ -33,36 +33,6 @@ export declare const kanbanCardConfigSchema: z.ZodObject<{
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type KanbanCardConfig = z.infer<typeof kanbanCardConfigSchema>;
-export declare const seedViewConfigSchema: z.ZodObject<{
-    kanban: z.ZodOptional<z.ZodObject<{
-        axisBranchId: z.ZodNullable<z.ZodString>;
-        sort: z.ZodNullable<z.ZodObject<{
-            branchId: z.ZodString;
-            dir: z.ZodEnum<{
-                ASC: "ASC";
-                DESC: "DESC";
-            }>;
-        }, z.core.$strip>>;
-        hiddenColumnValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        collapsedColumnValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-    card: z.ZodOptional<z.ZodObject<{
-        version: z.ZodLiteral<1>;
-        media: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-            branchId: z.ZodString;
-        }, z.core.$strip>>>;
-        header: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-            branchId: z.ZodString;
-        }, z.core.$strip>>>;
-        subtitle: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-            branchId: z.ZodString;
-        }, z.core.$strip>>>;
-        metadata: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            branchId: z.ZodString;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>;
-}, z.core.$loose>;
-export type SeedViewConfig = z.infer<typeof seedViewConfigSchema>;
 /** Reference to a Seed branch by its stable id (e.g. 'br_03').
  *  Aliases can be renamed — ids cannot. When the id does not match any
  *  branch on the Seed at read time, the field is silently stripped (auto-cleanup). */
@@ -108,6 +78,12 @@ export declare function isFullWidthBranch(branch: Branch): boolean;
 export declare function isSeoBranch(branch: Branch): boolean;
 export declare const METADATA_SLOT_CAP = 6;
 export declare function isCardEligibleBranch(branch: Branch): boolean;
+/** Gallery cover: a single-file branch that accepts images (a multi-file/asset-list branch has no single cover). */
+export declare function isImageMediaBranch(branch: Branch): boolean;
+export interface ValidateCardConfigOptions {
+    /** Gallery cards only render an image cover: a non-image `media` slot is dropped. */
+    mediaImageOnly?: boolean;
+}
 export type ValidateCardConfigResult = {
     ok: true;
     cleaned: KanbanCardConfig;
@@ -116,7 +92,9 @@ export type ValidateCardConfigResult = {
     errors: string[];
     cleaned: KanbanCardConfig;
 };
-export declare function validateCardConfigAgainstSeed(config: KanbanCardConfig, seed: Seed): ValidateCardConfigResult;
+export declare function validateCardConfigAgainstSeed(config: KanbanCardConfig, seed: Seed, options?: ValidateCardConfigOptions): ValidateCardConfigResult;
+/** Max serialized size of a form layout. Keeps the `seed_layouts` row far below D1's per-row limit. */
+export declare const MAX_LAYOUT_BYTES: number;
 export declare const layoutFieldSchema: z.ZodObject<{
     branchId: z.ZodString;
 }, z.core.$strip>;
@@ -176,6 +154,12 @@ export declare const formLayoutSchema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+/**
+ * Builds the default editor layout for a Seed with no custom `layout`: full-width branches
+ * (richtext, json, galleries) each get their own dedicated section, the remaining branches are
+ * packed three per section in seed order, and a single main non-gallery image file branch
+ * (`fileOptions.accept === 'image'`) leads the Data tab alone in its own full-width section.
+ */
 export declare function generateDefaultLayout(seed: Seed, opts?: {
     newId: () => string;
 }): FormLayout;
@@ -188,4 +172,11 @@ export type ValidateLayoutResult = {
     cleaned: FormLayout;
 };
 export declare function validateLayoutAgainstSeed(layout: FormLayout, seed: Seed): ValidateLayoutResult;
+/**
+ * Makes a stored layout safe to serve after the Seed changed. A layout that breaks the
+ * full-width rules falls back to the generated default; otherwise layoutable branches the
+ * layout never placed (added to the Seed later) are appended as trailing sections of the
+ * first tab, so the editor can always render and fill them.
+ */
+export declare function reconcileLayoutWithSeed(layout: FormLayout, seed: Seed): FormLayout;
 //# sourceMappingURL=seed-layout.d.ts.map

package/dist/dashboard-layout/seed-layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seed-layout.d.ts","sourceRoot":"","sources":["../../src/dashboard-layout/seed-layout.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAOtD,eAAO,MAAM,sBAAsB;;;;;;;;;;;iBAKjC,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAMrE,eAAO,MAAM,mBAAmB;;iBAE9B,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;iBAUjC,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAErE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGjB,CAAA;AAChB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAMjE;;sFAEsF;AACtF,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,WAAW,EAAE,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,4CAA4C;IAC5C,OAAO,EAAE,YAAY,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,aAAa,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,+DAA+D;IAC/D,OAAO,EAAE,CAAC,CAAA;IACV,IAAI,EAAE,SAAS,EAAE,CAAA;CAClB;AAMD,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,8CAAgD,CAAA;AAEpF,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED,gEAAgE;AAChE,eAAO,MAAM,wBAAwB,8CAA8B,CAAA;AAEnE,gFAAgF;AAChF,eAAO,MAAM,cAAc,aAEzB,CAAA;AAEF,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAK1D;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEnD;AAMD,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAIlC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAK5D;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,GACvC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAAA;AAE9D,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,IAAI,GACT,wBAAwB,CA6B1B;AAMD,eAAO,MAAM,iBAAiB;;iBAAgE,CAAA;AAC9F,eAAO,MAAM,kBAAkB;;;;;iBAG7B,CAAA;AACF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;iBAO9B,CAAA;AACF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;iBAI1B,CAAA;AACF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;iBAG3B,CAAA;AAiDF,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,MAAM,CAAA;CAAE,GAC7B,UAAU,CAmBZ;AAMD,MAAM,MAAM,oBAAoB,GAC5B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,GACjC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAA;AAExD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,IAAI,GACT,oBAAoB,CA0EtB"}
+{"version":3,"file":"seed-layout.d.ts","sourceRoot":"","sources":["../../src/dashboard-layout/seed-layout.ts"],"names":[],"mappings":"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"}

package/dist/dashboard-layout/seed-layout.js

@@ -1,9 +1,9 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) 2024–2026 Flavio De Musso
 import { z } from 'zod';
-import { findBranchById } from '../engine/seed-registry.js';
+import { findBranchById } from '../engine/seeds/seed-registry.js';
 // ---------------------------------------------------------------------------
-// View config — per-seed, per-view dashboard preferences (KB-S02)
+// Kanban view config — embedded in ContentViewConfig.kanban (seed_views)
 // ---------------------------------------------------------------------------
 export const kanbanViewConfigSchema = z.object({
     axisBranchId: z.string().nullable(),
@@ -12,7 +12,7 @@ export const kanbanViewConfigSchema = z.object({
     collapsedColumnValues: z.array(z.string()).optional(),
 });
 // ---------------------------------------------------------------------------
-// Kanban card layout (view_config.card)
+// Kanban card layout — embedded in ContentViewConfig.card (seed_views)
 // ---------------------------------------------------------------------------
 export const cardSlotFieldSchema = z.object({
     branchId: z.string().regex(/^br_[A-Za-z0-9]+$/),
@@ -28,10 +28,6 @@ export const kanbanCardConfigSchema = z.object({
     /** 2-column grid. Hard cap enforced by validator (see METADATA_SLOT_CAP). */
     metadata: z.array(cardSlotFieldSchema).max(6).default([]),
 });
-export const seedViewConfigSchema = z.object({
-    kanban: kanbanViewConfigSchema.optional(),
-    card: kanbanCardConfigSchema.optional(),
-}).passthrough();
 // ---------------------------------------------------------------------------
 // Branch-type rules used by both the default generator and the validator.
 // ---------------------------------------------------------------------------
@@ -42,6 +38,12 @@ export function isGalleryBranch(branch) {
     return branch.type === 'file'
         && (branch.multiple === true || branch.format === 'asset-list');
 }
+/** True for a single-file image branch: the candidate cover of the default editor layout. */
+function isCoverImageBranch(branch) {
+    return branch.type === 'file'
+        && !isGalleryBranch(branch)
+        && branch.fileOptions?.accept === 'image';
+}
 /** Branch types currently unsupported in the Layout Builder. */
 export const UNSUPPORTED_BRANCH_TYPES = new Set([]);
 /** Aliases that are NEVER included in the editor form (handled by other UI). */
@@ -80,7 +82,14 @@ export function isCardEligibleBranch(branch) {
         return false;
     return true;
 }
-export function validateCardConfigAgainstSeed(config, seed) {
+/** Gallery cover: a single-file branch that accepts images (a multi-file/asset-list branch has no single cover). */
+export function isImageMediaBranch(branch) {
+    return isCardEligibleBranch(branch)
+        && branch.type === 'file'
+        && !isGalleryBranch(branch)
+        && branch.fileOptions?.accept === 'image';
+}
+export function validateCardConfigAgainstSeed(config, seed, options = {}) {
     const errors = [];
     const seen = new Set();
     const keepSingle = (f) => {
@@ -96,7 +105,9 @@ export function validateCardConfigAgainstSeed(config, seed) {
         seen.add(f.branchId);
         return { branchId: f.branchId };
     };
-    const media = keepSingle(config.media);
+    const mediaBranch = config.media ? findBranchById(seed, config.media.branchId) : null;
+    const mediaAllowed = !options.mediaImageOnly || (mediaBranch !== null && isImageMediaBranch(mediaBranch));
+    const media = mediaAllowed ? keepSingle(config.media) : null;
     const header = keepSingle(config.header);
     const subtitle = keepSingle(config.subtitle);
     const metadata = [];
@@ -121,27 +132,37 @@ export function validateCardConfigAgainstSeed(config, seed) {
 // ---------------------------------------------------------------------------
 // Zod schema for shape validation
 // ---------------------------------------------------------------------------
+/** Max serialized size of a form layout. Keeps the `seed_layouts` row far below D1's per-row limit. */
+export const MAX_LAYOUT_BYTES = 256 * 1024;
+const LAYOUT_ID_MAX = 64;
+const LAYOUT_LABEL_MAX = 120;
+const MAX_SECTIONS_PER_TAB = 50;
+const MAX_FIELDS_PER_COLUMN = 100;
 export const layoutFieldSchema = z.object({ branchId: z.string().regex(/^br_[A-Za-z0-9]+$/) });
 export const layoutColumnSchema = z.object({
-    id: z.string().min(1),
-    fields: z.array(layoutFieldSchema),
+    id: z.string().min(1).max(LAYOUT_ID_MAX),
+    fields: z.array(layoutFieldSchema).max(MAX_FIELDS_PER_COLUMN),
 });
 export const layoutSectionSchema = z.object({
-    id: z.string().min(1),
-    label: z.string().optional(),
+    id: z.string().min(1).max(LAYOUT_ID_MAX),
+    label: z.string().max(LAYOUT_LABEL_MAX).optional(),
     hideLabel: z.boolean().optional(),
     hideBorder: z.boolean().optional(),
     collapsible: z.boolean().optional(),
     columns: z.array(layoutColumnSchema).min(1).max(4),
 });
 export const layoutTabSchema = z.object({
-    id: z.string().min(1),
+    id: z.string().min(1).max(LAYOUT_ID_MAX),
     label: z.string().min(1).max(60),
-    sections: z.array(layoutSectionSchema).min(1),
+    sections: z.array(layoutSectionSchema).min(1).max(MAX_SECTIONS_PER_TAB),
 });
-export const formLayoutSchema = z.object({
+export const formLayoutSchema = z
+    .object({
     version: z.literal(1),
     tabs: z.array(layoutTabSchema).min(1).max(8),
+})
+    .refine((layout) => new TextEncoder().encode(JSON.stringify(layout)).length <= MAX_LAYOUT_BYTES, {
+    message: `Layout exceeds the ${MAX_LAYOUT_BYTES / 1024} KB size limit.`,
 });
 // ---------------------------------------------------------------------------
 // Default layout generator
@@ -180,15 +201,40 @@ function buildSectionsForBranches(branches, newId) {
     }
     return sections;
 }
+/**
+ * Builds the default editor layout for a Seed with no custom `layout`: full-width branches
+ * (richtext, json, galleries) each get their own dedicated section, the remaining branches are
+ * packed three per section in seed order, and a single main non-gallery image file branch
+ * (`fileOptions.accept === 'image'`) leads the Data tab alone in its own full-width section.
+ */
 export function generateDefaultLayout(seed, opts) {
     const newId = opts?.newId ?? defaultIdFactory;
     const layoutable = seed.branches.filter(isLayoutableBranch);
     const seo = layoutable.filter(isSeoBranch);
     const main = layoutable.filter((b) => !isSeoBranch(b));
+    const coverCandidates = main.filter(isCoverImageBranch);
+    const cover = coverCandidates.length === 1 ? coverCandidates[0] : null;
+    const dataTabId = newId();
+    let dataSections;
+    if (cover) {
+        const coverSection = {
+            id: newId(),
+            label: cover.label,
+            hideLabel: true,
+            columns: [{ id: newId(), fields: [{ branchId: cover.id }] }],
+        };
+        const rest = main.filter((b) => b.id !== cover.id);
+        dataSections = rest.length === 0
+            ? [coverSection]
+            : [coverSection, ...buildSectionsForBranches(rest, newId)];
+    }
+    else {
+        dataSections = buildSectionsForBranches(main, newId);
+    }
     const dataTab = {
-        id: newId(),
+        id: dataTabId,
         label: 'Data',
-        sections: buildSectionsForBranches(main, newId),
+        sections: dataSections,
     };
     const seoTab = {
         id: newId(),
@@ -267,3 +313,32 @@ export function validateLayoutAgainstSeed(layout, seed) {
         return { ok: false, errors, cleaned };
     return { ok: true, cleaned };
 }
+/**
+ * Makes a stored layout safe to serve after the Seed changed. A layout that breaks the
+ * full-width rules falls back to the generated default; otherwise layoutable branches the
+ * layout never placed (added to the Seed later) are appended as trailing sections of the
+ * first tab, so the editor can always render and fill them.
+ */
+export function reconcileLayoutWithSeed(layout, seed) {
+    const result = validateLayoutAgainstSeed(layout, seed);
+    if (!result.ok)
+        return generateDefaultLayout(seed);
+    const placed = new Set();
+    for (const tab of result.cleaned.tabs) {
+        for (const section of tab.sections) {
+            for (const column of section.columns) {
+                for (const field of column.fields)
+                    placed.add(field.branchId);
+            }
+        }
+    }
+    const unplaced = seed.branches.filter((b) => isLayoutableBranch(b) && !placed.has(b.id));
+    if (unplaced.length === 0)
+        return result.cleaned;
+    const [firstTab, ...otherTabs] = result.cleaned.tabs;
+    const extended = {
+        ...firstTab,
+        sections: [...firstTab.sections, ...buildSectionsForBranches(unplaced, defaultIdFactory)],
+    };
+    return { ...result.cleaned, tabs: [extended, ...otherTabs] };
+}

package/dist/dashboard-layout/seed-layout.repository.d.ts

@@ -1,4 +1,4 @@
-import type { FormLayout, SeedViewConfig } from './seed-layout.js';
+import type { FormLayout } from './seed-layout.js';
 export interface SeedLayoutRecord {
     slug: string;
     layout: FormLayout;
@@ -14,9 +14,5 @@ export interface ISeedLayoutRepository {
     upsert(slug: string, layout: FormLayout, updatedBy: string): Promise<void>;
     /** Remove the stored row — used by the "Reset" action. */
     remove(slug: string): Promise<void>;
-    /** Return the per-view config blob for a seed, or null if none was stored. */
-    getViewConfig(slug: string): Promise<SeedViewConfig | null>;
-    /** Upsert the per-view config for a seed. */
-    setViewConfig(slug: string, config: SeedViewConfig, updatedBy: string): Promise<void>;
 }
 //# sourceMappingURL=seed-layout.repository.d.ts.map

package/dist/dashboard-layout/seed-layout.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seed-layout.repository.d.ts","sourceRoot":"","sources":["../../src/dashboard-layout/seed-layout.repository.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAElE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,UAAU,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IACnD,oFAAoF;IACpF,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;IAC/C,mDAAmD;IACnD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1E,0DAA0D;IAC1D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnC,8EAA8E;IAC9E,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IAC3D,6CAA6C;IAC7C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACtF"}
+{"version":3,"file":"seed-layout.repository.d.ts","sourceRoot":"","sources":["../../src/dashboard-layout/seed-layout.repository.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,UAAU,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IACnD,oFAAoF;IACpF,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;IAC/C,mDAAmD;IACnD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1E,0DAA0D;IAC1D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACpC"}

package/dist/engine/ddl/ddl.d.ts

@@ -15,6 +15,13 @@ export declare const SYSTEM_COLUMNS: Set<string>;
  * @returns The table name.
  */
 export declare function tableName(seed: Seed): string;
+/**
+ * Returns the draft SQL table name for a given Seed.
+ *
+ * @param seed The seed definition.
+ * @returns The draft table name.
+ */
+export declare function draftTableName(seed: Seed): string;
 /**
  * Returns the FTS (Full-Text Search) virtual table name for a given Seed.
  *
@@ -184,6 +191,17 @@ export declare function generateDropTable(seed: Seed): string[];
  * @returns An array of SQL statements.
  */
 export declare function generateDropColumn(seed: Seed, alias: string): string[];
+/**
+ * Returns the SQL statements that drop an orphan column: one left in the physical table after its
+ * branch was removed from the definition. Removes the conventional filter indexes first, since
+ * SQLite refuses to drop an indexed column.
+ *
+ * @param seed The seed definition (the column must not belong to it).
+ * @param column The orphan column name.
+ * @param inDraftTable Whether the draft table also holds the column.
+ * @returns An array of SQL statements.
+ */
+export declare function generateDropOrphanColumn(seed: Seed, column: string, inDraftTable: boolean): string[];
 /**
  * Returns the `RENAME COLUMN` SQL statements for renaming a field's alias.
  * For a multi-relation branch, renames the junction table (+ drafts junction table) instead.
@@ -203,6 +221,19 @@ export declare function generateRenameColumn(seed: Seed, from: string, to: strin
  * @returns An array of SQL statements.
  */
 export declare function generateRetypeColumn(seed: Seed, branch: Branch): string[];
+/**
+ * Returns `SELECT COUNT(*)` statements counting rows whose current value would be silently altered
+ * (zeroed or truncated) by the `CAST` in {@link generateRetypeColumn}. Empty when the target type
+ * is lossless for any input (`TEXT`).
+ *
+ * A text value is convertible only if it is a complete JSON number; `CAST` alone accepts trailing garbage.
+ *
+ * @param seed The seed definition.
+ * @param branch The target branch definition (carrying the new type).
+ * @throws {Error} If called on a multi-relation branch.
+ * @returns An array of SQL statements, each yielding a single `count` column.
+ */
+export declare function generateRetypeIncompatibleCount(seed: Seed, branch: Branch): string[];
 /**
  * Additive statements that turn soft delete on for a table that already exists.
  *

package/dist/engine/ddl/ddl.d.ts.map

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

package/dist/engine/ddl/ddl.js

@@ -41,7 +41,7 @@ export function tableName(seed) {
  * @param seed The seed definition.
  * @returns The draft table name.
  */
-function draftTableName(seed) {
+export function draftTableName(seed) {
     return `content_${seed.slug}_drafts`;
 }
 /**
@@ -221,6 +221,37 @@ export function generateAddColumn(seed, branch) {
 export function generateAddDraftSnapshotColumn(seed) {
     return `ALTER TABLE content_${seed.slug}_drafts ADD COLUMN live_snapshot_at INTEGER;`;
 }
+/**
+ * Lists the indexes a branch column carries (value index + blind index), as name/column pairs.
+ * Single source for both index creation and column teardown.
+ */
+function branchIndexes(seed, branch) {
+    if (branch.type === 'relation' && branch.multiple === true)
+        return [];
+    const isRelation = branch.type === 'relation';
+    if (!isRelation && !resolvePolicies(branch).filter)
+        return [];
+    const indexes = [];
+    if (['text', 'number', 'date', 'boolean', 'relation'].includes(branch.type)) {
+        indexes.push({ name: `idx_${seed.slug}_${branch.alias}`, column: branch.alias });
+    }
+    if (hasBlindIndex(branch)) {
+        indexes.push({ name: `idx_${seed.slug}_${branch.alias}_bidx`, column: `${branch.alias}_bidx` });
+    }
+    return indexes;
+}
+/**
+ * Statements that detach a column from everything SQLite refuses to drop it from:
+ * its indexes and, for searchable branches, the FTS table + triggers (rebuilt by `planFtsRebuild`).
+ */
+function generateColumnTeardown(seed, branch) {
+    const slug = seed.slug;
+    const stmts = branchIndexes(seed, branch).map(i => `DROP INDEX IF EXISTS ${i.name};`);
+    if (indexableSearchBranches(seed).some(b => b.alias === branch.alias)) {
+        stmts.push(`DROP TRIGGER IF EXISTS fts_${slug}_insert;`, `DROP TRIGGER IF EXISTS fts_${slug}_update;`, `DROP TRIGGER IF EXISTS fts_${slug}_delete;`, `DROP TABLE IF EXISTS ${ftsTableName(seed)};`);
+    }
+    return stmts;
+}
 /**
  * Generates SQL index statements for system fields (status, created_at)
  * and indexable branch columns.
@@ -236,16 +267,8 @@ export function generateIndexes(seed) {
         `CREATE INDEX IF NOT EXISTS idx_${slug}_created_at ON ${table}(created_at);`,
     ];
     for (const branch of seed.branches) {
-        if (branch.type === 'relation' && branch.multiple === true)
-            continue;
-        const isRelation = branch.type === 'relation';
-        if (!isRelation && !resolvePolicies(branch).filter)
-            continue;
-        if (['text', 'number', 'date', 'boolean', 'relation'].includes(branch.type)) {
-            indexes.push(`CREATE INDEX IF NOT EXISTS idx_${slug}_${branch.alias} ON ${table}(${branch.alias});`);
-        }
-        if (hasBlindIndex(branch)) {
-            indexes.push(`CREATE INDEX IF NOT EXISTS idx_${slug}_${branch.alias}_bidx ON ${table}(${branch.alias}_bidx);`);
+        for (const { name, column } of branchIndexes(seed, branch)) {
+            indexes.push(`CREATE INDEX IF NOT EXISTS ${name} ON ${table}(${column});`);
         }
     }
     if (seed.softDelete) {
@@ -494,12 +517,33 @@ export function generateDropColumn(seed, alias) {
             `DROP TABLE IF EXISTS ${jt};`,
         ];
     }
-    const stmts = [`ALTER TABLE ${tableName(seed)} DROP COLUMN ${alias};`];
+    const stmts = branch ? generateColumnTeardown(seed, branch) : [];
+    stmts.push(`ALTER TABLE ${tableName(seed)} DROP COLUMN ${alias};`);
     if (branch && seed.allowDrafts) {
         stmts.push(`ALTER TABLE ${draftTableName(seed)} DROP COLUMN ${alias};`);
     }
     return stmts;
 }
+/**
+ * Returns the SQL statements that drop an orphan column: one left in the physical table after its
+ * branch was removed from the definition. Removes the conventional filter indexes first, since
+ * SQLite refuses to drop an indexed column.
+ *
+ * @param seed The seed definition (the column must not belong to it).
+ * @param column The orphan column name.
+ * @param inDraftTable Whether the draft table also holds the column.
+ * @returns An array of SQL statements.
+ */
+export function generateDropOrphanColumn(seed, column, inDraftTable) {
+    const stmts = [
+        `DROP INDEX IF EXISTS idx_${seed.slug}_${column};`,
+        `DROP INDEX IF EXISTS idx_${seed.slug}_${column}_bidx;`,
+        `ALTER TABLE ${tableName(seed)} DROP COLUMN ${column};`,
+    ];
+    if (inDraftTable)
+        stmts.push(`ALTER TABLE ${draftTableName(seed)} DROP COLUMN ${column};`);
+    return stmts;
+}
 /**
  * Returns the `RENAME COLUMN` SQL statements for renaming a field's alias.
  * For a multi-relation branch, renames the junction table (+ drafts junction table) instead.
@@ -547,9 +591,44 @@ export function generateRetypeColumn(seed, branch) {
         `ALTER TABLE ${table} DROP COLUMN ${alias};`,
         `ALTER TABLE ${table} RENAME COLUMN ${tmp} TO ${alias};`,
     ];
-    const stmts = rebuild(tableName(seed));
+    const current = seed.branches.find(b => b.alias === alias);
+    const stmts = current ? generateColumnTeardown(seed, current) : [];
+    stmts.push(...rebuild(tableName(seed)));
     if (seed.allowDrafts)
         stmts.push(...rebuild(draftTableName(seed)));
+    for (const { name, column } of branchIndexes(seed, branch)) {
+        stmts.push(`CREATE INDEX IF NOT EXISTS ${name} ON ${tableName(seed)}(${column});`);
+    }
+    return stmts;
+}
+/**
+ * Returns `SELECT COUNT(*)` statements counting rows whose current value would be silently altered
+ * (zeroed or truncated) by the `CAST` in {@link generateRetypeColumn}. Empty when the target type
+ * is lossless for any input (`TEXT`).
+ *
+ * A text value is convertible only if it is a complete JSON number; `CAST` alone accepts trailing garbage.
+ *
+ * @param seed The seed definition.
+ * @param branch The target branch definition (carrying the new type).
+ * @throws {Error} If called on a multi-relation branch.
+ * @returns An array of SQL statements, each yielding a single `count` column.
+ */
+export function generateRetypeIncompatibleCount(seed, branch) {
+    if (branch.type === 'relation' && branch.multiple === true) {
+        throw new Error(`Branch "${branch.alias}" is a multi-relation and has no column to retype`);
+    }
+    const { sqlType } = BRANCH_TYPE_SQL[branch.type];
+    if (sqlType === 'TEXT')
+        return [];
+    const col = branch.alias;
+    const jsonNumber = (types) => `(typeof(${col}) = 'text' AND CASE WHEN json_valid(${col}) THEN json_type(${col}) IN (${types}) ELSE 0 END)`;
+    const convertible = sqlType === 'REAL'
+        ? `typeof(${col}) IN ('integer', 'real') OR ${jsonNumber("'integer', 'real'")}`
+        : `typeof(${col}) = 'integer' OR (typeof(${col}) = 'real' AND ${col} = CAST(${col} AS INTEGER)) OR ${jsonNumber("'integer'")}`;
+    const count = (table) => `SELECT COUNT(*) AS count FROM ${table} WHERE ${col} IS NOT NULL AND NOT (${convertible});`;
+    const stmts = [count(tableName(seed))];
+    if (seed.allowDrafts)
+        stmts.push(count(draftTableName(seed)));
     return stmts;
 }
 /**

package/dist/engine/ddl/schema-mutator.d.ts

@@ -18,6 +18,9 @@ export interface ISchemaMutator {
      *  type-change column rebuild, full type drop). The caller assembles the
      *  statements; the impl validates identifiers and runs them as one D1 batch. */
     execDestructive(statements: string[]): Promise<void>;
+    /** Runs read-only `SELECT COUNT(*) AS count` statements as one batch and returns the summed count.
+     *  Used to pre-check data compatibility before a lossy destructive operation. */
+    sumCounts(statements: string[]): Promise<number>;
     /** Reads all rows from a table for the specified columns only.
      *  Used before DROP TABLE to collect R2 keys for media cleanup.
      *  All identifiers are validated against `^[A-Za-z0-9_]+$`. */

package/dist/engine/ddl/schema-mutator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-mutator.d.ts","sourceRoot":"","sources":["../../../src/engine/ddl/schema-mutator.ts"],"names":[],"mappings":"AAGA;;yFAEyF;AACzF,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAA;IACtD;;8EAE0E;IAC1E,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAS5C,sCAAsC;IACtC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvC,kDAAkD;IAClD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxD,0DAA0D;IAC1D,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpE;;oFAEgF;IAChF,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEpD;;mEAE+D;IAC/D,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;CAChF"}
+{"version":3,"file":"schema-mutator.d.ts","sourceRoot":"","sources":["../../../src/engine/ddl/schema-mutator.ts"],"names":[],"mappings":"AAGA;;yFAEyF;AACzF,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAA;IACtD;;8EAE0E;IAC1E,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAS5C,sCAAsC;IACtC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvC,kDAAkD;IAClD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxD,0DAA0D;IAC1D,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpE;;oFAEgF;IAChF,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEpD;qFACiF;IACjF,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAEhD;;mEAE+D;IAC/D,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;CAChF"}

package/dist/engine/ddl/seed-purge-guards.d.ts

@@ -0,0 +1,7 @@
+import type { Seed } from '../types.js';
+/** Blocks writes from requests that loaded a seed immediately before its purge began. */
+export declare function generateSeedPurgeGuards(seed: Seed): {
+    create: string[];
+    drop: string[];
+};
+//# sourceMappingURL=seed-purge-guards.d.ts.map

package/dist/engine/ddl/seed-purge-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-purge-guards.d.ts","sourceRoot":"","sources":["../../../src/engine/ddl/seed-purge-guards.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAEvC,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAcxF"}

package/dist/engine/ddl/seed-purge-guards.js

@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2024–2026 Flavio De Musso
+/** Blocks writes from requests that loaded a seed immediately before its purge began. */
+export function generateSeedPurgeGuards(seed) {
+    if (!/^[a-z0-9_]+$/.test(seed.slug))
+        throw new Error(`Unsafe seed slug: ${seed.slug}`);
+    const tables = [`content_${seed.slug}`, ...(seed.allowDrafts ? [`content_${seed.slug}_drafts`] : [])];
+    const operations = ['INSERT', 'UPDATE', 'DELETE'];
+    const create = [];
+    const drop = [];
+    for (const table of tables) {
+        for (const operation of operations) {
+            const name = `purge_guard_${table}_${operation.toLowerCase()}`;
+            create.push(`CREATE TRIGGER ${name} BEFORE ${operation} ON ${table} BEGIN SELECT RAISE(ABORT, 'seed_purge_in_progress'); END;`);
+            drop.push(`DROP TRIGGER IF EXISTS ${name};`);
+        }
+    }
+    return { create, drop };
+}

package/dist/engine/engine.d.ts

@@ -1,4 +1,5 @@
-export * from './ddl.js';
-export * from './query.js';
-export * from './serialize.js';
+export * from './ddl/ddl.js';
+export * from './query/query.js';
+export * from './query/serialize.js';
+export * from './query/active-clause.js';
 //# sourceMappingURL=engine.d.ts.map

package/dist/engine/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/engine/engine.ts"],"names":[],"mappings":"AACA,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/engine/engine.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,0BAA0B,CAAA"}

package/dist/engine/engine.js

@@ -1,4 +1,5 @@
 // SPDX-License-Identifier: MIT
-export * from './ddl.js';
-export * from './query.js';
-export * from './serialize.js';
+export * from './ddl/ddl.js';
+export * from './query/query.js';
+export * from './query/serialize.js';
+export * from './query/active-clause.js';

package/dist/engine/introspection/relation-audit.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @module engine/relation-audit
+ * Finds relation branches whose physical storage no longer matches the deployed definition.
+ *
+ * Releases before the additive relation gate could persist a changed `multiple`, `targetSeed` or
+ * `onDelete` without migrating the FK column, the `rel_<slug>_<alias>` junction table or the FK
+ * policy. The gate prevents new mismatches; this audit identifies databases that already have one.
+ *
+ * Read-only by contract: only `PRAGMA` and `SELECT COUNT(*)` statements are issued, through the
+ * injected executor. Nothing is repaired and no row is ever touched.
+ */
+import type { Seed } from '../types.js';
+import { type SchemaQueryExecutor } from './introspection.js';
+/** What is wrong with the storage of one relation branch. */
+export type RelationStorageIssue = 
+/** Definition says single (or multiple) but the data lives in the other shape. */
+'wrong_storage'
+/** Neither the FK column nor the junction table exists. */
+ | 'missing_storage'
+/** The FK points at a different table than `targetSeed`. */
+ | 'fk_target_mismatch'
+/** The FK `ON DELETE` rule differs from the effective `onDelete`. */
+ | 'fk_on_delete_mismatch';
+export interface RelationStorageFinding {
+    seed: string;
+    alias: string;
+    issue: RelationStorageIssue;
+    /** What the deployed definition requires, e.g. `junction rel_posts_tags`. */
+    expected: string;
+    /** What the database holds. */
+    actual: string;
+    /**
+     * Rows or values sitting in storage the definition no longer points at. Always 0 for
+     * `missing_storage` and the FK findings: those carry no stranded values by themselves.
+     */
+    strandedRows: number;
+}
+/**
+ * Compares every relation branch of the given (active) seeds against the physical tables.
+ *
+ * Seeds whose `content_<slug>` table is missing are skipped: that is plain schema drift and is
+ * reported by the schema diff, not a relation-storage mismatch. Findings are ordered by seed, then
+ * branch order, so the report is deterministic.
+ */
+export declare function auditRelationStorage(executor: SchemaQueryExecutor, seeds: Seed[]): Promise<RelationStorageFinding[]>;
+//# sourceMappingURL=relation-audit.d.ts.map