kysely 0.16.0 → 0.16.4

package/dist/esm/operation-node/group-by-item-node.js

@@ -1,3 +1,4 @@
+/// <reference types="./group-by-item-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

package/dist/esm/operation-node/group-by-node.js

@@ -1,3 +1,4 @@
+/// <reference types="./group-by-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

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

@@ -1,3 +1,4 @@
+/// <reference types="./having-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 import { AndNode } from './and-node.js';
 import { OrNode } from './or-node.js';

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

@@ -1,3 +1,4 @@
+/// <reference types="./identifier-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

package/dist/esm/operation-node/insert-query-node.js

@@ -1,3 +1,4 @@
+/// <reference types="./insert-query-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

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

@@ -1,3 +1,4 @@
+/// <reference types="./join-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 import { OnNode } from './on-node.js';
 /**

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

@@ -1,3 +1,4 @@
+/// <reference types="./limit-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 import { ValueNode } from './value-node.js';
 /**

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

@@ -1,3 +1,4 @@
+/// <reference types="./list-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

package/dist/esm/operation-node/modify-column-node.js

@@ -1,3 +1,4 @@
+/// <reference types="./modify-column-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

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

@@ -1,3 +1,4 @@
+/// <reference types="./offset-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 import { ValueNode } from './value-node.js';
 /**

package/dist/esm/operation-node/on-conflict-node.js

@@ -1,3 +1,4 @@
+/// <reference types="./on-conflict-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 import { WhereNode } from './where-node.js';
 /**

package/dist/esm/operation-node/on-duplicate-key-node.js

@@ -1,3 +1,4 @@
+/// <reference types="./on-duplicate-key-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

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

@@ -1,3 +1,4 @@
+/// <reference types="./on-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 import { AndNode } from './and-node.js';
 import { OrNode } from './or-node.js';

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

@@ -1,3 +1,4 @@
+/// <reference types="./operation-node-source.d.ts" />
 import { isFunction, isObject } from '../util/object-utils.js';
 export function isOperationNodeSource(obj) {
     return isObject(obj) && isFunction(obj.toOperationNode);

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

@@ -1,3 +1,4 @@
+/// <reference types="./operation-node-transformer.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * Transforms an operation node tree into another one.

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

@@ -1 +1,2 @@
+/// <reference types="./operation-node-utils.d.ts" />
 export {};

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

@@ -1,3 +1,4 @@
+/// <reference types="./operation-node-visitor.d.ts" />
 import { freeze } from '../util/object-utils.js';
 export class OperationNodeVisitor {
     nodeStack = [];

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

@@ -1 +1,2 @@
+/// <reference types="./operation-node.d.ts" />
 export {};

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

@@ -1,3 +1,4 @@
+/// <reference types="./operator-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 export const OPERATORS = [
     '=',

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

@@ -1,3 +1,4 @@
+/// <reference types="./or-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

package/dist/esm/operation-node/order-by-item-node.js

@@ -1,3 +1,4 @@
+/// <reference types="./order-by-item-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

package/dist/esm/operation-node/order-by-node.js

@@ -1,3 +1,4 @@
+/// <reference types="./order-by-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

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

@@ -1,3 +1,4 @@
+/// <reference types="./parens-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

package/dist/esm/operation-node/primary-constraint-node.js

@@ -1,3 +1,4 @@
+/// <reference types="./primary-constraint-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 import { ColumnNode } from './column-node.js';
 import { IdentifierNode } from './identifier-node.js';

package/dist/esm/operation-node/primitive-value-list-node.js

@@ -1,3 +1,4 @@
+/// <reference types="./primitive-value-list-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

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

@@ -1,3 +1,4 @@
+/// <reference types="./query-node.d.ts" />
 import { InsertQueryNode } from './insert-query-node.js';
 import { SelectQueryNode } from './select-query-node.js';
 import { UpdateQueryNode } from './update-query-node.js';

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

@@ -1,3 +1,4 @@
+/// <reference types="./raw-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

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

@@ -1,3 +1,4 @@
+/// <reference types="./reference-node.d.ts" />
 import { TableNode } from './table-node.js';
 import { SelectAllNode } from './select-all-node.js';
 import { freeze } from '../util/object-utils.js';

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

@@ -1,3 +1,4 @@
+/// <reference types="./references-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

package/dist/esm/operation-node/rename-column-node.js

@@ -1,3 +1,4 @@
+/// <reference types="./rename-column-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 import { ColumnNode } from './column-node.js';
 /**

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

@@ -1,3 +1,4 @@
+/// <reference types="./returning-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

package/dist/esm/operation-node/select-all-node.js

@@ -1,3 +1,4 @@
+/// <reference types="./select-all-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

package/dist/esm/operation-node/select-query-node.js

@@ -1,3 +1,4 @@
+/// <reference types="./select-query-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 import { FromNode } from './from-node.js';
 import { GroupByNode } from './group-by-node.js';

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

@@ -1,3 +1,4 @@
+/// <reference types="./selection-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 import { ReferenceNode } from './reference-node.js';
 import { SelectAllNode } from './select-all-node.js';

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

@@ -1,3 +1,4 @@
+/// <reference types="./table-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 import { IdentifierNode } from './identifier-node.js';
 /**

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

@@ -1,3 +1,4 @@
+/// <reference types="./union-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

package/dist/esm/operation-node/unique-constraint-node.js

@@ -1,3 +1,4 @@
+/// <reference types="./unique-constraint-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 import { ColumnNode } from './column-node.js';
 import { IdentifierNode } from './identifier-node.js';

package/dist/esm/operation-node/update-query-node.js

@@ -1,3 +1,4 @@
+/// <reference types="./update-query-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

package/dist/esm/operation-node/value-list-node.js

@@ -1,3 +1,4 @@
+/// <reference types="./value-list-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

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

@@ -1,3 +1,4 @@
+/// <reference types="./value-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

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

@@ -1,3 +1,4 @@
+/// <reference types="./values-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

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

@@ -1,3 +1,4 @@
+/// <reference types="./where-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 import { AndNode } from './and-node.js';
 import { OrNode } from './or-node.js';

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

@@ -1,3 +1,4 @@
+/// <reference types="./with-node.d.ts" />
 import { freeze } from '../util/object-utils.js';
 /**
  * @internal

package/dist/esm/parser/complex-expression-parser.js

@@ -1,3 +1,4 @@
+/// <reference types="./complex-expression-parser.d.ts" />
 import { isOperationNodeSource } from '../operation-node/operation-node-source.js';
 import { isFunction } from '../util/object-utils.js';
 export function parseComplexExpression(ctx, exp) {

package/dist/esm/parser/data-type-parser.js

@@ -1,3 +1,4 @@
+/// <reference types="./data-type-parser.d.ts" />
 import { DataTypeNode, } from '../operation-node/data-type-node.js';
 import { isOperationNodeSource } from '../operation-node/operation-node-source.js';
 export function parseDataTypeExpression(dataType) {

package/dist/esm/parser/default-value-parser.js

@@ -1,3 +1,4 @@
+/// <reference types="./default-value-parser.d.ts" />
 import { isOperationNodeSource } from '../operation-node/operation-node-source.js';
 import { ValueNode } from '../operation-node/value-node.js';
 export function parseDefaultValueExpression(value) {

package/dist/esm/parser/filter-parser.js

@@ -1,3 +1,4 @@
+/// <reference types="./filter-parser.d.ts" />
 import { FilterNode } from '../operation-node/filter-node.js';
 import { freeze, isBoolean, isFunction, isNull, isString, } from '../util/object-utils.js';
 import { isOperationNodeSource } from '../operation-node/operation-node-source.js';

package/dist/esm/parser/group-by-parser.js

@@ -1,3 +1,4 @@
+/// <reference types="./group-by-parser.d.ts" />
 import { GroupByItemNode } from '../operation-node/group-by-item-node.js';
 import { parseReferenceExpressionOrList, } from './reference-parser.js';
 export function parseGroupBy(ctx, orderBy) {

package/dist/esm/parser/insert-values-parser.js

@@ -1,3 +1,4 @@
+/// <reference types="./insert-values-parser.d.ts" />
 import { ColumnNode } from '../operation-node/column-node.js';
 import { PrimitiveValueListNode } from '../operation-node/primitive-value-list-node.js';
 import { ValueListNode } from '../operation-node/value-list-node.js';

package/dist/esm/parser/join-parser.js

@@ -1,3 +1,4 @@
+/// <reference types="./join-parser.d.ts" />
 import { JoinNode } from '../operation-node/join-node.js';
 import { parseTableExpression, } from './table-parser.js';
 import { parseReferenceFilter } from './filter-parser.js';

package/dist/esm/parser/order-by-parser.js

@@ -1,3 +1,4 @@
+/// <reference types="./order-by-parser.d.ts" />
 import { OrderByItemNode } from '../operation-node/order-by-item-node.js';
 import { RawNode } from '../operation-node/raw-node.js';
 import { parseReferenceExpression, } from './reference-parser.js';

package/dist/esm/parser/parse-context.js

@@ -1,3 +1,4 @@
+/// <reference types="./parse-context.d.ts" />
 import { JoinNode } from '../operation-node/join-node.js';
 import { SelectQueryNode } from '../operation-node/select-query-node.js';
 import { JoinBuilder } from '../query-builder/join-builder.js';

package/dist/esm/parser/reference-parser.js

@@ -1,3 +1,4 @@
+/// <reference types="./reference-parser.d.ts" />
 import { AliasNode } from '../operation-node/alias-node.js';
 import { ColumnNode } from '../operation-node/column-node.js';
 import { ReferenceNode } from '../operation-node/reference-node.js';

package/dist/esm/parser/returning-parser.js

@@ -1 +1,2 @@
+/// <reference types="./returning-parser.d.ts" />
 export {};

package/dist/esm/parser/select-parser.js

@@ -1,3 +1,4 @@
+/// <reference types="./select-parser.d.ts" />
 import { isReadonlyArray, isString } from '../util/object-utils.js';
 import { SelectionNode } from '../operation-node/selection-node.js';
 import { parseAliasedStringReference } from './reference-parser.js';

package/dist/esm/parser/table-parser.js

@@ -1,3 +1,4 @@
+/// <reference types="./table-parser.d.ts" />
 import { isReadonlyArray, isString } from '../util/object-utils.js';
 import { AliasNode } from '../operation-node/alias-node.js';
 import { TableNode } from '../operation-node/table-node.js';

package/dist/esm/parser/union-parser.js

@@ -1,3 +1,4 @@
+/// <reference types="./union-parser.d.ts" />
 import { UnionNode } from '../operation-node/union-node.js';
 export function parseUnion(union, all) {
     return UnionNode.create(union.toOperationNode(), all);

package/dist/esm/parser/update-set-parser.js

@@ -1,3 +1,4 @@
+/// <reference types="./update-set-parser.d.ts" />
 import { ColumnNode } from '../operation-node/column-node.js';
 import { ColumnUpdateNode } from '../operation-node/column-update-node.js';
 import { parseValueExpression } from './value-parser.js';

package/dist/esm/parser/value-parser.js

@@ -1,3 +1,4 @@
+/// <reference types="./value-parser.d.ts" />
 import { PrimitiveValueListNode } from '../operation-node/primitive-value-list-node.js';
 import { ValueListNode } from '../operation-node/value-list-node.js';
 import { ValueNode } from '../operation-node/value-node.js';

package/dist/esm/parser/with-parser.js

@@ -1,3 +1,4 @@
+/// <reference types="./with-parser.d.ts" />
 import { CommonTableExpressionNode } from '../operation-node/common-table-expression-node.js';
 import { CommonTableExpressionNameNode } from '../operation-node/common-table-expression-name-node.js';
 export function parseCommonTableExpression(ctx, name, expression) {

package/dist/esm/plugin/camel-case/camel-case-plugin.js

@@ -1,4 +1,5 @@
-import { isObject } from '../../util/object-utils.js';
+/// <reference types="./camel-case-plugin.d.ts" />
+import { isBuffer, isDate, isObject } from '../../util/object-utils.js';
 import { SnakeCaseTransformer } from './camel-case-transformer.js';
 import { createCamelCaseMapper, createSnakeCaseMapper, } from './camel-case.js';
 /**
@@ -107,5 +108,5 @@ export class CamelCasePlugin {
     }
 }
 function canMap(obj) {
-    return isObject(obj) && !(obj instanceof Date) && !Buffer.isBuffer(obj);
+    return isObject(obj) && !isDate(obj) && !isBuffer(obj);
 }

package/dist/esm/plugin/camel-case/camel-case-transformer.js

@@ -1,3 +1,4 @@
+/// <reference types="./camel-case-transformer.d.ts" />
 import { OperationNodeTransformer } from '../../operation-node/operation-node-transformer.js';
 export class SnakeCaseTransformer extends OperationNodeTransformer {
     #snakeCase;

package/dist/esm/plugin/camel-case/camel-case.js

@@ -1,3 +1,4 @@
+/// <reference types="./camel-case.d.ts" />
 /**
  * Creates a function that transforms camel case strings to snake case.
  */

