feat(Domain): add allowEmpty constructor option

src/Validator/Domain.php

@@ -18,7 +18,8 @@ class Domain extends Validator
      */
     public function __construct(
         protected array $restrictions = [],
-        protected bool $hostnames = true
+        protected bool $hostnames = true,
+        protected bool $allowEmpty = false
     ) {
     }
 
@@ -64,6 +65,10 @@ public function getDescription(): string
      */
     public function isValid($value): bool
     {
+        if ($this->allowEmpty && $value === '') {
+            return true;
+        }
+
         if (empty($value)) {
             return false;
         }

tests/Validator/DomainTest.php

@@ -120,8 +120,31 @@
         $this->assertSame(true, $permissiveValidator->isValid('example.com/path')); // Path
     }
 
-    public function testRestrictions()
+    /**
+     * Test allowEmpty parameter
+     */
+    public function testAllowEmpty()
+    {
+        // By default, empty string is invalid
+        $this->assertSame(false, $this->domain->isValid(''));
+
+        // With allowEmpty=true, empty string is valid
+        $domainAllowEmpty = new Domain([], true, true);
+        $this->assertSame(true, $domainAllowEmpty->isValid(''));
+
+        // null is still invalid even with allowEmpty=true
+        $this->assertSame(false, $domainAllowEmpty->isValid(null));
+
+        // Valid domains still pass with allowEmpty=true
+        $this->assertSame(true, $domainAllowEmpty->isValid('example.com'));
+        $this->assertSame(true, $domainAllowEmpty->isValid('subdomain.example.com'));
+
+        // Invalid domains still fail with allowEmpty=true
+        $this->assertSame(false, $domainAllowEmpty->isValid('invalid..domain'));
+        $this->assertSame(false, $domainAllowEmpty->isValid(1));
+    }
+
     {
         $validator = new Domain([
             Domain::createRestriction('appwrite.network', 3, ['preview-', 'branch-']),
             Domain::createRestriction('fra.appwrite.run', 4),
@@ -175,4 +198,4 @@
         $this->assertSame(true, $permissiveValidator->isValid('subdomain.example.com'));
         $this->assertSame(true, $permissiveValidator->isValid('subdomain-new.example.com'));
     }
 }