@quereus/quereus 4.5.0 → 4.7.0

package/dist/src/planner/building/select-window.js

@@ -4,12 +4,25 @@ import { ProjectNode } from '../nodes/project-node.js';
 import { ArrayIndexNode } from '../nodes/array-index-node.js';
 import { LiteralNode } from '../nodes/scalar.js';
 import { buildExpression } from './expression.js';
-import { isWindowExpression } from './select-projections.js';
+import { assertGroupedWindowCoverage, collectAggregateFunctionExprs, redirectToGroupKeys } from './select-aggregates.js';
+import { findMatchingAggregate } from './function-call.js';
+import { QuereusError } from '../../common/errors.js';
+import { StatusCode } from '../../common/types.js';
+import { expressionToString } from '../../emit/ast-stringify.js';
 import { CapabilityDetectors } from '../framework/characteristics.js';
 /**
- * Processes window functions and creates WindowNode(s) with proper projections
+ * Processes window functions and creates WindowNode(s) with proper projections.
+ *
+ * `selectListProjections` is the query's ONE select-list projection list — stars
+ * already expanded, in written order, window functions still present as raw
+ * `WindowFunctionCallNode` subtrees. It is rewritten (not rebuilt) into the
+ * projection placed above the WindowNode(s); see {@link buildWindowProjections}.
+ *
+ * `groupedWindowContext` is supplied only for a GROUPED query. The WindowNode sits
+ * ABOVE the AggregateNode, so its window specifications and function arguments run
+ * over the grouped rows and may only read what those rows carry.
  */
-export function buildWindowPhase(input, windowFunctions, selectContext, stmt) {
+export function buildWindowPhase(input, windowFunctions, selectContext, selectListProjections, groupedWindowContext) {
     if (windowFunctions.length === 0) {
         return input;
     }
@@ -29,29 +42,118 @@ export function buildWindowPhase(input, windowFunctions, selectContext, stmt) {
             // TODO: Replace with SequencingNode for optimal performance
             // For now, proceed with WindowNode
         }
+        // Reject an aggregate this query never computed before trying to build it, so
+        // the failure names the unsupported construct.
+        for (const { func } of functions) {
+            rejectUncollectedAggregates(func, selectContext);
+        }
+        // In a grouped query the window runs over the AGGREGATE's rows, which carry only
+        // grouping keys and aggregate results. Several legal spellings of a grouping key
+        // nonetheless bind to a base-table attribute, because the scope these are built
+        // against falls through to the pre-aggregate select scope: a qualified `wg.a`
+        // against `group by a`, or the whole expression against `group by a || '!'`.
+        // Redirect every such subtree onto the aggregate's own output column.
+        const redirect = (expr) => groupedWindowContext
+            ? redirectToGroupKeys(expr, groupedWindowContext, selectContext.scope)
+            : expr;
         // CRITICAL: Build window specification expressions using the INPUT scope
         // This ensures expressions reference the correct input attribute IDs,
         // not premature output attribute IDs that don't exist in the runtime context
-        const partitionExpressions = windowSpec.partitionBy.map(expr => buildExpression(selectContext, expr, false));
-        const orderByExpressions = windowSpec.orderBy.map(orderClause => buildExpression(selectContext, orderClause.expr, false));
+        const partitionExpressions = windowSpec.partitionBy.map(expr => redirect(buildExpression(selectContext, expr, false)));
+        const orderByExpressions = windowSpec.orderBy.map(orderClause => redirect(buildExpression(selectContext, orderClause.expr, false)));
         // Build the function argument expressions FIRST (off the original nodes)
         // so each re-created WindowFunctionCallNode can be handed its argument
         // logical types for faithful return-type inference (window MIN/MAX).
-        const functionArguments = buildWindowFunctionArguments(functions.map(({ func }) => func), selectContext);
+        const functionArguments = buildWindowFunctionArguments(functions.map(({ func }) => func), selectContext).map(args => args.map(redirect));
+        // After redirection, anything still naming one of this query's pre-grouping
+        // columns is a genuinely ungrouped reference, illegal for exactly the reason a
+        // bare column in the select list is, and must say so at plan time — otherwise it
+        // reaches the runtime as an attribute the aggregate row never had, and the query
+        // dies with an internal "no row context" error instead. A reference belonging to
+        // a subquery inside the specification, or correlated out to an ENCLOSING query,
+        // is not this query's business and passes through.
+        if (groupedWindowContext) {
+            for (const expr of partitionExpressions)
+                assertGroupedWindowCoverage(expr, groupedWindowContext);
+            for (const expr of orderByExpressions)
+                assertGroupedWindowCoverage(expr, groupedWindowContext);
+            for (const args of functionArguments) {
+                for (const arg of args)
+                    assertGroupedWindowCoverage(arg, groupedWindowContext);
+            }
+        }
         // Create new WindowFunctionCallNode instances with alias + argument-type info
         const windowFuncsWithAlias = functions.map(({ func, alias }, i) => new WindowFunctionCallNode(func.scope, func.expression, func.functionName, func.isDistinct, alias, functionArguments[i].map(a => a.getType().logicalType)));
         // Now create the WindowNode with pre-compiled expressions
         currentInput = new WindowNode(selectContext.scope, currentInput, windowSpec, windowFuncsWithAlias, partitionExpressions, orderByExpressions, functionArguments);
     }
     // Create projections that select only the requested columns using direct array indexing
-    const windowProjections = buildWindowProjections(stmt, currentInput, selectContext, windowFunctions);
+    const windowProjections = buildWindowProjections(selectListProjections, currentInput, selectContext, windowFunctions);
     if (windowProjections.length > 0) {
         currentInput = new ProjectNode(selectContext.scope, currentInput, windowProjections);
     }
     return currentInput;
 }
