tempest-db-js 0.2.0 → 0.3.0

package/dist/migrations/index.d.cts

@@ -1,4 +1,4 @@
-import { ColumnType, DefaultValue, ModelClass, Dialect, SyncDriver, AsyncDriver } from '../index.cjs';
+import { ColumnType, DefaultValue, ModelClass, Dialect, AsyncDriver, SyncDriver } from '../index.cjs';
 
 /**
  * tempest-db-js — Phase 6: the Schema IR (intermediate representation).
@@ -106,11 +106,11 @@ declare function invert(op: Operation): Operation;
 declare function invertAll(ops: readonly Operation[]): Operation[];
 
 /**
- * tempest-db-js — Phase 6: DDL rendering.
+ * tempest-db-js — Phase 6/9: DDL rendering.
  *
  * Renders the dialect-neutral IR + operations to concrete SQL per dialect. This
  * is the ONLY place migration SQL is produced — the same operation yields the
- * right DDL for SQLite or PostgreSQL.
+ * right DDL for SQLite, PostgreSQL or MySQL.
  */
 
 /** Map a column type to its SQL type string for the dialect. */
@@ -126,7 +126,7 @@ declare function renderColumnDef(col: ColumnIR, dialect: Dialect): string;
  * @param dialect The target dialect.
  * @returns The SQL statements (usually one).
  * @throws Error When the operation is unsupported on the dialect (e.g. SQLite
- *   `alter_column`, which needs the Phase 6e batch/table-rebuild path).
+ *   `alter_column`, which needs the table-rebuild path).
  */
 declare function renderOperation(op: Operation, dialect: Dialect): string[];
 
@@ -280,6 +280,43 @@ declare class MigrationRunner {
      */
     downgrade(migrations: readonly Migration[], steps?: number): string[];
 }
+/**
+ * Runs migrations against an **async** driver (PostgreSQL, or any async driver),
+ * tracking applied revisions. Mirrors {@link MigrationRunner} but every statement
+ * is awaited, and identifier quoting + placeholder style follow the dialect —
+ * so the version table and its bookkeeping are portable across SQLite/PG/MySQL.
+ */
+declare class AsyncMigrationRunner {
+    private readonly driver;
+    private readonly dialect;
+    private readonly vt;
+    constructor(driver: AsyncDriver, dialect: Dialect);
+    /** Create the version-tracking table if it does not exist. */
+    ensureVersionTable(): Promise<void>;
+    /** A portable "text" column type for the version table. */
+    private textType;
+    /** The set of applied revision ids. */
+    applied(): Promise<Set<string>>;
+    private runOps;
+    private record;
+    private forget;
+    /**
+     * 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.
+     */
+    upgrade(migrations: readonly Migration[], appliedAt: string): Promise<string[]>;
+    /**
+     * 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.
+     */
+    downgrade(migrations: readonly Migration[], steps?: number): Promise<string[]>;
+}
 
 /**
  * tempest-db-js — Phase 6d: SQLite introspection + drift detection.
@@ -462,4 +499,4 @@ declare function defineMigrationConfig(config: CliConfig): CliConfig;
  */
 declare function runMigrationCli(argv: readonly string[], config: CliConfig): CliResult;
 
-export { type CliConfig, type CliResult, type ColumnIR, CyclicMigrationGraph, type DefaultIR, IrreversibleMigration, type Migration, type MigrationDraft, MigrationRunner, Op, type Operation, type RenameCandidate, type RevisionNode, type SchemaIR, type SqliteAffinity, type TableIR, UnknownRevision, applyOperation, applyRenames, checkDrift, checkDriftPostgres, defineMigrationConfig, detectRenames, diffSchema, emptySchema, generateMigration, heads, introspectPostgres, introspectSqlite, invert, invertAll, makeRevisionId, reflectSchema, reflectTable, renderColumnDef, renderColumnType, renderDefault, renderOperation, replaySchema, runMigrationCli, sqliteAffinity, topoOrder };
+export { AsyncMigrationRunner, type CliConfig, type CliResult, type ColumnIR, CyclicMigrationGraph, type DefaultIR, IrreversibleMigration, type Migration, type MigrationDraft, MigrationRunner, Op, type Operation, type RenameCandidate, type RevisionNode, type SchemaIR, type SqliteAffinity, type TableIR, UnknownRevision, applyOperation, applyRenames, checkDrift, checkDriftPostgres, defineMigrationConfig, detectRenames, diffSchema, emptySchema, generateMigration, heads, introspectPostgres, introspectSqlite, invert, invertAll, makeRevisionId, reflectSchema, reflectTable, renderColumnDef, renderColumnType, renderDefault, renderOperation, replaySchema, runMigrationCli, sqliteAffinity, topoOrder };

package/dist/migrations/index.d.ts

@@ -1,4 +1,4 @@
-import { ColumnType, DefaultValue, ModelClass, Dialect, SyncDriver, AsyncDriver } from '../index.js';
+import { ColumnType, DefaultValue, ModelClass, Dialect, AsyncDriver, SyncDriver } from '../index.js';
 
 /**
  * tempest-db-js — Phase 6: the Schema IR (intermediate representation).
@@ -106,11 +106,11 @@ declare function invert(op: Operation): Operation;
 declare function invertAll(ops: readonly Operation[]): Operation[];
 
 /**
- * tempest-db-js — Phase 6: DDL rendering.
+ * tempest-db-js — Phase 6/9: DDL rendering.
  *
  * Renders the dialect-neutral IR + operations to concrete SQL per dialect. This
  * is the ONLY place migration SQL is produced — the same operation yields the
- * right DDL for SQLite or PostgreSQL.
+ * right DDL for SQLite, PostgreSQL or MySQL.
  */
 
 /** Map a column type to its SQL type string for the dialect. */
