@warlock.js/cascade 4.0.171 → 4.1.1

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

@@ -0,0 +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 { 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   * 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    }\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\n        const aggregateFields = Object.keys(stage.$group).filter((key) => key !== \"_id\");\n        for (const field of aggregateFields) {\n          projection[field] = 1;\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 \"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   * 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 \"sum\":\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  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/mongodb/mongodb-sync-adapter.d.mts

@@ -0,0 +1,78 @@
+import { SyncAdapterContract, SyncInstruction } from "../../contracts/sync-adapter.contract.mjs";
+import { MongoDbDriver } from "./mongodb-driver.mjs";
+
+//#region ../../@warlock.js/cascade/src/drivers/mongodb/mongodb-sync-adapter.d.ts
+/**
+ * MongoDB implementation of the sync adapter.
+ * Handles array updates using positional operators and arrayFilters.
+ * Automatically participates in active transactions via the driver's session context.
+ */
+declare class MongoSyncAdapter implements SyncAdapterContract {
+  private readonly driver;
+  /**
+   * Creates a new MongoDB sync adapter.
+   *
+   * @param driver - The MongoDB driver instance (provides session-aware operations)
+   */
+  constructor(driver: MongoDbDriver);
+  /**
+   * Executes a batch of sync instructions.
+   *
+   * @param instructions - Array of sync instructions
+   * @returns Total number of documents affected
+   */
+  executeBatch(instructions: SyncInstruction[]): Promise<number>;
+  /**
+   * Executes a single sync instruction.
+   * Uses the driver's updateMany to automatically participate in active transactions.
+   *
+   * @param instruction - The sync instruction
+   * @returns Number of documents affected
+   */
+  executeOne(instruction: SyncInstruction): Promise<number>;
+  /**
+   * Executes an array update using MongoDB positional operators.
+   * Uses the driver's updateMany to automatically participate in active transactions.
+   *
+   * @param instruction - The sync instruction with array info
+   * @returns Number of documents affected
+   */
+  executeArrayUpdate(instruction: SyncInstruction): Promise<number>;
+  /**
+   * Checks if positional operator $ can be used.
+   * Requires filter to already match the array element.
+   *
+   * @param instruction - The sync instruction
+   * @returns True if positional operator can be used
+   */
+  private canUsePositionalOperator;
+  /**
+   * Executes array update using arrayFilters.
+   * Uses the driver's updateMany with arrayFilters option to participate in transactions.
+   *
+   * @param instruction - The sync instruction
+   * @returns Number of documents affected
+   */
+  private executeWithArrayFilters;
+  /**
+   * Builds an optimized filter to reduce the number of documents scanned.
+   * Adds array existence check when filter doesn't already match array elements.
+   *
+   * @param originalFilter - The original filter from the instruction
+   * @param arrayField - The array field path
+   * @param identifierField - The identifier field within array elements
+   * @returns Optimized filter
+   */
+  private buildOptimizedFilter;
+  /**
+   * Transforms update operation to use arrayFilters placeholder.
+   *
+   * @param update - Original update operation
+   * @param arrayField - Array field path
+   * @returns Transformed update operation
+   */
+  private transformUpdateForArrayFilters;
+}
+//#endregion
+export { MongoSyncAdapter };
+//# sourceMappingURL=mongodb-sync-adapter.d.mts.map

package/esm/drivers/mongodb/mongodb-sync-adapter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongodb-sync-adapter.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/drivers/mongodb/mongodb-sync-adapter.ts"],"mappings":";;;;;;;;;cAca,gBAAA,YAA4B,mBAAA;EAAA,iBACtB,MAAA;EADsB;;;;;cAQpB,MAAA,EAAQ,aAAA;EAAA;;;;;;EAUd,YAAA,CAAa,YAAA,EAAc,eAAA,KAAoB,OAAA;EAqBvB;;;;;;;EAAxB,UAAA,CAAW,WAAA,EAAa,eAAA,GAAkB,OAAA;EA0DzC;;;;AAkEwB;;;EA3GzB,kBAAA,CAAmB,WAAA,EAAa,eAAA,GAAkB,OAAA;;;;;;;;UA4BvD,wBAAA;;;;;;;;UAaM,uBAAA;;;;;;;;;;UAyCN,oBAAA;;;;;;;;UAyBA,8BAAA;AAAA"}

package/esm/drivers/mongodb/mongodb-sync-adapter.mjs

@@ -0,0 +1,118 @@
+//#region ../../@warlock.js/cascade/src/drivers/mongodb/mongodb-sync-adapter.ts
+/**
+* MongoDB implementation of the sync adapter.
+* Handles array updates using positional operators and arrayFilters.
+* Automatically participates in active transactions via the driver's session context.
+*/
+var MongoSyncAdapter = class {
+	driver;
+	/**
+	* Creates a new MongoDB sync adapter.
+	*
+	* @param driver - The MongoDB driver instance (provides session-aware operations)
+	*/
+	constructor(driver) {
+		this.driver = driver;
+	}
+	/**
+	* Executes a batch of sync instructions.
+	*
+	* @param instructions - Array of sync instructions
+	* @returns Total number of documents affected
+	*/
+	async executeBatch(instructions) {
+		let totalAffected = 0;
+		for (const instruction of instructions) {
+			const affected = instruction.isArrayUpdate ? await this.executeArrayUpdate(instruction) : await this.executeOne(instruction);
+			totalAffected += affected;
+		}
+		return totalAffected;
+	}
+	/**
+	* Executes a single sync instruction.
+	* Uses the driver's updateMany to automatically participate in active transactions.
+	*
+	* @param instruction - The sync instruction
+	* @returns Number of documents affected
+	*/
+	async executeOne(instruction) {
+		return (await this.driver.updateMany(instruction.targetTable, instruction.filter, instruction.update)).modifiedCount;
+	}
+	/**
+	* Executes an array update using MongoDB positional operators.
+	* Uses the driver's updateMany to automatically participate in active transactions.
+	*
+	* @param instruction - The sync instruction with array info
+	* @returns Number of documents affected
+	*/
+	async executeArrayUpdate(instruction) {
+		if (!instruction.arrayField || !instruction.identifierField) throw new Error("Array update requires arrayField and identifierField to be specified");
+		if (this.canUsePositionalOperator(instruction)) return (await this.driver.updateMany(instruction.targetTable, instruction.filter, instruction.update)).modifiedCount;
+		return await this.executeWithArrayFilters(instruction);
+	}
+	/**
+	* Checks if positional operator $ can be used.
+	* Requires filter to already match the array element.
+	*
+	* @param instruction - The sync instruction
+	* @returns True if positional operator can be used
+	*/
+	canUsePositionalOperator(instruction) {
+		return `${instruction.arrayField}.${instruction.identifierField}` in instruction.filter;
+	}
+	/**
+	* Executes array update using arrayFilters.
+	* Uses the driver's updateMany with arrayFilters option to participate in transactions.
+	*
+	* @param instruction - The sync instruction
+	* @returns Number of documents affected
+	*/
+	async executeWithArrayFilters(instruction) {
+		const arrayFilters = [{ [`elem.${instruction.identifierField}`]: instruction.identifierValue }];
+		const transformedUpdate = this.transformUpdateForArrayFilters(instruction.update, instruction.arrayField);
+		const optimizedFilter = this.buildOptimizedFilter(instruction.filter, instruction.arrayField, instruction.identifierField);
+		return (await this.driver.updateMany(instruction.targetTable, optimizedFilter, transformedUpdate, { arrayFilters })).modifiedCount;
+	}
+	/**
+	* Builds an optimized filter to reduce the number of documents scanned.
+	* Adds array existence check when filter doesn't already match array elements.
+	*
+	* @param originalFilter - The original filter from the instruction
+	* @param arrayField - The array field path
+	* @param identifierField - The identifier field within array elements
+	* @returns Optimized filter
+	*/
+	buildOptimizedFilter(originalFilter, arrayField, identifierField) {
+		if (`${arrayField}.${identifierField}` in originalFilter) return originalFilter;
+		return {
+			...originalFilter,
+			[arrayField]: {
+				$exists: true,
+				$ne: []
+			}
+		};
+	}
+	/**
+	* Transforms update operation to use arrayFilters placeholder.
+	*
+	* @param update - Original update operation
+	* @param arrayField - Array field path
+	* @returns Transformed update operation
+	*/
+	transformUpdateForArrayFilters(update, arrayField) {
+		const transformed = {};
+		for (const [operator, fields] of Object.entries(update)) if (typeof fields === "object" && fields !== null) {
+			const transformedFields = {};
+			for (const [field, value] of Object.entries(fields)) {
+				const transformedField = field.replace(`${arrayField}.$`, `${arrayField}.$[elem]`);
+				transformedFields[transformedField] = value;
+			}
+			transformed[operator] = transformedFields;
+		}
+		return transformed;
+	}
+};
+
+//#endregion
+export { MongoSyncAdapter };
+//# sourceMappingURL=mongodb-sync-adapter.mjs.map

package/esm/drivers/mongodb/mongodb-sync-adapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongodb-sync-adapter.mjs","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/drivers/mongodb/mongodb-sync-adapter.ts"],"sourcesContent":["/**\n * MongoDB-specific sync adapter implementation.\n *\n * @module cascade-next/drivers/mongodb/mongodb-sync-adapter\n */\n\nimport type { SyncAdapterContract, SyncInstruction } from \"../../contracts/sync-adapter.contract\";\nimport type { MongoDbDriver } from \"./mongodb-driver\";\n\n/**\n * MongoDB implementation of the sync adapter.\n * Handles array updates using positional operators and arrayFilters.\n * Automatically participates in active transactions via the driver's session context.\n */\nexport class MongoSyncAdapter implements SyncAdapterContract {\n  private readonly driver: MongoDbDriver;\n\n  /**\n   * Creates a new MongoDB sync adapter.\n   *\n   * @param driver - The MongoDB driver instance (provides session-aware operations)\n   */\n  public constructor(driver: MongoDbDriver) {\n    this.driver = driver;\n  }\n\n  /**\n   * Executes a batch of sync instructions.\n   *\n   * @param instructions - Array of sync instructions\n   * @returns Total number of documents affected\n   */\n  public async executeBatch(instructions: SyncInstruction[]): Promise<number> {\n    let totalAffected = 0;\n\n    for (const instruction of instructions) {\n      const affected = instruction.isArrayUpdate\n        ? await this.executeArrayUpdate(instruction)\n        : await this.executeOne(instruction);\n\n      totalAffected += affected;\n    }\n\n    return totalAffected;\n  }\n\n  /**\n   * Executes a single sync instruction.\n   * Uses the driver's updateMany to automatically participate in active transactions.\n   *\n   * @param instruction - The sync instruction\n   * @returns Number of documents affected\n   */\n  public async executeOne(instruction: SyncInstruction): Promise<number> {\n    const result = await this.driver.updateMany(\n      instruction.targetTable,\n      instruction.filter,\n      instruction.update,\n    );\n\n    return result.modifiedCount;\n  }\n\n  /**\n   * Executes an array update using MongoDB positional operators.\n   * Uses the driver's updateMany to automatically participate in active transactions.\n   *\n   * @param instruction - The sync instruction with array info\n   * @returns Number of documents affected\n   */\n  public async executeArrayUpdate(instruction: SyncInstruction): Promise<number> {\n    if (!instruction.arrayField || !instruction.identifierField) {\n      throw new Error(\"Array update requires arrayField and identifierField to be specified\");\n    }\n\n    // Strategy 1: Try positional operator $ (simpler, faster)\n    // Works when filter already identifies the array element\n    if (this.canUsePositionalOperator(instruction)) {\n      const result = await this.driver.updateMany(\n        instruction.targetTable,\n        instruction.filter,\n        instruction.update,\n      );\n      return result.modifiedCount;\n    }\n\n    // Strategy 2: Use arrayFilters (more flexible)\n    // Works for any array update scenario\n    return await this.executeWithArrayFilters(instruction);\n  }\n\n  /**\n   * Checks if positional operator $ can be used.\n   * Requires filter to already match the array element.\n   *\n   * @param instruction - The sync instruction\n   * @returns True if positional operator can be used\n   */\n  private canUsePositionalOperator(instruction: SyncInstruction): boolean {\n    // Check if filter already includes array element match\n    const arrayElementFilter = `${instruction.arrayField}.${instruction.identifierField}`;\n    return arrayElementFilter in instruction.filter;\n  }\n\n  /**\n   * Executes array update using arrayFilters.\n   * Uses the driver's updateMany with arrayFilters option to participate in transactions.\n   *\n   * @param instruction - The sync instruction\n   * @returns Number of documents affected\n   */\n  private async executeWithArrayFilters(instruction: SyncInstruction): Promise<number> {\n    // Build arrayFilters to match array elements\n    const arrayFilters = [\n      {\n        [`elem.${instruction.identifierField}`]: instruction.identifierValue,\n      },\n    ];\n\n    // Transform update to use array filter placeholder\n    const transformedUpdate = this.transformUpdateForArrayFilters(\n      instruction.update,\n      instruction.arrayField!,\n    );\n\n    // Build optimized filter to reduce documents scanned\n    const optimizedFilter = this.buildOptimizedFilter(\n      instruction.filter,\n      instruction.arrayField!,\n      instruction.identifierField!,\n    );\n\n    // Use driver's updateMany (session-aware) with arrayFilters\n    const result = await this.driver.updateMany(\n      instruction.targetTable,\n      optimizedFilter,\n      transformedUpdate,\n      { arrayFilters },\n    );\n\n    return result.modifiedCount;\n  }\n\n  /**\n   * Builds an optimized filter to reduce the number of documents scanned.\n   * Adds array existence check when filter doesn't already match array elements.\n   *\n   * @param originalFilter - The original filter from the instruction\n   * @param arrayField - The array field path\n   * @param identifierField - The identifier field within array elements\n   * @returns Optimized filter\n   */\n  private buildOptimizedFilter(\n    originalFilter: Record<string, unknown>,\n    arrayField: string,\n    identifierField: string,\n  ): Record<string, unknown> {\n    // If filter already has array element match, use it as-is\n    const arrayElementFilter = `${arrayField}.${identifierField}`;\n    if (arrayElementFilter in originalFilter) {\n      return originalFilter;\n    }\n\n    // Otherwise, add array existence check to avoid full collection scan\n    return {\n      ...originalFilter,\n      [arrayField]: { $exists: true, $ne: [] }, // Array exists and not empty\n    };\n  }\n\n  /**\n   * Transforms update operation to use arrayFilters placeholder.\n   *\n   * @param update - Original update operation\n   * @param arrayField - Array field path\n   * @returns Transformed update operation\n   */\n  private transformUpdateForArrayFilters(\n    update: Record<string, unknown>,\n    arrayField: string,\n  ): Record<string, unknown> {\n    const transformed: Record<string, unknown> = {};\n\n    for (const [operator, fields] of Object.entries(update)) {\n      if (typeof fields === \"object\" && fields !== null) {\n        const transformedFields: Record<string, unknown> = {};\n\n        for (const [field, value] of Object.entries(fields)) {\n          // Replace positional $ with arrayFilters placeholder $[elem]\n          const transformedField = field.replace(`${arrayField}.$`, `${arrayField}.$[elem]`);\n          transformedFields[transformedField] = value;\n        }\n\n        transformed[operator] = transformedFields;\n      }\n    }\n\n    return transformed;\n  }\n}\n"],"mappings":";;;;;;AAcA,IAAa,mBAAb,MAA6D;CAC3D,AAAiB;;;;;;CAOjB,AAAO,YAAY,QAAuB;EACxC,KAAK,SAAS;CAChB;;;;;;;CAQA,MAAa,aAAa,cAAkD;EAC1E,IAAI,gBAAgB;EAEpB,KAAK,MAAM,eAAe,cAAc;GACtC,MAAM,WAAW,YAAY,gBACzB,MAAM,KAAK,mBAAmB,WAAW,IACzC,MAAM,KAAK,WAAW,WAAW;GAErC,iBAAiB;EACnB;EAEA,OAAO;CACT;;;;;;;;CASA,MAAa,WAAW,aAA+C;EAOrE,QAAO,MANc,KAAK,OAAO,WAC/B,YAAY,aACZ,YAAY,QACZ,YAAY,MACd,GAEc;CAChB;;;;;;;;CASA,MAAa,mBAAmB,aAA+C;EAC7E,IAAI,CAAC,YAAY,cAAc,CAAC,YAAY,iBAC1C,MAAM,IAAI,MAAM,sEAAsE;EAKxF,IAAI,KAAK,yBAAyB,WAAW,GAM3C,QAAO,MALc,KAAK,OAAO,WAC/B,YAAY,aACZ,YAAY,QACZ,YAAY,MACd,GACc;EAKhB,OAAO,MAAM,KAAK,wBAAwB,WAAW;CACvD;;;;;;;;CASA,AAAQ,yBAAyB,aAAuC;EAGtE,OAAO,GADuB,YAAY,WAAW,GAAG,YAAY,qBACvC,YAAY;CAC3C;;;;;;;;CASA,MAAc,wBAAwB,aAA+C;EAEnF,MAAM,eAAe,CACnB,GACG,QAAQ,YAAY,oBAAoB,YAAY,gBACvD,CACF;EAGA,MAAM,oBAAoB,KAAK,+BAC7B,YAAY,QACZ,YAAY,UACd;EAGA,MAAM,kBAAkB,KAAK,qBAC3B,YAAY,QACZ,YAAY,YACZ,YAAY,eACd;EAUA,QAAO,MAPc,KAAK,OAAO,WAC/B,YAAY,aACZ,iBACA,mBACA,EAAE,aAAa,CACjB,GAEc;CAChB;;;;;;;;;;CAWA,AAAQ,qBACN,gBACA,YACA,iBACyB;EAGzB,IAAI,GAD0B,WAAW,GAAG,qBAClB,gBACxB,OAAO;EAIT,OAAO;GACL,GAAG;IACF,aAAa;IAAE,SAAS;IAAM,KAAK,CAAC;GAAE;EACzC;CACF;;;;;;;;CASA,AAAQ,+BACN,QACA,YACyB;EACzB,MAAM,cAAuC,CAAC;EAE9C,KAAK,MAAM,CAAC,UAAU,WAAW,OAAO,QAAQ,MAAM,GACpD,IAAI,OAAO,WAAW,YAAY,WAAW,MAAM;GACjD,MAAM,oBAA6C,CAAC;GAEpD,KAAK,MAAM,CAAC,OAAO,UAAU,OAAO,QAAQ,MAAM,GAAG;IAEnD,MAAM,mBAAmB,MAAM,QAAQ,GAAG,WAAW,KAAK,GAAG,WAAW,SAAS;IACjF,kBAAkB,oBAAoB;GACxC;GAEA,YAAY,YAAY;EAC1B;EAGF,OAAO;CACT;AACF"}

