@rangka/core 0.0.1

package/dist/db/diff-engine.d.ts

@@ -0,0 +1,53 @@
+import type { DesiredState, ActualState, DdlOperation } from './types.js';
+/**
+ * Compares a desired schema state against the actual database state and
+ * produces a sorted list of DDL operations needed to reconcile the two.
+ */
+export declare class DiffEngine {
+    /** Compute the full set of DDL operations to bring `actual` in line with `desired`. */
+    diff(desired: DesiredState, actual: ActualState): DdlOperation[];
+    /** Build all operations needed to create a brand new table (table + indexes + foreign keys + check constraints). */
+    private buildNewTableOperations;
+    /** Generate the CREATE TABLE DDL for a table definition. */
+    private buildCreateTableOp;
+    /** Compare an existing table against its desired definition and produce update operations. */
+    private diffTable;
+    /** Detect added columns, type changes, and orphaned columns. */
+    private diffColumns;
+    /** Detect indexes that need to be created. */
+    private diffIndexes;
+    /** Detect foreign keys that need to be added. */
+    private diffForeignKeys;
+    /** Detect CHECK constraints that need to be added. */
+    private diffCheckConstraints;
+    /** Generate an ADD COLUMN operation. */
+    private buildAddColumnOp;
+    /** Generate an ALTER COLUMN TYPE operation. */
+    private buildAlterColumnTypeOp;
+    /** Generate a CREATE INDEX operation. */
+    private buildCreateIndexOp;
+    /** Generate an ADD FOREIGN KEY constraint operation. */
+    private buildAddForeignKeyOp;
+    /** Generate an ADD CHECK CONSTRAINT operation. */
+    private buildAddCheckConstraintOp;
+    /** Produce a warning operation for a table that exists in the DB but not in the schema. */
+    private warnOrphanedTable;
+    /** Produce a warning operation for a column that exists in the DB but not in the schema. */
+    private warnOrphanedColumn;
+    /** Convert a column definition to its SQL fragment (e.g. `"name" TEXT NOT NULL DEFAULT 'x'`). */
+    private columnToSql;
+    /** Check whether the column type has changed (case-insensitive comparison). */
+    private hasColumnTypeChanged;
+    /**
+     * Sort operations so they execute in a safe dependency order:
+     * 1. CREATE TABLE (tables must exist before columns/indexes reference them)
+     * 2. ADD COLUMN
+     * 3. ALTER COLUMN TYPE
+     * 4. CREATE INDEX (columns must exist first)
+     * 5. ADD FOREIGN KEY (referenced tables must exist first)
+     * 6. ADD CHECK CONSTRAINT (columns must exist first)
+     * 7. Destructive operations (always last, require explicit opt-in)
+     */
+    private sortByDependencyOrder;
+}
+//# sourceMappingURL=diff-engine.d.ts.map

package/dist/db/diff-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-engine.d.ts","sourceRoot":"","sources":["../../src/db/diff-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EAWb,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,qBAAa,UAAU;IAGrB,uFAAuF;IACvF,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,GAAG,YAAY,EAAE;IA2BhE,oHAAoH;IACpH,OAAO,CAAC,uBAAuB;IAQ/B,4DAA4D;IAC5D,OAAO,CAAC,kBAAkB;IAuB1B,8FAA8F;IAC9F,OAAO,CAAC,SAAS;IAajB,gEAAgE;IAChE,OAAO,CAAC,WAAW;IA4BnB,8CAA8C;IAC9C,OAAO,CAAC,WAAW;IAYnB,iDAAiD;IACjD,OAAO,CAAC,eAAe;IAYvB,sDAAsD;IACtD,OAAO,CAAC,oBAAoB;IAc5B,wCAAwC;IACxC,OAAO,CAAC,gBAAgB;IAMxB,+CAA+C;IAC/C,OAAO,CAAC,sBAAsB;IAK9B,yCAAyC;IACzC,OAAO,CAAC,kBAAkB;IAQ1B,wDAAwD;IACxD,OAAO,CAAC,oBAAoB;IAK5B,kDAAkD;IAClD,OAAO,CAAC,yBAAyB;IAUjC,2FAA2F;IAC3F,OAAO,CAAC,iBAAiB;IAUzB,4FAA4F;IAC5F,OAAO,CAAC,kBAAkB;IAY1B,iGAAiG;IACjG,OAAO,CAAC,WAAW;IAOnB,+EAA+E;IAC/E,OAAO,CAAC,oBAAoB;IAM5B;;;;;;;;;OASG;IACH,OAAO,CAAC,qBAAqB;CAgD9B"}

