kysely 0.23.3 → 0.23.4

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

@@ -1,7 +1,7 @@
 import { OperationNodeSource } from '../operation-node/operation-node-source.js';
 import { CompiledQuery } from '../query-compiler/compiled-query.js';
 import { JoinCallbackExpression, JoinReferenceExpression } from '../parser/join-parser.js';
-import { TableExpression } from '../parser/table-parser.js';
+import { From, FromTables, TableExpression } from '../parser/table-parser.js';
 import { SelectExpression } from '../parser/select-parser.js';
 import { ReturningRow } from '../parser/returning-parser.js';
 import { ReferenceExpression } from '../parser/reference-parser.js';
@@ -428,6 +428,82 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
      * ```
      */
     clearWhere(): DeleteQueryBuilder<DB, TB, O>;
+    /**
+     * Adds a `using` clause to the query.
+     *
+     * This clause allows adding additional tables to the query for filtering/returning
+     * only. Usually a non-standard syntactic-sugar alternative to a `where` with a sub-query.
+     *
+     * ### Examples:
+     *
+     * ```ts
+     * await db
+     *   .deleteFrom('pet')
+     *   .using('person')
+     *   .whereRef('pet.owner_id', '=', 'person.id')
+     *   .where('person.first_name', '=', 'Bob')
+     *   .executeTakeFirstOrThrow()
+     * ```
+     *
+     * The generated SQL (PostgreSQL):
+     *
+     * ```sql
+     * delete from "pet"
+     * using "person"
+     * where "pet"."owner_id" = "person"."id"
+     *   and "person"."first_name" = $1
+     * ```
+     *
+     * On supported databases such as MySQL, this clause allows using joins, but requires
+     * at least one of the tables after the `from` keyword to be also named after
+     * the `using` keyword. See also {@link innerJoin}, {@link leftJoin}, {@link rightJoin}
+     * and {@link fullJoin}.
+     *
+     * ```ts
+     * await db
+     *   .deleteFrom('pet')
+     *   .using('pet')
+     *   .leftJoin('person', 'person.id', 'pet.owner_id')
+     *   .where('person.first_name', '=', 'Bob')
+     *   .executeTakeFirstOrThrow()
+     * ```
+     *
+     * The generated SQL (MySQL):
+     *
+     * ```sql
+     * delete from `pet`
+     * using `pet`
+     * left join `person` on `person`.`id` = `pet`.`owner_id`
+     * where `person`.`first_name` = ?
+     * ```
+     *
+     * You can also chain multiple invocations of this method, or pass an array to
+     * a single invocation to name multiple tables.
+     *
+     * ```ts
+     * await db
+     *   .deleteFrom('toy')
+     *   .using(['pet', 'person'])
+     *   .whereRef('toy.pet_id', '=', 'pet.id')
+     *   .whereRef('pet.owner_id', '=', 'person.id')
+     *   .where('person.first_name', '=', 'Bob')
+     *   .returning('pet.name')
+     *   .executeTakeFirstOrThrow()
+     * ```
+     *
+     * The generated SQL (PostgreSQL):
+     *
+     * ```sql
+     * delete from "toy"
+     * using "pet", "person"
+     * where "toy"."pet_id" = "pet"."id"
+     *   and "pet"."owner_id" = "person"."id"
+     *   and "person"."first_name" = $1
+     * returning "pet"."name"
+     * ```
+     */
+    using<TE extends TableExpression<DB, keyof DB>>(tables: TE[]): DeleteQueryBuilder<From<DB, TE>, FromTables<DB, TB, TE>, O>;
+    using<TE extends TableExpression<DB, keyof DB>>(table: TE): DeleteQueryBuilder<From<DB, TE>, FromTables<DB, TB, TE>, O>;
     /**
      * Joins another table to the query using an inner join.
      *
@@ -678,7 +754,7 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
      * Simply calls the given function passing `this` as the only argument.
      *
      * If you want to conditionally call a method on `this`, see
-     * the {@link if} method.
+     * the {@link $if} method.
      *
      * ### Examples
      *
@@ -691,10 +767,14 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
      * }
      *
      * db.deleteFrom('person')
-     *   .call(log)
+     *   .$call(log)
      *   .execute()
      * ```
      */