package/dist/esm/plugin/immediate-value.ts/immediate-value-plugin.js

@@ -1,3 +1,4 @@
+/// <reference types="./immediate-value-plugin.d.ts" />
 import { ImmediateValueTransformer } from './immediate-value-transformer.js';
 /**
  * Transforms all ValueNodes to immediate.

package/dist/esm/plugin/immediate-value.ts/immediate-value-transformer.js

@@ -1,3 +1,4 @@
+/// <reference types="./immediate-value-transformer.d.ts" />
 import { OperationNodeTransformer } from '../../operation-node/operation-node-transformer.js';
 /**
  * Transforms all ValueNodes to immediate.

package/dist/esm/plugin/kysely-plugin.js

@@ -1 +1,2 @@
+/// <reference types="./kysely-plugin.d.ts" />
 export {};

package/dist/esm/plugin/with-schema/with-schema-plugin.js

@@ -1,3 +1,4 @@
+/// <reference types="./with-schema-plugin.d.ts" />
 import { WithSchemaTransformer } from './with-schema-transformer.js';
 export class WithSchemaPlugin {
     #transformer;

package/dist/esm/plugin/with-schema/with-schema-transformer.js

@@ -1,3 +1,4 @@
+/// <reference types="./with-schema-transformer.d.ts" />
 import { AliasNode } from '../../operation-node/alias-node.js';
 import { OperationNodeTransformer } from '../../operation-node/operation-node-transformer.js';
 import { TableNode } from '../../operation-node/table-node.js';

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

@@ -1,3 +1,4 @@
+/// <reference types="./delete-query-builder.d.ts" />
 import { parseJoin, } from '../parser/join-parser.js';
 import { parseSelectExpressionOrList, parseSelectAll, } from '../parser/select-parser.js';
 import { parseExistFilter, parseReferenceFilter, parseWhereFilter, parseNotExistFilter, } from '../parser/filter-parser.js';

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

@@ -1,3 +1,4 @@
+/// <reference types="./delete-result.d.ts" />
 export class DeleteResult {
     #numDeletedRows;
     constructor(numDeletedRows) {

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

@@ -3,6 +3,8 @@ import { TableExpression, TableExpressionDatabase, TableExpressionTables } from
 import { NoopQueryExecutor } from '../query-executor/noop-query-executor.js';
 import { ParseContext } from '../parser/parse-context.js';
 import { FunctionBuilder } from './function-builder.js';
+import { RawBuilder } from '../index-nodeless.js';
+import { ExtractTypeFromReferenceExpression, StringReference } from '../parser/reference-parser.js';
 export declare class ExpressionBuilder<DB, TB extends keyof DB> {
     #private;
     constructor(props: ExpressionBuilderProps);
@@ -44,6 +46,8 @@ export declare class ExpressionBuilder<DB, TB extends keyof DB> {
      * The query builder returned by this method is typed in a way that you can refer to
      * all tables of the parent query in addition to the subquery's tables.
      *
+     * This method accepts all the same inputs as {@link QueryCreator.selectFrom}.
+     *
      * ### Examples
      *
      * This example shows that you can refer to both `pet.owner_id` and `person.id`
@@ -86,6 +90,44 @@ export declare class ExpressionBuilder<DB, TB extends keyof DB> {
      * See {@link QueryCreator.withSchema}
      */
     withSchema(schema: string): ExpressionBuilder<DB, TB>;
