kysely 0.3.4 → 0.3.9

package/dist/cjs/query-builder/query-builder.js

@@ -45,7 +45,7 @@ class QueryBuilder {
         ensureCanHaveWhereClause(this.#queryNode);
         return new QueryBuilder({
             executor: this.#executor,
-            queryNode: query_node_js_1.queryNode.cloneWithWhere(this.#queryNode, 'and', filter_parser_js_1.parseFilterArgs('Where', args)),
+            queryNode: query_node_js_1.queryNode.cloneWithWhere(this.#queryNode, 'and', filter_parser_js_1.parseFilter('Where', args)),
         });
     }
     /**
@@ -75,7 +75,8 @@ class QueryBuilder {
      * Usage in a subquery:
      *
      * ```ts
-     * db.selectFrom('person)
+     * const persons = await db
+     *   .selectFrom('person')
      *   .selectAll('person')
      *   .select((qb) => qb
      *     .subQuery('pet')
@@ -84,6 +85,7 @@ class QueryBuilder {
      *     .limit(1)
      *     .as('pet_name')
      *   )
+     *   .execute()
      * ```
      *
      * The generated SQL (postgresql):
@@ -93,21 +95,22 @@ class QueryBuilder {
      *   select "name"
      *   from "pet"
      *   where "pet"."owner_id" = "person"."id"
-     * ) as pet_name
-     * from "person"`
+     *   limit $1
+     * ) as "pet_name"
+     * from "person"
      */
     whereRef(lhs, op, rhs) {
         ensureCanHaveWhereClause(this.#queryNode);
         return new QueryBuilder({
             executor: this.#executor,
-            queryNode: query_node_js_1.queryNode.cloneWithWhere(this.#queryNode, 'and', filter_parser_js_1.parseReferenceFilterArgs(lhs, op, rhs)),
+            queryNode: query_node_js_1.queryNode.cloneWithWhere(this.#queryNode, 'and', filter_parser_js_1.parseReferenceFilter(lhs, op, rhs)),
         });
     }
     orWhere(...args) {
         ensureCanHaveWhereClause(this.#queryNode);
         return new QueryBuilder({
             executor: this.#executor,
-            queryNode: query_node_js_1.queryNode.cloneWithWhere(this.#queryNode, 'or', filter_parser_js_1.parseFilterArgs('Where', args)),
+            queryNode: query_node_js_1.queryNode.cloneWithWhere(this.#queryNode, 'or', filter_parser_js_1.parseFilter('Where', args)),
         });
     }
     /**
@@ -120,7 +123,7 @@ class QueryBuilder {
         ensureCanHaveWhereClause(this.#queryNode);
         return new QueryBuilder({
             executor: this.#executor,
-            queryNode: query_node_js_1.queryNode.cloneWithWhere(this.#queryNode, 'or', filter_parser_js_1.parseReferenceFilterArgs(lhs, op, rhs)),
+            queryNode: query_node_js_1.queryNode.cloneWithWhere(this.#queryNode, 'or', filter_parser_js_1.parseReferenceFilter(lhs, op, rhs)),
         });
     }
     /**
@@ -132,7 +135,8 @@ class QueryBuilder {
      * The query below selets all persons that own a pet named Catto:
      *
      * ```ts
-     * db.selectFrom('person')
+     * const persons = await db
+     *   .selectFrom('person')
      *   .selectAll()
      *   .whereExists((qb) => qb
      *     .subQuery('pet')
@@ -140,6 +144,7 @@ class QueryBuilder {
      *     .whereRef('person.id', '=', 'pet.owner_id')
      *     .where('pet.name', '=', 'Catto')
      *   )
+     *   .execute()
      * ```
      *
      * The generated SQL (postgresql):
@@ -184,7 +189,7 @@ class QueryBuilder {
         ensureCanHaveWhereClause(this.#queryNode);
         return new QueryBuilder({
             executor: this.#executor,
-            queryNode: query_node_js_1.queryNode.cloneWithWhere(this.#queryNode, 'and', filter_parser_js_1.parseExistsFilterArgs('exists', arg)),
+            queryNode: query_node_js_1.queryNode.cloneWithWhere(this.#queryNode, 'and', filter_parser_js_1.parseExistExpression('exists', arg)),
         });
     }
     /**
@@ -194,7 +199,7 @@ class QueryBuilder {
         ensureCanHaveWhereClause(this.#queryNode);
         return new QueryBuilder({
             executor: this.#executor,
-            queryNode: query_node_js_1.queryNode.cloneWithWhere(this.#queryNode, 'and', filter_parser_js_1.parseExistsFilterArgs('not exists', arg)),
+            queryNode: query_node_js_1.queryNode.cloneWithWhere(this.#queryNode, 'and', filter_parser_js_1.parseExistExpression('not exists', arg)),
         });
     }
     /**
@@ -204,7 +209,7 @@ class QueryBuilder {
         ensureCanHaveWhereClause(this.#queryNode);
         return new QueryBuilder({
             executor: this.#executor,
-            queryNode: query_node_js_1.queryNode.cloneWithWhere(this.#queryNode, 'or', filter_parser_js_1.parseExistsFilterArgs('exists', arg)),
+            queryNode: query_node_js_1.queryNode.cloneWithWhere(this.#queryNode, 'or', filter_parser_js_1.parseExistExpression('exists', arg)),
         });
     }
     /**
@@ -214,14 +219,14 @@ class QueryBuilder {
         ensureCanHaveWhereClause(this.#queryNode);
         return new QueryBuilder({
             executor: this.#executor,
-            queryNode: query_node_js_1.queryNode.cloneWithWhere(this.#queryNode, 'or', filter_parser_js_1.parseExistsFilterArgs('not exists', arg)),
+            queryNode: query_node_js_1.queryNode.cloneWithWhere(this.#queryNode, 'or', filter_parser_js_1.parseExistExpression('not exists', arg)),
         });
     }
     having(...args) {
         ensureCanHaveHavingClause(this.#queryNode);
         return new QueryBuilder({
             executor: this.#executor,
-            queryNode: select_query_node_js_1.selectQueryNode.cloneWithHaving(this.#queryNode, 'and', filter_parser_js_1.parseFilterArgs('Having', args)),
+            queryNode: select_query_node_js_1.selectQueryNode.cloneWithHaving(this.#queryNode, 'and', filter_parser_js_1.parseFilter('Having', args)),
         });
     }
     /**
@@ -232,14 +237,14 @@ class QueryBuilder {
         ensureCanHaveHavingClause(this.#queryNode);
         return new QueryBuilder({
             executor: this.#executor,
-            queryNode: select_query_node_js_1.selectQueryNode.cloneWithHaving(this.#queryNode, 'and', filter_parser_js_1.parseReferenceFilterArgs(lhs, op, rhs)),
+            queryNode: select_query_node_js_1.selectQueryNode.cloneWithHaving(this.#queryNode, 'and', filter_parser_js_1.parseReferenceFilter(lhs, op, rhs)),
         });
     }
     orHaving(...args) {
         ensureCanHaveHavingClause(this.#queryNode);
         return new QueryBuilder({
             executor: this.#executor,
-            queryNode: select_query_node_js_1.selectQueryNode.cloneWithHaving(this.#queryNode, 'or', filter_parser_js_1.parseFilterArgs('Having', args)),
+            queryNode: select_query_node_js_1.selectQueryNode.cloneWithHaving(this.#queryNode, 'or', filter_parser_js_1.parseFilter('Having', args)),
         });
     }
     /**
@@ -250,7 +255,7 @@ class QueryBuilder {
         ensureCanHaveHavingClause(this.#queryNode);
         return new QueryBuilder({
             executor: this.#executor,
-            queryNode: select_query_node_js_1.selectQueryNode.cloneWithHaving(this.#queryNode, 'or', filter_parser_js_1.parseReferenceFilterArgs(lhs, op, rhs)),
+            queryNode: select_query_node_js_1.selectQueryNode.cloneWithHaving(this.#queryNode, 'or', filter_parser_js_1.parseReferenceFilter(lhs, op, rhs)),
         });
     }
     /**
@@ -261,7 +266,7 @@ class QueryBuilder {
         ensureCanHaveHavingClause(this.#queryNode);
         return new QueryBuilder({
             executor: this.#executor,
-            queryNode: select_query_node_js_1.selectQueryNode.cloneWithHaving(this.#queryNode, 'and', filter_parser_js_1.parseExistsFilterArgs('exists', arg)),
+            queryNode: select_query_node_js_1.selectQueryNode.cloneWithHaving(this.#queryNode, 'and', filter_parser_js_1.parseExistExpression('exists', arg)),
         });
     }
     /**
@@ -272,7 +277,7 @@ class QueryBuilder {
         ensureCanHaveHavingClause(this.#queryNode);
         return new QueryBuilder({
             executor: this.#executor,
-            queryNode: select_query_node_js_1.selectQueryNode.cloneWithHaving(this.#queryNode, 'and', filter_parser_js_1.parseExistsFilterArgs('not exists', arg)),
+            queryNode: select_query_node_js_1.selectQueryNode.cloneWithHaving(this.#queryNode, 'and', filter_parser_js_1.parseExistExpression('not exists', arg)),
         });
     }
     /**
@@ -283,7 +288,7 @@ class QueryBuilder {
         ensureCanHaveHavingClause(this.#queryNode);
         return new QueryBuilder({
             executor: this.#executor,
-            queryNode: select_query_node_js_1.selectQueryNode.cloneWithHaving(this.#queryNode, 'or', filter_parser_js_1.parseExistsFilterArgs('exists', arg)),
+            queryNode: select_query_node_js_1.selectQueryNode.cloneWithHaving(this.#queryNode, 'or', filter_parser_js_1.parseExistExpression('exists', arg)),
         });
     }
     /**
@@ -294,7 +299,7 @@ class QueryBuilder {
         ensureCanHaveHavingClause(this.#queryNode);
         return new QueryBuilder({
             executor: this.#executor,
-            queryNode: select_query_node_js_1.selectQueryNode.cloneWithHaving(this.#queryNode, 'or', filter_parser_js_1.parseExistsFilterArgs('not exists', arg)),
+            queryNode: select_query_node_js_1.selectQueryNode.cloneWithHaving(this.#queryNode, 'or', filter_parser_js_1.parseExistExpression('not exists', arg)),
         });
     }
     select(selection) {
@@ -312,13 +317,27 @@ class QueryBuilder {
         });
     }
     /**
+     * Makes the selection distinct.
      *
+     * @example
+     * ```ts
+     * await db.selectFrom('person')
+     *   .select('first_name')
+     *   .distinct()
+     *   .execute()
+     * ```
+     *
+     * The generated SQL (postgresql):
+     *
+     * ```sql
+     * select distinct "first_name" from "person"
+     * ```
      */
     distinct() {
         ensureCanHaveSelectClause(this.#queryNode);
         return new QueryBuilder({
             executor: this.#executor,
-            queryNode: select_query_node_js_1.selectQueryNode.cloneWithModifier(this.#queryNode, 'Distinct'),
+            queryNode: select_query_node_js_1.selectQueryNode.cloneWithDistinct(this.#queryNode),
         });
     }
     /**
@@ -420,7 +439,7 @@ class QueryBuilder {
         ensureCanHaveInsertValues(this.#queryNode);
         return new QueryBuilder({
             executor: this.#executor,
-            queryNode: insert_query_node_js_1.insertQueryNode.cloneWithColumnsAndValues(this.#queryNode, ...insert_values_parser_js_1.parseInsertValuesArgs(args)),
+            queryNode: insert_query_node_js_1.insertQueryNode.cloneWithColumnsAndValues(this.#queryNode, ...insert_values_parser_js_1.parseInsertObjectOrList(args)),
         });
     }
     onConflictDoNothing(columns) {
@@ -438,7 +457,7 @@ class QueryBuilder {
         });
     }
     /**
-     * Sets the values to update for an `updateTable` query.
+     * Sets the values to update for an {@link Kysely.updateTable | update} query.
      *
      * This method takes an object whose keys are column names and values are
      * values to update. In addition to the column's type, the values can be `raw`
@@ -469,7 +488,7 @@ class QueryBuilder {
      * ```
      *
      * @example
-     * On postgresql you need to chain `returning` to the query to get
+     * On postgresql you ca chain `returning` to the query to get
      * the updated rows' columns (or any other expression) as the
      * return value:
      *
@@ -482,7 +501,7 @@ class QueryBuilder {
      *   })
      *   .where('id', '=', 1)
      *   .returning('id')
-     *   .executeTakeFirst()
+     *   .executeTakeFirstOrThrow()
      *
      * row.id
      * ```

package/dist/cjs/query-builder/type-utils.d.ts

@@ -40,7 +40,7 @@ export declare type RowType<DB, TB extends keyof DB> = UnionToIntersection<DB[TB
  */
 export declare type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
 /**
- * Given a database type and a union of table name in that db returns
+ * Given a database type and a union of table names in that db, returns
  * a union type with all possible column names.
  *
  * Example:
@@ -74,7 +74,7 @@ export declare type AnyColumn<DB, TB extends keyof DB> = {
     [T in TB]: keyof DB[T];
 }[TB];
 /**
- * Given a database type and a union of table names in that db returns
+ * Given a database type and a union of table names in that db, returns
  * a union type with all possible `table`.`column` combinations.
  *
  * Example:
@@ -107,29 +107,46 @@ export declare type AnyColumn<DB, TB extends keyof DB> = {
 export declare type AnyColumnWithTable<DB, TB extends keyof DB> = {
     [T in TB]: T extends string ? keyof DB[T] extends string ? `${T}.${keyof DB[T]}` : never : never;
 }[TB];
+/**
+ * Just like {@link AnyColumn} but with a ` as <string>` suffix.
+ */
 export declare type AnyAliasedColumn<DB, TB extends keyof DB> = {
     [T in TB]: T extends string ? keyof DB[T] extends string ? `${keyof DB[T]} as ${string}` : never : never;
 }[TB];
-export declare type AnyAliasedColumnWithTable<DB, TB extends keyof DB> = `${AnyColumnWithTable<DB, TB>} as ${string}`;
 /**
- * Extracts an array item type.
+ * Just like {@link AnyColumnWithTable} but with a ` as <string>` suffix.
+ */
+export declare type AnyAliasedColumnWithTable<DB, TB extends keyof DB> = {
+    [T in TB]: T extends string ? keyof DB[T] extends string ? `${T}.${keyof DB[T]} as ${string}` : never : never;
+}[TB];
+/**
+ * Extracts the item type of an array.
  */
 export declare type ArrayItemType<T> = T extends ReadonlyArray<infer I> ? I : never;
 export declare type AnyQueryBuilder = QueryBuilder<any, any, any>;
 export declare type AnyAliasedQueryBuilder = AliasedQueryBuilder<any, any, any, any>;
+export declare type AnyRawBuilder = RawBuilder<any>;
+export declare type AnyAliasedRawBuilder = AliasedRawBuilder<any, any>;
 export declare type QueryBuilderFactory<DB, TB extends keyof DB> = (qb: SubQueryBuilder<DB, TB>) => QueryBuilder<any, any, any>;
 export declare type AliasedQueryBuilderFactory<DB, TB extends keyof DB> = (qb: SubQueryBuilder<DB, TB>) => AnyAliasedQueryBuilder;
-export declare type RawBuilderFactory<DB, TB extends keyof DB> = (qb: SubQueryBuilder<DB, TB>) => RawBuilder<any>;
-export declare type AliasedRawBuilderFactory<DB, TB extends keyof DB> = (qb: SubQueryBuilder<DB, TB>) => AliasedRawBuilder<any, any>;
+export declare type RawBuilderFactory<DB, TB extends keyof DB> = (qb: SubQueryBuilder<DB, TB>) => AnyRawBuilder;
+export declare type AliasedRawBuilderFactory<DB, TB extends keyof DB> = (qb: SubQueryBuilder<DB, TB>) => AnyAliasedRawBuilder;
 export interface InsertResultTypeTag {
+    /** @internal */
     __isInsertResultTypeTag__: true;
 }
 export interface DeleteResultTypeTag {
+    /** @internal */
     __isDeleteResultTypeTag__: true;
 }
 export interface UpdateResultTypeTag {
+    /** @internal */
     __isUpdateResultTypeTag__: true;
 }
+export interface GeneratedPlaceholder {
+    /** @internal */
+    __isGeneratedPlaceholder__: true;
+}
 export declare type ManyResultRowType<O> = O extends InsertResultTypeTag ? number | undefined : O extends DeleteResultTypeTag ? number : O extends UpdateResultTypeTag ? number : O;
 export declare type SingleResultRowType<O> = O extends InsertResultTypeTag ? number | undefined : O extends DeleteResultTypeTag ? number : O extends UpdateResultTypeTag ? number : O | undefined;
 export declare type NonEmptySingleResultRowType<O> = O extends InsertResultTypeTag ? number : O extends DeleteResultTypeTag ? number : O extends UpdateResultTypeTag ? number : O;

package/dist/cjs/query-compiler/default-query-compiler.js

@@ -38,8 +38,8 @@ class DefaultQueryCompiler extends operation_node_visitor_js_1.OperationNodeVisi
             this.compileDistinctOn(node.distinctOnSelections);
             this.append(' ');
         }
-        if (node.modifier === 'Distinct') {
-            this.append(SELECT_MODIFIER_SQL[node.modifier]);
+        if (node.isDistinct) {
+            this.append('distinct');
             this.append(' ');
         }
         if (node.selections) {
@@ -75,9 +75,11 @@ class DefaultQueryCompiler extends operation_node_visitor_js_1.OperationNodeVisi
             this.append(' ');
             this.visitNode(node.offset);
         }
-        if (node.modifier) {
-            this.append(' ');
-            this.append(SELECT_MODIFIER_SQL[node.modifier]);
+        if (node.modifiers) {
+            node.modifiers.forEach((modifier) => {
+                this.append(' ');
+                this.append(SELECT_MODIFIER_SQL[modifier]);
+            });
         }
         if (isSubQuery) {
             this.append(')');
@@ -626,7 +628,6 @@ class DefaultQueryCompiler extends operation_node_visitor_js_1.OperationNodeVisi
 }
 exports.DefaultQueryCompiler = DefaultQueryCompiler;
 const SELECT_MODIFIER_SQL = {
-    Distinct: 'distinct',
     ForKeyShare: 'for key share',
     ForNoKeyUpdate: 'for no key update',
     ForUpdate: 'for update',

package/dist/cjs/query-creator.d.ts

@@ -138,6 +138,7 @@ export declare class QueryCreator<DB> {
      * const maybePrimaryKey: number | undefined = await db
      *   .insertInto('person')
      *   .values({
+     *     id: db.generated,
      *     first_name: 'Jennifer',
      *     last_name: 'Aniston'
      *   })
@@ -151,6 +152,7 @@ export declare class QueryCreator<DB> {
      * const { id } = await db
      *   .insertInto('person')
      *   .values({
+     *     id: db.generated,
      *     first_name: 'Jennifer',
      *     last_name: 'Aniston'
      *   })

package/dist/cjs/query-creator.js

@@ -43,6 +43,7 @@ class QueryCreator {
      * const maybePrimaryKey: number | undefined = await db
      *   .insertInto('person')
      *   .values({
+     *     id: db.generated,
      *     first_name: 'Jennifer',
      *     last_name: 'Aniston'
      *   })
@@ -56,6 +57,7 @@ class QueryCreator {
      * const { id } = await db
      *   .insertInto('person')
      *   .values({
+     *     id: db.generated,
      *     first_name: 'Jennifer',
      *     last_name: 'Aniston'
      *   })

package/dist/cjs/schema/alter-table-builder.d.ts

@@ -9,6 +9,7 @@ import { Compilable } from '../util/compilable.js';
 import { PrimitiveValue } from '../util/object-utils.js';
 import { QueryExecutor } from '../query-executor/query-executor.js';
 import { ColumnDefinitionBuilder, ColumnDefinitionBuilderInterface } from './column-definition-builder.js';
+import { AnyRawBuilder } from '../query-builder/type-utils.js';
 export declare class AlterTableBuilder {
     #private;
     constructor(args: AlterTableBuilderConstructorArgs);
@@ -23,7 +24,7 @@ export declare class AlterColumnBuilder {
     #private;
     constructor(args: AlterColumnBuilderConstructorArgs);
     setDataType(dataType: ColumnDataType): AlterTableExecutor;
-    setDefault(value: PrimitiveValue | RawBuilder<any>): AlterTableExecutor;
+    setDefault(value: PrimitiveValue | AnyRawBuilder): AlterTableExecutor;
     dropDefault(): AlterTableExecutor;
     setNotNull(): AlterTableExecutor;
     dropNotNull(): AlterTableExecutor;
@@ -44,7 +45,7 @@ export declare class AlterTableAddColumnBuilder implements ColumnDefinitionBuild
     onDelete(onDelete: OnDelete): AlterTableAddColumnBuilder;
     unique(): AlterTableAddColumnBuilder;
     notNull(): AlterTableAddColumnBuilder;
-    defaultTo(value: PrimitiveValue | RawBuilder<any>): AlterTableAddColumnBuilder;
+    defaultTo(value: PrimitiveValue | AnyRawBuilder): AlterTableAddColumnBuilder;
     check(sql: string): AlterTableAddColumnBuilder;
     toOperationNode(): AlterTableNode;
     compile(): CompiledQuery;

package/dist/cjs/schema/column-definition-builder.d.ts

@@ -1,8 +1,8 @@
 import { OperationNodeSource } from '../operation-node/operation-node-source.js';
 import { OnDelete } from '../operation-node/references-node.js';
-import { RawBuilder } from '../raw-builder/raw-builder.js';
 import { PrimitiveValue } from '../util/object-utils.js';
 import { ColumnDefinitionNode } from '../operation-node/column-definition-node.js';
+import { AnyRawBuilder } from '../query-builder/type-utils.js';
 export interface ColumnDefinitionBuilderInterface<R> {
     /**
      * Makes the column automatically incrementing.
@@ -51,7 +51,7 @@ export interface ColumnDefinitionBuilderInterface<R> {
      *   .execute()
      * ```
      */
-    defaultTo(value: PrimitiveValue | RawBuilder<any>): R;
+    defaultTo(value: PrimitiveValue | AnyRawBuilder): R;
     /**
      * Adds a check constraint for the column.
      *
@@ -74,7 +74,7 @@ export declare class ColumnDefinitionBuilder implements ColumnDefinitionBuilderI
     onDelete(onDelete: OnDelete): ColumnDefinitionBuilder;
     unique(): ColumnDefinitionBuilder;
     notNull(): ColumnDefinitionBuilder;
-    defaultTo(value: PrimitiveValue | RawBuilder<any>): ColumnDefinitionBuilder;
+    defaultTo(value: PrimitiveValue | AnyRawBuilder): ColumnDefinitionBuilder;
     check(sql: string): ColumnDefinitionBuilder;
     toOperationNode(): ColumnDefinitionNode;
 }

package/dist/cjs/util/generated-placeholder.d.ts

@@ -0,0 +1,3 @@
+import { GeneratedPlaceholder } from '../query-builder/type-utils';
+export declare const generatedPlaceholder: GeneratedPlaceholder;
+export declare function isGeneratedPlaceholder(obj: unknown): obj is GeneratedPlaceholder;

package/dist/cjs/util/generated-placeholder.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isGeneratedPlaceholder = exports.generatedPlaceholder = void 0;
+const object_utils_1 = require("./object-utils");
+exports.generatedPlaceholder = object_utils_1.freeze({
+    __isGeneratedPlaceholder__: true,
+});
+function isGeneratedPlaceholder(obj) {
+    return object_utils_1.isObject(obj) && obj.__isGeneratedPlaceholder__ === true;
+}
+exports.isGeneratedPlaceholder = isGeneratedPlaceholder;

package/dist/cjs/util/object-utils.d.ts

@@ -15,3 +15,4 @@ export declare function getLast<T>(arr: ArrayLike<T>): T | undefined;
 export declare function freeze<T>(obj: T): Readonly<T>;
 export declare function asArray<T>(arg: T | T[]): T[];
 export declare function asReadonlyArray<T>(arg: T | ReadonlyArray<T>): ReadonlyArray<T>;
+export declare function isReadonlyArray(arg: unknown): arg is ReadonlyArray<unknown>;

package/dist/cjs/util/object-utils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.asReadonlyArray = exports.asArray = exports.freeze = exports.getLast = exports.isObject = exports.isFunction = exports.isPrimitive = exports.isBigInt = exports.isBuffer = exports.isDate = exports.isNull = exports.isBoolean = exports.isNumber = exports.isString = exports.isEmpty = void 0;
+exports.isReadonlyArray = exports.asReadonlyArray = exports.asArray = exports.freeze = exports.getLast = exports.isObject = exports.isFunction = exports.isPrimitive = exports.isBigInt = exports.isBuffer = exports.isDate = exports.isNull = exports.isBoolean = exports.isNumber = exports.isString = exports.isEmpty = void 0;
 function isEmpty(obj) {
     if (Array.isArray(obj) || isString(obj) || Buffer.isBuffer(obj)) {
         return obj.length === 0;
@@ -86,3 +86,4 @@ exports.asReadonlyArray = asReadonlyArray;
 function isReadonlyArray(arg) {
     return Array.isArray(arg);
 }
+exports.isReadonlyArray = isReadonlyArray;

package/dist/esm/dialect/postgres/postgres-driver.js

@@ -23,6 +23,7 @@ export class PostgresDriver extends Driver {
             port: cfg.port,
             user: cfg.user,
             password: cfg.password,
+            ssl: cfg.ssl,
             // Pool options.
             connectionTimeoutMillis: cfg.pool.connectionTimeoutMillis,
             idleTimeoutMillis: cfg.pool.idleTimeoutMillis,
@@ -59,7 +60,7 @@ export class PostgresDriver extends Driver {
 async function importPgPool() {
     try {
         // For this to work with both esm and cjs modules we need
-        // this hacky craph here.
+        // this hacky crap here.
         const pg = (await import('pg'));
         if (isFunction(pg.Pool)) {
             return pg.Pool;

package/dist/esm/driver/driver-config.d.ts

@@ -1,3 +1,5 @@
+/// <reference types="node" />
+import { SecureContextOptions } from 'tls';
 import { DatabaseConnection } from './database-connection.js';
 export interface DriverConfig {
     /**
@@ -24,6 +26,10 @@ export interface DriverConfig {
      * Connection pooling config.
      */
     pool?: PoolConfig;
+    /**
+     * Optional SSL configuration.
+     */
+    ssl?: SecureContextOptions;
 }
 export interface PoolConfig {
     /**

package/dist/esm/index.d.ts

@@ -95,4 +95,15 @@ export * from './operation-node/offset-node.js';
 export * from './operation-node//on-conflict-node.js';
 export * from './operation-node/operation-node.js';
 export * from './operation-node/operation-node-source.js';
+export * from './operation-node/order-by-node.js';
 export * from './util/compilable.js';
+export { AnyColumn } from './query-builder/type-utils.js';
+export { SelectExpression, SelectExpressionOrList, } from './parser/select-parser';
+export { ReferenceExpression, ReferenceExpressionOrList, } from './parser/reference-parser';
+export { ValueExpression, ValueExpressionOrList } from './parser/value-parser';
+export { ExistsExpression, FilterOperator } from './parser/filter-parser';
+export { TableExpression } from './parser/table-parser';
+export { JoinReferenceExpression, JoinCallbackExpression, } from './parser/join-parser';
+export { InsertObject } from './parser/insert-values-parser';
+export { MutationObject } from './parser/mutation-parser';
+export { OrderByExpression } from './parser/order-by-parser';

package/dist/esm/index.js

@@ -95,4 +95,5 @@ export * from './operation-node/offset-node.js';
 export * from './operation-node//on-conflict-node.js';
 export * from './operation-node/operation-node.js';
 export * from './operation-node/operation-node-source.js';
+export * from './operation-node/order-by-node.js';
 export * from './util/compilable.js';

package/dist/esm/kysely.d.ts

@@ -8,6 +8,7 @@ import { MigrationModule } from './migration/migration.js';
 import { QueryExecutor } from './query-executor/query-executor.js';
 import { QueryCreator } from './query-creator.js';
 import { KyselyPlugin } from './plugin/plugin.js';
+import { GeneratedPlaceholder } from './query-builder/type-utils.js';
 /**
  * The main Kysely class.
  *
@@ -62,6 +63,30 @@ export declare class Kysely<DB> extends QueryCreator<DB> {
      * passing in dynamic values for the queries.
      */
     get dynamic(): DynamicModule;
+    /**
+     * A value to be used in place of columns that are generated in the database
+     * when inserting rows.
+     *
+     * @example
+     * In this example the `Person` table has non-null properties `id` and `created_at`
+     * which are both automatically genereted by the database. Since their types are
+     * `number` and `string` respectively instead of `number | null` and `string | null`
+     * the `values` method requires you to give a value for them. the `generated`
+     * placeholder can be used in these cases.
+     *
+     * ```ts
+     * await db.insertInto('person')
+     *   .values({
+     *     id: db.generated,
+     *     created_at: db.generated,
+     *     first_name: 'Jennifer',
+     *     last_name: 'Aniston',
+     *     gender: 'female'
+     *   })
+     *   .execute()
+     * ```
+     */
+    get generated(): GeneratedPlaceholder;
     /**
      * Starts a transaction. If the callback throws the transaction is rolled back,
      * otherwise it's committed.

package/dist/esm/kysely.js

@@ -8,6 +8,7 @@ import { INTERNAL_DRIVER_ACQUIRE_CONNECTION, INTERNAL_DRIVER_ENSURE_DESTROY, INT
 import { MigrationModule } from './migration/migration.js';
 import { DefaultQueryExecutor, } from './query-executor/query-executor.js';
 import { QueryCreator } from './query-creator.js';
+import { generatedPlaceholder } from './util/generated-placeholder.js';
 /**
  * The main Kysely class.
  *
@@ -94,6 +95,32 @@ export class Kysely extends QueryCreator {
     get dynamic() {
         return new DynamicModule();
     }
+    /**
+     * A value to be used in place of columns that are generated in the database
+     * when inserting rows.
+     *
+     * @example
+     * In this example the `Person` table has non-null properties `id` and `created_at`
+     * which are both automatically genereted by the database. Since their types are
+     * `number` and `string` respectively instead of `number | null` and `string | null`
+     * the `values` method requires you to give a value for them. the `generated`
+     * placeholder can be used in these cases.
+     *
+     * ```ts
+     * await db.insertInto('person')
+     *   .values({
+     *     id: db.generated,
+     *     created_at: db.generated,
+     *     first_name: 'Jennifer',
+     *     last_name: 'Aniston',
+     *     gender: 'female'
+     *   })
+     *   .execute()
+     * ```
+     */
+    get generated() {
+        return generatedPlaceholder;
+    }
     /**
      * Starts a transaction. If the callback throws the transaction is rolled back,
      * otherwise it's committed.

package/dist/esm/operation-node/operation-node-transformer.js

@@ -109,11 +109,12 @@ export class OperationNodeTransformer {
             from: this.transformNode(node.from),
             selections: this.transformNodeList(node.selections),
             distinctOnSelections: this.transformNodeList(node.distinctOnSelections),
+            isDistinct: node.isDistinct,
             joins: this.transformNodeList(node.joins),
             groupBy: this.transformNode(node.groupBy),
             orderBy: this.transformNode(node.orderBy),
             where: this.transformNode(node.where),
-            modifier: node.modifier,
+            modifiers: node.modifiers,
             limit: this.transformNode(node.limit),
             offset: this.transformNode(node.offset),
             with: this.transformNode(node.with),

package/dist/esm/operation-node/select-query-node.d.ts

@@ -12,17 +12,18 @@ import { OrderByNode } from './order-by-node.js';
 import { SelectionNode } from './selection-node.js';
 import { WhereNode } from './where-node.js';
 import { WithNode } from './with-node.js';
-export declare type SelectModifier = 'Distinct' | 'ForUpdate' | 'ForNoKeyUpdate' | 'ForShare' | 'ForKeyShare' | 'NoWait' | 'SkipLocked';
+export declare type SelectModifier = 'ForUpdate' | 'ForNoKeyUpdate' | 'ForShare' | 'ForKeyShare' | 'NoWait' | 'SkipLocked';
 export interface SelectQueryNode extends OperationNode {
     readonly kind: 'SelectQueryNode';
     readonly from: FromNode;
     readonly selections?: ReadonlyArray<SelectionNode>;
     readonly distinctOnSelections?: ReadonlyArray<SelectionNode>;
+    readonly isDistinct?: boolean;
     readonly joins?: ReadonlyArray<JoinNode>;
     readonly groupBy?: GroupByNode;
     readonly orderBy?: OrderByNode;
     readonly where?: WhereNode;
-    readonly modifier?: SelectModifier;
+    readonly modifiers?: ReadonlyArray<SelectModifier>;
     readonly limit?: LimitNode;
     readonly offset?: OffsetNode;
     readonly with?: WithNode;
@@ -42,4 +43,5 @@ export declare const selectQueryNode: Readonly<{
     cloneWithLimit(selectNode: SelectQueryNode, limit: LimitNode): SelectQueryNode;
     cloneWithOffset(selectNode: SelectQueryNode, offset: OffsetNode): SelectQueryNode;
     cloneWithHaving(selectNode: SelectQueryNode, op: 'and' | 'or', filter: HavingNodeChild): SelectQueryNode;
+    cloneWithDistinct(selectNode: SelectQueryNode): SelectQueryNode;
 }>;