@beechcms/core 0.9.6 → 0.9.7

package/dist/dashboard-layout/content-view.d.ts

@@ -125,8 +125,8 @@ export declare const viewConditionalFormatSchema: z.ZodObject<{
         value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
     }, z.core.$strip>>;
     tone: z.ZodEnum<{
-        info: "info";
         success: "success";
+        info: "info";
         warning: "warning";
         neutral: "neutral";
         danger: "danger";
@@ -275,8 +275,8 @@ export declare const contentViewConfigSchema: z.ZodObject<{
             value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
         }, z.core.$strip>>;
         tone: z.ZodEnum<{
-            info: "info";
             success: "success";
+            info: "info";
             warning: "warning";
             neutral: "neutral";
             danger: "danger";
@@ -457,8 +457,8 @@ export declare const createContentViewInputSchema: z.ZodObject<{
                 value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
             }, z.core.$strip>>;
             tone: z.ZodEnum<{
-                info: "info";
                 success: "success";
+                info: "info";
                 warning: "warning";
                 neutral: "neutral";
                 danger: "danger";
@@ -629,8 +629,8 @@ export declare const updateContentViewInputSchema: z.ZodObject<{
                 value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
             }, z.core.$strip>>;
             tone: z.ZodEnum<{
-                info: "info";
                 success: "success";
+                info: "info";
                 warning: "warning";
                 neutral: "neutral";
                 danger: "danger";

package/dist/dashboard-layout/relation-avatar.d.ts

@@ -0,0 +1,12 @@
+import type { Branch } from '../engine/types.js';
+import type { SeedLookup } from '../engine/query/search-support.js';
+/**
+ * The target-seed branch that supplies a relation's avatar image, or `null` when the relation has no
+ * avatar configured or the configuration no longer resolves (target gone, field renamed, retyped,
+ * hidden). Callers treat `null` as "no avatar" — a stale `avatarSource` degrades, it never throws.
+ *
+ * @param branch The relation branch carrying `avatarSource`.
+ * @param lookup Resolves the relation target.
+ */
+export declare function resolveRelationAvatar(branch: Branch, lookup: SeedLookup): Branch | null;
+//# sourceMappingURL=relation-avatar.d.ts.map

package/dist/dashboard-layout/relation-avatar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-avatar.d.ts","sourceRoot":"","sources":["../../src/dashboard-layout/relation-avatar.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAGnE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAKvF"}

package/dist/dashboard-layout/relation-avatar.js

@@ -0,0 +1,18 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2024–2026 Flavio De Musso
+import { isImageMediaBranch } from './seed-layout.js';
+/**
+ * The target-seed branch that supplies a relation's avatar image, or `null` when the relation has no
+ * avatar configured or the configuration no longer resolves (target gone, field renamed, retyped,
+ * hidden). Callers treat `null` as "no avatar" — a stale `avatarSource` degrades, it never throws.
+ *
+ * @param branch The relation branch carrying `avatarSource`.
+ * @param lookup Resolves the relation target.
+ */
+export function resolveRelationAvatar(branch, lookup) {
+    if (branch.type !== 'relation' || !branch.avatarSource || !branch.targetSeed)
+        return null;
+    const target = lookup(branch.targetSeed);
+    const source = target?.branches.find((b) => b.alias === branch.avatarSource);
+    return source && isImageMediaBranch(source) ? source : null;
+}

package/dist/dashboard-layout.d.ts

@@ -0,0 +1,154 @@
+import { z } from 'zod';
+import type { Seed } from './types.js';
+/** A placed widget. `type` is namespaced ('core/stat', '@acme/weather').
+ *  `config` is opaque to core/API except for the optional `seedSlug` key,
+ *  which enables auto-cleanup when the referenced seed disappears. */
+export interface DashboardWidgetInstance {
+    id: string;
+    type: string;
+    title?: string;
+    config: Record<string, unknown>;
+}
+export interface DashboardColumn {
+    id: string;
+    widgets: DashboardWidgetInstance[];
+}
+export interface DashboardSection {
+    id: string;
+    label?: string;
+    hideLabel?: boolean;
+    collapsible?: boolean;
+    /** 1–4 columns. Enforced by validator. */
+    columns: DashboardColumn[];
+    /** Optional spans on a 12-unit grid, parallel to `columns`, must sum to 12.
+     *  Absent = equal split. */
+    columnSpans?: number[];
+}
+export interface DashboardPageLayout {
+    id: string;
+    /** URL identity (?page=<slug>). Unique within the layout. */
+    slug: string;
+    label: string;
+    /** Lucide icon name, same convention as DashboardSeedConfig.icon. */
+    icon?: string;
+    sections: DashboardSection[];
+}
+export interface DashboardLayout {
+    /** Format version — bump when introducing breaking changes. */
+    version: 1;
+    pages: DashboardPageLayout[];
+}
+/** Namespaced widget type — lowercase npm-name-compatible.
+ *  Built-ins use the 'core/' prefix; custom widgets '@scope/name'. */
+export declare const WIDGET_TYPE_REGEX: RegExp;
+/** Max serialized size of a single widget `config`
+ *  (`JSON.stringify(widget.config).length`) — guards D1 row bloat. */
+export declare const MAX_WIDGET_CONFIG_BYTES = 8192;
+export declare const dashboardWidgetInstanceSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const dashboardColumnSchema: z.ZodObject<{
+    id: z.ZodString;
+    widgets: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const dashboardSectionSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    hideLabel: z.ZodOptional<z.ZodBoolean>;
+    collapsible: z.ZodOptional<z.ZodBoolean>;
+    columns: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        widgets: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    columnSpans: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+}, z.core.$strip>;
+export declare const dashboardPageSchema: z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    label: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    sections: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        hideLabel: z.ZodOptional<z.ZodBoolean>;
+        collapsible: z.ZodOptional<z.ZodBoolean>;
+        columns: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            widgets: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                type: z.ZodString;
+                title: z.ZodOptional<z.ZodString>;
+                config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        columnSpans: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const dashboardLayoutSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    pages: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        label: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+        sections: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            hideLabel: z.ZodOptional<z.ZodBoolean>;
+            collapsible: z.ZodOptional<z.ZodBoolean>;
+            columns: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                widgets: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    type: z.ZodString;
+                    title: z.ZodOptional<z.ZodString>;
+                    config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            columnSpans: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** 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 declare function generateDefaultDashboardLayout(seeds: Seed[], opts?: {
+    newId: () => string;
+}): DashboardLayout;
+export interface DashboardLayoutContext {
+    /** Slugs of currently registered seeds (from ISeedRegistry.all()). */
+    seedSlugs: ReadonlySet<string>;
+    /** Optional: widget types known to the caller (frontend registry).
+     *  When provided, unknown types produce WARNINGS, never strips. */
+    knownWidgetTypes?: ReadonlySet<string>;
+}
+export type ValidateDashboardLayoutResult = {
+    ok: true;
+    cleaned: DashboardLayout;
+    warnings: string[];
+} | {
+    ok: false;
+    errors: string[];
+    cleaned: DashboardLayout;
+    warnings: string[];
+};
+/** 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 declare function validateDashboardLayout(layout: DashboardLayout, ctx: DashboardLayoutContext): ValidateDashboardLayoutResult;
+//# sourceMappingURL=dashboard-layout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-layout.d.ts","sourceRoot":"","sources":["../src/dashboard-layout.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAMtC;;sEAEsE;AACtE,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,uBAAuB,EAAE,CAAA;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,0CAA0C;IAC1C,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B;gCAC4B;IAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,gBAAgB,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,OAAO,EAAE,CAAC,CAAA;IACV,KAAK,EAAE,mBAAmB,EAAE,CAAA;CAC7B;AAMD;sEACsE;AACtE,eAAO,MAAM,iBAAiB,QAA6B,CAAA;AAE3D;sEACsE;AACtE,eAAO,MAAM,uBAAuB,OAAO,CAAA;AAM3C,eAAO,MAAM,6BAA6B;;;;;iBAKxC,CAAA;AACF,eAAO,MAAM,qBAAqB;;;;;;;;iBAGhC,CAAA;AACF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;iBAOjC,CAAA;AACF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;iBAM9B,CAAA;AACF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;iBAGhC,CAAA;AAQF;;6DAE6D;AAC7D,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,IAAI,EAAE,EACb,IAAI,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,MAAM,CAAA;CAAE,GAC7B,eAAe,CA2EjB;AAMD,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC9B;uEACmE;IACnE,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CACvC;AAED,MAAM,MAAM,6BAA6B,GACrC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAC1D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAEjF;;;;mDAImD;AACnD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,sBAAsB,GAC1B,6BAA6B,CA2E/B"}

package/dist/dashboard-layout.js

@@ -0,0 +1,186 @@
+// 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

@@ -0,0 +1,18 @@
+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

@@ -0,0 +1 @@
+{"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

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

package/dist/dashboard-permissions.d.ts

@@ -0,0 +1,3 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,11 @@
+// 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

@@ -0,0 +1,12 @@
+/** 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,30 @@
+// 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

@@ -0,0 +1,3 @@
+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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1,5 @@
+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

@@ -0,0 +1 @@
+{"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

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

package/dist/email.provider.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,4 @@
+// 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.d.ts

@@ -68,19 +68,6 @@ export declare function generateDraftTable(seed: Seed): string | null;
  * @returns The ALTER TABLE SQL statement.
  */
 export declare function generateAddColumn(seed: Seed, branch: Branch): string;
-/**
- * Generates the `ALTER TABLE content_{slug}_drafts ADD COLUMN live_snapshot_at INTEGER` statement
- * for a draft table provisioned before the column existed.
- *
- * System column, not a branch — `generateAddColumn` iterates `seed.branches` and can never emit it.
- * NOT idempotent: `ADD COLUMN` fails when the column is already present and `ISchemaMutator.execDdl`
- * aborts the whole batch on the first failing statement, so the caller MUST check the physical
- * columns first (see `planExtendSeed`).
- *
- * @param seed The seed definition. Caller must have verified `seed.allowDrafts`.
- * @returns The ALTER TABLE statement.
- */
-export declare function generateAddDraftSnapshotColumn(seed: Seed): string;
 /**
  * Generates SQL index statements for system fields (status, created_at)
  * and indexable branch columns.
@@ -203,14 +190,4 @@ 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[];
-/**
- * Additive statements that turn soft delete on for a table that already exists.
- *
- * The partial unique index is emitted for correctness on tables that were CREATED with
- * `softDelete: true`. On a pre-existing table the inline `slug … UNIQUE` survives as a
- * sqlite_autoindex that SQLite cannot drop via ALTER; there the partial index is redundant
- * and a trashed slug stays reserved until the table is rebuilt (see ROADMAP deferral).
- * Returns [] when the seed does not opt in.
- */
-export declare function generateEnableSoftDelete(seed: Seed): string[];
 //# sourceMappingURL=ddl.d.ts.map

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

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