@beechcms/core 0.8.1 → 0.9.1

package/dist/dashboard-layout.js

@@ -1,186 +0,0 @@
-// SPDX-License-Identifier: MIT
-// Copyright (c) 2024–2026 Flavio De Musso
-import { z } from 'zod';
-// ---------------------------------------------------------------------------
-// Shared rules used by both the Zod schemas and the semantic validator.
-// ---------------------------------------------------------------------------
-/** Namespaced widget type — lowercase npm-name-compatible.
- *  Built-ins use the 'core/' prefix; custom widgets '@scope/name'. */
-export const WIDGET_TYPE_REGEX = /^[a-z0-9@][a-z0-9@/_-]*$/;
-/** Max serialized size of a single widget `config`
- *  (`JSON.stringify(widget.config).length`) — guards D1 row bloat. */
-export const MAX_WIDGET_CONFIG_BYTES = 8192;
-// ---------------------------------------------------------------------------
-// Zod schemas for shape validation
-// ---------------------------------------------------------------------------
-export const dashboardWidgetInstanceSchema = z.object({
-    id: z.string().min(1),
-    type: z.string().regex(WIDGET_TYPE_REGEX),
-    title: z.string().max(80).optional(),
-    config: z.record(z.string(), z.unknown()),
-});
-export const dashboardColumnSchema = z.object({
-    id: z.string().min(1),
-    widgets: z.array(dashboardWidgetInstanceSchema),
-});
-export const dashboardSectionSchema = z.object({
-    id: z.string().min(1),
-    label: z.string().max(60).optional(),
-    hideLabel: z.boolean().optional(),
-    collapsible: z.boolean().optional(),
-    columns: z.array(dashboardColumnSchema).min(1).max(4),
-    columnSpans: z.array(z.number().int().min(1).max(12)).optional(),
-});
-export const dashboardPageSchema = z.object({
-    id: z.string().min(1),
-    slug: z.string().regex(/^[a-z0-9][a-z0-9-]*$/).max(40),
-    label: z.string().min(1).max(60),
-    icon: z.string().max(40).optional(),
-    sections: z.array(dashboardSectionSchema).min(1),
-});
-export const dashboardLayoutSchema = z.object({
-    version: z.literal(1),
-    pages: z.array(dashboardPageSchema).min(1).max(8),
-});
-// ---------------------------------------------------------------------------
-// Default dashboard layout generator
-// ---------------------------------------------------------------------------
-const defaultIdFactory = () => crypto.randomUUID();
-/** Structural port of the legacy hardcoded dashboard config into a single
- *  'Overview' page. Widgets fetch their own data: configs carry only the
- *  variant and (where relevant) the default seed binding. */
-export function generateDefaultDashboardLayout(seeds, opts) {
-    const newId = opts?.newId ?? defaultIdFactory;
-    const widget = (type, config) => ({ id: newId(), type, config });
-    const singleWidgetColumn = (w) => ({
-        id: newId(),
-        widgets: [w],
-    });
-    const sections = [];
-    // Setup checklist, full width.
-    sections.push({
-        id: newId(),
-        hideLabel: true,
-        columns: [singleWidgetColumn(widget('core/setup-checklist', { variant: 'full' }))],
-    });
-    // Status row: equal columns; quick-draft needs at least one seed to target.
-    const statusWidgets = [
-        widget('core/site-status', { variant: 'badge' }),
-        widget('core/storage', { variant: 'gauge' }),
-        widget('core/publication-stats', { variant: 'trio' }),
-    ];
-    if (seeds.length > 0) {
-        statusWidgets.push(widget('core/quick-draft', { variant: 'minimal' }));
-    }
-    sections.push({
-        id: newId(),
-        hideLabel: true,
-        columns: statusWidgets.map(singleWidgetColumn),
-    });
-    if (seeds.length > 0) {
-        const seedSlug = seeds.find((s) => s.slug === 'articoli')?.slug ?? seeds[0].slug;
-        // Content row: recent content | pending drafts.
-        sections.push({
-            id: newId(),
-            hideLabel: true,
-            columns: [
-                singleWidgetColumn(widget('core/recent-content', { seedSlug, variant: 'list' })),
-                singleWidgetColumn(widget('core/pending-drafts', { seedSlug, variant: 'list' })),
-            ],
-            columnSpans: [6, 6],
-        });
-        // Media & activity row: media gallery | activity feed.
-        sections.push({
-            id: newId(),
-            hideLabel: true,
-            columns: [
-                singleWidgetColumn(widget('core/media-gallery', { seedSlug, variant: 'grid' })),
-                singleWidgetColumn(widget('core/activity-feed', { seedSlug, variant: 'feed' })),
-            ],
-            columnSpans: [6, 6],
-        });
-    }
-    return {
-        version: 1,
-        pages: [
-            {
-                id: newId(),
-                slug: 'overview',
-                label: 'Overview',
-                icon: 'LayoutDashboard',
-                sections,
-            },
-        ],
-    };
-}
-/** Semantic validation on top of the Zod shape check (the caller's job).
- *  Widgets bound to a seed that no longer exists are silently stripped
- *  (auto-cleanup, recorded as a warning). Unknown widget types only warn —
- *  custom widgets are invisible to the Worker and must never be stripped.
- *  `cleaned` is always returned, errors or not. */
-export function validateDashboardLayout(layout, ctx) {
-    const errors = [];
-    const warnings = [];
-    // Auto-cleanup: drop widgets whose config.seedSlug references a missing seed.
-    const cleanedPages = layout.pages.map((page) => ({
-        ...page,
-        sections: page.sections.map((section) => ({
-            ...section,
-            columns: section.columns.map((col) => ({
-                ...col,
-                widgets: (col.widgets ?? []).filter((w) => {
-                    const seedSlug = (w.config ?? {})['seedSlug'];
-                    if (typeof seedSlug === 'string' && !ctx.seedSlugs.has(seedSlug)) {
-                        warnings.push(`Widget '${w.type}' (id=${w.id}) removed: seed '${seedSlug}' is not registered.`);
-                        return false;
-                    }
-                    return true;
-                }),
-            })),
-        })),
-    }));
-    // Semantic checks on the cleaned layout
-    const seenWidgetIds = new Set();
-    const seenPageSlugs = new Set();
-    for (const page of cleanedPages) {
-        if (seenPageSlugs.has(page.slug)) {
-            errors.push(`Page slug '${page.slug}' appears more than once in the layout.`);
-        }
-        else {
-            seenPageSlugs.add(page.slug);
-        }
-        for (const section of page.sections) {
-            if (section.columnSpans !== undefined) {
-                if (section.columnSpans.length !== section.columns.length) {
-                    errors.push(`Section ${section.id}: columnSpans has ${section.columnSpans.length} entries for ${section.columns.length} columns.`);
-                }
-                else {
-                    const sum = section.columnSpans.reduce((acc, span) => acc + span, 0);
-                    if (sum !== 12) {
-                        errors.push(`Section ${section.id}: columnSpans must sum to 12, got ${sum}.`);
-                    }
-                }
-            }
-            for (const col of section.columns) {
-                for (const w of col.widgets) {
-                    if (seenWidgetIds.has(w.id)) {
-                        errors.push(`Widget id '${w.id}' appears more than once in the layout.`);
-                    }
-                    else {
-                        seenWidgetIds.add(w.id);
-                    }
-                    if (JSON.stringify(w.config ?? {}).length > MAX_WIDGET_CONFIG_BYTES) {
-                        errors.push(`Widget '${w.type}' (id=${w.id}): config exceeds ${MAX_WIDGET_CONFIG_BYTES} bytes when serialized.`);
-                    }
-                    if (ctx.knownWidgetTypes !== undefined && !ctx.knownWidgetTypes.has(w.type)) {
-                        warnings.push(`Widget '${w.type}' (id=${w.id}) is not a known widget type.`);
-                    }
-                }
-            }
-        }
-    }
-    const cleaned = { ...layout, pages: cleanedPages };
-    if (errors.length > 0)
-        return { ok: false, errors, cleaned, warnings };
-    return { ok: true, cleaned, warnings };
-}

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

