@beechcms/core 0.6.0-preview.3 → 0.6.0

package/dist/engine/query.js

@@ -0,0 +1,208 @@
+import { tableName, ftsTableName, isValidColumn, indexableSearchBranches, SYSTEM_COLUMNS } from './ddl.js';
+/**
+ * Builds a parameterized SQL SELECT query and bindings for a given Seed based on search, filtering, status, and ordering options.
+ *
+ * If `options.isCount` is set to `true`, it generates a counting query (`COUNT(*) as total`) rather than returning database rows.
+ * In count mode, column projections (`fields`), ordering (`orderBy` / `kanbanOrder`), and pagination (`LIMIT` / `OFFSET`) clauses and
+ * bindings are omitted, while join and filtering clauses are preserved.
+ *
+ * @param seed The seed definition.
+ * @param options Query configuration options.
+ * @returns The SQL query string and bindings.
+ * @example
+ * ```ts
+ * const { sql, bindings } = buildSelectQuery(postSeed, {
+ *   status: 'published',
+ *   filters: [{ column: 'title', type: 'text', conditions: [{ op: 'contains', value: 'cms' }] }],
+ *   orderBy: { column: 'created_at', dir: 'DESC' },
+ *   pagination: { limit: 20, offset: 0 },
+ * })
+ * ```
+ */
+export function buildSelectQuery(seed, options = {}) {
+    const table = tableName(seed);
+    const { filters = [], orderBy, pagination, status, search, fields } = options;
+    const bindings = [];
+    const whereClauses = [];
+    let joinClause = '';
+    let kanbanOrderClause = '';
+    if (options.kanbanOrder) {
+        joinClause = `LEFT JOIN kanban_positions kp` +
+            ` ON kp.seed_slug = ? AND kp.entry_id = ${table}.id AND kp.axis_branch_id = ?`;
+        bindings.push(options.kanbanOrder.seedSlug, options.kanbanOrder.axisBranchId);
+        kanbanOrderClause = ` ORDER BY (kp.position IS NULL) ASC, kp.position ASC`;
+    }
+    const rtBranches = indexableSearchBranches(seed);
+    if (search && rtBranches.length > 0) {
+        const ftsTable = ftsTableName(seed);
+        joinClause += (joinClause ? ' ' : '') + `INNER JOIN ${ftsTable} ON ${ftsTable}.entry_id = ${table}.id`;
+        whereClauses.push(`${ftsTable} MATCH ?`);
+        bindings.push(`"${search.replace(/"/g, '""')}"*`);
+    }
+    if (status !== undefined && status !== null) {
+        whereClauses.push(`${table}.status = ?`);
+        bindings.push(status);
+    }
+    for (const group of filters) {
+        if (!isValidColumn(seed, group.column))
+            continue;
+        const col = SYSTEM_COLUMNS.has(group.column)
+            ? `${table}.${group.column}`
+            : group.column;
+        for (const cond of group.conditions) {
+            const clause = buildFilterCondition(col, group.type, cond, bindings);
+            if (clause)
+                whereClauses.push(clause);
+        }
+    }
+    let selectCols = options.isCount ? 'COUNT(*) as total' : `${table}.*`;
+    if (!options.isCount && fields && fields.length > 0) {
+        const valid = fields.filter(f => isValidColumn(seed, f));
+        if (valid.length > 0) {
+            selectCols = valid
+                .map(f => (SYSTEM_COLUMNS.has(f) ? `${table}.${f}` : f))
+                .join(', ');
+        }
+    }
+    if (!options.isCount && options.kanbanOrder)
+        selectCols += ', kp.position';
+    let sql = `SELECT ${selectCols} FROM ${table}`;
+    if (joinClause)
+        sql += ` ${joinClause}`;
+    if (whereClauses.length > 0)
+        sql += ` WHERE ${whereClauses.join(' AND ')}`;
+    if (!options.isCount) {
+        if (kanbanOrderClause) {
+            sql += kanbanOrderClause;
+        }
+        else if (orderBy && isValidColumn(seed, orderBy.column)) {
+            const dir = orderBy.dir === 'DESC' ? 'DESC' : 'ASC';
+            const col = SYSTEM_COLUMNS.has(orderBy.column)
+                ? `${table}.${orderBy.column}`
+                : orderBy.column;
+            sql += ` ORDER BY ${col} ${dir}`;
+        }
+        else {
+            sql += ` ORDER BY ${table}.created_at DESC`;
+        }
+        if (pagination) {
+            sql += ` LIMIT ? OFFSET ?`;
+            bindings.push(pagination.limit, pagination.offset);
+        }
+    }
+    return { sql, bindings };
+}
+/**
+ * Normalizes user-provided filter values to a format appropriate for SQL execution.
+ *
+ * @param type The type of the filter.
+ * @param value The value to normalize.
+ * @returns The normalized value, or null.
+ */
+function normalizeFilterValue(type, value) {
+    if (value === null || value === undefined)
+        return null;
+    if (type === 'date') {
+        if (typeof value === 'number')
+            return value;
+        if (typeof value === 'string' && value.trim() !== '') {
+            const d = new Date(value);
+            return Number.isNaN(d.getTime()) ? null : Math.floor(d.getTime() / 1000);
+        }
+        return null;
+    }
+    if (type === 'boolean') {
+        return value ? 1 : 0;
+    }
+    if (type === 'number') {
+        if (typeof value === 'number')
+            return value;
+        if (typeof value === 'string' && value.trim() !== '') {
+            const n = Number(value);
+            return Number.isNaN(n) ? null : n;
+        }
+        return null;
+    }
+    return value;
+}
+/**
+ * Translates a filter condition into its SQL clause and adds parameters to the bindings list.
+ *
+ * @param col The column name in the table.
+ * @param type The type of the filter.
+ * @param cond The condition containing the operator and value.
+ * @param bindings The array of bindings where parameterized values are appended.
+ * @returns The SQL condition fragment, or null if invalid.
+ */
+function buildFilterCondition(col, type, cond, bindings) {
+    const { op, value } = cond;
+    if (op === 'is_empty' || op === 'is_not_empty') {
+        const isEmpty = op === 'is_empty';
+        if (type === 'text') {
+            return isEmpty ? `(${col} IS NULL OR ${col} = '')` : `(${col} IS NOT NULL AND ${col} != '')`;
+        }
+        if (type === 'tags' || type === 'json') {
+            return isEmpty
+                ? `(${col} IS NULL OR ${col} = '[]' OR ${col} = '{}')`
+                : `(${col} IS NOT NULL AND ${col} != '[]' AND ${col} != '{}')`;
+        }
+        return isEmpty ? `${col} IS NULL` : `${col} IS NOT NULL`;
+    }
+    if (op === 'in' || op === 'not_in') {
+        if (!Array.isArray(value) || value.length === 0)
+            return null;
+        const normalizedValues = value
+            .map((v) => normalizeFilterValue(type, v))
+            .filter((v) => v !== null);
+        if (normalizedValues.length === 0)
+            return null;
+        const placeholders = normalizedValues.map(() => '?').join(', ');
+        bindings.push(...normalizedValues);
+        return `${col} ${op === 'in' ? 'IN' : 'NOT IN'} (${placeholders})`;
+    }
+    if (op === 'has_tag' || op === 'has_any_tag' || op === 'has_all_tags') {
+        if (type !== 'tags' && type !== 'json')
+            return null;
+        const tags = (op === 'has_tag' ? [value] : Array.isArray(value) ? value : [value])
+            .map(t => String(t));
+        if (tags.length === 0)
+            return null;
+        // json_each on array → value is the element; on object → key is the property name.
+        // Tags stored as ["photo"] (array) or {"photo":"#3b82f6"} (object) must both match.
+        const tagRef = `CASE json_type(${col}) WHEN 'array' THEN value ELSE key END`;
+        if (op === 'has_tag' || op === 'has_any_tag') {
+            const placeholders = tags.map(() => '?').join(', ');
+            bindings.push(...tags);
+            return `EXISTS (SELECT 1 FROM json_each(${col}) WHERE ${tagRef} IN (${placeholders}))`;
+        }
+        const clauses = tags.map(() => `EXISTS (SELECT 1 FROM json_each(${col}) WHERE ${tagRef} = ?)`);
+        bindings.push(...tags);
+        return `(${clauses.join(' AND ')})`;
+    }
+    const normalized = normalizeFilterValue(type, value);
+    if (normalized === null)
+        return null;
+    if (op === 'eq' || op === 'neq') {
+        const sqlOp = op === 'eq' ? '=' : '!=';
+        bindings.push(normalized);
+        return `${col} ${sqlOp} ?`;
+    }
+    if (op === 'contains' || op === 'not_contains' || op === 'starts_with' || op === 'ends_with') {
+        const sqlOp = op === 'not_contains' ? 'NOT LIKE' : 'LIKE';
+        let pattern = String(value);
+        if (op === 'contains' || op === 'not_contains')
+            pattern = `%${pattern}%`;
+        else if (op === 'starts_with')
+            pattern = `${pattern}%`;
+        else if (op === 'ends_with')
+            pattern = `%${pattern}`;
+        bindings.push(pattern);
+        return `${col} ${sqlOp} ?`;
+    }
+    const mathOps = { gt: '>', gte: '>=', lt: '<', lte: '<=' };
+    if (mathOps[op]) {
+        bindings.push(normalized);
+        return `${col} ${mathOps[op]} ?`;
+    }
+    return null;
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"relations.d.ts","sourceRoot":"","sources":["../../src/engine/relations.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEtC,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAA;IAClB,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAA;IACnB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAA;IACnB,kEAAkE;IAClE,YAAY,EAAE,QAAQ,GAAG,OAAO,CAAA;IAChC,+EAA+E;IAC/E,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,uDAAuD;AACvD,MAAM,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAA;AAErD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,UAAU,CAoBzD"}

package/dist/{schema-mutator.d.ts → engine/schema-mutator.d.ts}

@@ -18,5 +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>;
+    /** 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_]+$`. */
+    fetchRows(table: string, columns: string[]): Promise<Record<string, unknown>[]>;
 }
 //# sourceMappingURL=schema-mutator.d.ts.map

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"seed-ddl-destructive.d.ts","sourceRoot":"","sources":["../../src/engine/seed-ddl-destructive.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAU,UAAU,EAAE,MAAM,YAAY,CAAA;AAkC1D;;;;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/seed-ddl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-ddl.d.ts","sourceRoot":"","sources":["../../src/engine/seed-ddl.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AActC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAanD;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,gBAAgB,EAAE,OAAO,CAAA;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,UAAU,CAqBnF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CA0BnD"}

package/dist/engine/seed-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-registry.d.ts","sourceRoot":"","sources":["../../src/engine/seed-registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAG9C,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,GAAG,IAAI,IAAI,EAAE,CAAA;IAEb;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IAE9B;;;;;OAKG;IACH,kBAAkB,IAAI,IAAI,EAAE,CAAA;IAE5B;;;OAGG;IACH,cAAc,IAAI,IAAI,EAAE,CAAA;IAExB;;;OAGG;IACH,YAAY,IAAI,IAAI,EAAE,CAAA;CACvB;AAID,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IAErC,YAAY,KAAK,EAAE,IAAI,EAAE,EA0BxB;IAED,GAAG,IAAI,IAAI,EAAE,CAEZ;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE7B;IAED,kBAAkB,IAAI,IAAI,EAAE,CAE3B;IAED,cAAc,IAAI,IAAI,EAAE,CAEvB;IAED,YAAY,IAAI,IAAI,EAAE,CAErB;CACF;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;CAAG;AAEzD,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,GAAG,MAAM,CAQjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAsE1E"}

package/dist/{seed-registry.js → engine/seed-registry.js}

@@ -1,6 +1,6 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) 2024–2026 Flavio De Musso
-import { AUTOMATION_RESERVED_WORDS } from './automations-grammar-words.js';
+import { AUTOMATION_RESERVED_WORDS } from '../automations/automations-grammar-words.js';
 const BRANCH_ID_RE = /^br_[A-Za-z0-9]+$/;
 export class SeedRegistry {
     seedMap;

package/dist/engine/seed-types-generator.d.ts

@@ -0,0 +1,10 @@
+import type { Seed, Branch } from './types.js';
+/** slug/alias → PascalCase identifier. 'blog-posts' → 'BlogPosts'. */
+export declare function pascalCase(input: string): string;
+/** Maps a single Branch to its TypeScript type expression (no optional marker). */
+export declare function tsTypeForBranch(branch: Branch): string;
+/** Emits one exported interface for a single Seed. */
+export declare function interfaceForSeed(seed: Seed): string;
+/** Pure entry point. Deterministic: sorts seeds by slug for stable diffs. */
+export declare function generateSeedTypes(seeds: Seed[]): string;
+//# sourceMappingURL=seed-types-generator.d.ts.map

package/dist/engine/seed-types-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-types-generator.d.ts","sourceRoot":"","sources":["../../src/engine/seed-types-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAe9C,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhD;AAMD,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAoCtD;AAWD,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAYnD;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CASvD"}

package/dist/engine/seed-types-generator.js

@@ -0,0 +1,86 @@
+// SPDX-License-Identifier: MIT
+// Copyright (c) 2024–2026 Flavio De Musso
+const HEADER = '// Questo file è generato automaticamente da BeechCMS CLI. Non modificarlo direttamente.\n';
+/** System columns emitted by generateCreateTable — always present, never optional. */
+const SYSTEM_FIELDS = `  id: string\n` +
+    `  slug: string\n` +
+    `  status: 'draft' | 'review' | 'published' | 'archived'\n`;
+const SYSTEM_TIMESTAMPS = `  created_at: number\n` +
+    `  updated_at: number\n`;
+/** slug/alias → PascalCase identifier. 'blog-posts' → 'BlogPosts'. */
+export function pascalCase(input) {
+    return input
+        .split(/[^A-Za-z0-9]+/)
+        .filter(Boolean)
+        .map(w => w.charAt(0).toUpperCase() + w.slice(1))
+        .join('');
+}
+function literalUnion(options) {
+    return options.map(o => `'${o.replace(/'/g, "\\'")}'`).join(' | ');
+}
+/** Maps a single Branch to its TypeScript type expression (no optional marker). */
+export function tsTypeForBranch(branch) {
+    switch (branch.type) {
+        case 'number':
+        case 'date':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'json':
+            return 'unknown';
+        case 'text':
+        case 'richtext':
+        case 'file': {
+            const base = branch.type === 'text' && branch.options?.length
+                ? literalUnion(branch.options)
+                : 'string';
+            return branch.type === 'file' && branch.multiple ? `${base}[]` : base;
+        }
+        case 'tags': {
+            const base = branch.options?.length ? `(${literalUnion(branch.options)})` : 'string';
+            return `${base}[]`;
+        }
+        case 'relation':
+            return branch.multiple ? 'string[]' : 'string';
+        case 'repeater': {
+            const inner = (branch.fields ?? [])
+                .map(f => `${propName(f)}${optional(f)}: ${tsTypeForBranch(f)}`)
+                .join('; ');
+            return `Array<{ ${inner} }>`;
+        }
+        default: {
+            // Exhaustiveness guard — fails the build if BranchType gains a member.
+            const _never = branch.type;
+            return _never;
+        }
+    }
+}
+function optional(branch) {
+    return branch.requiredOnCreate ? '' : '?';
+}
+function propName(branch) {
+    // alias is a valid SQL column; quote only if not a plain identifier.
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(branch.alias) ? branch.alias : `'${branch.alias}'`;
+}
+/** Emits one exported interface for a single Seed. */
+export function interfaceForSeed(seed) {
+    const name = pascalCase(seed.slug);
+    const props = seed.branches
+        .map(b => `  ${propName(b)}${optional(b)}: ${tsTypeForBranch(b)}`)
+        .join('\n');
+    return (`export interface ${name} {\n` +
+        SYSTEM_FIELDS +
+        (props ? props + '\n' : '') +
+        SYSTEM_TIMESTAMPS +
+        `}\n`);
+}
+/** Pure entry point. Deterministic: sorts seeds by slug for stable diffs. */
+export function generateSeedTypes(seeds) {
+    const sorted = [...seeds].sort((a, b) => a.slug.localeCompare(b.slug));
+    const interfaces = sorted.map(interfaceForSeed).join('\n');
+    const registry = `export interface SeedRegistryTypes {\n` +
+        sorted.map(s => `  ${propName({ alias: s.slug })}: ${pascalCase(s.slug)}`).join('\n') +
+        (sorted.length ? '\n' : '') +
+        `}\n`;
+    return `${HEADER}\n${interfaces}\n${registry}`;
+}

package/dist/engine/seed-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-validation.d.ts","sourceRoot":"","sources":["../../src/engine/seed-validation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAMtC;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,QAAyB,CAAA;AAErD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,EAAE,OAAO,CAAA;CACf;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,mBAAmB,EAAE,CAwO5E;AAED,6CAA6C;AAC7C,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAErD"}

package/dist/{seed-validation.js → engine/seed-validation.js}

@@ -1,6 +1,6 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) 2024–2026 Flavio De Musso
-import { AUTOMATION_RESERVED_WORDS } from './automations-grammar-words.js';
+import { AUTOMATION_RESERVED_WORDS } from '../automations/automations-grammar-words.js';
 import { sortSeedsByDependencies } from './seed-registry.js';
 const BRANCH_ID_RE = /^br_[A-Za-z0-9]+$/;
 /**
@@ -216,6 +216,19 @@ export function validateSeedDefinitions(seeds) {
                 result.push({ slug: seed.slug, messages: warnings, fatal: false });
         }
     }
+    // ── Fatal 12: displayNameAlias format validation ───────────────────────────
+    for (const seed of seeds) {
+        if (typeof seed.displayNameAlias !== 'string' || !BRANCH_ALIAS_RE.test(seed.displayNameAlias)) {
+            result.push({
+                slug: seed.slug,
+                messages: [
+                    `displayNameAlias '${seed.displayNameAlias}' is invalid. Expected format ${BRANCH_ALIAS_RE.source} ` +
+                        `(lowercase letter followed by alphanumeric characters or underscores).`,
+                ],
+                fatal: true,
+            });
+        }
+    }
     return result;
 }
 /** Convenience: true iff no fatal issues. */

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

