effect-qb 0.16.0 → 0.17.0

package/src/postgres/internal/dsl.ts

@@ -9,6 +9,7 @@ import * as Table from "../../internal/table.js"
 import type { CastTargetError, OperandCompatibilityError } from "../../internal/coercion/errors.js"
 import type { RuntimeOfDbType } from "../../internal/coercion/analysis.js"
 import type { CanCastDbType, CanCompareDbTypes, CanContainDbTypes, CanTextuallyCoerceDbType } from "../../internal/coercion/rules.js"
+import { normalizeDbValue } from "../../internal/runtime/normalize.js"
 import {
   currentRequiredList,
   extractRequiredRuntime,
@@ -30,11 +31,15 @@ import {
   type AssumptionsOfPlan,
   type AvailableOfPlan,
   type CapabilitiesOfPlan,
+  type CommonSetFacts,
   type DialectCompatibleNestedPlan,
   type DependenciesOf,
   type DependencyRecord,
   type DialectOf,
   type DerivedSelectionOf,
+  type DerivedTableCompatiblePlan,
+  type LateralSourceCompatiblePlan,
+  type DerivedSourceCompatiblePlan,
   type DerivedSource,
   type CompletePlan,
   type ExpressionInput,
@@ -217,6 +222,13 @@ type DialectAsExpression<
   ? Value
   : DialectLiteralExpression<Extract<Value, LiteralValue>, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
 
+type ProjectionAliasedExpression<
+  Value extends Expression.Any,
+  Alias extends string
+> = Value & {
+  readonly [ProjectionAlias.TypeId]: ProjectionAlias.State<Alias>
+}
+
 /** Normalizes a generic string-capable input into the expression form used internally. */
 type DialectAsStringExpression<
   Value extends ExpressionInput,
@@ -690,6 +702,21 @@ type DialectOfDialectNumericInput<
   NullDb extends Expression.DbType.Any
 > = DialectOf<DialectAsNumericExpression<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>>
 
+type NumericExpressionDialectInput<
+  Value extends NumericExpressionInput,
+  Dialect extends string,
+  TextDb extends Expression.DbType.Any,
+  NumericDb extends Expression.DbType.Any,
+  BoolDb extends Expression.DbType.Any,
+  TimestampDb extends Expression.DbType.Any,
+  NullDb extends Expression.DbType.Any
+> = Exclude<DialectOfDialectNumericInput<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>, Dialect> extends never
+  ? unknown
+  : {
+      readonly __effect_qb_error__: "effect-qb: numeric expressions cannot mix dialects"
+      readonly __effect_qb_dialect__: DialectOfDialectNumericInput<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
+    }
+
 /** Dependency map carried by a numeric-clause input after coercion. */
 type DependenciesOfDialectNumericInput<
   Value extends NumericExpressionInput,
@@ -1696,10 +1723,16 @@ const profile: QueryDialectProfile<Dialect, TextDb, NumericDb, BoolDb, Timestamp
     spec: WindowSpecInput<PartitionBy, OrderBy> | OrderedWindowSpecInput<PartitionBy, Extract<OrderBy, NonEmptyWindowOrderTerms>> | undefined
   ) => {
     const partitionBy = [...(spec?.partitionBy ?? [])] as unknown as PartitionBy
-    const orderBy = (spec?.orderBy ?? []).map((term) => ({
-      value: term.value,
-      direction: term.direction ?? "asc"
-    })) as {
+    const orderBy = (spec?.orderBy ?? []).map((term) => {
+      const direction = term.direction ?? "asc"
+      if (direction !== "asc" && direction !== "desc") {
+        throw new Error("window order direction must be asc or desc")
+      }
+      return {
+        value: term.value,
+        direction
+      }
+    }) as {
       readonly [K in keyof OrderBy]: OrderBy[K] extends WindowOrderTermInput<infer Value extends WindowOrderInput>
         ? { readonly value: Value; readonly direction: OrderDirection }
         : never
@@ -2073,9 +2106,15 @@ type BinaryPredicateExpression<
     })
   }
 
-  const collate = <Value extends ExpressionInput>(
+  type NormalizedCollation<Collation extends string | readonly [string, ...string[]]> =
+    Collation extends string ? readonly [Collation] : Collation
+
+  const collate = <
+    Value extends ExpressionInput,
+    Collation extends string | readonly [string, ...string[]]
+  >(
     value: Value & TextInput<NoInfer<Value>, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb, "collate">,
-    collation: string | readonly [string, ...string[]]
+    collation: Collation
   ): AstBackedExpression<
     Expression.RuntimeOf<DialectAsStringExpression<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>>,
     Expression.DbTypeOf<DialectAsStringExpression<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>>,
@@ -2083,10 +2122,10 @@ type BinaryPredicateExpression<
     DialectOfDialectStringInput<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
     KindOf<DialectAsStringExpression<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>>,
     DependenciesOfDialectStringInput<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
-    ExpressionAst.CollateNode<DialectAsStringExpression<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>>
+    ExpressionAst.CollateNode<DialectAsStringExpression<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>, NormalizedCollation<Collation>>
   > => {
     const expression = toDialectStringExpression(value as any)
-    const normalizedCollation: readonly [string, ...string[]] = typeof collation === "string" ? [collation] : collation
+    const normalizedCollation = (typeof collation === "string" ? [collation] : collation) as NormalizedCollation<Collation>
     return makeExpression({
       runtime: expression[Expression.TypeId].runtime as Expression.RuntimeOf<DialectAsStringExpression<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>>,
       dbType: expression[Expression.TypeId].dbType as Expression.DbTypeOf<DialectAsStringExpression<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>>,
@@ -2106,7 +2145,7 @@ type BinaryPredicateExpression<
       DialectOfDialectStringInput<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
       KindOf<DialectAsStringExpression<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>>,
       DependenciesOfDialectStringInput<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
-      ExpressionAst.CollateNode<DialectAsStringExpression<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>>
+      ExpressionAst.CollateNode<DialectAsStringExpression<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>, NormalizedCollation<Collation>>
     >
   }
 
@@ -2702,7 +2741,7 @@ type BinaryPredicateExpression<
     Next extends JsonValueInput
   >(
     base: Base,
-    target: Target & JsonSetGuard<Expression.RuntimeOf<Base>, Target, Next, "json.set">,
+    target: Target & JsonSetGuard<Expression.RuntimeOf<Base>, Target, NoInfer<Next>, "json.set">,
     next: Next,
     options: {
       readonly createMissing?: boolean
@@ -2750,7 +2789,7 @@ type BinaryPredicateExpression<
     InsertAfter extends boolean = false
   >(
     base: Base,
-    target: Target & JsonInsertGuard<Expression.RuntimeOf<Base>, Target, Next, InsertAfter, "json.insert">,
+    target: Target & JsonInsertGuard<Expression.RuntimeOf<Base>, Target, NoInfer<Next>, NoInfer<InsertAfter>, "json.insert">,
     next: Next,
     options: {
       readonly insertAfter?: InsertAfter
@@ -3964,7 +4003,9 @@ type BinaryPredicateExpression<
       string,
       "scalar",
       Expression.BindingId
-    >
+    > & {
+      readonly [ExpressionAst.TypeId]: ExpressionAst.ColumnNode<any, string>
+    }
   >(
     value: Value
   ): AstBackedExpression<
@@ -4008,22 +4049,56 @@ type BinaryPredicateExpression<
     value: Value,
     column: Expression.Any
   ): Expression.Any => {
+    const columnState = column[Expression.TypeId]
+    const normalizeMutationValue = (candidate: unknown): unknown => {
+      if (candidate === null && columnState.nullability !== "never") {
+        return null
+      }
+      const runtimeSchemaAccepts = columnState.runtimeSchema !== undefined &&
+        (Schema.is(columnState.runtimeSchema) as (input: unknown) => boolean)(candidate)
+      if (runtimeSchemaAccepts) {
+        return candidate
+      }
+      const normalized = normalizeDbValue(columnState.dbType, candidate)
+      return columnState.runtimeSchema === undefined
+        ? normalized
+        : (Schema.decodeUnknownSync as any)(columnState.runtimeSchema)(normalized)
+    }
     if (value !== null && typeof value === "object" && Expression.TypeId in value) {
+      const expression = value as unknown as Expression.Any
+      const ast = (expression as unknown as { readonly [ExpressionAst.TypeId]: ExpressionAst.Any })[ExpressionAst.TypeId]
+      if (ast.kind === "literal") {
+        const normalizedValue = normalizeMutationValue(ast.value)
+        return makeExpression({
+          runtime: normalizedValue,
+          dbType: columnState.dbType,
+          runtimeSchema: columnState.runtimeSchema,
+          driverValueMapping: columnState.driverValueMapping,
+          nullability: normalizedValue === null ? "always" : "never",
+          dialect: columnState.dialect,
+          kind: "scalar",
+          dependencies: {}
+        }, {
+          kind: "literal",
+          value: normalizedValue
+        })
+      }
       return retargetLiteralExpression(value as unknown as Expression.Any, column)
     }
+    const normalizedValue = normalizeMutationValue(value)
     return makeExpression({
-      runtime: value as Value,
-      dbType: column[Expression.TypeId].dbType,
-      runtimeSchema: column[Expression.TypeId].runtimeSchema,
-      driverValueMapping: column[Expression.TypeId].driverValueMapping,
-      nullability: value === null ? "always" : "never",
-      dialect: column[Expression.TypeId].dialect,
+      runtime: normalizedValue as Value,
+      dbType: columnState.dbType,
+      runtimeSchema: columnState.runtimeSchema,
+      driverValueMapping: columnState.driverValueMapping,
+      nullability: normalizedValue === null ? "always" : "never",
+      dialect: columnState.dialect,
       kind: "scalar",
 
       dependencies: {}
     }, {
       kind: "literal",
-      value
+      value: normalizedValue
     })
   }
 
@@ -4111,16 +4186,16 @@ type BinaryPredicateExpression<
     Alias extends string
   >(
     rows: readonly [Record<string, Expression.Any>, ...Record<string, Expression.Any>[]],
-    selection: ValuesOutputShape<Rows[0], Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
+    selection: ValuesOutputShape<Rows, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
     alias: Alias
   ): ValuesSource<
     Rows,
-    ValuesOutputShape<Rows[0], Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
+    ValuesOutputShape<Rows, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
     Alias,
     Dialect
   > => {
     const columns = makeColumnReferenceSelection(alias, selection as Record<string, Expression.Any>) as unknown as ValuesOutputShape<
-      Rows[0],
+      Rows,
       Dialect,
       TextDb,
       NumericDb,
@@ -4138,7 +4213,7 @@ type BinaryPredicateExpression<
     }
     return Object.assign(source, columns) as unknown as ValuesSource<
       Rows,
-      ValuesOutputShape<Rows[0], Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
+      ValuesOutputShape<Rows, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
       Alias,
       Dialect
     >
@@ -4151,7 +4226,12 @@ type BinaryPredicateExpression<
 
   const normalizeUnnestColumns = (columns: UnnestColumnsInput): Record<string, readonly Expression.Any[]> =>
     Object.fromEntries(
-      Object.entries(columns).map(([key, values]) => [key, values.map((value) => toDialectExpression(value))])
+      Object.entries(columns).map(([key, values]) => {
+        if (!Array.isArray(values)) {
+          throw new Error("unnest(...) expects every value to be an array")
+        }
+        return [key, values.map((value) => toDialectExpression(value))]
+      })
     ) as Record<string, readonly Expression.Any[]>
 
   const normalizeMutationTargets = (
@@ -4194,6 +4274,17 @@ type BinaryPredicateExpression<
     })
   ) as unknown as AddAvailableMany<{}, MutationTargetNamesOf<Target>, Mode>
 
+  const getMutationColumn = (
+    columns: Record<string, unknown>,
+    columnName: string
+  ): Expression.Any => {
+    const column = columns[columnName]
+    if (column === undefined || column === null || typeof column !== "object" || !(Expression.TypeId in column)) {
+      throw new Error("effect-qb: unknown mutation column")
+    }
+    return column as Expression.Any
+  }
+
   const buildMutationAssignments = <Target extends MutationTargetInput, Values>(
     target: Target,
     values: Values
@@ -4203,7 +4294,7 @@ type BinaryPredicateExpression<
       const columns = target as unknown as Record<string, Expression.Any>
       return Object.entries(values as Record<string, unknown>).map(([columnName, value]) => ({
         columnName,
-        value: toMutationValueExpression(value, columns[columnName]!)
+        value: toMutationValueExpression(value, getMutationColumn(columns, columnName))
       }))
     }
     const valueMap = values as Record<string, Record<string, unknown> | undefined>
@@ -4214,7 +4305,7 @@ type BinaryPredicateExpression<
       return Object.entries(scopedValues).map(([columnName, value]) => ({
         tableName: targetName,
         columnName,
-        value: toMutationValueExpression(value, columns[columnName]!)
+        value: toMutationValueExpression(value, getMutationColumn(columns, columnName))
       }))
     })
   }
@@ -4301,14 +4392,26 @@ type BinaryPredicateExpression<
     }
   }
 