package/esm/drivers/mongodb/types.d.mts

@@ -0,0 +1,43 @@
+import { TransactionOptions } from "mongodb";
+
+//#region ../../@warlock.js/cascade/src/drivers/mongodb/types.d.ts
+/**
+ * MongoDB pipeline stage names.
+ */
+type PipelineStage = "$match" | "$project" | "$sort" | "$group" | "$lookup" | "$limit" | "$skip" | "$unwind" | "$addFields" | "$setWindowFields" | "$vectorSearch";
+/**
+ * Represents a single operation in the query builder chain.
+ */
+type Operation = {
+  /** The MongoDB aggregation stage this operation belongs to */stage: PipelineStage; /** Whether this operation can be merged with other operations of the same stage */
+  mergeable: boolean; /** The operation type (for processing logic) */
+  type: string; /** The operation data */
+  data: any;
+};
+/**
+ * MongoDB driver-specific options.
+ *
+ * These are cascade-next specific configurations for the MongoDB driver,
+ * not native MongoDB client options.
+ */
+type MongoDriverOptions = {
+  /**
+   * Enable auto-generation of numeric IDs.
+   * When enabled, creates a counter collection for managing sequential IDs.
+   * @default false
+   */
+  autoGenerateId?: boolean;
+  /**
+   * Counter collection name for auto-generated IDs.
+   * @default "counters"
+   */
+  counterCollection?: string;
+  /**
+   * Transaction options for this driver.
+   * Applied to all transactions unless overridden.
+   */
+  transactionOptions?: TransactionOptions;
+};
+//#endregion
+export { MongoDriverOptions, Operation, PipelineStage };
+//# sourceMappingURL=types.d.mts.map

