@quereus/quereus 0.1.0

package/dist/src/planner/building/insert.js

@@ -0,0 +1,261 @@
+import { InsertNode } from '../nodes/insert-node.js';
+import { buildTableReference } from './table.js';
+import { QuereusError } from '../../common/errors.js';
+import { StatusCode } from '../../common/types.js';
+import { buildSelectStmt } from './select.js';
+import { buildWithClause } from './with.js';
+import { ValuesNode } from '../nodes/values-node.js';
+import { PlanNode } from '../nodes/plan-node.js';
+import { buildExpression } from './expression.js';
+import { checkColumnsAssignable, columnSchemaToDef } from '../type-utils.js';
+import { RegisteredScope } from '../scopes/registered.js';
+import { ColumnReferenceNode } from '../nodes/reference.js';
+import { SinkNode } from '../nodes/sink-node.js';
+import { ConstraintCheckNode } from '../nodes/constraint-check-node.js';
+import { RowOp } from '../../schema/table.js';
+import { ReturningNode } from '../nodes/returning-node.js';
+import { ProjectNode } from '../nodes/project-node.js';
+import { buildOldNewRowDescriptors } from '../../util/row-descriptor.js';
+import { DmlExecutorNode } from '../nodes/dml-executor-node.js';
+/**
+ * Creates a uniform row expansion projection that maps any relational source
+ * to the target table's column structure, filling in defaults for omitted columns.
+ * This ensures INSERT works orthogonally with any relational source.
+ */
+function createRowExpansionProjection(ctx, sourceNode, targetColumns, tableReference) {
+    const tableSchema = tableReference.tableSchema;
+    // If we're inserting into all columns in table order, no expansion needed
+    if (targetColumns.length === tableSchema.columns.length) {
+        const allColumnsMatch = targetColumns.every((tc, i) => tc.name.toLowerCase() === tableSchema.columns[i].name.toLowerCase());
+        if (allColumnsMatch) {
+            return sourceNode; // Source already matches table structure
+        }
+    }
+    // Create projection expressions for each table column
+    const projections = [];
+    const sourceAttributes = sourceNode.getAttributes();
+    tableSchema.columns.forEach((tableColumn) => {
+        // Find if this table column is in the target columns
+        const targetColIndex = targetColumns.findIndex(tc => tc.name.toLowerCase() === tableColumn.name.toLowerCase());
+        if (targetColIndex >= 0) {
+            // This column is provided by the source - reference the source column
+            if (targetColIndex < sourceAttributes.length) {
+                const sourceAttr = sourceAttributes[targetColIndex];
+                // Create a column reference to the source attribute
+                const columnRef = new ColumnReferenceNode(ctx.scope, { type: 'column', name: sourceAttr.name }, sourceAttr.type, sourceAttr.id, targetColIndex);
+                projections.push({
+                    node: columnRef,
+                    alias: tableColumn.name
+                });
+            }
+            else {
+                throw new QuereusError(`Source has fewer columns than expected for INSERT target columns`, StatusCode.ERROR);
+            }
+        }
+        else {
+            // This column is omitted - use default value or NULL
+            let defaultNode;
+            if (tableColumn.defaultValue !== undefined) {
+                // Use default value
+                if (typeof tableColumn.defaultValue === 'object' && tableColumn.defaultValue !== null && 'type' in tableColumn.defaultValue) {
+                    // It's an AST.Expression - build it into a plan node
+                    defaultNode = buildExpression(ctx, tableColumn.defaultValue);
+                }
+                else {
+                    // Literal default value
+                    defaultNode = buildExpression(ctx, { type: 'literal', value: tableColumn.defaultValue });
+                }
+            }
+            else {
+                // No default value - use NULL
+                defaultNode = buildExpression(ctx, { type: 'literal', value: null });
+            }
+            projections.push({
+                node: defaultNode,
+                alias: tableColumn.name
+            });
+        }
+    });
+    // Create projection node that expands source to table structure
+    return new ProjectNode(ctx.scope, sourceNode, projections);
+}
+/**
+ * Validates that RETURNING expressions use appropriate NEW/OLD qualifiers for the operation type
+ */
+function validateReturningExpression(expr, operationType) {
+    function checkExpression(e) {
+        if (e.type === 'column') {
+            if (e.table?.toLowerCase() === 'old' && operationType === 'INSERT') {
+                throw new QuereusError('OLD qualifier cannot be used in INSERT RETURNING clause', StatusCode.ERROR);
+            }
+            if (e.table?.toLowerCase() === 'new' && operationType === 'DELETE') {
+                throw new QuereusError('NEW qualifier cannot be used in DELETE RETURNING clause', StatusCode.ERROR);
+            }
+        }
+        else if (e.type === 'binary') {
+            checkExpression(e.left);
+            checkExpression(e.right);
+        }
+        else if (e.type === 'unary') {
+            checkExpression(e.expr);
+        }
+        else if (e.type === 'function') {
+            e.args.forEach(checkExpression);
+        }
+        else if (e.type === 'case') {
+            if (e.baseExpr)
+                checkExpression(e.baseExpr);
+            e.whenThenClauses.forEach(clause => {
+                checkExpression(clause.when);
+                checkExpression(clause.then);
+            });
+            if (e.elseExpr)
+                checkExpression(e.elseExpr);
+        }
+        else if (e.type === 'cast') {
+            checkExpression(e.expr);
+        }
+        else if (e.type === 'collate') {
+            checkExpression(e.expr);
+        }
+        else if (e.type === 'subquery') {
+            // Subqueries in RETURNING are complex - for now, we'll skip validation
+            // A full implementation would need to traverse the subquery's AST
+        }
+        else if (e.type === 'in') {
+            checkExpression(e.expr);
+            if (e.values) {
+                e.values.forEach(checkExpression);
+            }
+        }
+        else if (e.type === 'exists') {
+            // EXISTS subqueries are complex - skip validation for now
+        }
+        else if (e.type === 'windowFunction') {
+            checkExpression(e.function);
+        }
+        // Other expression types (literal, parameter) don't need validation
+    }
+    checkExpression(expr);
+}
+export function buildInsertStmt(ctx, stmt) {
+    const tableReference = buildTableReference({ type: 'table', table: stmt.table }, ctx);
+    let targetColumns = [];
+    if (stmt.columns && stmt.columns.length > 0) {
+        // Explicit columns specified
+        targetColumns = stmt.columns.map((colName, index) => columnSchemaToDef(colName, tableReference.tableSchema.columns[index]));
+    }
+    else {
+        // No explicit columns - default to all table columns in order
+        targetColumns = tableReference.tableSchema.columns.map(col => columnSchemaToDef(col.name, col));
+    }
+    let sourceNode;
+    if (stmt.values) {
+        // VALUES clause - build the VALUES node
+        const rows = stmt.values.map(rowExprs => rowExprs.map(expr => buildExpression(ctx, expr)));
+        // Check that there are the right number of columns in each row
+        rows.forEach(row => {
+            if (row.length !== targetColumns.length) {
+                throw new QuereusError(`Column count mismatch in VALUES clause. Expected ${targetColumns.length} columns, got ${row.length}.`, StatusCode.ERROR, undefined, stmt.loc?.start.line, stmt.loc?.start.column);
+            }
+        });
+        // Create VALUES node with target column names
+        const targetColumnNames = targetColumns.map(col => col.name);
+        sourceNode = new ValuesNode(ctx.scope, rows, targetColumnNames);
+    }
+    else if (stmt.select) {
+        // SELECT clause - build the SELECT statement
+        let parentCtes = new Map();
+        if (stmt.withClause) {
+            parentCtes = buildWithClause(ctx, stmt.withClause);
+        }
+        const selectPlan = buildSelectStmt(ctx, stmt.select, parentCtes);
+        if (selectPlan.getType().typeClass !== 'relation') {
+            throw new QuereusError('SELECT statement in INSERT did not produce a relational plan.', StatusCode.INTERNAL, undefined, stmt.loc?.start.line, stmt.loc?.start.column);
+        }
+        sourceNode = selectPlan;
+        checkColumnsAssignable(sourceNode.getType().columns, targetColumns, stmt);
+    }
+    else {
+        throw new QuereusError('INSERT statement must have a VALUES clause or a SELECT query.', StatusCode.ERROR);
+    }
+    // ORTHOGONAL ROW EXPANSION: Apply uniform row expansion to map any source to table structure with defaults
+    const expandedSourceNode = createRowExpansionProjection(ctx, sourceNode, targetColumns, tableReference);
+    // Update targetColumns to reflect all table columns since we've expanded the source
+    const finalTargetColumns = tableReference.tableSchema.columns.map(col => columnSchemaToDef(col.name, col));
+    // Create OLD/NEW attributes for INSERT (OLD = all NULL, NEW = actual values)
+    const oldAttributes = tableReference.tableSchema.columns.map((col) => ({
+        id: PlanNode.nextAttrId(),
+        name: col.name,
+        type: {
+            typeClass: 'scalar',
+            affinity: col.affinity,
+            nullable: true, // OLD values are always NULL for INSERT
+            isReadOnly: false
+        },
+        sourceRelation: `OLD.${tableReference.tableSchema.name}`
+    }));
+    const newAttributes = tableReference.tableSchema.columns.map((col) => ({
+        id: PlanNode.nextAttrId(),
+        name: col.name,
+        type: {
+            typeClass: 'scalar',
+            affinity: col.affinity,
+            nullable: !col.notNull,
+            isReadOnly: false
+        },
+        sourceRelation: `NEW.${tableReference.tableSchema.name}`
+    }));
+    const { oldRowDescriptor, newRowDescriptor, flatRowDescriptor } = buildOldNewRowDescriptors(oldAttributes, newAttributes);
+    const insertNode = new InsertNode(ctx.scope, tableReference, finalTargetColumns, expandedSourceNode, flatRowDescriptor);
+    const constraintCheckNode = new ConstraintCheckNode(ctx.scope, insertNode, tableReference, RowOp.INSERT, oldRowDescriptor, newRowDescriptor);
+    // Add DML executor node to perform the actual database insert operations
+    const dmlExecutorNode = new DmlExecutorNode(ctx.scope, constraintCheckNode, tableReference, 'insert', stmt.onConflict);
+    const resultNode = dmlExecutorNode;
+    if (stmt.returning && stmt.returning.length > 0) {
+        // Create returning scope with OLD/NEW attribute access
+        const returningScope = new RegisteredScope(ctx.scope);
+        // Register OLD.* symbols (always NULL for INSERT)
+        oldAttributes.forEach((attr, columnIndex) => {
+            const tableColumn = tableReference.tableSchema.columns[columnIndex];
+            returningScope.registerSymbol(`old.${tableColumn.name.toLowerCase()}`, (exp, s) => new ColumnReferenceNode(s, exp, attr.type, attr.id, columnIndex));
+        });
+        // Register NEW.* symbols and unqualified column names (default to NEW)
+        newAttributes.forEach((attr, columnIndex) => {
+            const tableColumn = tableReference.tableSchema.columns[columnIndex];
+            // NEW.column
+            returningScope.registerSymbol(`new.${tableColumn.name.toLowerCase()}`, (exp, s) => new ColumnReferenceNode(s, exp, attr.type, attr.id, columnIndex));
+            // Unqualified column (defaults to NEW)
+            returningScope.registerSymbol(tableColumn.name.toLowerCase(), (exp, s) => new ColumnReferenceNode(s, exp, attr.type, attr.id, columnIndex));
+            // Table-qualified form (table.column -> NEW)
+            const tblQualified = `${tableReference.tableSchema.name.toLowerCase()}.${tableColumn.name.toLowerCase()}`;
+            returningScope.registerSymbol(tblQualified, (exp, s) => new ColumnReferenceNode(s, exp, attr.type, attr.id, columnIndex));
+        });
+        // Build RETURNING projections in the OLD/NEW context
+        const returningProjections = stmt.returning.map(rc => {
+            // TODO: Support RETURNING *
+            if (rc.type === 'all')
+                throw new QuereusError('RETURNING * not yet supported', StatusCode.UNSUPPORTED);
+            // Infer alias from column name if not explicitly provided
+            let alias = rc.alias;
+            if (!alias && rc.expr.type === 'column') {
+                // For qualified column references like NEW.id, normalize to lowercase
+                if (rc.expr.table) {
+                    alias = `${rc.expr.table.toLowerCase()}.${rc.expr.name.toLowerCase()}`;
+                }
+                else {
+                    alias = rc.expr.name.toLowerCase();
+                }
+            }
+            // Validate that OLD references are not used in INSERT RETURNING
+            validateReturningExpression(rc.expr, 'INSERT');
+            return {
+                node: buildExpression({ ...ctx, scope: returningScope }, rc.expr),
+                alias: alias
+            };
+        });
+        return new ReturningNode(ctx.scope, dmlExecutorNode, returningProjections);
+    }
+    return new SinkNode(ctx.scope, resultNode, 'insert');
+}
+//# sourceMappingURL=insert.js.map

