@beechcms/core 0.8.1 → 0.9.1

package/dist/engine/ddl.d.ts

@@ -1,193 +0,0 @@
-import type { Seed, Branch } from './types.js';
-/**
- * Helper function to determine if a branch requires a blind index column.
- * Returns true if storage classification is 'encrypt' and filtering is not explicitly disabled.
- */
-export declare function hasBlindIndex(branch: Branch): boolean;
-/**
- * System-defined columns that exist on all content tables.
- */
-export declare const SYSTEM_COLUMNS: Set<string>;
-/**
- * Returns the SQL table name for a given Seed.
- *
- * @param seed The seed definition.
- * @returns The table name.
- */
-export declare function tableName(seed: Seed): string;
-/**
- * Returns the FTS (Full-Text Search) virtual table name for a given Seed.
- *
- * @param seed The seed definition.
- * @returns The FTS table name.
- */
-export declare function ftsTableName(seed: Seed): string;
-/**
- * Returns the vector table name for a given Seed.
- *
- * @param seed The seed definition.
- * @returns The vector table name.
- */
-export declare function vectorTableName(seed: Seed): string;
-/**
- * Determines whether a column is valid for a given Seed (either system column or branch alias).
- *
- * @param seed The seed definition.
- * @param col The column name to check.
- * @returns True if the column is valid, false otherwise.
- */
-export declare function isValidColumn(seed: Seed, col: string): boolean;
-/**
- * Filters the branches of a Seed to return only the ones that are indexable for full-text search.
- *
- * @param seed The seed definition.
- * @returns An array of indexable branches.
- */
-export declare function indexableSearchBranches(seed: Seed): Branch[];
-/**
- * Generates the SQL `CREATE TABLE IF NOT EXISTS content_{slug}` statement
- * with system columns and one column per branch.
- *
- * @param seed The seed definition.
- * @returns The CREATE TABLE SQL statement.
- */
-export declare function generateCreateTable(seed: Seed): string;
-/**
- * Generates the SQL `CREATE TABLE IF NOT EXISTS content_{slug}_drafts` statement
- * for seeds that allow drafts.
- *
- * @param seed The seed definition.
- * @returns The draft table CREATE TABLE SQL statement, or null if drafts are disabled.
- */
-export declare function generateDraftTable(seed: Seed): string | null;
-/**
- * Generates the SQL `ALTER TABLE content_{slug} ADD COLUMN {alias} {type}` statement.
- *
- * @param seed The seed definition.
- * @param branch The branch definition for the new column.
- * @returns The ALTER TABLE SQL statement.
- */
-export declare function generateAddColumn(seed: Seed, branch: Branch): string;
-/**
- * Generates SQL index statements for system fields (status, created_at)
- * and indexable branch columns.
- *
- * @param seed The seed definition.
- * @returns An array of CREATE INDEX SQL statements.
- */
-export declare function generateIndexes(seed: Seed): string[];
-/**
- * Generates the FTS5 virtual table definition for indexable text/richtext branches.
- *
- * @param seed The seed definition.
- * @returns The CREATE VIRTUAL TABLE SQL statement, or null if no branches are indexable.
- */
-export declare function generateFtsTable(seed: Seed): string | null;
-/**
- * Generates FTS5 triggers (insert, update, delete) to keep the FTS virtual table synchronized.
- *
- * @param seed The seed definition.
- * @returns An array of CREATE TRIGGER SQL statements.
- */
-export declare function generateFtsTriggers(seed: Seed): string[];
-/**
- * Generates the SQL `CREATE TABLE IF NOT EXISTS vector_{slug}` statement
- * for indexable text/richtext branches.
- *
- * @param seed The seed definition.
- * @returns The CREATE TABLE SQL statement, or null if no branches are indexable.
- */
-export declare function generateVectorTable(seed: Seed): string | null;
-/**
- * Expected database schema column interface.
- */
-export interface SchemaColumn {
-    /** Column name. */
-    name: string;
-    /** SQLite storage type. */
-    sqlType: 'TEXT' | 'REAL' | 'INTEGER';
-    /** Whether the column is NOT NULL. */
-    notNull: boolean;
-    /** Whether the column is the PRIMARY KEY. */
-    isPk: boolean;
-}
-/**
- * Returns the list of expected columns for a Seed's table.
- * Used to compare current vs expected schema (diffing).
- *
- * @param seed The seed definition.
- * @returns The array of expected schema columns.
- */
-export declare function getExpectedColumns(seed: Seed): SchemaColumn[];
-/**
- * Returns the junction table name for a many-to-many relation branch.
- * Format: `rel_<seedSlug>_<branchAlias>`.
- *
- * @param seedSlug The slug of the parent Seed.
- * @param branchAlias The alias of the relation branch.
- * @returns The junction table name.
- */
-export declare function junctionTableName(seedSlug: string, branchAlias: string): string;
-/**
- * Generates `CREATE TABLE IF NOT EXISTS rel_<seed>_<alias>` statement for a multi-relation branch.
- *
- * @param seed The parent seed definition.
- * @param branch The multi-relation branch definition.
- * @throws {Error} If called on a non-multi-relation branch or if `targetSeed` is missing.
- * @returns The CREATE TABLE SQL statement.
- */
-export declare function generateJunctionTable(seed: Seed, branch: Branch): string;
-/**
- * Generates the two B-tree indexes for a junction table:
- * one on `parent_id` (listing entries by parent) and one on `target_id` (handling cascade checks from target side).
- *
- * @param seed The parent seed definition.
- * @param branch The multi-relation branch definition.
- * @returns An array of CREATE INDEX SQL statements.
- */
-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.
- *
- * @param seed The parent seed definition.
- * @param branch The multi-relation branch definition.
- * @returns The CREATE TABLE SQL statement, or null if drafts are disabled.
- */
-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 table, the drafts table (if drafts enabled), full-text search table/triggers, and junction tables.
- *
- * @param seed The seed definition.
- * @returns An array of DROP TABLE / DROP TRIGGER SQL statements.
- */
-export declare function generateDropTable(seed: Seed): string[];
-/**
- * Returns the `DROP COLUMN` SQL statements for removing a single field.
- * Drops the junction table for multi-relations, or alters the tables to drop the column.
- *
- * @param seed The seed definition.
- * @param alias The alias of the branch to drop.
- * @returns An array of SQL statements.
- */
-export declare function generateDropColumn(seed: Seed, alias: string): string[];
-/**
- * Returns the `RENAME COLUMN` SQL statements for renaming a field's alias.
- * For a multi-relation branch, renames the junction table (+ drafts junction table) instead.
- *
- * @param seed The seed definition.
- * @param from The old alias.
- * @param to The new alias.
- * @returns An array of SQL statements.
- */
-export declare function generateRenameColumn(seed: Seed, from: string, to: string): string[];
-/**
- * Returns the statements that change a column's SQL type in place using CAST, bypassing SQLite rebuild limitations.
- *
- * @param seed The seed definition.
- * @param branch The target branch definition (carrying the new type).
- * @throws {Error} If called on a multi-relation branch.
- * @returns An array of SQL statements.
- */
-export declare function generateRetypeColumn(seed: Seed, branch: Branch): string[];
-//# sourceMappingURL=ddl.d.ts.map

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

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