+/**
+ * Rejects an aggregate inside a window function's OVER clause or arguments that the
+ * aggregate phase never collected.
+ *
+ * The supported spelling is one the SELECT list already computes — `select a,
+ * count(*) c, row_number() over (order by count(*) desc) … group by a` — because
+ * that `count(*)` resolves to the AggregateNode's own output column. An aggregate
+ * that appears ONLY here has nothing to resolve against; without this check it
+ * reaches `buildFunctionCall` with aggregates disallowed and fails with the generic
+ * "not allowed in this context", which reads like a bug rather than the limitation
+ * it is.
+ *
+ * NOTE: supporting the unsupported form means collecting these aggregates into the
+ * AggregateNode before the window phase runs, the way `collectOrderByAggregates`
+ * (select-aggregates.ts) already does for a top-level ORDER BY.
+ *
+ * NOTE: only the PARTITION BY / ORDER BY arms can fire today. A window function's
+ * ARGUMENTS are built once already, by `analyzeSelectColumns` → `buildExpression`'s
+ * `windowFunction` case, against the pre-aggregate context and with aggregates
+ * disallowed — so `sum(count(*)) over ()` dies there with the generic "not allowed
+ * in this context" long before this runs. The argument arm is kept because it
+ * becomes reachable the moment that early type-probe build stops rejecting
+ * aggregates; it is not load-bearing today.
+ *
+ * NOTE: this gate is only as precise as `findMatchingAggregate` (function-call.ts):
+ * a spelling that fingerprint-matches a SELECT-list aggregate passes; anything else
+ * — including a same-column-different-qualifier spelling like `sum(w.b)` against a
+ * SELECT list `sum(b)` — is rejected as uncollected, even though the value would be
+ * identical.
+ */
+function rejectUncollectedAggregates(func, selectContext) {
+    const check = (expr, site) => {
+        for (const aggExpr of collectAggregateFunctionExprs(expr, selectContext)) {
+            if (findMatchingAggregate(selectContext, aggExpr))
+                continue;
+            throw new QuereusError(`Aggregate function ${aggExpr.name} in a window function's ${site} is only supported ` +
+                `when the same aggregate also appears in the SELECT list`, StatusCode.UNSUPPORTED, undefined, aggExpr.loc?.start.line, aggExpr.loc?.start.column);
+        }
+    };
+    const window = func.expression.window;
+    for (const partitionExpr of window?.partitionBy ?? [])
+        check(partitionExpr, 'PARTITION BY');
+    for (const orderClause of window?.orderBy ?? [])
+        check(orderClause.expr, 'ORDER BY');
+    for (const arg of func.expression.function.args ?? [])
+        check(arg, 'arguments');
+}
 /**
  * Groups window functions by their window specification
+ *
+ * NOTE: the key is `JSON.stringify` over raw AST fragments, which include each
+ * fragment's source-location (`loc`) data — so two textually identical `over (…)`
+ * clauses at different source positions never key equal and this never actually
+ * groups anything; every window function gets its own WindowNode. That accident is
+ * currently load-bearing: {@link findWindowColumnIndex} matches a window function by
+ * name + spec only, so two same-named functions genuinely sharing one WindowNode
+ * would both resolve to the first one's output column. Stripping `loc` here (or
+ * comparing structurally) makes the grouping work and breaks the column matching —
+ * that change has to teach `findWindowColumnIndex` to match by node identity or
+ * position first.
  */
 function groupWindowFunctionsBySpec(windowFunctions) {
     const windowGroups = new Map();
@@ -97,39 +199,33 @@ function buildWindowFunctionArguments(windowFuncs, selectContext) {
     });
 }
 /**
- * Builds projections for window function output columns
+ * Rewrites the SELECT list into the projection that sits above the WindowNode(s).
+ *
+ * Every entry passes through — including expanded `*` columns and ordinary
+ * expressions, which are left exactly as built. Only entries containing a window
+ * function are rebuilt, and only by substituting each window result in place.
  */