package/dist/db/diff-engine.js

@@ -0,0 +1,234 @@
+/**
+ * Compares a desired schema state against the actual database state and
+ * produces a sorted list of DDL operations needed to reconcile the two.
+ */
+export class DiffEngine {
+    // --- Public API ---
+    /** Compute the full set of DDL operations to bring `actual` in line with `desired`. */
+    diff(desired, actual) {
+        const operations = [];
+        const actualTablesByName = new Map(actual.tables.map((t) => [t.name, t]));
+        // Generate operations for each desired table (create or update)
+        for (const desiredTable of desired.tables) {
+            const existingTable = actualTablesByName.get(desiredTable.name);
+            if (!existingTable) {
+                operations.push(...this.buildNewTableOperations(desiredTable));
+            }
+            else {
+                operations.push(...this.diffTable(desiredTable, existingTable));
+            }
+        }
+        // Flag tables that exist in the database but not in the schema
+        for (const existingTable of actual.tables) {
+            const stillDesired = desired.tables.find((t) => t.name === existingTable.name);
+            if (!stillDesired) {
+                operations.push(this.warnOrphanedTable(existingTable.name));
+            }
+        }
+        return this.sortByDependencyOrder(operations);
+    }
+    // --- Table creation ---
+    /** Build all operations needed to create a brand new table (table + indexes + foreign keys + check constraints). */
+    buildNewTableOperations(table) {
+        return [
+            this.buildCreateTableOp(table),
+            ...table.indexes.map((idx) => this.buildCreateIndexOp(idx)),
+            ...table.foreignKeys.map((fk) => this.buildAddForeignKeyOp(table.name, fk)),
+        ];
+    }
+    /** Generate the CREATE TABLE DDL for a table definition. */
+    buildCreateTableOp(table) {
+        const columnClauses = table.columns.map((col) => this.columnToSql(col));
+        const primaryKeyColumn = table.columns.find((c) => c.primaryKey);
+        if (primaryKeyColumn) {
+            columnClauses.push(`PRIMARY KEY (${primaryKeyColumn.name})`);
+        }
+        for (const chk of table.checkConstraints) {
+            columnClauses.push(`CONSTRAINT "${chk.name}" CHECK (${chk.expression})`);
+        }
+        const sql = `CREATE TABLE "${table.name}" (\n  ${columnClauses.join(',\n  ')}\n)`;
+        return {
+            type: 'CREATE_TABLE',
+            table: table.name,
+            sql,
+            destructive: false,
+        };
+    }
+    // --- Table diffing (existing table vs desired) ---
+    /** Compare an existing table against its desired definition and produce update operations. */
+    diffTable(desired, actual) {
+        const operations = [];
+        operations.push(...this.diffColumns(desired.name, desired.columns, actual.columns));
+        operations.push(...this.diffIndexes(desired.name, desired.indexes, actual.indexes));
+        operations.push(...this.diffForeignKeys(desired.name, desired.foreignKeys, actual.foreignKeys));
+        operations.push(...this.diffCheckConstraints(desired.name, desired.checkConstraints, actual.checkConstraints));
+        return operations;
+    }
+    /** Detect added columns, type changes, and orphaned columns. */
+    diffColumns(tableName, desiredColumns, actualColumns) {
+        const operations = [];
+        const actualColumnsByName = new Map(actualColumns.map((c) => [c.name, c]));
+        const desiredColumnNames = new Set(desiredColumns.map((c) => c.name));
+        for (const desiredCol of desiredColumns) {
+            const existingCol = actualColumnsByName.get(desiredCol.name);
+            if (!existingCol) {
+                operations.push(this.buildAddColumnOp(tableName, desiredCol));
+            }
+            else if (this.hasColumnTypeChanged(desiredCol, existingCol)) {
+                operations.push(this.buildAlterColumnTypeOp(tableName, desiredCol));
+            }
+        }
+        // Flag columns that exist in the DB but are no longer in the schema
+        for (const existingCol of actualColumns) {
+            if (!desiredColumnNames.has(existingCol.name)) {
+                operations.push(this.warnOrphanedColumn(tableName, existingCol.name));
+            }
+        }
+        return operations;
+    }
+    /** Detect indexes that need to be created. */
+    diffIndexes(tableName, desiredIndexes, actualIndexes) {
+        const existingIndexNames = new Set(actualIndexes.map((i) => i.name));
+        return desiredIndexes
+            .filter((idx) => !existingIndexNames.has(idx.name))
+            .map((idx) => this.buildCreateIndexOp(idx));
+    }
+    /** Detect foreign keys that need to be added. */
+    diffForeignKeys(tableName, desiredForeignKeys, actualForeignKeys) {
+        const existingFkNames = new Set(actualForeignKeys.map((fk) => fk.name));
+        return desiredForeignKeys
+            .filter((fk) => !existingFkNames.has(fk.name))
+            .map((fk) => this.buildAddForeignKeyOp(tableName, fk));
+    }
+    /** Detect CHECK constraints that need to be added. */
+    diffCheckConstraints(tableName, desiredConstraints, actualConstraints) {
+        const existingNames = new Set(actualConstraints.map((c) => c.name));
+        return desiredConstraints
+            .filter((chk) => !existingNames.has(chk.name))
+            .map((chk) => this.buildAddCheckConstraintOp(tableName, chk));
+    }
+    // --- DDL operation builders ---
+    /** Generate an ADD COLUMN operation. */
+    buildAddColumnOp(tableName, col) {
+        const colSql = this.columnToSql(col);
+        const sql = `ALTER TABLE "${tableName}" ADD COLUMN ${colSql}`;
+        return { type: 'ADD_COLUMN', table: tableName, sql, destructive: false };
+    }
+    /** Generate an ALTER COLUMN TYPE operation. */
+    buildAlterColumnTypeOp(tableName, col) {
+        const sql = `ALTER TABLE "${tableName}" ALTER COLUMN "${col.name}" TYPE ${col.type}`;
+        return { type: 'ALTER_COLUMN_TYPE', table: tableName, sql, destructive: false };
+    }
+    /** Generate a CREATE INDEX operation. */
+    buildCreateIndexOp(idx) {
+        const uniquePrefix = idx.unique ? 'UNIQUE ' : '';
+        const quotedColumns = idx.columns.map((c) => `"${c}"`).join(', ');
+        const whereClause = idx.where ? ` WHERE ${idx.where}` : '';
+        const sql = `CREATE ${uniquePrefix}INDEX "${idx.name}" ON "${idx.table}" (${quotedColumns})${whereClause}`;
+        return { type: 'CREATE_INDEX', table: idx.table, sql, destructive: false };
+    }
+    /** Generate an ADD FOREIGN KEY constraint operation. */
+    buildAddForeignKeyOp(tableName, fk) {
+        const sql = `ALTER TABLE "${tableName}" ADD CONSTRAINT "${fk.name}" FOREIGN KEY ("${fk.column}") REFERENCES "${fk.referencedTable}" ("${fk.referencedColumn}")`;
+        return { type: 'ADD_FOREIGN_KEY', table: tableName, sql, destructive: false };
+    }
+    /** Generate an ADD CHECK CONSTRAINT operation. */
+    buildAddCheckConstraintOp(tableName, chk) {
+        const sql = `ALTER TABLE "${tableName}" ADD CONSTRAINT "${chk.name}" CHECK (${chk.expression})`;
+        return { type: 'ADD_CHECK_CONSTRAINT', table: tableName, sql, destructive: false };
+    }
+    // --- Orphan warnings (destructive markers) ---
+    /** Produce a warning operation for a table that exists in the DB but not in the schema. */
+    warnOrphanedTable(tableName) {
+        return {
+            type: 'DROP_TABLE',
+            table: tableName,
+            sql: `-- WARNING: Table "${tableName}" exists in database but not in schema (not dropped without --allow-destructive)`,
+            destructive: true,
+            detail: `Orphaned table: ${tableName}`,
+        };
+    }
+    /** Produce a warning operation for a column that exists in the DB but not in the schema. */
+    warnOrphanedColumn(tableName, columnName) {
+        return {
+            type: 'DROP_COLUMN',
+            table: tableName,
+            sql: `-- WARNING: Column "${tableName}"."${columnName}" exists in database but not in schema (not dropped without --allow-destructive)`,
+            destructive: true,
+            detail: `Orphaned column: ${tableName}.${columnName}`,
+        };
+    }
+    // --- SQL helpers ---
+    /** Convert a column definition to its SQL fragment (e.g. `"name" TEXT NOT NULL DEFAULT 'x'`). */
+    columnToSql(col) {
+        let sql = `"${col.name}" ${col.type}`;
+        if (!col.nullable && !col.primaryKey)
+            sql += ' NOT NULL';
+        if (col.defaultValue !== undefined)
+            sql += ` DEFAULT ${col.defaultValue}`;
+        return sql;
+    }
+    /** Check whether the column type has changed (case-insensitive comparison). */
+    hasColumnTypeChanged(desired, actual) {
+        return desired.type.toUpperCase() !== actual.type.toUpperCase();
+    }
+    // --- Operation ordering ---
+    /**
+     * Sort operations so they execute in a safe dependency order:
+     * 1. CREATE TABLE (tables must exist before columns/indexes reference them)
+     * 2. ADD COLUMN
+     * 3. ALTER COLUMN TYPE
+     * 4. CREATE INDEX (columns must exist first)
+     * 5. ADD FOREIGN KEY (referenced tables must exist first)
+     * 6. ADD CHECK CONSTRAINT (columns must exist first)
+     * 7. Destructive operations (always last, require explicit opt-in)
+     */
+    sortByDependencyOrder(operations) {
+        const createTables = [];
+        const addColumns = [];
+        const alterColumns = [];
+        const createIndexes = [];
+        const addForeignKeys = [];
+        const addCheckConstraints = [];
+        const destructive = [];
+        for (const op of operations) {
+            if (op.destructive) {
+                destructive.push(op);
+            }
+            else {
+                switch (op.type) {
+                    case 'CREATE_TABLE':
+                        createTables.push(op);
+                        break;
+                    case 'ADD_COLUMN':
+                        addColumns.push(op);
+                        break;
+                    case 'ALTER_COLUMN_TYPE':
+                        alterColumns.push(op);
+                        break;
+                    case 'CREATE_INDEX':
+                        createIndexes.push(op);
+                        break;
+                    case 'ADD_FOREIGN_KEY':
+                        addForeignKeys.push(op);
+                        break;
+                    case 'ADD_CHECK_CONSTRAINT':
+                        addCheckConstraints.push(op);
+                        break;
+                    default:
+                        addColumns.push(op);
+                }
+            }
+        }
+        return [
+            ...createTables,
+            ...addColumns,
+            ...alterColumns,
+            ...createIndexes,
+            ...addForeignKeys,
+            ...addCheckConstraints,
+            ...destructive,
+        ];
+    }
+}
+//# sourceMappingURL=diff-engine.js.map

