kysely 0.23.5 → 0.24.0

package/dist/cjs/query-builder/insert-query-builder.js

@@ -15,14 +15,13 @@ const expression_parser_js_1 = require("../parser/expression-parser.js");
 const column_node_js_1 = require("../operation-node/column-node.js");
 const on_conflict_builder_js_1 = require("./on-conflict-builder.js");
 const on_conflict_node_js_1 = require("../operation-node/on-conflict-node.js");
-const explain_node_js_1 = require("../operation-node/explain-node.js");
 class InsertQueryBuilder {
     #props;
     constructor(props) {
         this.#props = (0, object_utils_js_1.freeze)(props);
     }
-    values(args) {
-        const [columns, values] = (0, insert_values_parser_js_1.parseInsertObjectOrList)(args);
+    values(insert) {
+        const [columns, values] = (0, insert_values_parser_js_1.parseInsertExpression)(insert);
         return new InsertQueryBuilder({
             ...this.#props,
             queryNode: insert_query_node_js_1.InsertQueryNode.cloneWith(this.#props.queryNode, {
@@ -295,18 +294,18 @@ class InsertQueryBuilder {
      *   .onDuplicateKeyUpdate({ species: 'hamster' })
      * ```
      */
-    onDuplicateKeyUpdate(updates) {
+    onDuplicateKeyUpdate(update) {
         return new InsertQueryBuilder({
             ...this.#props,
             queryNode: insert_query_node_js_1.InsertQueryNode.cloneWith(this.#props.queryNode, {
-                onDuplicateKey: on_duplicate_key_node_js_1.OnDuplicateKeyNode.create((0, update_set_parser_js_1.parseUpdateObject)(updates)),
+                onDuplicateKey: on_duplicate_key_node_js_1.OnDuplicateKeyNode.create((0, update_set_parser_js_1.parseUpdateExpression)(update)),
             }),
         });
     }
     returning(selection) {
         return new InsertQueryBuilder({
             ...this.#props,
-            queryNode: query_node_js_1.QueryNode.cloneWithReturning(this.#props.queryNode, (0, select_parser_js_1.parseSelectExpressionOrList)(selection)),
+            queryNode: query_node_js_1.QueryNode.cloneWithReturning(this.#props.queryNode, (0, select_parser_js_1.parseSelectArg)(selection)),
         });
     }
     returningAll() {
@@ -316,7 +315,8 @@ class InsertQueryBuilder {
         });
     }
     /**
-     * Simply calls the given function passing `this` as the only argument.
+     * Simply calls the provided function passing `this` as the only argument. `$call` returns
+     * what the provided function returns.
      *
      * If you want to conditionally call a method on `this`, see
      * the {@link $if} method.
@@ -442,7 +442,7 @@ class InsertQueryBuilder {
      *   )
      *   .with('new_pet', (qb) => qb
      *     .insertInto('pet')
-     *     .values({ owner_id: (eb) => eb.selectFrom('new_person').select('id'), ...pet })
+     *     .values((eb) => ({ owner_id: eb.selectFrom('new_person').select('id'), ...pet }))
      *     .returning(['name as pet_name', 'species'])
      *     .$assertType<{ pet_name: string, species: Species }>()
      *   )
@@ -506,38 +506,30 @@ class InsertQueryBuilder {
      * the query returned no result.
      *
      * By default an instance of {@link NoResultError} is thrown, but you can
-     * provide a custom error class as the only argument to throw a different
+     * provide a custom error class, or callback as the only argument to throw a different
      * error.
      */
     async executeTakeFirstOrThrow(errorConstructor = no_result_error_js_1.NoResultError) {
         const result = await this.executeTakeFirst();
         if (result === undefined) {
-            throw new errorConstructor(this.toOperationNode());
+            const error = (0, no_result_error_js_1.isNoResultErrorConstructor)(errorConstructor)
+                ? new errorConstructor(this.toOperationNode())
+                : errorConstructor(this.toOperationNode());
+            throw error;
         }
         return result;
     }
-    /**
-     * Executes query with `explain` statement before `insert` keyword.
-     *
-     * ```ts
-     * const explained = await db
-     *  .insertInto('person')
-     *  .values(values)
-     *  .explain('json')
-     * ```
-     *
-     * The generated SQL (MySQL):
-     *
-     * ```sql
-     * explain format=json insert into `person` (`id`, `first_name`, `last_name`) values (?, ?, ?) (?, ?, ?)
-     * ```
-     */
+    async *stream(chunkSize = 100) {
+        const compiledQuery = this.compile();
+        const stream = this.#props.executor.stream(compiledQuery, chunkSize, this.#props.queryId);
+        for await (const item of stream) {
+            yield* item.rows;
+        }
+    }
     async explain(format, options) {
         const builder = new InsertQueryBuilder({
             ...this.#props,
-            queryNode: insert_query_node_js_1.InsertQueryNode.cloneWith(this.#props.queryNode, {
-                explain: explain_node_js_1.ExplainNode.create(format, options?.toOperationNode()),
-            }),
+            queryNode: query_node_js_1.QueryNode.cloneWithExplain(this.#props.queryNode, format, options),
         });
         return await builder.execute();
     }

package/dist/cjs/query-builder/insert-result.js

@@ -45,3 +45,6 @@ class InsertResult {
     }
 }
 exports.InsertResult = InsertResult;
+for (const property of ['insertId', 'numInsertedOrUpdatedRows']) {
+    Object.defineProperty(InsertResult.prototype, property, { enumerable: true });
+}

package/dist/cjs/query-builder/join-builder.d.ts

@@ -4,6 +4,8 @@ import { OperationNodeSource } from '../operation-node/operation-node-source.js'
 import { ComparisonOperatorExpression, OperandValueExpressionOrList } from '../parser/binary-operation-parser.js';
 import { ReferenceExpression } from '../parser/reference-parser.js';
 import { ExistsExpression } from '../parser/unary-operation-parser.js';
+import { SqlBool } from '../util/type-utils.js';
+import { OnExpressionBuilder } from './deprecated-on-expression-builder.js';
 export declare class JoinBuilder<DB, TB extends keyof DB> implements OperationNodeSource {
     #private;
     constructor(props: JoinBuilderProps);
@@ -14,16 +16,19 @@ export declare class JoinBuilder<DB, TB extends keyof DB> implements OperationNo
      * See {@link WhereInterface.where} for documentation and examples.
      */
     on<RE extends ReferenceExpression<DB, TB>>(lhs: RE, op: ComparisonOperatorExpression, rhs: OperandValueExpressionOrList<DB, TB, RE>): JoinBuilder<DB, TB>;
-    on(grouper: (qb: JoinBuilder<DB, TB>) => JoinBuilder<DB, TB>): JoinBuilder<DB, TB>;
+    on(factory: OnExpressionFactory<DB, TB>): JoinBuilder<DB, TB>;
     on(expression: Expression<any>): JoinBuilder<DB, TB>;
     /**
-     * Just like {@link WhereInterface.orWhere} but adds an item to the join's
-     * `on` clause instead.
-     *
-     * See {@link WhereInterface.orWhere} for documentation and examples.
+     * @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
      */
     orOn<RE extends ReferenceExpression<DB, TB>>(lhs: RE, op: ComparisonOperatorExpression, rhs: OperandValueExpressionOrList<DB, TB, RE>): JoinBuilder<DB, TB>;
-    orOn(grouper: (qb: JoinBuilder<DB, TB>) => JoinBuilder<DB, TB>): JoinBuilder<DB, TB>;
+    /**
+     * @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
+     */
+    orOn(factory: OnExpressionFactory<DB, TB>): JoinBuilder<DB, TB>;
+    /**
+     * @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
+     */
     orOn(expression: Expression<any>): JoinBuilder<DB, TB>;
     /**
      * Just like {@link WhereInterface.whereRef} but adds an item to the join's
@@ -33,46 +38,38 @@ export declare class JoinBuilder<DB, TB extends keyof DB> implements OperationNo
      */
     onRef(lhs: ReferenceExpression<DB, TB>, op: ComparisonOperatorExpression, rhs: ReferenceExpression<DB, TB>): JoinBuilder<DB, TB>;
     /**
-     * Just like {@link WhereInterface.orWhereRef} but adds an item to the join's
-     * `on` clause instead.
-     *
-     * See {@link WhereInterface.orWhereRef} for documentation and examples.
+     * @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
      */
     orOnRef(lhs: ReferenceExpression<DB, TB>, op: ComparisonOperatorExpression, rhs: ReferenceExpression<DB, TB>): JoinBuilder<DB, TB>;
     /**
-     * Just like {@link WhereInterface.whereExists} but adds an item to the join's
-     * `on` clause instead.
-     *
-     * See {@link WhereInterface.whereExists} for documentation and examples.
+     * @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
      */
     onExists(arg: ExistsExpression<DB, TB>): JoinBuilder<DB, TB>;
     /**
-     * Just like {@link WhereInterface.whereNotExists} but adds an item to the join's
-     * `on` clause instead.
-     *
-     * See {@link WhereInterface.whereNotExists} for documentation and examples.
+     * @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
      */
     onNotExists(arg: ExistsExpression<DB, TB>): JoinBuilder<DB, TB>;
     /**
-     * Just like {@link WhereInterface.orWhereExists} but adds an item to the join's
-     * `on` clause instead.
-     *
-     * See {@link WhereInterface.orWhereExists} for documentation and examples.
+     * @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
      */
     orOnExists(arg: ExistsExpression<DB, TB>): JoinBuilder<DB, TB>;
     /**
-     * Just like {@link WhereInterface.orWhereNotExists} but adds an item to the join's
-     * `on` clause instead.
-     *
-     * See {@link WhereInterface.orWhereNotExists} for documentation and examples.
+     * @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
      */
     orOnNotExists(arg: ExistsExpression<DB, TB>): JoinBuilder<DB, TB>;
     /**
      * Adds `on true`.
      */
     onTrue(): JoinBuilder<DB, TB>;
+    /**
+     * Simply calls the provided function passing `this` as the only argument. `$call` returns
+     * what the provided function returns.
+     */
+    $call<T>(func: (qb: this) => T): T;
     toOperationNode(): JoinNode;
 }
 export interface JoinBuilderProps {
     readonly joinNode: JoinNode;
 }
+declare type OnExpressionFactory<DB, TB extends keyof DB> = (eb: OnExpressionBuilder<DB, TB>) => Expression<SqlBool> | OnExpressionBuilder<DB, TB>;
+export {};

package/dist/cjs/query-builder/join-builder.js

@@ -18,6 +18,9 @@ class JoinBuilder {
             joinNode: join_node_js_1.JoinNode.cloneWithOn(this.#props.joinNode, (0, binary_operation_parser_js_1.parseOn)(args)),
         });
     }
+    /**
+     * @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
+     */
     orOn(...args) {
         return new JoinBuilder({
             ...this.#props,
@@ -33,26 +36,20 @@ class JoinBuilder {
     onRef(lhs, op, rhs) {
         return new JoinBuilder({
             ...this.#props,
-            joinNode: join_node_js_1.JoinNode.cloneWithOn(this.#props.joinNode, (0, binary_operation_parser_js_1.parseReferentialFilter)(lhs, op, rhs)),
+            joinNode: join_node_js_1.JoinNode.cloneWithOn(this.#props.joinNode, (0, binary_operation_parser_js_1.parseReferentialComparison)(lhs, op, rhs)),
         });
     }
     /**
-     * Just like {@link WhereInterface.orWhereRef} but adds an item to the join's
-     * `on` clause instead.
-     *
-     * See {@link WhereInterface.orWhereRef} for documentation and examples.
+     * @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
      */
     orOnRef(lhs, op, rhs) {
         return new JoinBuilder({
             ...this.#props,
-            joinNode: join_node_js_1.JoinNode.cloneWithOrOn(this.#props.joinNode, (0, binary_operation_parser_js_1.parseReferentialFilter)(lhs, op, rhs)),
+            joinNode: join_node_js_1.JoinNode.cloneWithOrOn(this.#props.joinNode, (0, binary_operation_parser_js_1.parseReferentialComparison)(lhs, op, rhs)),
         });
     }
     /**
-     * Just like {@link WhereInterface.whereExists} but adds an item to the join's
-     * `on` clause instead.
-     *
-     * See {@link WhereInterface.whereExists} for documentation and examples.
+     * @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
      */
     onExists(arg) {
         return new JoinBuilder({
@@ -61,10 +58,7 @@ class JoinBuilder {
         });
     }
     /**
-     * Just like {@link WhereInterface.whereNotExists} but adds an item to the join's
-     * `on` clause instead.
-     *
-     * See {@link WhereInterface.whereNotExists} for documentation and examples.
+     * @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
      */
     onNotExists(arg) {
         return new JoinBuilder({
@@ -73,10 +67,7 @@ class JoinBuilder {
         });
     }
     /**
-     * Just like {@link WhereInterface.orWhereExists} but adds an item to the join's
-     * `on` clause instead.
-     *
-     * See {@link WhereInterface.orWhereExists} for documentation and examples.
+     * @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
      */
     orOnExists(arg) {
         return new JoinBuilder({
@@ -85,10 +76,7 @@ class JoinBuilder {
         });
     }
     /**
-     * Just like {@link WhereInterface.orWhereNotExists} but adds an item to the join's
-     * `on` clause instead.
-     *
-     * See {@link WhereInterface.orWhereNotExists} for documentation and examples.
+     * @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
      */
     orOnNotExists(arg) {
         return new JoinBuilder({
@@ -105,6 +93,13 @@ class JoinBuilder {
             joinNode: join_node_js_1.JoinNode.cloneWithOn(this.#props.joinNode, raw_node_js_1.RawNode.createWithSql('true')),
         });
     }
+    /**
+     * Simply calls the provided function passing `this` as the only argument. `$call` returns
+     * what the provided function returns.
+     */
+    $call(func) {
+        return func(this);
+    }
     toOperationNode() {
         return this.#props.joinNode;
     }

package/dist/cjs/query-builder/no-result-error.d.ts

@@ -7,3 +7,4 @@ export declare class NoResultError extends Error {
     readonly node: QueryNode;
     constructor(node: QueryNode);
 }
+export declare function isNoResultErrorConstructor(fn: NoResultErrorConstructor | ((node: QueryNode) => Error)): fn is NoResultErrorConstructor;

package/dist/cjs/query-builder/no-result-error.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NoResultError = void 0;
+exports.isNoResultErrorConstructor = exports.NoResultError = void 0;
 class NoResultError extends Error {
     /**
      * The operation node tree of the query that was executed.
@@ -12,3 +12,7 @@ class NoResultError extends Error {
     }
 }
 exports.NoResultError = NoResultError;
+function isNoResultErrorConstructor(fn) {
+    return Object.prototype.hasOwnProperty.call(fn, 'prototype');
+}
+exports.isNoResultErrorConstructor = isNoResultErrorConstructor;