kysely 0.23.4 → 0.24.0

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;