@uwdata/mosaic-sql 0.17.0 → 0.19.0

package/dist/src/ast/literal.js

@@ -0,0 +1,53 @@
+import { LITERAL } from '../constants.js';
+import { ExprNode } from './node.js';
+export class LiteralNode extends ExprNode {
+    /** The literal value. */
+    value;
+    /**
+     * Instantiate an literal node.
+     * @param value The literal value.
+     */
+    constructor(value) {
+        super(LITERAL);
+        this.value = value;
+    }
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString() {
+        return literalToSQL(this.value);
+    }
+}
+export function literalToSQL(value) {
+    switch (typeof value) {
+        case 'number':
+            return Number.isFinite(value) ? `${value}` : 'NULL';
+        case 'string':
+            return `'${value.replaceAll(`'`, `''`)}'`;
+        case 'boolean':
+            return value ? 'TRUE' : 'FALSE';
+        default:
+            if (value == null) {
+                return 'NULL';
+            }
+            else if (value instanceof Date) {
+                const ts = +value;
+                if (Number.isNaN(ts))
+                    return 'NULL';
+                const y = value.getUTCFullYear();
+                const m = value.getUTCMonth();
+                const d = value.getUTCDate();
+                return ts === Date.UTC(y, m, d)
+                    ? `DATE '${y}-${m + 1}-${d}'` // utc date
+                    : `epoch_ms(${ts})`; // timestamp
+            }
+            else if (value instanceof RegExp) {
+                return `'${value.source}'`;
+            }
+            else {
+                // otherwise rely on string coercion
+                return `${value}`;
+            }
+    }
+}
+//# sourceMappingURL=literal.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"literal.js","sourceRoot":"","sources":["../../../src/ast/literal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,OAAO,WAAY,SAAQ,QAAQ;IACvC,yBAAyB;IAChB,KAAK,CAAU;IAExB;;;OAGG;IACH,YAAY,KAAc;QACxB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,QAAQ,OAAO,KAAK,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QACtD,KAAK,QAAQ;YACX,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC;QAC5C,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QAClC;YACE,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;gBAClB,OAAO,MAAM,CAAC;YAChB,CAAC;iBAAM,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;gBACjC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC;gBAClB,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;oBAAE,OAAO,MAAM,CAAC;gBACpC,MAAM,CAAC,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC;gBACjC,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;gBAC9B,MAAM,CAAC,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;gBAC7B,OAAO,EAAE,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;oBAC7B,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAAC,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW;oBACvC,CAAC,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,YAAY;YACrC,CAAC;iBAAM,IAAI,KAAK,YAAY,MAAM,EAAE,CAAC;gBACnC,OAAO,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,oCAAoC;gBACpC,OAAO,GAAG,KAAK,EAAE,CAAC;YACpB,CAAC;IACL,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,32 @@
+import { ExprNode } from './node.js';
+export declare class LogicalOpNode<T extends ExprNode> extends ExprNode {
+    /** The logical operator */
+    readonly op: string;
+    /** The clause expressions. */
+    readonly clauses: T[];
+    /**
+     * Instantiate a logical operator node.
+     * @param op The logical operation.
+     * @param clauses The input clause expressions.
+     */
+    constructor(op: string, clauses: T[]);
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString(): string;
+}
+export declare class AndNode<T extends ExprNode> extends LogicalOpNode<T> {
+    /**
+     * Instantiate a logical AND operator node.
+     * @param clauses The input clause expressions.
+     */
+    constructor(clauses: T[]);
+}
+export declare class OrNode<T extends ExprNode> extends LogicalOpNode<T> {
+    /**
+     * Instantiate a logical OR operator node.
+     * @param clauses The input clause expressions.
+     */
+    constructor(clauses: T[]);
+}
+//# sourceMappingURL=logical-op.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logical-op.d.ts","sourceRoot":"","sources":["../../../src/ast/logical-op.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,qBAAa,aAAa,CAAC,CAAC,SAAS,QAAQ,CAAE,SAAQ,QAAQ;IAC7D,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;IAEtB;;;;OAIG;gBACS,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE;IAMpC;;OAEG;IACH,QAAQ;CAMT;AAED,qBAAa,OAAO,CAAC,CAAC,SAAS,QAAQ,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;IAC/D;;;OAGG;gBACS,OAAO,EAAE,CAAC,EAAE;CAGzB;AAED,qBAAa,MAAM,CAAC,CAAC,SAAS,QAAQ,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;IAC9D;;;OAGG;gBACS,OAAO,EAAE,CAAC,EAAE;CAGzB"}

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

@@ -0,0 +1,46 @@
+import { LOGICAL_OPERATOR } from '../constants.js';
+import { ExprNode } from './node.js';
+export class LogicalOpNode extends ExprNode {
+    /** The logical operator */
+    op;
+    /** The clause expressions. */
+    clauses;
+    /**
+     * Instantiate a logical operator node.
+     * @param op The logical operation.
+     * @param clauses The input clause expressions.
+     */
+    constructor(op, clauses) {
+        super(LOGICAL_OPERATOR);
+        this.op = op;
+        this.clauses = clauses;
+    }
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString() {
+        const c = this.clauses;
+        return c.length === 0 ? ''
+            : c.length === 1 ? `${c[0]}`
+                : `(${c.join(` ${this.op} `)})`;
+    }
+}
+export class AndNode extends LogicalOpNode {
+    /**
+     * Instantiate a logical AND operator node.
+     * @param clauses The input clause expressions.
+     */
+    constructor(clauses) {
+        super('AND', clauses);
+    }
+}
+export class OrNode extends LogicalOpNode {
+    /**
+     * Instantiate a logical OR operator node.
+     * @param clauses The input clause expressions.
+     */
+    constructor(clauses) {
+        super('OR', clauses);
+    }
+}
+//# sourceMappingURL=logical-op.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logical-op.js","sourceRoot":"","sources":["../../../src/ast/logical-op.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,OAAO,aAAkC,SAAQ,QAAQ;IAC7D,2BAA2B;IAClB,EAAE,CAAS;IACpB,8BAA8B;IACrB,OAAO,CAAM;IAEtB;;;;OAIG;IACH,YAAY,EAAU,EAAE,OAAY;QAClC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACxB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACvB,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;YACxB,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;gBAC5B,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,OAA4B,SAAQ,aAAgB;IAC/D;;;OAGG;IACH,YAAY,OAAY;QACtB,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACxB,CAAC;CACF;AAED,MAAM,OAAO,MAA2B,SAAQ,aAAgB;IAC9D;;;OAGG;IACH,YAAY,OAAY;QACtB,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvB,CAAC;CACF"}

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

@@ -0,0 +1,25 @@
+/**
+ * Check if a value is a SQL AST node.
+ * @param value The value to check.
+ */
+export declare function isNode(value: unknown): value is SQLNode;
+export declare class SQLNode {
+    /** The SQL AST node type. */
+    readonly type: string;
+    /**
+     * Instantiate a SQL AST node.
+     * @param type The SQL AST node type.
+     */
+    constructor(type: string);
+    /**
+     * Create a shallow clone of this SQL AST node.
+     * @returns The shallow clone node.
+     */
+    clone(): this;
+}
+/**
+ * AST node corresponding to an individual expression.
+ */
+export declare class ExprNode extends SQLNode {
+}
+//# sourceMappingURL=node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/ast/node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAEvD;AAED,qBAAa,OAAO;IAClB,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;gBACS,IAAI,EAAE,MAAM;IAIxB;;;OAGG;IACH,KAAK,IAAI,IAAI;CAQd;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,OAAO;CACpC"}

package/dist/src/ast/node.js

@@ -0,0 +1,36 @@
+/**
+ * Check if a value is a SQL AST node.
+ * @param value The value to check.
+ */
+export function isNode(value) {
+    return value instanceof SQLNode;
+}
+export class SQLNode {
+    /** The SQL AST node type. */
+    type;
+    /**
+     * Instantiate a SQL AST node.
+     * @param type The SQL AST node type.
+     */
+    constructor(type) {
+        this.type = type;
+    }
+    /**
+     * Create a shallow clone of this SQL AST node.
+     * @returns The shallow clone node.
+     */
+    clone() {
+        // @ts-expect-error use constructor
+        const clone = new this.constructor();
+        for (const key in this) {
+            clone[key] = this[key];
+        }
+        return clone;
+    }
+}
+/**
+ * AST node corresponding to an individual expression.
+ */
+export class ExprNode extends SQLNode {
+}
+//# sourceMappingURL=node.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../src/ast/node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,KAAK,YAAY,OAAO,CAAC;AAClC,CAAC;AAED,MAAM,OAAO,OAAO;IAClB,6BAA6B;IACpB,IAAI,CAAS;IAEtB;;;OAGG;IACH,YAAY,IAAY;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,mCAAmC;QACnC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,OAAO;CACpC"}

package/dist/src/ast/order-by.d.ts

@@ -0,0 +1,21 @@
+import { ExprNode } from './node.js';
+export declare class OrderByNode extends ExprNode {
+    /** The expression to order by. */
+    readonly expr: ExprNode;
+    /** Flag indicating descending order. */
+    readonly desc?: boolean;
+    /** Flag indicating if null values should be sorted first. */
+    readonly nullsFirst?: boolean;
+    /**
+     * Instantiate an order by entry node.
+     * @param expr The expression to order by.
+     * @param desc Flag indicating descending order.
+     * @param nullsFirst Flag indicating if null values should be sorted first.
+     */
+    constructor(expr: ExprNode, desc?: boolean, nullsFirst?: boolean);
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=order-by.d.ts.map

package/dist/src/ast/order-by.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-by.d.ts","sourceRoot":"","sources":["../../../src/ast/order-by.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,qBAAa,WAAY,SAAQ,QAAQ;IACvC,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;;OAKG;gBACS,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO;IAOhE;;OAEG;IACH,QAAQ;CAUT"}

package/dist/src/ast/order-by.js

@@ -0,0 +1,36 @@
+import { ORDER_BY } from '../constants.js';
+import { ExprNode } from './node.js';
+export class OrderByNode extends ExprNode {
+    /** The expression to order by. */
+    expr;
+    /** Flag indicating descending order. */
+    desc;
+    /** Flag indicating if null values should be sorted first. */
+    nullsFirst;
+    /**
+     * Instantiate an order by entry node.
+     * @param expr The expression to order by.
+     * @param desc Flag indicating descending order.
+     * @param nullsFirst Flag indicating if null values should be sorted first.
+     */
+    constructor(expr, desc, nullsFirst) {
+        super(ORDER_BY);
+        this.expr = expr;
+        this.desc = desc;
+        this.nullsFirst = nullsFirst;
+    }
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString() {
+        const { expr, desc, nullsFirst } = this;
+        const dir = desc ? ' DESC'
+            : desc === false ? ' ASC'
+                : '';
+        const nf = nullsFirst ? ' NULLS FIRST'
+            : nullsFirst === false ? ' NULLS LAST'
+                : '';
+        return `${expr}${dir}${nf}`;
+    }
+}
+//# sourceMappingURL=order-by.js.map

package/dist/src/ast/order-by.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-by.js","sourceRoot":"","sources":["../../../src/ast/order-by.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,OAAO,WAAY,SAAQ,QAAQ;IACvC,kCAAkC;IACzB,IAAI,CAAW;IACxB,wCAAwC;IAC/B,IAAI,CAAW;IACxB,6DAA6D;IACpD,UAAU,CAAW;IAE9B;;;;;OAKG;IACH,YAAY,IAAc,EAAE,IAAc,EAAE,UAAoB;QAC9D,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO;YACxB,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM;gBACzB,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,cAAc;YACpC,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,aAAa;gBACtC,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,GAAG,IAAI,GAAG,GAAG,GAAG,EAAE,EAAE,CAAC;IAC9B,CAAC;CACF"}

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

@@ -0,0 +1,20 @@
+import type { ParamLike } from '../types.js';
+import { ExprNode } from './node.js';
+export declare class ParamNode extends ExprNode {
+    /** The dynamic parameter. */
+    readonly param: ParamLike;
+    /**
+     * Instantiate a param node with a dynamic parameter.
+     * @param param The dynamic parameter.
+     */
+    constructor(param: ParamLike);
+    /**
+     * Returns the current parameter value.
+     */
+    get value(): unknown;
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=param.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"param.d.ts","sourceRoot":"","sources":["../../../src/ast/param.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,qBAAa,SAAU,SAAQ,QAAQ;IACrC,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAE1B;;;OAGG;gBACS,KAAK,EAAE,SAAS;IAK5B;;OAEG;IACH,IAAI,KAAK,YAER;IAED;;OAEG;IACH,QAAQ;CAGT"}

package/dist/src/ast/param.js

@@ -0,0 +1,28 @@
+import { PARAM } from '../constants.js';
+import { literalToSQL } from './literal.js';
+import { ExprNode } from './node.js';
+export class ParamNode extends ExprNode {
+    /** The dynamic parameter. */
+    param;
+    /**
+     * Instantiate a param node with a dynamic parameter.
+     * @param param The dynamic parameter.
+     */
+    constructor(param) {
+        super(PARAM);
+        this.param = param;
+    }
+    /**
+     * Returns the current parameter value.
+     */
+    get value() {
+        return this.param.value;
+    }
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString() {
+        return literalToSQL(this.value);
+    }
+}
+//# sourceMappingURL=param.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"param.js","sourceRoot":"","sources":["../../../src/ast/param.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,OAAO,SAAU,SAAQ,QAAQ;IACrC,6BAA6B;IACpB,KAAK,CAAY;IAE1B;;;OAGG;IACH,YAAY,KAAgB;QAC1B,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;CACF"}

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

@@ -0,0 +1,334 @@
+import type { FilterExpr, FromExpr, GroupByExpr, MaybeArray, OrderByExpr, SelectExpr, WithExpr } from '../types.js';
+import type { SampleMethod } from './sample.js';
+import { FromClauseNode } from './from.js';
+import { ExprNode, SQLNode } from './node.js';
+import { SampleClauseNode } from './sample.js';
+import { SelectClauseNode } from './select.js';
+import { WindowClauseNode, type WindowDefNode } from './window.js';
+import { WithClauseNode } from './with.js';
+/**
+ * Check if a value is a selection query or set operation.
+ * @param value The value to check.
+ */
+export declare function isQuery(value: unknown): value is Query;
+/**
+ * Check if a value is a selection query.
+ * @param value The value to check.
+ */
+export declare function isSelectQuery(value: unknown): value is SelectQuery;
+/**
+ * Check if a value is a describe query.
+ * @param value The value to check.
+ */
+export declare function isDescribeQuery(value: unknown): value is DescribeQuery;
+export declare class Query extends ExprNode {
+    /**
+     * Create a new WITH clause with the given CTE queries.
+     * @param expr The WITH CTE queries.
+     */
+    static with(...expr: WithExpr[]): WithClause;
+    /**
+     * Create a new select query with the given SELECT expressions.
+     * @param expr The SELECT expressions.
+     */
+    static select(...expr: SelectExpr[]): SelectQuery;
+    /**
+     * Create a new select query with the given FROM expressions.
+     * @param expr The FROM expressions.
+     */
+    static from(...expr: FromExpr[]): SelectQuery;
+    /**
+     * Create a new UNION set operation over the given queries.
+     * @param queries The queries.
+     */
+    static union(...queries: MaybeArray<Query>[]): SetOperation;
+    /**
+     * Create a new UNION BY NAME set operation over the given queries.
+     * @param queries The queries.
+     */
+    static unionByName(...queries: MaybeArray<Query>[]): SetOperation;
+    /**
+     * Create a new UNION ALL set operation over the given queries.
+     * @param queries The queries.
+     */
+    static unionAll(...queries: MaybeArray<Query>[]): SetOperation;
+    /**
+     * Create a new UNION ALL BY NAME set operation over the given queries.
+     * @param queries The queries.
+     */
+    static unionAllByName(...queries: MaybeArray<Query>[]): SetOperation;
+    /**
+     * Create a new INTERSECT set operation over the given queries.
+     * @param queries The queries.
+     */
+    static intersect(...queries: MaybeArray<Query>[]): SetOperation;
+    /**
+     * Create a new INTERSECT ALL set operation over the given queries.
+     * @param queries The queries.
+     */
+    static intersectAll(...queries: MaybeArray<Query>[]): SetOperation;
+    /**
+     * Create a new EXCEPT set operation over the given queries.
+     * @param queries The queries.
+     */
+    static except(...queries: MaybeArray<Query>[]): SetOperation;
+    /**
+     * Create a new EXCEPT ALL set operation over the given queries.
+     * @param queries The queries.
+     */
+    static exceptAll(...queries: MaybeArray<Query>[]): SetOperation;
+    /**
+     * Create a new describe query for the given input query.
+     * @param query The query to describe.
+     */
+    static describe(query: Query): DescribeQuery;
+    _with: WithClauseNode[];
+    _orderby: ExprNode[];
+    _limitPerc: boolean;
+    _limit?: ExprNode;
+    _offset?: ExprNode;
+    cteFor?: Query | null;
+    /**
+     * Instantiate a new query.
+     */
+    constructor(type: string);
+    /**
+     * Return a list of subqueries.
+     */
+    get subqueries(): Query[];
+    /**
+     * Clone this query.
+     */
+    clone(): this;
+    /**
+     * Add a pointer to the query for which this query is a CTE.
+     * @param query The query for which this query is a CTE.
+     */
+    setCteFor(query: Query | null): void;
+    /**
+     * Add WITH common table expressions (CTEs).
+     * @param expr Expressions to add.
+     */
+    with(...expr: WithExpr[]): this;
+    /**
+     * Add ORDER BY expressions.
+     * @param expr Expressions to add.
+     */
+    orderby(...expr: OrderByExpr[]): this;
+    /**
+     * Set the query result LIMIT as a percentage value.
+     * @param value The limit percentage value.
+     */
+    limitPercent(value: number | ExprNode): this;
+    /**
+     * Set the query result LIMIT.
+     * @param value The limit value.
+     */
+    limit(value: number | ExprNode): this;
+    /**
+     * Set the query result OFFSET.
+     * @param value The offset value.
+     */
+    offset(value: number | ExprNode): this;
+}
+export declare class SelectQuery extends Query {
+    _select: SelectClauseNode[];
+    _from: FromClauseNode[];
+    _where: ExprNode[];
+    _sample?: SampleClauseNode;
+    _groupby: ExprNode[];
+    _having: ExprNode[];
+    _window: WindowClauseNode[];
+    _qualify: ExprNode[];
+    _distinct: boolean;
+    /**
+     * Instantiate a new select query.
+     */
+    constructor();
+    /**
+     * Return a list of subqueries.
+     */
+    get subqueries(): Query[];
+    /**
+     * Clone this query.
+     */
+    clone(): this;
+    /**
+     * Add SELECT expressions.
+     * @param expr Expressions to add.
+     */
+    select(...expr: SelectExpr[]): this;
+    /**
+     * Set SELECT expressions, replacing any prior expressions.
+     * @param expr Expressions to add.
+     */
+    setSelect(...expr: SelectExpr[]): this;
+    /**
+     * Indicate if this query should retrieve distinct values only.
+     * @param value The distinct flag
+     */
+    distinct(value?: boolean): this;
+    /**
+     * Add table FROM expressions.
+     * @param expr Expressions to add.
+     */
+    from(...expr: FromExpr[]): this;
+    /**
+     * Set FROM expressions, replacing any prior expressions.
+     * @param expr Expressions to add.
+     */
+    setFrom(...expr: FromExpr[]): this;
+    /**
+     * Set SAMPLE settings.
+     * @param value Either a sample clause node or the sample size as either
+     *  a row count or percentage.
+     * @param method The sampling method to use.
+     * @param seed The random seed.
+     */
+    sample(value?: number | SampleClauseNode | null, method?: SampleMethod, seed?: number): this;
+    /**
+     * Add WHERE expressions.
+     * @param expr Expressions to add.
+     */
+    where(...expr: FilterExpr[]): this;
+    /**
+     * Set WHERE expressions, replacing any prior expressions.
+     * @param expr Expressions to add.
+     */
+    setWhere(...expr: FilterExpr[]): this;
+    /**
+     * Add GROUP BY expressions.
+     * @param expr Expressions to add.
+     */
+    groupby(...expr: GroupByExpr[]): this;
+    /**
+     * Set GROUP BY expressions, replacing any prior expressions.
+     * @param expr Expressions to add.
+     */
+    setGroupby(...expr: GroupByExpr[]): this;
+    /**
+     * Add HAVING expressions.
+     * @param expr Expressions to add.
+     */
+    having(...expr: FilterExpr[]): this;
+    /**
+     * Add WINDOW definitions.
+     * @param expr Window definitions to add.
+     */
+    window(...expr: (Record<string, WindowDefNode> | null)[]): this;
+    /**
+     * Add QUALIFY expressions.
+     * @param expr Expressions to add.
+     */
+    qualify(...expr: FilterExpr[]): this;
+    /**
+     * Generate a SQL query string.
+     */
+    toString(): string;
+}
+export declare class DescribeQuery extends SQLNode {
+    readonly query: Query;
+    /**
+     * Instantiate a describe query.
+     * @param query The query to describe.
+     */
+    constructor(query: Query);
+    /**
+     * Clone this describe query.
+     */
+    clone(): this;
+    /**
+     * Generate a SQL query string.
+     */
+    toString(): string;
+}
+export declare class SetOperation extends Query {
+    /** The set operation to perform. */
+    readonly op: string;
+    /** The input queries to the set operation. */
+    readonly queries: Query[];
+    /**
+     * Instantiate a new set operation instance.
+     * @param op The set operation.
+     * @param queries The subqueries.
+     */
+    constructor(op: string, queries: Query[]);
+    /**
+     * Add a pointer to the query for which this query is a CTE.
+     * @param query The query for which this query is a CTE.
+     */
+    setCteFor(query: Query | null): void;
+    /**
+     * Return a list of subqueries.
+     */
+    get subqueries(): Query[];
+    /**
+     * Clone this set operation.
+     */
+    clone(): this;
+    /**
+     * Generate a SQL query string.
+     */
+    toString(): string;
+}
+declare class WithClause {
+    /** The common table expressions (CTE). */
+    readonly _with: WithExpr[];
+    /**
+     * Instantiate a new WITH clause instance.
+     * @param expr The WITH CTE queries.
+     */
+    constructor(...expr: WithExpr[]);
+    /**
+     * Create a new select query with the given SELECT expressions.
+     * @param expr The SELECT expressions.
+     */
+    select(...expr: SelectExpr[]): SelectQuery;
+    /**
+     * Create a new select query with the given FROM expressions.
+     * @param expr The FROM expressions.
+     */
+    from(...expr: FromExpr[]): SelectQuery;
+    /**
+     * Create a new UNION set operation over the given queries.
+     * @param queries The queries.
+     */
+    union(...queries: Query[]): SetOperation;
+    /**
+     * Create a new UNION BY NAME set operation over the given queries.
+     * @param queries The queries.
+     */
+    unionByName(...queries: Query[]): SetOperation;
+    /**
+     * Create a new UNION ALL set operation over the given queries.
+     * @param queries The queries.
+     */
+    unionAll(...queries: Query[]): SetOperation;
+    /**
+     * Create a new UNION ALL BY NAME set operation over the given queries.
+     * @param queries The queries.
+     */
+    unionAllByName(...queries: Query[]): SetOperation;
+    /**
+     * Create a new INTERSECT set operation over the given queries.
+     * @param queries The queries.
+     */
+    intersect(...queries: Query[]): SetOperation;
+    /**
+     * Create a new INTERSECT ALL set operation over the given queries.
+     * @param queries The queries.
+     */
+    intersectAll(...queries: Query[]): SetOperation;
+    /**
+     * Create a new EXCEPT set operation over the given queries.
+     * @param queries The queries.
+     */
+    except(...queries: Query[]): SetOperation;
+    /**
+     * Create a new EXCEPT ALL set operation over the given queries.
+     * @param queries The queries.
+     */
+    exceptAll(...queries: Query[]): SetOperation;
+}
+export {};
+//# sourceMappingURL=query.d.ts.map