package/dist/src/planner/building/insert.js.map

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

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

@@ -0,0 +1,5 @@
+import type { PlanningContext } from '../planning-context.js';
+import * as AST from '../../parser/ast.js';
+import type { PlanNode } from '../nodes/plan-node.js';
+export declare function buildPragmaStmt(ctx: PlanningContext, stmt: AST.PragmaStmt): PlanNode;
+//# sourceMappingURL=pragma.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pragma.d.ts","sourceRoot":"","sources":["../../../../src/planner/building/pragma.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,GAAG,MAAM,qBAAqB,CAAC;AAM3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,wBAAgB,eAAe,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,GAAG,CAAC,UAAU,GAAG,QAAQ,CAuBpF"}

package/dist/src/planner/building/pragma.js

@@ -0,0 +1,28 @@
+import { QuereusError } from '../../common/errors.js';
+import { StatusCode } from '../../common/types.js';
+import { PragmaPlanNode } from '../nodes/pragma.js';
+import { SinkNode } from '../nodes/sink-node.js';
+import { getSyncLiteral } from '../../parser/utils.js';
+export function buildPragmaStmt(ctx, stmt) {
+    const pragmaName = stmt.name.toLowerCase();
+    let value;
+    if (stmt.value) {
+        if (stmt.value.type === 'literal') {
+            value = getSyncLiteral(stmt.value);
+        }
+        else if (stmt.value.type === 'identifier') {
+            value = stmt.value.name;
+        }
+        else {
+            throw new QuereusError(`Unsupported PRAGMA value type: ${stmt.value.type}`, StatusCode.ERROR);
+        }
+    }
+    const pragmaNode = new PragmaPlanNode(ctx.scope, pragmaName, stmt, value);
+    // If this is a setting operation (has a value), wrap with SinkNode to ensure execution
+    if (value !== undefined) {
+        return new SinkNode(ctx.scope, pragmaNode, 'pragma-set');
+    }
+    // Reading operation - return the PRAGMA node directly
+    return pragmaNode;
+}
+//# sourceMappingURL=pragma.js.map