@@ -126,7 +126,7 @@ declare function renderColumnDef(col: ColumnIR, dialect: Dialect): string;
  * @param dialect The target dialect.
  * @returns The SQL statements (usually one).
  * @throws Error When the operation is unsupported on the dialect (e.g. SQLite
- *   `alter_column`, which needs the Phase 6e batch/table-rebuild path).
+ *   `alter_column`, which needs the table-rebuild path).
  */
 declare function renderOperation(op: Operation, dialect: Dialect): string[];
 
@@ -280,6 +280,43 @@ declare class MigrationRunner {
      */
     downgrade(migrations: readonly Migration[], steps?: number): string[];
 }
+/**
+ * Runs migrations against an **async** driver (PostgreSQL, or any async driver),
+ * tracking applied revisions. Mirrors {@link MigrationRunner} but every statement
+ * is awaited, and identifier quoting + placeholder style follow the dialect —
+ * so the version table and its bookkeeping are portable across SQLite/PG/MySQL.
+ */
+declare class AsyncMigrationRunner {
+    private readonly driver;
+    private readonly dialect;
+    private readonly vt;
+    constructor(driver: AsyncDriver, dialect: Dialect);
+    /** Create the version-tracking table if it does not exist. */
+    ensureVersionTable(): Promise<void>;
+    /** A portable "text" column type for the version table. */
+    private textType;
+    /** The set of applied revision ids. */
+    applied(): Promise<Set<string>>;
+    private runOps;
+    private record;
+    private forget;
+    /**
+     * 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.
+     */
+    upgrade(migrations: readonly Migration[], appliedAt: string): Promise<string[]>;
+    /**
+     * 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.
+     */
+    downgrade(migrations: readonly Migration[], steps?: number): Promise<string[]>;
+}
 
 /**
  * tempest-db-js — Phase 6d: SQLite introspection + drift detection.
@@ -462,4 +499,4 @@ declare function defineMigrationConfig(config: CliConfig): CliConfig;
  */
 declare function runMigrationCli(argv: readonly string[], config: CliConfig): CliResult;
 
-export { type CliConfig, type CliResult, type ColumnIR, CyclicMigrationGraph, type DefaultIR, IrreversibleMigration, type Migration, type MigrationDraft, MigrationRunner, Op, type Operation, type RenameCandidate, type RevisionNode, type SchemaIR, type SqliteAffinity, type TableIR, UnknownRevision, applyOperation, applyRenames, checkDrift, checkDriftPostgres, defineMigrationConfig, detectRenames, diffSchema, emptySchema, generateMigration, heads, introspectPostgres, introspectSqlite, invert, invertAll, makeRevisionId, reflectSchema, reflectTable, renderColumnDef, renderColumnType, renderDefault, renderOperation, replaySchema, runMigrationCli, sqliteAffinity, topoOrder };
+export { AsyncMigrationRunner, type CliConfig, type CliResult, type ColumnIR, CyclicMigrationGraph, type DefaultIR, IrreversibleMigration, type Migration, type MigrationDraft, MigrationRunner, Op, type Operation, type RenameCandidate, type RevisionNode, type SchemaIR, type SqliteAffinity, type TableIR, UnknownRevision, applyOperation, applyRenames, checkDrift, checkDriftPostgres, defineMigrationConfig, detectRenames, diffSchema, emptySchema, generateMigration, heads, introspectPostgres, introspectSqlite, invert, invertAll, makeRevisionId, reflectSchema, reflectTable, renderColumnDef, renderColumnType, renderDefault, renderOperation, replaySchema, runMigrationCli, sqliteAffinity, topoOrder };

package/dist/migrations/index.js

@@ -1,4 +1,4 @@
-export { CyclicMigrationGraph, IrreversibleMigration, MigrationRunner, Op, UnknownRevision, applyOperation, applyRenames, checkDrift, checkDriftPostgres, defineMigrationConfig, detectRenames, diffSchema, emptySchema, generateMigration, heads, introspectPostgres, introspectSqlite, invert, invertAll, makeRevisionId, reflectSchema, reflectTable, renderColumnDef, renderColumnType, renderDefault, renderOperation, replaySchema, runMigrationCli, sqliteAffinity, topoOrder } from '../chunk-QMW4NKMH.js';
-import '../chunk-AGDD7K3F.js';
+export { AsyncMigrationRunner, CyclicMigrationGraph, IrreversibleMigration, MigrationRunner, Op, UnknownRevision, applyOperation, applyRenames, checkDrift, checkDriftPostgres, defineMigrationConfig, detectRenames, diffSchema, emptySchema, generateMigration, heads, introspectPostgres, introspectSqlite, invert, invertAll, makeRevisionId, reflectSchema, reflectTable, renderColumnDef, renderColumnType, renderDefault, renderOperation, replaySchema, runMigrationCli, sqliteAffinity, topoOrder } from '../chunk-OP7FRDI5.js';
+import '../chunk-Q32CBI2A.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tempest-db-js",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Type-safe, class-based ORM for TypeScript — SQLAlchemy 2.0 ergonomics for the JS/TS world.",
   "type": "module",
   "sideEffects": false,