data-finder-ts 0.1.0 → 0.1.4

package/dist/datafinder/attribute.cjs

@@ -0,0 +1,320 @@
+"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/attribute.ts
+var attribute_exports = {};
+__export(attribute_exports, {
+  Attribute: () => Attribute
+});
+module.exports = __toCommonJS(attribute_exports);
+
+// src/model/relational.ts
+var RelationalOperationElement = class {
+};
+var Operation = class extends RelationalOperationElement {
+  andOp(other) {
+    return new LogicalOperation(this, "AND" /* AND */, other);
+  }
+};
+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 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 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 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;
+};
+
+// 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)
+    );
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Attribute
+});
+//# sourceMappingURL=attribute.cjs.map

package/dist/datafinder/attribute.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/datafinder/attribute.ts","../../src/model/relational.ts"],"sourcesContent":["import {\n  Column,\n  AggregateOperation,\n  AggregateOperator,\n  ColumnWithJoin,\n  SortOperation,\n  SortDirection,\n  IsNullOperation,\n  IsNotNullOperation,\n  JoinTreeNodeOperation,\n  WindowFunction,\n  WindowFunctionOperation,\n  WindowSpecification,\n} from '../model/relational';\n\nexport abstract class Attribute {\n  private readonly _displayName: string;\n  private readonly _column: Column;\n  private readonly _owner: string;\n  private readonly _parent?: JoinTreeNodeOperation;\n  private readonly _embedded?: Attribute;\n\n  constructor(\n    displayName: string,\n    columnName: string,\n    columnDbType: string,\n    owner: string,\n    parent?: JoinTreeNodeOperation,\n    embedded?: Attribute,\n  ) {\n    this._displayName = displayName;\n    this._column = new Column(columnName, columnDbType, owner);\n    this._owner = owner;\n    this._parent = parent;\n    this._embedded = embedded;\n  }\n\n  column(): Column { return this._column; }\n  owner(): string { return this._owner; }\n  parent(): JoinTreeNodeOperation | undefined { return this._parent; }\n  displayName(): string { return this._displayName; }\n\n  /** Alternate attribute on a flat column of the owning table, used in place of this one when its join is elided. */\n  embedded(): Attribute | undefined { return this._embedded; }\n\n  cwj(): ColumnWithJoin {\n    return new ColumnWithJoin(this._column, this._parent, this._embedded?.cwj());\n  }\n\n  /** Count the number of non-null values. Use in a projection with `groupByOp` to aggregate per group. */\n  count(): AggregateOperation {\n    return new AggregateOperation(\n      this.cwj(),\n      AggregateOperator.COUNT,\n      this._displayName + ' Count',\n    );\n  }\n\n  /** Sort this attribute in ascending order. Pass to `orderByOp` or a window function's `orderBy`. */\n  ascending(): SortOperation {\n    return new SortOperation(this.cwj(), SortDirection.ASC);\n  }\n\n  /** Sort this attribute in descending order. Pass to `orderByOp` or a window function's `orderBy`. */\n  descending(): SortOperation {\n    return new SortOperation(this.cwj(), SortDirection.DESC);\n  }\n\n  /** Filter to rows where this attribute has no value. */\n  isNull(): IsNullOperation {\n    return new IsNullOperation(this.cwj());\n  }\n\n  /** Filter to rows where this attribute has a value. */\n  isNotNull(): IsNotNullOperation {\n    return new IsNotNullOperation(this.cwj());\n  }\n\n  private _windowSpec(\n    partitionBy?: Attribute | ColumnWithJoin | (Attribute | ColumnWithJoin)[],\n    orderBy?: SortOperation | SortOperation[],\n  ): WindowSpecification {\n    const pbArr = partitionBy === undefined ? [] : Array.isArray(partitionBy) ? partitionBy : [partitionBy];\n    const pb = pbArr.map(x => x instanceof Attribute ? x.cwj() : x);\n    const ob = orderBy === undefined ? [] : Array.isArray(orderBy) ? orderBy : [orderBy];\n    return new WindowSpecification(pb, ob);\n  }\n\n  /**\n   * Assign a rank to each row within the ordered window, following pandas `Series.rank` conventions.\n   *\n   * `method` controls tie-breaking (default `'min'`):\n   * - `'min'`   — tied rows share the lowest rank; the next rank skips.\n   * - `'dense'` — like `'min'` but ranks are contiguous (no gaps).\n   * - `'first'` — each row gets a unique sequential integer (no ties).\n   * - `'max'`   — only meaningful with `pct: true` (see below).\n   *\n   * When `pct: true` the result is a relative rank between 0 and 1:\n   * - `method: 'min'` (default) → fraction of values strictly below this row (PERCENT_RANK).\n   * - `method: 'max'` → fraction of values at or below this row (cumulative distribution).\n   *\n   * `partitionBy` restarts the ranking within each group of distinct values.\n   */\n  rank(opts: {\n    method?: 'min' | 'dense' | 'first' | 'max';\n    pct?: boolean;\n    partitionBy?: Attribute | ColumnWithJoin | (Attribute | ColumnWithJoin)[];\n    orderBy?: SortOperation | SortOperation[];\n  } = {}): WindowFunctionOperation {\n    const { method = 'min', pct = false, partitionBy, orderBy } = opts;\n    let func: WindowFunction;\n    let name: string;\n    if (pct) {\n      if (method === 'max') { func = WindowFunction.CUME_DIST; name = 'Cume Dist'; }\n      else { func = WindowFunction.PERCENT_RANK; name = 'Percent Rank'; }\n    } else if (method === 'first') { func = WindowFunction.ROW_NUMBER; name = 'Row Number'; }\n    else if (method === 'dense') { func = WindowFunction.DENSE_RANK; name = 'Dense Rank'; }\n    else { func = WindowFunction.RANK; name = 'Rank'; }\n    return new WindowFunctionOperation(null, func, name, undefined, [], this._windowSpec(partitionBy, orderBy));\n  }\n\n  /**\n   * Split rows into `buckets` equal-sized quantile bins ordered by `orderBy`.\n   * Each row receives a bucket number from 1 (lowest) to `buckets` (highest).\n   * Named after `pandas.qcut`.\n   */\n  qcut(buckets: number, opts: {\n    partitionBy?: Attribute | ColumnWithJoin | (Attribute | ColumnWithJoin)[];\n    orderBy?: SortOperation | SortOperation[];\n  } = {}): WindowFunctionOperation {\n    return new WindowFunctionOperation(null, WindowFunction.NTILE, 'Quantile', buckets, [],\n      this._windowSpec(opts.partitionBy, opts.orderBy));\n  }\n\n  /**\n   * Return the value of this attribute from `periods` rows earlier (positive) or later (negative)\n   * within the ordered window, following `pandas.Series.shift`.\n   * Rows with no neighbour at the given offset return `null` (or `fillValue` if provided).\n   */\n  shift(periods = 1, opts: {\n    fillValue?: string | number;\n    partitionBy?: Attribute | ColumnWithJoin | (Attribute | ColumnWithJoin)[];\n    orderBy?: SortOperation | SortOperation[];\n  } = {}): WindowFunctionOperation {\n    const extraArgs: (string | number)[] = opts.fillValue !== undefined ? [opts.fillValue] : [];\n    const func = periods >= 0 ? WindowFunction.LAG : WindowFunction.LEAD;\n    const label = periods >= 0 ? 'Lag' : 'Lead';\n    return new WindowFunctionOperation(\n      this.cwj(),\n      func,\n      label + ' ' + this._displayName,\n      Math.abs(periods),\n      extraArgs,\n      this._windowSpec(opts.partitionBy, opts.orderBy),\n    );\n  }\n\n  /**\n   * Return the first value of this attribute in the window frame.\n   * Use `partitionBy` to restart the frame for each group.\n   */\n  first(opts: {\n    partitionBy?: Attribute | ColumnWithJoin | (Attribute | ColumnWithJoin)[];\n    orderBy?: SortOperation | SortOperation[];\n  } = {}): WindowFunctionOperation {\n    return new WindowFunctionOperation(\n      this.cwj(),\n      WindowFunction.FIRST_VALUE,\n      'First ' + this._displayName,\n      undefined, [],\n      this._windowSpec(opts.partitionBy, opts.orderBy),\n    );\n  }\n\n  /**\n   * Return the last value of this attribute in the window frame.\n   * Use `partitionBy` to restart the frame for each group.\n   */\n  last(opts: {\n    partitionBy?: Attribute | ColumnWithJoin | (Attribute | ColumnWithJoin)[];\n    orderBy?: SortOperation | SortOperation[];\n  } = {}): WindowFunctionOperation {\n    return new WindowFunctionOperation(\n      this.cwj(),\n      WindowFunction.LAST_VALUE,\n      'Last ' + this._displayName,\n      undefined, [],\n      this._windowSpec(opts.partitionBy, opts.orderBy),\n    );\n  }\n}\n","export enum ComparisonOperator {\n  EQUAL = 'EQUAL',\n  NOT_EQUAL = 'NOT_EQUAL',\n  LESS_THAN = 'LESS_THAN',\n  GREATER_THAN = 'GREATER_THAN',\n  LESS_THAN_OR_EQUAL_TO = 'LESS_THAN_OR_EQUAL_TO',\n  GREATER_THAN_OR_EQUAL_TO = 'GREATER_THAN_OR_EQUAL_TO',\n  LIKE = 'LIKE',\n  NOT_LIKE = 'NOT_LIKE',\n}\n\nexport enum LogicalOperator {\n  AND = 'AND',\n  OR = 'OR',\n}\n\nexport enum AggregateOperator {\n  COUNT = 'COUNT',\n  SUM = 'SUM',\n  MIN = 'MIN',\n  MAX = 'MAX',\n  AVERAGE = 'AVERAGE',\n}\n\nexport enum ScalarFunction {\n  ABS = 'ABS',\n  CEILING = 'CEILING',\n  FLOOR = 'FLOOR',\n  MOD = 'MOD',\n  POWER = 'POWER',\n  SQRT = 'SQRT',\n  ROUND = 'ROUND',\n  UPPER = 'UPPER',\n  LOWER = 'LOWER',\n  TRIM = 'TRIM',\n  LTRIM = 'LTRIM',\n  RTRIM = 'RTRIM',\n  LENGTH = 'LENGTH',\n  REVERSE = 'REVERSE',\n  LEFT = 'LEFT',\n  RIGHT = 'RIGHT',\n  REPEAT = 'REPEAT',\n  REPLACE = 'REPLACE',\n  SUBSTRING = 'SUBSTRING',\n}\n\nexport enum DatePart {\n  YEAR = 'YEAR',\n  MONTH = 'MONTH',\n  DAY = 'DAY',\n  HOUR = 'HOUR',\n  MINUTE = 'MINUTE',\n  SECOND = 'SECOND',\n  QUARTER = 'QUARTER',\n  WEEK = 'WEEK',\n  DOW = 'DOW',\n}\n\nexport enum SortDirection {\n  ASC = 'ASC',\n  DESC = 'DESC',\n}\n\nexport abstract class RelationalOperationElement {}\n\nexport abstract class Operation extends RelationalOperationElement {\n  andOp(other: RelationalOperationElement): Operation {\n    return new LogicalOperation(this, LogicalOperator.AND, other);\n  }\n}\n\nexport class NoOperation extends Operation {\n  andOp(other: RelationalOperationElement): Operation {\n    return other as Operation;\n  }\n}\n\nexport abstract class ConstantOperation extends RelationalOperationElement {}\n\nexport class IntegerConstantOperation extends ConstantOperation {\n  constructor(readonly value: number) { super(); }\n}\n\nexport class FloatConstantOperation extends ConstantOperation {\n  constructor(readonly value: number) { super(); }\n}\n\nexport class StringConstantOperation extends ConstantOperation {\n  constructor(readonly value: string) { super(); }\n}\n\nexport class DateConstantOperation extends ConstantOperation {\n  constructor(readonly value: Date) { super(); }\n}\n\nexport class DateTimeConstantOperation extends ConstantOperation {\n  constructor(readonly value: Date) { super(); }\n}\n\nexport class DecimalConstantOperation extends ConstantOperation {\n  constructor(readonly value: number) { super(); }\n}\n\nexport class BooleanConstantOperation extends ConstantOperation {\n  constructor(readonly value: boolean) { super(); }\n}\n\nexport abstract class UnaryOperation extends Operation {\n  constructor(readonly element: RelationalOperationElement) { super(); }\n}\n\nexport abstract class BinaryOperation extends Operation {\n  constructor(\n    readonly left: RelationalOperationElement,\n    readonly right: RelationalOperationElement,\n  ) { super(); }\n}\n\nexport class IsNullOperation extends UnaryOperation {}\n\nexport class IsNotNullOperation extends UnaryOperation {}\n\nexport class ComparisonOperation extends BinaryOperation {\n  constructor(\n    left: RelationalOperationElement,\n    readonly operator: ComparisonOperator,\n    right: RelationalOperationElement,\n  ) { super(left, right); }\n}\n\nexport class LogicalOperation extends BinaryOperation {\n  constructor(\n    left: RelationalOperationElement,\n    readonly operator: LogicalOperator,\n    right: RelationalOperationElement,\n  ) { super(left, right); }\n}\n\nexport class WindowSpecification {\n  constructor(\n    readonly partitionBy: RelationalOperationElement[] = [],\n    readonly orderBy: SortOperation[] = [],\n  ) {}\n}\n\nexport class AggregateOperation extends UnaryOperation {\n  constructor(\n    element: RelationalOperationElement,\n    readonly operator: AggregateOperator,\n    readonly displayName?: string,\n    readonly window?: WindowSpecification,\n  ) { super(element); }\n\n  over(partitionBy?: RelationalOperationElement[], orderBy?: SortOperation[]): AggregateOperation {\n    return new AggregateOperation(this.element, this.operator, this.displayName,\n      new WindowSpecification(partitionBy ?? [], orderBy ?? []));\n  }\n}\n\nexport enum WindowFunction {\n  ROW_NUMBER = 'ROW_NUMBER',\n  RANK = 'RANK',\n  DENSE_RANK = 'DENSE_RANK',\n  NTILE = 'NTILE',\n  LAG = 'LAG',\n  LEAD = 'LEAD',\n  FIRST_VALUE = 'FIRST_VALUE',\n  LAST_VALUE = 'LAST_VALUE',\n  CUME_DIST = 'CUME_DIST',\n  PERCENT_RANK = 'PERCENT_RANK',\n}\n\nexport class WindowFunctionOperation extends UnaryOperation {\n  constructor(\n    element: RelationalOperationElement | null,\n    readonly func: WindowFunction,\n    readonly displayName?: string,\n    readonly secondArg?: number,\n    readonly extraArgs: (string | number)[] = [],\n    readonly window?: WindowSpecification,\n  ) { super(element as RelationalOperationElement); }\n\n  over(partitionBy?: RelationalOperationElement[], orderBy?: SortOperation[]): WindowFunctionOperation {\n    return new WindowFunctionOperation(this.element, this.func, this.displayName, this.secondArg,\n      [...this.extraArgs], new WindowSpecification(partitionBy ?? [], orderBy ?? []));\n  }\n}\n\nexport class ScalarFunctionOperation extends UnaryOperation {\n  constructor(\n    element: RelationalOperationElement,\n    readonly func: ScalarFunction,\n    readonly displayName?: string,\n    readonly secondArg?: number,\n    readonly extraArgs: (string | number)[] = [],\n  ) { super(element); }\n}\n\nexport class DateExtractOperation extends UnaryOperation {\n  constructor(\n    element: RelationalOperationElement,\n    readonly part: DatePart,\n    readonly displayName?: string,\n  ) { super(element); }\n}\n\nexport class DateArithmeticOperation extends UnaryOperation {\n  constructor(\n    element: RelationalOperationElement,\n    readonly n: number,\n    readonly unit: DatePart,\n    readonly isAdd: boolean = true,\n    readonly displayName?: string,\n  ) { super(element); }\n}\n\nexport class DateDiffOperation extends UnaryOperation {\n  constructor(\n    element: RelationalOperationElement,\n    readonly other: Date,\n    readonly unit: DatePart,\n    readonly displayName?: string,\n  ) { super(element); }\n}\n\nexport class Column extends RelationalOperationElement {\n  table?: Table;\n\n  constructor(\n    readonly name: string,\n    readonly type: string,\n    readonly owner?: string,\n    readonly primaryKey: boolean = false,\n  ) { super(); }\n}\n\nexport class ForeignKey {\n  constructor(readonly column: Column, readonly references: Column) {}\n}\n\nexport abstract class DataStore {\n  readonly schemas: Schema[] = [];\n\n  constructor(readonly name: string) {}\n\n  abstract namespace(schemaName: string): string;\n}\n\nexport class Database extends DataStore {\n  constructor(name: string, readonly location?: string) { super(name); }\n\n  namespace(schemaName: string): string { return schemaName; }\n}\n\nexport class DataCatalog extends DataStore {\n  constructor(name: string) { super(name); }\n\n  namespace(schemaName: string): string { return `${this.name}.${schemaName}`; }\n}\n\nexport class Schema {\n  readonly tables: Table[] = [];\n\n  constructor(readonly name: string, readonly datastore?: DataStore) {\n    datastore?.schemas.push(this);\n  }\n}\n\nexport class Table {\n  private readonly _columnsByName: Map<string, Column> = new Map();\n  readonly foreignKeys: ForeignKey[] = [];\n\n  constructor(readonly name: string, columns: Column[], readonly schema?: Schema) {\n    for (const col of columns) {\n      if (this._columnsByName.has(col.name)) {\n        throw new Error(`Duplicate column name '${col.name}' in table '${name}'`);\n      }\n      this._columnsByName.set(col.name, col);\n      col.table = this;\n    }\n    schema?.tables.push(this);\n  }\n\n  get columns(): Column[] {\n    return Array.from(this._columnsByName.values());\n  }\n\n  get qualifiedName(): string {\n    if (!this.schema) return this.name;\n    if (!this.schema.datastore) return `${this.schema.name}.${this.name}`;\n    return `${this.schema.datastore.namespace(this.schema.name)}.${this.name}`;\n  }\n}\n\nexport class JoinOperation {\n  filter?: RelationalOperationElement;\n  /** Property-equality filters on the join target (property id -> value), set by a related finder given a filter. */\n  filterKwargs: Record<string, unknown> = {};\n  /** Maps property ids to [column, type, table] for `filterKwargs`. */\n  filterColumnMap: Record<string, [string, string, string]> = {};\n\n  constructor(\n    readonly name: string,\n    readonly target: Table,\n    readonly left: Column,\n    readonly right: Column,\n    filter?: RelationalOperationElement,\n  ) {\n    this.filter = filter;\n  }\n}\n\nexport class JoinTreeNodeOperation {\n  constructor(\n    readonly join: JoinOperation,\n    readonly parent?: JoinTreeNodeOperation,\n  ) {}\n}\n\nexport class ColumnWithJoin extends RelationalOperationElement {\n  /**\n   * `embedded` is an alternate reference to a flat (denormalized) column on the owning table that\n   * holds the same value without the join; the SQL generator uses it when the join can be elided.\n   */\n  constructor(\n    readonly column: Column,\n    readonly parent?: JoinTreeNodeOperation,\n    readonly embedded?: ColumnWithJoin,\n  ) { super(); }\n}\n\nexport class SortOperation {\n  constructor(\n    readonly column: ColumnWithJoin,\n    readonly direction: SortDirection,\n  ) {}\n}\n\nexport class CountAllOperation extends RelationalOperationElement {\n  constructor(readonly table: string) { super(); }\n}\n\nexport class Alias extends RelationalOperationElement {\n  constructor(readonly element: RelationalOperationElement, readonly name: string) { super(); }\n}\n\n/** Returned by `RelatedFinder.exists()`. A backend translates it to a join-presence check. */\nexport class ExistsOperation extends RelationalOperationElement {\n  constructor(readonly node: JoinTreeNodeOperation) { super(); }\n\n  andOp(other: RelationalOperationElement): LogicalOperation {\n    return new LogicalOperation(this, LogicalOperator.AND, other);\n  }\n}\n\n/** Returned by `RelatedFinder.notExists()`. A backend translates it to a join-absence check. */\nexport class NotExistsOperation extends RelationalOperationElement {\n  constructor(readonly node: JoinTreeNodeOperation) { super(); }\n\n  andOp(other: RelationalOperationElement): LogicalOperation {\n    return new LogicalOperation(this, LogicalOperator.AND, other);\n  }\n}\n\nexport class SelectOperation {\n  constructor(\n    readonly display: RelationalOperationElement[],\n    readonly filter: RelationalOperationElement,\n    readonly orderBy: SortOperation[] = [],\n    readonly groupBy: RelationalOperationElement[] = [],\n    readonly limit?: number,\n    readonly table?: Table,\n    /**\n     * Extra ON conditions for this query's joins (milestoning and property filters), keyed by join node.\n     * Held here rather than on the shared JoinOperation, so queries that use the same node can't affect each other.\n     */\n    readonly joinFilters: ReadonlyMap<JoinTreeNodeOperation, Operation> = new Map(),\n  ) {}\n}\n"],"mappings":"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","names":[]}

