@uwdata/mosaic-sql 0.17.0 → 0.18.0

package/LICENSE

@@ -0,0 +1,47 @@
+BSD 3-Clause License
+
+Copyright (c) 2023-2025, UW Interactive Data Lab
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+---
+
+Portions of this software are derived from Observable Plot, which is released
+under the ISC license.
+
+Copyright 2020-2023 Observable, Inc.
+
+Permission to use, copy, modify, and/or distribute this software for any purpose
+with or without fee is hereby granted, provided that the above copyright notice
+and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
+OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
+THIS SOFTWARE.

package/README.md

@@ -3,5 +3,3 @@
 [![npm version](https://img.shields.io/npm/v/@uwdata/mosaic-sql.svg)](https://www.npmjs.com/package/@uwdata/mosaic-sql)
 
 An API for convenient construction and analysis of SQL queries. Constructed `Query` objects coerce to SQL query strings.
-
-Many `mosaic-sql` utilities are included as part of the [vgplot](https://github.com/uwdata/mosaic/tree/main/packages/vgplot) API.

package/dist/src/ast/aggregate.d.ts

@@ -0,0 +1,82 @@
+import type { ExprVarArgs, OrderByExpr } from '../types.js';
+import type { WindowFrameNode } from './window-frame.js';
+import { ExprNode } from './node.js';
+import { WindowNode } from './window.js';
+export declare class AggregateNode extends ExprNode {
+    /** The aggregate function name. */
+    readonly name: string;
+    /** The aggregate function arguments. */
+    readonly args: ExprNode[];
+    /** The distinct flag. */
+    readonly isDistinct: boolean;
+    /** Filter criteria. */
+    readonly filter: ExprNode | null;
+    /** Order by expression for order-sensitive aggregates. */
+    readonly order: ExprNode[];
+    /**
+     * Instantiate an aggregate function node.
+     * @param name The aggregate function name.
+     * @param args The aggregate function arguments.
+     * @param distinct The distinct flag.
+     * @param filter Filter expression.
+     * @param argOrder Order by expression.
+     */
+    constructor(name: string, args: ExprNode[], distinct?: boolean, filter?: ExprNode | null, argOrder?: OrderByExpr);
+    /**
+     * Return a new derived aggregate over distinct values.
+     * @param isDistinct The distinct flag.
+     * @returns A new aggregate node.
+     */
+    distinct(isDistinct?: boolean): AggregateNode;
+    /**
+     * Return a new derived aggregate function that filters values.
+     * @param The filter expression.
+     * @returns A new aggregate node.
+     */
+    where(filter: ExprNode | string): AggregateNode;
+    /**
+     * Return a new derived aggregate function that sorts values prior to aggregation.
+     * @param order The order by expression.
+     * @returns A new aggregate node.
+     */
+    argOrder(order: OrderByExpr): AggregateNode;
+    /**
+     * Return a new window function over this aggregate.
+     * @returns A new window node.
+     */
+    window(): WindowNode;
+    /**
+     * Return a new window function over this aggregate with the given partitions.
+     * @param expr The partition by criteria.
+     * @returns A new window node.
+     */
+    partitionby(...expr: ExprVarArgs[]): WindowNode;
+    /**
+     * Return a new window function over this aggregate with the given ordering.
+     * @param expr The order by criteria.
+     * @returns A new window node.
+     */
+    orderby(...expr: ExprVarArgs[]): WindowNode;
+    /**
+     * Return a new window function over this aggregate with the given frame.
+     * @param framedef The window frame definition.
+     * @returns A new window node.
+     */
+    frame(framedef: WindowFrameNode): WindowNode;
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString(): string;
+}
+/**
+ * Check if a function name corresponds to an aggregate function.
+ * @param name The function name to check
+ * @returns True if a known aggregate function, false otherwise.
+ */
+export declare function isAggregateFunction(name: string): boolean;
+/**
+ * An array of known aggregate function names.
+ * From https://duckdb.org/docs/sql/functions/aggregates.html.
+ */
+export declare const aggregateNames: string[];
+//# sourceMappingURL=aggregate.d.ts.map

package/dist/src/ast/aggregate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../../src/ast/aggregate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKzD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,qBAAa,aAAc,SAAQ,QAAQ;IACzC,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC1B,yBAAyB;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,uBAAuB;IACvB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjC,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAE3B;;;;;;;OAOG;gBAED,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,EAAE,EAChB,QAAQ,GAAE,OAAe,EACzB,MAAM,GAAE,QAAQ,GAAG,IAAW,EAC9B,QAAQ,GAAE,WAAgB;IAU5B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,GAAE,OAAc;IAInC;;;;OAIG;IACH,KAAK,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM;IAK/B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW;IAI3B;;;OAGG;IACH,MAAM;IAIN;;;;OAIG;IACH,WAAW,CAAC,GAAG,IAAI,EAAE,WAAW,EAAE;IAIlC;;;;OAIG;IACH,OAAO,CAAC,GAAG,IAAI,EAAE,WAAW,EAAE;IAI9B;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,eAAe;IAI/B;;OAEG;IACH,QAAQ;CAYT;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,WAE/C;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,UA4D1B,CAAC"}

package/dist/src/ast/aggregate.js

@@ -0,0 +1,180 @@
+import { AGGREGATE } from '../constants.js';
+import { asVerbatim } from '../util/ast.js';
+import { nodeList } from '../util/function.js';
+import { isString } from '../util/type-check.js';
+import { ExprNode } from './node.js';
+import { WindowNode } from './window.js';
+export class AggregateNode extends ExprNode {
+    /** The aggregate function name. */
+    name;
+    /** The aggregate function arguments. */
+    args;
+    /** The distinct flag. */
+    isDistinct;
+    /** Filter criteria. */
+    filter;
+    /** Order by expression for order-sensitive aggregates. */
+    order;
+    /**
+     * Instantiate an aggregate function node.
+     * @param name The aggregate function name.
+     * @param args The aggregate function arguments.
+     * @param distinct The distinct flag.
+     * @param filter Filter expression.
+     * @param argOrder Order by expression.
+     */
+    constructor(name, args, distinct = false, filter = null, argOrder = []) {
+        super(AGGREGATE);
+        this.name = name;
+        this.args = args;
+        this.isDistinct = distinct;
+        this.filter = filter;
+        this.order = nodeList([argOrder]);
+    }
+    /**
+     * Return a new derived aggregate over distinct values.
+     * @param isDistinct The distinct flag.
+     * @returns A new aggregate node.
+     */
+    distinct(isDistinct = true) {
+        return new AggregateNode(this.name, this.args, isDistinct, this.filter, this.order);
+    }
+    /**
+     * Return a new derived aggregate function that filters values.
+     * @param The filter expression.
+     * @returns A new aggregate node.
+     */
+    where(filter) {
+        if (isString(filter))
+            filter = asVerbatim(filter);
+        return new AggregateNode(this.name, this.args, this.isDistinct, filter, this.order);
+    }
+    /**
+     * Return a new derived aggregate function that sorts values prior to aggregation.
+     * @param order The order by expression.
+     * @returns A new aggregate node.
+     */
+    argOrder(order) {
+        return new AggregateNode(this.name, this.args, this.isDistinct, this.filter, order);
+    }
+    /**
+     * Return a new window function over this aggregate.
+     * @returns A new window node.
+     */
+    window() {
+        return new WindowNode(this);
+    }
+    /**
+     * Return a new window function over this aggregate with the given partitions.
+     * @param expr The partition by criteria.
+     * @returns A new window node.
+     */
+    partitionby(...expr) {
+        return this.window().partitionby(...expr);
+    }
+    /**
+     * Return a new window function over this aggregate with the given ordering.
+     * @param expr The order by criteria.
+     * @returns A new window node.
+     */
+    orderby(...expr) {
+        return this.window().orderby(...expr);
+    }
+    /**
+     * Return a new window function over this aggregate with the given frame.
+     * @param framedef The window frame definition.
+     * @returns A new window node.
+     */
+    frame(framedef) {
+        return this.window().frame(framedef);
+    }
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString() {
+        const { name, args, isDistinct, filter, order } = this;
+        const arg = [
+            isDistinct ? 'DISTINCT' : '',
+            args?.length ? args.join(', ')
+                : name.toLowerCase() === 'count' ? '*'
+                    : '',
+            order.length ? `ORDER BY ${order.join(', ')}` : ''
+        ].filter(x => x).join(' ');
+        const filt = filter ? ` FILTER (WHERE ${filter})` : '';
+        return `${name}(${arg})${filt}`;
+    }
+}
+/**
+ * Check if a function name corresponds to an aggregate function.
+ * @param name The function name to check
+ * @returns True if a known aggregate function, false otherwise.
+ */
+export function isAggregateFunction(name) {
+    return aggregateNames.includes(name.toLowerCase());
+}
+/**
+ * An array of known aggregate function names.
+ * From https://duckdb.org/docs/sql/functions/aggregates.html.
+ */
+export const aggregateNames = [
+    'any_value',
+    'approx_count_distinct',
+    'approx_quantile',
+    'arbitrary',
+    'arg_max',
+    'arg_max_null',
+    'arg_min',
+    'arg_min_null',
+    'array_agg',
+    'avg',
+    'bit_and',
+    'bit_or',
+    'bit_xor',
+    'bitstring_agg',
+    'bool_and',
+    'bool_or',
+    'corr',
+    'count',
+    'count_star',
+    'covar_pop',
+    'covar_samp',
+    'entropy',
+    'favg',
+    'first',
+    'fsum',
+    'geomean',
+    'kurtosis_pop',
+    'kurtosis',
+    'last',
+    'mad',
+    'max',
+    'max_by',
+    'median',
+    'min',
+    'min_by',
+    'mode',
+    'product',
+    'quantile',
+    'quantile_cont',
+    'quantile_disc',
+    'regr_avgx',
+    'regr_avgy',
+    'regr_count',
+    'regr_intercept',
+    'regr_r2',
+    'regr_sxx',
+    'regr_sxy',
+    'regr_syy',
+    'regr_slope',
+    'reservoir_quantile',
+    'skewness',
+    'stddev',
+    'stddev_pop',
+    'stddev_samp',
+    'string_agg',
+    'sum',
+    'variance',
+    'var_pop',
+    'var_samp'
+];
+//# sourceMappingURL=aggregate.js.map

package/dist/src/ast/aggregate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.js","sourceRoot":"","sources":["../../../src/ast/aggregate.ts"],"names":[],"mappings":"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"}

package/dist/src/ast/between-op.d.ts

@@ -0,0 +1,46 @@
+import { ExprNode } from './node.js';
+export type Extent = [ExprNode, ExprNode] | null;
+declare class AbstractBetweenOpNode extends ExprNode {
+    /** The input expression. */
+    readonly expr: ExprNode;
+    /** The range extent. */
+    readonly extent?: Extent;
+    /**
+     * Instantiate an abstract between operator node.
+     * @param type The node type.
+     * @param expr The input expression.
+     * @param extent The range extent.
+     */
+    constructor(type: string, expr: ExprNode, extent?: Extent);
+    /**
+     * Generate a SQL query string for this node.
+     * @param op The operator to apply.
+     */
+    toSQL(op: string): string;
+}
+export declare class BetweenOpNode extends AbstractBetweenOpNode {
+    /**
+     * Instantiate a between operator node.
+     * @param expr The input expression.
+     * @param extent The range extent.
+     */
+    constructor(expr: ExprNode, extent?: Extent);
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString(): string;
+}
+export declare class NotBetweenOpNode extends AbstractBetweenOpNode {
+    /**
+     * Instantiate a not between operator node.
+     * @param expr The input expression.
+     * @param extent The range extent.
+     */
+    constructor(expr: ExprNode, extent?: Extent);
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString(): string;
+}
+export {};
+//# sourceMappingURL=between-op.d.ts.map

package/dist/src/ast/between-op.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"between-op.d.ts","sourceRoot":"","sources":["../../../src/ast/between-op.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,MAAM,MAAM,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,IAAI,CAAC;AAEjD,cAAM,qBAAsB,SAAQ,QAAQ;IAC1C,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,wBAAwB;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;gBACS,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM;IAMzD;;;OAGG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM;CAIjB;AAED,qBAAa,aAAc,SAAQ,qBAAqB;IACtD;;;;OAIG;gBACS,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM;IAI3C;;OAEG;IACH,QAAQ;CAGT;AAED,qBAAa,gBAAiB,SAAQ,qBAAqB;IACzD;;;;OAIG;gBACS,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM;IAI3C;;OAEG;IACH,QAAQ;CAGT"}

package/dist/src/ast/between-op.js

@@ -0,0 +1,60 @@
+import { BETWEEN_OPERATOR, NOT_BETWEEN_OPERATOR } from '../constants.js';
+import { ExprNode } from './node.js';
+class AbstractBetweenOpNode extends ExprNode {
+    /** The input expression. */
+    expr;
+    /** The range extent. */
+    extent;
+    /**
+     * Instantiate an abstract between operator node.
+     * @param type The node type.
+     * @param expr The input expression.
+     * @param extent The range extent.
+     */
+    constructor(type, expr, extent) {
+        super(type);
+        this.expr = expr;
+        this.extent = extent;
+    }
+    /**
+     * Generate a SQL query string for this node.
+     * @param op The operator to apply.
+     */
+    toSQL(op) {
+        const { extent: r, expr } = this;
+        return r ? `(${expr} ${op} ${r[0]} AND ${r[1]})` : '';
+    }
+}
+export class BetweenOpNode extends AbstractBetweenOpNode {
+    /**
+     * Instantiate a between operator node.
+     * @param expr The input expression.
+     * @param extent The range extent.
+     */
+    constructor(expr, extent) {
+        super(BETWEEN_OPERATOR, expr, extent);
+    }
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString() {
+        return super.toSQL('BETWEEN');
+    }
+}
+export class NotBetweenOpNode extends AbstractBetweenOpNode {
+    /**
+     * Instantiate a not between operator node.
+     * @param expr The input expression.
+     * @param extent The range extent.
+     */
+    constructor(expr, extent) {
+        super(NOT_BETWEEN_OPERATOR, expr, extent);
+    }
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString() {
+        return super.toSQL('NOT BETWEEN');
+    }
+}
+//# sourceMappingURL=between-op.js.map

package/dist/src/ast/between-op.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"between-op.js","sourceRoot":"","sources":["../../../src/ast/between-op.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAIrC,MAAM,qBAAsB,SAAQ,QAAQ;IAC1C,4BAA4B;IACnB,IAAI,CAAW;IACxB,wBAAwB;IACf,MAAM,CAAU;IAEzB;;;;;OAKG;IACH,YAAY,IAAY,EAAE,IAAc,EAAE,MAAe;QACvD,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,EAAU;QACd,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACjC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,qBAAqB;IACtD;;;;OAIG;IACH,YAAY,IAAc,EAAE,MAAe;QACzC,KAAK,CAAC,gBAAgB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,qBAAqB;IACzD;;;;OAIG;IACH,YAAY,IAAc,EAAE,MAAe;QACzC,KAAK,CAAC,oBAAoB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/src/ast/binary-op.d.ts

@@ -0,0 +1,21 @@
+import { ExprNode } from './node.js';
+export declare class BinaryOpNode extends ExprNode {
+    /** The operator type. */
+    readonly op: string;
+    /** The left input expression. */
+    readonly left: ExprNode;
+    /** The right input expression. */
+    readonly right: ExprNode;
+    /**
+     * Instantiate a binary operator node.
+     * @param op The operator type.
+     * @param left The left input expression.
+     * @param right The right input expression.
+     */
+    constructor(op: string, left: ExprNode, right: ExprNode);
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=binary-op.d.ts.map

package/dist/src/ast/binary-op.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-op.d.ts","sourceRoot":"","sources":["../../../src/ast/binary-op.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,qBAAa,YAAa,SAAQ,QAAQ;IACxC,yBAAyB;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAEzB;;;;;OAKG;gBACS,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ;IAOvD;;OAEG;IACH,QAAQ;CAGT"}

package/dist/src/ast/binary-op.js

@@ -0,0 +1,29 @@
+import { BINARY_OPERATOR } from '../constants.js';
+import { ExprNode } from './node.js';
+export class BinaryOpNode extends ExprNode {
+    /** The operator type. */
+    op;
+    /** The left input expression. */
+    left;
+    /** The right input expression. */
+    right;
+    /**
+     * Instantiate a binary operator node.
+     * @param op The operator type.
+     * @param left The left input expression.
+     * @param right The right input expression.
+     */
+    constructor(op, left, right) {
+        super(BINARY_OPERATOR);
+        this.op = op;
+        this.left = left;
+        this.right = right;
+    }
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString() {
+        return `(${this.left} ${this.op} ${this.right})`;
+    }
+}
+//# sourceMappingURL=binary-op.js.map

package/dist/src/ast/binary-op.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-op.js","sourceRoot":"","sources":["../../../src/ast/binary-op.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxC,yBAAyB;IAChB,EAAE,CAAS;IACpB,iCAAiC;IACxB,IAAI,CAAW;IACxB,kCAAkC;IACzB,KAAK,CAAW;IAEzB;;;;;OAKG;IACH,YAAY,EAAU,EAAE,IAAc,EAAE,KAAe;QACrD,KAAK,CAAC,eAAe,CAAC,CAAC;QACvB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC;IACnD,CAAC;CACF"}

package/dist/src/ast/case.d.ts

@@ -0,0 +1,53 @@
+import { ExprValue } from '../types.js';
+import { ExprNode, SQLNode } from './node.js';
+export declare class CaseNode extends ExprNode {
+    /** The optional base expression. */
+    readonly expr?: ExprNode;
+    /** An array of WHEN/THEN expression nodes. */
+    readonly _when: WhenNode[];
+    /** An ELSE expression. */
+    readonly _else?: ExprNode;
+    /**
+     * Instantiate a case node.
+     * @param expr An optional base expression, that comes
+     *  immediately after the CASE keyword. If specified, this case statement
+     *  acts like a switch statement, with WHEN expressions as values to
+     *  match against the switch value rather than boolean conditions.
+     * @param when An array of WHEN/THEN expression nodes.
+     * @param elseExpr An ELSE expression.
+     */
+    constructor(expr?: ExprNode | undefined, when?: WhenNode[], elseExpr?: ExprNode | undefined);
+    /**
+     * Return a new case node with the given conditional added as
+     * the last WHEN / THEN pair.
+     * @param cond The WHEN condition expression.
+     * @param value The THEN value expression.
+     */
+    when(cond: ExprValue, value: ExprValue): CaseNode;
+    /**
+     * Return a new case node with the given ELSE expression.
+     * @param expr The ELSE expression.
+     */
+    else(expr: ExprValue): CaseNode;
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString(): string;
+}
+export declare class WhenNode extends SQLNode {
+    /** The condition expression. */
+    readonly when: ExprNode;
+    /** The value expression. */
+    readonly then: ExprNode;
+    /**
+     * Instantiate a case node.
+     * @param when The WHEN condition expression.
+     * @param then The THEN value expression.
+     */
+    constructor(when: ExprNode, then: ExprNode);
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=case.d.ts.map

package/dist/src/ast/case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"case.d.ts","sourceRoot":"","sources":["../../../src/ast/case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE9C,qBAAa,QAAS,SAAQ,QAAQ;IACpC,oCAAoC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACzB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC3B,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAE1B;;;;;;;;OAQG;gBAED,IAAI,GAAE,QAAQ,GAAG,SAAqB,EACtC,IAAI,GAAE,QAAQ,EAAO,EACrB,QAAQ,GAAE,QAAQ,GAAG,SAAqB;IAQ5C;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS;IAQtC;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,SAAS;IAIpB;;OAEG;IACH,QAAQ;CAOT;AAED,qBAAa,QAAS,SAAQ,OAAO;IACnC,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAExB;;;;OAIG;gBACS,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ;IAM1C;;OAEG;IACH,QAAQ;CAGT"}

package/dist/src/ast/case.js

@@ -0,0 +1,75 @@
+import { CASE, WHEN } from '../constants.js';
+import { asNode } from '../util/ast.js';
+import { ExprNode, SQLNode } from './node.js';
+export class CaseNode extends ExprNode {
+    /** The optional base expression. */
+    expr;
+    /** An array of WHEN/THEN expression nodes. */
+    _when;
+    /** An ELSE expression. */
+    _else;
+    /**
+     * Instantiate a case node.
+     * @param expr An optional base expression, that comes
+     *  immediately after the CASE keyword. If specified, this case statement
+     *  acts like a switch statement, with WHEN expressions as values to
+     *  match against the switch value rather than boolean conditions.
+     * @param when An array of WHEN/THEN expression nodes.
+     * @param elseExpr An ELSE expression.
+     */
+    constructor(expr = undefined, when = [], elseExpr = undefined) {
+        super(CASE);
+        this.expr = expr;
+        this._when = when;
+        this._else = elseExpr;
+    }
+    /**
+     * Return a new case node with the given conditional added as
+     * the last WHEN / THEN pair.
+     * @param cond The WHEN condition expression.
+     * @param value The THEN value expression.
+     */
+    when(cond, value) {
+        return new CaseNode(this.expr, this._when.concat(new WhenNode(asNode(cond), asNode(value))), this._else);
+    }
+    /**
+     * Return a new case node with the given ELSE expression.
+     * @param expr The ELSE expression.
+     */
+    else(expr) {
+        return new CaseNode(this.expr, this._when, asNode(expr));
+    }
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString() {
+        return 'CASE '
+            + (this.expr ? `${this.expr} ` : '')
+            + this._when.join(' ')
+            + (this._else ? ` ELSE ${this._else}` : '')
+            + ' END';
+    }
+}
+export class WhenNode extends SQLNode {
+    /** The condition expression. */
+    when;
+    /** The value expression. */
+    then;
+    /**
+     * Instantiate a case node.
+     * @param when The WHEN condition expression.
+     * @param then The THEN value expression.
+     */
+    constructor(when, then) {
+        super(WHEN);
+        this.when = when;
+        this.then = then;
+    }
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString() {
+        return `WHEN ${this.when} THEN ${this.then}`;
+    }
+}
+//# sourceMappingURL=case.js.map

package/dist/src/ast/case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"case.js","sourceRoot":"","sources":["../../../src/ast/case.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,OAAO,QAAS,SAAQ,QAAQ;IACpC,oCAAoC;IAC3B,IAAI,CAAY;IACzB,8CAA8C;IACrC,KAAK,CAAa;IAC3B,0BAA0B;IACjB,KAAK,CAAY;IAE1B;;;;;;;;OAQG;IACH,YACE,OAA6B,SAAS,EACtC,OAAmB,EAAE,EACrB,WAAiC,SAAS;QAE1C,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,IAAe,EAAE,KAAgB;QACpC,OAAO,IAAI,QAAQ,CACjB,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAC5D,IAAI,CAAC,KAAK,CACX,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,IAAe;QAClB,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,OAAO;cACV,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;cAClC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;cACpB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;cACzC,MAAM,CAAC;IACb,CAAC;CACF;AAED,MAAM,OAAO,QAAS,SAAQ,OAAO;IACnC,gCAAgC;IACvB,IAAI,CAAW;IACxB,4BAA4B;IACnB,IAAI,CAAW;IAExB;;;;OAIG;IACH,YAAY,IAAc,EAAE,IAAc;QACxC,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,QAAQ,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/C,CAAC;CACF"}

package/dist/src/ast/cast.d.ts

@@ -0,0 +1,18 @@
+import { ExprNode } from './node.js';
+export declare class CastNode extends ExprNode {
+    /** The expression to type cast. */
+    readonly expr: ExprNode;
+    /** The type to cast to. */
+    readonly cast: string;
+    /**
+     * Instantiate a cast node.
+     * @param expr The expression to type cast.
+     * @param type The type to cast to.
+     */
+    constructor(expr: ExprNode, type: string);
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=cast.d.ts.map

package/dist/src/ast/cast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cast.d.ts","sourceRoot":"","sources":["../../../src/ast/cast.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,qBAAa,QAAS,SAAQ,QAAQ;IACpC,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;gBACS,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM;IAMxC;;OAEG;IACH,QAAQ;CAIT"}