@docstack/client 0.0.3 → 0.0.5

package/lib/core/query-engine/accumulators.js

@@ -0,0 +1,258 @@
+// @ts-nocheck
+import { evalExpression } from './evaluator';
+/**
+ * Accumulator for the SUM() aggregate function.
+ */
+class Sum {
+    /**
+     * @param {string} alias The result alias for this aggregate.
+     * @param {object} expr The expression to be summed.
+     * @param {string} fromAlias The alias of the FROM table.
+     * @param {object} joinAliases A map of join table aliases.
+     */
+    constructor(alias, expr, fromAlias, joinAliases) {
+        this.alias = alias;
+        this.expr = expr;
+        this.fromAlias = fromAlias;
+        this.joinAliases = joinAliases;
+        this.sum = 0;
+        this.seen = false;
+    }
+    /**
+     * Adds a row's value to the sum.
+     * @param {object} row The row to process.
+     */
+    async add(row) {
+        const val = await evalExpression(row, this.expr, this.fromAlias, this.joinAliases);
+        if (val != null && typeof val === 'number') {
+            this.sum += val;
+            this.seen = true;
+        }
+    }
+    /**
+     * Returns the final sum.
+     * @returns {number|null} The total sum, or null if no values were added.
+     */
+    result() { return this.seen ? this.sum : null; }
+}
+/**
+ * Accumulator for the COUNT() aggregate function.
+ */
+class Count {
+    /**
+    * @param {string} alias The result alias for this aggregate.
+    * @param {object} expr The expression to be counted.
+    * @param {string} fromAlias The alias of the FROM table.
+    * @param {object} joinAliases A map of join table aliases.
+    */
+    constructor(alias, expr, fromAlias, joinAliases) {
+        this.alias = alias;
+        this.expr = expr;
+        this.fromAlias = fromAlias;
+        this.joinAliases = joinAliases;
+        this.count = 0;
+    }
+    /**
+     * Increments the count for a row. For COUNT(column), it only counts non-null values.
+     * For COUNT(*), it counts all rows.
+     * @param {object} row The row to process.
+     */
+    async add(row) {
+        if (this.expr.type === 'star') {
+            this.count++;
+        }
+        else {
+            const val = await evalExpression(row, this.expr, this.fromAlias, this.joinAliases);
+            if (val != null) {
+                this.count++;
+            }
+        }
+    }
+    /**
+     * Returns the final count.
+     * @returns {number} The total count.
+     */
+    result() { return this.count; }
+}
+/**
+ * Accumulator for the AVG() aggregate function.
+ */
+class Avg {
+    /**
+     * @param {string} alias The result alias for this aggregate.
+     * @param {object} expr The expression to be averaged.
+     * @param {string} fromAlias The alias of the FROM table.
+     * @param {object} joinAliases A map of join table aliases.
+     */
+    constructor(alias, expr, fromAlias, joinAliases) {
+        this.alias = alias;
+        this.expr = expr;
+        this.fromAlias = fromAlias;
+        this.joinAliases = joinAliases;
+        this.sum = 0;
+        this.count = 0;
+    }
+    /**
+     * Adds a row's value to the running sum and increments the count.
+     * @param {object} row The row to process.
+     */
+    async add(row) {
+        const val = await evalExpression(row, this.expr, this.fromAlias, this.joinAliases);
+        if (val != null && typeof val === 'number') {
+            this.sum += val;
+            this.count++;
+        }
+    }
+    /**
+     * Returns the final average.
+     * @returns {number|null} The average, or null if no values were added.
+     */
+    result() { return this.count > 0 ? this.sum / this.count : null; }
+}
+/**
+ * Accumulator for the MIN() aggregate function.
+ */
+class Min {
+    /**
+     * @param {string} alias The result alias for this aggregate.
+     * @param {object} expr The expression to find the minimum of.
+     * @param {string} fromAlias The alias of the FROM table.
+     * @param {object} joinAliases A map of join table aliases.
+     */
+    constructor(alias, expr, fromAlias, joinAliases) {
+        this.alias = alias;
+        this.expr = expr;
+        this.fromAlias = fromAlias;
+        this.joinAliases = joinAliases;
+        this.min = null;
+    }
+    /**
+     * Updates the minimum value based on the current row.
+     * @param {object} row The row to process.
+     */
+    async add(row) {
+        const val = await evalExpression(row, this.expr, this.fromAlias, this.joinAliases);
+        if (val != null) {
+            if (this.min === null || val < this.min) {
+                this.min = val;
+            }
+        }
+    }
+    /**
+     * Returns the final minimum value.
+     * @returns {*} The minimum value, or null if no values were processed.
+     */
+    result() { return this.min; }
+}
+/**
+ * Accumulator for the MAX() aggregate function.
+ */
+class Max {
+    /**
+     * @param {string} alias The result alias for this aggregate.
+     * @param {object} expr The expression to find the maximum of.
+     * @param {string} fromAlias The alias of the FROM table.
+     * @param {object} joinAliases A map of join table aliases.
+     */
+    constructor(alias, expr, fromAlias, joinAliases) {
+        this.alias = alias;
+        this.expr = expr;
+        this.fromAlias = fromAlias;
+        this.joinAliases = joinAliases;
+        this.max = null;
+    }
+    /**
+     * Updates the maximum value based on the current row.
+     * @param {object} row The row to process.
+     */
+    async add(row) {
+        const val = await evalExpression(row, this.expr, this.fromAlias, this.joinAliases);
+        if (val != null) {
+            if (this.max === null || val > this.max) {
+                this.max = val;
+            }
+        }
+    }
+    /**
+     * Returns the final maximum value.
+     * @returns {*} The maximum value, or null if no values were processed.
+     */
+    result() { return this.max; }
+}
+/**
+ * A wrapper class that adds DISTINCT functionality to another accumulator.
+ * It ensures that the inner accumulator only processes unique values.
+ */
+class DistinctWrapper {
+    /**
+     * @param {object} innerAccumulator The accumulator to wrap (e.g., Count, Sum).
+     */
+    constructor(innerAccumulator) {
+        this.inner = innerAccumulator;
+        this.seen = new Set();
+        this.alias = this.inner.alias;
+    }
+    /**
+     * Adds a row's value to the inner accumulator only if it hasn't been seen before.
+     * @param {object} row The row to process.
+     */
+    async add(row) {
+        const val = await evalExpression(row, this.inner.expr, this.inner.fromAlias, this.inner.joinAliases);
+        const key = JSON.stringify(val); // Use JSON to handle objects/arrays as keys
+        if (!this.seen.has(key)) {
+            this.seen.add(key);
+            // Delegate to the inner accumulator, which will re-evaluate, but only for unique values
+            await this.inner.add(row);
+        }
+    }
+    /**
+     * Returns the result from the inner accumulator.
+     * @returns {*} The final aggregated result.
+     */
+    result() {
+        return this.inner.result();
+    }
+}
+/**
+ * Creates an array of accumulator instances based on the aggregate functions in the query plan.
+ * @param {Array<object>} aggregates A list of aggregate function definitions from the plan.
+ * @param {string} fromAlias The alias for the FROM table.
+ * @param {object} joinAliases A map of join aliases.
+ * @returns {Array<object>} An array of initialized accumulator instances.
+ * @throws {Error} If an unsupported aggregate function is specified.
+ */
+export function createAccumulators(aggregates, fromAlias, joinAliases) {
+    return aggregates.map(agg => {
+        const alias = agg.as || agg.expr.name;
+        const expr = agg.expr.args.expr;
+        const isDistinct = agg.expr.args.distinct;
+        let accumulator;
+        switch (agg.expr.name) {
+            case 'COUNT':
+                accumulator = new Count(alias, expr, fromAlias, joinAliases);
+                break;
+            case 'SUM':
+                accumulator = new Sum(alias, expr, fromAlias, joinAliases);
+                break;
+            case 'AVG':
+                accumulator = new Avg(alias, expr, fromAlias, joinAliases);
+                break;
+            case 'MIN':
+                accumulator = new Min(alias, expr, fromAlias, joinAliases);
+                break;
+            case 'MAX':
+                accumulator = new Max(alias, expr, fromAlias, joinAliases);
+                break;
+            default:
+                throw new Error(`Unsupported aggregate function: ${agg.expr.name}`);
+        }
+        if (isDistinct) {
+            // COUNT(*) should not be distinct
+            if (expr.type === 'star')
+                return accumulator;
+            return new DistinctWrapper(accumulator);
+        }
+        return accumulator;
+    });
+}
+//# sourceMappingURL=accumulators.js.map

