@uwdata/mosaic-sql 0.17.0 → 0.19.0

package/src/ast/order-by.ts

@@ -0,0 +1,38 @@
+import { ORDER_BY } from '../constants.js';
+import { ExprNode } from './node.js';
+
+export 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) {
+    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}`;
+  }
+}

package/src/ast/{param.js → param.ts}

@@ -1,28 +1,23 @@
-/**
- * @import { ParamLike } from '../types.js'
- */
+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 {
+  /** The dynamic parameter. */
+  readonly param: ParamLike;
+
   /**
    * Instantiate a param node with a dynamic parameter.
-   * @param {ParamLike} param The dynamic parameter.
+   * @param param The dynamic parameter.
    */
-  constructor(param) {
+  constructor(param: ParamLike) {
     super(PARAM);
-    /**
-     * The dynamic parameter.
-     * @type {ParamLike}
-     * @readonly
-     */
     this.param = param;
   }
 
   /**
    * Returns the current parameter value.
-   * @returns {*}
    */
   get value() {
     return this.param.value;
@@ -30,7 +25,6 @@ export class ParamNode extends ExprNode {
 
   /**
    * Generate a SQL query string for this node.
-   * @returns {string}
    */
   toString() {
     return literalToSQL(this.value);