package/dist/datafinder/attribute.d.cts

@@ -0,0 +1,86 @@
+import { JoinTreeNodeOperation, Column, ColumnWithJoin, AggregateOperation, SortOperation, IsNullOperation, IsNotNullOperation, WindowFunctionOperation } from '../model/relational.cjs';
+
+declare abstract class Attribute {
+    private readonly _displayName;
+    private readonly _column;
+    private readonly _owner;
+    private readonly _parent?;
+    private readonly _embedded?;
+    constructor(displayName: string, columnName: string, columnDbType: string, owner: string, parent?: JoinTreeNodeOperation, embedded?: Attribute);
+    column(): Column;
+    owner(): string;
+    parent(): JoinTreeNodeOperation | undefined;
+    displayName(): string;
+    /** Alternate attribute on a flat column of the owning table, used in place of this one when its join is elided. */
+    embedded(): Attribute | undefined;
+    cwj(): ColumnWithJoin;
+    /** Count the number of non-null values. Use in a projection with `groupByOp` to aggregate per group. */
+    count(): AggregateOperation;
+    /** Sort this attribute in ascending order. Pass to `orderByOp` or a window function's `orderBy`. */
+    ascending(): SortOperation;
+    /** Sort this attribute in descending order. Pass to `orderByOp` or a window function's `orderBy`. */
+    descending(): SortOperation;
+    /** Filter to rows where this attribute has no value. */
+    isNull(): IsNullOperation;
+    /** Filter to rows where this attribute has a value. */
+    isNotNull(): IsNotNullOperation;
+    private _windowSpec;
+    /**
+     * 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?: {
+        method?: 'min' | 'dense' | 'first' | 'max';
+        pct?: boolean;
+        partitionBy?: Attribute | ColumnWithJoin | (Attribute | ColumnWithJoin)[];
+        orderBy?: SortOperation | SortOperation[];
+    }): WindowFunctionOperation;
+    /**
+     * 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: number, opts?: {
+        partitionBy?: Attribute | ColumnWithJoin | (Attribute | ColumnWithJoin)[];
+        orderBy?: SortOperation | SortOperation[];
+    }): WindowFunctionOperation;
+    /**
+     * 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?: number, opts?: {
+        fillValue?: string | number;
+        partitionBy?: Attribute | ColumnWithJoin | (Attribute | ColumnWithJoin)[];
+        orderBy?: SortOperation | SortOperation[];
+    }): WindowFunctionOperation;
+    /**
+     * Return the first value of this attribute in the window frame.
+     * Use `partitionBy` to restart the frame for each group.
+     */
+    first(opts?: {
+        partitionBy?: Attribute | ColumnWithJoin | (Attribute | ColumnWithJoin)[];
+        orderBy?: SortOperation | SortOperation[];
+    }): WindowFunctionOperation;
+    /**
+     * Return the last value of this attribute in the window frame.
+     * Use `partitionBy` to restart the frame for each group.
+     */
+    last(opts?: {
+        partitionBy?: Attribute | ColumnWithJoin | (Attribute | ColumnWithJoin)[];
+        orderBy?: SortOperation | SortOperation[];
+    }): WindowFunctionOperation;
+}
+
+export { Attribute };

