Add setPreserveSequence to Mirror and test invalid sequence validation

- Add setPreserveSequence delegation to Mirror.php
- Add test case for invalid $sequence value throwing StructureException

Author: premtsd-code

src/Database/Mirror.php

@@ -139,6 +139,15 @@ public function setPreserveDates(bool $preserve): static
         return $this;
     }
 
+    public function setPreserveSequence(bool $preserve): static
+    {
+        $this->delegate(__FUNCTION__, \func_get_args());
+
+        $this->preserveSequence = $preserve;
+
+        return $this;
+    }
+
     public function enableValidation(): static
     {
         $this->delegate(__FUNCTION__);

tests/e2e/Adapter/Scopes/DocumentTests.php

@@ -1286,6 +1286,32 @@ public function testPreserveSequenceUpsert(): void
         // Verify flag was reset after withPreserveSequence
         $this->assertFalse($database->getPreserveSequence());
 
+        // Test: With preserveSequence=true, invalid $sequence should throw error (SQL adapters only)
+        $database->setPreserveSequence(true);
+
+        try {
+            $database->upsertDocuments($collectionName, [
+                new Document([
+                    '$id' => 'doc1',
+                    '$sequence' => 'abc', // Invalid sequence value
+                    '$permissions' => [
+                        Permission::read(Role::any()),
+                        Permission::update(Role::any()),
+                    ],
+                    'name' => 'Alice Invalid',
+                ]),
+            ]);
+            // Schemaless adapters may not validate sequence type, so only fail for schemaful
+            if ($database->getAdapter()->getSupportForAttributes()) {
+                $this->fail('Expected StructureException for invalid sequence');
+            }
+        } catch (Throwable $e) {
+            if ($database->getAdapter()->getSupportForAttributes()) {
+                $this->assertInstanceOf(StructureException::class, $e);
+                $this->assertStringContainsString('sequence', $e->getMessage());
+            }
+        }
+
         $database->setPreserveSequence(false);
         $database->deleteCollection($collectionName);
     }