kysely 0.29.3 → 0.30.0-beta.0

package/README.md

@@ -1,7 +1,7 @@
 [![Stand With Ukraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner2-direct.svg)](https://stand-with-ukraine.pp.ua)
 
 [![NPM Version](https://img.shields.io/npm/v/kysely?style=flat&label=latest)](https://github.com/kysely-org/kysely/releases/latest)
-[![Socket Badge](https://badge.socket.dev/npm/package/kysely/0.29.3)](https://socket.dev/npm/package/kysely/overview/0.29.3)
+[![Socket Badge](https://badge.socket.dev/npm/package/kysely/0.30.0-beta.0)](https://socket.dev/npm/package/kysely/overview/0.30.0-beta.0)
 [![Tests](https://github.com/kysely-org/kysely/actions/workflows/test.yml/badge.svg)](https://github.com/kysely-org/kysely)
 [![License](https://img.shields.io/github/license/kysely-org/kysely?style=flat)](https://github.com/kysely-org/kysely/blob/master/LICENSE)
 [![Issues](https://img.shields.io/github/issues-closed/kysely-org/kysely?logo=github)](https://github.com/kysely-org/kysely/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc)

package/dist/dialect/postgres/postgres-driver.js

@@ -177,7 +177,11 @@ class PostgresConnection {
                 }
             });
         }
-        const controlClient = new Client({ ...poolOptions });
+        const controlClient = new Client({
+            ...poolOptions,
+            // `password` is not enumerable, so we have to explicitly set it after the spread.
+            password: 'password' in poolOptions ? poolOptions.password : undefined,
+        });
         try {
             await controlClient.connect();
             // by the time we get the connection, another query might have been executed.

package/dist/driver/driver.d.ts

@@ -55,8 +55,8 @@ export interface TransactionSettings {
     readonly accessMode?: AccessMode;
     readonly isolationLevel?: IsolationLevel;
 }
-export declare const TRANSACTION_ACCESS_MODES: readonly ["read only", "read write"];
+export declare const TRANSACTION_ACCESS_MODES: readonly ['read only', 'read write'];
 export type AccessMode = ArrayItemType<typeof TRANSACTION_ACCESS_MODES>;
-export declare const TRANSACTION_ISOLATION_LEVELS: readonly ["read uncommitted", "read committed", "repeatable read", "serializable", "snapshot"];
+export declare const TRANSACTION_ISOLATION_LEVELS: readonly ['read uncommitted', 'read committed', 'repeatable read', 'serializable', 'snapshot'];
 export type IsolationLevel = ArrayItemType<typeof TRANSACTION_ISOLATION_LEVELS>;
 export declare function validateTransactionSettings(settings: TransactionSettings): void;

package/dist/helpers/sqlite.d.ts

@@ -1,7 +1,14 @@
 import type { Expression } from '../expression/expression.js';
 import type { SelectQueryBuilderExpression } from '../query-builder/select-query-builder-expression.js';
 import type { RawBuilder } from '../raw-builder/raw-builder.js';
-import type { ShallowDehydrateObject, ShallowDehydrateValue, Simplify } from '../util/type-utils.js';
+import type { KyselyTypeError } from '../util/type-error.js';
+import type { IsNever, ShallowDehydrateObject, ShallowDehydrateValue, Simplify } from '../util/type-utils.js';
+/**
+ * Used to check for `BLOB` column existence in result records.
+ */
+export type ExtractBlobs<O> = {
+    [K in keyof O]: O[K] extends Expression<infer V> ? Extract<V, Uint8Array> : Extract<O[K], Uint8Array>;
+}[keyof O];
 /**
  * A SQLite helper for aggregating a subquery into a JSON array.
  *
@@ -63,7 +70,7 @@ import type { ShallowDehydrateObject, ShallowDehydrateValue, Simplify } from '..
  * from "person"
  * ```
  */
-export declare function jsonArrayFrom<O>(expr: SelectQueryBuilderExpression<O>): RawBuilder<Simplify<ShallowDehydrateObject<O>>[]>;
+export declare function jsonArrayFrom<O>(expr: IsNever<ExtractBlobs<O>> extends true ? SelectQueryBuilderExpression<O> : KyselyTypeError<'SQLite does not support passing `BLOB` values to `json_object`. Cast to `TEXT`.'>): RawBuilder<Simplify<ShallowDehydrateObject<O>>[]>;
 /**
  * A SQLite helper for turning a subquery into a JSON object.
  *
@@ -127,7 +134,7 @@ export declare function jsonArrayFrom<O>(expr: SelectQueryBuilderExpression<O>):
  * from "person";
  * ```
  */
-export declare function jsonObjectFrom<O>(expr: SelectQueryBuilderExpression<O>): RawBuilder<Simplify<ShallowDehydrateObject<O>> | null>;
+export declare function jsonObjectFrom<O>(expr: IsNever<ExtractBlobs<O>> extends true ? SelectQueryBuilderExpression<O> : KyselyTypeError<'SQLite does not support passing `BLOB` values to `json_object`. Cast to `TEXT`.'>): RawBuilder<Simplify<ShallowDehydrateObject<O>> | null>;
 /**
  * The SQLite `json_object` function.
  *
@@ -184,6 +191,6 @@ export declare function jsonObjectFrom<O>(expr: SelectQueryBuilderExpression<O>)
  * from "person"
  * ```
  */
-export declare function jsonBuildObject<O extends Record<string, Expression<unknown>>>(obj: O): RawBuilder<Simplify<{
+export declare function jsonBuildObject<O extends Record<string, Expression<unknown>>>(obj: IsNever<ExtractBlobs<O>> extends true ? O : KyselyTypeError<'SQLite does not support passing `BLOB` values to `json_object`. Cast to `TEXT`.'>): RawBuilder<Simplify<{
     [K in keyof O]: O[K] extends Expression<infer V> ? ShallowDehydrateValue<V> : never;
 }>>;

package/dist/helpers/sqlite.js

@@ -188,7 +188,10 @@ export function jsonObjectFrom(expr) {
  * ```
  */
 export function jsonBuildObject(obj) {
-    return sql `json_object(${sql.join(Object.keys(obj).flatMap((k) => [sql.lit(k), obj[k]]))})`;
+    return sql `json_object(${sql.join(Object.keys(obj).flatMap((k) => [
+        sql.lit(k),
+        obj[k],
+    ]))})`;
 }
 function getSqliteJsonObjectArgs(node, table) {
     try {

package/dist/migration/file-migration-provider.d.ts

@@ -1,4 +1,5 @@
-import type { Migration, MigrationProvider } from './migrator.js';
+import type { Migration } from './migration.js';
+import type { MigrationProvider } from './migrator.js';
 /**
  * Reads all migrations from a folder.
  *

package/dist/migration/index.d.ts

@@ -1,2 +1,3 @@
 export * from './file-migration-provider.js';
+export * from './migration.js';
 export * from './migrator.js';

package/dist/migration/index.js

@@ -1,3 +1,4 @@
 /// <reference types="./index.d.ts" />
 export * from './file-migration-provider.js';
+export * from './migration.js';
 export * from './migrator.js';

package/dist/migration/migration.d.ts

@@ -0,0 +1,70 @@
+import type { Kysely } from '../kysely.js';
+/**
+ * The shape of a migration's module.
+ */
+export interface Migration {
+    /**
+     * Configuration object for this migration module.
+     *
+     * See {@link MigrationConfig}.
+     */
+    config?: MigrationConfig;
+    /**
+     * The `down` method that reverts the changes made by it's sibling {@link Migration.up}
+     * method.
+     */
+    down?(db: Kysely<any>): Promise<void>;
+    /**
+     * The `up` method that changes the database schema.
+     *
+     * See {@link Migration.down}.
+     */
+    up(db: Kysely<any>): Promise<void>;
+}
+/**
+ * Configuration for a single migration.
+ */
+export interface MigrationConfig {
+    /**
+     * Controls whether this migration runs inside its own transaction, when
+     * {@link MigrateOptions.transactionMode} is `'per-migration'` — the only
+     * mode that honors this property. Defaults to `true` in that mode: the
+     * migration runs in its own transaction unless this is set to `false`.
+     *
+     * In any other transaction mode, leaving this property out is the only
+     * valid state — providing a value, either one, results in an error: in
+     * `'per-run'` mode a single shared transaction cannot partially exclude a
+     * migration, and in `'none'` mode there are no transactions to configure.
+     * This is the one place an explicit `true` differs from the default —
+     * `true` asserts a requirement that non-`'per-migration'` modes refuse,
+     * while leaving the property out never errors.
+     *
+     * Setting `false` makes the migration run without a transaction. This is
+     * required for statements that cannot run inside a transaction, such as
+     * PostgreSQL's `CREATE INDEX CONCURRENTLY`. Note that without a
+     * transaction, a failure can leave the migration partially applied, and the
+     * migration table record is written separately after the migration
+     * completes. Prefer a single statement per non-transactional migration, and
+     * write it so it can be safely retried — for example, drop a
+     * possibly-leftover invalid index before creating it.
+     */
+    readonly transaction?: boolean;
+}
+/**
+ * Helps define a single migration by taking over types duties and enforcing the contract.
+ *
+ * ### Examples
+ *
+ * ```ts
+ * import { defineMigration } from 'kysely/migration'
+ *
+ * export default defineMigration({
+ *   async up(db) {
+ *     // ...
+ *   },
+ *
+ *   config: { transaction: false },
+ * })
+ * ```
+ */
+export declare function defineMigration(migration: Migration): Migration;

package/dist/migration/migration.js

@@ -0,0 +1,21 @@
+/// <reference types="./migration.d.ts" />
+/**
+ * Helps define a single migration by taking over types duties and enforcing the contract.
+ *
+ * ### Examples
+ *
+ * ```ts
+ * import { defineMigration } from 'kysely/migration'
+ *
+ * export default defineMigration({
+ *   async up(db) {
+ *     // ...
+ *   },
+ *
+ *   config: { transaction: false },
+ * })
+ * ```
+ */
+export function defineMigration(migration) {
+    return migration;
+}

package/dist/migration/migrator.d.ts

@@ -1,19 +1,10 @@
 import type { Kysely } from '../kysely.js';
+import type { Migration } from './migration.js';
 export declare const DEFAULT_MIGRATION_TABLE = "kysely_migration";
 export declare const DEFAULT_MIGRATION_LOCK_TABLE = "kysely_migration_lock";
 export declare const DEFAULT_ALLOW_UNORDERED_MIGRATIONS = false;
 export declare const MIGRATION_LOCK_ID = "migration_lock";
 export declare const NO_MIGRATIONS: NoMigrations;
-export interface Migration {
-    up(db: Kysely<any>): Promise<void>;
-    /**
-     * An optional down method.
-     *
-     * If you don't provide a down method, the migration is skipped when
-     * migrating down.
-     */
-    down?(db: Kysely<any>): Promise<void>;
-}
 /**
  * A class for running migrations.
  *
@@ -221,10 +212,51 @@ export interface MigrateOptions {
      *
      * Default is `false`.
      *
-     * This is useful when some migrations include queries that would fail otherwise.
+     * @deprecated Use {@link transactionMode} instead — `disableTransactions: true`
+     * is equivalent to `transactionMode: 'none'`. Setting both to contradicting
+     * values results in an error.
      */
     readonly disableTransactions?: boolean;
+    /**
+     * Controls how migrations are wrapped in transactions, when the dialect
+     * supports transactional DDL ({@link DialectAdapter.supportsTransactionalDdl}).
+     *
+     * - `'per-run'` — the entire migration run is wrapped in a single transaction.
+     *   Either every migration in the run is applied, or none are. Any migration
+     *   with a per-migration `transaction` configuration ({@link MigrationConfig.transaction})
+     *   results in an error, since a single shared transaction cannot partially
+     *   exclude a migration. Requires transactional DDL — results in an error on
+     *   dialects without it (e.g. MySQL).
+     *
+     * - `'per-migration'` — each migration runs in its own transaction, together
+     *   with the insertion/deletion of its migration table record. A failure rolls
+     *   back only the failing migration; previously completed migrations stay
+     *   applied. Individual migrations can opt out of their transaction with
+     *   `config: { transaction: false }` — required for statements that cannot
+     *   run inside a transaction, such as PostgreSQL's `CREATE INDEX CONCURRENTLY`
+     *   or `ALTER TYPE ... ADD VALUE` (pre-12). Requires transactional DDL —
+     *   results in an error on dialects without it.
+     *
+     * - `'none'` — migrations run without any transactions. Any migration with a
+     *   per-migration `transaction` configuration results in an error.
+     *
+     * When not provided, the current default is `'per-run'` on dialects that
+     * support transactional DDL and `'none'` on dialects that don't. This
+     * default might change to `'per-migration'` in a future version of Kysely —
+     * running multiple migrations without an explicit `transactionMode` logs a
+     * message about this. Provide an explicit `transactionMode` to make the
+     * migrator's behavior independent of the default.
+     *
+     * Note that transactions spanning multiple migrations (`'per-run'`) can make
+     * otherwise-valid migration sequences fail. For example, a new PostgreSQL enum
+     * value cannot be used in the same transaction that added it, so a migration
+     * that runs `ALTER TYPE ... ADD VALUE` followed by a migration that uses the
+     * new value works when the two run in separate transactions, but fails when
+     * both are pending in a single `'per-run'` mode run.
+     */
+    readonly transactionMode?: MigratorTransactionMode;
 }
+export type MigratorTransactionMode = 'per-run' | 'per-migration' | 'none';
 export interface MigratorProps extends MigrateOptions {
     readonly db: Kysely<any>;
     readonly provider: MigrationProvider;

package/dist/migration/migrator.js

@@ -1,7 +1,8 @@
 /// <reference types="./migrator.d.ts" />
 import { NoopPlugin } from '../plugin/noop-plugin.js';
 import { WithSchemaPlugin } from '../plugin/with-schema/with-schema-plugin.js';
-import { freeze, getLast, isObject } from '../util/object-utils.js';
+import { logOnce } from '../util/log-once.js';
+import { freeze, isObject } from '../util/object-utils.js';
 export const DEFAULT_MIGRATION_TABLE = 'kysely_migration';
 export const DEFAULT_MIGRATION_LOCK_TABLE = 'kysely_migration_lock';
 export const DEFAULT_ALLOW_UNORDERED_MIGRATIONS = false;
@@ -403,6 +404,7 @@ export class Migrator {
             lockRowId: MIGRATION_LOCK_ID,
             lockTableSchema: this.#props.migrationTableSchema,
         });
+        const transactionMode = this.#resolveTransactionMode(options, adapter);
         const run = async (db) => {
             const state = await this.#getState(db);
             if (state.migrations.length === 0) {
@@ -412,13 +414,34 @@ export class Migrator {
             if (step <= 0) {
                 return { results: [] };
             }
-            if (direction === 'Down') {
-                return await this.#migrateDown(db, state, step);
+            const migrationsToRun = this.#getMigrationsToRun(state, direction, step);
+            const [orchestrator, runner] = direction === 'Down'
+                ? [
+                    this.#rollbackMigrations.bind(this),
+                    this.#rollbackMigration.bind(this),
+                ]
+                : [this.#applyMigrations.bind(this), this.#applyMigration.bind(this)];
+            if (transactionMode.value === 'per-migration') {
+                return await orchestrator(migrationsToRun, async (migration) => {
+                    if (migration.config?.transaction === false) {
+                        return await runner(db, migration);
+                    }
+                    await db.transaction().execute((trx) => runner(trx, migration));
+                });
+            }
+            const migrationWithTransactionConfig = migrationsToRun.find((migration) => migration.config?.transaction != null);
+            if (migrationWithTransactionConfig) {
+                const modeDescription = transactionMode.explicit
+                    ? `\`transactionMode\` is '${transactionMode.value}'`
+                    : `\`transactionMode\` was not provided and defaults to '${transactionMode.value}'`;
+                throw new Error(`Migration "${migrationWithTransactionConfig.name}" has a \`transaction\` configuration but ${modeDescription}. Per-migration transaction configuration is only supported when \`transactionMode\` is 'per-migration'. Set \`transactionMode: 'per-migration'\` on the migrator or the migrate call to enable it.`);
             }
-            else if (direction === 'Up') {
-                return await this.#migrateUp(db, state, step);
+            if (!transactionMode.explicit &&
+                adapter.supportsTransactionalDdl &&
+                migrationsToRun.length > 1) {
+                logOnce("kysely:migrator: multiple migrations were run in a single transaction ('per-run'). This default might change in a future version of Kysely. Pass an explicit `transactionMode` to the migrator to pin the behavior and silence this message: 'per-run' to keep the current behavior, or 'per-migration' to run each migration in its own transaction.");
             }
-            return { results: [] };
+            return await orchestrator(migrationsToRun, (migration) => runner(db, migration));
         };
         const runWithLock = async (db, cb) => {
             try {
@@ -429,51 +452,92 @@ export class Migrator {
                 await adapter.releaseMigrationLock(db, lockOptions);
             }
         };
-        const disableTransactions = options?.disableTransactions ?? this.#props.disableTransactions;
         if (this.#props.db.isTransaction) {
             if (!adapter.supportsTransactionalDdl) {
                 throw new Error('Transactional DDL is not supported in this dialect. Passing a transaction to this migrator would result in failure or unexpected behavior.');
             }
-            if (disableTransactions) {
-                throw new Error('`disableTransactions` is true but the migrator was given a transaction. Passing a transaction to this migrator would result in failure or unexpected behavior.');
+            if (transactionMode.value !== 'per-run') {
+                throw new Error(`The transaction mode is '${transactionMode.value}' but the migrator was given a transaction. Passing a transaction to this migrator is only supported when \`transactionMode\` is 'per-run'.`);
             }
             return runWithLock(this.#props.db, run);
         }
-        if (adapter.supportsTransactionalDdl && !disableTransactions) {
+        if (transactionMode.value === 'per-run') {
             return this.#props.db
                 .connection()
-                .execute((db) => runWithLock(db, (db) => db.transaction().execute((trx) => run(trx))));
+                .execute((db) => runWithLock(db, (db) => db.transaction().execute(run)));
         }
         return this.#props.db.connection().execute((db) => runWithLock(db, run));
     }
+    #resolveTransactionMode(options, adapter) {
+        const resolveLevel = (options, source) => {
+            if (!options) {
+                return;
+            }
+            const { disableTransactions, transactionMode } = options;
+            if (disableTransactions != null &&
+                transactionMode &&
+                (transactionMode === 'none') !== disableTransactions) {
+                throw new Error(`\`transactionMode\` is '${transactionMode}' but \`disableTransactions\` is ${disableTransactions} in the ${source}. These options contradict each other. Prefer \`transactionMode\` — \`disableTransactions\` is deprecated.`);
+            }
+            if (transactionMode) {
+                if (transactionMode !== 'none' && !adapter.supportsTransactionalDdl) {
+                    throw new Error(`\`transactionMode\` is '${transactionMode}' but transactional DDL is not supported in this dialect. Migrations would fail or behave unexpectedly.`);
+                }
+                return { explicit: true, value: transactionMode };
+            }
+            if (disableTransactions == null) {
+                return;
+            }
+            if (disableTransactions === true) {
+                return { explicit: true, value: 'none' };
+            }
+            return {
+                explicit: false,
+                value: adapter.supportsTransactionalDdl ? 'per-run' : 'none',
+            };
+        };
+        return (resolveLevel(options, 'migrate call options') ||
+            resolveLevel(this.#props, 'migrator properties') || {
+            explicit: false,
+            value: adapter.supportsTransactionalDdl ? 'per-run' : 'none',
+        });
+    }
+    #getMigrationsToRun(state, direction, step) {
+        if (direction === 'Down') {
+            return state.executedMigrations
+                .toReversed()
+                .slice(0, step)
+                .map((name) => {
+                return state.migrations.find((it) => it.name === name);
+            });
+        }
+        return state.pendingMigrations.slice(0, step);
+    }
     async #getState(db) {
-        const migrations = await this.#resolveMigrations();
-        const executedMigrations = await this.#getExecutedMigrations(db);
+        const [migrations, executedMigrations] = await Promise.all([
+            this.#resolveMigrations(),
+            this.#getExecutedMigrations(db),
+        ]);
         this.#ensureNoMissingMigrations(migrations, executedMigrations);
         if (!this.#allowUnorderedMigrations) {
             this.#ensureMigrationsInOrder(migrations, executedMigrations);
         }
         const pendingMigrations = this.#getPendingMigrations(migrations, executedMigrations);
         return freeze({
-            migrations,
             executedMigrations,
-            lastMigration: getLast(executedMigrations),
+            lastMigration: executedMigrations.at(-1),
+            migrations,
             pendingMigrations,
         });
     }
     #getPendingMigrations(migrations, executedMigrations) {
-        return migrations.filter((migration) => {
-            return !executedMigrations.includes(migration.name);
-        });
+        return migrations.filter((migration) => !executedMigrations.includes(migration.name));
     }
     async #resolveMigrations() {
         const allMigrations = await this.#props.provider.getMigrations();
         return Object.keys(allMigrations)
             .sort()
-            .map((name) => ({
-            ...allMigrations[name],
-            name,
-        }));
+            .map((name) => ({ ...allMigrations[name], name }));
     }
     async #getExecutedMigrations(db) {
         const executedMigrations = await db
@@ -509,92 +573,63 @@ export class Migrator {
             }
         }
     }
-    async #migrateDown(db, state, step) {
-        const migrationsToRollback = state.executedMigrations
-            .toReversed()
-            .slice(0, step)
-            .map((name) => {
-            return state.migrations.find((it) => it.name === name);
-        });
-        const results = migrationsToRollback.map((migration) => {
-            return {
-                migrationName: migration.name,
-                direction: 'Down',
-                status: 'NotExecuted',
-            };
-        });
+    async #rollbackMigrations(migrationsToRollback, rollbacker) {
+        const results = migrationsToRollback.map((migration) => ({
+            direction: 'Down',
+            migrationName: migration.name,
+            status: 'NotExecuted',
+        }));
         for (let i = 0; i < results.length; ++i) {
             const migration = migrationsToRollback[i];
+            if (!migration.down) {
+                continue;
+            }
             try {
-                if (migration.down) {
-                    await migration.down(db);
-                    await db
-                        .withPlugin(this.#schemaPlugin)
-                        .deleteFrom(this.#migrationTable)
-                        .where('name', '=', migration.name)
-                        .execute();
-                    results[i] = {
-                        migrationName: migration.name,
-                        direction: 'Down',
-                        status: 'Success',
-                    };
-                }
+                await rollbacker(migration);
+                results[i].status = 'Success';
             }
             catch (error) {
-                results[i] = {
-                    migrationName: migration.name,
-                    direction: 'Down',
-                    status: 'Error',
-                };
-                throw new MigrationResultSetError({
-                    error,
-                    results,
-                });
+                results[i].status = 'Error';
+                throw new MigrationResultSetError({ error, results });
             }
         }
         return { results };
     }
-    async #migrateUp(db, state, step) {
-        const migrationsToRun = state.pendingMigrations.slice(0, step);
-        const results = migrationsToRun.map((migration) => {
-            return {
-                migrationName: migration.name,
-                direction: 'Up',
-                status: 'NotExecuted',
-            };
-        });
+    async #applyMigrations(migrationsToRun, applier) {
+        const results = migrationsToRun.map((migration) => ({
+            direction: 'Up',
+            migrationName: migration.name,
+            status: 'NotExecuted',
+        }));
         for (let i = 0; i < results.length; i++) {
-            const migration = state.pendingMigrations[i];
+            const migration = migrationsToRun[i];
             try {
-                await migration.up(db);
-                await db
-                    .withPlugin(this.#schemaPlugin)
-                    .insertInto(this.#migrationTable)
-                    .values({
-                    name: migration.name,
-                    timestamp: new Date().toISOString(),
-                })
-                    .execute();
-                results[i] = {
-                    migrationName: migration.name,
-                    direction: 'Up',
-                    status: 'Success',
-                };
+                await applier(migration);
+                results[i].status = 'Success';
             }
             catch (error) {
-                results[i] = {
-                    migrationName: migration.name,
-                    direction: 'Up',
-                    status: 'Error',
-                };
-                throw new MigrationResultSetError({
-                    error,
-                    results,
-                });
+                results[i].status = 'Error';
+                throw new MigrationResultSetError({ error, results });
             }
         }
         return { results };
     }
+    async #applyMigration(db, migration) {
+        await migration.up(db);
+        await db
+            .withPlugin(this.#schemaPlugin)
+            .insertInto(this.#migrationTable)
+            .values({ name: migration.name, timestamp: new Date().toISOString() })
+            .execute();
+    }
+    async #rollbackMigration(db, migration) {
+        await migration.down(db);
+        await db
+            .withPlugin(this.#schemaPlugin)
+            .deleteFrom(this.#migrationTable)
+            .where('name', '=', migration.name)
+            .execute();
+    }
     async #createIfNotExists(qb) {
         if (this.#props.db.getExecutor().adapter.supportsCreateIfNotExists) {
             qb = qb.ifNotExists();

package/dist/plugin/camel-case/camel-case.d.ts

@@ -3,9 +3,9 @@ export type StringMapper = (str: string) => string;
  * Creates a function that transforms camel case strings to snake case.
  */
 export declare function createSnakeCaseMapper({ upperCase, underscoreBeforeDigits, underscoreBetweenUppercaseLetters, }?: {
-    upperCase?: boolean | undefined;
     underscoreBeforeDigits?: boolean | undefined;
     underscoreBetweenUppercaseLetters?: boolean | undefined;
+    upperCase?: boolean | undefined;
 }): StringMapper;
 /**
  * Creates a function that transforms snake case strings to camel case.

package/dist/query-compiler/default-query-compiler.js

@@ -254,6 +254,10 @@ export class DefaultQueryCompiler extends OperationNodeVisitor {
             this.append(' ');
             this.visitNode(node.where);
         }
+        if (node.returning) {
+            this.append(' ');
+            this.visitNode(node.returning);
+        }
         if (node.orderBy) {
             this.append(' ');
             this.visitNode(node.orderBy);
@@ -262,10 +266,6 @@ export class DefaultQueryCompiler extends OperationNodeVisitor {
             this.append(' ');
             this.visitNode(node.limit);
         }
-        if (node.returning) {
-            this.append(' ');
-            this.visitNode(node.returning);
-        }
         if (wrapInParens) {
             this.append(')');
         }

package/dist/util/log.d.ts

@@ -1,6 +1,6 @@
 import type { CompiledQuery } from '../query-compiler/compiled-query.js';
 import type { ArrayItemType } from './type-utils.js';
-declare const logLevels: readonly ["query", "error"];
+declare const logLevels: readonly ['query', 'error'];
 export declare const LOG_LEVELS: Readonly<typeof logLevels>;
 export type LogLevel = ArrayItemType<typeof LOG_LEVELS>;
 export interface QueryLogEvent {

package/dist/util/object-utils.d.ts

@@ -14,7 +14,6 @@ export declare function isFunction(obj: unknown): obj is Function;
 export declare function isObject(obj: unknown): obj is ShallowRecord<string, unknown>;
 export declare function isArrayBufferOrView(obj: unknown): obj is ArrayBuffer | ArrayBufferView;
 export declare function isPlainObject(obj: unknown): obj is Record<string, unknown>;
-export declare function getLast<T>(arr: ArrayLike<T>): T | undefined;
 export declare function freeze<T>(obj: T): Readonly<T>;
 export declare function asArray<T>(arg: T | ReadonlyArray<T>): ReadonlyArray<T>;
 export declare function asReadonlyArray<T>(arg: T | ReadonlyArray<T>): ReadonlyArray<T>;

package/dist/util/object-utils.js

@@ -56,9 +56,6 @@ export function isPlainObject(obj) {
     }
     return Object.getPrototypeOf(obj) === proto;
 }
-export function getLast(arr) {
-    return arr[arr.length - 1];
-}
 export function freeze(obj) {
     return Object.freeze(obj);
 }

package/dist/util/type-utils.d.ts

@@ -119,7 +119,7 @@ export type IsAny<T> = 0 extends T & 1 ? true : false;
 /**
  * Evaluates to `true` if the types `T` and `U` are equal.
  */
-export type Equals<T, U> = (<G>() => G extends T ? 1 : 2) extends <G>() => G extends U ? 1 : 2 ? true : false;
+export type Equals<T, U> = (<G>() => G extends T ? 1 : 2) extends <G>() => (G extends U ? 1 : 2) ? true : false;
 export type NarrowPartial<O, T> = T extends object ? DrainOuterGeneric<{
     [K in keyof O & string]: K extends keyof T ? T[K] extends NotNull ? Exclude<O[K], null> : T[K] extends O[K] ? T[K] : T[K] extends object ? SimplifyDeep<O[K] & NarrowPartial<O[K], T[K]>> : KyselyTypeError<`$narrowType() call failed: passed type does not exist in '${K}'s type union`> : O[K];
 }> : never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kysely",
-  "version": "0.29.3",
+  "version": "0.30.0-beta.0",
   "description": "Type safe SQL query builder",
   "repository": {
     "type": "git",
@@ -61,14 +61,13 @@
     "Igal Klebanov <igalklebanov@gmail.com>"
   ],
   "devDependencies": {
-    "@arethetypeswrong/cli": "0.18.4",
-    "@ark/attest": "0.56.2",
-    "@electric-sql/pglite": "0.5.3",
+    "@arethetypeswrong/cli": "0.18.5",
+    "@electric-sql/pglite": "0.5.4",
     "@types/better-sqlite3": "7.6.13",
     "@types/chai": "5.2.3",
     "@types/chai-as-promised": "8.0.2",
     "@types/mocha": "10.0.10",
-    "@types/node": "26.1.0",
+    "@types/node": "26.1.1",
     "@types/pg": "8.20.0",
     "@types/pg-cursor": "2.7.2",
     "@types/prototype-pollution-vulnerable-lodash.merge-dont-upgrade": "npm:@types/lodash.merge@4.6.1",
@@ -80,22 +79,23 @@
     "esbuild": "0.28.1",
     "jsr": "0.14.3",
     "mocha": "11.7.6",
-    "mysql2": "3.22.5",
+    "mysql2": "3.23.0",
     "pathe": "2.0.3",
     "pg": "8.22.0",
     "pg-cursor": "2.21.0",
     "playwright": "1.61.1",
-    "prettier": "3.9.4",
+    "prettier": "3.9.5",
     "prototype-pollution-vulnerable-lodash.merge-dont-upgrade": "npm:lodash.merge@4.6.1",
     "remeda": "2.39.0",
     "semver": "7.8.5",
     "sinon": "22.0.0",
-    "std-env": "4.1.0",
-    "tarn": "3.1.0",
+    "std-env": "4.2.0",
+    "tarn": "3.1.2",
     "tedious": "20.0.0",
     "tsd": "0.33.0",
-    "tsx": "4.22.4",
-    "typescript": "6.0.3"
+    "tsx": "4.23.1",
+    "typescript": "7.0.2",
+    "typescript-6": "npm:typescript@6.0.3"
   },
   "scripts": {
     "clean": "rm -rf dist & rm -rf test/node/dist & rm -rf test/browser/bundle.js",