@rudderjs/database 1.1.0 → 1.2.1

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

@@ -0,0 +1,144 @@
+import type { QueryBuilder, OrmAdapter } from '@rudderjs/contracts';
+import { Migration } from './migration.js';
+import type { SchemaBuilder } from './schema-builder.js';
+/** The minimal connection surface the migrator needs. `NativeAdapter` satisfies it. */
+export interface MigratorAdapter {
+    schemaBuilder(): SchemaBuilder;
+    query<T>(table: string): QueryBuilder<T>;
+    /**
+     * Run `fn` inside a transaction, passing it a transaction-scoped adapter whose
+     * `schemaBuilder()` / `query()` execute on the transaction. The migrator wraps
+     * each batch's up()s / down()s in this so a mid-batch failure rolls back the
+     * WHOLE batch — DDL and the `migrations` state-table writes commit atomically.
+     *
+     * The callback param mirrors the `OrmAdapter` contract (the scoped adapter the
+     * concrete `transaction()` hands back) so `NativeAdapter` stays structurally
+     * assignable to `MigratorAdapter`. The migrator narrows it to a {@link
+     * ScopedMigratorAdapter} internally — the scoped adapter is in fact a full
+     * native adapter that also exposes `schemaBuilder()`.
+     */
+    transaction<T>(fn: (tx: OrmAdapter) => Promise<T>): Promise<T>;
+    /**
+     * A recording {@link SchemaBuilder} for `migrate --pretend`: statements are
+     * captured (via `record`) instead of executed. Optional — an adapter without it
+     * makes `--pretend` throw a clear error rather than silently executing.
+     */
+    pretendSchemaBuilder?(record: (sql: string, bindings: readonly unknown[]) => void): SchemaBuilder;
+}
+/** A migration file resolved to its name (filename sans extension) + instance. */
+export interface LoadedMigration {
+    name: string;
+    migration: Migration;
+}
+/** One row of `migrate:status` output. */
+export interface MigrationStatus {
+    name: string;
+    ran: boolean;
+    batch: number | null;
+}
+/** The SQL a single migration's `up()` would emit, captured under `--pretend`. */
+export interface PretendedMigration {
+    name: string;
+    statements: string[];
+}
+/** Outcome of a `run()`. */
+export interface RunResult {
+    batch: number;
+    applied: string[];
+    /** Present only under `{ pretend: true }` — the captured (un-executed) SQL per
+     *  pending migration. `applied` is empty in that case (nothing ran). */
+    pretended?: PretendedMigration[];
+}
+/** Knobs for {@link Migrator.run} (Laravel `migrate` flag parity). */
+export interface RunOptions {
+    /** `--step`: record each pending migration in its OWN batch (so they roll back
+     *  one at a time) instead of grouping the whole run into a single batch. */
+    step?: boolean;
+    /** `--pretend`: capture the SQL each pending migration would emit without
+     *  executing anything or writing the `migrations` state table. */
+    pretend?: boolean;
+}
+/** Outcome of a `rollback()`. */
+export interface RollbackResult {
+    /** The batch number that was rolled back (`0` if nothing to roll back). For a
+     *  `--step`/`--batch` rollback this is the highest batch touched. */
+    batch: number;
+    reverted: string[];
+}
+/** Knobs for {@link Migrator.rollback} (Laravel `migrate:rollback` flag parity). */
+export interface RollbackOptions {
+    /** `--step=N`: roll back the last N applied migrations (across batches), each
+     *  reverted in reverse apply order. */
+    step?: number;
+    /** `--batch=N`: roll back every migration recorded in batch N. */
+    batch?: number;
+}
+interface MigrationRow {
+    id: number;
+    migration: string;
+    batch: number;
+}
+export declare class Migrator {
+    private readonly adapter;
+    private readonly schema;
+    constructor(adapter: MigratorAdapter);
+    /** Whether the `migrations` state table exists yet. */
+    installed(): Promise<boolean>;
+    /** Create the `migrations` state table if it's missing. Idempotent. */
+    ensureTable(): Promise<void>;
+    /** Names of applied migrations, in apply order. */
+    ran(): Promise<string[]>;
+    /** The batch number a fresh `run()` would use (`max(batch) + 1`, or 1). */
+    nextBatch(): Promise<number>;
+    /**
+     * Apply every not-yet-run migration (in `name` order) inside a single new
+     * batch. `onApply` streams progress to the caller (the CLI prints it). Returns
+     * the batch number and the applied names.
+     */
+    run(migrations: LoadedMigration[], onApply?: (name: string) => void, opts?: RunOptions): Promise<RunResult>;
+    /** Dry-run: bind each pending migration's `up()` to a recording schema builder
+     *  and collect the DDL it would emit. No transaction, no state-table writes. */
+    private pretend;
+    /** ran/pending state for every known migration, plus its batch when applied. */
+    status(migrations: LoadedMigration[]): Promise<MigrationStatus[]>;
+    /** The highest recorded batch number, or `0` when nothing has been applied. */
+    lastBatch(): Promise<number>;
+    /** Rows recorded in `batch`, newest-applied first (id DESC) — i.e. the order
+     *  their `down()` methods should run to unwind the batch. */
+    migrationsInBatch(batch: number): Promise<MigrationRow[]>;
+    /**
+     * Revert the LAST batch: run each of its migrations' `down()` in reverse apply
+     * order (id DESC) and delete their `migrations` rows. The whole batch runs in
+     * one transaction, so a `down()` that throws leaves the state table untouched.
+     * Returns the rolled-back batch number and the reverted names. A no-op (batch
+     * `0`) when nothing has been applied.
+     */
+    rollback(migrations: LoadedMigration[], onRevert?: (name: string) => void, opts?: RollbackOptions): Promise<RollbackResult>;
+    /**
+     * Revert EVERY applied migration (all batches), `down()` in full reverse order
+     * (id DESC across batches), in a single transaction. Used by `migrate:refresh`.
+     * Returns the reverted names.
+     */
+    rollbackAll(migrations: LoadedMigration[]): Promise<string[]>;
+    /** Shared unwind path for `rollback` / `rollbackAll`: run `down()` for each row
+     *  (already in reverse order) inside one transaction and delete its state row. */
+    private revertRows;
+    /**
+     * Drop every user table (used by `migrate:fresh`) — including the
+     * `migrations` state table, so the next `run()` rebuilds from a clean slate.
+     * Delegates to the dialect-aware {@link SchemaBuilder.dropAllTables}
+     * (`information_schema` + FK-safe drops on pg/mysql, `sqlite_master` on
+     * sqlite). Historically this read the SQLite catalog directly, which made
+     * `migrate:fresh` throw on pg/mysql native connections.
+     */
+    dropAllTables(): Promise<void>;
+}
+/**
+ * Load migration files from a directory: each `*.{ts,js,mts,mjs}` whose default
+ * export is a {@link Migration} subclass, instantiated and sorted by filename
+ * (timestamp-prefixed names sort chronologically). A file without a valid
+ * default export throws — a silently-skipped migration is worse than a loud one.
+ */
+export declare function discoverMigrations(dir: string): Promise<LoadedMigration[]>;
+export {};
+//# sourceMappingURL=migrator.d.ts.map

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

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

