@warlock.js/cascade 4.6.0 → 4.7.0

package/esm/drivers/mongodb/mongodb-query-parser.mjs

@@ -69,7 +69,7 @@ var MongoQueryParser = class {
 		const pipeline = [];
 		let currentStage = null;
 		let currentBuffer = [];
-		for (const op of this.operations) if (op.mergeable && op.stage === currentStage) currentBuffer.push(op);
+		for (const op of this.orderStages(this.operations)) if (op.mergeable && op.stage === currentStage) currentBuffer.push(op);
 		else {
 			if (currentBuffer.length > 0) {
 				const builtStage = this.buildStage(currentStage, currentBuffer);
@@ -104,6 +104,38 @@ var MongoQueryParser = class {
 		return this.postProcessGroupStages(pipeline);
 	}
 	/**
+	* Reorder operations so filters run before projections, mirroring SQL
+	* semantics: in `select(...).where(...)`, the WHERE always applies to the
+	* source columns regardless of call order. Without this, a `$project` that
+	* strips the filter column would run before the `$match` and silently drop
+	* every document (`select(["a"]).where("b", x)` → `[]`).
+	*
+	* Only *mergeable* `$match` operations are hoisted, and only within a
+	* segment of neighboring mergeable `$match` / `$project` / `$sort`
+	* operations. Any other operation — `$group`, `$lookup`, `$limit`, `$skip`,
+	* `$setWindowFields`, or a non-mergeable op (raw escapes, having-style
+	* post-group matches, `$sample`) — is a barrier: nothing moves across it.
+	* So `groupBy(...).where(...)` still filters AFTER the group, and
+	* `limit(...)` / `random()` keep their call-order meaning.
+	*/
+	orderStages(operations) {
+		const reordered = [];
+		let segment = [];
+		const flushSegment = () => {
+			if (segment.length === 0) return;
+			reordered.push(...segment.filter((op) => op.stage === "$match"));
+			reordered.push(...segment.filter((op) => op.stage !== "$match"));
+			segment = [];
+		};
+		for (const op of operations) if (op.mergeable && (op.stage === "$match" || op.stage === "$project" || op.stage === "$sort")) segment.push(op);
+		else {
+			flushSegment();
+			reordered.push(op);
+		}
+		flushSegment();
+		return reordered;
+	}
+	/**
 	* Track field names for group stages that need _id renaming.
 	*/
 	trackGroupFieldNames(stage, operations, stageIndex) {

package/esm/drivers/mongodb/mongodb-query-parser.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mongodb-query-parser.mjs","names":[],"sources":["../../../../../../../../@warlock.js/cascade/src/drivers/mongodb/mongodb-query-parser.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { Collection } from \"mongodb\";\nimport type { GroupByInput, RawExpression, WhereOperator } from \"../../contracts\";\nimport {\n  isAggregateExpression,\n  type AggregateExpression,\n} from \"../../expressions/aggregate-expressions\";\nimport type { ColumnExpression } from \"../../expressions/column-expressions\";\nimport type { MongoQueryBuilder } from \"./mongodb-query-builder\";\nimport type { Operation, PipelineStage } from \"./types\";\n\n/**\n * Options for configuring the MongoDB query parser.\n */\nexport type MongoQueryParserOptions = {\n  /** The MongoDB collection being queried */\n  collection: Collection;\n  /** The ordered list of operations to parse */\n  operations: Operation[];\n  /** Factory method for creating sub-builders (used for callbacks) */\n  createSubBuilder: () => MongoQueryBuilder;\n};\n\n/**\n * Parses query builder operations into MongoDB aggregation pipeline.\n *\n * This parser is responsible for converting the abstract operations collected\n * by the query builder into a concrete MongoDB aggregation pipeline. It handles\n * intelligent grouping of mergeable operations (like multiple where clauses)\n * into single pipeline stages for optimal performance.\n */\nexport class MongoQueryParser {\n  /**\n   * The MongoDB collection being queried.\n   */\n  private readonly collection: Collection;\n\n  /**\n   * The ordered list of operations to parse.\n   */\n  private readonly operations: Operation[];\n\n  /**\n   * Factory for creating sub-builders (used when resolving callbacks).\n   */\n  private readonly createSubBuilder: () => MongoQueryBuilder;\n\n  /**\n   * Track group field names for automatic _id renaming.\n   * Maps pipeline index to field names.\n   */\n  private readonly groupFieldNames = new Map<number, string | string[]>();\n\n  /**\n   * Track `countDistinct` aggregate aliases per group stage. The renaming\n   * `$project` finalizes these with `{ $size: \"$alias\" }` over the set built\n   * by `$addToSet` in the `$group` stage.\n   * Maps pipeline index to the set of aliases needing `$size` finalization.\n   */\n  private readonly countDistinctAliases = new Map<number, Set<string>>();\n\n  /**\n   * Create a new MongoDB query parser.\n   *\n   * @param options - Configuration options for the parser\n   */\n  public constructor(options: MongoQueryParserOptions) {\n    this.collection = options.collection;\n    this.operations = options.operations;\n    this.createSubBuilder = options.createSubBuilder;\n  }\n\n  /**\n   * Parse the operations into a MongoDB aggregation pipeline.\n   *\n   * This method intelligently groups mergeable operations (e.g., multiple where\n   * clauses) into single pipeline stages while maintaining the correct execution\n   * order for non-mergeable operations.\n   *\n   * @returns The MongoDB aggregation pipeline\n   *\n   * @example\n   * ```typescript\n   * const parser = new MongoQueryParser({ collection, operations });\n   * const pipeline = parser.parse();\n   * // [\n   * //   { $match: { status: 'active', age: { $gt: 18 } } },\n   * //   { $sort: { createdAt: -1 } },\n   * //   { $limit: 10 }\n   * // ]\n   * ```\n   */\n  public parse(): any[] {\n    const pipeline: any[] = [];\n    let currentStage: PipelineStage | null = null;\n    let currentBuffer: Operation[] = [];\n\n    for (const op of this.operations) {\n      if (op.mergeable && op.stage === currentStage) {\n        // Same mergeable stage, add to buffer\n        currentBuffer.push(op);\n      } else {\n        // Different stage or non-mergeable, flush buffer\n        if (currentBuffer.length > 0) {\n          const builtStage = this.buildStage(currentStage!, currentBuffer);\n          if (builtStage) {\n            const stageIndex = pipeline.length;\n            pipeline.push(builtStage);\n            // Track field names for group stages with aggregates\n            this.trackGroupFieldNames(currentStage!, currentBuffer, stageIndex);\n          }\n          currentBuffer = [];\n        }\n\n        if (op.mergeable) {\n          // Start new buffer\n          currentStage = op.stage;\n          currentBuffer.push(op);\n        } else {\n          // Non-mergeable, add directly\n          const builtStage = this.buildStage(op.stage, [op]);\n          if (builtStage) {\n            const stageIndex = pipeline.length;\n            pipeline.push(builtStage);\n            // Track field names for group stages with aggregates\n            this.trackGroupFieldNames(op.stage, [op], stageIndex);\n          }\n          currentStage = null;\n        }\n      }\n    }\n\n    // Flush remaining buffer\n    if (currentBuffer.length > 0) {\n      const builtStage = this.buildStage(currentStage!, currentBuffer);\n      if (builtStage) {\n        const stageIndex = pipeline.length;\n        pipeline.push(builtStage);\n        // Track field names for group stages with aggregates\n        this.trackGroupFieldNames(currentStage!, currentBuffer, stageIndex);\n      }\n    }\n\n    // Post-process: Rename _id to actual field names after $group stages with aggregates\n    return this.postProcessGroupStages(pipeline);\n  }\n\n  /**\n   * Track field names for group stages that need _id renaming.\n   */\n  private trackGroupFieldNames(\n    stage: PipelineStage,\n    operations: Operation[],\n    stageIndex: number,\n  ): void {\n    if (stage === \"$group\") {\n      const op = operations[0];\n      if (op.type === \"groupByWithAggregates\" && op.data.fields) {\n        const fieldNames = this.extractGroupFieldNames(op.data.fields);\n        if (fieldNames) {\n          this.groupFieldNames.set(stageIndex, fieldNames);\n        }\n\n        this.trackCountDistinctAliases(stageIndex, op.data.aggregates);\n      } else if (op.type === \"groupByDate\") {\n        // The `$dateTrunc` bucket becomes `_id`; rename it back to the column.\n        this.groupFieldNames.set(stageIndex, op.data.column as string);\n        this.trackCountDistinctAliases(stageIndex, op.data.aggregates ?? {});\n      }\n    }\n  }\n\n  /**\n   * Record which aggregate aliases in a group stage are `countDistinct` so the\n   * renaming `$project` can finalize them with `{ $size: \"$alias\" }` over the\n   * set built by `$addToSet` (the standard distinct-count-per-group pattern).\n   */\n  private trackCountDistinctAliases(\n    stageIndex: number,\n    aggregates: Record<string, RawExpression>,\n  ): void {\n    const distinctAliases = new Set<string>();\n    for (const [alias, expression] of Object.entries(aggregates)) {\n      if (isAggregateExpression(expression) && expression.__agg === \"countDistinct\") {\n        distinctAliases.add(alias);\n      }\n    }\n\n    if (distinctAliases.size > 0) {\n      this.countDistinctAliases.set(stageIndex, distinctAliases);\n    }\n  }\n\n  /**\n   * Post-process pipeline to rename _id fields after $group stages.\n   *\n   * This automatically renames MongoDB's `_id` field to the actual field name(s)\n   * used for grouping, making the results more intuitive.\n   *\n   * @param pipeline - The aggregation pipeline\n   * @returns The processed pipeline\n   */\n  private postProcessGroupStages(pipeline: any[]): any[] {\n    const processed: any[] = [];\n\n    for (let i = 0; i < pipeline.length; i++) {\n      const stage = pipeline[i];\n\n      // Check if this is a $group stage that needs _id renaming\n      if (stage.$group && this.groupFieldNames.has(i)) {\n        const fieldNames = this.groupFieldNames.get(i)!;\n\n        // Add the $group stage\n        processed.push(stage);\n\n        // Add a $project stage to rename _id\n        const projection: Record<string, unknown> = {};\n\n        if (typeof fieldNames === \"string\") {\n          // Single field: rename _id to field name\n          projection[fieldNames] = \"$_id\";\n        } else if (Array.isArray(fieldNames) && fieldNames.length > 0) {\n          // Multiple fields: _id is an object, spread it\n          for (const fieldName of fieldNames) {\n            projection[fieldName] = `$_id.${fieldName}`;\n          }\n        }\n\n        // Include all aggregate fields. countDistinct aliases are finalized\n        // with `{ $size: \"$alias\" }` over the set built by `$addToSet`; every\n        // other aggregate is projected through as-is.\n        const distinctAliases = this.countDistinctAliases.get(i);\n        const aggregateFields = Object.keys(stage.$group).filter((key) => key !== \"_id\");\n        for (const field of aggregateFields) {\n          if (distinctAliases?.has(field)) {\n            projection[field] = { $size: `$${field}` };\n          } else {\n            projection[field] = 1;\n          }\n        }\n\n        if (Object.keys(projection).length > 0) {\n          // now unselect the _id field\n          projection._id = 0;\n          processed.push({ $project: projection });\n        }\n      } else {\n        // Regular stage, add as-is\n        processed.push(stage);\n      }\n    }\n\n    return processed;\n  }\n\n  /**\n   * Convert the parsed pipeline to a pretty-printed string for debugging.\n   *\n   * This method formats the MongoDB aggregation pipeline in a human-readable\n   * way, making it easier to understand and debug complex queries.\n   *\n   * @returns A formatted string representation of the pipeline\n   *\n   * @example\n   * ```typescript\n   * const parser = new MongoQueryParser({ collection, operations });\n   * console.log(parser.toPrettyString());\n   * // Output:\n   * // MongoDB Aggregation Pipeline:\n   * // ════════════════════════════\n   * // Stage 1: $match\n   * //   status: \"active\"\n   * //   age: { $gt: 18 }\n   * //\n   * // Stage 2: $sort\n   * //   createdAt: -1\n   * ```\n   */\n  public toPrettyString(): string {\n    const pipeline = this.parse();\n\n    if (pipeline.length === 0) {\n      return \"MongoDB Aggregation Pipeline: (empty)\";\n    }\n\n    let output = \"MongoDB Aggregation Pipeline:\\n\";\n    output += \"═\".repeat(50) + \"\\n\";\n\n    pipeline.forEach((stage, index) => {\n      const stageName = Object.keys(stage)[0];\n      const stageData = stage[stageName];\n\n      if (index > 0) {\n        output += \"\\n\";\n      }\n\n      output += `Stage ${index + 1}: ${colors.redBright(stageName)}\\n`;\n      output += this.formatStageData(stageData, 2);\n    });\n\n    return output;\n  }\n\n  /**\n   * Format stage data with proper indentation.\n   *\n   * @param data - The stage data to format\n   * @param indent - The indentation level\n   * @returns Formatted string\n   */\n  private formatStageData(data: any, indent: number = 0): string {\n    const spaces = \" \".repeat(indent);\n\n    if (typeof data !== \"object\" || data === null) {\n      return `${spaces}${JSON.stringify(data)}\\n`;\n    }\n\n    if (Array.isArray(data)) {\n      if (data.length === 0) return `${spaces}[]`;\n\n      let result = \"\";\n      data.forEach((item, index) => {\n        result += `${spaces}[${colors.magenta(index)}]:\\n`;\n        result += this.formatStageData(item, indent + 2);\n      });\n      return result;\n    }\n\n    let result = \"\";\n    Object.entries(data).forEach(([key, value]) => {\n      const isOperator = key.startsWith(\"$\");\n      const coloredKey = isOperator ? colors.magentaBright(key) : colors.blue(key);\n\n      if (typeof value === \"object\" && value !== null && !Array.isArray(value)) {\n        result += `${spaces}${coloredKey}:\\n`;\n        result += this.formatStageData(value, indent + 2);\n      } else if (Array.isArray(value)) {\n        result += `${spaces}${coloredKey}:\\n`;\n        result += this.formatStageData(value, indent + 2);\n      } else {\n        const formattedValue =\n          typeof value === \"number\"\n            ? colors.yellowBright(value)\n            : typeof value === \"boolean\"\n              ? colors.cyanBright(value.toString())\n              : typeof value === \"string\"\n                ? colors.greenBright(JSON.stringify(value))\n                : colors.greenBright(String(value));\n        result += `${spaces}${coloredKey}: ${formattedValue}\\n`;\n      }\n    });\n\n    return result.endsWith(\"\\n\") ? result : `${result}\\n`;\n  }\n\n  /**\n   * Build a single pipeline stage from a group of operations.\n   *\n   * @param stage - The pipeline stage type\n   * @param operations - The operations to build the stage from\n   * @returns The built pipeline stage or null if no stage should be added\n   */\n  private buildStage(stage: PipelineStage, operations: Operation[]): any {\n    switch (stage) {\n      case \"$match\":\n        return this.buildMatchStage(operations);\n      case \"$project\":\n        return this.buildProjectStage(operations);\n      case \"$sort\":\n        return this.buildSortStage(operations);\n      case \"$group\":\n        return this.buildGroupStage(operations);\n      case \"$lookup\":\n        return this.buildLookupStage(operations);\n      case \"$limit\":\n        return { $limit: operations[0].data.value };\n      case \"$skip\":\n        return { $skip: operations[0].data.value };\n      case \"$setWindowFields\":\n        return {\n          $setWindowFields: operations[0].data.spec,\n        };\n      default:\n        return null;\n    }\n  }\n\n  /**\n   * Build a $match stage from where operations.\n   *\n   * Query building strategy:\n   * - Top-level where() + orWhere() = Pure OR\n   * - Use callbacks for AND + OR grouping\n   *\n   * @param operations - The where operations\n   * @returns The $match stage or null\n   */\n  private buildMatchStage(operations: Operation[]): any {\n    const andFilter: Record<string, any> = {};\n    const orClauses: any[] = [];\n    const pendingSimpleWhere: any[] = [];\n    let topLevelOrMode = false;\n\n    const pushOr = (clause: any): void => {\n      if (!clause) {\n        return;\n      }\n\n      if (this.isPureOrCondition(clause)) {\n        orClauses.push(...clause.$or);\n        return;\n      }\n\n      if (Array.isArray(clause)) {\n        orClauses.push(...clause);\n        return;\n      }\n\n      orClauses.push(clause);\n    };\n\n    const mergeAnd = (condition: any): void => {\n      if (!condition) {\n        return;\n      }\n\n      Object.entries(condition).forEach(([key, value]) => {\n        if (key === \"$or\") {\n          pushOr(value);\n          return;\n        }\n\n        if (\n          value &&\n          typeof value === \"object\" &&\n          !Array.isArray(value) &&\n          andFilter[key] &&\n          typeof andFilter[key] === \"object\" &&\n          !Array.isArray(andFilter[key])\n        ) {\n          andFilter[key] = { ...andFilter[key], ...value };\n        } else {\n          andFilter[key] = value;\n        }\n      });\n    };\n\n    const queueSimpleWhere = (condition: any): void => {\n      if (!condition) {\n        return;\n      }\n      if (topLevelOrMode) {\n        pushOr(condition);\n      } else {\n        pendingSimpleWhere.push(condition);\n      }\n    };\n\n    const enterTopLevelOrMode = (): void => {\n      if (topLevelOrMode) {\n        return;\n      }\n      topLevelOrMode = true;\n      while (pendingSimpleWhere.length > 0) {\n        const condition = pendingSimpleWhere.shift();\n        if (condition) {\n          pushOr(condition);\n        }\n      }\n    };\n\n    const flushPendingSimpleWhere = (): void => {\n      if (pendingSimpleWhere.length === 0) {\n        return;\n      }\n      if (topLevelOrMode) {\n        pendingSimpleWhere.forEach(pushOr);\n      } else {\n        pendingSimpleWhere.forEach(mergeAnd);\n      }\n      pendingSimpleWhere.length = 0;\n    };\n\n    for (const op of operations) {\n      if (op.type === \"where:callback\" || op.type === \"orWhere:callback\") {\n        flushPendingSimpleWhere();\n        const callbackCondition = this.buildCallbackCondition(op.data);\n        if (!callbackCondition) {\n          continue;\n        }\n\n        const treatAsOr =\n          op.type === \"orWhere:callback\" ||\n          (topLevelOrMode && !this.isPureOrCondition(callbackCondition)) ||\n          this.isPureOrCondition(callbackCondition);\n\n        if (treatAsOr) {\n          if (op.type === \"orWhere:callback\") {\n            enterTopLevelOrMode();\n          }\n          pushOr(callbackCondition);\n        } else {\n          mergeAnd(callbackCondition);\n        }\n        continue;\n      }\n\n      if (op.type === \"where:object\") {\n        queueSimpleWhere(op.data);\n        continue;\n      }\n\n      if (\n        op.type === \"where:not\" ||\n        op.type === \"orWhere:not\" ||\n        op.type === \"where:exists\" ||\n        op.type === \"where:notExists\"\n      ) {\n        const negated = op.type === \"where:not\" || op.type === \"where:notExists\";\n        const nested = this.buildCallbackCondition(op.data.callback);\n        if (nested) {\n          const condition = negated ? { $nor: [nested] } : nested;\n          if (op.type.startsWith(\"orWhere\")) {\n            enterTopLevelOrMode();\n            pushOr(condition);\n          } else {\n            queueSimpleWhere(condition);\n          }\n        }\n        continue;\n      }\n\n      if (op.type === \"orWhere:object\") {\n        enterTopLevelOrMode();\n        pushOr(op.data);\n        continue;\n      }\n\n      const condition = this.buildWhereCondition(op);\n      if (!condition) {\n        continue;\n      }\n\n      if (op.type.startsWith(\"orWhere\")) {\n        enterTopLevelOrMode();\n        pushOr(condition);\n      } else {\n        queueSimpleWhere(condition);\n      }\n    }\n\n    flushPendingSimpleWhere();\n\n    const hasAnd = Object.keys(andFilter).length > 0;\n    const hasOr = orClauses.length > 0;\n\n    if (!hasAnd && !hasOr) {\n      return null;\n    }\n\n    const match: any = {};\n    if (hasAnd) {\n      Object.assign(match, andFilter);\n    }\n    if (hasOr) {\n      match.$or = orClauses;\n    }\n\n    return { $match: match };\n  }\n\n  private isPureOrCondition(condition: any): condition is { $or: any[] } {\n    return (\n      condition &&\n      typeof condition === \"object\" &&\n      !Array.isArray(condition) &&\n      Object.keys(condition).length === 1 &&\n      Array.isArray((condition as any).$or)\n    );\n  }\n\n  /**\n   * Build a condition from a callback-based where clause.\n   * Creates a sub-builder, executes the callback, and extracts the conditions.\n   * If callback has orWhere, all conditions become OR.\n   *\n   * @param callback - The callback function\n   * @returns The built condition or null\n   */\n  private buildCallbackCondition(callback: any): any {\n    // Create a temporary sub-builder\n    const subBuilder = this.createSubBuilder();\n\n    // Execute the callback with the sub-builder\n    callback(subBuilder);\n\n    // Extract only match operations from the sub-builder\n    const matchOps = subBuilder.operations.filter((op: Operation) => op.stage === \"$match\");\n\n    if (matchOps.length === 0) {\n      return null;\n    }\n\n    const andFilter: Record<string, any> = {};\n    const orClauses: any[] = [];\n    const hasInternalOr = matchOps.some((op) => op.type.startsWith(\"orWhere\"));\n\n    const pushOr = (clause: any): void => {\n      if (!clause) {\n        return;\n      }\n      if (this.isPureOrCondition(clause)) {\n        orClauses.push(...clause.$or);\n        return;\n      }\n      orClauses.push(clause);\n    };\n\n    if (hasInternalOr) {\n      for (const op of matchOps) {\n        if (op.type === \"where:callback\" || op.type === \"orWhere:callback\") {\n          const nestedCondition = this.buildCallbackCondition(op.data);\n          if (nestedCondition) {\n            pushOr(nestedCondition);\n          }\n          continue;\n        }\n\n        if (op.type === \"where:object\" || op.type === \"orWhere:object\") {\n          pushOr(op.data);\n          continue;\n        }\n\n        const condition = this.buildWhereCondition(op);\n        if (condition) {\n          pushOr(condition);\n        }\n      }\n\n      return orClauses.length > 0 ? { $or: orClauses } : null;\n    }\n\n    for (const op of matchOps) {\n      if (op.type === \"where:callback\") {\n        const nestedCondition = this.buildCallbackCondition(op.data);\n        if (nestedCondition) {\n          Object.assign(andFilter, nestedCondition);\n        }\n      } else if (op.type === \"where:object\") {\n        Object.assign(andFilter, op.data);\n      } else {\n        const condition = this.buildWhereCondition(op);\n        if (condition) {\n          Object.assign(andFilter, condition);\n        }\n      }\n    }\n\n    return Object.keys(andFilter).length > 0 ? andFilter : null;\n  }\n\n  /**\n   * Build a MongoDB filter condition from a where operation.\n   *\n   * @param op - The operation to build\n   * @returns The MongoDB filter condition\n   */\n  private buildWhereCondition(op: Operation): any {\n    const { field, operator, value } = op.data;\n\n    switch (op.type) {\n      case \"where\":\n      case \"orWhere\":\n        return this.buildOperatorCondition(field, operator, value);\n\n      case \"whereIn\":\n        return { [field]: { $in: value || op.data.values } };\n\n      case \"whereNotIn\":\n        return { [field]: { $nin: value || op.data.values } };\n\n      case \"whereNull\":\n        return { [field]: null };\n\n      case \"whereNotNull\":\n        return { [field]: { $ne: null } };\n\n      case \"whereBetween\":\n        return {\n          [field]: {\n            $gte: op.data.range[0],\n            $lte: op.data.range[1],\n          },\n        };\n\n      case \"whereNotBetween\":\n        return {\n          [field]: {\n            $not: {\n              $gte: op.data.range[0],\n              $lte: op.data.range[1],\n            },\n          },\n        };\n\n      case \"whereLike\": {\n        const pattern =\n          typeof op.data.pattern === \"string\" ? op.data.pattern : op.data.pattern.source;\n        return { [field]: { $regex: pattern, $options: \"i\" } };\n      }\n\n      case \"whereNotLike\": {\n        const notPattern =\n          typeof op.data.pattern === \"string\" ? op.data.pattern : op.data.pattern.source;\n        return { [field]: { $not: { $regex: notPattern, $options: \"i\" } } };\n      }\n\n      case \"whereStartsWith\":\n        return { [field]: { $regex: `^${op.data.value}`, $options: \"i\" } };\n\n      case \"whereNotStartsWith\":\n        return {\n          [field]: { $not: { $regex: `^${op.data.value}`, $options: \"i\" } },\n        };\n\n      case \"whereEndsWith\":\n        return { [field]: { $regex: `${op.data.value}$`, $options: \"i\" } };\n\n      case \"whereNotEndsWith\":\n        return {\n          [field]: { $not: { $regex: `${op.data.value}$`, $options: \"i\" } },\n        };\n\n      case \"whereExists\":\n        return { [field]: { $exists: true } };\n\n      case \"whereNotExists\":\n        return { [field]: { $exists: false } };\n\n      case \"whereSize\":\n        if (op.data.operator === \"=\") {\n          return { [field]: { $size: op.data.size } };\n        } else {\n          const mongoOp = this.getMongoOperator(op.data.operator);\n          return {\n            $expr: {\n              [mongoOp]: [{ $size: `$${field}` }, op.data.size],\n            },\n          };\n        }\n\n      case \"textSearch\":\n        return {\n          $text: { $search: op.data.query },\n          ...(op.data.filters || {}),\n        };\n\n      case \"whereRaw\":\n      case \"orWhereRaw\":\n        return this.resolveRawExpression(\n          op.data.expression as RawExpression,\n          op.data.bindings,\n        );\n\n      case \"whereColumn\":\n      case \"orWhereColumn\":\n        return this.buildColumnComparison(op.data.first, op.data.operator, op.data.second);\n\n      case \"whereBetweenColumns\":\n        return this.buildBetweenColumnsCondition(\n          op.data.field,\n          op.data.lowerColumn,\n          op.data.upperColumn,\n        );\n\n      case \"whereDate\":\n      case \"whereDateEquals\":\n        return this.buildDateEqualityCondition(op.data.field, op.data.value);\n\n      case \"whereDateBefore\":\n        return this.buildDateBeforeCondition(op.data.field, op.data.value);\n\n      case \"whereDateAfter\":\n        return this.buildDateAfterCondition(op.data.field, op.data.value);\n\n      case \"whereTime\":\n        return this.buildTimeCondition(op.data.field, op.data.value);\n\n      case \"whereDay\":\n        return this.buildDatePartCondition(op.data.field, \"$dayOfMonth\", op.data.value);\n\n      case \"whereMonth\":\n        return this.buildDatePartCondition(op.data.field, \"$month\", op.data.value);\n\n      case \"whereYear\":\n        return this.buildDatePartCondition(op.data.field, \"$year\", op.data.value);\n\n      case \"whereJsonContains\":\n        return this.buildJsonContainsCondition(op.data.path, op.data.value);\n\n      case \"whereJsonDoesntContain\":\n        return this.buildJsonDoesntContainCondition(op.data.path, op.data.value);\n\n      case \"whereJsonContainsKey\":\n        return this.buildJsonContainsKeyCondition(op.data.path);\n\n      case \"whereJsonLength\":\n        return this.buildJsonLengthCondition(\n          op.data.path,\n          op.data.operator,\n          op.data.value,\n        );\n\n      case \"whereJsonIsArray\":\n        return this.buildJsonTypeCondition(op.data.path, \"array\");\n\n      case \"whereJsonIsObject\":\n        return this.buildJsonTypeCondition(op.data.path, \"object\");\n\n      case \"whereArrayLength\":\n        return this.buildArrayLengthCondition(\n          op.data.field,\n          op.data.operator,\n          op.data.value,\n        );\n\n      case \"whereFullText\":\n      case \"orWhereFullText\":\n        return { $text: { $search: op.data.query } };\n\n      case \"whereSearch\":\n        return {\n          [op.data.field]: {\n            $regex: op.data.query,\n            $options: \"i\",\n          },\n        };\n\n      case \"where:not\":\n      case \"orWhere:not\": {\n        const nestedNot = this.buildCallbackCondition(op.data.callback);\n        return nestedNot ? { $nor: [nestedNot] } : null;\n      }\n\n      case \"where:exists\":\n        return this.buildCallbackCondition(op.data.callback);\n\n      case \"where:notExists\": {\n        const nestedExists = this.buildCallbackCondition(op.data.callback);\n        return nestedExists ? { $nor: [nestedExists] } : null;\n      }\n\n      case \"whereArrayContains\":\n        if (op.data.key) {\n          return {\n            [field]: {\n              $elemMatch: { [op.data.key]: op.data.value },\n            },\n          };\n        } else {\n          return { [field]: op.data.value };\n        }\n\n      default:\n        return null;\n    }\n  }\n\n  /**\n   * Build a condition based on the operator.\n   *\n   * @param field - The field name\n   * @param operator - The comparison operator\n   * @param value - The value to compare\n   * @returns The MongoDB filter condition\n   */\n  private buildOperatorCondition(field: string, operator: string, value: unknown): any {\n    switch (operator) {\n      case \"=\":\n        return { [field]: value };\n      case \"!=\":\n        return { [field]: { $ne: value } };\n      case \">\":\n        return { [field]: { $gt: value } };\n      case \">=\":\n        return { [field]: { $gte: value } };\n      case \"<\":\n        return { [field]: { $lt: value } };\n      case \"<=\":\n        return { [field]: { $lte: value } };\n      default:\n        return { [field]: value };\n    }\n  }\n\n  /**\n   * Get MongoDB operator from comparison operator.\n   *\n   * @param operator - The comparison operator\n   * @returns The MongoDB operator\n   */\n  private getMongoOperator(operator: string): string {\n    const map: Record<string, string> = {\n      \"=\": \"$eq\",\n      \"!=\": \"$ne\",\n      \">\": \"$gt\",\n      \">=\": \"$gte\",\n      \"<\": \"$lt\",\n      \"<=\": \"$lte\",\n    };\n    return map[operator] || \"$eq\";\n  }\n\n  private resolveRawExpression(expression: RawExpression, bindings?: unknown[]): any {\n    if (typeof expression === \"string\") {\n      const bound = this.bindRawString(expression, bindings);\n      return { $where: bound };\n    }\n\n    if (typeof expression === \"object\" && expression !== null) {\n      return expression;\n    }\n\n    return null;\n  }\n\n  private bindRawString(expression: string, bindings?: unknown[]): string {\n    if (!bindings || bindings.length === 0) {\n      return expression;\n    }\n\n    let index = 0;\n    return expression.replace(/\\?/g, () => {\n      const value = bindings[index++];\n      return value === undefined ? \"?\" : JSON.stringify(value);\n    });\n  }\n\n  private buildColumnComparison(first: string, operator: WhereOperator, second: string): any {\n    const mongoOperator = this.getMongoOperator(operator);\n    return {\n      $expr: {\n        [mongoOperator]: [this.wrapColumn(first), this.wrapColumn(second)],\n      },\n    };\n  }\n\n  private buildBetweenColumnsCondition(field: string, lower: string, upper: string): any {\n    return {\n      $expr: {\n        $and: [\n          { $gte: [this.wrapColumn(field), this.wrapColumn(lower)] },\n          { $lte: [this.wrapColumn(field), this.wrapColumn(upper)] },\n        ],\n      },\n    };\n  }\n\n  private wrapColumn(column: string): string {\n    return column.startsWith(\"$\") ? column : `$${column}`;\n  }\n\n  private buildDateEqualityCondition(field: string, value: Date | string): any {\n    const target = this.normalizeDateInput(value);\n    const start = this.startOfDay(target);\n    const end = this.endOfDay(target);\n    return { [field]: { $gte: start, $lte: end } };\n  }\n\n  private buildDateBeforeCondition(field: string, value: Date | string): any {\n    const target = this.startOfDay(this.normalizeDateInput(value));\n    return { [field]: { $lt: target } };\n  }\n\n  private buildDateAfterCondition(field: string, value: Date | string): any {\n    const target = this.endOfDay(this.normalizeDateInput(value));\n    return { [field]: { $gt: target } };\n  }\n\n  private buildTimeCondition(field: string, value: string): any {\n    return {\n      $expr: {\n        $eq: [\n          {\n            $dateToString: {\n              format: \"%H:%M\",\n              date: `$${field}`,\n            },\n          },\n          value,\n        ],\n      },\n    };\n  }\n\n  private buildDatePartCondition(\n    field: string,\n    operator: \"$dayOfMonth\" | \"$month\" | \"$year\",\n    value: number,\n  ): any {\n    return {\n      $expr: {\n        $eq: [\n          {\n            [operator]: `$${field}`,\n          },\n          value,\n        ],\n      },\n    };\n  }\n\n  private buildJsonContainsCondition(path: string, value: unknown): any {\n    const fieldPath = this.normalizePath(path);\n    if (Array.isArray(value)) {\n      return { [fieldPath]: { $all: value } };\n    }\n    return { [fieldPath]: value };\n  }\n\n  private buildJsonDoesntContainCondition(path: string, value: unknown): any {\n    const fieldPath = this.normalizePath(path);\n    const values = Array.isArray(value) ? value : [value];\n    return { [fieldPath]: { $nin: values } };\n  }\n\n  private buildJsonContainsKeyCondition(path: string): any {\n    return {\n      [this.normalizePath(path)]: { $exists: true },\n    };\n  }\n\n  private buildJsonLengthCondition(path: string, operator: WhereOperator, value: number): any {\n    const mongoOperator = this.getMongoOperator(operator);\n    return {\n      $expr: {\n        [mongoOperator]: [{ $size: { $ifNull: [`$${this.normalizePath(path)}`, []] } }, value],\n      },\n    };\n  }\n\n  private buildJsonTypeCondition(path: string, type: string): any {\n    return {\n      $expr: {\n        $eq: [{ $type: `$${this.normalizePath(path)}` }, type],\n      },\n    };\n  }\n\n  private buildArrayLengthCondition(field: string, operator: WhereOperator, value: number): any {\n    const mongoOperator = this.getMongoOperator(operator);\n    return {\n      $expr: {\n        [mongoOperator]: [{ $size: { $ifNull: [`$${field}`, []] } }, value],\n      },\n    };\n  }\n\n  private normalizeDateInput(value: Date | string): Date {\n    if (value instanceof Date) {\n      return value;\n    }\n    const parsed = new Date(value);\n    if (Number.isNaN(parsed.getTime())) {\n      throw new Error(`Invalid date value: ${value}`);\n    }\n    return parsed;\n  }\n\n  private startOfDay(date: Date): Date {\n    const copy = new Date(date);\n    copy.setHours(0, 0, 0, 0);\n    return copy;\n  }\n\n  private endOfDay(date: Date): Date {\n    const copy = new Date(date);\n    copy.setHours(23, 59, 59, 999);\n    return copy;\n  }\n\n  private normalizePath(path: string): string {\n    return path.replace(/->/g, \".\");\n  }\n\n  private applyProjectionFields(\n    projection: Record<string, unknown>,\n    fields: string[],\n    value: 0 | 1,\n  ): void {\n    for (const field of fields) {\n      projection[field] = value;\n    }\n  }\n\n  /**\n   * Apply projection object with aliases and inclusion/exclusion.\n   * @param projection - The projection object to modify\n   * @param projectionObj - The projection specification\n   */\n  private applyProjectionObject(\n    projection: Record<string, unknown>,\n    projectionObj: Record<string, unknown>,\n  ): void {\n    for (const [field, value] of Object.entries(projectionObj)) {\n      // Handle boolean values (true = 1, false = 0)\n      if (typeof value === \"boolean\") {\n        projection[field] = value ? 1 : 0;\n        continue;\n      }\n\n      // Handle numeric values (0 or 1)\n      if (typeof value === \"number\") {\n        projection[field] = value;\n        continue;\n      }\n\n      // Handle string values (aliases)\n      if (typeof value === \"string\") {\n        // Alias: project the field with a new name\n        projection[value] = `$${field}`;\n        continue;\n      }\n\n      // Handle complex expressions (objects)\n      if (typeof value === \"object\" && value !== null) {\n        projection[field] = value;\n        continue;\n      }\n\n      // Default: include the field\n      projection[field] = 1;\n    }\n  }\n\n  private applyRawProjection(\n    projection: Record<string, unknown>,\n    expression: RawExpression,\n    bindings?: unknown[],\n  ): void {\n    const resolved = this.resolveProjectionExpression(expression, bindings);\n    if (!resolved) {\n      return;\n    }\n\n    if (typeof resolved === \"object\" && resolved !== null && !Array.isArray(resolved)) {\n      Object.assign(projection, resolved as Record<string, unknown>);\n    }\n  }\n\n  private resolveProjectionExpression(\n    expression: RawExpression | unknown,\n    bindings?: unknown[],\n  ): any {\n    if (typeof expression === \"string\") {\n      const source =\n        bindings && expression.includes(\"?\")\n          ? this.bindRawString(expression, bindings)\n          : expression;\n      if (source.startsWith(\":\")) {\n        return source.slice(1);\n      }\n      return this.normalizeFieldReference(source);\n    }\n\n    if (typeof expression === \"object\" && expression !== null && !(expression instanceof Date)) {\n      return expression;\n    }\n\n    if (typeof expression === \"number\" || typeof expression === \"boolean\") {\n      return expression;\n    }\n\n    return expression;\n  }\n\n  private normalizeFieldReference(value: string | RawExpression): any {\n    if (typeof value === \"string\") {\n      if (value.startsWith(\":\")) {\n        return value.slice(1);\n      }\n      // If already a field reference, return as-is\n      if (value.startsWith(\"$\")) {\n        return value;\n      }\n      // Check if it's a string literal (contains spaces or special chars)\n      // Field paths are typically: alphanumeric, underscore, dot only\n      if (!/^[a-zA-Z0-9_.]+$/.test(value)) {\n        return value; // Return as literal\n      }\n      // Otherwise, treat as field reference\n      return `$${value}`;\n    }\n    return value;\n  }\n\n  private buildAggregateProjection(field: string, aggregate: string): any {\n    if (aggregate === \"count\") {\n      return this.buildArraySizeExpression(field);\n    }\n\n    const map: Record<string, string> = {\n      sum: \"$sum\",\n      avg: \"$avg\",\n      min: \"$min\",\n      max: \"$max\",\n      first: \"$first\",\n      last: \"$last\",\n    };\n\n    const operator = map[aggregate];\n    if (!operator) {\n      return null;\n    }\n\n    return {\n      [operator]: this.normalizeFieldReference(field),\n    };\n  }\n\n  private buildExistsProjection(field: string): any {\n    return {\n      $ne: [{ $type: `$${field}` }, \"missing\"],\n    };\n  }\n\n  private buildArraySizeExpression(field: string): any {\n    return {\n      $size: { $ifNull: [`$${field}`, []] },\n    };\n  }\n\n  private buildCaseExpression(\n    cases: Array<{ when: RawExpression; then: RawExpression | unknown }>,\n    otherwise: RawExpression | unknown,\n  ): any {\n    return {\n      $switch: {\n        branches: cases.map((item) => ({\n          case: this.resolveProjectionExpression(item.when),\n          then: this.resolveLiteralOrExpression(item.then),\n        })),\n        default: this.resolveLiteralOrExpression(otherwise),\n      },\n    };\n  }\n\n  private buildCondExpression(\n    condition: RawExpression,\n    thenValue: RawExpression | unknown,\n    elseValue: RawExpression | unknown,\n  ): any {\n    return {\n      $cond: [\n        this.resolveProjectionExpression(condition),\n        this.resolveLiteralOrExpression(thenValue),\n        this.resolveLiteralOrExpression(elseValue),\n      ],\n    };\n  }\n\n  /**\n   * Resolve a value as a literal (if it's a plain string) or as an expression.\n   * Used for `then`/`default` values in CASE/WHEN expressions.\n   */\n  private resolveLiteralOrExpression(value: RawExpression | unknown): any {\n    // If it's a string that starts with $, treat as field reference\n    if (typeof value === \"string\" && value.startsWith(\"$\")) {\n      return value;\n    }\n    // If it's a plain string (not starting with $), treat as literal\n    if (typeof value === \"string\") {\n      return value;\n    }\n    // For objects (expressions), numbers, booleans, etc., use normal resolution\n    return this.resolveProjectionExpression(value);\n  }\n\n  private inferJsonAlias(path: string): string {\n    const normalized = this.normalizePath(path);\n    const segments = normalized.split(\".\");\n    return segments[segments.length - 1];\n  }\n\n  private buildConcatExpression(values: Array<string | RawExpression>): any {\n    return {\n      $concat: values.map((value) => this.normalizeFieldReference(value)),\n    };\n  }\n\n  private buildCoalesceExpression(values: Array<string | RawExpression>): any {\n    if (values.length === 0) {\n      return null;\n    }\n\n    let expression = this.normalizeFieldReference(values[values.length - 1]);\n\n    for (let index = values.length - 2; index >= 0; index--) {\n      expression = {\n        $ifNull: [this.normalizeFieldReference(values[index]), expression],\n      };\n    }\n\n    return expression;\n  }\n\n  /**\n   * Build a $project stage from select operations.\n   *\n   * @param operations - The select operations\n   * @returns The $project stage or null\n   */\n  private buildProjectStage(operations: Operation[]): any {\n    if (operations.length === 0) {\n      return null;\n    }\n\n    const projection: Record<string, unknown> = {};\n    const driverCallbacks: Array<(projection: Record<string, unknown>) => void> = [];\n\n    for (const op of operations) {\n      switch (op.type) {\n        case \"select\":\n          // Handle new projection format with aliases\n          if (op.data.projection) {\n            this.applyProjectionObject(projection, op.data.projection);\n          } else if (op.data.fields) {\n            this.applyProjectionFields(projection, op.data.fields, 1);\n          }\n          break;\n\n        case \"deselect\":\n          this.applyProjectionFields(projection, op.data.fields, 0);\n          break;\n\n        case \"addSelect\":\n          this.applyProjectionFields(projection, op.data.fields, 1);\n          break;\n\n        case \"selectRaw\":\n          this.applyRawProjection(projection, op.data.expression, op.data.bindings);\n          break;\n\n        case \"selectSub\":\n        case \"addSelectSub\": {\n          const expr = this.resolveProjectionExpression(op.data.expression, op.data.bindings);\n          if (expr !== undefined) {\n            projection[op.data.alias] = expr;\n          }\n          break;\n        }\n\n        case \"selectAggregate\":\n          projection[op.data.alias] = this.buildAggregateProjection(\n            op.data.field,\n            op.data.aggregate,\n          );\n          break;\n\n        case \"selectExists\":\n          projection[op.data.alias] = this.buildExistsProjection(op.data.field);\n          break;\n\n        case \"selectCount\":\n          projection[op.data.alias] = this.buildArraySizeExpression(op.data.field);\n          break;\n\n        case \"selectCase\":\n          projection[op.data.alias] = this.buildCaseExpression(\n            op.data.cases,\n            op.data.otherwise,\n          );\n          break;\n\n        case \"selectWhen\":\n          projection[op.data.alias] = this.buildCondExpression(\n            op.data.condition,\n            op.data.thenValue,\n            op.data.elseValue,\n          );\n          break;\n\n        case \"selectDriverProjection\":\n          driverCallbacks.push(op.data.callback);\n          break;\n\n        case \"selectJson\": {\n          const alias = op.data.alias ?? this.inferJsonAlias(op.data.path);\n          projection[alias] = this.normalizeFieldReference(\n            `$${this.normalizePath(op.data.path)}`,\n          );\n          break;\n        }\n\n        case \"selectJsonRaw\": {\n          projection[op.data.alias] = this.resolveProjectionExpression(op.data.expression);\n          break;\n        }\n\n        case \"deselectJson\":\n          projection[this.normalizePath(op.data.path)] = 0;\n          break;\n\n        case \"selectConcat\":\n          projection[op.data.alias] = this.buildConcatExpression(op.data.fields);\n          break;\n\n        case \"selectCoalesce\":\n          projection[op.data.alias] = this.buildCoalesceExpression(op.data.fields);\n          break;\n\n        default:\n          break;\n      }\n    }\n\n    for (const callback of driverCallbacks) {\n      callback(projection);\n    }\n\n    return Object.keys(projection).length > 0 ? { $project: projection } : null;\n  }\n\n  /**\n   * Build a $sort stage from order operations.\n   *\n   * @param operations - The order operations\n   * @returns The $sort stage or null\n   */\n  private buildSortStage(operations: Operation[]): any {\n    const sort: any = {};\n\n    for (const op of operations) {\n      switch (op.type) {\n        case \"orderBy\":\n          sort[op.data.field] = op.data.direction === \"asc\" ? 1 : -1;\n          break;\n\n        case \"orderByRandom\":\n          return { $sample: { size: op.data.limit } };\n\n        case \"orderByRaw\":\n          // TODO: Handle raw expressions\n          break;\n      }\n    }\n\n    return Object.keys(sort).length > 0 ? { $sort: sort } : null;\n  }\n\n  /**\n   * Build a $group stage from group operations.\n   *\n   * @param operations - The group operations\n   * @returns The $group stage or null\n   */\n  private buildGroupStage(operations: Operation[]): any {\n    const op = operations[0];\n\n    switch (op.type) {\n      case \"groupBy\": {\n        const stage = this.buildGroupByStage(op.data.fields);\n        if (stage) {\n          return stage;\n        }\n        break;\n      }\n      case \"groupByWithAggregates\": {\n        const stage = this.buildGroupByWithAggregatesStage(\n          op.data.fields,\n          op.data.aggregates,\n        );\n        if (stage) {\n          return stage;\n        }\n        break;\n      }\n      case \"groupByDate\": {\n        const stage = this.buildGroupByDateStage(\n          op.data.column,\n          op.data.unit,\n          op.data.aggregates ?? {},\n        );\n        if (stage) {\n          return stage;\n        }\n        break;\n      }\n      case \"groupByRaw\": {\n        const expression = op.data.expression;\n        if (expression && typeof expression === \"object\") {\n          return { $group: expression };\n        }\n        // If expression is not an object, it might be a string or other type\n        // In that case, we should still return it as a $group stage\n        if (expression) {\n          return { $group: { _id: expression } };\n        }\n        break;\n      }\n      case \"distinct\": {\n        const stage = this.buildGroupByStage(op.data.fields);\n        if (stage) {\n          return stage;\n        }\n        break;\n      }\n      default:\n        break;\n    }\n\n    return null;\n  }\n\n  private buildGroupByStage(fields: GroupByInput): any {\n    const groupId = this.buildGroupId(fields);\n    if (!groupId) {\n      return null;\n    }\n\n    return { $group: { _id: groupId } };\n  }\n\n  /**\n   * Build a $group stage with aggregates from group operations.\n   *\n   * @param fields - Fields to group by\n   * @param aggregates - Aggregate operations (abstract or raw)\n   * @returns The $group stage or null\n   */\n  private buildGroupByWithAggregatesStage(\n    fields: GroupByInput,\n    aggregates: Record<string, RawExpression>,\n  ): any {\n    const groupId = this.buildGroupId(fields);\n    if (!groupId) {\n      return null;\n    }\n\n    const groupStage: Record<string, unknown> = {\n      _id: groupId,\n    };\n\n    // Translate each aggregate expression\n    for (const [alias, expression] of Object.entries(aggregates)) {\n      if (isAggregateExpression(expression)) {\n        // Translate abstract expression to MongoDB format\n        groupStage[alias] = this.translateAggregateExpression(expression);\n      } else {\n        // Use raw expression as-is (already in MongoDB format)\n        groupStage[alias] = expression;\n      }\n    }\n\n    return { $group: groupStage };\n  }\n\n  /**\n   * Build a `$group` stage that buckets documents by a `$dateTrunc` of a date\n   * field, optionally running aggregates over each bucket.\n   *\n   * @param column - The date field to bucket\n   * @param unit - The bucket granularity\n   * @param aggregates - Aggregate operations (abstract or raw)\n   * @returns The `$group` stage\n   */\n  private buildGroupByDateStage(\n    column: string,\n    unit: string,\n    aggregates: Record<string, RawExpression>,\n  ): any {\n    const groupStage: Record<string, unknown> = {\n      _id: { $dateTrunc: { date: `$${column}`, unit } },\n    };\n\n    for (const [alias, expression] of Object.entries(aggregates)) {\n      if (isAggregateExpression(expression)) {\n        groupStage[alias] = this.translateAggregateExpression(expression);\n      } else {\n        groupStage[alias] = expression;\n      }\n    }\n\n    return { $group: groupStage };\n  }\n\n  /**\n   * Extract field names from GroupByInput for renaming _id.\n   *\n   * @param fields - The grouping fields\n   * @returns Field name(s) to use for renaming _id\n   */\n  private extractGroupFieldNames(fields: GroupByInput): string | string[] | null {\n    if (typeof fields === \"string\") {\n      return fields;\n    }\n\n    if (Array.isArray(fields)) {\n      const allStrings = fields.every((field) => typeof field === \"string\");\n      if (allStrings) {\n        return fields as string[];\n      }\n      // For complex arrays, return null (don't rename)\n      return null;\n    }\n\n    if (typeof fields === \"object\" && fields !== null) {\n      // For object syntax, use the keys as field names\n      return Object.keys(fields);\n    }\n\n    return null;\n  }\n\n  /**\n   * Translate an abstract aggregate expression to MongoDB format.\n   *\n   * @param expr - Abstract aggregate expression\n   * @returns MongoDB aggregation expression\n   */\n  private translateAggregateExpression(expr: AggregateExpression): Record<string, unknown> {\n    switch (expr.__agg) {\n      case \"count\":\n        return { $sum: 1 };\n\n      case \"countDistinct\":\n        if (!expr.__field) {\n          throw new Error(\"Count distinct aggregate requires a field name\");\n        }\n        // Accumulate the set of distinct values in the $group stage; the\n        // renaming $project then finalizes it with `{ $size: \"$alias\" }`\n        // (the standard distinct-count-per-group pattern — `$size` is not a\n        // valid $group accumulator).\n        return { $addToSet: `$${expr.__field}` };\n\n      case \"sum\":\n        // When a composed column expression is present, sum operates on it\n        // (e.g. SUM(price * quantity) → { $sum: { $multiply: [...] } }) instead\n        // of a bare field. This is the only aggregate that accepts `__expr`.\n        if (expr.__expr) {\n          return { $sum: this.columnExpressionToMongo(expr.__expr) };\n        }\n        if (!expr.__field) {\n          throw new Error(\"Sum aggregate requires a field name\");\n        }\n        return { $sum: `$${expr.__field}` };\n\n      case \"avg\":\n        if (!expr.__field) {\n          throw new Error(\"Average aggregate requires a field name\");\n        }\n        return { $avg: `$${expr.__field}` };\n\n      case \"min\":\n        if (!expr.__field) {\n          throw new Error(\"Min aggregate requires a field name\");\n        }\n        return { $min: `$${expr.__field}` };\n\n      case \"max\":\n        if (!expr.__field) {\n          throw new Error(\"Max aggregate requires a field name\");\n        }\n        return { $max: `$${expr.__field}` };\n\n      case \"first\":\n        if (!expr.__field) {\n          throw new Error(\"First aggregate requires a field name\");\n        }\n        return { $first: `$${expr.__field}` };\n\n      case \"last\":\n        if (!expr.__field) {\n          throw new Error(\"Last aggregate requires a field name\");\n        }\n        return { $last: `$${expr.__field}` };\n\n      case \"distinct\":\n        if (!expr.__field) {\n          throw new Error(\"Distinct aggregate requires a field name\");\n        }\n        return { $distinct: `$${expr.__field}` };\n\n      case \"floor\":\n        if (!expr.__field) {\n          throw new Error(\"Floor aggregate requires a field name\");\n        }\n\n        return { $floor: `$${expr.__field}` };\n\n      default:\n        throw new Error(`Unknown aggregate function: ${expr.__agg}`);\n    }\n  }\n\n  /**\n   * Compile a typed {@link ColumnExpression} tree into a MongoDB aggregation\n   * expression.\n   *\n   * Column references become `$field` paths; literals are emitted verbatim;\n   * arithmetic ops map to `$add` / `$subtract` / `$multiply` / `$divide`. The\n   * `raw` node is rejected — a raw SQL fragment is not portable to a MongoDB\n   * pipeline, so callers must use the typed combinators (or `groupByRaw`) here.\n   *\n   * @param expression - The expression tree to compile\n   * @returns A MongoDB aggregation expression (e.g. `{ $multiply: [\"$price\", \"$quantity\"] }`)\n   */\n  private columnExpressionToMongo(expression: ColumnExpression): unknown {\n    switch (expression.__expr) {\n      case \"column\":\n        return `$${expression.column}`;\n\n      case \"literal\":\n        return expression.value;\n\n      case \"raw\":\n        throw new Error(\n          `$agg.sumRaw / $expr.raw is not portable to a MongoDB pipeline — a raw ` +\n            `SQL fragment has no MongoDB equivalent. Use the typed $expr ` +\n            `combinators ($expr.mul / $expr.add / $expr.sub / $expr.div / $expr.col / $expr.lit) or groupByRaw instead.`,\n        );\n\n      case \"add\":\n      case \"subtract\":\n      case \"multiply\":\n      case \"divide\": {\n        const operator = {\n          add: \"$add\",\n          subtract: \"$subtract\",\n          multiply: \"$multiply\",\n          divide: \"$divide\",\n        }[expression.__expr];\n\n        return {\n          [operator]: expression.operands.map((operand) => this.columnExpressionToMongo(operand)),\n        };\n      }\n\n      default:\n        throw new Error(`Unsupported column expression node: ${JSON.stringify(expression)}`);\n    }\n  }\n\n  private buildGroupId(fields: GroupByInput): any {\n    if (!fields) {\n      return null;\n    }\n\n    if (typeof fields === \"string\") {\n      return `$${fields}`;\n    }\n\n    if (Array.isArray(fields)) {\n      if (fields.length === 0) {\n        return null;\n      }\n\n      const allStrings = fields.every((field) => typeof field === \"string\");\n      if (allStrings) {\n        const result: Record<string, string> = {};\n        for (const field of fields as string[]) {\n          result[field] = `$${field}`;\n        }\n        return result;\n      }\n\n      // Array of objects - merge them to build complex _id structures\n      return (fields as Record<string, unknown>[]).reduce((acc, item) => ({ ...acc, ...item }), {});\n    }\n\n    if (typeof fields === \"object\") {\n      const normalized: Record<string, unknown> = {};\n      Object.entries(fields).forEach(([key, value]) => {\n        if (typeof value === \"string\" && !value.startsWith(\"$\")) {\n          normalized[key] = `$${value}`;\n        } else {\n          normalized[key] = value;\n        }\n      });\n      return normalized;\n    }\n\n    return null;\n  }\n\n  /**\n   * Build a $lookup stage from join operations.\n   *\n   * @param operations - The join operations\n   * @returns The $lookup stage or null\n   */\n  private buildLookupStage(operations: Operation[]): any {\n    const op = operations[0];\n    const options = op.data;\n\n    return {\n      $lookup: {\n        from: options.table,\n        localField: options.localField,\n        foreignField: options.foreignField,\n        as: options.alias || options.table,\n      },\n    };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"mongodb-query-parser.mjs","names":[],"sources":["../../../../../../../../@warlock.js/cascade/src/drivers/mongodb/mongodb-query-parser.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { Collection } from \"mongodb\";\nimport type { GroupByInput, RawExpression, WhereOperator } from \"../../contracts\";\nimport {\n  isAggregateExpression,\n  type AggregateExpression,\n} from \"../../expressions/aggregate-expressions\";\nimport type { ColumnExpression } from \"../../expressions/column-expressions\";\nimport type { MongoQueryBuilder } from \"./mongodb-query-builder\";\nimport type { Operation, PipelineStage } from \"./types\";\n\n/**\n * Options for configuring the MongoDB query parser.\n */\nexport type MongoQueryParserOptions = {\n  /** The MongoDB collection being queried */\n  collection: Collection;\n  /** The ordered list of operations to parse */\n  operations: Operation[];\n  /** Factory method for creating sub-builders (used for callbacks) */\n  createSubBuilder: () => MongoQueryBuilder;\n};\n\n/**\n * Parses query builder operations into MongoDB aggregation pipeline.\n *\n * This parser is responsible for converting the abstract operations collected\n * by the query builder into a concrete MongoDB aggregation pipeline. It handles\n * intelligent grouping of mergeable operations (like multiple where clauses)\n * into single pipeline stages for optimal performance.\n */\nexport class MongoQueryParser {\n  /**\n   * The MongoDB collection being queried.\n   */\n  private readonly collection: Collection;\n\n  /**\n   * The ordered list of operations to parse.\n   */\n  private readonly operations: Operation[];\n\n  /**\n   * Factory for creating sub-builders (used when resolving callbacks).\n   */\n  private readonly createSubBuilder: () => MongoQueryBuilder;\n\n  /**\n   * Track group field names for automatic _id renaming.\n   * Maps pipeline index to field names.\n   */\n  private readonly groupFieldNames = new Map<number, string | string[]>();\n\n  /**\n   * Track `countDistinct` aggregate aliases per group stage. The renaming\n   * `$project` finalizes these with `{ $size: \"$alias\" }` over the set built\n   * by `$addToSet` in the `$group` stage.\n   * Maps pipeline index to the set of aliases needing `$size` finalization.\n   */\n  private readonly countDistinctAliases = new Map<number, Set<string>>();\n\n  /**\n   * Create a new MongoDB query parser.\n   *\n   * @param options - Configuration options for the parser\n   */\n  public constructor(options: MongoQueryParserOptions) {\n    this.collection = options.collection;\n    this.operations = options.operations;\n    this.createSubBuilder = options.createSubBuilder;\n  }\n\n  /**\n   * Parse the operations into a MongoDB aggregation pipeline.\n   *\n   * This method intelligently groups mergeable operations (e.g., multiple where\n   * clauses) into single pipeline stages while maintaining the correct execution\n   * order for non-mergeable operations.\n   *\n   * @returns The MongoDB aggregation pipeline\n   *\n   * @example\n   * ```typescript\n   * const parser = new MongoQueryParser({ collection, operations });\n   * const pipeline = parser.parse();\n   * // [\n   * //   { $match: { status: 'active', age: { $gt: 18 } } },\n   * //   { $sort: { createdAt: -1 } },\n   * //   { $limit: 10 }\n   * // ]\n   * ```\n   */\n  public parse(): any[] {\n    const pipeline: any[] = [];\n    let currentStage: PipelineStage | null = null;\n    let currentBuffer: Operation[] = [];\n\n    for (const op of this.orderStages(this.operations)) {\n      if (op.mergeable && op.stage === currentStage) {\n        // Same mergeable stage, add to buffer\n        currentBuffer.push(op);\n      } else {\n        // Different stage or non-mergeable, flush buffer\n        if (currentBuffer.length > 0) {\n          const builtStage = this.buildStage(currentStage!, currentBuffer);\n          if (builtStage) {\n            const stageIndex = pipeline.length;\n            pipeline.push(builtStage);\n            // Track field names for group stages with aggregates\n            this.trackGroupFieldNames(currentStage!, currentBuffer, stageIndex);\n          }\n          currentBuffer = [];\n        }\n\n        if (op.mergeable) {\n          // Start new buffer\n          currentStage = op.stage;\n          currentBuffer.push(op);\n        } else {\n          // Non-mergeable, add directly\n          const builtStage = this.buildStage(op.stage, [op]);\n          if (builtStage) {\n            const stageIndex = pipeline.length;\n            pipeline.push(builtStage);\n            // Track field names for group stages with aggregates\n            this.trackGroupFieldNames(op.stage, [op], stageIndex);\n          }\n          currentStage = null;\n        }\n      }\n    }\n\n    // Flush remaining buffer\n    if (currentBuffer.length > 0) {\n      const builtStage = this.buildStage(currentStage!, currentBuffer);\n      if (builtStage) {\n        const stageIndex = pipeline.length;\n        pipeline.push(builtStage);\n        // Track field names for group stages with aggregates\n        this.trackGroupFieldNames(currentStage!, currentBuffer, stageIndex);\n      }\n    }\n\n    // Post-process: Rename _id to actual field names after $group stages with aggregates\n    return this.postProcessGroupStages(pipeline);\n  }\n\n  /**\n   * Reorder operations so filters run before projections, mirroring SQL\n   * semantics: in `select(...).where(...)`, the WHERE always applies to the\n   * source columns regardless of call order. Without this, a `$project` that\n   * strips the filter column would run before the `$match` and silently drop\n   * every document (`select([\"a\"]).where(\"b\", x)` → `[]`).\n   *\n   * Only *mergeable* `$match` operations are hoisted, and only within a\n   * segment of neighboring mergeable `$match` / `$project` / `$sort`\n   * operations. Any other operation — `$group`, `$lookup`, `$limit`, `$skip`,\n   * `$setWindowFields`, or a non-mergeable op (raw escapes, having-style\n   * post-group matches, `$sample`) — is a barrier: nothing moves across it.\n   * So `groupBy(...).where(...)` still filters AFTER the group, and\n   * `limit(...)` / `random()` keep their call-order meaning.\n   */\n  private orderStages(operations: Operation[]): Operation[] {\n    const reordered: Operation[] = [];\n    let segment: Operation[] = [];\n\n    const flushSegment = (): void => {\n      if (segment.length === 0) {\n        return;\n      }\n      reordered.push(...segment.filter((op) => op.stage === \"$match\"));\n      reordered.push(...segment.filter((op) => op.stage !== \"$match\"));\n      segment = [];\n    };\n\n    for (const op of operations) {\n      const isReorderable =\n        op.mergeable &&\n        (op.stage === \"$match\" || op.stage === \"$project\" || op.stage === \"$sort\");\n\n      if (isReorderable) {\n        segment.push(op);\n      } else {\n        flushSegment();\n        reordered.push(op);\n      }\n    }\n\n    flushSegment();\n    return reordered;\n  }\n\n  /**\n   * Track field names for group stages that need _id renaming.\n   */\n  private trackGroupFieldNames(\n    stage: PipelineStage,\n    operations: Operation[],\n    stageIndex: number,\n  ): void {\n    if (stage === \"$group\") {\n      const op = operations[0];\n      if (op.type === \"groupByWithAggregates\" && op.data.fields) {\n        const fieldNames = this.extractGroupFieldNames(op.data.fields);\n        if (fieldNames) {\n          this.groupFieldNames.set(stageIndex, fieldNames);\n        }\n\n        this.trackCountDistinctAliases(stageIndex, op.data.aggregates);\n      } else if (op.type === \"groupByDate\") {\n        // The `$dateTrunc` bucket becomes `_id`; rename it back to the column.\n        this.groupFieldNames.set(stageIndex, op.data.column as string);\n        this.trackCountDistinctAliases(stageIndex, op.data.aggregates ?? {});\n      }\n    }\n  }\n\n  /**\n   * Record which aggregate aliases in a group stage are `countDistinct` so the\n   * renaming `$project` can finalize them with `{ $size: \"$alias\" }` over the\n   * set built by `$addToSet` (the standard distinct-count-per-group pattern).\n   */\n  private trackCountDistinctAliases(\n    stageIndex: number,\n    aggregates: Record<string, RawExpression>,\n  ): void {\n    const distinctAliases = new Set<string>();\n    for (const [alias, expression] of Object.entries(aggregates)) {\n      if (isAggregateExpression(expression) && expression.__agg === \"countDistinct\") {\n        distinctAliases.add(alias);\n      }\n    }\n\n    if (distinctAliases.size > 0) {\n      this.countDistinctAliases.set(stageIndex, distinctAliases);\n    }\n  }\n\n  /**\n   * Post-process pipeline to rename _id fields after $group stages.\n   *\n   * This automatically renames MongoDB's `_id` field to the actual field name(s)\n   * used for grouping, making the results more intuitive.\n   *\n   * @param pipeline - The aggregation pipeline\n   * @returns The processed pipeline\n   */\n  private postProcessGroupStages(pipeline: any[]): any[] {\n    const processed: any[] = [];\n\n    for (let i = 0; i < pipeline.length; i++) {\n      const stage = pipeline[i];\n\n      // Check if this is a $group stage that needs _id renaming\n      if (stage.$group && this.groupFieldNames.has(i)) {\n        const fieldNames = this.groupFieldNames.get(i)!;\n\n        // Add the $group stage\n        processed.push(stage);\n\n        // Add a $project stage to rename _id\n        const projection: Record<string, unknown> = {};\n\n        if (typeof fieldNames === \"string\") {\n          // Single field: rename _id to field name\n          projection[fieldNames] = \"$_id\";\n        } else if (Array.isArray(fieldNames) && fieldNames.length > 0) {\n          // Multiple fields: _id is an object, spread it\n          for (const fieldName of fieldNames) {\n            projection[fieldName] = `$_id.${fieldName}`;\n          }\n        }\n\n        // Include all aggregate fields. countDistinct aliases are finalized\n        // with `{ $size: \"$alias\" }` over the set built by `$addToSet`; every\n        // other aggregate is projected through as-is.\n        const distinctAliases = this.countDistinctAliases.get(i);\n        const aggregateFields = Object.keys(stage.$group).filter((key) => key !== \"_id\");\n        for (const field of aggregateFields) {\n          if (distinctAliases?.has(field)) {\n            projection[field] = { $size: `$${field}` };\n          } else {\n            projection[field] = 1;\n          }\n        }\n\n        if (Object.keys(projection).length > 0) {\n          // now unselect the _id field\n          projection._id = 0;\n          processed.push({ $project: projection });\n        }\n      } else {\n        // Regular stage, add as-is\n        processed.push(stage);\n      }\n    }\n\n    return processed;\n  }\n\n  /**\n   * Convert the parsed pipeline to a pretty-printed string for debugging.\n   *\n   * This method formats the MongoDB aggregation pipeline in a human-readable\n   * way, making it easier to understand and debug complex queries.\n   *\n   * @returns A formatted string representation of the pipeline\n   *\n   * @example\n   * ```typescript\n   * const parser = new MongoQueryParser({ collection, operations });\n   * console.log(parser.toPrettyString());\n   * // Output:\n   * // MongoDB Aggregation Pipeline:\n   * // ════════════════════════════\n   * // Stage 1: $match\n   * //   status: \"active\"\n   * //   age: { $gt: 18 }\n   * //\n   * // Stage 2: $sort\n   * //   createdAt: -1\n   * ```\n   */\n  public toPrettyString(): string {\n    const pipeline = this.parse();\n\n    if (pipeline.length === 0) {\n      return \"MongoDB Aggregation Pipeline: (empty)\";\n    }\n\n    let output = \"MongoDB Aggregation Pipeline:\\n\";\n    output += \"═\".repeat(50) + \"\\n\";\n\n    pipeline.forEach((stage, index) => {\n      const stageName = Object.keys(stage)[0];\n      const stageData = stage[stageName];\n\n      if (index > 0) {\n        output += \"\\n\";\n      }\n\n      output += `Stage ${index + 1}: ${colors.redBright(stageName)}\\n`;\n      output += this.formatStageData(stageData, 2);\n    });\n\n    return output;\n  }\n\n  /**\n   * Format stage data with proper indentation.\n   *\n   * @param data - The stage data to format\n   * @param indent - The indentation level\n   * @returns Formatted string\n   */\n  private formatStageData(data: any, indent: number = 0): string {\n    const spaces = \" \".repeat(indent);\n\n    if (typeof data !== \"object\" || data === null) {\n      return `${spaces}${JSON.stringify(data)}\\n`;\n    }\n\n    if (Array.isArray(data)) {\n      if (data.length === 0) return `${spaces}[]`;\n\n      let result = \"\";\n      data.forEach((item, index) => {\n        result += `${spaces}[${colors.magenta(index)}]:\\n`;\n        result += this.formatStageData(item, indent + 2);\n      });\n      return result;\n    }\n\n    let result = \"\";\n    Object.entries(data).forEach(([key, value]) => {\n      const isOperator = key.startsWith(\"$\");\n      const coloredKey = isOperator ? colors.magentaBright(key) : colors.blue(key);\n\n      if (typeof value === \"object\" && value !== null && !Array.isArray(value)) {\n        result += `${spaces}${coloredKey}:\\n`;\n        result += this.formatStageData(value, indent + 2);\n      } else if (Array.isArray(value)) {\n        result += `${spaces}${coloredKey}:\\n`;\n        result += this.formatStageData(value, indent + 2);\n      } else {\n        const formattedValue =\n          typeof value === \"number\"\n            ? colors.yellowBright(value)\n            : typeof value === \"boolean\"\n              ? colors.cyanBright(value.toString())\n              : typeof value === \"string\"\n                ? colors.greenBright(JSON.stringify(value))\n                : colors.greenBright(String(value));\n        result += `${spaces}${coloredKey}: ${formattedValue}\\n`;\n      }\n    });\n\n    return result.endsWith(\"\\n\") ? result : `${result}\\n`;\n  }\n\n  /**\n   * Build a single pipeline stage from a group of operations.\n   *\n   * @param stage - The pipeline stage type\n   * @param operations - The operations to build the stage from\n   * @returns The built pipeline stage or null if no stage should be added\n   */\n  private buildStage(stage: PipelineStage, operations: Operation[]): any {\n    switch (stage) {\n      case \"$match\":\n        return this.buildMatchStage(operations);\n      case \"$project\":\n        return this.buildProjectStage(operations);\n      case \"$sort\":\n        return this.buildSortStage(operations);\n      case \"$group\":\n        return this.buildGroupStage(operations);\n      case \"$lookup\":\n        return this.buildLookupStage(operations);\n      case \"$limit\":\n        return { $limit: operations[0].data.value };\n      case \"$skip\":\n        return { $skip: operations[0].data.value };\n      case \"$setWindowFields\":\n        return {\n          $setWindowFields: operations[0].data.spec,\n        };\n      default:\n        return null;\n    }\n  }\n\n  /**\n   * Build a $match stage from where operations.\n   *\n   * Query building strategy:\n   * - Top-level where() + orWhere() = Pure OR\n   * - Use callbacks for AND + OR grouping\n   *\n   * @param operations - The where operations\n   * @returns The $match stage or null\n   */\n  private buildMatchStage(operations: Operation[]): any {\n    const andFilter: Record<string, any> = {};\n    const orClauses: any[] = [];\n    const pendingSimpleWhere: any[] = [];\n    let topLevelOrMode = false;\n\n    const pushOr = (clause: any): void => {\n      if (!clause) {\n        return;\n      }\n\n      if (this.isPureOrCondition(clause)) {\n        orClauses.push(...clause.$or);\n        return;\n      }\n\n      if (Array.isArray(clause)) {\n        orClauses.push(...clause);\n        return;\n      }\n\n      orClauses.push(clause);\n    };\n\n    const mergeAnd = (condition: any): void => {\n      if (!condition) {\n        return;\n      }\n\n      Object.entries(condition).forEach(([key, value]) => {\n        if (key === \"$or\") {\n          pushOr(value);\n          return;\n        }\n\n        if (\n          value &&\n          typeof value === \"object\" &&\n          !Array.isArray(value) &&\n          andFilter[key] &&\n          typeof andFilter[key] === \"object\" &&\n          !Array.isArray(andFilter[key])\n        ) {\n          andFilter[key] = { ...andFilter[key], ...value };\n        } else {\n          andFilter[key] = value;\n        }\n      });\n    };\n\n    const queueSimpleWhere = (condition: any): void => {\n      if (!condition) {\n        return;\n      }\n      if (topLevelOrMode) {\n        pushOr(condition);\n      } else {\n        pendingSimpleWhere.push(condition);\n      }\n    };\n\n    const enterTopLevelOrMode = (): void => {\n      if (topLevelOrMode) {\n        return;\n      }\n      topLevelOrMode = true;\n      while (pendingSimpleWhere.length > 0) {\n        const condition = pendingSimpleWhere.shift();\n        if (condition) {\n          pushOr(condition);\n        }\n      }\n    };\n\n    const flushPendingSimpleWhere = (): void => {\n      if (pendingSimpleWhere.length === 0) {\n        return;\n      }\n      if (topLevelOrMode) {\n        pendingSimpleWhere.forEach(pushOr);\n      } else {\n        pendingSimpleWhere.forEach(mergeAnd);\n      }\n      pendingSimpleWhere.length = 0;\n    };\n\n    for (const op of operations) {\n      if (op.type === \"where:callback\" || op.type === \"orWhere:callback\") {\n        flushPendingSimpleWhere();\n        const callbackCondition = this.buildCallbackCondition(op.data);\n        if (!callbackCondition) {\n          continue;\n        }\n\n        const treatAsOr =\n          op.type === \"orWhere:callback\" ||\n          (topLevelOrMode && !this.isPureOrCondition(callbackCondition)) ||\n          this.isPureOrCondition(callbackCondition);\n\n        if (treatAsOr) {\n          if (op.type === \"orWhere:callback\") {\n            enterTopLevelOrMode();\n          }\n          pushOr(callbackCondition);\n        } else {\n          mergeAnd(callbackCondition);\n        }\n        continue;\n      }\n\n      if (op.type === \"where:object\") {\n        queueSimpleWhere(op.data);\n        continue;\n      }\n\n      if (\n        op.type === \"where:not\" ||\n        op.type === \"orWhere:not\" ||\n        op.type === \"where:exists\" ||\n        op.type === \"where:notExists\"\n      ) {\n        const negated = op.type === \"where:not\" || op.type === \"where:notExists\";\n        const nested = this.buildCallbackCondition(op.data.callback);\n        if (nested) {\n          const condition = negated ? { $nor: [nested] } : nested;\n          if (op.type.startsWith(\"orWhere\")) {\n            enterTopLevelOrMode();\n            pushOr(condition);\n          } else {\n            queueSimpleWhere(condition);\n          }\n        }\n        continue;\n      }\n\n      if (op.type === \"orWhere:object\") {\n        enterTopLevelOrMode();\n        pushOr(op.data);\n        continue;\n      }\n\n      const condition = this.buildWhereCondition(op);\n      if (!condition) {\n        continue;\n      }\n\n      if (op.type.startsWith(\"orWhere\")) {\n        enterTopLevelOrMode();\n        pushOr(condition);\n      } else {\n        queueSimpleWhere(condition);\n      }\n    }\n\n    flushPendingSimpleWhere();\n\n    const hasAnd = Object.keys(andFilter).length > 0;\n    const hasOr = orClauses.length > 0;\n\n    if (!hasAnd && !hasOr) {\n      return null;\n    }\n\n    const match: any = {};\n    if (hasAnd) {\n      Object.assign(match, andFilter);\n    }\n    if (hasOr) {\n      match.$or = orClauses;\n    }\n\n    return { $match: match };\n  }\n\n  private isPureOrCondition(condition: any): condition is { $or: any[] } {\n    return (\n      condition &&\n      typeof condition === \"object\" &&\n      !Array.isArray(condition) &&\n      Object.keys(condition).length === 1 &&\n      Array.isArray((condition as any).$or)\n    );\n  }\n\n  /**\n   * Build a condition from a callback-based where clause.\n   * Creates a sub-builder, executes the callback, and extracts the conditions.\n   * If callback has orWhere, all conditions become OR.\n   *\n   * @param callback - The callback function\n   * @returns The built condition or null\n   */\n  private buildCallbackCondition(callback: any): any {\n    // Create a temporary sub-builder\n    const subBuilder = this.createSubBuilder();\n\n    // Execute the callback with the sub-builder\n    callback(subBuilder);\n\n    // Extract only match operations from the sub-builder\n    const matchOps = subBuilder.operations.filter((op: Operation) => op.stage === \"$match\");\n\n    if (matchOps.length === 0) {\n      return null;\n    }\n\n    const andFilter: Record<string, any> = {};\n    const orClauses: any[] = [];\n    const hasInternalOr = matchOps.some((op) => op.type.startsWith(\"orWhere\"));\n\n    const pushOr = (clause: any): void => {\n      if (!clause) {\n        return;\n      }\n      if (this.isPureOrCondition(clause)) {\n        orClauses.push(...clause.$or);\n        return;\n      }\n      orClauses.push(clause);\n    };\n\n    if (hasInternalOr) {\n      for (const op of matchOps) {\n        if (op.type === \"where:callback\" || op.type === \"orWhere:callback\") {\n          const nestedCondition = this.buildCallbackCondition(op.data);\n          if (nestedCondition) {\n            pushOr(nestedCondition);\n          }\n          continue;\n        }\n\n        if (op.type === \"where:object\" || op.type === \"orWhere:object\") {\n          pushOr(op.data);\n          continue;\n        }\n\n        const condition = this.buildWhereCondition(op);\n        if (condition) {\n          pushOr(condition);\n        }\n      }\n\n      return orClauses.length > 0 ? { $or: orClauses } : null;\n    }\n\n    for (const op of matchOps) {\n      if (op.type === \"where:callback\") {\n        const nestedCondition = this.buildCallbackCondition(op.data);\n        if (nestedCondition) {\n          Object.assign(andFilter, nestedCondition);\n        }\n      } else if (op.type === \"where:object\") {\n        Object.assign(andFilter, op.data);\n      } else {\n        const condition = this.buildWhereCondition(op);\n        if (condition) {\n          Object.assign(andFilter, condition);\n        }\n      }\n    }\n\n    return Object.keys(andFilter).length > 0 ? andFilter : null;\n  }\n\n  /**\n   * Build a MongoDB filter condition from a where operation.\n   *\n   * @param op - The operation to build\n   * @returns The MongoDB filter condition\n   */\n  private buildWhereCondition(op: Operation): any {\n    const { field, operator, value } = op.data;\n\n    switch (op.type) {\n      case \"where\":\n      case \"orWhere\":\n        return this.buildOperatorCondition(field, operator, value);\n\n      case \"whereIn\":\n        return { [field]: { $in: value || op.data.values } };\n\n      case \"whereNotIn\":\n        return { [field]: { $nin: value || op.data.values } };\n\n      case \"whereNull\":\n        return { [field]: null };\n\n      case \"whereNotNull\":\n        return { [field]: { $ne: null } };\n\n      case \"whereBetween\":\n        return {\n          [field]: {\n            $gte: op.data.range[0],\n            $lte: op.data.range[1],\n          },\n        };\n\n      case \"whereNotBetween\":\n        return {\n          [field]: {\n            $not: {\n              $gte: op.data.range[0],\n              $lte: op.data.range[1],\n            },\n          },\n        };\n\n      case \"whereLike\": {\n        const pattern =\n          typeof op.data.pattern === \"string\" ? op.data.pattern : op.data.pattern.source;\n        return { [field]: { $regex: pattern, $options: \"i\" } };\n      }\n\n      case \"whereNotLike\": {\n        const notPattern =\n          typeof op.data.pattern === \"string\" ? op.data.pattern : op.data.pattern.source;\n        return { [field]: { $not: { $regex: notPattern, $options: \"i\" } } };\n      }\n\n      case \"whereStartsWith\":\n        return { [field]: { $regex: `^${op.data.value}`, $options: \"i\" } };\n\n      case \"whereNotStartsWith\":\n        return {\n          [field]: { $not: { $regex: `^${op.data.value}`, $options: \"i\" } },\n        };\n\n      case \"whereEndsWith\":\n        return { [field]: { $regex: `${op.data.value}$`, $options: \"i\" } };\n\n      case \"whereNotEndsWith\":\n        return {\n          [field]: { $not: { $regex: `${op.data.value}$`, $options: \"i\" } },\n        };\n\n      case \"whereExists\":\n        return { [field]: { $exists: true } };\n\n      case \"whereNotExists\":\n        return { [field]: { $exists: false } };\n\n      case \"whereSize\":\n        if (op.data.operator === \"=\") {\n          return { [field]: { $size: op.data.size } };\n        } else {\n          const mongoOp = this.getMongoOperator(op.data.operator);\n          return {\n            $expr: {\n              [mongoOp]: [{ $size: `$${field}` }, op.data.size],\n            },\n          };\n        }\n\n      case \"textSearch\":\n        return {\n          $text: { $search: op.data.query },\n          ...(op.data.filters || {}),\n        };\n\n      case \"whereRaw\":\n      case \"orWhereRaw\":\n        return this.resolveRawExpression(\n          op.data.expression as RawExpression,\n          op.data.bindings,\n        );\n\n      case \"whereColumn\":\n      case \"orWhereColumn\":\n        return this.buildColumnComparison(op.data.first, op.data.operator, op.data.second);\n\n      case \"whereBetweenColumns\":\n        return this.buildBetweenColumnsCondition(\n          op.data.field,\n          op.data.lowerColumn,\n          op.data.upperColumn,\n        );\n\n      case \"whereDate\":\n      case \"whereDateEquals\":\n        return this.buildDateEqualityCondition(op.data.field, op.data.value);\n\n      case \"whereDateBefore\":\n        return this.buildDateBeforeCondition(op.data.field, op.data.value);\n\n      case \"whereDateAfter\":\n        return this.buildDateAfterCondition(op.data.field, op.data.value);\n\n      case \"whereTime\":\n        return this.buildTimeCondition(op.data.field, op.data.value);\n\n      case \"whereDay\":\n        return this.buildDatePartCondition(op.data.field, \"$dayOfMonth\", op.data.value);\n\n      case \"whereMonth\":\n        return this.buildDatePartCondition(op.data.field, \"$month\", op.data.value);\n\n      case \"whereYear\":\n        return this.buildDatePartCondition(op.data.field, \"$year\", op.data.value);\n\n      case \"whereJsonContains\":\n        return this.buildJsonContainsCondition(op.data.path, op.data.value);\n\n      case \"whereJsonDoesntContain\":\n        return this.buildJsonDoesntContainCondition(op.data.path, op.data.value);\n\n      case \"whereJsonContainsKey\":\n        return this.buildJsonContainsKeyCondition(op.data.path);\n\n      case \"whereJsonLength\":\n        return this.buildJsonLengthCondition(\n          op.data.path,\n          op.data.operator,\n          op.data.value,\n        );\n\n      case \"whereJsonIsArray\":\n        return this.buildJsonTypeCondition(op.data.path, \"array\");\n\n      case \"whereJsonIsObject\":\n        return this.buildJsonTypeCondition(op.data.path, \"object\");\n\n      case \"whereArrayLength\":\n        return this.buildArrayLengthCondition(\n          op.data.field,\n          op.data.operator,\n          op.data.value,\n        );\n\n      case \"whereFullText\":\n      case \"orWhereFullText\":\n        return { $text: { $search: op.data.query } };\n\n      case \"whereSearch\":\n        return {\n          [op.data.field]: {\n            $regex: op.data.query,\n            $options: \"i\",\n          },\n        };\n\n      case \"where:not\":\n      case \"orWhere:not\": {\n        const nestedNot = this.buildCallbackCondition(op.data.callback);\n        return nestedNot ? { $nor: [nestedNot] } : null;\n      }\n\n      case \"where:exists\":\n        return this.buildCallbackCondition(op.data.callback);\n\n      case \"where:notExists\": {\n        const nestedExists = this.buildCallbackCondition(op.data.callback);\n        return nestedExists ? { $nor: [nestedExists] } : null;\n      }\n\n      case \"whereArrayContains\":\n        if (op.data.key) {\n          return {\n            [field]: {\n              $elemMatch: { [op.data.key]: op.data.value },\n            },\n          };\n        } else {\n          return { [field]: op.data.value };\n        }\n\n      default:\n        return null;\n    }\n  }\n\n  /**\n   * Build a condition based on the operator.\n   *\n   * @param field - The field name\n   * @param operator - The comparison operator\n   * @param value - The value to compare\n   * @returns The MongoDB filter condition\n   */\n  private buildOperatorCondition(field: string, operator: string, value: unknown): any {\n    switch (operator) {\n      case \"=\":\n        return { [field]: value };\n      case \"!=\":\n        return { [field]: { $ne: value } };\n      case \">\":\n        return { [field]: { $gt: value } };\n      case \">=\":\n        return { [field]: { $gte: value } };\n      case \"<\":\n        return { [field]: { $lt: value } };\n      case \"<=\":\n        return { [field]: { $lte: value } };\n      default:\n        return { [field]: value };\n    }\n  }\n\n  /**\n   * Get MongoDB operator from comparison operator.\n   *\n   * @param operator - The comparison operator\n   * @returns The MongoDB operator\n   */\n  private getMongoOperator(operator: string): string {\n    const map: Record<string, string> = {\n      \"=\": \"$eq\",\n      \"!=\": \"$ne\",\n      \">\": \"$gt\",\n      \">=\": \"$gte\",\n      \"<\": \"$lt\",\n      \"<=\": \"$lte\",\n    };\n    return map[operator] || \"$eq\";\n  }\n\n  private resolveRawExpression(expression: RawExpression, bindings?: unknown[]): any {\n    if (typeof expression === \"string\") {\n      const bound = this.bindRawString(expression, bindings);\n      return { $where: bound };\n    }\n\n    if (typeof expression === \"object\" && expression !== null) {\n      return expression;\n    }\n\n    return null;\n  }\n\n  private bindRawString(expression: string, bindings?: unknown[]): string {\n    if (!bindings || bindings.length === 0) {\n      return expression;\n    }\n\n    let index = 0;\n    return expression.replace(/\\?/g, () => {\n      const value = bindings[index++];\n      return value === undefined ? \"?\" : JSON.stringify(value);\n    });\n  }\n\n  private buildColumnComparison(first: string, operator: WhereOperator, second: string): any {\n    const mongoOperator = this.getMongoOperator(operator);\n    return {\n      $expr: {\n        [mongoOperator]: [this.wrapColumn(first), this.wrapColumn(second)],\n      },\n    };\n  }\n\n  private buildBetweenColumnsCondition(field: string, lower: string, upper: string): any {\n    return {\n      $expr: {\n        $and: [\n          { $gte: [this.wrapColumn(field), this.wrapColumn(lower)] },\n          { $lte: [this.wrapColumn(field), this.wrapColumn(upper)] },\n        ],\n      },\n    };\n  }\n\n  private wrapColumn(column: string): string {\n    return column.startsWith(\"$\") ? column : `$${column}`;\n  }\n\n  private buildDateEqualityCondition(field: string, value: Date | string): any {\n    const target = this.normalizeDateInput(value);\n    const start = this.startOfDay(target);\n    const end = this.endOfDay(target);\n    return { [field]: { $gte: start, $lte: end } };\n  }\n\n  private buildDateBeforeCondition(field: string, value: Date | string): any {\n    const target = this.startOfDay(this.normalizeDateInput(value));\n    return { [field]: { $lt: target } };\n  }\n\n  private buildDateAfterCondition(field: string, value: Date | string): any {\n    const target = this.endOfDay(this.normalizeDateInput(value));\n    return { [field]: { $gt: target } };\n  }\n\n  private buildTimeCondition(field: string, value: string): any {\n    return {\n      $expr: {\n        $eq: [\n          {\n            $dateToString: {\n              format: \"%H:%M\",\n              date: `$${field}`,\n            },\n          },\n          value,\n        ],\n      },\n    };\n  }\n\n  private buildDatePartCondition(\n    field: string,\n    operator: \"$dayOfMonth\" | \"$month\" | \"$year\",\n    value: number,\n  ): any {\n    return {\n      $expr: {\n        $eq: [\n          {\n            [operator]: `$${field}`,\n          },\n          value,\n        ],\n      },\n    };\n  }\n\n  private buildJsonContainsCondition(path: string, value: unknown): any {\n    const fieldPath = this.normalizePath(path);\n    if (Array.isArray(value)) {\n      return { [fieldPath]: { $all: value } };\n    }\n    return { [fieldPath]: value };\n  }\n\n  private buildJsonDoesntContainCondition(path: string, value: unknown): any {\n    const fieldPath = this.normalizePath(path);\n    const values = Array.isArray(value) ? value : [value];\n    return { [fieldPath]: { $nin: values } };\n  }\n\n  private buildJsonContainsKeyCondition(path: string): any {\n    return {\n      [this.normalizePath(path)]: { $exists: true },\n    };\n  }\n\n  private buildJsonLengthCondition(path: string, operator: WhereOperator, value: number): any {\n    const mongoOperator = this.getMongoOperator(operator);\n    return {\n      $expr: {\n        [mongoOperator]: [{ $size: { $ifNull: [`$${this.normalizePath(path)}`, []] } }, value],\n      },\n    };\n  }\n\n  private buildJsonTypeCondition(path: string, type: string): any {\n    return {\n      $expr: {\n        $eq: [{ $type: `$${this.normalizePath(path)}` }, type],\n      },\n    };\n  }\n\n  private buildArrayLengthCondition(field: string, operator: WhereOperator, value: number): any {\n    const mongoOperator = this.getMongoOperator(operator);\n    return {\n      $expr: {\n        [mongoOperator]: [{ $size: { $ifNull: [`$${field}`, []] } }, value],\n      },\n    };\n  }\n\n  private normalizeDateInput(value: Date | string): Date {\n    if (value instanceof Date) {\n      return value;\n    }\n    const parsed = new Date(value);\n    if (Number.isNaN(parsed.getTime())) {\n      throw new Error(`Invalid date value: ${value}`);\n    }\n    return parsed;\n  }\n\n  private startOfDay(date: Date): Date {\n    const copy = new Date(date);\n    copy.setHours(0, 0, 0, 0);\n    return copy;\n  }\n\n  private endOfDay(date: Date): Date {\n    const copy = new Date(date);\n    copy.setHours(23, 59, 59, 999);\n    return copy;\n  }\n\n  private normalizePath(path: string): string {\n    return path.replace(/->/g, \".\");\n  }\n\n  private applyProjectionFields(\n    projection: Record<string, unknown>,\n    fields: string[],\n    value: 0 | 1,\n  ): void {\n    for (const field of fields) {\n      projection[field] = value;\n    }\n  }\n\n  /**\n   * Apply projection object with aliases and inclusion/exclusion.\n   * @param projection - The projection object to modify\n   * @param projectionObj - The projection specification\n   */\n  private applyProjectionObject(\n    projection: Record<string, unknown>,\n    projectionObj: Record<string, unknown>,\n  ): void {\n    for (const [field, value] of Object.entries(projectionObj)) {\n      // Handle boolean values (true = 1, false = 0)\n      if (typeof value === \"boolean\") {\n        projection[field] = value ? 1 : 0;\n        continue;\n      }\n\n      // Handle numeric values (0 or 1)\n      if (typeof value === \"number\") {\n        projection[field] = value;\n        continue;\n      }\n\n      // Handle string values (aliases)\n      if (typeof value === \"string\") {\n        // Alias: project the field with a new name\n        projection[value] = `$${field}`;\n        continue;\n      }\n\n      // Handle complex expressions (objects)\n      if (typeof value === \"object\" && value !== null) {\n        projection[field] = value;\n        continue;\n      }\n\n      // Default: include the field\n      projection[field] = 1;\n    }\n  }\n\n  private applyRawProjection(\n    projection: Record<string, unknown>,\n    expression: RawExpression,\n    bindings?: unknown[],\n  ): void {\n    const resolved = this.resolveProjectionExpression(expression, bindings);\n    if (!resolved) {\n      return;\n    }\n\n    if (typeof resolved === \"object\" && resolved !== null && !Array.isArray(resolved)) {\n      Object.assign(projection, resolved as Record<string, unknown>);\n    }\n  }\n\n  private resolveProjectionExpression(\n    expression: RawExpression | unknown,\n    bindings?: unknown[],\n  ): any {\n    if (typeof expression === \"string\") {\n      const source =\n        bindings && expression.includes(\"?\")\n          ? this.bindRawString(expression, bindings)\n          : expression;\n      if (source.startsWith(\":\")) {\n        return source.slice(1);\n      }\n      return this.normalizeFieldReference(source);\n    }\n\n    if (typeof expression === \"object\" && expression !== null && !(expression instanceof Date)) {\n      return expression;\n    }\n\n    if (typeof expression === \"number\" || typeof expression === \"boolean\") {\n      return expression;\n    }\n\n    return expression;\n  }\n\n  private normalizeFieldReference(value: string | RawExpression): any {\n    if (typeof value === \"string\") {\n      if (value.startsWith(\":\")) {\n        return value.slice(1);\n      }\n      // If already a field reference, return as-is\n      if (value.startsWith(\"$\")) {\n        return value;\n      }\n      // Check if it's a string literal (contains spaces or special chars)\n      // Field paths are typically: alphanumeric, underscore, dot only\n      if (!/^[a-zA-Z0-9_.]+$/.test(value)) {\n        return value; // Return as literal\n      }\n      // Otherwise, treat as field reference\n      return `$${value}`;\n    }\n    return value;\n  }\n\n  private buildAggregateProjection(field: string, aggregate: string): any {\n    if (aggregate === \"count\") {\n      return this.buildArraySizeExpression(field);\n    }\n\n    const map: Record<string, string> = {\n      sum: \"$sum\",\n      avg: \"$avg\",\n      min: \"$min\",\n      max: \"$max\",\n      first: \"$first\",\n      last: \"$last\",\n    };\n\n    const operator = map[aggregate];\n    if (!operator) {\n      return null;\n    }\n\n    return {\n      [operator]: this.normalizeFieldReference(field),\n    };\n  }\n\n  private buildExistsProjection(field: string): any {\n    return {\n      $ne: [{ $type: `$${field}` }, \"missing\"],\n    };\n  }\n\n  private buildArraySizeExpression(field: string): any {\n    return {\n      $size: { $ifNull: [`$${field}`, []] },\n    };\n  }\n\n  private buildCaseExpression(\n    cases: Array<{ when: RawExpression; then: RawExpression | unknown }>,\n    otherwise: RawExpression | unknown,\n  ): any {\n    return {\n      $switch: {\n        branches: cases.map((item) => ({\n          case: this.resolveProjectionExpression(item.when),\n          then: this.resolveLiteralOrExpression(item.then),\n        })),\n        default: this.resolveLiteralOrExpression(otherwise),\n      },\n    };\n  }\n\n  private buildCondExpression(\n    condition: RawExpression,\n    thenValue: RawExpression | unknown,\n    elseValue: RawExpression | unknown,\n  ): any {\n    return {\n      $cond: [\n        this.resolveProjectionExpression(condition),\n        this.resolveLiteralOrExpression(thenValue),\n        this.resolveLiteralOrExpression(elseValue),\n      ],\n    };\n  }\n\n  /**\n   * Resolve a value as a literal (if it's a plain string) or as an expression.\n   * Used for `then`/`default` values in CASE/WHEN expressions.\n   */\n  private resolveLiteralOrExpression(value: RawExpression | unknown): any {\n    // If it's a string that starts with $, treat as field reference\n    if (typeof value === \"string\" && value.startsWith(\"$\")) {\n      return value;\n    }\n    // If it's a plain string (not starting with $), treat as literal\n    if (typeof value === \"string\") {\n      return value;\n    }\n    // For objects (expressions), numbers, booleans, etc., use normal resolution\n    return this.resolveProjectionExpression(value);\n  }\n\n  private inferJsonAlias(path: string): string {\n    const normalized = this.normalizePath(path);\n    const segments = normalized.split(\".\");\n    return segments[segments.length - 1];\n  }\n\n  private buildConcatExpression(values: Array<string | RawExpression>): any {\n    return {\n      $concat: values.map((value) => this.normalizeFieldReference(value)),\n    };\n  }\n\n  private buildCoalesceExpression(values: Array<string | RawExpression>): any {\n    if (values.length === 0) {\n      return null;\n    }\n\n    let expression = this.normalizeFieldReference(values[values.length - 1]);\n\n    for (let index = values.length - 2; index >= 0; index--) {\n      expression = {\n        $ifNull: [this.normalizeFieldReference(values[index]), expression],\n      };\n    }\n\n    return expression;\n  }\n\n  /**\n   * Build a $project stage from select operations.\n   *\n   * @param operations - The select operations\n   * @returns The $project stage or null\n   */\n  private buildProjectStage(operations: Operation[]): any {\n    if (operations.length === 0) {\n      return null;\n    }\n\n    const projection: Record<string, unknown> = {};\n    const driverCallbacks: Array<(projection: Record<string, unknown>) => void> = [];\n\n    for (const op of operations) {\n      switch (op.type) {\n        case \"select\":\n          // Handle new projection format with aliases\n          if (op.data.projection) {\n            this.applyProjectionObject(projection, op.data.projection);\n          } else if (op.data.fields) {\n            this.applyProjectionFields(projection, op.data.fields, 1);\n          }\n          break;\n\n        case \"deselect\":\n          this.applyProjectionFields(projection, op.data.fields, 0);\n          break;\n\n        case \"addSelect\":\n          this.applyProjectionFields(projection, op.data.fields, 1);\n          break;\n\n        case \"selectRaw\":\n          this.applyRawProjection(projection, op.data.expression, op.data.bindings);\n          break;\n\n        case \"selectSub\":\n        case \"addSelectSub\": {\n          const expr = this.resolveProjectionExpression(op.data.expression, op.data.bindings);\n          if (expr !== undefined) {\n            projection[op.data.alias] = expr;\n          }\n          break;\n        }\n\n        case \"selectAggregate\":\n          projection[op.data.alias] = this.buildAggregateProjection(\n            op.data.field,\n            op.data.aggregate,\n          );\n          break;\n\n        case \"selectExists\":\n          projection[op.data.alias] = this.buildExistsProjection(op.data.field);\n          break;\n\n        case \"selectCount\":\n          projection[op.data.alias] = this.buildArraySizeExpression(op.data.field);\n          break;\n\n        case \"selectCase\":\n          projection[op.data.alias] = this.buildCaseExpression(\n            op.data.cases,\n            op.data.otherwise,\n          );\n          break;\n\n        case \"selectWhen\":\n          projection[op.data.alias] = this.buildCondExpression(\n            op.data.condition,\n            op.data.thenValue,\n            op.data.elseValue,\n          );\n          break;\n\n        case \"selectDriverProjection\":\n          driverCallbacks.push(op.data.callback);\n          break;\n\n        case \"selectJson\": {\n          const alias = op.data.alias ?? this.inferJsonAlias(op.data.path);\n          projection[alias] = this.normalizeFieldReference(\n            `$${this.normalizePath(op.data.path)}`,\n          );\n          break;\n        }\n\n        case \"selectJsonRaw\": {\n          projection[op.data.alias] = this.resolveProjectionExpression(op.data.expression);\n          break;\n        }\n\n        case \"deselectJson\":\n          projection[this.normalizePath(op.data.path)] = 0;\n          break;\n\n        case \"selectConcat\":\n          projection[op.data.alias] = this.buildConcatExpression(op.data.fields);\n          break;\n\n        case \"selectCoalesce\":\n          projection[op.data.alias] = this.buildCoalesceExpression(op.data.fields);\n          break;\n\n        default:\n          break;\n      }\n    }\n\n    for (const callback of driverCallbacks) {\n      callback(projection);\n    }\n\n    return Object.keys(projection).length > 0 ? { $project: projection } : null;\n  }\n\n  /**\n   * Build a $sort stage from order operations.\n   *\n   * @param operations - The order operations\n   * @returns The $sort stage or null\n   */\n  private buildSortStage(operations: Operation[]): any {\n    const sort: any = {};\n\n    for (const op of operations) {\n      switch (op.type) {\n        case \"orderBy\":\n          sort[op.data.field] = op.data.direction === \"asc\" ? 1 : -1;\n          break;\n\n        case \"orderByRandom\":\n          return { $sample: { size: op.data.limit } };\n\n        case \"orderByRaw\":\n          // TODO: Handle raw expressions\n          break;\n      }\n    }\n\n    return Object.keys(sort).length > 0 ? { $sort: sort } : null;\n  }\n\n  /**\n   * Build a $group stage from group operations.\n   *\n   * @param operations - The group operations\n   * @returns The $group stage or null\n   */\n  private buildGroupStage(operations: Operation[]): any {\n    const op = operations[0];\n\n    switch (op.type) {\n      case \"groupBy\": {\n        const stage = this.buildGroupByStage(op.data.fields);\n        if (stage) {\n          return stage;\n        }\n        break;\n      }\n      case \"groupByWithAggregates\": {\n        const stage = this.buildGroupByWithAggregatesStage(\n          op.data.fields,\n          op.data.aggregates,\n        );\n        if (stage) {\n          return stage;\n        }\n        break;\n      }\n      case \"groupByDate\": {\n        const stage = this.buildGroupByDateStage(\n          op.data.column,\n          op.data.unit,\n          op.data.aggregates ?? {},\n        );\n        if (stage) {\n          return stage;\n        }\n        break;\n      }\n      case \"groupByRaw\": {\n        const expression = op.data.expression;\n        if (expression && typeof expression === \"object\") {\n          return { $group: expression };\n        }\n        // If expression is not an object, it might be a string or other type\n        // In that case, we should still return it as a $group stage\n        if (expression) {\n          return { $group: { _id: expression } };\n        }\n        break;\n      }\n      case \"distinct\": {\n        const stage = this.buildGroupByStage(op.data.fields);\n        if (stage) {\n          return stage;\n        }\n        break;\n      }\n      default:\n        break;\n    }\n\n    return null;\n  }\n\n  private buildGroupByStage(fields: GroupByInput): any {\n    const groupId = this.buildGroupId(fields);\n    if (!groupId) {\n      return null;\n    }\n\n    return { $group: { _id: groupId } };\n  }\n\n  /**\n   * Build a $group stage with aggregates from group operations.\n   *\n   * @param fields - Fields to group by\n   * @param aggregates - Aggregate operations (abstract or raw)\n   * @returns The $group stage or null\n   */\n  private buildGroupByWithAggregatesStage(\n    fields: GroupByInput,\n    aggregates: Record<string, RawExpression>,\n  ): any {\n    const groupId = this.buildGroupId(fields);\n    if (!groupId) {\n      return null;\n    }\n\n    const groupStage: Record<string, unknown> = {\n      _id: groupId,\n    };\n\n    // Translate each aggregate expression\n    for (const [alias, expression] of Object.entries(aggregates)) {\n      if (isAggregateExpression(expression)) {\n        // Translate abstract expression to MongoDB format\n        groupStage[alias] = this.translateAggregateExpression(expression);\n      } else {\n        // Use raw expression as-is (already in MongoDB format)\n        groupStage[alias] = expression;\n      }\n    }\n\n    return { $group: groupStage };\n  }\n\n  /**\n   * Build a `$group` stage that buckets documents by a `$dateTrunc` of a date\n   * field, optionally running aggregates over each bucket.\n   *\n   * @param column - The date field to bucket\n   * @param unit - The bucket granularity\n   * @param aggregates - Aggregate operations (abstract or raw)\n   * @returns The `$group` stage\n   */\n  private buildGroupByDateStage(\n    column: string,\n    unit: string,\n    aggregates: Record<string, RawExpression>,\n  ): any {\n    const groupStage: Record<string, unknown> = {\n      _id: { $dateTrunc: { date: `$${column}`, unit } },\n    };\n\n    for (const [alias, expression] of Object.entries(aggregates)) {\n      if (isAggregateExpression(expression)) {\n        groupStage[alias] = this.translateAggregateExpression(expression);\n      } else {\n        groupStage[alias] = expression;\n      }\n    }\n\n    return { $group: groupStage };\n  }\n\n  /**\n   * Extract field names from GroupByInput for renaming _id.\n   *\n   * @param fields - The grouping fields\n   * @returns Field name(s) to use for renaming _id\n   */\n  private extractGroupFieldNames(fields: GroupByInput): string | string[] | null {\n    if (typeof fields === \"string\") {\n      return fields;\n    }\n\n    if (Array.isArray(fields)) {\n      const allStrings = fields.every((field) => typeof field === \"string\");\n      if (allStrings) {\n        return fields as string[];\n      }\n      // For complex arrays, return null (don't rename)\n      return null;\n    }\n\n    if (typeof fields === \"object\" && fields !== null) {\n      // For object syntax, use the keys as field names\n      return Object.keys(fields);\n    }\n\n    return null;\n  }\n\n  /**\n   * Translate an abstract aggregate expression to MongoDB format.\n   *\n   * @param expr - Abstract aggregate expression\n   * @returns MongoDB aggregation expression\n   */\n  private translateAggregateExpression(expr: AggregateExpression): Record<string, unknown> {\n    switch (expr.__agg) {\n      case \"count\":\n        return { $sum: 1 };\n\n      case \"countDistinct\":\n        if (!expr.__field) {\n          throw new Error(\"Count distinct aggregate requires a field name\");\n        }\n        // Accumulate the set of distinct values in the $group stage; the\n        // renaming $project then finalizes it with `{ $size: \"$alias\" }`\n        // (the standard distinct-count-per-group pattern — `$size` is not a\n        // valid $group accumulator).\n        return { $addToSet: `$${expr.__field}` };\n\n      case \"sum\":\n        // When a composed column expression is present, sum operates on it\n        // (e.g. SUM(price * quantity) → { $sum: { $multiply: [...] } }) instead\n        // of a bare field. This is the only aggregate that accepts `__expr`.\n        if (expr.__expr) {\n          return { $sum: this.columnExpressionToMongo(expr.__expr) };\n        }\n        if (!expr.__field) {\n          throw new Error(\"Sum aggregate requires a field name\");\n        }\n        return { $sum: `$${expr.__field}` };\n\n      case \"avg\":\n        if (!expr.__field) {\n          throw new Error(\"Average aggregate requires a field name\");\n        }\n        return { $avg: `$${expr.__field}` };\n\n      case \"min\":\n        if (!expr.__field) {\n          throw new Error(\"Min aggregate requires a field name\");\n        }\n        return { $min: `$${expr.__field}` };\n\n      case \"max\":\n        if (!expr.__field) {\n          throw new Error(\"Max aggregate requires a field name\");\n        }\n        return { $max: `$${expr.__field}` };\n\n      case \"first\":\n        if (!expr.__field) {\n          throw new Error(\"First aggregate requires a field name\");\n        }\n        return { $first: `$${expr.__field}` };\n\n      case \"last\":\n        if (!expr.__field) {\n          throw new Error(\"Last aggregate requires a field name\");\n        }\n        return { $last: `$${expr.__field}` };\n\n      case \"distinct\":\n        if (!expr.__field) {\n          throw new Error(\"Distinct aggregate requires a field name\");\n        }\n        return { $distinct: `$${expr.__field}` };\n\n      case \"floor\":\n        if (!expr.__field) {\n          throw new Error(\"Floor aggregate requires a field name\");\n        }\n\n        return { $floor: `$${expr.__field}` };\n\n      default:\n        throw new Error(`Unknown aggregate function: ${expr.__agg}`);\n    }\n  }\n\n  /**\n   * Compile a typed {@link ColumnExpression} tree into a MongoDB aggregation\n   * expression.\n   *\n   * Column references become `$field` paths; literals are emitted verbatim;\n   * arithmetic ops map to `$add` / `$subtract` / `$multiply` / `$divide`. The\n   * `raw` node is rejected — a raw SQL fragment is not portable to a MongoDB\n   * pipeline, so callers must use the typed combinators (or `groupByRaw`) here.\n   *\n   * @param expression - The expression tree to compile\n   * @returns A MongoDB aggregation expression (e.g. `{ $multiply: [\"$price\", \"$quantity\"] }`)\n   */\n  private columnExpressionToMongo(expression: ColumnExpression): unknown {\n    switch (expression.__expr) {\n      case \"column\":\n        return `$${expression.column}`;\n\n      case \"literal\":\n        return expression.value;\n\n      case \"raw\":\n        throw new Error(\n          `$agg.sumRaw / $expr.raw is not portable to a MongoDB pipeline — a raw ` +\n            `SQL fragment has no MongoDB equivalent. Use the typed $expr ` +\n            `combinators ($expr.mul / $expr.add / $expr.sub / $expr.div / $expr.col / $expr.lit) or groupByRaw instead.`,\n        );\n\n      case \"add\":\n      case \"subtract\":\n      case \"multiply\":\n      case \"divide\": {\n        const operator = {\n          add: \"$add\",\n          subtract: \"$subtract\",\n          multiply: \"$multiply\",\n          divide: \"$divide\",\n        }[expression.__expr];\n\n        return {\n          [operator]: expression.operands.map((operand) => this.columnExpressionToMongo(operand)),\n        };\n      }\n\n      default:\n        throw new Error(`Unsupported column expression node: ${JSON.stringify(expression)}`);\n    }\n  }\n\n  private buildGroupId(fields: GroupByInput): any {\n    if (!fields) {\n      return null;\n    }\n\n    if (typeof fields === \"string\") {\n      return `$${fields}`;\n    }\n\n    if (Array.isArray(fields)) {\n      if (fields.length === 0) {\n        return null;\n      }\n\n      const allStrings = fields.every((field) => typeof field === \"string\");\n      if (allStrings) {\n        const result: Record<string, string> = {};\n        for (const field of fields as string[]) {\n          result[field] = `$${field}`;\n        }\n        return result;\n      }\n\n      // Array of objects - merge them to build complex _id structures\n      return (fields as Record<string, unknown>[]).reduce((acc, item) => ({ ...acc, ...item }), {});\n    }\n\n    if (typeof fields === \"object\") {\n      const normalized: Record<string, unknown> = {};\n      Object.entries(fields).forEach(([key, value]) => {\n        if (typeof value === \"string\" && !value.startsWith(\"$\")) {\n          normalized[key] = `$${value}`;\n        } else {\n          normalized[key] = value;\n        }\n      });\n      return normalized;\n    }\n\n    return null;\n  }\n\n  /**\n   * Build a $lookup stage from join operations.\n   *\n   * @param operations - The join operations\n   * @returns The $lookup stage or null\n   */\n  private buildLookupStage(operations: Operation[]): any {\n    const op = operations[0];\n    const options = op.data;\n\n    return {\n      $lookup: {\n        from: options.table,\n        localField: options.localField,\n        foreignField: options.foreignField,\n        as: options.alias || options.table,\n      },\n    };\n  }\n}\n"],"mappings":"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"}

package/esm/drivers/postgres/postgres-driver.d.mts

@@ -90,12 +90,21 @@ declare class PostgresDriver implements DriverContract {
    */
   private _syncAdapter;
   /**
-   * Lookup set of column names that hold native PostgreSQL arrays
-   * (`JSONB[]`, `TEXT[]`, …) and must NOT be JSON-text encoded.
+   * Explicit, table-agnostic override list of column names that hold native
+   * PostgreSQL arrays (`JSONB[]`, `TEXT[]`, …) and must NOT be JSON-text
+   * encoded. Merged with (and superseded per-table by) the schema
+   * introspection below; kept as a manual escape hatch.
    *
    * @see PostgresPoolConfig.nativeArrayColumns
    */
   private readonly _nativeArrayColumns;
+  /**
+   * Native-array columns discovered by introspecting the live schema on
+   * connect, keyed `table → { column, … }`. Authoritative and table-scoped, so
+   * a column that is `TEXT[]` in one table and `jsonb` in another is encoded
+   * correctly for each — no app configuration required.
+   */
+  private _introspectedArrayColumns;
   /**
    * Create a new PostgreSQL driver instance.
    *
@@ -148,9 +157,11 @@ declare class PostgresDriver implements DriverContract {
    * that need special handling for PostgreSQL storage.
    *
    * @param data - The data object to serialize
+   * @param table - Optional table name; when given, columns introspected as
+   *   native arrays on that table are bound raw (see {@link serializeValue}).
    * @returns Serialized data ready for PostgreSQL
    */
-  serialize(data: Record<string, unknown>): Record<string, unknown>;
+  serialize(data: Record<string, unknown>, table?: string): Record<string, unknown>;
   /**
    * Serialize a single column value into a node-pg bindable parameter.
    *
@@ -167,25 +178,54 @@ declare class PostgresDriver implements DriverContract {
    *   `JSON.stringify`. node-pg renders a raw JS array as a PostgreSQL array
    *   literal `{...}` (and `[]` as `{}`), which a `json` / `jsonb` column
    *   rejects — so we bind the value as JSON text instead, the form those
-   *   columns accept. Columns listed in `nativeArrayColumns` are exempt:
-   *   their raw array is passed through so node-pg emits the `{...}` literal
-   *   a genuine `JSONB[]` / `TEXT[]` column needs.
+   *   columns accept. Columns known to be native arrays — via schema
+   *   introspection or the `nativeArrayColumns` config — are exempt: their raw
+   *   array is passed through so node-pg emits the `{...}` literal a genuine
+   *   `JSONB[]` / `TEXT[]` column needs.
    * - plain object → `JSON.stringify`. Equivalent to node-pg's own object
    *   handling, made explicit so both write paths agree.
    * - everything else (scalars: string, number, boolean, null) → untouched.
    *
-   * Boundary note: the serializer has no access to the table schema, so it
-   * cannot tell a `json` / `jsonb` column from a native-array column purely
-   * from the value. `nativeArrayColumns` is the explicit, opt-in escape hatch
-   * for the latter. No `::jsonb` placeholder cast is added: a JSON-text string
-   * binds correctly to `json` / `jsonb` without one, and a blind cast would
-   * misfire on columns we cannot positively identify as jsonb.
+   * Distinguishing native-array from `json` / `jsonb` columns: a value alone
+   * can't tell them apart, so the driver introspects the live schema on connect
+   * (see {@link loadNativeArrayColumns}) and consults that per-table map here
+   * via {@link isNativeArrayColumn}. The explicit `nativeArrayColumns` config
+   * still works as a table-agnostic override. No `::jsonb` placeholder cast is
+   * added: a JSON-text string binds correctly to `json` / `jsonb` without one,
+   * and a blind cast would misfire on columns we cannot positively identify as
+   * jsonb.
    *
-   * @param key - Column name (used to honour `nativeArrayColumns`)
+   * @param key - Column name (used to resolve native-array columns)
    * @param value - The raw value to serialize (never `undefined`)
+   * @param table - Optional table name; enables the per-table native-array lookup
    * @returns The value ready to bind as a query parameter
    */
   private serializeValue;
+  /**
+   * Whether `column` on `table` is a native PostgreSQL array. True when the
+   * connect-time schema introspection saw it as `data_type = 'ARRAY'` for that
+   * table (authoritative, per-table), or when it's listed in the table-agnostic
+   * `nativeArrayColumns` config override.
+   */
+  private isNativeArrayColumn;
+  /**
+   * Introspect the live schema for native-array columns so array values bind
+   * correctly with zero app configuration.
+   *
+   * A JS array must be bound two opposite ways depending on the column: as JSON
+   * text for a `json` / `jsonb` column, but as a raw array (which node-pg
+   * renders `{...}`) for a native `TEXT[]` / `JSONB[]` / `INTEGER[]` column. The
+   * serializer sees values, not types, so without this it JSON-stringifies
+   * every array — which a native-array column rejects with "malformed array
+   * literal". One `information_schema` query at connect, cached for the
+   * connection lifetime, removes the need to hand-list `nativeArrayColumns`.
+   *
+   * Best-effort: any failure (e.g. restricted catalog access) is logged and
+   * leaves the map empty so the config override still applies — it never blocks
+   * connect. A schema change made within a live connection isn't reflected
+   * until the next connect.
+   */
+  private loadNativeArrayColumns;
   /**
    * Get the dirty tracker for this driver.
    */
@@ -348,6 +388,9 @@ declare class PostgresDriver implements DriverContract {
    * Perform an atomic update operation.
    *
    * Builds and executes an UPDATE query for the given filter and operations.
+   * Updates EVERY matching row — the MongoDB driver's atomic() delegates to
+   * updateMany, and Model.findAndUpdate documents multi-row semantics, so the
+   * two drivers must agree.
    *
    * @param table - Target table name
    * @param filter - Filter conditions
@@ -393,11 +436,24 @@ declare class PostgresDriver implements DriverContract {
   /**
    * Build a simple WHERE clause from a filter object.
    *
+   * Values are bound as plain equality, except Mongo-style operator objects
+   * (`{ $in: [...] }`, `{ $gt: 5 }`, ...) which are translated to their SQL
+   * equivalents — driver-level callers (e.g. pivot detach) build filters in
+   * that portable form. An unrecognized `$` operator throws instead of being
+   * bound literally, which would only surface as a cryptic type error from
+   * Postgres.
+   *
    * @param filter - Filter conditions
    * @param startParamIndex - Starting parameter index
    * @returns Object with WHERE clause string and parameters
    */
   private buildWhereClause;
+  /**
+   * A filter value is an operator object when it is a plain object whose keys
+   * ALL start with `$`. Arrays, Dates, and value objects (e.g. jsonb equality
+   * payloads) keep their existing bind-as-value behavior.
+   */
+  private isOperatorFilter;
   /**
    * Build an UPDATE query from update operations.
    *

package/esm/drivers/postgres/postgres-driver.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"postgres-driver.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/cascade/src/drivers/postgres/postgres-driver.ts"],"mappings":"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"}
+{"version":3,"file":"postgres-driver.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/cascade/src/drivers/postgres/postgres-driver.ts"],"mappings":"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"}