package/dist/datafinder/attribute.d.ts

@@ -0,0 +1,86 @@
+import { JoinTreeNodeOperation, Column, ColumnWithJoin, AggregateOperation, SortOperation, IsNullOperation, IsNotNullOperation, WindowFunctionOperation } from '../model/relational.js';
+
+declare abstract class Attribute {
+    private readonly _displayName;
+    private readonly _column;
+    private readonly _owner;
+    private readonly _parent?;
+    private readonly _embedded?;
+    constructor(displayName: string, columnName: string, columnDbType: string, owner: string, parent?: JoinTreeNodeOperation, embedded?: Attribute);
+    column(): Column;
+    owner(): string;
+    parent(): JoinTreeNodeOperation | undefined;
+    displayName(): string;
+    /** Alternate attribute on a flat column of the owning table, used in place of this one when its join is elided. */
+    embedded(): Attribute | undefined;
+    cwj(): ColumnWithJoin;
+    /** Count the number of non-null values. Use in a projection with `groupByOp` to aggregate per group. */
+    count(): AggregateOperation;
+    /** Sort this attribute in ascending order. Pass to `orderByOp` or a window function's `orderBy`. */
+    ascending(): SortOperation;
+    /** Sort this attribute in descending order. Pass to `orderByOp` or a window function's `orderBy`. */
+    descending(): SortOperation;
+    /** Filter to rows where this attribute has no value. */
+    isNull(): IsNullOperation;
+    /** Filter to rows where this attribute has a value. */
+    isNotNull(): IsNotNullOperation;
+    private _windowSpec;
+    /**
+     * 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?: {
+        method?: 'min' | 'dense' | 'first' | 'max';
+        pct?: boolean;
+        partitionBy?: Attribute | ColumnWithJoin | (Attribute | ColumnWithJoin)[];
+        orderBy?: SortOperation | SortOperation[];
+    }): WindowFunctionOperation;
+    /**
+     * 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: number, opts?: {
+        partitionBy?: Attribute | ColumnWithJoin | (Attribute | ColumnWithJoin)[];
+        orderBy?: SortOperation | SortOperation[];
+    }): WindowFunctionOperation;
+    /**
+     * 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?: number, opts?: {
+        fillValue?: string | number;
+        partitionBy?: Attribute | ColumnWithJoin | (Attribute | ColumnWithJoin)[];
+        orderBy?: SortOperation | SortOperation[];
+    }): WindowFunctionOperation;
+    /**
+     * Return the first value of this attribute in the window frame.
+     * Use `partitionBy` to restart the frame for each group.
+     */
+    first(opts?: {
+        partitionBy?: Attribute | ColumnWithJoin | (Attribute | ColumnWithJoin)[];
+        orderBy?: SortOperation | SortOperation[];
+    }): WindowFunctionOperation;
+    /**
+     * Return the last value of this attribute in the window frame.
+     * Use `partitionBy` to restart the frame for each group.
+     */
+    last(opts?: {
+        partitionBy?: Attribute | ColumnWithJoin | (Attribute | ColumnWithJoin)[];
+        orderBy?: SortOperation | SortOperation[];
+    }): WindowFunctionOperation;
+}
+
+export { Attribute };

