effect-qb 0.15.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,16 +31,21 @@ 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,
   type ExtractDialect,
   type ExtractRequired,
+  type FactsOfPlan,
   type GroupByInput,
   type GroupedOfPlan,
   type GroupedKeysFromValues,
@@ -55,6 +61,7 @@ import {
   type PlanDialectOf,
   type PresenceWitnessKeysOfSource,
   type PredicateInput,
+  type PredicateStateOfPlan,
   type KindOf,
   type QueryPlan,
   type OutputOfSelection,
@@ -117,7 +124,7 @@ import type {
   JsonValueAtPath,
   NormalizeJsonLiteral
 } from "../../internal/json/types.js"
-import type { AssumeTrue } from "../../internal/predicate/analysis.js"
+import type { AssumePredicateStateTrue, EmptyFacts, PredicateStateFacts, PredicateStateFormula } from "../../internal/predicate/analysis.js"
 import type { FormulaOfPredicate } from "../../internal/predicate/normalize.js"
 import type { TrueFormula } from "../../internal/predicate/formula.js"
 import { assumeFormulaTrue, formulaOfExpression as formulaOfExpressionRuntime, trueFormula } from "../../internal/predicate/runtime.js"
@@ -215,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,
@@ -688,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,
@@ -762,6 +791,18 @@ type DialectExpressionTuple<
   readonly [K in keyof Values]: DialectAsExpression<Values[K], Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
 }
 
+type DialectExpressionArray<
+  Values extends readonly ExpressionInput[],
+  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
+> = DialectExpressionTuple<Values, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb> extends infer Tuple extends readonly Expression.Any[]
+  ? Tuple
+  : never
+
 /** Normalized expression tuple for generic string operator inputs. */
 type DialectStringExpressionTuple<
   Values extends readonly ExpressionInput[],
@@ -778,7 +819,7 @@ type DialectStringExpressionTuple<
 /** Names of sources already available to a plan. */
 type AvailableNames<Available extends Record<string, Plan.AnySource>> = Extract<keyof Available, string>
 
-type PlanAssumptionsAfterWhere<
+type PlanPredicateStateAfterWhere<
   PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>,
   Predicate extends PredicateInput,
   Dialect extends string,
@@ -787,12 +828,34 @@ type PlanAssumptionsAfterWhere<
   BoolDb extends Expression.DbType.Any,
   TimestampDb extends Expression.DbType.Any,
   NullDb extends Expression.DbType.Any
-> = AssumeTrue<
-  AssumptionsOfPlan<PlanValue>,
+> = AssumePredicateStateTrue<
+  PredicateStateOfPlan<PlanValue>,
   DialectAsExpression<Predicate, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
 >
 
-type PlanAssumptionsAfterHaving<
+type PlanAssumptionsAfterWhere<
+  PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>,
+  Predicate extends PredicateInput,
+  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
+> = PredicateStateFormula<PlanPredicateStateAfterWhere<PlanValue, Predicate, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>>
+
+type PlanFactsAfterWhere<
+  PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>,
+  Predicate extends PredicateInput,
+  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
+> = PredicateStateFacts<PlanPredicateStateAfterWhere<PlanValue, Predicate, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>>
+
+type PlanPredicateStateAfterHaving<
   PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>,
   Predicate extends HavingPredicateInput,
   Dialect extends string,
@@ -801,12 +864,34 @@ type PlanAssumptionsAfterHaving<
   BoolDb extends Expression.DbType.Any,
   TimestampDb extends Expression.DbType.Any,
   NullDb extends Expression.DbType.Any
-> = AssumeTrue<
-  AssumptionsOfPlan<PlanValue>,
+> = AssumePredicateStateTrue<
+  PredicateStateOfPlan<PlanValue>,
   DialectAsExpression<Predicate, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
 >
 
