kysely 0.25.0 → 0.26.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -563
- package/dist/cjs/dialect/database-introspector.d.ts +1 -1
- package/dist/cjs/dialect/mysql/mysql-dialect-config.d.ts +2 -2
- package/dist/cjs/dialect/mysql/mysql-driver.js +5 -1
- package/dist/cjs/dialect/postgres/postgres-dialect-config.d.ts +1 -1
- package/dist/cjs/dialect/postgres/postgres-introspector.js +1 -4
- package/dist/cjs/dialect/sqlite/sqlite-introspector.js +1 -1
- package/dist/cjs/driver/database-connection.d.ts +6 -0
- package/dist/cjs/driver/driver.d.ts +1 -1
- package/dist/cjs/expression/expression-builder.d.ts +207 -108
- package/dist/cjs/expression/expression-builder.js +28 -7
- package/dist/cjs/expression/expression-wrapper.d.ts +296 -5
- package/dist/cjs/expression/expression-wrapper.js +70 -2
- package/dist/cjs/helpers/postgres.d.ts +30 -18
- package/dist/cjs/helpers/postgres.js +30 -18
- package/dist/cjs/index.d.ts +6 -0
- package/dist/cjs/index.js +6 -0
- package/dist/cjs/kysely.d.ts +23 -13
- package/dist/cjs/kysely.js +13 -9
- package/dist/cjs/migration/file-migration-provider.js +2 -2
- package/dist/cjs/operation-node/alter-column-node.d.ts +2 -3
- package/dist/cjs/operation-node/alter-column-node.js +2 -7
- package/dist/cjs/operation-node/alter-table-node.d.ts +2 -2
- package/dist/cjs/operation-node/column-definition-node.d.ts +1 -1
- package/dist/cjs/operation-node/constraint-node.d.ts +1 -1
- package/dist/cjs/operation-node/create-index-node.d.ts +2 -2
- package/dist/cjs/operation-node/create-schema-node.d.ts +1 -1
- package/dist/cjs/operation-node/create-table-node.d.ts +2 -2
- package/dist/cjs/operation-node/create-type-node.d.ts +1 -1
- package/dist/cjs/operation-node/create-view-node.d.ts +1 -1
- package/dist/cjs/operation-node/data-type-node.d.ts +2 -2
- package/dist/cjs/operation-node/drop-constraint-node.d.ts +1 -1
- package/dist/cjs/operation-node/drop-index-node.d.ts +1 -1
- package/dist/cjs/operation-node/drop-schema-node.d.ts +1 -1
- package/dist/cjs/operation-node/drop-table-node.d.ts +1 -1
- package/dist/cjs/operation-node/drop-type-node.d.ts +1 -1
- package/dist/cjs/operation-node/drop-view-node.d.ts +1 -1
- package/dist/cjs/operation-node/foreign-key-constraint-node.d.ts +1 -1
- package/dist/cjs/operation-node/generated-node.d.ts +1 -1
- package/dist/cjs/operation-node/insert-query-node.d.ts +1 -1
- package/dist/cjs/operation-node/join-node.d.ts +1 -2
- package/dist/cjs/operation-node/join-node.js +0 -8
- package/dist/cjs/operation-node/json-operator-chain-node.d.ts +16 -0
- package/dist/cjs/operation-node/json-operator-chain-node.js +25 -0
- package/dist/cjs/operation-node/json-path-leg-node.d.ts +14 -0
- package/dist/cjs/operation-node/json-path-leg-node.js +19 -0
- package/dist/cjs/operation-node/json-path-node.d.ts +16 -0
- package/dist/cjs/operation-node/json-path-node.js +25 -0
- package/dist/cjs/operation-node/json-reference-node.d.ts +17 -0
- package/dist/cjs/operation-node/json-reference-node.js +25 -0
- package/dist/cjs/operation-node/on-conflict-node.d.ts +1 -1
- package/dist/cjs/operation-node/on-duplicate-key-node.d.ts +1 -1
- package/dist/cjs/operation-node/operation-node-transformer.d.ts +8 -0
- package/dist/cjs/operation-node/operation-node-transformer.js +33 -1
- package/dist/cjs/operation-node/operation-node-visitor.d.ts +8 -0
- package/dist/cjs/operation-node/operation-node-visitor.js +4 -0
- package/dist/cjs/operation-node/operation-node.d.ts +1 -1
- package/dist/cjs/operation-node/operator-node.d.ts +13 -9
- package/dist/cjs/operation-node/operator-node.js +12 -2
- package/dist/cjs/operation-node/query-node.d.ts +9 -10
- package/dist/cjs/operation-node/query-node.js +0 -8
- package/dist/cjs/operation-node/reference-node.d.ts +2 -2
- package/dist/cjs/operation-node/reference-node.js +1 -1
- package/dist/cjs/operation-node/references-node.d.ts +1 -1
- package/dist/cjs/operation-node/select-modifier-node.d.ts +1 -1
- package/dist/cjs/operation-node/select-query-node.d.ts +0 -1
- package/dist/cjs/operation-node/select-query-node.js +0 -8
- package/dist/cjs/operation-node/selection-node.d.ts +1 -1
- package/dist/cjs/operation-node/set-operation-node.d.ts +1 -1
- package/dist/cjs/operation-node/simple-reference-expression-node.d.ts +1 -1
- package/dist/cjs/operation-node/update-query-node.d.ts +1 -1
- package/dist/cjs/operation-node/values-node.d.ts +1 -1
- package/dist/cjs/operation-node/with-node.d.ts +1 -1
- package/dist/cjs/parser/binary-operation-parser.d.ts +9 -12
- package/dist/cjs/parser/binary-operation-parser.js +40 -119
- package/dist/cjs/parser/coalesce-parser.d.ts +1 -1
- package/dist/cjs/parser/data-type-parser.d.ts +1 -1
- package/dist/cjs/parser/default-value-parser.d.ts +1 -1
- package/dist/cjs/parser/expression-parser.d.ts +5 -5
- package/dist/cjs/parser/group-by-parser.d.ts +2 -2
- package/dist/cjs/parser/insert-values-parser.d.ts +4 -4
- package/dist/cjs/parser/join-parser.d.ts +4 -4
- package/dist/cjs/parser/order-by-parser.d.ts +3 -3
- package/dist/cjs/parser/partition-by-parser.d.ts +2 -2
- package/dist/cjs/parser/reference-parser.d.ts +13 -9
- package/dist/cjs/parser/reference-parser.js +28 -16
- package/dist/cjs/parser/returning-parser.d.ts +2 -2
- package/dist/cjs/parser/select-parser.d.ts +10 -10
- package/dist/cjs/parser/table-parser.d.ts +12 -12
- package/dist/cjs/parser/unary-operation-parser.d.ts +1 -1
- package/dist/cjs/parser/update-set-parser.d.ts +3 -3
- package/dist/cjs/parser/update-set-parser.js +1 -3
- package/dist/cjs/parser/value-parser.d.ts +4 -4
- package/dist/cjs/parser/with-parser.d.ts +12 -8
- package/dist/cjs/plugin/camel-case/camel-case.d.ts +1 -1
- package/dist/cjs/plugin/parse-json-results/parse-json-results-plugin.d.ts +42 -0
- package/dist/cjs/plugin/parse-json-results/parse-json-results-plugin.js +32 -0
- package/dist/cjs/plugin/with-schema/with-schema-transformer.js +22 -6
- package/dist/cjs/query-builder/aggregate-function-builder.d.ts +5 -38
- package/dist/cjs/query-builder/aggregate-function-builder.js +4 -59
- package/dist/cjs/query-builder/case-builder.d.ts +11 -11
- package/dist/cjs/query-builder/case-builder.js +2 -2
- package/dist/cjs/query-builder/delete-query-builder.d.ts +110 -62
- package/dist/cjs/query-builder/delete-query-builder.js +1 -62
- package/dist/cjs/query-builder/delete-result.d.ts +1 -2
- package/dist/cjs/query-builder/delete-result.js +2 -8
- package/dist/cjs/query-builder/function-module.d.ts +44 -66
- package/dist/cjs/query-builder/having-interface.d.ts +2 -35
- package/dist/cjs/query-builder/insert-query-builder.d.ts +59 -48
- package/dist/cjs/query-builder/insert-query-builder.js +17 -34
- package/dist/cjs/query-builder/insert-result.d.ts +3 -4
- package/dist/cjs/query-builder/insert-result.js +5 -14
- package/dist/cjs/query-builder/join-builder.d.ts +2 -35
- package/dist/cjs/query-builder/join-builder.js +1 -56
- package/dist/cjs/query-builder/json-path-builder.d.ts +212 -0
- package/dist/cjs/query-builder/json-path-builder.js +191 -0
- package/dist/cjs/query-builder/no-result-error.d.ts +1 -1
- package/dist/cjs/query-builder/on-conflict-builder.d.ts +194 -77
- package/dist/cjs/query-builder/on-conflict-builder.js +2 -111
- package/dist/cjs/query-builder/over-builder.d.ts +2 -2
- package/dist/cjs/query-builder/over-builder.js +1 -1
- package/dist/cjs/query-builder/returning-interface.d.ts +1 -1
- package/dist/cjs/query-builder/select-query-builder.d.ts +169 -141
- package/dist/cjs/query-builder/select-query-builder.js +27 -136
- package/dist/cjs/query-builder/update-query-builder.d.ts +147 -66
- package/dist/cjs/query-builder/update-query-builder.js +3 -63
- package/dist/cjs/query-builder/update-result.d.ts +3 -3
- package/dist/cjs/query-builder/update-result.js +5 -9
- package/dist/cjs/query-builder/where-interface.d.ts +98 -40
- package/dist/cjs/query-compiler/compiled-query.d.ts +1 -1
- package/dist/cjs/query-compiler/compiled-query.js +2 -2
- package/dist/cjs/query-compiler/default-query-compiler.d.ts +8 -0
- package/dist/cjs/query-compiler/default-query-compiler.js +37 -2
- package/dist/cjs/query-compiler/query-compiler.d.ts +1 -1
- package/dist/cjs/query-creator.d.ts +4 -2
- package/dist/cjs/schema/alter-column-builder.d.ts +11 -5
- package/dist/cjs/schema/alter-column-builder.js +19 -21
- package/dist/cjs/schema/alter-table-builder.d.ts +0 -4
- package/dist/cjs/schema/alter-table-builder.js +2 -9
- package/dist/cjs/schema/column-definition-builder.d.ts +1 -1
- package/dist/cjs/schema/column-definition-builder.js +1 -2
- package/dist/cjs/schema/create-index-builder.js +1 -1
- package/dist/cjs/schema/create-table-builder.d.ts +2 -6
- package/dist/cjs/schema/create-table-builder.js +0 -6
- package/dist/cjs/schema/schema.d.ts +1 -2
- package/dist/cjs/schema/schema.js +1 -2
- package/dist/cjs/util/column-type.d.ts +22 -18
- package/dist/cjs/util/explainable.d.ts +1 -1
- package/dist/cjs/util/infer-result.d.ts +2 -2
- package/dist/cjs/util/log.d.ts +4 -4
- package/dist/cjs/util/require-all-props.d.ts +1 -1
- package/dist/cjs/util/type-utils.d.ts +19 -19
- package/dist/esm/dialect/database-introspector.d.ts +1 -1
- package/dist/esm/dialect/mysql/mysql-dialect-config.d.ts +2 -2
- package/dist/esm/dialect/mysql/mysql-driver.js +5 -1
- package/dist/esm/dialect/postgres/postgres-dialect-config.d.ts +1 -1
- package/dist/esm/dialect/postgres/postgres-introspector.js +1 -4
- package/dist/esm/dialect/sqlite/sqlite-introspector.js +1 -1
- package/dist/esm/driver/database-connection.d.ts +6 -0
- package/dist/esm/driver/driver.d.ts +1 -1
- package/dist/esm/expression/expression-builder.d.ts +207 -108
- package/dist/esm/expression/expression-builder.js +30 -9
- package/dist/esm/expression/expression-wrapper.d.ts +296 -5
- package/dist/esm/expression/expression-wrapper.js +67 -1
- package/dist/esm/helpers/postgres.d.ts +30 -18
- package/dist/esm/helpers/postgres.js +30 -18
- package/dist/esm/index.d.ts +6 -0
- package/dist/esm/index.js +6 -0
- package/dist/esm/kysely.d.ts +23 -13
- package/dist/esm/kysely.js +13 -9
- package/dist/esm/operation-node/alter-column-node.d.ts +2 -3
- package/dist/esm/operation-node/alter-column-node.js +2 -7
- package/dist/esm/operation-node/alter-table-node.d.ts +2 -2
- package/dist/esm/operation-node/column-definition-node.d.ts +1 -1
- package/dist/esm/operation-node/constraint-node.d.ts +1 -1
- package/dist/esm/operation-node/create-index-node.d.ts +2 -2
- package/dist/esm/operation-node/create-schema-node.d.ts +1 -1
- package/dist/esm/operation-node/create-table-node.d.ts +2 -2
- package/dist/esm/operation-node/create-type-node.d.ts +1 -1
- package/dist/esm/operation-node/create-view-node.d.ts +1 -1
- package/dist/esm/operation-node/data-type-node.d.ts +2 -2
- package/dist/esm/operation-node/drop-constraint-node.d.ts +1 -1
- package/dist/esm/operation-node/drop-index-node.d.ts +1 -1
- package/dist/esm/operation-node/drop-schema-node.d.ts +1 -1
- package/dist/esm/operation-node/drop-table-node.d.ts +1 -1
- package/dist/esm/operation-node/drop-type-node.d.ts +1 -1
- package/dist/esm/operation-node/drop-view-node.d.ts +1 -1
- package/dist/esm/operation-node/foreign-key-constraint-node.d.ts +1 -1
- package/dist/esm/operation-node/generated-node.d.ts +1 -1
- package/dist/esm/operation-node/insert-query-node.d.ts +1 -1
- package/dist/esm/operation-node/join-node.d.ts +1 -2
- package/dist/esm/operation-node/join-node.js +0 -8
- package/dist/esm/operation-node/json-operator-chain-node.d.ts +16 -0
- package/dist/esm/operation-node/json-operator-chain-node.js +23 -0
- package/dist/esm/operation-node/json-path-leg-node.d.ts +14 -0
- package/dist/esm/operation-node/json-path-leg-node.js +17 -0
- package/dist/esm/operation-node/json-path-node.d.ts +16 -0
- package/dist/esm/operation-node/json-path-node.js +23 -0
- package/dist/esm/operation-node/json-reference-node.d.ts +17 -0
- package/dist/esm/operation-node/json-reference-node.js +23 -0
- package/dist/esm/operation-node/on-conflict-node.d.ts +1 -1
- package/dist/esm/operation-node/on-duplicate-key-node.d.ts +1 -1
- package/dist/esm/operation-node/operation-node-transformer.d.ts +8 -0
- package/dist/esm/operation-node/operation-node-transformer.js +33 -1
- package/dist/esm/operation-node/operation-node-visitor.d.ts +8 -0
- package/dist/esm/operation-node/operation-node-visitor.js +4 -0
- package/dist/esm/operation-node/operation-node.d.ts +1 -1
- package/dist/esm/operation-node/operator-node.d.ts +13 -9
- package/dist/esm/operation-node/operator-node.js +10 -1
- package/dist/esm/operation-node/query-node.d.ts +9 -10
- package/dist/esm/operation-node/query-node.js +0 -8
- package/dist/esm/operation-node/reference-node.d.ts +2 -2
- package/dist/esm/operation-node/reference-node.js +1 -1
- package/dist/esm/operation-node/references-node.d.ts +1 -1
- package/dist/esm/operation-node/select-modifier-node.d.ts +1 -1
- package/dist/esm/operation-node/select-query-node.d.ts +0 -1
- package/dist/esm/operation-node/select-query-node.js +0 -8
- package/dist/esm/operation-node/selection-node.d.ts +1 -1
- package/dist/esm/operation-node/set-operation-node.d.ts +1 -1
- package/dist/esm/operation-node/simple-reference-expression-node.d.ts +1 -1
- package/dist/esm/operation-node/update-query-node.d.ts +1 -1
- package/dist/esm/operation-node/values-node.d.ts +1 -1
- package/dist/esm/operation-node/with-node.d.ts +1 -1
- package/dist/esm/parser/binary-operation-parser.d.ts +9 -12
- package/dist/esm/parser/binary-operation-parser.js +38 -114
- package/dist/esm/parser/coalesce-parser.d.ts +1 -1
- package/dist/esm/parser/data-type-parser.d.ts +1 -1
- package/dist/esm/parser/default-value-parser.d.ts +1 -1
- package/dist/esm/parser/expression-parser.d.ts +5 -5
- package/dist/esm/parser/group-by-parser.d.ts +2 -2
- package/dist/esm/parser/insert-values-parser.d.ts +4 -4
- package/dist/esm/parser/join-parser.d.ts +4 -4
- package/dist/esm/parser/order-by-parser.d.ts +3 -3
- package/dist/esm/parser/partition-by-parser.d.ts +2 -2
- package/dist/esm/parser/reference-parser.d.ts +13 -9
- package/dist/esm/parser/reference-parser.js +26 -15
- package/dist/esm/parser/returning-parser.d.ts +2 -2
- package/dist/esm/parser/select-parser.d.ts +10 -10
- package/dist/esm/parser/table-parser.d.ts +12 -12
- package/dist/esm/parser/unary-operation-parser.d.ts +1 -1
- package/dist/esm/parser/update-set-parser.d.ts +3 -3
- package/dist/esm/parser/update-set-parser.js +2 -4
- package/dist/esm/parser/value-parser.d.ts +4 -4
- package/dist/esm/parser/with-parser.d.ts +12 -8
- package/dist/esm/plugin/camel-case/camel-case.d.ts +1 -1
- package/dist/esm/plugin/parse-json-results/parse-json-results-plugin.d.ts +42 -0
- package/dist/esm/plugin/parse-json-results/parse-json-results-plugin.js +29 -0
- package/dist/esm/plugin/with-schema/with-schema-transformer.js +22 -6
- package/dist/esm/query-builder/aggregate-function-builder.d.ts +5 -38
- package/dist/esm/query-builder/aggregate-function-builder.js +5 -60
- package/dist/esm/query-builder/case-builder.d.ts +11 -11
- package/dist/esm/query-builder/case-builder.js +3 -3
- package/dist/esm/query-builder/delete-query-builder.d.ts +110 -62
- package/dist/esm/query-builder/delete-query-builder.js +2 -63
- package/dist/esm/query-builder/delete-result.d.ts +1 -2
- package/dist/esm/query-builder/delete-result.js +2 -8
- package/dist/esm/query-builder/function-module.d.ts +44 -66
- package/dist/esm/query-builder/having-interface.d.ts +2 -35
- package/dist/esm/query-builder/insert-query-builder.d.ts +59 -48
- package/dist/esm/query-builder/insert-query-builder.js +17 -34
- package/dist/esm/query-builder/insert-result.d.ts +3 -4
- package/dist/esm/query-builder/insert-result.js +5 -14
- package/dist/esm/query-builder/join-builder.d.ts +2 -35
- package/dist/esm/query-builder/join-builder.js +2 -57
- package/dist/esm/query-builder/json-path-builder.d.ts +212 -0
- package/dist/esm/query-builder/json-path-builder.js +186 -0
- package/dist/esm/query-builder/no-result-error.d.ts +1 -1
- package/dist/esm/query-builder/on-conflict-builder.d.ts +194 -77
- package/dist/esm/query-builder/on-conflict-builder.js +3 -112
- package/dist/esm/query-builder/over-builder.d.ts +2 -2
- package/dist/esm/query-builder/over-builder.js +1 -1
- package/dist/esm/query-builder/returning-interface.d.ts +1 -1
- package/dist/esm/query-builder/select-query-builder.d.ts +169 -141
- package/dist/esm/query-builder/select-query-builder.js +28 -137
- package/dist/esm/query-builder/update-query-builder.d.ts +147 -66
- package/dist/esm/query-builder/update-query-builder.js +4 -64
- package/dist/esm/query-builder/update-result.d.ts +3 -3
- package/dist/esm/query-builder/update-result.js +5 -9
- package/dist/esm/query-builder/where-interface.d.ts +98 -40
- package/dist/esm/query-compiler/compiled-query.d.ts +1 -1
- package/dist/esm/query-compiler/compiled-query.js +2 -2
- package/dist/esm/query-compiler/default-query-compiler.d.ts +8 -0
- package/dist/esm/query-compiler/default-query-compiler.js +37 -2
- package/dist/esm/query-compiler/query-compiler.d.ts +1 -1
- package/dist/esm/query-creator.d.ts +4 -2
- package/dist/esm/schema/alter-column-builder.d.ts +11 -5
- package/dist/esm/schema/alter-column-builder.js +19 -21
- package/dist/esm/schema/alter-table-builder.d.ts +0 -4
- package/dist/esm/schema/alter-table-builder.js +2 -9
- package/dist/esm/schema/column-definition-builder.d.ts +1 -1
- package/dist/esm/schema/column-definition-builder.js +1 -2
- package/dist/esm/schema/create-index-builder.js +2 -2
- package/dist/esm/schema/create-table-builder.d.ts +2 -6
- package/dist/esm/schema/create-table-builder.js +0 -6
- package/dist/esm/schema/schema.d.ts +1 -2
- package/dist/esm/schema/schema.js +1 -2
- package/dist/esm/util/column-type.d.ts +22 -18
- package/dist/esm/util/explainable.d.ts +1 -1
- package/dist/esm/util/infer-result.d.ts +2 -2
- package/dist/esm/util/log.d.ts +4 -4
- package/dist/esm/util/require-all-props.d.ts +1 -1
- package/dist/esm/util/type-utils.d.ts +19 -19
- package/package.json +25 -23
- package/dist/cjs/query-builder/deprecated-having-expression-builder.d.ts +0 -62
- package/dist/cjs/query-builder/deprecated-having-expression-builder.js +0 -2
- package/dist/cjs/query-builder/deprecated-on-expression-builder.d.ts +0 -62
- package/dist/cjs/query-builder/deprecated-on-expression-builder.js +0 -2
- package/dist/cjs/query-builder/deprecated-where-expression-builder.d.ts +0 -62
- package/dist/cjs/query-builder/deprecated-where-expression-builder.js +0 -2
- package/dist/esm/query-builder/deprecated-having-expression-builder.d.ts +0 -62
- package/dist/esm/query-builder/deprecated-having-expression-builder.js +0 -2
- package/dist/esm/query-builder/deprecated-on-expression-builder.d.ts +0 -62
- package/dist/esm/query-builder/deprecated-on-expression-builder.js +0 -2
- package/dist/esm/query-builder/deprecated-where-expression-builder.d.ts +0 -62
- package/dist/esm/query-builder/deprecated-where-expression-builder.js +0 -2
|
@@ -4,7 +4,6 @@ import { OverBuilder } from './over-builder.js';
|
|
|
4
4
|
import { AliasedExpression, Expression } from '../expression/expression.js';
|
|
5
5
|
import { ReferenceExpression } from '../parser/reference-parser.js';
|
|
6
6
|
import { ComparisonOperatorExpression, OperandValueExpressionOrList } from '../parser/binary-operation-parser.js';
|
|
7
|
-
import { ExistsExpression } from '../parser/unary-operation-parser.js';
|
|
8
7
|
import { WhereExpressionFactory } from './where-interface.js';
|
|
9
8
|
export declare class AggregateFunctionBuilder<DB, TB extends keyof DB, O = unknown> implements Expression<O> {
|
|
10
9
|
#private;
|
|
@@ -37,7 +36,7 @@ export declare class AggregateFunctionBuilder<DB, TB extends keyof DB, O = unkno
|
|
|
37
36
|
* const result = await db
|
|
38
37
|
* .selectFrom('person')
|
|
39
38
|
* .select(
|
|
40
|
-
* eb => eb.fn.count<number>('id').as('person_count')
|
|
39
|
+
* (eb) => eb.fn.count<number>('id').as('person_count')
|
|
41
40
|
* )
|
|
42
41
|
* .executeTakeFirstOrThrow()
|
|
43
42
|
*
|
|
@@ -80,7 +79,7 @@ export declare class AggregateFunctionBuilder<DB, TB extends keyof DB, O = unkno
|
|
|
80
79
|
*
|
|
81
80
|
* Similar to {@link WhereInterface}'s `where` method.
|
|
82
81
|
*
|
|
83
|
-
* Also see {@link
|
|
82
|
+
* Also see {@link filterWhereRef}.
|
|
84
83
|
*
|
|
85
84
|
* ### Examples
|
|
86
85
|
*
|
|
@@ -119,14 +118,6 @@ export declare class AggregateFunctionBuilder<DB, TB extends keyof DB, O = unkno
|
|
|
119
118
|
filterWhere<RE extends ReferenceExpression<DB, TB>>(lhs: RE, op: ComparisonOperatorExpression, rhs: OperandValueExpressionOrList<DB, TB, RE>): AggregateFunctionBuilder<DB, TB, O>;
|
|
120
119
|
filterWhere(factory: WhereExpressionFactory<DB, TB>): AggregateFunctionBuilder<DB, TB, O>;
|
|
121
120
|
filterWhere(expression: Expression<any>): AggregateFunctionBuilder<DB, TB, O>;
|
|
122
|
-
/**
|
|
123
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
124
|
-
*/
|
|
125
|
-
filterWhereExists(arg: ExistsExpression<DB, TB>): AggregateFunctionBuilder<DB, TB, O>;
|
|
126
|
-
/**
|
|
127
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
128
|
-
*/
|
|
129
|
-
filterWhereNotExists(arg: ExistsExpression<DB, TB>): AggregateFunctionBuilder<DB, TB, O>;
|
|
130
121
|
/**
|
|
131
122
|
* Adds a `filter` clause with a nested `where` clause after the function, where
|
|
132
123
|
* both sides of the operator are references to columns.
|
|
@@ -160,30 +151,6 @@ export declare class AggregateFunctionBuilder<DB, TB extends keyof DB, O = unkno
|
|
|
160
151
|
* ```
|
|
161
152
|
*/
|
|
162
153
|
filterWhereRef(lhs: ReferenceExpression<DB, TB>, op: ComparisonOperatorExpression, rhs: ReferenceExpression<DB, TB>): AggregateFunctionBuilder<DB, TB, O>;
|
|
163
|
-
/**
|
|
164
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
165
|
-
*/
|
|
166
|
-
orFilterWhere<RE extends ReferenceExpression<DB, TB>>(lhs: RE, op: ComparisonOperatorExpression, rhs: OperandValueExpressionOrList<DB, TB, RE>): AggregateFunctionBuilder<DB, TB, O>;
|
|
167
|
-
/**
|
|
168
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
169
|
-
*/
|
|
170
|
-
orFilterWhere(factory: WhereExpressionFactory<DB, TB>): AggregateFunctionBuilder<DB, TB, O>;
|
|
171
|
-
/**
|
|
172
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
173
|
-
*/
|
|
174
|
-
orFilterWhere(expression: Expression<any>): AggregateFunctionBuilder<DB, TB, O>;
|
|
175
|
-
/**
|
|
176
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
177
|
-
*/
|
|
178
|
-
orFilterWhereExists(arg: ExistsExpression<DB, TB>): AggregateFunctionBuilder<DB, TB, O>;
|
|
179
|
-
/**
|
|
180
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
181
|
-
*/
|
|
182
|
-
orFilterWhereNotExists(arg: ExistsExpression<DB, TB>): AggregateFunctionBuilder<DB, TB, O>;
|
|
183
|
-
/**
|
|
184
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
185
|
-
*/
|
|
186
|
-
orFilterWhereRef(lhs: ReferenceExpression<DB, TB>, op: ComparisonOperatorExpression, rhs: ReferenceExpression<DB, TB>): AggregateFunctionBuilder<DB, TB, O>;
|
|
187
154
|
/**
|
|
188
155
|
* Adds an `over` clause (window functions) after the function.
|
|
189
156
|
*
|
|
@@ -193,7 +160,7 @@ export declare class AggregateFunctionBuilder<DB, TB extends keyof DB, O = unkno
|
|
|
193
160
|
* const result = await db
|
|
194
161
|
* .selectFrom('person')
|
|
195
162
|
* .select(
|
|
196
|
-
* eb => eb.fn.avg<number>('age').over().as('average_age')
|
|
163
|
+
* (eb) => eb.fn.avg<number>('age').over().as('average_age')
|
|
197
164
|
* )
|
|
198
165
|
* .execute()
|
|
199
166
|
* ```
|
|
@@ -212,7 +179,7 @@ export declare class AggregateFunctionBuilder<DB, TB extends keyof DB, O = unkno
|
|
|
212
179
|
* const result = await db
|
|
213
180
|
* .selectFrom('person')
|
|
214
181
|
* .select(
|
|
215
|
-
* eb => eb.fn.avg<number>('age').over(
|
|
182
|
+
* (eb) => eb.fn.avg<number>('age').over(
|
|
216
183
|
* ob => ob.partitionBy('last_name').orderBy('first_name', 'asc')
|
|
217
184
|
* ).as('average_age')
|
|
218
185
|
* )
|
|
@@ -272,4 +239,4 @@ export declare class AliasedAggregateFunctionBuilder<DB, TB extends keyof DB, O
|
|
|
272
239
|
export interface AggregateFunctionBuilderProps {
|
|
273
240
|
aggregateFunctionNode: AggregateFunctionNode;
|
|
274
241
|
}
|
|
275
|
-
export
|
|
242
|
+
export type OverBuilderCallback<DB, TB extends keyof DB> = (builder: OverBuilder<DB, TB>) => OverBuilder<DB, TB>;
|
|
@@ -8,7 +8,6 @@ const identifier_node_js_1 = require("../operation-node/identifier-node.js");
|
|
|
8
8
|
const prevent_await_js_1 = require("../util/prevent-await.js");
|
|
9
9
|
const parse_utils_js_1 = require("../parser/parse-utils.js");
|
|
10
10
|
const binary_operation_parser_js_1 = require("../parser/binary-operation-parser.js");
|
|
11
|
-
const unary_operation_parser_js_1 = require("../parser/unary-operation-parser.js");
|
|
12
11
|
class AggregateFunctionBuilder {
|
|
13
12
|
#props;
|
|
14
13
|
constructor(props) {
|
|
@@ -28,7 +27,7 @@ class AggregateFunctionBuilder {
|
|
|
28
27
|
* const result = await db
|
|
29
28
|
* .selectFrom('person')
|
|
30
29
|
* .select(
|
|
31
|
-
* eb => eb.fn.count<number>('id').as('person_count')
|
|
30
|
+
* (eb) => eb.fn.count<number>('id').as('person_count')
|
|
32
31
|
* )
|
|
33
32
|
* .executeTakeFirstOrThrow()
|
|
34
33
|
*
|
|
@@ -76,25 +75,7 @@ class AggregateFunctionBuilder {
|
|
|
76
75
|
filterWhere(...args) {
|
|
77
76
|
return new AggregateFunctionBuilder({
|
|
78
77
|
...this.#props,
|
|
79
|
-
aggregateFunctionNode: aggregate_function_node_js_1.AggregateFunctionNode.cloneWithFilter(this.#props.aggregateFunctionNode, (0, binary_operation_parser_js_1.
|
|
80
|
-
});
|
|
81
|
-
}
|
|
82
|
-
/**
|
|
83
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
84
|
-
*/
|
|
85
|
-
filterWhereExists(arg) {
|
|
86
|
-
return new AggregateFunctionBuilder({
|
|
87
|
-
...this.#props,
|
|
88
|
-
aggregateFunctionNode: aggregate_function_node_js_1.AggregateFunctionNode.cloneWithFilter(this.#props.aggregateFunctionNode, (0, unary_operation_parser_js_1.parseExists)(arg)),
|
|
89
|
-
});
|
|
90
|
-
}
|
|
91
|
-
/**
|
|
92
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
93
|
-
*/
|
|
94
|
-
filterWhereNotExists(arg) {
|
|
95
|
-
return new AggregateFunctionBuilder({
|
|
96
|
-
...this.#props,
|
|
97
|
-
aggregateFunctionNode: aggregate_function_node_js_1.AggregateFunctionNode.cloneWithFilter(this.#props.aggregateFunctionNode, (0, unary_operation_parser_js_1.parseNotExists)(arg)),
|
|
78
|
+
aggregateFunctionNode: aggregate_function_node_js_1.AggregateFunctionNode.cloneWithFilter(this.#props.aggregateFunctionNode, (0, binary_operation_parser_js_1.parseFilter)(args)),
|
|
98
79
|
});
|
|
99
80
|
}
|
|
100
81
|
/**
|
|
@@ -135,42 +116,6 @@ class AggregateFunctionBuilder {
|
|
|
135
116
|
aggregateFunctionNode: aggregate_function_node_js_1.AggregateFunctionNode.cloneWithFilter(this.#props.aggregateFunctionNode, (0, binary_operation_parser_js_1.parseReferentialComparison)(lhs, op, rhs)),
|
|
136
117
|
});
|
|
137
118
|
}
|
|
138
|
-
/**
|
|
139
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
140
|
-
*/
|
|
141
|
-
orFilterWhere(...args) {
|
|
142
|
-
return new AggregateFunctionBuilder({
|
|
143
|
-
...this.#props,
|
|
144
|
-
aggregateFunctionNode: aggregate_function_node_js_1.AggregateFunctionNode.cloneWithOrFilter(this.#props.aggregateFunctionNode, (0, binary_operation_parser_js_1.parseWhere)(args)),
|
|
145
|
-
});
|
|
146
|
-
}
|
|
147
|
-
/**
|
|
148
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
149
|
-
*/
|
|
150
|
-
orFilterWhereExists(arg) {
|
|
151
|
-
return new AggregateFunctionBuilder({
|
|
152
|
-
...this.#props,
|
|
153
|
-
aggregateFunctionNode: aggregate_function_node_js_1.AggregateFunctionNode.cloneWithOrFilter(this.#props.aggregateFunctionNode, (0, unary_operation_parser_js_1.parseExists)(arg)),
|
|
154
|
-
});
|
|
155
|
-
}
|
|
156
|
-
/**
|
|
157
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
158
|
-
*/
|
|
159
|
-
orFilterWhereNotExists(arg) {
|
|
160
|
-
return new AggregateFunctionBuilder({
|
|
161
|
-
...this.#props,
|
|
162
|
-
aggregateFunctionNode: aggregate_function_node_js_1.AggregateFunctionNode.cloneWithOrFilter(this.#props.aggregateFunctionNode, (0, unary_operation_parser_js_1.parseNotExists)(arg)),
|
|
163
|
-
});
|
|
164
|
-
}
|
|
165
|
-
/**
|
|
166
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
167
|
-
*/
|
|
168
|
-
orFilterWhereRef(lhs, op, rhs) {
|
|
169
|
-
return new AggregateFunctionBuilder({
|
|
170
|
-
...this.#props,
|
|
171
|
-
aggregateFunctionNode: aggregate_function_node_js_1.AggregateFunctionNode.cloneWithOrFilter(this.#props.aggregateFunctionNode, (0, binary_operation_parser_js_1.parseReferentialComparison)(lhs, op, rhs)),
|
|
172
|
-
});
|
|
173
|
-
}
|
|
174
119
|
/**
|
|
175
120
|
* Adds an `over` clause (window functions) after the function.
|
|
176
121
|
*
|
|
@@ -180,7 +125,7 @@ class AggregateFunctionBuilder {
|
|
|
180
125
|
* const result = await db
|
|
181
126
|
* .selectFrom('person')
|
|
182
127
|
* .select(
|
|
183
|
-
* eb => eb.fn.avg<number>('age').over().as('average_age')
|
|
128
|
+
* (eb) => eb.fn.avg<number>('age').over().as('average_age')
|
|
184
129
|
* )
|
|
185
130
|
* .execute()
|
|
186
131
|
* ```
|
|
@@ -199,7 +144,7 @@ class AggregateFunctionBuilder {
|
|
|
199
144
|
* const result = await db
|
|
200
145
|
* .selectFrom('person')
|
|
201
146
|
* .select(
|
|
202
|
-
* eb => eb.fn.avg<number>('age').over(
|
|
147
|
+
* (eb) => eb.fn.avg<number>('age').over(
|
|
203
148
|
* ob => ob.partitionBy('last_name').orderBy('first_name', 'asc')
|
|
204
149
|
* ).as('average_age')
|
|
205
150
|
* )
|
|
@@ -31,7 +31,7 @@ export declare class CaseThenBuilder<DB, TB extends keyof DB, W, O> {
|
|
|
31
31
|
then<O2>(expression: Expression<O2>): CaseWhenBuilder<DB, TB, W, O | O2>;
|
|
32
32
|
then<V>(value: V): CaseWhenBuilder<DB, TB, W, O | V>;
|
|
33
33
|
}
|
|
34
|
-
export declare class CaseWhenBuilder<DB, TB extends keyof DB, W, O> implements Whenable<DB, TB, W, O>, Endable<O | null> {
|
|
34
|
+
export declare class CaseWhenBuilder<DB, TB extends keyof DB, W, O> implements Whenable<DB, TB, W, O>, Endable<DB, TB, O | null> {
|
|
35
35
|
#private;
|
|
36
36
|
constructor(props: CaseBuilderProps);
|
|
37
37
|
/**
|
|
@@ -47,24 +47,24 @@ export declare class CaseWhenBuilder<DB, TB extends keyof DB, W, O> implements W
|
|
|
47
47
|
*
|
|
48
48
|
* An `else` call must be followed by an {@link Endable.end} or {@link Endable.endCase} call.
|
|
49
49
|
*/
|
|
50
|
-
else<O2>(expression: Expression<O2>): CaseEndBuilder<O | O2>;
|
|
51
|
-
else<V>(value: V): CaseEndBuilder<O | V>;
|
|
50
|
+
else<O2>(expression: Expression<O2>): CaseEndBuilder<DB, TB, O | O2>;
|
|
51
|
+
else<V>(value: V): CaseEndBuilder<DB, TB, O | V>;
|
|
52
52
|
/**
|
|
53
53
|
* Adds an `end` keyword to the case operator.
|
|
54
54
|
*
|
|
55
55
|
* `case` operators can only be used as part of a query.
|
|
56
56
|
* For a `case` statement used as part of a stored program, use {@link endCase} instead.
|
|
57
57
|
*/
|
|
58
|
-
end(): ExpressionWrapper<O | null>;
|
|
58
|
+
end(): ExpressionWrapper<DB, TB, O | null>;
|
|
59
59
|
/**
|
|
60
60
|
* Adds `end case` keywords to the case statement.
|
|
61
61
|
*
|
|
62
62
|
* `case` statements can only be used for flow control in stored programs.
|
|
63
63
|
* For a `case` operator used as part of a query, use {@link end} instead.
|
|
64
64
|
*/
|
|
65
|
-
endCase(): ExpressionWrapper<O | null>;
|
|
65
|
+
endCase(): ExpressionWrapper<DB, TB, O | null>;
|
|
66
66
|
}
|
|
67
|
-
export declare class CaseEndBuilder<O> implements Endable<O> {
|
|
67
|
+
export declare class CaseEndBuilder<DB, TB extends keyof DB, O> implements Endable<DB, TB, O> {
|
|
68
68
|
#private;
|
|
69
69
|
constructor(props: CaseBuilderProps);
|
|
70
70
|
/**
|
|
@@ -73,14 +73,14 @@ export declare class CaseEndBuilder<O> implements Endable<O> {
|
|
|
73
73
|
* `case` operators can only be used as part of a query.
|
|
74
74
|
* For a `case` statement used as part of a stored program, use {@link endCase} instead.
|
|
75
75
|
*/
|
|
76
|
-
end(): ExpressionWrapper<O>;
|
|
76
|
+
end(): ExpressionWrapper<DB, TB, O>;
|
|
77
77
|
/**
|
|
78
78
|
* Adds `end case` keywords to the case statement.
|
|
79
79
|
*
|
|
80
80
|
* `case` statements can only be used for flow control in stored programs.
|
|
81
81
|
* For a `case` operator used as part of a query, use {@link end} instead.
|
|
82
82
|
*/
|
|
83
|
-
endCase(): ExpressionWrapper<O>;
|
|
83
|
+
endCase(): ExpressionWrapper<DB, TB, O>;
|
|
84
84
|
}
|
|
85
85
|
interface Whenable<DB, TB extends keyof DB, W, O> {
|
|
86
86
|
/**
|
|
@@ -92,20 +92,20 @@ interface Whenable<DB, TB extends keyof DB, W, O> {
|
|
|
92
92
|
when(expression: Expression<W>): CaseThenBuilder<DB, TB, W, O>;
|
|
93
93
|
when(value: unknown extends W ? KyselyTypeError<'when(value) is only supported when using case(value)'> : W): CaseThenBuilder<DB, TB, W, O>;
|
|
94
94
|
}
|
|
95
|
-
interface Endable<O> {
|
|
95
|
+
interface Endable<DB, TB extends keyof DB, O> {
|
|
96
96
|
/**
|
|
97
97
|
* Adds an `end` keyword to the case operator.
|
|
98
98
|
*
|
|
99
99
|
* `case` operators can only be used as part of a query.
|
|
100
100
|
* For a `case` statement used as part of a stored program, use {@link endCase} instead.
|
|
101
101
|
*/
|
|
102
|
-
end(): ExpressionWrapper<O>;
|
|
102
|
+
end(): ExpressionWrapper<DB, TB, O>;
|
|
103
103
|
/**
|
|
104
104
|
* Adds `end case` keywords to the case statement.
|
|
105
105
|
*
|
|
106
106
|
* `case` statements can only be used for flow control in stored programs.
|
|
107
107
|
* For a `case` operator used as part of a query, use {@link end} instead.
|
|
108
108
|
*/
|
|
109
|
-
endCase(): ExpressionWrapper<O>;
|
|
109
|
+
endCase(): ExpressionWrapper<DB, TB, O>;
|
|
110
110
|
}
|
|
111
111
|
export {};
|
|
@@ -15,7 +15,7 @@ class CaseBuilder {
|
|
|
15
15
|
when(...args) {
|
|
16
16
|
return new CaseThenBuilder({
|
|
17
17
|
...this.#props,
|
|
18
|
-
node: case_node_js_1.CaseNode.cloneWithWhen(this.#props.node, when_node_js_1.WhenNode.create((0, binary_operation_parser_js_1.
|
|
18
|
+
node: case_node_js_1.CaseNode.cloneWithWhen(this.#props.node, when_node_js_1.WhenNode.create((0, binary_operation_parser_js_1.parseFilter)(args))),
|
|
19
19
|
});
|
|
20
20
|
}
|
|
21
21
|
}
|
|
@@ -41,7 +41,7 @@ class CaseWhenBuilder {
|
|
|
41
41
|
when(...args) {
|
|
42
42
|
return new CaseThenBuilder({
|
|
43
43
|
...this.#props,
|
|
44
|
-
node: case_node_js_1.CaseNode.cloneWithWhen(this.#props.node, when_node_js_1.WhenNode.create((0, binary_operation_parser_js_1.
|
|
44
|
+
node: case_node_js_1.CaseNode.cloneWithWhen(this.#props.node, when_node_js_1.WhenNode.create((0, binary_operation_parser_js_1.parseFilter)(args))),
|
|
45
45
|
});
|
|
46
46
|
}
|
|
47
47
|
else(valueExpression) {
|
|
@@ -20,7 +20,6 @@ import { OrderByDirectionExpression, OrderByExpression } from '../parser/order-b
|
|
|
20
20
|
import { Explainable, ExplainFormat } from '../util/explainable.js';
|
|
21
21
|
import { AliasedExpression, Expression } from '../expression/expression.js';
|
|
22
22
|
import { ComparisonOperatorExpression, OperandValueExpressionOrList } from '../parser/binary-operation-parser.js';
|
|
23
|
-
import { ExistsExpression } from '../parser/unary-operation-parser.js';
|
|
24
23
|
import { KyselyTypeError } from '../util/type-error.js';
|
|
25
24
|
import { Streamable } from '../util/streamable.js';
|
|
26
25
|
export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements WhereInterface<DB, TB>, ReturningInterface<DB, TB, O>, OperationNodeSource, Compilable<O>, Explainable, Streamable<O> {
|
|
@@ -35,6 +34,10 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
|
|
|
35
34
|
*
|
|
36
35
|
* ### Examples
|
|
37
36
|
*
|
|
37
|
+
* <!-- siteExample("where", "Simple where clause", 10) -->
|
|
38
|
+
*
|
|
39
|
+
* `where` method calls are combined with `AND`:
|
|
40
|
+
*
|
|
38
41
|
* ```ts
|
|
39
42
|
* const person = await db
|
|
40
43
|
* .selectFrom('person')
|
|
@@ -57,9 +60,71 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
|
|
|
57
60
|
* sql`your operator`
|
|
58
61
|
* ```
|
|
59
62
|
*
|
|
63
|
+
* <!-- siteExample("where", "Where in", 20) -->
|
|
64
|
+
*
|
|
65
|
+
* Find multiple items using a list of identifiers:
|
|
66
|
+
*
|
|
67
|
+
* ```ts
|
|
68
|
+
* const persons = await db
|
|
69
|
+
* .selectFrom('person')
|
|
70
|
+
* .selectAll()
|
|
71
|
+
* .where('id', 'in', ['1', '2', '3'])
|
|
72
|
+
* .execute()
|
|
73
|
+
* ```
|
|
74
|
+
*
|
|
75
|
+
* The generated SQL (PostgreSQL):
|
|
76
|
+
*
|
|
77
|
+
* ```sql
|
|
78
|
+
* select * from "person" where "id" in ($1, $2, $3)
|
|
79
|
+
* ```
|
|
80
|
+
*
|
|
81
|
+
* <!-- siteExample("where", "OR where", 30) -->
|
|
82
|
+
*
|
|
83
|
+
* To combine conditions using `OR`, you can use the expression builder.
|
|
84
|
+
* There are two ways to create `OR` expressions. Both are shown in this
|
|
85
|
+
* example:
|
|
86
|
+
*
|
|
87
|
+
* ```ts
|
|
88
|
+
* const persons = await db
|
|
89
|
+
* .selectFrom('person')
|
|
90
|
+
* .selectAll()
|
|
91
|
+
* // 1. Using the `or` method on the expression builder:
|
|
92
|
+
* .where((eb) => eb.or([
|
|
93
|
+
* eb('first_name', '=', 'Jennifer'),
|
|
94
|
+
* eb('first_name', '=', 'Sylvester')
|
|
95
|
+
* ]))
|
|
96
|
+
* // 2. Chaining expressions using the `or` method on the
|
|
97
|
+
* // created expressions:
|
|
98
|
+
* .where((eb) =>
|
|
99
|
+
* eb('last_name', '=', 'Aniston').or('last_name', '=', 'Stallone')
|
|
100
|
+
* )
|
|
101
|
+
* .execute()
|
|
102
|
+
* ```
|
|
103
|
+
*
|
|
104
|
+
* The generated SQL (PostgreSQL):
|
|
105
|
+
*
|
|
106
|
+
* ```sql
|
|
107
|
+
* select *
|
|
108
|
+
* from "person"
|
|
109
|
+
* where (
|
|
110
|
+
* ("first_name" = $1 or "first_name" = $2)
|
|
111
|
+
* and
|
|
112
|
+
* ("last_name" = $3 or "last_name" = $4)
|
|
113
|
+
* )
|
|
114
|
+
* ```
|
|
115
|
+
*
|
|
116
|
+
* <!-- siteExample("where", "Conditional where calls", 40) -->
|
|
117
|
+
*
|
|
60
118
|
* You can add expressions conditionally like this:
|
|
61
119
|
*
|
|
62
120
|
* ```ts
|
|
121
|
+
* import { Expression, SqlBool } from 'kysely'
|
|
122
|
+
*
|
|
123
|
+
* const firstName: string | undefined = 'Jennifer'
|
|
124
|
+
* const lastName: string | undefined = 'Aniston'
|
|
125
|
+
* const under18 = true
|
|
126
|
+
* const over60 = true
|
|
127
|
+
*
|
|
63
128
|
* let query = db
|
|
64
129
|
* .selectFrom('person')
|
|
65
130
|
* .selectAll()
|
|
@@ -74,6 +139,23 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
|
|
|
74
139
|
* query = query.where('last_name', '=', lastName)
|
|
75
140
|
* }
|
|
76
141
|
*
|
|
142
|
+
* if (under18 || over60) {
|
|
143
|
+
* // Conditional OR expressions can be added like this.
|
|
144
|
+
* query = query.where((eb) => {
|
|
145
|
+
* const ors: Expression<SqlBool>[] = []
|
|
146
|
+
*
|
|
147
|
+
* if (under18) {
|
|
148
|
+
* ors.push(eb('age', '<', 18))
|
|
149
|
+
* }
|
|
150
|
+
*
|
|
151
|
+
* if (over60) {
|
|
152
|
+
* ors.push(eb('age', '>', 60))
|
|
153
|
+
* }
|
|
154
|
+
*
|
|
155
|
+
* return eb.or(ors)
|
|
156
|
+
* })
|
|
157
|
+
* }
|
|
158
|
+
*
|
|
77
159
|
* const persons = await query.execute()
|
|
78
160
|
* ```
|
|
79
161
|
*
|
|
@@ -126,22 +208,30 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
|
|
|
126
208
|
* select * from "person" where "id" in ($1, $2, $3)
|
|
127
209
|
* ```
|
|
128
210
|
*
|
|
211
|
+
* <!-- siteExample("where", "Complex where clause", 50) -->
|
|
212
|
+
*
|
|
129
213
|
* For complex `where` expressions you can pass in a single callback and
|
|
130
|
-
* use the
|
|
214
|
+
* use the `ExpressionBuilder` to build your expression:
|
|
131
215
|
*
|
|
132
216
|
* ```ts
|
|
217
|
+
* const firstName = 'Jennifer'
|
|
218
|
+
* const maxAge = 60
|
|
219
|
+
*
|
|
133
220
|
* const persons = await db
|
|
134
221
|
* .selectFrom('person')
|
|
135
222
|
* .selectAll('person')
|
|
136
|
-
* .where(({
|
|
223
|
+
* .where(({ eb, or, and, not, exists, selectFrom }) => and([
|
|
137
224
|
* or([
|
|
138
|
-
*
|
|
139
|
-
*
|
|
225
|
+
* eb('first_name', '=', firstName),
|
|
226
|
+
* eb('age', '<', maxAge)
|
|
140
227
|
* ]),
|
|
141
228
|
* not(exists(
|
|
142
|
-
* selectFrom('pet')
|
|
229
|
+
* selectFrom('pet')
|
|
230
|
+
* .select('pet.id')
|
|
231
|
+
* .whereRef('pet.owner_id', '=', 'person.id')
|
|
143
232
|
* ))
|
|
144
233
|
* ]))
|
|
234
|
+
* .execute()
|
|
145
235
|
* ```
|
|
146
236
|
*
|
|
147
237
|
* The generated SQL (PostgreSQL):
|
|
@@ -262,32 +352,6 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
|
|
|
262
352
|
* from "person"
|
|
263
353
|
*/
|
|
264
354
|
whereRef(lhs: ReferenceExpression<DB, TB>, op: ComparisonOperatorExpression, rhs: ReferenceExpression<DB, TB>): DeleteQueryBuilder<DB, TB, O>;
|
|
265
|
-
/**
|
|
266
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
267
|
-
*/
|
|
268
|
-
orWhere<RE extends ReferenceExpression<DB, TB>>(lhs: RE, op: ComparisonOperatorExpression, rhs: OperandValueExpressionOrList<DB, TB, RE>): DeleteQueryBuilder<DB, TB, O>;
|
|
269
|
-
orWhere(factory: WhereExpressionFactory<DB, TB>): DeleteQueryBuilder<DB, TB, O>;
|
|
270
|
-
orWhere(expression: Expression<any>): DeleteQueryBuilder<DB, TB, O>;
|
|
271
|
-
/**
|
|
272
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
273
|
-
*/
|
|
274
|
-
orWhereRef(lhs: ReferenceExpression<DB, TB>, op: ComparisonOperatorExpression, rhs: ReferenceExpression<DB, TB>): DeleteQueryBuilder<DB, TB, O>;
|
|
275
|
-
/**
|
|
276
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
277
|
-
*/
|
|
278
|
-
whereExists(arg: ExistsExpression<DB, TB>): DeleteQueryBuilder<DB, TB, O>;
|
|
279
|
-
/**
|
|
280
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
281
|
-
*/
|
|
282
|
-
whereNotExists(arg: ExistsExpression<DB, TB>): DeleteQueryBuilder<DB, TB, O>;
|
|
283
|
-
/**
|
|
284
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
285
|
-
*/
|
|
286
|
-
orWhereExists(arg: ExistsExpression<DB, TB>): DeleteQueryBuilder<DB, TB, O>;
|
|
287
|
-
/**
|
|
288
|
-
* @deprecated Follow [these](https://github.com/koskimas/kysely/releases/tag/0.24.0) instructions to migrate
|
|
289
|
-
*/
|
|
290
|
-
orWhereNotExists(arg: ExistsExpression<DB, TB>): DeleteQueryBuilder<DB, TB, O>;
|
|
291
355
|
/**
|
|
292
356
|
* Clears all where expressions from the query.
|
|
293
357
|
*
|
|
@@ -560,7 +624,7 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
|
|
|
560
624
|
* first_name: 'Jennifer',
|
|
561
625
|
* last_name: 'Aniston'
|
|
562
626
|
* })
|
|
563
|
-
* .returning(eb => [
|
|
627
|
+
* .returning((eb) => [
|
|
564
628
|
* 'id as id',
|
|
565
629
|
* sql<string>`concat(first_name, ' ', last_name)`.as('full_name'),
|
|
566
630
|
* eb.selectFrom('pets').select('pet.id').limit(1).as('first_pet_id')
|
|
@@ -745,10 +809,6 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
|
|
|
745
809
|
* ```
|
|
746
810
|
*/
|
|
747
811
|
$call<T>(func: (qb: this) => T): T;
|
|
748
|
-
/**
|
|
749
|
-
* @deprecated Use `$call` instead
|
|
750
|
-
*/
|
|
751
|
-
call<T>(func: (qb: this) => T): T;
|
|
752
812
|
/**
|
|
753
813
|
* Call `func(this)` if `condition` is true.
|
|
754
814
|
*
|
|
@@ -784,11 +844,7 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
|
|
|
784
844
|
* }
|
|
785
845
|
* ```
|
|
786
846
|
*/
|
|
787
|
-
$if<O2>(condition: boolean, func: (qb: this) => DeleteQueryBuilder<
|
|
788
|
-
/**
|
|
789
|
-
* @deprecated Use `$if` instead
|
|
790
|
-
*/
|
|
791
|
-
if<O2>(condition: boolean, func: (qb: this) => DeleteQueryBuilder<DB, TB, O2>): O2 extends DeleteResult ? DeleteQueryBuilder<DB, TB, DeleteResult> : O2 extends O & infer E ? DeleteQueryBuilder<DB, TB, O & Partial<E>> : DeleteQueryBuilder<DB, TB, Partial<O2>>;
|
|
847
|
+
$if<O2>(condition: boolean, func: (qb: this) => DeleteQueryBuilder<any, any, O2>): O2 extends DeleteResult ? DeleteQueryBuilder<DB, TB, DeleteResult> : O2 extends O & infer E ? DeleteQueryBuilder<DB, TB, O & Partial<E>> : DeleteQueryBuilder<DB, TB, Partial<O2>>;
|
|
792
848
|
/**
|
|
793
849
|
* Change the output type of the query.
|
|
794
850
|
*
|
|
@@ -796,10 +852,6 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
|
|
|
796
852
|
* don't support your use case.
|
|
797
853
|
*/
|
|
798
854
|
$castTo<T>(): DeleteQueryBuilder<DB, TB, T>;
|
|
799
|
-
/**
|
|
800
|
-
* @deprecated Use `$castTo` instead.
|
|
801
|
-
*/
|
|
802
|
-
castTo<T>(): DeleteQueryBuilder<DB, TB, T>;
|
|
803
855
|
/**
|
|
804
856
|
* Narrows (parts of) the output type of the query.
|
|
805
857
|
*
|
|
@@ -884,10 +936,6 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
|
|
|
884
936
|
* ```
|
|
885
937
|
*/
|
|
886
938
|
$assertType<T extends O>(): O extends T ? DeleteQueryBuilder<DB, TB, T> : KyselyTypeError<`$assertType() call failed: The type passed in is not equal to the output type of the query.`>;
|
|
887
|
-
/**
|
|
888
|
-
* @deprecated Use `$assertType` instead.
|
|
889
|
-
*/
|
|
890
|
-
assertType<T extends O>(): O extends T ? DeleteQueryBuilder<DB, TB, T> : KyselyTypeError<`assertType() call failed: The type passed in is not equal to the output type of the query.`>;
|
|
891
939
|
/**
|
|
892
940
|
* Returns a copy of this DeleteQueryBuilder instance with the given plugin installed.
|
|
893
941
|
*/
|
|
@@ -983,24 +1031,24 @@ export interface DeleteQueryBuilderProps {
|
|
|
983
1031
|
readonly queryNode: DeleteQueryNode;
|
|
984
1032
|
readonly executor: QueryExecutor;
|
|
985
1033
|
}
|
|
986
|
-
export
|
|
987
|
-
|
|
988
|
-
|
|
1034
|
+
export type DeleteQueryBuilderWithInnerJoin<DB, TB extends keyof DB, O, TE extends TableExpression<DB, TB>> = TE extends `${infer T} as ${infer A}` ? T extends keyof DB ? InnerJoinedBuilder<DB, TB, O, A, DB[T]> : never : TE extends keyof DB ? DeleteQueryBuilder<DB, TB | TE, O> : TE extends AliasedExpression<infer QO, infer QA> ? InnerJoinedBuilder<DB, TB, O, QA, QO> : TE extends (qb: any) => AliasedExpression<infer QO, infer QA> ? InnerJoinedBuilder<DB, TB, O, QA, QO> : never;
|
|
1035
|
+
type InnerJoinedBuilder<DB, TB extends keyof DB, O, A extends string, R> = A extends keyof DB ? DeleteQueryBuilder<InnerJoinedDB<DB, A, R>, TB | A, O> : DeleteQueryBuilder<DB & ShallowRecord<A, R>, TB | A, O>;
|
|
1036
|
+
type InnerJoinedDB<DB, A extends string, R> = DrainOuterGeneric<{
|
|
989
1037
|
[C in keyof DB | A]: C extends A ? R : C extends keyof DB ? DB[C] : never;
|
|
990
1038
|
}>;
|
|
991
|
-
export
|
|
992
|
-
|
|
993
|
-
|
|
1039
|
+
export type DeleteQueryBuilderWithLeftJoin<DB, TB extends keyof DB, O, TE extends TableExpression<DB, TB>> = TE extends `${infer T} as ${infer A}` ? T extends keyof DB ? LeftJoinedBuilder<DB, TB, O, A, DB[T]> : never : TE extends keyof DB ? LeftJoinedBuilder<DB, TB, O, TE, DB[TE]> : TE extends AliasedExpression<infer QO, infer QA> ? LeftJoinedBuilder<DB, TB, O, QA, QO> : TE extends (qb: any) => AliasedExpression<infer QO, infer QA> ? LeftJoinedBuilder<DB, TB, O, QA, QO> : never;
|
|
1040
|
+
type LeftJoinedBuilder<DB, TB extends keyof DB, O, A extends keyof any, R> = A extends keyof DB ? DeleteQueryBuilder<LeftJoinedDB<DB, A, R>, TB | A, O> : DeleteQueryBuilder<DB & ShallowRecord<A, Nullable<R>>, TB | A, O>;
|
|
1041
|
+
type LeftJoinedDB<DB, A extends keyof any, R> = DrainOuterGeneric<{
|
|
994
1042
|
[C in keyof DB | A]: C extends A ? Nullable<R> : C extends keyof DB ? DB[C] : never;
|
|
995
1043
|
}>;
|
|
996
|
-
export
|
|
997
|
-
|
|
998
|
-
|
|
1044
|
+
export type DeleteQueryBuilderWithRightJoin<DB, TB extends keyof DB, O, TE extends TableExpression<DB, TB>> = TE extends `${infer T} as ${infer A}` ? T extends keyof DB ? RightJoinedBuilder<DB, TB, O, A, DB[T]> : never : TE extends keyof DB ? RightJoinedBuilder<DB, TB, O, TE, DB[TE]> : TE extends AliasedExpression<infer QO, infer QA> ? RightJoinedBuilder<DB, TB, O, QA, QO> : TE extends (qb: any) => AliasedExpression<infer QO, infer QA> ? RightJoinedBuilder<DB, TB, O, QA, QO> : never;
|
|
1045
|
+
type RightJoinedBuilder<DB, TB extends keyof DB, O, A extends keyof any, R> = DeleteQueryBuilder<RightJoinedDB<DB, TB, A, R>, TB | A, O>;
|
|
1046
|
+
type RightJoinedDB<DB, TB extends keyof DB, A extends keyof any, R> = DrainOuterGeneric<{
|
|
999
1047
|
[C in keyof DB | A]: C extends A ? R : C extends TB ? Nullable<DB[C]> : C extends keyof DB ? DB[C] : never;
|
|
1000
1048
|
}>;
|
|
1001
|
-
export
|
|
1002
|
-
|
|
1003
|
-
|
|
1049
|
+
export type DeleteQueryBuilderWithFullJoin<DB, TB extends keyof DB, O, TE extends TableExpression<DB, TB>> = TE extends `${infer T} as ${infer A}` ? T extends keyof DB ? OuterJoinedBuilder<DB, TB, O, A, DB[T]> : never : TE extends keyof DB ? OuterJoinedBuilder<DB, TB, O, TE, DB[TE]> : TE extends AliasedExpression<infer QO, infer QA> ? OuterJoinedBuilder<DB, TB, O, QA, QO> : TE extends (qb: any) => AliasedExpression<infer QO, infer QA> ? OuterJoinedBuilder<DB, TB, O, QA, QO> : never;
|
|
1050
|
+
type OuterJoinedBuilder<DB, TB extends keyof DB, O, A extends keyof any, R> = DeleteQueryBuilder<OuterJoinedBuilderDB<DB, TB, A, R>, TB | A, O>;
|
|
1051
|
+
type OuterJoinedBuilderDB<DB, TB extends keyof DB, A extends keyof any, R> = DrainOuterGeneric<{
|
|
1004
1052
|
[C in keyof DB | A]: C extends A ? Nullable<R> : C extends TB ? Nullable<DB[C]> : C extends keyof DB ? DB[C] : never;
|
|
1005
1053
|
}>;
|
|
1006
1054
|
export {};
|