+    /**
+     * See {@link QueryCreator.raw}.
+     */
+    raw<T = unknown>(sql: string, parameters?: unknown[]): RawBuilder<T>;
+    /**
+     * This can be used to reference columns.
+     *
+     * ### Examples
+     *
+     * In the next example we use the `ref` method to reference
+     * columns of the virtual table `excluded` in a type-safe way
+     * to create an upsert operation:
+     *
+     * ```ts
+     * db.insertInto('person')
+     *   .values(person)
+     *   .onConflict(oc => oc
+     *     .column('id')
+     *     .doUpdateSet({
+     *       first_name: (eb) => eb.ref('excluded.first_name'),
+     *       last_name: (eb) => eb.ref('excluded.last_name')
+     *     })
+     *   )
+     * ```
+     *
+     * In the next example we use `ref` in a raw expression. Unless you
+     * want to be as type-safe as possible, this is probably overkill:
+     *
+     * ```ts
+     * db.update('pet').set({
+     *   name: (eb) => eb.raw('concat(?, ?)', [
+     *     eb.ref('pet.name'),
+     *     suffix,
+     *   ])
+     * })
+     * ```
+     */
+    ref<RE extends StringReference<DB, TB>>(reference: RE): RawBuilder<ExtractTypeFromReferenceExpression<DB, TB, RE>>;
 }
 export interface ExpressionBuilderProps {
     readonly executor: NoopQueryExecutor;

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

@@ -1,3 +1,4 @@
+/// <reference types="./expression-builder.d.ts" />
 import { SelectQueryBuilder } from './select-query-builder.js';
 import { SelectQueryNode } from '../operation-node/select-query-node.js';
 import { parseTableExpressionOrList, } from '../parser/table-parser.js';
@@ -5,6 +6,7 @@ import { WithSchemaPlugin } from '../plugin/with-schema/with-schema-plugin.js';
 import { createQueryId } from '../util/query-id.js';
 import { freeze } from '../util/object-utils.js';
 import { FunctionBuilder } from './function-builder.js';
+import { RawBuilder } from '../index-nodeless.js';
 export class ExpressionBuilder {
     #props;
     constructor(props) {
@@ -61,4 +63,51 @@ export class ExpressionBuilder {
             executor: this.#props.executor.withPluginAtFront(new WithSchemaPlugin(schema)),
         });
     }
+    /**
+     * See {@link QueryCreator.raw}.
+     */
+    raw(sql, parameters) {
+        return new RawBuilder({
+            queryId: createQueryId(),
+            executor: this.#props.executor,
+            sql,
+            parameters,
+        });
+    }
+    /**
+     * This can be used to reference columns.
+     *
+     * ### Examples
+     *
+     * In the next example we use the `ref` method to reference
+     * columns of the virtual table `excluded` in a type-safe way
+     * to create an upsert operation:
+     *
+     * ```ts
+     * db.insertInto('person')
+     *   .values(person)
+     *   .onConflict(oc => oc
+     *     .column('id')
+     *     .doUpdateSet({
+     *       first_name: (eb) => eb.ref('excluded.first_name'),
+     *       last_name: (eb) => eb.ref('excluded.last_name')
+     *     })
+     *   )
+     * ```
+     *
+     * In the next example we use `ref` in a raw expression. Unless you
+     * want to be as type-safe as possible, this is probably overkill:
+     *
+     * ```ts
+     * db.update('pet').set({
+     *   name: (eb) => eb.raw('concat(?, ?)', [
+     *     eb.ref('pet.name'),
+     *     suffix,
+     *   ])
+     * })
+     * ```
+     */
+    ref(reference) {
+        return this.raw('??', [reference]);
+    }
 }

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

