@beechcms/core 0.6.0-preview.4 → 0.6.0

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,CAqE5F;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"}