+  const normalizeConflictColumns = <Target extends MutationTargetLike>(
+    target: Target,
+    columnsInput: string | readonly string[]
+  ): readonly [string, ...string[]] => {
+    const columns = normalizeColumnList(columnsInput) as readonly [string, ...string[]]
+    const knownColumns = new Set(Object.keys(target[Table.TypeId].fields))
+    if (columns.some((columnName) => !knownColumns.has(columnName))) {
+      throw new Error("effect-qb: unknown conflict target column")
+    }
+    return columns
+  }
+
   const buildConflictTarget = <Target extends MutationTargetLike>(
     target: Target,
-    input: readonly string[] | { readonly columns: readonly string[]; readonly where?: PredicateInput } | { readonly constraint: string }
+    input: string | readonly string[] | { readonly columns: string | readonly string[]; readonly where?: PredicateInput } | { readonly constraint: string }
   ): QueryAst.ConflictTargetClause => {
-    if (Array.isArray(input)) {
+    if (typeof input === "string" || Array.isArray(input)) {
       return {
         kind: "columns",
-        columns: normalizeColumnList(input) as readonly [string, ...string[]]
+        columns: normalizeConflictColumns(target, input)
       }
     }
     if (!Array.isArray(input) && "constraint" in input) {
@@ -4318,12 +4421,12 @@ type BinaryPredicateExpression<
       }
     }
     const columnTarget = input as {
-      readonly columns: readonly string[]
+      readonly columns: string | readonly string[]
       readonly where?: PredicateInput
     }
     return {
       kind: "columns",
-      columns: normalizeColumnList(columnTarget.columns) as readonly [string, ...string[]],
+      columns: normalizeConflictColumns(target, columnTarget.columns),
       where: columnTarget.where === undefined ? undefined : toDialectExpression(columnTarget.where)
     }
   }
@@ -4361,11 +4464,21 @@ type ValidateDdlColumns<
   Columns extends readonly string[]
 > = Exclude<Columns[number], SchemaColumnNames<Target>> extends never ? Columns : never
 
+type ValidateDdlColumnInput<
+  Target extends SchemaTableLike,
+  Columns extends DdlColumnInput
+> = ValidateDdlColumns<Target, NormalizeDdlColumns<Columns>> extends never ? never : Columns
+
 type ValidateTargetColumns<
   Target extends MutationTargetLike,
   Columns extends readonly string[]
 > = Exclude<Columns[number], Extract<keyof Target[typeof Table.TypeId]["fields"], string>> extends never ? Columns : never
 
