@rudderjs/database 1.1.0 → 1.2.1

package/dist/native/schema/column.js.map

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

package/dist/native/schema/ddl-compiler.d.ts

@@ -0,0 +1,34 @@
+import { type Dialect } from '../dialect.js';
+import type { CompiledQuery } from '../compiler.js';
+import type { Blueprint } from './blueprint.js';
+import type { AlterBlueprint } from './alter-blueprint.js';
+import type { ColumnDefinition } from './column.js';
+/** A column's `"name" TYPE [NOT NULL] [DEFAULT …]` spec, no inline primary key.
+ *  Exported for the table-rebuild path (7.4b), which assembles a shadow
+ *  `CREATE TABLE` from a mix of changed columns and preserved (introspected) ones. */
+export declare function compileColumnSpec(column: ColumnDefinition, dialect: Dialect): string;
+/**
+ * Compile `Schema.create(...)` to a `CREATE TABLE` plus any `CREATE INDEX`
+ * statements (in that order). Each is a {@link CompiledQuery} with empty
+ * bindings — DDL carries no bound parameters.
+ */
+export declare function compileCreateTable(blueprint: Blueprint, dialect: Dialect): CompiledQuery[];
+/** Compile `Schema.drop(...)` / `Schema.dropIfExists(...)`. */
+export declare function compileDropTable(table: string, opts: {
+    ifExists?: boolean;
+}, dialect: Dialect): CompiledQuery;
+/** Compile `Schema.rename(from, to)`. */
+export declare function compileRenameTable(from: string, to: string, dialect: Dialect): CompiledQuery;
+/**
+ * Compile `Schema.table(...)` to the `ALTER TABLE` / `CREATE INDEX` / `DROP
+ * INDEX` statements its intents require, in dependency order: rename columns →
+ * add columns → add indexes → drop indexes → drop columns. Each is emitted as a
+ * separate statement (SQLite has no multi-clause `ALTER TABLE`).
+ *
+ * SQLite ADD COLUMN can't add a PRIMARY KEY column, and a NOT NULL column must
+ * carry a default — both are rejected here with a clear message rather than
+ * letting SQLite throw a cryptic one. Changing an existing column's type
+ * (`.change()`) needs the table-rebuild dance and is deferred to 7.4b.
+ */
+export declare function compileAlterTable(blueprint: AlterBlueprint, dialect: Dialect): CompiledQuery[];
+//# sourceMappingURL=ddl-compiler.d.ts.map

package/dist/native/schema/ddl-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddl-compiler.d.ts","sourceRoot":"","sources":["../../../src/native/schema/ddl-compiler.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,gBAAgB,CAAA;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAA0C,MAAM,aAAa,CAAA;AAyE3F;;sFAEsF;AACtF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAEpF;AA8ED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,EAAE,CA2C1F;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CAK7G;AAED,yCAAyC;AACzC,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CAE5F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,EAAE,CAuI9F"}

package/dist/native/schema/ddl-compiler.js

