@uwdata/mosaic-sql 0.18.0 → 0.20.0

package/dist/src/visit/to-string-visitor.d.ts

@@ -0,0 +1,60 @@
+import type { SQLNode, ExprNode, AggregateNode, BetweenOpNode, NotBetweenOpNode, BinaryOpNode, CaseNode, WhenNode, CastNode, CollateNode, ColumnParamNode, ColumnRefNode, FragmentNode, FromClauseNode, FunctionNode, InOpNode, IntervalNode, JoinNode, ListNode, LiteralNode, LogicalOpNode, OrderByNode, ParamNode, DescribeQuery, SelectQuery, SetOperation, SampleClauseNode, SelectClauseNode, ScalarSubqueryNode, TableRefNode, UnaryOpNode, UnaryPostfixOpNode, UnnestNode, VerbatimNode, WindowNode, WindowClauseNode, WindowDefNode, WindowFunctionNode, WindowFrameNode, WindowFrameExprNode, WithClauseNode } from '../index.js';
+/**
+ * Abstract base class for SQL visitors providing common functionality.
+ */
+export declare abstract class ToStringVisitor {
+    /**
+     * Convert a SQL AST node to a string using this visitor.
+     * @param node The SQL AST node to convert.
+     * @returns The SQL string representation.
+     */
+    toString(node: SQLNode): string;
+    protected getVisitMethod(nodeType: string): ((node: AggregateNode) => string) | ((node: BetweenOpNode) => string) | ((node: BinaryOpNode) => string) | ((node: CaseNode) => string) | ((node: CastNode) => string) | ((node: CollateNode) => string) | ((node: ColumnParamNode) => string) | ((node: DescribeQuery) => string);
+    /**
+     * Helper method to convert child nodes to strings.
+     * @param nodes Array of child nodes.
+     * @returns Array of SQL strings.
+     */
+    protected mapToString(nodes: SQLNode[]): string[];
+    abstract visitAggregate(node: AggregateNode): string;
+    abstract visitBetween(node: BetweenOpNode): string;
+    abstract visitBinary(node: BinaryOpNode): string;
+    abstract visitCase(node: CaseNode): string;
+    abstract visitCast(node: CastNode): string;
+    abstract visitCollate(node: CollateNode): string;
+    abstract visitColumnParam(node: ColumnParamNode): string;
+    abstract visitColumnRef(node: ColumnRefNode): string;
+    abstract visitDescribeQuery(node: DescribeQuery): string;
+    abstract visitExpression(node: ExprNode): string;
+    abstract visitFragment(node: FragmentNode): string;
+    abstract visitFromClause(node: FromClauseNode): string;
+    abstract visitFunction(node: FunctionNode): string;
+    abstract visitIn(node: InOpNode): string;
+    abstract visitInterval(node: IntervalNode): string;
+    abstract visitJoinClause(node: JoinNode): string;
+    abstract visitList(node: ListNode): string;
+    abstract visitLiteral(node: LiteralNode): string;
+    abstract visitLogicalOperator(node: LogicalOpNode<ExprNode>): string;
+    abstract visitNotBetween(node: NotBetweenOpNode): string;
+    abstract visitOrderBy(node: OrderByNode): string;
+    abstract visitParam(node: ParamNode): string;
+    abstract visitSampleClause(node: SampleClauseNode): string;
+    abstract visitScalarSubquery(node: ScalarSubqueryNode): string;
+    abstract visitSelectClause(node: SelectClauseNode): string;
+    abstract visitSelectQuery(node: SelectQuery): string;
+    abstract visitSetOperation(node: SetOperation): string;
+    abstract visitTableRef(node: TableRefNode): string;
+    abstract visitUnary(node: UnaryOpNode): string;
+    abstract visitUnaryPostfix(node: UnaryPostfixOpNode): string;
+    abstract visitUnnest(node: UnnestNode): string;
+    abstract visitVerbatim(node: VerbatimNode): string;
+    abstract visitWhen(node: WhenNode): string;
+    abstract visitWindow(node: WindowNode): string;
+    abstract visitWindowClause(node: WindowClauseNode): string;
+    abstract visitWindowDef(node: WindowDefNode): string;
+    abstract visitWindowExtentExpr(node: WindowFrameExprNode): string;
+    abstract visitWindowFrame(node: WindowFrameNode): string;
+    abstract visitWindowFunction(node: WindowFunctionNode): string;
+    abstract visitWithClause(node: WithClauseNode): string;
+}
+//# sourceMappingURL=to-string-visitor.d.ts.map