-function buildWindowProjections(stmt, windowNode, selectContext, windowFunctions) {
-    const windowProjections = [];
+function buildWindowProjections(selectListProjections, windowNode, selectContext, windowFunctions) {
     const windowType = windowNode.getType();
     const sourceColumnCount = windowType.columns.length - windowFunctions.length;
-    for (const column of stmt.columns) {
-        if (column.type === 'column') {
-            // Build each column expression once and reuse for both classification and projection
-            const builtExpr = buildExpression(selectContext, column.expr, true);
-            if (isWindowExpression(builtExpr)) {
-                // Rewrite each window-function descendant into an ArrayIndexNode pointing
-                // at its computed window-output column, preserving any surrounding
-                // arithmetic / scalar wrapper (e.g. `1000 - row_number() over (...)`).
-                // The top-level case (`row_number() over (...) as rn`) falls out naturally:
-                // the whole tree is the window node, so the rewrite returns a bare
-                // ArrayIndexNode, matching the prior behavior.
-                const rewritten = rewriteWindowFunctions(builtExpr, windowFunctions, sourceColumnCount, windowType, selectContext.scope);
-                windowProjections.push({
-                    node: rewritten,
-                    alias: column.alias
-                });
-            }
-            else {
-                // For regular columns, use the already-built expression
-                windowProjections.push({
-                    node: builtExpr,
-                    alias: column.alias
-                });
-            }
-        }
-    }
-    return windowProjections;
+    return selectListProjections.map(projection => {
+        // Rewrite each window-function descendant into an ArrayIndexNode pointing
+        // at its computed window-output column, preserving any surrounding
+        // arithmetic / scalar wrapper (e.g. `1000 - row_number() over (...)`).
+        const rewritten = rewriteWindowFunctions(projection.node, windowFunctions, sourceColumnCount, windowType, selectContext.scope);
+        if (rewritten === projection.node)
+            return projection;
+        // The rewrite replaces the authored expression with an ArrayIndexNode, whose
+        // own name is a bare index (`[2]`). An unaliased window column must keep the
+        // expression the user wrote as its output name, like every other unaliased
+        // select-list column (`select count(*) from t group by g` yields `count(*)`).
+        return {
+            ...projection,
+            node: rewritten,
+            alias: projection.alias ?? expressionToString(projection.node.expression),
+            attributeId: undefined,
+        };
+    });
 }
 /**
  * Recursively rewrites every WindowFunctionCallNode descendant of a scalar
@@ -184,6 +280,15 @@ function findWindowColumnIndex(windowNode, windowFunctions, sourceColumnCount) {
 }
 /**
  * Compares two window specifications for equality
+ *
+ * NOTE: like {@link groupWindowFunctionsBySpec}, this compares `JSON.stringify` of
+ * raw AST fragments including their source-location (`loc`) data, so two textually
+ * identical `over (…)` clauses written at different positions never compare equal.
+ * That is what keeps `sum(v) over (order by v) a, sum(v*10) over (order by v) b`
+ * resolving to two different window columns despite matching on function name.
+ * Making this comparison structural without also teaching
+ * {@link findWindowColumnIndex} to match by node identity or position collapses
+ * both onto the first function's column.
  */
 function compareWindowSpecs(originalWindow, funcWindow) {
     // Compare partition expressions

package/dist/src/planner/building/select-window.js.map

@@ -1 +1 @@
-{"version":3,"file":"select-window.js","sourceRoot":"","sources":["../../../../src/planner/building/select-window.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"select-window.js","sourceRoot":"","sources":["../../../../src/planner/building/select-window.ts"],"names":[],"mappings":"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"}

package/dist/src/planner/building/select.d.ts

@@ -1,6 +1,7 @@
 import type * as AST from '../../parser/ast.js';
-import { PlanNode, type RelationalPlanNode } from '../nodes/plan-node.js';
+import { PlanNode, type Attribute, type RelationalPlanNode, type ScalarPlanNode } from '../nodes/plan-node.js';
 import type { PlanningContext } from '../planning-context.js';
+import type { Scope } from '../scopes/scope.js';
 import type { CTEScopeNode } from '../nodes/cte-node.js';
 import { ValuesNode } from '../nodes/values-node.js';
 /**
@@ -43,4 +44,39 @@ export declare function buildValuesStmt(ctx: PlanningContext, stmt: AST.ValuesSt
  * @returns A relational plan node representing the FROM clause
  */
 export declare function buildFrom(fromClause: AST.FromClause, parentContext: PlanningContext, cteNodes?: Map<string, CTEScopeNode>): RelationalPlanNode;
+/**
+ * Desugar `using (c1, c2, …)` into the `on l.c1 = r.c1 and l.c2 = r.c2 …` condition
+ * it is defined to mean, so a USING join is *the same plan* an equivalent ON join
+ * builds. Each pair goes through `buildComparison` — the same helper `buildExpression`
+ * uses for a spelled-out `=` — so everything hanging off a real comparison node
+ * applies to USING for free and cannot drift from the ON spelling:
+ *
+ * - cross-type coercion — a JSON column paired with a TEXT one compares structurally,
+ *   an INTEGER paired with a TEXT one numerically (ticket
+ *   `bug-using-join-skips-cross-type-coercion`; before the desugar USING compared
+ *   raw storage classes and matched nothing).
+ * - `BinaryOpNode.generateType`'s collation-lattice validation — a `using (c)` over
+ *   columns with conflicting explicit/declared collations raises the identical
+ *   ambiguous-collation error as `l.c = r.c`, at plan time rather than only as the
+ *   emitter's backstop. Both spellings resolve each pair through the SAME symmetric
+ *   provenance lattice.
+ * - `extractEquiPairs` — hash/merge key selection, collation tagging and the
+ *   semantic-ordering gate, all off the one extractor.
+ *
+ * A NATURAL join (not yet parsed) desugars to USING pairs and inherits all of this.
+ *
+ * Column references are built **from attributes**, not by resolving a synthesized
+ * qualified `AST.ColumnExpr` through the join scope: a USING column can be ambiguous
+ * by name within one side (`a join b using (k) join c using (k)` — the left side of
+ * the second join has two `k` columns). First-match-per-side by name is the pairing
+ * rule USING has always used here.
+ *
+ * NOTE: the nested-loop USING path used to resolve one comparator per column at emit
+ * time; it now evaluates a condition sub-program per row pair, like every ON join.
+ * Only USING joins that fall back to nested loop (cross-type pairs, existence-flag
+ * joins) pay this, and it is not measured. If a USING-heavy workload ever profiles
+ * slower, the fix belongs in the shared ON-condition evaluation path — not in a
+ * restored USING special case.
+ */
+export declare function buildUsingCondition(usingColumns: readonly string[], leftAttrs: readonly Attribute[], rightAttrs: readonly Attribute[], scope: Scope): ScalarPlanNode;
 //# sourceMappingURL=select.d.ts.map

package/dist/src/planner/building/select.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../../src/planner/building/select.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,KAAK,kBAAkB,EAAuB,MAAM,uBAAuB,CAAC;AAG/F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAe9D,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,sBAAsB,CAAC;AAMtE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAwBrD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,GAAG,CAAC,UAAU,EACpB,UAAU,GAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAa;AACjD;;;;;GAKG;AACH,oBAAoB,GAAE,OAAc,GACnC,QAAQ,CA2OV;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC9B,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,GAAG,CAAC,UAAU,GAClB,UAAU,CAQZ;AAsBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,QAAQ,GAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAa,GAAG,kBAAkB,CA4QzJ"}
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../../src/planner/building/select.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,kBAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG/G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAO9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAUhD,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,sBAAsB,CAAC;AAMtE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAyBrD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,GAAG,CAAC,UAAU,EACpB,UAAU,GAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAa;AACjD;;;;;GAKG;AACH,oBAAoB,GAAE,OAAc,GACnC,QAAQ,CA6TV;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC9B,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,GAAG,CAAC,UAAU,GAClB,UAAU,CAQZ;AA6BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,QAAQ,GAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAa,GAAG,kBAAkB,CA0RzJ;AA6FD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,mBAAmB,CAClC,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,SAAS,EAAE,SAAS,SAAS,EAAE,EAC/B,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,KAAK,EAAE,KAAK,GACV,cAAc,CAchB"}