+    $call<T>(func: (qb: this) => T): T;
+    /**
+     * @deprecated Use `$call` instead
+     */
     call<T>(func: (qb: this) => T): T;
     /**
      * Call `func(this)` if `condition` is true.
@@ -714,7 +794,7 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
      *     .deleteFrom('person')
      *     .where('id', '=', id)
      *     .returning(['id', 'first_name'])
-     *     .if(returnLastName, (qb) => qb.returning('last_name'))
+     *     .$if(returnLastName, (qb) => qb.returning('last_name'))
      *     .executeTakeFirstOrThrow()
      * }
      * ```
@@ -731,6 +811,10 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
      * }
      * ```
      */
+    $if<O2>(condition: boolean, func: (qb: this) => DeleteQueryBuilder<DB, TB, O2>): DeleteQueryBuilder<DB, TB, O2 extends DeleteResult ? DeleteResult : O extends DeleteResult ? Partial<O2> : MergePartial<O, O2>>;
+    /**
+     * @deprecated Use `$if` instead
+     */
     if<O2>(condition: boolean, func: (qb: this) => DeleteQueryBuilder<DB, TB, O2>): DeleteQueryBuilder<DB, TB, O2 extends DeleteResult ? DeleteResult : O extends DeleteResult ? Partial<O2> : MergePartial<O, O2>>;
     /**
      * Change the output type of the query.
@@ -738,6 +822,10 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
      * You should only use this method as the last resort if the types
      * don't support your use case.
      */
+    $castTo<T>(): DeleteQueryBuilder<DB, TB, T>;
+    /**
+     * @deprecated Use `$castTo` instead.
+     */
     castTo<T>(): DeleteQueryBuilder<DB, TB, T>;
     /**
      * Asserts that query's output row type equals the given type `T`.
@@ -767,19 +855,23 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
      *     .deleteFrom('person')
      *     .where('id', '=', person.id)
      *     .returning('first_name')
-     *     .assertType<{ first_name: string }>()
+     *     .$assertType<{ first_name: string }>()
      *   )
      *   .with('deleted_pet', (qb) => qb
      *     .deleteFrom('pet')
      *     .where('owner_id', '=', person.id)
      *     .returning(['name as pet_name', 'species'])
-     *     .assertType<{ pet_name: string, species: Species }>()
+     *     .$assertType<{ pet_name: string, species: Species }>()
      *   )
      *   .selectFrom(['deleted_person', 'deleted_pet'])
      *   .selectAll()
      *   .executeTakeFirstOrThrow()
      * ```
      */
+    $assertType<T extends O>(): O extends T ? DeleteQueryBuilder<DB, TB, T> : KyselyTypeError<`$assertType() call failed: The type passed in is not equal to the output type of the query.`>;
+    /**
+     * @deprecated Use `$assertType` instead.
+     */
     assertType<T extends O>(): O extends T ? DeleteQueryBuilder<DB, TB, T> : KyselyTypeError<`assertType() call failed: The type passed in is not equal to the output type of the query.`>;
     /**
      * Returns a copy of this DeleteQueryBuilder instance with the given plugin installed.

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

@@ -1,5 +1,6 @@
 /// <reference types="./delete-query-builder.d.ts" />
 import { parseJoin, } from '../parser/join-parser.js';
+import { parseTableExpressionOrList, } from '../parser/table-parser.js';
 import { parseSelectExpressionOrList, parseSelectAll, } from '../parser/select-parser.js';
 import { QueryNode } from '../operation-node/query-node.js';
 import { preventAwait } from '../util/prevent-await.js';
@@ -71,6 +72,12 @@ export class DeleteQueryBuilder {
             queryNode: QueryNode.cloneWithoutWhere(this.#props.queryNode),
         });
     }
+    using(tables) {
+        return new DeleteQueryBuilder({
+            ...this.#props,
+            queryNode: DeleteQueryNode.cloneWithUsing(this.#props.queryNode, parseTableExpressionOrList(tables)),
+        });
+    }
     innerJoin(...args) {
         return new DeleteQueryBuilder({
             ...this.#props,
@@ -175,7 +182,7 @@ export class DeleteQueryBuilder {
      * Simply calls the given function passing `this` as the only argument.
      *
      * If you want to conditionally call a method on `this`, see
-     * the {@link if} method.
+     * the {@link $if} method.
      *
      * ### Examples
      *
@@ -188,13 +195,19 @@ export class DeleteQueryBuilder {
      * }
      *
      * db.deleteFrom('person')
-     *   .call(log)
+     *   .$call(log)
      *   .execute()
      * ```
      */