package/esm/drivers/mongodb/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/drivers/mongodb/types.ts"],"mappings":";;;;;AAKA;KAAY,aAAA;;;AAAa;KAiBb,SAAA;EAAS,8DAEnB,KAAA,EAAO,aAAa,EAAA;EAEpB,SAAA,WAFO;EAIP,IAAA;EAEA,IAAA;AAAA;AAAI;AASN;;;;;AATM,KASM,kBAAA;EAkBV;;;AAAuC;;EAZvC,cAAA;;;;;EAMA,iBAAA;;;;;EAMA,kBAAA,GAAqB,kBAAkB;AAAA"}

package/esm/drivers/postgres/index.d.mts

@@ -0,0 +1,8 @@
+import { PostgresDialect } from "./postgres-dialect.mjs";
+import { PostgresConnectionConfig, PostgresCopyOptions, PostgresIsolationLevel, PostgresNotification, PostgresOperation, PostgresPoolConfig, PostgresQueryResult, PostgresTransactionOptions, PostgresWhereClause } from "./types.mjs";
+import { PostgresDriver } from "./postgres-driver.mjs";
+import { PostgresBlueprint } from "./postgres-blueprint.mjs";
+import { PostgresMigrationDriver } from "./postgres-migration-driver.mjs";
+import { PostgresQueryBuilder } from "./postgres-query-builder.mjs";
+import { PostgresOperationType, PostgresParserOperation, PostgresParserOptions, PostgresQueryParser } from "./postgres-query-parser.mjs";
+import { PostgresSyncAdapter } from "./postgres-sync-adapter.mjs";

