feat: Add firstCaseInsensitive method to EntityControlTrait

Author: artengin

src/Traits/EntityControlTrait.php

@@ -290,6 +290,17 @@ public function findBy(string $field, $value): ?Model
         return $this->first([$field => $value]);
     }
 
+    public function firstCaseInsensitive(string $field, string $value): ?Model
+    {
+        $result = $this->getQuery()
+            ->whereRaw("LOWER({$field}) = ?", [strtolower($value)])
+            ->first();
+
+        $this->postQueryHook();
+
+        return $result;
+    }
+
     public function find($id): ?Model
     {
         return $this->first($id);

tests/EntityControlTraitTest.php

@@ -750,6 +750,21 @@ public function testFindBy()
         $this->assertSettablePropertiesReset(self::$testRepositoryClass);
     }
 
+    public function testFirstCaseInsensitive()
+    {
+        $this->mockFirstCaseInsensitive(self::$selectResult, 'john@example.com');
+
+        self::$testRepositoryClass
+            ->withTrashed()
+            ->onlyTrashed()
+            ->force()
+            ->with('relation')
+            ->withCount('relation')
+            ->firstCaseInsensitive('email', 'JOHN@example.com');
+
+        $this->assertSettablePropertiesReset(self::$testRepositoryClass);
+    }
+
     public function testFindByEmptyResult()
     {
         $this->mockSelectById(

tests/support/Traits/SqlMockTrait.php

@@ -70,6 +70,21 @@ protected function mockFirstBy(array $selectResult): void
         );
     }
 
+    protected function mockFirstCaseInsensitive(array $selectResult, string $value): void
+    {
+        $this->mockSelect(
+            'select "test_models".*, (select count(*) from "relation_models" '
+            . 'where "test_models"."id" = "relation_models"."test_model_id") as "relation_count" '
+            . 'from "test_models" where "test_models"."deleted_at" is not null and LOWER(email) = ? limit 1',
+            $selectResult,
+            [$value],
+        );
+
+        $this->mockSelect(
+            'select * from "relation_models" where "relation_models"."test_model_id" in (1)',
+        );
+    }
+
     protected function mockLast(array $selectResult): void
     {
         $this->mockSelectById(