kysely 0.15.3 → 0.16.3
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 +1 -9
- package/dist/cjs/dialect/database-introspector.d.ts +1 -1
- package/dist/cjs/dialect/dialect-adapter-base.d.ts +1 -1
- package/dist/cjs/dialect/dialect-adapter.d.ts +1 -1
- package/dist/cjs/dialect/dialect.d.ts +2 -2
- package/dist/cjs/dialect/mysql/mysql-adapter.d.ts +1 -1
- package/dist/cjs/dialect/mysql/mysql-dialect.d.ts +2 -2
- package/dist/cjs/dialect/mysql/mysql-introspector.d.ts +1 -1
- package/dist/cjs/dialect/postgres/postgres-adapter.d.ts +1 -1
- package/dist/cjs/dialect/postgres/postgres-dialect.d.ts +2 -2
- package/dist/cjs/dialect/postgres/postgres-introspector.d.ts +1 -1
- package/dist/cjs/dialect/sqlite/sqlite-adapter.d.ts +1 -1
- package/dist/cjs/dialect/sqlite/sqlite-dialect.d.ts +2 -2
- package/dist/cjs/dialect/sqlite/sqlite-introspector.d.ts +1 -1
- package/dist/cjs/kysely.js +9 -5
- package/dist/cjs/migration/file-migration-provider.d.ts +2 -25
- package/dist/cjs/migration/file-migration-provider.js +8 -17
- package/dist/cjs/migration/migrator.d.ts +2 -15
- package/dist/cjs/migration/migrator.js +2 -15
- package/dist/cjs/operation-node/constraint-node.d.ts +4 -4
- package/dist/cjs/parser/join-parser.d.ts +4 -4
- package/dist/cjs/plugin/camel-case/camel-case-plugin.js +1 -1
- package/dist/cjs/query-builder/delete-query-builder.d.ts +3 -3
- package/dist/cjs/query-builder/expression-builder.d.ts +42 -0
- package/dist/cjs/query-builder/expression-builder.js +48 -0
- package/dist/cjs/query-builder/insert-query-builder.d.ts +16 -0
- package/dist/cjs/query-builder/insert-query-builder.js +16 -0
- package/dist/cjs/query-builder/join-interface.d.ts +3 -3
- package/dist/cjs/query-builder/on-conflict-builder.d.ts +5 -3
- package/dist/cjs/query-builder/select-query-builder.d.ts +3 -3
- package/dist/cjs/query-builder/update-query-builder.d.ts +3 -3
- package/dist/cjs/query-creator.d.ts +1 -1
- package/dist/cjs/util/object-utils.d.ts +1 -1
- package/dist/cjs/util/object-utils.js +8 -8
- package/dist/esm/dialect/database-introspector.d.ts +1 -1
- package/dist/esm/dialect/database-introspector.js +1 -0
- package/dist/esm/dialect/dialect-adapter-base.d.ts +1 -1
- package/dist/esm/dialect/dialect-adapter-base.js +1 -0
- package/dist/esm/dialect/dialect-adapter.d.ts +1 -1
- package/dist/esm/dialect/dialect-adapter.js +1 -0
- package/dist/esm/dialect/dialect.d.ts +2 -2
- package/dist/esm/dialect/dialect.js +1 -0
- package/dist/esm/dialect/mysql/mysql-adapter.d.ts +1 -1
- package/dist/esm/dialect/mysql/mysql-adapter.js +1 -0
- package/dist/esm/dialect/mysql/mysql-dialect.d.ts +2 -2
- package/dist/esm/dialect/mysql/mysql-dialect.js +1 -0
- package/dist/esm/dialect/mysql/mysql-driver.js +1 -0
- package/dist/esm/dialect/mysql/mysql-introspector.d.ts +1 -1
- package/dist/esm/dialect/mysql/mysql-introspector.js +1 -0
- package/dist/esm/dialect/mysql/mysql-query-compiler.js +1 -0
- package/dist/esm/dialect/postgres/postgres-adapter.d.ts +1 -1
- package/dist/esm/dialect/postgres/postgres-adapter.js +1 -0
- package/dist/esm/dialect/postgres/postgres-dialect.d.ts +2 -2
- package/dist/esm/dialect/postgres/postgres-dialect.js +1 -0
- package/dist/esm/dialect/postgres/postgres-driver.js +1 -0
- package/dist/esm/dialect/postgres/postgres-introspector.d.ts +1 -1
- package/dist/esm/dialect/postgres/postgres-introspector.js +1 -0
- package/dist/esm/dialect/postgres/postgres-query-compiler.js +1 -0
- package/dist/esm/dialect/sqlite/sqlite-adapter.d.ts +1 -1
- package/dist/esm/dialect/sqlite/sqlite-adapter.js +1 -0
- package/dist/esm/dialect/sqlite/sqlite-dialect.d.ts +2 -2
- package/dist/esm/dialect/sqlite/sqlite-dialect.js +1 -0
- package/dist/esm/dialect/sqlite/sqlite-driver.js +1 -0
- package/dist/esm/dialect/sqlite/sqlite-introspector.d.ts +1 -1
- package/dist/esm/dialect/sqlite/sqlite-introspector.js +1 -0
- package/dist/esm/dialect/sqlite/sqlite-query-compiler.js +1 -0
- package/dist/esm/driver/connection-provider.js +1 -0
- package/dist/esm/driver/database-connection.js +1 -0
- package/dist/esm/driver/default-connection-provider.js +1 -0
- package/dist/esm/driver/driver.js +1 -0
- package/dist/esm/driver/runtime-driver.js +1 -0
- package/dist/esm/driver/single-connection-provider.js +1 -0
- package/dist/esm/dynamic/dynamic-reference-builder.js +1 -0
- package/dist/esm/dynamic/dynamic.js +1 -0
- package/dist/esm/index-nodeless.js +1 -0
- package/dist/esm/index.js +1 -0
- package/dist/esm/kysely.js +10 -5
- package/dist/esm/migration/file-migration-provider.d.ts +2 -25
- package/dist/esm/migration/file-migration-provider.js +9 -17
- package/dist/esm/migration/migrator.d.ts +2 -15
- package/dist/esm/migration/migrator.js +3 -15
- package/dist/esm/operation-node/add-column-node.js +1 -0
- package/dist/esm/operation-node/add-constraint-node.js +1 -0
- package/dist/esm/operation-node/alias-node.js +1 -0
- package/dist/esm/operation-node/alter-column-node.js +1 -0
- package/dist/esm/operation-node/alter-table-node.js +1 -0
- package/dist/esm/operation-node/and-node.js +1 -0
- package/dist/esm/operation-node/check-constraint-node.js +1 -0
- package/dist/esm/operation-node/column-definition-node.js +1 -0
- package/dist/esm/operation-node/column-node.js +1 -0
- package/dist/esm/operation-node/column-update-node.js +1 -0
- package/dist/esm/operation-node/common-table-expression-name-node.js +1 -0
- package/dist/esm/operation-node/common-table-expression-node.js +1 -0
- package/dist/esm/operation-node/constraint-node.d.ts +4 -4
- package/dist/esm/operation-node/constraint-node.js +1 -0
- package/dist/esm/operation-node/create-index-node.js +1 -0
- package/dist/esm/operation-node/create-schema-node.js +1 -0
- package/dist/esm/operation-node/create-table-node.js +1 -0
- package/dist/esm/operation-node/create-view-node.js +1 -0
- package/dist/esm/operation-node/data-type-node.js +1 -0
- package/dist/esm/operation-node/default-value-node.js +1 -0
- package/dist/esm/operation-node/delete-query-node.js +1 -0
- package/dist/esm/operation-node/drop-column-node.js +1 -0
- package/dist/esm/operation-node/drop-constraint-node.js +1 -0
- package/dist/esm/operation-node/drop-index-node.js +1 -0
- package/dist/esm/operation-node/drop-schema-node.js +1 -0
- package/dist/esm/operation-node/drop-table-node.js +1 -0
- package/dist/esm/operation-node/drop-view-node.js +1 -0
- package/dist/esm/operation-node/filter-node.js +1 -0
- package/dist/esm/operation-node/foreign-key-constraint-node.js +1 -0
- package/dist/esm/operation-node/from-node.js +1 -0
- package/dist/esm/operation-node/generated-node.js +1 -0
- package/dist/esm/operation-node/group-by-item-node.js +1 -0
- package/dist/esm/operation-node/group-by-node.js +1 -0
- package/dist/esm/operation-node/having-node.js +1 -0
- package/dist/esm/operation-node/identifier-node.js +1 -0
- package/dist/esm/operation-node/insert-query-node.js +1 -0
- package/dist/esm/operation-node/join-node.js +1 -0
- package/dist/esm/operation-node/limit-node.js +1 -0
- package/dist/esm/operation-node/list-node.js +1 -0
- package/dist/esm/operation-node/modify-column-node.js +1 -0
- package/dist/esm/operation-node/offset-node.js +1 -0
- package/dist/esm/operation-node/on-conflict-node.js +1 -0
- package/dist/esm/operation-node/on-duplicate-key-node.js +1 -0
- package/dist/esm/operation-node/on-node.js +1 -0
- package/dist/esm/operation-node/operation-node-source.js +1 -0
- package/dist/esm/operation-node/operation-node-transformer.js +1 -0
- package/dist/esm/operation-node/operation-node-utils.js +1 -0
- package/dist/esm/operation-node/operation-node-visitor.js +1 -0
- package/dist/esm/operation-node/operation-node.js +1 -0
- package/dist/esm/operation-node/operator-node.js +1 -0
- package/dist/esm/operation-node/or-node.js +1 -0
- package/dist/esm/operation-node/order-by-item-node.js +1 -0
- package/dist/esm/operation-node/order-by-node.js +1 -0
- package/dist/esm/operation-node/parens-node.js +1 -0
- package/dist/esm/operation-node/primary-constraint-node.js +1 -0
- package/dist/esm/operation-node/primitive-value-list-node.js +1 -0
- package/dist/esm/operation-node/query-node.js +1 -0
- package/dist/esm/operation-node/raw-node.js +1 -0
- package/dist/esm/operation-node/reference-node.js +1 -0
- package/dist/esm/operation-node/references-node.js +1 -0
- package/dist/esm/operation-node/rename-column-node.js +1 -0
- package/dist/esm/operation-node/returning-node.js +1 -0
- package/dist/esm/operation-node/select-all-node.js +1 -0
- package/dist/esm/operation-node/select-query-node.js +1 -0
- package/dist/esm/operation-node/selection-node.js +1 -0
- package/dist/esm/operation-node/table-node.js +1 -0
- package/dist/esm/operation-node/union-node.js +1 -0
- package/dist/esm/operation-node/unique-constraint-node.js +1 -0
- package/dist/esm/operation-node/update-query-node.js +1 -0
- package/dist/esm/operation-node/value-list-node.js +1 -0
- package/dist/esm/operation-node/value-node.js +1 -0
- package/dist/esm/operation-node/values-node.js +1 -0
- package/dist/esm/operation-node/where-node.js +1 -0
- package/dist/esm/operation-node/with-node.js +1 -0
- package/dist/esm/parser/complex-expression-parser.js +1 -0
- package/dist/esm/parser/data-type-parser.js +1 -0
- package/dist/esm/parser/default-value-parser.js +1 -0
- package/dist/esm/parser/filter-parser.js +1 -0
- package/dist/esm/parser/group-by-parser.js +1 -0
- package/dist/esm/parser/insert-values-parser.js +1 -0
- package/dist/esm/parser/join-parser.d.ts +4 -4
- package/dist/esm/parser/join-parser.js +1 -0
- package/dist/esm/parser/order-by-parser.js +1 -0
- package/dist/esm/parser/parse-context.js +1 -0
- package/dist/esm/parser/reference-parser.js +1 -0
- package/dist/esm/parser/returning-parser.js +1 -0
- package/dist/esm/parser/select-parser.js +1 -0
- package/dist/esm/parser/table-parser.js +1 -0
- package/dist/esm/parser/union-parser.js +1 -0
- package/dist/esm/parser/update-set-parser.js +1 -0
- package/dist/esm/parser/value-parser.js +1 -0
- package/dist/esm/parser/with-parser.js +1 -0
- package/dist/esm/plugin/camel-case/camel-case-plugin.js +3 -2
- package/dist/esm/plugin/camel-case/camel-case-transformer.js +1 -0
- package/dist/esm/plugin/camel-case/camel-case.js +1 -0
- package/dist/esm/plugin/immediate-value.ts/immediate-value-plugin.js +1 -0
- package/dist/esm/plugin/immediate-value.ts/immediate-value-transformer.js +1 -0
- package/dist/esm/plugin/kysely-plugin.js +1 -0
- package/dist/esm/plugin/with-schema/with-schema-plugin.js +1 -0
- package/dist/esm/plugin/with-schema/with-schema-transformer.js +1 -0
- package/dist/esm/query-builder/delete-query-builder.d.ts +3 -3
- package/dist/esm/query-builder/delete-query-builder.js +1 -0
- package/dist/esm/query-builder/delete-result.js +1 -0
- package/dist/esm/query-builder/expression-builder.d.ts +42 -0
- package/dist/esm/query-builder/expression-builder.js +49 -0
- package/dist/esm/query-builder/function-builder.js +1 -0
- package/dist/esm/query-builder/having-interface.js +1 -0
- package/dist/esm/query-builder/insert-query-builder.d.ts +16 -0
- package/dist/esm/query-builder/insert-query-builder.js +17 -0
- package/dist/esm/query-builder/insert-result.js +1 -0
- package/dist/esm/query-builder/join-builder.js +1 -0
- package/dist/esm/query-builder/join-interface.d.ts +3 -3
- package/dist/esm/query-builder/join-interface.js +1 -0
- package/dist/esm/query-builder/no-result-error.js +1 -0
- package/dist/esm/query-builder/on-conflict-builder.d.ts +5 -3
- package/dist/esm/query-builder/on-conflict-builder.js +1 -0
- package/dist/esm/query-builder/returning-interface.js +1 -0
- package/dist/esm/query-builder/select-query-builder.d.ts +3 -3
- package/dist/esm/query-builder/select-query-builder.js +1 -0
- package/dist/esm/query-builder/update-query-builder.d.ts +3 -3
- package/dist/esm/query-builder/update-query-builder.js +1 -0
- package/dist/esm/query-builder/update-result.js +1 -0
- package/dist/esm/query-builder/where-interface.js +1 -0
- package/dist/esm/query-compiler/compiled-query.js +1 -0
- package/dist/esm/query-compiler/default-query-compiler.js +1 -0
- package/dist/esm/query-compiler/query-compiler.js +1 -0
- package/dist/esm/query-creator.d.ts +1 -1
- package/dist/esm/query-creator.js +1 -0
- package/dist/esm/query-executor/default-query-executor.js +1 -0
- package/dist/esm/query-executor/noop-query-executor.js +1 -0
- package/dist/esm/query-executor/query-executor.js +1 -0
- package/dist/esm/raw-builder/raw-builder.js +1 -0
- package/dist/esm/schema/alter-table-builder.js +1 -0
- package/dist/esm/schema/column-definition-builder.js +1 -0
- package/dist/esm/schema/create-index-builder.js +1 -0
- package/dist/esm/schema/create-schema-builder.js +1 -0
- package/dist/esm/schema/create-table-builder.js +1 -0
- package/dist/esm/schema/create-view-builder.js +1 -0
- package/dist/esm/schema/drop-index-builder.js +1 -0
- package/dist/esm/schema/drop-schema-builder.js +1 -0
- package/dist/esm/schema/drop-table-builder.js +1 -0
- package/dist/esm/schema/drop-view-builder.js +1 -0
- package/dist/esm/schema/foreign-key-constraint-builder.js +1 -0
- package/dist/esm/schema/schema.js +1 -0
- package/dist/esm/util/assert.js +1 -0
- package/dist/esm/util/column-type.js +1 -0
- package/dist/esm/util/compilable.js +1 -0
- package/dist/esm/util/dynamic-import.js +1 -0
- package/dist/esm/util/log.js +1 -0
- package/dist/esm/util/object-utils.d.ts +1 -1
- package/dist/esm/util/object-utils.js +7 -6
- package/dist/esm/util/performance-now.js +1 -0
- package/dist/esm/util/prevent-await.js +1 -0
- package/dist/esm/util/private-symbols.js +1 -0
- package/dist/esm/util/query-id.js +1 -0
- package/dist/esm/util/random-string.js +1 -0
- package/dist/esm/util/type-utils.js +1 -0
- package/package.json +3 -2
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
/// <reference types="./with-parser.d.ts" />
|
|
1
2
|
import { CommonTableExpressionNode } from '../operation-node/common-table-expression-node.js';
|
|
2
3
|
import { CommonTableExpressionNameNode } from '../operation-node/common-table-expression-name-node.js';
|
|
3
4
|
export function parseCommonTableExpression(ctx, name, expression) {
|
|
@@ -1,4 +1,5 @@
|
|
|
1
|
-
|
|
1
|
+
/// <reference types="./camel-case-plugin.d.ts" />
|
|
2
|
+
import { isBuffer, isDate, isObject } from '../../util/object-utils.js';
|
|
2
3
|
import { SnakeCaseTransformer } from './camel-case-transformer.js';
|
|
3
4
|
import { createCamelCaseMapper, createSnakeCaseMapper, } from './camel-case.js';
|
|
4
5
|
/**
|
|
@@ -107,5 +108,5 @@ export class CamelCasePlugin {
|
|
|
107
108
|
}
|
|
108
109
|
}
|
|
109
110
|
function canMap(obj) {
|
|
110
|
-
return isObject(obj) && !(obj
|
|
111
|
+
return isObject(obj) && !isDate(obj) && !isBuffer(obj);
|
|
111
112
|
}
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
/// <reference types="./with-schema-transformer.d.ts" />
|
|
1
2
|
import { AliasNode } from '../../operation-node/alias-node.js';
|
|
2
3
|
import { OperationNodeTransformer } from '../../operation-node/operation-node-transformer.js';
|
|
3
4
|
import { TableNode } from '../../operation-node/table-node.js';
|
|
@@ -473,13 +473,13 @@ export declare class DeleteQueryBuilder<DB, TB extends keyof DB, O> implements W
|
|
|
473
473
|
* and "pet"."name" = $1
|
|
474
474
|
* ```
|
|
475
475
|
*
|
|
476
|
-
* You can join a subquery by providing a
|
|
477
|
-
* argument:
|
|
476
|
+
* You can join a subquery by providing a select query (or a callback)
|
|
477
|
+
* as the first argument:
|
|
478
478
|
*
|
|
479
479
|
* ```ts
|
|
480
480
|
* await db.selectFrom('person')
|
|
481
481
|
* .innerJoin(
|
|
482
|
-
*
|
|
482
|
+
* qb.selectFrom('pet')
|
|
483
483
|
* .select(['owner_id', 'name'])
|
|
484
484
|
* .where('name', '=', 'Doggo')
|
|
485
485
|
* .as('doggos'),
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
/// <reference types="./delete-query-builder.d.ts" />
|
|
1
2
|
import { parseJoin, } from '../parser/join-parser.js';
|
|
2
3
|
import { parseSelectExpressionOrList, parseSelectAll, } from '../parser/select-parser.js';
|
|
3
4
|
import { parseExistFilter, parseReferenceFilter, parseWhereFilter, parseNotExistFilter, } from '../parser/filter-parser.js';
|
|
@@ -3,6 +3,8 @@ import { TableExpression, TableExpressionDatabase, TableExpressionTables } from
|
|
|
3
3
|
import { NoopQueryExecutor } from '../query-executor/noop-query-executor.js';
|
|
4
4
|
import { ParseContext } from '../parser/parse-context.js';
|
|
5
5
|
import { FunctionBuilder } from './function-builder.js';
|
|
6
|
+
import { RawBuilder } from '../index-nodeless.js';
|
|
7
|
+
import { ExtractTypeFromReferenceExpression, StringReference } from '../parser/reference-parser.js';
|
|
6
8
|
export declare class ExpressionBuilder<DB, TB extends keyof DB> {
|
|
7
9
|
#private;
|
|
8
10
|
constructor(props: ExpressionBuilderProps);
|
|
@@ -44,6 +46,8 @@ export declare class ExpressionBuilder<DB, TB extends keyof DB> {
|
|
|
44
46
|
* The query builder returned by this method is typed in a way that you can refer to
|
|
45
47
|
* all tables of the parent query in addition to the subquery's tables.
|
|
46
48
|
*
|
|
49
|
+
* This method accepts all the same inputs as {@link QueryCreator.selectFrom}.
|
|
50
|
+
*
|
|
47
51
|
* ### Examples
|
|
48
52
|
*
|
|
49
53
|
* This example shows that you can refer to both `pet.owner_id` and `person.id`
|
|
@@ -86,6 +90,44 @@ export declare class ExpressionBuilder<DB, TB extends keyof DB> {
|
|
|
86
90
|
* See {@link QueryCreator.withSchema}
|
|
87
91
|
*/
|
|
88
92
|
withSchema(schema: string): ExpressionBuilder<DB, TB>;
|
|
93
|
+
/**
|
|
94
|
+
* See {@link QueryCreator.raw}.
|
|
95
|
+
*/
|
|
96
|
+
raw<T = unknown>(sql: string, parameters?: unknown[]): RawBuilder<T>;
|
|
97
|
+
/**
|
|
98
|
+
* This can be used to reference columns.
|
|
99
|
+
*
|
|
100
|
+
* ### Examples
|
|
101
|
+
*
|
|
102
|
+
* In the next example we use the `ref` method to reference
|
|
103
|
+
* columns of the virtual table `excluded` in a type-safe way
|
|
104
|
+
* to create an upsert operation:
|
|
105
|
+
*
|
|
106
|
+
* ```ts
|
|
107
|
+
* db.insertInto('person')
|
|
108
|
+
* .values(person)
|
|
109
|
+
* .onConflict(oc => oc
|
|
110
|
+
* .column('id')
|
|
111
|
+
* .doUpdateSet({
|
|
112
|
+
* first_name: (eb) => eb.ref('excluded.first_name'),
|
|
113
|
+
* last_name: (eb) => eb.ref('excluded.last_name')
|
|
114
|
+
* })
|
|
115
|
+
* )
|
|
116
|
+
* ```
|
|
117
|
+
*
|
|
118
|
+
* In the next example we use `ref` in a raw expression. Unless you
|
|
119
|
+
* want to be as type-safe as possible, this is probably overkill:
|
|
120
|
+
*
|
|
121
|
+
* ```ts
|
|
122
|
+
* db.update('pet').set({
|
|
123
|
+
* name: (eb) => eb.raw('concat(?, ?)', [
|
|
124
|
+
* eb.ref('pet.name'),
|
|
125
|
+
* suffix,
|
|
126
|
+
* ])
|
|
127
|
+
* })
|
|
128
|
+
* ```
|
|
129
|
+
*/
|
|
130
|
+
ref<RE extends StringReference<DB, TB>>(reference: RE): RawBuilder<ExtractTypeFromReferenceExpression<DB, TB, RE>>;
|
|
89
131
|
}
|
|
90
132
|
export interface ExpressionBuilderProps {
|
|
91
133
|
readonly executor: NoopQueryExecutor;
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
/// <reference types="./expression-builder.d.ts" />
|
|
1
2
|
import { SelectQueryBuilder } from './select-query-builder.js';
|
|
2
3
|
import { SelectQueryNode } from '../operation-node/select-query-node.js';
|
|
3
4
|
import { parseTableExpressionOrList, } from '../parser/table-parser.js';
|
|
@@ -5,6 +6,7 @@ import { WithSchemaPlugin } from '../plugin/with-schema/with-schema-plugin.js';
|
|
|
5
6
|
import { createQueryId } from '../util/query-id.js';
|
|
6
7
|
import { freeze } from '../util/object-utils.js';
|
|
7
8
|
import { FunctionBuilder } from './function-builder.js';
|
|
9
|
+
import { RawBuilder } from '../index-nodeless.js';
|
|
8
10
|
export class ExpressionBuilder {
|
|
9
11
|
#props;
|
|
10
12
|
constructor(props) {
|
|
@@ -61,4 +63,51 @@ export class ExpressionBuilder {
|
|
|
61
63
|
executor: this.#props.executor.withPluginAtFront(new WithSchemaPlugin(schema)),
|
|
62
64
|
});
|
|
63
65
|
}
|
|
66
|
+
/**
|
|
67
|
+
* See {@link QueryCreator.raw}.
|
|
68
|
+
*/
|
|
69
|
+
raw(sql, parameters) {
|
|
70
|
+
return new RawBuilder({
|
|
71
|
+
queryId: createQueryId(),
|
|
72
|
+
executor: this.#props.executor,
|
|
73
|
+
sql,
|
|
74
|
+
parameters,
|
|
75
|
+
});
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* This can be used to reference columns.
|
|
79
|
+
*
|
|
80
|
+
* ### Examples
|
|
81
|
+
*
|
|
82
|
+
* In the next example we use the `ref` method to reference
|
|
83
|
+
* columns of the virtual table `excluded` in a type-safe way
|
|
84
|
+
* to create an upsert operation:
|
|
85
|
+
*
|
|
86
|
+
* ```ts
|
|
87
|
+
* db.insertInto('person')
|
|
88
|
+
* .values(person)
|
|
89
|
+
* .onConflict(oc => oc
|
|
90
|
+
* .column('id')
|
|
91
|
+
* .doUpdateSet({
|
|
92
|
+
* first_name: (eb) => eb.ref('excluded.first_name'),
|
|
93
|
+
* last_name: (eb) => eb.ref('excluded.last_name')
|
|
94
|
+
* })
|
|
95
|
+
* )
|
|
96
|
+
* ```
|
|
97
|
+
*
|
|
98
|
+
* In the next example we use `ref` in a raw expression. Unless you
|
|
99
|
+
* want to be as type-safe as possible, this is probably overkill:
|
|
100
|
+
*
|
|
101
|
+
* ```ts
|
|
102
|
+
* db.update('pet').set({
|
|
103
|
+
* name: (eb) => eb.raw('concat(?, ?)', [
|
|
104
|
+
* eb.ref('pet.name'),
|
|
105
|
+
* suffix,
|
|
106
|
+
* ])
|
|
107
|
+
* })
|
|
108
|
+
* ```
|
|
109
|
+
*/
|
|
110
|
+
ref(reference) {
|
|
111
|
+
return this.raw('??', [reference]);
|
|
112
|
+
}
|
|
64
113
|
}
|
|
@@ -342,6 +342,22 @@ export declare class InsertQueryBuilder<DB, TB extends keyof DB, O> implements R
|
|
|
342
342
|
* values ($1, $2)
|
|
343
343
|
* on conflict ("name") do nothing
|
|
344
344
|
* ```
|
|
345
|
+
*
|
|
346
|
+
* You can refer to the columns of the virtual `excluded` table
|
|
347
|
+
* in a type-safe way using a callback and the `ref` method of
|
|
348
|
+
* `ExpressionBuilder`:
|
|
349
|
+
*
|
|
350
|
+
* ```ts
|
|
351
|
+
* db.insertInto('person')
|
|
352
|
+
* .values(person)
|
|
353
|
+
* .onConflict(oc => oc
|
|
354
|
+
* .column('id')
|
|
355
|
+
* .doUpdateSet({
|
|
356
|
+
* first_name: (eb) => eb.ref('excluded.first_name'),
|
|
357
|
+
* last_name: (eb) => eb.ref('excluded.last_name')
|
|
358
|
+
* })
|
|
359
|
+
* )
|
|
360
|
+
* ```
|
|
345
361
|
*/
|
|
346
362
|
onConflict(callback: (builder: OnConflictBuilder<DB, TB>) => OnConflictDoNothingBuilder<DB, TB> | OnConflictUpdateBuilder<DB, TB>): InsertQueryBuilder<DB, TB, O>;
|
|
347
363
|
/**
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
/// <reference types="./insert-query-builder.d.ts" />
|
|
1
2
|
import { parseSelectExpressionOrList, parseSelectAll, } from '../parser/select-parser.js';
|
|
2
3
|
import { parseInsertObjectOrList, } from '../parser/insert-values-parser.js';
|
|
3
4
|
import { InsertQueryNode } from '../operation-node/insert-query-node.js';
|
|
@@ -245,6 +246,22 @@ export class InsertQueryBuilder {
|
|
|
245
246
|
* values ($1, $2)
|
|
246
247
|
* on conflict ("name") do nothing
|
|
247
248
|
* ```
|
|
249
|
+
*
|
|
250
|
+
* You can refer to the columns of the virtual `excluded` table
|
|
251
|
+
* in a type-safe way using a callback and the `ref` method of
|
|
252
|
+
* `ExpressionBuilder`:
|
|
253
|
+
*
|
|
254
|
+
* ```ts
|
|
255
|
+
* db.insertInto('person')
|
|
256
|
+
* .values(person)
|
|
257
|
+
* .onConflict(oc => oc
|
|
258
|
+
* .column('id')
|
|
259
|
+
* .doUpdateSet({
|
|
260
|
+
* first_name: (eb) => eb.ref('excluded.first_name'),
|
|
261
|
+
* last_name: (eb) => eb.ref('excluded.last_name')
|
|
262
|
+
* })
|
|
263
|
+
* )
|
|
264
|
+
* ```
|
|
248
265
|
*/
|
|
249
266
|
onConflict(callback) {
|
|
250
267
|
return new InsertQueryBuilder({
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
/// <reference types="./join-builder.d.ts" />
|
|
1
2
|
import { JoinNode } from '../operation-node/join-node.js';
|
|
2
3
|
import { parseExistFilter, parseNotExistFilter, parseOnFilter, parseReferenceFilter, } from '../parser/filter-parser.js';
|
|
3
4
|
import { freeze } from '../util/object-utils.js';
|
|
@@ -80,13 +80,13 @@ export interface JoinInterface<DB, TB extends keyof DB> {
|
|
|
80
80
|
* and "pet"."name" = $1
|
|
81
81
|
* ```
|
|
82
82
|
*
|
|
83
|
-
* You can join a subquery by providing a
|
|
84
|
-
* argument:
|
|
83
|
+
* You can join a subquery by providing a select query (or a callback)
|
|
84
|
+
* as the first argument:
|
|
85
85
|
*
|
|
86
86
|
* ```ts
|
|
87
87
|
* await db.selectFrom('person')
|
|
88
88
|
* .innerJoin(
|
|
89
|
-
*
|
|
89
|
+
* qb.selectFrom('pet')
|
|
90
90
|
* .select(['owner_id', 'name'])
|
|
91
91
|
* .where('name', '=', 'Doggo')
|
|
92
92
|
* .as('doggos'),
|
|
@@ -377,14 +377,16 @@ export declare class OnConflictBuilder<DB, TB extends keyof DB> implements Where
|
|
|
377
377
|
* do update set "first_name" = $3
|
|
378
378
|
* ```
|
|
379
379
|
*/
|
|
380
|
-
doUpdateSet(updates: MutationObject<DB, TB
|
|
381
|
-
[K in keyof DB | 'excluded']: K extends keyof DB ? DB[K] : DB[TB];
|
|
382
|
-
}, TB | 'excluded'>;
|
|
380
|
+
doUpdateSet(updates: MutationObject<OnConflictDatabase<DB, TB>, OnConflictTables<TB>>): OnConflictUpdateBuilder<OnConflictDatabase<DB, TB>, OnConflictTables<TB>>;
|
|
383
381
|
}
|
|
384
382
|
export interface OnConflictBuilderProps {
|
|
385
383
|
readonly onConflictNode: OnConflictNode;
|
|
386
384
|
readonly parseContext: ParseContext;
|
|
387
385
|
}
|
|
386
|
+
export declare type OnConflictDatabase<DB, TB extends keyof DB> = {
|
|
387
|
+
[K in keyof DB | 'excluded']: K extends keyof DB ? DB[K] : DB[TB];
|
|
388
|
+
};
|
|
389
|
+
export declare type OnConflictTables<TB> = TB | 'excluded';
|
|
388
390
|
export declare class OnConflictDoNothingBuilder<DB, TB extends keyof DB> implements OperationNodeSource {
|
|
389
391
|
#private;
|
|
390
392
|
constructor(props: OnConflictBuilderProps);
|
|
@@ -811,13 +811,13 @@ export declare class SelectQueryBuilder<DB, TB extends keyof DB, O> implements W
|
|
|
811
811
|
* and "pet"."name" = $1
|
|
812
812
|
* ```
|
|
813
813
|
*
|
|
814
|
-
* You can join a subquery by providing a
|
|
815
|
-
* argument:
|
|
814
|
+
* You can join a subquery by providing a select query (or a callback)
|
|
815
|
+
* as the first argument:
|
|
816
816
|
*
|
|
817
817
|
* ```ts
|
|
818
818
|
* await db.selectFrom('person')
|
|
819
819
|
* .innerJoin(
|
|
820
|
-
*
|
|
820
|
+
* qb.selectFrom('pet')
|
|
821
821
|
* .select(['owner_id', 'name'])
|
|
822
822
|
* .where('name', '=', 'Doggo')
|
|
823
823
|
* .as('doggos'),
|
|
@@ -474,13 +474,13 @@ export declare class UpdateQueryBuilder<DB, TB extends keyof DB, O> implements W
|
|
|
474
474
|
* and "pet"."name" = $1
|
|
475
475
|
* ```
|
|
476
476
|
*
|
|
477
|
-
* You can join a subquery by providing a
|
|
478
|
-
* argument:
|
|
477
|
+
* You can join a subquery by providing a select query (or a callback)
|
|
478
|
+
* as the first argument:
|
|
479
479
|
*
|
|
480
480
|
* ```ts
|
|
481
481
|
* await db.selectFrom('person')
|
|
482
482
|
* .innerJoin(
|
|
483
|
-
*
|
|
483
|
+
* qb.selectFrom('pet')
|
|
484
484
|
* .select(['owner_id', 'name'])
|
|
485
485
|
* .where('name', '=', 'Doggo')
|
|
486
486
|
* .as('doggos'),
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
/// <reference types="./update-query-builder.d.ts" />
|
|
1
2
|
import { parseJoin, } from '../parser/join-parser.js';
|
|
2
3
|
import { parseSelectExpressionOrList, parseSelectAll, } from '../parser/select-parser.js';
|
|
3
4
|
import { parseExistFilter, parseReferenceFilter, parseWhereFilter, parseNotExistFilter, } from '../parser/filter-parser.js';
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
/// <reference types="./default-query-compiler.d.ts" />
|
|
1
2
|
import { InsertQueryNode } from '../operation-node/insert-query-node.js';
|
|
2
3
|
import { OperationNodeVisitor } from '../operation-node/operation-node-visitor.js';
|
|
3
4
|
import { QueryNode } from '../operation-node/query-node.js';
|
|
@@ -412,7 +412,7 @@ export declare class QueryCreator<DB> {
|
|
|
412
412
|
* @param params - The parameters that will be bound to the `?` and `??` placeholders in
|
|
413
413
|
* the sql string.
|
|
414
414
|
*/
|
|
415
|
-
raw<T = unknown>(sql: string, parameters?:
|
|
415
|
+
raw<T = unknown>(sql: string, parameters?: unknown[]): RawBuilder<T>;
|
|
416
416
|
}
|
|
417
417
|
export interface QueryCreatorProps {
|
|
418
418
|
readonly executor: QueryExecutor;
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
/// <reference types="./query-creator.d.ts" />
|
|
1
2
|
import { SelectQueryBuilder } from './query-builder/select-query-builder.js';
|
|
2
3
|
import { InsertQueryBuilder } from './query-builder/insert-query-builder.js';
|
|
3
4
|
import { DeleteQueryBuilder } from './query-builder/delete-query-builder.js';
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
/// <reference types="./alter-table-builder.d.ts" />
|
|
1
2
|
import { AddColumnNode } from '../operation-node/add-column-node.js';
|
|
2
3
|
import { AlterColumnNode } from '../operation-node/alter-column-node.js';
|
|
3
4
|
import { AlterTableNode } from '../operation-node/alter-table-node.js';
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
/// <reference types="./column-definition-builder.d.ts" />
|
|
1
2
|
import { CheckConstraintNode } from '../operation-node/check-constraint-node.js';
|
|
2
3
|
import { ReferenceNode } from '../operation-node/reference-node.js';
|
|
3
4
|
import { ReferencesNode, } from '../operation-node/references-node.js';
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
/// <reference types="./create-table-builder.d.ts" />
|
|
1
2
|
import { ColumnDefinitionNode } from '../operation-node/column-definition-node.js';
|
|
2
3
|
import { CreateTableNode, } from '../operation-node/create-table-node.js';
|
|
3
4
|
import { preventAwait } from '../util/prevent-await.js';
|
package/dist/esm/util/assert.js
CHANGED
package/dist/esm/util/log.js
CHANGED
|
@@ -6,8 +6,8 @@ export declare function isNumber(obj: unknown): obj is number;
|
|
|
6
6
|
export declare function isBoolean(obj: unknown): obj is boolean;
|
|
7
7
|
export declare function isNull(obj: unknown): obj is null;
|
|
8
8
|
export declare function isDate(obj: unknown): obj is Date;
|
|
9
|
-
export declare function isBuffer(obj: unknown): obj is Buffer;
|
|
10
9
|
export declare function isBigInt(obj: unknown): obj is BigInt;
|
|
10
|
+
export declare function isBuffer(obj: unknown): obj is Buffer;
|
|
11
11
|
export declare function isPrimitive(obj: unknown): obj is PrimitiveValue;
|
|
12
12
|
export declare function isFunction(obj: unknown): obj is Function;
|
|
13
13
|
export declare function isObject(obj: unknown): obj is Record<string, unknown>;
|