package/dist/native/schema/migrator.js

@@ -0,0 +1,240 @@
+// ─── Migrator (runner + state) ─────────────────────────────
+//
+// Node-capable: drives migration files against a connection and tracks applied
+// migrations in a `migrations` table (Laravel's model: `id`, `migration`,
+// `batch`). Phase 7.2 ships forward `migrate` + `status`; `rollback`/`refresh`
+// (which reverse a batch via `down()`) and transactional batches land in 7.5 —
+// the `batch` column is recorded now so rollback has the grouping it needs.
+//
+// The runner is decoupled from the concrete adapter: it needs only a
+// `schemaBuilder()` (DDL) and `query()` (state-table CRUD), both of which
+// `NativeAdapter` provides. That keeps it unit-testable against an in-memory
+// SQLite adapter, and reusable by RN/WASM drivers later.
+import { readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { Migration } from './migration.js';
+import { withSchema } from './schema-facade.js';
+import { NativeOrmError } from '../errors.js';
+const TABLE = 'migrations';
+export class Migrator {
+    adapter;
+    schema;
+    constructor(adapter) {
+        this.adapter = adapter;
+        this.schema = adapter.schemaBuilder();
+    }
+    /** Whether the `migrations` state table exists yet. */
+    installed() {
+        return this.schema.hasTable(TABLE);
+    }
+    /** Create the `migrations` state table if it's missing. Idempotent. */
+    async ensureTable() {
+        if (await this.installed())
+            return;
+        await this.schema.create(TABLE, (t) => {
+            t.id();
+            t.string('migration').unique();
+            t.integer('batch');
+        });
+    }
+    /** Names of applied migrations, in apply order. */
+    async ran() {
+        if (!(await this.installed()))
+            return [];
+        const rows = await this.adapter.query(TABLE).orderBy('id', 'ASC').get();
+        return rows.map(r => r.migration);
+    }
+    /** The batch number a fresh `run()` would use (`max(batch) + 1`, or 1). */
+    async nextBatch() {
+        if (!(await this.installed()))
+            return 1;
+        const rows = await this.adapter.query(TABLE).get();
+        return rows.reduce((max, r) => Math.max(max, r.batch), 0) + 1;
+    }
+    /**
+     * Apply every not-yet-run migration (in `name` order) inside a single new
+     * batch. `onApply` streams progress to the caller (the CLI prints it). Returns
+     * the batch number and the applied names.
+     */
+    async run(migrations, onApply, opts = {}) {
+        // --pretend: capture each pending migration's SQL without touching the DB or
+        // the state table. Doesn't need (or create) the migrations table.
+        if (opts.pretend)
+            return this.pretend(migrations);
+        await this.ensureTable();
+        const done = new Set(await this.ran());
+        const pending = migrations.filter(m => !done.has(m.name));
+        const startBatch = await this.nextBatch();
+        if (pending.length === 0)
+            return { batch: startBatch, applied: [] };
+        // One transaction for the whole run: if any up() throws, every DDL change and
+        // `migrations` row recorded so far rolls back atomically. Use the TX-scoped
+        // adapter for both the schema builder and the state-table writes. Under
+        // --step each migration takes its own incrementing batch number (so it can be
+        // rolled back individually); otherwise they share `startBatch`.
+        await this.adapter.transaction(async (txAdapter) => {
+            const tx = txAdapter;
+            const schema = tx.schemaBuilder();
+            let offset = 0;
+            for (const { name, migration } of pending) {
+                const batch = opts.step ? startBatch + offset : startBatch;
+                await withSchema(schema, () => migration.up());
+                await tx.query(TABLE).create({ migration: name, batch });
+                onApply?.(name);
+                offset++;
+            }
+        });
+        return { batch: startBatch, applied: pending.map(m => m.name) };
+    }
+    /** Dry-run: bind each pending migration's `up()` to a recording schema builder
+     *  and collect the DDL it would emit. No transaction, no state-table writes. */
+    async pretend(migrations) {
+        if (!this.adapter.pretendSchemaBuilder) {
+            throw new NativeOrmError('NATIVE_PRETEND_UNSUPPORTED', `[RudderJS ORM native] --pretend is not supported by this adapter (no pretendSchemaBuilder()).`);
+        }
+        const done = new Set(await this.ran());
+        const pending = migrations.filter(m => !done.has(m.name));
+        const pretended = [];
+        for (const { name, migration } of pending) {
+            const statements = [];
+            const schema = this.adapter.pretendSchemaBuilder((sql) => statements.push(sql));
+            await withSchema(schema, () => migration.up(), { pretend: true });
+            pretended.push({ name, statements });
+        }
+        return { batch: await this.nextBatch(), applied: [], pretended };
+    }
+    /** ran/pending state for every known migration, plus its batch when applied. */
+    async status(migrations) {
+        const rows = (await this.installed())
+            ? await this.adapter.query(TABLE).get()
+            : [];
+        const byName = new Map(rows.map(r => [r.migration, r.batch]));
+        return migrations.map(m => ({
+            name: m.name,
+            ran: byName.has(m.name),
+            batch: byName.get(m.name) ?? null,
+        }));
+    }
+    /** The highest recorded batch number, or `0` when nothing has been applied. */
+    async lastBatch() {
+        if (!(await this.installed()))
+            return 0;
+        const rows = await this.adapter.query(TABLE).get();
+        return rows.reduce((max, r) => Math.max(max, r.batch), 0);
+    }
+    /** Rows recorded in `batch`, newest-applied first (id DESC) — i.e. the order
+     *  their `down()` methods should run to unwind the batch. */
+    migrationsInBatch(batch) {
+        return this.adapter.query(TABLE).where('batch', batch).orderBy('id', 'DESC').get();
+    }
+    /**
+     * Revert the LAST batch: run each of its migrations' `down()` in reverse apply
+     * order (id DESC) and delete their `migrations` rows. The whole batch runs in
+     * one transaction, so a `down()` that throws leaves the state table untouched.
+     * Returns the rolled-back batch number and the reverted names. A no-op (batch
+     * `0`) when nothing has been applied.
+     */
+    async rollback(migrations, onRevert, opts = {}) {
+        // --batch=N: revert every migration recorded in that batch.
+        if (opts.batch !== undefined) {
+            const rows = await this.migrationsInBatch(opts.batch);
+            const reverted = await this.revertRows(rows, migrations, onRevert);
+            return { batch: opts.batch, reverted };
+        }
+        // --step=N: revert the last N applied migrations, across batches, newest first.
+        if (opts.step !== undefined && opts.step > 0) {
+            if (!(await this.installed()))
+                return { batch: 0, reverted: [] };
+            const all = await this.adapter.query(TABLE).orderBy('id', 'DESC').get();
+            const rows = all.slice(0, opts.step);
+            const batch = rows.reduce((max, r) => Math.max(max, r.batch), 0);
+            const reverted = await this.revertRows(rows, migrations, onRevert);
+            return { batch, reverted };
+        }
+        // Default: revert the last batch.
+        const batch = await this.lastBatch();
+        if (batch === 0)
+            return { batch: 0, reverted: [] };
+        const rows = await this.migrationsInBatch(batch);
+        const reverted = await this.revertRows(rows, migrations, onRevert);
+        return { batch, reverted };
+    }
+    /**
+     * Revert EVERY applied migration (all batches), `down()` in full reverse order
+     * (id DESC across batches), in a single transaction. Used by `migrate:refresh`.
+     * Returns the reverted names.
+     */
+    async rollbackAll(migrations) {
+        if (!(await this.installed()))
+            return [];
+        const rows = await this.adapter.query(TABLE).orderBy('id', 'DESC').get();
+        return this.revertRows(rows, migrations);
+    }
+    /** Shared unwind path for `rollback` / `rollbackAll`: run `down()` for each row
+     *  (already in reverse order) inside one transaction and delete its state row. */
+    async revertRows(rows, migrations, onRevert) {
+        if (rows.length === 0)
+            return [];
+        const byName = new Map(migrations.map(m => [m.name, m.migration]));
+        const reverted = [];
+        await this.adapter.transaction(async (txAdapter) => {
+            const tx = txAdapter;
+            const schema = tx.schemaBuilder();
+            for (const row of rows) {
+                const migration = byName.get(row.migration);
+                if (!migration) {
+                    throw new NativeOrmError('NATIVE_BAD_MIGRATION', `[RudderJS ORM native] Cannot roll back "${row.migration}": its migration file ` +
+                        `was not found in database/migrations. Restore the file or remove its row from the migrations table.`);
+                }
+                await withSchema(schema, () => migration.down());
+                await tx.query(TABLE).delete(row.id);
+                reverted.push(row.migration);
+                onRevert?.(row.migration);
+            }
+        });
+        return reverted;
+    }
+    /**
+     * Drop every user table (used by `migrate:fresh`) — including the
+     * `migrations` state table, so the next `run()` rebuilds from a clean slate.
+     * Delegates to the dialect-aware {@link SchemaBuilder.dropAllTables}
+     * (`information_schema` + FK-safe drops on pg/mysql, `sqlite_master` on
+     * sqlite). Historically this read the SQLite catalog directly, which made
+     * `migrate:fresh` throw on pg/mysql native connections.
+     */
+    async dropAllTables() {
+        await this.schema.dropAllTables();
+    }
+}
+/**
+ * Load migration files from a directory: each `*.{ts,js,mts,mjs}` whose default
+ * export is a {@link Migration} subclass, instantiated and sorted by filename
+ * (timestamp-prefixed names sort chronologically). A file without a valid
+ * default export throws — a silently-skipped migration is worse than a loud one.
+ */
+export async function discoverMigrations(dir) {
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return []; // no migrations directory yet
+    }
+    const files = entries
+        .filter(f => /\.(ts|js|mts|mjs)$/.test(f) && !/\.d\.ts$/.test(f))
+        .sort();
+    const loaded = [];
+    for (const file of files) {
+        const name = file.replace(/\.(ts|js|mts|mjs)$/, '');
+        // Runtime path by design (user migration files on disk) — Vite can't analyze it; suppress the dev warning.
+        const mod = await import(/* @vite-ignore */ pathToFileURL(join(dir, file)).href);
+        const Cls = mod.default;
+        if (typeof Cls !== 'function' || !(Cls.prototype instanceof Migration)) {
+            throw new NativeOrmError('NATIVE_BAD_MIGRATION', `[RudderJS ORM native] ${file} must default-export a class extending Migration.`);
+        }
+        loaded.push({ name, migration: new Cls() });
+    }
+    return loaded;
+}
+//# sourceMappingURL=migrator.js.map

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

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

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

