kysely 0.9.1 → 0.9.5

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

@@ -59,326 +59,11 @@ export class OperationNodeVisitor {
         AddConstraintNode: this.visitAddConstraint.bind(this),
         DropConstraintNode: this.visitDropConstraint.bind(this),
         ForeignKeyConstraintNode: this.visitForeignKeyConstraint.bind(this),
+        UnionNode: this.visitUnion.bind(this),
     };
     visitNode = (node) => {
         this.nodeStack.push(node);
         this.#visitors[node.kind](node);
         this.nodeStack.pop();
     };
-    visitSelectQuery(node) {
-        if (node.with) {
-            this.visitNode(node.with);
-        }
-        if (node.distinctOnSelections) {
-            node.distinctOnSelections.forEach(this.visitNode);
-        }
-        if (node.selections) {
-            node.selections.forEach(this.visitNode);
-        }
-        this.visitNode(node.from);
-        if (node.joins) {
-            node.joins.forEach(this.visitNode);
-        }
-        if (node.where) {
-            this.visitNode(node.where);
-        }
-        if (node.groupBy) {
-            this.visitNode(node.groupBy);
-        }
-        if (node.having) {
-            this.visitNode(node.having);
-        }
-        if (node.orderBy) {
-            this.visitNode(node.orderBy);
-        }
-        if (node.limit) {
-            this.visitNode(node.limit);
-        }
-        if (node.offset) {
-            this.visitNode(node.offset);
-        }
-    }
-    visitSelection(node) {
-        this.visitNode(node.selection);
-    }
-    visitColumn(node) {
-        this.visitNode(node.column);
-    }
-    visitAlias(node) {
-        this.visitNode(node.node);
-    }
-    visitTable(node) {
-        if (node.schema) {
-            this.visitNode(node.schema);
-        }
-        this.visitNode(node.table);
-    }
-    visitFrom(node) {
-        node.froms.forEach(this.visitNode);
-    }
-    visitReference(node) {
-        this.visitNode(node.column);
-        this.visitNode(node.table);
-    }
-    visitFilter(node) {
-        if (node.left) {
-            this.visitNode(node.left);
-        }
-        this.visitNode(node.op);
-        this.visitNode(node.right);
-    }
-    visitAnd(node) {
-        this.visitNode(node.left);
-        this.visitNode(node.right);
-    }
-    visitOr(node) {
-        this.visitNode(node.left);
-        this.visitNode(node.right);
-    }
-    visitValueList(node) {
-        node.values.forEach(this.visitNode);
-    }
-    visitParens(node) {
-        this.visitNode(node.node);
-    }
-    visitJoin(node) {
-        this.visitNode(node.table);
-        if (node.on) {
-            this.visitNode(node.on);
-        }
-    }
-    visitRaw(node) {
-        node.params.forEach(this.visitNode);
-    }
-    visitWhere(node) {
-        this.visitNode(node.where);
-    }
-    visitInsertQuery(node) {
-        if (node.with) {
-            this.visitNode(node.with);
-        }
-        this.visitNode(node.into);
-        if (node.columns) {
-            node.columns.forEach(this.visitNode);
-        }
-        if (node.values) {
-            node.values.forEach(this.visitNode);
-        }
-        if (node.returning) {
-            this.visitNode(node.returning);
-        }
-    }
-    visitDeleteQuery(node) {
-        if (node.with) {
-            this.visitNode(node.with);
-        }
-        this.visitNode(node.from);
-        if (node.joins) {
-            node.joins.forEach(this.visitNode);
-        }
-        if (node.where) {
-            this.visitNode(node.where);
-        }
-        if (node.returning) {
-            this.visitNode(node.returning);
-        }
-    }
-    visitReturning(node) {
-        node.selections.forEach(this.visitNode);
-    }
-    visitCreateTable(node) {
-        this.visitNode(node.table);
-        node.columns.forEach(this.visitNode);
-        if (node.constraints) {
-            node.constraints.forEach(this.visitNode);
-        }
-    }
-    visitAddColumn(node) {
-        this.visitNode(node.column);
-    }
-    visitColumnDefinition(node) {
-        this.visitNode(node.column);
-        this.visitNode(node.dataType);
-        if (node.defaultTo) {
-            this.visitNode(node.defaultTo);
-        }
-        if (node.references) {
-            this.visitNode(node.references);
-        }
-        if (node.check) {
-            this.visitNode(node.check);
-        }
-    }
-    visitDropTable(node) {
-        this.visitNode(node.table);
-    }
-    visitOrderBy(node) {
-        node.items.forEach(this.visitNode);
-    }
-    visitOrderByItem(node) {
-        this.visitNode(node.orderBy);
-    }
-    visitGroupBy(node) {
-        node.items.forEach(this.visitNode);
-    }
-    visitGroupByItem(node) {
-        this.visitNode(node.groupBy);
-    }
-    visitUpdateQuery(node) {
-        if (node.with) {
-            this.visitNode(node.with);
-        }
-        this.visitNode(node.table);
-        if (node.updates) {
-            node.updates.forEach(this.visitNode);
-        }
-        if (node.joins) {
-            node.joins.forEach(this.visitNode);
-        }
-        if (node.where) {
-            this.visitNode(node.where);
-        }
-        if (node.returning) {
-            this.visitNode(node.returning);
-        }
-    }
-    visitColumnUpdate(node) {
-        this.visitNode(node.column);
-        this.visitNode(node.value);
-    }
-    visitLimit(node) {
-        this.visitNode(node.limit);
-    }
-    visitOffset(node) {
-        this.visitNode(node.offset);
-    }
-    visitOnConflict(node) {
-        if (node.columns) {
-            node.columns.forEach(this.visitNode);
-        }
-        if (node.constraint) {
-            this.visitNode(node.constraint);
-        }
-        if (node.updates) {
-            node.updates.forEach(this.visitNode);
-        }
-    }
-    visitOnDuplicateKey(node) {
-        node.updates.forEach(this.visitNode);
-    }
-    visitCreateIndex(node) {
-        this.visitNode(node.name);
-        if (node.table) {
-            this.visitNode(node.table);
-        }
-        if (node.using) {
-            this.visitNode(node.using);
-        }
-        if (node.expression) {
-            this.visitNode(node.expression);
-        }
-    }
-    visitList(node) {
-        node.items.forEach(this.visitNode);
-    }
-    visitDropIndex(node) {
-        this.visitNode(node.name);
-        if (node.table) {
-            this.visitNode(node.table);
-        }
-    }
-    visitPrimaryKeyConstraint(node) {
-        if (node.name) {
-            this.visitNode(node.name);
-        }
-        node.columns.forEach(this.visitNode);
-    }
-    visitUniqueConstraint(node) {
-        if (node.name) {
-            this.visitNode(node.name);
-        }
-        node.columns.forEach(this.visitNode);
-    }
-    visitReferences(node) {
-        node.columns.forEach(this.visitNode);
-        this.visitNode(node.table);
-    }
-    visitCheckConstraint(node) {
-        if (node.name) {
-            this.visitNode(node.name);
-        }
-        this.visitNode(node.expression);
-    }
-    visitWith(node) {
-        node.expressions.forEach(this.visitNode);
-    }
-    visitCommonTableExpression(node) {
-        this.visitNode(node.name);
-        this.visitNode(node.expression);
-    }
-    visitHaving(node) {
-        this.visitNode(node.having);
-    }
-    visitCreateSchema(node) {
-        this.visitNode(node.schema);
-    }
-    visitDropSchema(node) {
-        this.visitNode(node.schema);
-    }
-    visitAlterTable(node) {
-        this.visitNode(node.table);
-        if (node.renameTo) {
-            this.visitNode(node.renameTo);
-        }
-        if (node.renameColumn) {
-            this.visitNode(node.renameColumn);
-        }
-        if (node.setSchema) {
-            this.visitNode(node.setSchema);
-        }
-        if (node.addColumn) {
-            this.visitNode(node.addColumn);
-        }
-        if (node.dropColumn) {
-            this.visitNode(node.dropColumn);
-        }
-        if (node.alterColumn) {
-            this.visitNode(node.alterColumn);
-        }
-        if (node.modifyColumn) {
-            this.visitNode(node.modifyColumn);
-        }
-    }
-    visitDropColumn(node) {
-        this.visitNode(node.column);
-    }
-    visitRenameColumn(node) {
-        this.visitNode(node.column);
-        this.visitNode(node.renameTo);
-    }
-    visitAlterColumn(node) {
-        this.visitNode(node.column);
-    }
-    visitModifyColumn(node) {
-        this.visitNode(node.column);
-    }
-    visitAddConstraint(node) {
-        this.visitNode(node.constraint);
-    }
-    visitDropConstraint(node) {
-        this.visitNode(node.constraintName);
-    }
-    visitForeignKeyConstraint(node) {
-        if (node.name) {
-            this.visitNode(node.name);
-        }
-        node.columns.forEach(this.visitNode);
-        this.visitNode(node.references);
-    }
-    visitDataType(node) { }
-    visitSelectAll(_) { }
-    visitIdentifier(_) { }
-    visitValue(_) { }
-    visitPrimitiveValueList(_) { }
-    visitOperator(node) { }
 }

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