-type PlanAssumptionsAfterJoin<
+type PlanAssumptionsAfterHaving<
+  PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>,
+  Predicate extends HavingPredicateInput,
+  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
+> = PredicateStateFormula<PlanPredicateStateAfterHaving<PlanValue, Predicate, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>>
+
+type PlanFactsAfterHaving<
+  PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>,
+  Predicate extends HavingPredicateInput,
+  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
+> = PredicateStateFacts<PlanPredicateStateAfterHaving<PlanValue, Predicate, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>>
+
+type PlanPredicateStateAfterJoin<
   PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>,
   Predicate extends PredicateInput,
   Kind extends QueryAst.JoinKind,
@@ -817,11 +902,35 @@ type PlanAssumptionsAfterJoin<
   TimestampDb extends Expression.DbType.Any,
   NullDb extends Expression.DbType.Any
 > = Kind extends "inner"
-  ? AssumeTrue<
-      AssumptionsOfPlan<PlanValue>,
+  ? AssumePredicateStateTrue<
+      PredicateStateOfPlan<PlanValue>,
       DialectAsExpression<Predicate, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
     >
-  : AssumptionsOfPlan<PlanValue>
+  : PredicateStateOfPlan<PlanValue>
+
+type PlanAssumptionsAfterJoin<
+  PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>,
+  Predicate extends PredicateInput,
+  Kind extends QueryAst.JoinKind,
+  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
+> = PredicateStateFormula<PlanPredicateStateAfterJoin<PlanValue, Predicate, Kind, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>>
+
+type PlanFactsAfterJoin<
+  PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>,
+  Predicate extends PredicateInput,
+  Kind extends QueryAst.JoinKind,
+  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
+> = PredicateStateFacts<PlanPredicateStateAfterJoin<PlanValue, Predicate, Kind, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>>
 
 type ScalarSubqueryInput<
   PlanValue extends QueryPlan<any, any, any, any, any, any, any, any, any, any>,
@@ -960,6 +1069,16 @@ type JsonPathInput = JsonPath.Path<any> | JsonPath.CanonicalSegment
 
 type JsonQueryInput = JsonPath.Path<any> | StringExpressionInput
 
+type JsonPathSegmentsOf<Target extends JsonPathInput> =
+  Target extends JsonPath.Path<any>
+    ? JsonPath.SegmentsOf<Target>
+    : readonly [Target]
+
+type JsonTextAccessKind<Target extends JsonPathInput> =
+  Target extends JsonPath.Path<any>
+    ? JsonPath.IsExactPath<Target> extends true ? "jsonPathText" : "jsonTraverseText"
+    : Target extends JsonPath.ExactSegment ? "jsonGetText" : "jsonAccessText"
+
 type JsonPathOutputOf<
   Root,
   Target extends JsonPathInput,
@@ -1480,6 +1599,42 @@ const profile: QueryDialectProfile<Dialect, TextDb, NumericDb, BoolDb, Timestamp
     >
   }
 
+  const retargetLiteralExpression = (
+    value: Expression.Any,
+    target: Expression.Any
+  ): Expression.Any => {
+    const ast = (value as unknown as { readonly [ExpressionAst.TypeId]: ExpressionAst.Any })[ExpressionAst.TypeId]
+    if (ast.kind !== "literal") {
+      return value
+    }
+    const targetState = target[Expression.TypeId]
+    return makeExpression({
+      runtime: value[Expression.TypeId].runtime,
+      dbType: targetState.dbType,
+      runtimeSchema: targetState.runtimeSchema,
+      driverValueMapping: targetState.driverValueMapping,
+      nullability: value[Expression.TypeId].nullability,
+      dialect: targetState.dialect,
+      kind: "scalar",
+      dependencies: {}
+    }, ast)
+  }
+
+  const alignBinaryPredicateExpressions = (
+    left: Expression.Any,
+    right: Expression.Any
+  ): readonly [Expression.Any, Expression.Any] => {
+    const leftAst = (left as unknown as { readonly [ExpressionAst.TypeId]: ExpressionAst.Any })[ExpressionAst.TypeId]
+    const rightAst = (right as unknown as { readonly [ExpressionAst.TypeId]: ExpressionAst.Any })[ExpressionAst.TypeId]
+    if (leftAst.kind === "literal" && rightAst.kind !== "literal") {
+      return [retargetLiteralExpression(left, right), right]
+    }
+    if (rightAst.kind === "literal" && leftAst.kind !== "literal") {
+      return [left, retargetLiteralExpression(right, left)]
+    }
+    return [left, right]
+  }
+
   const toDialectStringExpression = <Value extends StringExpressionInput>(
     value: Value
   ): DialectAsStringExpression<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb> =>
