(fix): CI — propagate skipDuplicates through Database → Adapter → Permissions hook

The feat-query-lib branch merged skipDuplicates support into Mirror / Adapter
but the Database layer's skipDuplicates(callback) only flipped a dynamic
property and never propagated to the adapter, so INSERT IGNORE was never
emitted.

- Database: declare protected bool $skipDuplicates so the flag is real.
- Traits/Documents::createDocuments: when $this->skipDuplicates is set,
  wrap each batch with $this->adapter->skipDuplicates(...) so the adapter
  flag is live during the INSERT.
- Hook/WriteContext: add a bool $skipDuplicates field so write hooks can
  see the mode in effect for the parent INSERT.
- Adapter/SQL::buildWriteContext: pass the adapter's $skipDuplicates
  through to the context.
- Hook/Permissions::afterDocumentCreate: use $permBuilder->insertOrIgnore()
  when the context signals skipDuplicates. Without this, destination
  backfill under skipDuplicates hit 1062 on the _perms unique index when
  a row already existed on source with the same permissions.

Verified: MirrorTest now green (653 tests, 0 failures).

Author: github-actions[bot]

src/Database/Adapter/SQL.php

@@ -2919,6 +2919,7 @@ protected function buildWriteContext(string $collection): WriteContext
             decorateRow: fn (array $row, array $metadata) => $this->decorateRow($row, $metadata),
             createBuilder: fn () => $this->createBuilder(),
             getTableRaw: fn (string $table) => $this->getSQLTableRaw($table),
+            skipDuplicates: $this->skipDuplicates,
         );
     }
 

src/Database/Database.php

@@ -298,6 +298,8 @@ class Database
 
     protected bool $preserveSequence = false;
 
+    protected bool $skipDuplicates = false;
+
     protected int $maxQueryValues = 5000;
 
     protected bool $migrating = false;

src/Database/Hook/Permissions.php

@@ -44,7 +44,7 @@ public function afterDocumentCreate(string $collection, array $documents, WriteC
         }
 
         if ($hasPermissions) {
-            $result = $permBuilder->insert();
+            $result = $context->skipDuplicates ? $permBuilder->insertOrIgnore() : $permBuilder->insert();
             $stmt = ($context->executeResult)($result, Event::PermissionsCreate);
             ($context->execute)($stmt);
         }

src/Database/Hook/WriteContext.php

@@ -18,6 +18,7 @@
      * @param  Closure(array<string, mixed>, array<string, mixed>): array<string, mixed>  $decorateRow  Apply all write hooks' decorateRow to a row
      * @param  Closure(): \Utopia\Query\Builder\SQL  $createBuilder  Create a raw builder (no hooks, no table)
      * @param  Closure(string): string  $getTableRaw  Get the raw SQL table name with namespace prefix
+     * @param  bool  $skipDuplicates  Whether duplicate-key errors should be swallowed by this write
      */
     public function __construct(
         public Closure $newBuilder,
@@ -26,6 +27,7 @@ public function __construct(
         public Closure $decorateRow,
         public Closure $createBuilder,
         public Closure $getTableRaw,
+        public bool $skipDuplicates = false,
     ) {
     }
 }

src/Database/Traits/Documents.php

@@ -556,9 +556,10 @@ public function createDocuments(
         }
 
         foreach (\array_chunk($documents, $batchSize) as $chunk) {
-            $batch = $this->withTransaction(function () use ($collection, $chunk) {
-                return $this->adapter->createDocuments($collection, $chunk);
-            });
+            $insert = fn () => $this->withTransaction(fn () => $this->adapter->createDocuments($collection, $chunk));
+            $batch = $this->skipDuplicates
+                ? $this->adapter->skipDuplicates($insert)
+                : $insert();
 
             $batch = $this->adapter->getSequences($collection->getId(), $batch);