kysely 0.19.7 → 0.19.10
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 +16 -10
- package/dist/cjs/dialect/sqlite/sqlite-introspector.js +1 -1
- package/dist/cjs/operation-node/create-type-node.d.ts +17 -0
- package/dist/cjs/operation-node/create-type-node.js +27 -0
- package/dist/cjs/operation-node/drop-type-node.d.ts +16 -0
- package/dist/cjs/operation-node/drop-type-node.js +25 -0
- package/dist/cjs/operation-node/operation-node-transformer.d.ts +9 -2
- package/dist/cjs/operation-node/operation-node-transformer.js +147 -122
- package/dist/cjs/operation-node/operation-node-visitor.d.ts +6 -0
- package/dist/cjs/operation-node/operation-node-visitor.js +3 -0
- package/dist/cjs/operation-node/operation-node.d.ts +1 -1
- package/dist/cjs/operation-node/select-modifier-node.d.ts +16 -0
- package/dist/cjs/operation-node/select-modifier-node.js +24 -0
- package/dist/cjs/operation-node/select-query-node.d.ts +5 -5
- package/dist/cjs/operation-node/select-query-node.js +11 -9
- package/dist/cjs/plugin/with-schema/with-schema-transformer.d.ts +4 -0
- package/dist/cjs/plugin/with-schema/with-schema-transformer.js +6 -0
- package/dist/cjs/query-builder/select-query-builder.d.ts +50 -6
- package/dist/cjs/query-builder/select-query-builder.js +68 -13
- package/dist/cjs/query-compiler/default-query-compiler.d.ts +6 -0
- package/dist/cjs/query-compiler/default-query-compiler.js +29 -7
- package/dist/cjs/query-compiler/query-compiler.d.ts +3 -1
- package/dist/cjs/schema/create-type-builder.d.ts +19 -0
- package/dist/cjs/schema/create-type-builder.js +29 -0
- package/dist/cjs/schema/drop-type-builder.d.ts +19 -0
- package/dist/cjs/schema/drop-type-builder.js +31 -0
- package/dist/cjs/schema/schema.d.ts +32 -0
- package/dist/cjs/schema/schema.js +46 -0
- package/dist/cjs/util/require-all-props.d.ts +43 -0
- package/dist/cjs/util/require-all-props.js +40 -0
- package/dist/esm/dialect/sqlite/sqlite-introspector.js +1 -1
- package/dist/esm/operation-node/create-type-node.d.ts +17 -0
- package/dist/esm/operation-node/create-type-node.js +25 -0
- package/dist/esm/operation-node/drop-type-node.d.ts +16 -0
- package/dist/esm/operation-node/drop-type-node.js +23 -0
- package/dist/esm/operation-node/operation-node-transformer.d.ts +9 -2
- package/dist/esm/operation-node/operation-node-transformer.js +147 -122
- package/dist/esm/operation-node/operation-node-visitor.d.ts +6 -0
- package/dist/esm/operation-node/operation-node-visitor.js +3 -0
- package/dist/esm/operation-node/operation-node.d.ts +1 -1
- package/dist/esm/operation-node/select-modifier-node.d.ts +16 -0
- package/dist/esm/operation-node/select-modifier-node.js +22 -0
- package/dist/esm/operation-node/select-query-node.d.ts +5 -5
- package/dist/esm/operation-node/select-query-node.js +11 -9
- package/dist/esm/plugin/with-schema/with-schema-transformer.d.ts +4 -0
- package/dist/esm/plugin/with-schema/with-schema-transformer.js +6 -0
- package/dist/esm/query-builder/select-query-builder.d.ts +50 -6
- package/dist/esm/query-builder/select-query-builder.js +68 -13
- package/dist/esm/query-compiler/default-query-compiler.d.ts +6 -0
- package/dist/esm/query-compiler/default-query-compiler.js +29 -7
- package/dist/esm/query-compiler/query-compiler.d.ts +3 -1
- package/dist/esm/schema/create-type-builder.d.ts +19 -0
- package/dist/esm/schema/create-type-builder.js +26 -0
- package/dist/esm/schema/drop-type-builder.d.ts +19 -0
- package/dist/esm/schema/drop-type-builder.js +28 -0
- package/dist/esm/schema/schema.d.ts +32 -0
- package/dist/esm/schema/schema.js +46 -0
- package/dist/esm/util/require-all-props.d.ts +43 -0
- package/dist/esm/util/require-all-props.js +37 -0
- package/package.json +1 -1
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.SelectModifierNode = void 0;
|
|
4
|
+
const object_utils_js_1 = require("../util/object-utils.js");
|
|
5
|
+
/**
|
|
6
|
+
* @internal
|
|
7
|
+
*/
|
|
8
|
+
exports.SelectModifierNode = (0, object_utils_js_1.freeze)({
|
|
9
|
+
is(node) {
|
|
10
|
+
return node.kind === 'SelectModifierNode';
|
|
11
|
+
},
|
|
12
|
+
create(modifier) {
|
|
13
|
+
return (0, object_utils_js_1.freeze)({
|
|
14
|
+
kind: 'SelectModifierNode',
|
|
15
|
+
modifier,
|
|
16
|
+
});
|
|
17
|
+
},
|
|
18
|
+
createWithRaw(modifier) {
|
|
19
|
+
return (0, object_utils_js_1.freeze)({
|
|
20
|
+
kind: 'SelectModifierNode',
|
|
21
|
+
rawModifier: modifier,
|
|
22
|
+
});
|
|
23
|
+
},
|
|
24
|
+
});
|
|
@@ -13,18 +13,18 @@ import { SelectionNode } from './selection-node.js';
|
|
|
13
13
|
import { WhereNode } from './where-node.js';
|
|
14
14
|
import { WithNode } from './with-node.js';
|
|
15
15
|
import { UnionNode } from './union-node.js';
|
|
16
|
-
|
|
16
|
+
import { SelectModifierNode } from './select-modifier-node.js';
|
|
17
17
|
export interface SelectQueryNode extends OperationNode {
|
|
18
18
|
readonly kind: 'SelectQueryNode';
|
|
19
19
|
readonly from: FromNode;
|
|
20
20
|
readonly selections?: ReadonlyArray<SelectionNode>;
|
|
21
21
|
readonly distinctOnSelections?: ReadonlyArray<SelectionNode>;
|
|
22
|
-
readonly distinct?: boolean;
|
|
23
22
|
readonly joins?: ReadonlyArray<JoinNode>;
|
|
24
23
|
readonly groupBy?: GroupByNode;
|
|
25
24
|
readonly orderBy?: OrderByNode;
|
|
26
25
|
readonly where?: WhereNode;
|
|
27
|
-
readonly
|
|
26
|
+
readonly frontModifiers?: ReadonlyArray<SelectModifierNode>;
|
|
27
|
+
readonly endModifiers?: ReadonlyArray<SelectModifierNode>;
|
|
28
28
|
readonly limit?: LimitNode;
|
|
29
29
|
readonly offset?: OffsetNode;
|
|
30
30
|
readonly with?: WithNode;
|
|
@@ -39,13 +39,13 @@ export declare const SelectQueryNode: Readonly<{
|
|
|
39
39
|
create(fromItems: ReadonlyArray<TableExpressionNode>, withNode?: WithNode): SelectQueryNode;
|
|
40
40
|
cloneWithSelections(select: SelectQueryNode, selections: ReadonlyArray<SelectionNode>): SelectQueryNode;
|
|
41
41
|
cloneWithDistinctOnSelections(select: SelectQueryNode, selections: ReadonlyArray<SelectionNode>): SelectQueryNode;
|
|
42
|
-
|
|
42
|
+
cloneWithFrontModifier(select: SelectQueryNode, modifier: SelectModifierNode): SelectQueryNode;
|
|
43
|
+
cloneWithEndModifier(select: SelectQueryNode, modifier: SelectModifierNode): SelectQueryNode;
|
|
43
44
|
cloneWithOrderByItem(selectNode: SelectQueryNode, item: OrderByItemNode): SelectQueryNode;
|
|
44
45
|
cloneWithGroupByItems(selectNode: SelectQueryNode, items: ReadonlyArray<GroupByItemNode>): SelectQueryNode;
|
|
45
46
|
cloneWithLimit(selectNode: SelectQueryNode, limit: LimitNode): SelectQueryNode;
|
|
46
47
|
cloneWithOffset(selectNode: SelectQueryNode, offset: OffsetNode): SelectQueryNode;
|
|
47
48
|
cloneWithHaving(selectNode: SelectQueryNode, filter: FilterExpressionNode): SelectQueryNode;
|
|
48
49
|
cloneWithOrHaving(selectNode: SelectQueryNode, filter: FilterExpressionNode): SelectQueryNode;
|
|
49
|
-
cloneWithDistinct(selectNode: SelectQueryNode): SelectQueryNode;
|
|
50
50
|
cloneWithUnion(selectNode: SelectQueryNode, union: UnionNode): SelectQueryNode;
|
|
51
51
|
}>;
|
|
@@ -36,11 +36,19 @@ exports.SelectQueryNode = (0, object_utils_js_1.freeze)({
|
|
|
36
36
|
: (0, object_utils_js_1.freeze)(selections),
|
|
37
37
|
});
|
|
38
38
|
},
|
|
39
|
-
|
|
39
|
+
cloneWithFrontModifier(select, modifier) {
|
|
40
40
|
return (0, object_utils_js_1.freeze)({
|
|
41
41
|
...select,
|
|
42
|
-
|
|
43
|
-
? (0, object_utils_js_1.freeze)([...select.
|
|
42
|
+
frontModifiers: select.frontModifiers
|
|
43
|
+
? (0, object_utils_js_1.freeze)([...select.frontModifiers, modifier])
|
|
44
|
+
: (0, object_utils_js_1.freeze)([modifier]),
|
|
45
|
+
});
|
|
46
|
+
},
|
|
47
|
+
cloneWithEndModifier(select, modifier) {
|
|
48
|
+
return (0, object_utils_js_1.freeze)({
|
|
49
|
+
...select,
|
|
50
|
+
endModifiers: select.endModifiers
|
|
51
|
+
? (0, object_utils_js_1.freeze)([...select.endModifiers, modifier])
|
|
44
52
|
: (0, object_utils_js_1.freeze)([modifier]),
|
|
45
53
|
});
|
|
46
54
|
},
|
|
@@ -88,12 +96,6 @@ exports.SelectQueryNode = (0, object_utils_js_1.freeze)({
|
|
|
88
96
|
: having_node_js_1.HavingNode.create(filter),
|
|
89
97
|
});
|
|
90
98
|
},
|
|
91
|
-
cloneWithDistinct(selectNode) {
|
|
92
|
-
return (0, object_utils_js_1.freeze)({
|
|
93
|
-
...selectNode,
|
|
94
|
-
distinct: true,
|
|
95
|
-
});
|
|
96
|
-
},
|
|
97
99
|
cloneWithUnion(selectNode, union) {
|
|
98
100
|
return (0, object_utils_js_1.freeze)({
|
|
99
101
|
...selectNode,
|
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
import { AlterTableNode } from '../../operation-node/alter-table-node.js';
|
|
2
2
|
import { CreateIndexNode } from '../../operation-node/create-index-node.js';
|
|
3
3
|
import { CreateTableNode } from '../../operation-node/create-table-node.js';
|
|
4
|
+
import { CreateTypeNode } from '../../operation-node/create-type-node.js';
|
|
4
5
|
import { CreateViewNode } from '../../operation-node/create-view-node.js';
|
|
5
6
|
import { DeleteQueryNode } from '../../operation-node/delete-query-node.js';
|
|
6
7
|
import { DropIndexNode } from '../../operation-node/drop-index-node.js';
|
|
7
8
|
import { DropTableNode } from '../../operation-node/drop-table-node.js';
|
|
9
|
+
import { DropTypeNode } from '../../operation-node/drop-type-node.js';
|
|
8
10
|
import { DropViewNode } from '../../operation-node/drop-view-node.js';
|
|
9
11
|
import { InsertQueryNode } from '../../operation-node/insert-query-node.js';
|
|
10
12
|
import { OperationNodeTransformer } from '../../operation-node/operation-node-transformer.js';
|
|
@@ -24,6 +26,8 @@ export declare class WithSchemaTransformer extends OperationNodeTransformer {
|
|
|
24
26
|
protected transformDropIndex(node: DropIndexNode): DropIndexNode;
|
|
25
27
|
protected transformCreateView(node: CreateViewNode): CreateViewNode;
|
|
26
28
|
protected transformDropView(node: DropViewNode): DropViewNode;
|
|
29
|
+
protected transformCreateType(node: CreateTypeNode): CreateTypeNode;
|
|
30
|
+
protected transformDropType(node: DropTypeNode): DropTypeNode;
|
|
27
31
|
protected transformAlterTable(node: AlterTableNode): AlterTableNode;
|
|
28
32
|
protected transformTable(node: TableNode): TableNode;
|
|
29
33
|
}
|
|
@@ -41,6 +41,12 @@ class WithSchemaTransformer extends operation_node_transformer_js_1.OperationNod
|
|
|
41
41
|
transformDropView(node) {
|
|
42
42
|
return this.#transformRoot(node, (node) => super.transformDropView(node));
|
|
43
43
|
}
|
|
44
|
+
transformCreateType(node) {
|
|
45
|
+
return this.#transformRoot(node, (node) => super.transformCreateType(node));
|
|
46
|
+
}
|
|
47
|
+
transformDropType(node) {
|
|
48
|
+
return this.#transformRoot(node, (node) => super.transformDropType(node));
|
|
49
|
+
}
|
|
44
50
|
transformAlterTable(node) {
|
|
45
51
|
return this.#transformRoot(node, (node) => super.transformAlterTable(node));
|
|
46
52
|
}
|
|
@@ -653,6 +653,50 @@ export declare class SelectQueryBuilder<DB, TB extends keyof DB, O> implements W
|
|
|
653
653
|
*/
|
|
654
654
|
distinctOn<SE extends SelectExpression<DB, TB>>(selections: ReadonlyArray<SE>): SelectQueryBuilder<DB, TB, O>;
|
|
655
655
|
distinctOn<SE extends SelectExpression<DB, TB>>(selection: SE): SelectQueryBuilder<DB, TB, O>;
|
|
656
|
+
/**
|
|
657
|
+
* This can be used to add any additional SQL to the front of the query __after__ the `select` keyword.
|
|
658
|
+
*
|
|
659
|
+
* ### Examples
|
|
660
|
+
*
|
|
661
|
+
* ```ts
|
|
662
|
+
* db.selectFrom('person')
|
|
663
|
+
* .modifyFront(sql`sql_no_cache`)
|
|
664
|
+
* .select('first_name')
|
|
665
|
+
* .execute()
|
|
666
|
+
* ```
|
|
667
|
+
*
|
|
668
|
+
* The generated SQL (MySQL):
|
|
669
|
+
*
|
|
670
|
+
* ```sql
|
|
671
|
+
* select sql_no_cache `first_name`
|
|
672
|
+
* from `person`
|
|
673
|
+
* ```
|
|
674
|
+
*/
|
|
675
|
+
modifyFront(modifier: AnyRawBuilder): SelectQueryBuilder<DB, TB, O>;
|
|
676
|
+
/**
|
|
677
|
+
* This can be used to add any additional SQL to the end of the query.
|
|
678
|
+
*
|
|
679
|
+
* Also see {@link forUpdate}, {@link forShare}, {@link forKeyShare}, {@link forNoKeyUpdate}
|
|
680
|
+
* {@link skipLocked} and {@link noWait}.
|
|
681
|
+
*
|
|
682
|
+
* ### Examples
|
|
683
|
+
*
|
|
684
|
+
* ```ts
|
|
685
|
+
* db.selectFrom('person')
|
|
686
|
+
* .select('first_name')
|
|
687
|
+
* .modifyEnd(sql`for update`)
|
|
688
|
+
* .execute()
|
|
689
|
+
* ```
|
|
690
|
+
*
|
|
691
|
+
* The generated SQL (PostgreSQL):
|
|
692
|
+
*
|
|
693
|
+
* ```sql
|
|
694
|
+
* select "first_name"
|
|
695
|
+
* from "person"
|
|
696
|
+
* for update
|
|
697
|
+
* ```
|
|
698
|
+
*/
|
|
699
|
+
modifyEnd(modifier: AnyRawBuilder): SelectQueryBuilder<DB, TB, O>;
|
|
656
700
|
/**
|
|
657
701
|
* Makes the selection distinct.
|
|
658
702
|
*
|
|
@@ -673,27 +717,27 @@ export declare class SelectQueryBuilder<DB, TB extends keyof DB, O> implements W
|
|
|
673
717
|
*/
|
|
674
718
|
distinct(): SelectQueryBuilder<DB, TB, O>;
|
|
675
719
|
/**
|
|
676
|
-
* Adds the `for update`
|
|
720
|
+
* Adds the `for update` modifier to a select query on supported databases.
|
|
677
721
|
*/
|
|
678
722
|
forUpdate(): SelectQueryBuilder<DB, TB, O>;
|
|
679
723
|
/**
|
|
680
|
-
* Adds the `for share`
|
|
724
|
+
* Adds the `for share` modifier to a select query on supported databases.
|
|
681
725
|
*/
|
|
682
726
|
forShare(): SelectQueryBuilder<DB, TB, O>;
|
|
683
727
|
/**
|
|
684
|
-
* Adds the `for key share`
|
|
728
|
+
* Adds the `for key share` modifier to a select query on supported databases.
|
|
685
729
|
*/
|
|
686
730
|
forKeyShare(): SelectQueryBuilder<DB, TB, O>;
|
|
687
731
|
/**
|
|
688
|
-
* Adds the `for no key update`
|
|
732
|
+
* Adds the `for no key update` modifier to a select query on supported databases.
|
|
689
733
|
*/
|
|
690
734
|
forNoKeyUpdate(): SelectQueryBuilder<DB, TB, O>;
|
|
691
735
|
/**
|
|
692
|
-
* Adds the `skip locked`
|
|
736
|
+
* Adds the `skip locked` modifier to a select query on supported databases.
|
|
693
737
|
*/
|
|
694
738
|
skipLocked(): SelectQueryBuilder<DB, TB, O>;
|
|
695
739
|
/**
|
|
696
|
-
* Adds the `nowait`
|
|
740
|
+
* Adds the `nowait` modifier to a select query on supported databases.
|
|
697
741
|
*/
|
|
698
742
|
noWait(): SelectQueryBuilder<DB, TB, O>;
|
|
699
743
|
/**
|
|
@@ -16,6 +16,7 @@ const group_by_parser_js_1 = require("../parser/group-by-parser.js");
|
|
|
16
16
|
const union_parser_js_1 = require("../parser/union-parser.js");
|
|
17
17
|
const no_result_error_js_1 = require("./no-result-error.js");
|
|
18
18
|
const identifier_node_js_1 = require("../operation-node/identifier-node.js");
|
|
19
|
+
const select_modifier_node_js_1 = require("../operation-node/select-modifier-node.js");
|
|
19
20
|
class SelectQueryBuilder {
|
|
20
21
|
#props;
|
|
21
22
|
constructor(props) {
|
|
@@ -129,6 +130,60 @@ class SelectQueryBuilder {
|
|
|
129
130
|
queryNode: select_query_node_js_1.SelectQueryNode.cloneWithDistinctOnSelections(this.#props.queryNode, (0, select_parser_js_1.parseSelectExpressionOrList)(selection)),
|
|
130
131
|
});
|
|
131
132
|
}
|
|
133
|
+
/**
|
|
134
|
+
* This can be used to add any additional SQL to the front of the query __after__ the `select` keyword.
|
|
135
|
+
*
|
|
136
|
+
* ### Examples
|
|
137
|
+
*
|
|
138
|
+
* ```ts
|
|
139
|
+
* db.selectFrom('person')
|
|
140
|
+
* .modifyFront(sql`sql_no_cache`)
|
|
141
|
+
* .select('first_name')
|
|
142
|
+
* .execute()
|
|
143
|
+
* ```
|
|
144
|
+
*
|
|
145
|
+
* The generated SQL (MySQL):
|
|
146
|
+
*
|
|
147
|
+
* ```sql
|
|
148
|
+
* select sql_no_cache `first_name`
|
|
149
|
+
* from `person`
|
|
150
|
+
* ```
|
|
151
|
+
*/
|
|
152
|
+
modifyFront(modifier) {
|
|
153
|
+
return new SelectQueryBuilder({
|
|
154
|
+
...this.#props,
|
|
155
|
+
queryNode: select_query_node_js_1.SelectQueryNode.cloneWithFrontModifier(this.#props.queryNode, select_modifier_node_js_1.SelectModifierNode.createWithRaw(modifier.toOperationNode())),
|
|
156
|
+
});
|
|
157
|
+
}
|
|
158
|
+
/**
|
|
159
|
+
* This can be used to add any additional SQL to the end of the query.
|
|
160
|
+
*
|
|
161
|
+
* Also see {@link forUpdate}, {@link forShare}, {@link forKeyShare}, {@link forNoKeyUpdate}
|
|
162
|
+
* {@link skipLocked} and {@link noWait}.
|
|
163
|
+
*
|
|
164
|
+
* ### Examples
|
|
165
|
+
*
|
|
166
|
+
* ```ts
|
|
167
|
+
* db.selectFrom('person')
|
|
168
|
+
* .select('first_name')
|
|
169
|
+
* .modifyEnd(sql`for update`)
|
|
170
|
+
* .execute()
|
|
171
|
+
* ```
|
|
172
|
+
*
|
|
173
|
+
* The generated SQL (PostgreSQL):
|
|
174
|
+
*
|
|
175
|
+
* ```sql
|
|
176
|
+
* select "first_name"
|
|
177
|
+
* from "person"
|
|
178
|
+
* for update
|
|
179
|
+
* ```
|
|
180
|
+
*/
|
|
181
|
+
modifyEnd(modifier) {
|
|
182
|
+
return new SelectQueryBuilder({
|
|
183
|
+
...this.#props,
|
|
184
|
+
queryNode: select_query_node_js_1.SelectQueryNode.cloneWithEndModifier(this.#props.queryNode, select_modifier_node_js_1.SelectModifierNode.createWithRaw(modifier.toOperationNode())),
|
|
185
|
+
});
|
|
186
|
+
}
|
|
132
187
|
/**
|
|
133
188
|
* Makes the selection distinct.
|
|
134
189
|
*
|
|
@@ -150,61 +205,61 @@ class SelectQueryBuilder {
|
|
|
150
205
|
distinct() {
|
|
151
206
|
return new SelectQueryBuilder({
|
|
152
207
|
...this.#props,
|
|
153
|
-
queryNode: select_query_node_js_1.SelectQueryNode.
|
|
208
|
+
queryNode: select_query_node_js_1.SelectQueryNode.cloneWithFrontModifier(this.#props.queryNode, select_modifier_node_js_1.SelectModifierNode.create('Distinct')),
|
|
154
209
|
});
|
|
155
210
|
}
|
|
156
211
|
/**
|
|
157
|
-
* Adds the `for update`
|
|
212
|
+
* Adds the `for update` modifier to a select query on supported databases.
|
|
158
213
|
*/
|
|
159
214
|
forUpdate() {
|
|
160
215
|
return new SelectQueryBuilder({
|
|
161
216
|
...this.#props,
|
|
162
|
-
queryNode: select_query_node_js_1.SelectQueryNode.
|
|
217
|
+
queryNode: select_query_node_js_1.SelectQueryNode.cloneWithEndModifier(this.#props.queryNode, select_modifier_node_js_1.SelectModifierNode.create('ForUpdate')),
|
|
163
218
|
});
|
|
164
219
|
}
|
|
165
220
|
/**
|
|
166
|
-
* Adds the `for share`
|
|
221
|
+
* Adds the `for share` modifier to a select query on supported databases.
|
|
167
222
|
*/
|
|
168
223
|
forShare() {
|
|
169
224
|
return new SelectQueryBuilder({
|
|
170
225
|
...this.#props,
|
|
171
|
-
queryNode: select_query_node_js_1.SelectQueryNode.
|
|
226
|
+
queryNode: select_query_node_js_1.SelectQueryNode.cloneWithEndModifier(this.#props.queryNode, select_modifier_node_js_1.SelectModifierNode.create('ForShare')),
|
|
172
227
|
});
|
|
173
228
|
}
|
|
174
229
|
/**
|
|
175
|
-
* Adds the `for key share`
|
|
230
|
+
* Adds the `for key share` modifier to a select query on supported databases.
|
|
176
231
|
*/
|
|
177
232
|
forKeyShare() {
|
|
178
233
|
return new SelectQueryBuilder({
|
|
179
234
|
...this.#props,
|
|
180
|
-
queryNode: select_query_node_js_1.SelectQueryNode.
|
|
235
|
+
queryNode: select_query_node_js_1.SelectQueryNode.cloneWithEndModifier(this.#props.queryNode, select_modifier_node_js_1.SelectModifierNode.create('ForKeyShare')),
|
|
181
236
|
});
|
|
182
237
|
}
|
|
183
238
|
/**
|
|
184
|
-
* Adds the `for no key update`
|
|
239
|
+
* Adds the `for no key update` modifier to a select query on supported databases.
|
|
185
240
|
*/
|
|
186
241
|
forNoKeyUpdate() {
|
|
187
242
|
return new SelectQueryBuilder({
|
|
188
243
|
...this.#props,
|
|
189
|
-
queryNode: select_query_node_js_1.SelectQueryNode.
|
|
244
|
+
queryNode: select_query_node_js_1.SelectQueryNode.cloneWithEndModifier(this.#props.queryNode, select_modifier_node_js_1.SelectModifierNode.create('ForNoKeyUpdate')),
|
|
190
245
|
});
|
|
191
246
|
}
|
|
192
247
|
/**
|
|
193
|
-
* Adds the `skip locked`
|
|
248
|
+
* Adds the `skip locked` modifier to a select query on supported databases.
|
|
194
249
|
*/
|
|
195
250
|
skipLocked() {
|
|
196
251
|
return new SelectQueryBuilder({
|
|
197
252
|
...this.#props,
|
|
198
|
-
queryNode: select_query_node_js_1.SelectQueryNode.
|
|
253
|
+
queryNode: select_query_node_js_1.SelectQueryNode.cloneWithEndModifier(this.#props.queryNode, select_modifier_node_js_1.SelectModifierNode.create('SkipLocked')),
|
|
199
254
|
});
|
|
200
255
|
}
|
|
201
256
|
/**
|
|
202
|
-
* Adds the `nowait`
|
|
257
|
+
* Adds the `nowait` modifier to a select query on supported databases.
|
|
203
258
|
*/
|
|
204
259
|
noWait() {
|
|
205
260
|
return new SelectQueryBuilder({
|
|
206
261
|
...this.#props,
|
|
207
|
-
queryNode: select_query_node_js_1.SelectQueryNode.
|
|
262
|
+
queryNode: select_query_node_js_1.SelectQueryNode.cloneWithEndModifier(this.#props.queryNode, select_modifier_node_js_1.SelectModifierNode.create('NoWait')),
|
|
208
263
|
});
|
|
209
264
|
}
|
|
210
265
|
selectAll(table) {
|
|
@@ -68,6 +68,9 @@ import { DefaultValueNode } from '../operation-node/default-value-node.js';
|
|
|
68
68
|
import { OnNode } from '../operation-node/on-node.js';
|
|
69
69
|
import { ValuesNode } from '../operation-node/values-node.js';
|
|
70
70
|
import { CommonTableExpressionNameNode } from '../operation-node/common-table-expression-name-node.js';
|
|
71
|
+
import { SelectModifierNode } from '../operation-node/select-modifier-node.js';
|
|
72
|
+
import { CreateTypeNode } from '../operation-node/create-type-node.js';
|
|
73
|
+
import { DropTypeNode } from '../operation-node/drop-type-node.js';
|
|
71
74
|
export declare class DefaultQueryCompiler extends OperationNodeVisitor implements QueryCompiler {
|
|
72
75
|
#private;
|
|
73
76
|
protected get numParameters(): number;
|
|
@@ -143,6 +146,9 @@ export declare class DefaultQueryCompiler extends OperationNodeVisitor implement
|
|
|
143
146
|
protected visitDropView(node: DropViewNode): void;
|
|
144
147
|
protected visitGenerated(node: GeneratedNode): void;
|
|
145
148
|
protected visitDefaultValue(node: DefaultValueNode): void;
|
|
149
|
+
protected visitSelectModifier(node: SelectModifierNode): void;
|
|
150
|
+
protected visitCreateType(node: CreateTypeNode): void;
|
|
151
|
+
protected visitDropType(node: DropTypeNode): void;
|
|
146
152
|
protected append(str: string): void;
|
|
147
153
|
protected appendValue(parameter: unknown): void;
|
|
148
154
|
protected getLeftIdentifierWrapper(): string;
|
|
@@ -44,8 +44,8 @@ class DefaultQueryCompiler extends operation_node_visitor_js_1.OperationNodeVisi
|
|
|
44
44
|
this.compileDistinctOn(node.distinctOnSelections);
|
|
45
45
|
this.append(' ');
|
|
46
46
|
}
|
|
47
|
-
if (node.
|
|
48
|
-
this.
|
|
47
|
+
if (node.frontModifiers && node.frontModifiers.length > 0) {
|
|
48
|
+
this.compileList(node.frontModifiers, ' ');
|
|
49
49
|
this.append(' ');
|
|
50
50
|
}
|
|
51
51
|
if (node.selections) {
|
|
@@ -85,11 +85,9 @@ class DefaultQueryCompiler extends operation_node_visitor_js_1.OperationNodeVisi
|
|
|
85
85
|
this.append(' ');
|
|
86
86
|
this.visitNode(node.offset);
|
|
87
87
|
}
|
|
88
|
-
if (node.
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
this.append(SELECT_MODIFIER_SQL[modifier]);
|
|
92
|
-
});
|
|
88
|
+
if (node.endModifiers && node.endModifiers.length > 0) {
|
|
89
|
+
this.append(' ');
|
|
90
|
+
this.compileList(node.endModifiers, ' ');
|
|
93
91
|
}
|
|
94
92
|
if (wrapInParens) {
|
|
95
93
|
this.append(')');
|
|
@@ -785,6 +783,29 @@ class DefaultQueryCompiler extends operation_node_visitor_js_1.OperationNodeVisi
|
|
|
785
783
|
this.append('default ');
|
|
786
784
|
this.visitNode(node.defaultValue);
|
|
787
785
|
}
|
|
786
|
+
visitSelectModifier(node) {
|
|
787
|
+
if (node.rawModifier) {
|
|
788
|
+
this.visitNode(node.rawModifier);
|
|
789
|
+
}
|
|
790
|
+
else {
|
|
791
|
+
this.append(SELECT_MODIFIER_SQL[node.modifier]);
|
|
792
|
+
}
|
|
793
|
+
}
|
|
794
|
+
visitCreateType(node) {
|
|
795
|
+
this.append('create type ');
|
|
796
|
+
this.visitNode(node.name);
|
|
797
|
+
if (node.enum) {
|
|
798
|
+
this.append(' as enum ');
|
|
799
|
+
this.visitNode(node.enum);
|
|
800
|
+
}
|
|
801
|
+
}
|
|
802
|
+
visitDropType(node) {
|
|
803
|
+
this.append('drop type ');
|
|
804
|
+
if (node.ifExists) {
|
|
805
|
+
this.append('if exists ');
|
|
806
|
+
}
|
|
807
|
+
this.visitNode(node.name);
|
|
808
|
+
}
|
|
788
809
|
append(str) {
|
|
789
810
|
this.#sql += str;
|
|
790
811
|
}
|
|
@@ -833,6 +854,7 @@ const SELECT_MODIFIER_SQL = (0, object_utils_js_1.freeze)({
|
|
|
833
854
|
ForShare: 'for share',
|
|
834
855
|
NoWait: 'nowait',
|
|
835
856
|
SkipLocked: 'skip locked',
|
|
857
|
+
Distinct: 'distinct',
|
|
836
858
|
});
|
|
837
859
|
const JOIN_TYPE_SQL = (0, object_utils_js_1.freeze)({
|
|
838
860
|
InnerJoin: 'inner join',
|
|
@@ -2,15 +2,17 @@ import { AlterTableNode } from '../operation-node/alter-table-node.js';
|
|
|
2
2
|
import { CreateIndexNode } from '../operation-node/create-index-node.js';
|
|
3
3
|
import { CreateSchemaNode } from '../operation-node/create-schema-node.js';
|
|
4
4
|
import { CreateTableNode } from '../operation-node/create-table-node.js';
|
|
5
|
+
import { CreateTypeNode } from '../operation-node/create-type-node.js';
|
|
5
6
|
import { CreateViewNode } from '../operation-node/create-view-node.js';
|
|
6
7
|
import { DropIndexNode } from '../operation-node/drop-index-node.js';
|
|
7
8
|
import { DropSchemaNode } from '../operation-node/drop-schema-node.js';
|
|
8
9
|
import { DropTableNode } from '../operation-node/drop-table-node.js';
|
|
10
|
+
import { DropTypeNode } from '../operation-node/drop-type-node.js';
|
|
9
11
|
import { DropViewNode } from '../operation-node/drop-view-node.js';
|
|
10
12
|
import { QueryNode } from '../operation-node/query-node.js';
|
|
11
13
|
import { RawNode } from '../operation-node/raw-node.js';
|
|
12
14
|
import { CompiledQuery } from './compiled-query.js';
|
|
13
|
-
export declare type RootOperationNode = QueryNode | CreateTableNode | CreateIndexNode | CreateSchemaNode | CreateViewNode | DropTableNode | DropIndexNode | DropSchemaNode | DropViewNode | AlterTableNode | RawNode;
|
|
15
|
+
export declare type RootOperationNode = QueryNode | CreateTableNode | CreateIndexNode | CreateSchemaNode | CreateViewNode | DropTableNode | DropIndexNode | DropSchemaNode | DropViewNode | AlterTableNode | RawNode | CreateTypeNode | DropTypeNode;
|
|
14
16
|
/**
|
|
15
17
|
* a `QueryCompiler` compiles a query expressed as a tree of `OperationNodes` into SQL.
|
|
16
18
|
*/
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { OperationNodeSource } from '../operation-node/operation-node-source.js';
|
|
2
|
+
import { CompiledQuery } from '../query-compiler/compiled-query.js';
|
|
3
|
+
import { Compilable } from '../util/compilable.js';
|
|
4
|
+
import { QueryExecutor } from '../query-executor/query-executor.js';
|
|
5
|
+
import { QueryId } from '../util/query-id.js';
|
|
6
|
+
import { CreateTypeNode } from '../operation-node/create-type-node.js';
|
|
7
|
+
export declare class CreateTypeBuilder implements OperationNodeSource, Compilable {
|
|
8
|
+
#private;
|
|
9
|
+
constructor(props: CreateTypeBuilderProps);
|
|
10
|
+
toOperationNode(): CreateTypeNode;
|
|
11
|
+
asEnum(values: string[]): CreateTypeBuilder;
|
|
12
|
+
compile(): CompiledQuery;
|
|
13
|
+
execute(): Promise<void>;
|
|
14
|
+
}
|
|
15
|
+
export interface CreateTypeBuilderProps {
|
|
16
|
+
readonly queryId: QueryId;
|
|
17
|
+
readonly executor: QueryExecutor;
|
|
18
|
+
readonly createTypeNode: CreateTypeNode;
|
|
19
|
+
}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.CreateTypeBuilder = void 0;
|
|
4
|
+
const prevent_await_js_1 = require("../util/prevent-await.js");
|
|
5
|
+
const object_utils_js_1 = require("../util/object-utils.js");
|
|
6
|
+
const create_type_node_js_1 = require("../operation-node/create-type-node.js");
|
|
7
|
+
class CreateTypeBuilder {
|
|
8
|
+
#props;
|
|
9
|
+
constructor(props) {
|
|
10
|
+
this.#props = (0, object_utils_js_1.freeze)(props);
|
|
11
|
+
}
|
|
12
|
+
toOperationNode() {
|
|
13
|
+
return this.#props.executor.transformQuery(this.#props.createTypeNode, this.#props.queryId);
|
|
14
|
+
}
|
|
15
|
+
asEnum(values) {
|
|
16
|
+
return new CreateTypeBuilder({
|
|
17
|
+
...this.#props,
|
|
18
|
+
createTypeNode: create_type_node_js_1.CreateTypeNode.cloneWithEnum(this.#props.createTypeNode, values),
|
|
19
|
+
});
|
|
20
|
+
}
|
|
21
|
+
compile() {
|
|
22
|
+
return this.#props.executor.compileQuery(this.toOperationNode(), this.#props.queryId);
|
|
23
|
+
}
|
|
24
|
+
async execute() {
|
|
25
|
+
await this.#props.executor.executeQuery(this.compile(), this.#props.queryId);
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
exports.CreateTypeBuilder = CreateTypeBuilder;
|
|
29
|
+
(0, prevent_await_js_1.preventAwait)(CreateTypeBuilder, "don't await CreateTypeBuilder instances directly. To execute the query you need to call `execute`");
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { DropTypeNode } from '../operation-node/drop-type-node.js';
|
|
2
|
+
import { OperationNodeSource } from '../operation-node/operation-node-source.js';
|
|
3
|
+
import { CompiledQuery } from '../query-compiler/compiled-query.js';
|
|
4
|
+
import { Compilable } from '../util/compilable.js';
|
|
5
|
+
import { QueryExecutor } from '../query-executor/query-executor.js';
|
|
6
|
+
import { QueryId } from '../util/query-id.js';
|
|
7
|
+
export declare class DropTypeBuilder implements OperationNodeSource, Compilable {
|
|
8
|
+
#private;
|
|
9
|
+
constructor(props: DropTypeBuilderProps);
|
|
10
|
+
ifExists(): DropTypeBuilder;
|
|
11
|
+
toOperationNode(): DropTypeNode;
|
|
12
|
+
compile(): CompiledQuery;
|
|
13
|
+
execute(): Promise<void>;
|
|
14
|
+
}
|
|
15
|
+
export interface DropTypeBuilderProps {
|
|
16
|
+
readonly queryId: QueryId;
|
|
17
|
+
readonly executor: QueryExecutor;
|
|
18
|
+
readonly dropTypeNode: DropTypeNode;
|
|
19
|
+
}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.DropTypeBuilder = void 0;
|
|
4
|
+
const drop_type_node_js_1 = require("../operation-node/drop-type-node.js");
|
|
5
|
+
const prevent_await_js_1 = require("../util/prevent-await.js");
|
|
6
|
+
const object_utils_js_1 = require("../util/object-utils.js");
|
|
7
|
+
class DropTypeBuilder {
|
|
8
|
+
#props;
|
|
9
|
+
constructor(props) {
|
|
10
|
+
this.#props = (0, object_utils_js_1.freeze)(props);
|
|
11
|
+
}
|
|
12
|
+
ifExists() {
|
|
13
|
+
return new DropTypeBuilder({
|
|
14
|
+
...this.#props,
|
|
15
|
+
dropTypeNode: drop_type_node_js_1.DropTypeNode.cloneWith(this.#props.dropTypeNode, {
|
|
16
|
+
ifExists: true,
|
|
17
|
+
}),
|
|
18
|
+
});
|
|
19
|
+
}
|
|
20
|
+
toOperationNode() {
|
|
21
|
+
return this.#props.executor.transformQuery(this.#props.dropTypeNode, this.#props.queryId);
|
|
22
|
+
}
|
|
23
|
+
compile() {
|
|
24
|
+
return this.#props.executor.compileQuery(this.toOperationNode(), this.#props.queryId);
|
|
25
|
+
}
|
|
26
|
+
async execute() {
|
|
27
|
+
await this.#props.executor.executeQuery(this.compile(), this.#props.queryId);
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
exports.DropTypeBuilder = DropTypeBuilder;
|
|
31
|
+
(0, prevent_await_js_1.preventAwait)(DropTypeBuilder, "don't await DropTypeBuilder instances directly. To execute the query you need to call `execute`");
|
|
@@ -9,6 +9,8 @@ import { DropTableBuilder } from './drop-table-builder.js';
|
|
|
9
9
|
import { CreateViewBuilder } from './create-view-builder.js';
|
|
10
10
|
import { DropViewBuilder } from './drop-view-builder.js';
|
|
11
11
|
import { KyselyPlugin } from '../plugin/kysely-plugin.js';
|
|
12
|
+
import { CreateTypeBuilder } from './create-type-builder.js';
|
|
13
|
+
import { DropTypeBuilder } from './drop-type-builder.js';
|
|
12
14
|
/**
|
|
13
15
|
* Provides methods for building database schema.
|
|
14
16
|
*/
|
|
@@ -170,6 +172,36 @@ export declare class SchemaModule {
|
|
|
170
172
|
* ```
|
|
171
173
|
*/
|
|
172
174
|
dropView(viewName: string): DropViewBuilder;
|
|
175
|
+
/**
|
|
176
|
+
* Create a new type.
|
|
177
|
+
*
|
|
178
|
+
* Only some dialects like PostgreSQL have user-defined types.
|
|
179
|
+
*
|
|
180
|
+
* ### Examples
|
|
181
|
+
*
|
|
182
|
+
* ```ts
|
|
183
|
+
* await db.schema
|
|
184
|
+
* .createType('species')
|
|
185
|
+
* .asEnum(['dog', 'cat', 'frog'])
|
|
186
|
+
* .execute()
|
|
187
|
+
* ```
|
|
188
|
+
*/
|
|
189
|
+
createType(viewName: string): CreateTypeBuilder;
|
|
190
|
+
/**
|
|
191
|
+
* Drop a type.
|
|
192
|
+
*
|
|
193
|
+
* Only some dialects like PostgreSQL have user-defined types.
|
|
194
|
+
*
|
|
195
|
+
* ### Examples
|
|
196
|
+
*
|
|
197
|
+
* ```ts
|
|
198
|
+
* await db.schema
|
|
199
|
+
* .dropType('species')
|
|
200
|
+
* .ifExists()
|
|
201
|
+
* .execute()
|
|
202
|
+
* ```
|
|
203
|
+
*/
|
|
204
|
+
dropType(viewName: string): DropTypeBuilder;
|
|
173
205
|
/**
|
|
174
206
|
* Returns a copy of this schema module with the given plugin installed.
|
|
175
207
|
*/
|