@@ -1568,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
@@ -1657,8 +1818,10 @@ type BinaryPredicateExpression<
     kind: Kind,
     nullability: Nullability = "maybe" as Nullability,
   ): any => {
-    const leftExpression = toDialectExpression(left)
-    const rightExpression = toDialectExpression(right)
+    const [leftExpression, rightExpression] = alignBinaryPredicateExpressions(
+      toDialectExpression(left),
+      toDialectExpression(right)
+    )
     return (makeExpression as any)({
       runtime: true as boolean,
       dbType: profile.boolDb as BoolDb,
@@ -1681,17 +1844,21 @@ type BinaryPredicateExpression<
     kind: ExpressionAst.VariadicKind
   ): Expression.Any => {
     const expressions = values.map((value) => toDialectExpression(value as any)) as readonly Expression.Any[]
+    const [head, ...tail] = expressions
+    const alignedExpressions = (head !== undefined && (kind === "in" || kind === "notIn" || kind === "between"))
+      ? [head, ...tail.map((value) => retargetLiteralExpression(value, head))]
+      : expressions
     return makeExpression({
       runtime: true as boolean,
       dbType: profile.boolDb as BoolDb,
       nullability: "maybe",
-      dialect: (expressions.find((value) => value[Expression.TypeId].dialect !== undefined)?.[Expression.TypeId].dialect ?? profile.dialect) as Dialect,
+      dialect: (alignedExpressions.find((value) => value[Expression.TypeId].dialect !== undefined)?.[Expression.TypeId].dialect ?? profile.dialect) as Dialect,
       kind: "scalar",
 
-      dependencies: mergeManyDependencies(expressions)
+      dependencies: mergeManyDependencies(alignedExpressions)
     }, {
       kind,
-      values: expressions
+      values: alignedExpressions
     })
   }
 
@@ -1939,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>>,
@@ -1949,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>>,
@@ -1972,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>>
     >
   }
 
@@ -1997,6 +2170,7 @@ type BinaryPredicateExpression<
       runtime: undefined as unknown as RuntimeOfDbType<Target>,
       dbType: target as Target,
       runtimeSchema: undefined,
+      driverValueMapping: (target as Expression.DbType.Any).driverValueMapping,
       nullability: expression[Expression.TypeId].nullability,
       dialect: expression[Expression.TypeId].dialect,
       kind: expression[Expression.TypeId].kind,
@@ -2076,6 +2250,14 @@ type BinaryPredicateExpression<
     kind
   })
 
