@warlock.js/cascade 4.0.174 → 4.1.1

package/esm/drivers/postgres/postgres-query-builder.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-query-builder.mjs","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/drivers/postgres/postgres-query-builder.ts"],"sourcesContent":["/**\n * PostgreSQL Query Builder\n *\n * Extends the pure QueryBuilder base with PostgreSQL-specific execution,\n * SQL generation, relation hydration, and scope management.\n *\n * @module cascade/drivers/postgres\n */\n\nimport type { GenericObject } from \"@mongez/reinforcements\";\nimport type {\n  ChunkCallback,\n  CursorPaginationOptions,\n  CursorPaginationResult,\n  DriverQuery,\n  GroupByInput,\n  PaginationOptions,\n  PaginationResult,\n  QueryBuilderContract,\n  RawExpression,\n} from \"../../contracts/query-builder.contract\";\nimport type { DataSource } from \"../../data-source/data-source\";\nimport { dataSourceRegistry } from \"../../data-source/data-source-registry\";\nimport { isAggregateExpression } from \"../../expressions\";\nimport type { GlobalScopeDefinition } from \"../../model/model\";\nimport { resolveModelClass, tryResolveModelClass, type ModelRef } from \"../../model/register-model\";\nimport { QueryBuilder, type Op } from \"../../query-builder/query-builder\";\nimport {\n  inferBelongsToForeignKey,\n  inferHasForeignKey,\n  inferPivotKey,\n  inferPivotTable,\n} from \"../../relations/key-conventions\";\nimport { attachLoadedRelation, RelationLoader } from \"../../relations/relation-loader\";\nimport type { PostgresDriver } from \"./postgres-driver\";\nimport { PostgresQueryParser, type PostgresParserOperation } from \"./postgres-query-parser\";\n\n// ============================================================================\n// HELPER\n// ============================================================================\n\n/**\n * Cast an Op[] to PostgresParserOperation[] — the shapes are compatible since\n * both have `type: string` and `data: Record<string, unknown>`.\n */\nfunction toParserOps(ops: Op[]): PostgresParserOperation[] {\n  return ops as unknown as PostgresParserOperation[];\n}\n\n// ============================================================================\n// JOIN RELATIONS MAP TYPE\n// ============================================================================\n\ntype JoinRelationConfig = {\n  alias: string;\n  type: \"belongsTo\" | \"hasOne\" | \"hasMany\";\n  model?: ModelRef;\n  localKey?: string;\n  foreignKey?: string;\n  ownerKey?: string;\n  parentPath?: string | null;\n  relationName?: string;\n  parentModel?: ModelRef;\n  select?: string[];\n  /** Operations recorded by a joinWith constraint callback. */\n  constraintOps?: Op[];\n};\n\n// ============================================================================\n// POSTGRES QUERY BUILDER\n// ============================================================================\n\n/**\n * PostgreSQL Query Builder.\n *\n * Collects query operations (via the base class) and delegates SQL generation\n * to `PostgresQueryParser`. Owns execution, hydration, and relation loading.\n *\n * @example\n * ```typescript\n * const users = await User.query()\n *   .select([\"id\", \"name\", \"email\"])\n *   .where(\"status\", \"active\")\n *   .orderBy(\"createdAt\", \"desc\")\n *   .limit(10)\n *   .get();\n * ```\n */\nexport class PostgresQueryBuilder<T = unknown>\n  extends QueryBuilder<T>\n  implements QueryBuilderContract<T>\n{\n  // ──────────────────────────────────────────────────────────────\n  // POSTGRES-SPECIFIC STATE\n  // ──────────────────────────────────────────────────────────────\n\n  /** Data source backing this builder. */\n  public readonly dataSource: DataSource;\n\n  /** Hydration callback for transforming result rows into model instances. */\n  public hydrateCallback?: (data: unknown, index: number) => unknown;\n\n  /** Invoked before query execution. */\n  private fetchingCallback?: (query: this) => void | Promise<void>;\n\n  /** Invoked after fetch but before hydration. */\n  private hydratingCallback?: (records: unknown[], context: unknown) => void | Promise<void>;\n\n  /** Invoked after fetch and hydration. */\n  private fetchedCallback?: (records: unknown[], context: unknown) => void | Promise<void>;\n\n  /**\n   * Map of relations registered via `joinWith()`.\n   * Keyed by dot-notation path (e.g. \"organizationAiModel.aiModel\").\n   */\n  public joinRelations = new Map<string, JoinRelationConfig>();\n\n  /**\n   * Idempotency guard for `applyJoinRelations()` so calling `parse()` then\n   * `get()` (or `parse()` twice) doesn't double-emit `selectRelatedColumns`\n   * operations.\n   */\n  private joinRelationsApplied = false;\n\n  /**\n   * Idempotency guard for `applyCountRelations()` — see `joinRelationsApplied`.\n   */\n  private countRelationsApplied = false;\n\n  /**\n   * Idempotency guard for `applyHasRelations()` — see `joinRelationsApplied`.\n   */\n  private hasRelationsApplied = false;\n\n  /**\n   * Alias → SQL expression for two-arg `groupBy` aggregates. Recorded by the\n   * `groupBy` override; consumed by `applyGroupByAggregates` to rewrite a\n   * `having()` on the alias into the underlying expression (Postgres forbids\n   * SELECT aliases in HAVING).\n   */\n  private aggregateAliases = new Map<string, string>();\n\n  /**\n   * Idempotency guard for `applyGroupByAggregates()` — see `joinRelationsApplied`.\n   */\n  private groupByAggregatesApplied = false;\n\n  // ──────────────────────────────────────────────────────────────\n  // CONSTRUCTOR\n  // ──────────────────────────────────────────────────────────────\n\n  /**\n   * @param table - Target table name\n   * @param dataSource - Optional (uses default data source from registry if omitted)\n   */\n  public constructor(\n    public readonly table: string,\n    dataSource?: DataSource,\n  ) {\n    super();\n    this.dataSource = dataSource ?? dataSourceRegistry.get()!;\n  }\n\n  // ──────────────────────────────────────────────────────────────\n  // DRIVER\n  // ──────────────────────────────────────────────────────────────\n\n  private get driver(): PostgresDriver {\n    return this.dataSource.driver as PostgresDriver;\n  }\n\n  // ──────────────────────────────────────────────────────────────\n  // CLONE\n  // ──────────────────────────────────────────────────────────────\n\n  public clone(): this {\n    const cloned = new PostgresQueryBuilder<T>(this.table, this.dataSource) as this;\n\n    // Copy base-class state\n    cloned.operations = [...this.operations];\n    cloned.pendingGlobalScopes = this.pendingGlobalScopes;\n    cloned.availableLocalScopes = this.availableLocalScopes;\n    cloned.disabledGlobalScopes = new Set(this.disabledGlobalScopes);\n    cloned.scopesApplied = this.scopesApplied;\n    cloned.eagerLoadRelations = new Map(this.eagerLoadRelations);\n    cloned.countRelations = new Map(this.countRelations);\n    cloned.relationDefinitions = this.relationDefinitions;\n    cloned.modelClass = this.modelClass;\n\n    // Copy PG-specific state\n    cloned.hydrateCallback = this.hydrateCallback;\n    cloned.joinRelations = new Map(this.joinRelations);\n    cloned.joinRelationsApplied = this.joinRelationsApplied;\n    cloned.countRelationsApplied = this.countRelationsApplied;\n    cloned.hasRelationsApplied = this.hasRelationsApplied;\n    cloned.aggregateAliases = new Map(this.aggregateAliases);\n    cloned.groupByAggregatesApplied = this.groupByAggregatesApplied;\n\n    return cloned;\n  }\n\n  // ============================================================================\n  // PG-SPECIFIC FLUENT METHODS\n  // ============================================================================\n\n  /**\n   * Native-query escape hatch. Passes `operations[]` to the callback for\n   * direct manipulation. Use sparingly — only when fluent API is insufficient.\n   *\n   * @example\n   * q.raw(ops => ops.push({ type: \"whereRaw\", data: { expression: \"1=1\" } }))\n   */\n  public raw(callback: (operations: Op[]) => void): this {\n    callback(this.operations);\n    return this;\n  }\n\n  /**\n   * Record a DISTINCT flag AND auto-select the field(s).\n   * In PostgreSQL, DISTINCT ON (col) requires the col to appear in SELECT.\n   *\n   * @example\n   * q.distinctValues(\"category\")               // SELECT category … DISTINCT ON (category)\n   * q.distinctValues([\"category\", \"status\"])   // both fields in DISTINCT ON and SELECT\n   */\n  public override distinctValues(fields?: string | string[]): this {\n    // Record the base DISTINCT flag op\n    super.distinctValues(fields);\n    // Also add a select for the field(s) so they appear in the SELECT clause\n    if (fields) {\n      const fieldArr = Array.isArray(fields) ? fields : [fields];\n      this.addOperation(\"select\", { fields: fieldArr });\n    }\n    return this;\n  }\n\n  /**\n   * GROUP BY with computed aggregates.\n   *\n   * Single-arg form defers to the base builder. With `aggregates`, each entry\n   * is translated to SQL — via the dialect for `$agg.*` helpers, verbatim for\n   * a raw SQL string — and pushed through the proven `selectRaw` projection\n   * (the same plumbing `similarTo` / `applyCountRelations` rely on). The\n   * grouped columns are projected explicitly because `SELECT *` is invalid\n   * alongside `GROUP BY`. The alias → expression map is recorded so\n   * `applyGroupByAggregates` can later rewrite `having()` on the alias.\n   *\n   * `$agg.distinct/floor/first/last` throw (MongoDB-only on Postgres v1);\n   * MongoDB operator objects throw (not portable to SQL).\n   *\n   * @example\n   * Order.query().groupBy(\"category\", {\n   *   orders: $agg.count(),\n   *   revenue: $agg.sum(\"amount\"),\n   * }).having(\"revenue\", \">\", 1000);\n   */\n  public groupBy(fields: GroupByInput): this;\n  public groupBy(fields: GroupByInput, aggregates: Record<string, RawExpression>): this;\n  public groupBy(fields: GroupByInput, aggregates?: Record<string, RawExpression>): this {\n    if (!aggregates) {\n      return super.groupBy(fields);\n    }\n\n    const fieldList = Array.isArray(fields) ? fields : [fields];\n\n    this.addOperation(\"select\", { fields: fieldList });\n\n    for (const [alias, expression] of Object.entries(aggregates)) {\n      let sql: string;\n\n      if (isAggregateExpression(expression)) {\n        sql = this.driver.dialect.aggregateToSql(expression);\n      } else if (typeof expression === \"string\") {\n        sql = expression;\n      } else {\n        throw new Error(\n          `groupBy aggregate \"${alias}\" must be a $agg.* helper or a raw SQL ` +\n            `string on Postgres; got ${typeof expression}. MongoDB operator ` +\n            `objects are not portable to SQL — use selectRaw with explicit SQL.`,\n        );\n      }\n\n      this.aggregateAliases.set(alias, sql);\n\n      this.addOperation(\"selectRaw\", {\n        expression: `${sql} AS ${this.driver.dialect.quoteIdentifier(alias)}`,\n        bindings: [],\n      });\n    }\n\n    return super.groupBy(fields);\n  }\n\n  /**\n   * Nearest-neighbour vector similarity search via pgvector cosine distance.\n   *\n   * Adds two operations atomically:\n   * 1. `selectRaw` → `1 - (column <=> $n::vector) AS <alias>`\n   *    Makes the similarity score available on every returned row.\n   * 2. `orderByRaw` → `column <=> $n::vector`\n   *    Tells the PostgreSQL query planner to use the IVFFlat/HNSW vector index.\n   *    Using the alias in ORDER BY would bypass the index — the raw expression is required.\n   *\n   * @example\n   * ```typescript\n   * const results = await Vector.query()\n   *   .where({ organization_id: \"org-123\", content_type: \"summary\" })\n   *   .similarTo(\"embedding\", queryEmbedding)\n   *   .limit(5)\n   *   .get<VectorRow & { score: number }>();\n   * ```\n   */\n  public similarTo(column: string, embedding: number[], alias = \"score\"): this {\n    // pgvector expects the literal format: [n,n,n,...]\n    const literal = `[${embedding.join(\",\")}]`;\n    const quotedCol = this.driver.dialect.quoteIdentifier(column);\n    const quotedTable = this.driver.dialect.quoteIdentifier(this.table);\n\n    // 0 — Preserve all table columns.\n    //     Adding a selectRaw suppresses the parser's \"SELECT *\" fallback,\n    //     so we must explicitly include table.* before the score expression.\n    this.addOperation(\"selectRaw\", {\n      expression: `${quotedTable}.*`,\n      bindings: [],\n    });\n\n    // 1 — Add similarity score to SELECT\n    this.addOperation(\"selectRaw\", {\n      expression: `1 - (${quotedCol} <=> ?::vector) AS ${alias}`,\n      bindings: [literal],\n    });\n\n    // 2 — ORDER BY the raw expression so the vector index is used\n    this.addOperation(\"orderByRaw\", {\n      expression: `${quotedCol} <=> ?::vector`,\n      bindings: [literal],\n    });\n\n    return this;\n  }\n\n  /** Set a hydration callback that transforms each result row. */\n  public hydrate(callback: (data: unknown, index: number) => unknown): this {\n    this.hydrateCallback = callback;\n    return this;\n  }\n\n  /** Register a callback invoked before query execution. */\n  public onFetching(callback: (query: this) => void | Promise<void>): () => void {\n    this.fetchingCallback = callback;\n    return () => {\n      this.fetchingCallback = undefined;\n    };\n  }\n\n  /** Register a callback invoked after fetch but before hydration. */\n  public onHydrating(\n    callback: (records: unknown[], context: unknown) => void | Promise<void>,\n  ): () => void {\n    this.hydratingCallback = callback;\n    return () => {\n      this.hydratingCallback = undefined;\n    };\n  }\n\n  /** Register a callback invoked after fetch and hydration. */\n  public onFetched(\n    callback: (records: unknown[], context: unknown) => void | Promise<void>,\n  ): () => void {\n    this.fetchedCallback = callback;\n    return () => {\n      this.fetchedCallback = undefined;\n    };\n  }\n\n  // ============================================================================\n  // SCOPES\n  // ============================================================================\n\n  /** Apply pending global scopes to the operations list. */\n  private applyPendingScopes(): void {\n    if (!this.pendingGlobalScopes || this.scopesApplied) return;\n\n    const beforeOps: Op[] = [];\n    const afterOps: Op[] = [];\n\n    for (const [name, { callback, timing }] of this.pendingGlobalScopes as Map<\n      string,\n      GlobalScopeDefinition\n    >) {\n      if (this.disabledGlobalScopes.has(name)) continue;\n\n      const temp = new PostgresQueryBuilder(this.table, this.dataSource);\n      callback(temp as unknown as QueryBuilderContract<T>);\n\n      if (timing === \"before\") {\n        beforeOps.push(...temp.operations);\n      } else {\n        afterOps.push(...temp.operations);\n      }\n    }\n\n    this.operations = [...beforeOps, ...this.operations, ...afterOps];\n    this.scopesApplied = true;\n  }\n\n  // ============================================================================\n  // WHERE — POSTGRES-SPECIFIC (driver.dialect required)\n  // ============================================================================\n\n  /** Array field contains a value (or object with key). */\n  public whereArrayContains(field: string, value: unknown, key?: string): this {\n    const quotedField = this.driver.dialect.quoteIdentifier(field);\n    if (key) {\n      this.addOperation(\"whereRaw\", {\n        expression: `${quotedField} @> ?::jsonb`,\n        bindings: [JSON.stringify([{ [key]: value }])],\n      });\n    } else {\n      this.addOperation(\"whereRaw\", {\n        expression: `? = ANY(${quotedField})`,\n        bindings: [value],\n      });\n    }\n    return this;\n  }\n\n  /** Array field does NOT contain a value (or object with key). */\n  public whereArrayNotContains(field: string, value: unknown, key?: string): this {\n    const quotedField = this.driver.dialect.quoteIdentifier(field);\n    if (key) {\n      this.addOperation(\"whereRaw\", {\n        expression: `NOT (${quotedField} @> ?::jsonb)`,\n        bindings: [JSON.stringify([{ [key]: value }])],\n      });\n    } else {\n      this.addOperation(\"whereRaw\", {\n        expression: `NOT (? = ANY(${quotedField}))`,\n        bindings: [value],\n      });\n    }\n    return this;\n  }\n\n  /** Array field contains value OR is empty. */\n  public whereArrayHasOrEmpty(field: string, value: unknown, key?: string): this {\n    const quotedField = this.driver.dialect.quoteIdentifier(field);\n    if (key) {\n      this.addOperation(\"whereRaw\", {\n        expression: `(${quotedField} @> ?::jsonb OR ${quotedField} = '[]'::jsonb OR ${quotedField} IS NULL)`,\n        bindings: [JSON.stringify([{ [key]: value }])],\n      });\n    } else {\n      this.addOperation(\"whereRaw\", {\n        expression: `(? = ANY(${quotedField}) OR array_length(${quotedField}, 1) IS NULL)`,\n        bindings: [value],\n      });\n    }\n    return this;\n  }\n\n  /** Array field does NOT contain value OR is empty. */\n  public whereArrayNotHaveOrEmpty(field: string, value: unknown, key?: string): this {\n    const quotedField = this.driver.dialect.quoteIdentifier(field);\n    if (key) {\n      this.addOperation(\"whereRaw\", {\n        expression: `(NOT (${quotedField} @> ?::jsonb) OR ${quotedField} = '[]'::jsonb OR ${quotedField} IS NULL)`,\n        bindings: [JSON.stringify([{ [key]: value }])],\n      });\n    } else {\n      this.addOperation(\"whereRaw\", {\n        expression: `(NOT (? = ANY(${quotedField})) OR array_length(${quotedField}, 1) IS NULL)`,\n        bindings: [value],\n      });\n    }\n    return this;\n  }\n\n  // ============================================================================\n  // joinWith — RESOLVE RELATION DEFINITIONS\n  // ============================================================================\n\n  /**\n   * Load relations via SQL JOINs (single query) with optional per-relation constraints.\n   *\n   * Supports:\n   * - `joinWith(\"author\")` / `joinWith([\"author\", \"category\"])`\n   * - `joinWith({ actions: q => q.where(\"status\", \"pending\").limit(5) })`\n   * - `joinWith({ organizationAiModel: \"id,name\", actions: q => q.orderBy(\"sort_order\") })`\n   *\n   * @example\n   * ChatMessage.joinWith({\n   *   actions: q => q.where(\"status\", \"pending\").orderBy(\"sort_order\", \"asc\").limit(5),\n   *   organizationAiModel: \"id,createdAt\",\n   * })\n   */\n  public override joinWith(...args: unknown[]): this {\n    // Normalise all args into an array of { path, constraint } pairs\n    type Entry = { path: string; constraint?: string | ((q: QueryBuilder) => void) };\n    const entries: Entry[] = [];\n\n    for (const arg of args) {\n      if (typeof arg === \"string\") {\n        entries.push({ path: arg });\n      } else if (Array.isArray(arg)) {\n        for (const rel of arg) {\n          entries.push({ path: rel });\n        }\n      } else if (typeof arg === \"object\" && arg !== null) {\n        for (const [rel, val] of Object.entries(arg)) {\n          entries.push({ path: rel, constraint: val });\n        }\n      }\n    }\n\n    for (const { path, constraint } of entries) {\n      // Parse each dot-notation path segment (supports \"rel1.rel2\" nesting)\n      const segments = path.split(\".\");\n      let currentModel: unknown = this.modelClass;\n      let currentPath = \"\";\n\n      for (let i = 0; i < segments.length; i++) {\n        const rawSeg = segments[i];\n        // String shorthand: \"relName:col1,col2\"\n        const colonIdx = rawSeg.indexOf(\":\");\n        const segName = colonIdx === -1 ? rawSeg : rawSeg.slice(0, colonIdx);\n        const segColumns =\n          colonIdx === -1\n            ? undefined\n            : rawSeg\n                .slice(colonIdx + 1)\n                .split(\",\")\n                .filter(Boolean);\n\n        currentPath = currentPath ? `${currentPath}.${segName}` : segName;\n\n        // If already registered, update if new select columns given; advance model\n        if (this.joinRelations.has(currentPath)) {\n          const existing = this.joinRelations.get(currentPath)!;\n          if (segColumns) existing.select = segColumns;\n\n          // Apply constraint only on the deepest segment\n          if (i === segments.length - 1 && constraint !== undefined) {\n            existing.constraintOps = this._resolveConstraintOps(constraint);\n          }\n\n          currentModel = tryResolveModelClass(existing.model);\n          continue;\n        }\n\n        if (!this.relationDefinitions) continue;\n\n        const def = (\n          i === 0\n            ? (this.relationDefinitions as Record<string, unknown>)\n            : (currentModel as { relations?: Record<string, unknown> })?.relations\n        )?.[segName] as Record<string, unknown> | undefined;\n\n        if (!def) {\n          throw new Error(\n            `Relation \"${segName}\" not found on model ${(currentModel as { name?: string })?.name ?? \"unknown\"}`,\n          );\n        }\n\n        // Resolve select columns: colon shorthand > constraint string > def.select\n        let selectColumns: string[] | undefined =\n          segColumns ?? (def.select as string[] | undefined);\n\n        let constraintOps: Op[] | undefined;\n        if (i === segments.length - 1 && constraint !== undefined) {\n          if (typeof constraint === \"string\") {\n            selectColumns = constraint.split(\",\").filter(Boolean);\n          } else {\n            constraintOps = this._resolveConstraintOps(constraint);\n          }\n        }\n\n        const alias = currentPath.replace(/\\./g, \"_\");\n\n        this.joinRelations.set(currentPath, {\n          alias,\n          type: def.type as JoinRelationConfig[\"type\"],\n          model: def.model as ModelRef | undefined,\n          localKey: def.localKey as string | undefined,\n          foreignKey: def.foreignKey as string | undefined,\n          ownerKey: def.ownerKey as string | undefined,\n          parentPath: i > 0 ? currentPath.substring(0, currentPath.lastIndexOf(\".\")) : null,\n          relationName: segName,\n          parentModel: currentModel as ModelRef | undefined,\n          select: selectColumns,\n          constraintOps,\n        });\n\n        currentModel = tryResolveModelClass(def.model as ModelRef | undefined);\n\n        if (!currentModel) {\n          throw new Error(`Relation model not found for \"${segName}\" in \"${currentPath}\"`);\n        }\n      }\n    }\n\n    return this;\n  }\n\n  /** Run a joinWith constraint callback against a sub-QB and capture its operations. */\n  private _resolveConstraintOps(constraint: string | ((q: QueryBuilder) => void)): Op[] {\n    if (typeof constraint === \"string\") return [];\n    const sub = new PostgresQueryBuilder(\"__sub__\", this.dataSource);\n    constraint(sub);\n    return sub.operations;\n  }\n\n  // ============================================================================\n  // EXECUTION METHODS\n  // ============================================================================\n\n  /**\n   * Execute the query and return all matching rows.\n   */\n  public async get<TResult = T>(): Promise<TResult[]> {\n    this.applyPendingScopes();\n    this._processJoinWithOps();\n    this.applyJoinRelations();\n    this.applyHasRelations();\n    this.applyCountRelations();\n    this.applyGroupByAggregates();\n\n    if (this.fetchingCallback) {\n      await this.fetchingCallback(this);\n    }\n\n    const parser = new PostgresQueryParser({\n      table: this.table,\n      operations: toParserOps(this.operations),\n    });\n\n    const { query = \"\", bindings = [] } = parser.parse();\n\n    try {\n      const result = await this.driver.query<TResult>(query, bindings);\n      let records = result.rows;\n\n      const joinedData = this.extractJoinedRelationData(records);\n\n      if (this.hydratingCallback) {\n        await this.hydratingCallback(records as unknown[], {});\n      }\n\n      if (this.hydrateCallback) {\n        records = records.map((row, index) => this.hydrateCallback!(row, index)) as TResult[];\n      }\n\n      this.attachJoinedRelations(records, joinedData);\n\n      await this.applyEagerLoading(records as unknown[]);\n\n      if (this.fetchedCallback) {\n        await this.fetchedCallback(records as unknown[], {});\n      }\n\n      this.operations = [];\n      return records;\n    } catch (error) {\n      console.log(\"Error while executing:\", query, bindings);\n      console.log(\"Query Builder Error:\", error);\n      throw error;\n    }\n  }\n\n  /** Get first result. */\n  public async first<TResult = T>(): Promise<TResult | null> {\n    const results = await this.limit(1).get<TResult>();\n    return results[0] ?? null;\n  }\n\n  /** Get last result (by id desc). */\n  public async last<TResult = T>(): Promise<TResult | null> {\n    const results = await this.orderByDesc(\"id\").limit(1).get<TResult>();\n    return results[0] ?? null;\n  }\n\n  /** Get random results. */\n  public async random<TResult = T>(limit?: number): Promise<TResult[]> {\n    this.orderByRaw(\"RANDOM()\");\n    if (limit) this.limit(limit);\n    return this.get<TResult>();\n  }\n\n  /** Get first or throw. */\n  public async firstOrFail<TResult = T>(): Promise<TResult> {\n    const result = await this.first<TResult>();\n    if (!result) throw new Error(\"No records found\");\n    return result;\n  }\n\n  /** Get first or call callback. */\n  public async firstOr<TResult = T>(callback: () => TResult | Promise<TResult>): Promise<TResult> {\n    const result = await this.first<TResult>();\n    return result ?? (await callback());\n  }\n\n  /** Get first or return null. */\n  public async firstOrNull<TResult = T>(): Promise<TResult | null> {\n    return this.first<TResult>();\n  }\n\n  /** Get first or return default. */\n  public async firstOrNew<TResult = T>(defaults: GenericObject): Promise<TResult> {\n    const result = await this.first<TResult>();\n    return result ?? (defaults as unknown as TResult);\n  }\n\n  /** Find by primary key. */\n  public async find<TResult = T>(id: number | string): Promise<TResult | null> {\n    return this.where(\"id\", id).first<TResult>();\n  }\n\n  /** Count matching rows. */\n  public async count(): Promise<number> {\n    this.applyPendingScopes();\n    const countOps: PostgresParserOperation[] = toParserOps([\n      ...this.operations.filter((op) => op.type.includes(\"where\") || op.type.includes(\"join\")),\n      { type: \"selectRaw\", data: { expression: 'COUNT(*) AS \"count\"' } },\n    ]);\n\n    const parser = new PostgresQueryParser({ table: this.table, operations: countOps });\n    const { query = \"\", bindings = [] } = parser.parse();\n    const result = await this.driver.query<{ count: string }>(query, bindings);\n    return parseInt(result.rows[0]?.count ?? \"0\", 10);\n  }\n\n  /** SUM a numeric field. */\n  public async sum(field: string): Promise<number> {\n    this.applyPendingScopes();\n    const result = await this.selectRaw(`SUM(${field}) as sum`).first<{ sum: string }>();\n    return parseFloat(result?.sum ?? \"0\");\n  }\n\n  /** AVG of a numeric field. */\n  public async avg(field: string): Promise<number> {\n    this.applyPendingScopes();\n    const result = await this.selectRaw(`AVG(${field}) as avg`).first<{ avg: string }>();\n    return parseFloat(result?.avg ?? \"0\");\n  }\n\n  /** MIN of a numeric field. */\n  public async min(field: string): Promise<number> {\n    this.applyPendingScopes();\n    const result = await this.selectRaw(`MIN(${field}) as min`).first<{ min: string }>();\n    return parseFloat(result?.min ?? \"0\");\n  }\n\n  /** MAX of a numeric field. */\n  public async max(field: string): Promise<number> {\n    this.applyPendingScopes();\n    const result = await this.selectRaw(`MAX(${field}) as max`).first<{ max: string }>();\n    return parseFloat(result?.max ?? \"0\");\n  }\n\n  /** Get distinct values for a field. */\n  public async distinct<TResult = unknown>(field: string): Promise<TResult[]> {\n    this.distinctValues(field);\n    const results = await this.get<{ [key: string]: TResult }>();\n    return results.map((row) => row[field]);\n  }\n\n  /** Get array of all values for a single field. */\n  public async pluck(field: string): Promise<unknown[]> {\n    const results = await this.select([field]).get<Record<string, unknown>>();\n    return results.map((row) => row[field]);\n  }\n\n  /** Get a single scalar value. */\n  public async value<TResult = unknown>(field: string): Promise<TResult | null> {\n    const result = await this.select([field]).first<Record<string, TResult>>();\n    return result?.[field] ?? null;\n  }\n\n  /** Check whether any matching rows exist. */\n  public async exists(): Promise<boolean> {\n    const count = await this.limit(1).count();\n    return count > 0;\n  }\n\n  /** Check whether NO matching rows exist. */\n  public async notExists(): Promise<boolean> {\n    return !(await this.exists());\n  }\n\n  /** COUNT DISTINCT a field. */\n  public async countDistinct(field: string): Promise<number> {\n    const result = await this.selectRaw(`COUNT(DISTINCT ${field}) as count`).first<{\n      count: string;\n    }>();\n    return parseInt(result?.count ?? \"0\", 10);\n  }\n\n  // ─── Aggregation shortcuts via latest/oldest ─────────────────\n\n  /** Get latest records ordered by a column. */\n  public async latest(column = \"createdAt\"): Promise<T[]> {\n    return this.orderBy(column, \"desc\").get();\n  }\n\n  // ─── Increment / Decrement ───────────────────────────────────\n\n  /** Increment a numeric field. Returns new value. */\n  public async increment(field: string, amount = 1): Promise<number> {\n    this.applyPendingScopes();\n    const { sql: filterSql, params: filterParams } = this.buildFilter();\n    const updateSql =\n      `UPDATE ${this.driver.dialect.quoteIdentifier(this.table)} ` +\n      `SET ${this.driver.dialect.quoteIdentifier(field)} = COALESCE(${this.driver.dialect.quoteIdentifier(field)}, 0) + $1 ` +\n      (filterSql ? `WHERE ${filterSql.replace(\"WHERE \", \"\")} ` : \"\") +\n      `RETURNING ${this.driver.dialect.quoteIdentifier(field)}`;\n    const result = await this.driver.query<Record<string, number>>(updateSql, [\n      amount,\n      ...filterParams,\n    ]);\n    return result.rows[0]?.[field] ?? 0;\n  }\n\n  /** Decrement a numeric field. Returns new value. */\n  public async decrement(field: string, amount = 1): Promise<number> {\n    return this.increment(field, -amount);\n  }\n\n  /** Increment a field for all matching rows. Returns affected row count. */\n  public async incrementMany(field: string, amount = 1): Promise<number> {\n    this.applyPendingScopes();\n    const { sql: filterSql, params: filterParams } = this.buildFilter();\n    const updateSql =\n      `UPDATE ${this.driver.dialect.quoteIdentifier(this.table)} ` +\n      `SET ${this.driver.dialect.quoteIdentifier(field)} = COALESCE(${this.driver.dialect.quoteIdentifier(field)}, 0) + $1` +\n      (filterSql ? ` WHERE ${filterSql.replace(\"WHERE \", \"\")}` : \"\");\n    const result = await this.driver.query(updateSql, [amount, ...filterParams]);\n    return result.rowCount ?? 0;\n  }\n\n  /** Decrement a field for all matching rows. Returns affected row count. */\n  public async decrementMany(field: string, amount = 1): Promise<number> {\n    return this.incrementMany(field, -amount);\n  }\n\n  // ─── Chunking / Pagination ───────────────────────────────────\n\n  /**\n   * Process results in memory-efficient chunks.\n   *\n   * @example\n   * await User.query().chunk(100, async (rows, idx) => { ... })\n   */\n  public async chunk(size: number, callback: ChunkCallback<T>): Promise<void> {\n    let chunkIndex = 0;\n    let hasMore = true;\n\n    while (hasMore) {\n      const chunk = await this.clone()\n        .skip(chunkIndex * size)\n        .limit(size)\n        .get();\n      if (chunk.length === 0) break;\n\n      const shouldContinue = await callback(chunk, chunkIndex);\n      if (shouldContinue === false) break;\n\n      hasMore = chunk.length === size;\n      chunkIndex++;\n    }\n  }\n\n  /** Page-based pagination. */\n  public async paginate(options?: PaginationOptions): Promise<PaginationResult<T>> {\n    const page = options?.page ?? 1;\n    const limit = options?.limit ?? 10;\n    const skip = (page - 1) * limit;\n\n    const [data, total] = await Promise.all([\n      this.clone().skip(skip).limit(limit).get(),\n      this.count(),\n    ]);\n\n    return {\n      data,\n      pagination: {\n        total,\n        page,\n        limit,\n        pages: Math.ceil(total / limit),\n      },\n    };\n  }\n\n  /**\n   * Set cursor pagination hints fluently.\n   * The recorded values are picked up by `cursorPaginate()` when no explicit\n   * options are passed.\n   *\n   * @example\n   * User.query().cursor(lastId).cursorPaginate({ limit: 20 })\n   */\n  public cursor(after?: unknown, before?: unknown): this {\n    this.addOperation(\"cursor\", { after, before });\n    return this;\n  }\n\n  /** Cursor-based pagination. */\n  public async cursorPaginate(\n    options?: CursorPaginationOptions,\n  ): Promise<CursorPaginationResult<T>> {\n    // Fall back to fluently-recorded cursor op if options.cursor not provided\n    const cursorOp = this.getOps(\"cursor\")[0];\n    const recordedCursor = cursorOp?.data.after;\n\n    const {\n      limit = 10,\n      cursor = recordedCursor,\n      column = \"id\",\n      direction = \"next\",\n    } = options ?? {};\n\n    if (cursor) {\n      this.where(column, direction === \"next\" ? \">\" : \"<\", cursor);\n    }\n\n    this.orderBy(column, direction === \"next\" ? \"asc\" : \"desc\");\n    const results = await this.limit(limit + 1).get();\n    const hasMore = results.length > limit;\n    let data = hasMore ? results.slice(0, limit) : results;\n    if (direction === \"prev\") data = data.reverse();\n\n    let nextCursor: unknown;\n    let prevCursor: unknown;\n    let hasPrev = false;\n\n    if (data.length > 0) {\n      const firstItem = (data[0] as Record<string, unknown>)[column];\n      const lastItem = (data[data.length - 1] as Record<string, unknown>)[column];\n\n      if (direction === \"next\") {\n        nextCursor = hasMore ? lastItem : undefined;\n        if (cursor) {\n          hasPrev = true;\n          prevCursor = firstItem;\n        }\n      } else {\n        prevCursor = hasMore ? firstItem : undefined;\n        hasPrev = hasMore;\n        if (cursor) nextCursor = lastItem;\n      }\n    }\n\n    return { data, pagination: { hasMore, hasPrev, nextCursor, prevCursor } };\n  }\n\n  // ─── Mutation methods ────────────────────────────────────────\n\n  /** Delete matching rows. Returns deleted count. */\n  public async delete(): Promise<number> {\n    this.applyPendingScopes();\n    const { sql, params } = this.buildFilter();\n    const deleteSql = `DELETE FROM ${this.driver.dialect.quoteIdentifier(this.table)} ${sql}`;\n    const result = await this.driver.query(deleteSql, params);\n    return result.rowCount ?? 0;\n  }\n\n  /** Delete the first matching row. */\n  public async deleteOne(): Promise<number> {\n    return this.limit(1).delete();\n  }\n\n  /** Update matching rows. */\n  public async update(fields: Record<string, unknown>): Promise<number> {\n    this.applyPendingScopes();\n    const result = await this.driver.updateMany(this.table, {}, { $set: fields });\n    return result.modifiedCount;\n  }\n\n  /** Unset fields from matching rows. */\n  public async unset(...fields: string[]): Promise<number> {\n    this.applyPendingScopes();\n    const updateObj: Record<string, 1> = {};\n    for (const field of fields) updateObj[field] = 1;\n    const result = await this.driver.updateMany(this.table, {}, { $unset: updateObj });\n    return result.modifiedCount;\n  }\n\n  // ─── Inspection / Debugging ───────────────────────────────────\n\n  /**\n   * Return the SQL + bindings without executing.\n   *\n   * Runs the same prelude as `get()` (scopes, joinWith expansion, joinRelations,\n   * countRelations) so the preview matches what would actually be sent to the\n   * database. The apply* methods are idempotent — calling `parse()` then `get()`\n   * does not double-emit operations.\n   */\n  public parse(): DriverQuery {\n    this.applyPendingScopes();\n    this._processJoinWithOps();\n    this.applyJoinRelations();\n    this.applyHasRelations();\n    this.applyCountRelations();\n    this.applyGroupByAggregates();\n\n    const parser = new PostgresQueryParser({\n      table: this.table,\n      operations: toParserOps(this.operations),\n    });\n    return parser.parse();\n  }\n\n  /** Formatted SQL string (for logging/debugging). */\n  public pretty(): string {\n    const { query = \"\", bindings } = this.parse();\n    return `${query}\\n-- Bindings: ${JSON.stringify(bindings ?? [])}`;\n  }\n\n  /** Run EXPLAIN ANALYZE on the query. */\n  public async explain(): Promise<unknown> {\n    const { query = \"\", bindings = [] } = this.parse();\n    const result = await this.driver.query(\n      `EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON) ${query}`,\n      bindings,\n    );\n    return result.rows;\n  }\n\n  // ─── Utility ──────────────────────────────────────────────────\n\n  /** Extend the builder with a driver-specific extension. */\n  public extend<R>(extension: string, ..._args: unknown[]): R {\n    throw new Error(`Extension \"${extension}\" is not supported by PostgresQueryBuilder`);\n  }\n\n  /** Pluck scalar values for a single field (alias for pluck). */\n  public async pluckOne<TResult = unknown>(field: string): Promise<TResult[]> {\n    const results = await this.select([field]).get<Record<string, TResult>>();\n    return results.map((row) => row[field]);\n  }\n\n  // ============================================================================\n  // JOIN RELATIONS — INTERNAL PIPELINE\n  // ============================================================================\n\n  /**\n   * Before `get()` runs the parser, consume any joinWith ops recorded by the base\n   * class and expand them into the joinRelations Map.\n   */\n  private _processJoinWithOps(): void {\n    const joinWithOps = this.operations.filter((op) => op.type === \"joinWith\");\n    if (joinWithOps.length === 0) return;\n\n    // Remove joinWith ops from main operations — they are consumed here\n    this.operations = this.operations.filter((op) => op.type !== \"joinWith\");\n\n    for (const op of joinWithOps) {\n      const constraints = op.data.constraints as Record<\n        string,\n        string | ((q: QueryBuilder) => void)\n      >;\n      for (const [path, constraint] of Object.entries(constraints)) {\n        // Re-delegate to the extended joinWith implementation\n        if (!constraint || constraint === \"\") {\n          this.joinWith(path);\n        } else {\n          this.joinWith({ [path]: constraint });\n        }\n      }\n    }\n  }\n\n  /**\n   * Translate each entry in `joinRelations` into actual JOIN + selectRelatedColumns operations.\n   *\n   * Idempotent — guarded by `joinRelationsApplied` so repeat calls (e.g.\n   * `parse()` followed by `get()`) don't double-emit operations.\n   */\n  private applyJoinRelations(): void {\n    if (this.joinRelationsApplied || this.joinRelations.size === 0) {\n      return;\n    }\n\n    this.joinRelationsApplied = true;\n\n    for (const [path, config] of this.joinRelations) {\n      const RelatedModel = tryResolveModelClass(config.model) as\n        | { table: string; name?: string; primaryKey?: string }\n        | undefined;\n\n      if (!RelatedModel) {\n        throw new Error(`Relation model not found for ${path}`);\n      }\n\n      const relatedTable = (RelatedModel as { table: string }).table;\n      const alias = config.alias;\n      const parentTable = config.parentPath\n        ? this.joinRelations.get(config.parentPath)!.alias\n        : this.table;\n\n      const parentModel = config.parentModel as { name?: string; primaryKey?: string } | undefined;\n      const relatedModelMeta = RelatedModel as { name?: string; primaryKey?: string };\n\n      let localField: string;\n      let foreignField: string;\n\n      const conventions = this.dataSource?.relationDefaults;\n\n      if (config.type === \"belongsTo\") {\n        localField =\n          config.foreignKey ?? inferBelongsToForeignKey(config.relationName ?? \"\", conventions);\n        foreignField = config.ownerKey ?? relatedModelMeta.primaryKey ?? \"id\";\n      } else {\n        localField = config.localKey ?? parentModel?.primaryKey ?? \"id\";\n        foreignField =\n          config.foreignKey ?? inferHasForeignKey(parentModel?.name ?? \"Model\", conventions);\n      }\n\n      // hasMany uses a correlated subquery in SELECT (no JOIN) to avoid row explosion\n      if (config.type !== \"hasMany\") {\n        this.addOperation(\"leftJoin\", {\n          table: relatedTable,\n          alias,\n          localField: `${parentTable}.${localField}`,\n          foreignField,\n          // For hasOne/belongsTo joinWith with a constraint callback, the parser\n          // appends the constraint's where-clauses to the JOIN's ON condition\n          // (not the outer WHERE, which would convert LEFT JOIN semantics into\n          // INNER JOIN — main rows without a matching constraint-passing related\n          // row would disappear).\n          constraintOps: config.constraintOps,\n        });\n      }\n\n      this.addOperation(\"selectRelatedColumns\", {\n        alias,\n        relationName: config.relationName,\n        path,\n        table: relatedTable,\n        select: config.select,\n        type: config.type,\n        foreignKey: foreignField,\n        localKey: localField,\n        parentTable,\n        constraintOps: config.constraintOps, // passed through to parser\n      });\n    }\n  }\n\n  // ============================================================================\n  // HAS RELATIONS — INTERNAL PIPELINE\n  // ============================================================================\n\n  /**\n   * Translate every `has` / `whereHas` / `orWhereHas` / `doesntHave` /\n   * `whereDoesntHave` operation into an equivalent `whereRaw` (or\n   * `orWhereRaw`) carrying an EXISTS / NOT EXISTS / COUNT-comparison\n   * subquery. Keeps the parser pure (no schema awareness) — same pattern as\n   * `applyJoinRelations` and `applyCountRelations`.\n   *\n   * In-place rewrite preserves position so the boolean (AND/OR) stays\n   * correctly slotted relative to other where conditions.\n   *\n   * Idempotent — guarded by `hasRelationsApplied` so repeat calls (e.g.\n   * `parse()` followed by `get()`) don't double-translate.\n   */\n  private applyHasRelations(): void {\n    if (this.hasRelationsApplied) {\n      return;\n    }\n\n    const HAS_OP_TYPES = new Set([\n      \"has\",\n      \"whereHas\",\n      \"orWhereHas\",\n      \"doesntHave\",\n      \"whereDoesntHave\",\n    ]);\n\n    const hasAnyHasOp = this.operations.some((op) => HAS_OP_TYPES.has(op.type));\n\n    if (!hasAnyHasOp) {\n      this.hasRelationsApplied = true;\n      return;\n    }\n\n    this.hasRelationsApplied = true;\n\n    this.operations = this.operations.map((op) => {\n      if (!HAS_OP_TYPES.has(op.type)) {\n        return op;\n      }\n\n      return this.translateHasOp(op);\n    });\n\n    this.rebuildIndex();\n  }\n\n  /**\n   * Translate one has-family operation into its `whereRaw`/`orWhereRaw`\n   * equivalent. Resolves the relation definition, builds the EXISTS or\n   * COUNT-comparison subquery, and returns the replacement op.\n   */\n  private translateHasOp(op: Op): Op {\n    const data = op.data as {\n      relation: string;\n      subquery?: Op[];\n      operator?: string;\n      count?: number;\n    };\n\n    const definition = this.relationDefinitions?.[data.relation] as\n      | Record<string, unknown>\n      | undefined;\n\n    if (!definition) {\n      const modelName = (this.modelClass as { name?: string } | undefined)?.name ?? \"unknown\";\n      throw new Error(`${op.type}: Relation \"${data.relation}\" not found on model ${modelName}`);\n    }\n\n    const RelatedModel = tryResolveModelClass(definition.model as ModelRef | undefined) as\n      | { table?: string; name?: string; primaryKey?: string }\n      | undefined;\n\n    if (!RelatedModel || !(RelatedModel as { table?: string }).table) {\n      throw new Error(`${op.type}: Related model not resolvable for \"${data.relation}\"`);\n    }\n\n    const subquery = this.buildHasSubquery(\n      op.type,\n      data.relation,\n      definition,\n      RelatedModel as { table: string; name: string; primaryKey?: string },\n      data.subquery,\n      data.operator,\n      data.count,\n    );\n\n    const targetType = op.type === \"orWhereHas\" ? \"orWhereRaw\" : \"whereRaw\";\n\n    return {\n      type: targetType,\n      data: {\n        expression: subquery.expression,\n        bindings: subquery.bindings,\n      },\n    };\n  }\n\n  /**\n   * Build the SQL fragment that goes inside a `whereRaw` op for a has-family\n   * translation. Branches on relation type AND on the operation type:\n   *\n   * - `has` with default operator/count → `EXISTS (SELECT 1 FROM ...)`\n   * - `has` with custom operator/count → `(SELECT COUNT(*) FROM ...) <op> <count>`\n   * - `whereHas` / `orWhereHas` → `EXISTS (SELECT 1 ... AND <constraint>)`\n   * - `doesntHave` → `NOT EXISTS (SELECT 1 FROM ...)`\n   * - `whereDoesntHave` → `NOT EXISTS (SELECT 1 ... AND <constraint>)`\n   */\n  private buildHasSubquery(\n    opType: string,\n    relationName: string,\n    definition: Record<string, unknown>,\n    RelatedModel: { table: string; name: string; primaryKey?: string },\n    constraintOps: Op[] | undefined,\n    operator: string | undefined,\n    count: number | undefined,\n  ): { expression: string; bindings: unknown[] } {\n    const dialect = this.driver.dialect;\n    const quotedSelfTable = dialect.quoteIdentifier(this.table);\n    const quotedRelatedTable = dialect.quoteIdentifier(RelatedModel.table);\n    const relationType = definition.type as string;\n    const selfModel = this.modelClass as { name?: string; primaryKey?: string } | undefined;\n    const conventions = this.dataSource?.relationDefaults;\n\n    const where = this.extractCountWhereFragment(RelatedModel.table, constraintOps);\n\n    let fromClause: string;\n    let joinCondition: string;\n\n    if (relationType === \"hasMany\" || relationType === \"hasOne\") {\n      const localKey = (definition.localKey as string | undefined) ?? selfModel?.primaryKey ?? \"id\";\n      const foreignKey =\n        (definition.foreignKey as string | undefined) ??\n        inferHasForeignKey(selfModel?.name ?? \"Model\", conventions);\n\n      fromClause = quotedRelatedTable;\n      joinCondition =\n        `${quotedRelatedTable}.${dialect.quoteIdentifier(foreignKey)} = ` +\n        `${quotedSelfTable}.${dialect.quoteIdentifier(localKey)}`;\n    } else if (relationType === \"belongsTo\") {\n      const ownerKey =\n        (definition.localKey as string | undefined) ?? RelatedModel.primaryKey ?? \"id\";\n      const foreignKey =\n        (definition.foreignKey as string | undefined) ??\n        inferBelongsToForeignKey(relationName, conventions);\n\n      fromClause = quotedRelatedTable;\n      joinCondition =\n        `${quotedRelatedTable}.${dialect.quoteIdentifier(ownerKey)} = ` +\n        `${quotedSelfTable}.${dialect.quoteIdentifier(foreignKey)}`;\n    } else if (relationType === \"belongsToMany\") {\n      const pivotTableName =\n        (definition.pivot as string | undefined) ??\n        inferPivotTable(selfModel?.name ?? \"Model\", RelatedModel.name, conventions);\n\n      const quotedPivot = dialect.quoteIdentifier(pivotTableName);\n      const pivotLocalCol =\n        (definition.localKey as string | undefined) ??\n        inferPivotKey(selfModel?.name ?? \"Model\", conventions);\n      const pivotForeignCol =\n        (definition.foreignKey as string | undefined) ??\n        inferPivotKey(RelatedModel.name, conventions);\n      const selfPk =\n        (definition.pivotLocalKey as string | undefined) ?? selfModel?.primaryKey ?? \"id\";\n      const relatedPk =\n        (definition.pivotForeignKey as string | undefined) ?? RelatedModel.primaryKey ?? \"id\";\n\n      // Constraint-free: pivot-only count. With constraint: INNER JOIN related so\n      // the constraint can target related columns.\n      if (!constraintOps || constraintOps.length === 0) {\n        fromClause = quotedPivot;\n        joinCondition =\n          `${quotedPivot}.${dialect.quoteIdentifier(pivotLocalCol)} = ` +\n          `${quotedSelfTable}.${dialect.quoteIdentifier(selfPk)}`;\n      } else {\n        fromClause =\n          `${quotedPivot} INNER JOIN ${quotedRelatedTable} ON ` +\n          `${quotedRelatedTable}.${dialect.quoteIdentifier(relatedPk)} = ` +\n          `${quotedPivot}.${dialect.quoteIdentifier(pivotForeignCol)}`;\n        joinCondition =\n          `${quotedPivot}.${dialect.quoteIdentifier(pivotLocalCol)} = ` +\n          `${quotedSelfTable}.${dialect.quoteIdentifier(selfPk)}`;\n      }\n    } else {\n      throw new Error(\n        `${opType}: Unsupported relation type \"${relationType}\" for \"${relationName}\"`,\n      );\n    }\n\n    const fullWhere = where.fragment ? `${joinCondition} AND ${where.fragment}` : joinCondition;\n\n    // `has` with custom operator/count compiles to a COUNT comparison; everything\n    // else uses EXISTS / NOT EXISTS for short-circuit behaviour.\n    const isCountComparison =\n      opType === \"has\" && ((operator !== undefined && operator !== \">=\") || (count ?? 1) !== 1);\n\n    if (isCountComparison) {\n      const op = operator ?? \">=\";\n      const compareCount = count ?? 1;\n\n      return {\n        expression: `(SELECT COUNT(*) FROM ${fromClause} WHERE ${fullWhere}) ${op} ${compareCount}`,\n        bindings: where.bindings,\n      };\n    }\n\n    const negate = opType === \"doesntHave\" || opType === \"whereDoesntHave\";\n    const keyword = negate ? \"NOT EXISTS\" : \"EXISTS\";\n\n    return {\n      expression: `${keyword} (SELECT 1 FROM ${fromClause} WHERE ${fullWhere})`,\n      bindings: where.bindings,\n    };\n  }\n\n  // ============================================================================\n  // COUNT RELATIONS — INTERNAL PIPELINE\n  // ============================================================================\n\n  /**\n   * Translate each entry in `countRelations` into a correlated COUNT subquery\n   * emitted as a `selectRaw` operation. Runs after `applyJoinRelations` so the\n   * \"preserve main table columns\" guard sees any joins already in place.\n   *\n   * Idempotent — guarded by `countRelationsApplied` so repeat calls (e.g.\n   * `parse()` followed by `get()`) don't double-emit operations.\n   */\n  private applyCountRelations(): void {\n    if (this.countRelationsApplied || this.countRelations.size === 0) {\n      return;\n    }\n\n    this.countRelationsApplied = true;\n\n    this.ensureMainColumnsForCount();\n\n    for (const [alias, entry] of this.countRelations) {\n      const definition = this.relationDefinitions?.[entry.relation] as\n        | Record<string, unknown>\n        | undefined;\n\n      if (!definition) {\n        const modelName = (this.modelClass as { name?: string } | undefined)?.name ?? \"unknown\";\n        throw new Error(`withCount: Relation \"${entry.relation}\" not found on model ${modelName}`);\n      }\n\n      const RelatedModel = tryResolveModelClass(definition.model as ModelRef | undefined) as\n        | { table?: string; name?: string }\n        | undefined;\n\n      if (!RelatedModel || !(RelatedModel as { table?: string }).table) {\n        throw new Error(\n          `withCount: Related model not resolvable for \"${entry.relation}\" (alias \"${alias}\")`,\n        );\n      }\n\n      const subquery = this.buildCountSubquery(\n        alias,\n        entry.relation,\n        definition,\n        RelatedModel as { table: string; name: string },\n        entry.constraintOps,\n      );\n\n      this.addOperation(\"selectRaw\", {\n        expression: subquery.expression,\n        bindings: subquery.bindings,\n      });\n    }\n  }\n\n  /**\n   * Without an explicit `select(...)` or any `selectRaw`/`selectRelatedColumns`\n   * already pushed, the parser's \"no selects → SELECT *\" fallback would be\n   * suppressed once we add count expressions. Push `<table>.*` first so the\n   * caller's columns survive.\n   */\n  private ensureMainColumnsForCount(): void {\n    const hasExistingSelect = this.operations.some(\n      (op) => op.type === \"select\" || op.type === \"selectRaw\" || op.type === \"selectRelatedColumns\",\n    );\n\n    if (hasExistingSelect) {\n      return;\n    }\n\n    const quotedTable = this.driver.dialect.quoteIdentifier(this.table);\n\n    this.addOperation(\"selectRaw\", {\n      expression: `${quotedTable}.*`,\n      bindings: [],\n    });\n  }\n\n  /**\n   * Build a single correlated-subquery expression for a count entry. Branches\n   * on relation type (hasMany/hasOne/belongsTo/belongsToMany). The optional\n   * constraint callback's where-ops are translated via a sub-parser and\n   * spliced into the subquery's WHERE clause.\n   */\n  private buildCountSubquery(\n    alias: string,\n    relationName: string,\n    definition: Record<string, unknown>,\n    RelatedModel: { table: string; name: string },\n    constraintOps: Op[] | undefined,\n  ): { expression: string; bindings: unknown[] } {\n    const dialect = this.driver.dialect;\n    const quotedAlias = dialect.quoteIdentifier(alias);\n    const quotedSelfTable = dialect.quoteIdentifier(this.table);\n    const quotedRelatedTable = dialect.quoteIdentifier(RelatedModel.table);\n    const relationType = definition.type as string;\n\n    const selfModel = this.modelClass as { name?: string; primaryKey?: string } | undefined;\n    const relatedMeta = RelatedModel as { name: string; primaryKey?: string; table: string };\n    const conventions = this.dataSource?.relationDefaults;\n\n    if (relationType === \"hasMany\" || relationType === \"hasOne\") {\n      const localKey = (definition.localKey as string | undefined) ?? selfModel?.primaryKey ?? \"id\";\n      const foreignKey =\n        (definition.foreignKey as string | undefined) ??\n        inferHasForeignKey(selfModel?.name ?? \"Model\", conventions);\n      const where = this.extractCountWhereFragment(RelatedModel.table, constraintOps);\n\n      const fkCondition =\n        `${quotedRelatedTable}.${dialect.quoteIdentifier(foreignKey)} = ` +\n        `${quotedSelfTable}.${dialect.quoteIdentifier(localKey)}`;\n      const fullWhere = where.fragment ? `${fkCondition} AND ${where.fragment}` : fkCondition;\n\n      return {\n        expression: `(SELECT COUNT(*) FROM ${quotedRelatedTable} WHERE ${fullWhere})::int AS ${quotedAlias}`,\n        bindings: where.bindings,\n      };\n    }\n\n    if (relationType === \"belongsTo\") {\n      const ownerKey =\n        (definition.localKey as string | undefined) ?? relatedMeta.primaryKey ?? \"id\";\n      const foreignKey =\n        (definition.foreignKey as string | undefined) ??\n        inferBelongsToForeignKey(relationName, conventions);\n      const where = this.extractCountWhereFragment(RelatedModel.table, constraintOps);\n\n      const condition =\n        `${quotedRelatedTable}.${dialect.quoteIdentifier(ownerKey)} = ` +\n        `${quotedSelfTable}.${dialect.quoteIdentifier(foreignKey)}`;\n      const fullWhere = where.fragment ? `${condition} AND ${where.fragment}` : condition;\n\n      return {\n        expression: `(SELECT COUNT(*) FROM ${quotedRelatedTable} WHERE ${fullWhere})::int AS ${quotedAlias}`,\n        bindings: where.bindings,\n      };\n    }\n\n    if (relationType === \"belongsToMany\") {\n      const pivotTableName =\n        (definition.pivot as string | undefined) ??\n        inferPivotTable(selfModel?.name ?? \"Model\", relatedMeta.name, conventions);\n\n      const quotedPivot = dialect.quoteIdentifier(pivotTableName);\n      const pivotLocalCol =\n        (definition.localKey as string | undefined) ??\n        inferPivotKey(selfModel?.name ?? \"Model\", conventions);\n      const pivotForeignCol =\n        (definition.foreignKey as string | undefined) ??\n        inferPivotKey(relatedMeta.name, conventions);\n      const selfPk =\n        (definition.pivotLocalKey as string | undefined) ?? selfModel?.primaryKey ?? \"id\";\n      const relatedPk =\n        (definition.pivotForeignKey as string | undefined) ?? relatedMeta.primaryKey ?? \"id\";\n\n      const pivotCondition =\n        `${quotedPivot}.${dialect.quoteIdentifier(pivotLocalCol)} = ` +\n        `${quotedSelfTable}.${dialect.quoteIdentifier(selfPk)}`;\n\n      if (!constraintOps || constraintOps.length === 0) {\n        return {\n          expression: `(SELECT COUNT(*) FROM ${quotedPivot} WHERE ${pivotCondition})::int AS ${quotedAlias}`,\n          bindings: [],\n        };\n      }\n\n      const where = this.extractCountWhereFragment(RelatedModel.table, constraintOps);\n      const join =\n        `INNER JOIN ${quotedRelatedTable} ON ${quotedRelatedTable}.${dialect.quoteIdentifier(relatedPk)} = ` +\n        `${quotedPivot}.${dialect.quoteIdentifier(pivotForeignCol)}`;\n      const fullWhere = where.fragment ? `${pivotCondition} AND ${where.fragment}` : pivotCondition;\n\n      return {\n        expression: `(SELECT COUNT(*) FROM ${quotedPivot} ${join} WHERE ${fullWhere})::int AS ${quotedAlias}`,\n        bindings: where.bindings,\n      };\n    }\n\n    throw new Error(`withCount: Unsupported relation type \"${relationType}\" for \"${relationName}\"`);\n  }\n\n  /**\n   * Run a constraint's where-ops through a fresh sub-parser to obtain a SQL\n   * WHERE-fragment plus bindings. Strips the leading `WHERE ` and rewrites\n   * `$N` placeholders back to `?` so the outer parser renumbers them\n   * consistently when it processes the enclosing `selectRaw` operation.\n   *\n   * Non-where ops (orderBy / limit / etc.) are silently dropped — they have\n   * no meaning inside a COUNT subquery.\n   */\n  private extractCountWhereFragment(\n    relatedTable: string,\n    constraintOps: Op[] | undefined,\n  ): { fragment: string; bindings: unknown[] } {\n    if (!constraintOps || constraintOps.length === 0) {\n      return { fragment: \"\", bindings: [] };\n    }\n\n    const whereOps = constraintOps.filter(\n      (op) => op.type.startsWith(\"where\") || op.type.startsWith(\"orWhere\"),\n    );\n\n    if (whereOps.length === 0) {\n      return { fragment: \"\", bindings: [] };\n    }\n\n    const subParser = new PostgresQueryParser({\n      table: relatedTable,\n      operations: toParserOps(whereOps),\n    });\n\n    const { query = \"\", bindings = [] } = subParser.parse();\n    const match = query.match(/WHERE\\s+(.+)$/);\n\n    if (!match) {\n      return { fragment: \"\", bindings: [] };\n    }\n\n    const fragment = match[1].replace(/\\$\\d+/g, \"?\");\n\n    return { fragment, bindings: bindings ?? [] };\n  }\n\n  // ============================================================================\n  // GROUP-BY AGGREGATES — INTERNAL PIPELINE\n  // ============================================================================\n\n  /**\n   * Rewrite every `having` op whose field matches a recorded aggregate alias\n   * into a `havingRaw` carrying the underlying SQL expression. PostgreSQL\n   * forbids SELECT aliases in HAVING, so `having(\"revenue\", \">\", 1000)` on a\n   * `groupBy` aggregate would otherwise throw at runtime. A `having` on a\n   * grouped column (no alias match) is left untouched. Runs at parse time\n   * (not in the `groupBy` override) so it is independent of fluent call order.\n   *\n   * Idempotent — guarded by `groupByAggregatesApplied` so repeat calls (e.g.\n   * `parse()` followed by `get()`) don't double-process.\n   */\n  private applyGroupByAggregates(): void {\n    if (this.groupByAggregatesApplied) {\n      return;\n    }\n\n    this.groupByAggregatesApplied = true;\n\n    if (this.aggregateAliases.size === 0) {\n      return;\n    }\n\n    this.operations = this.operations.map((operation) => {\n      if (operation.type !== \"having\") {\n        return operation;\n      }\n\n      const field = operation.data.field as string;\n      const sql = this.aggregateAliases.get(field);\n\n      if (!sql) {\n        return operation;\n      }\n\n      const operator = (operation.data.operator as string) ?? \"=\";\n\n      return {\n        type: \"havingRaw\",\n        data: {\n          expression: `${sql} ${operator} ?`,\n          bindings: [operation.data.value],\n        },\n      };\n    });\n\n    this.rebuildIndex();\n  }\n\n  // ============================================================================\n  // EAGER LOADING — INTERNAL PIPELINE\n  // ============================================================================\n\n  /**\n   * Run the RelationLoader against the fetched rows for every relation\n   * registered via `with()`. Mutates each model instance in place — attaches\n   * loaded relations onto `model.loadedRelations` and as direct properties.\n   *\n   * Lives here (not in `buildQuery`'s `onFetched` callback as it did\n   * historically) so any code path that calls `get()` — including\n   * `Model.newQueryBuilder()` direct instantiation, custom builder subclasses\n   * via `static builder`, or any `eagerLoadRelations`-bearing builder — gets\n   * eager-loading. Previously the loader was only installed when the builder\n   * was constructed via `Model.query()` / `buildQuery`, so bypassing that\n   * factory made `with()` a silent no-op.\n   *\n   * Skipped silently when `modelClass` is absent (raw driver-level\n   * `queryBuilder()` usage has no relations map to consult).\n   */\n  private async applyEagerLoading(records: unknown[]): Promise<void> {\n    if (!this.modelClass || this.eagerLoadRelations.size === 0 || records.length === 0) {\n      return;\n    }\n\n    const constraints: Record<string, (query: QueryBuilderContract) => void> = {};\n\n    for (const [name, constraint] of this.eagerLoadRelations) {\n      if (typeof constraint === \"function\") {\n        constraints[name] = constraint as (query: QueryBuilderContract) => void;\n      }\n    }\n\n    const loader = new RelationLoader(records as never, this.modelClass as never);\n    await loader.load([...this.eagerLoadRelations.keys()], constraints);\n  }\n\n  /**\n   * Extract per-relation data from raw DB rows (before hydration).\n   * Returns a Map of row index → nested relation data tree.\n   */\n  private extractJoinedRelationData(records: unknown[]): Map<number, Record<string, unknown>> {\n    const result = new Map<number, Record<string, unknown>>();\n    if (this.joinRelations.size === 0) return result;\n\n    (records as Record<string, unknown>[]).forEach((record, index) => {\n      const relationData: Record<string, unknown> = {};\n\n      // Process shallower paths first so parents exist before children\n      const sortedPaths = Array.from(this.joinRelations.keys()).sort(\n        (a, b) => a.split(\".\").length - b.split(\".\").length,\n      );\n\n      for (const path of sortedPaths) {\n        const config = this.joinRelations.get(path)!;\n        const columnName = config.alias;\n\n        const relatedData = record[columnName];\n        delete record[columnName];\n\n        const parsedData =\n          relatedData !== null &&\n          !(\n            typeof relatedData === \"object\" &&\n            Object.values(relatedData as object).every((v) => v === null)\n          )\n            ? relatedData\n            : null;\n\n        const parts = path.split(\".\");\n        const lastPart = parts.pop()!;\n        let current = relationData;\n\n        for (const part of parts) {\n          if (!current[part]) current[part] = {};\n          current = current[part] as Record<string, unknown>;\n        }\n\n        current[lastPart] = parsedData;\n      }\n\n      result.set(index, relationData);\n    });\n\n    return result;\n  }\n\n  /**\n   * Attach extracted relation data to hydrated model instances.\n   */\n  private attachJoinedRelations(\n    records: unknown[],\n    joinedData: Map<number, Record<string, unknown>>,\n  ): void {\n    if (this.joinRelations.size === 0) return;\n\n    const attachNested = (model: unknown, dataTree: unknown, currentPath = \"\"): void => {\n      if (!dataTree || typeof dataTree !== \"object\") return;\n\n      for (const [key, data] of Object.entries(dataTree as Record<string, unknown>)) {\n        const path = currentPath ? `${currentPath}.${key}` : key;\n        const config = this.joinRelations.get(path);\n        if (!config) continue;\n\n        if (data === null) {\n          attachLoadedRelation(model as object, key, null);\n          continue;\n        }\n\n        const RelatedModel = resolveModelClass(config.model as string);\n        if (!RelatedModel) continue;\n\n        const childKeys = Array.from(this.joinRelations.keys())\n          .filter((p) => p.startsWith(`${path}.`))\n          .map((p) => p.split(\".\")[path.split(\".\").length]);\n\n        if (config.type === \"hasMany\") {\n          const rows = Array.isArray(data) ? data : [];\n          const instances = rows.map((row: unknown) => {\n            const rowData = { ...(row as object) } as Record<string, unknown>;\n            for (const childKey of childKeys) delete rowData[childKey];\n            return (RelatedModel as { hydrate: (d: unknown) => unknown }).hydrate(rowData);\n          });\n\n          attachLoadedRelation(model as object, key, instances as never);\n        } else {\n          const modelData = { ...(data as object) } as Record<string, unknown>;\n          for (const childKey of childKeys) delete modelData[childKey];\n\n          const relatedInstance = (RelatedModel as { hydrate: (d: unknown) => unknown }).hydrate(\n            modelData,\n          );\n          attachNested(relatedInstance, data, path);\n\n          attachLoadedRelation(model as object, key, relatedInstance as never);\n        }\n      }\n    };\n\n    records.forEach((model, index) => {\n      const relationData = joinedData.get(index);\n      if (relationData) attachNested(model, relationData);\n    });\n  }\n\n  // ============================================================================\n  // INTERNAL HELPERS\n  // ============================================================================\n\n  /**\n   * Build a WHERE-only SQL fragment from `where*` operations on the current builder.\n   * Used by DELETE / UPDATE / increment paths.\n   */\n  private buildFilter(): { sql: string; params: unknown[] } {\n    const whereOps = this.operations.filter(\n      (op) => op.type.includes(\"where\") || op.type.includes(\"Where\"),\n    );\n\n    if (whereOps.length === 0) return { sql: \"\", params: [] };\n\n    const parser = new PostgresQueryParser({\n      table: this.table,\n      operations: toParserOps(whereOps),\n    });\n\n    const { query = \"\", bindings = [] } = parser.parse();\n    const whereMatch = query.match(/WHERE .+$/);\n    return { sql: whereMatch ? whereMatch[0] : \"\", params: bindings };\n  }\n}\n"],"mappings":"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"}

