kysely 0.11.1 → 0.12.0

package/dist/esm/dialect/mysql/mysql-query-compiler.js

@@ -1,11 +1,5 @@
 import { DefaultQueryCompiler } from '../../query-compiler/default-query-compiler.js';
 export class MysqlQueryCompiler extends DefaultQueryCompiler {
-    visitReturning() {
-        // Do nothing.
-    }
-    getSql() {
-        return super.getSql().trimEnd();
-    }
     getCurrentParameterPlaceholder() {
         return '?';
     }

package/dist/esm/dialect/postgres/postgres-query-compiler.d.ts

@@ -1,3 +1,6 @@
 import { DefaultQueryCompiler } from '../../query-compiler/default-query-compiler.js';
 export declare class PostgresQueryCompiler extends DefaultQueryCompiler {
+    protected getCurrentParameterPlaceholder(): string;
+    protected getLeftIdentifierWrapper(): string;
+    protected getRightIdentifierWrapper(): string;
 }

package/dist/esm/dialect/postgres/postgres-query-compiler.js

@@ -1,4 +1,12 @@
 import { DefaultQueryCompiler } from '../../query-compiler/default-query-compiler.js';
-// The default query compiler is for PostgreSQL.
 export class PostgresQueryCompiler extends DefaultQueryCompiler {
+    getCurrentParameterPlaceholder() {
+        return '$' + this.numParameters;
+    }
+    getLeftIdentifierWrapper() {
+        return '"';
+    }
+    getRightIdentifierWrapper() {
+        return '"';
+    }
 }

package/dist/esm/dialect/sqlite/sqlite-adapter.js

@@ -6,9 +6,13 @@ export class SqliteAdapter {
         return false;
     }
     async acquireMigrationLock() {
-        // Nothing to do here.
+        // SQLite only has one connection that's reserved by the migration system
+        // for the whole time between acquireMigrationLock and releaseMigrationLock.
+        // We don't need to do anything here.
     }
     async releaseMigrationLock() {
-        // Nothing to do here.
+        // SQLite only has one connection that's reserved by the migration system
+        // for the whole time between acquireMigrationLock and releaseMigrationLock.
+        // We don't need to do anything here.
     }
 }

package/dist/esm/dialect/sqlite/sqlite-driver.js

@@ -1,5 +1,6 @@
 import { CompiledQuery } from '../../query-compiler/compiled-query.js';
 import { importFunction } from '../../util/dynamic-import.js';