@@ -1,4 +1,4 @@
-export declare type OperationNodeKind = 'IdentifierNode' | 'RawNode' | 'SelectQueryNode' | 'SelectionNode' | 'ReferenceNode' | 'ColumnNode' | 'TableNode' | 'AliasNode' | 'FromNode' | 'SelectAllNode' | 'FilterNode' | 'AndNode' | 'OrNode' | 'ParensNode' | 'ValueNode' | 'ValueListNode' | 'PrimitiveValueListNode' | 'JoinNode' | 'OperatorNode' | 'WhereNode' | 'InsertQueryNode' | 'DeleteQueryNode' | 'ReturningNode' | 'CreateTableNode' | 'ColumnDefinitionNode' | 'AddColumnNode' | 'DropTableNode' | 'DataTypeNode' | 'OrderByNode' | 'OrderByItemNode' | 'GroupByNode' | 'GroupByItemNode' | 'UpdateQueryNode' | 'ColumnUpdateNode' | 'LimitNode' | 'OffsetNode' | 'OnConflictNode' | 'OnDuplicateKeyNode' | 'CreateIndexNode' | 'DropIndexNode' | 'ListNode' | 'ReferencesNode' | 'PrimaryKeyConstraintNode' | 'UniqueConstraintNode' | 'CheckConstraintNode' | 'ForeignKeyConstraintNode' | 'WithNode' | 'CommonTableExpressionNode' | 'HavingNode' | 'CreateSchemaNode' | 'DropSchemaNode' | 'AlterTableNode' | 'ModifyColumnNode' | 'DropColumnNode' | 'RenameColumnNode' | 'AlterColumnNode' | 'AddConstraintNode' | 'DropConstraintNode';
+export declare type OperationNodeKind = 'IdentifierNode' | 'RawNode' | 'SelectQueryNode' | 'SelectionNode' | 'ReferenceNode' | 'ColumnNode' | 'TableNode' | 'AliasNode' | 'FromNode' | 'SelectAllNode' | 'FilterNode' | 'AndNode' | 'OrNode' | 'ParensNode' | 'ValueNode' | 'ValueListNode' | 'PrimitiveValueListNode' | 'JoinNode' | 'OperatorNode' | 'WhereNode' | 'InsertQueryNode' | 'DeleteQueryNode' | 'ReturningNode' | 'CreateTableNode' | 'ColumnDefinitionNode' | 'AddColumnNode' | 'DropTableNode' | 'DataTypeNode' | 'OrderByNode' | 'OrderByItemNode' | 'GroupByNode' | 'GroupByItemNode' | 'UpdateQueryNode' | 'ColumnUpdateNode' | 'LimitNode' | 'OffsetNode' | 'OnConflictNode' | 'OnDuplicateKeyNode' | 'CreateIndexNode' | 'DropIndexNode' | 'ListNode' | 'ReferencesNode' | 'PrimaryKeyConstraintNode' | 'UniqueConstraintNode' | 'CheckConstraintNode' | 'ForeignKeyConstraintNode' | 'WithNode' | 'CommonTableExpressionNode' | 'HavingNode' | 'CreateSchemaNode' | 'DropSchemaNode' | 'AlterTableNode' | 'ModifyColumnNode' | 'DropColumnNode' | 'RenameColumnNode' | 'AlterColumnNode' | 'AddConstraintNode' | 'DropConstraintNode' | 'UnionNode';
 export interface OperationNode {
     readonly kind: OperationNodeKind;
 }

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