@@ -1,18 +0,0 @@
-import type { DashboardLayout } from './dashboard-layout.js';
-export interface DashboardLayoutRecord {
-    scope: string;
-    layout: DashboardLayout;
-    updatedAt: number;
-    updatedBy: string;
-}
-export interface IDashboardLayoutRepository {
-    /** Stored layout for a scope, or null if none was ever saved. */
-    get(scope: string): Promise<DashboardLayoutRecord | null>;
-    /** Scopes that currently have a stored row — used by the Sprint 06 builder UI. */
-    listScopes(): Promise<string[]>;
-    /** Upsert. `updatedBy` is the writer's user id. */
-    upsert(scope: string, layout: DashboardLayout, updatedBy: string): Promise<void>;
-    /** Remove the stored row — the "Reset" action. */
-    remove(scope: string): Promise<void>;
-}
-//# sourceMappingURL=dashboard-layout.repository.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"dashboard-layout.repository.d.ts","sourceRoot":"","sources":["../src/dashboard-layout.repository.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE5D,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,eAAe,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,0BAA0B;IACzC,iEAAiE;IACjE,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAA;IACzD,kFAAkF;IAClF,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC/B,mDAAmD;IACnD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChF,kDAAkD;IAClD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACrC"}

package/dist/dashboard-layout.repository.js