package/dist/db/diff-engine.js.map

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

package/dist/db/field-mapper.d.ts

@@ -0,0 +1,22 @@
+import type { ResolvedModel } from '../schema/types.js';
+import type { ColumnDefinition, ForeignKeyDefinition, CheckConstraintDefinition, TableDefinition } from './types.js';
+/**
+ * The complete set of database artifacts produced when mapping a model's fields to columns.
+ */
+export interface FieldMappingResult {
+    columns: ColumnDefinition[];
+    foreignKeys: ForeignKeyDefinition[];
+    checkConstraints: CheckConstraintDefinition[];
+    extraTables: TableDefinition[];
+}
+/**
+ * Convert a dot-separated qualified model name (e.g. "core.User") to a
+ * flat table name using double-underscore as separator (e.g. "core__User").
+ */
+export declare function modelToTableName(qualifiedName: string): string;
+/**
+ * Map all fields of a resolved model into database column definitions,
+ * foreign keys, check constraints, and any extra junction/closure tables.
+ */
+export declare function mapFieldsToColumns(model: ResolvedModel): FieldMappingResult;
+//# sourceMappingURL=field-mapper.d.ts.map

package/dist/db/field-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-mapper.d.ts","sourceRoot":"","sources":["../../src/db/field-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,EACzB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,gBAAgB,EAAE,yBAAyB,EAAE,CAAC;IAC9C,WAAW,EAAE,eAAe,EAAE,CAAC;CAChC;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,kBAAkB,CAqC3E"}