+  const driverValueMapping = <Db extends Expression.DbType.Any>(
+    dbType: Db,
+    mapping: Expression.DriverValueMapping
+  ): Db => ({
+    ...dbType,
+    driverValueMapping: mapping
+  })
+
   const type = {
     ...profile.type,
     array,
@@ -2085,7 +2267,8 @@ type BinaryPredicateExpression<
     domain,
     enum: enum_,
     set,
-    custom
+    custom,
+    driverValueMapping
   }
 
   const makeJsonDb = <Kind extends string>(
@@ -2273,7 +2456,7 @@ type BinaryPredicateExpression<
     DialectOf<Base>,
     KindOf<Base>,
     DependenciesOf<Base>,
-    JsonNode
+    ExpressionAst.JsonAccessNode<JsonTextAccessKind<Target>, Base, JsonPathSegmentsOf<Target>>
   > => {
     const segments = normalizeJsonPathInput(target)
     const kind = isJsonPathValue(target)
@@ -2300,7 +2483,7 @@ type BinaryPredicateExpression<
       DialectOf<Base>,
       KindOf<Base>,
       DependenciesOf<Base>,
-      JsonNode
+      ExpressionAst.JsonAccessNode<JsonTextAccessKind<Target>, Base, JsonPathSegmentsOf<Target>>
     >
   }
 
@@ -2558,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
@@ -2606,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
@@ -3027,12 +3210,12 @@ type BinaryPredicateExpression<
   }
 
   const and = <
-    Values extends readonly [ExpressionInput, ...ExpressionInput[]]
+    const Values extends readonly [ExpressionInput, ...ExpressionInput[]]
   >(
     ...values: Values
   ): VariadicBooleanExpression<
     "and",
-    { readonly [K in keyof Values]: DialectAsExpression<Values[K], Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb> } & readonly Expression.Any[],
+    DialectExpressionArray<Values, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
     Dialect,
     TextDb,
     NumericDb,
@@ -3042,16 +3225,16 @@ type BinaryPredicateExpression<
   > =>
     makeVariadicBooleanExpression(
       "and",
-      values.map((value) => toDialectExpression(value)) as { readonly [K in keyof Values]: DialectAsExpression<Values[K], Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb> } & readonly Expression.Any[]
+      values.map((value) => toDialectExpression(value)) as unknown as DialectExpressionArray<Values, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
     )
 
   const or = <
-    Values extends readonly [ExpressionInput, ...ExpressionInput[]]
+    const Values extends readonly [ExpressionInput, ...ExpressionInput[]]
   >(
     ...values: Values
   ): VariadicBooleanExpression<
     "or",
-    { readonly [K in keyof Values]: DialectAsExpression<Values[K], Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb> } & readonly Expression.Any[],
+    DialectExpressionArray<Values, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
     Dialect,
     TextDb,
     NumericDb,
@@ -3061,7 +3244,7 @@ type BinaryPredicateExpression<
   > =>
     makeVariadicBooleanExpression(
       "or",
-      values.map((value) => toDialectExpression(value)) as { readonly [K in keyof Values]: DialectAsExpression<Values[K], Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb> } & readonly Expression.Any[]
+      values.map((value) => toDialectExpression(value)) as unknown as DialectExpressionArray<Values, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
     )
 
   const not = <Value extends ExpressionInput>(
@@ -3295,6 +3478,8 @@ type BinaryPredicateExpression<
     return makeExpression({
       runtime: undefined as Expression.RuntimeOf<ScalarOutputOfPlan<PlanValue>> | null,
       dbType: expression[Expression.TypeId].dbType as Expression.DbTypeOf<ScalarOutputOfPlan<PlanValue>>,
+      runtimeSchema: expression[Expression.TypeId].runtimeSchema,
+      driverValueMapping: expression[Expression.TypeId].driverValueMapping,
       nullability: "maybe",
       dialect: profile.dialect as Dialect,
       kind: "scalar",
@@ -3818,7 +4003,9 @@ type BinaryPredicateExpression<
       string,
       "scalar",
       Expression.BindingId
-    >
+    > & {
+      readonly [ExpressionAst.TypeId]: ExpressionAst.ColumnNode<any, string>
+    }
   >(
     value: Value
   ): AstBackedExpression<
@@ -3838,6 +4025,7 @@ type BinaryPredicateExpression<
       runtime: undefined as Expression.RuntimeOf<Value>,
       dbType: value[Expression.TypeId].dbType as Expression.DbTypeOf<Value>,
       runtimeSchema: value[Expression.TypeId].runtimeSchema,
+      driverValueMapping: value[Expression.TypeId].driverValueMapping,
       nullability: value[Expression.TypeId].nullability as Expression.NullabilityOf<Value>,
       dialect: profile.dialect as Dialect,
       kind: "scalar",
@@ -3861,20 +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) {
-      return value as unknown as Expression.Any
+      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,
-      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
     })
   }
 