@@ -1,3 +0,0 @@
-// SPDX-License-Identifier: MIT
-// Copyright (c) 2024–2026 Flavio De Musso
-export {};

package/dist/dashboard-permissions.d.ts

@@ -1,3 +0,0 @@
-export declare const ROLES_ALLOWED_TO_EDIT_DASHBOARD: ReadonlyArray<string>;
-export declare function canEditDashboard(role: string | undefined | null): boolean;
-//# sourceMappingURL=dashboard-permissions.d.ts.map

package/dist/dashboard-permissions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dashboard-permissions.d.ts","sourceRoot":"","sources":["../src/dashboard-permissions.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,+BAA+B,EAAE,aAAa,CAAC,MAAM,CAAa,CAAA;AAE/E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAGzE"}

package/dist/dashboard-permissions.js

@@ -1,11 +0,0 @@
-// SPDX-License-Identifier: MIT
-// Copyright (c) 2024–2026 Flavio De Musso
-// NOTE: change this list to extend write-access to other roles
-// (e.g. add 'editor', or introduce a fine-grained 'dashboard:edit' permission).
-// Single source of truth — used by both API guards and dashboard buttons.
-export const ROLES_ALLOWED_TO_EDIT_DASHBOARD = ['admin'];
-export function canEditDashboard(role) {
-    if (!role)
-        return false;
-    return ROLES_ALLOWED_TO_EDIT_DASHBOARD.includes(role);
-}

package/dist/dashboard-scopes.d.ts

@@ -1,12 +0,0 @@
-/** Roles that may have their own dashboard layout. Single source of truth —
- *  extend this list if a new role is introduced. */
-export declare const KNOWN_DASHBOARD_ROLES: ReadonlyArray<string>;
-export declare const DEFAULT_DASHBOARD_SCOPE = "default";
-/** Builds the per-role scope string, e.g. `roleScope('editor') === 'role:editor'`. */
-export declare function roleScope(role: string): string;
-/** Whether `scope` is one of the closed set: `'default' | 'role:<known role>'`. */
-export declare function isValidDashboardScope(scope: string): boolean;
-/** Read-resolution order for a caller's role: `['role:<role>', 'default']`,
- *  or just `['default']` for unknown/missing roles. */
-export declare function resolveDashboardScopeChain(role: string | undefined | null): string[];
-//# sourceMappingURL=dashboard-scopes.d.ts.map