package/lib/core/query-engine/accumulators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accumulators.js","sourceRoot":"","sources":["../../../src/core/query-engine/accumulators.ts"],"names":[],"mappings":"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"}

package/lib/core/query-engine/evaluator.js

@@ -0,0 +1,179 @@
+// @ts-nocheck
+/**
+ * Creates a function that evaluates a predicate AST node against a row.
+ * This is useful for filtering operations (e.g., in WHERE or JOIN ON clauses).
+ * The returned function is async to handle subqueries.
+ * @param {object} astNode The predicate AST node.
+ * @param {object} stack The ClientStack instance.
+ * @param {function} executePlan The main query execution function.
+ * @param {object} outerRow The row from the parent query context.
+ * @param {object} outerAliases The aliases from the parent query context.
+ * @returns {function(object): Promise<boolean>} An async function that takes a row and returns true if it matches the predicate.
+ */
+export function createRowEvaluator(astNode, stack, executePlan, outerRow, outerAliases) {
+    return async (row) => {
+        // Determine aliases from the current row context
+        const fromAlias = Object.keys(row).find(k => row[k] !== null) || Object.keys(row)[0];
+        const joinAliases = Object.keys(row).reduce((acc, key) => {
+            if (key !== fromAlias)
+                acc[key] = key; // simplified alias mapping
+            return acc;
+        }, {});
+        // The row being evaluated is the inner context, and we pass the captured outer context.
+        return await evalExpression(row, astNode, fromAlias, joinAliases, stack, executePlan, outerRow, outerAliases);
+    };
+}
+/**
+ * Evaluates an AST expression node against a data row. This function is async
+ * to handle scalar subqueries which require executing a separate query plan.
+ * @param {object} row The data row to evaluate against.
+ * @param {object} expr The AST expression node.
+ * @param {string} fromAlias The alias for the main FROM table.
+ * @param {object} joinAliases A map of aliases for joined tables.
+ * @param {object} stack The ClientStack instance for data access.
+ * @param {function} executePlan The function to execute sub-plans.
+ * @param {object} outerRow The row from the parent query context (for correlation).
+ * @param {object} outerAliases The aliases from the parent query context.
+ * @returns {Promise<*>} The result of the expression evaluation.
+ */
+export async function evalExpression(row, expr, fromAlias, joinAliases, stack, executePlan, outerRow, outerAliases) {
+    if (!expr)
+        return null;
+    switch (expr.type) {
+        case 'scalar_subquery': {
+            // Dynamically import planner to avoid circular dependency
+            const { createPlan } = await import('./planner');
+            const subqueryPlan = createPlan([expr.ast]);
+            // Execute the subquery, passing the current row as the outer context for correlation
+            const result = await executePlan(stack, subqueryPlan, [], row, null); // Pass outer row, but no aliases
+            if (result.length > 0 && result[0] != null) {
+                const firstRow = result[0];
+                const firstColName = Object.keys(firstRow)[0];
+                return firstRow[firstColName];
+            }
+            return null; // SQL standard: scalar subquery with no rows evaluates to NULL
+        }
+        case 'column_ref': {
+            const tableAlias = expr.table || fromAlias;
+            const tableData = row[tableAlias];
+            // 1. Check current row's data for the specified alias
+            if (tableData && typeof tableData === 'object' && tableData !== null && tableData.hasOwnProperty(expr.column)) {
+                return tableData[expr.column];
+            }
+            // 2. Fallback for simplified structures (e.g., aggregated rows)
+            if (row.hasOwnProperty(expr.column)) {
+                return row[expr.column];
+            }
+            // 3. Check outer context for correlated subqueries
+            if (outerRow) {
+                for (const alias in outerRow) {
+                    const outerTableData = outerRow[alias];
+                    if (outerTableData && typeof outerTableData === 'object' && outerTableData.hasOwnProperty(expr.column)) {
+                        // If an explicit table is specified in the expression (e.g., m.actors),
+                        // it must match the alias in the outer row.
+                        if (expr.table && expr.table !== alias) {
+                            continue;
+                        }
+                        return outerTableData[expr.column];
+                    }
+                }
+            }
+            return null;
+        }
+        case 'binary_expr': {
+            const left = await evalExpression(row, expr.left, fromAlias, joinAliases, stack, executePlan, outerRow, outerAliases);
+            let right;
+            if (expr.right.type === 'param') {
+                right = expr.right.value;
+                if (!isNaN(parseFloat(right)))
+                    right = parseFloat(right);
+            }
+            else {
+                right = await evalExpression(row, expr.right, fromAlias, joinAliases, stack, executePlan, outerRow, outerAliases);
+            }
+            switch (expr.operator) {
+                case '=': return left == right;
+                case '>': return left > right;
+                case '<': return left < right;
+                case '>=': return left >= right;
+                case '<=': return left <= right;
+                case 'IN': // This is handled specially during join execution
+                    return Array.isArray(right) && right.includes(left);
+                default:
+                    throw new Error(`Unsupported operator ${expr.operator}`);
+            }
+        }
+        case 'aggr_func':
+            // This should be handled by accumulators, but can be evaluated post-aggregation
+            if (row.hasOwnProperty(expr.name))
+                return row[expr.name];
+            return null;
+        case 'param':
+            let value = expr.value;
+            if (!isNaN(parseFloat(value)))
+                value = parseFloat(value);
+            return value;
+        case 'star':
+            return row; // Represents the whole row for COUNT(*)
+        default:
+            throw new Error(`Unsupported expression type: ${expr.type}`);
+    }
+}
+/**
+ * Evaluates an expression against a row that has already been aggregated.
+ * This is specifically used for the HAVING clause, where expressions can
+ * contain aggregate functions or GROUP BY columns.
+ * @param {object} row The aggregated data row.
+ * @param {object} expr The AST expression node from the HAVING clause.
+ * @param {Map<string, string>} aggregateAliasMap A map to resolve aggregate function expressions to their aliases in the row.
+ * @returns {*} The result of the expression evaluation.
+ * @throws {Error} If the expression is invalid for a HAVING clause.
+ */
+export function evalAggregatedRowExpression(row, expr, aggregateAliasMap) {
+    if (!expr)
+        return null;
+    switch (expr.type) {
+        case 'aggr_func':
+            const key = JSON.stringify(expr);
+            const alias = aggregateAliasMap.get(key);
+            if (alias && row.hasOwnProperty(alias)) {
+                return row[alias];
+            }
+            throw new Error(`Aggregate function ${expr.name} used in HAVING clause was not found in the SELECT list.`);
+        case 'column_ref':
+            // In an aggregated row, column refs point to GROUP BY keys.
+            const colName = expr.as || expr.column;
+            if (row.hasOwnProperty(colName)) {
+                return row[colName];
+            }
+            throw new Error(`Column '${colName}' not found in aggregated row. It must be part of the GROUP BY clause.`);
+        case 'binary_expr':
+            const left = evalAggregatedRowExpression(row, expr.left, aggregateAliasMap);
+            let right;
+            if (expr.right.type === 'param') {
+                right = expr.right.value;
+                if (!isNaN(parseFloat(right)))
+                    right = parseFloat(right);
+            }
+            else {
+                right = evalAggregatedRowExpression(row, expr.right, aggregateAliasMap);
+            }
+            switch (expr.operator) {
+                case '=': return left == right;
+                case '>': return left > right;
+                case '<': return left < right;
+                case '>=': return left >= right;
+                case '<=': return left <= right;
+                default:
+                    throw new Error(`Unsupported operator in HAVING clause: ${expr.operator}`);
+            }
+        case 'param':
+            let value = expr.value;
+            if (!isNaN(parseFloat(value)))
+                value = parseFloat(value);
+            return value;
+        default:
+            throw new Error(`Unsupported expression type in HAVING clause: ${expr.type}`);
+    }
+}
+//# sourceMappingURL=evaluator.js.map

package/lib/core/query-engine/evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.js","sourceRoot":"","sources":["../../../src/core/query-engine/evaluator.ts"],"names":[],"mappings":"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"}