@@ -3941,6 +4165,7 @@ type BinaryPredicateExpression<
         runtime: undefined as never,
         dbType: state.dbType,
         runtimeSchema: state.runtimeSchema,
+        driverValueMapping: state.driverValueMapping,
         nullability: state.nullability,
         dialect: state.dialect,
         kind: "scalar",
@@ -3961,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,
@@ -3988,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
     >
@@ -4001,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 = (
@@ -4044,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
@@ -4053,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>
@@ -4064,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))
       }))
     })
   }
@@ -4151,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) {
@@ -4168,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)
     }
   }
@@ -4211,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
@@ -4245,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>
@@ -4263,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,
@@ -4278,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<
@@ -4318,21 +4705,24 @@ 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>
+      StatementOfPlan<PlanValue>,
+      MutationTargetOfPlan<PlanValue>,
+      InsertSourceStateOfPlan<PlanValue>,
+      FactsOfPlan<PlanValue>
     >
   : DistinctOnUnsupportedError<Dialect>
 
@@ -4362,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<{
@@ -4455,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,
@@ -4483,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
@@ -4501,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
 }
@@ -4511,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
@@ -4556,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]
@@ -4569,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
 }
@@ -4602,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<
@@ -4624,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>)
 
@@ -4641,7 +5229,10 @@ type SelectFromResult<
   Exclude<OutstandingOfPlan<PlanValue>, SourceNameOf<CurrentSource>>,
   AssumptionsOfPlan<PlanValue>,
   MergeCapabilities<CapabilitiesOfPlan<PlanValue>, SourceCapabilitiesOf<CurrentSource>>,
-  StatementOfPlan<PlanValue>
+  StatementOfPlan<PlanValue>,
+  MutationTargetOfPlan<PlanValue>,
+  InsertSourceStateOfPlan<PlanValue>,
+  FactsOfPlan<PlanValue>
 >
 
 type UpdateFromResult<
@@ -4663,7 +5254,10 @@ type UpdateFromResult<
   Exclude<OutstandingOfPlan<PlanValue>, SourceNameOf<CurrentSource>>,
   AssumptionsOfPlan<PlanValue>,
   MergeCapabilities<CapabilitiesOfPlan<PlanValue>, SourceCapabilitiesOf<CurrentSource>>,
-  StatementOfPlan<PlanValue>
+  StatementOfPlan<PlanValue>,
+  MutationTargetOfPlan<PlanValue>,
+  InsertSourceStateOfPlan<PlanValue>,
+  FactsOfPlan<PlanValue>
 >
 
 type InsertFromResult<
@@ -4672,19 +5266,20 @@ 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>>
     : CapabilitiesOfPlan<PlanValue>,
   StatementOfPlan<PlanValue>,
   MutationTargetOfPlan<PlanValue>,
-  "ready"
+  "ready",
+  FactsOfPlan<PlanValue>
 >
 
 type FromPlanConstraint<
@@ -4693,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>
@@ -4756,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<
@@ -4769,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
@@ -4777,7 +5380,7 @@ export type PublicStructuredFromResult<
             SelectionOfPlan<PlanValue>,
             never,
             AvailableOfPlan<PlanValue>,
-            PlanDialectOf<PlanValue>,
+            PlanDialectOf<PlanValue> | SourceDialectOf<CurrentSource>,
             GroupedOfPlan<PlanValue>,
             ScopedNamesOfPlan<PlanValue>,
             never,
@@ -4785,7 +5388,8 @@ export type PublicStructuredFromResult<
             CapabilitiesOfPlan<PlanValue>,
             StatementOfPlan<PlanValue>,
             MutationTargetOfPlan<PlanValue>,