@@ -16,7 +16,8 @@ export declare const QueryNode: Readonly<{
     is(node: OperationNode): node is QueryNode;
     isMutating(node: OperationNode): node is MutatingQueryNode;
     isFilterable(node: OperationNode): node is FilterableQueryNode;
-    cloneWithWhere<T extends FilterableQueryNode>(node: T, op: 'And' | 'Or', filter: WhereChildNode): T;
-    cloneWithJoin<T_1 extends FilterableQueryNode>(node: T_1, join: JoinNode): T_1;
-    cloneWithReturning<T_2 extends MutatingQueryNode>(node: T_2, selections: ReadonlyArray<SelectionNode>): T_2;
+    cloneWithWhere<T extends FilterableQueryNode>(node: T, filter: WhereChildNode): T;
+    cloneWithOrWhere<T_1 extends FilterableQueryNode>(node: T_1, filter: WhereChildNode): T_1;
+    cloneWithJoin<T_2 extends FilterableQueryNode>(node: T_2, join: JoinNode): T_2;
+    cloneWithReturning<T_3 extends MutatingQueryNode>(node: T_3, selections: ReadonlyArray<SelectionNode>): T_3;
 }>;

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

@@ -25,11 +25,19 @@ export const QueryNode = freeze({
             DeleteQueryNode.is(node) ||
             UpdateQueryNode.is(node));
     },
