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,136 @@
|
|
|
1
|
+
/// <reference types="./postgres.d.ts" />
|
|
2
|
+
import { sql } from '../raw-builder/sql.js';
|
|
3
|
+
/**
|
|
4
|
+
* A postgres helper for aggregating a subquery (or other expression) into a JSONB array.
|
|
5
|
+
*
|
|
6
|
+
* NOTE: This helper is only guaranteed to fully work with the built-in `PostgresDialect`.
|
|
7
|
+
* While the produced SQL is compatibe with all PostgreSQL databases, some 3rd party dialects
|
|
8
|
+
* may not parse the nested results into arrays.
|
|
9
|
+
*
|
|
10
|
+
* ### Examples
|
|
11
|
+
*
|
|
12
|
+
* ```ts
|
|
13
|
+
* const result = await db
|
|
14
|
+
* .selectFrom('person')
|
|
15
|
+
* .select((eb) => [
|
|
16
|
+
* 'id',
|
|
17
|
+
* jsonArrayFrom(
|
|
18
|
+
* eb.selectFrom('pet')
|
|
19
|
+
* .select(['pet.id as pet_id', 'pet.name'])
|
|
20
|
+
* .where('pet.owner_id', '=', 'person.id')
|
|
21
|
+
* .orderBy('pet.name')
|
|
22
|
+
* ).as('pets')
|
|
23
|
+
* ])
|
|
24
|
+
* .execute()
|
|
25
|
+
*
|
|
26
|
+
* result[0].id
|
|
27
|
+
* result[0].pets[0].pet_id
|
|
28
|
+
* result[0].pets[0].name
|
|
29
|
+
* ```
|
|
30
|
+
*
|
|
31
|
+
* The generated SQL (PostgreSQL):
|
|
32
|
+
*
|
|
33
|
+
* ```sql
|
|
34
|
+
* select "id", (
|
|
35
|
+
* select coalesce(jsonb_agg(agg), '[]') from (
|
|
36
|
+
* select "pet"."id" as "pet_id", "pet"."name"
|
|
37
|
+
* from "pet"
|
|
38
|
+
* where "pet"."owner_id" = "person"."id"
|
|
39
|
+
* order by "pet"."name"
|
|
40
|
+
* ) as agg
|
|
41
|
+
* ) as "pets"
|
|
42
|
+
* from "person"
|
|
43
|
+
* ```
|
|
44
|
+
*/
|
|
45
|
+
export function jsonArrayFrom(expr) {
|
|
46
|
+
return sql `(select coalesce(jsonb_agg(agg), '[]') from ${expr} as agg)`;
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* A postgres helper for turning a subquery (or other expression) into a JSONB object.
|
|
50
|
+
*
|
|
51
|
+
* The subquery must only return one row.
|
|
52
|
+
*
|
|
53
|
+
* NOTE: This helper is only guaranteed to fully work with the built-in `PostgresDialect`.
|
|
54
|
+
* While the produced SQL is compatibe with all PostgreSQL databases, some 3rd party dialects
|
|
55
|
+
* may not parse the nested results into objects.
|
|
56
|
+
*
|
|
57
|
+
* ### Examples
|
|
58
|
+
*
|
|
59
|
+
* ```ts
|
|
60
|
+
* const result = await db
|
|
61
|
+
* .selectFrom('person')
|
|
62
|
+
* .select((eb) => [
|
|
63
|
+
* 'id',
|
|
64
|
+
* jsonObjectFrom(
|
|
65
|
+
* eb.selectFrom('pet')
|
|
66
|
+
* .select(['pet.id as pet_id', 'pet.name'])
|
|
67
|
+
* .where('pet.owner_id', '=', 'person.id')
|
|
68
|
+
* .where('pet.is_favorite', '=', true)
|
|
69
|
+
* ).as('favorite_pet')
|
|
70
|
+
* ])
|
|
71
|
+
* .execute()
|
|
72
|
+
*
|
|
73
|
+
* result[0].id
|
|
74
|
+
* result[0].favorite_pet.pet_id
|
|
75
|
+
* result[0].favorite_pet.name
|
|
76
|
+
* ```
|
|
77
|
+
*
|
|
78
|
+
* The generated SQL (PostgreSQL):
|
|
79
|
+
*
|
|
80
|
+
* ```sql
|
|
81
|
+
* select "id", (
|
|
82
|
+
* select to_jsonb(obj) from (
|
|
83
|
+
* select "pet"."id" as "pet_id", "pet"."name"
|
|
84
|
+
* from "pet"
|
|
85
|
+
* where "pet"."owner_id" = "person"."id"
|
|
86
|
+
* and "pet"."is_favorite" = $1
|
|
87
|
+
* ) as obj
|
|
88
|
+
* ) as "favorite_pet"
|
|
89
|
+
* from "person"
|
|
90
|
+
* ```
|
|
91
|
+
*/
|
|
92
|
+
export function jsonObjectFrom(expr) {
|
|
93
|
+
return sql `(select to_jsonb(obj) from ${expr} as obj)`;
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* The PostgreSQL `jsonb_build_object` function.
|
|
97
|
+
*
|
|
98
|
+
* NOTE: This helper is only guaranteed to fully work with the built-in `PostgresDialect`.
|
|
99
|
+
* While the produced SQL is compatibe with all PostgreSQL databases, some 3rd party dialects
|
|
100
|
+
* may not parse the nested results into objects.
|
|
101
|
+
*
|
|
102
|
+
* ### Examples
|
|
103
|
+
*
|
|
104
|
+
* ```ts
|
|
105
|
+
* const result = await db
|
|
106
|
+
* .selectFrom('person')
|
|
107
|
+
* .select((eb) => [
|
|
108
|
+
* 'id',
|
|
109
|
+
* jsonbBuildObject({
|
|
110
|
+
* first: eb.ref('first_name'),
|
|
111
|
+
* last: eb.ref('last_name'),
|
|
112
|
+
* full: sql<string>`first_name || ' ' || last_name`
|
|
113
|
+
* }).as('name')
|
|
114
|
+
* ])
|
|
115
|
+
* .execute()
|
|
116
|
+
*
|
|
117
|
+
* result[0].id
|
|
118
|
+
* result[0].name.first
|
|
119
|
+
* result[0].name.last
|
|
120
|
+
* result[0].name.full
|
|
121
|
+
* ```
|
|
122
|
+
*
|
|
123
|
+
* The generated SQL (PostgreSQL):
|
|
124
|
+
*
|
|
125
|
+
* ```sql
|
|
126
|
+
* select "id", jsonb_build_object(
|
|
127
|
+
* 'first', first_name,
|
|
128
|
+
* 'last', last_name,
|
|
129
|
+
* 'full', first_name || ' ' || last_name
|
|
130
|
+
* ) as "name"
|
|
131
|
+
* from "person"
|
|
132
|
+
* ```
|
|
133
|
+
*/
|
|
134
|
+
export function jsonbBuildObject(obj) {
|
|
135
|
+
return sql `jsonb_build_object(${sql.join(Object.keys(obj).flatMap((k) => [sql.lit(k), obj[k]]))})`;
|
|
136
|
+
}
|
package/dist/esm/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/esm/index.js
CHANGED
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
export * from './kysely.js';
|
|
3
3
|
export * from './query-creator.js';
|
|
4
4
|
export * from './expression/expression.js';
|
|
5
|
+
export { expressionBuilder, } from './expression/expression-builder.js';
|
|
5
6
|
export * from './query-builder/where-interface.js';
|
|
6
7
|
export * from './query-builder/returning-interface.js';
|
|
7
8
|
export * from './query-builder/having-interface.js';
|
|
@@ -11,7 +12,6 @@ export * from './query-builder/update-query-builder.js';
|
|
|
11
12
|
export * from './query-builder/delete-query-builder.js';
|
|
12
13
|
export * from './query-builder/no-result-error.js';
|
|
13
14
|
export * from './query-builder/join-builder.js';
|
|
14
|
-
export * from './query-builder/expression-builder.js';
|
|
15
15
|
export * from './query-builder/function-module.js';
|
|
16
16
|
export * from './query-builder/insert-result.js';
|
|
17
17
|
export * from './query-builder/delete-result.js';
|
|
@@ -164,6 +164,7 @@ export * from './operation-node/using-node.js';
|
|
|
164
164
|
export * from './util/column-type.js';
|
|
165
165
|
export * from './util/compilable.js';
|
|
166
166
|
export * from './util/explainable.js';
|
|
167
|
+
export * from './util/streamable.js';
|
|
167
168
|
export * from './util/log.js';
|
|
168
169
|
export * from './util/infer-result.js';
|
|
169
170
|
export { logOnce } from './util/log-once.js';
|
package/dist/esm/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/esm/kysely.js
CHANGED
|
@@ -9,8 +9,10 @@ import { RuntimeDriver } from './driver/runtime-driver.js';
|
|
|
9
9
|
import { SingleConnectionProvider } from './driver/single-connection-provider.js';
|
|
10
10
|
import { TRANSACTION_ISOLATION_LEVELS, } from './driver/driver.js';
|
|
11
11
|
import { preventAwait } from './util/prevent-await.js';
|
|
12
|
-
import {
|
|
12
|
+
import { createFunctionModule, } from './query-builder/function-module.js';
|
|
13
13
|
import { Log } from './util/log.js';
|
|
14
|
+
import { createQueryId } from './util/query-id.js';
|
|
15
|
+
import { isCompilable } from './util/compilable.js';
|
|
14
16
|
/**
|
|
15
17
|
* The main Kysely class.
|
|
16
18
|
*
|
|
@@ -133,7 +135,7 @@ export class Kysely extends QueryCreator {
|
|
|
133
135
|
* ```
|
|
134
136
|
*/
|
|
135
137
|
get fn() {
|
|
136
|
-
return
|
|
138
|
+
return createFunctionModule();
|
|
137
139
|
}
|
|
138
140
|
/**
|
|
139
141
|
* Creates a {@link TransactionBuilder} that can be used to run queries inside a transaction.
|
|
@@ -282,6 +284,15 @@ export class Kysely extends QueryCreator {
|
|
|
282
284
|
getExecutor() {
|
|
283
285
|
return this.#props.executor;
|
|
284
286
|
}
|
|
287
|
+
/**
|
|
288
|
+
* Executes a given compiled query or query builder.
|
|
289
|
+
*
|
|
290
|
+
* 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.
|
|
291
|
+
*/
|
|
292
|
+
executeQuery(query, queryId = createQueryId()) {
|
|
293
|
+
const compiledQuery = isCompilable(query) ? query.compile() : query;
|
|
294
|
+
return this.getExecutor().executeQuery(compiledQuery, queryId);
|
|
295
|
+
}
|
|
285
296
|
}
|
|
286
297
|
export class Transaction extends Kysely {
|
|
287
298
|
#props;
|
|
@@ -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;
|
|
@@ -8,11 +8,11 @@ export const AggregateFunctionNode = freeze({
|
|
|
8
8
|
is(node) {
|
|
9
9
|
return node.kind === 'AggregateFunctionNode';
|
|
10
10
|
},
|
|
11
|
-
create(aggregateFunction,
|
|
11
|
+
create(aggregateFunction, aggregated) {
|
|
12
12
|
return freeze({
|
|
13
13
|
kind: 'AggregateFunctionNode',
|
|
14
14
|
func: aggregateFunction,
|
|
15
|
-
|
|
15
|
+
aggregated,
|
|
16
16
|
});
|
|
17
17
|
},
|
|
18
18
|
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
|
}>;
|
|
@@ -10,10 +10,10 @@ export const DeleteQueryNode = freeze({
|
|
|
10
10
|
is(node) {
|
|
11
11
|
return node.kind === 'DeleteQueryNode';
|
|
12
12
|
},
|
|
13
|
-
create(
|
|
13
|
+
create(fromItems, withNode) {
|
|
14
14
|
return freeze({
|
|
15
15
|
kind: 'DeleteQueryNode',
|
|
16
|
-
from: FromNode.create(
|
|
16
|
+
from: FromNode.create(fromItems),
|
|
17
17
|
...(withNode && { with: withNode }),
|
|
18
18
|
});
|
|
19
19
|
},
|
|
@@ -31,12 +31,6 @@ export const DeleteQueryNode = freeze({
|
|
|
31
31
|
limit,
|
|
32
32
|
});
|
|
33
33
|
},
|
|
34
|
-
cloneWithExplain(deleteNode, explain) {
|
|
35
|
-
return freeze({
|
|
36
|
-
...deleteNode,
|
|
37
|
-
explain,
|
|
38
|
-
});
|
|
39
|
-
},
|
|
40
34
|
cloneWithUsing(deleteNode, tables) {
|
|
41
35
|
return freeze({
|
|
42
36
|
...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,17 @@
|
|
|
1
|
+
/// <reference types="./function-node.d.ts" />
|
|
2
|
+
import { freeze } from '../util/object-utils.js';
|
|
3
|
+
/**
|
|
4
|
+
* @internal
|
|
5
|
+
*/
|
|
6
|
+
export const FunctionNode = freeze({
|
|
7
|
+
is(node) {
|
|
8
|
+
return node.kind === 'FunctionNode';
|
|
9
|
+
},
|
|
10
|
+
create(func, args) {
|
|
11
|
+
return freeze({
|
|
12
|
+
kind: 'FunctionNode',
|
|
13
|
+
func,
|
|
14
|
+
arguments: args,
|
|
15
|
+
});
|
|
16
|
+
},
|
|
17
|
+
});
|
|
@@ -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;
|
|
@@ -111,6 +111,7 @@ export class OperationNodeTransformer {
|
|
|
111
111
|
BinaryOperationNode: this.transformBinaryOperation.bind(this),
|
|
112
112
|
UnaryOperationNode: this.transformUnaryOperation.bind(this),
|
|
113
113
|
UsingNode: this.transformUsing.bind(this),
|
|
114
|
+
FunctionNode: this.transformFunction.bind(this),
|
|
114
115
|
});
|
|
115
116
|
transformNode(node) {
|
|
116
117
|
if (!node) {
|
|
@@ -405,6 +406,7 @@ export class OperationNodeTransformer {
|
|
|
405
406
|
unique: node.unique,
|
|
406
407
|
using: this.transformNode(node.using),
|
|
407
408
|
ifNotExists: node.ifNotExists,
|
|
409
|
+
where: this.transformNode(node.where),
|
|
408
410
|
});
|
|
409
411
|
}
|
|
410
412
|
transformList(node) {
|
|
@@ -649,7 +651,7 @@ export class OperationNodeTransformer {
|
|
|
649
651
|
transformAggregateFunction(node) {
|
|
650
652
|
return requireAllProps({
|
|
651
653
|
kind: 'AggregateFunctionNode',
|
|
652
|
-
|
|
654
|
+
aggregated: this.transformNode(node.aggregated),
|
|
653
655
|
distinct: node.distinct,
|
|
654
656
|
filter: this.transformNode(node.filter),
|
|
655
657
|
func: node.func,
|
|
@@ -693,7 +695,14 @@ export class OperationNodeTransformer {
|
|
|
693
695
|
transformUsing(node) {
|
|
694
696
|
return requireAllProps({
|
|
695
697
|
kind: 'UsingNode',
|
|
696
|
-
tables: node.tables,
|
|
698
|
+
tables: this.transformNodeList(node.tables),
|
|
699
|
+
});
|
|
700
|
+
}
|
|
701
|
+
transformFunction(node) {
|
|
702
|
+
return requireAllProps({
|
|
703
|
+
kind: 'FunctionNode',
|
|
704
|
+
func: node.func,
|
|
705
|
+
arguments: this.transformNodeList(node.arguments),
|
|
697
706
|
});
|
|
698
707
|
}
|
|
699
708
|
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
|
}
|
|
@@ -84,6 +84,7 @@ export class OperationNodeVisitor {
|
|
|
84
84
|
BinaryOperationNode: this.visitBinaryOperation.bind(this),
|
|
85
85
|
UnaryOperationNode: this.visitUnaryOperation.bind(this),
|
|
86
86
|
UsingNode: this.visitUsing.bind(this),
|
|
87
|
+
FunctionNode: this.visitFunction.bind(this),
|
|
87
88
|
});
|
|
88
89
|
visitNode = (node) => {
|
|
89
90
|
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
|
}
|