package/esm/drivers/postgres/index.mjs

@@ -0,0 +1,9 @@
+import { PostgresBlueprint } from "./postgres-blueprint.mjs";
+import { PostgresDialect } from "./postgres-dialect.mjs";
+import { PostgresMigrationDriver } from "./postgres-migration-driver.mjs";
+import { PostgresQueryParser } from "./postgres-query-parser.mjs";
+import { PostgresQueryBuilder } from "./postgres-query-builder.mjs";
+import { PostgresSyncAdapter } from "./postgres-sync-adapter.mjs";
+import { PostgresDriver } from "./postgres-driver.mjs";
+
+export {  };

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

@@ -0,0 +1,60 @@
+import { DriverBlueprintContract, TableIndexInformation } from "../../contracts/driver-blueprint.contract.mjs";
+import { PostgresDriver } from "./postgres-driver.mjs";
+
+//#region ../../@warlock.js/cascade/src/drivers/postgres/postgres-blueprint.d.ts
+/**
+ * PostgreSQL Blueprint.
+ *
+ * Provides methods for introspecting the database schema
+ * via PostgreSQL's information_schema and pg_catalog.
+ *
+ * @example
+ * ```typescript
+ * const blueprint = driver.blueprint;
+ *
+ * // Get all tables
+ * const tables = await blueprint.listTables();
+ *
+ * // Get columns for a table
+ * const columns = await blueprint.listColumns('users');
+ * ```
+ */
+declare class PostgresBlueprint implements DriverBlueprintContract {
+  private readonly driver;
+  /**
+   * Create a new blueprint.
+   *
+   * @param driver - The PostgreSQL driver instance
+   */
+  constructor(driver: PostgresDriver);
+  /**
+   * Get all table names in the database.
+   *
+   * @returns Array of table names
+   */
+  listTables(): Promise<string[]>;
+  /**
+   * Get all indexes for a table.
+   *
+   * @param table - Table name
+   * @returns Array of index information
+   */
+  listIndexes(table: string): Promise<TableIndexInformation[]>;
+  /**
+   * Get all column names for a table.
+   *
+   * @param table - Table name
+   * @returns Array of column names
+   */
+  listColumns(table: string): Promise<string[]>;
+  /**
+   * Check if a table exists.
+   *
+   * @param table - Table name
+   * @returns Whether the table exists
+   */
+  tableExists(table: string): Promise<boolean>;
+}
+//#endregion
+export { PostgresBlueprint };
+//# sourceMappingURL=postgres-blueprint.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-blueprint.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/drivers/postgres/postgres-blueprint.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;cAgCa,iBAAA,YAA6B,uBAAA;EAAA,iBAMJ,MAAA;EA6EK;;;;;cA7EL,MAAA,EAAQ,cAAA;;;;;;EAO/B,UAAA,CAAA,GAAc,OAAA;;;;;;;EAkBd,WAAA,CAAY,KAAA,WAAgB,OAAA,CAAQ,qBAAA;;;;;;;EAoDpC,WAAA,CAAY,KAAA,WAAgB,OAAA;;;;;;;EAmB5B,WAAA,CAAY,KAAA,WAAgB,OAAA;AAAA"}