package/dist/src/visit/to-string-visitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-string-visitor.d.ts","sourceRoot":"","sources":["../../../src/visit/to-string-visitor.ts"],"names":[],"mappings":"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"}

package/dist/src/visit/to-string-visitor.js

@@ -0,0 +1,80 @@
+import { AGGREGATE, BETWEEN_OPERATOR, BINARY_OPERATOR, CASE, CAST, COLLATE, COLUMN_PARAM, COLUMN_REF, DESCRIBE_QUERY, EXPRESSION, FRAGMENT, FROM_CLAUSE, FUNCTION, IN_OPERATOR, INTERVAL, JOIN_CLAUSE, LIST, LITERAL, LOGICAL_OPERATOR, NOT_BETWEEN_OPERATOR, ORDER_BY, PARAM, SAMPLE_CLAUSE, SCALAR_SUBQUERY, SELECT_CLAUSE, SELECT_QUERY, SET_OPERATION, TABLE_REF, UNARY_OPERATOR, UNARY_POSTFIX_OPERATOR, UNNEST, VERBATIM, WHEN, WINDOW, WINDOW_CLAUSE, WINDOW_DEF, WINDOW_EXTENT_EXPR, WINDOW_FRAME, WINDOW_FUNCTION, WITH_CLAUSE } from '../constants.js';
+/**
+ * Abstract base class for SQL visitors providing common functionality.
+ */
+export class ToStringVisitor {
+    /**
+     * Convert a SQL AST node to a string using this visitor.
+     * @param node The SQL AST node to convert.
+     * @returns The SQL string representation.
+     */
+    toString(node) {
+        if (!node) {
+            throw new Error('Node is null or undefined');
+        }
+        if (typeof node.type !== 'string') {
+            throw new Error(`Node type is not a string: ${typeof node.type}, value: ${node.type}`);
+        }
+        const method = this.getVisitMethod(node.type);
+        if (typeof method === 'function') {
+            // @ts-expect-error: fix me
+            return method.call(this, node);
+        }
+        throw new Error(`No visitor method for node type: '${node.type}'`);
+    }
+    getVisitMethod(nodeType) {
+        switch (nodeType) {
+            case AGGREGATE: return this.visitAggregate;
+            case BETWEEN_OPERATOR: return this.visitBetween;
+            case BINARY_OPERATOR: return this.visitBinary;
+            case CASE: return this.visitCase;
+            case CAST: return this.visitCast;
+            case COLLATE: return this.visitCollate;
+            case COLUMN_PARAM: return this.visitColumnParam;
+            case COLUMN_REF: return this.visitColumnRef;
+            case DESCRIBE_QUERY: return this.visitDescribeQuery;
+            case EXPRESSION: return this.visitExpression;
+            case FRAGMENT: return this.visitFragment;
+            case FROM_CLAUSE: return this.visitFromClause;
+            case FUNCTION: return this.visitFunction;
+            case IN_OPERATOR: return this.visitIn;
+            case INTERVAL: return this.visitInterval;
+            case JOIN_CLAUSE: return this.visitJoinClause;
+            case LIST: return this.visitList;
+            case LITERAL: return this.visitLiteral;
+            case LOGICAL_OPERATOR: return this.visitLogicalOperator;
+            case NOT_BETWEEN_OPERATOR: return this.visitNotBetween;
+            case ORDER_BY: return this.visitOrderBy;
+            case PARAM: return this.visitParam;
+            case SAMPLE_CLAUSE: return this.visitSampleClause;
+            case SCALAR_SUBQUERY: return this.visitScalarSubquery;
+            case SELECT_CLAUSE: return this.visitSelectClause;
+            case SELECT_QUERY: return this.visitSelectQuery;
+            case SET_OPERATION: return this.visitSetOperation;
+            case TABLE_REF: return this.visitTableRef;
+            case UNARY_OPERATOR: return this.visitUnary;
+            case UNARY_POSTFIX_OPERATOR: return this.visitUnaryPostfix;
+            case UNNEST: return this.visitUnnest;
+            case VERBATIM: return this.visitVerbatim;
+            case WHEN: return this.visitWhen;
+            case WINDOW: return this.visitWindow;
+            case WINDOW_CLAUSE: return this.visitWindowClause;
+            case WINDOW_DEF: return this.visitWindowDef;
+            case WINDOW_EXTENT_EXPR: return this.visitWindowExtentExpr;
+            case WINDOW_FRAME: return this.visitWindowFrame;
+            case WINDOW_FUNCTION: return this.visitWindowFunction;
+            case WITH_CLAUSE: return this.visitWithClause;
+            default:
+                throw new Error(`Unknown node type: '${nodeType}'`);
+        }
+    }
+    /**
+     * Helper method to convert child nodes to strings.
+     * @param nodes Array of child nodes.
+     * @returns Array of SQL strings.
+     */
+    mapToString(nodes) {
+        return nodes.map(node => this.toString(node));
+    }
+}
+//# sourceMappingURL=to-string-visitor.js.map