@@ -0,0 +1,352 @@
+// ─── DDL compiler (pure) ───────────────────────────────────
+//
+// PURE: turns a {@link Blueprint} into `CREATE TABLE` (+ `CREATE INDEX`)
+// statements through a {@link Dialect}. No driver, no `node:`, no I/O — the
+// portable half of the schema builder, the DDL counterpart to the read/write
+// query compiler. The dialect owns per-flavor column *types*
+// (`dialect.columnTypeSql`); this module owns statement *structure* (column
+// lists, shared modifiers, table constraints, indexes) so it's identical across
+// SQLite / Postgres / MySQL.
+//
+// Identifiers (table / column / index names) are validated + quoted by the
+// dialect — the security gate (parent plan rule 2). DDL `DEFAULT` values are the
+// one exception to "always bind": most databases reject bound parameters in DDL,
+// so defaults are rendered as escaped literals. That's safe here because
+// migration authors — not end users — write them.
+import { Expression } from '@rudderjs/contracts';
+import { quoteSqlString } from '../dialect.js';
+import { NativeOrmError, NativeNotImplementedError } from '../errors.js';
+/** Render a column's DEFAULT value as a SQL literal (DDL can't bind). Only the
+ *  literal-able types are allowed; a Date/object/function default throws so the
+ *  failure is at migrate time, not a silent `[object Object]` in the schema. An
+ *  `Expression` (`raw('…')`) is spliced verbatim — the escape hatch for function
+ *  defaults like `raw('gen_random_uuid()')`. */
+function defaultLiteral(value, dialect) {
+    if (value === null)
+        return 'NULL';
+    // raw(...) default — splice the literal fragment, no quoting (it carries no
+    // bindings; DDL can't bind anyway).
+    if (value instanceof Expression)
+        return String(value.getValue());
+    switch (typeof value) {
+        case 'boolean': return dialect.booleanLiteral(value);
+        case 'bigint': return value.toString();
+        case 'number':
+            if (!Number.isFinite(value)) {
+                throw new NativeOrmError('NATIVE_DDL_BAD_DEFAULT', `[RudderJS ORM native] Non-finite numeric default ${String(value)} is not a valid column default.`);
+            }
+            return String(value);
+        case 'string': return `'${value.replace(/'/g, "''")}'`;
+        default:
+            throw new NativeOrmError('NATIVE_DDL_BAD_DEFAULT', `[RudderJS ORM native] Unsupported column default of type "${typeof value}". ` +
+                `Column defaults must be a string, number, bigint, boolean, or null ` +
+                `(use \`useCurrent()\` for a timestamp default).`);
+    }
+}
+/** Render one column to its `CREATE TABLE` line (sans leading indent). */
+function compileColumn(column, dialect, inlinePrimary) {
+    const parts = [dialect.quoteId(column.name), dialect.columnTypeSql(column)];
+    // Auto-increment columns carry their full spec (incl. PRIMARY KEY) from the
+    // dialect — appending NOT NULL / DEFAULT / PRIMARY KEY would be redundant or
+    // invalid, so stop here.
+    if (column.autoIncrement)
+        return parts.join(' ');
+    if (!column.nullable)
+        parts.push('NOT NULL');
+    if (column.useCurrent) {
+        parts.push('DEFAULT CURRENT_TIMESTAMP');
+    }
+    else if (column.hasDefault) {
+        parts.push(`DEFAULT ${defaultLiteral(column.default, dialect)}`);
+    }
+    // `ON UPDATE CURRENT_TIMESTAMP` is MySQL-only grammar; pg/sqlite have no inline
+    // form, so the modifier is silently dropped there (Laravel does the same).
+    if (dialect.name === 'mysql' && column.useCurrentOnUpdate)
+        parts.push('ON UPDATE CURRENT_TIMESTAMP');
+    if (inlinePrimary)
+        parts.push('PRIMARY KEY');
+    // MySQL takes an inline column COMMENT (last). pg comments out-of-line (a
+    // separate COMMENT ON COLUMN statement, emitted by the table compiler); sqlite
+    // has no column comments at all.
+    if (dialect.name === 'mysql' && column.comment !== undefined)
+        parts.push(`COMMENT ${quoteSqlString(column.comment)}`);
+    return parts.join(' ');
+}
+/** Postgres `COMMENT ON COLUMN "table"."col" IS '…'` statement for a column that
+ *  carries a `.comment(...)`, or null when the dialect comments inline (mysql) or
+ *  not at all (sqlite), or the column has no comment. */
+function compileColumnComment(table, column, dialect) {
+    if (dialect.name !== 'pg' || column.comment === undefined)
+        return null;
+    return {
+        sql: `COMMENT ON COLUMN ${dialect.quoteId(table)}.${dialect.quoteId(column.name)} IS ${quoteSqlString(column.comment)}`,
+        bindings: [],
+    };
+}
+/** A column's `"name" TYPE [NOT NULL] [DEFAULT …]` spec, no inline primary key.
+ *  Exported for the table-rebuild path (7.4b), which assembles a shadow
+ *  `CREATE TABLE` from a mix of changed columns and preserved (introspected) ones. */
+export function compileColumnSpec(column, dialect) {
+    return compileColumn(column, dialect, false);
+}
+/** Default index name, Laravel-style: `{table}_{col[_col…]}_{index|unique}`. */
+function indexName(table, idx) {
+    return idx.name ?? `${table}_${idx.columns.join('_')}_${idx.unique ? 'unique' : 'index'}`;
+}
+/** Collect every index to create: table-level ones plus the per-column
+ *  `.unique()` / `.index()` modifiers, normalized to {@link IndexDefinition}s. */
+function collectIndexes(blueprint) {
+    const out = [...blueprint.indexes];
+    for (const col of blueprint.columns) {
+        if (col.unique)
+            out.push({ columns: [col.name], unique: true });
+        if (col.index)
+            out.push({ columns: [col.name], unique: false });
+    }
+    return out;
+}
+/** Default FK constraint name, Laravel-style: `{table}_{col[_col…]}_foreign`. */
+function foreignKeyName(table, fk) {
+    return fk.name ?? `${table}_${fk.columns.join('_')}_foreign`;
+}
+/** Render a normalized referential action to its SQL keyword (`set null` →
+ *  `SET NULL`). The value is allowlisted at record time, so this is a pure map. */
+function foreignKeyActionSql(action) {
+    return action.toUpperCase();
+}
+/** Collect every foreign key to emit: per-column `constrained()` intents plus
+ *  table-level `foreign()` ones, in declaration order (columns first). */
+function collectForeignKeys(blueprint) {
+    const out = [];
+    for (const col of blueprint.columns) {
+        if (col.foreignKey)
+            out.push(col.foreignKey);
+    }
+    out.push(...blueprint.foreignKeys);
+    return out;
+}
+/** Render one FK as a `CONSTRAINT … FOREIGN KEY (…) REFERENCES "tbl" (…)
+ *  [ON DELETE …] [ON UPDATE …]` table-constraint line. Every identifier is
+ *  quoted+validated via the dialect; the referenced table/columns must be set. */
+function compileForeignKey(table, fk, dialect) {
+    if (!fk.on) {
+        throw new NativeOrmError('NATIVE_DDL_FK_NO_TABLE', `[RudderJS ORM native] Foreign key on (${fk.columns.join(', ')}) in "${table}" is missing its ` +
+            `referenced table — call \`.on('<table>')\` or use \`.constrained()\`.`);
+    }
+    if (fk.references.length === 0) {
+        throw new NativeOrmError('NATIVE_DDL_FK_NO_REFERENCES', `[RudderJS ORM native] Foreign key on (${fk.columns.join(', ')}) in "${table}" references no ` +
+            `columns — call \`.references('<column>')\` (defaults to "id" via \`.constrained()\`).`);
+    }
+    const cols = fk.columns.map(c => dialect.quoteId(c)).join(', ');
+    const refCols = fk.references.map(c => dialect.quoteId(c)).join(', ');
+    let sql = `CONSTRAINT ${dialect.quoteId(foreignKeyName(table, fk))} ` +
+        `FOREIGN KEY (${cols}) REFERENCES ${dialect.quoteId(fk.on)} (${refCols})`;
+    if (fk.onDelete)
+        sql += ` ON DELETE ${foreignKeyActionSql(fk.onDelete)}`;
+    if (fk.onUpdate)
+        sql += ` ON UPDATE ${foreignKeyActionSql(fk.onUpdate)}`;
+    return sql;
+}
+/** `CREATE [UNIQUE] INDEX "name" ON "table" ("c1", …)` — shared by create + alter. */
+function compileCreateIndex(table, idx, dialect) {
+    return {
+        sql: `CREATE ${idx.unique ? 'UNIQUE ' : ''}INDEX ${dialect.quoteId(indexName(table, idx))} ` +
+            `ON ${dialect.quoteId(table)} (${idx.columns.map(c => dialect.quoteId(c)).join(', ')})`,
+        bindings: [],
+    };
+}
+/**
+ * Compile `Schema.create(...)` to a `CREATE TABLE` plus any `CREATE INDEX`
+ * statements (in that order). Each is a {@link CompiledQuery} with empty
+ * bindings — DDL carries no bound parameters.
+ */
+export function compileCreateTable(blueprint, dialect) {
+    if (blueprint.columns.length === 0) {
+        throw new NativeOrmError('NATIVE_DDL_EMPTY_TABLE', `[RudderJS ORM native] Cannot create table "${blueprint.table}" with no columns.`);
+    }
+    // Resolve the primary key. An explicit composite PK (Blueprint.primary) wins
+    // and becomes a table constraint. Otherwise, column-level `.primary()` flags
+    // (excluding the auto-increment column, which owns its own inline PK) become
+    // an inline PK if there's exactly one, or a table constraint if several.
+    const autoPk = blueprint.columns.some(c => c.autoIncrement);
+    const flagged = blueprint.columns.filter(c => c.primary && !c.autoIncrement).map(c => c.name);
+    let tablePk = null;
+    let inlinePk = null;
+    if (blueprint.primaryColumns && !autoPk) {
+        tablePk = blueprint.primaryColumns;
+    }
+    else if (!autoPk && flagged.length === 1) {
+        inlinePk = flagged[0] ?? null;
+    }
+    else if (!autoPk && flagged.length > 1) {
+        tablePk = flagged;
+    }
+    const lines = blueprint.columns.map(c => `  ${compileColumn(c, dialect, c.name === inlinePk)}`);
+    if (tablePk) {
+        lines.push(`  PRIMARY KEY (${tablePk.map(c => dialect.quoteId(c)).join(', ')})`);
+    }
+    // Foreign keys come after the column lines / primary key, as table constraints.
+    for (const fk of collectForeignKeys(blueprint)) {
+        lines.push(`  ${compileForeignKey(blueprint.table, fk, dialect)}`);
+    }
+    const create = {
+        sql: `CREATE TABLE ${dialect.quoteId(blueprint.table)} (\n${lines.join(',\n')}\n)`,
+        bindings: [],
+    };
+    const indexes = collectIndexes(blueprint).map(idx => compileCreateIndex(blueprint.table, idx, dialect));
+    // Postgres column comments are separate statements (pg has no inline COMMENT).
+    const comments = blueprint.columns
+        .map(c => compileColumnComment(blueprint.table, c, dialect))
+        .filter((c) => c !== null);
+    return [create, ...indexes, ...comments];
+}
+/** Compile `Schema.drop(...)` / `Schema.dropIfExists(...)`. */
+export function compileDropTable(table, opts, dialect) {
+    return {
+        sql: `DROP TABLE ${opts.ifExists ? 'IF EXISTS ' : ''}${dialect.quoteId(table)}`,
+        bindings: [],
+    };
+}
+/** Compile `Schema.rename(from, to)`. */
+export function compileRenameTable(from, to, dialect) {
+    return { sql: `ALTER TABLE ${dialect.quoteId(from)} RENAME TO ${dialect.quoteId(to)}`, bindings: [] };
+}
+/**
+ * Compile `Schema.table(...)` to the `ALTER TABLE` / `CREATE INDEX` / `DROP
+ * INDEX` statements its intents require, in dependency order: rename columns →
+ * add columns → add indexes → drop indexes → drop columns. Each is emitted as a
+ * separate statement (SQLite has no multi-clause `ALTER TABLE`).
+ *
+ * SQLite ADD COLUMN can't add a PRIMARY KEY column, and a NOT NULL column must
+ * carry a default — both are rejected here with a clear message rather than
+ * letting SQLite throw a cryptic one. Changing an existing column's type
+ * (`.change()`) needs the table-rebuild dance and is deferred to 7.4b.
+ */
+export function compileAlterTable(blueprint, dialect) {
+    const t = dialect.quoteId(blueprint.table);
+    const out = [];
+    // SQLite can neither ADD nor DROP a foreign key in place (no such ALTER form),
+    // so reject any FK touched on an existing table with a pointer to the
+    // supported paths. (FK-on-alter via the table-rebuild dance is a follow-up.)
+    if (dialect.name === 'sqlite') {
+        const addsFk = blueprint.foreignKeys.length > 0 || blueprint.columns.some(c => c.foreignKey);
+        if (addsFk) {
+            throw new NativeNotImplementedError(`Schema.table foreign key add on "${blueprint.table}" (SQLite)`, 'a later phase — SQLite can\'t ADD a foreign key in place; create the table with the FK, or use a column change()/rebuild');
+        }
+        if (blueprint.droppedForeignKeys.length > 0) {
+            throw new NativeNotImplementedError(`Schema.table dropForeign on "${blueprint.table}" (SQLite)`, 'a later phase — SQLite can\'t DROP a foreign key in place; recreate the table without the FK, or use a column change()/rebuild');
+        }
+    }
+    // 1. Renames first, so any later op refers to the new name.
+    for (const r of blueprint.renamedColumns) {
+        out.push({ sql: `ALTER TABLE ${t} RENAME COLUMN ${dialect.quoteId(r.from)} TO ${dialect.quoteId(r.to)}`, bindings: [] });
+    }
+    // 2. Column changes (`.change()`) — pg/mysql express them natively (7.4b);
+    // SQLite can't and routes through the table-rebuild dance in SchemaBuilder
+    // BEFORE this compiler runs, so reaching here on sqlite is a direct-compile
+    // misuse and throws the pointer.
+    for (const col of blueprint.columns) {
+        if (!col.change)
+            continue;
+        if (dialect.name === 'sqlite') {
+            throw new NativeNotImplementedError(`compileAlterTable column change() on "${blueprint.table}.${col.name}" (SQLite)`, 'the SchemaBuilder table-rebuild path — drive changes through Schema.table()/SchemaBuilder.table(), not the compiler directly');
+        }
+        if (col.autoIncrement || col.primary) {
+            throw new NativeOrmError('NATIVE_DDL_CHANGE_PRIMARY', `[RudderJS ORM native] Cannot change() "${col.name}" into a primary-key/auto-increment column — recreate the table instead.`);
+        }
+        if (dialect.name === 'mysql') {
+            // MySQL MODIFY takes the FULL new column spec (type, nullability,
+            // default, comment) in one clause — anything omitted is RESET, exactly
+            // the "the new definition replaces the old one" semantics Laravel's
+            // change() documents. Positional FIRST/AFTER composes here too.
+            let sql = `ALTER TABLE ${t} MODIFY ${compileColumn(col, dialect, false)}`;
+            if (col.first)
+                sql += ' FIRST';
+            else if (col.after)
+                sql += ` AFTER ${dialect.quoteId(col.after)}`;
+            out.push({ sql, bindings: [] });
+        }
+        else {
+            // Postgres alters each facet separately; one statement with
+            // comma-joined actions keeps it atomic. The new definition replaces the
+            // old one (Laravel semantics): no `.default(...)` → DROP DEFAULT, no
+            // `.nullable()` → SET NOT NULL. Type changes rely on pg's implicit
+            // casts (varchar↔text, widenings); an incompatible change needs a raw
+            // `USING` statement — `DB.statement('ALTER TABLE … USING …')`.
+            const c = dialect.quoteId(col.name);
+            const actions = [`ALTER COLUMN ${c} TYPE ${dialect.columnTypeSql(col)}`];
+            actions.push(col.nullable ? `ALTER COLUMN ${c} DROP NOT NULL` : `ALTER COLUMN ${c} SET NOT NULL`);
+            if (col.useCurrent)
+                actions.push(`ALTER COLUMN ${c} SET DEFAULT CURRENT_TIMESTAMP`);
+            else if (col.hasDefault)
+                actions.push(`ALTER COLUMN ${c} SET DEFAULT ${defaultLiteral(col.default, dialect)}`);
+            else
+                actions.push(`ALTER COLUMN ${c} DROP DEFAULT`);
+            out.push({ sql: `ALTER TABLE ${t} ${actions.join(', ')}`, bindings: [] });
+            // pg comments stay out-of-line on change too.
+            const comment = compileColumnComment(blueprint.table, col, dialect);
+            if (comment)
+                out.push(comment);
+        }
+    }
+    // 3. Add columns (one ALTER ... ADD COLUMN each), with SQLite's restrictions.
+    for (const col of blueprint.columns) {
+        if (col.change)
+            continue;
+        if (col.autoIncrement || col.primary) {
+            throw new NativeOrmError('NATIVE_DDL_ADD_PRIMARY', `[RudderJS ORM native] Cannot ADD a primary-key column ("${col.name}") to an existing table on SQLite. Create the table with its primary key, or rebuild it.`);
+        }
+        if (!col.nullable && !col.hasDefault && !col.useCurrent) {
+            throw new NativeOrmError('NATIVE_DDL_ADD_NOT_NULL', `[RudderJS ORM native] Adding a NOT NULL column ("${col.name}") to an existing table requires a default — chain \`.default(...)\` or \`.nullable()\`.`);
+        }
+        let addSql = `ALTER TABLE ${t} ADD COLUMN ${compileColumn(col, dialect, false)}`;
+        // Positional ADD (MySQL only): FIRST wins over AFTER. pg/sqlite have no
+        // positional ADD COLUMN, so these are silently ignored there (Laravel too).
+        if (dialect.name === 'mysql') {
+            if (col.first)
+                addSql += ' FIRST';
+            else if (col.after)
+                addSql += ` AFTER ${dialect.quoteId(col.after)}`;
+        }
+        out.push({ sql: addSql, bindings: [] });
+        // pg out-of-line comment for the added column.
+        const comment = compileColumnComment(blueprint.table, col, dialect);
+        if (comment)
+            out.push(comment);
+    }
+    // 4. New indexes (table-level + per-column unique()/index() on added/changed columns).
+    for (const idx of collectIndexes(blueprint)) {
+        out.push(compileCreateIndex(blueprint.table, idx, dialect));
+    }
+    // 4b. New foreign keys (pg/mysql only — the sqlite guard above already
+    // rejected them): `ADD CONSTRAINT … FOREIGN KEY … REFERENCES …`, reusing
+    // the create-table constraint renderer. Historically these were silently
+    // dropped on alter — a migration "succeeded" without its FK.
+    if (dialect.name !== 'sqlite') {
+        for (const fk of collectForeignKeys(blueprint)) {
+            out.push({ sql: `ALTER TABLE ${t} ADD ${compileForeignKey(blueprint.table, fk, dialect)}`, bindings: [] });
+        }
+        // Dropped FKs — by constraint name, or by the column list they cover
+        // (derived via the same default-name convention used at creation).
+        // mysql spells it DROP FOREIGN KEY; pg DROP CONSTRAINT.
+        for (const dropped of blueprint.droppedForeignKeys) {
+            const name = typeof dropped === 'string'
+                ? dropped
+                : `${blueprint.table}_${dropped.join('_')}_foreign`;
+            const clause = dialect.name === 'mysql' ? 'DROP FOREIGN KEY' : 'DROP CONSTRAINT';
+            out.push({ sql: `ALTER TABLE ${t} ${clause} ${dialect.quoteId(name)}`, bindings: [] });
+        }
+    }
+    // 5. Drop indexes (by name). SQLite and pg address an index as a standalone
+    // schema object; MySQL scopes it to its table (`DROP INDEX … ON <table>`).
+    for (const name of blueprint.droppedIndexes) {
+        const onTable = dialect.name === 'mysql' ? ` ON ${t}` : '';
+        out.push({ sql: `DROP INDEX ${dialect.quoteId(name)}${onTable}`, bindings: [] });
+    }
+    // 6. Drop columns last.
+    for (const name of blueprint.droppedColumns) {
+        out.push({ sql: `ALTER TABLE ${t} DROP COLUMN ${dialect.quoteId(name)}`, bindings: [] });
+    }
+    return out;
+}
+//# sourceMappingURL=ddl-compiler.js.map