package/dist/datafinder/attribute.js

@@ -0,0 +1,8 @@
+import {
+  Attribute
+} from "../chunk-4JVW4TAB.js";
+import "../chunk-UYMOE6YU.js";
+export {
+  Attribute
+};
+//# sourceMappingURL=attribute.js.map

package/dist/datafinder/attribute.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/datafinder/finder-registry.cjs

@@ -0,0 +1,39 @@
+"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/finder-registry.ts
+var finder_registry_exports = {};
+__export(finder_registry_exports, {
+  getRelatedFinderClass: () => getRelatedFinderClass,
+  registerRelatedFinderClass: () => registerRelatedFinderClass
+});
+module.exports = __toCommonJS(finder_registry_exports);
+var _registry = /* @__PURE__ */ new Map();
+function registerRelatedFinderClass(name, cls) {
+  _registry.set(name, cls);
+}
+function getRelatedFinderClass(name) {
+  return _registry.get(name);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getRelatedFinderClass,
+  registerRelatedFinderClass
+});
+//# sourceMappingURL=finder-registry.cjs.map

package/dist/datafinder/finder-registry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/datafinder/finder-registry.ts"],"sourcesContent":["const _registry = new Map<string, new (...args: any[]) => unknown>();\n\nexport function registerRelatedFinderClass(name: string, cls: new (...args: any[]) => unknown): void {\n  _registry.set(name, cls);\n}\n\nexport function getRelatedFinderClass(name: string): (new (...args: any[]) => unknown) | undefined {\n  return _registry.get(name);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAAM,YAAY,oBAAI,IAA6C;AAE5D,SAAS,2BAA2B,MAAc,KAA4C;AACnG,YAAU,IAAI,MAAM,GAAG;AACzB;AAEO,SAAS,sBAAsB,MAA6D;AACjG,SAAO,UAAU,IAAI,IAAI;AAC3B;","names":[]}

package/dist/datafinder/finder-registry.d.cts

@@ -0,0 +1,4 @@
+declare function registerRelatedFinderClass(name: string, cls: new (...args: any[]) => unknown): void;
+declare function getRelatedFinderClass(name: string): (new (...args: any[]) => unknown) | undefined;
+
+export { getRelatedFinderClass, registerRelatedFinderClass };

package/dist/datafinder/finder-registry.d.ts

@@ -0,0 +1,4 @@
+declare function registerRelatedFinderClass(name: string, cls: new (...args: any[]) => unknown): void;
+declare function getRelatedFinderClass(name: string): (new (...args: any[]) => unknown) | undefined;
+
+export { getRelatedFinderClass, registerRelatedFinderClass };

package/dist/datafinder/finder-registry.js

@@ -0,0 +1,9 @@
+import {
+  getRelatedFinderClass,
+  registerRelatedFinderClass
+} from "../chunk-FLEIUDZZ.js";
+export {
+  getRelatedFinderClass,
+  registerRelatedFinderClass
+};
+//# sourceMappingURL=finder-registry.js.map

package/dist/datafinder/finder-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}