effect-qb 0.14.0 → 0.15.0

package/src/mysql/internal/sql-expression-renderer.ts

@@ -0,0 +1,1455 @@
+import * as Query from "../../internal/query.js"
+import * as Expression from "../../internal/scalar.js"
+import * as Table from "../../internal/table.js"
+import * as QueryAst from "../../internal/query-ast.js"
+import type { RenderState, SqlDialect } from "../../internal/dialect.js"
+import * as ExpressionAst from "../../internal/expression-ast.js"
+import * as JsonPath from "../../internal/json/path.js"
+import { flattenSelection, type Projection } from "../../internal/projections.js"
+import { type SelectionValue, validateAggregationSelection } from "../../internal/aggregation-validation.js"
+import * as SchemaExpression from "../../internal/schema-expression.js"
+import type { DdlExpressionLike } from "../../internal/table-options.js"
+
+const renderDbType = (
+  dialect: SqlDialect,
+  dbType: Expression.DbType.Any
+): string => {
+  if (dialect.name === "mysql" && dbType.dialect === "mysql" && dbType.kind === "uuid") {
+    return "char(36)"
+  }
+  return dbType.kind
+}
+
+const renderCastType = (
+  dialect: SqlDialect,
+  dbType: Expression.DbType.Any
+): string => {
+  if (dialect.name !== "mysql") {
+    return dbType.kind
+  }
+  switch (dbType.kind) {
+    case "text":
+      return "char"
+    case "uuid":
+      return "char(36)"
+    case "numeric":
+      return "decimal"
+    case "timestamp":
+      return "datetime"
+    case "bool":
+    case "boolean":
+      return "boolean"
+    case "json":
+      return "json"
+    default:
+      return dbType.kind
+  }
+}
+
+const renderDdlExpression = (
+  expression: DdlExpressionLike,
+  state: RenderState,
+  dialect: SqlDialect
+): string =>
+  SchemaExpression.isSchemaExpression(expression)
+    ? SchemaExpression.render(expression)
+    : renderExpression(expression, state, dialect)
+
+const renderMysqlMutationLimit = (
+  expression: Expression.Any,
+  state: RenderState,
+  dialect: SqlDialect
+): string => {
+  const ast = (expression as Expression.Any & {
+    readonly [ExpressionAst.TypeId]: ExpressionAst.Any
+  })[ExpressionAst.TypeId]
+  if (ast.kind === "literal" && typeof ast.value === "number" && Number.isInteger(ast.value) && ast.value >= 0) {
+    return String(ast.value)
+  }
+  return renderExpression(expression, state, dialect)
+}
+
+const renderColumnDefinition = (
+  dialect: SqlDialect,
+  state: RenderState,
+  columnName: string,
+  column: Table.AnyTable[typeof Table.TypeId]["fields"][string]
+): string => {
+  const clauses = [
+    dialect.quoteIdentifier(columnName),
+    column.metadata.ddlType ?? renderDbType(dialect, column.metadata.dbType)
+  ]
+  if (column.metadata.identity) {
+    clauses.push(`generated ${column.metadata.identity.generation === "byDefault" ? "by default" : "always"} as identity`)
+  } else if (column.metadata.generatedValue) {
+    clauses.push(`generated always as (${renderDdlExpression(column.metadata.generatedValue, state, dialect)}) stored`)
+  } else if (column.metadata.defaultValue) {
+    clauses.push(`default ${renderDdlExpression(column.metadata.defaultValue, state, dialect)}`)
+  }
+  if (!column.metadata.nullable) {
+    clauses.push("not null")
+  }
+  return clauses.join(" ")
+}
+
+const renderCreateTableSql = (
+  targetSource: QueryAst.FromClause,
+  state: RenderState,
+  dialect: SqlDialect,
+  ifNotExists: boolean
+): string => {
+  const table = targetSource.source as Table.AnyTable
+  const fields = table[Table.TypeId].fields
+  const definitions = Object.entries(fields).map(([columnName, column]) =>
+    renderColumnDefinition(dialect, state, columnName, column)
+  )
+  for (const option of table[Table.OptionsSymbol]) {
+    switch (option.kind) {
+      case "primaryKey":
+        definitions.push(`${option.name ? `constraint ${dialect.quoteIdentifier(option.name)} ` : ""}primary key (${option.columns.map((column) => dialect.quoteIdentifier(column)).join(", ")})${option.deferrable ? ` deferrable${option.initiallyDeferred ? " initially deferred" : ""}` : ""}`)
+        break
+      case "unique":
+        definitions.push(`${option.name ? `constraint ${dialect.quoteIdentifier(option.name)} ` : ""}unique${option.nullsNotDistinct ? " nulls not distinct" : ""} (${option.columns.map((column) => dialect.quoteIdentifier(column)).join(", ")})${option.deferrable ? ` deferrable${option.initiallyDeferred ? " initially deferred" : ""}` : ""}`)
+        break
+      case "foreignKey": {
+        const reference = option.references()
+        definitions.push(
+          `${option.name ? `constraint ${dialect.quoteIdentifier(option.name)} ` : ""}foreign key (${option.columns.map((column) => dialect.quoteIdentifier(column)).join(", ")}) references ${dialect.renderTableReference(reference.tableName, reference.tableName, reference.schemaName)} (${reference.columns.map((column) => dialect.quoteIdentifier(column)).join(", ")})${option.onDelete ? ` on delete ${option.onDelete.replace(/[A-Z]/g, (value) => ` ${value.toLowerCase()}`).trim()}` : ""}${option.onUpdate ? ` on update ${option.onUpdate.replace(/[A-Z]/g, (value) => ` ${value.toLowerCase()}`).trim()}` : ""}${option.deferrable ? ` deferrable${option.initiallyDeferred ? " initially deferred" : ""}` : ""}`
+        )
+        break
+      }
+      case "check":
+        definitions.push(
+          `constraint ${dialect.quoteIdentifier(option.name)} check (${renderDdlExpression(option.predicate, state, dialect)})${option.noInherit ? " no inherit" : ""}`
+        )
+        break
+      case "index":
+        break
+    }
+  }
+  return `create table${ifNotExists ? " if not exists" : ""} ${renderSourceReference(targetSource.source, targetSource.tableName, targetSource.baseTableName, state, dialect)} (${definitions.join(", ")})`
+}
+
+const renderCreateIndexSql = (
+  targetSource: QueryAst.FromClause,
+  ddl: Extract<QueryAst.DdlClause, { readonly kind: "createIndex" }>,
+  state: RenderState,
+  dialect: SqlDialect
+): string => {
+  const maybeIfNotExists = dialect.name === "postgres" && ddl.ifNotExists ? " if not exists" : ""
+  return `create${ddl.unique ? " unique" : ""} index${maybeIfNotExists} ${dialect.quoteIdentifier(ddl.name)} on ${renderSourceReference(targetSource.source, targetSource.tableName, targetSource.baseTableName, state, dialect)} (${ddl.columns.map((column) => dialect.quoteIdentifier(column)).join(", ")})`
+}
+
+const renderDropIndexSql = (
+  targetSource: QueryAst.FromClause,
+  ddl: Extract<QueryAst.DdlClause, { readonly kind: "dropIndex" }>,
+  state: RenderState,
+  dialect: SqlDialect
+): string =>
+  dialect.name === "postgres"
+    ? `drop index${ddl.ifExists ? " if exists" : ""} ${dialect.quoteIdentifier(ddl.name)}`
+    : `drop index ${dialect.quoteIdentifier(ddl.name)} on ${renderSourceReference(targetSource.source, targetSource.tableName, targetSource.baseTableName, state, dialect)}`
+
+const isExpression = (value: unknown): value is Expression.Any =>
+  value !== null && typeof value === "object" && Expression.TypeId in value
+
+const isJsonDbType = (dbType: Expression.DbType.Any): boolean =>
+  dbType.kind === "jsonb" || dbType.kind === "json" || ("variant" in dbType && dbType.variant === "json")
+
+const isJsonExpression = (value: unknown): value is Expression.Any =>
+  isExpression(value) && isJsonDbType(value[Expression.TypeId].dbType)
+
+const unsupportedJsonFeature = (
+  dialect: SqlDialect,
+  feature: string
+): never => {
+  const error = new Error(`Unsupported JSON feature for ${dialect.name}: ${feature}`) as Error & {
+    readonly tag: string
+    readonly dialect: string
+    readonly feature: string
+  }
+  Object.assign(error, {
+    tag: `@${dialect.name}/unsupported/json-feature`,
+    dialect: dialect.name,
+    feature
+  })
+  throw error
+}
+
+const extractJsonBase = (node: Record<string, unknown>): unknown =>
+  node.value ?? node.base ?? node.input ?? node.left ?? node.target
+
+const isJsonPathValue = (value: unknown): value is JsonPath.Path<any> =>
+  value !== null && typeof value === "object" && JsonPath.TypeId in value
+
+const extractJsonPathSegments = (node: Record<string, unknown>): ReadonlyArray<JsonPath.AnySegment> => {
+  const path = node.path ?? node.segments ?? node.keys
+  if (isJsonPathValue(path)) {
+    return path.segments
+  }
+  if (Array.isArray(path)) {
+    return path as readonly JsonPath.AnySegment[]
+  }
+  if ("key" in node) {
+    return [JsonPath.key(String(node.key))]
+  }
+  if ("segment" in node) {
+    const segment = node.segment
+    if (typeof segment === "string") {
+      return [JsonPath.key(segment)]
+    }
+    if (typeof segment === "number") {
+      return [JsonPath.index(segment)]
+    }
+    if (segment !== null && typeof segment === "object" && JsonPath.SegmentTypeId in segment) {
+      return [segment as JsonPath.AnySegment]
+    }
+    return []
+  }
+  if ("right" in node && isJsonPathValue(node.right)) {
+    return node.right.segments
+  }
+  return []
+}
+
+const extractJsonValue = (node: Record<string, unknown>): unknown =>
+  node.newValue ?? node.insert ?? node.right
+
+const renderJsonPathSegment = (segment: JsonPath.AnySegment | string | number): string => {
+  if (typeof segment === "string") {
+    return /^[A-Za-z_][A-Za-z0-9_]*$/.test(segment)
+      ? `.${segment}`
+      : `."${segment.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`
+  }
+  if (typeof segment === "number") {
+    return `[${segment}]`
+  }
+  switch (segment.kind) {
+    case "key":
+      return /^[A-Za-z_][A-Za-z0-9_]*$/.test(segment.key)
+        ? `.${segment.key}`
+        : `."${segment.key.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`
+    case "index":
+      return `[${segment.index}]`
+    case "wildcard":
+      return "[*]"
+    case "slice":
+      return `[${segment.start ?? 0} to ${segment.end ?? "last"}]`
+    case "descend":
+      return ".**"
+    default:
+      throw new Error("Unsupported JSON path segment")
+  }
+}
+
+const renderJsonPathStringLiteral = (segments: ReadonlyArray<JsonPath.AnySegment | string | number>): string => {
+  let path = "$"
+  for (const segment of segments) {
+    path += renderJsonPathSegment(segment)
+  }
+  return path
+}
+
+const renderMySqlJsonPath = (
+  segments: ReadonlyArray<JsonPath.AnySegment | string | number>,
+  state: RenderState,
+  dialect: SqlDialect
+): string => dialect.renderLiteral(renderJsonPathStringLiteral(segments), state)
+
+const renderPostgresJsonPathArray = (
+  segments: ReadonlyArray<JsonPath.AnySegment | string | number>,
+  state: RenderState,
+  dialect: SqlDialect
+): string => `array[${segments.map((segment) => {
+  if (typeof segment === "string") {
+    return dialect.renderLiteral(segment, state)
+  }
+  if (typeof segment === "number") {
+    return dialect.renderLiteral(String(segment), state)
+  }
+  switch (segment.kind) {
+    case "key":
+      return dialect.renderLiteral(segment.key, state)
+    case "index":
+      return dialect.renderLiteral(String(segment.index), state)
+    default:
+      throw new Error("Postgres JSON traversal requires exact key/index segments")
+  }
+}).join(", ")}]`
+
+const renderPostgresTextLiteral = (
+  value: string,
+  state: RenderState,
+  dialect: SqlDialect
+): string => `cast(${dialect.renderLiteral(value, state)} as text)`
+
+const renderPostgresJsonAccessStep = (
+  segment: JsonPath.AnySegment,
+  textMode: boolean,
+  state: RenderState,
+  dialect: SqlDialect
+): string => {
+  switch (segment.kind) {
+    case "key":
+      return `${textMode ? "->>" : "->"} ${dialect.renderLiteral(segment.key, state)}`
+    case "index":
+      return `${textMode ? "->>" : "->"} ${dialect.renderLiteral(String(segment.index), state)}`
+    default:
+      throw new Error("Postgres exact JSON access requires key/index segments")
+  }
+}
+
+const renderPostgresJsonValue = (
+  value: unknown,
+  state: RenderState,
+  dialect: SqlDialect
+): string => {
+  if (!isExpression(value)) {
+    throw new Error("Expected a JSON expression")
+  }
+  const rendered = renderExpression(value, state, dialect)
+  return value[Expression.TypeId].dbType.kind === "jsonb"
+    ? rendered
+    : `cast(${rendered} as jsonb)`
+}
+
+const renderPostgresJsonKind = (
+  value: Expression.Any
+): "json" | "jsonb" => value[Expression.TypeId].dbType.kind === "jsonb" ? "jsonb" : "json"
+
+const renderJsonOpaquePath = (
+  value: unknown,
+  state: RenderState,
+  dialect: SqlDialect
+): string => {
+  if (isJsonPathValue(value)) {
+    return dialect.renderLiteral(renderJsonPathStringLiteral(value.segments), state)
+  }
+  if (typeof value === "string") {
+    return dialect.renderLiteral(value, state)
+  }
+  if (isExpression(value)) {
+    return renderExpression(value, state, dialect)
+  }
+  throw new Error("Unsupported SQL/JSON path input")
+}
+
+const renderFunctionCall = (
+  name: string,
+  args: readonly Expression.Any[],
+  state: RenderState,
+  dialect: SqlDialect
+): string => {
+  if (name === "array") {
+    return `ARRAY[${args.map((arg) => renderExpression(arg, state, dialect)).join(", ")}]`
+  }
+  if (name === "extract" && args.length === 2) {
+    const field = args[0]
+    const source = args[1]
+    if (field === undefined) {
+      throw new Error("Unsupported SQL extract expression")
+    }
+    if (source === undefined) {
+      throw new Error("Unsupported SQL extract expression")
+    }
+    const fieldRuntime = isExpression(field) && field[Expression.TypeId].dbType.kind === "text" && typeof field[Expression.TypeId].runtime === "string"
+      ? field[Expression.TypeId].runtime
+      : undefined
+    const renderedField = fieldRuntime ?? renderExpression(field, state, dialect)
+    return `extract(${renderedField} from ${renderExpression(source, state, dialect)})`
+  }
+  const renderedArgs = args.map((arg) => renderExpression(arg, state, dialect)).join(", ")
+  if (args.length === 0) {
+    switch (name) {
+      case "current_date":
+      case "current_time":
+      case "current_timestamp":
+      case "localtime":
+      case "localtimestamp":
+        return name
+      default:
+        return `${name}()`
+    }
+  }
+  return `${name}(${renderedArgs})`
+}
+
+const renderJsonExpression = (
+  expression: Expression.Any,
+  ast: Record<string, unknown>,
+  state: RenderState,
+  dialect: SqlDialect
+): string | undefined => {
+  const kind = typeof ast.kind === "string" ? ast.kind : undefined
+  if (!kind) {
+    return undefined
+  }
+
+  const base = extractJsonBase(ast)
+  const segments = extractJsonPathSegments(ast)
+  const exact = segments.every((segment) => segment.kind === "key" || segment.kind === "index")
+  const postgresExpressionKind = dialect.name === "postgres" && isJsonExpression(expression)
+    ? renderPostgresJsonKind(expression)
+    : undefined
+  const postgresBaseKind = dialect.name === "postgres" && isJsonExpression(base)
+    ? renderPostgresJsonKind(base)
+    : undefined
+
+  switch (kind) {
+    case "jsonGet":
+    case "jsonPath":
+    case "jsonAccess":
+    case "jsonTraverse":
+    case "jsonGetText":
+    case "jsonPathText":
+    case "jsonAccessText":
+    case "jsonTraverseText": {
+      if (!isExpression(base) || segments.length === 0) {
+        return undefined
+      }
+      const baseSql = renderExpression(base, state, dialect)
+      const textMode = kind.endsWith("Text") || ast.text === true || ast.asText === true
+      if (dialect.name === "postgres") {
+        if (exact) {
+          return segments.length === 1
+            ? `(${baseSql} ${renderPostgresJsonAccessStep(segments[0]!, textMode, state, dialect)})`
+            : `(${baseSql} ${textMode ? "#>>" : "#>"} ${renderPostgresJsonPathArray(segments, state, dialect)})`
+        }
+        const jsonPathLiteral = dialect.renderLiteral(renderJsonPathStringLiteral(segments), state)
+        const queried = `jsonb_path_query_first(${renderPostgresJsonValue(base, state, dialect)}, ${jsonPathLiteral})`
+        return textMode ? `(${queried} #>> '{}')` : queried
+      }
+      if (dialect.name === "mysql") {
+        const extracted = `json_extract(${baseSql}, ${renderMySqlJsonPath(segments, state, dialect)})`
+        return textMode ? `json_unquote(${extracted})` : extracted
+      }
+      return undefined
+    }
+    case "jsonHasKey":
+    case "jsonKeyExists":
+    case "jsonHasAnyKeys":
+    case "jsonHasAllKeys": {
+      if (!isExpression(base)) {
+        return undefined
+      }
+      const baseSql = dialect.name === "postgres"
+        ? renderPostgresJsonValue(base, state, dialect)
+        : renderExpression(base, state, dialect)
+      const keys = segments
+      if (keys.length === 0) {
+        return undefined
+      }
+      if (dialect.name === "postgres") {
+        if (kind === "jsonHasAnyKeys") {
+          return `(${baseSql} ?| array[${keys.map((key) => renderPostgresTextLiteral(String(key), state, dialect)).join(", ")}])`
+        }
+        if (kind === "jsonHasAllKeys") {
+          return `(${baseSql} ?& array[${keys.map((key) => renderPostgresTextLiteral(String(key), state, dialect)).join(", ")}])`
+        }
+        return `(${baseSql} ? ${renderPostgresTextLiteral(String(keys[0]!), state, dialect)})`
+      }
+      if (dialect.name === "mysql") {
+        const mode = kind === "jsonHasAllKeys" ? "all" : "one"
+        const paths = keys.map((segment) => renderMySqlJsonPath([segment], state, dialect)).join(", ")
+        return `json_contains_path(${baseSql}, ${dialect.renderLiteral(mode, state)}, ${paths})`
+      }
+      return undefined
+    }
+    case "jsonConcat":
+    case "jsonMerge": {
+      if (!isExpression(ast.left) || !isExpression(ast.right)) {
+        return undefined
+      }
+      if (dialect.name === "postgres") {
+        return `(${renderPostgresJsonValue(ast.left, state, dialect)} || ${renderPostgresJsonValue(ast.right, state, dialect)})`
+      }
+      if (dialect.name === "mysql") {
+        return `json_merge_preserve(${renderExpression(ast.left, state, dialect)}, ${renderExpression(ast.right, state, dialect)})`
+      }
+      return undefined
+    }
+    case "jsonBuildObject": {
+      const entries = Array.isArray((ast as { readonly entries?: readonly { readonly key: string; readonly value: Expression.Any }[] }).entries)
+        ? (ast as { readonly entries: readonly { readonly key: string; readonly value: Expression.Any }[] }).entries
+        : []
+      const renderedEntries = entries.flatMap((entry) => [
+        dialect.renderLiteral(entry.key, state),
+        renderExpression(entry.value, state, dialect)
+      ])
+      if (dialect.name === "postgres") {
+        return `${postgresExpressionKind === "jsonb" ? "jsonb" : "json"}_build_object(${renderedEntries.join(", ")})`
+      }
+      if (dialect.name === "mysql") {
+        return `json_object(${renderedEntries.join(", ")})`
+      }
+      return undefined
+    }
+    case "jsonBuildArray": {
+      const values = Array.isArray((ast as { readonly values?: readonly Expression.Any[] }).values)
+        ? (ast as { readonly values: readonly Expression.Any[] }).values
+        : []
+      const renderedValues = values.map((value) => renderExpression(value, state, dialect)).join(", ")
+      if (dialect.name === "postgres") {
+        return `${postgresExpressionKind === "jsonb" ? "jsonb" : "json"}_build_array(${renderedValues})`
+      }
+      if (dialect.name === "mysql") {
+        return `json_array(${renderedValues})`
+      }
+      return undefined
+    }
+    case "jsonToJson":
+      if (!isExpression(base)) {
+        return undefined
+      }
+      if (dialect.name === "postgres") {
+        return `to_json(${renderExpression(base, state, dialect)})`
+      }
+      if (dialect.name === "mysql") {
+        return `cast(${renderExpression(base, state, dialect)} as json)`
+      }
+      return undefined
+    case "jsonToJsonb":
+      if (!isExpression(base)) {
+        return undefined
+      }
+      if (dialect.name === "postgres") {
+        return `to_jsonb(${renderExpression(base, state, dialect)})`
+      }
+      if (dialect.name === "mysql") {
+        return `cast(${renderExpression(base, state, dialect)} as json)`
+      }
+      return undefined
+    case "jsonTypeOf":
+      if (!isExpression(base)) {
+        return undefined
+      }
+      if (dialect.name === "postgres") {
+        const baseSql = renderExpression(base, state, dialect)
+        return `${postgresBaseKind === "jsonb" ? "jsonb" : "json"}_typeof(${baseSql})`
+      }
+      if (dialect.name === "mysql") {
+        return `json_type(${renderExpression(base, state, dialect)})`
+      }
+      return undefined
+    case "jsonLength":
+      if (!isExpression(base)) {
+        return undefined
+      }
+      if (dialect.name === "postgres") {
+        const baseSql = renderExpression(base, state, dialect)
+        const typeOf = `${postgresBaseKind === "jsonb" ? "jsonb" : "json"}_typeof`
+        const arrayLength = `${postgresBaseKind === "jsonb" ? "jsonb" : "json"}_array_length`
+        const objectKeys = `${postgresBaseKind === "jsonb" ? "jsonb" : "json"}_object_keys`
+        return `(case when ${typeOf}(${baseSql}) = 'array' then ${arrayLength}(${baseSql}) when ${typeOf}(${baseSql}) = 'object' then (select count(*)::int from ${objectKeys}(${baseSql})) else null end)`
+      }
+      if (dialect.name === "mysql") {
+        return `json_length(${renderExpression(base, state, dialect)})`
+      }
+      return undefined
+    case "jsonKeys":
+      if (!isExpression(base)) {
+        return undefined
+      }
+      if (dialect.name === "postgres") {
+        const baseSql = renderExpression(base, state, dialect)
+        const typeOf = `${postgresBaseKind === "jsonb" ? "jsonb" : "json"}_typeof`
+        const objectKeys = `${postgresBaseKind === "jsonb" ? "jsonb" : "json"}_object_keys`
+        return `(case when ${typeOf}(${baseSql}) = 'object' then array(select ${objectKeys}(${baseSql})) else null end)`
+      }
+      if (dialect.name === "mysql") {
+        return `json_keys(${renderExpression(base, state, dialect)})`
+      }
+      return undefined
+    case "jsonStripNulls":
+      if (!isExpression(base)) {
+        return undefined
+      }
+      if (dialect.name === "postgres") {
+        return `${postgresBaseKind === "jsonb" ? "jsonb" : "json"}_strip_nulls(${renderExpression(base, state, dialect)})`
+      }
+      unsupportedJsonFeature(dialect, "jsonStripNulls")
+      return undefined
+    case "jsonDelete":
+    case "jsonDeletePath":
+    case "jsonRemove": {
+      if (!isExpression(base) || segments.length === 0) {
+        return undefined
+      }
+      if (dialect.name === "postgres") {
+        const baseSql = renderPostgresJsonValue(base, state, dialect)
+        if (segments.length === 1 && (segments[0]!.kind === "key" || segments[0]!.kind === "index")) {
+          const segment = segments[0]!
+          return `(${baseSql} - ${segment.kind === "key"
+            ? dialect.renderLiteral(segment.key, state)
+            : dialect.renderLiteral(String(segment.index), state)})`
+        }
+        return `(${baseSql} #- ${renderPostgresJsonPathArray(segments, state, dialect)})`
+      }
+      if (dialect.name === "mysql") {
+        return `json_remove(${renderExpression(base, state, dialect)}, ${segments.map((segment) =>
+          renderMySqlJsonPath([segment], state, dialect)
+        ).join(", ")})`
+      }
+      return undefined
+    }
+    case "jsonSet":
+    case "jsonInsert": {
+      if (!isExpression(base) || segments.length === 0) {
+        return undefined
+      }
+      const nextValue = extractJsonValue(ast)
+      if (!isExpression(nextValue)) {
+        return undefined
+      }
+      const createMissing = ast.createMissing === true
+      const insertAfter = ast.insertAfter === true
+      if (dialect.name === "postgres") {
+        const functionName = kind === "jsonInsert" ? "jsonb_insert" : "jsonb_set"
+        const extra =
+          kind === "jsonInsert"
+            ? `, ${insertAfter ? "true" : "false"}`
+            : `, ${createMissing ? "true" : "false"}`
+        return `${functionName}(${renderPostgresJsonValue(base, state, dialect)}, ${renderPostgresJsonPathArray(segments, state, dialect)}, ${renderPostgresJsonValue(nextValue, state, dialect)}${extra})`
+      }
+      if (dialect.name === "mysql") {
+        const functionName = kind === "jsonInsert" ? "json_insert" : "json_set"
+        return `${functionName}(${renderExpression(base, state, dialect)}, ${renderMySqlJsonPath(segments, state, dialect)}, ${renderExpression(nextValue, state, dialect)})`
+      }
+      return undefined
+    }
+    case "jsonPathExists": {
+      if (!isExpression(base)) {
+        return undefined
+      }
+      const path = ast.path ?? ast.query ?? ast.right
+      if (path === undefined) {
+        return undefined
+      }
+      if (dialect.name === "postgres") {
+        return `(${renderPostgresJsonValue(base, state, dialect)} @? ${renderJsonOpaquePath(path, state, dialect)})`
+      }
+      if (dialect.name === "mysql") {
+        return `json_contains_path(${renderExpression(base, state, dialect)}, ${dialect.renderLiteral("one", state)}, ${renderJsonOpaquePath(path, state, dialect)})`
+      }
+      return undefined
+    }
+    case "jsonPathMatch": {
+      if (!isExpression(base)) {
+        return undefined
+      }
+      const path = ast.path ?? ast.query ?? ast.right
+      if (path === undefined) {
+        return undefined
+      }
+      if (dialect.name === "postgres") {
+        return `(${renderPostgresJsonValue(base, state, dialect)} @@ ${renderJsonOpaquePath(path, state, dialect)})`
+      }
+      unsupportedJsonFeature(dialect, "jsonPathMatch")
+    }
+  }
+
+  return undefined
+}
+
+export interface RenderedQueryAst {
+  readonly sql: string
+  readonly projections: readonly Projection[]
+}
+
+const selectionProjections = (selection: Record<string, unknown>): readonly Projection[] =>
+  flattenSelection(selection).map(({ path, alias }) => ({
+    path,
+    alias
+  }))
+
+const renderMutationAssignment = (
+  entry: QueryAst.AssignmentClause,
+  state: RenderState,
+  dialect: SqlDialect
+): string => {
+  const column = entry.tableName && dialect.name === "mysql"
+    ? `${dialect.quoteIdentifier(entry.tableName)}.${dialect.quoteIdentifier(entry.columnName)}`
+    : dialect.quoteIdentifier(entry.columnName)
+  return `${column} = ${renderExpression(entry.value, state, dialect)}`
+}
+
+const renderJoinSourcesForMutation = (
+  joins: readonly QueryAst.JoinClause[],
+  state: RenderState,
+  dialect: SqlDialect
+): string => joins.map((join) =>
+  renderSourceReference(join.source, join.tableName, join.baseTableName, state, dialect)
+).join(", ")
+
+const renderFromSources = (
+  sources: readonly QueryAst.FromClause[],
+  state: RenderState,
+  dialect: SqlDialect
+): string => sources.map((source) =>
+  renderSourceReference(source.source, source.tableName, source.baseTableName, state, dialect)
+).join(", ")
+
+const renderJoinPredicatesForMutation = (
+  joins: readonly QueryAst.JoinClause[],
+  state: RenderState,
+  dialect: SqlDialect
+): readonly string[] =>
+  joins.flatMap((join) =>
+    join.kind === "cross" || !join.on
+      ? []
+      : [renderExpression(join.on, state, dialect)]
+  )
+
+const renderDeleteTargets = (
+  targets: readonly QueryAst.FromClause[],
+  dialect: SqlDialect
+): string => targets.map((target) => dialect.quoteIdentifier(target.tableName)).join(", ")
+
+const renderMysqlMutationLock = (
+  lock: QueryAst.LockClause | undefined,
+  statement: "update" | "delete"
+): string => {
+  if (!lock) {
+    return ""
+  }
+  switch (lock.mode) {
+    case "lowPriority":
+      return " low_priority"
+    case "ignore":
+      return " ignore"
+    case "quick":
+      return statement === "delete" ? " quick" : ""
+    default:
+      return ""
+  }
+}
+
+const renderTransactionClause = (
+  clause: QueryAst.TransactionClause,
+  dialect: SqlDialect
+): string => {
+  switch (clause.kind) {
+    case "transaction": {
+      const modes: string[] = []
+      if (clause.isolationLevel) {
+        modes.push(`isolation level ${clause.isolationLevel}`)
+      }
+      if (clause.readOnly === true) {
+        modes.push("read only")
+      }
+      return modes.length > 0
+        ? `start transaction ${modes.join(", ")}`
+        : "start transaction"
+    }
+    case "commit":
+      return "commit"
+    case "rollback":
+      return "rollback"
+    case "savepoint":
+      return `savepoint ${dialect.quoteIdentifier(clause.name)}`
+    case "rollbackTo":
+      return `rollback to savepoint ${dialect.quoteIdentifier(clause.name)}`
+    case "releaseSavepoint":
+      return `release savepoint ${dialect.quoteIdentifier(clause.name)}`
+  }
+  return ""
+}
+
+const renderSelectionList = (
+  selection: Record<string, unknown>,
+  state: RenderState,
+  dialect: SqlDialect,
+  validateAggregation: boolean
+): RenderedQueryAst => {
+  if (validateAggregation) {
+    validateAggregationSelection(selection as SelectionValue, [])
+  }
+  const flattened = flattenSelection(selection)
+  const projections = selectionProjections(selection)
+  const sql = flattened.map(({ expression, alias }) =>
+    `${renderExpression(expression, state, dialect)} as ${dialect.quoteIdentifier(alias)}`).join(", ")
+  return {
+    sql,
+    projections
+  }
+}
+
+export const renderQueryAst = (
+  ast: QueryAst.Ast<Record<string, unknown>, any, QueryAst.QueryStatement>,
+  state: RenderState,
+  dialect: SqlDialect
+): RenderedQueryAst => {
+  let sql = ""
+  let projections: readonly Projection[] = []
+
+  switch (ast.kind) {
+    case "select": {
+      validateAggregationSelection(ast.select as SelectionValue, ast.groupBy)
+      const rendered = renderSelectionList(ast.select as Record<string, unknown>, state, dialect, false)
+      projections = rendered.projections
+      const clauses = [
+        ast.distinctOn && ast.distinctOn.length > 0
+          ? `select distinct on (${ast.distinctOn.map((value) => renderExpression(value, state, dialect)).join(", ")}) ${rendered.sql}`
+          : `select${ast.distinct ? " distinct" : ""} ${rendered.sql}`
+      ]
+      if (ast.from) {
+        clauses.push(`from ${renderSourceReference(ast.from.source, ast.from.tableName, ast.from.baseTableName, state, dialect)}`)
+      }
+      for (const join of ast.joins) {
+        const source = renderSourceReference(join.source, join.tableName, join.baseTableName, state, dialect)
+        clauses.push(
+          join.kind === "cross"
+            ? `cross join ${source}`
+            : `${join.kind} join ${source} on ${renderExpression(join.on!, state, dialect)}`
+        )
+      }
+      if (ast.where.length > 0) {
+        clauses.push(`where ${ast.where.map((entry: QueryAst.WhereClause) => renderExpression(entry.predicate, state, dialect)).join(" and ")}`)
+      }
+      if (ast.groupBy.length > 0) {
+        clauses.push(`group by ${ast.groupBy.map((value: QueryAst.Ast["groupBy"][number]) => renderExpression(value, state, dialect)).join(", ")}`)
+      }
+      if (ast.having.length > 0) {
+        clauses.push(`having ${ast.having.map((entry: QueryAst.HavingClause) => renderExpression(entry.predicate, state, dialect)).join(" and ")}`)
+      }
+      if (ast.orderBy.length > 0) {
+        clauses.push(`order by ${ast.orderBy.map((entry: QueryAst.OrderByClause) => `${renderExpression(entry.value, state, dialect)} ${entry.direction}`).join(", ")}`)
+      }
+      if (ast.limit) {
+        clauses.push(`limit ${renderExpression(ast.limit, state, dialect)}`)
+      }
+      if (ast.offset) {
+        clauses.push(`offset ${renderExpression(ast.offset, state, dialect)}`)
+      }
+      if (ast.lock) {
+        clauses.push(
+          `${ast.lock.mode === "update" ? "for update" : "for share"}${ast.lock.nowait ? " nowait" : ""}${ast.lock.skipLocked ? " skip locked" : ""}`
+        )
+      }
+      sql = clauses.join(" ")
+      break
+    }
+    case "set": {
+      const setAst = ast as QueryAst.Ast<Record<string, unknown>, any, "set">
+      const base = renderQueryAst(
+        Query.getAst(setAst.setBase as Query.Plan.Any) as QueryAst.Ast<
+          Record<string, unknown>,
+          any,
+          QueryAst.QueryStatement
+        >,
+        state,
+        dialect
+      )
+      projections = selectionProjections(setAst.select as Record<string, unknown>)
+      sql = [
+        `(${base.sql})`,
+        ...(setAst.setOperations ?? []).map((entry) => {
+          const rendered = renderQueryAst(
+            Query.getAst(entry.query as Query.Plan.Any) as QueryAst.Ast<
+              Record<string, unknown>,
+              any,
+              QueryAst.QueryStatement
+            >,
+            state,
+            dialect
+          )
+          return `${entry.kind}${entry.all ? " all" : ""} (${rendered.sql})`
+        })
+      ].join(" ")
+      break
+    }
+    case "insert": {
+      const insertAst = ast as QueryAst.Ast<Record<string, unknown>, any, "insert">
+      const targetSource = insertAst.into!
+      const target = renderSourceReference(targetSource.source, targetSource.tableName, targetSource.baseTableName, state, dialect)
+      sql = `insert into ${target}`
+      if (insertAst.insertSource?.kind === "values") {
+        const columns = insertAst.insertSource.columns.map((column) => dialect.quoteIdentifier(column)).join(", ")
+        const rows = insertAst.insertSource.rows.map((row) =>
+          `(${row.values.map((entry) => renderExpression(entry.value, state, dialect)).join(", ")})`
+        ).join(", ")
+        sql += ` (${columns}) values ${rows}`
+      } else if (insertAst.insertSource?.kind === "query") {
+        const columns = insertAst.insertSource.columns.map((column) => dialect.quoteIdentifier(column)).join(", ")
+        const renderedQuery = renderQueryAst(
+          Query.getAst(insertAst.insertSource.query as Query.Plan.Any) as QueryAst.Ast<
+            Record<string, unknown>,
+            any,
+            QueryAst.QueryStatement
+          >,
+          state,
+          dialect
+        )
+        sql += ` (${columns}) ${renderedQuery.sql}`
+      } else if (insertAst.insertSource?.kind === "unnest") {
+        const unnestSource = insertAst.insertSource
+        const columns = unnestSource.columns.map((column) => dialect.quoteIdentifier(column)).join(", ")
+        if (dialect.name === "postgres") {
+          const table = targetSource.source as Table.AnyTable
+          const fields = table[Table.TypeId].fields
+          const rendered = unnestSource.values.map((entry) =>
+            `cast(${dialect.renderLiteral(entry.values, state)} as ${renderCastType(dialect, fields[entry.columnName]!.metadata.dbType)}[])`
+          ).join(", ")
+          sql += ` (${columns}) select * from unnest(${rendered})`
+        } else {
+          const rowCount = unnestSource.values[0]?.values.length ?? 0
+          const rows = Array.from({ length: rowCount }, (_, index) =>
+            `(${unnestSource.values.map((entry) =>
+              dialect.renderLiteral(entry.values[index], state)
+            ).join(", ")})`
+          ).join(", ")
+          sql += ` (${columns}) values ${rows}`
+        }
+      } else {
+        const columns = (insertAst.values ?? []).map((entry) => dialect.quoteIdentifier(entry.columnName)).join(", ")
+        const values = (insertAst.values ?? []).map((entry) => renderExpression(entry.value, state, dialect)).join(", ")
+        if ((insertAst.values ?? []).length > 0) {
+          sql += ` (${columns}) values (${values})`
+        } else {
+          sql += " default values"
+        }
+      }
+      if (insertAst.conflict) {
+        const updateValues = (insertAst.conflict.values ?? []).map((entry) =>
+          `${dialect.quoteIdentifier(entry.columnName)} = ${renderExpression(entry.value, state, dialect)}`
+        ).join(", ")
+        if (dialect.name === "postgres") {
+          const targetSql = insertAst.conflict.target?.kind === "constraint"
+            ? ` on conflict on constraint ${dialect.quoteIdentifier(insertAst.conflict.target.name)}`
+            : insertAst.conflict.target?.kind === "columns"
+              ? ` on conflict (${insertAst.conflict.target.columns.map((column) => dialect.quoteIdentifier(column)).join(", ")})${insertAst.conflict.target.where ? ` where ${renderExpression(insertAst.conflict.target.where, state, dialect)}` : ""}`
+              : " on conflict"
+          sql += targetSql
+          sql += insertAst.conflict.action === "doNothing"
+            ? " do nothing"
+            : ` do update set ${updateValues}${insertAst.conflict.where ? ` where ${renderExpression(insertAst.conflict.where, state, dialect)}` : ""}`
+        } else if (insertAst.conflict.action === "doNothing") {
+          sql = sql.replace(/^insert/, "insert ignore")
+        } else {
+          sql += ` on duplicate key update ${updateValues}`
+        }
+      }
+      const returning = renderSelectionList(insertAst.select as Record<string, unknown>, state, dialect, false)
+      projections = returning.projections
+      if (returning.sql.length > 0) {
+        sql += ` returning ${returning.sql}`
+      }
+      break
+    }
+    case "update": {
+      const updateAst = ast as QueryAst.Ast<Record<string, unknown>, any, "update">
+      const targetSource = updateAst.target!
+      const target = renderSourceReference(targetSource.source, targetSource.tableName, targetSource.baseTableName, state, dialect)
+      const targets = updateAst.targets ?? [targetSource]
+      const fromSources = updateAst.fromSources ?? []
+      const assignments = updateAst.set!.map((entry) =>
+        renderMutationAssignment(entry, state, dialect)).join(", ")
+      if (dialect.name === "mysql") {
+        const modifiers = renderMysqlMutationLock(updateAst.lock, "update")
+        const extraSources = renderFromSources(fromSources, state, dialect)
+        const joinSources = updateAst.joins.map((join) =>
+          join.kind === "cross"
+            ? `cross join ${renderSourceReference(join.source, join.tableName, join.baseTableName, state, dialect)}`
+            : `${join.kind} join ${renderSourceReference(join.source, join.tableName, join.baseTableName, state, dialect)} on ${renderExpression(join.on!, state, dialect)}`
+        ).join(" ")
+        const targetList = [
+          ...targets.map((entry) =>
+            renderSourceReference(entry.source, entry.tableName, entry.baseTableName, state, dialect)
+          ),
+          ...(extraSources.length > 0 ? [extraSources] : [])
+        ].join(", ")
+        sql = `update${modifiers} ${targetList}${joinSources.length > 0 ? ` ${joinSources}` : ""} set ${assignments}`
+      } else {
+        sql = `update ${target} set ${assignments}`
+        const mutationSources = [
+          ...(fromSources.length > 0 ? [renderFromSources(fromSources, state, dialect)] : []),
+          ...(updateAst.joins.length > 0 ? [renderJoinSourcesForMutation(updateAst.joins, state, dialect)] : [])
+        ].filter((part) => part.length > 0)
+        if (mutationSources.length > 0) {
+          sql += ` from ${mutationSources.join(", ")}`
+        }
+      }
+      const whereParts = [
+        ...(dialect.name === "postgres" ? renderJoinPredicatesForMutation(updateAst.joins, state, dialect) : []),
+        ...updateAst.where.map((entry: QueryAst.WhereClause) => renderExpression(entry.predicate, state, dialect))
+      ]
+      if (whereParts.length > 0) {
+        sql += ` where ${whereParts.join(" and ")}`
+      }
+      if (dialect.name === "mysql" && updateAst.orderBy.length > 0) {
+        sql += ` order by ${updateAst.orderBy.map((entry: QueryAst.OrderByClause) => `${renderExpression(entry.value, state, dialect)} ${entry.direction}`).join(", ")}`
+      }
+      if (dialect.name === "mysql" && updateAst.limit) {
+        sql += ` limit ${renderMysqlMutationLimit(updateAst.limit, state, dialect)}`
+      }
+      const returning = renderSelectionList(updateAst.select as Record<string, unknown>, state, dialect, false)
+      projections = returning.projections
+      if (returning.sql.length > 0) {
+        sql += ` returning ${returning.sql}`
+      }
+      break
+    }
+    case "delete": {
+      const deleteAst = ast as QueryAst.Ast<Record<string, unknown>, any, "delete">
+      const targetSource = deleteAst.target!
+      const target = renderSourceReference(targetSource.source, targetSource.tableName, targetSource.baseTableName, state, dialect)
+      const targets = deleteAst.targets ?? [targetSource]
+      if (dialect.name === "mysql") {
+        const modifiers = renderMysqlMutationLock(deleteAst.lock, "delete")
+        const hasJoinedSources = deleteAst.joins.length > 0 || targets.length > 1
+        const targetList = renderDeleteTargets(targets, dialect)
+        const fromSources = targets.map((entry) =>
+          renderSourceReference(entry.source, entry.tableName, entry.baseTableName, state, dialect)
+        ).join(", ")
+        const joinSources = deleteAst.joins.map((join) =>
+          join.kind === "cross"
+            ? `cross join ${renderSourceReference(join.source, join.tableName, join.baseTableName, state, dialect)}`
+            : `${join.kind} join ${renderSourceReference(join.source, join.tableName, join.baseTableName, state, dialect)} on ${renderExpression(join.on!, state, dialect)}`
+        ).join(" ")
+        sql = hasJoinedSources
+          ? `delete${modifiers} ${targetList} from ${fromSources}${joinSources.length > 0 ? ` ${joinSources}` : ""}`
+          : `delete${modifiers} from ${fromSources}`
+      } else {
+        sql = `delete from ${target}`
+        if (deleteAst.joins.length > 0) {
+          sql += ` using ${renderJoinSourcesForMutation(deleteAst.joins, state, dialect)}`
+        }
+      }
+      const whereParts = [
+        ...(dialect.name === "postgres" ? renderJoinPredicatesForMutation(deleteAst.joins, state, dialect) : []),
+        ...deleteAst.where.map((entry: QueryAst.WhereClause) => renderExpression(entry.predicate, state, dialect))
+      ]
+      if (whereParts.length > 0) {
+        sql += ` where ${whereParts.join(" and ")}`
+      }
+      if (dialect.name === "mysql" && deleteAst.orderBy.length > 0) {
+        sql += ` order by ${deleteAst.orderBy.map((entry: QueryAst.OrderByClause) => `${renderExpression(entry.value, state, dialect)} ${entry.direction}`).join(", ")}`
+      }
+      if (dialect.name === "mysql" && deleteAst.limit) {
+        sql += ` limit ${renderMysqlMutationLimit(deleteAst.limit, state, dialect)}`
+      }
+      const returning = renderSelectionList(deleteAst.select as Record<string, unknown>, state, dialect, false)
+      projections = returning.projections
+      if (returning.sql.length > 0) {
+        sql += ` returning ${returning.sql}`
+      }
+      break
+    }
+    case "truncate": {
+      const truncateAst = ast as QueryAst.Ast<Record<string, unknown>, any, "truncate">
+      const targetSource = truncateAst.target!
+      sql = `truncate table ${renderSourceReference(targetSource.source, targetSource.tableName, targetSource.baseTableName, state, dialect)}`
+      if (truncateAst.truncate?.restartIdentity) {
+        sql += " restart identity"
+      }
+      if (truncateAst.truncate?.cascade) {
+        sql += " cascade"
+      }
+      break
+    }
+    case "merge": {
+      if (dialect.name !== "postgres") {
+        throw new Error(`Unsupported merge statement for ${dialect.name}`)
+      }
+      const mergeAst = ast as QueryAst.Ast<Record<string, unknown>, any, "merge">
+      const targetSource = mergeAst.target!
+      const usingSource = mergeAst.using!
+      const merge = mergeAst.merge!
+      sql = `merge into ${renderSourceReference(targetSource.source, targetSource.tableName, targetSource.baseTableName, state, dialect)} using ${renderSourceReference(usingSource.source, usingSource.tableName, usingSource.baseTableName, state, dialect)} on ${renderExpression(merge.on, state, dialect)}`
+      if (merge.whenMatched) {
+        sql += " when matched"
+        if (merge.whenMatched.predicate) {
+          sql += ` and ${renderExpression(merge.whenMatched.predicate, state, dialect)}`
+        }
+        if (merge.whenMatched.kind === "delete") {
+          sql += " then delete"
+        } else {
+          sql += ` then update set ${merge.whenMatched.values.map((entry) =>
+            `${dialect.quoteIdentifier(entry.columnName)} = ${renderExpression(entry.value, state, dialect)}`
+          ).join(", ")}`
+        }
+      }
+      if (merge.whenNotMatched) {
+        sql += " when not matched"
+        if (merge.whenNotMatched.predicate) {
+          sql += ` and ${renderExpression(merge.whenNotMatched.predicate, state, dialect)}`
+        }
+        sql += ` then insert (${merge.whenNotMatched.values.map((entry) => dialect.quoteIdentifier(entry.columnName)).join(", ")}) values (${merge.whenNotMatched.values.map((entry) => renderExpression(entry.value, state, dialect)).join(", ")})`
+      }
+      break
+    }
+    case "transaction":
+    case "commit":
+    case "rollback":
+    case "savepoint":
+    case "rollbackTo":
+    case "releaseSavepoint": {
+      sql = renderTransactionClause(ast.transaction!, dialect)
+      break
+    }
+    case "createTable": {
+      const createTableAst = ast as QueryAst.Ast<Record<string, unknown>, any, "createTable">
+      sql = renderCreateTableSql(createTableAst.target!, state, dialect, createTableAst.ddl?.kind === "createTable" && createTableAst.ddl.ifNotExists)
+      break
+    }
+    case "dropTable": {
+      const dropTableAst = ast as QueryAst.Ast<Record<string, unknown>, any, "dropTable">
+      const ifExists = dropTableAst.ddl?.kind === "dropTable" && dropTableAst.ddl.ifExists
+      sql = `drop table${ifExists ? " if exists" : ""} ${renderSourceReference(dropTableAst.target!.source, dropTableAst.target!.tableName, dropTableAst.target!.baseTableName, state, dialect)}`
+      break
+    }
+    case "createIndex": {
+      const createIndexAst = ast as QueryAst.Ast<Record<string, unknown>, any, "createIndex">
+      sql = renderCreateIndexSql(
+        createIndexAst.target!,
+        createIndexAst.ddl as Extract<QueryAst.DdlClause, { readonly kind: "createIndex" }>,
+        state,
+        dialect
+      )
+      break
+    }
+    case "dropIndex": {
+      const dropIndexAst = ast as QueryAst.Ast<Record<string, unknown>, any, "dropIndex">
+      sql = renderDropIndexSql(
+        dropIndexAst.target!,
+        dropIndexAst.ddl as Extract<QueryAst.DdlClause, { readonly kind: "dropIndex" }>,
+        state,
+        dialect
+      )
+      break
+    }
+  }
+
+  if (state.ctes.length === 0) {
+    return {
+      sql,
+      projections
+    }
+  }
+  return {
+    sql: `with${state.ctes.some((entry) => entry.recursive) ? " recursive" : ""} ${state.ctes.map((entry) => `${dialect.quoteIdentifier(entry.name)} as (${entry.sql})`).join(", ")} ${sql}`,
+    projections
+  }
+}
+
+const renderSourceReference = (
+  source: unknown,
+  tableName: string,
+  baseTableName: string,
+  state: RenderState,
+  dialect: SqlDialect
+): string => {
+  const renderSelectRows = (
+    rows: readonly Record<string, Expression.Any>[],
+    columnNames: readonly string[]
+  ): string => {
+    const renderedRows = rows.map((row) =>
+      `select ${columnNames.map((columnName) =>
+        `${renderExpression(row[columnName]!, state, dialect)} as ${dialect.quoteIdentifier(columnName)}`
+      ).join(", ")}`
+    )
+    return `(${renderedRows.join(" union all ")}) as ${dialect.quoteIdentifier(tableName)}(${columnNames.map((columnName) => dialect.quoteIdentifier(columnName)).join(", ")})`
+  }
+
+  const renderUnnestRows = (
+    arrays: Readonly<Record<string, readonly Expression.Any[]>>,
+    columnNames: readonly string[]
+  ): string => {
+    const rowCount = arrays[columnNames[0]!]!.length
+    const rows = Array.from({ length: rowCount }, (_, index) =>
+      Object.fromEntries(columnNames.map((columnName) => [columnName, arrays[columnName]![index]!] as const)) as Record<string, Expression.Any>
+    )
+    return renderSelectRows(rows, columnNames)
+  }
+
+  if (typeof source === "object" && source !== null && "kind" in source && (source as { readonly kind?: string }).kind === "cte") {
+    const cte = source as unknown as {
+      readonly name: string
+      readonly plan: Query.Plan.Any
+      readonly recursive?: boolean
+    }
+    if (!state.cteNames.has(cte.name)) {
+      state.cteNames.add(cte.name)
+      const rendered = renderQueryAst(Query.getAst(cte.plan) as QueryAst.Ast<Record<string, unknown>, any, QueryAst.QueryStatement>, state, dialect)
+      state.ctes.push({
+        name: cte.name,
+        sql: rendered.sql,
+        recursive: cte.recursive
+      })
+    }
+    return dialect.quoteIdentifier(cte.name)
+  }
+  if (typeof source === "object" && source !== null && "kind" in source && (source as { readonly kind?: string }).kind === "derived") {
+    const derived = source as unknown as {
+      readonly name: string
+      readonly plan: Query.Plan.Any
+    }
+    if (!state.cteNames.has(derived.name)) {
+      // derived tables are inlined, so no CTE registration is needed
+    }
+    return `(${renderQueryAst(Query.getAst(derived.plan) as QueryAst.Ast<Record<string, unknown>, any, QueryAst.QueryStatement>, state, dialect).sql}) as ${dialect.quoteIdentifier(derived.name)}`
+  }
+  if (typeof source === "object" && source !== null && "kind" in source && (source as { readonly kind?: string }).kind === "lateral") {
+    const lateral = source as unknown as {
+      readonly name: string
+      readonly plan: Query.Plan.Any
+    }
+    return `lateral (${renderQueryAst(Query.getAst(lateral.plan) as QueryAst.Ast<Record<string, unknown>, any, QueryAst.QueryStatement>, state, dialect).sql}) as ${dialect.quoteIdentifier(lateral.name)}`
+  }
+  if (typeof source === "object" && source !== null && (source as { readonly kind?: string }).kind === "values") {
+    const values = source as unknown as {
+      readonly columns: Record<string, Expression.Any>
+      readonly rows: readonly Record<string, Expression.Any>[]
+    }
+    return renderSelectRows(values.rows, Object.keys(values.columns))
+  }
+  if (typeof source === "object" && source !== null && (source as { readonly kind?: string }).kind === "unnest") {
+    const unnest = source as unknown as {
+      readonly columns: Record<string, Expression.Any>
+      readonly arrays: Readonly<Record<string, readonly Expression.Any[]>>
+    }
+    return renderUnnestRows(unnest.arrays, Object.keys(unnest.columns))
+  }
+  if (typeof source === "object" && source !== null && (source as { readonly kind?: string }).kind === "tableFunction") {
+    const tableFunction = source as unknown as {
+      readonly name: string
+      readonly columns: Record<string, Expression.Any>
+      readonly functionName: string
+      readonly args: readonly Expression.Any[]
+    }
+    if (dialect.name !== "postgres") {
+      throw new Error("Unsupported table function source for SQL rendering")
+    }
+    const columnNames = Object.keys(tableFunction.columns)
+    return `${tableFunction.functionName}(${tableFunction.args.map((arg) => renderExpression(arg, state, dialect)).join(", ")}) as ${dialect.quoteIdentifier(tableFunction.name)}(${columnNames.map((columnName) => dialect.quoteIdentifier(columnName)).join(", ")})`
+  }
+  const schemaName = typeof source === "object" && source !== null && Table.TypeId in source
+    ? (source as Table.AnyTable)[Table.TypeId].schemaName
+    : undefined
+  return dialect.renderTableReference(tableName, baseTableName, schemaName)
+}
+
+/**
+ * Renders a scalar expression AST into SQL text.
+ *
+ * This is parameterized by a runtime dialect so the same expression walker can
+ * be reused across dialect-specific renderers while still delegating quoting
+ * and literal serialization to the concrete dialect implementation.
+ */
+export const renderExpression = (
+  expression: Expression.Any,
+  state: RenderState,
+  dialect: SqlDialect
+): string => {
+  const rawAst = (expression as Expression.Any & {
+    readonly [ExpressionAst.TypeId]: ExpressionAst.Any
+  })[ExpressionAst.TypeId] as ExpressionAst.Any | Record<string, unknown>
+  const jsonSql = renderJsonExpression(expression, rawAst as Record<string, unknown>, state, dialect)
+  if (jsonSql !== undefined) {
+    return jsonSql
+  }
+  const ast = rawAst as ExpressionAst.Any
+  const renderComparisonOperator = (operator: "eq" | "neq" | "lt" | "lte" | "gt" | "gte"): "=" | "<>" | "<" | "<=" | ">" | ">=" =>
+    operator === "eq"
+      ? "="
+      : operator === "neq"
+        ? "<>"
+        : operator === "lt"
+          ? "<"
+          : operator === "lte"
+            ? "<="
+            : operator === "gt"
+              ? ">"
+              : ">="
+    switch (ast.kind) {
+    case "column":
+      return ast.tableName.length === 0
+        ? dialect.quoteIdentifier(ast.columnName)
+        : `${dialect.quoteIdentifier(ast.tableName)}.${dialect.quoteIdentifier(ast.columnName)}`
+    case "literal":
+      return dialect.renderLiteral(ast.value, state)
+    case "excluded":
+      return dialect.name === "mysql"
+        ? `values(${dialect.quoteIdentifier(ast.columnName)})`
+        : `excluded.${dialect.quoteIdentifier(ast.columnName)}`
+    case "cast":
+      return `cast(${renderExpression(ast.value, state, dialect)} as ${renderCastType(dialect, ast.target)})`
+    case "function":
+      return renderFunctionCall(ast.name, Array.isArray(ast.args) ? ast.args : [], state, dialect)
+    case "eq":
+      return `(${renderExpression(ast.left, state, dialect)} = ${renderExpression(ast.right, state, dialect)})`
+    case "neq":
+      return `(${renderExpression(ast.left, state, dialect)} <> ${renderExpression(ast.right, state, dialect)})`
+    case "lt":
+      return `(${renderExpression(ast.left, state, dialect)} < ${renderExpression(ast.right, state, dialect)})`
+    case "lte":
+      return `(${renderExpression(ast.left, state, dialect)} <= ${renderExpression(ast.right, state, dialect)})`
+    case "gt":
+      return `(${renderExpression(ast.left, state, dialect)} > ${renderExpression(ast.right, state, dialect)})`
+    case "gte":
+      return `(${renderExpression(ast.left, state, dialect)} >= ${renderExpression(ast.right, state, dialect)})`
+    case "like":
+      return `(${renderExpression(ast.left, state, dialect)} like ${renderExpression(ast.right, state, dialect)})`
+    case "ilike":
+      return dialect.name === "postgres"
+        ? `(${renderExpression(ast.left, state, dialect)} ilike ${renderExpression(ast.right, state, dialect)})`
+        : `(lower(${renderExpression(ast.left, state, dialect)}) like lower(${renderExpression(ast.right, state, dialect)}))`
+    case "regexMatch":
+      return dialect.name === "postgres"
+        ? `(${renderExpression(ast.left, state, dialect)} ~ ${renderExpression(ast.right, state, dialect)})`
+        : `(${renderExpression(ast.left, state, dialect)} regexp ${renderExpression(ast.right, state, dialect)})`
+    case "regexIMatch":
+      return dialect.name === "postgres"
+        ? `(${renderExpression(ast.left, state, dialect)} ~* ${renderExpression(ast.right, state, dialect)})`
+        : `(${renderExpression(ast.left, state, dialect)} regexp ${renderExpression(ast.right, state, dialect)})`
+    case "regexNotMatch":
+      return dialect.name === "postgres"
+        ? `(${renderExpression(ast.left, state, dialect)} !~ ${renderExpression(ast.right, state, dialect)})`
+        : `(${renderExpression(ast.left, state, dialect)} not regexp ${renderExpression(ast.right, state, dialect)})`
+    case "regexNotIMatch":
+      return dialect.name === "postgres"
+        ? `(${renderExpression(ast.left, state, dialect)} !~* ${renderExpression(ast.right, state, dialect)})`
+        : `(${renderExpression(ast.left, state, dialect)} not regexp ${renderExpression(ast.right, state, dialect)})`
+    case "isDistinctFrom":
+      return dialect.name === "mysql"
+        ? `(not (${renderExpression(ast.left, state, dialect)} <=> ${renderExpression(ast.right, state, dialect)}))`
+        : `(${renderExpression(ast.left, state, dialect)} is distinct from ${renderExpression(ast.right, state, dialect)})`
+    case "isNotDistinctFrom":
+      return dialect.name === "mysql"
+        ? `(${renderExpression(ast.left, state, dialect)} <=> ${renderExpression(ast.right, state, dialect)})`
+        : `(${renderExpression(ast.left, state, dialect)} is not distinct from ${renderExpression(ast.right, state, dialect)})`
+    case "contains":
+      if (dialect.name === "postgres") {
+        const left = isJsonExpression(ast.left)
+          ? renderPostgresJsonValue(ast.left, state, dialect)
+          : renderExpression(ast.left, state, dialect)
+        const right = isJsonExpression(ast.right)
+          ? renderPostgresJsonValue(ast.right, state, dialect)
+          : renderExpression(ast.right, state, dialect)
+        return `(${left} @> ${right})`
+      }
+      if (dialect.name === "mysql" && isJsonExpression(ast.left) && isJsonExpression(ast.right)) {
+        return `json_contains(${renderExpression(ast.left, state, dialect)}, ${renderExpression(ast.right, state, dialect)})`
+      }
+      throw new Error("Unsupported container operator for SQL rendering")
+    case "containedBy":
+      if (dialect.name === "postgres") {
+        const left = isJsonExpression(ast.left)
+          ? renderPostgresJsonValue(ast.left, state, dialect)
+          : renderExpression(ast.left, state, dialect)
+        const right = isJsonExpression(ast.right)
+          ? renderPostgresJsonValue(ast.right, state, dialect)
+          : renderExpression(ast.right, state, dialect)
+        return `(${left} <@ ${right})`
+      }
+      if (dialect.name === "mysql" && isJsonExpression(ast.left) && isJsonExpression(ast.right)) {
+        return `json_contains(${renderExpression(ast.right, state, dialect)}, ${renderExpression(ast.left, state, dialect)})`
+      }
+      throw new Error("Unsupported container operator for SQL rendering")
+    case "overlaps":
+      if (dialect.name === "postgres") {
+        const left = isJsonExpression(ast.left)
+          ? renderPostgresJsonValue(ast.left, state, dialect)
+          : renderExpression(ast.left, state, dialect)
+        const right = isJsonExpression(ast.right)
+          ? renderPostgresJsonValue(ast.right, state, dialect)
+          : renderExpression(ast.right, state, dialect)
+        return `(${left} && ${right})`
+      }
+      if (dialect.name === "mysql" && isJsonExpression(ast.left) && isJsonExpression(ast.right)) {
+        return `json_overlaps(${renderExpression(ast.left, state, dialect)}, ${renderExpression(ast.right, state, dialect)})`
+      }
+      throw new Error("Unsupported container operator for SQL rendering")
+    case "isNull":
+      return `(${renderExpression(ast.value, state, dialect)} is null)`
+    case "isNotNull":
+      return `(${renderExpression(ast.value, state, dialect)} is not null)`
+    case "not":
+      return `(not ${renderExpression(ast.value, state, dialect)})`
+    case "upper":
+      return `upper(${renderExpression(ast.value, state, dialect)})`
+    case "lower":
+      return `lower(${renderExpression(ast.value, state, dialect)})`
+    case "count":
+      return `count(${renderExpression(ast.value, state, dialect)})`
+    case "max":
+      return `max(${renderExpression(ast.value, state, dialect)})`
+    case "min":
+      return `min(${renderExpression(ast.value, state, dialect)})`
+    case "and":
+      return `(${ast.values.map((value: Expression.Any) => renderExpression(value, state, dialect)).join(" and ")})`
+    case "or":
+      return `(${ast.values.map((value: Expression.Any) => renderExpression(value, state, dialect)).join(" or ")})`
+    case "coalesce":
+      return `coalesce(${ast.values.map((value: Expression.Any) => renderExpression(value, state, dialect)).join(", ")})`
+    case "in":
+      return `(${renderExpression(ast.values[0]!, state, dialect)} in (${ast.values.slice(1).map((value: Expression.Any) => renderExpression(value, state, dialect)).join(", ")}))`
+    case "notIn":
+      return `(${renderExpression(ast.values[0]!, state, dialect)} not in (${ast.values.slice(1).map((value: Expression.Any) => renderExpression(value, state, dialect)).join(", ")}))`
+    case "between":
+      return `(${renderExpression(ast.values[0]!, state, dialect)} between ${renderExpression(ast.values[1]!, state, dialect)} and ${renderExpression(ast.values[2]!, state, dialect)})`
+    case "concat":
+      return dialect.renderConcat(ast.values.map((value: Expression.Any) => renderExpression(value, state, dialect)))
+    case "case":
+      return `case ${ast.branches.map((branch) =>
+        `when ${renderExpression(branch.when, state, dialect)} then ${renderExpression(branch.then, state, dialect)}`
+      ).join(" ")} else ${renderExpression(ast.else, state, dialect)} end`
+    case "exists":
+      return `exists (${renderQueryAst(
+        Query.getAst(ast.plan) as QueryAst.Ast<Record<string, unknown>, any, QueryAst.QueryStatement>,
+        state,
+        dialect
+      ).sql})`
+    case "scalarSubquery":
+      return `(${renderQueryAst(
+        Query.getAst(ast.plan) as QueryAst.Ast<Record<string, unknown>, any, QueryAst.QueryStatement>,
+        state,
+        dialect
+      ).sql})`
+    case "inSubquery":
+      return `(${renderExpression(ast.left, state, dialect)} in (${renderQueryAst(
+        Query.getAst(ast.plan) as QueryAst.Ast<Record<string, unknown>, any, QueryAst.QueryStatement>,
+        state,
+        dialect
+      ).sql}))`
+    case "comparisonAny":
+      return `(${renderExpression(ast.left, state, dialect)} ${renderComparisonOperator(ast.operator)} any (${renderQueryAst(
+        Query.getAst(ast.plan) as QueryAst.Ast<Record<string, unknown>, any, QueryAst.QueryStatement>,
+        state,
+        dialect
+      ).sql}))`
+    case "comparisonAll":
+      return `(${renderExpression(ast.left, state, dialect)} ${renderComparisonOperator(ast.operator)} all (${renderQueryAst(
+        Query.getAst(ast.plan) as QueryAst.Ast<Record<string, unknown>, any, QueryAst.QueryStatement>,
+        state,
+        dialect
+      ).sql}))`
+    case "window": {
+      if (!Array.isArray(ast.partitionBy) || !Array.isArray(ast.orderBy) || typeof ast.function !== "string") {
+        break
+      }
+      const clauses: string[] = []
+      if (ast.partitionBy.length > 0) {
+        clauses.push(`partition by ${ast.partitionBy.map((value: Expression.Any) => renderExpression(value, state, dialect)).join(", ")}`)
+      }
+      if (ast.orderBy.length > 0) {
+        clauses.push(`order by ${ast.orderBy.map((entry) =>
+          `${renderExpression(entry.value, state, dialect)} ${entry.direction}`
+        ).join(", ")}`)
+      }
+      const specification = clauses.join(" ")
+      switch (ast.function) {
+        case "rowNumber":
+          return `row_number() over (${specification})`
+        case "rank":
+          return `rank() over (${specification})`
+        case "denseRank":
+          return `dense_rank() over (${specification})`
+        case "over":
+          return `${renderExpression(ast.value!, state, dialect)} over (${specification})`
+      }
+      break
+    }
+  }
+  throw new Error("Unsupported expression for SQL rendering")
+}