fix(query): compile relation filters inside where groups and nested relation constraints

[3m1n3nc3]

Summary

Two relation-filter bugs, both found while building a permission-based audience query in an app.

1. whereHas inside a where(callback) group was discarded

A grouped where callback kept only the group's plain conditions. Any whereHas / orWhereHas inside it was dropped without an error, so results came back wider than asked for.

User.query()
  .where({ id: 2 })
  .where((query) => query.whereHas('posts', (posts) => posts.where({ title: 'A' })))
// before: matched user 2; after: matches nobody

2. whereHas nested inside another relation's callback did not compile

A relation constraint that itself contained a relation filter couldn't be turned into an adapter spec. So the query was refused or handled outside SQL, and toSql() didn't show the filter.

Fix

• New QueryRelationCondition ({ type: 'relation', filter }) where-tree node.
• Relation filters inside a group, and inside another relation's constraint, are folded into the where tree. They keep the and/or they were added with.
• The Kysely adapter compiles the node as the same correlated count(*) subquery used by top-level whereHas.
• The Prisma compatibility adapter rejects the node with UnsupportedAdapterFeatureException instead of silently ignoring it.

Also

• Corrected the update() / updateFrom() docblocks. update() changes the first match only, as the guide already says; updateFrom() changes every match.
• Documented nested and grouped relation filters in the relationships guide.
• Pre-existing fixes:
  • cast-set-symmetry.spec.ts failed tsc because its model borrows the user schema, which has no unitPrice.
  • packages/plugin-clear-router/package.json failed format:check.

Test plan

• New Postgres tests for grouped and nested relation filters. Both fail on main and pass here; the nested test also asserts each query runs as a single SQL statement.
• pnpm build, pnpm lint, tsc --noEmit (0 errors), pnpm format:check
• pnpm test:all: 567 passed, 2 skipped

[codecov]

Codecov Report

❌ Patch coverage is 94.11765% with 1 line in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/QueryBuilder.ts	93.33%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!