kysely 0.23.4 → 0.24.0
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 +49 -25
- package/dist/cjs/dialect/database-introspector.d.ts +4 -2
- package/dist/cjs/dialect/mysql/mysql-adapter.js +2 -2
- package/dist/cjs/dialect/mysql/mysql-driver.d.ts +1 -1
- package/dist/cjs/dialect/mysql/mysql-driver.js +1 -1
- package/dist/cjs/dialect/mysql/mysql-introspector.d.ts +1 -1
- package/dist/cjs/dialect/mysql/mysql-introspector.js +19 -13
- package/dist/cjs/dialect/postgres/postgres-adapter.js +1 -1
- package/dist/cjs/dialect/postgres/postgres-introspector.d.ts +1 -1
- package/dist/cjs/dialect/postgres/postgres-introspector.js +3 -1
- package/dist/cjs/dialect/sqlite/sqlite-dialect.d.ts +1 -0
- package/dist/cjs/dialect/sqlite/sqlite-dialect.js +1 -0
- package/dist/cjs/dialect/sqlite/sqlite-introspector.d.ts +1 -1
- package/dist/cjs/dialect/sqlite/sqlite-introspector.js +6 -5
- package/dist/cjs/driver/runtime-driver.js +4 -2
- package/dist/cjs/expression/expression-builder.d.ts +386 -0
- package/dist/cjs/expression/expression-builder.js +92 -0
- package/dist/cjs/expression/expression-wrapper.d.ts +92 -0
- package/dist/cjs/expression/expression-wrapper.js +54 -0
- package/dist/cjs/expression/expression.d.ts +1 -1
- package/dist/cjs/helpers/postgres.d.ts +133 -0
- package/dist/cjs/helpers/postgres.js +141 -0
- package/dist/cjs/index.d.ts +4 -3
- package/dist/cjs/index.js +4 -2
- package/dist/cjs/kysely.d.ts +10 -0
- package/dist/cjs/kysely.js +12 -1
- package/dist/cjs/migration/file-migration-provider.d.ts +5 -2
- package/dist/cjs/migration/migrator.d.ts +5 -2
- package/dist/cjs/operation-node/aggregate-function-node.d.ts +3 -2
- package/dist/cjs/operation-node/aggregate-function-node.js +2 -2
- package/dist/cjs/operation-node/create-index-node.d.ts +2 -0
- package/dist/cjs/operation-node/delete-query-node.d.ts +1 -2
- package/dist/cjs/operation-node/delete-query-node.js +2 -8
- package/dist/cjs/operation-node/function-node.d.ts +13 -0
- package/dist/cjs/operation-node/function-node.js +19 -0
- package/dist/cjs/operation-node/operation-node-transformer.d.ts +2 -0
- package/dist/cjs/operation-node/operation-node-transformer.js +11 -2
- package/dist/cjs/operation-node/operation-node-visitor.d.ts +2 -0
- package/dist/cjs/operation-node/operation-node-visitor.js +1 -0
- package/dist/cjs/operation-node/operation-node.d.ts +1 -1
- package/dist/cjs/operation-node/operator-node.d.ts +13 -2
- package/dist/cjs/operation-node/operator-node.js +38 -3
- package/dist/cjs/operation-node/query-node.d.ts +25 -8
- package/dist/cjs/operation-node/query-node.js +9 -2
- package/dist/cjs/operation-node/select-query-node.d.ts +0 -1
- package/dist/cjs/operation-node/select-query-node.js +0 -6
- package/dist/cjs/operation-node/update-query-node.d.ts +0 -1
- package/dist/cjs/operation-node/update-query-node.js +0 -6
- package/dist/cjs/parser/binary-operation-parser.d.ts +9 -10
- package/dist/cjs/parser/binary-operation-parser.js +89 -39
- package/dist/cjs/parser/coalesce-parser.d.ts +0 -2
- package/dist/cjs/parser/coalesce-parser.js +0 -9
- package/dist/cjs/parser/expression-parser.d.ts +7 -3
- package/dist/cjs/parser/expression-parser.js +4 -4
- package/dist/cjs/parser/group-by-parser.d.ts +3 -2
- package/dist/cjs/parser/group-by-parser.js +3 -0
- package/dist/cjs/parser/insert-values-parser.d.ts +4 -1
- package/dist/cjs/parser/insert-values-parser.js +19 -13
- package/dist/cjs/parser/join-parser.js +1 -1
- package/dist/cjs/parser/parse-utils.d.ts +0 -2
- package/dist/cjs/parser/parse-utils.js +1 -8
- package/dist/cjs/parser/returning-parser.d.ts +2 -1
- package/dist/cjs/parser/select-parser.d.ts +5 -13
- package/dist/cjs/parser/select-parser.js +8 -4
- package/dist/cjs/parser/table-parser.d.ts +6 -3
- package/dist/cjs/parser/unary-operation-parser.d.ts +5 -2
- package/dist/cjs/parser/unary-operation-parser.js +9 -8
- package/dist/cjs/parser/update-set-parser.d.ts +4 -1
- package/dist/cjs/parser/update-set-parser.js +9 -4
- package/dist/cjs/parser/value-parser.d.ts +5 -0
- package/dist/cjs/parser/value-parser.js +1 -3
- package/dist/cjs/plugin/camel-case/camel-case-plugin.d.ts +7 -0
- package/dist/cjs/plugin/camel-case/camel-case-plugin.js +10 -4
- package/dist/cjs/plugin/deduplicate-joins/deduplicate-joins-plugin.d.ts +1 -1
- package/dist/cjs/plugin/deduplicate-joins/deduplicate-joins-plugin.js +1 -1
- package/dist/cjs/query-builder/aggregate-function-builder.d.ts +40 -113
- package/dist/cjs/query-builder/aggregate-function-builder.js +23 -63
- package/dist/cjs/query-builder/delete-query-builder.d.ts +224 -205
- package/dist/cjs/query-builder/delete-query-builder.js +21 -27
- package/dist/cjs/query-builder/delete-result.js +3 -0
- package/dist/cjs/query-builder/deprecated-having-expression-builder.d.ts +62 -0
- package/dist/cjs/query-builder/deprecated-having-expression-builder.js +2 -0
- package/dist/cjs/query-builder/deprecated-on-expression-builder.d.ts +62 -0
- package/dist/cjs/query-builder/deprecated-on-expression-builder.js +2 -0
- package/dist/cjs/query-builder/deprecated-where-expression-builder.d.ts +62 -0
- package/dist/cjs/query-builder/deprecated-where-expression-builder.js +2 -0
- package/dist/cjs/query-builder/function-module.d.ts +304 -42
- package/dist/cjs/query-builder/function-module.js +44 -208
- package/dist/cjs/query-builder/having-interface.d.ts +19 -16
- package/dist/cjs/query-builder/insert-query-builder.d.ts +78 -30
- package/dist/cjs/query-builder/insert-query-builder.js +21 -30
- package/dist/cjs/query-builder/insert-result.js +3 -0
- package/dist/cjs/query-builder/join-builder.d.ts +23 -26
- package/dist/cjs/query-builder/join-builder.js +17 -22
- package/dist/cjs/query-builder/no-result-error.d.ts +1 -0
- package/dist/cjs/query-builder/no-result-error.js +5 -1
- package/dist/cjs/query-builder/on-conflict-builder.d.ts +158 -276
- package/dist/cjs/query-builder/on-conflict-builder.js +52 -36
- package/dist/cjs/query-builder/over-builder.d.ts +5 -0
- package/dist/cjs/query-builder/over-builder.js +7 -0
- package/dist/cjs/query-builder/returning-interface.d.ts +2 -2
- package/dist/cjs/query-builder/select-query-builder.d.ts +155 -243
- package/dist/cjs/query-builder/select-query-builder.js +333 -78
- package/dist/cjs/query-builder/update-query-builder.d.ts +149 -217
- package/dist/cjs/query-builder/update-query-builder.js +21 -115
- package/dist/cjs/query-builder/update-result.js +3 -0
- package/dist/cjs/query-builder/where-interface.d.ts +71 -184
- package/dist/cjs/query-compiler/default-query-compiler.d.ts +3 -0
- package/dist/cjs/query-compiler/default-query-compiler.js +18 -2
- package/dist/cjs/query-creator.d.ts +38 -2
- package/dist/cjs/query-creator.js +3 -45
- package/dist/cjs/query-executor/query-executor.d.ts +3 -3
- package/dist/cjs/raw-builder/raw-builder.d.ts +5 -3
- package/dist/cjs/raw-builder/raw-builder.js +13 -7
- package/dist/cjs/raw-builder/sql.d.ts +17 -9
- package/dist/cjs/raw-builder/sql.js +8 -2
- package/dist/cjs/schema/alter-column-builder.d.ts +5 -0
- package/dist/cjs/schema/alter-column-builder.js +7 -0
- package/dist/cjs/schema/alter-table-add-foreign-key-constraint-builder.d.ts +5 -0
- package/dist/cjs/schema/alter-table-add-foreign-key-constraint-builder.js +7 -0
- package/dist/cjs/schema/alter-table-drop-constraint-builder.d.ts +5 -0
- package/dist/cjs/schema/alter-table-drop-constraint-builder.js +7 -0
- package/dist/cjs/schema/column-definition-builder.d.ts +6 -1
- package/dist/cjs/schema/column-definition-builder.js +8 -1
- package/dist/cjs/schema/create-index-builder.d.ts +51 -9
- package/dist/cjs/schema/create-index-builder.js +17 -0
- package/dist/cjs/schema/create-schema-builder.d.ts +5 -0
- package/dist/cjs/schema/create-schema-builder.js +7 -0
- package/dist/cjs/schema/create-table-builder.d.ts +3 -1
- package/dist/cjs/schema/create-table-builder.js +3 -1
- package/dist/cjs/schema/create-type-builder.d.ts +5 -0
- package/dist/cjs/schema/create-type-builder.js +7 -0
- package/dist/cjs/schema/create-view-builder.d.ts +5 -0
- package/dist/cjs/schema/create-view-builder.js +7 -0
- package/dist/cjs/schema/drop-index-builder.d.ts +5 -0
- package/dist/cjs/schema/drop-index-builder.js +7 -0
- package/dist/cjs/schema/drop-schema-builder.d.ts +5 -0
- package/dist/cjs/schema/drop-schema-builder.js +7 -0
- package/dist/cjs/schema/drop-table-builder.d.ts +5 -0
- package/dist/cjs/schema/drop-table-builder.js +7 -0
- package/dist/cjs/schema/drop-type-builder.d.ts +5 -0
- package/dist/cjs/schema/drop-type-builder.js +7 -0
- package/dist/cjs/schema/drop-view-builder.d.ts +5 -0
- package/dist/cjs/schema/drop-view-builder.js +7 -0
- package/dist/cjs/schema/foreign-key-constraint-builder.d.ts +5 -0
- package/dist/cjs/schema/foreign-key-constraint-builder.js +7 -0
- package/dist/cjs/util/compilable.d.ts +1 -0
- package/dist/cjs/util/compilable.js +6 -0
- package/dist/cjs/util/explainable.d.ts +35 -0
- package/dist/cjs/util/log.d.ts +2 -0
- package/dist/cjs/util/object-utils.js +1 -1
- package/dist/cjs/util/streamable.d.ts +29 -0
- package/dist/cjs/util/streamable.js +2 -0
- package/dist/cjs/util/type-utils.d.ts +6 -4
- package/dist/esm/dialect/database-introspector.d.ts +4 -2
- package/dist/esm/dialect/mysql/mysql-adapter.js +2 -2
- package/dist/esm/dialect/mysql/mysql-driver.d.ts +1 -1
- package/dist/esm/dialect/mysql/mysql-driver.js +1 -1
- package/dist/esm/dialect/mysql/mysql-introspector.d.ts +1 -1
- package/dist/esm/dialect/mysql/mysql-introspector.js +19 -13
- package/dist/esm/dialect/postgres/postgres-adapter.js +1 -1
- package/dist/esm/dialect/postgres/postgres-introspector.d.ts +1 -1
- package/dist/esm/dialect/postgres/postgres-introspector.js +3 -1
- package/dist/esm/dialect/sqlite/sqlite-dialect.d.ts +1 -0
- package/dist/esm/dialect/sqlite/sqlite-dialect.js +1 -0
- package/dist/esm/dialect/sqlite/sqlite-introspector.d.ts +1 -1
- package/dist/esm/dialect/sqlite/sqlite-introspector.js +6 -5
- package/dist/esm/driver/runtime-driver.js +4 -2
- package/dist/esm/expression/expression-builder.d.ts +386 -0
- package/dist/esm/expression/expression-builder.js +88 -0
- package/dist/esm/expression/expression-wrapper.d.ts +92 -0
- package/dist/esm/expression/expression-wrapper.js +50 -0
- package/dist/esm/expression/expression.d.ts +1 -1
- package/dist/esm/helpers/postgres.d.ts +133 -0
- package/dist/esm/helpers/postgres.js +136 -0
- package/dist/esm/index.d.ts +4 -3
- package/dist/esm/index.js +2 -1
- package/dist/esm/kysely.d.ts +10 -0
- package/dist/esm/kysely.js +13 -2
- package/dist/esm/migration/file-migration-provider.d.ts +5 -2
- package/dist/esm/migration/migrator.d.ts +5 -2
- package/dist/esm/operation-node/aggregate-function-node.d.ts +3 -2
- package/dist/esm/operation-node/aggregate-function-node.js +2 -2
- package/dist/esm/operation-node/create-index-node.d.ts +2 -0
- package/dist/esm/operation-node/delete-query-node.d.ts +1 -2
- package/dist/esm/operation-node/delete-query-node.js +2 -8
- package/dist/esm/operation-node/function-node.d.ts +13 -0
- package/dist/esm/operation-node/function-node.js +17 -0
- package/dist/esm/operation-node/operation-node-transformer.d.ts +2 -0
- package/dist/esm/operation-node/operation-node-transformer.js +11 -2
- package/dist/esm/operation-node/operation-node-visitor.d.ts +2 -0
- package/dist/esm/operation-node/operation-node-visitor.js +1 -0
- package/dist/esm/operation-node/operation-node.d.ts +1 -1
- package/dist/esm/operation-node/operator-node.d.ts +13 -2
- package/dist/esm/operation-node/operator-node.js +34 -3
- package/dist/esm/operation-node/query-node.d.ts +25 -8
- package/dist/esm/operation-node/query-node.js +9 -2
- package/dist/esm/operation-node/select-query-node.d.ts +0 -1
- package/dist/esm/operation-node/select-query-node.js +0 -6
- package/dist/esm/operation-node/update-query-node.d.ts +0 -1
- package/dist/esm/operation-node/update-query-node.js +0 -6
- package/dist/esm/parser/binary-operation-parser.d.ts +9 -10
- package/dist/esm/parser/binary-operation-parser.js +85 -37
- package/dist/esm/parser/coalesce-parser.d.ts +0 -2
- package/dist/esm/parser/coalesce-parser.js +1 -7
- package/dist/esm/parser/expression-parser.d.ts +7 -3
- package/dist/esm/parser/expression-parser.js +5 -5
- package/dist/esm/parser/group-by-parser.d.ts +3 -2
- package/dist/esm/parser/group-by-parser.js +3 -0
- package/dist/esm/parser/insert-values-parser.d.ts +4 -1
- package/dist/esm/parser/insert-values-parser.js +18 -12
- package/dist/esm/parser/join-parser.js +2 -2
- package/dist/esm/parser/parse-utils.d.ts +0 -2
- package/dist/esm/parser/parse-utils.js +0 -6
- package/dist/esm/parser/returning-parser.d.ts +2 -1
- package/dist/esm/parser/select-parser.d.ts +5 -13
- package/dist/esm/parser/select-parser.js +7 -3
- package/dist/esm/parser/table-parser.d.ts +6 -3
- package/dist/esm/parser/unary-operation-parser.d.ts +5 -2
- package/dist/esm/parser/unary-operation-parser.js +8 -8
- package/dist/esm/parser/update-set-parser.d.ts +4 -1
- package/dist/esm/parser/update-set-parser.js +7 -2
- package/dist/esm/parser/value-parser.d.ts +5 -0
- package/dist/esm/parser/value-parser.js +1 -3
- package/dist/esm/plugin/camel-case/camel-case-plugin.d.ts +7 -0
- package/dist/esm/plugin/camel-case/camel-case-plugin.js +10 -4
- package/dist/esm/plugin/deduplicate-joins/deduplicate-joins-plugin.d.ts +1 -1
- package/dist/esm/plugin/deduplicate-joins/deduplicate-joins-plugin.js +1 -1
- package/dist/esm/query-builder/aggregate-function-builder.d.ts +40 -113
- package/dist/esm/query-builder/aggregate-function-builder.js +24 -64
- package/dist/esm/query-builder/delete-query-builder.d.ts +224 -205
- package/dist/esm/query-builder/delete-query-builder.js +24 -30
- package/dist/esm/query-builder/delete-result.js +3 -0
- package/dist/esm/query-builder/deprecated-having-expression-builder.d.ts +62 -0
- package/dist/esm/query-builder/deprecated-having-expression-builder.js +2 -0
- package/dist/esm/query-builder/deprecated-on-expression-builder.d.ts +62 -0
- package/dist/esm/query-builder/deprecated-on-expression-builder.js +2 -0
- package/dist/esm/query-builder/deprecated-where-expression-builder.d.ts +62 -0
- package/dist/esm/query-builder/deprecated-where-expression-builder.js +2 -0
- package/dist/esm/query-builder/function-module.d.ts +304 -42
- package/dist/esm/query-builder/function-module.js +43 -207
- package/dist/esm/query-builder/having-interface.d.ts +19 -16
- package/dist/esm/query-builder/insert-query-builder.d.ts +78 -30
- package/dist/esm/query-builder/insert-query-builder.js +25 -34
- package/dist/esm/query-builder/insert-result.js +3 -0
- package/dist/esm/query-builder/join-builder.d.ts +23 -26
- package/dist/esm/query-builder/join-builder.js +18 -23
- package/dist/esm/query-builder/no-result-error.d.ts +1 -0
- package/dist/esm/query-builder/no-result-error.js +3 -0
- package/dist/esm/query-builder/on-conflict-builder.d.ts +158 -276
- package/dist/esm/query-builder/on-conflict-builder.js +54 -38
- package/dist/esm/query-builder/over-builder.d.ts +5 -0
- package/dist/esm/query-builder/over-builder.js +7 -0
- package/dist/esm/query-builder/returning-interface.d.ts +2 -2
- package/dist/esm/query-builder/select-query-builder.d.ts +155 -243
- package/dist/esm/query-builder/select-query-builder.js +337 -82
- package/dist/esm/query-builder/update-query-builder.d.ts +149 -217
- package/dist/esm/query-builder/update-query-builder.js +25 -119
- package/dist/esm/query-builder/update-result.js +3 -0
- package/dist/esm/query-builder/where-interface.d.ts +71 -184
- package/dist/esm/query-compiler/default-query-compiler.d.ts +3 -0
- package/dist/esm/query-compiler/default-query-compiler.js +18 -2
- package/dist/esm/query-creator.d.ts +38 -2
- package/dist/esm/query-creator.js +3 -45
- package/dist/esm/query-executor/query-executor.d.ts +3 -3
- package/dist/esm/raw-builder/raw-builder.d.ts +5 -3
- package/dist/esm/raw-builder/raw-builder.js +13 -7
- package/dist/esm/raw-builder/sql.d.ts +17 -9
- package/dist/esm/raw-builder/sql.js +8 -2
- package/dist/esm/schema/alter-column-builder.d.ts +5 -0
- package/dist/esm/schema/alter-column-builder.js +7 -0
- package/dist/esm/schema/alter-table-add-foreign-key-constraint-builder.d.ts +5 -0
- package/dist/esm/schema/alter-table-add-foreign-key-constraint-builder.js +7 -0
- package/dist/esm/schema/alter-table-drop-constraint-builder.d.ts +5 -0
- package/dist/esm/schema/alter-table-drop-constraint-builder.js +7 -0
- package/dist/esm/schema/column-definition-builder.d.ts +6 -1
- package/dist/esm/schema/column-definition-builder.js +8 -1
- package/dist/esm/schema/create-index-builder.d.ts +51 -9
- package/dist/esm/schema/create-index-builder.js +17 -0
- package/dist/esm/schema/create-schema-builder.d.ts +5 -0
- package/dist/esm/schema/create-schema-builder.js +7 -0
- package/dist/esm/schema/create-table-builder.d.ts +3 -1
- package/dist/esm/schema/create-table-builder.js +3 -1
- package/dist/esm/schema/create-type-builder.d.ts +5 -0
- package/dist/esm/schema/create-type-builder.js +7 -0
- package/dist/esm/schema/create-view-builder.d.ts +5 -0
- package/dist/esm/schema/create-view-builder.js +7 -0
- package/dist/esm/schema/drop-index-builder.d.ts +5 -0
- package/dist/esm/schema/drop-index-builder.js +7 -0
- package/dist/esm/schema/drop-schema-builder.d.ts +5 -0
- package/dist/esm/schema/drop-schema-builder.js +7 -0
- package/dist/esm/schema/drop-table-builder.d.ts +5 -0
- package/dist/esm/schema/drop-table-builder.js +7 -0
- package/dist/esm/schema/drop-type-builder.d.ts +5 -0
- package/dist/esm/schema/drop-type-builder.js +7 -0
- package/dist/esm/schema/drop-view-builder.d.ts +5 -0
- package/dist/esm/schema/drop-view-builder.js +7 -0
- package/dist/esm/schema/foreign-key-constraint-builder.d.ts +5 -0
- package/dist/esm/schema/foreign-key-constraint-builder.js +7 -0
- package/dist/esm/util/compilable.d.ts +1 -0
- package/dist/esm/util/compilable.js +4 -1
- package/dist/esm/util/explainable.d.ts +35 -0
- package/dist/esm/util/log.d.ts +2 -0
- package/dist/esm/util/object-utils.js +1 -1
- package/dist/esm/util/streamable.d.ts +29 -0
- package/dist/esm/util/streamable.js +2 -0
- package/dist/esm/util/type-utils.d.ts +6 -4
- package/helpers/postgres.d.ts +1 -0
- package/helpers/postgres.js +1 -0
- package/package.json +20 -9
- package/dist/cjs/query-builder/expression-builder.d.ts +0 -126
- package/dist/cjs/query-builder/expression-builder.js +0 -107
- package/dist/esm/query-builder/expression-builder.d.ts +0 -126
- package/dist/esm/query-builder/expression-builder.js +0 -104
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
import { Expression } from '../expression/expression.js';
|
|
2
|
+
import { RawBuilder } from '../raw-builder/raw-builder.js';
|
|
3
|
+
import { Simplify } from '../util/type-utils.js';
|
|
4
|
+
/**
|
|
5
|
+
* A postgres helper for aggregating a subquery (or other expression) into a JSONB array.
|
|
6
|
+
*
|
|
7
|
+
* NOTE: This helper is only guaranteed to fully work with the built-in `PostgresDialect`.
|
|
8
|
+
* While the produced SQL is compatibe with all PostgreSQL databases, some 3rd party dialects
|
|
9
|
+
* may not parse the nested results into arrays.
|
|
10
|
+
*
|
|
11
|
+
* ### Examples
|
|
12
|
+
*
|
|
13
|
+
* ```ts
|
|
14
|
+
* const result = await db
|
|
15
|
+
* .selectFrom('person')
|
|
16
|
+
* .select((eb) => [
|
|
17
|
+
* 'id',
|
|
18
|
+
* jsonArrayFrom(
|
|
19
|
+
* eb.selectFrom('pet')
|
|
20
|
+
* .select(['pet.id as pet_id', 'pet.name'])
|
|
21
|
+
* .where('pet.owner_id', '=', 'person.id')
|
|
22
|
+
* .orderBy('pet.name')
|
|
23
|
+
* ).as('pets')
|
|
24
|
+
* ])
|
|
25
|
+
* .execute()
|
|
26
|
+
*
|
|
27
|
+
* result[0].id
|
|
28
|
+
* result[0].pets[0].pet_id
|
|
29
|
+
* result[0].pets[0].name
|
|
30
|
+
* ```
|
|
31
|
+
*
|
|
32
|
+
* The generated SQL (PostgreSQL):
|
|
33
|
+
*
|
|
34
|
+
* ```sql
|
|
35
|
+
* select "id", (
|
|
36
|
+
* select coalesce(jsonb_agg(agg), '[]') from (
|
|
37
|
+
* select "pet"."id" as "pet_id", "pet"."name"
|
|
38
|
+
* from "pet"
|
|
39
|
+
* where "pet"."owner_id" = "person"."id"
|
|
40
|
+
* order by "pet"."name"
|
|
41
|
+
* ) as agg
|
|
42
|
+
* ) as "pets"
|
|
43
|
+
* from "person"
|
|
44
|
+
* ```
|
|
45
|
+
*/
|
|
46
|
+
export declare function jsonArrayFrom<O>(expr: Expression<O>): RawBuilder<Simplify<O>[]>;
|
|
47
|
+
/**
|
|
48
|
+
* A postgres helper for turning a subquery (or other expression) into a JSONB object.
|
|
49
|
+
*
|
|
50
|
+
* The subquery must only return one row.
|
|
51
|
+
*
|
|
52
|
+
* NOTE: This helper is only guaranteed to fully work with the built-in `PostgresDialect`.
|
|
53
|
+
* While the produced SQL is compatibe with all PostgreSQL databases, some 3rd party dialects
|
|
54
|
+
* may not parse the nested results into objects.
|
|
55
|
+
*
|
|
56
|
+
* ### Examples
|
|
57
|
+
*
|
|
58
|
+
* ```ts
|
|
59
|
+
* const result = await db
|
|
60
|
+
* .selectFrom('person')
|
|
61
|
+
* .select((eb) => [
|
|
62
|
+
* 'id',
|
|
63
|
+
* jsonObjectFrom(
|
|
64
|
+
* eb.selectFrom('pet')
|
|
65
|
+
* .select(['pet.id as pet_id', 'pet.name'])
|
|
66
|
+
* .where('pet.owner_id', '=', 'person.id')
|
|
67
|
+
* .where('pet.is_favorite', '=', true)
|
|
68
|
+
* ).as('favorite_pet')
|
|
69
|
+
* ])
|
|
70
|
+
* .execute()
|
|
71
|
+
*
|
|
72
|
+
* result[0].id
|
|
73
|
+
* result[0].favorite_pet.pet_id
|
|
74
|
+
* result[0].favorite_pet.name
|
|
75
|
+
* ```
|
|
76
|
+
*
|
|
77
|
+
* The generated SQL (PostgreSQL):
|
|
78
|
+
*
|
|
79
|
+
* ```sql
|
|
80
|
+
* select "id", (
|
|
81
|
+
* select to_jsonb(obj) from (
|
|
82
|
+
* select "pet"."id" as "pet_id", "pet"."name"
|
|
83
|
+
* from "pet"
|
|
84
|
+
* where "pet"."owner_id" = "person"."id"
|
|
85
|
+
* and "pet"."is_favorite" = $1
|
|
86
|
+
* ) as obj
|
|
87
|
+
* ) as "favorite_pet"
|
|
88
|
+
* from "person"
|
|
89
|
+
* ```
|
|
90
|
+
*/
|
|
91
|
+
export declare function jsonObjectFrom<O>(expr: Expression<O>): RawBuilder<Simplify<O>>;
|
|
92
|
+
/**
|
|
93
|
+
* The PostgreSQL `jsonb_build_object` function.
|
|
94
|
+
*
|
|
95
|
+
* NOTE: This helper is only guaranteed to fully work with the built-in `PostgresDialect`.
|
|
96
|
+
* While the produced SQL is compatibe with all PostgreSQL databases, some 3rd party dialects
|
|
97
|
+
* may not parse the nested results into objects.
|
|
98
|
+
*
|
|
99
|
+
* ### Examples
|
|
100
|
+
*
|
|
101
|
+
* ```ts
|
|
102
|
+
* const result = await db
|
|
103
|
+
* .selectFrom('person')
|
|
104
|
+
* .select((eb) => [
|
|
105
|
+
* 'id',
|
|
106
|
+
* jsonbBuildObject({
|
|
107
|
+
* first: eb.ref('first_name'),
|
|
108
|
+
* last: eb.ref('last_name'),
|
|
109
|
+
* full: sql<string>`first_name || ' ' || last_name`
|
|
110
|
+
* }).as('name')
|
|
111
|
+
* ])
|
|
112
|
+
* .execute()
|
|
113
|
+
*
|
|
114
|
+
* result[0].id
|
|
115
|
+
* result[0].name.first
|
|
116
|
+
* result[0].name.last
|
|
117
|
+
* result[0].name.full
|
|
118
|
+
* ```
|
|
119
|
+
*
|
|
120
|
+
* The generated SQL (PostgreSQL):
|
|
121
|
+
*
|
|
122
|
+
* ```sql
|
|
123
|
+
* select "id", jsonb_build_object(
|
|
124
|
+
* 'first', first_name,
|
|
125
|
+
* 'last', last_name,
|
|
126
|
+
* 'full', first_name || ' ' || last_name
|
|
127
|
+
* ) as "name"
|
|
128
|
+
* from "person"
|
|
129
|
+
* ```
|
|
130
|
+
*/
|
|
131
|
+
export declare function jsonbBuildObject<O extends Record<string, Expression<unknown>>>(obj: O): RawBuilder<Simplify<{
|
|
132
|
+
[K in keyof O]: O[K] extends Expression<infer V> ? V : never;
|
|
133
|
+
}>>;
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.jsonbBuildObject = exports.jsonObjectFrom = exports.jsonArrayFrom = void 0;
|
|
4
|
+
const sql_js_1 = require("../raw-builder/sql.js");
|
|
5
|
+
/**
|
|
6
|
+
* A postgres helper for aggregating a subquery (or other expression) into a JSONB array.
|
|
7
|
+
*
|
|
8
|
+
* NOTE: This helper is only guaranteed to fully work with the built-in `PostgresDialect`.
|
|
9
|
+
* While the produced SQL is compatibe with all PostgreSQL databases, some 3rd party dialects
|
|
10
|
+
* may not parse the nested results into arrays.
|
|
11
|
+
*
|
|
12
|
+
* ### Examples
|
|
13
|
+
*
|
|
14
|
+
* ```ts
|
|
15
|
+
* const result = await db
|
|
16
|
+
* .selectFrom('person')
|
|
17
|
+
* .select((eb) => [
|
|
18
|
+
* 'id',
|
|
19
|
+
* jsonArrayFrom(
|
|
20
|
+
* eb.selectFrom('pet')
|
|
21
|
+
* .select(['pet.id as pet_id', 'pet.name'])
|
|
22
|
+
* .where('pet.owner_id', '=', 'person.id')
|
|
23
|
+
* .orderBy('pet.name')
|
|
24
|
+
* ).as('pets')
|
|
25
|
+
* ])
|
|
26
|
+
* .execute()
|
|
27
|
+
*
|
|
28
|
+
* result[0].id
|
|
29
|
+
* result[0].pets[0].pet_id
|
|
30
|
+
* result[0].pets[0].name
|
|
31
|
+
* ```
|
|
32
|
+
*
|
|
33
|
+
* The generated SQL (PostgreSQL):
|
|
34
|
+
*
|
|
35
|
+
* ```sql
|
|
36
|
+
* select "id", (
|
|
37
|
+
* select coalesce(jsonb_agg(agg), '[]') from (
|
|
38
|
+
* select "pet"."id" as "pet_id", "pet"."name"
|
|
39
|
+
* from "pet"
|
|
40
|
+
* where "pet"."owner_id" = "person"."id"
|
|
41
|
+
* order by "pet"."name"
|
|
42
|
+
* ) as agg
|
|
43
|
+
* ) as "pets"
|
|
44
|
+
* from "person"
|
|
45
|
+
* ```
|
|
46
|
+
*/
|
|
47
|
+
function jsonArrayFrom(expr) {
|
|
48
|
+
return (0, sql_js_1.sql) `(select coalesce(jsonb_agg(agg), '[]') from ${expr} as agg)`;
|
|
49
|
+
}
|
|
50
|
+
exports.jsonArrayFrom = jsonArrayFrom;
|
|
51
|
+
/**
|
|
52
|
+
* A postgres helper for turning a subquery (or other expression) into a JSONB object.
|
|
53
|
+
*
|
|
54
|
+
* The subquery must only return one row.
|
|
55
|
+
*
|
|
56
|
+
* NOTE: This helper is only guaranteed to fully work with the built-in `PostgresDialect`.
|
|
57
|
+
* While the produced SQL is compatibe with all PostgreSQL databases, some 3rd party dialects
|
|
58
|
+
* may not parse the nested results into objects.
|
|
59
|
+
*
|
|
60
|
+
* ### Examples
|
|
61
|
+
*
|
|
62
|
+
* ```ts
|
|
63
|
+
* const result = await db
|
|
64
|
+
* .selectFrom('person')
|
|
65
|
+
* .select((eb) => [
|
|
66
|
+
* 'id',
|
|
67
|
+
* jsonObjectFrom(
|
|
68
|
+
* eb.selectFrom('pet')
|
|
69
|
+
* .select(['pet.id as pet_id', 'pet.name'])
|
|
70
|
+
* .where('pet.owner_id', '=', 'person.id')
|
|
71
|
+
* .where('pet.is_favorite', '=', true)
|
|
72
|
+
* ).as('favorite_pet')
|
|
73
|
+
* ])
|
|
74
|
+
* .execute()
|
|
75
|
+
*
|
|
76
|
+
* result[0].id
|
|
77
|
+
* result[0].favorite_pet.pet_id
|
|
78
|
+
* result[0].favorite_pet.name
|
|
79
|
+
* ```
|
|
80
|
+
*
|
|
81
|
+
* The generated SQL (PostgreSQL):
|
|
82
|
+
*
|
|
83
|
+
* ```sql
|
|
84
|
+
* select "id", (
|
|
85
|
+
* select to_jsonb(obj) from (
|
|
86
|
+
* select "pet"."id" as "pet_id", "pet"."name"
|
|
87
|
+
* from "pet"
|
|
88
|
+
* where "pet"."owner_id" = "person"."id"
|
|
89
|
+
* and "pet"."is_favorite" = $1
|
|
90
|
+
* ) as obj
|
|
91
|
+
* ) as "favorite_pet"
|
|
92
|
+
* from "person"
|
|
93
|
+
* ```
|
|
94
|
+
*/
|
|
95
|
+
function jsonObjectFrom(expr) {
|
|
96
|
+
return (0, sql_js_1.sql) `(select to_jsonb(obj) from ${expr} as obj)`;
|
|
97
|
+
}
|
|
98
|
+
exports.jsonObjectFrom = jsonObjectFrom;
|
|
99
|
+
/**
|
|
100
|
+
* The PostgreSQL `jsonb_build_object` function.
|
|
101
|
+
*
|
|
102
|
+
* NOTE: This helper is only guaranteed to fully work with the built-in `PostgresDialect`.
|
|
103
|
+
* While the produced SQL is compatibe with all PostgreSQL databases, some 3rd party dialects
|
|
104
|
+
* may not parse the nested results into objects.
|
|
105
|
+
*
|
|
106
|
+
* ### Examples
|
|
107
|
+
*
|
|
108
|
+
* ```ts
|
|
109
|
+
* const result = await db
|
|
110
|
+
* .selectFrom('person')
|
|
111
|
+
* .select((eb) => [
|
|
112
|
+
* 'id',
|
|
113
|
+
* jsonbBuildObject({
|
|
114
|
+
* first: eb.ref('first_name'),
|
|
115
|
+
* last: eb.ref('last_name'),
|
|
116
|
+
* full: sql<string>`first_name || ' ' || last_name`
|
|
117
|
+
* }).as('name')
|
|
118
|
+
* ])
|
|
119
|
+
* .execute()
|
|
120
|
+
*
|
|
121
|
+
* result[0].id
|
|
122
|
+
* result[0].name.first
|
|
123
|
+
* result[0].name.last
|
|
124
|
+
* result[0].name.full
|
|
125
|
+
* ```
|
|
126
|
+
*
|
|
127
|
+
* The generated SQL (PostgreSQL):
|
|
128
|
+
*
|
|
129
|
+
* ```sql
|
|
130
|
+
* select "id", jsonb_build_object(
|
|
131
|
+
* 'first', first_name,
|
|
132
|
+
* 'last', last_name,
|
|
133
|
+
* 'full', first_name || ' ' || last_name
|
|
134
|
+
* ) as "name"
|
|
135
|
+
* from "person"
|
|
136
|
+
* ```
|
|
137
|
+
*/
|
|
138
|
+
function jsonbBuildObject(obj) {
|
|
139
|
+
return (0, sql_js_1.sql) `jsonb_build_object(${sql_js_1.sql.join(Object.keys(obj).flatMap((k) => [sql_js_1.sql.lit(k), obj[k]]))})`;
|
|
140
|
+
}
|
|
141
|
+
exports.jsonbBuildObject = jsonbBuildObject;
|
package/dist/cjs/index.d.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
export * from './kysely.js';
|
|
2
2
|
export * from './query-creator.js';
|
|
3
3
|
export * from './expression/expression.js';
|
|
4
|
+
export { ExpressionBuilder, expressionBuilder, } from './expression/expression-builder.js';
|
|
4
5
|
export * from './query-builder/where-interface.js';
|
|
5
6
|
export * from './query-builder/returning-interface.js';
|
|
6
7
|
export * from './query-builder/having-interface.js';
|
|
@@ -10,7 +11,6 @@ export * from './query-builder/update-query-builder.js';
|
|
|
10
11
|
export * from './query-builder/delete-query-builder.js';
|
|
11
12
|
export * from './query-builder/no-result-error.js';
|
|
12
13
|
export * from './query-builder/join-builder.js';
|
|
13
|
-
export * from './query-builder/expression-builder.js';
|
|
14
14
|
export * from './query-builder/function-module.js';
|
|
15
15
|
export * from './query-builder/insert-result.js';
|
|
16
16
|
export * from './query-builder/delete-result.js';
|
|
@@ -163,11 +163,12 @@ export * from './operation-node/using-node.js';
|
|
|
163
163
|
export * from './util/column-type.js';
|
|
164
164
|
export * from './util/compilable.js';
|
|
165
165
|
export * from './util/explainable.js';
|
|
166
|
+
export * from './util/streamable.js';
|
|
166
167
|
export * from './util/log.js';
|
|
167
|
-
export { AnyAliasedColumn, AnyAliasedColumnWithTable, AnyColumn, AnyColumnWithTable, AnySelectQueryBuilder, Equals, UnknownRow, } from './util/type-utils.js';
|
|
168
|
+
export { AnyAliasedColumn, AnyAliasedColumnWithTable, AnyColumn, AnyColumnWithTable, AnySelectQueryBuilder, Equals, UnknownRow, Simplify, SqlBool, } from './util/type-utils.js';
|
|
168
169
|
export * from './util/infer-result.js';
|
|
169
170
|
export { logOnce } from './util/log-once.js';
|
|
170
|
-
export { SelectExpression,
|
|
171
|
+
export { SelectExpression, SelectArg, Selection, } from './parser/select-parser.js';
|
|
171
172
|
export { ReferenceExpression, ReferenceExpressionOrList, SimpleReferenceExpression, StringReference, ExtractTypeFromStringReference, ExtractTypeFromReferenceExpression, } from './parser/reference-parser.js';
|
|
172
173
|
export { ValueExpression, ValueExpressionOrList, } from './parser/value-parser.js';
|
|
173
174
|
export { TableExpression, TableExpressionOrList, } from './parser/table-parser.js';
|
package/dist/cjs/index.js
CHANGED
|
@@ -14,10 +14,12 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
|
14
14
|
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
|
|
15
15
|
};
|
|
16
16
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
17
|
-
exports.logOnce = void 0;
|
|
17
|
+
exports.logOnce = exports.expressionBuilder = void 0;
|
|
18
18
|
__exportStar(require("./kysely.js"), exports);
|
|
19
19
|
__exportStar(require("./query-creator.js"), exports);
|
|
20
20
|
__exportStar(require("./expression/expression.js"), exports);
|
|
21
|
+
var expression_builder_js_1 = require("./expression/expression-builder.js");
|
|
22
|
+
Object.defineProperty(exports, "expressionBuilder", { enumerable: true, get: function () { return expression_builder_js_1.expressionBuilder; } });
|
|
21
23
|
__exportStar(require("./query-builder/where-interface.js"), exports);
|
|
22
24
|
__exportStar(require("./query-builder/returning-interface.js"), exports);
|
|
23
25
|
__exportStar(require("./query-builder/having-interface.js"), exports);
|
|
@@ -27,7 +29,6 @@ __exportStar(require("./query-builder/update-query-builder.js"), exports);
|
|
|
27
29
|
__exportStar(require("./query-builder/delete-query-builder.js"), exports);
|
|
28
30
|
__exportStar(require("./query-builder/no-result-error.js"), exports);
|
|
29
31
|
__exportStar(require("./query-builder/join-builder.js"), exports);
|
|
30
|
-
__exportStar(require("./query-builder/expression-builder.js"), exports);
|
|
31
32
|
__exportStar(require("./query-builder/function-module.js"), exports);
|
|
32
33
|
__exportStar(require("./query-builder/insert-result.js"), exports);
|
|
33
34
|
__exportStar(require("./query-builder/delete-result.js"), exports);
|
|
@@ -180,6 +181,7 @@ __exportStar(require("./operation-node/using-node.js"), exports);
|
|
|
180
181
|
__exportStar(require("./util/column-type.js"), exports);
|
|
181
182
|
__exportStar(require("./util/compilable.js"), exports);
|
|
182
183
|
__exportStar(require("./util/explainable.js"), exports);
|
|
184
|
+
__exportStar(require("./util/streamable.js"), exports);
|
|
183
185
|
__exportStar(require("./util/log.js"), exports);
|
|
184
186
|
__exportStar(require("./util/infer-result.js"), exports);
|
|
185
187
|
var log_once_js_1 = require("./util/log-once.js");
|
package/dist/cjs/kysely.d.ts
CHANGED
|
@@ -9,6 +9,10 @@ import { Driver, IsolationLevel } from './driver/driver.js';
|
|
|
9
9
|
import { FunctionModule } from './query-builder/function-module.js';
|
|
10
10
|
import { LogConfig } from './util/log.js';
|
|
11
11
|
import { QueryExecutorProvider } from './query-executor/query-executor-provider.js';
|
|
12
|
+
import { QueryResult } from './driver/database-connection.js';
|
|
13
|
+
import { CompiledQuery } from './query-compiler/compiled-query.js';
|
|
14
|
+
import { QueryId } from './util/query-id.js';
|
|
15
|
+
import { Compilable } from './util/compilable.js';
|
|
12
16
|
/**
|
|
13
17
|
* The main Kysely class.
|
|
14
18
|
*
|
|
@@ -225,6 +229,12 @@ export declare class Kysely<DB> extends QueryCreator<DB> implements QueryExecuto
|
|
|
225
229
|
* @private
|
|
226
230
|
*/
|
|
227
231
|
getExecutor(): QueryExecutor;
|
|
232
|
+
/**
|
|
233
|
+
* Executes a given compiled query or query builder.
|
|
234
|
+
*
|
|
235
|
+
* See {@link https://github.com/koskimas/kysely/blob/master/site/docs/recipes/splitting-build-compile-and-execute-code.md#execute-compiled-queries splitting build, compile and execute code recipe} for more information.
|
|
236
|
+
*/
|
|
237
|
+
executeQuery<R>(query: CompiledQuery<R> | Compilable<R>, queryId?: QueryId): Promise<QueryResult<R>>;
|
|
228
238
|
}
|
|
229
239
|
export declare class Transaction<DB> extends Kysely<DB> {
|
|
230
240
|
#private;
|
package/dist/cjs/kysely.js
CHANGED
|
@@ -13,6 +13,8 @@ const driver_js_1 = require("./driver/driver.js");
|
|
|
13
13
|
const prevent_await_js_1 = require("./util/prevent-await.js");
|
|
14
14
|
const function_module_js_1 = require("./query-builder/function-module.js");
|
|
15
15
|
const log_js_1 = require("./util/log.js");
|
|
16
|
+
const query_id_js_1 = require("./util/query-id.js");
|
|
17
|
+
const compilable_js_1 = require("./util/compilable.js");
|
|
16
18
|
/**
|
|
17
19
|
* The main Kysely class.
|
|
18
20
|
*
|
|
@@ -135,7 +137,7 @@ class Kysely extends query_creator_js_1.QueryCreator {
|
|
|
135
137
|
* ```
|
|
136
138
|
*/
|
|
137
139
|
get fn() {
|
|
138
|
-
return
|
|
140
|
+
return (0, function_module_js_1.createFunctionModule)();
|
|
139
141
|
}
|
|
140
142
|
/**
|
|
141
143
|
* Creates a {@link TransactionBuilder} that can be used to run queries inside a transaction.
|
|
@@ -284,6 +286,15 @@ class Kysely extends query_creator_js_1.QueryCreator {
|
|
|
284
286
|
getExecutor() {
|
|
285
287
|
return this.#props.executor;
|
|
286
288
|
}
|
|
289
|
+
/**
|
|
290
|
+
* Executes a given compiled query or query builder.
|
|
291
|
+
*
|
|
292
|
+
* See {@link https://github.com/koskimas/kysely/blob/master/site/docs/recipes/splitting-build-compile-and-execute-code.md#execute-compiled-queries splitting build, compile and execute code recipe} for more information.
|
|
293
|
+
*/
|
|
294
|
+
executeQuery(query, queryId = (0, query_id_js_1.createQueryId)()) {
|
|
295
|
+
const compiledQuery = (0, compilable_js_1.isCompilable)(query) ? query.compile() : query;
|
|
296
|
+
return this.getExecutor().executeQuery(compiledQuery, queryId);
|
|
297
|
+
}
|
|
287
298
|
}
|
|
288
299
|
exports.Kysely = Kysely;
|
|
289
300
|
class Transaction extends Kysely {
|
|
@@ -22,8 +22,11 @@ export declare class FileMigrationProvider implements MigrationProvider {
|
|
|
22
22
|
* Returns all migrations, old and new.
|
|
23
23
|
*
|
|
24
24
|
* For example if you have your migrations in a folder as separate files,
|
|
25
|
-
* you can
|
|
26
|
-
*
|
|
25
|
+
* you can implement this method to return all migration in that folder
|
|
26
|
+
* as {@link Migration} objects.
|
|
27
|
+
*
|
|
28
|
+
* Kysely already has a built-in {@link FileMigrationProvider} for node.js
|
|
29
|
+
* that does exactly that.
|
|
27
30
|
*
|
|
28
31
|
* The keys of the returned object are migration names and values are the
|
|
29
32
|
* migrations. The order of the migrations is determined by the alphabetical
|
|
@@ -258,8 +258,11 @@ export interface MigrationProvider {
|
|
|
258
258
|
* Returns all migrations, old and new.
|
|
259
259
|
*
|
|
260
260
|
* For example if you have your migrations in a folder as separate files,
|
|
261
|
-
* you can
|
|
262
|
-
*
|
|
261
|
+
* you can implement this method to return all migration in that folder
|
|
262
|
+
* as {@link Migration} objects.
|
|
263
|
+
*
|
|
264
|
+
* Kysely already has a built-in {@link FileMigrationProvider} for node.js
|
|
265
|
+
* that does exactly that.
|
|
263
266
|
*
|
|
264
267
|
* The keys of the returned object are migration names and values are the
|
|
265
268
|
* migrations. The order of the migrations is determined by the alphabetical
|
|
@@ -1,12 +1,13 @@
|
|
|
1
1
|
import { OperationNode } from './operation-node.js';
|
|
2
2
|
import { OverNode } from './over-node.js';
|
|
3
|
+
import { SelectionNode } from './selection-node.js';
|
|
3
4
|
import { SimpleReferenceExpressionNode } from './simple-reference-expression-node.js';
|
|
4
5
|
import { WhereNode } from './where-node.js';
|
|
5
6
|
declare type AggregateFunction = 'avg' | 'count' | 'max' | 'min' | 'sum';
|
|
6
7
|
export interface AggregateFunctionNode extends OperationNode {
|
|
7
8
|
readonly kind: 'AggregateFunctionNode';
|
|
8
9
|
readonly func: AggregateFunction;
|
|
9
|
-
readonly
|
|
10
|
+
readonly aggregated: SimpleReferenceExpressionNode | SelectionNode;
|
|
10
11
|
readonly distinct?: boolean;
|
|
11
12
|
readonly filter?: WhereNode;
|
|
12
13
|
readonly over?: OverNode;
|
|
@@ -16,7 +17,7 @@ export interface AggregateFunctionNode extends OperationNode {
|
|
|
16
17
|
*/
|
|
17
18
|
export declare const AggregateFunctionNode: Readonly<{
|
|
18
19
|
is(node: OperationNode): node is AggregateFunctionNode;
|
|
19
|
-
create(aggregateFunction: AggregateFunction,
|
|
20
|
+
create(aggregateFunction: AggregateFunction, aggregated: SimpleReferenceExpressionNode | SelectionNode): AggregateFunctionNode;
|
|
20
21
|
cloneWithDistinct(aggregateFunctionNode: AggregateFunctionNode): AggregateFunctionNode;
|
|
21
22
|
cloneWithFilter(aggregateFunctionNode: AggregateFunctionNode, filter: OperationNode): AggregateFunctionNode;
|
|
22
23
|
cloneWithOrFilter(aggregateFunctionNode: AggregateFunctionNode, filter: OperationNode): AggregateFunctionNode;
|
|
@@ -10,11 +10,11 @@ exports.AggregateFunctionNode = (0, object_utils_js_1.freeze)({
|
|
|
10
10
|
is(node) {
|
|
11
11
|
return node.kind === 'AggregateFunctionNode';
|
|
12
12
|
},
|
|
13
|
-
create(aggregateFunction,
|
|
13
|
+
create(aggregateFunction, aggregated) {
|
|
14
14
|
return (0, object_utils_js_1.freeze)({
|
|
15
15
|
kind: 'AggregateFunctionNode',
|
|
16
16
|
func: aggregateFunction,
|
|
17
|
-
|
|
17
|
+
aggregated,
|
|
18
18
|
});
|
|
19
19
|
},
|
|
20
20
|
cloneWithDistinct(aggregateFunctionNode) {
|
|
@@ -2,6 +2,7 @@ import { IdentifierNode } from './identifier-node.js';
|
|
|
2
2
|
import { OperationNode } from './operation-node.js';
|
|
3
3
|
import { RawNode } from './raw-node.js';
|
|
4
4
|
import { TableNode } from './table-node.js';
|
|
5
|
+
import { WhereNode } from './where-node.js';
|
|
5
6
|
export declare type CreateIndexNodeProps = Omit<CreateIndexNode, 'kind' | 'name'>;
|
|
6
7
|
export declare type IndexType = 'btree' | 'hash' | 'gist' | 'gin';
|
|
7
8
|
export interface CreateIndexNode extends OperationNode {
|
|
@@ -12,6 +13,7 @@ export interface CreateIndexNode extends OperationNode {
|
|
|
12
13
|
readonly unique?: boolean;
|
|
13
14
|
readonly using?: RawNode;
|
|
14
15
|
readonly ifNotExists?: boolean;
|
|
16
|
+
readonly where?: WhereNode;
|
|
15
17
|
}
|
|
16
18
|
/**
|
|
17
19
|
* @internal
|
|
@@ -26,9 +26,8 @@ export interface DeleteQueryNode extends OperationNode {
|
|
|
26
26
|
*/
|
|
27
27
|
export declare const DeleteQueryNode: Readonly<{
|
|
28
28
|
is(node: OperationNode): node is DeleteQueryNode;
|
|
29
|
-
create(
|
|
29
|
+
create(fromItems: OperationNode[], withNode?: WithNode): DeleteQueryNode;
|
|
30
30
|
cloneWithOrderByItem(deleteNode: DeleteQueryNode, item: OrderByItemNode): DeleteQueryNode;
|
|
31
31
|
cloneWithLimit(deleteNode: DeleteQueryNode, limit: LimitNode): DeleteQueryNode;
|
|
32
|
-
cloneWithExplain(deleteNode: DeleteQueryNode, explain: ExplainNode): DeleteQueryNode;
|
|
33
32
|
cloneWithUsing(deleteNode: DeleteQueryNode, tables: OperationNode[]): DeleteQueryNode;
|
|
34
33
|
}>;
|
|
@@ -12,10 +12,10 @@ exports.DeleteQueryNode = (0, object_utils_js_1.freeze)({
|
|
|
12
12
|
is(node) {
|
|
13
13
|
return node.kind === 'DeleteQueryNode';
|
|
14
14
|
},
|
|
15
|
-
create(
|
|
15
|
+
create(fromItems, withNode) {
|
|
16
16
|
return (0, object_utils_js_1.freeze)({
|
|
17
17
|
kind: 'DeleteQueryNode',
|
|
18
|
-
from: from_node_js_1.FromNode.create(
|
|
18
|
+
from: from_node_js_1.FromNode.create(fromItems),
|
|
19
19
|
...(withNode && { with: withNode }),
|
|
20
20
|
});
|
|
21
21
|
},
|
|
@@ -33,12 +33,6 @@ exports.DeleteQueryNode = (0, object_utils_js_1.freeze)({
|
|
|
33
33
|
limit,
|
|
34
34
|
});
|
|
35
35
|
},
|
|
36
|
-
cloneWithExplain(deleteNode, explain) {
|
|
37
|
-
return (0, object_utils_js_1.freeze)({
|
|
38
|
-
...deleteNode,
|
|
39
|
-
explain,
|
|
40
|
-
});
|
|
41
|
-
},
|
|
42
36
|
cloneWithUsing(deleteNode, tables) {
|
|
43
37
|
return (0, object_utils_js_1.freeze)({
|
|
44
38
|
...deleteNode,
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { OperationNode } from './operation-node.js';
|
|
2
|
+
export interface FunctionNode extends OperationNode {
|
|
3
|
+
readonly kind: 'FunctionNode';
|
|
4
|
+
readonly func: string;
|
|
5
|
+
readonly arguments: ReadonlyArray<OperationNode>;
|
|
6
|
+
}
|
|
7
|
+
/**
|
|
8
|
+
* @internal
|
|
9
|
+
*/
|
|
10
|
+
export declare const FunctionNode: Readonly<{
|
|
11
|
+
is(node: OperationNode): node is FunctionNode;
|
|
12
|
+
create(func: string, args: ReadonlyArray<OperationNode>): FunctionNode;
|
|
13
|
+
}>;
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.FunctionNode = void 0;
|
|
4
|
+
const object_utils_js_1 = require("../util/object-utils.js");
|
|
5
|
+
/**
|
|
6
|
+
* @internal
|
|
7
|
+
*/
|
|
8
|
+
exports.FunctionNode = (0, object_utils_js_1.freeze)({
|
|
9
|
+
is(node) {
|
|
10
|
+
return node.kind === 'FunctionNode';
|
|
11
|
+
},
|
|
12
|
+
create(func, args) {
|
|
13
|
+
return (0, object_utils_js_1.freeze)({
|
|
14
|
+
kind: 'FunctionNode',
|
|
15
|
+
func,
|
|
16
|
+
arguments: args,
|
|
17
|
+
});
|
|
18
|
+
},
|
|
19
|
+
});
|
|
@@ -77,6 +77,7 @@ import { SetOperationNode } from './set-operation-node.js';
|
|
|
77
77
|
import { BinaryOperationNode } from './binary-operation-node.js';
|
|
78
78
|
import { UnaryOperationNode } from './unary-operation-node.js';
|
|
79
79
|
import { UsingNode } from './using-node.js';
|
|
80
|
+
import { FunctionNode } from './function-node.js';
|
|
80
81
|
/**
|
|
81
82
|
* Transforms an operation node tree into another one.
|
|
82
83
|
*
|
|
@@ -183,6 +184,7 @@ export declare class OperationNodeTransformer {
|
|
|
183
184
|
protected transformBinaryOperation(node: BinaryOperationNode): BinaryOperationNode;
|
|
184
185
|
protected transformUnaryOperation(node: UnaryOperationNode): UnaryOperationNode;
|
|
185
186
|
protected transformUsing(node: UsingNode): UsingNode;
|
|
187
|
+
protected transformFunction(node: FunctionNode): FunctionNode;
|
|
186
188
|
protected transformDataType(node: DataTypeNode): DataTypeNode;
|
|
187
189
|
protected transformSelectAll(node: SelectAllNode): SelectAllNode;
|
|
188
190
|
protected transformIdentifier(node: IdentifierNode): IdentifierNode;
|
|
@@ -113,6 +113,7 @@ class OperationNodeTransformer {
|
|
|
113
113
|
BinaryOperationNode: this.transformBinaryOperation.bind(this),
|
|
114
114
|
UnaryOperationNode: this.transformUnaryOperation.bind(this),
|
|
115
115
|
UsingNode: this.transformUsing.bind(this),
|
|
116
|
+
FunctionNode: this.transformFunction.bind(this),
|
|
116
117
|
});
|
|
117
118
|
transformNode(node) {
|
|
118
119
|
if (!node) {
|
|
@@ -407,6 +408,7 @@ class OperationNodeTransformer {
|
|
|
407
408
|
unique: node.unique,
|
|
408
409
|
using: this.transformNode(node.using),
|
|
409
410
|
ifNotExists: node.ifNotExists,
|
|
411
|
+
where: this.transformNode(node.where),
|
|
410
412
|
});
|
|
411
413
|
}
|
|
412
414
|
transformList(node) {
|
|
@@ -651,7 +653,7 @@ class OperationNodeTransformer {
|
|
|
651
653
|
transformAggregateFunction(node) {
|
|
652
654
|
return (0, require_all_props_js_1.requireAllProps)({
|
|
653
655
|
kind: 'AggregateFunctionNode',
|
|
654
|
-
|
|
656
|
+
aggregated: this.transformNode(node.aggregated),
|
|
655
657
|
distinct: node.distinct,
|
|
656
658
|
filter: this.transformNode(node.filter),
|
|
657
659
|
func: node.func,
|
|
@@ -695,7 +697,14 @@ class OperationNodeTransformer {
|
|
|
695
697
|
transformUsing(node) {
|
|
696
698
|
return (0, require_all_props_js_1.requireAllProps)({
|
|
697
699
|
kind: 'UsingNode',
|
|
698
|
-
tables: node.tables,
|
|
700
|
+
tables: this.transformNodeList(node.tables),
|
|
701
|
+
});
|
|
702
|
+
}
|
|
703
|
+
transformFunction(node) {
|
|
704
|
+
return (0, require_all_props_js_1.requireAllProps)({
|
|
705
|
+
kind: 'FunctionNode',
|
|
706
|
+
func: node.func,
|
|
707
|
+
arguments: this.transformNodeList(node.arguments),
|
|
699
708
|
});
|
|
700
709
|
}
|
|
701
710
|
transformDataType(node) {
|
|
@@ -77,6 +77,7 @@ import { SetOperationNode } from './set-operation-node.js';
|
|
|
77
77
|
import { BinaryOperationNode } from './binary-operation-node.js';
|
|
78
78
|
import { UnaryOperationNode } from './unary-operation-node.js';
|
|
79
79
|
import { UsingNode } from './using-node.js';
|
|
80
|
+
import { FunctionNode } from './function-node.js';
|
|
80
81
|
export declare abstract class OperationNodeVisitor {
|
|
81
82
|
#private;
|
|
82
83
|
protected readonly nodeStack: OperationNode[];
|
|
@@ -160,4 +161,5 @@ export declare abstract class OperationNodeVisitor {
|
|
|
160
161
|
protected abstract visitBinaryOperation(node: BinaryOperationNode): void;
|
|
161
162
|
protected abstract visitUnaryOperation(node: UnaryOperationNode): void;
|
|
162
163
|
protected abstract visitUsing(node: UsingNode): void;
|
|
164
|
+
protected abstract visitFunction(node: FunctionNode): void;
|
|
163
165
|
}
|
|
@@ -86,6 +86,7 @@ class OperationNodeVisitor {
|
|
|
86
86
|
BinaryOperationNode: this.visitBinaryOperation.bind(this),
|
|
87
87
|
UnaryOperationNode: this.visitUnaryOperation.bind(this),
|
|
88
88
|
UsingNode: this.visitUsing.bind(this),
|
|
89
|
+
FunctionNode: this.visitFunction.bind(this),
|
|
89
90
|
});
|
|
90
91
|
visitNode = (node) => {
|
|
91
92
|
this.nodeStack.push(node);
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export declare type OperationNodeKind = 'IdentifierNode' | 'SchemableIdentifierNode' | 'RawNode' | 'SelectQueryNode' | 'SelectionNode' | 'ReferenceNode' | 'ColumnNode' | 'TableNode' | 'AliasNode' | 'FromNode' | 'SelectAllNode' | 'AndNode' | 'OrNode' | 'ParensNode' | 'ValueNode' | 'ValueListNode' | 'PrimitiveValueListNode' | 'JoinNode' | 'OperatorNode' | 'WhereNode' | 'InsertQueryNode' | 'DeleteQueryNode' | 'ReturningNode' | 'CreateTableNode' | 'ColumnDefinitionNode' | 'AddColumnNode' | 'DropTableNode' | 'DataTypeNode' | 'OrderByNode' | 'OrderByItemNode' | 'GroupByNode' | 'GroupByItemNode' | 'UpdateQueryNode' | 'ColumnUpdateNode' | 'LimitNode' | 'OffsetNode' | 'OnConflictNode' | 'OnDuplicateKeyNode' | 'CreateIndexNode' | 'DropIndexNode' | 'ListNode' | 'ReferencesNode' | 'PrimaryKeyConstraintNode' | 'UniqueConstraintNode' | 'CheckConstraintNode' | 'ForeignKeyConstraintNode' | 'WithNode' | 'CommonTableExpressionNode' | 'HavingNode' | 'CreateSchemaNode' | 'DropSchemaNode' | 'AlterTableNode' | 'ModifyColumnNode' | 'DropColumnNode' | 'RenameColumnNode' | 'AlterColumnNode' | 'AddConstraintNode' | 'DropConstraintNode' | 'CreateViewNode' | 'DropViewNode' | 'GeneratedNode' | 'DefaultValueNode' | 'OnNode' | 'ValuesNode' | 'CommonTableExpressionNameNode' | 'SelectModifierNode' | 'CreateTypeNode' | 'DropTypeNode' | 'ExplainNode' | 'DefaultInsertValueNode' | 'AggregateFunctionNode' | 'OverNode' | 'PartitionByNode' | 'PartitionByItemNode' | 'SetOperationNode' | 'BinaryOperationNode' | 'UnaryOperationNode' | 'UsingNode';
|
|
1
|
+
export declare type OperationNodeKind = 'IdentifierNode' | 'SchemableIdentifierNode' | 'RawNode' | 'SelectQueryNode' | 'SelectionNode' | 'ReferenceNode' | 'ColumnNode' | 'TableNode' | 'AliasNode' | 'FromNode' | 'SelectAllNode' | 'AndNode' | 'OrNode' | 'ParensNode' | 'ValueNode' | 'ValueListNode' | 'PrimitiveValueListNode' | 'JoinNode' | 'OperatorNode' | 'WhereNode' | 'InsertQueryNode' | 'DeleteQueryNode' | 'ReturningNode' | 'CreateTableNode' | 'ColumnDefinitionNode' | 'AddColumnNode' | 'DropTableNode' | 'DataTypeNode' | 'OrderByNode' | 'OrderByItemNode' | 'GroupByNode' | 'GroupByItemNode' | 'UpdateQueryNode' | 'ColumnUpdateNode' | 'LimitNode' | 'OffsetNode' | 'OnConflictNode' | 'OnDuplicateKeyNode' | 'CreateIndexNode' | 'DropIndexNode' | 'ListNode' | 'ReferencesNode' | 'PrimaryKeyConstraintNode' | 'UniqueConstraintNode' | 'CheckConstraintNode' | 'ForeignKeyConstraintNode' | 'WithNode' | 'CommonTableExpressionNode' | 'HavingNode' | 'CreateSchemaNode' | 'DropSchemaNode' | 'AlterTableNode' | 'ModifyColumnNode' | 'DropColumnNode' | 'RenameColumnNode' | 'AlterColumnNode' | 'AddConstraintNode' | 'DropConstraintNode' | 'CreateViewNode' | 'DropViewNode' | 'GeneratedNode' | 'DefaultValueNode' | 'OnNode' | 'ValuesNode' | 'CommonTableExpressionNameNode' | 'SelectModifierNode' | 'CreateTypeNode' | 'DropTypeNode' | 'ExplainNode' | 'DefaultInsertValueNode' | 'AggregateFunctionNode' | 'OverNode' | 'PartitionByNode' | 'PartitionByItemNode' | 'SetOperationNode' | 'BinaryOperationNode' | 'UnaryOperationNode' | 'UsingNode' | 'FunctionNode';
|
|
2
2
|
export interface OperationNode {
|
|
3
3
|
readonly kind: OperationNodeKind;
|
|
4
4
|
}
|