data-finder-ts 0.1.0 → 0.1.4

package/dist/datafinder/sql-generator.cjs

@@ -0,0 +1,1467 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/datafinder/sql-generator.ts
+var sql_generator_exports = {};
+__export(sql_generator_exports, {
+  buildQueryOperation: () => buildQueryOperation,
+  selectSqlToString: () => selectSqlToString,
+  toSql: () => toSql
+});
+module.exports = __toCommonJS(sql_generator_exports);
+
+// src/model/relational.ts
+var RelationalOperationElement = class {
+};
+var Operation = class extends RelationalOperationElement {
+  andOp(other) {
+    return new LogicalOperation(this, "AND" /* AND */, other);
+  }
+};
+var NoOperation = class extends Operation {
+  andOp(other) {
+    return other;
+  }
+};
+var ConstantOperation = class extends RelationalOperationElement {
+};
+var IntegerConstantOperation = class extends ConstantOperation {
+  constructor(value) {
+    super();
+    this.value = value;
+  }
+  value;
+};
+var FloatConstantOperation = class extends ConstantOperation {
+  constructor(value) {
+    super();
+    this.value = value;
+  }
+  value;
+};
+var StringConstantOperation = class extends ConstantOperation {
+  constructor(value) {
+    super();
+    this.value = value;
+  }
+  value;
+};
+var DateConstantOperation = class extends ConstantOperation {
+  constructor(value) {
+    super();
+    this.value = value;
+  }
+  value;
+};
+var DateTimeConstantOperation = class extends ConstantOperation {
+  constructor(value) {
+    super();
+    this.value = value;
+  }
+  value;
+};
+var DecimalConstantOperation = class extends ConstantOperation {
+  constructor(value) {
+    super();
+    this.value = value;
+  }
+  value;
+};
+var BooleanConstantOperation = class extends ConstantOperation {
+  constructor(value) {
+    super();
+    this.value = value;
+  }
+  value;
+};
+var UnaryOperation = class extends Operation {
+  constructor(element) {
+    super();
+    this.element = element;
+  }
+  element;
+};
+var BinaryOperation = class extends Operation {
+  constructor(left, right) {
+    super();
+    this.left = left;
+    this.right = right;
+  }
+  left;
+  right;
+};
+var IsNullOperation = class extends UnaryOperation {
+};
+var IsNotNullOperation = class extends UnaryOperation {
+};
+var ComparisonOperation = class extends BinaryOperation {
+  constructor(left, operator, right) {
+    super(left, right);
+    this.operator = operator;
+  }
+  operator;
+};
+var LogicalOperation = class extends BinaryOperation {
+  constructor(left, operator, right) {
+    super(left, right);
+    this.operator = operator;
+  }
+  operator;
+};
+var WindowSpecification = class {
+  constructor(partitionBy = [], orderBy = []) {
+    this.partitionBy = partitionBy;
+    this.orderBy = orderBy;
+  }
+  partitionBy;
+  orderBy;
+};
+var AggregateOperation = class _AggregateOperation extends UnaryOperation {
+  constructor(element, operator, displayName, window) {
+    super(element);
+    this.operator = operator;
+    this.displayName = displayName;
+    this.window = window;
+  }
+  operator;
+  displayName;
+  window;
+  over(partitionBy, orderBy) {
+    return new _AggregateOperation(
+      this.element,
+      this.operator,
+      this.displayName,
+      new WindowSpecification(partitionBy ?? [], orderBy ?? [])
+    );
+  }
+};
+var WindowFunctionOperation = class _WindowFunctionOperation extends UnaryOperation {
+  constructor(element, func, displayName, secondArg, extraArgs = [], window) {
+    super(element);
+    this.func = func;
+    this.displayName = displayName;
+    this.secondArg = secondArg;
+    this.extraArgs = extraArgs;
+    this.window = window;
+  }
+  func;
+  displayName;
+  secondArg;
+  extraArgs;
+  window;
+  over(partitionBy, orderBy) {
+    return new _WindowFunctionOperation(
+      this.element,
+      this.func,
+      this.displayName,
+      this.secondArg,
+      [...this.extraArgs],
+      new WindowSpecification(partitionBy ?? [], orderBy ?? [])
+    );
+  }
+};
+var ScalarFunctionOperation = class extends UnaryOperation {
+  constructor(element, func, displayName, secondArg, extraArgs = []) {
+    super(element);
+    this.func = func;
+    this.displayName = displayName;
+    this.secondArg = secondArg;
+    this.extraArgs = extraArgs;
+  }
+  func;
+  displayName;
+  secondArg;
+  extraArgs;
+};
+var DateExtractOperation = class extends UnaryOperation {
+  constructor(element, part, displayName) {
+    super(element);
+    this.part = part;
+    this.displayName = displayName;
+  }
+  part;
+  displayName;
+};
+var DateArithmeticOperation = class extends UnaryOperation {
+  constructor(element, n, unit, isAdd = true, displayName) {
+    super(element);
+    this.n = n;
+    this.unit = unit;
+    this.isAdd = isAdd;
+    this.displayName = displayName;
+  }
+  n;
+  unit;
+  isAdd;
+  displayName;
+};
+var DateDiffOperation = class extends UnaryOperation {
+  constructor(element, other, unit, displayName) {
+    super(element);
+    this.other = other;
+    this.unit = unit;
+    this.displayName = displayName;
+  }
+  other;
+  unit;
+  displayName;
+};
+var Column = class extends RelationalOperationElement {
+  constructor(name, type, owner, primaryKey = false) {
+    super();
+    this.name = name;
+    this.type = type;
+    this.owner = owner;
+    this.primaryKey = primaryKey;
+  }
+  name;
+  type;
+  owner;
+  primaryKey;
+  table;
+};
+var Table = class {
+  constructor(name, columns, schema) {
+    this.name = name;
+    this.schema = schema;
+    for (const col of columns) {
+      if (this._columnsByName.has(col.name)) {
+        throw new Error(`Duplicate column name '${col.name}' in table '${name}'`);
+      }
+      this._columnsByName.set(col.name, col);
+      col.table = this;
+    }
+    schema?.tables.push(this);
+  }
+  name;
+  schema;
+  _columnsByName = /* @__PURE__ */ new Map();
+  foreignKeys = [];
+  get columns() {
+    return Array.from(this._columnsByName.values());
+  }
+  get qualifiedName() {
+    if (!this.schema) return this.name;
+    if (!this.schema.datastore) return `${this.schema.name}.${this.name}`;
+    return `${this.schema.datastore.namespace(this.schema.name)}.${this.name}`;
+  }
+};
+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) {
+    super();
+    this.column = column;
+    this.parent = parent;
+    this.embedded = embedded;
+  }
+  column;
+  parent;
+  embedded;
+};
+var SortOperation = class {
+  constructor(column, direction) {
+    this.column = column;
+    this.direction = direction;
+  }
+  column;
+  direction;
+};
+var CountAllOperation = class extends RelationalOperationElement {
+  constructor(table) {
+    super();
+    this.table = table;
+  }
+  table;
+};
+var Alias = class extends RelationalOperationElement {
+  constructor(element, name) {
+    super();
+    this.element = element;
+    this.name = name;
+  }
+  element;
+  name;
+};
+var ExistsOperation = class extends RelationalOperationElement {
+  constructor(node) {
+    super();
+    this.node = node;
+  }
+  node;
+  andOp(other) {
+    return new LogicalOperation(this, "AND" /* AND */, other);
+  }
+};
+var NotExistsOperation = class extends RelationalOperationElement {
+  constructor(node) {
+    super();
+    this.node = node;
+  }
+  node;
+  andOp(other) {
+    return new LogicalOperation(this, "AND" /* AND */, other);
+  }
+};
+var SelectOperation = class {
+  constructor(display, filter, orderBy = [], groupBy = [], limit, table, joinFilters = /* @__PURE__ */ new Map()) {
+    this.display = display;
+    this.filter = filter;
+    this.orderBy = orderBy;
+    this.groupBy = groupBy;
+    this.limit = limit;
+    this.table = table;
+    this.joinFilters = joinFilters;
+  }
+  display;
+  filter;
+  orderBy;
+  groupBy;
+  limit;
+  table;
+  joinFilters;
+};
+
+// src/datafinder/attribute.ts
+var Attribute = class _Attribute {
+  _displayName;
+  _column;
+  _owner;
+  _parent;
+  _embedded;
+  constructor(displayName, columnName, columnDbType, owner, parent, embedded) {
+    this._displayName = displayName;
+    this._column = new Column(columnName, columnDbType, owner);
+    this._owner = owner;
+    this._parent = parent;
+    this._embedded = embedded;
+  }
+  column() {
+    return this._column;
+  }
+  owner() {
+    return this._owner;
+  }
+  parent() {
+    return this._parent;
+  }
+  displayName() {
+    return this._displayName;
+  }
+  /** Alternate attribute on a flat column of the owning table, used in place of this one when its join is elided. */
+  embedded() {
+    return this._embedded;
+  }
+  cwj() {
+    return new ColumnWithJoin(this._column, this._parent, this._embedded?.cwj());
+  }
+  /** Count the number of non-null values. Use in a projection with `groupByOp` to aggregate per group. */
+  count() {
+    return new AggregateOperation(
+      this.cwj(),
+      "COUNT" /* COUNT */,
+      this._displayName + " Count"
+    );
+  }
+  /** Sort this attribute in ascending order. Pass to `orderByOp` or a window function's `orderBy`. */
+  ascending() {
+    return new SortOperation(this.cwj(), "ASC" /* ASC */);
+  }
+  /** Sort this attribute in descending order. Pass to `orderByOp` or a window function's `orderBy`. */
+  descending() {
+    return new SortOperation(this.cwj(), "DESC" /* DESC */);
+  }
+  /** Filter to rows where this attribute has no value. */
+  isNull() {
+    return new IsNullOperation(this.cwj());
+  }
+  /** Filter to rows where this attribute has a value. */
+  isNotNull() {
+    return new IsNotNullOperation(this.cwj());
+  }
+  _windowSpec(partitionBy, orderBy) {
+    const pbArr = partitionBy === void 0 ? [] : Array.isArray(partitionBy) ? partitionBy : [partitionBy];
+    const pb = pbArr.map((x) => x instanceof _Attribute ? x.cwj() : x);
+    const ob = orderBy === void 0 ? [] : Array.isArray(orderBy) ? orderBy : [orderBy];
+    return new WindowSpecification(pb, ob);
+  }
+  /**
+   * Assign a rank to each row within the ordered window, following pandas `Series.rank` conventions.
+   *
+   * `method` controls tie-breaking (default `'min'`):
+   * - `'min'`   — tied rows share the lowest rank; the next rank skips.
+   * - `'dense'` — like `'min'` but ranks are contiguous (no gaps).
+   * - `'first'` — each row gets a unique sequential integer (no ties).
+   * - `'max'`   — only meaningful with `pct: true` (see below).
+   *
+   * When `pct: true` the result is a relative rank between 0 and 1:
+   * - `method: 'min'` (default) → fraction of values strictly below this row (PERCENT_RANK).
+   * - `method: 'max'` → fraction of values at or below this row (cumulative distribution).
+   *
+   * `partitionBy` restarts the ranking within each group of distinct values.
+   */
+  rank(opts = {}) {
+    const { method = "min", pct = false, partitionBy, orderBy } = opts;
+    let func;
+    let name;
+    if (pct) {
+      if (method === "max") {
+        func = "CUME_DIST" /* CUME_DIST */;
+        name = "Cume Dist";
+      } else {
+        func = "PERCENT_RANK" /* PERCENT_RANK */;
+        name = "Percent Rank";
+      }
+    } else if (method === "first") {
+      func = "ROW_NUMBER" /* ROW_NUMBER */;
+      name = "Row Number";
+    } else if (method === "dense") {
+      func = "DENSE_RANK" /* DENSE_RANK */;
+      name = "Dense Rank";
+    } else {
+      func = "RANK" /* RANK */;
+      name = "Rank";
+    }
+    return new WindowFunctionOperation(null, func, name, void 0, [], this._windowSpec(partitionBy, orderBy));
+  }
+  /**
+   * Split rows into `buckets` equal-sized quantile bins ordered by `orderBy`.
+   * Each row receives a bucket number from 1 (lowest) to `buckets` (highest).
+   * Named after `pandas.qcut`.
+   */
+  qcut(buckets, opts = {}) {
+    return new WindowFunctionOperation(
+      null,
+      "NTILE" /* NTILE */,
+      "Quantile",
+      buckets,
+      [],
+      this._windowSpec(opts.partitionBy, opts.orderBy)
+    );
+  }
+  /**
+   * Return the value of this attribute from `periods` rows earlier (positive) or later (negative)
+   * within the ordered window, following `pandas.Series.shift`.
+   * Rows with no neighbour at the given offset return `null` (or `fillValue` if provided).
+   */
+  shift(periods = 1, opts = {}) {
+    const extraArgs = opts.fillValue !== void 0 ? [opts.fillValue] : [];
+    const func = periods >= 0 ? "LAG" /* LAG */ : "LEAD" /* LEAD */;
+    const label = periods >= 0 ? "Lag" : "Lead";
+    return new WindowFunctionOperation(
+      this.cwj(),
+      func,
+      label + " " + this._displayName,
+      Math.abs(periods),
+      extraArgs,
+      this._windowSpec(opts.partitionBy, opts.orderBy)
+    );
+  }
+  /**
+   * Return the first value of this attribute in the window frame.
+   * Use `partitionBy` to restart the frame for each group.
+   */
+  first(opts = {}) {
+    return new WindowFunctionOperation(
+      this.cwj(),
+      "FIRST_VALUE" /* FIRST_VALUE */,
+      "First " + this._displayName,
+      void 0,
+      [],
+      this._windowSpec(opts.partitionBy, opts.orderBy)
+    );
+  }
+  /**
+   * Return the last value of this attribute in the window frame.
+   * Use `partitionBy` to restart the frame for each group.
+   */
+  last(opts = {}) {
+    return new WindowFunctionOperation(
+      this.cwj(),
+      "LAST_VALUE" /* LAST_VALUE */,
+      "Last " + this._displayName,
+      void 0,
+      [],
+      this._windowSpec(opts.partitionBy, opts.orderBy)
+    );
+  }
+};
+
+// src/model/milestoning.ts
+var MilestoningColumns = class {
+};
+var ProcessingTemporalColumns = class extends MilestoningColumns {
+  constructor(startAtColumn, endAtColumn, infiniteDatetime) {
+    super();
+    this.startAtColumn = startAtColumn;
+    this.endAtColumn = endAtColumn;
+    this.infiniteDatetime = infiniteDatetime;
+  }
+  startAtColumn;
+  endAtColumn;
+  infiniteDatetime;
+  columns() {
+    return [this.startAtColumn, this.endAtColumn];
+  }
+};
+var SingleBusinessDateColumn = class extends MilestoningColumns {
+  constructor(businessDateColumn) {
+    super();
+    this.businessDateColumn = businessDateColumn;
+  }
+  businessDateColumn;
+  columns() {
+    return [this.businessDateColumn];
+  }
+};
+var BusinessDateAndProcessingTemporalColumns = class extends MilestoningColumns {
+  constructor(businessDateColumn, startAtColumn, endAtColumn, infiniteDatetime) {
+    super();
+    this.businessDateColumn = businessDateColumn;
+    this.startAtColumn = startAtColumn;
+    this.endAtColumn = endAtColumn;
+    this.infiniteDatetime = infiniteDatetime;
+  }
+  businessDateColumn;
+  startAtColumn;
+  endAtColumn;
+  infiniteDatetime;
+  columns() {
+    return [this.businessDateColumn, this.startAtColumn, this.endAtColumn];
+  }
+};
+var BiTemporalColumns = class extends MilestoningColumns {
+  constructor(businessDateFromColumn, businessDateToColumn, startAtColumn, endAtColumn, infiniteDatetime) {
+    super();
+    this.businessDateFromColumn = businessDateFromColumn;
+    this.businessDateToColumn = businessDateToColumn;
+    this.startAtColumn = startAtColumn;
+    this.endAtColumn = endAtColumn;
+    this.infiniteDatetime = infiniteDatetime;
+  }
+  businessDateFromColumn;
+  businessDateToColumn;
+  startAtColumn;
+  endAtColumn;
+  infiniteDatetime;
+  columns() {
+    return [
+      this.businessDateFromColumn,
+      this.businessDateToColumn,
+      this.startAtColumn,
+      this.endAtColumn
+    ];
+  }
+};
+var MilestonedTable = class extends Table {
+  constructor(name, columns, milestoningColumns, schema) {
+    super(name, columns, schema);
+    this.milestoningColumns = milestoningColumns;
+    for (const col of milestoningColumns.columns()) {
+      col.table = this;
+    }
+  }
+  milestoningColumns;
+};
+
+// src/datafinder/typed-attributes.ts
+function parseDate(value) {
+  if (value instanceof Date) return value;
+  const d = new Date(value);
+  if (isNaN(d.getTime())) throw new Error(`Cannot parse date: ${value}`);
+  return d;
+}
+var DateAttribute = class extends Attribute {
+  constructor(displayName, columnName, columnDbType, owner, parent, embedded) {
+    super(displayName, columnName, columnDbType, owner, parent, embedded);
+  }
+  /** Filter to rows where this date equals `value`. */
+  eq(value) {
+    return new ComparisonOperation(this.cwj(), "EQUAL" /* EQUAL */, new DateConstantOperation(parseDate(value)));
+  }
+  /** Filter to rows where this date does not equal `value`. */
+  ne(value) {
+    return new ComparisonOperation(this.cwj(), "NOT_EQUAL" /* NOT_EQUAL */, new DateConstantOperation(parseDate(value)));
+  }
+  /** Filter to rows where this date is after `value`. */
+  gt(value) {
+    return new ComparisonOperation(this.cwj(), "GREATER_THAN" /* GREATER_THAN */, new DateConstantOperation(parseDate(value)));
+  }
+  /** Filter to rows where this date is before `value`. */
+  lt(value) {
+    return new ComparisonOperation(this.cwj(), "LESS_THAN" /* LESS_THAN */, new DateConstantOperation(parseDate(value)));
+  }
+  /** Filter to rows where this date is on or after `value`. */
+  gte(value) {
+    return new ComparisonOperation(this.cwj(), "GREATER_THAN_OR_EQUAL_TO" /* GREATER_THAN_OR_EQUAL_TO */, new DateConstantOperation(parseDate(value)));
+  }
+  /** Filter to rows where this date is on or before `value`. */
+  lte(value) {
+    return new ComparisonOperation(this.cwj(), "LESS_THAN_OR_EQUAL_TO" /* LESS_THAN_OR_EQUAL_TO */, new DateConstantOperation(parseDate(value)));
+  }
+  /** Extract the four-digit calendar year. */
+  year() {
+    return new DateExtractOperation(this.cwj(), "YEAR" /* YEAR */, "Year " + this.displayName());
+  }
+  /** Extract the month number (1–12). */
+  month() {
+    return new DateExtractOperation(this.cwj(), "MONTH" /* MONTH */, "Month " + this.displayName());
+  }
+  /** Extract the day of the month (1–31). */
+  day() {
+    return new DateExtractOperation(this.cwj(), "DAY" /* DAY */, "Day " + this.displayName());
+  }
+  /** Extract the quarter (1–4). */
+  quarter() {
+    return new DateExtractOperation(this.cwj(), "QUARTER" /* QUARTER */, "Quarter " + this.displayName());
+  }
+  /** Extract the ISO week number (1–53). */
+  week() {
+    return new DateExtractOperation(this.cwj(), "WEEK" /* WEEK */, "Week " + this.displayName());
+  }
+  /** Extract the day of the week (0 = Sunday through 6 = Saturday). */
+  dayOfWeek() {
+    return new DateExtractOperation(this.cwj(), "DOW" /* DOW */, "Day Of Week " + this.displayName());
+  }
+  /** Add `n` days to this date. */
+  addDays(n) {
+    return new DateArithmeticOperation(this.cwj(), n, "DAY" /* DAY */, true, "Add Days " + this.displayName());
+  }
+  /** Add `n` months to this date. */
+  addMonths(n) {
+    return new DateArithmeticOperation(this.cwj(), n, "MONTH" /* MONTH */, true, "Add Months " + this.displayName());
+  }
+  /** Add `n` years to this date. */
+  addYears(n) {
+    return new DateArithmeticOperation(this.cwj(), n, "YEAR" /* YEAR */, true, "Add Years " + this.displayName());
+  }
+  /** Subtract `n` days from this date. */
+  subtractDays(n) {
+    return new DateArithmeticOperation(this.cwj(), n, "DAY" /* DAY */, false, "Subtract Days " + this.displayName());
+  }
+  /** Subtract `n` months from this date. */
+  subtractMonths(n) {
+    return new DateArithmeticOperation(this.cwj(), n, "MONTH" /* MONTH */, false, "Subtract Months " + this.displayName());
+  }
+  /** Subtract `n` years from this date. */
+  subtractYears(n) {
+    return new DateArithmeticOperation(this.cwj(), n, "YEAR" /* YEAR */, false, "Subtract Years " + this.displayName());
+  }
+  /** Number of whole days between this date and `other`. */
+  diffDays(other) {
+    return new DateDiffOperation(this.cwj(), other, "DAY" /* DAY */, "Diff Days " + this.displayName());
+  }
+  /** Number of whole months between this date and `other`. */
+  diffMonths(other) {
+    return new DateDiffOperation(this.cwj(), other, "MONTH" /* MONTH */, "Diff Months " + this.displayName());
+  }
+  /** Number of whole years between this date and `other`. */
+  diffYears(other) {
+    return new DateDiffOperation(this.cwj(), other, "YEAR" /* YEAR */, "Diff Years " + this.displayName());
+  }
+};
+var DateTimeAttribute = class extends Attribute {
+  constructor(displayName, columnName, columnDbType, owner, parent, embedded) {
+    super(displayName, columnName, columnDbType, owner, parent, embedded);
+  }
+  /** Filter to rows where this timestamp equals `value`. */
+  eq(value) {
+    return new ComparisonOperation(this.cwj(), "EQUAL" /* EQUAL */, new DateTimeConstantOperation(parseDate(value)));
+  }
+  /** Filter to rows where this timestamp does not equal `value`. */
+  ne(value) {
+    return new ComparisonOperation(this.cwj(), "NOT_EQUAL" /* NOT_EQUAL */, new DateTimeConstantOperation(parseDate(value)));
+  }
+  /** Filter to rows where this timestamp is after `value`. */
+  gt(value) {
+    return new ComparisonOperation(this.cwj(), "GREATER_THAN" /* GREATER_THAN */, new DateTimeConstantOperation(parseDate(value)));
+  }
+  /** Filter to rows where this timestamp is before `value`. */
+  lt(value) {
+    return new ComparisonOperation(this.cwj(), "LESS_THAN" /* LESS_THAN */, new DateTimeConstantOperation(parseDate(value)));
+  }
+  /** Filter to rows where this timestamp is on or after `value`. */
+  gte(value) {
+    return new ComparisonOperation(this.cwj(), "GREATER_THAN_OR_EQUAL_TO" /* GREATER_THAN_OR_EQUAL_TO */, new DateTimeConstantOperation(parseDate(value)));
+  }
+  /** Filter to rows where this timestamp is on or before `value`. */
+  lte(value) {
+    return new ComparisonOperation(this.cwj(), "LESS_THAN_OR_EQUAL_TO" /* LESS_THAN_OR_EQUAL_TO */, new DateTimeConstantOperation(parseDate(value)));
+  }
+  /** Extract the four-digit calendar year. */
+  year() {
+    return new DateExtractOperation(this.cwj(), "YEAR" /* YEAR */, "Year " + this.displayName());
+  }
+  /** Extract the month number (1–12). */
+  month() {
+    return new DateExtractOperation(this.cwj(), "MONTH" /* MONTH */, "Month " + this.displayName());
+  }
+  /** Extract the day of the month (1–31). */
+  day() {
+    return new DateExtractOperation(this.cwj(), "DAY" /* DAY */, "Day " + this.displayName());
+  }
+  /** Extract the hour (0–23). */
+  hour() {
+    return new DateExtractOperation(this.cwj(), "HOUR" /* HOUR */, "Hour " + this.displayName());
+  }
+  /** Extract the minute (0–59). */
+  minute() {
+    return new DateExtractOperation(this.cwj(), "MINUTE" /* MINUTE */, "Minute " + this.displayName());
+  }
+  /** Extract the second (0–59). */
+  second() {
+    return new DateExtractOperation(this.cwj(), "SECOND" /* SECOND */, "Second " + this.displayName());
+  }
+  /** Extract the quarter (1–4). */
+  quarter() {
+    return new DateExtractOperation(this.cwj(), "QUARTER" /* QUARTER */, "Quarter " + this.displayName());
+  }
+  /** Extract the ISO week number (1–53). */
+  week() {
+    return new DateExtractOperation(this.cwj(), "WEEK" /* WEEK */, "Week " + this.displayName());
+  }
+  /** Extract the day of the week (0 = Sunday through 6 = Saturday). */
+  dayOfWeek() {
+    return new DateExtractOperation(this.cwj(), "DOW" /* DOW */, "Day Of Week " + this.displayName());
+  }
+  /** Add `n` days to this timestamp. */
+  addDays(n) {
+    return new DateArithmeticOperation(this.cwj(), n, "DAY" /* DAY */, true, "Add Days " + this.displayName());
+  }
+  /** Add `n` months to this timestamp. */
+  addMonths(n) {
+    return new DateArithmeticOperation(this.cwj(), n, "MONTH" /* MONTH */, true, "Add Months " + this.displayName());
+  }
+  /** Add `n` years to this timestamp. */
+  addYears(n) {
+    return new DateArithmeticOperation(this.cwj(), n, "YEAR" /* YEAR */, true, "Add Years " + this.displayName());
+  }
+  /** Add `n` hours to this timestamp. */
+  addHours(n) {
+    return new DateArithmeticOperation(this.cwj(), n, "HOUR" /* HOUR */, true, "Add Hours " + this.displayName());
+  }
+  /** Add `n` minutes to this timestamp. */
+  addMinutes(n) {
+    return new DateArithmeticOperation(this.cwj(), n, "MINUTE" /* MINUTE */, true, "Add Minutes " + this.displayName());
+  }
+  /** Add `n` seconds to this timestamp. */
+  addSeconds(n) {
+    return new DateArithmeticOperation(this.cwj(), n, "SECOND" /* SECOND */, true, "Add Seconds " + this.displayName());
+  }
+  /** Subtract `n` days from this timestamp. */
+  subtractDays(n) {
+    return new DateArithmeticOperation(this.cwj(), n, "DAY" /* DAY */, false, "Subtract Days " + this.displayName());
+  }
+  /** Subtract `n` months from this timestamp. */
+  subtractMonths(n) {
+    return new DateArithmeticOperation(this.cwj(), n, "MONTH" /* MONTH */, false, "Subtract Months " + this.displayName());
+  }
+  /** Subtract `n` years from this timestamp. */
+  subtractYears(n) {
+    return new DateArithmeticOperation(this.cwj(), n, "YEAR" /* YEAR */, false, "Subtract Years " + this.displayName());
+  }
+  /** Subtract `n` hours from this timestamp. */
+  subtractHours(n) {
+    return new DateArithmeticOperation(this.cwj(), n, "HOUR" /* HOUR */, false, "Subtract Hours " + this.displayName());
+  }
+  /** Subtract `n` minutes from this timestamp. */
+  subtractMinutes(n) {
+    return new DateArithmeticOperation(this.cwj(), n, "MINUTE" /* MINUTE */, false, "Subtract Minutes " + this.displayName());
+  }
+  /** Subtract `n` seconds from this timestamp. */
+  subtractSeconds(n) {
+    return new DateArithmeticOperation(this.cwj(), n, "SECOND" /* SECOND */, false, "Subtract Seconds " + this.displayName());
+  }
+  /** Number of whole days between this timestamp and `other`. */
+  diffDays(other) {
+    return new DateDiffOperation(this.cwj(), other, "DAY" /* DAY */, "Diff Days " + this.displayName());
+  }
+  /** Number of whole months between this timestamp and `other`. */
+  diffMonths(other) {
+    return new DateDiffOperation(this.cwj(), other, "MONTH" /* MONTH */, "Diff Months " + this.displayName());
+  }
+  /** Number of whole years between this timestamp and `other`. */
+  diffYears(other) {
+    return new DateDiffOperation(this.cwj(), other, "YEAR" /* YEAR */, "Diff Years " + this.displayName());
+  }
+  /** Number of whole hours between this timestamp and `other`. */
+  diffHours(other) {
+    return new DateDiffOperation(this.cwj(), other, "HOUR" /* HOUR */, "Diff Hours " + this.displayName());
+  }
+  /** Number of whole minutes between this timestamp and `other`. */
+  diffMinutes(other) {
+    return new DateDiffOperation(this.cwj(), other, "MINUTE" /* MINUTE */, "Diff Minutes " + this.displayName());
+  }
+  /** Number of whole seconds between this timestamp and `other`. */
+  diffSeconds(other) {
+    return new DateDiffOperation(this.cwj(), other, "SECOND" /* SECOND */, "Diff Seconds " + this.displayName());
+  }
+};
+
+// src/datafinder/sql-generator.ts
+var TableAlias = class {
+  constructor(table, alias) {
+    this.table = table;
+    this.alias = alias;
+  }
+  table;
+  alias;
+};
+var TableAliasColumn = class extends RelationalOperationElement {
+  constructor(column, tableAlias) {
+    super();
+    this.column = column;
+    this.tableAlias = tableAlias;
+  }
+  column;
+  tableAlias;
+};
+var Join = class {
+  constructor(source, target, filterOp) {
+    this.source = source;
+    this.target = target;
+    this.filterOp = filterOp;
+  }
+  source;
+  target;
+  filterOp;
+};
+function sqlFormatDatetime(value) {
+  const pad = (n, w = 2) => String(n).padStart(w, "0");
+  return `'${value.getUTCFullYear()}-${pad(value.getUTCMonth() + 1)}-${pad(value.getUTCDate())} ${pad(value.getUTCHours())}:${pad(value.getUTCMinutes())}:${pad(value.getUTCSeconds())}'`;
+}
+function sqlFormatDate(value) {
+  const pad = (n) => String(n).padStart(2, "0");
+  return `'${value.getUTCFullYear()}-${pad(value.getUTCMonth() + 1)}-${pad(value.getUTCDate())}'`;
+}
+var LOGICAL_OPERATOR_STR = {
+  ["AND" /* AND */]: " AND ",
+  ["OR" /* OR */]: " OR "
+};
+var COMPARISON_OPERATOR_STR = {
+  ["EQUAL" /* EQUAL */]: " = ",
+  ["NOT_EQUAL" /* NOT_EQUAL */]: " <> ",
+  ["LESS_THAN" /* LESS_THAN */]: " < ",
+  ["GREATER_THAN" /* GREATER_THAN */]: " > ",
+  ["LESS_THAN_OR_EQUAL_TO" /* LESS_THAN_OR_EQUAL_TO */]: " <= ",
+  ["GREATER_THAN_OR_EQUAL_TO" /* GREATER_THAN_OR_EQUAL_TO */]: " >= ",
+  ["LIKE" /* LIKE */]: " LIKE ",
+  ["NOT_LIKE" /* NOT_LIKE */]: " NOT LIKE "
+};
+var AGGREGATE_SQL_NAMES = {
+  ["AVERAGE" /* AVERAGE */]: "AVG"
+};
+var WINDOW_SQL_NAMES = {
+  ["ROW_NUMBER" /* ROW_NUMBER */]: "ROW_NUMBER",
+  ["RANK" /* RANK */]: "RANK",
+  ["DENSE_RANK" /* DENSE_RANK */]: "DENSE_RANK",
+  ["NTILE" /* NTILE */]: "NTILE",
+  ["LAG" /* LAG */]: "LAG",
+  ["LEAD" /* LEAD */]: "LEAD",
+  ["FIRST_VALUE" /* FIRST_VALUE */]: "FIRST_VALUE",
+  ["LAST_VALUE" /* LAST_VALUE */]: "LAST_VALUE",
+  ["CUME_DIST" /* CUME_DIST */]: "CUME_DIST",
+  ["PERCENT_RANK" /* PERCENT_RANK */]: "PERCENT_RANK"
+};
+var SCALAR_SQL_NAMES = {
+  ["ABS" /* ABS */]: "ABS",
+  ["CEILING" /* CEILING */]: "CEILING",
+  ["FLOOR" /* FLOOR */]: "FLOOR",
+  ["MOD" /* MOD */]: "MOD",
+  ["POWER" /* POWER */]: "POWER",
+  ["SQRT" /* SQRT */]: "SQRT",
+  ["ROUND" /* ROUND */]: "ROUND",
+  ["UPPER" /* UPPER */]: "UPPER",
+  ["LOWER" /* LOWER */]: "LOWER",
+  ["TRIM" /* TRIM */]: "TRIM",
+  ["LTRIM" /* LTRIM */]: "LTRIM",
+  ["RTRIM" /* RTRIM */]: "RTRIM",
+  ["LENGTH" /* LENGTH */]: "LENGTH",
+  ["REVERSE" /* REVERSE */]: "REVERSE",
+  ["LEFT" /* LEFT */]: "LEFT",
+  ["RIGHT" /* RIGHT */]: "RIGHT",
+  ["REPEAT" /* REPEAT */]: "REPEAT",
+  ["REPLACE" /* REPLACE */]: "REPLACE",
+  ["SUBSTRING" /* SUBSTRING */]: "SUBSTRING"
+};
+function constantValueString(op) {
+  if (op instanceof StringConstantOperation) return "'" + op.value + "'";
+  if (op instanceof DateConstantOperation) return sqlFormatDate(op.value);
+  if (op instanceof DateTimeConstantOperation) return sqlFormatDatetime(op.value);
+  if (op instanceof IntegerConstantOperation) return String(op.value);
+  if (op instanceof FloatConstantOperation) return String(op.value);
+  if (op instanceof BooleanConstantOperation) return op.value ? "TRUE" : "FALSE";
+  if (op instanceof DecimalConstantOperation) return String(op.value);
+  throw new Error("Unknown constant operation");
+}
+function windowSpecToString(window) {
+  const parts = [];
+  if (window.partitionBy.length > 0) {
+    parts.push("PARTITION BY " + window.partitionBy.map((p) => sqlOperationToString(p)).join(", "));
+  }
+  if (window.orderBy.length > 0) {
+    parts.push("ORDER BY " + window.orderBy.map(
+      (s) => sqlOperationToString(s.column) + (s.direction === "ASC" /* ASC */ ? " ASC" : " DESC")
+    ).join(", "));
+  }
+  return "OVER (" + parts.join(" ") + ")";
+}
+function sqlOperationToString(operation) {
+  if (operation instanceof TableAliasColumn) {
+    return operation.tableAlias.alias + "." + operation.column.name;
+  }
+  if (operation instanceof WindowFunctionOperation) {
+    const fn = WINDOW_SQL_NAMES[operation.func];
+    const parts = [];
+    if (operation.element !== null && operation.element !== void 0) {
+      parts.push(sqlOperationToString(operation.element));
+    }
+    if (operation.secondArg !== void 0) parts.push(String(operation.secondArg));
+    for (const arg of operation.extraArgs) {
+      parts.push(typeof arg === "string" ? "'" + arg + "'" : String(arg));
+    }
+    const sql = fn + "(" + parts.join(", ") + ")";
+    return sql + (operation.window !== void 0 ? " " + windowSpecToString(operation.window) : " OVER ()");
+  }
+  if (operation instanceof AggregateOperation) {
+    const fn = AGGREGATE_SQL_NAMES[operation.operator] ?? operation.operator;
+    let sql = fn + "(" + sqlOperationToString(operation.element) + ")";
+    if (operation.window !== void 0) {
+      sql += " " + windowSpecToString(operation.window);
+    }
+    return sql;
+  }
+  if (operation instanceof ScalarFunctionOperation) {
+    const fn = SCALAR_SQL_NAMES[operation.func];
+    const parts = [sqlOperationToString(operation.element)];
+    if (operation.secondArg !== void 0) parts.push(String(operation.secondArg));
+    for (const arg of operation.extraArgs) {
+      parts.push(typeof arg === "string" ? "'" + arg + "'" : String(arg));
+    }
+    return fn + "(" + parts.join(", ") + ")";
+  }
+  if (operation instanceof DateExtractOperation) {
+    return "EXTRACT(" + operation.part + " FROM " + sqlOperationToString(operation.element) + ")";
+  }
+  if (operation instanceof DateArithmeticOperation) {
+    const op = operation.isAdd ? "+" : "-";
+    return sqlOperationToString(operation.element) + " " + op + " INTERVAL " + operation.n + " " + operation.unit;
+  }
+  if (operation instanceof DateDiffOperation) {
+    const otherSql = sqlFormatDatetime(operation.other);
+    return "DATE_DIFF('" + operation.unit.toLowerCase() + "', " + sqlOperationToString(operation.element) + ", " + otherSql + ")";
+  }
+  if (operation instanceof CountAllOperation) return "COUNT(*)";
+  if (operation instanceof Alias) {
+    return sqlOperationToString(operation.element) + ' AS "' + operation.name + '"';
+  }
+  throw new TypeError("Unknown operation in sqlOperationToString: " + operation.constructor.name);
+}
+function embeddedOf(ref) {
+  return ref instanceof Attribute ? ref.embedded() : ref.embedded;
+}
+function findColumn(operation) {
+  if (operation instanceof UnaryOperation) return findColumn(operation.element);
+  if (operation instanceof ColumnWithJoin) return operation;
+  throw new TypeError("Cannot find ColumnWithJoin in: " + operation.constructor.name);
+}
+function openEndClause(endAttr, value, infiniteDatetime) {
+  const gtOp = endAttr instanceof DateTimeAttribute ? endAttr.gt(value) : endAttr.gt(value);
+  if (infiniteDatetime === void 0) {
+    const colRef = new ColumnWithJoin(endAttr.column(), endAttr.parent());
+    return new LogicalOperation(gtOp, "OR" /* OR */, new IsNullOperation(colRef));
+  }
+  return gtOp;
+}
+function buildMilestoningFilterOperation(businessDate, processingDatetime, table, joinNode) {
+  const mc = table.milestoningColumns;
+  const ops = [];
+  if (mc instanceof BiTemporalColumns) {
+    if (businessDate !== null) {
+      const dateFrom = new DateAttribute("business_date_from", mc.businessDateFromColumn.name, mc.businessDateFromColumn.type, mc.businessDateFromColumn.table.qualifiedName, joinNode);
+      const dateTo = new DateAttribute("business_date_to", mc.businessDateToColumn.name, mc.businessDateToColumn.type, mc.businessDateToColumn.table.qualifiedName, joinNode);
+      ops.push(new LogicalOperation(dateFrom.lte(businessDate), "AND" /* AND */, openEndClause(dateTo, businessDate, mc.infiniteDatetime)));
+    }
+    if (processingDatetime !== null) {
+      const startAt = new DateTimeAttribute("start_at", mc.startAtColumn.name, mc.startAtColumn.type, mc.startAtColumn.table.qualifiedName, joinNode);
+      const endAt = new DateTimeAttribute("end_at", mc.endAtColumn.name, mc.endAtColumn.type, mc.endAtColumn.table.qualifiedName, joinNode);
+      ops.push(new LogicalOperation(startAt.lte(processingDatetime), "AND" /* AND */, openEndClause(endAt, processingDatetime, mc.infiniteDatetime)));
+    }
+  } else if (mc instanceof BusinessDateAndProcessingTemporalColumns) {
+    if (businessDate !== null) {
+      const businessAtt = new DateAttribute("business_date", mc.businessDateColumn.name, mc.businessDateColumn.type, mc.businessDateColumn.table.qualifiedName, joinNode);
+      ops.push(businessAtt.eq(businessDate));
+    }
+    if (processingDatetime !== null) {
+      const startAt = new DateTimeAttribute("start_at", mc.startAtColumn.name, mc.startAtColumn.type, mc.startAtColumn.table.qualifiedName, joinNode);
+      const endAt = new DateTimeAttribute("end_at", mc.endAtColumn.name, mc.endAtColumn.type, mc.endAtColumn.table.qualifiedName, joinNode);
+      ops.push(new LogicalOperation(startAt.lte(processingDatetime), "AND" /* AND */, openEndClause(endAt, processingDatetime, mc.infiniteDatetime)));
+    }
+  } else if (mc instanceof ProcessingTemporalColumns && processingDatetime !== null) {
+    const startAt = new DateTimeAttribute("start_at", mc.startAtColumn.name, mc.startAtColumn.type, mc.startAtColumn.table.qualifiedName, joinNode);
+    const endAt = new DateTimeAttribute("end_at", mc.endAtColumn.name, mc.endAtColumn.type, mc.endAtColumn.table.qualifiedName, joinNode);
+    ops.push(new LogicalOperation(startAt.lte(processingDatetime), "AND" /* AND */, openEndClause(endAt, processingDatetime, mc.infiniteDatetime)));
+  } else if (mc instanceof SingleBusinessDateColumn && businessDate !== null) {
+    const businessAtt = new DateAttribute("business_date", mc.businessDateColumn.name, mc.businessDateColumn.type, mc.businessDateColumn.table.qualifiedName, joinNode);
+    ops.push(businessAtt.eq(businessDate));
+  }
+  if (ops.length === 0) return null;
+  if (ops.length === 1) return ops[0];
+  return new LogicalOperation(ops[0], "AND" /* AND */, ops[1]);
+}
+function buildMilestoningFilterOperationForDateRange(businessDateFrom, businessDateTo, processingDatetime, table, joinNode) {
+  const mc = table.milestoningColumns;
+  const ops = [];
+  const hasRange = businessDateFrom !== null && businessDateTo !== null;
+  const processingOp = (m) => {
+    const startAt = new DateTimeAttribute("start_at", m.startAtColumn.name, m.startAtColumn.type, m.startAtColumn.table.qualifiedName, joinNode);
+    const endAt = new DateTimeAttribute("end_at", m.endAtColumn.name, m.endAtColumn.type, m.endAtColumn.table.qualifiedName, joinNode);
+    return new LogicalOperation(startAt.lte(processingDatetime), "AND" /* AND */, openEndClause(endAt, processingDatetime, m.infiniteDatetime));
+  };
+  if (mc instanceof BiTemporalColumns) {
+    if (hasRange) {
+      const dateFrom = new DateAttribute("business_date_from", mc.businessDateFromColumn.name, mc.businessDateFromColumn.type, mc.businessDateFromColumn.table.qualifiedName, joinNode);
+      const dateTo = new DateAttribute("business_date_to", mc.businessDateToColumn.name, mc.businessDateToColumn.type, mc.businessDateToColumn.table.qualifiedName, joinNode);
+      ops.push(new LogicalOperation(dateFrom.lte(businessDateTo), "AND" /* AND */, openEndClause(dateTo, businessDateFrom, mc.infiniteDatetime)));
+    }
+    if (processingDatetime !== null) ops.push(processingOp(mc));
+  } else if (mc instanceof BusinessDateAndProcessingTemporalColumns) {
+    if (hasRange) {
+      const businessAtt = new DateAttribute("business_date", mc.businessDateColumn.name, mc.businessDateColumn.type, mc.businessDateColumn.table.qualifiedName, joinNode);
+      ops.push(new LogicalOperation(businessAtt.gte(businessDateFrom), "AND" /* AND */, businessAtt.lte(businessDateTo)));
+    }
+    if (processingDatetime !== null) ops.push(processingOp(mc));
+  } else if (mc instanceof ProcessingTemporalColumns) {
+    if (processingDatetime !== null) ops.push(processingOp(mc));
+  } else if (mc instanceof SingleBusinessDateColumn && hasRange) {
+    const businessAtt = new DateAttribute("business_date", mc.businessDateColumn.name, mc.businessDateColumn.type, mc.businessDateColumn.table.qualifiedName, joinNode);
+    ops.push(new LogicalOperation(businessAtt.gte(businessDateFrom), "AND" /* AND */, businessAtt.lte(businessDateTo)));
+  }
+  if (ops.length === 0) return null;
+  if (ops.length === 1) return ops[0];
+  return new LogicalOperation(ops[0], "AND" /* AND */, ops[1]);
+}
+function walkRefs(op, visit, visitExists) {
+  if (op === null || op === void 0) return;
+  if (op instanceof Attribute || op instanceof ColumnWithJoin) {
+    visit(op);
+  } else if (op instanceof ExistsOperation || op instanceof NotExistsOperation) {
+    visitExists?.(op.node);
+  } else if (op instanceof AggregateOperation) {
+    walkRefs(op.element, visit, visitExists);
+    if (op.window) walkWindowSpec(op.window, visit, visitExists);
+  } else if (op instanceof WindowFunctionOperation) {
+    if (op.element) walkRefs(op.element, visit, visitExists);
+    if (op.window) walkWindowSpec(op.window, visit, visitExists);
+  } else if (op instanceof ScalarFunctionOperation || op instanceof DateExtractOperation || op instanceof DateArithmeticOperation || op instanceof DateDiffOperation || op instanceof IsNullOperation || op instanceof IsNotNullOperation) {
+    walkRefs(op.element, visit, visitExists);
+  } else if (op instanceof SortOperation) {
+    walkRefs(op.column, visit, visitExists);
+  } else if (op instanceof LogicalOperation || op instanceof ComparisonOperation) {
+    walkRefs(op.left, visit, visitExists);
+    walkRefs(op.right, visit, visitExists);
+  }
+}
+function walkWindowSpec(window, visit, visitExists) {
+  for (const p of window.partitionBy) walkRefs(p, visit, visitExists);
+  for (const s of window.orderBy) walkRefs(s.column, visit, visitExists);
+}
+function buildJoinFilterFromProperties(node, filter, columnMap) {
+  const ops = [];
+  for (const [key, value] of Object.entries(filter)) {
+    const entry = columnMap[key];
+    if (entry === void 0) {
+      throw new Error(`Unknown property '${key}' \u2014 valid properties are: ${Object.keys(columnMap).sort().join(", ")}`);
+    }
+    const [name, type, table] = entry;
+    const col = new ColumnWithJoin(new Column(name, type, table), node);
+    let constant;
+    if (typeof value === "boolean") constant = new BooleanConstantOperation(value);
+    else if (typeof value === "number") constant = Number.isInteger(value) ? new IntegerConstantOperation(value) : new FloatConstantOperation(value);
+    else if (value instanceof Date) constant = type.toUpperCase() === "DATE" ? new DateConstantOperation(value) : new DateTimeConstantOperation(value);
+    else constant = new StringConstantOperation(String(value));
+    ops.push(new ComparisonOperation(col, "EQUAL" /* EQUAL */, constant));
+  }
+  return ops.reduce((acc, op) => new LogicalOperation(acc, "AND" /* AND */, op));
+}
+function withAncestors(nodes) {
+  const ordered = /* @__PURE__ */ new Set();
+  const add = (node) => {
+    if (ordered.has(node)) return;
+    if (node.parent !== void 0) add(node.parent);
+    ordered.add(node);
+  };
+  for (const node of nodes) add(node);
+  return [...ordered];
+}
+function buildQueryOperation(businessDate, processingDatetime, columns, table, op, orderBy = [], groupBy = [], limit, businessDateTo = null) {
+  let filter = op;
+  const milestoningFor = (t, node) => businessDateTo !== null ? buildMilestoningFilterOperationForDateRange(businessDate, businessDateTo, processingDatetime, t, node) : buildMilestoningFilterOperation(businessDate, processingDatetime, t, node);
+  if (table instanceof MilestonedTable) {
+    const milestonedOp = milestoningFor(table);
+    if (milestonedOp !== null) {
+      filter = filter instanceof NoOperation ? milestonedOp : new LogicalOperation(filter, "AND" /* AND */, milestonedOp);
+    }
+  }
+  const requiredJoins = /* @__PURE__ */ new Set();
+  const collect = (ref) => {
+    const parent = ref instanceof Attribute ? ref.parent() : ref.parent;
+    if (parent !== void 0) requiredJoins.add(parent);
+  };
+  const collectNode = (node) => requiredJoins.add(node);
+  for (const col of columns) walkRefs(col, collect, collectNode);
+  for (const expr of groupBy) walkRefs(expr, collect, collectNode);
+  for (const sort of orderBy) walkRefs(sort, collect, collectNode);
+  walkRefs(op, collect, collectNode);
+  const joinFilters = /* @__PURE__ */ new Map();
+  for (const node of withAncestors(requiredJoins)) {
+    let combined;
+    if (Object.keys(node.join.filterKwargs).length > 0) {
+      combined = buildJoinFilterFromProperties(node, node.join.filterKwargs, node.join.filterColumnMap);
+    }
+    if (node.join.target instanceof MilestonedTable) {
+      const milestonedOp = milestoningFor(node.join.target, node);
+      if (milestonedOp !== null) {
+        combined = combined === void 0 ? milestonedOp : new LogicalOperation(combined, "AND" /* AND */, milestonedOp);
+      }
+    }
+    if (combined !== void 0) joinFilters.set(node, combined);
+  }
+  return new SelectOperation(columns, filter, orderBy, groupBy, limit, table, joinFilters);
+}
+var SQLQueryGenerator = class {
+  _select = [];
+  _from = /* @__PURE__ */ new Set();
+  _join = [];
+  _groupByParts = [];
+  _orderByParts = [];
+  _where = "";
+  _limit;
+  _tableAliasIncr = 0;
+  _tableAliasesByTable = /* @__PURE__ */ new Map();
+  _addedJoinIds = /* @__PURE__ */ new Set();
+  _rootTable;
+  _elidableNodes = /* @__PURE__ */ new Set();
+  _joinFilters = /* @__PURE__ */ new Map();
+  generate(select) {
+    this._rootTable = select.table;
+    this._elidableNodes = this._computeElidableNodes(select);
+    this._joinFilters = select.joinFilters;
+    if (this._rootTable !== void 0) {
+      this._from.add(this._tableAliasForTable(this._rootTable.qualifiedName, this._rootTable.qualifiedName));
+    }
+    this.processSelect(select.display);
+    this._where = this.buildFilter(select.filter);
+    const groupByJoins = /* @__PURE__ */ new Map();
+    for (const expr of select.groupBy) {
+      this._collectRequiredJoins(expr, groupByJoins);
+    }
+    for (const node of groupByJoins.values()) {
+      this._addJoin(node);
+    }
+    this._groupByParts = select.groupBy.map((a) => this._attrToColString(a));
+    this._orderByParts = select.orderBy.map(
+      (s) => this.buildFilter(s.column) + (s.direction === "ASC" /* ASC */ ? " ASC" : " DESC")
+    );
+    this._limit = select.limit;
+  }
+  _attrToColString(attr) {
+    const { column, parent } = this._resolve(attr);
+    const ta = this._tableAliasForTable(column.owner, parent ?? column.owner);
+    return ta.alias + "." + column.name;
+  }
+  _collectRequiredJoins(op, out) {
+    walkRefs(op, (ref) => {
+      const { parent } = this._resolve(ref);
+      if (parent !== void 0) out.set(parent, parent);
+    });
+  }
+  /**
+   * Determine upfront which join nodes can be satisfied entirely by embedded (join-less) alternates:
+   * a node is elidable when every reference to it has an embedded alternate. A reference without one
+   * (e.g. a milestoning column) keeps the join for every reference to that node.
+   */
+  _computeElidableNodes(select) {
+    const refsByNode = /* @__PURE__ */ new Map();
+    const record = (ref) => {
+      const parent = ref instanceof Attribute ? ref.parent() : ref.parent;
+      if (parent === void 0) return;
+      const refs = refsByNode.get(parent);
+      if (refs) refs.push(ref);
+      else refsByNode.set(parent, [ref]);
+    };
+    for (const col of select.display) walkRefs(col, record);
+    for (const expr of select.groupBy) walkRefs(expr, record);
+    for (const sort of select.orderBy) walkRefs(sort, record);
+    walkRefs(select.filter, record);
+    const elidable = /* @__PURE__ */ new Set();
+    for (const [node, refs] of refsByNode) {
+      if (refs.every((ref) => embeddedOf(ref) !== void 0)) elidable.add(node);
+    }
+    return elidable;
+  }
+  /** The (column, parent) a reference should resolve to, substituting its embedded alternate when its join is elided. */
+  _resolve(ref) {
+    const column = ref instanceof Attribute ? ref.column() : ref.column;
+    const parent = ref instanceof Attribute ? ref.parent() : ref.parent;
+    if (parent !== void 0 && this._elidableNodes.has(parent)) {
+      const embedded = embeddedOf(ref);
+      if (embedded !== void 0) return this._resolve(embedded);
+    }
+    return { column, parent };
+  }
+  _rewriteWindowSpec(window) {
+    const partitionBy = window.partitionBy.map((p) => this._rewriteOperation(p));
+    const orderBy = window.orderBy.map((s) => new SortOperation(this._rewriteOperation(s.column), s.direction));
+    return new WindowSpecification(partitionBy, orderBy);
+  }
+  _rewriteOperation(op) {
+    if (op instanceof Attribute || op instanceof ColumnWithJoin) {
+      const { column, parent } = this._resolve(op);
+      return new TableAliasColumn(column, this._tableAliasForTable(column.owner, parent ?? column.owner));
+    }
+    if (op instanceof Column) {
+      const ta = this._tableAliasForTable(op.owner, op.owner);
+      return new TableAliasColumn(op, ta);
+    }
+    if (op instanceof AggregateOperation) {
+      return new AggregateOperation(
+        this._rewriteOperation(op.element),
+        op.operator,
+        op.displayName,
+        op.window ? this._rewriteWindowSpec(op.window) : void 0
+      );
+    }
+    if (op instanceof WindowFunctionOperation) {
+      const el = op.element ? this._rewriteOperation(op.element) : null;
+      return new WindowFunctionOperation(
+        el,
+        op.func,
+        op.displayName,
+        op.secondArg,
+        [...op.extraArgs],
+        op.window ? this._rewriteWindowSpec(op.window) : void 0
+      );
+    }
+    if (op instanceof ScalarFunctionOperation) {
+      return new ScalarFunctionOperation(this._rewriteOperation(op.element), op.func, op.displayName, op.secondArg, op.extraArgs);
+    }
+    if (op instanceof DateExtractOperation) {
+      return new DateExtractOperation(this._rewriteOperation(op.element), op.part, op.displayName);
+    }
+    if (op instanceof DateArithmeticOperation) {
+      return new DateArithmeticOperation(this._rewriteOperation(op.element), op.n, op.unit, op.isAdd, op.displayName);
+    }
+    if (op instanceof DateDiffOperation) {
+      return new DateDiffOperation(this._rewriteOperation(op.element), op.other, op.unit, op.displayName);
+    }
+    return op;
+  }
+  processSelect(cols) {
+    const requiredJoins = /* @__PURE__ */ new Map();
+    for (const col of cols) {
+      this._collectRequiredJoins(col, requiredJoins);
+    }
+    for (const node of requiredJoins.values()) {
+      this._addJoin(node);
+    }
+    for (const col of cols) {
+      if (col instanceof Attribute) {
+        const { column, parent: node } = this._resolve(col);
+        let ta;
+        if (node !== void 0) {
+          ta = this._tableAliasForTable(column.owner, node);
+        } else {
+          ta = this._tableAliasForTable(column.owner, column.owner);
+          this._from.add(ta);
+        }
+        this._select.push(new Alias(new TableAliasColumn(column, ta), col.displayName()));
+      } else if (col instanceof WindowFunctionOperation) {
+        const rewritten = this._rewriteOperation(col);
+        let alias;
+        if (col.displayName) {
+          alias = col.displayName;
+        } else if (["ROW_NUMBER" /* ROW_NUMBER */, "RANK" /* RANK */, "DENSE_RANK" /* DENSE_RANK */].includes(col.func)) {
+          alias = col.func.replace(/_/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+        } else if (col.element) {
+          alias = col.func + " " + findColumn(col).column.name;
+        } else {
+          alias = col.func;
+        }
+        this._select.push(new Alias(rewritten, alias));
+      } else if (col instanceof AggregateOperation) {
+        const colNested = this._resolve(findColumn(col));
+        const node = colNested.parent;
+        let ta;
+        if (node !== void 0) {
+          ta = this._tableAliasForTable(colNested.column.owner, node);
+        } else {
+          ta = this._tableAliasForTable(colNested.column.owner, colNested.column.owner);
+          this._from.add(ta);
+        }
+        const alias = col.displayName ?? col.operator + " " + findColumn(col).column.name;
+        const rewrittenAgg = new AggregateOperation(
+          new TableAliasColumn(colNested.column, ta),
+          col.operator,
+          void 0,
+          col.window ? this._rewriteWindowSpec(col.window) : void 0
+        );
+        this._select.push(new Alias(rewrittenAgg, alias));
+      } else if (col instanceof ScalarFunctionOperation) {
+        const colNested = this._resolve(findColumn(col));
+        const node = colNested.parent;
+        let ta;
+        if (node !== void 0) {
+          ta = this._tableAliasForTable(colNested.column.owner, node);
+        } else {
+          ta = this._tableAliasForTable(colNested.column.owner, colNested.column.owner);
+          this._from.add(ta);
+        }
+        const alias = col.displayName ?? col.func + " " + findColumn(col).column.name;
+        this._select.push(new Alias(
+          new ScalarFunctionOperation(new TableAliasColumn(colNested.column, ta), col.func, void 0, col.secondArg, col.extraArgs),
+          alias
+        ));
+      } else if (col instanceof DateExtractOperation || col instanceof DateArithmeticOperation || col instanceof DateDiffOperation) {
+        const colNested = this._resolve(findColumn(col));
+        const node = colNested.parent;
+        let ta;
+        if (node !== void 0) {
+          ta = this._tableAliasForTable(colNested.column.owner, node);
+        } else {
+          ta = this._tableAliasForTable(colNested.column.owner, colNested.column.owner);
+          this._from.add(ta);
+        }
+        const alias = col.displayName ?? findColumn(col).column.name;
+        let aliasedOp;
+        if (col instanceof DateExtractOperation) {
+          aliasedOp = new DateExtractOperation(new TableAliasColumn(colNested.column, ta), col.part);
+        } else if (col instanceof DateArithmeticOperation) {
+          aliasedOp = new DateArithmeticOperation(new TableAliasColumn(colNested.column, ta), col.n, col.unit, col.isAdd);
+        } else {
+          aliasedOp = new DateDiffOperation(new TableAliasColumn(colNested.column, ta), col.other, col.unit);
+        }
+        this._select.push(new Alias(aliasedOp, alias));
+      } else if (col instanceof CountAllOperation) {
+        const ta = this._tableAliasForTable(col.table, col.table);
+        this._from.add(ta);
+        this._select.push(new Alias(col, "Count"));
+      }
+    }
+  }
+  _addJoin(node) {
+    if (this._addedJoinIds.has(node)) return;
+    if (node.parent !== void 0) this._addJoin(node.parent);
+    this._addedJoinIds.add(node);
+    const join = node.join;
+    const left = join.left;
+    const srcTa = this._tableAliasForTable(left.owner, node.parent ?? left.owner);
+    if (node.parent === void 0) this._from.add(srcTa);
+    const sc = new TableAliasColumn(left, srcTa);
+    const right = join.right;
+    const tc = new TableAliasColumn(right, this._tableAliasForTable(right.owner, node));
+    const queryFilter = this._joinFilters.get(node);
+    const filterOp = join.filter !== void 0 && queryFilter !== void 0 ? new LogicalOperation(join.filter, "AND" /* AND */, queryFilter) : join.filter ?? queryFilter;
+    this._join.push(new Join(sc, tc, filterOp));
+  }
+  buildFilter(op) {
+    if (op instanceof NoOperation) return "";
+    if (op instanceof ExistsOperation) {
+      const col = op.node.join.right;
+      return this.buildFilter(new ColumnWithJoin(col, op.node)) + " IS NOT NULL";
+    }
+    if (op instanceof NotExistsOperation) {
+      const col = op.node.join.right;
+      return this.buildFilter(new ColumnWithJoin(col, op.node)) + " IS NULL";
+    }
+    if (op instanceof IsNotNullOperation) return this.buildFilter(op.element) + " IS NOT NULL";
+    if (op instanceof IsNullOperation) return this.buildFilter(op.element) + " IS NULL";
+    if (op instanceof LogicalOperation) {
+      let left = this.buildFilter(op.left);
+      let right = this.buildFilter(op.right);
+      if (op.left instanceof LogicalOperation) left = "(" + left + ")";
+      if (op.right instanceof LogicalOperation) right = "(" + right + ")";
+      return left + LOGICAL_OPERATOR_STR[op.operator] + right;
+    }
+    if (op instanceof ComparisonOperation) {
+      return this.buildFilter(op.left) + COMPARISON_OPERATOR_STR[op.operator] + this.buildFilter(op.right);
+    }
+    if (op instanceof ConstantOperation) return constantValueString(op);
+    if (op instanceof ColumnWithJoin) {
+      const { column, parent: node } = this._resolve(op);
+      let ta;
+      if (node !== void 0) {
+        ta = this._tableAliasForTable(column.owner, node);
+        this._addJoin(node);
+      } else {
+        ta = this._tableAliasForTable(column.owner, column.owner);
+      }
+      return ta.alias + "." + column.name;
+    }
+    if (op instanceof Column) {
+      const ta = this._tableAliasForTable(op.owner, op.owner);
+      return ta.alias + "." + op.name;
+    }
+    throw new Error("Unknown operation in buildFilter: " + op.constructor.name);
+  }
+  _tableAliasForTable(table, key) {
+    if (this._tableAliasesByTable.has(key)) {
+      return this._tableAliasesByTable.get(key);
+    }
+    const ta = new TableAlias(table, "t" + this._tableAliasIncr++);
+    this._tableAliasesByTable.set(key, ta);
+    return ta;
+  }
+  buildQueryString() {
+    const joins = this._join.map(
+      (j) => " LEFT OUTER JOIN " + j.target.tableAlias.table + " AS " + j.target.tableAlias.alias + " ON " + j.source.tableAlias.alias + "." + j.source.column.name + " = " + j.target.tableAlias.alias + "." + j.target.column.name + (j.filterOp ? " AND " + this.buildFilter(j.filterOp) : "")
+    );
+    return "SELECT " + this._select.map((ca) => sqlOperationToString(ca)).join(",") + " FROM " + Array.from(this._from).map((ta) => ta.table + " AS " + ta.alias).join(",") + joins.join("") + this._buildWhere() + this._buildGroupBy() + this._buildOrderBy() + this._buildLimit();
+  }
+  _buildWhere() {
+    return this._where.length > 0 ? " WHERE " + this._where : "";
+  }
+  _buildGroupBy() {
+    return this._groupByParts.length > 0 ? " GROUP BY " + this._groupByParts.join(", ") : "";
+  }
+  _buildOrderBy() {
+    return this._orderByParts.length > 0 ? " ORDER BY " + this._orderByParts.join(", ") : "";
+  }
+  _buildLimit() {
+    return this._limit !== void 0 ? " LIMIT " + this._limit : "";
+  }
+};
+function selectSqlToString(selectOperation) {
+  const qg = new SQLQueryGenerator();
+  qg.generate(selectOperation);
+  return qg.buildQueryString();
+}
+function toSql(businessDate, processingDatetime, columns, table, op, orderBy = [], groupBy = [], limit, businessDateTo = null) {
+  const selectOp = buildQueryOperation(businessDate, processingDatetime, columns, table, op, orderBy, groupBy, limit, businessDateTo);
+  return selectSqlToString(selectOp);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildQueryOperation,
+  selectSqlToString,
+  toSql
+});
+//# sourceMappingURL=sql-generator.cjs.map