package/dist/dashboard-scopes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dashboard-scopes.d.ts","sourceRoot":"","sources":["../src/dashboard-scopes.ts"],"names":[],"mappings":"AAOA;oDACoD;AACpD,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,MAAM,CAAuB,CAAA;AAE/E,eAAO,MAAM,uBAAuB,YAAY,CAAA;AAEhD,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAK5D;AAED;uDACuD;AACvD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,EAAE,CAKpF"}

package/dist/dashboard-scopes.js

@@ -1,30 +0,0 @@
-// SPDX-License-Identifier: MIT
-// Copyright (c) 2024–2026 Flavio De Musso
-// ---------------------------------------------------------------------------
-// Dashboard layout scopes (Sprint 06: role-based dashboards)
-// ---------------------------------------------------------------------------
-/** Roles that may have their own dashboard layout. Single source of truth —
- *  extend this list if a new role is introduced. */
-export const KNOWN_DASHBOARD_ROLES = ['admin', 'editor'];
-export const DEFAULT_DASHBOARD_SCOPE = 'default';
-/** Builds the per-role scope string, e.g. `roleScope('editor') === 'role:editor'`. */
-export function roleScope(role) {
-    return `role:${role}`;
-}
-/** Whether `scope` is one of the closed set: `'default' | 'role:<known role>'`. */
-export function isValidDashboardScope(scope) {
-    if (scope === DEFAULT_DASHBOARD_SCOPE)
-        return true;
-    const match = /^role:(.+)$/.exec(scope);
-    if (!match)
-        return false;
-    return KNOWN_DASHBOARD_ROLES.includes(match[1]);
-}
-/** Read-resolution order for a caller's role: `['role:<role>', 'default']`,
- *  or just `['default']` for unknown/missing roles. */
-export function resolveDashboardScopeChain(role) {
-    if (role && KNOWN_DASHBOARD_ROLES.includes(role)) {
-        return [roleScope(role), DEFAULT_DASHBOARD_SCOPE];
-    }
-    return [DEFAULT_DASHBOARD_SCOPE];
-}

package/dist/define-seed.d.ts

@@ -1,3 +0,0 @@
-import type { Seed } from './types.js';
-export declare function defineSeed(seed: Seed): Seed;
-//# sourceMappingURL=define-seed.d.ts.map

package/dist/define-seed.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"define-seed.d.ts","sourceRoot":"","sources":["../src/define-seed.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEtC,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAE3C"}

package/dist/define-seed.js

@@ -1,5 +0,0 @@
-// SPDX-License-Identifier: MIT
-// Copyright (c) 2024–2026 Flavio De Musso
-export function defineSeed(seed) {
-    return seed;
-}

package/dist/demo-data.repository.d.ts

@@ -1,5 +0,0 @@
-export interface IDemoDataRepository {
-    /** Executes the compiled demo dataset SQL against the database. */
-    loadDemoData(): Promise<void>;
-}
-//# sourceMappingURL=demo-data.repository.d.ts.map

package/dist/demo-data.repository.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"demo-data.repository.d.ts","sourceRoot":"","sources":["../src/demo-data.repository.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9B"}

package/dist/demo-data.repository.js

@@ -1,3 +0,0 @@
-// SPDX-License-Identifier: MIT
-// Copyright (c) 2024–2026 Flavio De Musso
-export {};

package/dist/email.provider.d.ts