+type ValidateTargetColumnInput<
+  Target extends MutationTargetLike,
+  Columns extends DdlColumnInput
+> = ValidateTargetColumns<Target, NormalizeDdlColumns<Columns>> extends never ? never : Columns
+
 type CreateIndexOptions = {
   readonly name?: string
   readonly unique?: boolean
@@ -4395,10 +4508,15 @@ type TransactionOptions = {
   readonly readOnly?: boolean
 }
 
-type LockOptions = {
-  readonly nowait?: boolean
-  readonly skipLocked?: boolean
-}
+type LockOptions =
+  | {
+    readonly nowait?: boolean
+    readonly skipLocked?: false
+  }
+  | {
+    readonly nowait?: false
+    readonly skipLocked?: boolean
+  }
 
 type UpsertConflictOptions = {
   readonly update?: Record<string, unknown>
@@ -4413,14 +4531,133 @@ type InsertRowInput<Target extends MutationTargetLike> = MutationInputOf<Table.I
 type ValuesRowInput = Record<string, ExpressionInput>
 type ValuesRowsInput = readonly [ValuesRowInput, ...ValuesRowInput[]]
 
+type ValuesColumnInput<Row, Key extends PropertyKey> =
+  Row extends ValuesRowInput
+    ? Key extends keyof Row ? Row[Key] : never
+    : never
+
+type ValuesRowShapeMismatch<
+  First extends ValuesRowInput,
+  Row extends ValuesRowInput
+> =
+  | Exclude<Extract<keyof Row, string>, Extract<keyof First, string>>
+  | Exclude<Extract<keyof First, string>, Extract<keyof Row, string>>
+
+type ValuesRowsShapeMismatchesFor<
+  First extends ValuesRowInput,
+  Row
+> = Row extends ValuesRowInput ? ValuesRowShapeMismatch<First, Row> : never
+
+type ValuesRowsShapeMismatches<Rows extends ValuesRowsInput> =
+  Rows extends readonly [infer First extends ValuesRowInput, ...infer Rest extends ValuesRowInput[]]
+    ? ValuesRowsShapeMismatchesFor<First, Rest[number]>
+    : never
+
+type ValuesRowsColumnKeys<Rows extends ValuesRowsInput> =
+  Rows extends readonly [infer First extends ValuesRowInput, ...ValuesRowInput[]]
+    ? Extract<keyof First, string>
+    : never
+
+type ValuesRowsShapeInput<Rows extends ValuesRowsInput> =
+  [ValuesRowsColumnKeys<Rows>] extends [never]
+    ? {
+        readonly __effect_qb_error__: "effect-qb: values rows must project at least one column"
+      }
+    : [ValuesRowsShapeMismatches<Rows>] extends [never]
+      ? unknown
+    : {
+        readonly __effect_qb_error__: "effect-qb: values rows must project the same columns"
+        readonly __effect_qb_mismatched_columns__: ValuesRowsShapeMismatches<Rows>
+      }
+
+type ValuesRowsDialect<
+  Rows extends ValuesRowsInput,
+  Dialect extends string,
+  TextDb extends Expression.DbType.Any,
+  NumericDb extends Expression.DbType.Any,
+  BoolDb extends Expression.DbType.Any,
+  TimestampDb extends Expression.DbType.Any,
+  NullDb extends Expression.DbType.Any
+> = Rows[number][keyof Rows[number]] extends infer Value extends ExpressionInput
+  ? DialectOfDialectInput<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
+  : never
+
+type ValuesRowsDialectInput<
+  Rows extends ValuesRowsInput,
+  Dialect extends string,
+  TextDb extends Expression.DbType.Any,
+  NumericDb extends Expression.DbType.Any,
+  BoolDb extends Expression.DbType.Any,
+  TimestampDb extends Expression.DbType.Any,
+  NullDb extends Expression.DbType.Any
+> = Exclude<ValuesRowsDialect<Rows, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>, Dialect> extends never
+  ? unknown
+  : {
+      readonly __effect_qb_error__: "effect-qb: values rows cannot mix dialects"
+      readonly __effect_qb_dialect__: ValuesRowsDialect<Rows, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
+    }
+
 type UnnestColumnsInput = Record<string, readonly [ExpressionInput, ...ExpressionInput[]]>
 
+type IsNever<Value> = [Value] extends [never] ? true : false
+
+type IsUnion<Value, All = Value> = Value extends any
+  ? ([All] extends [Value] ? false : true)
+  : never
+
+type UnnestColumnKeys<Columns extends UnnestColumnsInput> =
+  Extract<keyof Columns, string>
+
+type UnnestColumnLengths<Columns extends UnnestColumnsInput> =
+  Columns[UnnestColumnKeys<Columns>]["length"]
+
+type UnnestColumnsShapeInput<Columns extends UnnestColumnsInput> =
+  IsNever<UnnestColumnKeys<Columns>> extends true
+    ? {
+        readonly __effect_qb_error__: "effect-qb: unnest requires at least one column array"
+      }
+    : number extends UnnestColumnLengths<Columns>
+      ? unknown
+      : IsUnion<UnnestColumnLengths<Columns>> extends true
+        ? {
+            readonly __effect_qb_error__: "effect-qb: unnest column arrays must have the same length"
+            readonly __effect_qb_column_lengths__: UnnestColumnLengths<Columns>
+          }
+        : unknown
+
+type UnnestColumnsDialect<
+  Columns extends UnnestColumnsInput,
+  Dialect extends string,
+  TextDb extends Expression.DbType.Any,
+  NumericDb extends Expression.DbType.Any,
+  BoolDb extends Expression.DbType.Any,
+  TimestampDb extends Expression.DbType.Any,
+  NullDb extends Expression.DbType.Any
+> = Columns[UnnestColumnKeys<Columns>][number] extends infer Value extends ExpressionInput
+  ? DialectOfDialectInput<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
+  : never
+
+type UnnestColumnsDialectInput<
+  Columns extends UnnestColumnsInput,
+  Dialect extends string,
+  TextDb extends Expression.DbType.Any,
+  NumericDb extends Expression.DbType.Any,
+  BoolDb extends Expression.DbType.Any,
+  TimestampDb extends Expression.DbType.Any,
+  NullDb extends Expression.DbType.Any
+> = Exclude<UnnestColumnsDialect<Columns, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>, Dialect> extends never
+  ? unknown
+  : {
+      readonly __effect_qb_error__: "effect-qb: unnest columns cannot mix dialects"
+      readonly __effect_qb_dialect__: UnnestColumnsDialect<Columns, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
+    }
+
 type UnnestRowShape<Shape extends Record<string, readonly unknown[]>> = {
   readonly [K in keyof Shape]: Shape[K] extends readonly (infer Item)[] ? Item : never
 }
 
 type ValuesOutputShape<
-  Row extends ValuesRowInput,
+  Rows extends ValuesRowsInput,
   Dialect extends string,
   TextDb extends Expression.DbType.Any,
   NumericDb extends Expression.DbType.Any,
@@ -4428,7 +4665,7 @@ type ValuesOutputShape<
   TimestampDb extends Expression.DbType.Any,
   NullDb extends Expression.DbType.Any
 > = {
-  readonly [K in keyof Row]: DialectAsExpression<Row[K], Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
+  readonly [K in keyof Rows[0]]: DialectAsExpression<ValuesColumnInput<Rows[number], K>, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
 }
 
 type UnnestOutputShape<
@@ -4468,18 +4705,18 @@ type DistinctOnUnsupportedError<Dialect extends string> = {
 }
 
 type DistinctOnApi<Dialect extends string> = Dialect extends "postgres"
-  ? <Values extends readonly ExpressionInput[]>(
+  ? <Values extends readonly [ExpressionInput, ...ExpressionInput[]]>(
       ...values: Values
     ) => <PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>>(
       plan: PlanValue & RequireSelectStatement<PlanValue>
     ) => QueryPlan<
       SelectionOfPlan<PlanValue>,
-      RequiredOfPlan<PlanValue>,
+      AddExpressionRequired<RequiredOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, Values[number]>,
       AvailableOfPlan<PlanValue>,
-      PlanDialectOf<PlanValue>,
+      PlanDialectOf<PlanValue> | DialectOfDialectInput<Values[number], Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
       GroupedOfPlan<PlanValue>,
       ScopedNamesOfPlan<PlanValue>,
-      OutstandingOfPlan<PlanValue>,
+      AddExpressionRequired<OutstandingOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, Values[number]>,
       AssumptionsOfPlan<PlanValue>,
       CapabilitiesOfPlan<PlanValue>,
       StatementOfPlan<PlanValue>,
@@ -4515,6 +4752,44 @@ type MysqlConflictWhereError<Values> = Values & {
   readonly __effect_qb_hint__: "Move the condition into the update assignment expressions or use the Postgres dialect"
 }
 
+type ConflictActionWhereWithoutUpdateError<Values> = Values & {
+  readonly __effect_qb_error__: "effect-qb: conflict action where(...) requires update assignments"
+  readonly __effect_qb_hint__: "Add update assignments or move the predicate into the conflict target"
+}
+
+type ConflictActionWhereInput<Dialect extends string> =
+  Dialect extends "postgres" ? PredicateInput : MysqlConflictWhereError<PredicateInput>
+
+type UpdateValuesNonEmptyError<Values> = Values & {
+  readonly __effect_qb_error__: "effect-qb: update statements require at least one assignment"
+}
+
+type UpdateValuesNonEmptyConstraint<Values> =
+  [Extract<keyof Values, string>] extends [never]
+    ? UpdateValuesNonEmptyError<Values>
+    : unknown
+
+type NestedUpdateValuesNonEmptyConstraint<Values> =
+  [Extract<keyof Values, string>] extends [never]
+    ? UpdateValuesNonEmptyError<Values>
+    : true extends {
+      [K in Extract<keyof Values, string>]:
+        Values[K] extends Record<string, unknown>
+          ? [Extract<keyof Values[K], string>] extends [never] ? false : true
+          : false
+    }[Extract<keyof Values, string>]
+      ? unknown
+      : UpdateValuesNonEmptyError<Values>
+
+type MergeInsertValuesNonEmptyError<Values> = Values & {
+  readonly __effect_qb_error__: "effect-qb: merge insert actions require at least one value"
+}
+
+type MergeInsertValuesNonEmptyConstraint<Values> =
+  [Extract<keyof Values, string>] extends [never]
+    ? MergeInsertValuesNonEmptyError<Values>
+    : unknown
+
 type InsertShapeExtraKeys<TargetShape, SourceShape> = Exclude<Extract<keyof SourceShape, string>, Extract<keyof TargetShape, string>>
 type InsertShapeMissingKeys<TargetShape, SourceShape> = Exclude<RequiredKeys<TargetShape>, Extract<keyof SourceShape, string>>
 type InsertShapeMismatchedKeys<TargetShape, SourceShape> = Extract<{
@@ -4608,10 +4883,15 @@ type InsertSourceRequired<Source> =
       Source extends QueryPlan<any, any, any, any, any, any, any, any, any, any> ? RequiredOfPlan<Source> :
         never
 
+type InsertSourceDialect<Source> =
+  Source extends QueryPlan<any, any, any, any, any, any, any, any, any, any> ? PlanDialectOf<Source> :
+    Source extends SourceLike ? SourceDialectOf<Source> :
+      never
+
 type ConflictColumnTarget<
   Target extends MutationTargetLike,
   Columns extends DdlColumnInput
-> = ValidateTargetColumns<Target, NormalizeDdlColumns<Columns>>
+> = ValidateTargetColumnInput<Target, Columns>
 
 type ConflictTargetInput<
   Target extends MutationTargetLike,
@@ -4636,10 +4916,64 @@ type ConflictActionInput<
   Target extends MutationTargetLike,
   Dialect extends string,
   UpdateValues extends MutationInputOf<Table.UpdateOf<Target>> | undefined = MutationInputOf<Table.UpdateOf<Target>> | undefined
+> =
+  | {
+      readonly update: Exclude<UpdateValues, undefined>
+      readonly where?: ConflictActionWhereInput<Dialect>
+    }
+  | {
+      readonly update?: undefined
+      readonly where?: ConflictActionWhereWithoutUpdateError<PredicateInput>
+    }
+
+type ConflictActionUpdateNonEmptyConstraint<Options> =
+  Options extends { readonly update: infer Values }
+    ? UpdateValuesNonEmptyConstraint<Values>
+    : unknown
+
+type ConflictTargetPredicate<Target> =
+  Target extends { readonly where?: infer Predicate } ? Extract<Predicate, PredicateInput> : never
+
+type ConflictActionPredicate<Options> =
+  Options extends { readonly where?: infer Predicate } ? Extract<Predicate, PredicateInput> : never
+
+type MutationDialectFromValues<
+  Values extends Record<string, unknown>,
+  Dialect extends string,
+  TextDb extends Expression.DbType.Any,
+  NumericDb extends Expression.DbType.Any,
+  BoolDb extends Expression.DbType.Any,
+  TimestampDb extends Expression.DbType.Any,
+  NullDb extends Expression.DbType.Any
 > = {
-  readonly update?: UpdateValues
-  readonly where?: Dialect extends "postgres" ? PredicateInput : MysqlConflictWhereError<PredicateInput>
-}
+  [K in keyof Values]: Values[K] extends ExpressionInput
+    ? DialectOfDialectInput<Values[K], Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
+    : never
+}[keyof Values]
+
+type ConflictRequired<
+  UpdateValues extends MutationInputOf<any> | undefined,
+  Options,
+  ConflictTarget
+> =
+  | MutationRequiredFromValues<Exclude<UpdateValues, undefined>>
+  | RequiredFromInput<ConflictActionPredicate<Options>>
+  | RequiredFromInput<ConflictTargetPredicate<ConflictTarget>>
+
+type ConflictDialect<
+  UpdateValues extends MutationInputOf<any> | undefined,
+  Options,
+  ConflictTarget,
+  Dialect extends string,
+  TextDb extends Expression.DbType.Any,
+  NumericDb extends Expression.DbType.Any,
+  BoolDb extends Expression.DbType.Any,
+  TimestampDb extends Expression.DbType.Any,
+  NullDb extends Expression.DbType.Any
+> =
+  | MutationDialectFromValues<Exclude<UpdateValues, undefined>, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
+  | DialectOfDialectInput<ConflictActionPredicate<Options>, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
+  | DialectOfDialectInput<ConflictTargetPredicate<ConflictTarget>, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
 
 type MergeWhenMatchedDelete<
   Predicate extends PredicateInput | undefined = undefined
@@ -4654,7 +4988,7 @@ type MergeWhenMatchedUpdate<
   Values extends MutationInputOf<Table.UpdateOf<Target>>,
   Predicate extends PredicateInput | undefined = undefined
 > = {
-  readonly update: Values
+  readonly update: Values & UpdateValuesNonEmptyConstraint<Values>
   readonly predicate?: Predicate
   readonly delete?: never
 }
@@ -4664,20 +4998,37 @@ type MergeWhenNotMatched<
   Values extends MutationInputOf<Table.InsertOf<Target>>,
   Predicate extends PredicateInput | undefined = undefined
 > = {
-  readonly values: Values
+  readonly values: Values & MergeInsertValuesNonEmptyConstraint<Values>
   readonly predicate?: Predicate
 }
 
+type MergeMatchedOption<
+  Target extends MutationTargetLike,
+  MatchedValues extends MutationInputOf<Table.UpdateOf<Target>>,
+  MatchedPredicate extends PredicateInput | undefined = undefined
+> = MergeWhenMatchedDelete<MatchedPredicate> | MergeWhenMatchedUpdate<Target, MatchedValues, MatchedPredicate>
+
+type MergeNotMatchedOption<
+  Target extends MutationTargetLike,
+  InsertValues extends MutationInputOf<Table.InsertOf<Target>>,
+  NotMatchedPredicate extends PredicateInput | undefined = undefined
+> = MergeWhenNotMatched<Target, InsertValues, NotMatchedPredicate>
+
 type MergeOptions<
   Target extends MutationTargetLike,
   MatchedValues extends MutationInputOf<Table.UpdateOf<Target>>,
   InsertValues extends MutationInputOf<Table.InsertOf<Target>>,
   MatchedPredicate extends PredicateInput | undefined = undefined,
   NotMatchedPredicate extends PredicateInput | undefined = undefined
-> = {
-  readonly whenMatched?: MergeWhenMatchedDelete<MatchedPredicate> | MergeWhenMatchedUpdate<Target, MatchedValues, MatchedPredicate>
-  readonly whenNotMatched?: MergeWhenNotMatched<Target, InsertValues, NotMatchedPredicate>
-}
+> =
+  | {
+    readonly whenMatched: MergeMatchedOption<Target, MatchedValues, MatchedPredicate>
+    readonly whenNotMatched?: MergeNotMatchedOption<Target, InsertValues, NotMatchedPredicate>
+  }
+  | {
+    readonly whenMatched?: MergeMatchedOption<Target, MatchedValues, MatchedPredicate>
+    readonly whenNotMatched: MergeNotMatchedOption<Target, InsertValues, NotMatchedPredicate>
+  }
 
 type RequireSelectStatement<PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>> =
   StatementOfPlan<PlanValue> extends "select" ? unknown : never
@@ -4709,6 +5060,11 @@ type MutationOrderLimitSupported<PlanValue extends QueryPlan<any, any, any, any,
       ? StatementOfPlan<PlanValue> extends "update" | "delete" ? unknown : never
       : never
 
+type MutationTargetTupleDialectConstraint<
+  Targets extends MutationTargetTuple,
+  Dialect extends string
+> = Exclude<TableDialectOf<Targets[number]>, Dialect> extends never ? unknown : never
+
 type MutationRequiredFromValues<Values extends Record<string, unknown>> = {
   [K in keyof Values]: Values[K] extends Expression.Any ? RequiredFromDependencies<DependenciesOf<Values[K]>> : never
 }[keyof Values]
@@ -4722,6 +5078,59 @@ type NestedMutationRequiredFromValues<Values> =
         }[keyof Values]
       : never
 
+type NestedMutationDialectFromValues<
+  Values,
+  Dialect extends string,
+  TextDb extends Expression.DbType.Any,
+  NumericDb extends Expression.DbType.Any,
+  BoolDb extends Expression.DbType.Any,
+  TimestampDb extends Expression.DbType.Any,
+  NullDb extends Expression.DbType.Any
+> =
+  Values extends ExpressionInput
+    ? DialectOfDialectInput<Values, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
+    : Values extends Record<string, unknown>
+      ? {
+          [K in keyof Values]: NestedMutationDialectFromValues<Values[K], Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
+        }[keyof Values]
+      : never
+
+type KnownMutationDialectFromValues<
+  Values,
+  Dialect extends string,
+  TextDb extends Expression.DbType.Any,
+  NumericDb extends Expression.DbType.Any,
+  BoolDb extends Expression.DbType.Any,
+  TimestampDb extends Expression.DbType.Any,
+  NullDb extends Expression.DbType.Any
+> = NestedMutationDialectFromValues<Values, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb> extends infer Current
+  ? Current extends string
+    ? string extends Current ? never : Current
+    : never
+  : never
+
+type KnownIncompatibleMutationDialectFromValues<
+  Values,
+  Dialect extends string,
+  TextDb extends Expression.DbType.Any,
+  NumericDb extends Expression.DbType.Any,
+  BoolDb extends Expression.DbType.Any,
+  TimestampDb extends Expression.DbType.Any,
+  NullDb extends Expression.DbType.Any
+> = Exclude<KnownMutationDialectFromValues<Values, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>, Dialect>
+
+type MutationValuesDialectConstraint<
+  Values,
+  Dialect extends string,
+  TextDb extends Expression.DbType.Any,
+  NumericDb extends Expression.DbType.Any,
+  BoolDb extends Expression.DbType.Any,
+  TimestampDb extends Expression.DbType.Any,
+  NullDb extends Expression.DbType.Any
+> = KnownIncompatibleMutationDialectFromValues<Values, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb> extends never
+  ? unknown
+  : never
+
 type MutationAssignments<Shape extends Record<string, unknown>> = {
   readonly [K in keyof Shape]: QueryAst.AssignmentClause
 }
@@ -4755,12 +5164,38 @@ type InsertDirectSource =
 
 type FromInput = SourceLike | InsertDirectSource
 
+type SourceDialectConstraint<
+  CurrentSource extends SourceLike,
+  Dialect extends string
+> = [SourceDialectOf<CurrentSource>] extends [never]
+  ? unknown
+  : Extract<SourceDialectOf<CurrentSource>, Dialect> extends never
+    ? never
+    : unknown
+
+type SourceRequirementConstraint<
+  PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>,
+  CurrentSource extends SourceLike
+> = [SourceRequiredOf<CurrentSource>] extends [never]
+  ? unknown
+  : Exclude<SourceRequiredOf<CurrentSource>, ScopedNamesOfPlan<PlanValue>> extends never
+    ? unknown
+    : SourceRequirementError<CurrentSource>
+
 type SelectFromConstraint<
   PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>,
   CurrentSource extends SourceLike
 > =
   RequireSelectStatement<PlanValue> &
-  (SourceNameOf<CurrentSource> extends OutstandingOfPlan<PlanValue> ? unknown : never) &
+  (
+    SourceNameOf<CurrentSource> extends OutstandingOfPlan<PlanValue>
+      ? unknown
+      : [OutstandingOfPlan<PlanValue>] extends [never]
+        ? [ScopedNamesOfPlan<PlanValue>] extends [never]
+          ? unknown
+          : never
+        : never
+  ) &
   (SourceRequiredOf<CurrentSource> extends never ? unknown : SourceRequirementError<CurrentSource>)
 
 type UpdateFromConstraint<
@@ -4777,7 +5212,7 @@ type InsertFromConstraint<
   Dialect extends string
 > =
   RequirePendingInsertStatement<PlanValue> &
-  (InsertSourceOfPlanInput<PlanValue, CurrentSource, Dialect> extends CurrentSource
+  (CurrentSource extends InsertSourceOfPlanInput<PlanValue, CurrentSource, Dialect>
     ? unknown
     : InsertSourceOfPlanInput<PlanValue, CurrentSource, Dialect>)
 
@@ -4831,12 +5266,12 @@ type InsertFromResult<
   Dialect extends string
 > = QueryPlan<
   SelectionOfPlan<PlanValue>,
-  Exclude<InsertSourceRequired<CurrentSource>, AvailableNames<AvailableOfPlan<PlanValue>>>,
+  InsertSourceRequired<CurrentSource>,
   AvailableOfPlan<PlanValue>,
-  PlanDialectOf<PlanValue>,
+  PlanDialectOf<PlanValue> | InsertSourceDialect<CurrentSource>,
   GroupedOfPlan<PlanValue>,
   ScopedNamesOfPlan<PlanValue>,
-  Exclude<InsertSourceRequired<CurrentSource>, AvailableNames<AvailableOfPlan<PlanValue>>>,
+  InsertSourceRequired<CurrentSource>,
   AssumptionsOfPlan<PlanValue>,
   CurrentSource extends QueryPlan<any, any, any, any, any, any, any, any, any, any>
     ? MergeCapabilities<CapabilitiesOfPlan<PlanValue>, CapabilitiesOfPlan<CurrentSource>>
@@ -4853,15 +5288,17 @@ type FromPlanConstraint<
   Dialect extends string
 > =
   CurrentSource extends SourceLike
-    ? StatementOfPlan<PlanValue> extends "select"
-      ? SelectFromConstraint<PlanValue, CurrentSource>
-      : StatementOfPlan<PlanValue> extends "update"
-        ? UpdateFromConstraint<PlanValue, CurrentSource>
-        : StatementOfPlan<PlanValue> extends "insert"
-          ? CurrentSource extends AnyValuesSource | AnyUnnestSource
-            ? InsertFromConstraint<PlanValue, CurrentSource, Dialect>
-            : never
-          : never
+    ? SourceDialectConstraint<CurrentSource, Dialect> & (
+        StatementOfPlan<PlanValue> extends "select"
+          ? SelectFromConstraint<PlanValue, CurrentSource>
+          : StatementOfPlan<PlanValue> extends "update"
+            ? UpdateFromConstraint<PlanValue, CurrentSource>
+            : StatementOfPlan<PlanValue> extends "insert"
+              ? CurrentSource extends AnyValuesSource | AnyUnnestSource
+                ? InsertFromConstraint<PlanValue, CurrentSource, Dialect>
+                : never
+              : never
+      )
     : CurrentSource extends InsertDirectSource
       ? StatementOfPlan<PlanValue> extends "insert"
         ? InsertFromConstraint<PlanValue, CurrentSource, Dialect>
@@ -4916,7 +5353,10 @@ export type PublicStructuredFromResult<
         Exclude<OutstandingOfPlan<PlanValue>, SourceNameOf<CurrentSource>>,
         AssumptionsOfPlan<PlanValue>,
         MergeCapabilities<CapabilitiesOfPlan<PlanValue>, SourceCapabilitiesOf<CurrentSource>>,
-        StatementOfPlan<PlanValue>
+        StatementOfPlan<PlanValue>,
+        MutationTargetOfPlan<PlanValue>,
+        InsertSourceStateOfPlan<PlanValue>,
+        FactsOfPlan<PlanValue>
       >
     : StatementOfPlan<PlanValue> extends "update"
       ? QueryPlan<
@@ -4929,7 +5369,10 @@ export type PublicStructuredFromResult<
           Exclude<OutstandingOfPlan<PlanValue>, SourceNameOf<CurrentSource>>,
           AssumptionsOfPlan<PlanValue>,
           MergeCapabilities<CapabilitiesOfPlan<PlanValue>, SourceCapabilitiesOf<CurrentSource>>,
-          StatementOfPlan<PlanValue>
+          StatementOfPlan<PlanValue>,
+          MutationTargetOfPlan<PlanValue>,
+          InsertSourceStateOfPlan<PlanValue>,
+          FactsOfPlan<PlanValue>
         >
       : StatementOfPlan<PlanValue> extends "insert"
       ? CurrentSource extends AnyValuesSource | AnyUnnestSource
@@ -4937,7 +5380,7 @@ export type PublicStructuredFromResult<
             SelectionOfPlan<PlanValue>,
             never,
             AvailableOfPlan<PlanValue>,
-            PlanDialectOf<PlanValue>,
+            PlanDialectOf<PlanValue> | SourceDialectOf<CurrentSource>,
             GroupedOfPlan<PlanValue>,
             ScopedNamesOfPlan<PlanValue>,
             never,
@@ -4945,7 +5388,8 @@ export type PublicStructuredFromResult<
             CapabilitiesOfPlan<PlanValue>,
             StatementOfPlan<PlanValue>,
             MutationTargetOfPlan<PlanValue>,
-            "ready"
+            "ready",
+            FactsOfPlan<PlanValue>
           >
         : FromPlanResult<PlanValue, CurrentSource, Dialect>
       : FromPlanResult<PlanValue, CurrentSource, Dialect>
@@ -4962,6 +5406,36 @@ type MergeRequiredFromPredicate<
   Available extends Record<string, Plan.AnySource>
 > = Predicate extends PredicateInput ? AddExpressionRequired<never, Available, Predicate> : never
 
+type BroadString<Value extends string> = string extends Value ? true : false
+
+type SameSourceName<
+  Left extends string,
+  Right extends string
+> = [Left] extends [Right] ? [Right] extends [Left] ? true : false : false
+
+type MergeSourceNameConflictError<
+  TargetName extends string,
+  SourceName extends string
+> = {
+  readonly __effect_qb_error__: "effect-qb: merge source name must differ from target source name"
+  readonly __effect_qb_target_source_name__: TargetName
+  readonly __effect_qb_using_source_name__: SourceName
+  readonly __effect_qb_hint__: "Alias the merge source with Table.alias(...), Query.as(...), or Query.with(...)"
+}
+
+type MergeSourceNameConstraint<
+  Target extends MutationTargetLike,
+  Source extends SourceLike,
+  TargetName extends string = SourceNameOf<Target>,
+  SourceName extends string = SourceNameOf<Source>
+> = BroadString<TargetName> extends true
+  ? unknown
+  : BroadString<SourceName> extends true
+    ? unknown
+    : SameSourceName<TargetName, SourceName> extends true
+      ? MergeSourceNameConflictError<TargetName, SourceName>
+      : unknown
+
 type AsCurriedInput<Dialect extends string> =
   | ExpressionInput
   | ValuesInput<any, any, Dialect>
@@ -5001,20 +5475,20 @@ type AsCurriedResult<
   >(
     value: Value,
     alias: Alias
-  ): DialectAsExpression<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
+  ): ProjectionAliasedExpression<DialectAsExpression<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>, Alias>
   function as<
     Rows extends ValuesRowsInput,
     Alias extends string
   >(
     value: ValuesInput<
       Rows,
-      ValuesOutputShape<Rows[0], Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
+      ValuesOutputShape<Rows, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
       Dialect
     >,
     alias: Alias
   ): ValuesSource<
     Rows,
-    ValuesOutputShape<Rows[0], Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
+    ValuesOutputShape<Rows, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
     Alias,
     Dialect
   >
@@ -5022,7 +5496,7 @@ type AsCurriedResult<
     PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>,
     Alias extends string
   >(
-    value: CompletePlan<PlanValue>,
+    value: DerivedTableCompatiblePlan<PlanValue>,
     alias: Alias
   ): DerivedSource<PlanValue, Alias>
   function as(valueOrAlias: unknown, alias?: string): unknown {
@@ -5069,13 +5543,13 @@ type AsCurriedResult<
   >(
     alias: Alias
   ): <PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>>(
-    value: CompletePlan<PlanValue>
+    value: DerivedSourceCompatiblePlan<PlanValue>
   ) => import("../../internal/query.js").CteSource<PlanValue, Alias>
   function with_<
     PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>,
     Alias extends string
   >(
-    value: CompletePlan<PlanValue>,
+    value: DerivedSourceCompatiblePlan<PlanValue>,
     alias: Alias
   ): import("../../internal/query.js").CteSource<PlanValue, Alias>
   function with_(valueOrAlias: unknown, alias?: string): unknown {
@@ -5093,13 +5567,13 @@ type AsCurriedResult<
   >(
     alias: Alias
   ): <PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>>(
-    value: CompletePlan<PlanValue>
+    value: DerivedSourceCompatiblePlan<PlanValue>
   ) => import("../../internal/query.js").CteSource<PlanValue, Alias>
   function withRecursive_<
     PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>,
     Alias extends string
   >(
-    value: CompletePlan<PlanValue>,
+    value: DerivedSourceCompatiblePlan<PlanValue>,
     alias: Alias
   ): import("../../internal/query.js").CteSource<PlanValue, Alias>
   function withRecursive_(valueOrAlias: unknown, alias?: string): unknown {
@@ -5118,13 +5592,13 @@ type AsCurriedResult<
   >(
     alias: Alias
   ): <PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>>(
-    value: PlanValue
+    value: LateralSourceCompatiblePlan<PlanValue>
   ) => import("../../internal/query.js").LateralSource<PlanValue, Alias>
   function lateral<
     PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>,
     Alias extends string
   >(
-    value: PlanValue,
+    value: LateralSourceCompatiblePlan<PlanValue>,
     alias: Alias
   ): import("../../internal/query.js").LateralSource<PlanValue, Alias>
   function lateral(valueOrAlias: unknown, alias?: string): unknown {
@@ -5141,9 +5615,11 @@ type AsCurriedResult<
     Rows extends ValuesRowsInput
   >(
     rows: Rows
+      & ValuesRowsShapeInput<Rows>
+      & ValuesRowsDialectInput<Rows, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
   ) => ValuesInput<
     Rows,
-    ValuesOutputShape<Rows[0], Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
+    ValuesOutputShape<Rows, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
     Dialect
   >
 
@@ -5151,7 +5627,9 @@ type AsCurriedResult<
     Columns extends UnnestColumnsInput,
     Alias extends string
   >(
-    columns: Columns,
+    columns: Columns
+      & UnnestColumnsShapeInput<Columns>
+      & UnnestColumnsDialectInput<Columns, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
     alias: Alias
   ) => UnnestSource<
     UnnestOutputShape<Columns, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
@@ -5165,9 +5643,9 @@ type AsCurriedResult<
     Step extends NumericExpressionInput | undefined = undefined,
     Alias extends string = "series"
   >(
-    start: Start,
-    stop: Stop,
-    step?: Step,
+    start: Start & NumericExpressionDialectInput<Start, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
+    stop: Stop & NumericExpressionDialectInput<Stop, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
+    step?: Step & (Step extends NumericExpressionInput ? NumericExpressionDialectInput<Step, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb> : unknown),
     alias?: Alias
   ) => Dialect extends "postgres"
     ? TableFunctionSource<
@@ -5179,11 +5657,14 @@ type AsCurriedResult<
     : GenerateSeriesUnsupportedError<Dialect>
 
   export type PublicGenerateSeriesApi = <
+    Start extends NumericExpressionInput,
+    Stop extends NumericExpressionInput,
+    Step extends NumericExpressionInput | undefined = undefined,
     Alias extends string = "series"
   >(
-    start: NumericExpressionInput,
-    stop: NumericExpressionInput,
-    step?: NumericExpressionInput,
+    start: Start & NumericExpressionDialectInput<Start, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
+    stop: Stop & NumericExpressionDialectInput<Stop, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
+    step?: Step & (Step extends NumericExpressionInput ? NumericExpressionDialectInput<Step, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb> : unknown),
     alias?: Alias
   ) => TableFunctionSource<
     {
@@ -5194,8 +5675,36 @@ type AsCurriedResult<
     "generate_series"
   >
 
-  export type SelectApi = <Selection extends SelectionShape>(
-    selection: Selection
+  type SelectionRootObjectError<Selection> = Selection & {
+    readonly __effect_qb_error__: "effect-qb: selections must be projection objects"
+    readonly __effect_qb_hint__: "Use select({ value: expression }) or returning({ value: expression })"
+  }
+
+  type SelectionRootObjectConstraint<Selection> =
+    Selection extends Expression.Any ? SelectionRootObjectError<Selection> : unknown
+
+  type SelectionNestedEmptyError<Selection> = Selection & {
+    readonly __effect_qb_error__: "effect-qb: projection objects cannot contain empty nested selections"
+  }
+
+  type SelectionHasEmptyNestedObject<Selection, IsRoot extends boolean> =
+    Selection extends Expression.Any
+      ? false
+      : Selection extends Record<string, any>
+        ? [Extract<keyof Selection, string>] extends [never]
+          ? IsRoot extends true ? false : true
+          : true extends {
+              [K in Extract<keyof Selection, string>]: SelectionHasEmptyNestedObject<Selection[K], false>
+            }[Extract<keyof Selection, string>]
+            ? true
+            : false
+        : false
+
+  type SelectionNestedNonEmptyConstraint<Selection> =
+    SelectionHasEmptyNestedObject<Selection, true> extends true ? SelectionNestedEmptyError<Selection> : unknown
+
+  export type SelectApi = <Selection extends SelectionShape = {}>(
+    selection?: Selection & SelectionRootObjectConstraint<Selection> & SelectionNestedNonEmptyConstraint<Selection>
   ) => QueryPlan<
     Selection,
     ExtractRequired<Selection>,
@@ -5254,7 +5763,10 @@ type AsCurriedResult<
     never,
     TrueFormula,
     CapabilitiesOfPlan<LeftPlanValue> | CapabilitiesOfPlan<RightPlanValue>,
-    "set"
+    "set",
+    any,
+    "ready",
+    CommonSetFacts<LeftPlanValue, RightPlanValue>
   >
 
   type SetOperationApi = <
@@ -5322,10 +5834,10 @@ type AsCurriedResult<
         keyof AvailableOfPlan<PlanValue> extends never ? never : unknown
       ) & (
         SourceNameOf<CurrentTable> extends ScopedNamesOfPlan<PlanValue> ? never : unknown
-      )
+      ) & SourceRequirementConstraint<PlanValue, CurrentTable> & SourceDialectConstraint<CurrentTable, Dialect>
     ) => QueryPlan<
       SelectionOfPlan<PlanValue>,
-      AddJoinRequired<RequiredOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, SourceNameOf<CurrentTable>, never, "cross">,
+      AddJoinRequired<RequiredOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, SourceNameOf<CurrentTable>, never, "cross", SourceRequiredOf<CurrentTable>>,
       AddAvailable<
         AvailableOfPlan<PlanValue>,
         SourceNameOf<CurrentTable>,
@@ -5336,10 +5848,13 @@ type AsCurriedResult<
       PlanDialectOf<PlanValue> | SourceDialectOf<CurrentTable>,
       GroupedOfPlan<PlanValue>,
       ScopedNamesOfPlan<PlanValue> | SourceNameOf<CurrentTable>,
-      AddJoinRequired<OutstandingOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, SourceNameOf<CurrentTable>, never, "cross">,
+      AddJoinRequired<OutstandingOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, SourceNameOf<CurrentTable>, never, "cross", SourceRequiredOf<CurrentTable>>,
       AssumptionsOfPlan<PlanValue>,
       MergeCapabilities<CapabilitiesOfPlan<PlanValue>, SourceCapabilitiesOf<CurrentTable>>,
-      StatementOfPlan<PlanValue>
+      StatementOfPlan<PlanValue>,
+      MutationTargetOfPlan<PlanValue>,
+      InsertSourceStateOfPlan<PlanValue>,
+      FactsOfPlan<PlanValue>
     >
 
   type JoinApi = <
@@ -5356,10 +5871,10 @@ type AsCurriedResult<
         keyof AvailableOfPlan<PlanValue> extends never ? never : unknown
       ) & (
         SourceNameOf<CurrentTable> extends ScopedNamesOfPlan<PlanValue> ? never : unknown
-      )
+      ) & SourceRequirementConstraint<PlanValue, CurrentTable> & SourceDialectConstraint<CurrentTable, Dialect>
     ) => QueryPlan<
       SelectionOfPlan<PlanValue>,
-      AddJoinRequired<RequiredOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, SourceNameOf<CurrentTable>, Predicate, Kind>,
+      AddJoinRequired<RequiredOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, SourceNameOf<CurrentTable>, Predicate, Kind, SourceRequiredOf<CurrentTable>>,
       AvailableAfterJoin<
         AvailableOfPlan<PlanValue>,
         SourceNameOf<CurrentTable>,
@@ -5370,7 +5885,7 @@ type AsCurriedResult<
       PlanDialectOf<PlanValue> | SourceDialectOf<CurrentTable> | DialectOfDialectInput<Predicate, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
       GroupedOfPlan<PlanValue>,
       ScopedNamesOfPlan<PlanValue> | SourceNameOf<CurrentTable>,
-      AddJoinRequired<OutstandingOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, SourceNameOf<CurrentTable>, Predicate, Kind>,
+      AddJoinRequired<OutstandingOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, SourceNameOf<CurrentTable>, Predicate, Kind, SourceRequiredOf<CurrentTable>>,
       PlanAssumptionsAfterJoin<PlanValue, Predicate, Kind, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
       MergeCapabilities<CapabilitiesOfPlan<PlanValue>, SourceCapabilitiesOf<CurrentTable>>,
       StatementOfPlan<PlanValue>,
@@ -5391,10 +5906,10 @@ type AsCurriedResult<
         keyof AvailableOfPlan<PlanValue> extends never ? never : unknown
       ) & (
         SourceNameOf<CurrentTable> extends ScopedNamesOfPlan<PlanValue> ? never : unknown
-      )
+      ) & SourceRequirementConstraint<PlanValue, CurrentTable> & SourceDialectConstraint<CurrentTable, Dialect>
     ) => QueryPlan<
       SelectionOfPlan<PlanValue>,
