Chunk id-lookup queries to respect RELATION_QUERY_CHUNK_SIZE

Addresses CodeRabbit #3084994641 and #3084994657 (+ Greptile #3084466265).
Three call sites were passing unchunked id arrays into Query::equal('$id',
...), which throws QueryException from DocumentsValidator once the array
exceeds 5000 values.

Mirror::createDocuments (skipDuplicates pre-filter): defensive — Mirror's
public API accepts arbitrary-size input, and while current callers pass
batches below the limit, the code shouldn't throw on a theoretical
direct caller with >5000 input ids.

Database::upsertDocumentsWithIncrease (both tenantPerDocument and single-
tenant branches): real regression. The batched pre-read was introduced
in ae929db to restore per-tenant grouping for StatsUsage. It replaced
a per-doc getDocument() loop on main (which is safe from validator
limits because each call queries one id). Passing the full input array
to Query::equal now breaks at >5000 input docs — a path that previously
worked slowly on main.

All three sites use self::RELATION_QUERY_CHUNK_SIZE (5000) and
Query::limit(PHP_INT_MAX), matching the existing pattern used by the
five populateDocumentsRelationshipsBatch chunking sites. Accumulator
shape is adapted to our map-only use case: we build the existence set /
lookup map directly inside the chunk loop instead of carrying a flat
list we don't need.

Author: premtsd-code

src/Database/Database.php

@@ -7159,14 +7159,16 @@ public function upsertDocumentsWithIncrease(
             }
             foreach ($idsByTenant as $tenant => $tenantIds) {
                 $tenantIds = \array_values(\array_unique($tenantIds));
-                $found = $this->authorization->skip(fn () => $this->withTenant($tenant, fn () => $this->silent(
-                    fn () => $this->find($collection->getId(), [
-                        Query::equal('$id', $tenantIds),
-                        Query::limit(\count($tenantIds)),
-                    ])
-                )));
-                foreach ($found as $doc) {
-                    $existingDocs[$tenant . ':' . $doc->getId()] = $doc;
+                foreach (\array_chunk($tenantIds, self::RELATION_QUERY_CHUNK_SIZE) as $chunk) {
+                    $found = $this->authorization->skip(fn () => $this->withTenant($tenant, fn () => $this->silent(
+                        fn () => $this->find($collection->getId(), [
+                            Query::equal('$id', $chunk),
+                            Query::limit(PHP_INT_MAX),
+                        ])
+                    )));
+                    foreach ($found as $doc) {
+                        $existingDocs[$tenant . ':' . $doc->getId()] = $doc;
+                    }
                 }
             }
         } else {
@@ -7176,14 +7178,16 @@ public function upsertDocumentsWithIncrease(
             )));
 
             if (!empty($docIds)) {
-                $existing = $this->authorization->skip(fn () => $this->silent(
-                    fn () => $this->find($collection->getId(), [
-                        Query::equal('$id', $docIds),
-                        Query::limit(\count($docIds)),
-                    ])
-                ));
-                foreach ($existing as $doc) {
-                    $existingDocs[$this->tenantKey($doc)] = $doc;
+                foreach (\array_chunk($docIds, self::RELATION_QUERY_CHUNK_SIZE) as $chunk) {
+                    $existing = $this->authorization->skip(fn () => $this->silent(
+                        fn () => $this->find($collection->getId(), [
+                            Query::equal('$id', $chunk),
+                            Query::limit(PHP_INT_MAX),
+                        ])
+                    ));
+                    foreach ($existing as $doc) {
+                        $existingDocs[$this->tenantKey($doc)] = $doc;
+                    }
                 }
             }
         }

src/Database/Mirror.php

@@ -612,14 +612,16 @@ public function createDocuments(
             ));
 
             if (!empty($ids)) {
-                $existing = $this->source->silent(
-                    fn () => $this->source->find($collection, [
-                        Query::equal('$id', $ids),
-                        Query::limit(\count($ids)),
-                    ])
-                );
-                foreach ($existing as $doc) {
-                    $existingIds[$doc->getId()] = true;
+                foreach (\array_chunk(\array_unique($ids), self::RELATION_QUERY_CHUNK_SIZE) as $chunk) {
+                    $existing = $this->source->silent(
+                        fn () => $this->source->find($collection, [
+                            Query::equal('$id', $chunk),
+                            Query::limit(PHP_INT_MAX),
+                        ])
+                    );
+                    foreach ($existing as $doc) {
+                        $existingIds[$doc->getId()] = true;
+                    }
                 }
             }
         }