@@ -1,32 +0,0 @@
-/**
- * The resolved email message that the provider receives and sends.
- * Constructed by the service by combining call parameters with template builder output.
- */
-export interface OutboundEmail {
-    /** Sender address in RFC 5321 format (e.g., "Beech CMS <noreply@beechcms.dev>"). */
-    from: string;
-    /** List of recipient addresses. Must contain at least one element. */
-    to: string[];
-    subject: string;
-    /** Complete HTML body. Must be a valid HTML document (see templates/shell.ts). */
-    html: string;
-}
-/**
- * Formal contract for email sending providers.
- *
- * Every implementation (Resend, SMTP, …) must comply with this interface.
- * It is the only point of coupling between the email module and any external service.
- *
- * To add a new provider: create a class in apps/api/src/shared/email/providers/
- * that implements this interface, then wire it in email.service.ts.
- */
-export interface EmailProvider {
-    /**
-     * Sends a single transactional email.
-     *
-     * @throws {Error} If the provider rejects the request. The caller is responsible
-     *                 for catching and handling this error appropriately.
-     */
-    send(email: OutboundEmail): Promise<void>;
-}
-//# sourceMappingURL=email.provider.d.ts.map

package/dist/email.provider.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"email.provider.d.ts","sourceRoot":"","sources":["../src/email.provider.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,EAAE,EAAE,MAAM,EAAE,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1C"}

package/dist/email.provider.js

@@ -1,4 +0,0 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-export {};

package/dist/engine/ddl/seed-ddl-destructive.d.ts

@@ -1,40 +0,0 @@
-import type { Seed, BranchType } from '../types.js';
-/**
- * Ordered DROP TABLE statements for a full hard-delete of a seed's tables.
- * Order: junction drafts → junctions → FTS triggers → FTS table → drafts → main table.
- * All statements use IF EXISTS (idempotent).
- */
-export declare function generateDropTable(seed: Seed): string[];
-/**
- * DROP COLUMN statements for a single branch (by alias).
- * For multi-relation branches: drops the junction tables (no column on parent).
- * For regular branches: drops from main table + drafts table (if allowDrafts).
- * Does NOT include FTS handling — callers must prepend ftsTriggerDrops() and
- * append planFtsRebuild() when the branch is searchable.
- */
-export declare function generateDropColumn(seed: Seed, alias: string): string[];
-/**
- * RENAME COLUMN statements for a branch alias change.
- * Updates main table + drafts (if allowDrafts).
- * Does NOT handle FTS — callers must rebuild FTS separately (SQLite auto-updates
- * trigger bodies on RENAME but the FTS virtual-table columns keep the old name).
- */
-export declare function generateRenameColumn(seed: Seed, fromAlias: string, toAlias: string): string[];
-/**
- * Full FTS rebuild: drop triggers + FTS table, then recreate them, then backfill.
- * Returns an empty array if the seed has no searchable branches.
- * The drop steps use IF EXISTS so this is safe to call even if FTS was already dropped.
- */
-export declare function planFtsRebuild(seed: Seed): string[];
-export interface RetypeColumnPlan {
-    statements: string[];
-    ftsRebuildNeeded: boolean;
-}
-/**
- * Generates statements to change a branch's SQL storage type using the
- * add-new-column / copy / drop-old / rename approach.
- * Includes FTS rebuild statements when the branch is (or becomes) searchable.
- * `updatedSeed` must already reflect the new type on the renamed branch.
- */
-export declare function planRetypeColumn(seed: Seed, alias: string, newType: BranchType, updatedSeed: Seed): RetypeColumnPlan;
-//# sourceMappingURL=seed-ddl-destructive.d.ts.map

package/dist/engine/ddl/seed-ddl-destructive.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"seed-ddl-destructive.d.ts","sourceRoot":"","sources":["../../../src/engine/ddl/seed-ddl-destructive.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAU,UAAU,EAAE,MAAM,aAAa,CAAA;AAkC3D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAgBtD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBtE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ7F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAiBnD;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,gBAAgB,EAAE,OAAO,CAAA;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,UAAU,EACnB,WAAW,EAAE,IAAI,GAChB,gBAAgB,CAyClB"}

package/dist/engine/ddl/seed-ddl-destructive.js