-            "ready"
+            "ready",
+            FactsOfPlan<PlanValue>
           >
         : FromPlanResult<PlanValue, CurrentSource, Dialect>
       : FromPlanResult<PlanValue, CurrentSource, Dialect>
@@ -4802,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>
@@ -4841,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
   >
@@ -4862,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 {
@@ -4909,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 {
@@ -4933,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 {
@@ -4958,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 {
@@ -4981,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
   >
 
@@ -4991,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>,
@@ -5005,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<
@@ -5019,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<
     {
@@ -5034,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>,
@@ -5046,7 +5715,10 @@ type AsCurriedResult<
     ExtractRequired<Selection>,
     TrueFormula,
     "read",
-    "select"
+    "select",
+    any,
+    "ready",
+    EmptyFacts
   >
 
   const {
@@ -5091,7 +5763,10 @@ type AsCurriedResult<
     never,
     TrueFormula,
     CapabilitiesOfPlan<LeftPlanValue> | CapabilitiesOfPlan<RightPlanValue>,
-    "set"
+    "set",
+    any,
+    "ready",
+    CommonSetFacts<LeftPlanValue, RightPlanValue>
   >
 
   type SetOperationApi = <
@@ -5117,7 +5792,10 @@ type AsCurriedResult<
       AddExpressionRequired<OutstandingOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, Predicate>,
       PlanAssumptionsAfterWhere<PlanValue, Predicate, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
       CapabilitiesOfPlan<PlanValue>,
-      StatementOfPlan<PlanValue>
+      StatementOfPlan<PlanValue>,
+      MutationTargetOfPlan<PlanValue>,
+      InsertSourceStateOfPlan<PlanValue>,
+      PlanFactsAfterWhere<PlanValue, Predicate, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
     >
 
   export type FromApi = <CurrentSource extends FromInput>(
@@ -5142,7 +5820,10 @@ type AsCurriedResult<
       AddExpressionRequired<OutstandingOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, Predicate>,
       PlanAssumptionsAfterHaving<PlanValue, Predicate, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>,
       CapabilitiesOfPlan<PlanValue>,
-      StatementOfPlan<PlanValue>
+      StatementOfPlan<PlanValue>,
+      MutationTargetOfPlan<PlanValue>,
+      InsertSourceStateOfPlan<PlanValue>,
+      PlanFactsAfterHaving<PlanValue, Predicate, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
     >
 
   type CrossJoinApi = <CurrentTable extends SourceLike>(
@@ -5153,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>,
@@ -5167,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 = <
@@ -5187,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>,
@@ -5201,10 +5885,13 @@ 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>
+      StatementOfPlan<PlanValue>,
+      MutationTargetOfPlan<PlanValue>,
+      InsertSourceStateOfPlan<PlanValue>,
+      PlanFactsAfterJoin<PlanValue, Predicate, Kind, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
     >
 
   type BinaryJoinApi<Kind extends QueryAst.JoinKind> = <
@@ -5219,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>,
@@ -5233,10 +5920,13 @@ 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>
+      StatementOfPlan<PlanValue>,
+      MutationTargetOfPlan<PlanValue>,
+      InsertSourceStateOfPlan<PlanValue>,
+      PlanFactsAfterJoin<PlanValue, Predicate, Kind, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>
     >
 
   type OrderByApi = <Value extends ExpressionInput>(
@@ -5255,7 +5945,10 @@ type AsCurriedResult<
       AddExpressionRequired<OutstandingOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, Value>,
       AssumptionsOfPlan<PlanValue>,
       CapabilitiesOfPlan<PlanValue>,
-      StatementOfPlan<PlanValue>
+      StatementOfPlan<PlanValue>,
+      MutationTargetOfPlan<PlanValue>,
+      InsertSourceStateOfPlan<PlanValue>,
+      FactsOfPlan<PlanValue>
     >
 
   interface LockApi {
@@ -5271,7 +5964,10 @@ type AsCurriedResult<
       OutstandingOfPlan<PlanValue>,
       AssumptionsOfPlan<PlanValue>,
       MergeCapabilities<CapabilitiesOfPlan<PlanValue>, "transaction">,
-      StatementOfPlan<PlanValue>
+      StatementOfPlan<PlanValue>,
+      MutationTargetOfPlan<PlanValue>,
+      InsertSourceStateOfPlan<PlanValue>,
+      FactsOfPlan<PlanValue>
     >
     <Mode extends Dialect extends "mysql" ? "lowPriority" | "ignore" | "quick" : never>(
       mode: Mode,
@@ -5296,7 +5992,10 @@ type AsCurriedResult<
       OutstandingOfPlan<PlanValue>,
       AssumptionsOfPlan<PlanValue>,
       MergeCapabilities<CapabilitiesOfPlan<PlanValue>, "transaction">,
-      StatementOfPlan<PlanValue>
+      StatementOfPlan<PlanValue>,
+      MutationTargetOfPlan<PlanValue>,
+      InsertSourceStateOfPlan<PlanValue>,
+      FactsOfPlan<PlanValue>
     >
   }
 
@@ -5313,7 +6012,10 @@ type AsCurriedResult<
       OutstandingOfPlan<PlanValue>,
       AssumptionsOfPlan<PlanValue>,
       CapabilitiesOfPlan<PlanValue>,
-      StatementOfPlan<PlanValue>
+      StatementOfPlan<PlanValue>,
+      MutationTargetOfPlan<PlanValue>,
+      InsertSourceStateOfPlan<PlanValue>,
+      FactsOfPlan<PlanValue>
     >
 
   type LimitApi = <Value extends NumericExpressionInput>(
@@ -5331,7 +6033,10 @@ type AsCurriedResult<
       AddExpressionRequired<OutstandingOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, DialectAsNumericExpression<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>>,
       AssumptionsOfPlan<PlanValue>,
       CapabilitiesOfPlan<PlanValue>,
-      StatementOfPlan<PlanValue>
+      StatementOfPlan<PlanValue>,
+      MutationTargetOfPlan<PlanValue>,
+      InsertSourceStateOfPlan<PlanValue>,
+      FactsOfPlan<PlanValue>
     >
 
   type OffsetApi = <Value extends NumericExpressionInput>(
@@ -5349,7 +6054,10 @@ type AsCurriedResult<
       AddExpressionRequired<OutstandingOfPlan<PlanValue>, AvailableOfPlan<PlanValue>, DialectAsNumericExpression<Value, Dialect, TextDb, NumericDb, BoolDb, TimestampDb, NullDb>>,
       AssumptionsOfPlan<PlanValue>,
       CapabilitiesOfPlan<PlanValue>,
-      StatementOfPlan<PlanValue>
+      StatementOfPlan<PlanValue>,
+      MutationTargetOfPlan<PlanValue>,
+      InsertSourceStateOfPlan<PlanValue>,
+      FactsOfPlan<PlanValue>
     >
 
   const {
@@ -5420,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>
@@ -5439,16 +6150,18 @@ 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,
         distinctOn: expressions
-      }, currentQuery.assumptions, currentQuery.capabilities, currentQuery.statement as StatementOfPlan<PlanValue>)
+      }, currentQuery.assumptions, currentQuery.capabilities, currentQuery.statement as StatementOfPlan<PlanValue>, currentQuery.target, currentQuery.insertSource, currentQuery.facts)
     }
   }) as DistinctOnApi<Dialect>
 
@@ -5467,11 +6180,25 @@ type AsCurriedResult<
       Exclude<OutstandingOfPlan<PlanValue> | RequiredFromDependencies<TupleDependencies<Values>>, AvailableNames<AvailableOfPlan<PlanValue>>>,
       AssumptionsOfPlan<PlanValue>,
       CapabilitiesOfPlan<PlanValue>,
-      StatementOfPlan<PlanValue>
+      StatementOfPlan<PlanValue>,
+      MutationTargetOfPlan<PlanValue>,
+      InsertSourceStateOfPlan<PlanValue>,
+      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>
@@ -5487,7 +6214,8 @@ type AsCurriedResult<
       CapabilitiesOfPlan<PlanValue>,
       StatementOfPlan<PlanValue>,
       MutationTargetOfPlan<PlanValue>,
-      InsertSourceStateOfPlan<PlanValue>
+      InsertSourceStateOfPlan<PlanValue>,
+      FactsOfPlan<PlanValue>
     >
 
   export interface InsertApi {
@@ -5505,16 +6233,17 @@ type AsCurriedResult<
       "write",
       "insert",
       Target,
-      "missing"
+      "missing",
+      EmptyFacts
     >
     <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>>,
@@ -5522,7 +6251,8 @@ type AsCurriedResult<
       "write",
       "insert",
       Target,
-      "ready"
+      "ready",
+      EmptyFacts
     >
   }
 
@@ -5535,58 +6265,66 @@ 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>,
       MutationTargetOfPlan<PlanValue>,
-      InsertSourceStateOfPlan<PlanValue>
+      InsertSourceStateOfPlan<PlanValue>,
+      FactsOfPlan<PlanValue>
     >
 
   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>>,
       TrueFormula,
       "write",
-      "update"
+      "update",
+      any,
+      "ready",
+      EmptyFacts
     >
     <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>>,
       TrueFormula,
       "write",
-      "update"
+      "update",
+      any,
+      "ready",
+      EmptyFacts
     >
   }
 
@@ -5594,25 +6332,28 @@ 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",
     Target,
-    "ready"
+    "ready",
+    EmptyFacts
   >
 
   interface DeleteApi {
@@ -5628,10 +6369,13 @@ type AsCurriedResult<
       never,
       TrueFormula,
       "write",
-      "delete"
+      "delete",
+      any,
+      "ready",
+      EmptyFacts
     >
     <Targets extends MutationTargetTuple>(
-      target: Dialect extends "mysql" ? Targets : never
+      target: Dialect extends "mysql" ? Targets & MutationTargetTupleDialectConstraint<Targets, Dialect> : never
     ): QueryPlan<
       {},
       never,
@@ -5642,7 +6386,10 @@ type AsCurriedResult<
       never,
       TrueFormula,
       "write",
-      "delete"
+      "delete",
+      any,
+      "ready",
+      EmptyFacts
     >
   }
 
@@ -5659,7 +6406,10 @@ type AsCurriedResult<
     never,
     TrueFormula,
     "write",
-    "truncate"
+    "truncate",
+    any,
+    "ready",
+    EmptyFacts
   >
 
   type MergeApi = <
@@ -5674,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<
@@ -5713,10 +6463,14 @@ type AsCurriedResult<
     >,
     TrueFormula,
     MergeCapabilities<"write", SourceCapabilitiesOf<Source>>,
-    "merge"
+    "merge",
+    any,
+    "ready",
+    EmptyFacts
   >
 
   const mutationRuntime = makeDslMutationRuntime({
+    profile,
     makePlan,
     getAst,
     getQueryState,
@@ -5729,7 +6483,7 @@ type AsCurriedResult<
     buildConflictTarget,
     mutationTargetClauses,
     mutationAvailableSources,
-    normalizeColumnList,
+    normalizeConflictColumns,
     targetSourceDetails,
     sourceDetails
   })
@@ -5745,61 +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>
-    > => 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"
-  > => 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
@@ -5820,62 +6534,18 @@ type AsCurriedResult<
     never,
     TrueFormula,
     "write",
-    "truncate"
+    "truncate",
+    any,
+    "ready",
+    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"
-  > => 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<
     {},
@@ -5989,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<
     {},
@@ -6006,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<
     {},