kysely 0.27.0 → 0.27.1

package/dist/cjs/raw-builder/raw-builder.d.ts

@@ -130,7 +130,17 @@ export interface RawBuilder<O> extends AliasableExpression<O> {
      * This method call doesn't change the SQL in any way. This methods simply
      * returns a copy of this `RawBuilder` with a new output type.
      */
-    $castTo<T>(): RawBuilder<T>;
+    $castTo<C>(): RawBuilder<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(): RawBuilder<Exclude<O, null>>;
     /**
      * Adds a plugin for this SQL snippet.
      */

package/dist/cjs/raw-builder/raw-builder.js

@@ -24,6 +24,9 @@ class RawBuilderImpl {
     $castTo() {
         return new RawBuilderImpl({ ...this.#props });
     }
+    $notNull() {
+        return new RawBuilderImpl(this.#props);
+    }
     withPlugin(plugin) {
         return new RawBuilderImpl({
             ...this.#props,

package/dist/cjs/raw-builder/sql.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.sql = void 0;
 const identifier_node_js_1 = require("../operation-node/identifier-node.js");
+const operation_node_source_js_1 = require("../operation-node/operation-node-source.js");
 const raw_node_js_1 = require("../operation-node/raw-node.js");
 const value_node_js_1 = require("../operation-node/value-node.js");
 const reference_parser_js_1 = require("../parser/reference-parser.js");
@@ -12,7 +13,7 @@ const raw_builder_js_1 = require("./raw-builder.js");
 exports.sql = Object.assign((sqlFragments, ...parameters) => {
     return (0, raw_builder_js_1.createRawBuilder)({
         queryId: (0, query_id_js_1.createQueryId)(),
-        rawNode: raw_node_js_1.RawNode.create(sqlFragments, parameters?.map(value_parser_js_1.parseValueExpression) ?? []),
+        rawNode: raw_node_js_1.RawNode.create(sqlFragments, parameters?.map(parseParameter) ?? []),
     });
 }, {
     ref(columnReference) {
@@ -64,7 +65,7 @@ exports.sql = Object.assign((sqlFragments, ...parameters) => {
         const nodes = new Array(2 * array.length - 1);
         const sep = separator.toOperationNode();
         for (let i = 0; i < array.length; ++i) {
-            nodes[2 * i] = (0, value_parser_js_1.parseValueExpression)(array[i]);
+            nodes[2 * i] = parseParameter(array[i]);
             if (i !== array.length - 1) {
                 nodes[2 * i + 1] = sep;
             }
@@ -75,3 +76,9 @@ exports.sql = Object.assign((sqlFragments, ...parameters) => {
         });
     },
 });
+function parseParameter(param) {
+    if ((0, operation_node_source_js_1.isOperationNodeSource)(param)) {
+        return param.toOperationNode();
+    }
+    return (0, value_parser_js_1.parseValueExpression)(param);
+}

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

@@ -16,7 +16,7 @@ export declare function isArrayBufferOrView(obj: unknown): obj is ArrayBuffer |
 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 | T[]): T[];
+export declare function asArray<T>(arg: T | ReadonlyArray<T>): ReadonlyArray<T>;
 export declare function asReadonlyArray<T>(arg: T | ReadonlyArray<T>): ReadonlyArray<T>;
 export declare function isReadonlyArray(arg: unknown): arg is ReadonlyArray<unknown>;
 export declare function noop<T>(obj: T): T;

package/dist/cjs/util/object-utils.js

@@ -74,7 +74,7 @@ function freeze(obj) {
 }
 exports.freeze = freeze;
 function asArray(arg) {
-    if (Array.isArray(arg)) {
+    if (isReadonlyArray(arg)) {
         return arg;
     }
     else {

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

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

package/dist/esm/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/esm/expression/expression-wrapper.js

@@ -33,6 +33,18 @@ export 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/esm/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/esm/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/esm/operation-node/limit-node.js

@@ -1,6 +1,5 @@
 /// <reference types="./limit-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
-import { ValueNode } from './value-node.js';
 /**
  * @internal
  */
@@ -11,7 +10,7 @@ export const LimitNode = freeze({
     create(limit) {
         return freeze({
             kind: 'LimitNode',
-            limit: ValueNode.create(limit),
+            limit,
         });
     },
 });

package/dist/esm/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/esm/operation-node/offset-node.js

@@ -1,6 +1,5 @@
 /// <reference types="./offset-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
-import { ValueNode } from './value-node.js';
 /**
  * @internal
  */
@@ -11,7 +10,7 @@ export const OffsetNode = freeze({
     create(offset) {
         return freeze({
             kind: 'OffsetNode',
-            offset: ValueNode.create(offset),
+            offset,
         });
     },
 });

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

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

package/dist/esm/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/esm/operation-node/select-modifier-node.js

@@ -7,10 +7,11 @@ export const SelectModifierNode = freeze({
     is(node) {
         return node.kind === 'SelectModifierNode';
     },
-    create(modifier) {
+    create(modifier, of) {
         return freeze({
             kind: 'SelectModifierNode',
             modifier,
+            of,
         });
     },
     createWithExpression(modifier) {

package/dist/esm/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/esm/query-builder/aggregate-function-builder.js

@@ -170,6 +170,27 @@ export 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/esm/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/esm/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/esm/query-builder/delete-query-builder.js

@@ -11,6 +11,7 @@ import { DeleteQueryNode } from '../operation-node/delete-query-node.js';
 import { LimitNode } from '../operation-node/limit-node.js';
 import { parseOrderBy, } from '../parser/order-by-parser.js';
 import { parseValueBinaryOperationOrExpression, parseReferentialBinaryOperation, } from '../parser/binary-operation-parser.js';
+import { parseValueExpression, } from '../parser/value-parser.js';
 export class DeleteQueryBuilder {
     #props;
     constructor(props) {
@@ -137,7 +138,7 @@ export class DeleteQueryBuilder {
     limit(limit) {
         return new DeleteQueryBuilder({
             ...this.#props,
-            queryNode: DeleteQueryNode.cloneWithLimit(this.#props.queryNode, LimitNode.create(limit)),
+            queryNode: DeleteQueryNode.cloneWithLimit(this.#props.queryNode, LimitNode.create(parseValueExpression(limit))),
         });
     }
     /**
@@ -211,8 +212,8 @@ export 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);

package/dist/esm/query-builder/function-module.d.ts

@@ -138,7 +138,7 @@ export interface FunctionModule<DB, TB extends keyof DB> {
      * from "person"
      * ```
      */
-    agg<O, RE extends ReferenceExpression<DB, TB>>(name: string, args?: ReadonlyArray<RE>): AggregateFunctionBuilder<DB, TB, O>;
+    agg<O, RE extends ReferenceExpression<DB, TB> = ReferenceExpression<DB, TB>>(name: string, args?: ReadonlyArray<RE>): AggregateFunctionBuilder<DB, TB, O>;
     /**
      * Calls the `avg` function for the column or expression given as the argument.
      *

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

@@ -240,6 +240,10 @@ export declare class InsertQueryBuilder<DB, TB extends keyof DB, O> implements R
      * ```
      */
     expression(expression: ExpressionOrFactory<DB, TB, any>): InsertQueryBuilder<DB, TB, O>;
+    /**
+     * Creates an `insert into "person" default values` query.
+     */
+    defaultValues(): InsertQueryBuilder<DB, TB, O>;
     /**
      * Changes an `insert into` query to an `insert ignore into` query.
      *
@@ -563,10 +567,10 @@ export declare class InsertQueryBuilder<DB, TB extends keyof DB, O> implements R
     /**
      * 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 `InsertQueryBuilder` with a new output type.
      */
-    $castTo<T>(): InsertQueryBuilder<DB, TB, T>;
+    $castTo<C>(): InsertQueryBuilder<DB, TB, C>;
     /**
      * Narrows (parts of) the output type of the query.
      *

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

@@ -96,6 +96,17 @@ export class InsertQueryBuilder {
             }),
         });
     }
+    /**
+     * Creates an `insert into "person" default values` query.
+     */
+    defaultValues() {
+        return new InsertQueryBuilder({
+            ...this.#props,
+            queryNode: InsertQueryNode.cloneWith(this.#props.queryNode, {
+                defaultValues: true,
+            }),
+        });
+    }
     /**
      * Changes an `insert into` query to an `insert ignore into` query.
      *
@@ -396,8 +407,8 @@ export class InsertQueryBuilder {
     /**
      * 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 `InsertQueryBuilder` with a new output type.
      */
     $castTo() {
         return new InsertQueryBuilder(this.#props);

package/dist/esm/query-builder/json-path-builder.d.ts

@@ -232,7 +232,8 @@ export declare class TraversedJSONPathBuilder<S, O> extends JSONPathBuilder<S, O
      * This method call doesn't change the SQL in any way. This methods simply
      * returns a copy of this `JSONPathBuilder` with a new output type.
      */
-    $castTo<T>(): JSONPathBuilder<T>;
+    $castTo<C>(): JSONPathBuilder<C>;
+    $notNull(): JSONPathBuilder<Exclude<O, null>>;
     /**
      * Creates the OperationNode that describes how to compile this expression into SQL.
      *

package/dist/esm/query-builder/json-path-builder.js

@@ -162,6 +162,9 @@ export class TraversedJSONPathBuilder extends JSONPathBuilder {
     $castTo() {
         return new JSONPathBuilder(this.#node);
     }
+    $notNull() {
+        return new JSONPathBuilder(this.#node);
+    }
     toOperationNode() {
         return this.#node;
     }

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

@@ -25,6 +25,7 @@ import { Streamable } from '../util/streamable.js';
 import { ExpressionOrFactory } from '../parser/expression-parser.js';
 import { ExpressionWrapper } from '../expression/expression-wrapper.js';
 import { SelectQueryBuilderExpression } from './select-query-builder-expression.js';
+import { ValueExpression } from '../parser/value-parser.js';
 export interface SelectQueryBuilder<DB, TB extends keyof DB, O> extends WhereInterface<DB, TB>, HavingInterface<DB, TB>, SelectQueryBuilderExpression<O>, Compilable<O>, Explainable, Streamable<O> {
     /**
      * Adds a `where` expression to the query.
@@ -674,19 +675,19 @@ export interface SelectQueryBuilder<DB, TB extends keyof DB, O> extends WhereInt
     /**
      * Adds the `for update` modifier to a select query on supported databases.
      */
-    forUpdate(): SelectQueryBuilder<DB, TB, O>;
+    forUpdate(of?: TableOrList<TB>): SelectQueryBuilder<DB, TB, O>;
     /**
      * Adds the `for share` modifier to a select query on supported databases.
      */
-    forShare(): SelectQueryBuilder<DB, TB, O>;
+    forShare(of?: TableOrList<TB>): SelectQueryBuilder<DB, TB, O>;
     /**
      * Adds the `for key share` modifier to a select query on supported databases.
      */
-    forKeyShare(): SelectQueryBuilder<DB, TB, O>;
+    forKeyShare(of?: TableOrList<TB>): SelectQueryBuilder<DB, TB, O>;
     /**
      * Adds the `for no key update` modifier to a select query on supported databases.
      */
-    forNoKeyUpdate(): SelectQueryBuilder<DB, TB, O>;
+    forNoKeyUpdate(of?: TableOrList<TB>): SelectQueryBuilder<DB, TB, O>;
     /**
      * Adds the `skip locked` modifier to a select query on supported databases.
      */
@@ -1161,7 +1162,7 @@ export interface SelectQueryBuilder<DB, TB extends keyof DB, O> extends WhereInt
      *   .limit(10)
      * ```
      */
-    limit(limit: number): SelectQueryBuilder<DB, TB, O>;
+    limit(limit: ValueExpression<DB, TB, number>): SelectQueryBuilder<DB, TB, O>;
     /**
      * Adds an offset clause to the query.
      *
@@ -1177,7 +1178,7 @@ export interface SelectQueryBuilder<DB, TB extends keyof DB, O> extends WhereInt
      *   .limit(10)
      * ```
      */
-    offset(offset: number): SelectQueryBuilder<DB, TB, O>;
+    offset(offset: ValueExpression<DB, TB, number>): SelectQueryBuilder<DB, TB, O>;
     /**
      * Combines another select query or raw expression to this query using `union`.
      *
@@ -1549,10 +1550,10 @@ export interface SelectQueryBuilder<DB, TB extends keyof DB, O> extends WhereInt
     /**
      * 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 `SelectQueryBuilder` with a new output type.
      */
-    $castTo<T>(): SelectQueryBuilder<DB, TB, T>;
+    $castTo<C>(): SelectQueryBuilder<DB, TB, C>;
     /**
      * Changes the output type from an object to a tuple.
      *
@@ -1831,4 +1832,5 @@ type OuterJoinedBuilder<DB, TB extends keyof DB, O, A extends keyof any, R> = Se
 type OuterJoinedBuilderDB<DB, TB extends keyof DB, A extends keyof any, R> = DrainOuterGeneric<{
     [C in keyof DB | A]: C extends A ? Nullable<R> : C extends TB ? Nullable<DB[C]> : C extends keyof DB ? DB[C] : never;
 }>;
+type TableOrList<TB extends keyof any> = (TB & string) | ReadonlyArray<TB & string>;
 export {};