@@ -0,0 +1,11 @@
+import type { Executor } from '../driver.js';
+import type { Dialect } from '../dialect.js';
+import type { AlterBlueprint } from './alter-blueprint.js';
+/**
+ * Rebuild `blueprint.table` applying its `change()` column definitions, via the
+ * SQLite shadow-table dance. Assumes `change()` is the only op in the call (the
+ * caller routes here only when a change is present; this re-checks and throws on
+ * a mixed call).
+ */
+export declare function rebuildTable(executor: Executor, dialect: Dialect, blueprint: AlterBlueprint): Promise<void>;
+//# sourceMappingURL=rebuild.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rebuild.d.ts","sourceRoot":"","sources":["../../../src/native/schema/rebuild.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAiB1D;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA4DjH"}

package/dist/native/schema/rebuild.js

@@ -0,0 +1,92 @@
+// ─── SQLite table rebuild (Schema.table column change()) ───
+//
+// Node-capable (runs via an {@link Executor}). SQLite can't change a column's
+// type/constraints in place, so `t.<type>('col').change()` triggers the
+// canonical 12-step rebuild: create a shadow table with the new column set, copy
+// the data across, drop the original, rename the shadow into its place, then
+// recreate the user indexes. This is the single biggest piece of `Schema.table`
+// (parent plan Part 4) and the reason it's its own phase (7.4b).
+//
+// v1 scope — **`change()` must be the only operation in its `Schema.table` call.**
+// Mixing it with add/drop/rename/index in one call throws; split those into a
+// separate `table()` (the native-ALTER path handles them). That keeps the shadow
+// reconstruction faithful: every non-changed column and the primary key are
+// preserved exactly, only the changed columns' definitions are swapped, and all
+// rows copy 1:1. Changing a primary-key column is rejected (the PK is preserved
+// verbatim). Atomicity comes from the migrator's per-batch transaction (7.5);
+// run standalone, the steps execute sequentially.
+import { NativeOrmError } from '../errors.js';
+import { compileColumnSpec } from './ddl-compiler.js';
+import { readColumns, readIndexSql, isAutoincrement } from './introspect.js';
+/** Render one preserved (introspected) column to its shadow-table spec. The
+ *  single INTEGER rowid primary key is re-emitted inline (with AUTOINCREMENT
+ *  when the original used it); everything else keeps its type/null/default. */
+function preservedColumnSpec(col, dialect, singleIntPk, auto) {
+    if (singleIntPk && col.pk === 1) {
+        return `${dialect.quoteId(col.name)} INTEGER PRIMARY KEY${auto ? ' AUTOINCREMENT' : ''}`;
+    }
+    const parts = [dialect.quoteId(col.name), col.type || 'TEXT'];
+    if (col.notNull)
+        parts.push('NOT NULL');
+    if (col.dflt !== null)
+        parts.push(`DEFAULT ${col.dflt}`);
+    return parts.join(' ');
+}
+/**
+ * Rebuild `blueprint.table` applying its `change()` column definitions, via the
+ * SQLite shadow-table dance. Assumes `change()` is the only op in the call (the
+ * caller routes here only when a change is present; this re-checks and throws on
+ * a mixed call).
+ */
+export async function rebuildTable(executor, dialect, blueprint) {
+    const table = blueprint.table;
+    const changes = blueprint.columns.filter(c => c.change);
+    const others = blueprint.columns.filter(c => !c.change);
+    if (others.length || blueprint.droppedColumns.length || blueprint.renamedColumns.length || blueprint.indexes.length || blueprint.droppedIndexes.length) {
+        throw new NativeOrmError('NATIVE_DDL_CHANGE_COMBINED', `[RudderJS ORM native] change() must be the only operation in a Schema.table('${table}', …) call (v1). ` +
+            `Move adds / drops / renames / index changes into a separate table() call.`);
+    }
+    const current = await readColumns(executor, dialect, table);
+    if (current.length === 0) {
+        throw new NativeOrmError('NATIVE_DDL_NO_TABLE', `[RudderJS ORM native] Cannot alter "${table}" — it has no columns or does not exist.`);
+    }
+    const byName = new Map(current.map(c => [c.name, c]));
+    const changeByName = new Map();
+    for (const def of changes) {
+        const existing = byName.get(def.name);
+        if (!existing) {
+            throw new NativeOrmError('NATIVE_DDL_CHANGE_MISSING', `[RudderJS ORM native] Cannot change column "${def.name}" — no such column on "${table}".`);
+        }
+        if (existing.pk > 0) {
+            throw new NativeOrmError('NATIVE_DDL_CHANGE_PK', `[RudderJS ORM native] Changing a primary-key column ("${def.name}") is not supported.`);
+        }
+        if (def.primary || def.autoIncrement) {
+            throw new NativeOrmError('NATIVE_DDL_CHANGE_TO_PK', `[RudderJS ORM native] change() cannot turn "${def.name}" into a primary key.`);
+        }
+        changeByName.set(def.name, def);
+    }
+    const auto = await isAutoincrement(executor, table);
+    const indexSqls = await readIndexSql(executor, table);
+    const pkCols = current.filter(c => c.pk > 0).sort((a, b) => a.pk - b.pk);
+    const singleIntPk = pkCols.length === 1 && (pkCols[0]?.type.toUpperCase() === 'INTEGER');
+    // New column set: same order, changed columns swapped for their new spec.
+    const colLines = current.map((col) => {
+        const changed = changeByName.get(col.name);
+        return changed ? compileColumnSpec(changed, dialect) : preservedColumnSpec(col, dialect, singleIntPk, auto);
+    });
+    if (pkCols.length && !singleIntPk) {
+        colLines.push(`PRIMARY KEY (${pkCols.map(c => dialect.quoteId(c.name)).join(', ')})`);
+    }
+    const shadow = `__rudder_new_${table}`;
+    const colNames = current.map(c => dialect.quoteId(c.name)).join(', ');
+    // The rebuild dance. (No renames/drops in v1, so the shadow has the same
+    // column names as the original — a straight 1:1 copy.)
+    await executor.execute(`CREATE TABLE ${dialect.quoteId(shadow)} (\n  ${colLines.join(',\n  ')}\n)`, []);
+    await executor.execute(`INSERT INTO ${dialect.quoteId(shadow)} (${colNames}) SELECT ${colNames} FROM ${dialect.quoteId(table)}`, []);
+    await executor.execute(`DROP TABLE ${dialect.quoteId(table)}`, []);
+    await executor.execute(`ALTER TABLE ${dialect.quoteId(shadow)} RENAME TO ${dialect.quoteId(table)}`, []);
+    for (const sql of indexSqls) {
+        await executor.execute(sql, []);
+    }
+}
+//# sourceMappingURL=rebuild.js.map

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

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

