kysely 0.27.6 → 0.28.0

package/README.md

@@ -54,7 +54,175 @@ Please visit our documentation site [kysely.dev](https://kysely.dev) to get star
 API documentation hosted [here](https://kysely-org.github.io/kysely-apidoc/), but you can access the same
 documentation in your IDE by hovering over a class/method/property/whatever.
 
-# Contributors
+# Core team
+
+## Project leads
+
+Responsible for project direction, API design, maintenance, code reviews, community support, documentation, and working on some of the most 
+impactful/challenging things.
+
+<table>
+    <tbody>
+        <tr>
+            <td align="center">
+                <a href="https://github.com/koskimas">
+                    <img src="https://avatars.githubusercontent.com/u/846508?v=4?s=100" width="100px;" alt=""/>
+                    <br />
+                    Sami Koskimäki
+                </a>
+                <br />
+                (the <a href="https://web.archive.org/web/20211203210043/https://www.jakso.me/blog/kysely-a-type-safe-sql-query-builder-for-typescript">author</a>)
+            </td>
+            <td align="center">
+                <a href="https://github.com/igalklebanov">
+                    <img src="https://avatars.githubusercontent.com/u/14938291?v=4&s=100" width="100px;" alt=""/>
+                    <br />
+                    Igal Klebanov
+                </a>
+                <br />
+                (the <a href="https://github.com/kysely-org/kysely/pull/1414#issuecomment-2781281996">dynamo</a>)
+            </td>
+        </tr>
+    </tbody>
+</table>
+
+## Honorable mentions
+
+People who had special impact on the project and its growth.
+
+<table>
+    <tbody>
+        <tr>
+            <td align="center">
+                <a href="https://github.com/fhur">
+                    <img src="https://avatars.githubusercontent.com/u/6452323?v=4&s=100" width="100px;" alt=""/>
+                    <br />
+                    Fernando Hurtado
+                </a>
+                <br />
+                (1st <a href="https://kysely.dev">docs</a>)
+            </td>
+            <td align="center">
+                <a href="https://github.com/wirekang">
+                    <img src="https://avatars.githubusercontent.com/u/43294688?v=4&s=100" width="100px;" alt=""/>
+                    <br />
+                    Wirekang
+                </a>
+                <br />
+                (<a href="https://kyse.link">playground</a>)
+            </td>
+            <td align="center">
+                <a href="https://github.com/tgriesser">
+                    <img src="https://avatars.githubusercontent.com/u/154748?v=4&s=100" width="100px;" alt=""/>
+                    <br />
+                    Tim Griesser
+                </a>
+                <br />
+                (<a href="https://knexjs.org/">Knex</a>)
+            </td>
+        </tr>
+        <tr>
+            <td align="center">
+                <a href="https://github.com/RobinBlomberg">
+                    <img src="https://avatars.githubusercontent.com/u/20827397?v=4&s=100" width="100px;" alt=""/>
+                    <br />
+                    Robin Blomberg
+                </a>
+                <br />
+                (<a href="https://github.com/RobinBlomberg/kysely-codegen">codegen</a>)
+            </td>
+                        <td align="center">
+                <a href="https://github.com/nexxeln">
+                    <img src="https://avatars.githubusercontent.com/u/95541290?v=4&s=100" width="100px" alt="" />
+                    <br />
+                    Shoubhit Dash
+                </a>
+                <br />
+                (prisma <a href="https://www.nexxel.dev/blog/typesafe-database">idea</a>)
+            </td>
+            <td align="center">
+                <a href="https://github.com/nexxeln">
+                    <img src="https://avatars.githubusercontent.com/u/3050355?v=4&s=100" width="100px" alt="" />
+                    <br />
+                    Valtýr Örn Kjartansson
+                </a>
+                <br />
+                (prisma <a href="https://github.com/valtyr/prisma-kysely">impl</a>)
+            </td>
+        </tr>
+        <tr>
+            <td align="center">
+                <a href="https://github.com/thdxr">
+                    <img src="https://avatars.githubusercontent.com/u/826656?v=4&s=100" width="100px;" alt=""/>
+                    <br />
+                    Dax Raad
+                </a>
+                <br />
+                (early <a href="https://thdxr.com/post/serverless-relational-showdown">adopter</a>)
+            </td>
+            <td align="center">
+                <a href="https://github.com/t3dotgg">
+                    <img src="https://avatars.githubusercontent.com/u/6751787?v=4&s=100" width="100px;" alt=""/>
+                    <br />
+                    Theo Browne
+                </a>
+                <br />
+                (early <a href="https://discord.com/channels/966627436387266600/988912020558602331/993220628154961930">promoter</a>)
+            </td>
+            <td align="center">
+                <a href="https://github.com/leerob">
+                    <img src="https://avatars.githubusercontent.com/u/9113740?v=4&s=100" width="100px;" alt="" />
+                    <br />
+                    Lee Robinson
+                </a>
+                <br />
+                (early <a href="https://x.com/leerob/status/1576929372811849730">promoter</a>)
+            </td>
+        </tr>
+        <tr>
+            <td align="center">
+                <a href="https://github.com/ethanresnick">
+                    <img src="https://avatars.githubusercontent.com/u/471894?v=4&s=100" width="100px" alt="" />
+                    <br />
+                    Ethan Resnick
+                </a>
+                <br />
+                (timely <a href="https://github.com/kysely-org/kysely/issues/494">feedback</a>)
+            </td>
+            <td align="center">
+                <a href="https://github.com/thetutlage">
+                    <img src="https://avatars.githubusercontent.com/u/1706381?v=4&s=100" width="100px;" alt="" />
+                    <br />
+                    Harminder Virk
+                </a>
+                <br />
+                (dope <a href="https://github.com/thetutlage/meta/discussions/8">writeup</a>)
+            </td>
+            <td align="center">
+                <a href="https://github.com/elitan">
+                    <img src="https://avatars.githubusercontent.com/u/331818?v=4&s=100" width="100px;" alt="" />
+                    <br />
+                    Johan Eliasson
+                </a>
+                <br />
+                (<a href="https://eliasson.me/articles/crafting-the-perfect-t3-stack-my-journey-with-kysely-atlas-and-clerk">promoter</a>/<a href="https://www.youtube.com/watch?v=u2s39dRIpCM">educator</a>)
+            </td>
+        </tr>
+        <!-- <tr>
+            <td align="center">
+                <a href="">
+                    <img src="" width="100px;" alt="" />
+                    <br />
+                    Name
+                </a>
+                <br />
+                (contribution)
+            </td>
+        </tr> -->
+    </tbody>
+</table>
+
+## All contributors
 
 <p align="center">
     <a href="https://github.com/kysely-org/kysely/graphs/contributors">

package/deno.check.d.ts

@@ -10,13 +10,19 @@ import type {
 } from './dist/esm'
 
 export interface Database {
+  audit: AuditTable
   person: PersonTable
+  person_backup: PersonTable
   pet: PetTable
   toy: ToyTable
   wine: WineTable
   wine_stock_change: WineStockChangeTable
 }
 
+interface AuditTable {
+  action: string
+}
+
 interface PersonTable {
   id: Generated<number>
   address: { city: string } | null
@@ -51,6 +57,7 @@ interface PetTable {
 
 interface ToyTable {
   id: Generated<number>
+  name: string
   pet_id: number
   price: number
 }

package/dist/cjs/dialect/mssql/mssql-dialect-config.d.ts

@@ -1,4 +1,12 @@
+import { KyselyTypeError } from '../../util/type-error.js';
 export interface MssqlDialectConfig {
+    /**
+     * When `true`, connections are reset to their initial states when released
+     * back to the pool, resulting in additional requests to the database.
+     *
+     * Defaults to `false`.
+     */
+    resetConnectionsOnRelease?: boolean;
     /**
      * This dialect uses the `tarn` package to manage the connection pool to your
      * database. To use it as a peer dependency and not bundle it with Kysely's code,
@@ -54,26 +62,30 @@ export interface MssqlDialectConfig {
      * ```
      */
     tedious: Tedious;
+    /**
+     * When `true`, connections are validated before being acquired from the pool,
+     * resulting in additional requests to the database.
+     *
+     * Defaults to `true`.
+     */
+    validateConnections?: boolean;
 }
 export interface Tedious {
     connectionFactory: () => TediousConnection | Promise<TediousConnection>;
     ISOLATION_LEVEL: TediousIsolationLevel;
     Request: TediousRequestClass;
-    TYPES: TediousTypes;
     /**
-     * Controls whether connections are reset to their initial states when released back to the pool. Resetting a connection performs additional requests to the database.
-     * See {@link https://tediousjs.github.io/tedious/api-connection.html#function_reset | connection.reset}.
-     *
-     * Defaults to `true`.
+     * @deprecated use {@link MssqlDialectConfig.resetConnectionsOnRelease} instead.
      */
-    resetConnectionOnRelease?: boolean;
+    resetConnectionOnRelease?: KyselyTypeError<'deprecated: use `MssqlDialectConfig.resetConnectionsOnRelease` instead'>;
+    TYPES: TediousTypes;
 }
 export interface TediousConnection {
-    beginTransaction(callback: (error?: Error | null, transactionDescriptor?: any) => void, name?: string, isolationLevel?: number): void;
+    beginTransaction(callback: (err: Error | null | undefined, transactionDescriptor?: any) => void, name?: string | undefined, isolationLevel?: number | undefined): void;
     cancel(): boolean;
     close(): void;
-    commitTransaction(callback: (error?: Error | null) => void, name?: string): void;
-    connect(callback?: (error?: Error) => void): void;
+    commitTransaction(callback: (err: Error | null | undefined) => void, name?: string | undefined): void;
+    connect(connectListener: (err?: Error) => void): void;
     execSql(request: TediousRequest): void;
     off(event: 'error', listener: (error: unknown) => void): this;
     off(event: string, listener: (...args: any[]) => void): this;
@@ -81,9 +93,9 @@ export interface TediousConnection {
     on(event: string, listener: (...args: any[]) => void): this;
     once(event: 'end', listener: () => void): this;
     once(event: string, listener: (...args: any[]) => void): this;
-    reset(callback: (error?: Error | null) => void): void;
-    rollbackTransaction(callback: (error?: Error | null) => void, name?: string): void;
-    saveTransaction(callback: (error?: Error | null) => void, name: string): void;
+    reset(callback: (err: Error | null | undefined) => void): void;
+    rollbackTransaction(callback: (err: Error | null | undefined) => void, name?: string | undefined): void;
+    saveTransaction(callback: (err: Error | null | undefined) => void, name: string): void;
 }
 export type TediousIsolationLevel = Record<string, number>;
 export interface TediousRequestClass {
@@ -132,11 +144,9 @@ export interface Tarn {
      */
     options: Omit<TarnPoolOptions<any>, 'create' | 'destroy' | 'validate'> & {
         /**
-         * Controls whether connections are validated before being acquired from the pool. Connection validation performs additional requests to the database.
-         *
-         * Defaults to `true`.
+         * @deprecated use {@link MssqlDialectConfig.validateConnections} instead.
          */
-        validateConnections?: boolean;
+        validateConnections?: KyselyTypeError<'deprecated: use `MssqlDialectConfig.validateConnections` instead'>;
     };
     /**
      * Tarn.js' Pool class.

package/dist/cjs/dialect/mssql/mssql-driver.d.ts

@@ -2,7 +2,7 @@ import { DatabaseConnection, QueryResult } from '../../driver/database-connectio
 import { Driver, TransactionSettings } from '../../driver/driver.js';
 import { MssqlDialectConfig, Tedious, TediousConnection } from './mssql-dialect-config.js';
 import { CompiledQuery } from '../../query-compiler/compiled-query.js';
-declare const PRIVATE_RELEASE_METHOD: unique symbol;
+declare const PRIVATE_RESET_METHOD: unique symbol;
 declare const PRIVATE_DESTROY_METHOD: unique symbol;
 export declare class MssqlDriver implements Driver {
     #private;
@@ -30,6 +30,8 @@ export declare class MssqlDriver implements Driver {
      * Rolls back a transaction.
      */
     rollbackTransaction(connection: MssqlConnection): Promise<void>;
+    savepoint(connection: MssqlConnection, savepointName: string): Promise<void>;
+    rollbackToSavepoint(connection: MssqlConnection, savepointName: string): Promise<void>;
     /**
      * Releases a connection back to the pool.
      */
@@ -46,10 +48,11 @@ declare class MssqlConnection implements DatabaseConnection {
     commitTransaction(): Promise<void>;
     connect(): Promise<this>;
     executeQuery<O>(compiledQuery: CompiledQuery): Promise<QueryResult<O>>;
-    rollbackTransaction(): Promise<void>;
+    rollbackTransaction(savepointName?: string): Promise<void>;
+    savepoint(savepointName: string): Promise<void>;
     streamQuery<O>(compiledQuery: CompiledQuery, chunkSize: number): AsyncIterableIterator<QueryResult<O>>;
     validate(): Promise<boolean>;
-    [PRIVATE_RELEASE_METHOD](): Promise<void>;
+    [PRIVATE_RESET_METHOD](): Promise<void>;
     [PRIVATE_DESTROY_METHOD](): Promise<void>;
 }
 export {};

package/dist/cjs/dialect/mssql/mssql-driver.js

@@ -6,15 +6,15 @@ const compiled_query_js_1 = require("../../query-compiler/compiled-query.js");
 const stack_trace_utils_js_1 = require("../../util/stack-trace-utils.js");
 const random_string_js_1 = require("../../util/random-string.js");
 const deferred_js_1 = require("../../util/deferred.js");
-const PRIVATE_RELEASE_METHOD = Symbol();
+const PRIVATE_RESET_METHOD = Symbol();
 const PRIVATE_DESTROY_METHOD = Symbol();
 class MssqlDriver {
     #config;
     #pool;
     constructor(config) {
         this.#config = (0, object_utils_js_1.freeze)({ ...config });
-        const { tarn, tedious } = this.#config;
-        const { validateConnections, ...poolOptions } = tarn.options;
+        const { tarn, tedious, validateConnections } = this.#config;
+        const { validateConnections: deprecatedValidateConnections, ...poolOptions } = tarn.options;
         this.#pool = new tarn.Pool({
             ...poolOptions,
             create: async () => {
@@ -26,7 +26,8 @@ class MssqlDriver {
             },
             // @ts-ignore `tarn` accepts a function that returns a promise here, but
             // the types are not aligned and it type errors.
-            validate: validateConnections === false
+            validate: validateConnections === false ||
+                deprecatedValidateConnections === false
                 ? undefined
                 : (connection) => connection.validate(),
         });
@@ -46,8 +47,17 @@ class MssqlDriver {
     async rollbackTransaction(connection) {
         await connection.rollbackTransaction();
     }
+    async savepoint(connection, savepointName) {
+        await connection.savepoint(savepointName);
+    }
+    async rollbackToSavepoint(connection, savepointName) {
+        await connection.rollbackTransaction(savepointName);
+    }
     async releaseConnection(connection) {
-        await connection[PRIVATE_RELEASE_METHOD]();
+        if (this.#config.resetConnectionsOnRelease ||
+            this.#config.tedious.resetConnectionOnRelease) {
+            await connection[PRIVATE_RESET_METHOD]();
+        }
         this.#pool.release(connection);
     }
     async destroy() {
@@ -118,13 +128,21 @@ class MssqlConnection {
             throw (0, stack_trace_utils_js_1.extendStackTrace)(err, new Error());
         }
     }
-    async rollbackTransaction() {
+    async rollbackTransaction(savepointName) {
         await new Promise((resolve, reject) => this.#connection.rollbackTransaction((error) => {
             if (error)
                 reject(error);
             else
                 resolve(undefined);
-        }));
+        }, savepointName));
+    }
+    async savepoint(savepointName) {
+        await new Promise((resolve, reject) => this.#connection.saveTransaction((error) => {
+            if (error)
+                reject(error);
+            else
+                resolve(undefined);
+        }, savepointName));
     }
     async *streamQuery(compiledQuery, chunkSize) {
         if (!Number.isInteger(chunkSize) || chunkSize <= 0) {
@@ -193,18 +211,15 @@ class MssqlConnection {
             }
         });
     }
-    async [PRIVATE_RELEASE_METHOD]() {
-        // TODO: flip this to `if (!this.#tedious.resetConnectionOnRelease) {}` in a future PR.
-        if (this.#tedious.resetConnectionOnRelease !== false) {
-            await new Promise((resolve, reject) => {
-                this.#connection.reset((error) => {
-                    if (error)
-                        reject(error);
-                    else
-                        resolve(undefined);
-                });
+    async [PRIVATE_RESET_METHOD]() {
+        await new Promise((resolve, reject) => {
+            this.#connection.reset((error) => {
+                if (error)
+                    reject(error);
+                else
+                    resolve(undefined);
             });
-        }
+        });
     }
     [PRIVATE_DESTROY_METHOD]() {
         return new Promise((resolve) => {
@@ -221,7 +236,6 @@ class MssqlRequest {
     #streamChunkSize;
     #subscribers;
     #tedious;
-    #error;
     #rowCount;
     constructor(props) {
         const { compiledQuery, onDone, streamChunkSize, tedious } = props;

package/dist/cjs/dialect/mssql/mssql-query-compiler.d.ts

@@ -4,6 +4,7 @@ import { DropColumnNode } from '../../operation-node/drop-column-node.js';
 import { OffsetNode } from '../../operation-node/offset-node.js';
 import { MergeQueryNode } from '../../operation-node/merge-query-node.js';
 import { DefaultQueryCompiler } from '../../query-compiler/default-query-compiler.js';
+import { CollateNode } from '../../operation-node/collate-node.js';
 export declare class MssqlQueryCompiler extends DefaultQueryCompiler {
     protected getCurrentParameterPlaceholder(): string;
     protected visitOffset(node: OffsetNode): void;
@@ -11,5 +12,6 @@ export declare class MssqlQueryCompiler extends DefaultQueryCompiler {
     protected visitAddColumn(node: AddColumnNode): void;
     protected visitDropColumn(node: DropColumnNode): void;
     protected visitMergeQuery(node: MergeQueryNode): void;
+    protected visitCollate(node: CollateNode): void;
     protected announcesNewColumnDataType(): boolean;
 }

package/dist/cjs/dialect/mssql/mssql-query-compiler.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MssqlQueryCompiler = void 0;
 const default_query_compiler_js_1 = require("../../query-compiler/default-query-compiler.js");
+const COLLATION_CHAR_REGEX = /^[a-z0-9_]$/i;
 class MssqlQueryCompiler extends default_query_compiler_js_1.DefaultQueryCompiler {
     getCurrentParameterPlaceholder() {
         return `@${this.numParameters}`;
@@ -65,6 +66,16 @@ class MssqlQueryCompiler extends default_query_compiler_js_1.DefaultQueryCompile
         super.visitMergeQuery(node);
         this.append(';');
     }
+    visitCollate(node) {
+        this.append('collate ');
+        const { name } = node.collation;
+        for (const char of name) {
+            if (!COLLATION_CHAR_REGEX.test(char)) {
+                throw new Error(`Invalid collation: ${name}`);
+            }
+        }
+        this.append(name);
+    }
     announcesNewColumnDataType() {
         return false;
     }

package/dist/cjs/dialect/mysql/mysql-driver.d.ts

@@ -1,6 +1,7 @@
 import { DatabaseConnection, QueryResult } from '../../driver/database-connection.js';
 import { Driver, TransactionSettings } from '../../driver/driver.js';
 import { CompiledQuery } from '../../query-compiler/compiled-query.js';
+import { QueryCompiler } from '../../query-compiler/query-compiler.js';
 import { MysqlDialectConfig, MysqlPoolConnection } from './mysql-dialect-config.js';
 declare const PRIVATE_RELEASE_METHOD: unique symbol;
 export declare class MysqlDriver implements Driver {
@@ -29,6 +30,9 @@ export declare class MysqlDriver implements Driver {
      * Rolls back a transaction.
      */
     rollbackTransaction(connection: DatabaseConnection): Promise<void>;
+    savepoint(connection: DatabaseConnection, savepointName: string, compileQuery: QueryCompiler['compileQuery']): Promise<void>;
+    rollbackToSavepoint(connection: DatabaseConnection, savepointName: string, compileQuery: QueryCompiler['compileQuery']): Promise<void>;
+    releaseSavepoint(connection: DatabaseConnection, savepointName: string, compileQuery: QueryCompiler['compileQuery']): Promise<void>;
     /**
      * Releases a connection back to the pool.
      */

package/dist/cjs/dialect/mysql/mysql-driver.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MysqlDriver = void 0;
+const savepoint_parser_js_1 = require("../../parser/savepoint-parser.js");
 const compiled_query_js_1 = require("../../query-compiler/compiled-query.js");
 const object_utils_js_1 = require("../../util/object-utils.js");
+const query_id_js_1 = require("../../util/query-id.js");
 const stack_trace_utils_js_1 = require("../../util/stack-trace-utils.js");
 const PRIVATE_RELEASE_METHOD = Symbol();
 class MysqlDriver {
@@ -48,9 +50,17 @@ class MysqlDriver {
         });
     }
     async beginTransaction(connection, settings) {
-        if (settings.isolationLevel) {
+        if (settings.isolationLevel || settings.accessMode) {
+            const parts = [];
+            if (settings.isolationLevel) {
+                parts.push(`isolation level ${settings.isolationLevel}`);
+            }
+            if (settings.accessMode) {
+                parts.push(settings.accessMode);
+            }
+            const sql = `set transaction ${parts.join(', ')}`;
             // On MySQL this sets the isolation level of the next transaction.
-            await connection.executeQuery(compiled_query_js_1.CompiledQuery.raw(`set transaction isolation level ${settings.isolationLevel}`));
+            await connection.executeQuery(compiled_query_js_1.CompiledQuery.raw(sql));
         }
         await connection.executeQuery(compiled_query_js_1.CompiledQuery.raw('begin'));
     }
@@ -60,6 +70,15 @@ class MysqlDriver {
     async rollbackTransaction(connection) {
         await connection.executeQuery(compiled_query_js_1.CompiledQuery.raw('rollback'));
     }
+    async savepoint(connection, savepointName, compileQuery) {
+        await connection.executeQuery(compileQuery((0, savepoint_parser_js_1.parseSavepointCommand)('savepoint', savepointName), (0, query_id_js_1.createQueryId)()));
+    }
+    async rollbackToSavepoint(connection, savepointName, compileQuery) {
+        await connection.executeQuery(compileQuery((0, savepoint_parser_js_1.parseSavepointCommand)('rollback to', savepointName), (0, query_id_js_1.createQueryId)()));
+    }
+    async releaseSavepoint(connection, savepointName, compileQuery) {
+        await connection.executeQuery(compileQuery((0, savepoint_parser_js_1.parseSavepointCommand)('release savepoint', savepointName), (0, query_id_js_1.createQueryId)()));
+    }
     async releaseConnection(connection) {
         connection[PRIVATE_RELEASE_METHOD]();
     }
@@ -90,22 +109,18 @@ class MysqlConnection {
             const result = await this.#executeQuery(compiledQuery);
             if (isOkPacket(result)) {
                 const { insertId, affectedRows, changedRows } = result;
-                const numAffectedRows = affectedRows !== undefined && affectedRows !== null
-                    ? BigInt(affectedRows)
-                    : undefined;
-                const numChangedRows = changedRows !== undefined && changedRows !== null
-                    ? BigInt(changedRows)
-                    : undefined;
                 return {
                     insertId: insertId !== undefined &&
                         insertId !== null &&
                         insertId.toString() !== '0'
                         ? BigInt(insertId)
                         : undefined,
-                    // TODO: remove.
-                    numUpdatedOrDeletedRows: numAffectedRows,
-                    numAffectedRows,
-                    numChangedRows,
+                    numAffectedRows: affectedRows !== undefined && affectedRows !== null
+                        ? BigInt(affectedRows)
+                        : undefined,
+                    numChangedRows: changedRows !== undefined && changedRows !== null
+                        ? BigInt(changedRows)
+                        : undefined,
                     rows: [],
                 };
             }

package/dist/cjs/dialect/postgres/postgres-driver.d.ts

@@ -1,6 +1,7 @@
 import { DatabaseConnection, QueryResult } from '../../driver/database-connection.js';
 import { Driver, TransactionSettings } from '../../driver/driver.js';
 import { CompiledQuery } from '../../query-compiler/compiled-query.js';
+import { QueryCompiler } from '../../query-compiler/query-compiler.js';
 import { PostgresCursorConstructor, PostgresDialectConfig, PostgresPoolClient } from './postgres-dialect-config.js';
 declare const PRIVATE_RELEASE_METHOD: unique symbol;
 export declare class PostgresDriver implements Driver {
@@ -29,6 +30,9 @@ export declare class PostgresDriver implements Driver {
      * Rolls back a transaction.
      */
     rollbackTransaction(connection: DatabaseConnection): Promise<void>;
+    savepoint(connection: DatabaseConnection, savepointName: string, compileQuery: QueryCompiler['compileQuery']): Promise<void>;
+    rollbackToSavepoint(connection: DatabaseConnection, savepointName: string, compileQuery: QueryCompiler['compileQuery']): Promise<void>;
+    releaseSavepoint(connection: DatabaseConnection, savepointName: string, compileQuery: QueryCompiler['compileQuery']): Promise<void>;
     /**
      * Releases a connection back to the pool.
      */

package/dist/cjs/dialect/postgres/postgres-driver.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PostgresDriver = void 0;
+const savepoint_parser_js_1 = require("../../parser/savepoint-parser.js");
 const compiled_query_js_1 = require("../../query-compiler/compiled-query.js");
 const object_utils_js_1 = require("../../util/object-utils.js");
+const query_id_js_1 = require("../../util/query-id.js");
 const stack_trace_utils_js_1 = require("../../util/stack-trace-utils.js");
 const PRIVATE_RELEASE_METHOD = Symbol();
 class PostgresDriver {
@@ -38,8 +40,15 @@ class PostgresDriver {
         return connection;
     }
     async beginTransaction(connection, settings) {
-        if (settings.isolationLevel) {
-            await connection.executeQuery(compiled_query_js_1.CompiledQuery.raw(`start transaction isolation level ${settings.isolationLevel}`));
+        if (settings.isolationLevel || settings.accessMode) {
+            let sql = 'start transaction';
+            if (settings.isolationLevel) {
+                sql += ` isolation level ${settings.isolationLevel}`;
+            }
+            if (settings.accessMode) {
+                sql += ` ${settings.accessMode}`;
+            }
+            await connection.executeQuery(compiled_query_js_1.CompiledQuery.raw(sql));
         }
         else {
             await connection.executeQuery(compiled_query_js_1.CompiledQuery.raw('begin'));
@@ -51,6 +60,15 @@ class PostgresDriver {
     async rollbackTransaction(connection) {
         await connection.executeQuery(compiled_query_js_1.CompiledQuery.raw('rollback'));
     }
+    async savepoint(connection, savepointName, compileQuery) {
+        await connection.executeQuery(compileQuery((0, savepoint_parser_js_1.parseSavepointCommand)('savepoint', savepointName), (0, query_id_js_1.createQueryId)()));
+    }
+    async rollbackToSavepoint(connection, savepointName, compileQuery) {
+        await connection.executeQuery(compileQuery((0, savepoint_parser_js_1.parseSavepointCommand)('rollback to', savepointName), (0, query_id_js_1.createQueryId)()));
+    }
+    async releaseSavepoint(connection, savepointName, compileQuery) {
+        await connection.executeQuery(compileQuery((0, savepoint_parser_js_1.parseSavepointCommand)('release', savepointName), (0, query_id_js_1.createQueryId)()));
+    }
     async releaseConnection(connection) {
         connection[PRIVATE_RELEASE_METHOD]();
     }
@@ -72,23 +90,15 @@ class PostgresConnection {
     }
     async executeQuery(compiledQuery) {
         try {
-            const result = await this.#client.query(compiledQuery.sql, [
-                ...compiledQuery.parameters,
-            ]);
-            if (result.command === 'INSERT' ||
-                result.command === 'UPDATE' ||
-                result.command === 'DELETE' ||
-                result.command === 'MERGE') {
-                const numAffectedRows = BigInt(result.rowCount);
-                return {
-                    // TODO: remove.
-                    numUpdatedOrDeletedRows: numAffectedRows,
-                    numAffectedRows,
-                    rows: result.rows ?? [],
-                };
-            }
+            const { command, rowCount, rows } = await this.#client.query(compiledQuery.sql, [...compiledQuery.parameters]);
             return {
-                rows: result.rows ?? [],
+                numAffectedRows: command === 'INSERT' ||
+                    command === 'UPDATE' ||
+                    command === 'DELETE' ||
+                    command === 'MERGE'
+                    ? BigInt(rowCount)
+                    : undefined,
+                rows: rows ?? [],
             };
         }
         catch (err) {