@@ -1,149 +0,0 @@
-// SPDX-License-Identifier: MIT
-// Copyright (c) 2024–2026 Flavio De Musso
-import { junctionTableName, generateFtsTable, generateFtsTriggers } from './ddl.js';
-const BRANCH_SQL_TYPE = {
-    text: 'TEXT',
-    number: 'REAL',
-    boolean: 'INTEGER',
-    date: 'INTEGER',
-    json: 'TEXT',
-    richtext: 'TEXT',
-    file: 'TEXT',
-    tags: 'TEXT',
-    relation: 'TEXT',
-    repeater: 'TEXT',
-};
-/** Branch types that receive a B-tree index in generateIndexes (used by retype to drop/recreate). */
-const INDEXABLE_TYPES = new Set(['text', 'number', 'date', 'boolean', 'relation']);
-function searchBranches(seed) {
-    return seed.branches.filter(b => (b.type === 'text' || b.type === 'richtext') && b.policies?.search !== false);
-}
-function ftsTriggerDrops(slug) {
-    return [
-        `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 fts_${slug};`,
-    ];
-}
-/**
- * Ordered DROP TABLE statements for a full hard-delete of a seed's tables.
- * Order: junction drafts → junctions → FTS triggers → FTS table → drafts → main table.
- * All statements use IF EXISTS (idempotent).
- */
-export function generateDropTable(seed) {
-    const stmts = [];
-    const { slug } = seed;
-    for (const branch of seed.branches) {
-        if (branch.type !== 'relation' || branch.multiple !== true)
-            continue;
-        const jt = junctionTableName(slug, branch.alias);
-        stmts.push(`DROP TABLE IF EXISTS ${jt}_drafts;`);
-        stmts.push(`DROP TABLE IF EXISTS ${jt};`);
-    }
-    stmts.push(...ftsTriggerDrops(slug));
-    stmts.push(`DROP TABLE IF EXISTS content_${slug}_drafts;`);
-    stmts.push(`DROP TABLE IF EXISTS content_${slug};`);
-    return stmts;
-}
-/**
- * DROP COLUMN statements for a single branch (by alias).
- * For multi-relation branches: drops the junction tables (no column on parent).
- * For regular branches: drops from main table + drafts table (if allowDrafts).
- * Does NOT include FTS handling — callers must prepend ftsTriggerDrops() and
- * append planFtsRebuild() when the branch is searchable.
- */
-export function generateDropColumn(seed, alias) {
-    const stmts = [];
-    const { slug } = seed;
-    const branch = seed.branches.find(b => b.alias === alias);
-    if (!branch)
-        throw new Error(`Branch '${alias}' not found in seed '${slug}'`);
-    if (branch.type === 'relation' && branch.multiple === true) {
-        const jt = junctionTableName(slug, alias);
-        if (seed.allowDrafts)
-            stmts.push(`DROP TABLE IF EXISTS ${jt}_drafts;`);
-        stmts.push(`DROP TABLE IF EXISTS ${jt};`);
-    }
-    else {
-        stmts.push(`ALTER TABLE content_${slug} DROP COLUMN ${alias};`);
-        if (seed.allowDrafts)
-            stmts.push(`ALTER TABLE content_${slug}_drafts DROP COLUMN ${alias};`);
-    }
-    return stmts;
-}
-/**
- * RENAME COLUMN statements for a branch alias change.
- * Updates main table + drafts (if allowDrafts).
- * Does NOT handle FTS — callers must rebuild FTS separately (SQLite auto-updates
- * trigger bodies on RENAME but the FTS virtual-table columns keep the old name).
- */
-export function generateRenameColumn(seed, fromAlias, toAlias) {
-    const stmts = [];
-    const { slug } = seed;
-    stmts.push(`ALTER TABLE content_${slug} RENAME COLUMN ${fromAlias} TO ${toAlias};`);
-    if (seed.allowDrafts) {
-        stmts.push(`ALTER TABLE content_${slug}_drafts RENAME COLUMN ${fromAlias} TO ${toAlias};`);
-    }
-    return stmts;
-}
-/**
- * Full FTS rebuild: drop triggers + FTS table, then recreate them, then backfill.
- * Returns an empty array if the seed has no searchable branches.
- * The drop steps use IF EXISTS so this is safe to call even if FTS was already dropped.
- */
-export function planFtsRebuild(seed) {
-    const rtBranches = searchBranches(seed);
-    if (rtBranches.length === 0)
-        return [];
-    const { slug } = seed;
-    const stmts = [...ftsTriggerDrops(slug)];
-    const ftsTable = generateFtsTable(seed);
-    if (ftsTable)
-        stmts.push(ftsTable);
-    stmts.push(...generateFtsTriggers(seed));
-    const cols = rtBranches.map(b => b.alias);
-    stmts.push(`INSERT INTO fts_${slug}(entry_id, ${cols.join(', ')}) SELECT id, ${cols.join(', ')} FROM content_${slug};`);
-    return stmts;
-}
-/**
- * Generates statements to change a branch's SQL storage type using the
- * add-new-column / copy / drop-old / rename approach.
- * Includes FTS rebuild statements when the branch is (or becomes) searchable.
- * `updatedSeed` must already reflect the new type on the renamed branch.
- */
-export function planRetypeColumn(seed, alias, newType, updatedSeed) {
-    const branch = seed.branches.find(b => b.alias === alias);
-    if (!branch)
-        throw new Error(`Branch '${alias}' not found in seed '${seed.slug}'`);
-    const { slug } = seed;
-    const newSqlType = BRANCH_SQL_TYPE[newType];
-    const tmpAlias = `${alias}_migrate`;
-    const stmts = [];
-    // Always drop FTS first to avoid "column referenced in trigger" errors on DROP COLUMN.
-    stmts.push(...ftsTriggerDrops(slug));
-    // Drop the branch index if it exists on the old column (required before DROP COLUMN).
-    if (INDEXABLE_TYPES.has(branch.type) && branch.policies?.filter !== false) {
-        stmts.push(`DROP INDEX IF EXISTS idx_${slug}_${alias};`);
-    }
-    // Main table: add migration column, copy data, drop old, rename.
-    stmts.push(`ALTER TABLE content_${slug} ADD COLUMN ${tmpAlias} ${newSqlType};`);
-    stmts.push(`UPDATE content_${slug} SET ${tmpAlias} = CAST(${alias} AS ${newSqlType});`);
-    stmts.push(`ALTER TABLE content_${slug} DROP COLUMN ${alias};`);
-    stmts.push(`ALTER TABLE content_${slug} RENAME COLUMN ${tmpAlias} TO ${alias};`);
-    // Recreate index for the renamed column if the new type warrants it.
-    if (INDEXABLE_TYPES.has(newType) && branch.policies?.filter !== false) {
-        stmts.push(`CREATE INDEX IF NOT EXISTS idx_${slug}_${alias} ON content_${slug}(${alias});`);
-    }
-    // Drafts table (no indexes to worry about).
-    if (seed.allowDrafts) {
-        stmts.push(`ALTER TABLE content_${slug}_drafts ADD COLUMN ${tmpAlias} ${newSqlType};`);
-        stmts.push(`UPDATE content_${slug}_drafts SET ${tmpAlias} = CAST(${alias} AS ${newSqlType});`);
-        stmts.push(`ALTER TABLE content_${slug}_drafts DROP COLUMN ${alias};`);
-        stmts.push(`ALTER TABLE content_${slug}_drafts RENAME COLUMN ${tmpAlias} TO ${alias};`);
-    }
-    // Rebuild FTS if the seed has searchable branches in the updated definition.
-    const rebuild = planFtsRebuild(updatedSeed);
-    stmts.push(...rebuild);
-    return { statements: stmts, ftsRebuildNeeded: rebuild.length > 0 };
-}