mongo.do 0.1.0

package/dist/translator/stages/lookup-stage.js

@@ -0,0 +1,73 @@
+/**
+ * $lookup stage - Performs a left outer join with another collection
+ * Translates to SQL LEFT JOIN or subquery
+ */
+import { getFieldPath } from './expression-translator';
+export function translateLookupStage(lookup, context) {
+    const params = [];
+    const { localField, foreignField } = lookup;
+    if (localField && foreignField) {
+        // Simple lookup with localField/foreignField
+        return translateSimpleLookup(lookup, context, params);
+    }
+    else if (lookup.let && lookup.pipeline) {
+        // Pipeline lookup
+        return translatePipelineLookup(lookup, context, params);
+    }
+    throw new Error('$lookup requires either localField/foreignField or let/pipeline');
+}
+function translateSimpleLookup(lookup, context, params) {
+    const { from, localField, foreignField, as } = lookup;
+    const source = context.previousCte || context.collection;
+    const localPath = getFieldPath('$' + localField);
+    const foreignPath = getFieldPath('$' + foreignField);
+    // Use a subquery to collect matching documents as a JSON array
+    const cteName = `stage_${context.cteIndex}`;
+    const cteExpression = `
+    SELECT
+      ${source}.data,
+      COALESCE(
+        (SELECT json_group_array(${from}.data)
+         FROM ${from}
+         WHERE json_extract(${from}.data, '${foreignPath}') = json_extract(${source}.data, '${localPath}')),
+        '[]'
+      ) AS lookup_result
+    FROM ${source}
+  `;
+    // The result should merge lookup_result into data as the 'as' field
+    const selectClause = `json_set(data, '$.${as}', json(lookup_result)) AS data`;
+    return {
+        cteExpression: cteExpression.trim(),
+        cteName,
+        selectClause,
+        params,
+        transformsShape: true
+    };
+}
+function translatePipelineLookup(lookup, context, params) {
+    const { from, as } = lookup;
+    // For pipeline lookups, we need to handle variable substitution
+    // This is a simplified implementation
+    const source = context.previousCte || context.collection;
+    const cteName = `stage_${context.cteIndex}`;
+    // Build the inner query for the lookup
+    // In a full implementation, we'd translate the pipeline with variable substitution
+    const cteExpression = `
+    SELECT
+      ${source}.data,
+      COALESCE(
+        (SELECT json_group_array(${from}.data) FROM ${from}),
+        '[]'
+      ) AS lookup_result
+    FROM ${source}
+  `;
+    const selectClause = `json_set(data, '$.${as}', json(lookup_result)) AS data`;
+    return {
+        cteExpression: cteExpression.trim(),
+        cteName,
+        selectClause,
+        params,
+        transformsShape: true
+    };
+}
+//# sourceMappingURL=lookup-stage.js.map

