@beechcms/core 0.9.0 → 0.9.2

package/dist/engine/serialize.d.ts

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

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

@@ -1,160 +0,0 @@
-/**
- * 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;
-    }
-}

package/dist/engine.d.ts

@@ -1,144 +0,0 @@
-/**
- * Botanical Engine: Schema Compiler + Query Builder.
- *
- * In v0.4.0 each Seed has a dedicated SQL table (`content_{slug}`) with
- * real typed columns. This module generates the DDL and builds parameterized queries.
- * It does not know about HTTP, auth, or UI — it's a pure TypeScript library.
- */
-import type { Seed, Branch, SelectOptions, ParameterizedQuery } from './types.js';
-export declare function indexableSearchBranches(seed: Seed): Branch[];
-/**
- * Generates `CREATE TABLE IF NOT EXISTS content_{slug}` with system columns
- * + one column per Branch. Pure function: same Seed → same SQL.
- */
-export declare function generateCreateTable(seed: Seed): string;
-/**
- * Generates the drafts table `content_{slug}_drafts` for Seeds with `allowDrafts: true`.
- * All branch columns are nullable (drafts are partial).
- * Returns null if the Seed does not have `allowDrafts: true`.
- */
-export declare function generateDraftTable(seed: Seed): string | null;
-/**
- * Generates `ALTER TABLE content_{slug} ADD COLUMN {alias} {type}`.
- * New columns are always nullable (SQLite limit on ALTER TABLE).
- */
-export declare function generateAddColumn(seed: Seed, branch: Branch): string;
-/**
- * Generates B-tree indexes for status, created_at and every filterable Branch
- * with an indexable type (text, number, date, boolean).
- */
-export declare function generateIndexes(seed: Seed): string[];
-/**
- * Generates the FTS5 virtual table for indexable text/richtext Branches.
- * Returns null if the Seed has no branches with search enabled.
- */
-export declare function generateFtsTable(seed: Seed): string | null;
-/**
- * Generates the 3 SQLite triggers (insert/update/delete) that keep the FTS
- * automatically synchronized — eliminates the need for manual syncFts.
- * Returns an empty array if the Seed has no indexable branches.
- */
-export declare function generateFtsTriggers(seed: Seed): string[];
-/**
- * Builds a parameterized SELECT on `content_{slug}`.
- * Never uses json_extract — every column is a real column.
- * Unknown columns in filters/orderBy are ignored (fail-closed).
- */
-export declare function buildSelectQuery(seed: Seed, options?: SelectOptions): ParameterizedQuery;
-export interface SchemaColumn {
-    name: string;
-    sqlType: 'TEXT' | 'REAL' | 'INTEGER';
-    notNull: boolean;
-    isPk: boolean;
-}
-/**
- * Returns the list of expected columns for a Seed's table.
- * Used by `beech seed:load --diff` to compare current vs expected schema.
- */
-export declare function getExpectedColumns(seed: Seed): SchemaColumn[];
-/**
- * Serializes a value for writing to the DB.
- * boolean → 0/1 | date → Unix timestamp | json/asset-list → JSON string
- */
-export declare function serializeForDb(branch: Branch, value: unknown): string | number | null;
-/**
- * Returns the junction table name for a many-to-many relation branch.
- * Format: `rel_<seedSlug>_<branchAlias>`.
- */
-export declare function junctionTableName(seedSlug: string, branchAlias: string): string;
-/**
- * Generates `CREATE TABLE IF NOT EXISTS rel_<seed>_<alias>` for a multi-relation
- * branch. The parent FK always cascades (parent lifecycle owns the edge);
- * the target FK uses `branch.onDelete` (default CASCADE).
- *
- * @throws {Error} when called on a non-multi-relation branch
- * @throws {Error} when `branch.targetSeed` is missing
- */
-export declare function generateJunctionTable(seed: Seed, branch: Branch): string;
-/**
- * Generates the two B-tree indexes for a junction table:
- * one on `parent_id` (list entries by parent) and one on `target_id`
- * (cascade checks from target side).
- */
-export declare function generateJunctionIndexes(seed: Seed, branch: Branch): string[];
-/**
- * Generates the drafts junction table `rel_<seed>_<alias>_drafts` for a
- * many-to-many relation branch. Note: no FK on `target_id` — targets may be
- * deleted between draft save and publish; the FK would be wrong here.
- * Returns null when `seed.allowDrafts` is falsy.
- */
-export declare function generateJunctionDraftTable(seed: Seed, branch: Branch): string | null;
-/**
- * Returns every `DROP TABLE IF EXISTS` needed to fully remove a content type:
- * the main `content_{slug}` table, its `fts_{slug}` virtual table, the
- * `content_{slug}_drafts` mirror (when drafts are enabled), and each
- * multi-relation junction table `rel_{slug}_{alias}` (+ its `_drafts` mirror).
- *
- * FTS triggers reference the main table; dropping the main table also drops
- * its triggers in SQLite, but we drop the FTS table explicitly so no orphaned
- * virtual table survives. Order: junction (children) → drafts → fts → main.
- */
-export declare function generateDropTable(seed: Seed): string[];
-/**
- * Returns the `DROP COLUMN` statements for removing a single field.
- *
- * - For a multi-relation branch (no column on the parent table) it drops the
- *   junction table `rel_{slug}_{alias}` (+ `_drafts`) instead.
- * - For a normal branch it drops the column from `content_{slug}` and, when
- *   drafts are enabled, the mirror column from `content_{slug}_drafts`.
- * - For an orphan column (no matching branch in the definition) it falls back
- *   to a plain `ALTER TABLE … DROP COLUMN`, never touching drafts.
- *
- * Callers must rebuild FTS separately (planFtsRebuild) when the dropped column
- * was searchable, since SQLite cannot ALTER an fts5 table's columns.
- */
-export declare function generateDropColumn(seed: Seed, alias: string): string[];
-/**
- * Returns the `RENAME COLUMN` statements for renaming a field's alias while
- * keeping the stable `branch.id`. Renames the column on `content_{slug}` and,
- * when drafts are enabled, the mirror column on `content_{slug}_drafts`.
- *
- * For a multi-relation branch the alias is part of the junction table name, so
- * the junction table (+ `_drafts`) is renamed instead of a column.
- *
- * Callers must rebuild FTS separately (planFtsRebuild) when the renamed column
- * was searchable.
- */
-export declare function generateRenameColumn(seed: Seed, from: string, to: string): string[];
-/**
- * Returns the add/copy/drop/rename statements that change a column's SQL type
- * in place, preserving data via `CAST`. This is the documented simpler
- * alternative to SQLite's full 12-step table rebuild.
- *
- * The `branch` passed in is the *target* definition (already carrying the new
- * `type`); its SQL type is read from BRANCH_TYPE_SQL. Multi-relation branches
- * have no column to retype and are rejected. Mirrors the change onto the drafts
- * table when drafts are enabled. Callers rebuild FTS separately when needed.
- */
-export declare function generateRetypeColumn(seed: Seed, branch: Branch): string[];
-/**
- * Deserializes a value read from the DB for the API response.
- * 0/1 → boolean | Unix timestamp → ISO 8601 | JSON string → object
- */
-export declare function deserializeFromDb(branch: Branch, value: unknown): unknown;
-//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,IAAI,EACJ,MAAM,EAKN,aAAa,EACb,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAsCnB,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAI5D;AAkED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CA0BtD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAyB5D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAuBpD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAc1D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAgCxD;AAID;;;;GAIG;AAGH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,aAAkB,GAAG,kBAAkB,CAsF5F;AAgHD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,OAAO,CAAA;CACd;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,YAAY,EAAE,CAiB7D;AAID;;;GAGG;AAEH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAwCrF;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAkBxE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAM5E;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAapF;AAcD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CA0BtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBnF;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBzE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAqCzE"}