@@ -0,0 +1 @@
+{"version":3,"file":"seeds.d.ts","sourceRoot":"","sources":["../../src/engine/seeds.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEtC;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAM,CAAA;AAErD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,QAI1C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEjD"}

package/dist/engine/serialize.d.ts

@@ -0,0 +1,20 @@
+import type { Branch } from './types.js';
+/**
+ * Serializes a value for writing to the DB.
+ * boolean → 0/1 | date → Unix timestamp | json/tags/richtext/repeater → JSON string
+ *
+ * @param branch The branch definition.
+ * @param value The value to serialize.
+ * @returns The serialized DB value (string, number, or null).
+ */
+export declare function serializeForDb(branch: Branch, value: unknown): string | number | null;
+/**
+ * Deserializes a value read from the DB to its API/JS representation.
+ * 0/1 → boolean | Unix timestamp → ISO 8601 | JSON string → object/array
+ *
+ * @param branch The branch definition.
+ * @param value The raw database value.
+ * @returns The deserialized value.
+ */
+export declare function deserializeFromDb(branch: Branch, value: unknown): unknown;
+//# sourceMappingURL=serialize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/engine/serialize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,MAAM,EAOP,MAAM,YAAY,CAAC;AAmEpB;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAsCrF;AAGD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAmCzE"}

package/dist/engine/serialize.js

@@ -0,0 +1,160 @@
+/**
+ * Checks if a branch represents a multiple asset list field.
+ *
+ * @param branch The branch definition.
+ * @returns True if it's an asset list, false otherwise.
+ */
+function isAssetListBranch(branch) {
+    return branch.type === 'file' && (branch.multiple === true || branch.format === 'asset-list');
+}
+/**
+ * Normalizes an unknown value to a valid HTTP URL string, or null.
+ *
+ * @param value The value to normalize.
+ * @returns The normalized URL string, or null if invalid.
+ */
+function normalizeHttpUrl(value) {
+    if (typeof value !== 'string')
+        return null;
+    const cleaned = value.trim();
+    if (!cleaned)
+        return null;
+    try {
+        const parsed = new URL(cleaned);
+        return parsed.protocol.startsWith('http') ? cleaned : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Safely parses a JSON string, falling back to the raw string on error.
+ *
+ * @param value The string to parse.
+ * @returns The parsed object, or the original string.
+ */
+function parseJsonSafe(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+/**
+ * Normalizes raw asset list values to a flat list of valid URL strings.
+ *
+ * @param rawValue The raw value (string, array, or object) to normalize.
+ * @returns An array of unique normalized URL strings.
+ */
+function normalizeAssetListValue(rawValue) {
+    const input = typeof rawValue === 'string' ? parseJsonSafe(rawValue) : rawValue;
+    const values = Array.isArray(input) ? input : [input];
+    const normalized = [];
+    for (const item of values) {
+        if (item == null)
+            continue;
+        const direct = normalizeHttpUrl(item);
+        if (direct) {
+            normalized.push(direct);
+            continue;
+        }
+        if (typeof item === 'object' && !Array.isArray(item)) {
+            const fromObj = normalizeHttpUrl(item.url);
+            if (fromObj)
+                normalized.push(fromObj);
+        }
+    }
+    return [...new Set(normalized)];
+}
+/**
+ * Serializes a value for writing to the DB.
+ * boolean → 0/1 | date → Unix timestamp | json/tags/richtext/repeater → JSON string
+ *
+ * @param branch The branch definition.
+ * @param value The value to serialize.
+ * @returns The serialized DB value (string, number, or null).
+ */
+export function serializeForDb(branch, value) {
+    if (value === null || value === undefined)
+        return null;
+    switch (branch.type) {
+        case 'boolean':
+            return value ? 1 : 0;
+        case 'json':
+        case 'tags':
+        case 'richtext':
+            return typeof value === 'string' ? value : JSON.stringify(value);
+        case 'date': {
+            if (typeof value === 'number')
+                return value;
+            if (typeof value === 'string') {
+                const d = new Date(value);
+                if (Number.isNaN(d.getTime()))
+                    return null;
+                if (branch.format === 'date') {
+                    const midnight = Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate());
+                    return Math.floor(midnight / 1000);
+                }
+                return Math.floor(d.getTime() / 1000);
+            }
+            return null;
+        }
+        case 'file':
+            if (isAssetListBranch(branch)) {
+                return Array.isArray(value) ? JSON.stringify(value) : typeof value === 'string' ? value : null;
+            }
+            return typeof value === 'string' ? value : null;
+        case 'repeater':
+            return JSON.stringify(Array.isArray(value) ? value : []);
+        default:
+            return typeof value === 'string' ? value : typeof value === 'number' ? value : null;
+    }
+}
+/**
+ * Deserializes a value read from the DB to its API/JS representation.
+ * 0/1 → boolean | Unix timestamp → ISO 8601 | JSON string → object/array
+ *
+ * @param branch The branch definition.
+ * @param value The raw database value.
+ * @returns The deserialized value.
+ */
+export function deserializeFromDb(branch, value) {
+    if (branch.type === 'repeater') {
+        if (typeof value !== 'string' || value.length === 0)
+            return [];
+        const parsed = parseJsonSafe(value);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    if (value === null || value === undefined)
+        return null;
+    switch (branch.type) {
+        case 'boolean':
+            return value === 1 || value === true;
+        case 'json':
+        case 'tags':
+        case 'richtext': {
+            if (typeof value === 'string') {
+                try {
+                    return JSON.parse(value);
+                }
+                catch {
+                    return value;
+                }
+            }
+            return value;
+        }
+        case 'date': {
+            if (typeof value !== 'number')
+                return null;
+            const d = new Date(value * 1000);
+            return branch.format === 'date' ? d.toISOString().slice(0, 10) : d.toISOString();
+        }
+        case 'file':
+            if (isAssetListBranch(branch))
+                return normalizeAssetListValue(value);
+            return typeof value === 'string' ? value : null;
+        default:
+            return value;
+    }
+}