@warlock.js/cascade 5.22.1 → 5.23.0

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

@@ -342,7 +342,7 @@ var PostgresQueryParser = class PostgresQueryParser {
 	buildSql() {
 		const parts = [];
 		parts.push(this.buildSelectClause());
-		const quotedTable = this.dialect.quoteIdentifier(this.table);
+		const quotedTable = this.quoteTable(this.table);
 		const fromClause = this.alias ? `FROM ${quotedTable} AS ${this.dialect.quoteIdentifier(this.alias)}` : `FROM ${quotedTable}`;
 		parts.push(fromClause);
 		if (this.joinClauses.length > 0) parts.push(this.joinClauses.join(" "));
@@ -365,7 +365,7 @@ var PostgresQueryParser = class PostgresQueryParser {
 	*/
 	buildSelectClause() {
 		const distinct = this.isDistinct ? "DISTINCT " : "";
-		if (this.selectColumns.length === 0 && this.selectRaw.length === 0) return this.hasJoins ? `SELECT ${distinct}${this.dialect.quoteIdentifier(this.table)}.*` : `SELECT ${distinct}*`;
+		if (this.selectColumns.length === 0 && this.selectRaw.length === 0) return this.hasJoins ? `SELECT ${distinct}${this.quoteTable(this.table)}.*` : `SELECT ${distinct}*`;
 		const columns = [];
 		for (const col of this.selectColumns) if (!this.deselectColumns.includes(col)) columns.push(this.parseColumnIdentifier(col, this.table, this.alias));
 		columns.push(...this.selectRaw);
@@ -658,16 +658,16 @@ var PostgresQueryParser = class PostgresQueryParser {
 		const relationType = data.type;
 		const constraintOps = data.constraintOps;
 		const quotedAlias = this.dialect.quoteIdentifier(alias);
-		const quotedTable = this.dialect.quoteIdentifier(this.table);
+		const quotedTable = this.quoteTable(this.table);
 		if (!(this.selectColumns.length > 0) && !this.selectRaw.includes(`${quotedTable}.*`)) this.selectRaw.unshift(`${quotedTable}.*`);
 		if (relationType === "hasMany") {
 			const relatedTable = data.table;
 			const foreignKey = data.foreignKey;
 			const localKey = data.localKey;
-			const quotedRelatedTable = this.dialect.quoteIdentifier(relatedTable);
+			const quotedRelatedTable = this.quoteTable(relatedTable);
 			const quotedForeignKey = this.dialect.quoteIdentifier(foreignKey);
 			const quotedLocalKey = this.dialect.quoteIdentifier(localKey);
-			const quotedMainTable = this.dialect.quoteIdentifier(this.table);
+			const quotedMainTable = this.quoteTable(this.table);
 			let innerSelect;
 			if (select && select.length > 0) innerSelect = `json_agg(json_build_object(${select.map((col) => `'${escapeSqlLiteral(col)}', a.${this.dialect.quoteIdentifier(col)}`).join(", ")}))`;
 			else innerSelect = `json_agg(row_to_json(a.*))`;
@@ -679,6 +679,7 @@ var PostgresQueryParser = class PostgresQueryParser {
 				const subParser = new PostgresQueryParser({
 					table: relatedTable,
 					alias: "a",
+					dialect: this.dialect,
 					operations: constraintOps
 				});
 				subParser.parse();
@@ -696,6 +697,7 @@ var PostgresQueryParser = class PostgresQueryParser {
 				const subParser = new PostgresQueryParser({
 					table: data.table ?? alias,
 					alias,
+					dialect: this.dialect,
 					operations: constraintOps
 				});
 				subParser.parse();
@@ -723,7 +725,7 @@ var PostgresQueryParser = class PostgresQueryParser {
 		const foreignField = "foreignField" in options ? options.foreignField : "";
 		const alias = "alias" in options ? options.alias : void 0;
 		const constraintOps = data.constraintOps ?? [];
-		const quotedTable = this.dialect.quoteIdentifier(joinTable);
+		const quotedTable = this.quoteTable(joinTable);
 		const tableRef = alias ? `${quotedTable} AS ${this.dialect.quoteIdentifier(alias)}` : quotedTable;
 		const tableAlias = alias ?? joinTable;
 		this.joinedTables.add(joinTable);
@@ -735,6 +737,7 @@ var PostgresQueryParser = class PostgresQueryParser {
 				const subParser = new PostgresQueryParser({
 					table: joinTable,
 					alias: tableAlias,
+					dialect: this.dialect,
 					operations: whereOps
 				});
 				subParser.parse();
@@ -776,11 +779,11 @@ var PostgresQueryParser = class PostgresQueryParser {
 		const effectiveTable = tableAlias ?? defaultTable;
 		const parts = field.split(".");
 		let expression;
-		if (parts.length === 1) expression = `${this.dialect.quoteIdentifier(effectiveTable)}.${this.dialect.quoteIdentifier(field)}`;
+		if (parts.length === 1) expression = `${this.quoteTable(effectiveTable)}.${this.dialect.quoteIdentifier(field)}`;
 		else if (parts.length === 2) {
 			const [first, second] = parts;
 			if (first === void 0 || second === void 0) throw new Error(`Cannot parse field path "${field}": expected two non-empty segments.`);
-			if (this.isTableReference(first)) expression = `${this.dialect.quoteIdentifier(first)}.${this.dialect.quoteIdentifier(second)}`;
+			if (this.isTableReference(first)) expression = `${this.quoteTable(first)}.${this.dialect.quoteIdentifier(second)}`;
 			else expression = this.buildJsonbPath(effectiveTable, first, [second]);
 		} else {
 			const [first, second, ...rest] = parts;
@@ -802,6 +805,9 @@ var PostgresQueryParser = class PostgresQueryParser {
 		if (this.joinedTables.has(name)) return true;
 		return false;
 	}
+	quoteTable(table) {
+		return this.dialect instanceof PostgresDialect ? this.dialect.quoteTableIdentifier(table) : this.dialect.quoteIdentifier(table);
+	}
 	/**
 	* Build a JSONB path expression.
 	*
@@ -822,7 +828,7 @@ var PostgresQueryParser = class PostgresQueryParser {
 	* // Returns: "posts"."createdBy"->'address'->>'city'
 	*/
 	buildJsonbPath(table, column, path) {
-		const quotedTable = this.dialect.quoteIdentifier(table);
+		const quotedTable = this.quoteTable(table);
 		const quotedColumn = this.dialect.quoteIdentifier(column);
 		if (path.length === 0) return `${quotedTable}.${quotedColumn}`;
 		let expression = `${quotedTable}.${quotedColumn}`;
@@ -837,7 +843,7 @@ var PostgresQueryParser = class PostgresQueryParser {
 	*/
 	processCrossJoin(data) {
 		const table = data.table;
-		const quotedTable = this.dialect.quoteIdentifier(table);
+		const quotedTable = this.quoteTable(table);
 		this.joinClauses.push(`CROSS JOIN ${quotedTable}`);
 	}
 	/**

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

@@ -1 +1 @@
-{"version":3,"file":"postgres-query-parser.mjs","names":[],"sources":["../../../../../../../../cascade/src/drivers/postgres/postgres-query-parser.ts"],"sourcesContent":["/**\n * PostgreSQL Query Parser\n *\n * Translates Cascade query operations into PostgreSQL SQL queries.\n * Mirrors the MongoQueryParser pattern but generates SQL instead\n * of MongoDB aggregation pipelines.\n *\n * @module cascade/drivers/postgres\n */\n\nimport type {\n  DriverQuery,\n  JoinOptions,\n  WhereOperator,\n} from \"../../contracts/query-builder.contract\";\nimport type { SqlDialectContract } from \"../sql/sql-dialect.contract\";\n\nimport { escapeSqlLiteral, PostgresDialect } from \"./postgres-dialect\";\n\n/** Allowed `::cast` type names, e.g. `int`, `numeric(10,2)`, `text[]`. */\nconst SAFE_CAST_PATTERN = /^[a-z_][a-z0-9_ ]*(\\(\\d+(,\\d+)?\\))?(\\[\\])?$/i;\n\n/** Allowed orderBy direction, with optional NULLS placement. */\nconst SAFE_DIRECTION_PATTERN = /^(asc|desc)(\\s+nulls\\s+(first|last))?$/i;\n\n/**\n * Operation types supported by the query parser.\n */\nexport type PostgresOperationType =\n  // WHERE operations\n  | \"where\"\n  | \"orWhere\"\n  | \"whereRaw\"\n  | \"orWhereRaw\"\n  | \"whereIn\"\n  | \"whereNotIn\"\n  | \"whereNull\"\n  | \"whereNotNull\"\n  | \"whereBetween\"\n  | \"whereNotBetween\"\n  | \"orWhereIn\"\n  | \"orWhereNotIn\"\n  | \"orWhereNull\"\n  | \"orWhereNotNull\"\n  | \"orWhereBetween\"\n  | \"whereLike\"\n  | \"whereNotLike\"\n  | \"whereColumn\"\n  | \"orWhereColumn\"\n  | \"whereExists\"\n  | \"whereNotExists\"\n  | \"whereNot\"\n  | \"orWhereNot\"\n  | \"whereDate\"\n  | \"whereDateBefore\"\n  | \"whereDateAfter\"\n  | \"whereDateBetween\"\n  | \"whereJsonContains\"\n  | \"whereJsonDoesntContain\"\n  | \"whereFullText\"\n  // SELECT operations\n  | \"select\"\n  | \"selectRaw\"\n  | \"deselect\"\n  // JOIN operations\n  | \"join\"\n  | \"leftJoin\"\n  | \"rightJoin\"\n  | \"innerJoin\"\n  | \"fullJoin\"\n  | \"crossJoin\"\n  | \"joinRaw\"\n  // ORDER operations\n  | \"orderBy\"\n  | \"orderByRaw\"\n  // GROUP operations\n  | \"groupBy\"\n  | \"groupByRaw\"\n  | \"having\"\n  | \"havingRaw\"\n  // LIMIT operations\n  | \"limit\"\n  | \"offset\"\n  // Row locking\n  | \"lock\"\n  // RELATION operations\n  | \"has\"\n  | \"whereHas\"\n  | \"doesntHave\"\n  | \"whereDoesntHave\"\n  // joinWith operations\n  | \"selectRelatedColumns\"\n  // Builder-level metadata (consumed before parsing)\n  | \"joinWith\"\n  | \"cursor\"\n  // Other\n  | \"distinct\";\n\n/**\n * Internal operation representation.\n */\nexport type PostgresParserOperation = {\n  /** Operation type */\n  readonly type: PostgresOperationType;\n  /** Operation data/parameters */\n  readonly data: Record<string, unknown>;\n};\n\n/**\n * Parser configuration options.\n */\nexport type PostgresParserOptions = {\n  /** Target table name */\n  readonly table: string;\n  /** Table alias (optional) */\n  readonly alias?: string;\n  /** Operations to parse */\n  readonly operations: PostgresParserOperation[];\n  /** SQL dialect for syntax generation */\n  readonly dialect?: SqlDialectContract;\n  /** Factory for creating sub-parsers (for nested queries) */\n  readonly createSubParser?: (table: string) => PostgresQueryParser;\n};\n\n/**\n * PostgreSQL Query Parser.\n *\n * Converts a list of query operations into a SQL query string with parameters.\n * Handles SELECT, WHERE, JOIN, ORDER BY, GROUP BY, LIMIT/OFFSET clauses.\n *\n * @example\n * ```typescript\n * const parser = new PostgresQueryParser({\n *   table: 'users',\n *   operations: [\n *     { type: 'where', data: { field: 'name', operator: '=', value: 'Alice' } },\n *     { type: 'orderBy', data: { field: 'createdAt', direction: 'desc' } },\n *     { type: 'limit', data: { value: 10 } }\n *   ]\n * });\n *\n * const { sql, params } = parser.parse();\n * // sql: 'SELECT * FROM \"users\" WHERE \"name\" = $1 ORDER BY \"createdAt\" DESC LIMIT 10'\n * // params: ['Alice']\n * ```\n */\nexport class PostgresQueryParser {\n  /**\n   * Target table name.\n   */\n  private readonly table: string;\n\n  /**\n   * Table alias.\n   */\n  private readonly alias?: string;\n\n  /**\n   * Operations to process.\n   */\n  private readonly operations: PostgresParserOperation[];\n\n  /**\n   * SQL dialect for syntax.\n   */\n  private readonly dialect: SqlDialectContract;\n\n  /**\n   * Current parameter index (1-based for PostgreSQL).\n   */\n  private paramIndex = 1;\n\n  /**\n   * Collected parameters.\n   */\n  private readonly params: unknown[] = [];\n\n  /**\n   * SELECT columns.\n   */\n  public selectColumns: string[] = [];\n\n  /**\n   * Deselected (excluded) columns.\n   */\n  private deselectColumns: string[] = [];\n\n  /**\n   * Raw SELECT expressions.\n   */\n  private selectRaw: string[] = [];\n\n  /**\n   * WHERE clauses.\n   */\n  public whereClauses: string[] = [];\n\n  /**\n   * JOIN clauses.\n   */\n  private joinClauses: string[] = [];\n\n  /**\n   * ORDER BY clauses.\n   */\n  public orderClauses: string[] = [];\n\n  /**\n   * GROUP BY columns (bare identifiers — get quoted).\n   */\n  private groupColumns: string[] = [];\n\n  /**\n   * Raw GROUP BY expressions (emitted verbatim — e.g. a `date_trunc(...)`\n   * bucket). Kept separate from `groupColumns` so they bypass identifier\n   * quoting while still landing in the same `GROUP BY` clause.\n   */\n  private groupRawExpressions: string[] = [];\n\n  /**\n   * HAVING clauses.\n   */\n  private havingClauses: string[] = [];\n\n  /**\n   * LIMIT value.\n   */\n  public limitValue?: number;\n\n  /**\n   * OFFSET value.\n   */\n  public offsetValue?: number;\n\n  /**\n   * DISTINCT flag.\n   */\n  private isDistinct = false;\n\n  /**\n   * Row-locking clause (`FOR UPDATE [SKIP LOCKED | NOWAIT]`). Appended after\n   * LIMIT/OFFSET — the locking clause is last in PostgreSQL's SELECT grammar.\n   */\n  private lockClause = \"\";\n\n  /**\n   * Whether the query has any JOIN operations (pre-scanned before processing).\n   * Used by qualifyColumn() to decide whether to prefix columns with the main table.\n   */\n  private hasJoins = false;\n\n  /**\n   * Tracked joined tables (for table reference detection).\n   */\n  private readonly joinedTables = new Set<string>();\n\n  /**\n   * Create a new query parser.\n   *\n   * @param options - Parser configuration\n   */\n  public constructor(options: PostgresParserOptions) {\n    this.table = options.table;\n    this.alias = options.alias;\n    this.operations = options.operations;\n    this.dialect = options.dialect ?? new PostgresDialect();\n  }\n\n  /**\n   * Parse all operations and build the SQL query.\n   *\n   * @returns DriverQuery with `query` (SQL string) and `bindings` (parameter values)\n   */\n  public parse(): DriverQuery {\n    // Pre-scan for any join operations so qualifyColumn() can prefix columns\n    // correctly even when WHERE clauses appear before JOINs in the operations list.\n    const JOIN_TYPES = new Set([\n      \"join\",\n      \"leftJoin\",\n      \"rightJoin\",\n      \"innerJoin\",\n      \"fullJoin\",\n      \"crossJoin\",\n      \"joinRaw\",\n    ]);\n\n    this.hasJoins = false;\n\n    // First pass: locate all joins and populate joinedTables for accurate JSON path detection\n    for (const operation of this.operations) {\n      if (JOIN_TYPES.has(operation.type)) {\n        this.hasJoins = true;\n        const data = operation.data as any;\n        const joinTable = data.table as string;\n        const alias = data.alias as string;\n\n        if (joinTable) this.joinedTables.add(joinTable);\n        if (alias) this.joinedTables.add(alias);\n      }\n    }\n\n    // Process each operation\n    for (const operation of this.operations) {\n      this.processOperation(operation);\n    }\n\n    // Build the final SQL query\n    const query = this.buildSql();\n\n    return { query, bindings: this.params };\n  }\n\n  /**\n   * Get a formatted string representation of the query.\n   *\n   * @returns Formatted SQL with bindings\n   */\n  public toPrettyString(): string {\n    const { query = \"\", bindings } = this.parse();\n    return `${query}\\n-- Bindings: ${JSON.stringify(bindings ?? [])}`;\n  }\n\n  /**\n   * Process a single operation.\n   *\n   * @param operation - The operation to process\n   */\n  private processOperation(operation: PostgresParserOperation): void {\n    const { type, data } = operation;\n\n    switch (type) {\n      // WHERE operations\n      case \"where\":\n        this.processWhere(data, \"AND\");\n        break;\n      case \"orWhere\":\n        this.processWhere(data, \"OR\");\n        break;\n      case \"whereRaw\":\n        this.processWhereRaw(data, \"AND\");\n        break;\n      case \"orWhereRaw\":\n        this.processWhereRaw(data, \"OR\");\n        break;\n      case \"whereIn\":\n        this.processWhereIn(data, false);\n        break;\n      case \"whereNotIn\":\n        this.processWhereIn(data, true);\n        break;\n      case \"orWhereIn\":\n        this.processWhereIn(data, false, \"OR\");\n        break;\n      case \"orWhereNotIn\":\n        this.processWhereIn(data, true, \"OR\");\n        break;\n      case \"whereNull\":\n        this.processWhereNull(data, false);\n        break;\n      case \"whereNotNull\":\n        this.processWhereNull(data, true);\n        break;\n      case \"orWhereNull\":\n        this.processWhereNull(data, false, \"OR\");\n        break;\n      case \"orWhereNotNull\":\n        this.processWhereNull(data, true, \"OR\");\n        break;\n      case \"orWhereBetween\":\n        this.processWhereBetween(data, false, \"OR\");\n        break;\n      case \"whereBetween\":\n        this.processWhereBetween(data, false);\n        break;\n      case \"whereNotBetween\":\n        this.processWhereBetween(data, true);\n        break;\n      case \"whereLike\":\n        this.processWhereLike(data, false);\n        break;\n      case \"whereNotLike\":\n        this.processWhereLike(data, true);\n        break;\n      case \"whereColumn\":\n        this.processWhereColumn(data, \"AND\");\n        break;\n      case \"orWhereColumn\":\n        this.processWhereColumn(data, \"OR\");\n        break;\n      case \"whereJsonContains\":\n        this.processWhereJsonContains(data, false);\n        break;\n      case \"whereJsonDoesntContain\":\n        this.processWhereJsonContains(data, true);\n        break;\n      case \"whereFullText\":\n        this.processWhereFullText(data);\n        break;\n      case \"whereNot\":\n        this.processNested(data.nested, \"AND\", true, type);\n        break;\n      case \"orWhereNot\":\n        this.processNested(data.nested, \"OR\", true, type);\n        break;\n      // Same semantics as the Mongo driver: the callback conditions are applied\n      // inline (exists) or negated (notExists).\n      case \"whereExists\":\n        this.processNested(data.subquery, \"AND\", false, type);\n        break;\n      case \"whereNotExists\":\n        this.processNested(data.subquery, \"AND\", true, type);\n        break;\n      case \"whereDate\":\n        this.processWhereDate(data, \"=\");\n        break;\n      case \"whereDateBefore\":\n        this.processWhereDate(data, \"<\");\n        break;\n      case \"whereDateAfter\":\n        this.processWhereDate(data, \">\");\n        break;\n      case \"whereDateBetween\":\n        this.processWhereDateBetween(data);\n        break;\n\n      // SELECT operations\n      case \"select\":\n        this.processSelect(data);\n        break;\n      case \"selectRaw\":\n        this.processSelectRaw(data);\n        break;\n      case \"deselect\":\n        this.processDeselect(data);\n        break;\n\n      // JOIN operations\n      case \"join\":\n      case \"innerJoin\":\n        this.processJoin(data, \"INNER\");\n        break;\n      case \"leftJoin\":\n        this.processJoin(data, \"LEFT\");\n        break;\n      case \"rightJoin\":\n        this.processJoin(data, \"RIGHT\");\n        break;\n      case \"fullJoin\":\n        this.processJoin(data, \"FULL OUTER\");\n        break;\n      case \"crossJoin\":\n        this.processCrossJoin(data);\n        break;\n      case \"joinRaw\":\n        this.processJoinRaw(data);\n        break;\n\n      // ORDER operations\n      case \"orderBy\":\n        this.processOrderBy(data);\n        break;\n      case \"orderByRaw\":\n        this.processOrderByRaw(data);\n        break;\n\n      // GROUP operations\n      case \"groupBy\":\n        this.processGroupBy(data);\n        break;\n      case \"groupByRaw\":\n        this.processGroupByRaw(data);\n        break;\n      case \"having\":\n        this.processHaving(data);\n        break;\n      case \"havingRaw\":\n        this.processHavingRaw(data);\n        break;\n\n      // LIMIT operations\n      case \"limit\":\n        this.limitValue = data.value as number;\n        break;\n      case \"offset\":\n        this.offsetValue = data.value as number;\n        break;\n\n      // Row locking\n      case \"lock\": {\n        let clause = \"FOR UPDATE\";\n        if (data.skipLocked) {\n          clause += \" SKIP LOCKED\";\n        } else if (data.noWait) {\n          clause += \" NOWAIT\";\n        }\n        this.lockClause = clause;\n        break;\n      }\n\n      // Other\n      case \"distinct\":\n        this.isDistinct = true;\n        break;\n\n      // joinWith select related columns\n      case \"selectRelatedColumns\":\n        this.processSelectRelatedColumns(data);\n        break;\n\n      // Builder-level metadata consumed before parsing; carries no SQL of its own\n      case \"cursor\":\n      case \"joinWith\":\n        break;\n\n      default:\n        // An unknown filter must never silently disappear: write paths\n        // (delete/update) reuse this parser, so a dropped filter widens the\n        // statement to every row.\n        throw new Error(`PostgresQueryParser: unsupported operation type \"${type}\"`);\n    }\n  }\n\n  /**\n   * Build the final SQL query from collected clauses.\n   *\n   * @returns Complete SQL query string\n   */\n  private buildSql(): string {\n    const parts: string[] = [];\n\n    // SELECT clause\n    parts.push(this.buildSelectClause());\n\n    // FROM clause\n    const quotedTable = this.dialect.quoteIdentifier(this.table);\n    const fromClause = this.alias\n      ? `FROM ${quotedTable} AS ${this.dialect.quoteIdentifier(this.alias)}`\n      : `FROM ${quotedTable}`;\n    parts.push(fromClause);\n\n    // JOIN clauses\n    if (this.joinClauses.length > 0) {\n      parts.push(this.joinClauses.join(\" \"));\n    }\n\n    // WHERE clause\n    if (this.whereClauses.length > 0) {\n      parts.push(`WHERE ${this.whereClauses.join(\" \")}`);\n    }\n\n    // GROUP BY clause — bare columns are quoted; raw expressions (e.g.\n    // date_trunc buckets) are emitted verbatim. Both share one clause.\n    if (this.groupColumns.length > 0 || this.groupRawExpressions.length > 0) {\n      const quotedCols = this.groupColumns.map((c) => this.dialect.quoteIdentifier(c));\n      const allGroupTerms = [...quotedCols, ...this.groupRawExpressions];\n      parts.push(`GROUP BY ${allGroupTerms.join(\", \")}`);\n    }\n\n    // HAVING clause\n    if (this.havingClauses.length > 0) {\n      parts.push(`HAVING ${this.havingClauses.join(\" AND \")}`);\n    }\n\n    // ORDER BY clause\n    if (this.orderClauses.length > 0) {\n      parts.push(`ORDER BY ${this.orderClauses.join(\", \")}`);\n    }\n\n    // LIMIT/OFFSET\n    const limitOffset = this.dialect.limitOffset(this.limitValue, this.offsetValue);\n    if (limitOffset) {\n      parts.push(limitOffset);\n    }\n\n    // Row-locking clause — last in PostgreSQL's SELECT grammar\n    if (this.lockClause) {\n      parts.push(this.lockClause);\n    }\n\n    return parts.join(\" \");\n  }\n\n  /**\n   * Build the SELECT clause.\n   *\n   * @returns SELECT clause string\n   */\n  private buildSelectClause(): string {\n    const distinct = this.isDistinct ? \"DISTINCT \" : \"\";\n\n    // If no specific columns, select all — qualify with main table when joins present\n    if (this.selectColumns.length === 0 && this.selectRaw.length === 0) {\n      return this.hasJoins\n        ? `SELECT ${distinct}${this.dialect.quoteIdentifier(this.table)}.*`\n        : `SELECT ${distinct}*`;\n    }\n\n    const columns: string[] = [];\n\n    // Add selected columns — prefix with main table when joins present to avoid ambiguity\n    for (const col of this.selectColumns) {\n      if (!this.deselectColumns.includes(col)) {\n        columns.push(this.parseColumnIdentifier(col, this.table, this.alias));\n      }\n    }\n\n    // Add raw expressions\n    columns.push(...this.selectRaw);\n\n    return `SELECT ${distinct}${columns.join(\", \")}`;\n  }\n\n  /**\n   * Add a placeholder and parameter.\n   *\n   * @param value - Parameter value\n   * @returns Placeholder string ($1, $2, etc.)\n   */\n  private addParam(value: unknown): string {\n    this.params.push(value);\n    return this.dialect.placeholder(this.paramIndex++);\n  }\n\n  /**\n   * Absorb a sub-parser's params into this parser, returning a rewriter\n   * function that translates the sub-parser's `$N` placeholders into freshly\n   * numbered placeholders in this parser's namespace.\n   *\n   * Required whenever sub-parser SQL fragments (e.g. WHERE clauses produced\n   * for a `joinWith` constraint) are spliced into the outer query — without\n   * the rewrite the embedded `$N` references point at parameters this\n   * parser has no knowledge of, leaving them dangling in the final SQL.\n   *\n   * The sub-parser's `params[i]` corresponds to its `$(i+1)` placeholder\n   * (its `paramIndex` always starts at 1), so we map sequentially.\n   *\n   * @example\n   *   const renumber = this.absorbSubParserParams(subParser);\n   *   const fragment = renumber(subParser.whereClauses.join(\" \"));\n   */\n  private absorbSubParserParams(subParser: PostgresQueryParser): (sql: string) => string {\n    if (subParser.params.length === 0) {\n      return (sql) => sql;\n    }\n\n    const oldToNew = new Map<string, string>();\n\n    for (let index = 0; index < subParser.params.length; index++) {\n      const newPlaceholder = this.addParam(subParser.params[index]);\n      oldToNew.set(`$${index + 1}`, newPlaceholder);\n    }\n\n    return (sql) => sql.replace(/\\$\\d+/g, (match) => oldToNew.get(match) ?? match);\n  }\n\n  /**\n   * Process a basic WHERE operation.\n   *\n   * Delegates to specialised processors for operators that require more than a\n   * single placeholder (between, in, like-variants, exists, etc.).\n   */\n  private processWhere(data: Record<string, unknown>, boolean: \"AND\" | \"OR\"): void {\n    // `where(q => ...)` / `orWhere(q => ...)` record a nested group\n    if (data.nested !== undefined) {\n      return this.processNested(data.nested, boolean, false, \"where\");\n    }\n\n    const field = data.field as string;\n    const operator = (data.operator as WhereOperator) ?? \"=\";\n    const value = data.value;\n\n    // Delegate to specialised processors for operators that need it. The\n    // `boolean` connective is forwarded so `orWhere(f, \"in\", …)` stays an OR.\n    const range = value as [unknown, unknown];\n    const like = { field, pattern: value as string };\n\n    switch (operator) {\n      case \"between\":\n        return this.processWhereBetween({ field, range }, false, boolean);\n      case \"notBetween\":\n        return this.processWhereBetween({ field, range }, true, boolean);\n      case \"in\":\n        return this.processWhereIn({ field, values: value as unknown[] }, false, boolean);\n      case \"notIn\":\n        return this.processWhereIn({ field, values: value as unknown[] }, true, boolean);\n      case \"like\":\n      case \"ilike\":\n        return this.processWhereLike(like, false, boolean);\n      case \"startsWith\":\n      case \"endsWith\":\n        return this.processWhereLike(like, false, boolean, operator);\n      case \"notLike\":\n        return this.processWhereLike(like, true, boolean);\n      case \"notStartsWith\":\n        return this.processWhereLike(like, true, boolean, \"startsWith\");\n      case \"notEndsWith\":\n        return this.processWhereLike(like, true, boolean, \"endsWith\");\n      case \"exists\":\n        // Raw strings are never inlined into SQL (injection); a sub-query must\n        // arrive as an already-parameterised builder, not text.\n        throw new Error(\n          'PostgresQueryParser: where(field, \"exists\", value) does not accept a raw SQL string; use a query builder or callback',\n        );\n    }\n\n    const quotedField = this.parseColumnIdentifier(field, this.table, this.alias);\n\n    if (value === null) {\n      const nullOperator = operator === \"!=\" ? \"IS NOT NULL\" : \"IS NULL\";\n      return this.addWhereClause(`${quotedField} ${nullOperator}`, boolean);\n    }\n\n    // Simple single-value operator — fall through to generic path\n    const placeholder = this.addParam(value);\n    this.addWhereClause(`${quotedField} ${this.mapOperator(operator)} ${placeholder}`, boolean);\n  }\n\n  /**\n   * Process a nested group of operations as `(<group>)` / `NOT (<group>)`.\n   *\n   * The group is parsed by a sub-parser; its params are renumbered into this\n   * parser's namespace.\n   */\n  private processNested(\n    nested: unknown,\n    boolean: \"AND\" | \"OR\",\n    negate: boolean,\n    opType: string,\n  ): void {\n    const subParser = new PostgresQueryParser({\n      table: this.table,\n      alias: this.alias,\n      dialect: this.dialect,\n      operations: (nested as PostgresParserOperation[] | undefined) ?? [],\n    });\n    subParser.parse();\n\n    if (subParser.whereClauses.length === 0) {\n      throw new Error(`PostgresQueryParser: \"${opType}\" received an empty condition group`);\n    }\n\n    const renumber = this.absorbSubParserParams(subParser);\n    const group = `(${renumber(subParser.whereClauses.join(\" \"))})`;\n\n    this.addWhereClause(negate ? `NOT ${group}` : group, boolean);\n  }\n\n  /**\n   * Compare the date portion of a column (time ignored).\n   */\n  private processWhereDate(data: Record<string, unknown>, operator: string): void {\n    const quotedField = this.parseColumnIdentifier(data.field as string, this.table, this.alias);\n    const placeholder = this.addParam(data.value);\n\n    this.addWhereClause(`${quotedField}::date ${operator} ${placeholder}::date`, \"AND\");\n  }\n\n  /**\n   * Date portion of a column within an inclusive [from, to] range.\n   */\n  private processWhereDateBetween(data: Record<string, unknown>): void {\n    const range = data.range as [unknown, unknown];\n    const quotedField = this.parseColumnIdentifier(data.field as string, this.table, this.alias);\n    const from = this.addParam(range[0]);\n    const to = this.addParam(range[1]);\n\n    this.addWhereClause(`${quotedField}::date BETWEEN ${from}::date AND ${to}::date`, \"AND\");\n  }\n\n  /**\n   * Process a raw WHERE operation.\n   */\n  private processWhereRaw(data: Record<string, unknown>, boolean: \"AND\" | \"OR\"): void {\n    const expression = data.expression as string;\n    const bindings = (data.bindings as unknown[]) ?? [];\n\n    // Replace ? placeholders with $n\n    let processed = expression;\n    for (const binding of bindings) {\n      processed = processed.replace(\"?\", this.addParam(binding));\n    }\n\n    this.addWhereClause(processed, boolean);\n  }\n\n  /**\n   * Process WHERE IN / NOT IN.\n   */\n  private processWhereIn(\n    data: Record<string, unknown>,\n    negate: boolean,\n    boolean: \"AND\" | \"OR\" = \"AND\",\n  ): void {\n    const field = data.field as string;\n    const values = data.values as unknown[];\n\n    const quotedField = this.parseColumnIdentifier(field, this.table, this.alias);\n    const operator = negate ? \"!= ALL\" : \"= ANY\";\n    const placeholder = this.addParam(values);\n\n    this.addWhereClause(`${quotedField} ${operator}(${placeholder})`, boolean);\n  }\n\n  /**\n   * Process WHERE NULL / NOT NULL.\n   */\n  private processWhereNull(\n    data: Record<string, unknown>,\n    negate: boolean,\n    boolean: \"AND\" | \"OR\" = \"AND\",\n  ): void {\n    const field = data.field as string;\n    const quotedField = this.parseColumnIdentifier(field, this.table, this.alias);\n    const clause = negate ? `${quotedField} IS NOT NULL` : `${quotedField} IS NULL`;\n    this.addWhereClause(clause, boolean);\n  }\n\n  /**\n   * Process WHERE BETWEEN / NOT BETWEEN.\n   */\n  private processWhereBetween(\n    data: Record<string, unknown>,\n    negate: boolean,\n    boolean: \"AND\" | \"OR\" = \"AND\",\n  ): void {\n    const field = data.field as string;\n    const range = data.range as [unknown, unknown];\n\n    const quotedField = this.parseColumnIdentifier(field, this.table, this.alias);\n    const placeholder1 = this.addParam(range[0]);\n    const placeholder2 = this.addParam(range[1]);\n    const keyword = negate ? \"NOT BETWEEN\" : \"BETWEEN\";\n\n    this.addWhereClause(`${quotedField} ${keyword} ${placeholder1} AND ${placeholder2}`, boolean);\n  }\n\n  /**\n   * Process WHERE LIKE / NOT LIKE.\n   *\n   * Cross-driver semantics (matches MongoDB): `%` is the only wildcard, `_`\n   * and backslash are literal, and a pattern with no `%` matches as a\n   * substring. `startsWith` / `endsWith` anchor the escaped text explicitly.\n   * A `RegExp` has no SQL equivalent and is rejected.\n   */\n  private processWhereLike(\n    data: Record<string, unknown>,\n    negate: boolean,\n    boolean: \"AND\" | \"OR\" = \"AND\",\n    modeArg?: \"startsWith\" | \"endsWith\",\n  ): void {\n    const field = data.field as string;\n    const mode = modeArg ?? (data.mode as \"startsWith\" | \"endsWith\" | undefined);\n\n    // A RegExp maps to the POSIX case-insensitive match operators\n    if (data.isRegExp === true || (data.pattern as unknown) instanceof RegExp) {\n      const source =\n        (data.pattern as unknown) instanceof RegExp\n          ? (data.pattern as unknown as RegExp).source\n          : String(data.pattern);\n      const regexField = this.parseColumnIdentifier(field, this.table, this.alias);\n      const regexPlaceholder = this.addParam(source);\n\n      return this.addWhereClause(\n        `${regexField} ${negate ? \"!~*\" : \"~*\"} ${regexPlaceholder}`,\n        boolean,\n      );\n    }\n    // Mode ops carry the raw user value; `pattern` is only the display shape\n    const pattern = String(mode && data.value !== undefined ? data.value : data.pattern);\n\n    const quotedField = this.parseColumnIdentifier(field, this.table, this.alias);\n    const { operator } = this.dialect.likePattern(pattern, true);\n    // Escape `\\` and `_` (literal). `%` stays the wildcard of a plain LIKE\n    // pattern, but startsWith / endsWith values are literal text, so it is\n    // escaped there too.\n    let escaped = pattern.replace(/\\\\/g, \"\\\\\\\\\").replace(/_/g, \"\\\\_\");\n\n    if (mode) {\n      escaped = escaped.replace(/%/g, \"\\\\%\");\n    }\n\n    let finalPattern = escaped;\n\n    if (mode === \"startsWith\") {\n      finalPattern = `${escaped}%`;\n    } else if (mode === \"endsWith\") {\n      finalPattern = `%${escaped}`;\n    } else if (!escaped.includes(\"%\")) {\n      finalPattern = `%${escaped}%`;\n    }\n\n    const placeholder = this.addParam(finalPattern);\n    const keyword = negate ? `NOT ${operator}` : operator;\n\n    // Mode variants state the escape character explicitly\n    const escapeClause = mode ? \" ESCAPE '\\\\'\" : \"\";\n\n    this.addWhereClause(`${quotedField} ${keyword} ${placeholder}${escapeClause}`, boolean);\n  }\n\n  /**\n   * Process WHERE column comparison.\n   */\n  private processWhereColumn(data: Record<string, unknown>, boolean: \"AND\" | \"OR\"): void {\n    const first = data.first as string;\n    const operator = this.mapOperator(((data.operator as string) ?? \"=\") as WhereOperator);\n    const second = data.second as string;\n\n    // Both sides may need qualification if unambiguous table is unclear\n    const quotedFirst = this.parseColumnIdentifier(first, this.table, this.alias);\n    const quotedSecond = this.parseColumnIdentifier(second, this.table, this.alias);\n\n    this.addWhereClause(`${quotedFirst} ${operator} ${quotedSecond}`, boolean);\n  }\n\n  /**\n   * Process WHERE JSON contains.\n   */\n  private processWhereJsonContains(data: Record<string, unknown>, negate: boolean): void {\n    const path = data.path as string;\n    const value = data.value;\n\n    const quotedPath = this.parseColumnIdentifier(path, this.table, this.alias);\n    const operator = negate ? \"NOT @>\" : \"@>\";\n    const placeholder = this.addParam(JSON.stringify(value));\n\n    this.addWhereClause(`${quotedPath} ${operator} ${placeholder}::jsonb`, \"AND\");\n  }\n\n  /** Text search config name; anything but a plain identifier falls back to english. */\n  private safeLanguage(language: unknown): string {\n    return typeof language === \"string\" && /^[a-z_]+$/i.test(language) ? language : \"english\";\n  }\n\n  /**\n   * Process full-text search WHERE.\n   */\n  private processWhereFullText(data: Record<string, unknown>): void {\n    const fields = data.fields as string[];\n    const query = data.query as string;\n    const language = this.safeLanguage(data.language);\n    const weights = (data.weights as Record<string, string> | undefined) ?? {};\n\n    // Same expression as `createFullTextIndex`, so the GIN index is used and a\n    // NULL column doesn't null the whole vector.\n    const tsVectors = fields\n      .map((f) => {\n        const weight = /^[A-D]$/.test(weights[f] ?? \"\") ? weights[f] : \"A\";\n\n        return `setweight(to_tsvector('${language}', COALESCE(${this.dialect.quoteIdentifier(f)}, '')), '${weight}')`;\n      })\n      .join(\" || \");\n\n    const placeholder = this.addParam(query);\n    this.addWhereClause(`(${tsVectors}) @@ plainto_tsquery('${language}', ${placeholder})`, \"AND\");\n  }\n\n  /**\n   * Process SELECT operation.\n   */\n  private processSelect(data: Record<string, unknown>): void {\n    const fields = data.fields as string[] | Record<string, string>;\n\n    if (Array.isArray(fields)) {\n      this.selectColumns.push(...fields);\n    } else {\n      // Handle aliases: { field: 'alias' }\n      for (const [field, alias] of Object.entries(fields)) {\n        const quotedField = this.dialect.quoteIdentifier(field);\n        const quotedAlias = this.dialect.quoteIdentifier(alias);\n        this.selectRaw.push(`${quotedField} AS ${quotedAlias}`);\n      }\n    }\n  }\n\n  /**\n   * Process raw SELECT expression.\n   */\n  private processSelectRaw(data: Record<string, unknown>): void {\n    const expression = data.expression as string | Record<string, unknown>;\n    const bindings = (data.bindings as unknown[]) ?? [];\n\n    if (typeof expression === \"string\") {\n      // Replace ? placeholders with $n positional params (same as processWhereRaw)\n      let processed = expression;\n      for (const binding of bindings) {\n        processed = processed.replace(\"?\", this.addParam(binding));\n      }\n      this.selectRaw.push(processed);\n    } else {\n      // Handle object expressions (for compatibility)\n      for (const [alias, expr] of Object.entries(expression)) {\n        this.selectRaw.push(`${expr} AS ${this.dialect.quoteIdentifier(alias)}`);\n      }\n    }\n  }\n\n  /**\n   * Process DESELECT operation.\n   */\n  private processDeselect(data: Record<string, unknown>): void {\n    const fields = data.fields as string[];\n    this.deselectColumns.push(...fields);\n  }\n\n  /**\n   * Process SELECT for related columns (joinWith).\n   *\n   * - hasOne / belongsTo  → LEFT JOIN + row_to_json  (single object)\n   * - hasMany             → correlated subquery with json_agg (array, no row explosion)\n   *\n   * @example hasMany correlated subquery:\n   *   (SELECT json_agg(row_to_json(a.*))\n   *    FROM \"chat_message_actions\" a\n   *    WHERE a.\"chat_message_id\" = \"chat_messages\".\"id\") AS \"actions\"\n   *\n   * @example hasOne/belongsTo row_to_json:\n   *   row_to_json(\"organizationAiModel\".*) AS \"organizationAiModel\"\n   */\n  private processSelectRelatedColumns(data: Record<string, unknown>): void {\n    const alias = data.alias as string;\n    const select = data.select as string[] | undefined;\n    const relationType = data.type as string | undefined;\n    const constraintOps = data.constraintOps as PostgresParserOperation[] | undefined;\n    const quotedAlias = this.dialect.quoteIdentifier(alias);\n    const quotedTable = this.dialect.quoteIdentifier(this.table);\n\n    const hasExplicitSelect = this.selectColumns.length > 0;\n    if (!hasExplicitSelect && !this.selectRaw.includes(`${quotedTable}.*`)) {\n      this.selectRaw.unshift(`${quotedTable}.*`);\n    }\n\n    if (relationType === \"hasMany\") {\n      // Correlated subquery — no JOIN, no row explosion, returns a JSON array.\n      const relatedTable = data.table as string;\n      const foreignKey = data.foreignKey as string;\n      const localKey = data.localKey as string;\n      const quotedRelatedTable = this.dialect.quoteIdentifier(relatedTable);\n      const quotedForeignKey = this.dialect.quoteIdentifier(foreignKey);\n      const quotedLocalKey = this.dialect.quoteIdentifier(localKey);\n      const quotedMainTable = this.dialect.quoteIdentifier(this.table);\n\n      let innerSelect: string;\n      if (select && select.length > 0) {\n        // Pick specific columns: json_agg(json_build_object('id', a.\"id\", ...))\n        const fields = select\n          .map((col) => `'${escapeSqlLiteral(col)}', a.${this.dialect.quoteIdentifier(col)}`)\n          .join(\", \");\n        innerSelect = `json_agg(json_build_object(${fields}))`;\n      } else {\n        innerSelect = `json_agg(row_to_json(a.*))`;\n      }\n\n      // Build the base FK condition\n      const fkCondition = `a.${quotedForeignKey} = ${quotedMainTable}.${quotedLocalKey}`;\n\n      // Merge constraint ops (where / order / limit) from a sub-parser.\n      // The sub-parser numbers its own placeholders starting at $1; we must\n      // absorb its params into this parser and renumber the embedded SQL,\n      // otherwise $N references in the merged clauses dangle.\n      let extraWhere = \"\";\n      let orderBy = \"\";\n      let limitClause = \"\";\n\n      if (constraintOps && constraintOps.length > 0) {\n        const subParser = new PostgresQueryParser({\n          table: relatedTable,\n          alias: \"a\",\n          operations: constraintOps,\n        });\n        subParser.parse();\n\n        const renumber = this.absorbSubParserParams(subParser);\n\n        if (subParser.whereClauses.length > 0) {\n          extraWhere = ` AND ${renumber(subParser.whereClauses.join(\" \"))}`;\n        }\n        if (subParser.orderClauses.length > 0) {\n          orderBy = ` ORDER BY ${renumber(subParser.orderClauses.join(\", \"))}`;\n        }\n        if (subParser.limitValue !== undefined) {\n          limitClause = ` ${this.dialect.limitOffset(subParser.limitValue)}`;\n        }\n      }\n\n      // Wrap with ORDER/LIMIT only when constraints are present (json_agg ignores ORDER)\n      const innerQuery =\n        orderBy || limitClause\n          ? `SELECT row_to_json(sub.*) FROM (SELECT * FROM ${quotedRelatedTable} a WHERE ${fkCondition}${extraWhere}${orderBy}${limitClause}) sub`\n          : `SELECT ${innerSelect.replace(\"json_agg(\", \"\").replace(/\\)$/, \"\")} FROM ${quotedRelatedTable} a WHERE ${fkCondition}${extraWhere}`;\n\n      const aggregated =\n        orderBy || limitClause\n          ? `(SELECT json_agg(row_to_json(sub.*)) FROM (SELECT * FROM ${quotedRelatedTable} a WHERE ${fkCondition}${extraWhere}${orderBy}${limitClause}) sub) AS ${quotedAlias}`\n          : `(SELECT ${innerSelect} FROM ${quotedRelatedTable} a WHERE ${fkCondition}${extraWhere}) AS ${quotedAlias}`;\n\n      this.selectRaw.push(aggregated);\n    } else {\n      // hasOne / belongsTo — single object via LEFT JOIN + row_to_json.\n      // If constraint provides an explicit select list, prefer it over data.select\n      let effectiveSelect = select;\n      if (constraintOps && constraintOps.length > 0) {\n        const subParser = new PostgresQueryParser({\n          table: (data.table as string) ?? alias,\n          alias,\n          operations: constraintOps,\n        });\n        subParser.parse();\n        if (subParser.selectColumns.length > 0) {\n          effectiveSelect = subParser.selectColumns;\n        }\n      }\n\n      if (effectiveSelect && effectiveSelect.length > 0) {\n        const selectedColumns = effectiveSelect\n          .map((col) => `${quotedAlias}.${this.dialect.quoteIdentifier(col)}`)\n          .join(\", \");\n        this.selectRaw.push(\n          `row_to_json((SELECT d FROM (SELECT ${selectedColumns}) d)) AS ${quotedAlias}`,\n        );\n      } else {\n        this.selectRaw.push(`row_to_json(${quotedAlias}.*) AS ${quotedAlias}`);\n      }\n    }\n  }\n\n  /**\n   * Process JOIN operation with smart field detection.\n   *\n   * Handles both regular columns and JSONB nested paths:\n   * - \"id\" → \"table\".\"id\" (auto-prefixed)\n   * - \"users.id\" → \"users\".\"id\" (explicit table)\n   * - \"createdBy.id\" → \"table\".\"createdBy\"->>'id' (JSONB path)\n   * - \"posts.createdBy.id\" → \"posts\".\"createdBy\"->>'id' (JSONB with table)\n   */\n  private processJoin(data: Record<string, unknown>, type: string): void {\n    const options = data as unknown as\n      | JoinOptions\n      | { table: string; localField: string; foreignField: string };\n\n    const joinTable = \"table\" in options ? options.table : \"\";\n    const localField = \"localField\" in options ? options.localField : \"\";\n    const foreignField = \"foreignField\" in options ? options.foreignField : \"\";\n    const alias = \"alias\" in options ? options.alias : undefined;\n    const constraintOps = (data.constraintOps as PostgresParserOperation[] | undefined) ?? [];\n\n    const quotedTable = this.dialect.quoteIdentifier(joinTable);\n    const tableRef = alias\n      ? `${quotedTable} AS ${this.dialect.quoteIdentifier(alias)}`\n      : quotedTable;\n    const tableAlias = alias ?? joinTable;\n\n    // Track the joined table for reference detection\n    this.joinedTables.add(joinTable);\n    if (alias) {\n      this.joinedTables.add(alias);\n    }\n\n    // Parse local field (belongs to main table)\n    const quotedLocal = this.parseColumnIdentifier(localField!, this.table, this.alias);\n\n    // Parse foreign field (belongs to join table)\n    const quotedForeign = this.parseColumnIdentifier(foreignField!, joinTable, tableAlias);\n\n    // Build the basic ON condition. For hasOne/belongsTo joinWith with a\n    // constraint callback, append the constraint's where-clauses to the ON\n    // clause (preserves LEFT JOIN semantics — main rows stay even when no\n    // related row passes the constraint). orderBy/limit on the constraint\n    // are silently dropped — they have no meaning on a single-row LEFT JOIN.\n    let onClause = `${quotedLocal} = ${quotedForeign}`;\n\n    if (constraintOps.length > 0) {\n      const whereOps = constraintOps.filter(\n        (op) => op.type.startsWith(\"where\") || op.type.startsWith(\"orWhere\"),\n      );\n\n      if (whereOps.length > 0) {\n        const subParser = new PostgresQueryParser({\n          table: joinTable,\n          alias: tableAlias,\n          operations: whereOps,\n        });\n        subParser.parse();\n\n        if (subParser.whereClauses.length > 0) {\n          const renumber = this.absorbSubParserParams(subParser);\n          onClause = `${onClause} AND ${renumber(subParser.whereClauses.join(\" \"))}`;\n        }\n      }\n    }\n\n    this.joinClauses.push(`${type} JOIN ${tableRef} ON ${onClause}`);\n  }\n\n  /**\n   * Parse a column identifier with smart detection for table prefixes and JSONB paths.\n   *\n   * Supports an optional explicit cast suffix using PostgreSQL's `::type` syntax,\n   * which is the only way to coerce a JSONB-extracted value (always returned as\n   * `text`) into another type. The parser does NOT infer casts from key names —\n   * coercion is always opt-in by the caller.\n   *\n   * @param field - The field string. Examples:\n   *   - \"id\"                       → `\"table\".\"id\"`\n   *   - \"users.id\"                 → `\"users\".\"id\"`\n   *   - \"createdBy.id\"             → `\"table\".\"createdBy\"->>'id'`\n   *   - \"createdBy.id::int\"        → `(\"table\".\"createdBy\"->>'id')::int`\n   *   - \"meta.score::numeric\"      → `(\"table\".\"meta\"->>'score')::numeric`\n   *   - \"posts.createdBy.id::uuid\" → `(\"posts\".\"createdBy\"->>'id')::uuid`\n   * @param defaultTable - Default table to use if no prefix\n   * @param tableAlias - Table alias to use if provided\n   * @returns Properly quoted SQL expression\n   */\n  private parseColumnIdentifier(field: string, defaultTable: string, tableAlias?: string): string {\n    if (!field) return \"\";\n\n    // Extract optional explicit cast suffix: \"createdBy.id::int\" → path \"createdBy.id\", cast \"int\"\n    let cast: string | undefined;\n    const castIndex = field.indexOf(\"::\");\n    if (castIndex !== -1) {\n      cast = field.slice(castIndex + 2).trim();\n      field = field.slice(0, castIndex);\n    }\n\n    const effectiveTable = tableAlias ?? defaultTable;\n    const parts = field.split(\".\");\n\n    let expression: string;\n\n    if (parts.length === 1) {\n      // Single part: just a column name, prefix with default table\n      expression = `${this.dialect.quoteIdentifier(effectiveTable)}.${this.dialect.quoteIdentifier(field)}`;\n    } else if (parts.length === 2) {\n      // Two parts: could be \"table.column\" or \"jsonbColumn.key\"\n      const [first, second] = parts;\n\n      // `parts.length === 2` above guarantees both, but the compiler does not\n      // narrow a destructured element from a length check. Throwing rather\n      // than defaulting to \"\": every branch below feeds `quoteIdentifier` or a\n      // JSONB path, so an empty segment would emit SYNTACTICALLY VALID SQL\n      // against the wrong identifier — a query that silently returns the wrong\n      // rows is far worse than one that refuses to build.\n      if (first === undefined || second === undefined) {\n        throw new Error(`Cannot parse field path \"${field}\": expected two non-empty segments.`);\n      }\n\n      if (this.isTableReference(first)) {\n        // It's table.column - regular column reference\n        expression = `${this.dialect.quoteIdentifier(first)}.${this.dialect.quoteIdentifier(second)}`;\n      } else {\n        // It's jsonbColumn.key - JSONB path\n        expression = this.buildJsonbPath(effectiveTable, first, [second]);\n      }\n    } else {\n      // Three or more parts: \"table.jsonbColumn.key...\" or \"jsonbColumn.key1.key2...\"\n      const [first, second, ...rest] = parts;\n\n      // Same reasoning as the two-part branch: this arm runs only for three or\n      // more parts, so both exist — and an empty identifier reaching the SQL\n      // is a wrong-rows bug, not a crash.\n      if (first === undefined || second === undefined) {\n        throw new Error(\n          `Cannot parse field path \"${field}\": expected at least three non-empty segments.`,\n        );\n      }\n\n      if (this.isTableReference(first)) {\n        // First part is table: \"posts.createdBy.id\" → table is \"posts\", JSONB is \"createdBy.id\"\n        expression = this.buildJsonbPath(first, second, rest);\n      } else {\n        // No table prefix: \"createdBy.address.city\" → use default table\n        expression = this.buildJsonbPath(effectiveTable, first, [second, ...rest]);\n      }\n    }\n\n    if (cast) {\n      if (!SAFE_CAST_PATTERN.test(cast)) {\n        throw new Error(`PostgresQueryParser: unsafe cast type \"${cast}\"`);\n      }\n\n      return `(${expression})::${cast}`;\n    }\n\n    return expression;\n  }\n\n  /**\n   * Check if a string is a table reference (main table or join table).\n   */\n  private isTableReference(name: string): boolean {\n    if (name === this.table || name === this.alias) {\n      return true;\n    }\n\n    if (this.joinedTables.has(name)) {\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Build a JSONB path expression.\n   *\n   * @param table - Table name\n   * @param column - JSONB column name\n   * @param path - Array of nested keys\n   * @returns PostgreSQL JSONB path expression\n   *\n   * Returns the raw JSONB path expression — extracted values are always `text`\n   * (`->>` returns text). Callers that need a different type must request an\n   * explicit cast via the `::type` suffix in `parseColumnIdentifier`.\n   *\n   * @example\n   * buildJsonbPath(\"posts\", \"createdBy\", [\"id\"])\n   * // Returns: \"posts\".\"createdBy\"->>'id'\n   *\n   * buildJsonbPath(\"posts\", \"createdBy\", [\"address\", \"city\"])\n   * // Returns: \"posts\".\"createdBy\"->'address'->>'city'\n   */\n  private buildJsonbPath(table: string, column: string, path: string[]): string {\n    const quotedTable = this.dialect.quoteIdentifier(table);\n    const quotedColumn = this.dialect.quoteIdentifier(column);\n\n    if (path.length === 0) {\n      return `${quotedTable}.${quotedColumn}`;\n    }\n\n    // Build JSONB path: use -> for intermediate keys, ->> for final key (returns text)\n    let expression = `${quotedTable}.${quotedColumn}`;\n\n    for (let i = 0; i < path.length; i++) {\n      const isLast = i === path.length - 1;\n      const operator = isLast ? \"->>\" : \"->\";\n      expression += `${operator}'${escapeSqlLiteral(path[i] as string)}'`;\n    }\n\n    return expression;\n  }\n\n  /**\n   * Process CROSS JOIN operation.\n   */\n  private processCrossJoin(data: Record<string, unknown>): void {\n    const table = data.table as string;\n    const quotedTable = this.dialect.quoteIdentifier(table);\n    this.joinClauses.push(`CROSS JOIN ${quotedTable}`);\n  }\n\n  /**\n   * Process raw JOIN expression.\n   */\n  private processJoinRaw(data: Record<string, unknown>): void {\n    const expression = data.expression as string;\n    const bindings = (data.bindings as unknown[]) ?? [];\n\n    let processed = expression;\n    for (const binding of bindings) {\n      processed = processed.replace(\"?\", this.addParam(binding));\n    }\n\n    this.joinClauses.push(processed);\n  }\n\n  /**\n   * Process ORDER BY operation.\n   */\n  private processOrderBy(data: Record<string, unknown>): void {\n    const field = data.field as string;\n    const rawDirection = String(data.direction ?? \"asc\").trim();\n\n    if (!SAFE_DIRECTION_PATTERN.test(rawDirection)) {\n      throw new Error(`PostgresQueryParser: invalid orderBy direction \"${rawDirection}\"`);\n    }\n\n    const direction = rawDirection.replace(/\\s+/g, \" \").toUpperCase();\n\n    const quotedField = this.parseColumnIdentifier(field, this.table, this.alias);\n    this.orderClauses.push(`${quotedField} ${direction}`);\n  }\n\n  /**\n   * Process raw ORDER BY expression.\n   */\n  private processOrderByRaw(data: Record<string, unknown>): void {\n    const expression = data.expression as string;\n    const bindings = (data.bindings as unknown[]) ?? [];\n\n    // Replace ? placeholders with $n positional params (same as processWhereRaw)\n    let processed = expression;\n    for (const binding of bindings) {\n      processed = processed.replace(\"?\", this.addParam(binding));\n    }\n    this.orderClauses.push(processed);\n  }\n\n  /**\n   * Process GROUP BY operation.\n   */\n  private processGroupBy(data: Record<string, unknown>): void {\n    const fields = data.fields as string | string[];\n    const columns = Array.isArray(fields) ? fields : [fields];\n    this.groupColumns.push(...columns);\n  }\n\n  /**\n   * Process a raw GROUP BY expression (emitted verbatim, no quoting). Used by\n   * `groupByDate` to add a `date_trunc(...)` bucket to the GROUP BY clause.\n   */\n  private processGroupByRaw(data: Record<string, unknown>): void {\n    const expression = data.expression as string;\n    this.groupRawExpressions.push(expression);\n  }\n\n  /**\n   * Process HAVING operation.\n   */\n  private processHaving(data: Record<string, unknown>): void {\n    const field = data.field as string;\n    const operator = this.mapOperator(((data.operator as string) ?? \"=\") as WhereOperator);\n    const value = data.value;\n\n    const quotedField = this.dialect.quoteIdentifier(field);\n    const placeholder = this.addParam(value);\n\n    this.havingClauses.push(`${quotedField} ${operator} ${placeholder}`);\n  }\n\n  /**\n   * Process a raw HAVING expression, threading `?` placeholders into\n   * positional params the same way `processWhereRaw` / `processSelectRaw` do.\n   * Without this, bindings on a `havingRaw` op are silently dropped.\n   */\n  private processHavingRaw(data: Record<string, unknown>): void {\n    let expression = data.expression as string;\n    const bindings = (data.bindings as unknown[]) ?? [];\n\n    for (const binding of bindings) {\n      expression = expression.replace(\"?\", this.addParam(binding));\n    }\n\n    this.havingClauses.push(expression);\n  }\n\n  /**\n   * Add a WHERE clause with boolean operator.\n   */\n  private addWhereClause(clause: string, boolean: \"AND\" | \"OR\"): void {\n    if (this.whereClauses.length === 0) {\n      this.whereClauses.push(clause);\n    } else {\n      this.whereClauses.push(`${boolean} ${clause}`);\n    }\n  }\n\n  /**\n   * Map simple Cascade operators to their SQL equivalents.\n   *\n   * Complex operators (between, in, like-variants, exists) are handled by\n   * dedicated processors and should never reach this method.\n   */\n  private mapOperator(operator: WhereOperator): string {\n    const mapping: Record<string, string> = {\n      \"=\": \"=\",\n      \"!=\": \"!=\",\n      \"<>\": \"<>\",\n      \">\": \">\",\n      \">=\": \">=\",\n      \"<\": \"<\",\n      \"<=\": \"<=\",\n      like: \"LIKE\",\n      notlike: \"NOT LIKE\",\n      ilike: \"ILIKE\",\n    };\n\n    const mapped = mapping[String(operator).toLowerCase()];\n\n    if (mapped === undefined) {\n      throw new Error(`PostgresQueryParser: unsupported operator \"${operator}\"`);\n    }\n\n    return mapped;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"postgres-query-parser.mjs","names":[],"sources":["../../../../../../../../cascade/src/drivers/postgres/postgres-query-parser.ts"],"sourcesContent":["/**\n * PostgreSQL Query Parser\n *\n * Translates Cascade query operations into PostgreSQL SQL queries.\n * Mirrors the MongoQueryParser pattern but generates SQL instead\n * of MongoDB aggregation pipelines.\n *\n * @module cascade/drivers/postgres\n */\n\nimport type {\n  DriverQuery,\n  JoinOptions,\n  WhereOperator,\n} from \"../../contracts/query-builder.contract\";\nimport type { SqlDialectContract } from \"../sql/sql-dialect.contract\";\n\nimport { escapeSqlLiteral, PostgresDialect } from \"./postgres-dialect\";\n\n/** Allowed `::cast` type names, e.g. `int`, `numeric(10,2)`, `text[]`. */\nconst SAFE_CAST_PATTERN = /^[a-z_][a-z0-9_ ]*(\\(\\d+(,\\d+)?\\))?(\\[\\])?$/i;\n\n/** Allowed orderBy direction, with optional NULLS placement. */\nconst SAFE_DIRECTION_PATTERN = /^(asc|desc)(\\s+nulls\\s+(first|last))?$/i;\n\n/**\n * Operation types supported by the query parser.\n */\nexport type PostgresOperationType =\n  // WHERE operations\n  | \"where\"\n  | \"orWhere\"\n  | \"whereRaw\"\n  | \"orWhereRaw\"\n  | \"whereIn\"\n  | \"whereNotIn\"\n  | \"whereNull\"\n  | \"whereNotNull\"\n  | \"whereBetween\"\n  | \"whereNotBetween\"\n  | \"orWhereIn\"\n  | \"orWhereNotIn\"\n  | \"orWhereNull\"\n  | \"orWhereNotNull\"\n  | \"orWhereBetween\"\n  | \"whereLike\"\n  | \"whereNotLike\"\n  | \"whereColumn\"\n  | \"orWhereColumn\"\n  | \"whereExists\"\n  | \"whereNotExists\"\n  | \"whereNot\"\n  | \"orWhereNot\"\n  | \"whereDate\"\n  | \"whereDateBefore\"\n  | \"whereDateAfter\"\n  | \"whereDateBetween\"\n  | \"whereJsonContains\"\n  | \"whereJsonDoesntContain\"\n  | \"whereFullText\"\n  // SELECT operations\n  | \"select\"\n  | \"selectRaw\"\n  | \"deselect\"\n  // JOIN operations\n  | \"join\"\n  | \"leftJoin\"\n  | \"rightJoin\"\n  | \"innerJoin\"\n  | \"fullJoin\"\n  | \"crossJoin\"\n  | \"joinRaw\"\n  // ORDER operations\n  | \"orderBy\"\n  | \"orderByRaw\"\n  // GROUP operations\n  | \"groupBy\"\n  | \"groupByRaw\"\n  | \"having\"\n  | \"havingRaw\"\n  // LIMIT operations\n  | \"limit\"\n  | \"offset\"\n  // Row locking\n  | \"lock\"\n  // RELATION operations\n  | \"has\"\n  | \"whereHas\"\n  | \"doesntHave\"\n  | \"whereDoesntHave\"\n  // joinWith operations\n  | \"selectRelatedColumns\"\n  // Builder-level metadata (consumed before parsing)\n  | \"joinWith\"\n  | \"cursor\"\n  // Other\n  | \"distinct\";\n\n/**\n * Internal operation representation.\n */\nexport type PostgresParserOperation = {\n  /** Operation type */\n  readonly type: PostgresOperationType;\n  /** Operation data/parameters */\n  readonly data: Record<string, unknown>;\n};\n\n/**\n * Parser configuration options.\n */\nexport type PostgresParserOptions = {\n  /** Target table name */\n  readonly table: string;\n  /** Table alias (optional) */\n  readonly alias?: string;\n  /** Operations to parse */\n  readonly operations: PostgresParserOperation[];\n  /** SQL dialect for syntax generation */\n  readonly dialect?: SqlDialectContract;\n  /** Factory for creating sub-parsers (for nested queries) */\n  readonly createSubParser?: (table: string) => PostgresQueryParser;\n};\n\n/**\n * PostgreSQL Query Parser.\n *\n * Converts a list of query operations into a SQL query string with parameters.\n * Handles SELECT, WHERE, JOIN, ORDER BY, GROUP BY, LIMIT/OFFSET clauses.\n *\n * @example\n * ```typescript\n * const parser = new PostgresQueryParser({\n *   table: 'users',\n *   operations: [\n *     { type: 'where', data: { field: 'name', operator: '=', value: 'Alice' } },\n *     { type: 'orderBy', data: { field: 'createdAt', direction: 'desc' } },\n *     { type: 'limit', data: { value: 10 } }\n *   ]\n * });\n *\n * const { sql, params } = parser.parse();\n * // sql: 'SELECT * FROM \"users\" WHERE \"name\" = $1 ORDER BY \"createdAt\" DESC LIMIT 10'\n * // params: ['Alice']\n * ```\n */\nexport class PostgresQueryParser {\n  /**\n   * Target table name.\n   */\n  private readonly table: string;\n\n  /**\n   * Table alias.\n   */\n  private readonly alias?: string;\n\n  /**\n   * Operations to process.\n   */\n  private readonly operations: PostgresParserOperation[];\n\n  /**\n   * SQL dialect for syntax.\n   */\n  private readonly dialect: SqlDialectContract;\n\n  /**\n   * Current parameter index (1-based for PostgreSQL).\n   */\n  private paramIndex = 1;\n\n  /**\n   * Collected parameters.\n   */\n  private readonly params: unknown[] = [];\n\n  /**\n   * SELECT columns.\n   */\n  public selectColumns: string[] = [];\n\n  /**\n   * Deselected (excluded) columns.\n   */\n  private deselectColumns: string[] = [];\n\n  /**\n   * Raw SELECT expressions.\n   */\n  private selectRaw: string[] = [];\n\n  /**\n   * WHERE clauses.\n   */\n  public whereClauses: string[] = [];\n\n  /**\n   * JOIN clauses.\n   */\n  private joinClauses: string[] = [];\n\n  /**\n   * ORDER BY clauses.\n   */\n  public orderClauses: string[] = [];\n\n  /**\n   * GROUP BY columns (bare identifiers — get quoted).\n   */\n  private groupColumns: string[] = [];\n\n  /**\n   * Raw GROUP BY expressions (emitted verbatim — e.g. a `date_trunc(...)`\n   * bucket). Kept separate from `groupColumns` so they bypass identifier\n   * quoting while still landing in the same `GROUP BY` clause.\n   */\n  private groupRawExpressions: string[] = [];\n\n  /**\n   * HAVING clauses.\n   */\n  private havingClauses: string[] = [];\n\n  /**\n   * LIMIT value.\n   */\n  public limitValue?: number;\n\n  /**\n   * OFFSET value.\n   */\n  public offsetValue?: number;\n\n  /**\n   * DISTINCT flag.\n   */\n  private isDistinct = false;\n\n  /**\n   * Row-locking clause (`FOR UPDATE [SKIP LOCKED | NOWAIT]`). Appended after\n   * LIMIT/OFFSET — the locking clause is last in PostgreSQL's SELECT grammar.\n   */\n  private lockClause = \"\";\n\n  /**\n   * Whether the query has any JOIN operations (pre-scanned before processing).\n   * Used by qualifyColumn() to decide whether to prefix columns with the main table.\n   */\n  private hasJoins = false;\n\n  /**\n   * Tracked joined tables (for table reference detection).\n   */\n  private readonly joinedTables = new Set<string>();\n\n  /**\n   * Create a new query parser.\n   *\n   * @param options - Parser configuration\n   */\n  public constructor(options: PostgresParserOptions) {\n    this.table = options.table;\n    this.alias = options.alias;\n    this.operations = options.operations;\n    this.dialect = options.dialect ?? new PostgresDialect();\n  }\n\n  /**\n   * Parse all operations and build the SQL query.\n   *\n   * @returns DriverQuery with `query` (SQL string) and `bindings` (parameter values)\n   */\n  public parse(): DriverQuery {\n    // Pre-scan for any join operations so qualifyColumn() can prefix columns\n    // correctly even when WHERE clauses appear before JOINs in the operations list.\n    const JOIN_TYPES = new Set([\n      \"join\",\n      \"leftJoin\",\n      \"rightJoin\",\n      \"innerJoin\",\n      \"fullJoin\",\n      \"crossJoin\",\n      \"joinRaw\",\n    ]);\n\n    this.hasJoins = false;\n\n    // First pass: locate all joins and populate joinedTables for accurate JSON path detection\n    for (const operation of this.operations) {\n      if (JOIN_TYPES.has(operation.type)) {\n        this.hasJoins = true;\n        const data = operation.data as any;\n        const joinTable = data.table as string;\n        const alias = data.alias as string;\n\n        if (joinTable) this.joinedTables.add(joinTable);\n        if (alias) this.joinedTables.add(alias);\n      }\n    }\n\n    // Process each operation\n    for (const operation of this.operations) {\n      this.processOperation(operation);\n    }\n\n    // Build the final SQL query\n    const query = this.buildSql();\n\n    return { query, bindings: this.params };\n  }\n\n  /**\n   * Get a formatted string representation of the query.\n   *\n   * @returns Formatted SQL with bindings\n   */\n  public toPrettyString(): string {\n    const { query = \"\", bindings } = this.parse();\n    return `${query}\\n-- Bindings: ${JSON.stringify(bindings ?? [])}`;\n  }\n\n  /**\n   * Process a single operation.\n   *\n   * @param operation - The operation to process\n   */\n  private processOperation(operation: PostgresParserOperation): void {\n    const { type, data } = operation;\n\n    switch (type) {\n      // WHERE operations\n      case \"where\":\n        this.processWhere(data, \"AND\");\n        break;\n      case \"orWhere\":\n        this.processWhere(data, \"OR\");\n        break;\n      case \"whereRaw\":\n        this.processWhereRaw(data, \"AND\");\n        break;\n      case \"orWhereRaw\":\n        this.processWhereRaw(data, \"OR\");\n        break;\n      case \"whereIn\":\n        this.processWhereIn(data, false);\n        break;\n      case \"whereNotIn\":\n        this.processWhereIn(data, true);\n        break;\n      case \"orWhereIn\":\n        this.processWhereIn(data, false, \"OR\");\n        break;\n      case \"orWhereNotIn\":\n        this.processWhereIn(data, true, \"OR\");\n        break;\n      case \"whereNull\":\n        this.processWhereNull(data, false);\n        break;\n      case \"whereNotNull\":\n        this.processWhereNull(data, true);\n        break;\n      case \"orWhereNull\":\n        this.processWhereNull(data, false, \"OR\");\n        break;\n      case \"orWhereNotNull\":\n        this.processWhereNull(data, true, \"OR\");\n        break;\n      case \"orWhereBetween\":\n        this.processWhereBetween(data, false, \"OR\");\n        break;\n      case \"whereBetween\":\n        this.processWhereBetween(data, false);\n        break;\n      case \"whereNotBetween\":\n        this.processWhereBetween(data, true);\n        break;\n      case \"whereLike\":\n        this.processWhereLike(data, false);\n        break;\n      case \"whereNotLike\":\n        this.processWhereLike(data, true);\n        break;\n      case \"whereColumn\":\n        this.processWhereColumn(data, \"AND\");\n        break;\n      case \"orWhereColumn\":\n        this.processWhereColumn(data, \"OR\");\n        break;\n      case \"whereJsonContains\":\n        this.processWhereJsonContains(data, false);\n        break;\n      case \"whereJsonDoesntContain\":\n        this.processWhereJsonContains(data, true);\n        break;\n      case \"whereFullText\":\n        this.processWhereFullText(data);\n        break;\n      case \"whereNot\":\n        this.processNested(data.nested, \"AND\", true, type);\n        break;\n      case \"orWhereNot\":\n        this.processNested(data.nested, \"OR\", true, type);\n        break;\n      // Same semantics as the Mongo driver: the callback conditions are applied\n      // inline (exists) or negated (notExists).\n      case \"whereExists\":\n        this.processNested(data.subquery, \"AND\", false, type);\n        break;\n      case \"whereNotExists\":\n        this.processNested(data.subquery, \"AND\", true, type);\n        break;\n      case \"whereDate\":\n        this.processWhereDate(data, \"=\");\n        break;\n      case \"whereDateBefore\":\n        this.processWhereDate(data, \"<\");\n        break;\n      case \"whereDateAfter\":\n        this.processWhereDate(data, \">\");\n        break;\n      case \"whereDateBetween\":\n        this.processWhereDateBetween(data);\n        break;\n\n      // SELECT operations\n      case \"select\":\n        this.processSelect(data);\n        break;\n      case \"selectRaw\":\n        this.processSelectRaw(data);\n        break;\n      case \"deselect\":\n        this.processDeselect(data);\n        break;\n\n      // JOIN operations\n      case \"join\":\n      case \"innerJoin\":\n        this.processJoin(data, \"INNER\");\n        break;\n      case \"leftJoin\":\n        this.processJoin(data, \"LEFT\");\n        break;\n      case \"rightJoin\":\n        this.processJoin(data, \"RIGHT\");\n        break;\n      case \"fullJoin\":\n        this.processJoin(data, \"FULL OUTER\");\n        break;\n      case \"crossJoin\":\n        this.processCrossJoin(data);\n        break;\n      case \"joinRaw\":\n        this.processJoinRaw(data);\n        break;\n\n      // ORDER operations\n      case \"orderBy\":\n        this.processOrderBy(data);\n        break;\n      case \"orderByRaw\":\n        this.processOrderByRaw(data);\n        break;\n\n      // GROUP operations\n      case \"groupBy\":\n        this.processGroupBy(data);\n        break;\n      case \"groupByRaw\":\n        this.processGroupByRaw(data);\n        break;\n      case \"having\":\n        this.processHaving(data);\n        break;\n      case \"havingRaw\":\n        this.processHavingRaw(data);\n        break;\n\n      // LIMIT operations\n      case \"limit\":\n        this.limitValue = data.value as number;\n        break;\n      case \"offset\":\n        this.offsetValue = data.value as number;\n        break;\n\n      // Row locking\n      case \"lock\": {\n        let clause = \"FOR UPDATE\";\n        if (data.skipLocked) {\n          clause += \" SKIP LOCKED\";\n        } else if (data.noWait) {\n          clause += \" NOWAIT\";\n        }\n        this.lockClause = clause;\n        break;\n      }\n\n      // Other\n      case \"distinct\":\n        this.isDistinct = true;\n        break;\n\n      // joinWith select related columns\n      case \"selectRelatedColumns\":\n        this.processSelectRelatedColumns(data);\n        break;\n\n      // Builder-level metadata consumed before parsing; carries no SQL of its own\n      case \"cursor\":\n      case \"joinWith\":\n        break;\n\n      default:\n        // An unknown filter must never silently disappear: write paths\n        // (delete/update) reuse this parser, so a dropped filter widens the\n        // statement to every row.\n        throw new Error(`PostgresQueryParser: unsupported operation type \"${type}\"`);\n    }\n  }\n\n  /**\n   * Build the final SQL query from collected clauses.\n   *\n   * @returns Complete SQL query string\n   */\n  private buildSql(): string {\n    const parts: string[] = [];\n\n    // SELECT clause\n    parts.push(this.buildSelectClause());\n\n    // FROM clause\n    const quotedTable = this.quoteTable(this.table);\n    const fromClause = this.alias\n      ? `FROM ${quotedTable} AS ${this.dialect.quoteIdentifier(this.alias)}`\n      : `FROM ${quotedTable}`;\n    parts.push(fromClause);\n\n    // JOIN clauses\n    if (this.joinClauses.length > 0) {\n      parts.push(this.joinClauses.join(\" \"));\n    }\n\n    // WHERE clause\n    if (this.whereClauses.length > 0) {\n      parts.push(`WHERE ${this.whereClauses.join(\" \")}`);\n    }\n\n    // GROUP BY clause — bare columns are quoted; raw expressions (e.g.\n    // date_trunc buckets) are emitted verbatim. Both share one clause.\n    if (this.groupColumns.length > 0 || this.groupRawExpressions.length > 0) {\n      const quotedCols = this.groupColumns.map((c) => this.dialect.quoteIdentifier(c));\n      const allGroupTerms = [...quotedCols, ...this.groupRawExpressions];\n      parts.push(`GROUP BY ${allGroupTerms.join(\", \")}`);\n    }\n\n    // HAVING clause\n    if (this.havingClauses.length > 0) {\n      parts.push(`HAVING ${this.havingClauses.join(\" AND \")}`);\n    }\n\n    // ORDER BY clause\n    if (this.orderClauses.length > 0) {\n      parts.push(`ORDER BY ${this.orderClauses.join(\", \")}`);\n    }\n\n    // LIMIT/OFFSET\n    const limitOffset = this.dialect.limitOffset(this.limitValue, this.offsetValue);\n    if (limitOffset) {\n      parts.push(limitOffset);\n    }\n\n    // Row-locking clause — last in PostgreSQL's SELECT grammar\n    if (this.lockClause) {\n      parts.push(this.lockClause);\n    }\n\n    return parts.join(\" \");\n  }\n\n  /**\n   * Build the SELECT clause.\n   *\n   * @returns SELECT clause string\n   */\n  private buildSelectClause(): string {\n    const distinct = this.isDistinct ? \"DISTINCT \" : \"\";\n\n    // If no specific columns, select all — qualify with main table when joins present\n    if (this.selectColumns.length === 0 && this.selectRaw.length === 0) {\n      return this.hasJoins\n        ? `SELECT ${distinct}${this.quoteTable(this.table)}.*`\n        : `SELECT ${distinct}*`;\n    }\n\n    const columns: string[] = [];\n\n    // Add selected columns — prefix with main table when joins present to avoid ambiguity\n    for (const col of this.selectColumns) {\n      if (!this.deselectColumns.includes(col)) {\n        columns.push(this.parseColumnIdentifier(col, this.table, this.alias));\n      }\n    }\n\n    // Add raw expressions\n    columns.push(...this.selectRaw);\n\n    return `SELECT ${distinct}${columns.join(\", \")}`;\n  }\n\n  /**\n   * Add a placeholder and parameter.\n   *\n   * @param value - Parameter value\n   * @returns Placeholder string ($1, $2, etc.)\n   */\n  private addParam(value: unknown): string {\n    this.params.push(value);\n    return this.dialect.placeholder(this.paramIndex++);\n  }\n\n  /**\n   * Absorb a sub-parser's params into this parser, returning a rewriter\n   * function that translates the sub-parser's `$N` placeholders into freshly\n   * numbered placeholders in this parser's namespace.\n   *\n   * Required whenever sub-parser SQL fragments (e.g. WHERE clauses produced\n   * for a `joinWith` constraint) are spliced into the outer query — without\n   * the rewrite the embedded `$N` references point at parameters this\n   * parser has no knowledge of, leaving them dangling in the final SQL.\n   *\n   * The sub-parser's `params[i]` corresponds to its `$(i+1)` placeholder\n   * (its `paramIndex` always starts at 1), so we map sequentially.\n   *\n   * @example\n   *   const renumber = this.absorbSubParserParams(subParser);\n   *   const fragment = renumber(subParser.whereClauses.join(\" \"));\n   */\n  private absorbSubParserParams(subParser: PostgresQueryParser): (sql: string) => string {\n    if (subParser.params.length === 0) {\n      return (sql) => sql;\n    }\n\n    const oldToNew = new Map<string, string>();\n\n    for (let index = 0; index < subParser.params.length; index++) {\n      const newPlaceholder = this.addParam(subParser.params[index]);\n      oldToNew.set(`$${index + 1}`, newPlaceholder);\n    }\n\n    return (sql) => sql.replace(/\\$\\d+/g, (match) => oldToNew.get(match) ?? match);\n  }\n\n  /**\n   * Process a basic WHERE operation.\n   *\n   * Delegates to specialised processors for operators that require more than a\n   * single placeholder (between, in, like-variants, exists, etc.).\n   */\n  private processWhere(data: Record<string, unknown>, boolean: \"AND\" | \"OR\"): void {\n    // `where(q => ...)` / `orWhere(q => ...)` record a nested group\n    if (data.nested !== undefined) {\n      return this.processNested(data.nested, boolean, false, \"where\");\n    }\n\n    const field = data.field as string;\n    const operator = (data.operator as WhereOperator) ?? \"=\";\n    const value = data.value;\n\n    // Delegate to specialised processors for operators that need it. The\n    // `boolean` connective is forwarded so `orWhere(f, \"in\", …)` stays an OR.\n    const range = value as [unknown, unknown];\n    const like = { field, pattern: value as string };\n\n    switch (operator) {\n      case \"between\":\n        return this.processWhereBetween({ field, range }, false, boolean);\n      case \"notBetween\":\n        return this.processWhereBetween({ field, range }, true, boolean);\n      case \"in\":\n        return this.processWhereIn({ field, values: value as unknown[] }, false, boolean);\n      case \"notIn\":\n        return this.processWhereIn({ field, values: value as unknown[] }, true, boolean);\n      case \"like\":\n      case \"ilike\":\n        return this.processWhereLike(like, false, boolean);\n      case \"startsWith\":\n      case \"endsWith\":\n        return this.processWhereLike(like, false, boolean, operator);\n      case \"notLike\":\n        return this.processWhereLike(like, true, boolean);\n      case \"notStartsWith\":\n        return this.processWhereLike(like, true, boolean, \"startsWith\");\n      case \"notEndsWith\":\n        return this.processWhereLike(like, true, boolean, \"endsWith\");\n      case \"exists\":\n        // Raw strings are never inlined into SQL (injection); a sub-query must\n        // arrive as an already-parameterised builder, not text.\n        throw new Error(\n          'PostgresQueryParser: where(field, \"exists\", value) does not accept a raw SQL string; use a query builder or callback',\n        );\n    }\n\n    const quotedField = this.parseColumnIdentifier(field, this.table, this.alias);\n\n    if (value === null) {\n      const nullOperator = operator === \"!=\" ? \"IS NOT NULL\" : \"IS NULL\";\n      return this.addWhereClause(`${quotedField} ${nullOperator}`, boolean);\n    }\n\n    // Simple single-value operator — fall through to generic path\n    const placeholder = this.addParam(value);\n    this.addWhereClause(`${quotedField} ${this.mapOperator(operator)} ${placeholder}`, boolean);\n  }\n\n  /**\n   * Process a nested group of operations as `(<group>)` / `NOT (<group>)`.\n   *\n   * The group is parsed by a sub-parser; its params are renumbered into this\n   * parser's namespace.\n   */\n  private processNested(\n    nested: unknown,\n    boolean: \"AND\" | \"OR\",\n    negate: boolean,\n    opType: string,\n  ): void {\n    const subParser = new PostgresQueryParser({\n      table: this.table,\n      alias: this.alias,\n      dialect: this.dialect,\n      operations: (nested as PostgresParserOperation[] | undefined) ?? [],\n    });\n    subParser.parse();\n\n    if (subParser.whereClauses.length === 0) {\n      throw new Error(`PostgresQueryParser: \"${opType}\" received an empty condition group`);\n    }\n\n    const renumber = this.absorbSubParserParams(subParser);\n    const group = `(${renumber(subParser.whereClauses.join(\" \"))})`;\n\n    this.addWhereClause(negate ? `NOT ${group}` : group, boolean);\n  }\n\n  /**\n   * Compare the date portion of a column (time ignored).\n   */\n  private processWhereDate(data: Record<string, unknown>, operator: string): void {\n    const quotedField = this.parseColumnIdentifier(data.field as string, this.table, this.alias);\n    const placeholder = this.addParam(data.value);\n\n    this.addWhereClause(`${quotedField}::date ${operator} ${placeholder}::date`, \"AND\");\n  }\n\n  /**\n   * Date portion of a column within an inclusive [from, to] range.\n   */\n  private processWhereDateBetween(data: Record<string, unknown>): void {\n    const range = data.range as [unknown, unknown];\n    const quotedField = this.parseColumnIdentifier(data.field as string, this.table, this.alias);\n    const from = this.addParam(range[0]);\n    const to = this.addParam(range[1]);\n\n    this.addWhereClause(`${quotedField}::date BETWEEN ${from}::date AND ${to}::date`, \"AND\");\n  }\n\n  /**\n   * Process a raw WHERE operation.\n   */\n  private processWhereRaw(data: Record<string, unknown>, boolean: \"AND\" | \"OR\"): void {\n    const expression = data.expression as string;\n    const bindings = (data.bindings as unknown[]) ?? [];\n\n    // Replace ? placeholders with $n\n    let processed = expression;\n    for (const binding of bindings) {\n      processed = processed.replace(\"?\", this.addParam(binding));\n    }\n\n    this.addWhereClause(processed, boolean);\n  }\n\n  /**\n   * Process WHERE IN / NOT IN.\n   */\n  private processWhereIn(\n    data: Record<string, unknown>,\n    negate: boolean,\n    boolean: \"AND\" | \"OR\" = \"AND\",\n  ): void {\n    const field = data.field as string;\n    const values = data.values as unknown[];\n\n    const quotedField = this.parseColumnIdentifier(field, this.table, this.alias);\n    const operator = negate ? \"!= ALL\" : \"= ANY\";\n    const placeholder = this.addParam(values);\n\n    this.addWhereClause(`${quotedField} ${operator}(${placeholder})`, boolean);\n  }\n\n  /**\n   * Process WHERE NULL / NOT NULL.\n   */\n  private processWhereNull(\n    data: Record<string, unknown>,\n    negate: boolean,\n    boolean: \"AND\" | \"OR\" = \"AND\",\n  ): void {\n    const field = data.field as string;\n    const quotedField = this.parseColumnIdentifier(field, this.table, this.alias);\n    const clause = negate ? `${quotedField} IS NOT NULL` : `${quotedField} IS NULL`;\n    this.addWhereClause(clause, boolean);\n  }\n\n  /**\n   * Process WHERE BETWEEN / NOT BETWEEN.\n   */\n  private processWhereBetween(\n    data: Record<string, unknown>,\n    negate: boolean,\n    boolean: \"AND\" | \"OR\" = \"AND\",\n  ): void {\n    const field = data.field as string;\n    const range = data.range as [unknown, unknown];\n\n    const quotedField = this.parseColumnIdentifier(field, this.table, this.alias);\n    const placeholder1 = this.addParam(range[0]);\n    const placeholder2 = this.addParam(range[1]);\n    const keyword = negate ? \"NOT BETWEEN\" : \"BETWEEN\";\n\n    this.addWhereClause(`${quotedField} ${keyword} ${placeholder1} AND ${placeholder2}`, boolean);\n  }\n\n  /**\n   * Process WHERE LIKE / NOT LIKE.\n   *\n   * Cross-driver semantics (matches MongoDB): `%` is the only wildcard, `_`\n   * and backslash are literal, and a pattern with no `%` matches as a\n   * substring. `startsWith` / `endsWith` anchor the escaped text explicitly.\n   * A `RegExp` has no SQL equivalent and is rejected.\n   */\n  private processWhereLike(\n    data: Record<string, unknown>,\n    negate: boolean,\n    boolean: \"AND\" | \"OR\" = \"AND\",\n    modeArg?: \"startsWith\" | \"endsWith\",\n  ): void {\n    const field = data.field as string;\n    const mode = modeArg ?? (data.mode as \"startsWith\" | \"endsWith\" | undefined);\n\n    // A RegExp maps to the POSIX case-insensitive match operators\n    if (data.isRegExp === true || (data.pattern as unknown) instanceof RegExp) {\n      const source =\n        (data.pattern as unknown) instanceof RegExp\n          ? (data.pattern as unknown as RegExp).source\n          : String(data.pattern);\n      const regexField = this.parseColumnIdentifier(field, this.table, this.alias);\n      const regexPlaceholder = this.addParam(source);\n\n      return this.addWhereClause(\n        `${regexField} ${negate ? \"!~*\" : \"~*\"} ${regexPlaceholder}`,\n        boolean,\n      );\n    }\n    // Mode ops carry the raw user value; `pattern` is only the display shape\n    const pattern = String(mode && data.value !== undefined ? data.value : data.pattern);\n\n    const quotedField = this.parseColumnIdentifier(field, this.table, this.alias);\n    const { operator } = this.dialect.likePattern(pattern, true);\n    // Escape `\\` and `_` (literal). `%` stays the wildcard of a plain LIKE\n    // pattern, but startsWith / endsWith values are literal text, so it is\n    // escaped there too.\n    let escaped = pattern.replace(/\\\\/g, \"\\\\\\\\\").replace(/_/g, \"\\\\_\");\n\n    if (mode) {\n      escaped = escaped.replace(/%/g, \"\\\\%\");\n    }\n\n    let finalPattern = escaped;\n\n    if (mode === \"startsWith\") {\n      finalPattern = `${escaped}%`;\n    } else if (mode === \"endsWith\") {\n      finalPattern = `%${escaped}`;\n    } else if (!escaped.includes(\"%\")) {\n      finalPattern = `%${escaped}%`;\n    }\n\n    const placeholder = this.addParam(finalPattern);\n    const keyword = negate ? `NOT ${operator}` : operator;\n\n    // Mode variants state the escape character explicitly\n    const escapeClause = mode ? \" ESCAPE '\\\\'\" : \"\";\n\n    this.addWhereClause(`${quotedField} ${keyword} ${placeholder}${escapeClause}`, boolean);\n  }\n\n  /**\n   * Process WHERE column comparison.\n   */\n  private processWhereColumn(data: Record<string, unknown>, boolean: \"AND\" | \"OR\"): void {\n    const first = data.first as string;\n    const operator = this.mapOperator(((data.operator as string) ?? \"=\") as WhereOperator);\n    const second = data.second as string;\n\n    // Both sides may need qualification if unambiguous table is unclear\n    const quotedFirst = this.parseColumnIdentifier(first, this.table, this.alias);\n    const quotedSecond = this.parseColumnIdentifier(second, this.table, this.alias);\n\n    this.addWhereClause(`${quotedFirst} ${operator} ${quotedSecond}`, boolean);\n  }\n\n  /**\n   * Process WHERE JSON contains.\n   */\n  private processWhereJsonContains(data: Record<string, unknown>, negate: boolean): void {\n    const path = data.path as string;\n    const value = data.value;\n\n    const quotedPath = this.parseColumnIdentifier(path, this.table, this.alias);\n    const operator = negate ? \"NOT @>\" : \"@>\";\n    const placeholder = this.addParam(JSON.stringify(value));\n\n    this.addWhereClause(`${quotedPath} ${operator} ${placeholder}::jsonb`, \"AND\");\n  }\n\n  /** Text search config name; anything but a plain identifier falls back to english. */\n  private safeLanguage(language: unknown): string {\n    return typeof language === \"string\" && /^[a-z_]+$/i.test(language) ? language : \"english\";\n  }\n\n  /**\n   * Process full-text search WHERE.\n   */\n  private processWhereFullText(data: Record<string, unknown>): void {\n    const fields = data.fields as string[];\n    const query = data.query as string;\n    const language = this.safeLanguage(data.language);\n    const weights = (data.weights as Record<string, string> | undefined) ?? {};\n\n    // Same expression as `createFullTextIndex`, so the GIN index is used and a\n    // NULL column doesn't null the whole vector.\n    const tsVectors = fields\n      .map((f) => {\n        const weight = /^[A-D]$/.test(weights[f] ?? \"\") ? weights[f] : \"A\";\n\n        return `setweight(to_tsvector('${language}', COALESCE(${this.dialect.quoteIdentifier(f)}, '')), '${weight}')`;\n      })\n      .join(\" || \");\n\n    const placeholder = this.addParam(query);\n    this.addWhereClause(`(${tsVectors}) @@ plainto_tsquery('${language}', ${placeholder})`, \"AND\");\n  }\n\n  /**\n   * Process SELECT operation.\n   */\n  private processSelect(data: Record<string, unknown>): void {\n    const fields = data.fields as string[] | Record<string, string>;\n\n    if (Array.isArray(fields)) {\n      this.selectColumns.push(...fields);\n    } else {\n      // Handle aliases: { field: 'alias' }\n      for (const [field, alias] of Object.entries(fields)) {\n        const quotedField = this.dialect.quoteIdentifier(field);\n        const quotedAlias = this.dialect.quoteIdentifier(alias);\n        this.selectRaw.push(`${quotedField} AS ${quotedAlias}`);\n      }\n    }\n  }\n\n  /**\n   * Process raw SELECT expression.\n   */\n  private processSelectRaw(data: Record<string, unknown>): void {\n    const expression = data.expression as string | Record<string, unknown>;\n    const bindings = (data.bindings as unknown[]) ?? [];\n\n    if (typeof expression === \"string\") {\n      // Replace ? placeholders with $n positional params (same as processWhereRaw)\n      let processed = expression;\n      for (const binding of bindings) {\n        processed = processed.replace(\"?\", this.addParam(binding));\n      }\n      this.selectRaw.push(processed);\n    } else {\n      // Handle object expressions (for compatibility)\n      for (const [alias, expr] of Object.entries(expression)) {\n        this.selectRaw.push(`${expr} AS ${this.dialect.quoteIdentifier(alias)}`);\n      }\n    }\n  }\n\n  /**\n   * Process DESELECT operation.\n   */\n  private processDeselect(data: Record<string, unknown>): void {\n    const fields = data.fields as string[];\n    this.deselectColumns.push(...fields);\n  }\n\n  /**\n   * Process SELECT for related columns (joinWith).\n   *\n   * - hasOne / belongsTo  → LEFT JOIN + row_to_json  (single object)\n   * - hasMany             → correlated subquery with json_agg (array, no row explosion)\n   *\n   * @example hasMany correlated subquery:\n   *   (SELECT json_agg(row_to_json(a.*))\n   *    FROM \"chat_message_actions\" a\n   *    WHERE a.\"chat_message_id\" = \"chat_messages\".\"id\") AS \"actions\"\n   *\n   * @example hasOne/belongsTo row_to_json:\n   *   row_to_json(\"organizationAiModel\".*) AS \"organizationAiModel\"\n   */\n  private processSelectRelatedColumns(data: Record<string, unknown>): void {\n    const alias = data.alias as string;\n    const select = data.select as string[] | undefined;\n    const relationType = data.type as string | undefined;\n    const constraintOps = data.constraintOps as PostgresParserOperation[] | undefined;\n    const quotedAlias = this.dialect.quoteIdentifier(alias);\n    const quotedTable = this.quoteTable(this.table);\n\n    const hasExplicitSelect = this.selectColumns.length > 0;\n    if (!hasExplicitSelect && !this.selectRaw.includes(`${quotedTable}.*`)) {\n      this.selectRaw.unshift(`${quotedTable}.*`);\n    }\n\n    if (relationType === \"hasMany\") {\n      // Correlated subquery — no JOIN, no row explosion, returns a JSON array.\n      const relatedTable = data.table as string;\n      const foreignKey = data.foreignKey as string;\n      const localKey = data.localKey as string;\n      const quotedRelatedTable = this.quoteTable(relatedTable);\n      const quotedForeignKey = this.dialect.quoteIdentifier(foreignKey);\n      const quotedLocalKey = this.dialect.quoteIdentifier(localKey);\n      const quotedMainTable = this.quoteTable(this.table);\n\n      let innerSelect: string;\n      if (select && select.length > 0) {\n        // Pick specific columns: json_agg(json_build_object('id', a.\"id\", ...))\n        const fields = select\n          .map((col) => `'${escapeSqlLiteral(col)}', a.${this.dialect.quoteIdentifier(col)}`)\n          .join(\", \");\n        innerSelect = `json_agg(json_build_object(${fields}))`;\n      } else {\n        innerSelect = `json_agg(row_to_json(a.*))`;\n      }\n\n      // Build the base FK condition\n      const fkCondition = `a.${quotedForeignKey} = ${quotedMainTable}.${quotedLocalKey}`;\n\n      // Merge constraint ops (where / order / limit) from a sub-parser.\n      // The sub-parser numbers its own placeholders starting at $1; we must\n      // absorb its params into this parser and renumber the embedded SQL,\n      // otherwise $N references in the merged clauses dangle.\n      let extraWhere = \"\";\n      let orderBy = \"\";\n      let limitClause = \"\";\n\n      if (constraintOps && constraintOps.length > 0) {\n        const subParser = new PostgresQueryParser({\n          table: relatedTable,\n          alias: \"a\",\n          dialect: this.dialect,\n          operations: constraintOps,\n        });\n        subParser.parse();\n\n        const renumber = this.absorbSubParserParams(subParser);\n\n        if (subParser.whereClauses.length > 0) {\n          extraWhere = ` AND ${renumber(subParser.whereClauses.join(\" \"))}`;\n        }\n        if (subParser.orderClauses.length > 0) {\n          orderBy = ` ORDER BY ${renumber(subParser.orderClauses.join(\", \"))}`;\n        }\n        if (subParser.limitValue !== undefined) {\n          limitClause = ` ${this.dialect.limitOffset(subParser.limitValue)}`;\n        }\n      }\n\n      // Wrap with ORDER/LIMIT only when constraints are present (json_agg ignores ORDER)\n      const innerQuery =\n        orderBy || limitClause\n          ? `SELECT row_to_json(sub.*) FROM (SELECT * FROM ${quotedRelatedTable} a WHERE ${fkCondition}${extraWhere}${orderBy}${limitClause}) sub`\n          : `SELECT ${innerSelect.replace(\"json_agg(\", \"\").replace(/\\)$/, \"\")} FROM ${quotedRelatedTable} a WHERE ${fkCondition}${extraWhere}`;\n\n      const aggregated =\n        orderBy || limitClause\n          ? `(SELECT json_agg(row_to_json(sub.*)) FROM (SELECT * FROM ${quotedRelatedTable} a WHERE ${fkCondition}${extraWhere}${orderBy}${limitClause}) sub) AS ${quotedAlias}`\n          : `(SELECT ${innerSelect} FROM ${quotedRelatedTable} a WHERE ${fkCondition}${extraWhere}) AS ${quotedAlias}`;\n\n      this.selectRaw.push(aggregated);\n    } else {\n      // hasOne / belongsTo — single object via LEFT JOIN + row_to_json.\n      // If constraint provides an explicit select list, prefer it over data.select\n      let effectiveSelect = select;\n      if (constraintOps && constraintOps.length > 0) {\n        const subParser = new PostgresQueryParser({\n          table: (data.table as string) ?? alias,\n          alias,\n          dialect: this.dialect,\n          operations: constraintOps,\n        });\n        subParser.parse();\n        if (subParser.selectColumns.length > 0) {\n          effectiveSelect = subParser.selectColumns;\n        }\n      }\n\n      if (effectiveSelect && effectiveSelect.length > 0) {\n        const selectedColumns = effectiveSelect\n          .map((col) => `${quotedAlias}.${this.dialect.quoteIdentifier(col)}`)\n          .join(\", \");\n        this.selectRaw.push(\n          `row_to_json((SELECT d FROM (SELECT ${selectedColumns}) d)) AS ${quotedAlias}`,\n        );\n      } else {\n        this.selectRaw.push(`row_to_json(${quotedAlias}.*) AS ${quotedAlias}`);\n      }\n    }\n  }\n\n  /**\n   * Process JOIN operation with smart field detection.\n   *\n   * Handles both regular columns and JSONB nested paths:\n   * - \"id\" → \"table\".\"id\" (auto-prefixed)\n   * - \"users.id\" → \"users\".\"id\" (explicit table)\n   * - \"createdBy.id\" → \"table\".\"createdBy\"->>'id' (JSONB path)\n   * - \"posts.createdBy.id\" → \"posts\".\"createdBy\"->>'id' (JSONB with table)\n   */\n  private processJoin(data: Record<string, unknown>, type: string): void {\n    const options = data as unknown as\n      | JoinOptions\n      | { table: string; localField: string; foreignField: string };\n\n    const joinTable = \"table\" in options ? options.table : \"\";\n    const localField = \"localField\" in options ? options.localField : \"\";\n    const foreignField = \"foreignField\" in options ? options.foreignField : \"\";\n    const alias = \"alias\" in options ? options.alias : undefined;\n    const constraintOps = (data.constraintOps as PostgresParserOperation[] | undefined) ?? [];\n\n    const quotedTable = this.quoteTable(joinTable);\n    const tableRef = alias\n      ? `${quotedTable} AS ${this.dialect.quoteIdentifier(alias)}`\n      : quotedTable;\n    const tableAlias = alias ?? joinTable;\n\n    // Track the joined table for reference detection\n    this.joinedTables.add(joinTable);\n    if (alias) {\n      this.joinedTables.add(alias);\n    }\n\n    // Parse local field (belongs to main table)\n    const quotedLocal = this.parseColumnIdentifier(localField!, this.table, this.alias);\n\n    // Parse foreign field (belongs to join table)\n    const quotedForeign = this.parseColumnIdentifier(foreignField!, joinTable, tableAlias);\n\n    // Build the basic ON condition. For hasOne/belongsTo joinWith with a\n    // constraint callback, append the constraint's where-clauses to the ON\n    // clause (preserves LEFT JOIN semantics — main rows stay even when no\n    // related row passes the constraint). orderBy/limit on the constraint\n    // are silently dropped — they have no meaning on a single-row LEFT JOIN.\n    let onClause = `${quotedLocal} = ${quotedForeign}`;\n\n    if (constraintOps.length > 0) {\n      const whereOps = constraintOps.filter(\n        (op) => op.type.startsWith(\"where\") || op.type.startsWith(\"orWhere\"),\n      );\n\n      if (whereOps.length > 0) {\n        const subParser = new PostgresQueryParser({\n          table: joinTable,\n          alias: tableAlias,\n          dialect: this.dialect,\n          operations: whereOps,\n        });\n        subParser.parse();\n\n        if (subParser.whereClauses.length > 0) {\n          const renumber = this.absorbSubParserParams(subParser);\n          onClause = `${onClause} AND ${renumber(subParser.whereClauses.join(\" \"))}`;\n        }\n      }\n    }\n\n    this.joinClauses.push(`${type} JOIN ${tableRef} ON ${onClause}`);\n  }\n\n  /**\n   * Parse a column identifier with smart detection for table prefixes and JSONB paths.\n   *\n   * Supports an optional explicit cast suffix using PostgreSQL's `::type` syntax,\n   * which is the only way to coerce a JSONB-extracted value (always returned as\n   * `text`) into another type. The parser does NOT infer casts from key names —\n   * coercion is always opt-in by the caller.\n   *\n   * @param field - The field string. Examples:\n   *   - \"id\"                       → `\"table\".\"id\"`\n   *   - \"users.id\"                 → `\"users\".\"id\"`\n   *   - \"createdBy.id\"             → `\"table\".\"createdBy\"->>'id'`\n   *   - \"createdBy.id::int\"        → `(\"table\".\"createdBy\"->>'id')::int`\n   *   - \"meta.score::numeric\"      → `(\"table\".\"meta\"->>'score')::numeric`\n   *   - \"posts.createdBy.id::uuid\" → `(\"posts\".\"createdBy\"->>'id')::uuid`\n   * @param defaultTable - Default table to use if no prefix\n   * @param tableAlias - Table alias to use if provided\n   * @returns Properly quoted SQL expression\n   */\n  private parseColumnIdentifier(field: string, defaultTable: string, tableAlias?: string): string {\n    if (!field) return \"\";\n\n    // Extract optional explicit cast suffix: \"createdBy.id::int\" → path \"createdBy.id\", cast \"int\"\n    let cast: string | undefined;\n    const castIndex = field.indexOf(\"::\");\n    if (castIndex !== -1) {\n      cast = field.slice(castIndex + 2).trim();\n      field = field.slice(0, castIndex);\n    }\n\n    const effectiveTable = tableAlias ?? defaultTable;\n    const parts = field.split(\".\");\n\n    let expression: string;\n\n    if (parts.length === 1) {\n      // Single part: just a column name, prefix with default table\n      expression = `${this.quoteTable(effectiveTable)}.${this.dialect.quoteIdentifier(field)}`;\n    } else if (parts.length === 2) {\n      // Two parts: could be \"table.column\" or \"jsonbColumn.key\"\n      const [first, second] = parts;\n\n      // `parts.length === 2` above guarantees both, but the compiler does not\n      // narrow a destructured element from a length check. Throwing rather\n      // than defaulting to \"\": every branch below feeds `quoteIdentifier` or a\n      // JSONB path, so an empty segment would emit SYNTACTICALLY VALID SQL\n      // against the wrong identifier — a query that silently returns the wrong\n      // rows is far worse than one that refuses to build.\n      if (first === undefined || second === undefined) {\n        throw new Error(`Cannot parse field path \"${field}\": expected two non-empty segments.`);\n      }\n\n      if (this.isTableReference(first)) {\n        // It's table.column - regular column reference\n        expression = `${this.quoteTable(first)}.${this.dialect.quoteIdentifier(second)}`;\n      } else {\n        // It's jsonbColumn.key - JSONB path\n        expression = this.buildJsonbPath(effectiveTable, first, [second]);\n      }\n    } else {\n      // Three or more parts: \"table.jsonbColumn.key...\" or \"jsonbColumn.key1.key2...\"\n      const [first, second, ...rest] = parts;\n\n      // Same reasoning as the two-part branch: this arm runs only for three or\n      // more parts, so both exist — and an empty identifier reaching the SQL\n      // is a wrong-rows bug, not a crash.\n      if (first === undefined || second === undefined) {\n        throw new Error(\n          `Cannot parse field path \"${field}\": expected at least three non-empty segments.`,\n        );\n      }\n\n      if (this.isTableReference(first)) {\n        // First part is table: \"posts.createdBy.id\" → table is \"posts\", JSONB is \"createdBy.id\"\n        expression = this.buildJsonbPath(first, second, rest);\n      } else {\n        // No table prefix: \"createdBy.address.city\" → use default table\n        expression = this.buildJsonbPath(effectiveTable, first, [second, ...rest]);\n      }\n    }\n\n    if (cast) {\n      if (!SAFE_CAST_PATTERN.test(cast)) {\n        throw new Error(`PostgresQueryParser: unsafe cast type \"${cast}\"`);\n      }\n\n      return `(${expression})::${cast}`;\n    }\n\n    return expression;\n  }\n\n  /**\n   * Check if a string is a table reference (main table or join table).\n   */\n  private isTableReference(name: string): boolean {\n    if (name === this.table || name === this.alias) {\n      return true;\n    }\n\n    if (this.joinedTables.has(name)) {\n      return true;\n    }\n\n    return false;\n  }\n\n  private quoteTable(table: string): string {\n    return this.dialect instanceof PostgresDialect\n      ? this.dialect.quoteTableIdentifier(table)\n      : this.dialect.quoteIdentifier(table);\n  }\n\n  /**\n   * Build a JSONB path expression.\n   *\n   * @param table - Table name\n   * @param column - JSONB column name\n   * @param path - Array of nested keys\n   * @returns PostgreSQL JSONB path expression\n   *\n   * Returns the raw JSONB path expression — extracted values are always `text`\n   * (`->>` returns text). Callers that need a different type must request an\n   * explicit cast via the `::type` suffix in `parseColumnIdentifier`.\n   *\n   * @example\n   * buildJsonbPath(\"posts\", \"createdBy\", [\"id\"])\n   * // Returns: \"posts\".\"createdBy\"->>'id'\n   *\n   * buildJsonbPath(\"posts\", \"createdBy\", [\"address\", \"city\"])\n   * // Returns: \"posts\".\"createdBy\"->'address'->>'city'\n   */\n  private buildJsonbPath(table: string, column: string, path: string[]): string {\n    const quotedTable = this.quoteTable(table);\n    const quotedColumn = this.dialect.quoteIdentifier(column);\n\n    if (path.length === 0) {\n      return `${quotedTable}.${quotedColumn}`;\n    }\n\n    // Build JSONB path: use -> for intermediate keys, ->> for final key (returns text)\n    let expression = `${quotedTable}.${quotedColumn}`;\n\n    for (let i = 0; i < path.length; i++) {\n      const isLast = i === path.length - 1;\n      const operator = isLast ? \"->>\" : \"->\";\n      expression += `${operator}'${escapeSqlLiteral(path[i] as string)}'`;\n    }\n\n    return expression;\n  }\n\n  /**\n   * Process CROSS JOIN operation.\n   */\n  private processCrossJoin(data: Record<string, unknown>): void {\n    const table = data.table as string;\n    const quotedTable = this.quoteTable(table);\n    this.joinClauses.push(`CROSS JOIN ${quotedTable}`);\n  }\n\n  /**\n   * Process raw JOIN expression.\n   */\n  private processJoinRaw(data: Record<string, unknown>): void {\n    const expression = data.expression as string;\n    const bindings = (data.bindings as unknown[]) ?? [];\n\n    let processed = expression;\n    for (const binding of bindings) {\n      processed = processed.replace(\"?\", this.addParam(binding));\n    }\n\n    this.joinClauses.push(processed);\n  }\n\n  /**\n   * Process ORDER BY operation.\n   */\n  private processOrderBy(data: Record<string, unknown>): void {\n    const field = data.field as string;\n    const rawDirection = String(data.direction ?? \"asc\").trim();\n\n    if (!SAFE_DIRECTION_PATTERN.test(rawDirection)) {\n      throw new Error(`PostgresQueryParser: invalid orderBy direction \"${rawDirection}\"`);\n    }\n\n    const direction = rawDirection.replace(/\\s+/g, \" \").toUpperCase();\n\n    const quotedField = this.parseColumnIdentifier(field, this.table, this.alias);\n    this.orderClauses.push(`${quotedField} ${direction}`);\n  }\n\n  /**\n   * Process raw ORDER BY expression.\n   */\n  private processOrderByRaw(data: Record<string, unknown>): void {\n    const expression = data.expression as string;\n    const bindings = (data.bindings as unknown[]) ?? [];\n\n    // Replace ? placeholders with $n positional params (same as processWhereRaw)\n    let processed = expression;\n    for (const binding of bindings) {\n      processed = processed.replace(\"?\", this.addParam(binding));\n    }\n    this.orderClauses.push(processed);\n  }\n\n  /**\n   * Process GROUP BY operation.\n   */\n  private processGroupBy(data: Record<string, unknown>): void {\n    const fields = data.fields as string | string[];\n    const columns = Array.isArray(fields) ? fields : [fields];\n    this.groupColumns.push(...columns);\n  }\n\n  /**\n   * Process a raw GROUP BY expression (emitted verbatim, no quoting). Used by\n   * `groupByDate` to add a `date_trunc(...)` bucket to the GROUP BY clause.\n   */\n  private processGroupByRaw(data: Record<string, unknown>): void {\n    const expression = data.expression as string;\n    this.groupRawExpressions.push(expression);\n  }\n\n  /**\n   * Process HAVING operation.\n   */\n  private processHaving(data: Record<string, unknown>): void {\n    const field = data.field as string;\n    const operator = this.mapOperator(((data.operator as string) ?? \"=\") as WhereOperator);\n    const value = data.value;\n\n    const quotedField = this.dialect.quoteIdentifier(field);\n    const placeholder = this.addParam(value);\n\n    this.havingClauses.push(`${quotedField} ${operator} ${placeholder}`);\n  }\n\n  /**\n   * Process a raw HAVING expression, threading `?` placeholders into\n   * positional params the same way `processWhereRaw` / `processSelectRaw` do.\n   * Without this, bindings on a `havingRaw` op are silently dropped.\n   */\n  private processHavingRaw(data: Record<string, unknown>): void {\n    let expression = data.expression as string;\n    const bindings = (data.bindings as unknown[]) ?? [];\n\n    for (const binding of bindings) {\n      expression = expression.replace(\"?\", this.addParam(binding));\n    }\n\n    this.havingClauses.push(expression);\n  }\n\n  /**\n   * Add a WHERE clause with boolean operator.\n   */\n  private addWhereClause(clause: string, boolean: \"AND\" | \"OR\"): void {\n    if (this.whereClauses.length === 0) {\n      this.whereClauses.push(clause);\n    } else {\n      this.whereClauses.push(`${boolean} ${clause}`);\n    }\n  }\n\n  /**\n   * Map simple Cascade operators to their SQL equivalents.\n   *\n   * Complex operators (between, in, like-variants, exists) are handled by\n   * dedicated processors and should never reach this method.\n   */\n  private mapOperator(operator: WhereOperator): string {\n    const mapping: Record<string, string> = {\n      \"=\": \"=\",\n      \"!=\": \"!=\",\n      \"<>\": \"<>\",\n      \">\": \">\",\n      \">=\": \">=\",\n      \"<\": \"<\",\n      \"<=\": \"<=\",\n      like: \"LIKE\",\n      notlike: \"NOT LIKE\",\n      ilike: \"ILIKE\",\n    };\n\n    const mapped = mapping[String(operator).toLowerCase()];\n\n    if (mapped === undefined) {\n      throw new Error(`PostgresQueryParser: unsupported operator \"${operator}\"`);\n    }\n\n    return mapped;\n  }\n}\n"],"mappings":"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"}

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

@@ -28,7 +28,8 @@ type PostgresConnectionConfig = {
  * PostgreSQL pool configuration options.
  */
 type PostgresPoolConfig = PostgresConnectionConfig & {
-  /** Maximum number of clients in the pool (default: 10) */readonly max?: number; /** Minimum number of clients in the pool (default: 0) */
+  /** Column naming policy; snake_case maps columns both directions while preserving table names. @default "preserve" */readonly naming?: "preserve" | "snake_case"; /** Maximum number of clients in the pool (default: 10) */
+  readonly max?: number; /** Minimum number of clients in the pool (default: 0) */
   readonly min?: number; /** How long a client can sit idle before being closed (ms) */
   readonly idleTimeoutMillis?: number; /** How long to wait for a client before timing out (ms) (default: 10000) */
   readonly connectionTimeoutMillis?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../cascade/src/drivers/postgres/types.ts"],"mappings":";;AAWA;;;;;;;;;KAAY,wBAAA;EAcD,oDAZA,IAAA,WAgBM;EAAA,SAdN,IAAA,WAgBM;EAAA,SAdN,QAAA,UAiBO;EAAA,SAfP,IAAA,WAqBC;EAAA,SAnBD,QAAA;WAEA,gBAAA,WAiBsB;EAAA,SAftB,GAAA;IAAA,SAGM,kBAAA;IAAA,SACA,EAAA;IAAA,SACA,IAAA;IAAA,SACA,GAAA;EAAA,GA+BN;EAAA,SA5BA,OAAA;AAAA;AA2CkB;AAM7B;;AAN6B,KArCjB,kBAAA,GAAqB,wBAAwB;EA2CrB,mEAzCzB,GAAA,WA+CQ;EAAA,SA7CR,GAAA,WA6Ca;EAAA,SA3Cb,iBAAA,WAqCyB;EAAA,SAnCzB,uBAAA;EAqCM;;;;;;;;AASC;EATD,SA3BN,SAAA,YA0CuB;EAAA,SAxCvB,OAAA,WAwCuB;EAAA,SAtCvB,gBAAA;EA4CC;;;;;;;;;AAMS;AAMrB;;;;EAZY,SA7BD,kBAAA;AAAA;;;;KAMC,mBAAA,KAAwB,MAAA;EAgDxB,mDA9CD,IAAA,EAAM,CAAA;WAEN,QAAA,iBA8CA;EAAA,SA5CA,MAAA,EAAQ,KAAA;IAAA,SACN,IAAA;IAAA,SACA,UAAA;EAAA,IAgEF;EAAA,SA7DA,OAAA;AAAA;;;AAiE4B;KA3D3B,sBAAA;;;;KAMA,0BAAA;EA+DD,mDA7DA,cAAA,GAAiB,sBAAsB,EA+D9B;EAAA,SA7DT,QAAA,YAmEC;EAAA,SAjED,UAAA;AAAA;;;;KAMC,iBAAA;EAmED,2DAjEA,KAAA,gGAqEA;EAAA,SAlEA,IAAA,UAoEO;EAAA,SAlEP,IAAA,EAAM,MAAM;AAAA;;;;KAMX,mBAAA;kEAED,OAAA;WAEA,IAAA;WAcA,MAAA;WAEA,QAAA;WAEA,KAAA;WAEA,GAAA;WAEA,QAAA;WAEA,MAAA,GAAS,mBAAmB;AAAA;;;;KAM3B,oBAAA;8BAED,OAAA;WAEA,OAAA;WAEA,SAAA;AAAA;;;;KAMC,mBAAA;4CAED,MAAA;WAEA,SAAA;WAEA,KAAA;WAEA,MAAA;WAEA,MAAA;WAEA,IAAA;WAEA,OAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../cascade/src/drivers/postgres/types.ts"],"mappings":";;AAWA;;;;;;;;;KAAY,wBAAA;EAcD,oDAZA,IAAA,WAgBM;EAAA,SAdN,IAAA,WAgBM;EAAA,SAdN,QAAA,UAiBO;EAAA,SAfP,IAAA,WAqBC;EAAA,SAnBD,QAAA;WAEA,gBAAA,WAiBsB;EAAA,SAftB,GAAA;IAAA,SAGM,kBAAA;IAAA,SACA,EAAA;IAAA,SACA,IAAA;IAAA,SACA,GAAA;EAAA,GA+BN;EAAA,SA5BA,OAAA;AAAA;;AA6CkB;AAM7B;KA7CY,kBAAA,GAAqB,wBAAwB;EA6C1B,+HA3CpB,MAAA,8BA6CM;EAAA,SA3CN,GAAA,WA+Ca;EAAA,SA7Cb,GAAA,WAuCqB;EAAA,SArCrB,iBAAA,WAuCA;EAAA,SArCA,uBAAA;EAuCA;;;;;;;AAOO;AAMlB;EAbW,SA7BA,SAAA;WAEA,OAAA,WAwCuB;EAAA,SAtCvB,gBAAA;EA4C2B;;;;;;;;AAMjB;AAMrB;;;;;EAZsC,SA7B3B,kBAAA;AAAA;;;AAgDY;KA1CX,mBAAA,KAAwB,MAAA;EAgDL,mDA9CpB,IAAA,EAAM,CAAA,IA0EsB;EAAA,SAxE5B,QAAA,iBAgDA;EAAA,SA9CA,MAAA,EAAQ,KAAA;IAAA,SACN,IAAA;IAAA,SACA,UAAA;EAAA,IAkEF;EAAA,SA/DA,OAAA;AAAA;;AAiE4B;AAMvC;KAjEY,sBAAA;;;;KAMA,0BAAA;EAiED,mDA/DA,cAAA,GAAiB,sBAAsB,EA+D9B;EAAA,SA7DT,QAAA,YAmEoB;EAAA,SAjEpB,UAAA;AAAA;;;;KAMC,iBAAA;EAqED,2DAnEA,KAAA,gGAuEA;EAAA,SApEA,IAAA,UAoEO;EAAA,SAlEP,IAAA,EAAM,MAAM;AAAA;;;;KAMX,mBAAA;kEAED,OAAA;WAEA,IAAA;WAcA,MAAA;WAEA,QAAA;WAEA,KAAA;WAEA,GAAA;WAEA,QAAA;WAEA,MAAA,GAAS,mBAAmB;AAAA;;;;KAM3B,oBAAA;8BAED,OAAA;WAEA,OAAA;WAEA,SAAA;AAAA;;;;KAMC,mBAAA;4CAED,MAAA;WAEA,SAAA;WAEA,KAAA;WAEA,MAAA;WAEA,MAAA;WAEA,IAAA;WAEA,OAAA;AAAA"}

package/esm/index.d.mts

@@ -65,14 +65,14 @@ import { ExportMigrationsSQLOptions, PendingMigration, RollbackMigrationsOptions
 import { MongoMigrationDriver } from "./drivers/mongodb/mongodb-migration-driver.mjs";
 import { SqlDialectContract } from "./drivers/sql/sql-dialect.contract.mjs";
 import { SqlAggregateFunction, SqlDeleteOperation, SqlGroupClause, SqlHavingClause, SqlInsertOperation, SqlJoinClause, SqlJoinType, SqlOrderClause, SqlQueryConfig, SqlQueryResult, SqlSelectClause, SqlUpdateOperation, SqlWhereOperation, SqlWhereType } from "./drivers/sql/sql-types.mjs";
-import { PostgresDialect, escapeSqlLiteral } from "./drivers/postgres/postgres-dialect.mjs";
+import { PostgresDialect, PostgresDialectOptions, PostgresNaming, escapeSqlLiteral } from "./drivers/postgres/postgres-dialect.mjs";
 import { PostgresConnectionConfig, PostgresCopyOptions, PostgresIsolationLevel, PostgresNotification, PostgresOperation, PostgresPoolConfig, PostgresQueryResult, PostgresTransactionOptions, PostgresWhereClause } from "./drivers/postgres/types.mjs";
-import { PostgresDriver, buildPostgresPoolConfig } from "./drivers/postgres/postgres-driver.mjs";
+import { PostgresDriver, buildPostgresPoolConfig, parsePostgresInt8 } from "./drivers/postgres/postgres-driver.mjs";
 import { PostgresBlueprint } from "./drivers/postgres/postgres-blueprint.mjs";
 import { PostgresMigrationDriver } from "./drivers/postgres/postgres-migration-driver.mjs";
 import { PostgresQueryBuilder } from "./drivers/postgres/postgres-query-builder.mjs";
 import { PostgresOperationType, PostgresParserOperation, PostgresParserOptions, PostgresQueryParser } from "./drivers/postgres/postgres-query-parser.mjs";
 import { MongoClientOptions, TransactionOptions } from "mongodb";
-export { $agg, $expr, AggregateExpression, AggregateFunction, AlterSchema, ArithmeticExpression, AtomicUpdate, AtomicUpdateOptions, type BaseQueryRuleOptions, type BaseUniqueRuleOptions, BelongsTo, BelongsToMany, type BelongsToManyOptions, type BelongsToOptions, BuildUpdateOperationsResult, type ChildModel, ChunkCallback, ColumnBuilder, ColumnDefinition, ColumnExpression, ColumnExpressionInput, ColumnExpressionType, ColumnMap, ColumnRefExpression, ColumnType, ConnectionOptions, CreateDatabaseOptions, CreateDatabaseResult, CursorPaginationOptions, CursorPaginationResult, DEFAULT_MAX_SYNC_DEPTH, DataSource, DataSourceOptions, DataSourceRegistryEvent, DataSourceRegistryListener, DatabaseDirtyTracker, DatabaseDriver, DatabaseRemover, DatabaseRestorer, DatabaseWriter, DatabaseWriterValidationError, DefineModelOptions, DeleteStrategy, DetachedColumnBuilder, DriverAtomicUpdateOptions, DriverContract, DriverEvent, DriverEventListener, DriverQuery, DriverTransactionContract, DropAllTablesResult, DropDatabaseOptions, type EmbedKey, type ExistsRuleOptions, ExportMigrationsSQLOptions, FindOneAndUpdateOptions, ForeignKeyBuilder, ForeignKeyDefinition, FullTextIndexOptions, GenerateIdOptions, GeoIndexOptions, type GlobalScopeDefinition, type GlobalScopeOptions, GroupByInput, HasMany, type HasManyOptions, HasOne, type HasOneOptions, HavingInput, IdGeneratorContract, IndexDefinition, IndexEntry, InsertResult, JoinOptions, LeanDocument, LiteralExpression, type LoadedRelationResult, type LoadedRelationsMap, type LocalScopeCallback, LockForUpdateOptions, Migration, MigrationAlterOptions, MigrationConstructor, MigrationContract, MigrationCreateOptions, MigrationDefaults, MigrationDriverContract, MigrationDriverFactory, type MigrationRecord, type MigrationResult, MigrationRunner, type MigrationRunnerOptions, type MigrationStatus, MigrationStep, MissingDataSourceError, Model, ModelDefaultConfig, ModelDefaults, ModelEventListener, ModelEventName, ModelEvents, ModelRef, type ModelSchema, type ModelSnapshot, type ModelSyncConfig, type ModelSyncContract, ModelSyncOperation, type ModelSyncOperationContract, ModelTransformCallback, ModelType, type MongoClientOptions, MongoDbDriver, MongoDriverOptions, MongoIdGenerator, MongoMigrationDriver, MongoQueryBuilder, MongoSyncAdapter, NamingConvention, OnDeletedEventContext, Operation, OperationType, OrderDirection, PaginationOptions, PaginationResult, PendingMigration, PendingOperation, PipelineStage, type PivotData, type PivotIds, PivotOperations, PostgresBlueprint, PostgresConnectionConfig, PostgresCopyOptions, PostgresDialect, PostgresDriver, PostgresIsolationLevel, PostgresMigrationDriver, PostgresNotification, PostgresOperation, PostgresOperationType, PostgresParserOperation, PostgresParserOptions, PostgresPoolConfig, PostgresQueryBuilder, PostgresQueryParser, PostgresQueryResult, PostgresTransactionOptions, PostgresWhereClause, QueryBuilderContract, RELATION_METADATA_KEY, RawColumnExpression, RawExpression, RawQueryResult, RegisterModel, RegisterModelOptions, type RelationConstraintCallback, type RelationConstraints, RelationDefaults, type RelationDefinition, type RelationDefinitions, RelationHydrator, RelationLoader, type RelationType, RemoverContract, RemoverOptions, RemoverResult, RestorerContract, RestorerOptions, RestorerResult, RollbackMigrationsOptions, type RollbackOptions, type RunMigrationsOptions, type ScopeTiming, type SerializedRelation, SqlAggregateFunction, SqlDeleteOperation, SqlDialectContract, SqlGroupClause, SqlHavingClause, SqlInsertOperation, SqlJoinClause, SqlJoinType, SqlOrderClause, SqlQueryConfig, SqlQueryResult, SqlSelectClause, SqlUpdateOperation, SqlWhereOperation, SqlWhereType, StrictMode, SyncAdapterContract, type SyncConfig, type SyncContext, SyncContextManager, type SyncEventPayload, SyncInstruction, type SyncInstructionOptions, SyncManager, type SyncResult, type TableIndexInformation, TransactionContext, type TransactionOptions, TransactionRollbackError, UndefinedWhereValueError, UniqueEntry, type UniqueRuleOptions, UnsafeFilterError, UnsafeRawExpressionError, UnsupportedLeanOperationError, UnsupportedQueryOperationError, UnsupportedUpdateOperationError, UnwindOptions, UpdateOperations, UpdatePipeline, UpdateResult, UuidStrategy, VectorIndexOptions, WhereCallback, WhereObject, WhereOperator, WriterContract, WriterOptions, WriterResult, afterCommit, arrayBigInt, arrayBoolean, arrayDate, arrayDecimal, arrayFloat, arrayInt, arrayJson, arrayText, arrayTimestamp, arrayUuid, assertDefined, bigInt, bigInteger, binary, blobCol, boolCol as bool, boolCol, buildPostgresPoolConfig, char, cleanupModelsRegistery, connectToDatabase, createDatabase, createPivotOperations, dataSourceRegistry, databaseDataSourceContext, databaseTransactionContext, date, dateTime, decimal, defineModel, double, dropAllTables, enumCol, escapeRegex, escapeSqlLiteral, exportMigrationsSQL, float, freshMigrate, geometry, getAllModelsFromRegistry, getDatabaseDriver, getModelFromRegistry, globalModelEvents, inferMigrationName, int, integer, ipAddress, isAggregateExpression, isColumnExpression, isMongoDBDriverLoaded, json, likePatternToRegexSource, lineString, listExecutedMigrations, listPendingMigrations, longText, macAddress, mediumText, migrate, migrationRunner, modelSync, objectCol, onceConnected, onceDisconnected, point, polygon, registerModelInRegistry, removeModelFromRegistery, requireModelClass, resolveLikePattern, resolveModelClass, resolveModelName, rollbackMigrations, runMigrations, sanitizeFilter, sanitizeFilterValue, setCol, smallInt, smallInteger, string, text, time, timestamp, tinyInt, tinyInteger, toColumnExpression, transaction, tryResolveModelClass, ulid, useModelTransformer, uuid, vector, verifyRegisteredRelations, year };
+export { $agg, $expr, AggregateExpression, AggregateFunction, AlterSchema, ArithmeticExpression, AtomicUpdate, AtomicUpdateOptions, type BaseQueryRuleOptions, type BaseUniqueRuleOptions, BelongsTo, BelongsToMany, type BelongsToManyOptions, type BelongsToOptions, BuildUpdateOperationsResult, type ChildModel, ChunkCallback, ColumnBuilder, ColumnDefinition, ColumnExpression, ColumnExpressionInput, ColumnExpressionType, ColumnMap, ColumnRefExpression, ColumnType, ConnectionOptions, CreateDatabaseOptions, CreateDatabaseResult, CursorPaginationOptions, CursorPaginationResult, DEFAULT_MAX_SYNC_DEPTH, DataSource, DataSourceOptions, DataSourceRegistryEvent, DataSourceRegistryListener, DatabaseDirtyTracker, DatabaseDriver, DatabaseRemover, DatabaseRestorer, DatabaseWriter, DatabaseWriterValidationError, DefineModelOptions, DeleteStrategy, DetachedColumnBuilder, DriverAtomicUpdateOptions, DriverContract, DriverEvent, DriverEventListener, DriverQuery, DriverTransactionContract, DropAllTablesResult, DropDatabaseOptions, type EmbedKey, type ExistsRuleOptions, ExportMigrationsSQLOptions, FindOneAndUpdateOptions, ForeignKeyBuilder, ForeignKeyDefinition, FullTextIndexOptions, GenerateIdOptions, GeoIndexOptions, type GlobalScopeDefinition, type GlobalScopeOptions, GroupByInput, HasMany, type HasManyOptions, HasOne, type HasOneOptions, HavingInput, IdGeneratorContract, IndexDefinition, IndexEntry, InsertResult, JoinOptions, LeanDocument, LiteralExpression, type LoadedRelationResult, type LoadedRelationsMap, type LocalScopeCallback, LockForUpdateOptions, Migration, MigrationAlterOptions, MigrationConstructor, MigrationContract, MigrationCreateOptions, MigrationDefaults, MigrationDriverContract, MigrationDriverFactory, type MigrationRecord, type MigrationResult, MigrationRunner, type MigrationRunnerOptions, type MigrationStatus, MigrationStep, MissingDataSourceError, Model, ModelDefaultConfig, ModelDefaults, ModelEventListener, ModelEventName, ModelEvents, ModelRef, type ModelSchema, type ModelSnapshot, type ModelSyncConfig, type ModelSyncContract, ModelSyncOperation, type ModelSyncOperationContract, ModelTransformCallback, ModelType, type MongoClientOptions, MongoDbDriver, MongoDriverOptions, MongoIdGenerator, MongoMigrationDriver, MongoQueryBuilder, MongoSyncAdapter, NamingConvention, OnDeletedEventContext, Operation, OperationType, OrderDirection, PaginationOptions, PaginationResult, PendingMigration, PendingOperation, PipelineStage, type PivotData, type PivotIds, PivotOperations, PostgresBlueprint, PostgresConnectionConfig, PostgresCopyOptions, PostgresDialect, PostgresDialectOptions, PostgresDriver, PostgresIsolationLevel, PostgresMigrationDriver, PostgresNaming, PostgresNotification, PostgresOperation, PostgresOperationType, PostgresParserOperation, PostgresParserOptions, PostgresPoolConfig, PostgresQueryBuilder, PostgresQueryParser, PostgresQueryResult, PostgresTransactionOptions, PostgresWhereClause, QueryBuilderContract, RELATION_METADATA_KEY, RawColumnExpression, RawExpression, RawQueryResult, RegisterModel, RegisterModelOptions, type RelationConstraintCallback, type RelationConstraints, RelationDefaults, type RelationDefinition, type RelationDefinitions, RelationHydrator, RelationLoader, type RelationType, RemoverContract, RemoverOptions, RemoverResult, RestorerContract, RestorerOptions, RestorerResult, RollbackMigrationsOptions, type RollbackOptions, type RunMigrationsOptions, type ScopeTiming, type SerializedRelation, SqlAggregateFunction, SqlDeleteOperation, SqlDialectContract, SqlGroupClause, SqlHavingClause, SqlInsertOperation, SqlJoinClause, SqlJoinType, SqlOrderClause, SqlQueryConfig, SqlQueryResult, SqlSelectClause, SqlUpdateOperation, SqlWhereOperation, SqlWhereType, StrictMode, SyncAdapterContract, type SyncConfig, type SyncContext, SyncContextManager, type SyncEventPayload, SyncInstruction, type SyncInstructionOptions, SyncManager, type SyncResult, type TableIndexInformation, TransactionContext, type TransactionOptions, TransactionRollbackError, UndefinedWhereValueError, UniqueEntry, type UniqueRuleOptions, UnsafeFilterError, UnsafeRawExpressionError, UnsupportedLeanOperationError, UnsupportedQueryOperationError, UnsupportedUpdateOperationError, UnwindOptions, UpdateOperations, UpdatePipeline, UpdateResult, UuidStrategy, VectorIndexOptions, WhereCallback, WhereObject, WhereOperator, WriterContract, WriterOptions, WriterResult, afterCommit, arrayBigInt, arrayBoolean, arrayDate, arrayDecimal, arrayFloat, arrayInt, arrayJson, arrayText, arrayTimestamp, arrayUuid, assertDefined, bigInt, bigInteger, binary, blobCol, boolCol as bool, boolCol, buildPostgresPoolConfig, char, cleanupModelsRegistery, connectToDatabase, createDatabase, createPivotOperations, dataSourceRegistry, databaseDataSourceContext, databaseTransactionContext, date, dateTime, decimal, defineModel, double, dropAllTables, enumCol, escapeRegex, escapeSqlLiteral, exportMigrationsSQL, float, freshMigrate, geometry, getAllModelsFromRegistry, getDatabaseDriver, getModelFromRegistry, globalModelEvents, inferMigrationName, int, integer, ipAddress, isAggregateExpression, isColumnExpression, isMongoDBDriverLoaded, json, likePatternToRegexSource, lineString, listExecutedMigrations, listPendingMigrations, longText, macAddress, mediumText, migrate, migrationRunner, modelSync, objectCol, onceConnected, onceDisconnected, parsePostgresInt8, point, polygon, registerModelInRegistry, removeModelFromRegistery, requireModelClass, resolveLikePattern, resolveModelClass, resolveModelName, rollbackMigrations, runMigrations, sanitizeFilter, sanitizeFilterValue, setCol, smallInt, smallInteger, string, text, time, timestamp, tinyInt, tinyInteger, toColumnExpression, transaction, tryResolveModelClass, ulid, useModelTransformer, uuid, vector, verifyRegisteredRelations, year };
 import "./validation/plugins/database-rules-plugin.mjs";
 import "./validation/plugins/embed-validator-plugin.mjs";

package/esm/index.mjs

@@ -43,7 +43,7 @@ import { PostgresDialect, escapeSqlLiteral } from "./drivers/postgres/postgres-d
 import { PostgresMigrationDriver } from "./drivers/postgres/postgres-migration-driver.mjs";
 import { PostgresQueryParser } from "./drivers/postgres/postgres-query-parser.mjs";
 import { PostgresQueryBuilder } from "./drivers/postgres/postgres-query-builder.mjs";
-import { PostgresDriver, buildPostgresPoolConfig } from "./drivers/postgres/postgres-driver.mjs";
+import { PostgresDriver, buildPostgresPoolConfig, parsePostgresInt8 } from "./drivers/postgres/postgres-driver.mjs";
 import "./drivers/postgres/index.mjs";
 import { connectToDatabase, getDatabaseDriver, transaction } from "./utils/connect-to-database.mjs";
 import { useModelTransformer } from "./utils/database-writer.utils.mjs";
@@ -59,4 +59,4 @@ import { createDatabase, dropAllTables } from "./operations/database.mjs";
 import { exportMigrationsSQL, freshMigrate, listExecutedMigrations, listPendingMigrations, rollbackMigrations, runMigrations } from "./operations/migrations.mjs";
 import "./operations/index.mjs";
 
-export { $agg, $expr, BelongsTo, BelongsToMany, ColumnBuilder, DEFAULT_MAX_SYNC_DEPTH, DataSource, DatabaseDirtyTracker, DatabaseRemover, DatabaseRestorer, DatabaseWriter, DatabaseWriterValidationError, DetachedColumnBuilder, ForeignKeyBuilder, HasMany, HasOne, Migration, MigrationRunner, MissingDataSourceError, Model, ModelEvents, ModelSyncOperation, MongoDbDriver, MongoIdGenerator, MongoMigrationDriver, MongoQueryBuilder, MongoSyncAdapter, PivotOperations, PostgresBlueprint, PostgresDialect, PostgresDriver, PostgresMigrationDriver, PostgresQueryBuilder, PostgresQueryParser, RELATION_METADATA_KEY, RegisterModel, RelationHydrator, RelationLoader, SyncContextManager, SyncManager, TransactionRollbackError, UndefinedWhereValueError, UnsafeFilterError, UnsafeRawExpressionError, UnsupportedLeanOperationError, UnsupportedQueryOperationError, UnsupportedUpdateOperationError, afterCommit, arrayBigInt, arrayBoolean, arrayDate, arrayDecimal, arrayFloat, arrayInt, arrayJson, arrayText, arrayTimestamp, arrayUuid, assertDefined, bigInt, bigInteger, binary, blobCol, boolCol as bool, boolCol, buildPostgresPoolConfig, char, cleanupModelsRegistery, connectToDatabase, createDatabase, createPivotOperations, dataSourceRegistry, databaseDataSourceContext, databaseTransactionContext, date, dateTime, decimal, defineModel, double, dropAllTables, enumCol, escapeRegex, escapeSqlLiteral, exportMigrationsSQL, float, freshMigrate, geometry, getAllModelsFromRegistry, getDatabaseDriver, getModelFromRegistry, globalModelEvents, inferMigrationName, int, integer, ipAddress, isAggregateExpression, isColumnExpression, isMongoDBDriverLoaded, json, likePatternToRegexSource, lineString, listExecutedMigrations, listPendingMigrations, longText, macAddress, mediumText, migrate, migrationRunner, modelSync, objectCol, onceConnected, onceDisconnected, point, polygon, registerModelInRegistry, removeModelFromRegistery, requireModelClass, resolveLikePattern, resolveModelClass, resolveModelName, rollbackMigrations, runMigrations, sanitizeFilter, sanitizeFilterValue, setCol, smallInt, smallInteger, string, text, time, timestamp, tinyInt, tinyInteger, toColumnExpression, transaction, tryResolveModelClass, ulid, useModelTransformer, uuid, vector, verifyRegisteredRelations, year };
+export { $agg, $expr, BelongsTo, BelongsToMany, ColumnBuilder, DEFAULT_MAX_SYNC_DEPTH, DataSource, DatabaseDirtyTracker, DatabaseRemover, DatabaseRestorer, DatabaseWriter, DatabaseWriterValidationError, DetachedColumnBuilder, ForeignKeyBuilder, HasMany, HasOne, Migration, MigrationRunner, MissingDataSourceError, Model, ModelEvents, ModelSyncOperation, MongoDbDriver, MongoIdGenerator, MongoMigrationDriver, MongoQueryBuilder, MongoSyncAdapter, PivotOperations, PostgresBlueprint, PostgresDialect, PostgresDriver, PostgresMigrationDriver, PostgresQueryBuilder, PostgresQueryParser, RELATION_METADATA_KEY, RegisterModel, RelationHydrator, RelationLoader, SyncContextManager, SyncManager, TransactionRollbackError, UndefinedWhereValueError, UnsafeFilterError, UnsafeRawExpressionError, UnsupportedLeanOperationError, UnsupportedQueryOperationError, UnsupportedUpdateOperationError, afterCommit, arrayBigInt, arrayBoolean, arrayDate, arrayDecimal, arrayFloat, arrayInt, arrayJson, arrayText, arrayTimestamp, arrayUuid, assertDefined, bigInt, bigInteger, binary, blobCol, boolCol as bool, boolCol, buildPostgresPoolConfig, char, cleanupModelsRegistery, connectToDatabase, createDatabase, createPivotOperations, dataSourceRegistry, databaseDataSourceContext, databaseTransactionContext, date, dateTime, decimal, defineModel, double, dropAllTables, enumCol, escapeRegex, escapeSqlLiteral, exportMigrationsSQL, float, freshMigrate, geometry, getAllModelsFromRegistry, getDatabaseDriver, getModelFromRegistry, globalModelEvents, inferMigrationName, int, integer, ipAddress, isAggregateExpression, isColumnExpression, isMongoDBDriverLoaded, json, likePatternToRegexSource, lineString, listExecutedMigrations, listPendingMigrations, longText, macAddress, mediumText, migrate, migrationRunner, modelSync, objectCol, onceConnected, onceDisconnected, parsePostgresInt8, point, polygon, registerModelInRegistry, removeModelFromRegistery, requireModelClass, resolveLikePattern, resolveModelClass, resolveModelName, rollbackMigrations, runMigrations, sanitizeFilter, sanitizeFilterValue, setCol, smallInt, smallInteger, string, text, time, timestamp, tinyInt, tinyInteger, toColumnExpression, transaction, tryResolveModelClass, ulid, useModelTransformer, uuid, vector, verifyRegisteredRelations, year };

package/esm/model/model.d.mts

@@ -7,7 +7,7 @@ import { PivotOperations } from "../relations/pivot-operations.mjs";
 import { ModelSnapshot } from "../relations/relation-hydrator.mjs";
 import { ModelSyncOperationContract } from "../sync/types.mjs";
 import { CreateManyOptions } from "./methods/write-methods.mjs";
-import { PaginationOptions, PaginationResult, QueryBuilderContract, WhereCallback, WhereObject, WhereOperator } from "../contracts/query-builder.contract.mjs";
+import { PaginationOptions, PaginationResult, QueryBuilderContract, RawExpression, WhereCallback, WhereObject, WhereOperator } from "../contracts/query-builder.contract.mjs";
 import { AtomicUpdate, AtomicUpdateOptions, DriverContract, FindOneAndUpdateOptions, RawQueryResult } from "../contracts/database-driver.contract.mjs";
 import { RemoverResult } from "../contracts/database-remover.contract.mjs";
 import { WriterOptions } from "../contracts/database-writer.contract.mjs";
@@ -1237,6 +1237,10 @@ declare abstract class Model<TSchema extends ModelSchema = ModelSchema> {
   static where<TModel extends Model = Model>(this: ChildModel<TModel>, field: string, operator: WhereOperator, value: unknown): QueryBuilderContract<TModel>;
   static where<TModel extends Model = Model>(this: (new (...args: any[]) => TModel) & Pick<typeof Model, "query" | "getDataSource" | "table">, conditions: WhereObject): QueryBuilderContract<TModel>;
   static where<TModel extends Model = Model>(this: (new (...args: any[]) => TModel) & Pick<typeof Model, "query" | "getDataSource" | "table">, callback: WhereCallback<TModel>): QueryBuilderContract<TModel>;
+  /**
+   * Use a raw where clause directly.
+   */
+  static whereRaw<TModel extends Model = Model>(this: ChildModel<TModel>, expression: RawExpression, bindings?: unknown[]): QueryBuilderContract<TModel>;
   /**
    * Count the number of records in the table
    * @param filter - The filter to apply to the query