kysely 0.30.0-beta.0 → 0.30.0-beta.2

package/dist/query-creator.d.ts

@@ -12,8 +12,17 @@ import type { SelectFrom } from './parser/select-from-parser.js';
 import type { DeleteFrom } from './parser/delete-from-parser.js';
 import type { UpdateTable } from './parser/update-parser.js';
 import type { MergeInto } from './parser/merge-into-parser.js';
+import type { IsAny } from './util/type-utils.js';
+import type { Insertable, Selectable, Updateable } from './util/column-type.js';
 export declare class QueryCreator<DB> {
     #private;
+    protected readonly '~DB': IsAny<DB> extends true ? any : {
+        [T in keyof DB]: {
+            select: () => Selectable<DB[T]>;
+            insert: (row: Insertable<DB[T]>) => void;
+            update: (row: Updateable<DB[T]>) => void;
+        };
+    };
     constructor(props: QueryCreatorProps);
     /**
      * Creates a `select` query builder for the given table or tables.

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

@@ -6,6 +6,7 @@ import type { QueryExecutorProvider } from '../query-executor/query-executor-pro
 import type { QueryId } from '../util/query-id.js';
 import type { AliasableExpression, AliasedExpression, Expression } from '../expression/expression.js';
 import type { AbortableQueryOptions } from '../util/abort.js';
+import type { StreamOptions } from '../util/streamable.js';
 /**
  * An instance of this class can be used to create raw SQL snippets or queries.
  *
@@ -181,6 +182,10 @@ export interface RawBuilder<O> extends AliasableExpression<O> {
      * ```
      */
     execute(executorProvider: QueryExecutorProvider, options?: AbortableQueryOptions): Promise<QueryResult<O>>;
+    /**
+     * Executes the raw query and streams the rows.
+     */
+    stream(executorOrProvider: QueryExecutorProvider, options?: StreamOptions | StreamOptions['chunkSize']): AsyncIterableIterator<O>;
     /**
      * Creates the OperationNode that describes how to compile this expression into SQL.
      *

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

@@ -42,6 +42,18 @@ class RawBuilderImpl {
         const executor = this.#getExecutor(executorProvider);
         return executor.executeQuery(this.#compile(executor), options);
     }
+    async *stream(executorProvider, chunkSizeOrOptions) {
+        const executor = this.#getExecutor(executorProvider);
+        if (typeof chunkSizeOrOptions !== 'object') {
+            chunkSizeOrOptions = {
+                chunkSize: chunkSizeOrOptions,
+            };
+        }
+        const stream = executor.stream(this.#compile(executor), chunkSizeOrOptions.chunkSize ?? 100, chunkSizeOrOptions);
+        for await (const item of stream) {
+            yield* item.rows;
+        }
+    }
     #getExecutor(executorProvider) {
         const executor = executorProvider !== undefined
             ? executorProvider.getExecutor()

package/dist/readonly/readonly-kysely.d.ts

@@ -5,11 +5,11 @@ import type { KyselyPlugin } from '../plugin/kysely-plugin.js';
 import type { SelectQueryBuilder } from '../query-builder/select-query-builder.js';
 import type { AbortableOperationOptions, AbortableQueryOptions } from '../util/abort.js';
 import type { KyselyTypeError } from '../util/type-error.js';
-import type { DrainOuterGeneric } from '../util/type-utils.js';
 import type { ReadonlyCompiledQuery } from './readonly-compiled-query.js';
 import type { ReadonlyQueryResult } from './readonly-database-connection.js';
 import type { ReadonlyAccessMode } from './readonly-driver.js';
 import type { ReadonlyQueryCreator } from './readonly-query-creator.js';
+export type { ReadonlyKysely, ReadonlyTransaction, ReadonlyControlledTransaction, };
 /**
  * A helper type that allows you to expose a type-level read-only {@link Kysely} version
  * to your service's consumers.
@@ -43,7 +43,13 @@ import type { ReadonlyQueryCreator } from './readonly-query-creator.js';
  * db.deleteFrom('person') // typescript compiler error!
  * ```
  */
-export interface ReadonlyKysely<DB> extends ReadonlyQueryCreator<DB>, Pick<Kysely<DB>, 'case' | 'destroy' | 'dynamic' | 'fn' | 'introspection' | 'isTransaction'> {
+declare class ReadonlyKysely<DB> extends ReadonlyQueryCreator<DB> {
+    case: Kysely<DB>['case'];
+    destroy: Kysely<DB>['destroy'];
+    get dynamic(): Kysely<DB>['dynamic'];
+    readonly fn: Kysely<DB>['fn'];
+    get introspection(): Kysely<DB>['introspection'];
+    get isTransaction(): Kysely<DB>['isTransaction'];
     /**
      * Similar to {@link Kysely.connection} but read-only.
      */
@@ -89,11 +95,11 @@ export interface ReadonlyKysely<DB> extends ReadonlyQueryCreator<DB>, Pick<Kysel
      *
      * @deprecated use {@link $extendTables} instead.
      */
-    withTables<T extends Record<string, Record<string, any>>>(): ReadonlyKysely<DrainOuterGeneric<DB & T>>;
+    withTables<T extends Record<string, Record<string, any>>>(): ReadonlyKysely<DB & T>;
     /**
      * Similar to {@link Kysely.$extendTables} but read-only.
      */
-    $extendTables<T extends Record<string, Record<string, any>>>(): ReadonlyKysely<DrainOuterGeneric<DB & T>>;
+    $extendTables<T extends Record<string, Record<string, any>>>(): ReadonlyKysely<DB & T>;
     /**
      * Similar to {@link Kysely.$omitTables} but read-only.
      */
@@ -132,7 +138,24 @@ export interface ReadonlyTransactionBuilder<DB> {
 /**
  * Similar to {@link Transaction} but read-only.
  */
-export interface ReadonlyTransaction<DB> extends Pick<ReadonlyKysely<DB>, 'case' | 'deleteFrom' | 'dynamic' | 'executeQuery' | 'fn' | 'getExecutor' | 'insertInto' | 'introspection' | 'mergeInto' | 'replaceInto' | 'schema' | 'selectFrom' | 'selectNoFrom' | 'updateTable' | 'with' | 'withRecursive'>, Pick<Transaction<DB>, 'connection' | 'destroy' | 'isTransaction' | 'startTransaction' | 'transaction'> {
+declare class ReadonlyTransaction<DB> extends ReadonlyKysely<DB> {
+    /**
+     * @deprecated calling the connection method for a Transaction is not supported
+     */
+    connection(): never;
+    /**
+     * @deprecated calling the destroy method for a Transaction is not supported
+     */
+    destroy: Transaction<DB>['destroy'];
+    get isTransaction(): true;
+    /**
+     * @deprecated calling the controlled transaction method for a Transaction is not supported
+     */
+    startTransaction(): never;
+    /**
+     * @deprecated calling the transaction method for a Transaction is not supported
+     */
+    transaction(): never;
     /**
      * Similar to {@link Transaction.withoutPlugins} but read-only.
      */
@@ -150,19 +173,32 @@ export interface ReadonlyTransaction<DB> extends Pick<ReadonlyKysely<DB>, 'case'
      *
      * @deprecated use {@link $extendTables} instead.
      */
-    withTables<T extends Record<string, Record<string, any>>>(): ReadonlyTransaction<DrainOuterGeneric<DB & T>>;
+    withTables<T extends Record<string, Record<string, any>>>(): ReadonlyTransaction<DB & T>;
+    /**
+     * Similar to {@link Kysely.withTables} but read-only.
+     *
+     * @deprecated use {@link $extendTables} instead.
+     */
+    withTables<T extends Record<string, Record<string, any>>>(): ReadonlyKysely<DB & T>;
+    withTables<T extends Record<string, Record<string, any>>>(): ReadonlyTransaction<DB & T>;
     /**
      * Similar to {@link Transaction.$extendTables} but read-only.
      */
-    $extendTables<T extends Record<string, Record<string, any>>>(): ReadonlyTransaction<DrainOuterGeneric<DB & T>>;
+    $extendTables<T extends Record<string, Record<string, any>>>(): ReadonlyTransaction<DB & T>;
+    $extendTables<T extends Record<string, Record<string, any>>>(): ReadonlyKysely<DB & T>;
+    $extendTables<T extends Record<string, Record<string, any>>>(): ReadonlyTransaction<DB & T>;
     /**
      * Similar to {@link Transaction.$omitTables} but read-only.
      */
     $omitTables<T extends keyof DB>(): ReadonlyTransaction<DB extends object ? Omit<DB, T> : DB>;
+    $omitTables<T extends keyof DB>(): ReadonlyKysely<DB extends object ? Omit<DB, T> : DB>;
+    $omitTables<T extends keyof DB>(): ReadonlyTransaction<DB extends object ? Omit<DB, T> : DB>;
     /**
      * Similar to {@link Transaction.$pickTables} but read-only.
      */
     $pickTables<T extends keyof DB>(): ReadonlyTransaction<DB extends object ? Pick<DB, T> : DB>;
+    $pickTables<T extends keyof DB>(): ReadonlyKysely<DB extends object ? Pick<DB, T> : DB>;
+    $pickTables<T extends keyof DB>(): ReadonlyTransaction<DB extends object ? Pick<DB, T> : DB>;
 }
 /**
  * Similar to {@link ControlledTransactionBuilder} but read-only.
@@ -184,7 +220,11 @@ export interface ReadonlyControlledTransactionBuilder<DB> {
 /**
  * Similar to {@link ControlledTransaction} but read-only.
  */
-export interface ReadonlyControlledTransaction<DB, S extends string[] = []> extends ReadonlyTransaction<DB>, Pick<ControlledTransaction<DB, S>, 'commit' | 'isCommitted' | 'isRolledBack' | 'rollback'> {
+declare class ReadonlyControlledTransaction<DB, S extends string[] = []> extends ReadonlyTransaction<DB> {
+    commit: ControlledTransaction<DB, S>['commit'];
+    get isCommitted(): ControlledTransaction<DB, S>['isCommitted'];
+    get isRolledBack(): ControlledTransaction<DB, S>['isRolledBack'];
+    rollback: ControlledTransaction<DB, S>['rollback'];
     /**
      * Similar to {@link ControlledTransaction.releaseSavepoint} but read-only.
      */
@@ -214,17 +254,31 @@ export interface ReadonlyControlledTransaction<DB, S extends string[] = []> exte
      *
      * @deprecated use {@link $extendTables} instead.
      */
-    withTables<T extends Record<string, Record<string, any>>>(): ReadonlyControlledTransaction<DrainOuterGeneric<DB & T>, S>;
+    withTables<T extends Record<string, Record<string, any>>>(): ReadonlyControlledTransaction<DB & T, S>;
+    /**
+     * Similar to {@link Transaction.withTables} but read-only.
+     *
+     * @deprecated use {@link $extendTables} instead.
+     */
+    withTables<T extends Record<string, Record<string, any>>>(): ReadonlyKysely<DB & T>;
+    withTables<T extends Record<string, Record<string, any>>>(): ReadonlyControlledTransaction<DB & T, S>;
     /**
      * Similar to {@link ControlledTransaction.$extendTables} but read-only.
      */
-    $extendTables<T extends Record<string, Record<string, any>>>(): ReadonlyControlledTransaction<DrainOuterGeneric<DB & T>, S>;
+    $extendTables<T extends Record<string, Record<string, any>>>(): ReadonlyControlledTransaction<DB & T, S>;
+    $extendTables<T extends Record<string, Record<string, any>>>(): ReadonlyKysely<DB & T>;
+    $extendTables<T extends Record<string, Record<string, any>>>(): ReadonlyControlledTransaction<DB & T, S>;
     /**
      * Similar to {@link ControlledTransaction.$omitTables} but read-only.
      */
     $omitTables<T extends keyof DB>(): ReadonlyControlledTransaction<DB extends object ? Omit<DB, T> : DB, S>;
+    $omitTables<T extends keyof DB>(): ReadonlyKysely<DB extends object ? Omit<DB, T> : DB>;
+    $omitTables<T extends keyof DB>(): ReadonlyTransaction<DB extends object ? Omit<DB, T> : DB>;
+    $omitTables<T extends keyof DB>(): ReadonlyControlledTransaction<DB extends object ? Omit<DB, T> : DB, S>;
     /**
      * Similar to {@link ControlledTransaction.$pickTables} but read-only.
      */
     $pickTables<T extends keyof DB>(): ReadonlyControlledTransaction<DB extends object ? Pick<DB, T> : DB, S>;
+    $pickTables<T extends keyof DB>(): ReadonlyKysely<DB extends object ? Pick<DB, T> : DB>;
+    $pickTables<T extends keyof DB>(): ReadonlyControlledTransaction<DB extends object ? Pick<DB, T> : DB, S>;
 }

package/dist/readonly/readonly-query-creator.d.ts

@@ -1,11 +1,19 @@
 import type { CTEBuilderCallback } from '../query-builder/cte-builder.js';
 import type { QueryCreator } from '../query-creator.js';
+import type { Selectable } from '../util/column-type.js';
+import type { IsAny } from '../util/type-utils.js';
 import type { KyselyTypeError } from '../util/type-error.js';
 import type { ReadonlyCommonTableExpression, ReadonlyQueryCreatorWithCommonTableExpression, ReadonlyRecursiveCommonTableExpression } from './readonly-with-parser.js';
+export type { ReadonlyQueryCreator };
 /**
  * Similar to {@link QueryCreator} but read-only.
  */
-export interface ReadonlyQueryCreator<DB> extends Pick<QueryCreator<DB>, 'selectFrom' | 'selectNoFrom'> {
+declare class ReadonlyQueryCreator<DB> {
+    protected readonly '~DB': IsAny<DB> extends true ? any : {
+        [T in keyof DB]: Selectable<DB[T]>;
+    };
+    selectFrom: QueryCreator<DB>['selectFrom'];
+    selectNoFrom: QueryCreator<DB>['selectNoFrom'];
     /**
      * @deprecated not allowed with a read-only Kysely instance.
      */

package/dist/schema/create-type-builder.d.ts

@@ -10,7 +10,7 @@ export declare class CreateTypeBuilder implements OperationNodeSource, Compilabl
     constructor(props: CreateTypeBuilderProps);
     toOperationNode(): CreateTypeNode;
     /**
-     * Creates an anum type.
+     * Creates an enum type.
      *
      * ### Examples
      *

package/dist/schema/create-type-builder.js

@@ -10,7 +10,7 @@ export class CreateTypeBuilder {
         return this.#props.executor.transformQuery(this.#props.node, this.#props.queryId);
     }
     /**
-     * Creates an anum type.
+     * Creates an enum type.
      *
      * ### Examples
      *

package/dist/util/abort.js

@@ -8,6 +8,7 @@ export function getInflightQueryAbortHandler(abortStrategy = 'ignore query', con
     if (abortStrategy === 'cancel query') {
         const handler = connection.cancelQuery;
         if (!handler) {
+            beforeThrow();
             throwUnsupportedInflightQueryAbortStrategyError(abortStrategy, connection.killSession ? 'kill session' : undefined);
         }
         return handler.bind(connection);
@@ -15,6 +16,7 @@ export function getInflightQueryAbortHandler(abortStrategy = 'ignore query', con
     if (abortStrategy === 'kill session') {
         const handler = connection.killSession;
         if (!handler) {
+            beforeThrow();
             throwUnsupportedInflightQueryAbortStrategyError(abortStrategy, connection.cancelQuery ? 'cancel query' : undefined);
         }
         return handler.bind(connection);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kysely",
-  "version": "0.30.0-beta.0",
+  "version": "0.30.0-beta.2",
   "description": "Type safe SQL query builder",
   "repository": {
     "type": "git",
@@ -63,39 +63,40 @@
   "devDependencies": {
     "@arethetypeswrong/cli": "0.18.5",
     "@electric-sql/pglite": "0.5.4",
-    "@types/better-sqlite3": "7.6.13",
+    "@types/better-sqlite3": "9.6.0",
     "@types/chai": "5.2.3",
     "@types/chai-as-promised": "8.0.2",
     "@types/mocha": "10.0.10",
-    "@types/node": "26.1.1",
-    "@types/pg": "8.20.0",
+    "@types/node": "26.2.0",
+    "@types/pg": "8.21.0",
     "@types/pg-cursor": "2.7.2",
     "@types/prototype-pollution-vulnerable-lodash.merge-dont-upgrade": "npm:@types/lodash.merge@4.6.1",
-    "@types/semver": "7.7.1",
+    "@types/semver": "7.8.0",
     "@types/sinon": "22.0.0",
-    "better-sqlite3": "12.11.1",
+    "better-sqlite3": "13.0.3",
     "chai": "6.2.2",
     "chai-as-promised": "8.0.2",
-    "esbuild": "0.28.1",
+    "esbuild": "0.28.2",
     "jsr": "0.14.3",
-    "mocha": "11.7.6",
-    "mysql2": "3.23.0",
+    "mocha": "11.8.0",
+    "mysql2": "3.23.3",
     "pathe": "2.0.3",
-    "pg": "8.22.0",
-    "pg-cursor": "2.21.0",
-    "playwright": "1.61.1",
-    "prettier": "3.9.5",
+    "pg": "8.23.0",
+    "pg-cursor": "2.22.0",
+    "playwright": "1.62.1",
+    "prettier": "3.9.6",
     "prototype-pollution-vulnerable-lodash.merge-dont-upgrade": "npm:lodash.merge@4.6.1",
     "remeda": "2.39.0",
     "semver": "7.8.5",
-    "sinon": "22.0.0",
+    "sinon": "22.1.0",
     "std-env": "4.2.0",
     "tarn": "3.1.2",
     "tedious": "20.0.0",
     "tsd": "0.33.0",
-    "tsx": "4.23.1",
+    "tsx": "4.23.12",
     "typescript": "7.0.2",
-    "typescript-6": "npm:typescript@6.0.3"
+    "typescript-6": "npm:typescript@6.0.3",
+    "vitest": "5.0.0"
   },
   "scripts": {
     "clean": "rm -rf dist & rm -rf test/node/dist & rm -rf test/browser/bundle.js",
@@ -110,6 +111,7 @@
     "test:cloudflare-workers": "pnpm build && pnpm -r test --filter kysely-cloudflare-workers-test",
     "test:deno": "deno run --allow-env --allow-read --allow-net --no-lock test/deno/test.ts",
     "test:typings": "tsd test/typings",
+    "test:typings:vitest": "vitest run --config test/typings/vitest.config.ts",
     "test:esmimports": "node scripts/check-esm-imports.cjs",
     "test:esbuild": "esbuild --bundle --platform=node --external:pg-native dist/index.js --outfile=/dev/null",
     "test:exports": "attw --profile esm-only --pack . && node scripts/check-exports.cjs",