bun-query-builder 0.1.37 → 0.1.39

package/dist/drivers/mysql.d.ts

@@ -1,4 +1,4 @@
-import type { ColumnPlan, IndexPlan, TablePlan } from '../migrations';
+import type { ColumnPlan, IndexPlan, RebuildTableSpec, TablePlan } from '../migrations';
 export declare interface DialectDriver {
   createEnumType: (enumTypeName: string, values: string[]) => string
   createTable: (table: TablePlan) => string
@@ -6,6 +6,9 @@ export declare interface DialectDriver {
   addForeignKey: (tableName: string, columnName: string, refTable: string, refColumn: string, onDelete?: string, onUpdate?: string) => string
   addColumn: (tableName: string, column: ColumnPlan) => string
   modifyColumn: (tableName: string, column: ColumnPlan) => string
+  renameColumn: (tableName: string, from: string, to: string) => string
+  renameTable: (from: string, to: string) => string
+  rebuildTable: (spec: RebuildTableSpec) => string
   dropTable: (tableName: string) => string
   dropColumn: (tableName: string, columnName: string) => string
   dropIndex: (tableName: string, indexName: string) => string
@@ -21,6 +24,9 @@ export declare class MySQLDriver implements DialectDriver {
   addForeignKey(tableName: string, columnName: string, refTable: string, refColumn: string, onDelete?: string, onUpdate?: string): string;
   addColumn(tableName: string, column: ColumnPlan): string;
   modifyColumn(tableName: string, column: ColumnPlan): string;
+  renameColumn(tableName: string, from: string, to: string): string;
+  renameTable(from: string, to: string): string;
+  rebuildTable(): string;
   dropTable(tableName: string): string;
   dropColumn(tableName: string, columnName: string): string;
   dropIndex(tableName: string, indexName: string): string;

package/dist/drivers/postgres.d.ts

@@ -1,4 +1,4 @@
-import type { ColumnPlan, IndexPlan, TablePlan } from '../migrations';
+import type { ColumnPlan, IndexPlan, RebuildTableSpec, TablePlan } from '../migrations';
 export declare interface DialectDriver {
   createEnumType: (enumTypeName: string, values: string[]) => string
   createTable: (table: TablePlan) => string
@@ -6,6 +6,9 @@ export declare interface DialectDriver {
   addForeignKey: (tableName: string, columnName: string, refTable: string, refColumn: string, onDelete?: string, onUpdate?: string) => string
   addColumn: (tableName: string, column: ColumnPlan) => string
   modifyColumn: (tableName: string, column: ColumnPlan) => string
+  renameColumn: (tableName: string, from: string, to: string) => string
+  renameTable: (from: string, to: string) => string
+  rebuildTable: (spec: RebuildTableSpec) => string
   dropTable: (tableName: string) => string
   dropColumn: (tableName: string, columnName: string) => string
   dropIndex: (tableName: string, indexName: string) => string
@@ -21,6 +24,9 @@ export declare class PostgresDriver implements DialectDriver {
   addForeignKey(tableName: string, columnName: string, refTable: string, refColumn: string, onDelete?: string, onUpdate?: string): string;
   addColumn(tableName: string, column: ColumnPlan): string;
   modifyColumn(tableName: string, column: ColumnPlan): string;
+  renameColumn(tableName: string, from: string, to: string): string;
+  renameTable(from: string, to: string): string;
+  rebuildTable(): string;
   dropTable(tableName: string): string;
   dropColumn(tableName: string, columnName: string): string;
   dropIndex(tableName: string, indexName: string): string;

package/dist/drivers/sqlite.d.ts

@@ -1,4 +1,4 @@
-import type { ColumnPlan, IndexPlan, TablePlan } from '../migrations';
+import type { ColumnPlan, IndexPlan, RebuildTableSpec, TablePlan } from '../migrations';
 export declare interface DialectDriver {
   createEnumType: (enumTypeName: string, values: string[]) => string
   createTable: (table: TablePlan) => string
@@ -6,6 +6,9 @@ export declare interface DialectDriver {
   addForeignKey: (tableName: string, columnName: string, refTable: string, refColumn: string, onDelete?: string, onUpdate?: string) => string
   addColumn: (tableName: string, column: ColumnPlan) => string
   modifyColumn: (tableName: string, column: ColumnPlan) => string
+  renameColumn: (tableName: string, from: string, to: string) => string
+  renameTable: (from: string, to: string) => string
+  rebuildTable: (spec: RebuildTableSpec) => string
   dropTable: (tableName: string) => string
   dropColumn: (tableName: string, columnName: string) => string
   dropIndex: (tableName: string, indexName: string) => string
@@ -21,6 +24,9 @@ export declare class SQLiteDriver implements DialectDriver {
   addForeignKey(_tableName: string, _columnName: string, _refTable: string, _refColumn: string, _onDelete?: string, _onUpdate?: string): string;
   addColumn(tableName: string, column: ColumnPlan): string;
   modifyColumn(tableName: string, column: ColumnPlan): string;
+  renameColumn(tableName: string, from: string, to: string): string;
+  renameTable(from: string, to: string): string;
+  rebuildTable(spec: RebuildTableSpec): string;
   dropTable(tableName: string): string;
   dropColumn(tableName: string, columnName: string): string;
   dropIndex(tableName: string, indexName: string): string;

package/dist/migrations.d.ts

@@ -1,7 +1,7 @@
 import type { ModelRecord, OnForeignKeyAction } from './schema';
 import type { SupportedDialect } from './types';
 export declare function buildMigrationPlan(models: ModelRecord, options: InferenceOptions): MigrationPlan;
-export declare function generateSql(plan: MigrationPlan): string[];
+export declare function generateSql(plan: MigrationPlan, opts?: { dryRun?: boolean }): string[];
 /**
  * Helper function to convert SQL statements array to a single string (for backward compatibility)
  */
@@ -15,18 +15,42 @@ export declare function generateDiffSqlString(previous: MigrationPlan | undefine
  */
 export declare function hashMigrationPlan(plan: MigrationPlan): string;
 /**
- * Generate comprehensive SQL to migrate from a previous plan to a new plan.
- * - Creates new tables
- * - Drops removed tables
- * - Adds new columns
- * - Drops removed columns
- * - Adds new indexes
- * - Drops removed indexes
- * - Adds new foreign keys for newly added columns
+ * The dialect's *physical* storage type for a column. Two model types that
+ * collapse to the same physical type produce no real schema change, so the
+ * diff should ignore the difference. This is what keeps the live-DB
+ * introspection path (where the exact model type can't be recovered) from
+ * emitting spurious ALTERs on every run.
+ *
+ * SQLite is the lossy one (string/text/date/datetime/json all map to TEXT;
+ * boolean/integer/bigint to INTEGER; float/double/decimal to REAL). For
+ * Postgres/MySQL the normalized type round-trips faithfully enough to compare
+ * directly.
+ */
+export declare function canonicalStorageType(col: ColumnPlan, dialect: SupportedDialect): string;
+/**
+ * Canonical string form of a column default, so equivalent defaults expressed
+ * differently by a live DB vs a model (quoting, casts, `now()` vs
+ * `CURRENT_TIMESTAMP`, `0` vs `'0'`) compare equal.
+ */
+export declare function canonicalizeDefault(col: ColumnPlan): string | undefined;
+/**
+ * Generate comprehensive SQL to migrate from a previous plan to a new plan,
+ * plus a structured list of the operations involved (so callers can gate
+ * destructive changes and report renames without re-parsing SQL).
+ *
+ * Handles: created/dropped tables, added/dropped/renamed/modified columns,
+ * added/dropped indexes, foreign-key changes, and — on SQLite — table rebuilds
+ * for changes the dialect can't do in place.
  *
  * If there is no previous plan or the dialect changed, generates full SQL.
  */
-export declare function generateDiffSql(previous: MigrationPlan | undefined, next: MigrationPlan): string[];
+export declare function generateDiffOperations(previous: MigrationPlan | undefined, next: MigrationPlan, opts?: DiffOptions): DiffResult;
+/**
+ * Generate comprehensive SQL to migrate from a previous plan to a new plan.
+ * Thin wrapper over {@link generateDiffOperations} preserved for existing
+ * callers that only need the raw statements.
+ */
+export declare function generateDiffSql(previous: MigrationPlan | undefined, next: MigrationPlan, opts?: DiffOptions): string[];
 export declare interface ColumnPlan {
   name: string
   type: NormalizedColumnType
@@ -53,9 +77,46 @@ export declare interface MigrationPlan {
   dialect: SupportedDialect
   tables: TablePlan[]
 }
+/**
+ * Inputs for a SQLite table rebuild ("12-step recreate"). SQLite can't
+ * `ALTER COLUMN` to change a type, and can't `DROP COLUMN` when the column
+ * is a PK / unique / indexed / FK target. The fix is to create a new table
+ * with the desired schema, copy data across, drop the old table, and rename
+ * the new one into place. See `SQLiteDriver.rebuildTable`.
+ */
+export declare interface RebuildTableSpec {
+  target: TablePlan
+  tempName: string
+  columnSource: Record<string, string>
+}
+/**
+ * A structured description of one change emitted by the diff engine. Callers
+ * (e.g. the Stacks `buddy migrate` command) inspect these to gate destructive
+ * changes behind confirmation and to surface rename candidates, instead of
+ * re-parsing the raw SQL strings.
+ */
+export declare interface MigrationOperation {
+  kind: MigrationOpKind
+  table: string
+  column?: string
+  from?: string
+  to?: string
+  destructive: boolean
+  confidence?: 'high' | 'low'
+  sql: string
+}
+/** Result of {@link generateDiffOperations}: raw statements + structured ops. */
+export declare interface DiffResult {
+  statements: string[]
+  operations: MigrationOperation[]
+}
 export declare interface InferenceOptions {
   dialect: SupportedDialect
 }
+export declare interface DiffOptions {
+  applyRenames?: boolean
+  dryRun?: boolean
+}
 export type PrimitiveDefault = string | number | boolean | bigint | Date;
 export type NormalizedColumnType = | 'string'
   | 'text'
@@ -69,3 +130,16 @@ export type NormalizedColumnType = | 'string'
   | 'datetime'
   | 'json'
   | 'enum';
+/** The kind of schema change a single migration operation represents. */
+export type MigrationOpKind = | 'create_table'
+  | 'drop_table'
+  | 'rename_table'
+  | 'add_column'
+  | 'drop_column'
+  | 'modify_column'
+  | 'rename_column'
+  | 'create_index'
+  | 'drop_index'
+  | 'add_foreign_key'
+  | 'rebuild_table'
+  | 'create_enum';