New Entity ORM Method groupByCallback

src/Phaseolies/Database/Entity/Builder.php

@@ -2986,6 +2986,28 @@ public function repair(callable $fixer, bool $saveChanges = false): Collection
         return $results;
     }
 
+    /**
+     * Get records grouped by a callback result
+     *
+     * @param callable $callback
+     * @return array
+     */
+    public function groupByCallback(callable $callback): array
+    {
+        $results = $this->get();
+        $grouped = [];
+
+        foreach ($results as $item) {
+            $key = $callback($item);
+            if (!isset($grouped[$key])) {
+                $grouped[$key] = [];
+            }
+            $grouped[$key][] = $item;
+        }
+
+        return $grouped;
+    }
+
     /**
      * Convert camelCase to snake_case for column names
      *

tests/Model/Query/EntityModelQueryTest.php

@@ -2,6 +2,7 @@
 
 namespace Tests\Unit\Model\Query;
 
+use App\Models\Product;
 use Tests\Support\Model\MockUser;
 use Tests\Support\Model\MockTag;
 use Tests\Support\Model\MockPost;
@@ -2661,4 +2662,33 @@ public function testRepairMethodSaveChanges()
             $this->assertNull($product->price);
         }
     }
+
+    public function testGroupByCallback()
+    {
+        $products = MockProduct::groupByCallback(function ($product) {
+            if ($product->price < 500) return 'lower_than_500';
+            if ($product->price > 500) return 'bigger_than_500';
+            return 'default';
+        });
+
+        $this->assertCount(1, $products['lower_than_500']);
+
+        foreach ($products['lower_than_500'] as $key => $product) {
+            $this->assertEquals(
+                435,
+                $product->price,
+                "Expected product ID {$product->id} to have price 435"
+            );
+        }
+
+        $this->assertCount(2, $products['bigger_than_500']);
+
+        foreach ($products['bigger_than_500'] as $product) {
+            $this->assertGreaterThan(
+                500,
+                $product->price,
+                "Expected product ID {$product->id} to have price > 500"
+            );
+        }
+    }
 }