package/dist/src/visit/to-string-visitor.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uwdata/mosaic-sql",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "SQL query construction and analysis.",
   "keywords": [
     "sql",
@@ -29,5 +29,5 @@
     "test": "vitest run",
     "prepublishOnly": "npm run test && npm run lint && tsc --build"
   },
-  "gitHead": "dfb9ded0b0307754e3185ca34cc49a1384fe8455"
+  "gitHead": "5dae8fa40fd559abe287e1264d1a00073eedc749"
 }

package/src/ast/aggregate.ts

@@ -104,22 +104,6 @@ export class AggregateNode extends ExprNode {
   frame(framedef: WindowFrameNode) {
     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}`;
-  }
 }
 
 /**

package/src/ast/between-op.ts

@@ -40,13 +40,6 @@ export class BetweenOpNode extends AbstractBetweenOpNode {
   constructor(expr: ExprNode, extent?: Extent) {
     super(BETWEEN_OPERATOR, expr, extent);
   }
-
-  /**
-   * Generate a SQL query string for this node.
-   */
-  toString() {
-    return super.toSQL('BETWEEN');
-  }
 }
 
 export class NotBetweenOpNode extends AbstractBetweenOpNode {
@@ -58,11 +51,4 @@ export class NotBetweenOpNode extends AbstractBetweenOpNode {
   constructor(expr: ExprNode, extent?: Extent) {
     super(NOT_BETWEEN_OPERATOR, expr, extent);
   }
-
-  /**
-   * Generate a SQL query string for this node.
-   */
-  toString() {
-    return super.toSQL('NOT BETWEEN');
-  }
 }

package/src/ast/binary-op.ts

@@ -21,11 +21,4 @@ export class BinaryOpNode extends ExprNode {
     this.left = left;
     this.right = right;
   }
-
-  /**
-   * Generate a SQL query string for this node.
-   */
-  toString() {
-    return `(${this.left} ${this.op} ${this.right})`;
-  }
 }

package/src/ast/case.ts

@@ -52,17 +52,6 @@ export class CaseNode extends ExprNode {
   else(expr: ExprValue) {
     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 {
@@ -81,11 +70,4 @@ export class WhenNode extends SQLNode {
     this.when = when;
     this.then = then;
   }
-
-  /**
-   * Generate a SQL query string for this node.
-   */
-  toString() {
-    return `WHEN ${this.when} THEN ${this.then}`;
-  }
 }

package/src/ast/cast.ts

@@ -17,12 +17,4 @@ export class CastNode extends ExprNode {
     this.expr = expr;
     this.cast = type;
   }
-
-  /**
-   * Generate a SQL query string for this node.
-   */
-  toString() {
-    // TODO? could include check to see if parens are necessary
-    return `(${this.expr})::${this.cast}`;
-  }
 }

package/src/ast/collate.ts

@@ -17,11 +17,4 @@ export class CollateNode extends ExprNode {
     this.expr = expr;
     this.collation = collation;
   }
-
-  /**
-   * Generate a SQL query string for this node.
-   */
-  toString() {
-    return `${this.expr} ${COLLATE} ${this.collation}`;
-  }
 }

package/src/ast/column-ref.ts

@@ -1,6 +1,5 @@
 import type { TableRefNode } from './table-ref.js';
 import { COLUMN_REF } from '../constants.js';
-import { quoteIdentifier } from '../util/string.js';
 import { ExprNode } from './node.js';
 
 /**
@@ -31,16 +30,6 @@ export class ColumnRefNode extends ExprNode {
   get column() {
     return ''; // subclasses to override
   }
-
-  /**
-   * Generate a SQL query string for this node.
-   */
-  toString() {
-    const { column, table } = this;
-    const tref = `${table ?? ''}`;
-    const id = column === '*' ? '*' : quoteIdentifier(column);
-    return (tref ? (tref + '.') : '') + id;
-  }
 }
 
 export class ColumnNameRefNode extends ColumnRefNode {

package/src/ast/fragment.ts

@@ -18,11 +18,4 @@ export class FragmentNode extends ExprNode {
     super(FRAGMENT);
     this.spans = spans;
   }
-
-  /**
-   * Generate a SQL query string for this node.
-   */
-  toString() {
-    return this.spans.join('');
-  }
 }

package/src/ast/from.ts

@@ -1,11 +1,15 @@
 import type { SampleClauseNode } from './sample.js';
 import { FROM_CLAUSE } from '../constants.js';
-import { quoteIdentifier } from '../util/string.js';
 import { SQLNode } from './node.js';
-import { isQuery } from './query.js';
-import { isTableRef } from './table-ref.js';
 
-export class FromClauseNode extends SQLNode {
+/**
+ * AST node corresponding to a table source which can appear
+ * within a SQL `FROM` clause.
+ */
+export class FromNode extends SQLNode {
+}
+
+export class FromClauseNode extends FromNode {
   /** The from expression. */
   readonly expr: SQLNode;
   /** The output name. */
@@ -27,14 +31,10 @@ export class FromClauseNode extends SQLNode {
   }
 
   /**
-   * Generate a SQL query string for this node.
+   * Create a new from clause node that uses the given alias.
+   * @param string alias
    */
-  toString() {
-    const { expr, alias, sample } = this;
-    const ref = isQuery(expr) ? `(${expr})` : `${expr}`;
-    const from = alias && !(isTableRef(expr) && expr.table.join('.') === alias)
-      ? `${ref} AS ${quoteIdentifier(alias)}`
-      : `${ref}`;
-    return `${from}${sample ? ` TABLESAMPLE ${sample}` : ''}`;
+  as(alias: string) {
+    return new FromClauseNode(this.expr, alias, this.sample);
   }
 }

package/src/ast/function.ts

@@ -17,12 +17,4 @@ export class FunctionNode extends ExprNode {
     this.name = name;
     this.args = args;
   }
-
-  /**
-   * Generate a SQL query string for this node.
-   */
-  toString() {
-    const { name, args } = this;
-    return `${name}(${args.join(', ')})`;
-  }
 }

package/src/ast/in-op.ts

@@ -17,11 +17,4 @@ export class InOpNode extends ExprNode {
     this.expr = expr;
     this.values = values;
   }
-
-  /**
-   * Generate a SQL query string for this node.
-   */
-  toString() {
-    return `(${this.expr} IN (${this.values.join(', ')}))`;
-  }
 }

package/src/ast/interval.ts

@@ -17,11 +17,4 @@ export class IntervalNode extends ExprNode {
     this.name = name;
     this.steps = steps;
   }
-
-  /**
-   * Generate a SQL query string for this node.
-   */
-  toString() {
-    return `INTERVAL ${this.steps} ${this.name}`;
-  }
 }

package/src/ast/join.ts

@@ -0,0 +1,66 @@
+import type { SampleClauseNode } from './sample.js';
+import { JOIN_CLAUSE } from '../constants.js';
+import { ColumnRefNode } from './column-ref.js';
+import { FromNode } from './from.js';
+import { ExprNode } from './node.js';
+import { TableRefNode } from './table-ref.js';
+
+/** The join variant. Determines what kind of join is performed. */
+export type JoinVariant = 'REGULAR' | 'CROSS' | 'NATURAL' | 'POSITIONAL' | 'ASOF';
+
+/** The join type. Determines which values are included in the join output. */
+export type JoinType = 'INNER' | 'LEFT' | 'RIGHT' | 'FULL' | 'SEMI' | 'ANTI';
+
+export class JoinNode extends FromNode {
+  /** The left table to join. */
+  readonly left: FromNode | TableRefNode;
+  /** The right table to join. */
+  readonly right: FromNode | TableRefNode;
+  /** The join variant (REGULAR, CROSS, NATURAL, POSITIONAL, ASOF). */
+  readonly joinVariant: JoinVariant;
+  /** The join type (INNER, LEFT, RIGHT, FULL, SEMI, ANTI). */
+  readonly joinType: JoinType;
+  /**
+   * The join condition as a boolean expression.
+   * If specified, *using* should be `undefined`.
+   */
+  readonly condition?: ExprNode;
+  /**
+   * The join condition as shared columns to match on.
+   * If specified, *condition* should be `undefined`.
+   */
+  readonly using?: ColumnRefNode[];
+  /** A table sample to apply to join output. */
+  readonly sample?: SampleClauseNode;
+
+  /**
+   * Instantiate a join node.
+   * @param left The left table to join.
+   * @param right The right table to join.
+   * @param variant The join variant (REGULAR, CROSS, NATURAL, POSITIONAL, ASOF).
+   * @param type The join type (INNER, LEFT, RIGHT, FULL, SEMI, ANTI).
+   * @param condition The join condition as a boolean expression.
+   *  If specified, *using* should be `undefined`.
+   * @param using The join condition as shared columns to match on.
+   *  If specified, *condition* should be `undefined`.
+   * @param sample A table sample to apply to join output.
+   */
+  constructor(
+    left: FromNode | TableRefNode,
+    right: FromNode | TableRefNode,
+    variant: JoinVariant = 'NATURAL',
+    type: JoinType = 'INNER',
+    condition?: ExprNode,
+    using?: ColumnRefNode[],
+    sample?: SampleClauseNode
+  ) {
+    super(JOIN_CLAUSE);
+    this.left = left;
+    this.right = right;
+    this.joinVariant = variant;
+    this.joinType = type;
+    this.condition = condition;
+    this.using = using;
+    this.sample = sample;
+  }
+}

package/src/ast/list.ts

@@ -0,0 +1,16 @@
+import { LIST } from '../constants.js';
+import { ExprNode } from './node.js';
+
+export class ListNode extends ExprNode {
+  /** The array of values. */
+  readonly values: ExprNode[];
+
+  /**
+   * Instantiate a list node.
+   * @param values
+   */
+  constructor(values: ExprNode[]) {
+    super(LIST);
+    this.values = values;
+  }
+}

package/src/ast/literal.ts

@@ -13,13 +13,6 @@ export class LiteralNode extends ExprNode {
     super(LITERAL);
     this.value = value;
   }
-
-  /**
-   * Generate a SQL query string for this node.
-   */
-  toString() {
-    return literalToSQL(this.value);
-  }
 }
 
 export function literalToSQL(value: unknown) {

package/src/ast/logical-op.ts

@@ -17,16 +17,6 @@ export class LogicalOpNode<T extends ExprNode> extends ExprNode {
     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<T extends ExprNode> extends LogicalOpNode<T> {

package/src/ast/node.ts

@@ -1,3 +1,5 @@
+import type { SQLCodeGenerator } from '../visit/codegen/sql.js';
+
 /**
  * Check if a value is a SQL AST node.
  * @param value The value to check.
@@ -6,6 +8,16 @@ export function isNode(value: unknown): value is SQLNode {
   return value instanceof SQLNode;
 }
 
+let _defaultVisitor: SQLCodeGenerator | undefined;
+
+/**
+ * Set the default visitor for toString operations.
+ * This is used when no visitor is explicitly provided.
+ */
+export function setDefaultVisitor(visitor: SQLCodeGenerator) {
+  _defaultVisitor = visitor;
+}
+
 export class SQLNode {
   /** The SQL AST node type. */
   readonly type: string;
@@ -23,13 +35,28 @@ export class SQLNode {
    * @returns The shallow clone node.
    */
   clone(): this {
-    // @ts-expect-error use constructor
-    const clone = new this.constructor();
+    // @ts-expect-error use constructor with type
+    const clone = new this.constructor(this.type);
     for (const key in this) {
-      clone[key] = this[key];
+      if (key !== 'type') { // Skip type since it's already set by constructor
+        clone[key] = this[key];
+      }
     }
     return clone;
   }
+
+  /**
+   * Generate a SQL query string for this node using a specific dialect visitor.
+   * @param visitor Optional SQL visitor to use for string generation.
+   *  If not provided, uses the default visitor.
+   * @returns The SQL string representation.
+   */
+  toString(visitor: SQLCodeGenerator | undefined = _defaultVisitor): string {
+    if (!visitor) {
+      throw new Error('No visitor provided and no default visitor set.');
+    }
+    return visitor.toString(this);
+  }
 }
 
 /**

package/src/ast/order-by.ts

@@ -21,18 +21,4 @@ export class OrderByNode extends ExprNode {
     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}`;
-  }
 }

package/src/ast/param.ts

@@ -1,6 +1,5 @@
 import type { ParamLike } from '../types.js';
 import { PARAM } from '../constants.js';
-import { literalToSQL } from './literal.js';
 import { ExprNode } from './node.js';
 
 export class ParamNode extends ExprNode {
@@ -22,11 +21,4 @@ export class ParamNode extends ExprNode {
   get value() {
     return this.param.value;
   }
-
-  /**
-   * Generate a SQL query string for this node.
-   */
-  toString() {
-    return literalToSQL(this.value);
-  }
 }