package/dist/translator/stages/lookup-stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup-stage.js","sourceRoot":"","sources":["../../../src/translator/stages/lookup-stage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAEtD,MAAM,UAAU,oBAAoB,CAClC,MAAmB,EACnB,OAAqB;IAErB,MAAM,MAAM,GAAc,EAAE,CAAA;IAC5B,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,CAAA;IAE3C,IAAI,UAAU,IAAI,YAAY,EAAE,CAAC;QAC/B,6CAA6C;QAC7C,OAAO,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;IACvD,CAAC;SAAM,IAAI,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACzC,kBAAkB;QAClB,OAAO,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;IACzD,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAA;AACpF,CAAC;AAED,SAAS,qBAAqB,CAC5B,MAAmB,EACnB,OAAqB,EACrB,MAAiB;IAEjB,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE,EAAE,GAAG,MAAM,CAAA;IAErD,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,UAAU,CAAA;IACxD,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,GAAG,UAAW,CAAC,CAAA;IACjD,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,GAAG,YAAa,CAAC,CAAA;IAErD,+DAA+D;IAC/D,MAAM,OAAO,GAAG,SAAS,OAAO,CAAC,QAAQ,EAAE,CAAA;IAC3C,MAAM,aAAa,GAAG;;QAEhB,MAAM;;mCAEqB,IAAI;gBACvB,IAAI;8BACU,IAAI,WAAW,WAAW,qBAAqB,MAAM,WAAW,SAAS;;;WAG5F,MAAM;GACd,CAAA;IAED,oEAAoE;IACpE,MAAM,YAAY,GAAG,qBAAqB,EAAE,iCAAiC,CAAA;IAE7E,OAAO;QACL,aAAa,EAAE,aAAa,CAAC,IAAI,EAAE;QACnC,OAAO;QACP,YAAY;QACZ,MAAM;QACN,eAAe,EAAE,IAAI;KACtB,CAAA;AACH,CAAC;AAED,SAAS,uBAAuB,CAC9B,MAAmB,EACnB,OAAqB,EACrB,MAAiB;IAEjB,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,MAAM,CAAA;IAE3B,gEAAgE;IAChE,sCAAsC;IACtC,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,UAAU,CAAA;IACxD,MAAM,OAAO,GAAG,SAAS,OAAO,CAAC,QAAQ,EAAE,CAAA;IAE3C,uCAAuC;IACvC,mFAAmF;IACnF,MAAM,aAAa,GAAG;;QAEhB,MAAM;;mCAEqB,IAAI,eAAe,IAAI;;;WAG/C,MAAM;GACd,CAAA;IAED,MAAM,YAAY,GAAG,qBAAqB,EAAE,iCAAiC,CAAA;IAE7E,OAAO;QACL,aAAa,EAAE,aAAa,CAAC,IAAI,EAAE;QACnC,OAAO;QACP,YAAY;QACZ,MAAM;QACN,eAAe,EAAE,IAAI;KACtB,CAAA;AACH,CAAC"}

package/dist/translator/stages/match-stage.d.ts

@@ -0,0 +1,7 @@
+/**
+ * $match stage - Filters documents based on a query condition
+ * Translates to SQL WHERE clause using QueryTranslator
+ */
+import type { StageResult, StageContext } from './types';
+export declare function translateMatchStage(matchQuery: Record<string, unknown>, _context: StageContext): StageResult;
+//# sourceMappingURL=match-stage.d.ts.map

package/dist/translator/stages/match-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-stage.d.ts","sourceRoot":"","sources":["../../../src/translator/stages/match-stage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAExD,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,QAAQ,EAAE,YAAY,GACrB,WAAW,CAQb"}

package/dist/translator/stages/match-stage.js

@@ -0,0 +1,14 @@
+/**
+ * $match stage - Filters documents based on a query condition
+ * Translates to SQL WHERE clause using QueryTranslator
+ */
+import { QueryTranslator } from '../query-translator';
+export function translateMatchStage(matchQuery, _context) {
+    const queryTranslator = new QueryTranslator();
+    const { sql, params } = queryTranslator.translate(matchQuery);
+    return {
+        whereClause: sql,
+        params
+    };
+}
+//# sourceMappingURL=match-stage.js.map

package/dist/translator/stages/match-stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-stage.js","sourceRoot":"","sources":["../../../src/translator/stages/match-stage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAGrD,MAAM,UAAU,mBAAmB,CACjC,UAAmC,EACnC,QAAsB;IAEtB,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAA;IAC7C,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;IAE7D,OAAO;QACL,WAAW,EAAE,GAAG;QAChB,MAAM;KACP,CAAA;AACH,CAAC"}

package/dist/translator/stages/optimizer.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Pipeline Optimizer - Optimizes aggregation pipelines before translation
+ *
+ * Optimizations:
+ * 1. Predicate pushdown: Move $match stages as early as possible
+ * 2. Projection pushdown: Reduce fields carried through pipeline
+ * 3. Stage merging: Combine adjacent compatible stages
+ * 4. Redundant stage elimination
+ */
+import type { PipelineStage } from './types';
+/**
+ * Optimize an aggregation pipeline
+ */
+export declare function optimizePipeline(pipeline: PipelineStage[]): PipelineStage[];
+//# sourceMappingURL=optimizer.d.ts.map