-      AddJoinRequired<RequiredOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, SourceNameOf<CurrentTable>, Predicate, Kind>,
+      AddJoinRequired<RequiredOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, SourceNameOf<CurrentTable>, Predicate, Kind, SourceRequiredOf<CurrentTable>>,
       AvailableAfterJoin<
         AvailableOfPlan<PlanValue>,
         SourceNameOf<CurrentTable>,
@@ -5405,7 +5920,7 @@ type AsCurriedResult<
       PlanDialectOf<PlanValue> | SourceDialectOf<CurrentTable> | DialectOfDialectInput<Predicate, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
       GroupedOfPlan<PlanValue>,
       ScopedNamesOfPlan<PlanValue> | SourceNameOf<CurrentTable>,
-      AddJoinRequired<OutstandingOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, SourceNameOf<CurrentTable>, Predicate, Kind>,
+      AddJoinRequired<OutstandingOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, SourceNameOf<CurrentTable>, Predicate, Kind, SourceRequiredOf<CurrentTable>>,
       PlanAssumptionsAfterJoin<PlanValue, Predicate, Kind, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
       MergeCapabilities<CapabilitiesOfPlan<PlanValue>, SourceCapabilitiesOf<CurrentTable>>,
       StatementOfPlan<PlanValue>,
@@ -5613,18 +6128,21 @@ type AsCurriedResult<
 
   const fullJoin = ((table, on) => (join as any)("full", table, on)) as BinaryJoinApi<"full">
 