+import { isBoolean, isFunction, isNumber } from '../../util/object-utils.js';
 export class SqliteDriver {
     #config;
     #connectionMutex = new ConnectionMutex();
@@ -16,16 +17,16 @@ export class SqliteDriver {
         // into javascript. You can check the built javascript code.
         const DatabaseConstructor = await importBetterSqlite3Database();
         const options = {};
-        if (typeof this.#config.readonly === 'boolean') {
+        if (isBoolean(this.#config.readonly)) {
             options.readonly = this.#config.readonly;
         }
-        if (typeof this.#config.fileMustExist === 'boolean') {
+        if (isBoolean(this.#config.fileMustExist)) {
             options.fileMustExist = this.#config.fileMustExist;
         }
-        if (typeof this.#config.timeout === 'number') {
+        if (isNumber(this.#config.timeout)) {
             options.timeout = this.#config.timeout;
         }
-        if (typeof this.#config.verbose === 'function') {
+        if (isFunction(this.#config.verbose)) {
             options.verbose = this.#config.verbose;
         }
         this.#db = new DatabaseConstructor(this.#config.databasePath, options);
@@ -35,8 +36,8 @@ export class SqliteDriver {
         }
     }
     async acquireConnection() {
-        // sqlite effectively only has one single connection. We use a mutex
-        // here to wait until the single connection has been released.
+        // SQLite only has one single connection. We use a mutex here to wait
+        // until the single connection has been released.
         await this.#connectionMutex.lock();
         return this.#connection;
     }
@@ -61,7 +62,6 @@ async function importBetterSqlite3Database() {
         return await importFunction('better-sqlite3');
     }
     catch (error) {
-        console.error(error);
         throw new Error('SQLite client not installed. Please run `npm install better-sqlite3`');
     }
 }

package/dist/esm/dialect/sqlite/sqlite-query-compiler.d.ts

@@ -1,7 +1,7 @@
 import { DefaultQueryCompiler } from '../../query-compiler/default-query-compiler.js';
 export declare class SqliteQueryCompiler extends DefaultQueryCompiler {
-    protected visitReturning(): void;
-    protected getSql(): string;
     protected getCurrentParameterPlaceholder(): string;
+    protected getLeftIdentifierWrapper(): string;
+    protected getRightIdentifierWrapper(): string;
     protected getAutoIncrement(): string;
 }

package/dist/esm/dialect/sqlite/sqlite-query-compiler.js

@@ -1,14 +1,14 @@
 import { DefaultQueryCompiler } from '../../query-compiler/default-query-compiler.js';
 export class SqliteQueryCompiler extends DefaultQueryCompiler {
-    visitReturning() {
-        // Do nothing.
-    }
-    getSql() {
-        return super.getSql().trimEnd();
-    }
     getCurrentParameterPlaceholder() {
         return '?';
     }
+    getLeftIdentifierWrapper() {
+        return '"';
+    }
+    getRightIdentifierWrapper() {
+        return '"';
+    }
     getAutoIncrement() {
         return 'autoincrement';
     }

package/dist/esm/driver/runtime-driver.js

@@ -93,7 +93,7 @@ class RuntimeConnection {
     #logQuery(compiledQuery, startTime) {
         this.#log.query(() => ({
             level: 'query',
-            sql: compiledQuery.sql,
+            query: compiledQuery,
             queryDurationMillis: this.#calculateDurationMillis(startTime),
         }));
     }

package/dist/esm/dynamic/dynamic-reference-builder.d.ts

@@ -16,3 +16,4 @@ export declare class DynamicReferenceBuilder<R extends string = never> implement
     constructor(reference: string);
     toOperationNode(): ReferenceNode | ColumnNode;
 }
+export declare function isDynamicReferenceBuilder(obj: unknown): obj is DynamicReferenceBuilder<any>;

package/dist/esm/dynamic/dynamic-reference-builder.js

@@ -1,4 +1,6 @@
+import { isOperationNodeSource, } from '../operation-node/operation-node-source.js';
 import { parseStringReference } from '../parser/reference-parser.js';
+import { isObject, isString } from '../util/object-utils.js';
 export class DynamicReferenceBuilder {
     #dynamicReference;
     get dynamicReference() {
@@ -22,3 +24,8 @@ export class DynamicReferenceBuilder {
         return parseStringReference(this.#dynamicReference);
     }
 }
+export function isDynamicReferenceBuilder(obj) {
+    return (isObject(obj) &&
+        isOperationNodeSource(obj) &&
+        isString(obj.dynamicReference));
+}

package/dist/esm/dynamic/dynamic.d.ts

@@ -20,7 +20,8 @@ export declare class DynamicModule {
      * `ref` to other methods as well. If the types allow you to pass a `ref`
      * value to some place, it should work.
      *
-     * @example
+     * ### Examples
+     *
      * Filter by a column not know at compile time:
      *
      * ```ts
@@ -38,7 +39,6 @@ export declare class DynamicModule {
      * someQuery('person.last_name', 'Aniston')
      * ```
      *
-     * @example
      * Order by a column not know at compile time:
      *
      * ```ts
@@ -55,7 +55,6 @@ export declare class DynamicModule {
      * someQuery('fn')
      * ```
      *
-     * @example
      * In this example we add selections dynamically:
      *
      * ```ts
@@ -66,7 +65,7 @@ export declare class DynamicModule {
      *
      * // A type that lists all possible values `columnFromUserInput` can have.
      * // You can use `keyof Person` if any column of an interface is allowed.
-     * type PossibleColumns = 'last_name' | 'first_name' | 'birth_date'
+     * type PossibleColumns = 'last_name' | 'first_name' | 'birth_date'
      *
      * const [person] = await db.selectFrom('person')
      *   .select([
@@ -78,9 +77,9 @@ export declare class DynamicModule {
      * // The resulting type contains all `PossibleColumns` as optional fields
      * // because we cannot know which field was actually selected before
      * // running the code.
-     * const lastName: string | undefined = person.last_name
-     * const firstName: string | undefined = person.first_name
-     * const birthDate: string | undefined = person.birth_date
+     * const lastName: string | undefined = person.last_name
+     * const firstName: string | undefined = person.first_name
+     * const birthDate: string | undefined = person.birth_date
      *
      * // The result type also contains the compile time selection `id`.
      * person.id

package/dist/esm/dynamic/dynamic.js

@@ -20,7 +20,8 @@ export class DynamicModule {
      * `ref` to other methods as well. If the types allow you to pass a `ref`
      * value to some place, it should work.
      *
-     * @example
+     * ### Examples
+     *
      * Filter by a column not know at compile time:
      *
      * ```ts
@@ -38,7 +39,6 @@ export class DynamicModule {
      * someQuery('person.last_name', 'Aniston')
      * ```
      *
-     * @example
      * Order by a column not know at compile time:
      *
      * ```ts
@@ -55,7 +55,6 @@ export class DynamicModule {
      * someQuery('fn')
      * ```
      *
-     * @example
      * In this example we add selections dynamically:
      *
      * ```ts
@@ -66,7 +65,7 @@ export class DynamicModule {
      *
      * // A type that lists all possible values `columnFromUserInput` can have.
      * // You can use `keyof Person` if any column of an interface is allowed.
-     * type PossibleColumns = 'last_name' | 'first_name' | 'birth_date'
+     * type PossibleColumns = 'last_name' | 'first_name' | 'birth_date'
      *
      * const [person] = await db.selectFrom('person')
      *   .select([
@@ -78,9 +77,9 @@ export class DynamicModule {
      * // The resulting type contains all `PossibleColumns` as optional fields
      * // because we cannot know which field was actually selected before
      * // running the code.
-     * const lastName: string | undefined = person.last_name
-     * const firstName: string | undefined = person.first_name
-     * const birthDate: string | undefined = person.birth_date
+     * const lastName: string | undefined = person.last_name
+     * const firstName: string | undefined = person.first_name
+     * const birthDate: string | undefined = person.birth_date
      *
      * // The result type also contains the compile time selection `id`.
      * person.id

package/dist/esm/index.d.ts

@@ -1,8 +1,17 @@
 export * from './kysely.js';
 export * from './query-creator.js';
-export * from './query-builder/query-builder.js';
+export * from './query-builder/where-interface.js';
+export * from './query-builder/join-interface.js';
+export * from './query-builder/returning-interface.js';
+export * from './query-builder/having-interface.js';
+export * from './query-builder/select-query-builder.js';
+export * from './query-builder/insert-query-builder.js';
+export * from './query-builder/update-query-builder.js';
+export * from './query-builder/delete-query-builder.js';
+export * from './query-builder/no-result-error.js';
 export * from './query-builder/join-builder.js';
 export * from './query-builder/expression-builder.js';
+export * from './query-builder/function-builder.js';
 export * from './query-builder/insert-result.js';
 export * from './query-builder/delete-result.js';
 export * from './query-builder/update-result.js';
@@ -51,35 +60,8 @@ export * from './migration/migration.js';
 export * from './dialect/dialect.js';
 export * from './dialect/dialect-adapter.js';
 export * from './dialect/dialect-adapter-base.js';
-export * from './operation-node/operation-node-transformer.js';
-export * from './operation-node/operation-node-visitor.js';
 export * from './plugin/kysely-plugin.js';
 export * from './plugin/camel-case/camel-case-plugin.js';
-export * from './operation-node/operation-node-transformer.js';
-export * from './operation-node/operation-node-visitor.js';
-export * from './operation-node/operator-node.js';
-export * from './operation-node/or-node.js';
-export * from './operation-node/order-by-item-node.js';
-export * from './operation-node/order-by-node.js';
-export * from './operation-node/parens-node.js';
-export * from './operation-node/primary-constraint-node.js';
-export * from './operation-node/primitive-value-list-node.js';
-export * from './operation-node/query-node.js';
-export * from './operation-node/raw-node.js';
-export * from './operation-node/reference-node.js';
-export * from './operation-node/references-node.js';
-export * from './operation-node/rename-column-node.js';
-export * from './operation-node/returning-node.js';
-export * from './operation-node/select-all-node.js';
-export * from './operation-node/select-query-node.js';
-export * from './operation-node/selection-node.js';
-export * from './operation-node/table-node.js';
-export * from './operation-node/unique-constraint-node.js';
-export * from './operation-node/update-query-node.js';
-export * from './operation-node/value-list-node.js';
-export * from './operation-node/value-node.js';
-export * from './operation-node/where-node.js';
-export * from './operation-node/with-node.js';
 export * from './operation-node/add-column-node.js';
 export * from './operation-node/add-constraint-node.js';
 export * from './operation-node/alias-node.js';
@@ -95,16 +77,20 @@ export * from './operation-node/constraint-node.js';
 export * from './operation-node/create-index-node.js';
 export * from './operation-node/create-schema-node.js';
 export * from './operation-node/create-table-node.js';
+export * from './operation-node/create-view-node.js';
 export * from './operation-node/data-type-node.js';
+export * from './operation-node/default-value-node.js';
 export * from './operation-node/delete-query-node.js';
 export * from './operation-node/drop-column-node.js';
 export * from './operation-node/drop-constraint-node.js';
 export * from './operation-node/drop-index-node.js';
 export * from './operation-node/drop-schema-node.js';
 export * from './operation-node/drop-table-node.js';
+export * from './operation-node/drop-view-node.js';
 export * from './operation-node/filter-node.js';
 export * from './operation-node/foreign-key-constraint-node.js';
 export * from './operation-node/from-node.js';
+export * from './operation-node/generated-always-as-node.js';
 export * from './operation-node/group-by-item-node.js';
 export * from './operation-node/group-by-node.js';
 export * from './operation-node/having-node.js';
@@ -113,19 +99,51 @@ export * from './operation-node/insert-query-node.js';
 export * from './operation-node/join-node.js';
 export * from './operation-node/limit-node.js';
 export * from './operation-node/list-node.js';
+export * from './operation-node/modify-column-node.js';
 export * from './operation-node/offset-node.js';
-export * from './operation-node//on-conflict-node.js';
-export * from './operation-node/operation-node.js';
+export * from './operation-node/on-conflict-node.js';
+export * from './operation-node/on-duplicate-key-node.js';
+export * from './operation-node/on-node.js';
 export * from './operation-node/operation-node-source.js';
+export * from './operation-node/operation-node-transformer.js';
+export * from './operation-node/operation-node-utils.js';
+export * from './operation-node/operation-node-visitor.js';
+export * from './operation-node/operation-node.js';
+export * from './operation-node/operator-node.js';
+export * from './operation-node/or-node.js';
+export * from './operation-node/order-by-item-node.js';
 export * from './operation-node/order-by-node.js';
+export * from './operation-node/parens-node.js';
+export * from './operation-node/primary-constraint-node.js';
+export * from './operation-node/primitive-value-list-node.js';
+export * from './operation-node/query-node.js';
+export * from './operation-node/raw-node.js';
+export * from './operation-node/reference-node.js';
+export * from './operation-node/references-node.js';
+export * from './operation-node/rename-column-node.js';
+export * from './operation-node/returning-node.js';
+export * from './operation-node/select-all-node.js';
+export * from './operation-node/select-query-node.js';
+export * from './operation-node/select-query-node.js';
+export * from './operation-node/selection-node.js';
+export * from './operation-node/table-node.js';
+export * from './operation-node/union-node.js';
+export * from './operation-node/unique-constraint-node.js';
+export * from './operation-node/update-query-node.js';
+export * from './operation-node/value-list-node.js';
+export * from './operation-node/value-node.js';
+export * from './operation-node/values-node.js';
+export * from './operation-node/where-node.js';
+export * from './operation-node/with-node.js';
 export * from './introspection/database-introspector.js';
 export * from './util/compilable.js';
-export { AnyColumn, UnknownRow, AnyQueryBuilder } from './util/type-utils.js';
+export * from './util/log.js';
+export { AnyColumn, UnknownRow, AnySelectQueryBuilder, } from './util/type-utils.js';
 export { SelectExpression, SelectExpressionOrList, } from './parser/select-parser.js';
 export { ReferenceExpression, ReferenceExpressionOrList, } from './parser/reference-parser.js';
 export { ValueExpression, ValueExpressionOrList, } from './parser/value-parser.js';
-export { ExistsExpression, FilterOperator } from './parser/filter-parser.js';
-export { TableExpression } from './parser/table-parser.js';
+export { FilterValueExpression, FilterValueExpressionOrList, ExistsExpression, FilterOperator, } from './parser/filter-parser.js';
+export { TableExpression, TableExpressionOrList, } from './parser/table-parser.js';
 export { JoinReferenceExpression, JoinCallbackExpression, } from './parser/join-parser.js';
 export { InsertObject } from './parser/insert-values-parser.js';
 export { MutationObject } from './parser/update-set-parser.js';

package/dist/esm/index.js

@@ -1,8 +1,17 @@
 export * from './kysely.js';
 export * from './query-creator.js';
-export * from './query-builder/query-builder.js';
+export * from './query-builder/where-interface.js';
+export * from './query-builder/join-interface.js';
+export * from './query-builder/returning-interface.js';
+export * from './query-builder/having-interface.js';
+export * from './query-builder/select-query-builder.js';
+export * from './query-builder/insert-query-builder.js';
+export * from './query-builder/update-query-builder.js';
+export * from './query-builder/delete-query-builder.js';
+export * from './query-builder/no-result-error.js';
 export * from './query-builder/join-builder.js';
 export * from './query-builder/expression-builder.js';
+export * from './query-builder/function-builder.js';
 export * from './query-builder/insert-result.js';
 export * from './query-builder/delete-result.js';
 export * from './query-builder/update-result.js';
@@ -51,35 +60,8 @@ export * from './migration/migration.js';
 export * from './dialect/dialect.js';
 export * from './dialect/dialect-adapter.js';
 export * from './dialect/dialect-adapter-base.js';
-export * from './operation-node/operation-node-transformer.js';
-export * from './operation-node/operation-node-visitor.js';
 export * from './plugin/kysely-plugin.js';
 export * from './plugin/camel-case/camel-case-plugin.js';
-export * from './operation-node/operation-node-transformer.js';
-export * from './operation-node/operation-node-visitor.js';
-export * from './operation-node/operator-node.js';
-export * from './operation-node/or-node.js';
-export * from './operation-node/order-by-item-node.js';
-export * from './operation-node/order-by-node.js';
-export * from './operation-node/parens-node.js';
-export * from './operation-node/primary-constraint-node.js';
-export * from './operation-node/primitive-value-list-node.js';
-export * from './operation-node/query-node.js';
-export * from './operation-node/raw-node.js';
-export * from './operation-node/reference-node.js';
-export * from './operation-node/references-node.js';
-export * from './operation-node/rename-column-node.js';
-export * from './operation-node/returning-node.js';
-export * from './operation-node/select-all-node.js';
-export * from './operation-node/select-query-node.js';
-export * from './operation-node/selection-node.js';
-export * from './operation-node/table-node.js';
-export * from './operation-node/unique-constraint-node.js';
-export * from './operation-node/update-query-node.js';
-export * from './operation-node/value-list-node.js';
-export * from './operation-node/value-node.js';
-export * from './operation-node/where-node.js';
-export * from './operation-node/with-node.js';
 export * from './operation-node/add-column-node.js';
 export * from './operation-node/add-constraint-node.js';
 export * from './operation-node/alias-node.js';
@@ -95,16 +77,20 @@ export * from './operation-node/constraint-node.js';
 export * from './operation-node/create-index-node.js';
 export * from './operation-node/create-schema-node.js';
 export * from './operation-node/create-table-node.js';
+export * from './operation-node/create-view-node.js';
 export * from './operation-node/data-type-node.js';
+export * from './operation-node/default-value-node.js';
 export * from './operation-node/delete-query-node.js';
 export * from './operation-node/drop-column-node.js';
 export * from './operation-node/drop-constraint-node.js';
 export * from './operation-node/drop-index-node.js';
 export * from './operation-node/drop-schema-node.js';
 export * from './operation-node/drop-table-node.js';
+export * from './operation-node/drop-view-node.js';
 export * from './operation-node/filter-node.js';
 export * from './operation-node/foreign-key-constraint-node.js';
 export * from './operation-node/from-node.js';
+export * from './operation-node/generated-always-as-node.js';
 export * from './operation-node/group-by-item-node.js';
 export * from './operation-node/group-by-node.js';
 export * from './operation-node/having-node.js';
@@ -113,10 +99,42 @@ export * from './operation-node/insert-query-node.js';
 export * from './operation-node/join-node.js';
 export * from './operation-node/limit-node.js';
 export * from './operation-node/list-node.js';
+export * from './operation-node/modify-column-node.js';
 export * from './operation-node/offset-node.js';
-export * from './operation-node//on-conflict-node.js';
-export * from './operation-node/operation-node.js';
+export * from './operation-node/on-conflict-node.js';
+export * from './operation-node/on-duplicate-key-node.js';
+export * from './operation-node/on-node.js';
 export * from './operation-node/operation-node-source.js';
+export * from './operation-node/operation-node-transformer.js';
+export * from './operation-node/operation-node-utils.js';
+export * from './operation-node/operation-node-visitor.js';
+export * from './operation-node/operation-node.js';
+export * from './operation-node/operator-node.js';
+export * from './operation-node/or-node.js';
+export * from './operation-node/order-by-item-node.js';
 export * from './operation-node/order-by-node.js';
+export * from './operation-node/parens-node.js';
+export * from './operation-node/primary-constraint-node.js';
+export * from './operation-node/primitive-value-list-node.js';
+export * from './operation-node/query-node.js';
+export * from './operation-node/raw-node.js';
+export * from './operation-node/reference-node.js';
+export * from './operation-node/references-node.js';
+export * from './operation-node/rename-column-node.js';
+export * from './operation-node/returning-node.js';
+export * from './operation-node/select-all-node.js';
+export * from './operation-node/select-query-node.js';
+export * from './operation-node/select-query-node.js';
+export * from './operation-node/selection-node.js';
+export * from './operation-node/table-node.js';
+export * from './operation-node/union-node.js';
+export * from './operation-node/unique-constraint-node.js';
+export * from './operation-node/update-query-node.js';
+export * from './operation-node/value-list-node.js';
+export * from './operation-node/value-node.js';
+export * from './operation-node/values-node.js';
+export * from './operation-node/where-node.js';
+export * from './operation-node/with-node.js';
 export * from './introspection/database-introspector.js';
 export * from './util/compilable.js';
+export * from './util/log.js';

package/dist/esm/kysely.d.ts

@@ -10,14 +10,15 @@ import { DatabaseIntrospector } from './introspection/database-introspector.js';
 import { Driver, IsolationLevel } from './driver/driver.js';
 import { ParseContext } from './parser/parse-context.js';
 import { FunctionBuilder } from './query-builder/function-builder.js';
-import { LogLevel } from './util/log.js';
+import { LogConfig } from './util/log.js';
 /**
  * The main Kysely class.
  *
  * You should create one instance of `Kysely` per database using the {@link Kysely}
  * constructor. Each `Kysely` instance maintains it's own connection pool.
  *
- * @example
+ * ### Examples
+ *
  * This example assumes your database has tables `person` and `pet`:
  *
  * ```ts
@@ -31,7 +32,7 @@ import { LogLevel } from './util/log.js';
  *   id: number
  *   owner_id: number
  *   name: string
- *   species 'cat' | 'dog'
+ *   species 'cat' | 'dog'
  * }
  *
  * interface Database {
@@ -78,10 +79,11 @@ export declare class Kysely<DB> extends QueryCreator<DB> {
      * A value to be used in place of columns that are generated in the database
      * when inserting rows.
      *
-     * @example
+     * ### Examples
+     *
      * In this example the `Person` table has non-null properties `id` and `created_at`
      * which are both automatically genereted by the database. Since their types are
-     * `number` and `string` respectively instead of `number | null` and `string | null`
+     * `number` and `string` respectively instead of `number | null` and `string | null`
      * the `values` method requires you to give a value for them. the `generated`
      * placeholder can be used in these cases.
      *
@@ -136,12 +138,13 @@ export declare class Kysely<DB> extends QueryCreator<DB> {
      * transaction. If the function throws, the transaction is rolled back. Otherwise
      * the transaction is committed.
      *
-     * The callback function passed to the {@link TransactionBuilder.execute | execute}
+     * The callback function passed to the {@link TransactionBuilder.execute | execute}
      * method gets the transaction object as its only argument. The transaction is
      * of type {@link Transaction} which inherits {@link Kysely}. Any query
      * started through the transaction object is executed inside the transaction.
      *
-     * @example
+     * ### Examples
+     *
      * ```ts
      * const catto = await db.transaction().execute(async (trx) => {
      *   const jennifer = await trx.insertInto('person')
@@ -167,8 +170,7 @@ export declare class Kysely<DB> extends QueryCreator<DB> {
      * })
      * ```
      *
-     * @example
-     * Setting the isolation level.
+     * Setting the isolation level:
      *
      * ```ts
      * await db
@@ -183,7 +185,8 @@ export declare class Kysely<DB> extends QueryCreator<DB> {
     /**
      * Provides a kysely instance bound to a single database connection.
      *
-     * @example
+     * ### Examples
+     *
      * ```ts
      * await db
      *   .connection()
@@ -218,10 +221,15 @@ export declare class Kysely<DB> extends QueryCreator<DB> {
     get isTransaction(): boolean;
 }
 export declare class Transaction<DB> extends Kysely<DB> {
+    #private;
+    constructor(props: KyselyProps);
     get isTransaction(): true;
     get migration(): MigrationModule;
     transaction(): TransactionBuilder<DB>;
+    connection(): ConnectionBuilder<DB>;
     destroy(): Promise<void>;
+    withPlugin(plugin: KyselyPlugin): Transaction<DB>;
+    withoutPlugins(): Transaction<DB>;
 }
 export interface KyselyProps {
     readonly config: KyselyConfig;
@@ -235,17 +243,33 @@ export interface KyselyConfig {
     readonly dialect: Dialect;
     readonly plugins?: KyselyPlugin[];
     /**
-     * A list of log levels to log.
+     * A list of log levels to log or a custom logger function.
      *
      * Currently there's only two levels: `query` and `error`.
      * This will be expanded based on user feedback later.
      *
-     * Log levels:
+     * ### Examples
      *
-     *  - query: Log each query's SQL and duration using console.log
-     *  - error: Log all query errors using console.error
+     * ```ts
+     * const db = new Kysely<Database>({
+     *   dialect: new PostgresDialect(postgresConfig),
+     *   log: ['query', 'error']
+     * })
+     * ```
+     *
+     * ```ts
+     * const db = new Kysely<Database>({
+     *   dialect: new PostgresDialect(postgresConfig),
+     *   log(event): void {
+     *     if (event.level === 'query') {
+     *       console.log(event.query.sql)
+     *       console.log(event.query.parameters)
+     *     }
+     *   }
+     * })
+     * ```
      */
-    readonly log?: ReadonlyArray<LogLevel>;
+    readonly log?: LogConfig;
 }
 export declare class ConnectionBuilder<DB> {
     #private;