package/esm/drivers/postgres/postgres-query-parser.d.mts

@@ -0,0 +1,351 @@
+import { DriverQuery } from "../../contracts/query-builder.contract.mjs";
+import { SqlDialectContract } from "../sql/sql-dialect.contract.mjs";
+
+//#region ../../@warlock.js/cascade/src/drivers/postgres/postgres-query-parser.d.ts
+/**
+ * Operation types supported by the query parser.
+ */
+type PostgresOperationType = "where" | "orWhere" | "whereRaw" | "orWhereRaw" | "whereIn" | "whereNotIn" | "whereNull" | "whereNotNull" | "whereBetween" | "whereNotBetween" | "whereLike" | "whereNotLike" | "whereColumn" | "orWhereColumn" | "whereExists" | "whereNotExists" | "whereDate" | "whereDateBefore" | "whereDateAfter" | "whereDateBetween" | "whereJsonContains" | "whereJsonDoesntContain" | "whereFullText" | "select" | "selectRaw" | "deselect" | "join" | "leftJoin" | "rightJoin" | "innerJoin" | "fullJoin" | "crossJoin" | "joinRaw" | "orderBy" | "orderByRaw" | "groupBy" | "having" | "havingRaw" | "limit" | "offset" | "has" | "whereHas" | "doesntHave" | "whereDoesntHave" | "selectRelatedColumns" | "distinct";
+/**
+ * Internal operation representation.
+ */
+type PostgresParserOperation = {
+  /** Operation type */readonly type: PostgresOperationType; /** Operation data/parameters */
+  readonly data: Record<string, unknown>;
+};
+/**
+ * Parser configuration options.
+ */
+type PostgresParserOptions = {
+  /** Target table name */readonly table: string; /** Table alias (optional) */
+  readonly alias?: string; /** Operations to parse */
+  readonly operations: PostgresParserOperation[]; /** SQL dialect for syntax generation */
+  readonly dialect?: SqlDialectContract; /** Factory for creating sub-parsers (for nested queries) */
+  readonly createSubParser?: (table: string) => PostgresQueryParser;
+};
+/**
+ * PostgreSQL Query Parser.
+ *
+ * Converts a list of query operations into a SQL query string with parameters.
+ * Handles SELECT, WHERE, JOIN, ORDER BY, GROUP BY, LIMIT/OFFSET clauses.
+ *
+ * @example
+ * ```typescript
+ * const parser = new PostgresQueryParser({
+ *   table: 'users',
+ *   operations: [
+ *     { type: 'where', data: { field: 'name', operator: '=', value: 'Alice' } },
+ *     { type: 'orderBy', data: { field: 'createdAt', direction: 'desc' } },
+ *     { type: 'limit', data: { value: 10 } }
+ *   ]
+ * });
+ *
+ * const { sql, params } = parser.parse();
+ * // sql: 'SELECT * FROM "users" WHERE "name" = $1 ORDER BY "createdAt" DESC LIMIT 10'
+ * // params: ['Alice']
+ * ```
+ */
+declare class PostgresQueryParser {
+  /**
+   * Target table name.
+   */
+  private readonly table;
+  /**
+   * Table alias.
+   */
+  private readonly alias?;
+  /**
+   * Operations to process.
+   */
+  private readonly operations;
+  /**
+   * SQL dialect for syntax.
+   */
+  private readonly dialect;
+  /**
+   * Current parameter index (1-based for PostgreSQL).
+   */
+  private paramIndex;
+  /**
+   * Collected parameters.
+   */
+  private readonly params;
+  /**
+   * SELECT columns.
+   */
+  selectColumns: string[];
+  /**
+   * Deselected (excluded) columns.
+   */
+  private deselectColumns;
+  /**
+   * Raw SELECT expressions.
+   */
+  private selectRaw;
+  /**
+   * WHERE clauses.
+   */
+  whereClauses: string[];
+  /**
+   * JOIN clauses.
+   */
+  private joinClauses;
+  /**
+   * ORDER BY clauses.
+   */
+  orderClauses: string[];
+  /**
+   * GROUP BY columns.
+   */
+  private groupColumns;
+  /**
+   * HAVING clauses.
+   */
+  private havingClauses;
+  /**
+   * LIMIT value.
+   */
+  limitValue?: number;
+  /**
+   * OFFSET value.
+   */
+  offsetValue?: number;
+  /**
+   * DISTINCT flag.
+   */
+  private isDistinct;
+  /**
+   * Whether the query has any JOIN operations (pre-scanned before processing).
+   * Used by qualifyColumn() to decide whether to prefix columns with the main table.
+   */
+  private hasJoins;
+  /**
+   * Tracked joined tables (for table reference detection).
+   */
+  private readonly joinedTables;
+  /**
+   * Create a new query parser.
+   *
+   * @param options - Parser configuration
+   */
+  constructor(options: PostgresParserOptions);
+  /**
+   * Parse all operations and build the SQL query.
+   *
+   * @returns DriverQuery with `query` (SQL string) and `bindings` (parameter values)
+   */
+  parse(): DriverQuery;
+  /**
+   * Get a formatted string representation of the query.
+   *
+   * @returns Formatted SQL with bindings
+   */
+  toPrettyString(): string;
+  /**
+   * Process a single operation.
+   *
+   * @param operation - The operation to process
+   */
+  private processOperation;
+  /**
+   * Build the final SQL query from collected clauses.
+   *
+   * @returns Complete SQL query string
+   */
+  private buildSql;
+  /**
+   * Build the SELECT clause.
+   *
+   * @returns SELECT clause string
+   */
+  private buildSelectClause;
+  /**
+   * Add a placeholder and parameter.
+   *
+   * @param value - Parameter value
+   * @returns Placeholder string ($1, $2, etc.)
+   */
+  private addParam;
+  /**
+   * Absorb a sub-parser's params into this parser, returning a rewriter
+   * function that translates the sub-parser's `$N` placeholders into freshly
+   * numbered placeholders in this parser's namespace.
+   *
+   * Required whenever sub-parser SQL fragments (e.g. WHERE clauses produced
+   * for a `joinWith` constraint) are spliced into the outer query — without
+   * the rewrite the embedded `$N` references point at parameters this
+   * parser has no knowledge of, leaving them dangling in the final SQL.
+   *
+   * The sub-parser's `params[i]` corresponds to its `$(i+1)` placeholder
+   * (its `paramIndex` always starts at 1), so we map sequentially.
+   *
+   * @example
+   *   const renumber = this.absorbSubParserParams(subParser);
+   *   const fragment = renumber(subParser.whereClauses.join(" "));
+   */
+  private absorbSubParserParams;
+  /**
+   * Process a basic WHERE operation.
+   *
+   * Delegates to specialised processors for operators that require more than a
+   * single placeholder (between, in, like-variants, exists, etc.).
+   */
+  private processWhere;
+  /**
+   * Process a raw WHERE operation.
+   */
+  private processWhereRaw;
+  /**
+   * Process WHERE IN / NOT IN.
+   */
+  private processWhereIn;
+  /**
+   * Process WHERE NULL / NOT NULL.
+   */
+  private processWhereNull;
+  /**
+   * Process WHERE BETWEEN / NOT BETWEEN.
+   */
+  private processWhereBetween;
+  /**
+   * Process WHERE LIKE / NOT LIKE.
+   */
+  private processWhereLike;
+  /**
+   * Process WHERE column comparison.
+   */
+  private processWhereColumn;
+  /**
+   * Process WHERE JSON contains.
+   */
+  private processWhereJsonContains;
+  /**
+   * Process full-text search WHERE.
+   */
+  private processWhereFullText;
+  /**
+   * Process SELECT operation.
+   */
+  private processSelect;
+  /**
+   * Process raw SELECT expression.
+   */
+  private processSelectRaw;
+  /**
+   * Process DESELECT operation.
+   */
+  private processDeselect;
+  /**
+   * Process SELECT for related columns (joinWith).
+   *
+   * - hasOne / belongsTo  → LEFT JOIN + row_to_json  (single object)
+   * - hasMany             → correlated subquery with json_agg (array, no row explosion)
+   *
+   * @example hasMany correlated subquery:
+   *   (SELECT json_agg(row_to_json(a.*))
+   *    FROM "chat_message_actions" a
+   *    WHERE a."chat_message_id" = "chat_messages"."id") AS "actions"
+   *
+   * @example hasOne/belongsTo row_to_json:
+   *   row_to_json("organizationAiModel".*) AS "organizationAiModel"
+   */
+  private processSelectRelatedColumns;
+  /**
+   * Process JOIN operation with smart field detection.
+   *
+   * Handles both regular columns and JSONB nested paths:
+   * - "id" → "table"."id" (auto-prefixed)
+   * - "users.id" → "users"."id" (explicit table)
+   * - "createdBy.id" → "table"."createdBy"->>'id' (JSONB path)
+   * - "posts.createdBy.id" → "posts"."createdBy"->>'id' (JSONB with table)
+   */
+  private processJoin;
+  /**
+   * Parse a column identifier with smart detection for table prefixes and JSONB paths.
+   *
+   * Supports an optional explicit cast suffix using PostgreSQL's `::type` syntax,
+   * which is the only way to coerce a JSONB-extracted value (always returned as
+   * `text`) into another type. The parser does NOT infer casts from key names —
+   * coercion is always opt-in by the caller.
+   *
+   * @param field - The field string. Examples:
+   *   - "id"                       → `"table"."id"`
+   *   - "users.id"                 → `"users"."id"`
+   *   - "createdBy.id"             → `"table"."createdBy"->>'id'`
+   *   - "createdBy.id::int"        → `("table"."createdBy"->>'id')::int`
+   *   - "meta.score::numeric"      → `("table"."meta"->>'score')::numeric`
+   *   - "posts.createdBy.id::uuid" → `("posts"."createdBy"->>'id')::uuid`
+   * @param defaultTable - Default table to use if no prefix
+   * @param tableAlias - Table alias to use if provided
+   * @returns Properly quoted SQL expression
+   */
+  private parseColumnIdentifier;
+  /**
+   * Check if a string is a table reference (main table or join table).
+   */
+  private isTableReference;
+  /**
+   * Build a JSONB path expression.
+   *
+   * @param table - Table name
+   * @param column - JSONB column name
+   * @param path - Array of nested keys
+   * @returns PostgreSQL JSONB path expression
+   *
+   * Returns the raw JSONB path expression — extracted values are always `text`
+   * (`->>` returns text). Callers that need a different type must request an
+   * explicit cast via the `::type` suffix in `parseColumnIdentifier`.
+   *
+   * @example
+   * buildJsonbPath("posts", "createdBy", ["id"])
+   * // Returns: "posts"."createdBy"->>'id'
+   *
+   * buildJsonbPath("posts", "createdBy", ["address", "city"])
+   * // Returns: "posts"."createdBy"->'address'->>'city'
+   */
+  private buildJsonbPath;
+  /**
+   * Process CROSS JOIN operation.
+   */
+  private processCrossJoin;
+  /**
+   * Process raw JOIN expression.
+   */
+  private processJoinRaw;
+  /**
+   * Process ORDER BY operation.
+   */
+  private processOrderBy;
+  /**
+   * Process raw ORDER BY expression.
+   */
+  private processOrderByRaw;
+  /**
+   * Process GROUP BY operation.
+   */
+  private processGroupBy;
+  /**
+   * Process HAVING operation.
+   */
+  private processHaving;
+  /**
+   * Process a raw HAVING expression, threading `?` placeholders into
+   * positional params the same way `processWhereRaw` / `processSelectRaw` do.
+   * Without this, bindings on a `havingRaw` op are silently dropped.
+   */
+  private processHavingRaw;
+  /**
+   * Add a WHERE clause with boolean operator.
+   */
+  private addWhereClause;
+  /**
+   * Map simple Cascade operators to their SQL equivalents.
+   *
+   * Complex operators (between, in, like-variants, exists) are handled by
+   * dedicated processors and should never reach this method.
+   */
+  private mapOperator;
+}
+//#endregion
+export { PostgresOperationType, PostgresParserOperation, PostgresParserOptions, PostgresQueryParser };
+//# sourceMappingURL=postgres-query-parser.d.mts.map

