data-finder-ts 0.1.4 → 0.1.5

package/dist/model/relational.cjs

@@ -22,15 +22,24 @@ var relational_exports = {};
 __export(relational_exports, {
   AggregateOperation: () => AggregateOperation,
   AggregateOperator: () => AggregateOperator,
+  Aggregates: () => Aggregates,
   Alias: () => Alias,
+  Arithmetic: () => Arithmetic,
+  ArithmeticOperation: () => ArithmeticOperation,
+  ArithmeticOperator: () => ArithmeticOperator,
   BinaryOperation: () => BinaryOperation,
+  BooleanAggregates: () => BooleanAggregates,
   BooleanConstantOperation: () => BooleanConstantOperation,
+  CaseOperation: () => CaseOperation,
   Column: () => Column,
   ColumnWithJoin: () => ColumnWithJoin,
+  Comparable: () => Comparable,
   ComparisonOperation: () => ComparisonOperation,
   ComparisonOperator: () => ComparisonOperator,
+  ConcatOperation: () => ConcatOperation,
   ConstantOperation: () => ConstantOperation,
   CountAllOperation: () => CountAllOperation,
+  DATE_ONLY_PATTERN: () => DATE_ONLY_PATTERN,
   DataCatalog: () => DataCatalog,
   DataStore: () => DataStore,
   Database: () => Database,
@@ -38,21 +47,28 @@ __export(relational_exports, {
   DateConstantOperation: () => DateConstantOperation,
   DateDiffOperation: () => DateDiffOperation,
   DateExtractOperation: () => DateExtractOperation,
+  DateOnly: () => DateOnly,
   DatePart: () => DatePart,
   DateTimeConstantOperation: () => DateTimeConstantOperation,
+  DateTruncOperation: () => DateTruncOperation,
   DecimalConstantOperation: () => DecimalConstantOperation,
   ExistsOperation: () => ExistsOperation,
   FloatConstantOperation: () => FloatConstantOperation,
   ForeignKey: () => ForeignKey,
+  InOperation: () => InOperation,
   IntegerConstantOperation: () => IntegerConstantOperation,
   IsNotNullOperation: () => IsNotNullOperation,
   IsNullOperation: () => IsNullOperation,
   JoinOperation: () => JoinOperation,
   JoinTreeNodeOperation: () => JoinTreeNodeOperation,
+  LIKE_ESCAPE: () => LIKE_ESCAPE,
   LogicalOperation: () => LogicalOperation,
   LogicalOperator: () => LogicalOperator,
+  NUMERIC_FUNCTIONS: () => NUMERIC_FUNCTIONS,
   NoOperation: () => NoOperation,
   NotExistsOperation: () => NotExistsOperation,
+  NotInOperation: () => NotInOperation,
+  NumericConstantOperation: () => NumericConstantOperation,
   Operation: () => Operation,
   RelationalOperationElement: () => RelationalOperationElement,
   ScalarFunction: () => ScalarFunction,
@@ -62,11 +78,20 @@ __export(relational_exports, {
   SortDirection: () => SortDirection,
   SortOperation: () => SortOperation,
   StringConstantOperation: () => StringConstantOperation,
+  StringPredicates: () => StringPredicates,
   Table: () => Table,
   UnaryOperation: () => UnaryOperation,
   WindowFunction: () => WindowFunction,
   WindowFunctionOperation: () => WindowFunctionOperation,
-  WindowSpecification: () => WindowSpecification
+  WindowSpecification: () => WindowSpecification,
+  applyMixins: () => applyMixins,
+  concat: () => concat,
+  containsAggregate: () => containsAggregate,
+  containsAggregateOrWindow: () => containsAggregateOrWindow,
+  escapeLike: () => escapeLike,
+  operandOf: () => operandOf,
+  sample: () => sample,
+  valueOperand: () => valueOperand
 });
 module.exports = __toCommonJS(relational_exports);
 var ComparisonOperator = /* @__PURE__ */ ((ComparisonOperator2) => {
@@ -80,6 +105,10 @@ var ComparisonOperator = /* @__PURE__ */ ((ComparisonOperator2) => {
   ComparisonOperator2["NOT_LIKE"] = "NOT_LIKE";
   return ComparisonOperator2;
 })(ComparisonOperator || {});
+var LIKE_ESCAPE = "!";
+function escapeLike(value) {
+  return value.replaceAll(LIKE_ESCAPE, LIKE_ESCAPE + LIKE_ESCAPE).replaceAll("%", LIKE_ESCAPE + "%").replaceAll("_", LIKE_ESCAPE + "_");
+}
 var LogicalOperator = /* @__PURE__ */ ((LogicalOperator2) => {
   LogicalOperator2["AND"] = "AND";
   LogicalOperator2["OR"] = "OR";
@@ -91,6 +120,14 @@ var AggregateOperator = /* @__PURE__ */ ((AggregateOperator2) => {
   AggregateOperator2["MIN"] = "MIN";
   AggregateOperator2["MAX"] = "MAX";
   AggregateOperator2["AVERAGE"] = "AVERAGE";
+  AggregateOperator2["STRING_AGG"] = "STRING_AGG";
+  AggregateOperator2["COUNT_DISTINCT"] = "COUNT_DISTINCT";
+  AggregateOperator2["STDDEV_SAMP"] = "STDDEV_SAMP";
+  AggregateOperator2["STDDEV_POP"] = "STDDEV_POP";
+  AggregateOperator2["VAR_SAMP"] = "VAR_SAMP";
+  AggregateOperator2["VAR_POP"] = "VAR_POP";
+  AggregateOperator2["BOOL_AND"] = "BOOL_AND";
+  AggregateOperator2["BOOL_OR"] = "BOOL_OR";
   return AggregateOperator2;
 })(AggregateOperator || {});
 var ScalarFunction = /* @__PURE__ */ ((ScalarFunction2) => {
@@ -113,6 +150,7 @@ var ScalarFunction = /* @__PURE__ */ ((ScalarFunction2) => {
   ScalarFunction2["REPEAT"] = "REPEAT";
   ScalarFunction2["REPLACE"] = "REPLACE";
   ScalarFunction2["SUBSTRING"] = "SUBSTRING";
+  ScalarFunction2["COALESCE"] = "COALESCE";
   return ScalarFunction2;
 })(ScalarFunction || {});
 var DatePart = /* @__PURE__ */ ((DatePart2) => {
@@ -135,25 +173,54 @@ var SortDirection = /* @__PURE__ */ ((SortDirection2) => {
 var RelationalOperationElement = class {
 };
 var Operation = class extends RelationalOperationElement {
-  andOp(other) {
+  /** Name this column in the result: `f.price().sum().alias('Total')`, `f.age().gt(30).alias('Adult')`. */
+  alias(name) {
+    return new Alias(this, name);
+  }
+  and(other) {
     return new LogicalOperation(this, "AND" /* AND */, other);
   }
+  /** Combine with `other` using OR. A chain reads left to right: `a.or(b).and(c)` is `(a OR b) AND c`. */
+  or(other) {
+    return new LogicalOperation(this, "OR" /* OR */, other);
+  }
 };
 var NoOperation = class extends Operation {
-  andOp(other) {
+  and(other) {
     return other;
   }
+  /** No filter matches every row, so OR-ing anything with it still matches every row. */
+  or(_other) {
+    return this;
+  }
 };
 var ConstantOperation = class extends RelationalOperationElement {
+  /** Name this column in the result. */
+  alias(name) {
+    return new Alias(this, name);
+  }
+  /** Sort by this expression, smallest first. */
+  ascending() {
+    return new SortOperation(this, "ASC" /* ASC */);
+  }
+  /** Sort by this expression, largest first. */
+  descending() {
+    return new SortOperation(this, "DESC" /* DESC */);
+  }
+};
+var NumericConstantOperation = class extends ConstantOperation {
+  arithmeticOperand() {
+    return this;
+  }
 };
-var IntegerConstantOperation = class extends ConstantOperation {
+var IntegerConstantOperation = class extends NumericConstantOperation {
   constructor(value) {
     super();
     this.value = value;
   }
   value;
 };
-var FloatConstantOperation = class extends ConstantOperation {
+var FloatConstantOperation = class extends NumericConstantOperation {
   constructor(value) {
     super();
     this.value = value;
@@ -167,6 +234,9 @@ var StringConstantOperation = class extends ConstantOperation {
   }
   value;
 };
+var DATE_ONLY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+var DateOnly = class extends Date {
+};
 var DateConstantOperation = class extends ConstantOperation {
   constructor(value) {
     super();
@@ -181,7 +251,7 @@ var DateTimeConstantOperation = class extends ConstantOperation {
   }
   value;
 };
-var DecimalConstantOperation = class extends ConstantOperation {
+var DecimalConstantOperation = class extends NumericConstantOperation {
   constructor(value) {
     super();
     this.value = value;
@@ -215,6 +285,20 @@ var IsNullOperation = class extends UnaryOperation {
 };
 var IsNotNullOperation = class extends UnaryOperation {
 };
+var InOperation = class extends UnaryOperation {
+  constructor(element, values) {
+    super(element);
+    this.values = values;
+  }
+  values;
+};
+var NotInOperation = class extends UnaryOperation {
+  constructor(element, values) {
+    super(element);
+    this.values = values;
+  }
+  values;
+};
 var ComparisonOperation = class extends BinaryOperation {
   constructor(left, operator, right) {
     super(left, right);
@@ -238,21 +322,41 @@ var WindowSpecification = class {
   orderBy;
 };
 var AggregateOperation = class _AggregateOperation extends UnaryOperation {
-  constructor(element, operator, displayName, window) {
+  constructor(element, operator, displayName, window, separator, orderBy = []) {
     super(element);
     this.operator = operator;
     this.displayName = displayName;
     this.window = window;
+    this.separator = separator;
+    this.orderBy = orderBy;
   }
   operator;
   displayName;
   window;
+  separator;
+  orderBy;
+  /** Sort by this expression, smallest first. */
+  ascending() {
+    return new SortOperation(this, "ASC" /* ASC */);
+  }
+  /** Sort by this expression, largest first. */
+  descending() {
+    return new SortOperation(this, "DESC" /* DESC */);
+  }
+  arithmeticOperand() {
+    return this;
+  }
+  comparisonOperand() {
+    return this;
+  }
   over(partitionBy, orderBy) {
     return new _AggregateOperation(
       this.element,
       this.operator,
       this.displayName,
-      new WindowSpecification(partitionBy ?? [], orderBy ?? [])
+      new WindowSpecification(partitionBy ?? [], orderBy ?? []),
+      this.separator,
+      this.orderBy
     );
   }
 };
@@ -283,6 +387,14 @@ var WindowFunctionOperation = class _WindowFunctionOperation extends UnaryOperat
   secondArg;
   extraArgs;
   window;
+  /** Sort by this expression, smallest first. */
+  ascending() {
+    return new SortOperation(this, "ASC" /* ASC */);
+  }
+  /** Sort by this expression, largest first. */
+  descending() {
+    return new SortOperation(this, "DESC" /* DESC */);
+  }
   over(partitionBy, orderBy) {
     return new _WindowFunctionOperation(
       this.element,
@@ -306,7 +418,38 @@ var ScalarFunctionOperation = class extends UnaryOperation {
   displayName;
   secondArg;
   extraArgs;
+  /** Sort by this expression, smallest first. */
+  ascending() {
+    return new SortOperation(this, "ASC" /* ASC */);
+  }
+  /** Sort by this expression, largest first. */
+  descending() {
+    return new SortOperation(this, "DESC" /* DESC */);
+  }
+  /** This expression as an operand of a comparison. */
+  comparisonOperand() {
+    return this;
+  }
+  arithmeticOperand() {
+    return this;
+  }
+  /** Only a function that gives a number can be used in arithmetic. */
+  assertNumeric() {
+    if (!NUMERIC_FUNCTIONS.has(this.func)) {
+      throw new TypeError(`${this.func} does not give a number, so it cannot be used in arithmetic`);
+    }
+  }
 };
+var NUMERIC_FUNCTIONS = /* @__PURE__ */ new Set([
+  "ABS" /* ABS */,
+  "CEILING" /* CEILING */,
+  "FLOOR" /* FLOOR */,
+  "MOD" /* MOD */,
+  "POWER" /* POWER */,
+  "SQRT" /* SQRT */,
+  "ROUND" /* ROUND */,
+  "LENGTH" /* LENGTH */
+]);
 var DateExtractOperation = class extends UnaryOperation {
   constructor(element, part, displayName) {
     super(element);
@@ -315,6 +458,34 @@ var DateExtractOperation = class extends UnaryOperation {
   }
   part;
   displayName;
+  /** Sort by this expression, smallest first. */
+  ascending() {
+    return new SortOperation(this, "ASC" /* ASC */);
+  }
+  /** Sort by this expression, largest first. */
+  descending() {
+    return new SortOperation(this, "DESC" /* DESC */);
+  }
+};
+var DateTruncOperation = class extends UnaryOperation {
+  constructor(element, part, displayName) {
+    super(element);
+    this.part = part;
+    this.displayName = displayName;
+  }
+  part;
+  displayName;
+  /** Sort by this expression, earliest first. */
+  ascending() {
+    return new SortOperation(this, "ASC" /* ASC */);
+  }
+  /** Sort by this expression, latest first. */
+  descending() {
+    return new SortOperation(this, "DESC" /* DESC */);
+  }
+  comparisonOperand() {
+    return this;
+  }
 };
 var DateArithmeticOperation = class extends UnaryOperation {
   constructor(element, n, unit, isAdd = true, displayName) {
@@ -328,6 +499,14 @@ var DateArithmeticOperation = class extends UnaryOperation {
   unit;
   isAdd;
   displayName;
+  /** Sort by this expression, smallest first. */
+  ascending() {
+    return new SortOperation(this, "ASC" /* ASC */);
+  }
+  /** Sort by this expression, largest first. */
+  descending() {
+    return new SortOperation(this, "DESC" /* DESC */);
+  }
 };
 var DateDiffOperation = class extends UnaryOperation {
   constructor(element, other, unit, displayName) {
@@ -339,20 +518,31 @@ var DateDiffOperation = class extends UnaryOperation {
   other;
   unit;
   displayName;
+  /** Sort by this expression, smallest first. */
+  ascending() {
+    return new SortOperation(this, "ASC" /* ASC */);
+  }
+  /** Sort by this expression, largest first. */
+  descending() {
+    return new SortOperation(this, "DESC" /* DESC */);
+  }
 };
 var Column = class extends RelationalOperationElement {
-  constructor(name, type, owner, primaryKey = false) {
+  constructor(name, type, owner, primaryKey = false, nullable = true) {
     super();
     this.name = name;
     this.type = type;
     this.owner = owner;
     this.primaryKey = primaryKey;
+    this.nullable = nullable && !primaryKey;
   }
   name;
   type;
   owner;
   primaryKey;
   table;
+  /** Whether the column may hold NULL. As in Legend, a primary key is never null. */
+  nullable;
 };
 var ForeignKey = class {
   constructor(column, references) {
@@ -442,27 +632,40 @@ var JoinOperation = class {
   filterColumnMap = {};
 };
 var JoinTreeNodeOperation = class {
-  constructor(join, parent) {
+  constructor(join, parent, many = false, optional = false) {
     this.join = join;
     this.parent = parent;
+    this.many = many;
+    this.optional = optional;
   }
   join;
   parent;
+  many;
+  optional;
 };
 var ColumnWithJoin = class extends RelationalOperationElement {
   /**
    * `embedded` is an alternate reference to a flat (denormalized) column on the owning table that
    * holds the same value without the join; the SQL generator uses it when the join can be elided.
    */
-  constructor(column, parent, embedded) {
+  constructor(column, parent, embedded, _optional = false) {
     super();
     this.column = column;
     this.parent = parent;
     this.embedded = embedded;
+    this._optional = _optional;
   }
   column;
   parent;
   embedded;
+  _optional;
+  /** Whether the value can be missing: its property is optional, or a navigation on the way to it is. */
+  get optional() {
+    for (let node = this.parent; node !== void 0; node = node.parent) {
+      if (node.optional) return true;
+    }
+    return this._optional;
+  }
 };
 var SortOperation = class {
   constructor(column, direction) {
@@ -478,8 +681,23 @@ var CountAllOperation = class extends RelationalOperationElement {
     this.table = table;
   }
   table;
+  /** Name this column in the result. */
+  alias(name) {
+    return new Alias(this, name);
+  }
+  /** Sort by this expression, smallest first. */
+  ascending() {
+    return new SortOperation(this, "ASC" /* ASC */);
+  }
+  /** Sort by this expression, largest first. */
+  descending() {
+    return new SortOperation(this, "DESC" /* DESC */);
+  }
+  comparisonOperand() {
+    return this;
+  }
 };
-var Alias = class extends RelationalOperationElement {
+var Alias = class _Alias extends RelationalOperationElement {
   constructor(element, name) {
     super();
     this.element = element;
@@ -487,6 +705,30 @@ var Alias = class extends RelationalOperationElement {
   }
   element;
   name;
+  alias(name) {
+    return new _Alias(this.element, name);
+  }
+  /** Sorts by the column the alias names. */
+  ascending() {
+    return new SortOperation(this.element, "ASC" /* ASC */);
+  }
+  /** Sorts by the column the alias names. */
+  descending() {
+    return new SortOperation(this.element, "DESC" /* DESC */);
+  }
+};
+var CaseOperation = class extends Operation {
+  constructor(condition, then, fallback, displayName) {
+    super();
+    this.condition = condition;
+    this.then = then;
+    this.fallback = fallback;
+    this.displayName = displayName;
+  }
+  condition;
+  then;
+  fallback;
+  displayName;
 };
 var ExistsOperation = class extends RelationalOperationElement {
   constructor(node) {
@@ -494,9 +736,16 @@ var ExistsOperation = class extends RelationalOperationElement {
     this.node = node;
   }
   node;
-  andOp(other) {
+  /** Name this column in the result. */
+  alias(name) {
+    return new Alias(this, name);
+  }
+  and(other) {
     return new LogicalOperation(this, "AND" /* AND */, other);
   }
+  or(other) {
+    return new LogicalOperation(this, "OR" /* OR */, other);
+  }
 };
 var NotExistsOperation = class extends RelationalOperationElement {
   constructor(node) {
@@ -504,12 +753,19 @@ var NotExistsOperation = class extends RelationalOperationElement {
     this.node = node;
   }
   node;
-  andOp(other) {
+  /** Name this column in the result. */
+  alias(name) {
+    return new Alias(this, name);
+  }
+  and(other) {
     return new LogicalOperation(this, "AND" /* AND */, other);
   }
+  or(other) {
+    return new LogicalOperation(this, "OR" /* OR */, other);
+  }
 };
 var SelectOperation = class {
-  constructor(display, filter, orderBy = [], groupBy = [], limit, table, joinFilters = /* @__PURE__ */ new Map()) {
+  constructor(display, filter, orderBy = [], groupBy = [], limit, table, joinFilters = /* @__PURE__ */ new Map(), distinct = false, offset, having) {
     this.display = display;
     this.filter = filter;
     this.orderBy = orderBy;
@@ -517,6 +773,9 @@ var SelectOperation = class {
     this.limit = limit;
     this.table = table;
     this.joinFilters = joinFilters;
+    this.distinct = distinct;
+    this.offset = offset;
+    this.having = having;
   }
   display;
   filter;
@@ -525,20 +784,276 @@ var SelectOperation = class {
   limit;
   table;
   joinFilters;
+  distinct;
+  offset;
+  having;
+};
+function containsAggregateOrWindow(op) {
+  if (op instanceof AggregateOperation || op instanceof WindowFunctionOperation || op instanceof CountAllOperation) return true;
+  if (op instanceof BinaryOperation) return containsAggregateOrWindow(op.left) || containsAggregateOrWindow(op.right);
+  if (op instanceof UnaryOperation || op instanceof Alias) return containsAggregateOrWindow(op.element);
+  return false;
+}
+function containsAggregate(op) {
+  if (op instanceof AggregateOperation || op instanceof CountAllOperation) return true;
+  if (op instanceof BinaryOperation) return containsAggregate(op.left) || containsAggregate(op.right);
+  if (op instanceof UnaryOperation || op instanceof Alias) return containsAggregate(op.element);
+  return false;
+}
+function valueOperand(value) {
+  if (typeof value === "boolean") return new BooleanConstantOperation(value);
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return Number.isInteger(value) ? new IntegerConstantOperation(value) : new FloatConstantOperation(value);
+  }
+  if (typeof value === "string") return new StringConstantOperation(value);
+  if (value instanceof DateOnly) return new DateConstantOperation(value);
+  if (value instanceof Date) return new DateTimeConstantOperation(value);
+  throw new TypeError(`A value to compare with is a boolean, a finite number, a string or a date, not ${value === null ? "null" : typeof value}`);
+}
+function operandOf(other) {
+  if (other instanceof RelationalOperationElement) return other;
+  if (typeof other?.cwj === "function") return other.cwj();
+  return valueOperand(other);
+}
+var Comparable = class {
+  _compared(operator, other) {
+    return new ComparisonOperation(this.comparisonOperand(), operator, operandOf(other));
+  }
+  /** Filter to rows where this expression equals `other`. */
+  eq(other) {
+    return this._compared("EQUAL" /* EQUAL */, other);
+  }
+  /** Filter to rows where this expression does not equal `other`. */
+  ne(other) {
+    return this._compared("NOT_EQUAL" /* NOT_EQUAL */, other);
+  }
+  /** Filter to rows where this expression is less than `other`. */
+  lt(other) {
+    return this._compared("LESS_THAN" /* LESS_THAN */, other);
+  }
+  /** Filter to rows where this expression is at most `other`. */
+  lte(other) {
+    return this._compared("LESS_THAN_OR_EQUAL_TO" /* LESS_THAN_OR_EQUAL_TO */, other);
+  }
+  /** Filter to rows where this expression is greater than `other`. */
+  gt(other) {
+    return this._compared("GREATER_THAN" /* GREATER_THAN */, other);
+  }
+  /** Filter to rows where this expression is at least `other`. */
+  gte(other) {
+    return this._compared("GREATER_THAN_OR_EQUAL_TO" /* GREATER_THAN_OR_EQUAL_TO */, other);
+  }
+};
+function sample(ddof) {
+  if (ddof !== 0 && ddof !== 1) throw new RangeError(`ddof is 0 (population) or 1 (sample), not ${ddof}`);
+  return ddof === 1;
+}
+var StringPredicates = class {
+  _like(pattern) {
+    return new ComparisonOperation(this.comparisonOperand(), "LIKE" /* LIKE */, new StringConstantOperation(pattern));
+  }
+  /** Filter to rows where this text contains `value`. */
+  contains(value) {
+    return this._like(`%${escapeLike(value)}%`);
+  }
+  /** Filter to rows where this text starts with `prefix`. */
+  startsWith(prefix) {
+    return this._like(`${escapeLike(prefix)}%`);
+  }
+  /** Filter to rows where this text ends with `suffix`. */
+  endsWith(suffix) {
+    return this._like(`%${escapeLike(suffix)}`);
+  }
+};
+var Aggregates = class {
+  _aggregate(operator, label) {
+    return new AggregateOperation(this, operator, label + " Expression");
+  }
+  /** Sum of the values in the group. */
+  sum() {
+    return this._aggregate("SUM" /* SUM */, "Sum");
+  }
+  /** Smallest value in the group. */
+  min() {
+    return this._aggregate("MIN" /* MIN */, "Min");
+  }
+  /** Largest value in the group. */
+  max() {
+    return this._aggregate("MAX" /* MAX */, "Max");
+  }
+  /** Arithmetic mean of the values in the group. */
+  average() {
+    return this._aggregate("AVERAGE" /* AVERAGE */, "Average");
+  }
+  /** Number of non-null values in the group. */
+  count() {
+    return this._aggregate("COUNT" /* COUNT */, "Count");
+  }
+  /** Standard deviation of the values in the group: the sample one by default, `ddof = 0` for the population one. */
+  std(ddof = 1) {
+    return this._aggregate(sample(ddof) ? "STDDEV_SAMP" /* STDDEV_SAMP */ : "STDDEV_POP" /* STDDEV_POP */, "Std");
+  }
+  /** Variance of the values in the group: the sample one by default, `ddof = 0` for the population one. */
+  var(ddof = 1) {
+    return this._aggregate(sample(ddof) ? "VAR_SAMP" /* VAR_SAMP */ : "VAR_POP" /* VAR_POP */, "Var");
+  }
+};
+var BooleanAggregates = class {
+  /** True for a group where every row satisfies the condition. */
+  all() {
+    return new AggregateOperation(this, "BOOL_AND" /* BOOL_AND */, "All Expression");
+  }
+  /** True for a group where at least one row satisfies the condition. */
+  any() {
+    return new AggregateOperation(this, "BOOL_OR" /* BOOL_OR */, "Any Expression");
+  }
+};
+function applyMixins(derived, bases) {
+  for (const base of bases) {
+    for (const name of Object.getOwnPropertyNames(base.prototype)) {
+      if (name === "constructor" || Object.prototype.hasOwnProperty.call(derived.prototype, name)) continue;
+      Object.defineProperty(derived.prototype, name, Object.getOwnPropertyDescriptor(base.prototype, name));
+    }
+  }
+}
+var ArithmeticOperator = /* @__PURE__ */ ((ArithmeticOperator2) => {
+  ArithmeticOperator2["ADD"] = "+";
+  ArithmeticOperator2["SUBTRACT"] = "-";
+  ArithmeticOperator2["MULTIPLY"] = "*";
+  ArithmeticOperator2["DIVIDE"] = "/";
+  return ArithmeticOperator2;
+})(ArithmeticOperator || {});
+var Arithmetic = class {
+  /** Raises if this expression is not a number. */
+  assertNumeric() {
+  }
+  _arithmetic(operator, other) {
+    this.assertNumeric();
+    let operand;
+    if (typeof other === "number") {
+      if (!Number.isFinite(other)) throw new TypeError("Arithmetic is between numbers and numeric columns, not a non-finite number");
+      operand = valueOperand(other);
+    } else if (other !== null && typeof other === "object" && typeof other.arithmeticOperand === "function") {
+      other.assertNumeric?.();
+      operand = other.arithmeticOperand();
+    } else {
+      throw new TypeError(`Arithmetic is between numbers and numeric columns, not ${other === null ? "null" : typeof other}`);
+    }
+    return new ArithmeticOperation(this.arithmeticOperand(), operator, operand);
+  }
+  /** `this + other`. */
+  plus(other) {
+    return this._arithmetic("+" /* ADD */, other);
+  }
+  /** `this - other`. */
+  minus(other) {
+    return this._arithmetic("-" /* SUBTRACT */, other);
+  }
+  /** `this * other`. */
+  times(other) {
+    return this._arithmetic("*" /* MULTIPLY */, other);
+  }
+  /** `this / other`. */
+  dividedBy(other) {
+    return this._arithmetic("/" /* DIVIDE */, other);
+  }
+};
+var ArithmeticOperation = class extends BinaryOperation {
+  constructor(left, operator, right, displayName) {
+    super(left, right);
+    this.operator = operator;
+    this.displayName = displayName;
+  }
+  operator;
+  displayName;
+  /** Sort by this expression, smallest first. */
+  ascending() {
+    return new SortOperation(this, "ASC" /* ASC */);
+  }
+  /** Sort by this expression, largest first. */
+  descending() {
+    return new SortOperation(this, "DESC" /* DESC */);
+  }
+  arithmeticOperand() {
+    return this;
+  }
+  comparisonOperand() {
+    return this;
+  }
+};
+var ConcatOperation = class extends Operation {
+  constructor(parts, displayName) {
+    super();
+    this.parts = parts;
+    this.displayName = displayName;
+  }
+  parts;
+  displayName;
+  /** Join more text on the end: `f.first().concat(' ', f.last())`. A concatenation joins into one. */
+  concat(...more) {
+    return concat(this, ...more);
+  }
+  /** Sort by this expression, smallest first. */
+  ascending() {
+    return new SortOperation(this, "ASC" /* ASC */);
+  }
+  /** Sort by this expression, largest first. */
+  descending() {
+    return new SortOperation(this, "DESC" /* DESC */);
+  }
+  comparisonOperand() {
+    return this;
+  }
 };
+function concat(...parts) {
+  const partsOf = (part) => {
+    if (part instanceof ConcatOperation) return part.parts;
+    if (typeof part === "string") return [new StringConstantOperation(part)];
+    if (part instanceof RelationalOperationElement) return [part];
+    if (part !== null && typeof part === "object" && typeof part.functionInput === "function") return [part.functionInput()];
+    throw new TypeError(`Text is joined with text, not ${part === null ? "null" : typeof part}`);
+  };
+  return new ConcatOperation(parts.flatMap(partsOf));
+}
+applyMixins(ConcatOperation, [Comparable, StringPredicates]);
+applyMixins(DateTruncOperation, [Comparable]);
+applyMixins(ArithmeticOperation, [Arithmetic, Comparable]);
+applyMixins(ScalarFunctionOperation, [Comparable, Arithmetic, StringPredicates]);
+applyMixins(AggregateOperation, [Arithmetic, Comparable, StringPredicates]);
+applyMixins(CountAllOperation, [Comparable]);
+applyMixins(NumericConstantOperation, [Arithmetic]);
+applyMixins(ConstantOperation, [Aggregates]);
+applyMixins(ArithmeticOperation, [Aggregates]);
+applyMixins(ScalarFunctionOperation, [Aggregates]);
+applyMixins(CaseOperation, [Aggregates]);
+applyMixins(IsNullOperation, [BooleanAggregates]);
+applyMixins(IsNotNullOperation, [BooleanAggregates]);
+applyMixins(InOperation, [BooleanAggregates]);
+applyMixins(NotInOperation, [BooleanAggregates]);
+applyMixins(ComparisonOperation, [BooleanAggregates]);
+applyMixins(LogicalOperation, [BooleanAggregates]);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AggregateOperation,
   AggregateOperator,
+  Aggregates,
   Alias,
+  Arithmetic,
+  ArithmeticOperation,
+  ArithmeticOperator,
   BinaryOperation,
+  BooleanAggregates,
   BooleanConstantOperation,
+  CaseOperation,
   Column,
   ColumnWithJoin,
+  Comparable,
   ComparisonOperation,
   ComparisonOperator,
+  ConcatOperation,
   ConstantOperation,
   CountAllOperation,
+  DATE_ONLY_PATTERN,
   DataCatalog,
   DataStore,
   Database,
@@ -546,21 +1061,28 @@ var SelectOperation = class {
   DateConstantOperation,
   DateDiffOperation,
   DateExtractOperation,
+  DateOnly,
   DatePart,
   DateTimeConstantOperation,
+  DateTruncOperation,
   DecimalConstantOperation,
   ExistsOperation,
   FloatConstantOperation,
   ForeignKey,
+  InOperation,
   IntegerConstantOperation,
   IsNotNullOperation,
   IsNullOperation,
   JoinOperation,
   JoinTreeNodeOperation,
+  LIKE_ESCAPE,
   LogicalOperation,
   LogicalOperator,
+  NUMERIC_FUNCTIONS,
   NoOperation,
   NotExistsOperation,
+  NotInOperation,
+  NumericConstantOperation,
   Operation,
   RelationalOperationElement,
   ScalarFunction,
@@ -570,10 +1092,19 @@ var SelectOperation = class {
   SortDirection,
   SortOperation,
   StringConstantOperation,
+  StringPredicates,
   Table,
   UnaryOperation,
   WindowFunction,
   WindowFunctionOperation,
-  WindowSpecification
+  WindowSpecification,
+  applyMixins,
+  concat,
+  containsAggregate,
+  containsAggregateOrWindow,
+  escapeLike,
+  operandOf,
+  sample,
+  valueOperand
 });
 //# sourceMappingURL=relational.cjs.map