package/dist/src/planner/building/pragma.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pragma.js","sourceRoot":"","sources":["../../../../src/planner/building/pragma.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAiB,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,MAAM,UAAU,eAAe,CAAC,GAAoB,EAAE,IAAoB;IACzE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IAE3C,IAAI,KAA2B,CAAC;IAChC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAChB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACnC,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC7C,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QACzB,CAAC;aAAM,CAAC;YACP,MAAM,IAAI,YAAY,CAAC,kCAAmC,IAAI,CAAC,KAAa,CAAC,IAAI,EAAE,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;QACxG,CAAC;IACF,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAE1E,uFAAuF;IACvF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;IAC1D,CAAC;IAED,sDAAsD;IACtD,OAAO,UAAU,CAAC;AACnB,CAAC"}

package/dist/src/planner/building/schema-resolution.d.ts

@@ -0,0 +1,25 @@
+import type { PlanningContext } from '../planning-context.js';
+import type { TableSchema } from '../../schema/table.js';
+import type { FunctionSchema } from '../../schema/function.js';
+import type { VirtualTableModule } from '../../vtab/module.js';
+import type { CollationFunction } from '../../util/comparison.js';
+/**
+ * Resolves a table schema at build time and records the dependency.
+ */
+export declare function resolveTableSchema(ctx: PlanningContext, tableName: string, schemaName?: string): TableSchema;
+/**
+ * Resolves a function schema at build time and records the dependency.
+ */
+export declare function resolveFunctionSchema(ctx: PlanningContext, funcName: string, numArgs: number): FunctionSchema;
+/**
+ * Resolves a virtual table module at build time and records the dependency.
+ */
+export declare function resolveVtabModule(ctx: PlanningContext, moduleName: string): {
+    module: VirtualTableModule<any, any>;
+    auxData?: unknown;
+};
+/**
+ * Resolves a collation function at build time and records the dependency.
+ */
+export declare function resolveCollation(ctx: PlanningContext, collationName: string): CollationFunction;
+//# sourceMappingURL=schema-resolution.d.ts.map