-    call(func) {
+    $call(func) {
         return func(this);
     }
+    /**
+     * @deprecated Use `$call` instead
+     */
+    call(func) {
+        return this.$call(func);
+    }
     /**
      * Call `func(this)` if `condition` is true.
      *
@@ -213,7 +226,7 @@ export class DeleteQueryBuilder {
      *     .deleteFrom('person')
      *     .where('id', '=', id)
      *     .returning(['id', 'first_name'])
-     *     .if(returnLastName, (qb) => qb.returning('last_name'))
+     *     .$if(returnLastName, (qb) => qb.returning('last_name'))
      *     .executeTakeFirstOrThrow()
      * }
      * ```
@@ -230,7 +243,7 @@ export class DeleteQueryBuilder {
      * }
      * ```
      */
-    if(condition, func) {
+    $if(condition, func) {
         if (condition) {
             return func(this);
         }
@@ -238,15 +251,27 @@ export class DeleteQueryBuilder {
             ...this.#props,
         });
     }
+    /**
+     * @deprecated Use `$if` instead
+     */
+    if(condition, func) {
+        return this.$if(condition, func);
+    }
     /**
      * 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.
      */
-    castTo() {
+    $castTo() {
         return new DeleteQueryBuilder(this.#props);
     }
+    /**
+     * @deprecated Use `$castTo` instead.
+     */
+    castTo() {
+        return this.$castTo();
+    }
     /**
      * Asserts that query's output row type equals the given type `T`.
      *
@@ -275,19 +300,25 @@ export class DeleteQueryBuilder {
      *     .deleteFrom('person')
      *     .where('id', '=', person.id)
      *     .returning('first_name')
-     *     .assertType<{ first_name: string }>()
+     *     .$assertType<{ first_name: string }>()
      *   )
      *   .with('deleted_pet', (qb) => qb
      *     .deleteFrom('pet')
      *     .where('owner_id', '=', person.id)
      *     .returning(['name as pet_name', 'species'])
-     *     .assertType<{ pet_name: string, species: Species }>()
+     *     .$assertType<{ pet_name: string, species: Species }>()
      *   )
      *   .selectFrom(['deleted_person', 'deleted_pet'])
      *   .selectAll()
      *   .executeTakeFirstOrThrow()
      * ```
      */
+    $assertType() {
+        return new DeleteQueryBuilder(this.#props);
+    }
+    /**
+     * @deprecated Use `$assertType` instead.
+     */
     assertType() {
         return new DeleteQueryBuilder(this.#props);
     }

package/dist/esm/query-builder/insert-query-builder.d.ts

@@ -456,7 +456,7 @@ export declare class InsertQueryBuilder<DB, TB extends keyof DB, O> implements R
      * Simply calls the given function passing `this` as the only argument.
      *
      * If you want to conditionally call a method on `this`, see
-     * the {@link if} method.
+     * the {@link $if} method.
      *
      * ### Examples
      *
@@ -470,10 +470,14 @@ export declare class InsertQueryBuilder<DB, TB extends keyof DB, O> implements R
      *
      * db.updateTable('person')
      *   .set(values)
-     *   .call(log)
+     *   .$call(log)
      *   .execute()
      * ```
      */
+    $call<T>(func: (qb: this) => T): T;
+    /**
+     * @deprecated Use `$call` instead
+     */
     call<T>(func: (qb: this) => T): T;
     /**
      * Call `func(this)` if `condition` is true.
@@ -493,7 +497,7 @@ export declare class InsertQueryBuilder<DB, TB extends keyof DB, O> implements R
      *     .insertInto('person')
      *     .values(values)
      *     .returning(['id', 'first_name'])
-     *     .if(returnLastName, (qb) => qb.returning('last_name'))
+     *     .$if(returnLastName, (qb) => qb.returning('last_name'))
      *     .executeTakeFirstOrThrow()
      * }
      * ```
@@ -510,6 +514,10 @@ export declare class InsertQueryBuilder<DB, TB extends keyof DB, O> implements R
      * }
      * ```
      */
+    $if<O2>(condition: boolean, func: (qb: this) => InsertQueryBuilder<DB, TB, O2>): InsertQueryBuilder<DB, TB, O2 extends InsertResult ? InsertResult : O extends InsertResult ? Partial<O2> : MergePartial<O, O2>>;
+    /**
+     * @deprecated Use `$if` instead
+     */
     if<O2>(condition: boolean, func: (qb: this) => InsertQueryBuilder<DB, TB, O2>): InsertQueryBuilder<DB, TB, O2 extends InsertResult ? InsertResult : O extends InsertResult ? Partial<O2> : MergePartial<O, O2>>;
     /**
      * Change the output type of the query.
@@ -517,6 +525,10 @@ export declare class InsertQueryBuilder<DB, TB extends keyof DB, O> implements R
      * You should only use this method as the last resort if the types
      * don't support your use case.
      */
+    $castTo<T>(): InsertQueryBuilder<DB, TB, T>;
+    /**
+     * @deprecated Use `$castTo` instead.
+     */
     castTo<T>(): InsertQueryBuilder<DB, TB, T>;
     /**
      * Asserts that query's output row type equals the given type `T`.
@@ -546,19 +558,23 @@ export declare class InsertQueryBuilder<DB, TB extends keyof DB, O> implements R
      *     .insertInto('person')
      *     .values(person)
      *     .returning('id')
-     *     .assertType<{ id: string }>()
+     *     .$assertType<{ id: string }>()
      *   )
      *   .with('new_pet', (qb) => qb
      *     .insertInto('pet')
      *     .values({ owner_id: (eb) => eb.selectFrom('new_person').select('id'), ...pet })
      *     .returning(['name as pet_name', 'species'])
-     *     .assertType<{ pet_name: string, species: Species }>()
+     *     .$assertType<{ pet_name: string, species: Species }>()
      *   )
      *   .selectFrom(['new_person', 'new_pet'])
      *   .selectAll()
      *   .executeTakeFirstOrThrow()
      * ```
      */
+    $assertType<T extends O>(): O extends T ? InsertQueryBuilder<DB, TB, T> : KyselyTypeError<`$assertType() call failed: The type passed in is not equal to the output type of the query.`>;
+    /**
+     * @deprecated Use `$assertType` instead.
+     */
     assertType<T extends O>(): O extends T ? InsertQueryBuilder<DB, TB, T> : KyselyTypeError<`assertType() call failed: The type passed in is not equal to the output type of the query.`>;
     /**
      * Returns a copy of this InsertQueryBuilder instance with the given plugin installed.

package/dist/esm/query-builder/insert-query-builder.js

@@ -3,7 +3,7 @@ import { parseSelectExpressionOrList, parseSelectAll, } from '../parser/select-p
 import { parseInsertObjectOrList, } from '../parser/insert-values-parser.js';
 import { InsertQueryNode } from '../operation-node/insert-query-node.js';
 import { QueryNode } from '../operation-node/query-node.js';
-import { parseUpdateObject, } from '../parser/update-set-parser.js';
+import { parseUpdateObject } from '../parser/update-set-parser.js';
 import { preventAwait } from '../util/prevent-await.js';
 import { freeze } from '../util/object-utils.js';
 import { OnDuplicateKeyNode } from '../operation-node/on-duplicate-key-node.js';
@@ -318,7 +318,7 @@ export class InsertQueryBuilder {
      * Simply calls the given function passing `this` as the only argument.
      *
      * If you want to conditionally call a method on `this`, see
-     * the {@link if} method.
+     * the {@link $if} method.
      *
      * ### Examples
      *
@@ -332,13 +332,19 @@ export class InsertQueryBuilder {
      *
      * db.updateTable('person')
      *   .set(values)
-     *   .call(log)
+     *   .$call(log)
      *   .execute()
      * ```
      */
-    call(func) {
+    $call(func) {
         return func(this);
     }
+    /**
+     * @deprecated Use `$call` instead
+     */
+    call(func) {
+        return this.$call(func);
+    }
     /**
      * Call `func(this)` if `condition` is true.
      *
@@ -357,7 +363,7 @@ export class InsertQueryBuilder {
      *     .insertInto('person')
      *     .values(values)
      *     .returning(['id', 'first_name'])
-     *     .if(returnLastName, (qb) => qb.returning('last_name'))
+     *     .$if(returnLastName, (qb) => qb.returning('last_name'))
      *     .executeTakeFirstOrThrow()
      * }
      * ```
@@ -374,7 +380,7 @@ export class InsertQueryBuilder {
      * }
      * ```
      */
-    if(condition, func) {
+    $if(condition, func) {
         if (condition) {
             return func(this);
         }
@@ -382,15 +388,27 @@ export class InsertQueryBuilder {
             ...this.#props,
         });
     }
+    /**
+     * @deprecated Use `$if` instead
+     */
+    if(condition, func) {
+        return this.$if(condition, func);
+    }
     /**
      * 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.
      */
-    castTo() {
+    $castTo() {
         return new InsertQueryBuilder(this.#props);
     }
+    /**
+     * @deprecated Use `$castTo` instead.
+     */
+    castTo() {
+        return this.$castTo();
+    }
     /**
      * Asserts that query's output row type equals the given type `T`.
      *
@@ -419,19 +437,25 @@ export class InsertQueryBuilder {
      *     .insertInto('person')
      *     .values(person)
      *     .returning('id')
-     *     .assertType<{ id: string }>()
+     *     .$assertType<{ id: string }>()
      *   )
      *   .with('new_pet', (qb) => qb
      *     .insertInto('pet')
      *     .values({ owner_id: (eb) => eb.selectFrom('new_person').select('id'), ...pet })
      *     .returning(['name as pet_name', 'species'])
-     *     .assertType<{ pet_name: string, species: Species }>()
+     *     .$assertType<{ pet_name: string, species: Species }>()
      *   )
      *   .selectFrom(['new_person', 'new_pet'])
      *   .selectAll()
      *   .executeTakeFirstOrThrow()
      * ```
      */
+    $assertType() {
+        return new InsertQueryBuilder(this.#props);
+    }
+    /**
+     * @deprecated Use `$assertType` instead.
+     */
     assertType() {
         return new InsertQueryBuilder(this.#props);
     }

package/dist/esm/query-builder/select-query-builder.d.ts

@@ -488,7 +488,7 @@ export declare class SelectQueryBuilder<DB, TB extends keyof DB, O> implements W
      * To select all columns of the query or specific tables see the
      * {@link selectAll} method.
      *
-     * See the {@link if} method if you are looking for a way to add selections
+     * See the {@link $if} method if you are looking for a way to add selections
      * based on a runtime condition.
      *
      * ### Examples
@@ -1292,6 +1292,26 @@ export declare class SelectQueryBuilder<DB, TB extends keyof DB, O> implements W
      * ```
      */
     exceptAll(expression: Expression<O>): SelectQueryBuilder<DB, TB, O>;
+    /**
+     * Gives an alias for the query. This method is only useful for sub queries.
+     *
+     * ### Examples
+     *
+     * ```ts
+     * const pets = await db.selectFrom('pet')
+     *   .selectAll('pet')
+     *   .select(
+     *     (qb) => qb.selectFrom('person')
+     *       .select('first_name')
+     *       .whereRef('pet.owner_id', '=', 'person.id')
+     *       .as('owner_first_name')
+     *   )
+     *   .execute()
+     *
+     * pets[0].owner_first_name
+     * ```
+     */
+    as<A extends string>(alias: A): AliasedSelectQueryBuilder<DB, TB, O, A>;
     /**
      * Clears all select clauses from the query.
      *
@@ -1392,7 +1412,7 @@ export declare class SelectQueryBuilder<DB, TB extends keyof DB, O> implements W
      * Simply calls the given function passing `this` as the only argument.
      *
      * If you want to conditionally call a method on `this`, see
-     * the {@link if} method.
+     * the {@link $if} method.
      *
      * ### Examples
      *
@@ -1406,10 +1426,14 @@ export declare class SelectQueryBuilder<DB, TB extends keyof DB, O> implements W
      *
      * db.selectFrom('person')
      *   .selectAll()
-     *   .call(log)
+     *   .$call(log)
      *   .execute()
      * ```
      */
+    $call<T>(func: (qb: this) => T): T;
+    /**
+     * @deprecated Use `$call` instead
+     */
     call<T>(func: (qb: this) => T): T;
     /**
      * Call `func(this)` if `condition` is true.
@@ -1428,7 +1452,7 @@ export declare class SelectQueryBuilder<DB, TB extends keyof DB, O> implements W
      *   return await db
      *     .selectFrom('person')
      *     .select(['id', 'first_name'])
-     *     .if(withLastName, (qb) => qb.select('last_name'))
+     *     .$if(withLastName, (qb) => qb.select('last_name'))
      *     .where('id', '=', id)
      *     .executeTakeFirstOrThrow()
      * }
@@ -1453,41 +1477,29 @@ export declare class SelectQueryBuilder<DB, TB extends keyof DB, O> implements W
      *
      * db.selectFrom('person')
      *   .select('person.id')
-     *   .if(filterByFirstName, (qb) => qb.where('first_name', '=', firstName))
-     *   .if(filterByPetCount, (qb) => qb
+     *   .$if(filterByFirstName, (qb) => qb.where('first_name', '=', firstName))
+     *   .$if(filterByPetCount, (qb) => qb
      *     .innerJoin('pet', 'pet.owner_id', 'person.id')
      *     .having(count('pet.id'), '>', petCountLimit)
      *     .groupBy('person.id')
      *   )
      * ```
      */
-    if<O2 extends O>(condition: boolean, func: (qb: this) => SelectQueryBuilder<DB, TB, O2>): SelectQueryBuilder<DB, TB, MergePartial<O, O2>>;
+    $if<O2 extends O>(condition: boolean, func: (qb: this) => SelectQueryBuilder<DB, TB, O2>): SelectQueryBuilder<DB, TB, MergePartial<O, O2>>;
     /**
-     * Gives an alias for the query. This method is only useful for sub queries.
-     *
-     * ### Examples
-     *
-     * ```ts
-     * const pets = await db.selectFrom('pet')
-     *   .selectAll('pet')
-     *   .select(
-     *     (qb) => qb.selectFrom('person')
-     *       .select('first_name')
-     *       .whereRef('pet.owner_id', '=', 'person.id')
-     *       .as('owner_first_name')
-     *   )
-     *   .execute()
-     *
-     * pets[0].owner_first_name
-     * ```
+     * @deprecated Use `$if` instead
      */
-    as<A extends string>(alias: A): AliasedSelectQueryBuilder<DB, TB, O, A>;
+    if<O2 extends O>(condition: boolean, func: (qb: this) => SelectQueryBuilder<DB, TB, O2>): SelectQueryBuilder<DB, TB, MergePartial<O, O2>>;
     /**
      * 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.
      */
+    $castTo<T>(): SelectQueryBuilder<DB, TB, T>;
+    /**
+     * @deprecated Use `$castTo` instead.
+     */
     castTo<T>(): SelectQueryBuilder<DB, TB, T>;
     /**
      * Asserts that query's output row type equals the given type `T`.
@@ -1516,18 +1528,22 @@ export declare class SelectQueryBuilder<DB, TB extends keyof DB, O> implements W
      *   .with('first_and_last', (qb) => qb
      *     .selectFrom('person')
      *     .select(['first_name', 'last_name'])
-     *     .assertType<{ first_name: string, last_name: string }>()
+     *     .$assertType<{ first_name: string, last_name: string }>()
      *   )
      *   .with('age', (qb) => qb
      *     .selectFrom('person')
      *     .select('age')
-     *     .assertType<{ age: number }>()
+     *     .$assertType<{ age: number }>()
      *   )
      *   .selectFrom(['first_and_last', 'age'])
      *   .selectAll()
      *   .executeTakeFirstOrThrow()
      * ```
      */
+    $assertType<T extends O>(): O extends T ? SelectQueryBuilder<DB, TB, T> : KyselyTypeError<`$assertType() call failed: The type passed in is not equal to the output type of the query.`>;
+    /**
+     * @deprecated Use `$assertType` instead.
+     */
     assertType<T extends O>(): O extends T ? SelectQueryBuilder<DB, TB, T> : KyselyTypeError<`assertType() call failed: The type passed in is not equal to the output type of the query.`>;
     /**
      * Returns a copy of this SelectQueryBuilder instance with the given plugin installed.