-  const distinctOn = ((...values: readonly ExpressionInput[]) => {
+  const distinctOn = (<Values extends readonly [ExpressionInput, ...ExpressionInput[]]>(...values: Values) => {
+    if (values.length === 0) {
+      throw new Error("distinctOn(...) requires at least one expression")
+    }
     const expressions = values.map((value) => toDialectExpression(value)) as Expression.Any[]
     return <PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>>(
       plan: PlanValue & RequireSelectStatement<PlanValue>
     ): QueryPlan<
       SelectionOfPlan<PlanValue>,
-      RequiredOfPlan<PlanValue>,
+      AddExpressionRequired<RequiredOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, Values[number]>,
       AvailableOfPlan<PlanValue>,
-      PlanDialectOf<PlanValue>,
+      PlanDialectOf<PlanValue> | DialectOfDialectInput<Values[number], Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
       GroupedOfPlan<PlanValue>,
       ScopedNamesOfPlan<PlanValue>,
-      OutstandingOfPlan<PlanValue>,
+      AddExpressionRequired<OutstandingOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, Values[number]>,
       AssumptionsOfPlan<PlanValue>,
       CapabilitiesOfPlan<PlanValue>,
       StatementOfPlan<PlanValue>
@@ -5632,11 +6150,13 @@ type AsCurriedResult<
       const current = plan[Plan.TypeId]
       const currentAst = getAst(plan)
       const currentQuery = getQueryState(plan)
+      const required = values.flatMap((value) => extractRequiredFromDialectInputRuntime(value))
       return makePlan({
         selection: current.selection,
-        required: current.required as RequiredOfPlan<PlanValue>,
+        required: [...currentRequiredList(current.required), ...required].filter((name, index, list) =>
+          !(name in current.available) && list.indexOf(name) === index) as AddExpressionRequired<RequiredOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, Values[number]>,
         available: current.available,
-        dialect: current.dialect as PlanDialectOf<PlanValue>
+        dialect: current.dialect as PlanDialectOf<PlanValue> | DialectOfDialectInput<Values[number], Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
       }, {
         ...currentAst,
         distinct: true,
@@ -5666,8 +6186,19 @@ type AsCurriedResult<
       FactsOfPlan<PlanValue>
     >
 
+  type ReturningSelectionNonEmptyError<Selection> = Selection & {
+    readonly __effect_qb_error__: "effect-qb: returning(...) requires at least one selected expression"
+  }
+
+  type ReturningSelectionNonEmptyConstraint<Selection> =
+    Selection extends Expression.Any
+      ? unknown
+      : [Extract<keyof Selection, string>] extends [never]
+        ? ReturningSelectionNonEmptyError<Selection>
+        : unknown
+
   type ReturningApi = <Selection extends SelectionShape>(
-    selection: Selection
+    selection: Selection & SelectionRootObjectConstraint<Selection> & SelectionNestedNonEmptyConstraint<Selection> & ReturningSelectionNonEmptyConstraint<Selection>
   ) =>
     <PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>>(
       plan: PlanValue & RequireMutationStatement<PlanValue>
@@ -5707,12 +6238,12 @@ type AsCurriedResult<
     >
     <Target extends MutationTargetLike, Values extends Record<string, unknown>>(
       target: Target,
-      values: MutationValuesInput<"insert", Target, Values>
+      values: MutationValuesInput<"insert", Target, Values> & MutationValuesDialectConstraint<Values, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
     ): QueryPlan<
       {},
       Exclude<MutationRequiredFromValues<Values>, SourceNameOf<Target>>,
       AddAvailable<{}, SourceNameOf<Target>>,
-      TableDialectOf<Target>,
+      TableDialectOf<Target> | KnownMutationDialectFromValues<Values, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
       never,
       SourceNameOf<Target>,
       Exclude<MutationRequiredFromValues<Values>, SourceNameOf<Target>>,
@@ -5734,21 +6265,22 @@ type AsCurriedResult<
     Target extends MutationTargetLike,
     const Columns extends DdlColumnInput,
     UpdateValues extends MutationInputOf<Table.UpdateOf<Target>> | undefined = MutationInputOf<Table.UpdateOf<Target>> | undefined,
-    Options extends ConflictActionInput<Target, Dialect, UpdateValues> = ConflictActionInput<Target, Dialect, UpdateValues>
+    Options extends ConflictActionInput<Target, Dialect, UpdateValues> = ConflictActionInput<Target, Dialect, UpdateValues>,
+    ConflictTarget extends ConflictTargetInput<Target, Dialect, Columns> = ConflictTargetInput<Target, Dialect, Columns>
   >(
-    target: ConflictTargetInput<Target, Dialect, Columns>,
-    options?: Options
+    target: ConflictTarget,
+    options?: Options & ConflictActionUpdateNonEmptyConstraint<Options>
   ) =>
     <PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>>(
       plan: PlanValue & RequireInsertStatement<PlanValue>
     ) => QueryPlan<
       SelectionOfPlan<PlanValue>,
-      Exclude<RequiredOfPlan<PlanValue> | MutationRequiredFromValues<Exclude<UpdateValues, undefined>> | RequiredFromInput<Extract<Options["where"], PredicateInput>>, AvailableNames<AvailableOfPlan<PlanValue>>>,
+      Exclude<RequiredOfPlan<PlanValue> | ConflictRequired<UpdateValues, Options, ConflictTarget>, AvailableNames<AvailableOfPlan<PlanValue>>>,
       AvailableOfPlan<PlanValue>,
-      PlanDialectOf<PlanValue>,
+      PlanDialectOf<PlanValue> | ConflictDialect<UpdateValues, Options, ConflictTarget, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
       GroupedOfPlan<PlanValue>,
       ScopedNamesOfPlan<PlanValue>,
-      Exclude<OutstandingOfPlan<PlanValue> | MutationRequiredFromValues<Exclude<UpdateValues, undefined>> | RequiredFromInput<Extract<Options["where"], PredicateInput>>, AvailableNames<AvailableOfPlan<PlanValue>>>,
+      Exclude<OutstandingOfPlan<PlanValue> | ConflictRequired<UpdateValues, Options, ConflictTarget>, AvailableNames<AvailableOfPlan<PlanValue>>>,
       AssumptionsOfPlan<PlanValue>,
       CapabilitiesOfPlan<PlanValue>,
       StatementOfPlan<PlanValue>,
@@ -5759,13 +6291,13 @@ type AsCurriedResult<
 
   interface UpdateApi {
     <Targets extends MutationTargetTuple, Values extends UpdateInputOfTarget<Targets>>(
-      target: Dialect extends "mysql" ? Targets : never,
-      values: Values
+      target: Dialect extends "mysql" ? Targets & MutationTargetTupleDialectConstraint<Targets, Dialect> : never,
+      values: Values & NestedUpdateValuesNonEmptyConstraint<Values> & MutationValuesDialectConstraint<Values, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
     ): QueryPlan<
       {},
       Exclude<NestedMutationRequiredFromValues<Values>, MutationTargetNamesOf<Targets>>,
       AddAvailableMany<{}, MutationTargetNamesOf<Targets>>,
-      TableDialectOf<Targets[0]>,
+      TableDialectOf<Targets[0]> | KnownMutationDialectFromValues<Values, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
       never,
       MutationTargetNamesOf<Targets>,
       Exclude<NestedMutationRequiredFromValues<Values>, MutationTargetNamesOf<Targets>>,
@@ -5778,12 +6310,12 @@ type AsCurriedResult<
     >
     <Target extends MutationTargetLike, Values extends Record<string, unknown>>(
       target: Target,
-      values: MutationValuesInput<"update", Target, Values>
+      values: MutationValuesInput<"update", Target, Values> & UpdateValuesNonEmptyConstraint<Values> & MutationValuesDialectConstraint<Values, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
     ): QueryPlan<
       {},
       Exclude<MutationRequiredFromValues<Values>, SourceNameOf<Target>>,
       AddAvailable<{}, SourceNameOf<Target>>,
-      TableDialectOf<Target>,
+      TableDialectOf<Target> | KnownMutationDialectFromValues<Values, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
       never,
       SourceNameOf<Target>,
       Exclude<MutationRequiredFromValues<Values>, SourceNameOf<Target>>,
@@ -5800,20 +6332,22 @@ type AsCurriedResult<
     Target extends MutationTargetLike,
     Values extends MutationInputOf<Table.InsertOf<Target>>,
     const Columns extends DdlColumnInput,
-    UpdateValues extends MutationInputOf<Table.UpdateOf<Target>>
+    UpdateValues extends MutationInputOf<Table.UpdateOf<Target>> | undefined = undefined
   >(
     target: Target,
-    values: Values,
-    conflictColumns: ValidateTargetColumns<Target, NormalizeDdlColumns<Columns>>,
-    updateValues?: UpdateValues
+    values: Values & MutationValuesDialectConstraint<Values, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
+    conflictColumns: ValidateTargetColumnInput<Target, Columns>,
+    updateValues?: UpdateValues & UpdateValuesNonEmptyConstraint<Exclude<UpdateValues, undefined>> & MutationValuesDialectConstraint<Exclude<UpdateValues, undefined>, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
   ) => QueryPlan<
     {},
-    Exclude<MutationRequiredFromValues<Values> | MutationRequiredFromValues<UpdateValues>, SourceNameOf<Target>>,
+    Exclude<MutationRequiredFromValues<Values> | MutationRequiredFromValues<Exclude<UpdateValues, undefined>>, SourceNameOf<Target>>,
     AddAvailable<{}, SourceNameOf<Target>>,
-    TableDialectOf<Target>,
+    | TableDialectOf<Target>
+    | KnownMutationDialectFromValues<Values, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
+    | KnownMutationDialectFromValues<Exclude<UpdateValues, undefined>, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
     never,
     SourceNameOf<Target>,
-    Exclude<MutationRequiredFromValues<Values> | MutationRequiredFromValues<UpdateValues>, SourceNameOf<Target>>,
+    Exclude<MutationRequiredFromValues<Values> | MutationRequiredFromValues<Exclude<UpdateValues, undefined>>, SourceNameOf<Target>>,
     TrueFormula,
     "write",
     "insert",
@@ -5841,7 +6375,7 @@ type AsCurriedResult<
       EmptyFacts
     >
     <Targets extends MutationTargetTuple>(
-      target: Dialect extends "mysql" ? Targets : never
+      target: Dialect extends "mysql" ? Targets & MutationTargetTupleDialectConstraint<Targets, Dialect> : never
     ): QueryPlan<
       {},
       never,
@@ -5890,9 +6424,9 @@ type AsCurriedResult<
     target: Target,
     source: Source & (
       SourceRequiredOf<Source> extends never ? unknown : SourceRequirementError<Source>
-    ),
+    ) & MergeSourceNameConstraint<Target, Source>,
     on: On,
-    options?: MergeOptions<Target, MatchedValues, InsertValues, MatchedPredicate, NotMatchedPredicate>
+    options: MergeOptions<Target, MatchedValues, InsertValues, MatchedPredicate, NotMatchedPredicate>
   ) => QueryPlan<
     {},
     Exclude<
@@ -5936,6 +6470,7 @@ type AsCurriedResult<
   >
 
   const mutationRuntime = makeDslMutationRuntime({
+    profile,
     makePlan,
     getAst,
     getQueryState,
@@ -5948,7 +6483,7 @@ type AsCurriedResult<
     buildConflictTarget,
     mutationTargetClauses,
     mutationAvailableSources,
-    normalizeColumnList,
+    normalizeConflictColumns,
     targetSourceDetails,
     sourceDetails
   })
@@ -5964,63 +6499,21 @@ type AsCurriedResult<
   ): QueryPlan<any, any, any, any, any, any, any, any, any, "insert", MutationTargetLike, "ready"> =>
     mutationRuntime.attachInsertSource(plan, source)
 
-  const onConflict: OnConflictApi = <
-    Target extends MutationTargetLike,
-    const Columns extends DdlColumnInput,
-    UpdateValues extends MutationInputOf<Table.UpdateOf<Target>> | undefined = MutationInputOf<Table.UpdateOf<Target>> | undefined,
-    Options extends ConflictActionInput<Target, Dialect, UpdateValues> = ConflictActionInput<Target, Dialect, UpdateValues>
-  >(
-    target: ConflictTargetInput<Target, Dialect, Columns>,
-    options: Options = {} as Options
-  ) =>
-    <PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>>(
-      plan: PlanValue & RequireInsertStatement<PlanValue>
-    ): QueryPlan<
-      SelectionOfPlan<PlanValue>,
-      Exclude<RequiredOfPlan<PlanValue> | MutationRequiredFromValues<Exclude<UpdateValues, undefined>> | RequiredFromInput<Extract<Options["where"], PredicateInput>>, AvailableNames<AvailableOfPlan<PlanValue>>>,
-      AvailableOfPlan<PlanValue>,
-      PlanDialectOf<PlanValue>,
-      GroupedOfPlan<PlanValue>,
-      ScopedNamesOfPlan<PlanValue>,
-      Exclude<OutstandingOfPlan<PlanValue> | MutationRequiredFromValues<Exclude<UpdateValues, undefined>> | RequiredFromInput<Extract<Options["where"], PredicateInput>>, AvailableNames<AvailableOfPlan<PlanValue>>>,
-      AssumptionsOfPlan<PlanValue>,
-      CapabilitiesOfPlan<PlanValue>,
-      StatementOfPlan<PlanValue>,
-      MutationTargetOfPlan<PlanValue>,
-      InsertSourceStateOfPlan<PlanValue>,
-      FactsOfPlan<PlanValue>
-    > => mutationRuntime.onConflict(target, options)(plan)
+  const onConflict = ((target: unknown, options: unknown = {}) =>
+    (plan: QueryPlan<any, any, any, any, any, any, any, any, any, any>) =>
+      mutationRuntime.onConflict(target, options)(plan)) as OnConflictApi
 
   const update: UpdateApi = ((
     target: MutationTargetInput,
     values: Record<string, unknown>
   ) => mutationRuntime.update(target, values)) as UpdateApi
 
-  const upsert: UpsertApi = <
-    Target extends MutationTargetLike,
-    Values extends MutationInputOf<Table.InsertOf<Target>>,
-    const Columns extends DdlColumnInput,
-    UpdateValues extends MutationInputOf<Table.UpdateOf<Target>>
-  >(
-    target: Target,
-    values: Values,
-    conflictColumns: ValidateTargetColumns<Target, NormalizeDdlColumns<Columns>>,
-    updateValues?: UpdateValues
-  ): QueryPlan<
-    {},
-    Exclude<MutationRequiredFromValues<Values> | MutationRequiredFromValues<UpdateValues>, SourceNameOf<Target>>,
-    AddAvailable<{}, SourceNameOf<Target>>,
-    TableDialectOf<Target>,
-    never,
-    SourceNameOf<Target>,
-    Exclude<MutationRequiredFromValues<Values> | MutationRequiredFromValues<UpdateValues>, SourceNameOf<Target>>,
-    TrueFormula,
-    "write",
-    "insert",
-    Target,
-    "ready",
-    EmptyFacts
-  > => mutationRuntime.upsert(target, values, conflictColumns as string | readonly string[], updateValues)
+  const upsert = ((
+    target: MutationTargetLike,
+    values: Record<string, unknown>,
+    conflictColumns: DdlColumnInput,
+    updateValues?: Record<string, unknown>
+  ) => mutationRuntime.upsert(target, values, conflictColumns as string | readonly string[], updateValues)) as UpsertApi
 
   const delete_: DeleteApi = ((
     target: MutationTargetInput
@@ -6047,62 +6540,12 @@ type AsCurriedResult<
     EmptyFacts
   > => mutationRuntime.truncate(target, options)
 
-  const merge: MergeApi = <
-    Target extends MutationTargetLike,
-    Source extends SourceLike,
-    On extends PredicateInput,
-    MatchedValues extends MutationInputOf<Table.UpdateOf<Target>> = MutationInputOf<Table.UpdateOf<Target>>,
-    InsertValues extends MutationInputOf<Table.InsertOf<Target>> = MutationInputOf<Table.InsertOf<Target>>,
-    MatchedPredicate extends PredicateInput | undefined = undefined,
-    NotMatchedPredicate extends PredicateInput | undefined = undefined
-  >(
-    target: Target,
-    source: Source & (
-      SourceRequiredOf<Source> extends never ? unknown : SourceRequirementError<Source>
-    ),
-    on: On,
-    options: MergeOptions<Target, MatchedValues, InsertValues, MatchedPredicate, NotMatchedPredicate> = {}
-  ): QueryPlan<
-    {},
-    Exclude<
-      AddExpressionRequired<
-        MergeRequiredFromPredicate<
-          MatchedPredicate,
-          AddAvailable<AddAvailable<{}, SourceNameOf<Target>>, SourceNameOf<Source>>
-        > | MergeRequiredFromPredicate<
-          NotMatchedPredicate,
-          AddAvailable<AddAvailable<{}, SourceNameOf<Target>>, SourceNameOf<Source>>
-        > | MutationRequiredFromValues<MatchedValues> | MutationRequiredFromValues<InsertValues>,
-        AddAvailable<AddAvailable<{}, SourceNameOf<Target>>, SourceNameOf<Source>>,
-        On
-      >,
-      SourceNameOf<Target> | SourceNameOf<Source>
-    >,
-    AddAvailable<AddAvailable<{}, SourceNameOf<Target>>, SourceNameOf<Source>>,
-    TableDialectOf<Target> | SourceDialectOf<Source>,
-    never,
-    SourceNameOf<Target> | SourceNameOf<Source>,
-    Exclude<
-      AddExpressionRequired<
-        MergeRequiredFromPredicate<
-          MatchedPredicate,
-          AddAvailable<AddAvailable<{}, SourceNameOf<Target>>, SourceNameOf<Source>>
-        > | MergeRequiredFromPredicate<
-          NotMatchedPredicate,
-          AddAvailable<AddAvailable<{}, SourceNameOf<Target>>, SourceNameOf<Source>>
-        > | MutationRequiredFromValues<MatchedValues> | MutationRequiredFromValues<InsertValues>,
-        AddAvailable<AddAvailable<{}, SourceNameOf<Target>>, SourceNameOf<Source>>,
-        On
-      >,
-      SourceNameOf<Target> | SourceNameOf<Source>
-    >,
-    TrueFormula,
-    MergeCapabilities<"write", SourceCapabilitiesOf<Source>>,
-    "merge",
-    any,
-    "ready",
-    EmptyFacts
-  > => mutationRuntime.merge(target, source, on, options)
+  const merge = ((
+    target: MutationTargetLike,
+    source: SourceLike,
+    on: PredicateInput,
+    options: Record<string, unknown>
+  ) => mutationRuntime.merge(target, source, on, options)) as MergeApi
 
   type TransactionApi = (options?: TransactionOptions) => QueryPlan<
     {},
@@ -6216,7 +6659,7 @@ type AsCurriedResult<
 
   type CreateIndexApi = <Target extends SchemaTableLike, const Columns extends DdlColumnInput>(
     target: Target,
-    columns: Columns & ValidateDdlColumns<Target, NormalizeDdlColumns<Columns>>,
+    columns: Columns & ValidateDdlColumnInput<Target, Columns>,
     options?: CreateIndexOptions
   ) => QueryPlan<
     {},
@@ -6233,7 +6676,7 @@ type AsCurriedResult<
 
   type DropIndexApi = <Target extends SchemaTableLike, const Columns extends DdlColumnInput>(
     target: Target,
-    columns: Columns & ValidateDdlColumns<Target, NormalizeDdlColumns<Columns>>,
+    columns: Columns & ValidateDdlColumnInput<Target, Columns>,
     options?: DropIndexOptions
   ) => QueryPlan<
     {},