WIP POC for better perf.

src/Database/Adapter.php

@@ -325,6 +325,32 @@ public function clearTimeout(string $event): void
         $this->before($event, 'timeout');
     }
 
+    /**
+     * Bulk update attributes for many documents by their IDs.
+     *
+     * Default implementation performs per-ID updates using updateDocument with
+     * permissions update skipped. Adapters can override for optimized paths.
+     *
+     * @param Document $collection
+     * @param array<string> $ids
+     * @param array<string,mixed> $attributes Encoded attribute keys expected by adapter
+     * @return int Number of documents processed
+     */
+    public function updateManyByIds(Document $collection, array $ids, array $attributes): int
+    {
+        if (empty($ids) || empty($attributes)) {
+            return 0;
+        }
+
+        $count = 0;
+        foreach ($ids as $id) {
+            $this->updateDocument($collection, $id, new Document($attributes), true);
+            $count++;
+        }
+
+        return $count;
+    }
+
     /**
      * Start a new transaction.
      *

src/Database/Adapter/Pool.php

@@ -245,6 +245,11 @@ public function updateDocuments(Document $collection, Document $updates, array $
         return $this->delegate(__FUNCTION__, \func_get_args());
     }
 
+    public function updateManyByIds(Document $collection, array $ids, array $attributes): int
+    {
+        return $this->delegate(__FUNCTION__, \func_get_args());
+    }
+
     public function upsertDocuments(Document $collection, string $attribute, array $changes): array
     {
         return $this->delegate(__FUNCTION__, \func_get_args());

src/Database/Adapter/SQL.php

@@ -2100,6 +2100,78 @@ public function createDocuments(Document $collection, array $documents): array
         return $documents;
     }
 
+    /**
+     * Bulk update attributes for many documents by their IDs
+     *
+     * @param Document $collection
+     * @param array<string> $ids
+     * @param array<string,mixed> $attributes Public attribute keys (e.g. "$updatedAt", "author")
+     * @return int Number of rows updated
+     * @throws \Exception
+     */
+    public function updateManyByIds(Document $collection, array $ids, array $attributes): int
+    {
+        if (empty($ids) || empty($attributes)) {
+            return 0;
+        }
+
+        $collectionId = $this->filter($collection->getId());
+
+        // Map attribute keys to internal column names and build bindings
+        $binds = [];
+        $setParts = [];
+        $bindIndex = 0;
+
+        foreach ($attributes as $key => $value) {
+            $internal = $this->filter($this->getInternalKeyForAttribute($key));
+
+            // JSON encode arrays/objects; cast bools to int
+            if (\is_array($value)) {
+                $value = \json_encode($value);
+            } elseif (\is_bool($value)) {
+                $value = (int) $value;
+            }
+
+            $bindKey = ":val_{$bindIndex}";
+            $setParts[] = "{$this->quote($internal)} = {$bindKey}";
+            $binds[$bindKey] = $value;
+            $bindIndex++;
+        }
+
+        // Build IN list for IDs
+        $idPlaceholders = [];
+        foreach ($ids as $i => $id) {
+            $ph = ":id_{$i}";
+            $idPlaceholders[] = $ph;
+            $binds[$ph] = $id;
+        }
+
+        $tenantClause = '';
+        if ($this->sharedTables) {
+            $tenantClause = " AND {$this->quote('_tenant')} = :_tenant";
+            $binds[':_tenant'] = $this->getTenant();
+        }
+
+        $setSQL = \implode(', ', $setParts);
+        $inSQL = \implode(', ', $idPlaceholders);
+
+        $sql = "
+            UPDATE {$this->getSQLTable($collectionId)}
+            SET {$setSQL}
+            WHERE {$this->quote('_uid')} IN ({$inSQL}){$tenantClause}
+        ";
+
+        $stmt = $this->getPDO()->prepare($sql);
+
+        foreach ($binds as $key => $val) {
+            $stmt->bindValue($key, $val, $this->getPDOType($val));
+        }
+
+        $this->execute($stmt);
+
+        return $stmt->rowCount();
+    }
+
     /**
      * @param Document $collection
      * @param string $attribute