PHPLARA-73 Make id/_id column aliasing overridable via Grammar (#3539)

Delegate the top-level `id` to `_id` column rename in
`Builder::compileWheres()` to `Grammar::prepareFieldsForQuery()` so users
can extend the Grammar to disable the aliasing when documents have a
business `id` field alongside `_id`.

Author: GromNaN

src/Query/Builder.php

@@ -36,6 +36,7 @@
 use function array_filter;
 use function array_is_list;
 use function array_key_exists;
+use function array_key_first;
 use function array_keys;
 use function array_map;
 use function array_merge;
@@ -1293,10 +1294,11 @@ protected function compileWheres(): array
             if (isset($where['column'])) {
                 $where['column'] = (string) $where['column'];
 
-                // Compatibility with Eloquent queries that uses "id" instead of MongoDB's _id
-                if ($where['column'] === 'id') {
-                    $where['column'] = '_id';
-                }
+                // Compatibility with Eloquent queries that use "id" instead of MongoDB's _id.
+                // Delegates to Grammar::prepareFieldsForQuery so the aliasing is overridable.
+                $where['column'] = (string) array_key_first(
+                    $this->grammar->prepareFieldsForQuery([$where['column'] => null]),
+                );
 
                 // Convert id's.
                 if ($where['column'] === '_id' || str_ends_with($where['column'], '._id')) {

tests/Query/BuilderTest.php

@@ -1736,6 +1736,29 @@ public static function provideDisableRenameEmbeddedIdField()
         ];
     }
 
+    public function testCustomGrammarDisablesIdAliasing()
+    {
+        $connection = $this->createStub(Connection::class);
+        $connection->method('getRenameEmbeddedIdField')->willReturn(true);
+        $connection->method('getSession')->willReturn(null);
+        $grammar = new class ($connection) extends Grammar {
+            public function prepareFieldsForQuery(array $values, bool $root = true): array
+            {
+                return $values;
+            }
+        };
+        $connection->method('getQueryGrammar')->willReturn($grammar);
+
+        $builder = new Builder($connection, null, $this->createStub(Processor::class));
+
+        $mql = $builder->where('id', '=', 'abc123')->toMql();
+
+        $this->assertEquals(
+            ['find' => [['id' => 'abc123'], ['typeMap' => ['root' => 'object', 'document' => 'array']]]],
+            $mql,
+        );
+    }
+
     private function getBuilder(bool $renameEmbeddedIdField = true): Builder
     {
         $connection = $this->createStub(Connection::class);