package/esm/drivers/postgres/postgres-blueprint.mjs

@@ -0,0 +1,105 @@
+//#region ../../@warlock.js/cascade/src/drivers/postgres/postgres-blueprint.ts
+/**
+* PostgreSQL Blueprint.
+*
+* Provides methods for introspecting the database schema
+* via PostgreSQL's information_schema and pg_catalog.
+*
+* @example
+* ```typescript
+* const blueprint = driver.blueprint;
+*
+* // Get all tables
+* const tables = await blueprint.listTables();
+*
+* // Get columns for a table
+* const columns = await blueprint.listColumns('users');
+* ```
+*/
+var PostgresBlueprint = class {
+	driver;
+	/**
+	* Create a new blueprint.
+	*
+	* @param driver - The PostgreSQL driver instance
+	*/
+	constructor(driver) {
+		this.driver = driver;
+	}
+	/**
+	* Get all table names in the database.
+	*
+	* @returns Array of table names
+	*/
+	async listTables() {
+		return (await this.driver.query(`SELECT table_name 
+       FROM information_schema.tables 
+       WHERE table_schema = 'public' 
+       AND table_type = 'BASE TABLE'
+       ORDER BY table_name`)).rows.map((row) => row.table_name);
+	}
+	/**
+	* Get all indexes for a table.
+	*
+	* @param table - Table name
+	* @returns Array of index information
+	*/
+	async listIndexes(table) {
+		return (await this.driver.query(`SELECT indexname, indexdef
+       FROM pg_indexes
+       WHERE schemaname = 'public'
+       AND tablename = $1`, [table])).rows.map((row) => {
+			const isUnique = row.indexdef.includes("UNIQUE");
+			const isPrimary = row.indexname.endsWith("_pkey");
+			const columnsMatch = row.indexdef.match(/\(([^)]+)\)/);
+			const columns = columnsMatch ? columnsMatch[1].split(",").map((c) => c.trim().replace(/"/g, "")) : [];
+			let type = "btree";
+			if (row.indexdef.includes("USING GIN")) type = "gin";
+			else if (row.indexdef.includes("USING GIST")) type = "gist";
+			else if (row.indexdef.includes("USING HASH")) type = "hash";
+			else if (row.indexdef.includes("USING ivfflat")) type = "ivfflat";
+			const isPartial = row.indexdef.includes("WHERE");
+			return {
+				name: row.indexname,
+				columns,
+				type,
+				unique: isUnique || isPrimary,
+				partial: isPartial,
+				options: {
+					primary: isPrimary,
+					definition: row.indexdef
+				}
+			};
+		});
+	}
+	/**
+	* Get all column names for a table.
+	*
+	* @param table - Table name
+	* @returns Array of column names
+	*/
+	async listColumns(table) {
+		return (await this.driver.query(`SELECT column_name
+       FROM information_schema.columns
+       WHERE table_schema = 'public'
+       AND table_name = $1
+       ORDER BY ordinal_position`, [table])).rows.map((row) => row.column_name);
+	}
+	/**
+	* Check if a table exists.
+	*
+	* @param table - Table name
+	* @returns Whether the table exists
+	*/
+	async tableExists(table) {
+		return (await this.driver.query(`SELECT EXISTS (
+        SELECT FROM information_schema.tables 
+        WHERE table_schema = 'public' 
+        AND table_name = $1
+      )`, [table])).rows[0]?.exists ?? false;
+	}
+};
+
+//#endregion
+export { PostgresBlueprint };
+//# sourceMappingURL=postgres-blueprint.mjs.map

package/esm/drivers/postgres/postgres-blueprint.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-blueprint.mjs","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/drivers/postgres/postgres-blueprint.ts"],"sourcesContent":["/**\n * PostgreSQL Blueprint\n *\n * Implements the DriverBlueprintContract for querying PostgreSQL\n * information schema metadata.\n *\n * @module cascade/drivers/postgres\n */\n\nimport type {\n  DriverBlueprintContract,\n  TableIndexInformation,\n} from \"../../contracts/driver-blueprint.contract\";\nimport type { PostgresDriver } from \"./postgres-driver\";\n\n/**\n * PostgreSQL Blueprint.\n *\n * Provides methods for introspecting the database schema\n * via PostgreSQL's information_schema and pg_catalog.\n *\n * @example\n * ```typescript\n * const blueprint = driver.blueprint;\n *\n * // Get all tables\n * const tables = await blueprint.listTables();\n *\n * // Get columns for a table\n * const columns = await blueprint.listColumns('users');\n * ```\n */\nexport class PostgresBlueprint implements DriverBlueprintContract {\n  /**\n   * Create a new blueprint.\n   *\n   * @param driver - The PostgreSQL driver instance\n   */\n  public constructor(private readonly driver: PostgresDriver) {}\n\n  /**\n   * Get all table names in the database.\n   *\n   * @returns Array of table names\n   */\n  public async listTables(): Promise<string[]> {\n    const result = await this.driver.query<{ table_name: string }>(\n      `SELECT table_name \n       FROM information_schema.tables \n       WHERE table_schema = 'public' \n       AND table_type = 'BASE TABLE'\n       ORDER BY table_name`,\n    );\n\n    return result.rows.map((row) => row.table_name);\n  }\n\n  /**\n   * Get all indexes for a table.\n   *\n   * @param table - Table name\n   * @returns Array of index information\n   */\n  public async listIndexes(table: string): Promise<TableIndexInformation[]> {\n    const result = await this.driver.query<{\n      indexname: string;\n      indexdef: string;\n    }>(\n      `SELECT indexname, indexdef\n       FROM pg_indexes\n       WHERE schemaname = 'public'\n       AND tablename = $1`,\n      [table],\n    );\n\n    return result.rows.map((row) => {\n      const isUnique = row.indexdef.includes(\"UNIQUE\");\n      const isPrimary = row.indexname.endsWith(\"_pkey\");\n\n      // Extract columns from indexdef\n      const columnsMatch = row.indexdef.match(/\\(([^)]+)\\)/);\n      const columns = columnsMatch\n        ? columnsMatch[1].split(\",\").map((c) => c.trim().replace(/\"/g, \"\"))\n        : [];\n\n      // Determine index type\n      let type = \"btree\"; // default\n      if (row.indexdef.includes(\"USING GIN\")) type = \"gin\";\n      else if (row.indexdef.includes(\"USING GIST\")) type = \"gist\";\n      else if (row.indexdef.includes(\"USING HASH\")) type = \"hash\";\n      else if (row.indexdef.includes(\"USING ivfflat\")) type = \"ivfflat\";\n\n      // Check for partial index\n      const isPartial = row.indexdef.includes(\"WHERE\");\n\n      return {\n        name: row.indexname,\n        columns,\n        type,\n        unique: isUnique || isPrimary,\n        partial: isPartial,\n        options: {\n          primary: isPrimary,\n          definition: row.indexdef,\n        },\n      };\n    });\n  }\n\n  /**\n   * Get all column names for a table.\n   *\n   * @param table - Table name\n   * @returns Array of column names\n   */\n  public async listColumns(table: string): Promise<string[]> {\n    const result = await this.driver.query<{ column_name: string }>(\n      `SELECT column_name\n       FROM information_schema.columns\n       WHERE table_schema = 'public'\n       AND table_name = $1\n       ORDER BY ordinal_position`,\n      [table],\n    );\n\n    return result.rows.map((row) => row.column_name);\n  }\n\n  /**\n   * Check if a table exists.\n   *\n   * @param table - Table name\n   * @returns Whether the table exists\n   */\n  public async tableExists(table: string): Promise<boolean> {\n    const result = await this.driver.query<{ exists: boolean }>(\n      `SELECT EXISTS (\n        SELECT FROM information_schema.tables \n        WHERE table_schema = 'public' \n        AND table_name = $1\n      )`,\n      [table],\n    );\n\n    return result.rows[0]?.exists ?? false;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAgCA,IAAa,oBAAb,MAAkE;CAM5B;;;;;;CAApC,AAAO,YAAY,AAAiB,QAAwB;EAAxB;CAAyB;;;;;;CAO7D,MAAa,aAAgC;EAS3C,QAAO,MARc,KAAK,OAAO,MAC/B;;;;2BAKF,GAEc,KAAK,KAAK,QAAQ,IAAI,UAAU;CAChD;;;;;;;CAQA,MAAa,YAAY,OAAiD;EAYxE,QAAO,MAXc,KAAK,OAAO,MAI/B;;;4BAIA,CAAC,KAAK,CACR,GAEc,KAAK,KAAK,QAAQ;GAC9B,MAAM,WAAW,IAAI,SAAS,SAAS,QAAQ;GAC/C,MAAM,YAAY,IAAI,UAAU,SAAS,OAAO;GAGhD,MAAM,eAAe,IAAI,SAAS,MAAM,aAAa;GACrD,MAAM,UAAU,eACZ,aAAa,GAAG,MAAM,GAAG,EAAE,KAAK,MAAM,EAAE,KAAK,EAAE,QAAQ,MAAM,EAAE,CAAC,IAChE,CAAC;GAGL,IAAI,OAAO;GACX,IAAI,IAAI,SAAS,SAAS,WAAW,GAAG,OAAO;QAC1C,IAAI,IAAI,SAAS,SAAS,YAAY,GAAG,OAAO;QAChD,IAAI,IAAI,SAAS,SAAS,YAAY,GAAG,OAAO;QAChD,IAAI,IAAI,SAAS,SAAS,eAAe,GAAG,OAAO;GAGxD,MAAM,YAAY,IAAI,SAAS,SAAS,OAAO;GAE/C,OAAO;IACL,MAAM,IAAI;IACV;IACA;IACA,QAAQ,YAAY;IACpB,SAAS;IACT,SAAS;KACP,SAAS;KACT,YAAY,IAAI;IAClB;GACF;EACF,CAAC;CACH;;;;;;;CAQA,MAAa,YAAY,OAAkC;EAUzD,QAAO,MATc,KAAK,OAAO,MAC/B;;;;mCAKA,CAAC,KAAK,CACR,GAEc,KAAK,KAAK,QAAQ,IAAI,WAAW;CACjD;;;;;;;CAQA,MAAa,YAAY,OAAiC;EAUxD,QAAO,MATc,KAAK,OAAO,MAC/B;;;;UAKA,CAAC,KAAK,CACR,GAEc,KAAK,IAAI,UAAU;CACnC;AACF"}