docs(database): update query() docs to reflect all relation types now supported

Author: laylatichy

docs/1-essentials/03-database.md

@@ -776,13 +776,21 @@ $author->query('books')->update(title: 'Updated')->execute();
 $author->query('books')->delete()->execute();
 ```
 
-The `query()` method works with `HasMany`, `HasManyThrough`, and `BelongsToMany` relations — any relation that returns a collection. Calling it on a singular relation like `BelongsTo` or `HasOne` will throw an exception.
+The `query()` method works with all relation types:
 
 ```php
-// HasManyThrough
+// HasMany / HasOne — simple FK on related table
+$author->query('books')->select()->all();
+$book->query('isbn')->select()->first();
+
+// BelongsTo — subquery through owner's FK
+$book->query('author')->select()->first();
+
+// HasManyThrough / HasOneThrough — subquery through intermediate table
 $tag->query('reviewers')->select()->all();
+$tag->query('topReviewer')->select()->first();
 
-// BelongsToMany
+// BelongsToMany — subquery through pivot table
 $tag->query('books')->select()->all();
 ```
 

packages/database/src/BelongsTo.php

@@ -16,7 +16,6 @@
 use Tempest\Support\Arr\ImmutableArray;
 use UnitEnum;
 
-use function Tempest\Database\query;
 use function Tempest\Support\str;
 
 #[Attribute(Attribute::TARGET_PROPERTY)]

packages/database/src/HasOne.php

@@ -16,7 +16,6 @@
 use Tempest\Support\Arr\ImmutableArray;
 use UnitEnum;
 
-use function Tempest\Database\query;
 use function Tempest\Support\str;
 
 #[Attribute(Attribute::TARGET_PROPERTY)]

packages/database/src/HasOneThrough.php

@@ -16,7 +16,6 @@
 use Tempest\Support\Arr\ImmutableArray;
 use UnitEnum;
 
-use function Tempest\Database\query;
 use function Tempest\Support\str;
 
 #[Attribute(flags: Attribute::TARGET_PROPERTY)]

tests/Fixtures/Migrations/CreateBookTagTable.php

@@ -6,10 +6,10 @@
 
 use Tempest\Database\MigratesDown;
 use Tempest\Database\MigratesUp;
-use Tempest\Database\QueryStatements\OnDelete;
 use Tempest\Database\QueryStatement;
 use Tempest\Database\QueryStatements\CreateTableStatement;
 use Tempest\Database\QueryStatements\DropTableStatement;
+use Tempest\Database\QueryStatements\OnDelete;
 
 final class CreateBookTagTable implements MigratesUp, MigratesDown
 {

tests/Integration/Database/Builder/IsDatabaseModelTest.php

@@ -4,7 +4,6 @@
 
 namespace Tests\Tempest\Integration\Database\Builder;
 
-use BadMethodCallException;
 use Carbon\Carbon;
 use DateTime as NativeDateTime;
 use DateTimeImmutable;