package/dist/native/schema/ddl-compiler.js.map

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

package/dist/native/schema/inspect.d.ts

@@ -0,0 +1,67 @@
+import type { Executor } from '../driver.js';
+import type { Dialect } from '../dialect.js';
+import { type RawColumn } from './introspect.js';
+/** One table in the `db:show` overview. */
+export interface TableSummary {
+    name: string;
+    /** On-disk size in bytes, or null when the dialect can't report it (sqlite
+     *  without the `dbstat` module). */
+    sizeBytes: number | null;
+    /** `COUNT(*)` — only populated when `db:show --counts` asks for it. */
+    rows?: number;
+}
+/** The `db:show` payload. */
+export interface DatabaseInfo {
+    dialect: 'sqlite' | 'pg' | 'mysql';
+    /** Server/library version (`sqlite_version()`, pg `server_version`, mysql `VERSION()`). */
+    version: string | null;
+    /** Current database name — pg/mysql catalog name, sqlite main file path
+     *  (`:memory:` shows as null). */
+    database: string | null;
+    tables: TableSummary[];
+    /** View names — only populated when `db:show --views` asks for them. */
+    views?: string[];
+}
+/** One index in the `db:table` detail. */
+export interface IndexInfo {
+    name: string;
+    columns: string[];
+    unique: boolean;
+    primary: boolean;
+}
+/** One foreign key in the `db:table` detail. `columns[i]` references
+ *  `foreignColumns[i]`. */
+export interface ForeignKeyInfo {
+    /** Constraint name — null on sqlite (PRAGMA reports an ordinal, not a name). */
+    name: string | null;
+    columns: string[];
+    foreignTable: string;
+    foreignColumns: string[];
+    onUpdate: string | null;
+    onDelete: string | null;
+}
+/** The `db:table <name>` payload. */
+export interface TableInfo {
+    name: string;
+    columns: RawColumn[];
+    indexes: IndexInfo[];
+    foreignKeys: ForeignKeyInfo[];
+    rows: number;
+    sizeBytes: number | null;
+}
+export declare function inspectDatabase(executor: Executor, dialect: Dialect, opts?: {
+    counts?: boolean;
+    views?: boolean;
+}): Promise<DatabaseInfo>;
+/** Inspect one table — null when the table doesn't exist (the caller renders
+ *  the available-tables hint). The existence check doubles as the injection
+ *  gate: PRAGMA/`COUNT(*)` interpolation only ever sees the catalog's own
+ *  spelling of the name, never the raw CLI argument. */
+export declare function inspectTable(executor: Executor, dialect: Dialect, table: string): Promise<TableInfo | null>;
+/** A table's indexes. On sqlite an INTEGER PRIMARY KEY is the rowid — no index
+ *  row exists for it, so a `PRIMARY` pseudo-entry is synthesized from the
+ *  column PK ordinals (mirrors Laravel's SQLite schema reader). */
+export declare function readIndexes(executor: Executor, dialect: Dialect, table: string): Promise<IndexInfo[]>;
+/** A table's outbound foreign keys, composite columns paired in order. */
+export declare function readForeignKeys(executor: Executor, dialect: Dialect, table: string): Promise<ForeignKeyInfo[]>;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/native/schema/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../../src/native/schema/inspect.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE7D,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ;wCACoC;IACpC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,6BAA6B;AAC7B,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAA;IACnC,2FAA2F;IAC3F,OAAO,EAAG,MAAM,GAAG,IAAI,CAAA;IACvB;sCACkC;IAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,EAAI,YAAY,EAAE,CAAA;IACxB,wEAAwE;IACxE,KAAK,CAAC,EAAI,MAAM,EAAE,CAAA;CACnB;AAED,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAK,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAG,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;2BAC2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,gFAAgF;IAChF,IAAI,EAAY,MAAM,GAAG,IAAI,CAAA;IAC7B,OAAO,EAAS,MAAM,EAAE,CAAA;IACxB,YAAY,EAAI,MAAM,CAAA;IACtB,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,QAAQ,EAAQ,MAAM,GAAG,IAAI,CAAA;IAC7B,QAAQ,EAAQ,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED,qCAAqC;AACrC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAS,MAAM,CAAA;IACnB,OAAO,EAAM,SAAS,EAAE,CAAA;IACxB,OAAO,EAAM,SAAS,EAAE,CAAA;IACxB,WAAW,EAAE,cAAc,EAAE,CAAA;IAC7B,IAAI,EAAS,MAAM,CAAA;IACnB,SAAS,EAAI,MAAM,GAAG,IAAI,CAAA;CAC3B;AAyED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,OAAO,CAAC,YAAY,CAAC,CAqCvB;AAuBD;;;wDAGwD;AACxD,wBAAsB,YAAY,CAChC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAa3B;AAED;;mEAEmE;AACnE,wBAAsB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA4D3G;AAmBD,0EAA0E;AAC1E,wBAAsB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAwFpH"}