package/esm/drivers/postgres/postgres-query-parser.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-query-parser.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/drivers/postgres/postgres-query-parser.ts"],"mappings":";;;;;;;KAsBY,qBAAA;;;;KA4DA,uBAAA;EAUA,8BARD,IAAA,EAAM,qBAAA;WAEN,IAAA,EAAM,MAAM;AAAA;;;;KAMX,qBAAA;EAID,iCAFA,KAAA,UAIY;EAAA,SAFZ,KAAA,WAIU;EAAA,SAFV,UAAA,EAAY,uBAAA,IAIO;EAAA,SAFnB,OAAA,GAAU,kBAAA,EAE8C;EAAA,SAAxD,eAAA,IAAmB,KAAA,aAAkB,mBAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;cAyBnC,mBAAA;EAsGiB;;;EAAA,iBAlGX,KAAA;EA0JV;;;EAAA,iBArJU,KAAA;EA4XT;;;EAAA,iBAvXS,UAAA;EA8dT;;;EAAA,iBAzdS,OAAA;EA+gBT;;;EAAA,QA1gBA,UAAA;EAykBA;;;EAAA,iBApkBS,MAAA;EA+yBT;;;EA1yBD,aAAA;EA05BC;;;EAAA,QAr5BA,eAAA;EAu8BA;;;EAAA,QAl8BA,SAAA;EA8+BW;AAAA;;EAz+BZ,YAAA;;;;UAKC,WAAA;;;;EAKD,YAAA;;;;UAKC,YAAA;;;;UAKA,aAAA;;;;EAKD,UAAA;;;;EAKA,WAAA;;;;UAKC,UAAA;;;;;UAMA,QAAA;;;;mBAKS,YAAA;;;;;;cAOE,OAAA,EAAS,qBAAA;;;;;;EAYrB,KAAA,CAAA,GAAS,WAAW;;;;;;EA4CpB,cAAA,CAAA;;;;;;UAUC,gBAAA;;;;;;UAyIA,QAAA;;;;;;UAqDA,iBAAA;;;;;;;UA+BA,QAAA;;;;;;;;;;;;;;;;;;UAsBA,qBAAA;;;;;;;UAqBA,YAAA;;;;UA4CA,eAAA;;;;UAgBA,cAAA;;;;UAcA,gBAAA;;;;UAUA,mBAAA;;;;UAeA,gBAAA;;;;UAeA,kBAAA;;;;UAeA,wBAAA;;;;UAcA,oBAAA;;;;UAgBA,aAAA;;;;UAkBA,gBAAA;;;;UAsBA,eAAA;;;;;;;;;;;;;;;UAmBA,2BAAA;;;;;;;;;;UAoHA,WAAA;;;;;;;;;;;;;;;;;;;;UA8EA,qBAAA;;;;UAiDA,gBAAA;;;;;;;;;;;;;;;;;;;;UA+BA,cAAA;;;;UAuBA,gBAAA;;;;UASA,cAAA;;;;UAeA,cAAA;;;;UAWA,iBAAA;;;;UAeA,cAAA;;;;UASA,aAAA;;;;;;UAgBA,gBAAA;;;;UAcA,cAAA;;;;;;;UAcA,WAAA;AAAA"}