@uwdata/mosaic-sql 0.17.0 → 0.19.0

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

@@ -0,0 +1,128 @@
+import type { ExprVarArgs, OrderByExpr, WindowFunctionName } from '../types.js';
+import type { AggregateNode } from './aggregate.js';
+import type { WindowFrameNode } from './window-frame.js';
+import { ExprNode, SQLNode } from './node.js';
+export declare class WindowClauseNode extends SQLNode {
+    /** The window name. */
+    readonly name: string;
+    /** The window definition. */
+    readonly def: WindowDefNode;
+    /**
+     * Instantiate a window clause node.
+     * @param name The window name.
+     * @param def The window definition.
+     */
+    constructor(name: string, def: WindowDefNode);
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString(): string;
+}
+export declare class WindowNode extends ExprNode {
+    readonly func: WindowFunctionNode | AggregateNode;
+    readonly def: WindowDefNode;
+    /**
+     * Instantiate a window node.
+     * @param func The window function call.
+     * @param over The window definition or name.
+     */
+    constructor(func: WindowFunctionNode | AggregateNode, over?: WindowDefNode);
+    /**
+     * Return an updated window over a named window definition.
+     * @param name The window definition name.
+     * @returns A new window node.
+     */
+    over(name: string): WindowNode;
+    /**
+     * Return an updated window with the given partitions.
+     * @param expr The partition by criteria.
+     * @returns A new window node.
+     */
+    partitionby(...expr: ExprVarArgs[]): WindowNode;
+    /**
+     * Return an updated window with the given ordering.
+     * @param expr The order by criteria.
+     * @returns A new window node.
+     */
+    orderby(...expr: ExprVarArgs[]): WindowNode;
+    /**
+     * Return an updated window with the given frame definition.
+     * @param framedef The frame definition.
+     * @returns A new window node.
+     */
+    frame(framedef: WindowFrameNode): WindowNode;
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString(): string;
+}
+export declare class WindowFunctionNode extends ExprNode {
+    /** The window function name. */
+    readonly name: string;
+    /** The window function arguments. */
+    readonly args: ExprNode[];
+    /** Flag to ignore null values. */
+    readonly ignoreNulls: boolean;
+    /** Order by expression for window arguments. */
+    readonly order: ExprNode[];
+    /**
+     * Instantiate a window function call node.
+     * @param name The window function name.
+     * @param args The window function arguments.
+     * @param ignoreNulls Flag to ignore null values.
+     * @param argOrder Order expressions for window arguments.
+     *  Note that this argument ordering is distinct from the window ordering.
+     */
+    constructor(name: WindowFunctionName, args?: ExprNode[], ignoreNulls?: boolean, argOrder?: OrderByExpr);
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString(): string;
+}
+export declare class WindowDefNode extends SQLNode {
+    /** The base window definition name. */
+    readonly name?: string;
+    /** The partition by criteria. */
+    readonly partition?: ExprNode[];
+    /** The order by criteria. */
+    readonly order?: ExprNode[];
+    /** The window frame definition. */
+    readonly framedef?: WindowFrameNode;
+    /**
+     * Instantiate a window definition node.
+     * @param name The base window definition name.
+     * @param partition The partition by criteria.
+     * @param order The order by criteria.
+     * @param framedef The window frame definition.
+     */
+    constructor(name?: string, partition?: ExprNode[], order?: ExprNode[], framedef?: WindowFrameNode);
+    /**
+     * Return an updated window definition with the given base name.
+     * @param name The base window definition name.
+     * @returns A new window definition node.
+     */
+    over(name: string): WindowDefNode;
+    /**
+     * Return an updated window definition with the given partitions.
+     * @param expr The partition by criteria.
+     * @returns A new window definition node.
+     */
+    partitionby(...expr: ExprVarArgs[]): WindowDefNode;
+    /**
+     * Return an updated window definition with the given ordering.
+     * @param expr The order by criteria.
+     * @returns A new window definition node.
+     */
+    orderby(...expr: ExprVarArgs[]): WindowDefNode;
+    /**
+     * Return an updated window definition with the given frame definition.
+     * @param framedef The frame definition.
+     * @return A new window definition node.
+     */
+    frame(framedef: WindowFrameNode): WindowDefNode;
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=window.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../../../src/ast/window.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIzD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE9C,qBAAa,gBAAiB,SAAQ,OAAO;IAC1C,uBAAuB;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAE7B;;;;OAIG;gBACS,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa;IAM5C;;OAEG;IACH,QAAQ;CAGT;AAED,qBAAa,UAAW,SAAQ,QAAQ;IACtC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,aAAa,CAAC;IAClD,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAA;IAE3B;;;;OAIG;gBAED,IAAI,EAAE,kBAAkB,GAAG,aAAa,EACxC,IAAI,GAAE,aAAmC;IAO3C;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM;IAIjB;;;;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;CAGT;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC1B,kCAAkC;IAClC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAE3B;;;;;;;OAOG;gBAED,IAAI,EAAE,kBAAkB,EACxB,IAAI,GAAE,QAAQ,EAAO,EACrB,WAAW,GAAE,OAAe,EAC5B,QAAQ,GAAE,WAAgB;IAS5B;;OAEG;IACH,QAAQ;CAST;AAED,qBAAa,aAAc,SAAQ,OAAO;IACxC,uCAAuC;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IAChC,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC5B,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAEpC;;;;;;OAMG;gBAED,IAAI,CAAC,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,QAAQ,EAAE,EACtB,KAAK,CAAC,EAAE,QAAQ,EAAE,EAClB,QAAQ,CAAC,EAAE,eAAe;IAS5B;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM;IAIjB;;;;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;CAWT"}

package/dist/src/ast/window.js

@@ -0,0 +1,194 @@
+import { WINDOW, WINDOW_CLAUSE, WINDOW_DEF, WINDOW_FUNCTION } from '../constants.js';
+import { nodeList } from '../util/function.js';
+import { quoteIdentifier } from '../util/string.js';
+import { ExprNode, SQLNode } from './node.js';
+export class WindowClauseNode extends SQLNode {
+    /** The window name. */
+    name;
+    /** The window definition. */
+    def;
+    /**
+     * Instantiate a window clause node.
+     * @param name The window name.
+     * @param def The window definition.
+     */
+    constructor(name, def) {
+        super(WINDOW_CLAUSE);
+        this.name = name;
+        this.def = def;
+    }
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString() {
+        return `${quoteIdentifier(this.name)} AS ${this.def}`;
+    }
+}
+export class WindowNode extends ExprNode {
+    func;
+    def;
+    /**
+     * Instantiate a window node.
+     * @param func The window function call.
+     * @param over The window definition or name.
+     */
+    constructor(func, over = new WindowDefNode()) {
+        super(WINDOW);
+        this.func = func;
+        this.def = over;
+    }
+    /**
+     * Return an updated window over a named window definition.
+     * @param name The window definition name.
+     * @returns A new window node.
+     */
+    over(name) {
+        return new WindowNode(this.func, this.def.over(name));
+    }
+    /**
+     * Return an updated window with the given partitions.
+     * @param expr The partition by criteria.
+     * @returns A new window node.
+     */
+    partitionby(...expr) {
+        return new WindowNode(this.func, this.def.partitionby(...expr));
+    }
+    /**
+     * Return an updated window with the given ordering.
+     * @param expr The order by criteria.
+     * @returns A new window node.
+     */
+    orderby(...expr) {
+        return new WindowNode(this.func, this.def.orderby(...expr));
+    }
+    /**
+     * Return an updated window with the given frame definition.
+     * @param framedef The frame definition.
+     * @returns A new window node.
+     */
+    frame(framedef) {
+        return new WindowNode(this.func, this.def.frame(framedef));
+    }
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString() {
+        return `${this.func} OVER ${this.def}`;
+    }
+}
+export class WindowFunctionNode extends ExprNode {
+    /** The window function name. */
+    name;
+    /** The window function arguments. */
+    args;
+    /** Flag to ignore null values. */
+    ignoreNulls;
+    /** Order by expression for window arguments. */
+    order;
+    /**
+     * Instantiate a window function call node.
+     * @param name The window function name.
+     * @param args The window function arguments.
+     * @param ignoreNulls Flag to ignore null values.
+     * @param argOrder Order expressions for window arguments.
+     *  Note that this argument ordering is distinct from the window ordering.
+     */
+    constructor(name, args = [], ignoreNulls = false, argOrder = []) {
+        super(WINDOW_FUNCTION);
+        this.name = name;
+        this.args = args;
+        this.ignoreNulls = ignoreNulls;
+        this.order = nodeList([argOrder]);
+    }
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString() {
+        const { name, args, ignoreNulls, order } = this;
+        const arg = [
+            args.join(', '),
+            order.length ? `ORDER BY ${order.join(', ')}` : '',
+            ignoreNulls ? 'IGNORE NULLS' : ''
+        ].filter(x => x).join(' ');
+        return `${name}(${arg})`;
+    }
+}
+export class WindowDefNode extends SQLNode {
+    /** The base window definition name. */
+    name;
+    /** The partition by criteria. */
+    partition;
+    /** The order by criteria. */
+    order;
+    /** The window frame definition. */
+    framedef;
+    /**
+     * Instantiate a window definition node.
+     * @param name The base window definition name.
+     * @param partition The partition by criteria.
+     * @param order The order by criteria.
+     * @param framedef The window frame definition.
+     */
+    constructor(name, partition, order, framedef) {
+        super(WINDOW_DEF);
+        this.name = name;
+        this.partition = partition;
+        this.order = order;
+        this.framedef = framedef;
+    }
+    /**
+     * Return an updated window definition with the given base name.
+     * @param name The base window definition name.
+     * @returns A new window definition node.
+     */
+    over(name) {
+        return deriveDef(this, { name });
+    }
+    /**
+     * Return an updated window definition with the given partitions.
+     * @param expr The partition by criteria.
+     * @returns A new window definition node.
+     */
+    partitionby(...expr) {
+        return deriveDef(this, { partition: nodeList(expr) });
+    }
+    /**
+     * Return an updated window definition with the given ordering.
+     * @param expr The order by criteria.
+     * @returns A new window definition node.
+     */
+    orderby(...expr) {
+        return deriveDef(this, { order: nodeList(expr) });
+    }
+    /**
+     * Return an updated window definition with the given frame definition.
+     * @param framedef The frame definition.
+     * @return A new window definition node.
+     */
+    frame(framedef) {
+        return deriveDef(this, { framedef });
+    }
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString() {
+        const { name, partition, order, framedef } = this;
+        const base = name && quoteIdentifier(name);
+        const def = [
+            base,
+            partition?.length && `PARTITION BY ${partition.join(', ')}`,
+            order?.length && `ORDER BY ${order.join(', ')}`,
+            framedef
+        ].filter(x => x);
+        return base && def.length < 2 ? base : `(${def.join(' ')})`;
+    }
+}
+/**
+ * Derive a new window definition node from an existing one.
+ * @param def The existing window definition.
+ * @param options An options object with new definition properties.
+ */
+function deriveDef(def, options) {
+    return new WindowDefNode(options.name ?? def.name, options.partition ?? def.partition, options.order ?? def.order, options.framedef ?? def.framedef);
+}
+//# sourceMappingURL=window.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"window.js","sourceRoot":"","sources":["../../../src/ast/window.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,OAAO,gBAAiB,SAAQ,OAAO;IAC1C,uBAAuB;IACd,IAAI,CAAS;IACtB,6BAA6B;IACpB,GAAG,CAAgB;IAE7B;;;;OAIG;IACH,YAAY,IAAY,EAAE,GAAkB;QAC1C,KAAK,CAAC,aAAa,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;IACxD,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,QAAQ;IAC7B,IAAI,CAAqC;IACzC,GAAG,CAAe;IAE3B;;;;OAIG;IACH,YACE,IAAwC,EACxC,OAAsB,IAAI,aAAa,EAAE;QAEzC,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,IAAY;QACf,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACxD,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,GAAG,IAAmB;QAChC,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAClE,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,GAAG,IAAmB;QAC5B,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAyB;QAC7B,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,GAAG,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9C,gCAAgC;IACvB,IAAI,CAAS;IACtB,qCAAqC;IAC5B,IAAI,CAAa;IAC1B,kCAAkC;IACzB,WAAW,CAAU;IAC9B,gDAAgD;IACvC,KAAK,CAAa;IAE3B;;;;;;;OAOG;IACH,YACE,IAAwB,EACxB,OAAmB,EAAE,EACrB,cAAuB,KAAK,EAC5B,WAAwB,EAAE;QAE1B,KAAK,CAAC,eAAe,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAChD,MAAM,GAAG,GAAG;YACV,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YACf,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;YAClD,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE;SAClC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3B,OAAO,GAAG,IAAI,IAAI,GAAG,GAAG,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,OAAO;IACxC,uCAAuC;IAC9B,IAAI,CAAU;IACvB,iCAAiC;IACxB,SAAS,CAAc;IAChC,6BAA6B;IACpB,KAAK,CAAc;IAC5B,mCAAmC;IAC1B,QAAQ,CAAmB;IAEpC;;;;;;OAMG;IACH,YACE,IAAa,EACb,SAAsB,EACtB,KAAkB,EAClB,QAA0B;QAE1B,KAAK,CAAC,UAAU,CAAC,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,IAAY;QACf,OAAO,SAAS,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,GAAG,IAAmB;QAChC,OAAO,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxD,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,GAAG,IAAmB;QAC5B,OAAO,SAAS,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAyB;QAC7B,OAAO,SAAS,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG;YACV,IAAI;YACJ,SAAS,EAAE,MAAM,IAAI,gBAAgB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC3D,KAAK,EAAE,MAAM,IAAI,YAAY,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC/C,QAAQ;SACT,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACjB,OAAO,IAAI,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC9D,CAAC;CACF;AAaD;;;;GAIG;AACH,SAAS,SAAS,CAAC,GAAkB,EAAE,OAAyB;IAC9D,OAAO,IAAI,aAAa,CACtB,OAAO,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,EACxB,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,EAClC,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,EAC1B,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,CACjC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,25 @@
+import type { Query } from './query.js';
+import { SQLNode } from './node.js';
+export declare class WithClauseNode extends SQLNode {
+    /** The common table expression (CTE) name. */
+    readonly name: string;
+    /** The common table expression (CTE) query. */
+    readonly query: Query;
+    /** The common table expression (CTE) materialization flag. */
+    readonly materialized: boolean | null;
+    /**
+     * Instantiate a with clause node for a common table expression (CTE).
+     * @param name The common table expression (CTE) name.
+     * @param query The common table expression (CTE) query.
+     * @param materialized The common table expression (CTE)
+     *  materialization flag. If `true`, forces materialization of the CTE.
+     *  If `false`, materialization is not performed. Otherwise (for example, if
+     *  `undefined` or `null`), materialization is decided by the database.
+     */
+    constructor(name: string, query: Query, materialized?: boolean | null);
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=with.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"with.d.ts","sourceRoot":"","sources":["../../../src/ast/with.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,qBAAa,cAAe,SAAQ,OAAO;IACzC,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;IAEtC;;;;;;;;OAQG;gBAED,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,KAAK,EACZ,YAAY,GAAE,OAAO,GAAG,IAAW;IAQrC;;OAEG;IACH,QAAQ;CAOT"}

package/dist/src/ast/with.js

@@ -0,0 +1,36 @@
+import { WITH_CLAUSE } from '../constants.js';
+import { SQLNode } from './node.js';
+export class WithClauseNode extends SQLNode {
+    /** The common table expression (CTE) name. */
+    name;
+    /** The common table expression (CTE) query. */
+    query;
+    /** The common table expression (CTE) materialization flag. */
+    materialized;
+    /**
+     * Instantiate a with clause node for a common table expression (CTE).
+     * @param name The common table expression (CTE) name.
+     * @param query The common table expression (CTE) query.
+     * @param materialized The common table expression (CTE)
+     *  materialization flag. If `true`, forces materialization of the CTE.
+     *  If `false`, materialization is not performed. Otherwise (for example, if
+     *  `undefined` or `null`), materialization is decided by the database.
+     */
+    constructor(name, query, materialized = null) {
+        super(WITH_CLAUSE);
+        this.name = name;
+        this.query = query;
+        this.materialized = materialized;
+    }
+    /**
+     * Generate a SQL query string for this node.
+     */
+    toString() {
+        const flag = this.materialized;
+        const mat = flag === true ? ' MATERIALIZED'
+            : flag === false ? ' NOT MATERIALIZED'
+                : '';
+        return `"${this.name}" AS${mat} (${this.query})`;
+    }
+}
+//# sourceMappingURL=with.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"with.js","sourceRoot":"","sources":["../../../src/ast/with.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,OAAO,cAAe,SAAQ,OAAO;IACzC,8CAA8C;IACrC,IAAI,CAAS;IACtB,+CAA+C;IACtC,KAAK,CAAQ;IACtB,8DAA8D;IACrD,YAAY,CAAiB;IAEtC;;;;;;;;OAQG;IACH,YACE,IAAY,EACZ,KAAY,EACZ,eAA+B,IAAI;QAEnC,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC;QAC/B,MAAM,GAAG,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,eAAe;YACzC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,mBAAmB;gBACtC,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,IAAI,IAAI,CAAC,IAAI,OAAO,GAAG,KAAK,IAAI,CAAC,KAAK,GAAG,CAAC;IACnD,CAAC;CACF"}

package/dist/src/constants.d.ts

@@ -0,0 +1,40 @@
+export declare const COLUMN_REF = "COLUMN_REF";
+export declare const COLUMN_PARAM = "COLUMN_PARAM";
+export declare const TABLE_REF = "TABLE_REF";
+export declare const LITERAL = "LITERAL";
+export declare const INTERVAL = "INTERVAL";
+export declare const LIST = "LIST";
+export declare const UNNEST = "UNNEST";
+export declare const ORDER_BY = "ORDER_BY";
+export declare const CAST = "CAST";
+export declare const CASE = "CASE";
+export declare const WHEN = "WHEN";
+export declare const COLLATE = "COLLATE";
+export declare const UNARY_OPERATOR = "UNARY";
+export declare const UNARY_POSTFIX_OPERATOR = "UNARY_POSTFIX";
+export declare const BINARY_OPERATOR = "BINARY";
+export declare const BETWEEN_OPERATOR = "BETWEEN";
+export declare const NOT_BETWEEN_OPERATOR = "NOT_BETWEEN";
+export declare const LOGICAL_OPERATOR = "LOGICAL_OPERATOR";
+export declare const IN_OPERATOR = "IN";
+export declare const FUNCTION = "FUNCTION";
+export declare const AGGREGATE = "AGGREGATE";
+export declare const WINDOW = "WINDOW";
+export declare const WINDOW_FUNCTION = "WINDOW_FUNCTION";
+export declare const WINDOW_DEF = "WINDOW_DEF";
+export declare const WINDOW_FRAME = "WINDOW_FRAME";
+export declare const WINDOW_EXTENT_EXPR = "WINDOW_EXTENT_EXPR";
+export declare const EXPRESSION = "EXPRESSION";
+export declare const FRAGMENT = "FRAGMENT";
+export declare const VERBATIM = "VERBATIM";
+export declare const PARAM = "PARAM";
+export declare const WITH_CLAUSE = "WITH_CLAUSE";
+export declare const WINDOW_CLAUSE = "WINDOW_CLAUSE";
+export declare const SELECT_CLAUSE = "SELECT_CLAUSE";
+export declare const FROM_CLAUSE = "FROM_CLAUSE";
+export declare const SAMPLE_CLAUSE = "SAMPLE_CLAUSE";
+export declare const SELECT_QUERY = "SELECT_QUERY";
+export declare const DESCRIBE_QUERY = "DESCRIBE_QUERY";
+export declare const SET_OPERATION = "SET_OPERATION";
+export declare const SCALAR_SUBQUERY = "SCALAR_SUBQUERY";
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,eAAe,CAAC;AACvC,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAC3C,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,OAAO,YAAY,CAAC;AACjC,eAAO,MAAM,QAAQ,aAAa,CAAC;AACnC,eAAO,MAAM,IAAI,SAAS,CAAC;AAC3B,eAAO,MAAM,MAAM,WAAW,CAAC;AAE/B,eAAO,MAAM,QAAQ,aAAa,CAAC;AACnC,eAAO,MAAM,IAAI,SAAS,CAAC;AAC3B,eAAO,MAAM,IAAI,SAAS,CAAC;AAC3B,eAAO,MAAM,IAAI,SAAS,CAAC;AAC3B,eAAO,MAAM,OAAO,YAAY,CAAC;AAEjC,eAAO,MAAM,cAAc,UAAU,CAAC;AACtC,eAAO,MAAM,sBAAsB,kBAAkB,CAAC;AACtD,eAAO,MAAM,eAAe,WAAW,CAAC;AACxC,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAC1C,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAClD,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD,eAAO,MAAM,WAAW,OAAO,CAAC;AAEhC,eAAO,MAAM,QAAQ,aAAa,CAAC;AACnC,eAAO,MAAM,SAAS,cAAc,CAAC;AACrC,eAAO,MAAM,MAAM,WAAW,CAAC;AAC/B,eAAO,MAAM,eAAe,oBAAoB,CAAC;AACjD,eAAO,MAAM,UAAU,eAAe,CAAC;AACvC,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAC3C,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAEvD,eAAO,MAAM,UAAU,eAAe,CAAC;AACvC,eAAO,MAAM,QAAQ,aAAa,CAAC;AACnC,eAAO,MAAM,QAAQ,aAAa,CAAC;AACnC,eAAO,MAAM,KAAK,UAAU,CAAC;AAE7B,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAC7C,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAC7C,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAC3C,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAC7C,eAAO,MAAM,eAAe,oBAAoB,CAAC"}

package/dist/src/constants.js

@@ -0,0 +1,40 @@
+export const COLUMN_REF = 'COLUMN_REF';
+export const COLUMN_PARAM = 'COLUMN_PARAM';
+export const TABLE_REF = 'TABLE_REF';
+export const LITERAL = 'LITERAL';
+export const INTERVAL = 'INTERVAL';
+export const LIST = 'LIST';
+export const UNNEST = 'UNNEST';
+export const ORDER_BY = 'ORDER_BY';
+export const CAST = 'CAST';
+export const CASE = 'CASE';
+export const WHEN = 'WHEN';
+export const COLLATE = 'COLLATE';
+export const UNARY_OPERATOR = 'UNARY';
+export const UNARY_POSTFIX_OPERATOR = 'UNARY_POSTFIX';
+export const BINARY_OPERATOR = 'BINARY';
+export const BETWEEN_OPERATOR = 'BETWEEN';
+export const NOT_BETWEEN_OPERATOR = 'NOT_BETWEEN';
+export const LOGICAL_OPERATOR = 'LOGICAL_OPERATOR';
+export const IN_OPERATOR = 'IN';
+export const FUNCTION = 'FUNCTION';
+export const AGGREGATE = 'AGGREGATE';
+export const WINDOW = 'WINDOW';
+export const WINDOW_FUNCTION = 'WINDOW_FUNCTION';
+export const WINDOW_DEF = 'WINDOW_DEF';
+export const WINDOW_FRAME = 'WINDOW_FRAME';
+export const WINDOW_EXTENT_EXPR = 'WINDOW_EXTENT_EXPR';
+export const EXPRESSION = 'EXPRESSION';
+export const FRAGMENT = 'FRAGMENT';
+export const VERBATIM = 'VERBATIM';
+export const PARAM = 'PARAM';
+export const WITH_CLAUSE = 'WITH_CLAUSE';
+export const WINDOW_CLAUSE = 'WINDOW_CLAUSE';
+export const SELECT_CLAUSE = 'SELECT_CLAUSE';
+export const FROM_CLAUSE = 'FROM_CLAUSE';
+export const SAMPLE_CLAUSE = 'SAMPLE_CLAUSE';
+export const SELECT_QUERY = 'SELECT_QUERY';
+export const DESCRIBE_QUERY = 'DESCRIBE_QUERY';
+export const SET_OPERATION = 'SET_OPERATION';
+export const SCALAR_SUBQUERY = 'SCALAR_SUBQUERY';
+//# sourceMappingURL=constants.js.map

package/dist/src/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;AACvC,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAC3C,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;AACrC,MAAM,CAAC,MAAM,OAAO,GAAG,SAAS,CAAC;AACjC,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;AACnC,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC;AAC3B,MAAM,CAAC,MAAM,MAAM,GAAG,QAAQ,CAAC;AAE/B,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;AACnC,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC;AAC3B,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC;AAC3B,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC;AAC3B,MAAM,CAAC,MAAM,OAAO,GAAG,SAAS,CAAC;AAEjC,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AACtC,MAAM,CAAC,MAAM,sBAAsB,GAAG,eAAe,CAAC;AACtD,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC;AACxC,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAC;AAClD,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC;AAEhC,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;AACnC,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;AACrC,MAAM,CAAC,MAAM,MAAM,GAAG,QAAQ,CAAC;AAC/B,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAC;AACjD,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;AACvC,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEvD,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;AACvC,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;AACnC,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;AACnC,MAAM,CAAC,MAAM,KAAK,GAAG,OAAO,CAAC;AAE7B,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AACzC,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAC7C,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAC7C,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AACzC,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAE7C,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAC3C,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAC/C,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAC7C,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAC"}