docs(query): document the join alias default and population stddev

[abnegate]

What

• Join docs: the join docblocks (web, react-native, dart, php, kotlin, android) say that without an alias the join is named after the table ID.
• Tests: each SDK's query tests (node, php, python, go, dart, kotlin, swift) pin the alias-less ON-list join and cross join. They send no alias, and the server applies its default.
• stddev and variance: documented as population statistics. The database library maps them to STDDEV_POP and VAR_POP on every engine.

Why

• Server default: an alias-less join used to be rejected with Join alias is required. The database library now defaults the alias to the joined table ID when that ID is a valid alias, and otherwise returns a 400 naming the reason. (Server work is in utopia-php/query, utopia-php/database and appwrite/appwrite.)
• No signature changes: every SDK already serialized the alias-less forms correctly. The overloaded forms ship in released SDKs (web 29.0.0, node 30.0.1, python 25.0.0), so removing them would be a breaking change.

Verification

Each SDK was generated from server-ce main specs and its query tests run locally:

SDK	Result
node	92/92 (jest), format:check + lint clean
php	Join tests 8/8, pint clean
python	pass, black clean
go	pass, gofmt clean
dart	91 pass
kotlin	29/29, ktlint 1.8.0 clean
swift	join tests 7/7 (swift test; CI only builds swift)

Before/after: these tests also pass on main, because the SDKs never had the bug. The fail-before proof is at the server layer: the database library's unit and e2e tests, plus the appwrite API E2E. The new SDK tests pin the wire contract that the server default relies on.

🤖 Generated with Claude Code

[hansi-codes]

🔵 Tier A · Mergeable after minor fixes

The only issue is a minor documentation omission: the server applies the fallback only when the table ID is a valid alias.

This PR updates the generated query documentation to describe alias-less joins and clarify that stddev and variance use population statistics. It also adds query serialization tests for alias-less nested joins and cross joins across the affected SDKs.

Verdict	New comments	Fixed	Still open
✅ Approved	1	0	0

	Finding	Where
🟡	Qualify the default for IDs that are not valid aliases	templates/web/src/query.ts.twig:827

Fix with agent prompt

### Issue 1
templates/web/src/query.ts.twig:827
**Qualify the default for IDs that are not valid aliases**

One caveat is missing here: the server applies this default only when `table` is valid as an alias; otherwise it returns 400. This reads as an unconditional default for every collection ID, so please qualify the limitation in this and the mirrored SDK docs.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

📂 Walkthrough · 13

File	Change
templates/android/library/src/main/java/io/package/Query.kt.twig	Clarifies population aggregate statistics and alias-less join documentation.
templates/dart/lib/query.dart.twig	Clarifies aggregate statistics and documents the alias-less join default.
templates/dart/test/query_test.dart.twig	Adds serialization tests for nested joins and cross joins without aliases.
templates/go/query_test.go.twig	Adds serialization tests for nested joins and cross joins without aliases.
templates/kotlin/src/main/kotlin/io/appwrite/Query.kt.twig	Clarifies population aggregate statistics and alias-less join documentation.
templates/kotlin/src/test/kotlin/io/appwrite/QueryTest.kt.twig	Adds serialization tests for nested joins and cross joins without aliases.
templates/node/test/query.test.js.twig	Adds serialization tests for nested joins and cross joins without aliases.
templates/php/src/Query.php.twig	Clarifies aggregate statistics and documents the alias-less join default.
templates/php/tests/QueryTest.php.twig	Adds serialization tests for nested joins and cross joins without aliases.
templates/python/test/test_query.py.twig	Adds serialization tests for nested joins and cross joins without aliases.
templates/react-native/src/query.ts.twig	Documents the alias-less join default.
templates/swift/Tests/Tests.swift.twig	Adds serialization tests for nested joins and cross joins without aliases.
templates/web/src/query.ts.twig	Clarifies population aggregate statistics and documents the alias-less join default.

---

_{Reviewed f99c4c2 · Details · Comment @hansi-codes review to re-run, or mention @hansi-codes with a question.}

[hansi-codes]

🔵 Tier A · Looks good to merge. Summary

[hansi-codes]

Qualify the default for IDs that are not valid aliases

One caveat is missing here: the server applies this default only when table is valid as an alias; otherwise it returns 400. This reads as an unconditional default for every collection ID, so please qualify the limitation in this and the mirrored SDK docs.

Prompt To Fix With AI

This is a comment left during a code review.
Path: templates/web/src/query.ts.twig
Line: 827

Comment:
**Qualify the default for IDs that are not valid aliases**

One caveat is missing here: the server applies this default only when `table` is valid as an alias; otherwise it returns 400. This reads as an unconditional default for every collection ID, so please qualify the limitation in this and the mirrored SDK docs.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

_{🟡 Minor · documentation · Reply if this doesn't apply.}