package/dist/src/planner/building/schema-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-resolution.d.ts","sourceRoot":"","sources":["../../../../src/planner/building/schema-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAOlE;;GAEG;AACH,wBAAgB,kBAAkB,CACjC,GAAG,EAAE,eAAe,EACpB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GACjB,WAAW,CAiCb;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACb,cAAc,CAqChB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,eAAe,EACpB,UAAU,EAAE,MAAM,GAChB;IAAE,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CA+B7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,eAAe,EACpB,aAAa,EAAE,MAAM,GACnB,iBAAiB,CA+BnB"}

package/dist/src/planner/building/schema-resolution.js

@@ -0,0 +1,119 @@
+import { QuereusError } from '../../common/errors.js';
+import { StatusCode } from '../../common/types.js';
+import { createLogger } from '../../common/logger.js';
+const log = createLogger('planner:schema-resolution');
+/**
+ * Resolves a table schema at build time and records the dependency.
+ */
+export function resolveTableSchema(ctx, tableName, schemaName) {
+    const resolvedSchemaName = schemaName || ctx.db.schemaManager.getCurrentSchemaName();
+    const cacheKey = `table:${resolvedSchemaName}:${tableName}`;
+    // Check cache first
+    const cached = ctx.schemaCache.get(cacheKey);
+    if (cached) {
+        log('Using cached table schema: %s.%s', resolvedSchemaName, tableName);
+        return cached;
+    }
+    // Resolve table schema
+    const tableSchema = ctx.schemaManager.findTable(tableName, resolvedSchemaName);
+    if (!tableSchema) {
+        throw new QuereusError(`Table not found: ${resolvedSchemaName}.${tableName}`, StatusCode.ERROR);
+    }
+    // Record dependency
+    const dependency = {
+        type: 'table',
+        schemaName: tableSchema.schemaName,
+        objectName: tableSchema.name
+    };
+    ctx.schemaDependencies.recordDependency(dependency, tableSchema);
+    // Cache result
+    ctx.schemaCache.set(cacheKey, tableSchema);
+    log('Resolved table schema: %s.%s', tableSchema.schemaName, tableSchema.name);
+    return tableSchema;
+}
+/**
+ * Resolves a function schema at build time and records the dependency.
+ */
+export function resolveFunctionSchema(ctx, funcName, numArgs) {
+    const cacheKey = `function:${funcName}/${numArgs}`;
+    // Check cache first
+    const cached = ctx.schemaCache.get(cacheKey);
+    if (cached) {
+        log('Using cached function schema: %s/%d', funcName, numArgs);
+        return cached;
+    }
+    // Resolve function schema - try exact match first
+    let functionSchema = ctx.schemaManager.findFunction(funcName, numArgs);
+    // If not found, try variable argument function
+    if (!functionSchema) {
+        functionSchema = ctx.schemaManager.findFunction(funcName, -1);
+    }
+    if (!functionSchema) {
+        throw new QuereusError(`Function not found: ${funcName}/${numArgs}`, StatusCode.ERROR);
+    }
+    // Record dependency using the actual function's numArgs
+    const dependency = {
+        type: 'function',
+        objectName: `${functionSchema.name}/${functionSchema.numArgs}`
+    };
+    ctx.schemaDependencies.recordDependency(dependency, functionSchema);
+    // Cache result with the requested key for future lookups
+    ctx.schemaCache.set(cacheKey, functionSchema);
+    log('Resolved function schema: %s/%d', functionSchema.name, functionSchema.numArgs);
+    return functionSchema;
+}
+/**
+ * Resolves a virtual table module at build time and records the dependency.
+ */
+export function resolveVtabModule(ctx, moduleName) {
+    const cacheKey = `vtab_module:${moduleName}`;
+    // Check cache first
+    const cached = ctx.schemaCache.get(cacheKey);
+    if (cached) {
+        log('Using cached vtab module: %s', moduleName);
+        return cached;
+    }
+    // Resolve vtab module
+    const moduleInfo = ctx.schemaManager.getModule(moduleName);
+    if (!moduleInfo) {
+        throw new QuereusError(`Virtual table module not found: ${moduleName}`, StatusCode.ERROR);
+    }
+    // Record dependency
+    const dependency = {
+        type: 'vtab_module',
+        objectName: moduleName
+    };
+    ctx.schemaDependencies.recordDependency(dependency, moduleInfo);
+    // Cache result
+    ctx.schemaCache.set(cacheKey, moduleInfo);
+    log('Resolved vtab module: %s', moduleName);
+    return moduleInfo;
+}
+/**
+ * Resolves a collation function at build time and records the dependency.
+ */
+export function resolveCollation(ctx, collationName) {
+    const cacheKey = `collation:${collationName}`;
+    // Check cache first
+    const cached = ctx.schemaCache.get(cacheKey);
+    if (cached) {
+        log('Using cached collation: %s', collationName);
+        return cached;
+    }
+    // Resolve collation
+    const collation = ctx.db._getCollation(collationName);
+    if (!collation) {
+        throw new QuereusError(`Collation not found: ${collationName}`, StatusCode.ERROR);
+    }
+    // Record dependency
+    const dependency = {
+        type: 'collation',
+        objectName: collationName
+    };
+    ctx.schemaDependencies.recordDependency(dependency, collation);
+    // Cache result
+    ctx.schemaCache.set(cacheKey, collation);
+    log('Resolved collation: %s', collationName);
+    return collation;
+}
+//# sourceMappingURL=schema-resolution.js.map

