kysely 0.27.0 → 0.27.2

package/README.md

@@ -13,7 +13,7 @@
 # [Kysely](https://kysely.dev)
 
 Kysely (pronounce “Key-Seh-Lee”) is a type-safe and autocompletion-friendly typescript SQL query builder.
-Inspired by [knex](http://knexjs.org/). Mainly developed for [node.js](https://nodejs.org/en/) but also 
+Inspired by [knex](http://knexjs.org/). Mainly developed for [node.js](https://nodejs.org/en/) but also
 runs on all other javascript environments like [deno](https://deno.land/).
 
 ![](https://github.com/kysely-org/kysely/blob/master/assets/demo.gif)
@@ -32,7 +32,7 @@ hatches for these situations. See the [sql template tag](https://kysely-org.gith
 and the [DynamicModule](https://kysely-org.github.io/kysely-apidoc/classes/DynamicModule.html#ref) for more info.
 
 All API documentation is written in the typing files and you can simply hover over the module, class
-or method you're using to see it in your IDE. The same documentation is also hosted [here](https://github.com/kysely-org/kysely).
+or method you're using to see it in your IDE. The same documentation is also hosted [here](https://kysely-org.github.io/kysely-apidoc/).
 
 If you start using Kysely and can't find something you'd want to use, please open an issue or join our
 [discord server](https://discord.gg/xyBJ3GwvAm).

package/dist/cjs/dialect/mssql/mssql-introspector.js

@@ -67,12 +67,14 @@ class MssqlIntrospector {
         const tableDictionary = {};
         for (const rawColumn of rawColumns) {
             const key = `${rawColumn.table_schema_name}.${rawColumn.table_name}`;
-            const table = (tableDictionary[key] ||= (0, object_utils_js_1.freeze)({
-                columns: [],
-                isView: rawColumn.table_type === 'V ',
-                name: rawColumn.table_name,
-                schema: rawColumn.table_schema_name ?? undefined,
-            }));
+            const table = (tableDictionary[key] =
+                tableDictionary[key] ||
+                    (0, object_utils_js_1.freeze)({
+                        columns: [],
+                        isView: rawColumn.table_type === 'V ',
+                        name: rawColumn.table_name,
+                        schema: rawColumn.table_schema_name ?? undefined,
+                    }));
             table.columns.push((0, object_utils_js_1.freeze)({
                 dataType: rawColumn.type_name,
                 dataTypeSchema: rawColumn.type_schema_name ?? undefined,

package/dist/cjs/expression/expression-wrapper.d.ts

@@ -243,7 +243,17 @@ export declare class ExpressionWrapper<DB, TB extends keyof DB, T> implements Al
      * This method call doesn't change the SQL in any way. This methods simply
      * returns a copy of this `ExpressionWrapper` with a new output type.
      */
-    $castTo<T>(): ExpressionWrapper<DB, TB, T>;
+    $castTo<C>(): ExpressionWrapper<DB, TB, C>;
+    /**
+     * Omit null from the expression's type.
+     *
+     * This function can be useful in cases where you know an expression can't be
+     * null, but Kysely is unable to infer it.
+     *
+     * This method call doesn't change the SQL in any way. This methods simply
+     * returns a copy of `this` with a new output type.
+     */
+    $notNull(): ExpressionWrapper<DB, TB, Exclude<T, null>>;
     /**
      * Creates the OperationNode that describes how to compile this expression into SQL.
      *
@@ -397,7 +407,7 @@ export declare class OrWrapper<DB, TB extends keyof DB, T extends SqlBool> imple
      * This method call doesn't change the SQL in any way. This methods simply
      * returns a copy of this `OrWrapper` with a new output type.
      */
-    $castTo<T extends SqlBool>(): OrWrapper<DB, TB, T>;
+    $castTo<C extends SqlBool>(): OrWrapper<DB, TB, C>;
     /**
      * Creates the OperationNode that describes how to compile this expression into SQL.
      *
@@ -533,7 +543,7 @@ export declare class AndWrapper<DB, TB extends keyof DB, T extends SqlBool> impl
      * This method call doesn't change the SQL in any way. This methods simply
      * returns a copy of this `AndWrapper` with a new output type.
      */
-    $castTo<T extends SqlBool>(): AndWrapper<DB, TB, T>;
+    $castTo<C extends SqlBool>(): AndWrapper<DB, TB, C>;
     /**
      * Creates the OperationNode that describes how to compile this expression into SQL.
      *

package/dist/cjs/expression/expression-wrapper.js

@@ -35,6 +35,18 @@ class ExpressionWrapper {
     $castTo() {
         return new ExpressionWrapper(this.#node);
     }
+    /**
+     * Omit null from the expression's type.
+     *
+     * This function can be useful in cases where you know an expression can't be
+     * null, but Kysely is unable to infer it.
+     *
+     * This method call doesn't change the SQL in any way. This methods simply
+     * returns a copy of `this` with a new output type.
+     */
+    $notNull() {
+        return new ExpressionWrapper(this.#node);
+    }
     toOperationNode() {
         return this.#node;
     }

package/dist/cjs/migration/migrator.d.ts

@@ -1,6 +1,7 @@
 import { Kysely } from '../kysely.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 {
@@ -58,7 +59,7 @@ export declare class Migrator {
      * This method goes through all possible migrations provided by the provider and runs the
      * ones whose names come alphabetically after the last migration that has been run. If the
      * list of executed migrations doesn't match the beginning of the list of possible migrations
-     * an error is thrown.
+     * an error is returned.
      *
      * ### Examples
      *
@@ -197,6 +198,20 @@ export interface MigratorProps {
      * This only works on postgres.
      */
     readonly migrationTableSchema?: string;
+    /**
+     * Enforces whether or not migrations must be run in alpha-numeric order.
+     *
+     * When false, migrations must be run in their exact alpha-numeric order.
+     * This is checked against the migrations already run in the database
+     * (`migrationTableName'). This ensures your migrations are always run in
+     * the same order and is the safest option.
+     *
+     * When true, migrations are still run in alpha-numeric order, but
+     * the order is not checked against already-run migrations in the database.
+     * Kysely will simply run all migrations that haven't run yet, in alpha-numeric
+     * order.
+     */
+    readonly allowUnorderedMigrations?: boolean;
 }
 /**
  * All migration methods ({@link Migrator.migrateTo | migrateTo},
@@ -231,12 +246,13 @@ export interface MigrationResultSet {
      */
     readonly results?: MigrationResult[];
 }
+type MigrationDirection = 'Up' | 'Down';
 export interface MigrationResult {
     readonly migrationName: string;
     /**
      * The direction in which this migration was executed.
      */
-    readonly direction: 'Up' | 'Down';
+    readonly direction: MigrationDirection;
     /**
      * The execution status.
      *
@@ -293,3 +309,4 @@ export interface MigrationInfo {
      */
     executedAt?: Date;
 }
+export {};

package/dist/cjs/migration/migrator.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Migrator = exports.NO_MIGRATIONS = exports.MIGRATION_LOCK_ID = exports.DEFAULT_MIGRATION_LOCK_TABLE = exports.DEFAULT_MIGRATION_TABLE = void 0;
+exports.Migrator = exports.NO_MIGRATIONS = exports.MIGRATION_LOCK_ID = exports.DEFAULT_ALLOW_UNORDERED_MIGRATIONS = exports.DEFAULT_MIGRATION_LOCK_TABLE = exports.DEFAULT_MIGRATION_TABLE = void 0;
 const noop_plugin_js_1 = require("../plugin/noop-plugin.js");
 const with_schema_plugin_js_1 = require("../plugin/with-schema/with-schema-plugin.js");
 const object_utils_js_1 = require("../util/object-utils.js");
 exports.DEFAULT_MIGRATION_TABLE = 'kysely_migration';
 exports.DEFAULT_MIGRATION_LOCK_TABLE = 'kysely_migration_lock';
+exports.DEFAULT_ALLOW_UNORDERED_MIGRATIONS = false;
 exports.MIGRATION_LOCK_ID = 'migration_lock';
 exports.NO_MIGRATIONS = (0, object_utils_js_1.freeze)({ __noMigrations__: true });
 /**
@@ -72,7 +73,7 @@ class Migrator {
      * This method goes through all possible migrations provided by the provider and runs the
      * ones whose names come alphabetically after the last migration that has been run. If the
      * list of executed migrations doesn't match the beginning of the list of possible migrations
-     * an error is thrown.
+     * an error is returned.
      *
      * ### Examples
      *
@@ -109,7 +110,7 @@ class Migrator {
      * ```
      */
     async migrateToLatest() {
-        return this.#migrate(({ migrations }) => migrations.length - 1);
+        return this.#migrate(() => ({ direction: 'Up', step: Infinity }));
     }
     /**
      * Migrate up/down to a specific migration.
@@ -135,15 +136,27 @@ class Migrator {
      * ```
      */
     async migrateTo(targetMigrationName) {
-        return this.#migrate(({ migrations }) => {
+        return this.#migrate(({ migrations, executedMigrations, pendingMigrations, }) => {
             if (targetMigrationName === exports.NO_MIGRATIONS) {
-                return -1;
+                return { direction: 'Down', step: Infinity };
             }
-            const index = migrations.findIndex((it) => it.name === targetMigrationName);
-            if (index === -1) {
+            if (!migrations.find((m) => m.name === targetMigrationName)) {
                 throw new Error(`migration "${targetMigrationName}" doesn't exist`);
             }
-            return index;
+            const executedIndex = executedMigrations.indexOf(targetMigrationName);
+            const pendingIndex = pendingMigrations.findIndex((m) => m.name === targetMigrationName);
+            if (executedIndex !== -1) {
+                return {
+                    direction: 'Down',
+                    step: executedMigrations.length - executedIndex - 1,
+                };
+            }
+            else if (pendingIndex !== -1) {
+                return { direction: 'Up', step: pendingIndex + 1 };
+            }
+            else {
+                throw new Error(`migration "${targetMigrationName}" isn't executed or pending`);
+            }
         });
     }
     /**
@@ -161,7 +174,7 @@ class Migrator {
      * ```
      */
     async migrateUp() {
-        return this.#migrate(({ currentIndex, migrations }) => Math.min(currentIndex + 1, migrations.length - 1));
+        return this.#migrate(() => ({ direction: 'Up', step: 1 }));
     }
     /**
      * Migrate one step down.
@@ -178,12 +191,12 @@ class Migrator {
      * ```
      */
     async migrateDown() {
-        return this.#migrate(({ currentIndex }) => Math.max(currentIndex - 1, -1));
+        return this.#migrate(() => ({ direction: 'Down', step: 1 }));
     }
-    async #migrate(getTargetMigrationIndex) {
+    async #migrate(getMigrationDirectionAndStep) {
         try {
             await this.#ensureMigrationTablesExists();
-            return await this.#runMigrations(getTargetMigrationIndex);
+            return await this.#runMigrations(getMigrationDirectionAndStep);
         }
         catch (error) {
             if (error instanceof MigrationResultSetError) {
@@ -201,6 +214,9 @@ class Migrator {
     get #migrationLockTable() {
         return this.#props.migrationLockTableName ?? exports.DEFAULT_MIGRATION_LOCK_TABLE;
     }
+    get #allowUnorderedMigrations() {
+        return (this.#props.allowUnorderedMigrations ?? exports.DEFAULT_ALLOW_UNORDERED_MIGRATIONS);
+    }
     get #schemaPlugin() {
         if (this.#migrationTableSchema) {
             return new with_schema_plugin_js_1.WithSchemaPlugin(this.#migrationTableSchema);
@@ -311,7 +327,7 @@ class Migrator {
             .executeTakeFirst();
         return !!lockRow;
     }
-    async #runMigrations(getTargetMigrationIndex) {
+    async #runMigrations(getMigrationDirectionAndStep) {
         const adapter = this.#props.db.getExecutor().adapter;
         const lockOptions = (0, object_utils_js_1.freeze)({
             lockTable: this.#props.migrationLockTableName ?? exports.DEFAULT_MIGRATION_LOCK_TABLE,
@@ -325,15 +341,15 @@ class Migrator {
                 if (state.migrations.length === 0) {
                     return { results: [] };
                 }
-                const targetIndex = getTargetMigrationIndex(state);
-                if (targetIndex === undefined) {
+                const { direction, step } = getMigrationDirectionAndStep(state);
+                if (step <= 0) {
                     return { results: [] };
                 }
-                if (targetIndex < state.currentIndex) {
-                    return await this.#migrateDown(db, state, targetIndex);
+                if (direction === 'Down') {
+                    return await this.#migrateDown(db, state, step);
                 }
-                else if (targetIndex > state.currentIndex) {
-                    return await this.#migrateUp(db, state, targetIndex);
+                else if (direction === 'Up') {
+                    return await this.#migrateUp(db, state, step);
                 }
                 return { results: [] };
             }
@@ -351,10 +367,21 @@ class Migrator {
     async #getState(db) {
         const migrations = await this.#resolveMigrations();
         const executedMigrations = await this.#getExecutedMigrations(db);
-        this.#ensureMigrationsNotCorrupted(migrations, executedMigrations);
+        this.#ensureNoMissingMigrations(migrations, executedMigrations);
+        if (!this.#allowUnorderedMigrations) {
+            this.#ensureMigrationsInOrder(migrations, executedMigrations);
+        }
+        const pendingMigrations = this.#getPendingMigrations(migrations, executedMigrations);
         return (0, object_utils_js_1.freeze)({
             migrations,
-            currentIndex: migrations.findIndex((it) => it.name === (0, object_utils_js_1.getLast)(executedMigrations)),
+            executedMigrations,
+            lastMigration: (0, object_utils_js_1.getLast)(executedMigrations),
+            pendingMigrations,
+        });
+    }
+    #getPendingMigrations(migrations, executedMigrations) {
+        return migrations.filter((migration) => {
+            return !executedMigrations.includes(migration.name);
         });
     }
     async #resolveMigrations() {
@@ -371,36 +398,43 @@ class Migrator {
             .withPlugin(this.#schemaPlugin)
             .selectFrom(this.#migrationTable)
             .select('name')
-            .orderBy('name')
+            .orderBy(['timestamp', 'name'])
             .execute();
         return executedMigrations.map((it) => it.name);
     }
-    #ensureMigrationsNotCorrupted(migrations, executedMigrations) {
+    #ensureNoMissingMigrations(migrations, executedMigrations) {
+        // Ensure all executed migrations exist in the `migrations` list.
         for (const executed of executedMigrations) {
             if (!migrations.some((it) => it.name === executed)) {
                 throw new Error(`corrupted migrations: previously executed migration ${executed} is missing`);
             }
         }
-        // Now we know all executed migrations exist in the `migrations` list.
-        // Next we need to make sure that the executed migratiosns are the first
-        // ones in the migration list.
+    }
+    #ensureMigrationsInOrder(migrations, executedMigrations) {
+        // Ensure the executed migrations are the first ones in the migration list.
         for (let i = 0; i < executedMigrations.length; ++i) {
             if (migrations[i].name !== executedMigrations[i]) {
                 throw new Error(`corrupted migrations: expected previously executed migration ${executedMigrations[i]} to be at index ${i} but ${migrations[i].name} was found in its place. New migrations must always have a name that comes alphabetically after the last executed migration.`);
             }
         }
     }
-    async #migrateDown(db, state, targetIndex) {
-        const results = [];
-        for (let i = state.currentIndex; i > targetIndex; --i) {
-            results.push({
-                migrationName: state.migrations[i].name,
+    async #migrateDown(db, state, step) {
+        const migrationsToRollback = state.executedMigrations
+            .slice()
+            .reverse()
+            .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',
-            });
-        }
+            };
+        });
         for (let i = 0; i < results.length; ++i) {
-            const migration = state.migrations.find((it) => it.name === results[i].migrationName);
+            const migration = migrationsToRollback[i];
             try {
                 if (migration.down) {
                     await migration.down(db);
@@ -430,17 +464,17 @@ class Migrator {
         }
         return { results };
     }
-    async #migrateUp(db, state, targetIndex) {
-        const results = [];
-        for (let i = state.currentIndex + 1; i <= targetIndex; ++i) {
-            results.push({
-                migrationName: state.migrations[i].name,
+    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',
-            });
-        }
-        for (let i = 0; i < results.length; ++i) {
-            const migration = state.migrations.find((it) => it.name === results[i].migrationName);
+            };
+        });
+        for (let i = 0; i < results.length; i++) {
+            const migration = state.pendingMigrations[i];
             try {
                 await migration.up(db);
                 await db

package/dist/cjs/operation-node/insert-query-node.d.ts

@@ -19,6 +19,7 @@ export interface InsertQueryNode extends OperationNode {
     readonly ignore?: boolean;
     readonly replace?: boolean;
     readonly explain?: ExplainNode;
+    readonly defaultValues?: boolean;
 }
 /**
  * @internal

package/dist/cjs/operation-node/limit-node.d.ts

@@ -1,13 +1,12 @@
 import { OperationNode } from './operation-node.js';
-import { ValueNode } from './value-node.js';
 export interface LimitNode extends OperationNode {
     readonly kind: 'LimitNode';
-    readonly limit: ValueNode;
+    readonly limit: OperationNode;
 }
 /**
  * @internal
  */
 export declare const LimitNode: Readonly<{
     is(node: OperationNode): node is LimitNode;
-    create(limit: number): LimitNode;
+    create(limit: OperationNode): LimitNode;
 }>;

package/dist/cjs/operation-node/limit-node.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LimitNode = void 0;
 const object_utils_js_1 = require("../util/object-utils.js");
-const value_node_js_1 = require("./value-node.js");
 /**
  * @internal
  */
@@ -13,7 +12,7 @@ exports.LimitNode = (0, object_utils_js_1.freeze)({
     create(limit) {
         return (0, object_utils_js_1.freeze)({
             kind: 'LimitNode',
-            limit: value_node_js_1.ValueNode.create(limit),
+            limit,
         });
     },
 });

package/dist/cjs/operation-node/offset-node.d.ts

@@ -1,13 +1,12 @@
 import { OperationNode } from './operation-node.js';
-import { ValueNode } from './value-node.js';
 export interface OffsetNode extends OperationNode {
     readonly kind: 'OffsetNode';
-    readonly offset: ValueNode;
+    readonly offset: OperationNode;
 }
 /**
  * @internal
  */
 export declare const OffsetNode: Readonly<{
     is(node: OperationNode): node is OffsetNode;
-    create(offset: number): OffsetNode;
+    create(offset: OperationNode): OffsetNode;
 }>;

package/dist/cjs/operation-node/offset-node.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OffsetNode = void 0;
 const object_utils_js_1 = require("../util/object-utils.js");
-const value_node_js_1 = require("./value-node.js");
 /**
  * @internal
  */
@@ -13,7 +12,7 @@ exports.OffsetNode = (0, object_utils_js_1.freeze)({
     create(offset) {
         return (0, object_utils_js_1.freeze)({
             kind: 'OffsetNode',
-            offset: value_node_js_1.ValueNode.create(offset),
+            offset,
         });
     },
 });

package/dist/cjs/operation-node/operation-node-transformer.js

@@ -259,6 +259,7 @@ class OperationNodeTransformer {
             ignore: node.ignore,
             replace: node.replace,
             explain: this.transformNode(node.explain),
+            defaultValues: node.defaultValues,
         });
     }
     transformValues(node) {
@@ -635,6 +636,7 @@ class OperationNodeTransformer {
             kind: 'SelectModifierNode',
             modifier: node.modifier,
             rawModifier: this.transformNode(node.rawModifier),
+            of: this.transformNodeList(node.of),
         });
     }
     transformCreateType(node) {

package/dist/cjs/operation-node/select-modifier-node.d.ts

@@ -4,12 +4,13 @@ export interface SelectModifierNode extends OperationNode {
     readonly kind: 'SelectModifierNode';
     readonly modifier?: SelectModifier;
     readonly rawModifier?: OperationNode;
+    readonly of?: ReadonlyArray<OperationNode>;
 }
 /**
  * @internal
  */
 export declare const SelectModifierNode: Readonly<{
     is(node: OperationNode): node is SelectModifierNode;
-    create(modifier: SelectModifier): SelectModifierNode;
+    create(modifier: SelectModifier, of?: ReadonlyArray<OperationNode>): SelectModifierNode;
     createWithExpression(modifier: OperationNode): SelectModifierNode;
 }>;

package/dist/cjs/operation-node/select-modifier-node.js

@@ -9,10 +9,11 @@ exports.SelectModifierNode = (0, object_utils_js_1.freeze)({
     is(node) {
         return node.kind === 'SelectModifierNode';
     },
-    create(modifier) {
+    create(modifier, of) {
         return (0, object_utils_js_1.freeze)({
             kind: 'SelectModifierNode',
             modifier,
+            of,
         });
     },
     createWithExpression(modifier) {

package/dist/cjs/query-builder/aggregate-function-builder.d.ts

@@ -199,6 +199,23 @@ export declare class AggregateFunctionBuilder<DB, TB extends keyof DB, O = unkno
      * what the provided function returns.
      */
     $call<T>(func: (qb: this) => T): T;
+    /**
+     * Casts the expression to the given type.
+     *
+     * This method call doesn't change the SQL in any way. This methods simply
+     * returns a copy of this `AggregateFunctionBuilder` with a new output type.
+     */
+    $castTo<C>(): AggregateFunctionBuilder<DB, TB, C>;
+    /**
+     * Omit null from the expression's type.
+     *
+     * This function can be useful in cases where you know an expression can't be
+     * null, but Kysely is unable to infer it.
+     *
+     * This method call doesn't change the SQL in any way. This methods simply
+     * returns a copy of `this` with a new output type.
+     */
+    $notNull(): AggregateFunctionBuilder<DB, TB, Exclude<O, null>>;
     /**
      * Creates the OperationNode that describes how to compile this expression into SQL.
      *

package/dist/cjs/query-builder/aggregate-function-builder.js

@@ -172,6 +172,27 @@ class AggregateFunctionBuilder {
     $call(func) {
         return func(this);
     }
+    /**
+     * Casts the expression to the given type.
+     *
+     * This method call doesn't change the SQL in any way. This methods simply
+     * returns a copy of this `AggregateFunctionBuilder` with a new output type.
+     */
+    $castTo() {
+        return new AggregateFunctionBuilder(this.#props);
+    }
+    /**
+     * Omit null from the expression's type.
+     *
+     * This function can be useful in cases where you know an expression can't be
+     * null, but Kysely is unable to infer it.
+     *
+     * This method call doesn't change the SQL in any way. This methods simply
+     * returns a copy of `this` with a new output type.
+     */
+    $notNull() {
+        return new AggregateFunctionBuilder(this.#props);
+    }
     toOperationNode() {
         return this.#props.aggregateFunctionNode;
     }

package/dist/cjs/query-builder/case-builder.d.ts

@@ -29,7 +29,7 @@ export declare class CaseThenBuilder<DB, TB extends keyof DB, W, O> {
      * A `then` call can be followed by {@link Whenable.when}, {@link CaseWhenBuilder.else},
      * {@link CaseWhenBuilder.end} or {@link CaseWhenBuilder.endCase} call.
      */
-    then<E extends Expression<any>>(expression: E): CaseWhenBuilder<DB, TB, W, O | ExtractTypeFromValueExpression<E>>;
+    then<E extends Expression<unknown>>(expression: E): CaseWhenBuilder<DB, TB, W, O | ExtractTypeFromValueExpression<E>>;
     then<V>(value: V): CaseWhenBuilder<DB, TB, W, O | V>;
 }
 export declare class CaseWhenBuilder<DB, TB extends keyof DB, W, O> implements Whenable<DB, TB, W, O>, Endable<DB, TB, O | null> {
@@ -48,7 +48,7 @@ export declare class CaseWhenBuilder<DB, TB extends keyof DB, W, O> implements W
      *
      * An `else` call must be followed by an {@link Endable.end} or {@link Endable.endCase} call.
      */
-    else<O2>(expression: Expression<O2>): CaseEndBuilder<DB, TB, O | O2>;
+    else<E extends Expression<unknown>>(expression: E): CaseEndBuilder<DB, TB, O | ExtractTypeFromValueExpression<E>>;
     else<V>(value: V): CaseEndBuilder<DB, TB, O | V>;
     /**
      * Adds an `end` keyword to the case operator.

package/dist/cjs/query-builder/delete-query-builder.d.ts

@@ -23,6 +23,7 @@ import { ComparisonOperatorExpression, OperandValueExpressionOrList } from '../p
 import { KyselyTypeError } from '../util/type-error.js';
 import { Streamable } from '../util/streamable.js';
 import { ExpressionOrFactory } from '../parser/expression-parser.js';
+import { ValueExpression } from '../parser/value-parser.js';
 export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements WhereInterface<DB, TB>, ReturningInterface<DB, TB, O>, OperationNodeSource, Compilable<O>, Explainable, Streamable<O> {
     #private;
     constructor(props: DeleteQueryBuilderProps);
@@ -814,7 +815,7 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
      *   .execute()
      * ```
      */
-    limit(limit: number): DeleteQueryBuilder<DB, TB, O>;
+    limit(limit: ValueExpression<DB, TB, number>): DeleteQueryBuilder<DB, TB, O>;
     /**
      * Simply calls the provided function passing `this` as the only argument. `$call` returns
      * what the provided function returns.
@@ -877,10 +878,10 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
     /**
      * Change the output type of the query.
      *
-     * You should only use this method as the last resort if the types
-     * don't support your use case.
+     * This method call doesn't change the SQL in any way. This methods simply
+     * returns a copy of this `DeleteQueryBuilder` with a new output type.
      */
-    $castTo<T>(): DeleteQueryBuilder<DB, TB, T>;
+    $castTo<C>(): DeleteQueryBuilder<DB, TB, C>;
     /**
      * Narrows (parts of) the output type of the query.
      *

package/dist/cjs/query-builder/delete-query-builder.js

@@ -13,6 +13,7 @@ const delete_query_node_js_1 = require("../operation-node/delete-query-node.js")
 const limit_node_js_1 = require("../operation-node/limit-node.js");
 const order_by_parser_js_1 = require("../parser/order-by-parser.js");
 const binary_operation_parser_js_1 = require("../parser/binary-operation-parser.js");
+const value_parser_js_1 = require("../parser/value-parser.js");
 class DeleteQueryBuilder {
     #props;
     constructor(props) {
@@ -139,7 +140,7 @@ class DeleteQueryBuilder {
     limit(limit) {
         return new DeleteQueryBuilder({
             ...this.#props,
-            queryNode: delete_query_node_js_1.DeleteQueryNode.cloneWithLimit(this.#props.queryNode, limit_node_js_1.LimitNode.create(limit)),
+            queryNode: delete_query_node_js_1.DeleteQueryNode.cloneWithLimit(this.#props.queryNode, limit_node_js_1.LimitNode.create((0, value_parser_js_1.parseValueExpression)(limit))),
         });
     }
     /**
@@ -213,8 +214,8 @@ class DeleteQueryBuilder {
     /**
      * Change the output type of the query.
      *
-     * You should only use this method as the last resort if the types
-     * don't support your use case.
+     * This method call doesn't change the SQL in any way. This methods simply
+     * returns a copy of this `DeleteQueryBuilder` with a new output type.
      */
     $castTo() {
         return new DeleteQueryBuilder(this.#props);