package/dist/translator/stages/optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimizer.d.ts","sourceRoot":"","sources":["../../../src/translator/stages/optimizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAS3E"}

package/dist/translator/stages/optimizer.js

@@ -0,0 +1,249 @@
+/**
+ * Pipeline Optimizer - Optimizes aggregation pipelines before translation
+ *
+ * Optimizations:
+ * 1. Predicate pushdown: Move $match stages as early as possible
+ * 2. Projection pushdown: Reduce fields carried through pipeline
+ * 3. Stage merging: Combine adjacent compatible stages
+ * 4. Redundant stage elimination
+ */
+/**
+ * Optimize an aggregation pipeline
+ */
+export function optimizePipeline(pipeline) {
+    let optimized = [...pipeline];
+    // Apply optimizations in order
+    optimized = pushdownPredicates(optimized);
+    optimized = mergeAdjacentStages(optimized);
+    optimized = eliminateRedundantStages(optimized);
+    return optimized;
+}
+/**
+ * Push $match stages as early as possible in the pipeline
+ * This reduces the number of documents processed by subsequent stages
+ */
+function pushdownPredicates(pipeline) {
+    const result = [];
+    for (let i = 0; i < pipeline.length; i++) {
+        const stage = pipeline[i];
+        const stageType = getStageType(stage);
+        if (stageType !== '$match') {
+            result.push(stage);
+            continue;
+        }
+        // Try to push this $match earlier
+        const matchCondition = stage.$match;
+        const pushPosition = findEarliestPushPosition(result, matchCondition);
+        if (pushPosition < result.length) {
+            // Insert at the earlier position
+            result.splice(pushPosition, 0, stage);
+        }
+        else {
+            result.push(stage);
+        }
+    }
+    return result;
+}
+/**
+ * Find the earliest position where a $match can be pushed
+ */
+function findEarliestPushPosition(stages, matchCondition) {
+    const matchFields = extractFieldsFromCondition(matchCondition);
+    // Walk backwards through stages
+    for (let i = stages.length - 1; i >= 0; i--) {
+        const stage = stages[i];
+        const stageType = getStageType(stage);
+        // Can't push past stages that modify the fields we're matching on
+        if (stageType === '$group') {
+            // $group completely changes document shape
+            return i + 1;
+        }
+        if (stageType === '$project' || stageType === '$addFields') {
+            const projectFields = getAffectedFields(stage);
+            if (matchFields.some(f => projectFields.has(f))) {
+                return i + 1;
+            }
+        }
+        if (stageType === '$unwind') {
+            const unwindField = getUnwindField(stage);
+            if (matchFields.some(f => f === unwindField || f.startsWith(unwindField + '.'))) {
+                return i + 1;
+            }
+        }
+        if (stageType === '$lookup') {
+            const lookupAs = getLookupAsField(stage);
+            if (matchFields.some(f => f === lookupAs || f.startsWith(lookupAs + '.'))) {
+                return i + 1;
+            }
+        }
+        // $sort, $limit, $skip don't affect fields
+        // We can generally push $match past them (though order matters for correctness)
+        if (stageType === '$limit' || stageType === '$skip') {
+            // Can't push past limit/skip as it changes result set
+            return i + 1;
+        }
+    }
+    return 0;
+}
+/**
+ * Merge adjacent compatible stages
+ */
+function mergeAdjacentStages(pipeline) {
+    const result = [];
+    for (const stage of pipeline) {
+        if (result.length === 0) {
+            result.push(stage);
+            continue;
+        }
+        const prevStage = result[result.length - 1];
+        const merged = tryMergeStages(prevStage, stage);
+        if (merged) {
+            result[result.length - 1] = merged;
+        }
+        else {
+            result.push(stage);
+        }
+    }
+    return result;
+}
+/**
+ * Try to merge two stages into one
+ */
+function tryMergeStages(first, second) {
+    const firstType = getStageType(first);
+    const secondType = getStageType(second);
+    // Merge adjacent $match stages
+    if (firstType === '$match' && secondType === '$match') {
+        const firstMatch = first.$match;
+        const secondMatch = second.$match;
+        return {
+            $match: {
+                $and: [firstMatch, secondMatch]
+            }
+        };
+    }
+    // Merge adjacent $addFields stages
+    if (firstType === '$addFields' && secondType === '$addFields') {
+        const firstFields = first.$addFields;
+        const secondFields = second.$addFields;
+        return {
+            $addFields: {
+                ...firstFields,
+                ...secondFields
+            }
+        };
+    }
+    // Merge adjacent $project stages (if compatible)
+    if (firstType === '$project' && secondType === '$project') {
+        const firstProject = first.$project;
+        const secondProject = second.$project;
+        // Only merge if both are inclusion or both are exclusion
+        const firstIsExclusion = isExclusionProject(firstProject);
+        const secondIsExclusion = isExclusionProject(secondProject);
+        if (firstIsExclusion === secondIsExclusion) {
+            return {
+                $project: {
+                    ...firstProject,
+                    ...secondProject
+                }
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Eliminate redundant stages
+ */
+function eliminateRedundantStages(pipeline) {
+    return pipeline.filter((stage, index) => {
+        const stageType = getStageType(stage);
+        // Remove empty $match
+        if (stageType === '$match') {
+            const matchCondition = stage.$match;
+            if (Object.keys(matchCondition).length === 0) {
+                return false;
+            }
+        }
+        // Remove $limit 0 followed by anything (no results anyway)
+        if (stageType === '$limit') {
+            const limit = stage.$limit;
+            if (limit === 0) {
+                // Keep only this stage, remove rest
+                return true;
+            }
+        }
+        // Remove duplicate $sort stages (only last one matters)
+        if (stageType === '$sort' && index < pipeline.length - 1) {
+            for (let i = index + 1; i < pipeline.length; i++) {
+                const laterStageType = getStageType(pipeline[i]);
+                if (laterStageType === '$sort') {
+                    return false;
+                }
+                // If we hit a stage that depends on order, keep this sort
+                if (['$limit', '$skip', '$first', '$last'].includes(laterStageType)) {
+                    return true;
+                }
+            }
+        }
+        return true;
+    });
+}
+/**
+ * Helper functions
+ */
+function getStageType(stage) {
+    return Object.keys(stage)[0];
+}
+function extractFieldsFromCondition(condition) {
+    const fields = [];
+    for (const [key, value] of Object.entries(condition)) {
+        if (key.startsWith('$')) {
+            // Logical operator
+            if (Array.isArray(value)) {
+                for (const subCondition of value) {
+                    fields.push(...extractFieldsFromCondition(subCondition));
+                }
+            }
+        }
+        else {
+            fields.push(key);
+        }
+    }
+    return fields;
+}
+function getAffectedFields(stage) {
+    const stageType = getStageType(stage);
+    const fields = new Set();
+    if (stageType === '$project') {
+        const project = stage.$project;
+        for (const key of Object.keys(project)) {
+            fields.add(key);
+        }
+    }
+    else if (stageType === '$addFields') {
+        const addFields = stage.$addFields;
+        for (const key of Object.keys(addFields)) {
+            fields.add(key);
+        }
+    }
+    return fields;
+}
+function getUnwindField(stage) {
+    const unwind = stage.$unwind;
+    if (typeof unwind === 'string') {
+        return unwind.replace(/^\$/, '');
+    }
+    return unwind.path.replace(/^\$/, '');
+}
+function getLookupAsField(stage) {
+    const lookup = stage.$lookup;
+    return lookup.as;
+}
+function isExclusionProject(project) {
+    return Object.entries(project).every(([key, value]) => {
+        if (key === '_id')
+            return true;
+        return value === 0;
+    });
+}
+//# sourceMappingURL=optimizer.js.map

package/dist/translator/stages/optimizer.js.map

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

package/dist/translator/stages/parallel-facet.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Parallel Facet Executor - Executes multiple facet pipelines concurrently
+ *
+ * This module provides utilities for executing facet queries in parallel,
+ * taking advantage of the independent nature of each facet.
+ */
+export interface FacetQuery {
+    name: string;
+    sql: string;
+    params: unknown[];
+}
+export interface FacetResult {
+    name: string;
+    rows: unknown[];
+}
+export interface FacetExecutionPlan {
+    /** Queries that can be executed in parallel */
+    parallelQueries: FacetQuery[];
+    /** Combined result structure */
+    combineResults: (results: FacetResult[]) => Record<string, unknown[]>;
+}
+/**
+ * Create an execution plan for parallel facet queries
+ */
+export declare function createFacetExecutionPlan(facets: Record<string, {
+    sql: string;
+    params: unknown[];
+}>): FacetExecutionPlan;
+/**
+ * Example executor interface for parallel facet execution
+ * This would be implemented by the database layer
+ */
+export interface ParallelExecutor {
+    executeParallel(queries: FacetQuery[]): Promise<FacetResult[]>;
+}
+/**
+ * Create a mock parallel executor for testing
+ */
+export declare function createMockParallelExecutor(queryHandler: (sql: string, params: unknown[]) => unknown[]): ParallelExecutor;
+/**
+ * Batch facet execution - groups queries for efficient execution
+ */
+export declare function batchFacetQueries(facets: Record<string, {
+    sql: string;
+    params: unknown[];
+}>, batchSize?: number): FacetQuery[][];
+//# sourceMappingURL=parallel-facet.d.ts.map

package/dist/translator/stages/parallel-facet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-facet.d.ts","sourceRoot":"","sources":["../../../src/translator/stages/parallel-facet.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,OAAO,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,OAAO,EAAE,CAAA;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,eAAe,EAAE,UAAU,EAAE,CAAA;IAC7B,gCAAgC;IAChC,cAAc,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;CACtE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,GACzD,kBAAkB,CAiBpB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;CAC/D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,GAC1D,gBAAgB,CAalB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,EAC1D,SAAS,GAAE,MAAU,GACpB,UAAU,EAAE,EAAE,CAahB"}

package/dist/translator/stages/parallel-facet.js

@@ -0,0 +1,57 @@
+/**
+ * Parallel Facet Executor - Executes multiple facet pipelines concurrently
+ *
+ * This module provides utilities for executing facet queries in parallel,
+ * taking advantage of the independent nature of each facet.
+ */
+/**
+ * Create an execution plan for parallel facet queries
+ */
+export function createFacetExecutionPlan(facets) {
+    const parallelQueries = Object.entries(facets).map(([name, query]) => ({
+        name,
+        sql: query.sql,
+        params: query.params
+    }));
+    return {
+        parallelQueries,
+        combineResults: (results) => {
+            const combined = {};
+            for (const result of results) {
+                combined[result.name] = result.rows;
+            }
+            return combined;
+        }
+    };
+}
+/**
+ * Create a mock parallel executor for testing
+ */
+export function createMockParallelExecutor(queryHandler) {
+    return {
+        async executeParallel(queries) {
+            // Execute all queries in parallel using Promise.all
+            const results = await Promise.all(queries.map(async (query) => ({
+                name: query.name,
+                rows: queryHandler(query.sql, query.params)
+            })));
+            return results;
+        }
+    };
+}
+/**
+ * Batch facet execution - groups queries for efficient execution
+ */
+export function batchFacetQueries(facets, batchSize = 3) {
+    const queries = Object.entries(facets).map(([name, query]) => ({
+        name,
+        sql: query.sql,
+        params: query.params
+    }));
+    const batches = [];
+    for (let i = 0; i < queries.length; i += batchSize) {
+        batches.push(queries.slice(i, i + batchSize));
+    }
+    return batches;
+}
+//# sourceMappingURL=parallel-facet.js.map

package/dist/translator/stages/parallel-facet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-facet.js","sourceRoot":"","sources":["../../../src/translator/stages/parallel-facet.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAA0D;IAE1D,MAAM,eAAe,GAAiB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACnF,IAAI;QACJ,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC,CAAA;IAEH,OAAO;QACL,eAAe;QACf,cAAc,EAAE,CAAC,OAAsB,EAAE,EAAE;YACzC,MAAM,QAAQ,GAA8B,EAAE,CAAA;YAC9C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAA;YACrC,CAAC;YACD,OAAO,QAAQ,CAAA;QACjB,CAAC;KACF,CAAA;AACH,CAAC;AAUD;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,YAA2D;IAE3D,OAAO;QACL,KAAK,CAAC,eAAe,CAAC,OAAqB;YACzC,oDAAoD;YACpD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;gBAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC;aAC5C,CAAC,CAAC,CACJ,CAAA;YACD,OAAO,OAAO,CAAA;QAChB,CAAC;KACF,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAA0D,EAC1D,YAAoB,CAAC;IAErB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7D,IAAI;QACJ,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC,CAAA;IAEH,MAAM,OAAO,GAAmB,EAAE,CAAA;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAA;IAC/C,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/translator/stages/project-stage.d.ts

@@ -0,0 +1,8 @@
+/**
+ * $project stage - Reshapes documents by including, excluding, or computing fields
+ * Translates to SQL SELECT with json_object, json_remove, or computed expressions
+ * Supports multiple SQL dialects (SQLite, ClickHouse)
+ */
+import type { StageResult, StageContext } from './types';
+export declare function translateProjectStage(projection: Record<string, unknown>, context: StageContext): StageResult;
+//# sourceMappingURL=project-stage.d.ts.map

package/dist/translator/stages/project-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-stage.d.ts","sourceRoot":"","sources":["../../../src/translator/stages/project-stage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAwCxD,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,EAAE,YAAY,GACpB,WAAW,CAiBb"}

package/dist/translator/stages/project-stage.js

@@ -0,0 +1,145 @@
+/**
+ * $project stage - Reshapes documents by including, excluding, or computing fields
+ * Translates to SQL SELECT with json_object, json_remove, or computed expressions
+ * Supports multiple SQL dialects (SQLite, ClickHouse)
+ */
+import { translateExpression, isFieldReference, getFieldPath } from './expression-translator';
+import { validateFieldPath } from '../../utils/sql-safety.js';
+import { jsonExtract as dialectJsonExtract } from '../dialect';
+/**
+ * Recursively collect all field references from a $function expression's args
+ */
+function collectFunctionFieldRefs(expr) {
+    if (!expr || typeof expr !== 'object')
+        return [];
+    const fields = [];
+    const exprObj = expr;
+    // Check if this is a $function expression
+    if ('$function' in exprObj) {
+        const fnSpec = exprObj.$function;
+        if (fnSpec.args && Array.isArray(fnSpec.args)) {
+            for (const arg of fnSpec.args) {
+                if (isFieldReference(arg)) {
+                    // Extract field name from $fieldName reference
+                    const fieldName = arg.substring(1).split('.')[0];
+                    if (fieldName) {
+                        fields.push(fieldName);
+                    }
+                }
+            }
+        }
+    }
+    // Recursively check nested objects
+    for (const value of Object.values(exprObj)) {
+        if (value && typeof value === 'object') {
+            fields.push(...collectFunctionFieldRefs(value));
+        }
+    }
+    return fields;
+}
+export function translateProjectStage(projection, context) {
+    const params = [];
+    const dialect = context.dialect || 'sqlite';
+    const fields = Object.entries(projection);
+    // Check if it's an exclusion projection (all values are 0 except _id)
+    const isExclusion = fields.every(([key, value]) => {
+        if (key === '_id')
+            return true;
+        return value === 0;
+    });
+    if (isExclusion) {
+        return translateExclusionProject(projection, context, params, dialect);
+    }
+    // Inclusion or computed projection
+    return translateInclusionProject(projection, context, params, dialect);
+}
+function translateExclusionProject(projection, _context, params, dialect = 'sqlite') {
+    const fieldsToRemove = Object.entries(projection)
+        .filter(([key, value]) => value === 0 && key !== '_id')
+        .map(([key]) => {
+        // Validate field name to prevent SQL injection
+        validateFieldPath(key);
+        return `'$.${key}'`;
+    });
+    let selectClause;
+    if (fieldsToRemove.length > 0) {
+        if (dialect === 'clickhouse') {
+            // ClickHouse doesn't have json_remove, would need different approach
+            selectClause = 'data'; // Simplified for now
+        }
+        else {
+            selectClause = `json_remove(data, ${fieldsToRemove.join(', ')}) AS data`;
+        }
+    }
+    else {
+        selectClause = 'data';
+    }
+    return {
+        selectClause,
+        params
+    };
+}
+function translateInclusionProject(projection, _context, params, dialect = 'sqlite') {
+    const jsonParts = [];
+    // Collect all field references needed by $function expressions
+    // These need to be included in the output so the function executor can extract them
+    const functionFieldRefs = new Set();
+    for (const [, value] of Object.entries(projection)) {
+        if (typeof value === 'object' && value !== null) {
+            const refs = collectFunctionFieldRefs(value);
+            refs.forEach(ref => functionFieldRefs.add(ref));
+        }
+    }
+    // First, add the explicitly projected fields
+    const explicitFields = new Set();
+    for (const [key, value] of Object.entries(projection)) {
+        // Validate key (output field name) to prevent SQL injection
+        validateFieldPath(key);
+        explicitFields.add(key);
+        if (value === 1) {
+            // Include existing field
+            const fieldExpr = dialectJsonExtract(dialect, 'data', `$.${key}`);
+            jsonParts.push(`'${key}', ${fieldExpr}`);
+        }
+        else if (typeof value === 'string' && value.startsWith('$')) {
+            // Field reference (renaming) - getFieldPath validates the field
+            const fieldPath = getFieldPath(value);
+            const fieldExpr = dialectJsonExtract(dialect, 'data', fieldPath);
+            jsonParts.push(`'${key}', ${fieldExpr}`);
+        }
+        else if (typeof value === 'object' && value !== null) {
+            // Expression
+            const exprSql = translateExpression(value, params, dialect);
+            jsonParts.push(`'${key}', ${exprSql}`);
+        }
+        else if (value !== 0) {
+            // Literal value
+            if (typeof value === 'string') {
+                params.push(value);
+                jsonParts.push(`'${key}', ?`);
+            }
+            else if (typeof value === 'number' || typeof value === 'boolean') {
+                jsonParts.push(`'${key}', ${JSON.stringify(value)}`);
+            }
+        }
+    }
+    // Add source fields needed by $function that aren't already projected
+    // These will be used by the function executor to extract argument values
+    for (const fieldRef of functionFieldRefs) {
+        if (!explicitFields.has(fieldRef)) {
+            // Validate field reference to prevent SQL injection
+            validateFieldPath(fieldRef);
+            const fieldExpr = dialectJsonExtract(dialect, 'data', `$.${fieldRef}`);
+            jsonParts.push(`'${fieldRef}', ${fieldExpr}`);
+        }
+    }
+    const selectClause = dialect === 'clickhouse'
+        ? `tuple(${jsonParts.join(', ')}) AS data`
+        : `json_object(${jsonParts.join(', ')}) AS data`;
+    return {
+        selectClause,
+        params,
+        transformsShape: true
+    };
+}
+//# sourceMappingURL=project-stage.js.map