package/dist/native/schema/schema-builder.d.ts

@@ -0,0 +1,46 @@
+import type { Executor } from '../driver.js';
+import type { Dialect } from '../dialect.js';
+import { Blueprint } from './blueprint.js';
+import { AlterBlueprint } from './alter-blueprint.js';
+export declare class SchemaBuilder {
+    private readonly executor;
+    private readonly dialect;
+    constructor(executor: Executor, dialect: Dialect);
+    /** `CREATE TABLE` (+ any indexes) from a `Blueprint` callback. */
+    create(table: string, build: (table: Blueprint) => void): Promise<void>;
+    /** `ALTER TABLE` — add/drop/rename/change columns + add/drop indexes and
+     *  foreign keys via a callback. A `.change()` (column type/constraint
+     *  change) is a native `ALTER COLUMN` / `MODIFY` on pg/mysql (7.4b); SQLite
+     *  can't change a column in place, so it routes through the table-rebuild
+     *  dance instead (which requires `change()` to be the only op in the call). */
+    table(table: string, build: (table: AlterBlueprint) => void): Promise<void>;
+    /** Rename a table. */
+    rename(from: string, to: string): Promise<void>;
+    /** `DROP TABLE`. */
+    drop(table: string): Promise<void>;
+    /** `DROP TABLE IF EXISTS`. */
+    dropIfExists(table: string): Promise<void>;
+    /**
+     * Names of every user table (catalog lookup) — includes the `migrations`
+     * state table, excludes the engine's internal tables (`sqlite_*`).
+     * `information_schema` on pg/mysql, `sqlite_master` on sqlite.
+     */
+    allTables(): Promise<string[]>;
+    /**
+     * Drop every user table — the `migrate:fresh` sweep (Laravel's
+     * `Schema::dropAllTables()` analog). Dialect-aware so foreign keys can't
+     * block it: pg drops with `CASCADE`, mysql disables `FOREIGN_KEY_CHECKS`
+     * for the batch (restored after, even on failure), sqlite drops in catalog
+     * order exactly as before.
+     */
+    dropAllTables(): Promise<void>;
+    /** Whether `table` exists (catalog lookup). */
+    hasTable(table: string): Promise<boolean>;
+    /** Whether `table` has a `column` (catalog lookup). */
+    hasColumn(table: string, column: string): Promise<boolean>;
+    /** The SQL expression naming the active schema/database for dialects that
+     *  introspect via `information_schema`, or `null` for the sqlite path. */
+    private currentSchemaSql;
+    private requireSqlite;
+}
+//# sourceMappingURL=schema-builder.d.ts.map

package/dist/native/schema/schema-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-builder.d.ts","sourceRoot":"","sources":["../../../src/native/schema/schema-builder.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAIrD,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAG,OAAO;IAGpC,kEAAkE;IAC5D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7E;;;;mFAI+E;IACzE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjF,sBAAsB;IAChB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrD,oBAAoB;IACd,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC,8BAA8B;IACxB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhD;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBpC;;;;;;OAMG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BpC,+CAA+C;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB/C,uDAAuD;IACjD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAehE;8EAC0E;IAC1E,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,aAAa;CAKtB"}