kysely 0.27.5 → 0.28.0

package/dist/esm/helpers/postgres.js

@@ -152,3 +152,52 @@ export function jsonObjectFrom(expr) {
 export function jsonBuildObject(obj) {
     return sql `json_build_object(${sql.join(Object.keys(obj).flatMap((k) => [sql.lit(k), obj[k]]))})`;
 }
+/**
+ * The PostgreSQL `merge_action` function.
+ *
+ * This function can be used in a `returning` clause to get the action that was
+ * performed in a `mergeInto` query. The function returns one of the following
+ * strings: `'INSERT'`, `'UPDATE'`, or `'DELETE'`.
+ *
+ * ### Examples
+ *
+ * ```ts
+ * import { mergeAction } from 'kysely/helpers/postgres'
+ *
+ * const result = await db
+ *   .mergeInto('person as p')
+ *   .using('person_backup as pb', 'p.id', 'pb.id')
+ *   .whenMatched()
+ *   .thenUpdateSet(({ ref }) => ({
+ *     first_name: ref('pb.first_name'),
+ *     updated_at: ref('pb.updated_at').$castTo<string | null>(),
+ *   }))
+ *   .whenNotMatched()
+ *   .thenInsertValues(({ ref}) => ({
+ *     id: ref('pb.id'),
+ *     first_name: ref('pb.first_name'),
+ *     created_at: ref('pb.updated_at'),
+ *     updated_at: ref('pb.updated_at').$castTo<string | null>(),
+ *   }))
+ *   .returning([mergeAction().as('action'), 'p.id', 'p.updated_at'])
+ *   .execute()
+ *
+ * result[0].action
+ * ```
+ *
+ * The generated SQL (PostgreSQL):
+ *
+ * ```sql
+ * merge into "person" as "p"
+ * using "person_backup" as "pb" on "p"."id" = "pb"."id"
+ * when matched then update set
+ *   "first_name" = "pb"."first_name",
+ *   "updated_at" = "pb"."updated_at"::text
+ * when not matched then insert values ("id", "first_name", "created_at", "updated_at")
+ * values ("pb"."id", "pb"."first_name", "pb"."updated_at", "pb"."updated_at")
+ * returning merge_action() as "action", "p"."id", "p"."updated_at"
+ * ```
+ */
+export function mergeAction() {
+    return sql `merge_action()`;
+}

package/dist/esm/index.d.ts

@@ -7,6 +7,7 @@ export * from './query-builder/where-interface.js';
 export * from './query-builder/returning-interface.js';
 export * from './query-builder/output-interface.js';
 export * from './query-builder/having-interface.js';
+export * from './query-builder/order-by-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';
@@ -23,6 +24,7 @@ export * from './query-builder/case-builder.js';
 export * from './query-builder/json-path-builder.js';
 export * from './query-builder/merge-query-builder.js';
 export * from './query-builder/merge-result.js';
+export * from './query-builder/order-by-item-builder.js';
 export * from './raw-builder/raw-builder.js';
 export * from './raw-builder/sql.js';
 export * from './query-executor/query-executor.js';
@@ -44,6 +46,7 @@ export * from './schema/column-definition-builder.js';
 export * from './schema/foreign-key-constraint-builder.js';
 export * from './schema/alter-table-builder.js';
 export * from './schema/create-view-builder.js';
+export * from './schema/refresh-materialized-view-builder.js';
 export * from './schema/drop-view-builder.js';
 export * from './schema/alter-column-builder.js';
 export * from './dynamic/dynamic.js';
@@ -90,6 +93,8 @@ export * from './plugin/camel-case/camel-case-plugin.js';
 export * from './plugin/deduplicate-joins/deduplicate-joins-plugin.js';
 export * from './plugin/with-schema/with-schema-plugin.js';
 export * from './plugin/parse-json-results/parse-json-results-plugin.js';
+export * from './plugin/handle-empty-in-lists/handle-empty-in-lists-plugin.js';
+export * from './plugin/handle-empty-in-lists/handle-empty-in-lists.js';
 export * from './operation-node/add-column-node.js';
 export * from './operation-node/add-constraint-node.js';
 export * from './operation-node/add-index-node.js';
@@ -102,6 +107,7 @@ export * from './operation-node/binary-operation-node.js';
 export * from './operation-node/case-node.js';
 export * from './operation-node/cast-node.js';
 export * from './operation-node/check-constraint-node.js';
+export * from './operation-node/collate-node.js';
 export * from './operation-node/column-definition-node.js';
 export * from './operation-node/column-node.js';
 export * from './operation-node/column-update-node.js';
@@ -113,6 +119,7 @@ export * from './operation-node/create-schema-node.js';
 export * from './operation-node/create-table-node.js';
 export * from './operation-node/create-type-node.js';
 export * from './operation-node/create-view-node.js';
+export * from './operation-node/refresh-materialized-view-node.js';
 export * from './operation-node/data-type-node.js';
 export * from './operation-node/default-insert-value-node.js';
 export * from './operation-node/default-value-node.js';
@@ -154,6 +161,7 @@ export * from './operation-node/operation-node-transformer.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-action-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';
@@ -162,13 +170,14 @@ export * from './operation-node/over-node.js';
 export * from './operation-node/parens-node.js';
 export * from './operation-node/partition-by-item-node.js';
 export * from './operation-node/partition-by-node.js';
-export * from './operation-node/primary-constraint-node.js';
+export * from './operation-node/primary-key-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/rename-constraint-node.js';
 export * from './operation-node/returning-node.js';
 export * from './operation-node/schemable-identifier-node.js';
 export * from './operation-node/select-all-node.js';
@@ -198,6 +207,7 @@ export * from './util/log.js';
 export { AnyAliasedColumn, AnyAliasedColumnWithTable, AnyColumn, AnyColumnWithTable, Equals, UnknownRow, Simplify, SqlBool, Nullable, NotNull, } from './util/type-utils.js';
 export * from './util/infer-result.js';
 export { logOnce } from './util/log-once.js';
+export { createQueryId, QueryId } from './util/query-id.js';
 export { SelectExpression, SelectCallback, SelectArg, Selection, CallbackSelection, } from './parser/select-parser.js';
 export { ReferenceExpression, ReferenceExpressionOrList, SimpleReferenceExpression, StringReference, ExtractTypeFromStringReference, ExtractTypeFromReferenceExpression, } from './parser/reference-parser.js';
 export { ValueExpression, ValueExpressionOrList, } from './parser/value-parser.js';
@@ -205,7 +215,8 @@ export { SimpleTableReference, TableExpression, TableExpressionOrList, } from '.
 export { JoinReferenceExpression, JoinCallbackExpression, } from './parser/join-parser.js';
 export { InsertObject } from './parser/insert-values-parser.js';
 export { UpdateObject } from './parser/update-set-parser.js';
-export { OrderByExpression, OrderByDirectionExpression, } from './parser/order-by-parser.js';
+export { OrderByExpression, OrderByDirectionExpression, OrderByModifiers, OrderByDirection, OrderByModifiersCallbackExpression, } from './parser/order-by-parser.js';
 export { ComparisonOperatorExpression, OperandValueExpression, OperandValueExpressionOrList, FilterObject, } from './parser/binary-operation-parser.js';
 export { ExistsExpression } from './parser/unary-operation-parser.js';
 export { OperandExpression, ExpressionOrFactory, } from './parser/expression-parser.js';
+export { Collation } from './parser/collate-parser.js';

package/dist/esm/index.js

@@ -8,6 +8,7 @@ export * from './query-builder/where-interface.js';
 export * from './query-builder/returning-interface.js';
 export * from './query-builder/output-interface.js';
 export * from './query-builder/having-interface.js';
+export * from './query-builder/order-by-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';
@@ -24,6 +25,7 @@ export * from './query-builder/case-builder.js';
 export * from './query-builder/json-path-builder.js';
 export * from './query-builder/merge-query-builder.js';
 export * from './query-builder/merge-result.js';
+export * from './query-builder/order-by-item-builder.js';
 export * from './raw-builder/raw-builder.js';
 export * from './raw-builder/sql.js';
 export * from './query-executor/query-executor.js';
@@ -45,6 +47,7 @@ export * from './schema/column-definition-builder.js';
 export * from './schema/foreign-key-constraint-builder.js';
 export * from './schema/alter-table-builder.js';
 export * from './schema/create-view-builder.js';
+export * from './schema/refresh-materialized-view-builder.js';
 export * from './schema/drop-view-builder.js';
 export * from './schema/alter-column-builder.js';
 export * from './dynamic/dynamic.js';
@@ -91,6 +94,8 @@ export * from './plugin/camel-case/camel-case-plugin.js';
 export * from './plugin/deduplicate-joins/deduplicate-joins-plugin.js';
 export * from './plugin/with-schema/with-schema-plugin.js';
 export * from './plugin/parse-json-results/parse-json-results-plugin.js';
+export * from './plugin/handle-empty-in-lists/handle-empty-in-lists-plugin.js';
+export * from './plugin/handle-empty-in-lists/handle-empty-in-lists.js';
 export * from './operation-node/add-column-node.js';
 export * from './operation-node/add-constraint-node.js';
 export * from './operation-node/add-index-node.js';
@@ -103,6 +108,7 @@ export * from './operation-node/binary-operation-node.js';
 export * from './operation-node/case-node.js';
 export * from './operation-node/cast-node.js';
 export * from './operation-node/check-constraint-node.js';
+export * from './operation-node/collate-node.js';
 export * from './operation-node/column-definition-node.js';
 export * from './operation-node/column-node.js';
 export * from './operation-node/column-update-node.js';
@@ -114,6 +120,7 @@ export * from './operation-node/create-schema-node.js';
 export * from './operation-node/create-table-node.js';
 export * from './operation-node/create-type-node.js';
 export * from './operation-node/create-view-node.js';
+export * from './operation-node/refresh-materialized-view-node.js';
 export * from './operation-node/data-type-node.js';
 export * from './operation-node/default-insert-value-node.js';
 export * from './operation-node/default-value-node.js';
@@ -155,6 +162,7 @@ export * from './operation-node/operation-node-transformer.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-action-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';
@@ -163,13 +171,14 @@ export * from './operation-node/over-node.js';
 export * from './operation-node/parens-node.js';
 export * from './operation-node/partition-by-item-node.js';
 export * from './operation-node/partition-by-node.js';
-export * from './operation-node/primary-constraint-node.js';
+export * from './operation-node/primary-key-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/rename-constraint-node.js';
 export * from './operation-node/returning-node.js';
 export * from './operation-node/schemable-identifier-node.js';
 export * from './operation-node/select-all-node.js';
@@ -198,3 +207,4 @@ export * from './util/streamable.js';
 export * from './util/log.js';
 export * from './util/infer-result.js';
 export { logOnce } from './util/log-once.js';
+export { createQueryId } from './util/query-id.js';

package/dist/esm/kysely.d.ts

@@ -5,7 +5,7 @@ import { QueryExecutor } from './query-executor/query-executor.js';
 import { QueryCreator } from './query-creator.js';
 import { KyselyPlugin } from './plugin/kysely-plugin.js';
 import { DatabaseIntrospector } from './dialect/database-introspector.js';
-import { Driver, IsolationLevel } from './driver/driver.js';
+import { Driver, IsolationLevel, AccessMode } from './driver/driver.js';
 import { FunctionModule } from './query-builder/function-module.js';
 import { LogConfig } from './util/log.js';
 import { QueryExecutorProvider } from './query-executor/query-executor-provider.js';
@@ -16,6 +16,8 @@ import { Compilable } from './util/compilable.js';
 import { CaseBuilder } from './query-builder/case-builder.js';
 import { Expression } from './expression/expression.js';
 import { DrainOuterGeneric } from './util/type-utils.js';
+import { ReleaseSavepoint, RollbackToSavepoint } from './parser/savepoint-parser.js';
+import { ControlledConnection } from './util/provide-controlled-connection.js';
 /**
  * The main Kysely class.
  *
@@ -49,7 +51,7 @@ import { DrainOuterGeneric } from './util/type-utils.js';
  *    in the database and values must be interfaces that describe the rows in those
  *    tables. See the examples above.
  */
-export declare class Kysely<DB> extends QueryCreator<DB> implements QueryExecutorProvider {
+export declare class Kysely<DB> extends QueryCreator<DB> implements QueryExecutorProvider, AsyncDisposable {
     #private;
     constructor(args: KyselyConfig);
     constructor(args: KyselyProps);
@@ -141,6 +143,9 @@ export declare class Kysely<DB> extends QueryCreator<DB> implements QueryExecuto
      * of type {@link Transaction} which inherits {@link Kysely}. Any query
      * started through the transaction object is executed inside the transaction.
      *
+     * To run a controlled transaction, allowing you to commit and rollback manually,
+     * use {@link startTransaction} instead.
+     *
      * ### Examples
      *
      * <!-- siteExample("transactions", "Simple transaction", 10) -->
@@ -193,6 +198,118 @@ export declare class Kysely<DB> extends QueryCreator<DB> implements QueryExecuto
      * ```
      */
     transaction(): TransactionBuilder<DB>;
+    /**
+     * Creates a {@link ControlledTransactionBuilder} that can be used to run queries inside a controlled transaction.
+     *
+     * The returned {@link ControlledTransactionBuilder} can be used to configure the transaction.
+     * The {@link ControlledTransactionBuilder.execute} method can then be called
+     * to start the transaction and return a {@link ControlledTransaction}.
+     *
+     * A {@link ControlledTransaction} allows you to commit and rollback manually,
+     * execute savepoint commands. It extends {@link Transaction} which extends {@link Kysely},
+     * so you can run queries inside the transaction. Once the transaction is committed,
+     * or rolled back, it can't be used anymore - all queries will throw an error.
+     * This is to prevent accidentally running queries outside the transaction - where
+     * atomicity is not guaranteed anymore.
+     *
+     * ### Examples
+     *
+     * <!-- siteExample("transactions", "Controlled transaction", 11) -->
+     *
+     * A controlled transaction allows you to commit and rollback manually, execute
+     * savepoint commands, and queries in general.
+     *
+     * In this example we start a transaction, use it to insert two rows and then commit
+     * the transaction. If an error is thrown, we catch it and rollback the transaction.
+     *
+     * ```ts
+     * const trx = await db.startTransaction().execute()
+     *
+     * try {
+     *   const jennifer = await trx.insertInto('person')
+     *     .values({
+     *       first_name: 'Jennifer',
+     *       last_name: 'Aniston',
+     *       age: 40,
+     *     })
+     *     .returning('id')
+     *     .executeTakeFirstOrThrow()
+     *
+     *   const catto = await trx.insertInto('pet')
+     *     .values({
+     *       owner_id: jennifer.id,
+     *       name: 'Catto',
+     *       species: 'cat',
+     *       is_favorite: false,
+     *     })
+     *     .returningAll()
+     *     .executeTakeFirstOrThrow()
+     *
+     *   await trx.commit().execute()
+     *
+     *   // ...
+     * } catch (error) {
+     *   await trx.rollback().execute()
+     * }
+     * ```
+     *
+     * <!-- siteExample("transactions", "Controlled transaction /w savepoints", 12) -->
+     *
+     * A controlled transaction allows you to commit and rollback manually, execute
+     * savepoint commands, and queries in general.
+     *
+     * In this example we start a transaction, insert a person, create a savepoint,
+     * try inserting a toy and a pet, and if an error is thrown, we rollback to the
+     * savepoint. Eventually we release the savepoint, insert an audit record and
+     * commit the transaction. If an error is thrown, we catch it and rollback the
+     * transaction.
+     *
+     * ```ts
+     * const trx = await db.startTransaction().execute()
+     *
+     * try {
+     *   const jennifer = await trx
+     *     .insertInto('person')
+     *     .values({
+     *       first_name: 'Jennifer',
+     *       last_name: 'Aniston',
+     *       age: 40,
+     *     })
+     *     .returning('id')
+     *     .executeTakeFirstOrThrow()
+     *
+     *   const trxAfterJennifer = await trx.savepoint('after_jennifer').execute()
+     *
+     *   try {
+     *     const catto = await trxAfterJennifer
+     *       .insertInto('pet')
+     *       .values({
+     *         owner_id: jennifer.id,
+     *         name: 'Catto',
+     *         species: 'cat',
+     *       })
+     *       .returning('id')
+     *       .executeTakeFirstOrThrow()
+     *
+     *     await trxAfterJennifer
+     *       .insertInto('toy')
+     *       .values({ name: 'Bone', price: 1.99, pet_id: catto.id })
+     *       .execute()
+     *   } catch (error) {
+     *     await trxAfterJennifer.rollbackToSavepoint('after_jennifer').execute()
+     *   }
+     *
+     *   await trxAfterJennifer.releaseSavepoint('after_jennifer').execute()
+     *
+     *   await trx.insertInto('audit').values({ action: 'added Jennifer' }).execute()
+     *
+     *   await trx.commit().execute()
+     * } catch (error) {
+     *   await trx.rollback().execute()
+     * }
+     * ```
+     */
+    startTransaction(): ControlledTransactionBuilder<DB>;
     /**
      * Provides a kysely instance bound to a single database connection.
      *
@@ -280,6 +397,7 @@ export declare class Kysely<DB> extends QueryCreator<DB> implements QueryExecuto
      * See {@link https://github.com/kysely-org/kysely/blob/master/site/docs/recipes/0004-splitting-query-building-and-execution.md#execute-compiled-queries splitting build, compile and execute code recipe} for more information.
      */
     executeQuery<R>(query: CompiledQuery<R> | Compilable<R>, queryId?: QueryId): Promise<QueryResult<R>>;
+    [Symbol.asyncDispose](): Promise<void>;
 }
 export declare class Transaction<DB> extends Kysely<DB> {
     #private;
@@ -307,6 +425,9 @@ export declare class Transaction<DB> extends Kysely<DB> {
      * of type {@link Transaction} which inherits {@link Kysely}. Any query
      * started through the transaction object is executed inside the transaction.
      *
+     * To run a controlled transaction, allowing you to commit and rollback manually,
+     * use {@link startTransaction} instead.
+     *
      * ### Examples
      *
      * <!-- siteExample("transactions", "Simple transaction", 10) -->
@@ -495,10 +616,226 @@ interface ConnectionBuilderProps extends KyselyProps {
 export declare class TransactionBuilder<DB> {
     #private;
     constructor(props: TransactionBuilderProps);
+    setAccessMode(accessMode: AccessMode): TransactionBuilder<DB>;
     setIsolationLevel(isolationLevel: IsolationLevel): TransactionBuilder<DB>;
     execute<T>(callback: (trx: Transaction<DB>) => Promise<T>): Promise<T>;
 }
 interface TransactionBuilderProps extends KyselyProps {
+    readonly accessMode?: AccessMode;
     readonly isolationLevel?: IsolationLevel;
 }
+export declare class ControlledTransactionBuilder<DB> {
+    #private;
+    constructor(props: TransactionBuilderProps);
+    setAccessMode(accessMode: AccessMode): ControlledTransactionBuilder<DB>;
+    setIsolationLevel(isolationLevel: IsolationLevel): ControlledTransactionBuilder<DB>;
+    execute(): Promise<ControlledTransaction<DB>>;
+}
+export declare class ControlledTransaction<DB, S extends string[] = []> extends Transaction<DB> {
+    #private;
+    constructor(props: ControlledTransactionProps);
+    get isCommitted(): boolean;
+    get isRolledBack(): boolean;
+    /**
+     * Commits the transaction.
+     *
+     * See {@link rollback}.
+     *
+     * ### Examples
+     *
+     * ```ts
+     * import type { Kysely } from 'kysely'
+     * import type { Database } from 'type-editor' // imaginary module
+     *
+     * const trx = await db.startTransaction().execute()
+     *
+     * try {
+     *   await doSomething(trx)
+     *
+     *   await trx.commit().execute()
+     * } catch (error) {
+     *   await trx.rollback().execute()
+     * }
+     *
+     * async function doSomething(kysely: Kysely<Database>) {}
+     * ```
+     */
+    commit(): Command<void>;
+    /**
+     * Rolls back the transaction.
+     *
+     * See {@link commit} and {@link rollbackToSavepoint}.
+     *
+     * ### Examples
+     *
+     * ```ts
+     * import type { Kysely } from 'kysely'
+     * import type { Database } from 'type-editor' // imaginary module
+     *
+     * const trx = await db.startTransaction().execute()
+     *
+     * try {
+     *   await doSomething(trx)
+     *
+     *   await trx.commit().execute()
+     * } catch (error) {
+     *   await trx.rollback().execute()
+     * }
+     *
+     * async function doSomething(kysely: Kysely<Database>) {}
+     * ```
+     */
+    rollback(): Command<void>;
+    /**
+     * Creates a savepoint with a given name.
+     *
+     * See {@link rollbackToSavepoint} and {@link releaseSavepoint}.
+     *
+     * For a type-safe experience, you should use the returned instance from now on.
+     *
+     * ### Examples
+     *
+     * ```ts
+     * import type { Kysely } from 'kysely'
+     * import type { Database } from 'type-editor' // imaginary module
+     *
+     * const trx = await db.startTransaction().execute()
+     *
+     * await insertJennifer(trx)
+     *
+     * const trxAfterJennifer = await trx.savepoint('after_jennifer').execute()
+     *
+     * try {
+     *   await doSomething(trxAfterJennifer)
+     * } catch (error) {
+     *   await trxAfterJennifer.rollbackToSavepoint('after_jennifer').execute()
+     * }
+     *
+     * async function insertJennifer(kysely: Kysely<Database>) {}
+     * async function doSomething(kysely: Kysely<Database>) {}
+     * ```
+     */
+    savepoint<SN extends string>(savepointName: SN extends S ? never : SN): Command<ControlledTransaction<DB, [...S, SN]>>;
+    /**
+     * Rolls back to a savepoint with a given name.
+     *
+     * See {@link savepoint} and {@link releaseSavepoint}.
+     *
+     * You must use the same instance returned by {@link savepoint}, or
+     * escape the type-check by using `as any`.
+     *
+     * ### Examples
+     *
+     * ```ts
+     * import type { Kysely } from 'kysely'
+     * import type { Database } from 'type-editor' // imaginary module
+     *
+     * const trx = await db.startTransaction().execute()
+     *
+     * await insertJennifer(trx)
+     *
+     * const trxAfterJennifer = await trx.savepoint('after_jennifer').execute()
+     *
+     * try {
+     *   await doSomething(trxAfterJennifer)
+     * } catch (error) {
+     *   await trxAfterJennifer.rollbackToSavepoint('after_jennifer').execute()
+     * }
+     *
+     * async function insertJennifer(kysely: Kysely<Database>) {}
+     * async function doSomething(kysely: Kysely<Database>) {}
+     * ```
+     */
+    rollbackToSavepoint<SN extends S[number]>(savepointName: SN): RollbackToSavepoint<S, SN> extends string[] ? Command<ControlledTransaction<DB, RollbackToSavepoint<S, SN>>> : never;
+    /**
+     * Releases a savepoint with a given name.
+     *
+     * See {@link savepoint} and {@link rollbackToSavepoint}.
+     *
+     * You must use the same instance returned by {@link savepoint}, or
+     * escape the type-check by using `as any`.
+     *
+     * ### Examples
+     *
+     * ```ts
+     * import type { Kysely } from 'kysely'
+     * import type { Database } from 'type-editor' // imaginary module
+     *
+     * const trx = await db.startTransaction().execute()
+     *
+     * await insertJennifer(trx)
+     *
+     * const trxAfterJennifer = await trx.savepoint('after_jennifer').execute()
+     *
+     * try {
+     *   await doSomething(trxAfterJennifer)
+     * } catch (error) {
+     *   await trxAfterJennifer.rollbackToSavepoint('after_jennifer').execute()
+     * }
+     *
+     * await trxAfterJennifer.releaseSavepoint('after_jennifer').execute()
+     *
+     * await doSomethingElse(trx)
+     *
+     * async function insertJennifer(kysely: Kysely<Database>) {}
+     * async function doSomething(kysely: Kysely<Database>) {}
+     * async function doSomethingElse(kysely: Kysely<Database>) {}
+     * ```
+     */
+    releaseSavepoint<SN extends S[number]>(savepointName: SN): ReleaseSavepoint<S, SN> extends string[] ? Command<ControlledTransaction<DB, ReleaseSavepoint<S, SN>>> : never;
+    /**
+     * Returns a copy of this Kysely instance with the given plugin installed.
+     */
+    withPlugin(plugin: KyselyPlugin): ControlledTransaction<DB, S>;
+    /**
+     * Returns a copy of this Kysely instance without any plugins.
+     */
+    withoutPlugins(): ControlledTransaction<DB, S>;
+    /**
+     * @override
+     */
+    withSchema(schema: string): ControlledTransaction<DB, S>;
+    /**
+     * Returns a copy of this Kysely instance with tables added to its
+     * database type.
+     *
+     * This method only modifies the types and doesn't affect any of the
+     * executed queries in any way.
+     *
+     * ### Examples
+     *
+     * The following example adds and uses a temporary table:
+     *
+     * ```ts
+     * await db.schema
+     *   .createTable('temp_table')
+     *   .temporary()
+     *   .addColumn('some_column', 'integer')
+     *   .execute()
+     *
+     * const tempDb = db.withTables<{
+     *   temp_table: {
+     *     some_column: number
+     *   }
+     * }>()
+     *
+     * await tempDb
+     *   .insertInto('temp_table')
+     *   .values({ some_column: 100 })
+     *   .execute()
+     * ```
+     */
+    withTables<T extends Record<string, Record<string, any>>>(): ControlledTransaction<DrainOuterGeneric<DB & T>, S>;
+}
+interface ControlledTransactionProps extends KyselyProps {
+    readonly connection: ControlledConnection;
+}
+export declare class Command<T> {
+    #private;
+    constructor(cb: () => Promise<T>);
+    /**
+     * Executes the command.
+     */
+    execute(): Promise<T>;
+}
 export {};