-    cloneWithWhere(node, op, filter) {
+    cloneWithWhere(node, filter) {
         return freeze({
             ...node,
             where: node.where
-                ? WhereNode.cloneWithFilter(node.where, op, filter)
+                ? WhereNode.cloneWithFilter(node.where, 'And', filter)
+                : WhereNode.create(filter),
+        });
+    },
+    cloneWithOrWhere(node, filter) {
+        return freeze({
+            ...node,
+            where: node.where
+                ? WhereNode.cloneWithFilter(node.where, 'Or', filter)
                 : WhereNode.create(filter),
         });
     },

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

@@ -12,6 +12,7 @@ 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';
+import { UnionNode } from './union-node.js';
 export declare type SelectModifier = 'ForUpdate' | 'ForNoKeyUpdate' | 'ForShare' | 'ForKeyShare' | 'NoWait' | 'SkipLocked';
 export interface SelectQueryNode extends OperationNode {
     readonly kind: 'SelectQueryNode';
@@ -28,6 +29,7 @@ export interface SelectQueryNode extends OperationNode {
     readonly offset?: OffsetNode;
     readonly with?: WithNode;
     readonly having?: HavingNode;
+    readonly union?: ReadonlyArray<UnionNode>;
 }
 /**
  * @internal
@@ -42,6 +44,8 @@ export declare const SelectQueryNode: Readonly<{
     cloneWithGroupByItems(selectNode: SelectQueryNode, items: ReadonlyArray<GroupByItemNode>): SelectQueryNode;
     cloneWithLimit(selectNode: SelectQueryNode, limit: LimitNode): SelectQueryNode;
     cloneWithOffset(selectNode: SelectQueryNode, offset: OffsetNode): SelectQueryNode;
-    cloneWithHaving(selectNode: SelectQueryNode, op: 'And' | 'Or', filter: HavingNodeChild): SelectQueryNode;
+    cloneWithHaving(selectNode: SelectQueryNode, filter: HavingNodeChild): SelectQueryNode;
+    cloneWithOrHaving(selectNode: SelectQueryNode, filter: HavingNodeChild): SelectQueryNode;
     cloneWithDistinct(selectNode: SelectQueryNode): SelectQueryNode;
+    cloneWithUnion(selectNode: SelectQueryNode, union: UnionNode): SelectQueryNode;
 }>;

package/dist/esm/operation-node/select-query-node.js

@@ -69,11 +69,19 @@ export const SelectQueryNode = freeze({
             offset,
         });
     },
-    cloneWithHaving(selectNode, op, filter) {
+    cloneWithHaving(selectNode, filter) {
         return freeze({
             ...selectNode,
             having: selectNode.having
-                ? HavingNode.cloneWithFilter(selectNode.having, op, filter)
+                ? HavingNode.cloneWithFilter(selectNode.having, 'And', filter)
+                : HavingNode.create(filter),
+        });
+    },
+    cloneWithOrHaving(selectNode, filter) {
+        return freeze({
+            ...selectNode,
+            having: selectNode.having
+                ? HavingNode.cloneWithFilter(selectNode.having, 'Or', filter)
                 : HavingNode.create(filter),
         });
     },
@@ -83,4 +91,12 @@ export const SelectQueryNode = freeze({
             isDistinct: true,
         });
     },
+    cloneWithUnion(selectNode, union) {
+        return freeze({
+            ...selectNode,
+            union: selectNode.union
+                ? freeze([...selectNode.union, union])
+                : freeze([union]),
+        });
+    },
 });

package/dist/esm/operation-node/union-node.d.ts

@@ -0,0 +1,16 @@
+import { OperationNode } from './operation-node.js';
+import { RawNode } from './raw-node.js';
+import { SelectQueryNode } from './select-query-node.js';
+export declare type UnionExpressionNode = SelectQueryNode | RawNode;
+export interface UnionNode extends OperationNode {
+    readonly kind: 'UnionNode';
+    readonly union: UnionExpressionNode;
+    readonly all: boolean;
+}
+/**
+ * @internal
+ */
+export declare const UnionNode: Readonly<{
+    is(node: OperationNode): node is UnionNode;
+    create(union: UnionExpressionNode, all: boolean): UnionNode;
+}>;

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

@@ -0,0 +1,16 @@
+import { freeze } from '../util/object-utils.js';
+/**
+ * @internal
+ */
+export const UnionNode = freeze({
+    is(node) {
+        return node.kind === 'UnionNode';
+    },
+    create(union, all) {
+        return freeze({
+            kind: 'UnionNode',
+            union,
+            all,
+        });
+    },
+});

package/dist/esm/parser/group-by-parser.d.ts

@@ -0,0 +1,4 @@
+import { GroupByItemNode } from '../operation-node/group-by-item-node.js';
+import { ParseContext } from './parse-context.js';
+import { ReferenceExpressionOrList } from './reference-parser.js';
+export declare function parseGroupBy(ctx: ParseContext, orderBy: ReferenceExpressionOrList<any, any>): GroupByItemNode[];

package/dist/esm/parser/group-by-parser.js

@@ -0,0 +1,5 @@
+import { GroupByItemNode } from '../operation-node/group-by-item-node.js';
+import { parseReferenceExpressionOrList, } from './reference-parser.js';
+export function parseGroupBy(ctx, orderBy) {
+    return parseReferenceExpressionOrList(ctx, orderBy).map(GroupByItemNode.create);
+}

package/dist/esm/parser/insert-values-parser.d.ts

@@ -8,7 +8,7 @@ import { PrimitiveValue } from '../util/object-utils.js';
 export declare type InsertObject<DB, TB extends keyof DB> = {
     [C in keyof DB[TB]]: InsertValueExpression<DB[TB][C]>;
 };
-export declare type InsertObjectOrList<DB, TB extends keyof DB> = InsertObject<DB, TB> | InsertObject<DB, TB>[];
+export declare type InsertObjectOrList<DB, TB extends keyof DB> = InsertObject<DB, TB> | ReadonlyArray<InsertObject<DB, TB>>;
 declare type InsertValueExpression<T> = T | AnyQueryBuilder | AnyRawBuilder | GeneratedPlaceholder;
 export declare function parseInsertObjectOrList(args: InsertObjectOrList<any, any>): [ReadonlyArray<ColumnNode>, ReadonlyArray<InsertValuesNode>];
 export declare function parseInsertValueExpression(value: InsertValueExpression<PrimitiveValue>): ValueNode | RawNode | SelectQueryNode;

package/dist/esm/parser/join-parser.d.ts

@@ -3,9 +3,9 @@ import { AnyColumn, AnyColumnWithTable } from '../util/type-utils.js';
 import { ExtractAliasFromTableExpression, TableExpressionDatabase } from './table-parser.js';
 import { JoinBuilder } from '../query-builder/join-builder.js';
 import { ParseContext } from './parse-context.js';
-export declare type JoinReferenceExpression<DB, TB extends keyof DB, F> = AnyJoinColumn<DB, TB, F> | AnyJoinColumnWithTable<DB, TB, F>;
-export declare type JoinCallbackExpression<DB, TB extends keyof DB, F> = (join: JoinBuilder<TableExpressionDatabase<DB, F>, TB | ExtractAliasFromTableExpression<DB, F>>) => JoinBuilder<any, any>;
-declare type AnyJoinColumn<DB, TB extends keyof DB, F> = AnyColumn<TableExpressionDatabase<DB, F>, TB | ExtractAliasFromTableExpression<DB, F>>;
-declare type AnyJoinColumnWithTable<DB, TB extends keyof DB, F> = AnyColumnWithTable<TableExpressionDatabase<DB, F>, TB | ExtractAliasFromTableExpression<DB, F>>;
+export declare type JoinReferenceExpression<DB, TB extends keyof DB, TE> = AnyJoinColumn<DB, TB, TE> | AnyJoinColumnWithTable<DB, TB, TE>;
+export declare type JoinCallbackExpression<DB, TB extends keyof DB, TE> = (join: JoinBuilder<TableExpressionDatabase<DB, TE>, TB | ExtractAliasFromTableExpression<DB, TE>>) => JoinBuilder<any, any>;
+declare type AnyJoinColumn<DB, TB extends keyof DB, TE> = AnyColumn<TableExpressionDatabase<DB, TE>, TB | ExtractAliasFromTableExpression<DB, TE>>;
+declare type AnyJoinColumnWithTable<DB, TB extends keyof DB, TE> = AnyColumnWithTable<TableExpressionDatabase<DB, TE>, TB | ExtractAliasFromTableExpression<DB, TE>>;
 export declare function parseJoin(ctx: ParseContext, joinType: JoinType, args: any[]): JoinNode;
 export {};

package/dist/esm/parser/order-by-parser.d.ts

@@ -1,10 +1,8 @@
-import { ReferenceExpressionNode } from '../operation-node/operation-node-utils.js';
-import { RawNode } from '../operation-node/raw-node.js';
+import { OrderByItemNode } from '../operation-node/order-by-item-node.js';
 import { AnyRawBuilder } from '../util/type-utils.js';
 import { ParseContext } from './parse-context.js';
 import { ReferenceExpression } from './reference-parser.js';
 export declare type OrderByDirection = 'asc' | 'desc';
 export declare type OrderByExpression<DB, TB extends keyof DB, O> = ReferenceExpression<DB, TB> | keyof O;
 export declare type OrderByDirectionExpression = OrderByDirection | AnyRawBuilder;
-export declare function parseOrderByExpression(ctx: ParseContext, expr: OrderByExpression<any, any, any>): ReferenceExpressionNode;
-export declare function parseOrderByDirectionExpression(expr?: OrderByDirectionExpression): RawNode | undefined;
+export declare function parseOrderBy(ctx: ParseContext, orderBy: OrderByExpression<any, any, any>, direction?: OrderByDirectionExpression): OrderByItemNode;

package/dist/esm/parser/order-by-parser.js

@@ -1,9 +1,13 @@
+import { OrderByItemNode } from '../operation-node/order-by-item-node.js';
 import { RawNode } from '../operation-node/raw-node.js';
 import { parseReferenceExpression, } from './reference-parser.js';
-export function parseOrderByExpression(ctx, expr) {
+export function parseOrderBy(ctx, orderBy, direction) {
+    return OrderByItemNode.create(parseOrderByExpression(ctx, orderBy), parseOrderByDirectionExpression(direction));
+}
+function parseOrderByExpression(ctx, expr) {
     return parseReferenceExpression(ctx, expr);
 }
-export function parseOrderByDirectionExpression(expr) {
+function parseOrderByDirectionExpression(expr) {
     if (!expr) {
         return undefined;
     }

package/dist/esm/parser/reference-parser.d.ts

@@ -9,7 +9,7 @@ import { RawBuilder } from '../raw-builder/raw-builder.js';
 import { QueryBuilder } from '../query-builder/query-builder.js';
 import { ParseContext } from './parse-context.js';
 export declare type ReferenceExpression<DB, TB extends keyof DB> = StringReference<DB, TB> | AnyQueryBuilder | QueryBuilderFactory<DB, TB> | AnyRawBuilder | RawBuilderFactory<DB, TB> | DynamicReferenceBuilder<any>;
-export declare type ReferenceExpressionOrList<DB, TB extends keyof DB> = ReferenceExpression<DB, TB> | ReferenceExpression<DB, TB>[];
+export declare type ReferenceExpressionOrList<DB, TB extends keyof DB> = ReferenceExpression<DB, TB> | ReadonlyArray<ReferenceExpression<DB, TB>>;
 export declare type StringReference<DB, TB extends keyof DB> = AnyColumn<DB, TB> | AnyColumnWithTable<DB, TB>;
 export declare type ExtractTypeFromReferenceExpression<DB, TB extends keyof DB, RE> = RE extends string ? ExtractTypeFromStringReference<DB, TB, RE> : RE extends RawBuilder<infer O> ? O : RE extends (qb: any) => RawBuilder<infer O> ? O : RE extends QueryBuilder<any, any, infer O> ? ValueType<O> : RE extends (qb: any) => QueryBuilder<any, any, infer O> ? ValueType<O> : PrimitiveValue;
 declare type ExtractTypeFromStringReference<DB, TB extends keyof DB, S extends string, R = RowType<DB, TB>> = S extends `${infer SC}.${infer T}.${infer C}` ? `${SC}.${T}` extends TB ? C extends keyof DB[`${SC}.${T}`] ? DB[`${SC}.${T}`][C] : never : never : S extends `${infer T}.${infer C}` ? T extends TB ? C extends keyof DB[T] ? DB[T][C] : never : never : S extends keyof R ? R[S] : PrimitiveValue;

package/dist/esm/parser/reference-parser.js

@@ -3,10 +3,10 @@ import { ColumnNode } from '../operation-node/column-node.js';
 import { isOperationNodeSource } from '../operation-node/operation-node-source.js';
 import { ReferenceNode } from '../operation-node/reference-node.js';
 import { TableNode } from '../operation-node/table-node.js';
-import { isFunction, isString } from '../util/object-utils.js';
+import { isFunction, isReadonlyArray, isString, } from '../util/object-utils.js';
 import { QueryNode } from '../operation-node/query-node.js';
 export function parseReferenceExpressionOrList(ctx, arg) {
-    if (Array.isArray(arg)) {
+    if (isReadonlyArray(arg)) {
         return arg.map((it) => parseReferenceExpression(ctx, it));
     }
     else {

package/dist/esm/parser/union-parser.d.ts

@@ -0,0 +1,5 @@
+import { UnionNode } from '../operation-node/union-node.js';
+import { QueryBuilder } from '../query-builder/query-builder.js';
+import { RawBuilder } from '../raw-builder/raw-builder.js';
+export declare type UnionExpression<DB, O> = QueryBuilder<DB, any, O> | RawBuilder<O>;
+export declare function parseUnion(union: UnionExpression<any, any>, all: boolean): UnionNode;

package/dist/esm/parser/union-parser.js

@@ -0,0 +1,9 @@
+import { QueryNode } from '../operation-node/query-node.js';
+import { UnionNode } from '../operation-node/union-node.js';
+export function parseUnion(union, all) {
+    const node = union.toOperationNode();
+    if (QueryNode.isMutating(node)) {
+        throw new Error("can't combine insert, update or delete queries using union");
+    }
+    return UnionNode.create(node, all);
+}

package/dist/esm/parser/value-parser.d.ts

@@ -3,6 +3,6 @@ import { AnyQueryBuilder, AnyRawBuilder, QueryBuilderFactory, RawBuilderFactory
 import { ExtractTypeFromReferenceExpression } from './reference-parser.js';
 import { ParseContext } from './parse-context.js';
 export declare type ValueExpression<DB, TB extends keyof DB, RE> = ExtractTypeFromReferenceExpression<DB, TB, RE> | AnyQueryBuilder | QueryBuilderFactory<DB, TB> | AnyRawBuilder | RawBuilderFactory<DB, TB>;
-export declare type ValueExpressionOrList<DB, TB extends keyof DB, RE> = ValueExpression<DB, TB, RE> | ValueExpression<DB, TB, RE>[];
+export declare type ValueExpressionOrList<DB, TB extends keyof DB, RE> = ValueExpression<DB, TB, RE> | ReadonlyArray<ValueExpression<DB, TB, RE>>;
 export declare function parseValueExpressionOrList(ctx: ParseContext, arg: ValueExpressionOrList<any, any, any>): ValueExpressionNode;
 export declare function parseValueExpression(ctx: ParseContext, arg: ValueExpression<any, any, any>): ValueExpressionNode;