package/dist/src/planner/building/schema-resolution.js.map

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

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

@@ -0,0 +1,22 @@
+import type * as AST from '../../parser/ast.js';
+import type { RelationalPlanNode, ScalarPlanNode } from '../nodes/plan-node.js';
+import type { PlanningContext } from '../planning-context.js';
+import { type Projection } from '../nodes/project-node.js';
+import { RegisteredScope } from '../scopes/registered.js';
+/**
+ * Processes GROUP BY, aggregates, and HAVING clauses
+ */
+export declare function buildAggregatePhase(input: RelationalPlanNode, stmt: AST.SelectStmt, selectContext: PlanningContext, aggregates: {
+    expression: ScalarPlanNode;
+    alias: string;
+}[], hasAggregates: boolean, projections: Projection[]): {
+    output: RelationalPlanNode;
+    aggregateScope?: RegisteredScope;
+    needsFinalProjection: boolean;
+    preAggregateSort: boolean;
+};
+/**
+ * Builds final projections for the complete SELECT list in aggregate context
+ */
+export declare function buildFinalAggregateProjections(stmt: AST.SelectStmt, selectContext: PlanningContext, aggregateOutputScope: RegisteredScope): Projection[];
+//# sourceMappingURL=select-aggregates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"select-aggregates.d.ts","sourceRoot":"","sources":["../../../../src/planner/building/select-aggregates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAI9D,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAM1D;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,kBAAkB,EACzB,IAAI,EAAE,GAAG,CAAC,UAAU,EACpB,aAAa,EAAE,eAAe,EAC9B,UAAU,EAAE;IAAE,UAAU,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,EAC3D,aAAa,EAAE,OAAO,EACtB,WAAW,EAAE,UAAU,EAAE,GACvB;IACF,MAAM,EAAE,kBAAkB,CAAC;IAC3B,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,gBAAgB,EAAE,OAAO,CAAC;CAC1B,CAmEA;AA6HD;;GAEG;AACH,wBAAgB,8BAA8B,CAC7C,IAAI,EAAE,GAAG,CAAC,UAAU,EACpB,aAAa,EAAE,eAAe,EAC9B,oBAAoB,EAAE,eAAe,GACnC,UAAU,EAAE,CAiBd"}