tempest-db-js 0.2.0 → 0.3.0

package/dist/index.d.cts

@@ -380,14 +380,14 @@ declare function del<C extends ModelClass>(model: C): DeleteBuilder<InferModel<C
  * detection, so URLs copied from a Python service still work here.
  */
 /** A database dialect tempest-db-js can target. */
-type Dialect = "sqlite" | "postgresql";
+type Dialect = "sqlite" | "postgresql" | "mysql";
 /** A parsed database URL, dialect-neutral. */
 interface ParsedDatabaseUrl {
     /** The detected dialect. */
     readonly dialect: Dialect;
     /** Driver after the `+` in the scheme (e.g. `better-sqlite3`), or `null`. */
     readonly driver: string | null;
-    /** Host (PostgreSQL), or `null` for SQLite. */
+    /** Host (PostgreSQL/MySQL), or `null` for SQLite. */
     readonly host: string | null;
     /** Port, or `null`. */
     readonly port: number | null;
@@ -610,7 +610,7 @@ type QueryNode = SelectNode | InsertNode | UpdateNode | DeleteNode | JoinNode;
  * actually differs between databases (placeholder syntax, `ILIKE` support).
  */
 declare abstract class BaseDialect {
-    abstract readonly name: "sqlite" | "postgresql";
+    abstract readonly name: Dialect;
     /**
      * INSERT SQL templates keyed by structure (dialect|table|columns|rowCount|
      * returning). Shared across dialect instances — the key namespaces by dialect
@@ -647,10 +647,19 @@ declare abstract class BaseDialect {
      * So a per-row insert loop compiles the string once and reuses it every row.
      */
     private insertTemplate;
+    /**
+     * Render the conflict-handling clause. Standard SQL (SQLite/PostgreSQL) uses
+     * `ON CONFLICT (...) DO NOTHING | DO UPDATE SET ...`; MySQL overrides this.
+     *
+     * @param onConflict The conflict clause from the node.
+     * @param conflictCols The columns to overwrite on `DO UPDATE` (empty for nothing).
+     * @param nextPlaceholder Yields the next positional placeholder (advances the count).
+     */
+    protected renderConflict(onConflict: NonNullable<InsertNode["onConflict"]>, conflictCols: readonly string[], nextPlaceholder: () => string): string;
     private compileUpdate;
     private compileDelete;
     private compileJoin;
-    private compileReturning;
+    protected compileReturning(returning: readonly string[] | "*" | null): string;
     /**
      * Compile a condition tree (fields / and / or / not) to SQL. `idFor` renders a
      * key to a quoted identifier — `quoteId` for single-table, `qualify` for joins —
@@ -672,8 +681,21 @@ declare class PostgresDialect extends BaseDialect {
     protected placeholder(index: number): string;
     protected ilike(column: string, param: string): string;
 }
+/**
+ * MySQL dialect: `?` placeholders, backtick identifiers, `ON DUPLICATE KEY
+ * UPDATE` for upsert, and case-insensitive `LIKE` (default collation). MySQL has
+ * no `RETURNING`, so requesting it throws.
+ */
+declare class MysqlDialect extends BaseDialect {
+    readonly name: "mysql";
+    protected placeholder(): string;
+    protected ilike(column: string, param: string): string;
+    protected quoteId(name: string): string;
+    protected renderConflict(onConflict: NonNullable<InsertNode["onConflict"]>, conflictCols: readonly string[], nextPlaceholder: () => string): string;
+    protected compileReturning(returning: readonly string[] | "*" | null): string;
+}
 /** Get a dialect instance by name. */
-declare function getDialect(name: "sqlite" | "postgresql"): BaseDialect;
+declare function getDialect(name: Dialect): BaseDialect;
 
 /** The outcome of running one statement. */
 interface DriverResult {
@@ -1364,4 +1386,4 @@ type InferInsert<C extends ModelClass> = Simplify<{
     [K in Exclude<ColumnKeys<InstanceType<C>>, OptionalInsertKeys<InstanceType<C>>>]: ColValue<InstanceType<C>[K]>;
 }>;
 
-export { ActiveRecord, type ActiveRecordManager, Agg, type AggregateTerm, type AsyncDriver, AsyncEngine, AsyncResult, AsyncSession, BaseDialect, BaseRepository, type BelongsTo, type ColRef, type ColType, Column, type ColumnFlags, type ColumnType, type ColumnTypeKind, type ColumnTypeMeta, type CompiledQuery, type CondNode, type Condition, type DefaultValue, DeleteBuilder, type DeleteNode, type Dialect, type DriverResult, type EngineOptions, type Executable, type HasMany, type InferInsert, type InferModel, InsertBuilder, type InsertNode, InvalidDatabaseUrl, JoinBuilder, type JoinClause, type JoinNode, type JoinOn, type JoinSelection, type JoinWhereInput, Model, type ModelClass, NoResultError, NodeSqliteDriver, OPERATORS, type OnConflict, type Operator, type OperatorsFor, type OrderTerm, type PaginationFilter, type PaginationResult, type ParsedDatabaseUrl, type PoolOptions, type PortableExpression, PostgresDialect, QueryExecutionError, type QueryLogger, type QueryNode, RecordNotFound, type Relation, type RelationValue, type ReservedAsyncDriver, type Returning, type RowOf, SelectBuilder, type SelectNode, type SortDirection, type Sources, SqliteDialect, type SyncDriver, SyncEngine, SyncResult, SyncSession, UpdateBuilder, type UpdateNode, ValidationError, type WhereArg, type WhereInput, type WithRelations, activeRecord, and, avg, belongsTo, column, columnsOf, count, createEngine, createSyncEngine, del, detectDialect, fromDict, getDialect, hasMany, insert, isCondition, join, loadRelations, max, min, not, or, parse, parseDatabaseUrl, select, sql, stringify, sum, toCondNode, toDict, toJSON, update };
+export { ActiveRecord, type ActiveRecordManager, Agg, type AggregateTerm, type AsyncDriver, AsyncEngine, AsyncResult, AsyncSession, BaseDialect, BaseRepository, type BelongsTo, type ColRef, type ColType, Column, type ColumnFlags, type ColumnType, type ColumnTypeKind, type ColumnTypeMeta, type CompiledQuery, type CondNode, type Condition, type DefaultValue, DeleteBuilder, type DeleteNode, type Dialect, type DriverResult, type EngineOptions, type Executable, type HasMany, type InferInsert, type InferModel, InsertBuilder, type InsertNode, InvalidDatabaseUrl, JoinBuilder, type JoinClause, type JoinNode, type JoinOn, type JoinSelection, type JoinWhereInput, Model, type ModelClass, MysqlDialect, NoResultError, NodeSqliteDriver, OPERATORS, type OnConflict, type Operator, type OperatorsFor, type OrderTerm, type PaginationFilter, type PaginationResult, type ParsedDatabaseUrl, type PoolOptions, type PortableExpression, PostgresDialect, QueryExecutionError, type QueryLogger, type QueryNode, RecordNotFound, type Relation, type RelationValue, type ReservedAsyncDriver, type Returning, type RowOf, SelectBuilder, type SelectNode, type SortDirection, type Sources, SqliteDialect, type SyncDriver, SyncEngine, SyncResult, SyncSession, UpdateBuilder, type UpdateNode, ValidationError, type WhereArg, type WhereInput, type WithRelations, activeRecord, and, avg, belongsTo, column, columnsOf, count, createEngine, createSyncEngine, del, detectDialect, fromDict, getDialect, hasMany, insert, isCondition, join, loadRelations, max, min, not, or, parse, parseDatabaseUrl, select, sql, stringify, sum, toCondNode, toDict, toJSON, update };

package/dist/index.d.ts

@@ -380,14 +380,14 @@ declare function del<C extends ModelClass>(model: C): DeleteBuilder<InferModel<C
  * detection, so URLs copied from a Python service still work here.
  */
 /** A database dialect tempest-db-js can target. */
-type Dialect = "sqlite" | "postgresql";
+type Dialect = "sqlite" | "postgresql" | "mysql";
 /** A parsed database URL, dialect-neutral. */
 interface ParsedDatabaseUrl {
     /** The detected dialect. */
     readonly dialect: Dialect;
     /** Driver after the `+` in the scheme (e.g. `better-sqlite3`), or `null`. */
     readonly driver: string | null;
-    /** Host (PostgreSQL), or `null` for SQLite. */
+    /** Host (PostgreSQL/MySQL), or `null` for SQLite. */
     readonly host: string | null;
     /** Port, or `null`. */
     readonly port: number | null;
@@ -610,7 +610,7 @@ type QueryNode = SelectNode | InsertNode | UpdateNode | DeleteNode | JoinNode;
  * actually differs between databases (placeholder syntax, `ILIKE` support).
  */
 declare abstract class BaseDialect {
-    abstract readonly name: "sqlite" | "postgresql";
+    abstract readonly name: Dialect;
     /**
      * INSERT SQL templates keyed by structure (dialect|table|columns|rowCount|
      * returning). Shared across dialect instances — the key namespaces by dialect
@@ -647,10 +647,19 @@ declare abstract class BaseDialect {
      * So a per-row insert loop compiles the string once and reuses it every row.
      */
     private insertTemplate;
+    /**
+     * Render the conflict-handling clause. Standard SQL (SQLite/PostgreSQL) uses
+     * `ON CONFLICT (...) DO NOTHING | DO UPDATE SET ...`; MySQL overrides this.
+     *
+     * @param onConflict The conflict clause from the node.
+     * @param conflictCols The columns to overwrite on `DO UPDATE` (empty for nothing).
+     * @param nextPlaceholder Yields the next positional placeholder (advances the count).
+     */
+    protected renderConflict(onConflict: NonNullable<InsertNode["onConflict"]>, conflictCols: readonly string[], nextPlaceholder: () => string): string;
     private compileUpdate;
     private compileDelete;
     private compileJoin;
-    private compileReturning;
+    protected compileReturning(returning: readonly string[] | "*" | null): string;
     /**
      * Compile a condition tree (fields / and / or / not) to SQL. `idFor` renders a
      * key to a quoted identifier — `quoteId` for single-table, `qualify` for joins —
@@ -672,8 +681,21 @@ declare class PostgresDialect extends BaseDialect {
     protected placeholder(index: number): string;
     protected ilike(column: string, param: string): string;
 }
+/**
+ * MySQL dialect: `?` placeholders, backtick identifiers, `ON DUPLICATE KEY
+ * UPDATE` for upsert, and case-insensitive `LIKE` (default collation). MySQL has
+ * no `RETURNING`, so requesting it throws.
+ */
+declare class MysqlDialect extends BaseDialect {
+    readonly name: "mysql";
+    protected placeholder(): string;
+    protected ilike(column: string, param: string): string;
+    protected quoteId(name: string): string;
+    protected renderConflict(onConflict: NonNullable<InsertNode["onConflict"]>, conflictCols: readonly string[], nextPlaceholder: () => string): string;
+    protected compileReturning(returning: readonly string[] | "*" | null): string;
+}
 /** Get a dialect instance by name. */
-declare function getDialect(name: "sqlite" | "postgresql"): BaseDialect;
+declare function getDialect(name: Dialect): BaseDialect;
 
 /** The outcome of running one statement. */
 interface DriverResult {
@@ -1364,4 +1386,4 @@ type InferInsert<C extends ModelClass> = Simplify<{
     [K in Exclude<ColumnKeys<InstanceType<C>>, OptionalInsertKeys<InstanceType<C>>>]: ColValue<InstanceType<C>[K]>;
 }>;
 
-export { ActiveRecord, type ActiveRecordManager, Agg, type AggregateTerm, type AsyncDriver, AsyncEngine, AsyncResult, AsyncSession, BaseDialect, BaseRepository, type BelongsTo, type ColRef, type ColType, Column, type ColumnFlags, type ColumnType, type ColumnTypeKind, type ColumnTypeMeta, type CompiledQuery, type CondNode, type Condition, type DefaultValue, DeleteBuilder, type DeleteNode, type Dialect, type DriverResult, type EngineOptions, type Executable, type HasMany, type InferInsert, type InferModel, InsertBuilder, type InsertNode, InvalidDatabaseUrl, JoinBuilder, type JoinClause, type JoinNode, type JoinOn, type JoinSelection, type JoinWhereInput, Model, type ModelClass, NoResultError, NodeSqliteDriver, OPERATORS, type OnConflict, type Operator, type OperatorsFor, type OrderTerm, type PaginationFilter, type PaginationResult, type ParsedDatabaseUrl, type PoolOptions, type PortableExpression, PostgresDialect, QueryExecutionError, type QueryLogger, type QueryNode, RecordNotFound, type Relation, type RelationValue, type ReservedAsyncDriver, type Returning, type RowOf, SelectBuilder, type SelectNode, type SortDirection, type Sources, SqliteDialect, type SyncDriver, SyncEngine, SyncResult, SyncSession, UpdateBuilder, type UpdateNode, ValidationError, type WhereArg, type WhereInput, type WithRelations, activeRecord, and, avg, belongsTo, column, columnsOf, count, createEngine, createSyncEngine, del, detectDialect, fromDict, getDialect, hasMany, insert, isCondition, join, loadRelations, max, min, not, or, parse, parseDatabaseUrl, select, sql, stringify, sum, toCondNode, toDict, toJSON, update };
+export { ActiveRecord, type ActiveRecordManager, Agg, type AggregateTerm, type AsyncDriver, AsyncEngine, AsyncResult, AsyncSession, BaseDialect, BaseRepository, type BelongsTo, type ColRef, type ColType, Column, type ColumnFlags, type ColumnType, type ColumnTypeKind, type ColumnTypeMeta, type CompiledQuery, type CondNode, type Condition, type DefaultValue, DeleteBuilder, type DeleteNode, type Dialect, type DriverResult, type EngineOptions, type Executable, type HasMany, type InferInsert, type InferModel, InsertBuilder, type InsertNode, InvalidDatabaseUrl, JoinBuilder, type JoinClause, type JoinNode, type JoinOn, type JoinSelection, type JoinWhereInput, Model, type ModelClass, MysqlDialect, NoResultError, NodeSqliteDriver, OPERATORS, type OnConflict, type Operator, type OperatorsFor, type OrderTerm, type PaginationFilter, type PaginationResult, type ParsedDatabaseUrl, type PoolOptions, type PortableExpression, PostgresDialect, QueryExecutionError, type QueryLogger, type QueryNode, RecordNotFound, type Relation, type RelationValue, type ReservedAsyncDriver, type Returning, type RowOf, SelectBuilder, type SelectNode, type SortDirection, type Sources, SqliteDialect, type SyncDriver, SyncEngine, SyncResult, SyncSession, UpdateBuilder, type UpdateNode, ValidationError, type WhereArg, type WhereInput, type WithRelations, activeRecord, and, avg, belongsTo, column, columnsOf, count, createEngine, createSyncEngine, del, detectDialect, fromDict, getDialect, hasMany, insert, isCondition, join, loadRelations, max, min, not, or, parse, parseDatabaseUrl, select, sql, stringify, sum, toCondNode, toDict, toJSON, update };

package/dist/index.js

@@ -1,3 +1,3 @@
-export { ActiveRecord, Agg, AsyncEngine, AsyncResult, AsyncSession, BaseDialect, BaseRepository, Column, DeleteBuilder, InsertBuilder, InvalidDatabaseUrl, JoinBuilder, Model, NoResultError, NodeSqliteDriver, OPERATORS, PostgresDialect, QueryExecutionError, RecordNotFound, SelectBuilder, SqliteDialect, SyncEngine, SyncResult, SyncSession, UpdateBuilder, ValidationError, activeRecord, and, avg, belongsTo, column, columnsOf, count, createEngine, createSyncEngine, del, detectDialect, fromDict, getDialect, hasMany, insert, isCondition, join, loadRelations, max, min, not, or, parse, parseDatabaseUrl, select, sql, stringify, sum, toCondNode, toDict, toJSON, update } from './chunk-AGDD7K3F.js';
+export { ActiveRecord, Agg, AsyncEngine, AsyncResult, AsyncSession, BaseDialect, BaseRepository, Column, DeleteBuilder, InsertBuilder, InvalidDatabaseUrl, JoinBuilder, Model, MysqlDialect, NoResultError, NodeSqliteDriver, OPERATORS, PostgresDialect, QueryExecutionError, RecordNotFound, SelectBuilder, SqliteDialect, SyncEngine, SyncResult, SyncSession, UpdateBuilder, ValidationError, activeRecord, and, avg, belongsTo, column, columnsOf, count, createEngine, createSyncEngine, del, detectDialect, fromDict, getDialect, hasMany, insert, isCondition, join, loadRelations, max, min, not, or, parse, parseDatabaseUrl, select, sql, stringify, sum, toCondNode, toDict, toJSON, update } from './chunk-Q32CBI2A.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/migrations/index.cjs

@@ -140,8 +140,8 @@ function invertAll(ops) {
 }
 
 // src/migrations/ddl.ts
-function quoteId(name) {
-  return `"${name.replace(/"/g, '""')}"`;
+function quoteId(name, dialect) {
+  return dialect === "mysql" ? `\`${name.replace(/`/g, "``")}\`` : `"${name.replace(/"/g, '""')}"`;
 }
 function quoteLiteral(value) {
   return `'${value.replace(/'/g, "''")}'`;
@@ -166,6 +166,45 @@ function renderColumnType(type, dialect) {
         return "TEXT";
     }
   }
+  if (dialect === "mysql") {
+    switch (kind) {
+      case "smallint":
+        return "SMALLINT";
+      case "integer":
+        return "INT";
+      case "bigint":
+        return "BIGINT";
+      case "numeric":
+        return meta.precision !== void 0 ? `DECIMAL(${meta.precision}${meta.scale !== void 0 ? `, ${meta.scale}` : ""})` : "DECIMAL";
+      case "real":
+        return "FLOAT";
+      case "double":
+        return "DOUBLE";
+      case "varchar":
+        return `VARCHAR(${meta.length ?? 255})`;
+      case "char":
+        return `CHAR(${meta.length ?? 255})`;
+      case "text":
+        return "TEXT";
+      case "boolean":
+        return "TINYINT(1)";
+      case "date":
+        return "DATE";
+      case "time":
+        return "TIME";
+      case "datetime":
+      case "timestamp":
+        return "DATETIME";
+      case "blob":
+        return "BLOB";
+      case "json":
+        return "JSON";
+      case "uuid":
+        return "CHAR(36)";
+      case "enum":
+        return `ENUM(${(meta.values ?? []).map(quoteLiteral).join(", ")})`;
+    }
+  }
   switch (kind) {
     case "smallint":
       return "SMALLINT";
@@ -210,19 +249,21 @@ function renderDefault(def, dialect) {
     if (typeof expr === "object") return expr.raw;
     switch (expr) {
       case "now":
-        return dialect === "sqlite" ? "CURRENT_TIMESTAMP" : "now()";
+        return dialect === "postgresql" ? "now()" : "CURRENT_TIMESTAMP";
       case "current_date":
         return "CURRENT_DATE";
       case "current_time":
         return "CURRENT_TIME";
       case "uuidv4":
-        return dialect === "sqlite" ? "(lower(hex(randomblob(16))))" : "gen_random_uuid()";
+        if (dialect === "postgresql") return "gen_random_uuid()";
+        if (dialect === "mysql") return "(UUID())";
+        return "(lower(hex(randomblob(16))))";
     }
   }
   const value = def.value;
   if (value === null) return "NULL";
   if (typeof value === "boolean") {
-    return dialect === "sqlite" ? value ? "1" : "0" : value ? "TRUE" : "FALSE";
+    return dialect === "postgresql" ? value ? "TRUE" : "FALSE" : value ? "1" : "0";
   }
   if (typeof value === "number" || typeof value === "bigint") return String(value);
   if (value instanceof Date) return quoteLiteral(value.toISOString());
@@ -230,7 +271,7 @@ function renderDefault(def, dialect) {
   return quoteLiteral(String(value));
 }
 function renderColumnDef(col, dialect) {
-  let sql = `${quoteId(col.name)} ${renderColumnType(col.type, dialect)}`;
+  let sql = `${quoteId(col.name, dialect)} ${renderColumnType(col.type, dialect)}`;
   if (col.notNull) sql += " NOT NULL";
   if (col.default !== null) sql += ` DEFAULT ${renderDefault(col.default, dialect)}`;
   return sql;
@@ -252,23 +293,28 @@ function renderCreateTable(table, dialect) {
     if (dialect === "postgresql" && c.type.kind === "enum") {
       const typeName = enumTypeName(table.name, c.name);
       const values = (c.type.meta.values ?? []).map(quoteLiteral).join(", ");
-      typeStmts.push(`CREATE TYPE ${quoteId(typeName)} AS ENUM (${values})`);
-      let def = `${quoteId(c.name)} ${quoteId(typeName)}`;
+      typeStmts.push(`CREATE TYPE ${quoteId(typeName, dialect)} AS ENUM (${values})`);
+      let def = `${quoteId(c.name, dialect)} ${quoteId(typeName, dialect)}`;
       if (c.notNull) def += " NOT NULL";
       if (c.default !== null) def += ` DEFAULT ${renderDefault(c.default, dialect)}`;
       return def;
     }
     if (dialect === "postgresql" && isAutoIncrementPk(table, c)) {
-      return `${quoteId(c.name)} ${postgresSerialType(c.type.kind)}`;
+      return `${quoteId(c.name, dialect)} ${postgresSerialType(c.type.kind)}`;
+    }
+    if (dialect === "mysql" && isAutoIncrementPk(table, c)) {
+      return `${quoteId(c.name, dialect)} ${renderColumnType(c.type, dialect)} NOT NULL AUTO_INCREMENT`;
     }
     return renderColumnDef(c, dialect);
   });
   if (table.primaryKey.length > 0) {
-    cols.push(`PRIMARY KEY (${table.primaryKey.map(quoteId).join(", ")})`);
+    cols.push(
+      `PRIMARY KEY (${table.primaryKey.map((c) => quoteId(c, dialect)).join(", ")})`
+    );
   }
   return [
     ...typeStmts,
-    `CREATE TABLE ${quoteId(table.name)} (
+    `CREATE TABLE ${quoteId(table.name, dialect)} (
   ${cols.join(",\n  ")}
 )`
   ];
@@ -278,23 +324,27 @@ function renderOperation(op, dialect) {
     case "create_table":
       return renderCreateTable(op.table, dialect);
     case "drop_table":
-      return [`DROP TABLE ${quoteId(op.table.name)}`];
+      return [`DROP TABLE ${quoteId(op.table.name, dialect)}`];
     case "rename_table":
-      return [`ALTER TABLE ${quoteId(op.from)} RENAME TO ${quoteId(op.to)}`];
+      return dialect === "mysql" ? [`RENAME TABLE ${quoteId(op.from, dialect)} TO ${quoteId(op.to, dialect)}`] : [
+        `ALTER TABLE ${quoteId(op.from, dialect)} RENAME TO ${quoteId(op.to, dialect)}`
+      ];
     case "add_column":
       return [
-        `ALTER TABLE ${quoteId(op.table)} ADD COLUMN ${renderColumnDef(op.column, dialect)}`
+        `ALTER TABLE ${quoteId(op.table, dialect)} ADD COLUMN ${renderColumnDef(op.column, dialect)}`
       ];
     case "drop_column":
-      return [`ALTER TABLE ${quoteId(op.table)} DROP COLUMN ${quoteId(op.column.name)}`];
+      return [
+        `ALTER TABLE ${quoteId(op.table, dialect)} DROP COLUMN ${quoteId(op.column.name, dialect)}`
+      ];
     case "rename_column":
       return [
-        `ALTER TABLE ${quoteId(op.table)} RENAME COLUMN ${quoteId(op.from)} TO ${quoteId(op.to)}`
+        `ALTER TABLE ${quoteId(op.table, dialect)} RENAME COLUMN ${quoteId(op.from, dialect)} TO ${quoteId(op.to, dialect)}`
       ];
     case "alter_column":
       return renderAlterColumn(op.table, op.to, dialect);
     case "recreate_table":
-      return dialect === "sqlite" ? renderSqliteRebuild(op.from, op.to) : renderPostgresTableDiff(op.from, op.to);
+      return dialect === "sqlite" ? renderSqliteRebuild(op.from, op.to) : renderTableDiff(op.from, op.to, dialect);
     case "execute":
       return [op.up];
   }
@@ -304,34 +354,38 @@ function renderSqliteRebuild(from, to) {
   const common = Object.keys(to.columns).filter((c) => c in from.columns);
   const cols = Object.values(to.columns).map((c) => renderColumnDef(c, "sqlite"));
   if (to.primaryKey.length > 0) {
-    cols.push(`PRIMARY KEY (${to.primaryKey.map(quoteId).join(", ")})`);
+    cols.push(
+      `PRIMARY KEY (${to.primaryKey.map((c) => quoteId(c, "sqlite")).join(", ")})`
+    );
   }
-  const commonSql = common.map(quoteId).join(", ");
+  const commonSql = common.map((c) => quoteId(c, "sqlite")).join(", ");
   return [
     "PRAGMA foreign_keys=off",
-    `CREATE TABLE ${quoteId(tmp)} (
+    `CREATE TABLE ${quoteId(tmp, "sqlite")} (
   ${cols.join(",\n  ")}
 )`,
-    common.length > 0 ? `INSERT INTO ${quoteId(tmp)} (${commonSql}) SELECT ${commonSql} FROM ${quoteId(from.name)}` : `-- no common columns to copy from ${from.name}`,
-    `DROP TABLE ${quoteId(from.name)}`,
-    `ALTER TABLE ${quoteId(tmp)} RENAME TO ${quoteId(to.name)}`,
+    common.length > 0 ? `INSERT INTO ${quoteId(tmp, "sqlite")} (${commonSql}) SELECT ${commonSql} FROM ${quoteId(from.name, "sqlite")}` : `-- no common columns to copy from ${from.name}`,
+    `DROP TABLE ${quoteId(from.name, "sqlite")}`,
+    `ALTER TABLE ${quoteId(tmp, "sqlite")} RENAME TO ${quoteId(to.name, "sqlite")}`,
     "PRAGMA foreign_keys=on"
   ];
 }
-function renderPostgresTableDiff(from, to) {
+function renderTableDiff(from, to, dialect) {
   const stmts = [];
   for (const [name, col] of Object.entries(to.columns)) {
     if (!(name in from.columns)) {
       stmts.push(
-        `ALTER TABLE ${quoteId(to.name)} ADD COLUMN ${renderColumnDef(col, "postgresql")}`
+        `ALTER TABLE ${quoteId(to.name, dialect)} ADD COLUMN ${renderColumnDef(col, dialect)}`
       );
     } else {
-      stmts.push(...renderAlterColumn(to.name, col, "postgresql"));
+      stmts.push(...renderAlterColumn(to.name, col, dialect));
     }
   }
   for (const name of Object.keys(from.columns)) {
     if (!(name in to.columns)) {
-      stmts.push(`ALTER TABLE ${quoteId(to.name)} DROP COLUMN ${quoteId(name)}`);
+      stmts.push(
+        `ALTER TABLE ${quoteId(to.name, dialect)} DROP COLUMN ${quoteId(name, dialect)}`
+      );
     }
   }
   return stmts;
@@ -339,11 +393,16 @@ function renderPostgresTableDiff(from, to) {
 function renderAlterColumn(table, to, dialect) {
   if (dialect === "sqlite") {
     throw new Error(
-      `alter_column on SQLite needs batch/table-rebuild (Phase 6e); column ${table}.${to.name}`
+      `alter_column on SQLite needs a table-rebuild (recreate_table); column ${table}.${to.name}`
     );
   }
-  const t = quoteId(table);
-  const c = quoteId(to.name);
+  if (dialect === "mysql") {
+    return [
+      `ALTER TABLE ${quoteId(table, dialect)} MODIFY COLUMN ${renderColumnDef(to, dialect)}`
+    ];
+  }
+  const t = quoteId(table, dialect);
+  const c = quoteId(to.name, dialect);
   const stmts = [
     `ALTER TABLE ${t} ALTER COLUMN ${c} TYPE ${renderColumnType(to.type, dialect)}`
   ];
@@ -634,6 +693,112 @@ var MigrationRunner = class {
     return reverted;
   }
 };
+function quoteIdent(name, dialect) {
+  return dialect === "mysql" ? `\`${name.replace(/`/g, "``")}\`` : `"${name.replace(/"/g, '""')}"`;
+}
+function placeholder(index, dialect) {
+  return dialect === "postgresql" ? `$${index}` : "?";
+}
+var AsyncMigrationRunner = class {
+  constructor(driver, dialect) {
+    this.driver = driver;
+    this.dialect = dialect;
+    this.vt = quoteIdent(VERSION_TABLE, dialect);
+  }
+  driver;
+  dialect;
+  vt;
+  /** Create the version-tracking table if it does not exist. */
+  async ensureVersionTable() {
+    await this.driver.execute(
+      `CREATE TABLE IF NOT EXISTS ${this.vt} (revision ${this.textType()} PRIMARY KEY, applied_at ${this.textType()} NOT NULL, down_revision ${this.textType()} NOT NULL)`,
+      []
+    );
+  }
+  /** A portable "text" column type for the version table. */
+  textType() {
+    return this.dialect === "mysql" ? "VARCHAR(255)" : "TEXT";
+  }
+  /** The set of applied revision ids. */
+  async applied() {
+    await this.ensureVersionTable();
+    const { rows } = await this.driver.execute(`SELECT revision FROM ${this.vt}`, []);
+    return new Set(rows.map((r) => String(r.revision)));
+  }
+  async runOps(ops) {
+    for (const op of ops) {
+      for (const stmt of renderOperation(op, this.dialect)) {
+        const trimmed = stmt.trim();
+        if (trimmed.length === 0 || trimmed.startsWith("--")) continue;
+        await this.driver.execute(stmt, []);
+      }
+    }
+  }
+  async record(migration, appliedAt) {
+    const p = (i) => placeholder(i, this.dialect);
+    await this.driver.execute(
+      `INSERT INTO ${this.vt} (revision, applied_at, down_revision) VALUES (${p(1)}, ${p(2)}, ${p(3)})`,
+      [migration.revision, appliedAt, migration.downRevision.join(",")]
+    );
+  }
+  async forget(revision) {
+    await this.driver.execute(
+      `DELETE FROM ${this.vt} WHERE revision = ${placeholder(1, this.dialect)}`,
+      [revision]
+    );
+  }
+  /**
+   * Apply all pending migrations up to the head(s), in DAG order.
+   *
+   * @param migrations All known migrations.
+   * @param appliedAt Timestamp string to stamp on each applied revision.
+   * @returns The revision ids that were applied this run.
+   */
+  async upgrade(migrations, appliedAt) {
+    const done = await this.applied();
+    const ordered = topoOrder(migrations);
+    const ran = [];
+    for (const migration of ordered) {
+      if (done.has(migration.revision)) continue;
+      const op = new Op();
+      migration.up(op);
+      await this.runOps(op.operations);
+      await this.record(migration, appliedAt);
+      ran.push(migration.revision);
+    }
+    return ran;
+  }
+  /**
+   * Revert the last `steps` applied migrations (default 1), newest first.
+   *
+   * @param migrations All known migrations.
+   * @param steps How many applied revisions to roll back.
+   * @returns The revision ids that were reverted.
+   */
+  async downgrade(migrations, steps = 1) {
+    const done = await this.applied();
+    const ordered = topoOrder(migrations).filter((m) => done.has(m.revision));
+    const toRevert = ordered.slice(-steps).reverse();
+    const reverted = [];
+    for (const migration of toRevert) {
+      const op = new Op();
+      try {
+        migration.down(op);
+      } catch {
+        op.operations.length = 0;
+      }
+      if (op.operations.length === 0) {
+        const upOp = new Op();
+        migration.up(upOp);
+        op.operations.push(...invertAll(upOp.operations));
+      }
+      await this.runOps(op.operations);
+      await this.forget(migration.revision);
+      reverted.push(migration.revision);
+    }
+    return reverted;
+  }
+};
 
 // src/migrations/introspect.ts
 function sqliteAffinity(declared) {
@@ -1123,6 +1288,7 @@ function runMigrationCli(argv, config) {
   }
 }
 
+exports.AsyncMigrationRunner = AsyncMigrationRunner;
 exports.CyclicMigrationGraph = CyclicMigrationGraph;
 exports.IrreversibleMigration = IrreversibleMigration;
 exports.MigrationRunner = MigrationRunner;