@@ -1,3 +1,4 @@
+/// <reference types="./function-builder.d.ts" />
 import { RawBuilder } from '../raw-builder/raw-builder.js';
 import { freeze } from '../util/object-utils.js';
 import { createQueryId } from '../util/query-id.js';

package/dist/esm/query-builder/having-interface.js

@@ -1 +1,2 @@
+/// <reference types="./having-interface.d.ts" />
 export {};

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

@@ -342,6 +342,22 @@ export declare class InsertQueryBuilder<DB, TB extends keyof DB, O> implements R
      * values ($1, $2)
      * on conflict ("name") do nothing
      * ```
+     *
+     * You can refer to the columns of the virtual `excluded` table
+     * in a type-safe way using a callback and the `ref` method of
+     * `ExpressionBuilder`:
+     *
+     * ```ts
+     * db.insertInto('person')
+     *   .values(person)
+     *   .onConflict(oc => oc
+     *     .column('id')
+     *     .doUpdateSet({
+     *       first_name: (eb) => eb.ref('excluded.first_name'),
+     *       last_name: (eb) => eb.ref('excluded.last_name')
+     *     })
+     *   )
+     * ```
      */
     onConflict(callback: (builder: OnConflictBuilder<DB, TB>) => OnConflictDoNothingBuilder<DB, TB> | OnConflictUpdateBuilder<DB, TB>): InsertQueryBuilder<DB, TB, O>;
     /**