fix: update latest received reviews query for flexibility

Author: fajarwz

src/Traits/CanBeReviewed.php

@@ -4,7 +4,6 @@
 
 use Fajarwz\LaravelReview\Models\Review;
 use Fajarwz\LaravelReview\Models\ReviewSummary;
-use Illuminate\Database\Eloquent\Collection;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Database\Eloquent\Relations\MorphOne;
@@ -63,17 +62,17 @@ public function getReceivedReview(Model $model, bool $includeUnapproved = false)
     }
 
     /**
-     * Get the current model latest received reviews of the specified model.
+     * Query the current model latest received reviews of the specified model.
      */
-    public function getLatestReceivedReviews(?Model $model = null, bool $includeUnapproved = false): Collection
+    public function latestReceivedReviews(?Model $model = null, bool $includeUnapproved = false): HasMany
     {
         $query = $this->receivedReviews($model);
 
         if ($includeUnapproved) {
             $query->withUnapproved();
         }
 
-        return $query->orderByDesc('created_at')->get();
+        return $query->orderByDesc('created_at');
     }
 
     /**

tests/CanBeReviewedTest.php

@@ -148,37 +148,37 @@ public function test_getReceivedReview_can_retrieve_unapproved_review_when_inclu
         $this->assertEquals(3, $review->rating);
     }
 
-    public function test_getLatestReceivedReviews_retrieves_latest_approved_reviews_by_default()
+    public function test_latestReceivedReviews_retrieves_latest_approved_reviews_by_default()
     {
         $newMentee = Mentor::factory()->create();
 
         $newReview = $newMentee->review($this->mentor, 4, 'nice!!!');
 
-        $reviews = $this->mentor->getLatestReceivedReviews();
+        $reviews = $this->mentor->latestReceivedReviews()->get();
 
         $this->assertCount(3, $reviews);
         $this->assertEquals($reviews->first()->id, $newReview->id);
     }
 
-    public function test_getLatestReceivedReviews_not_returning_unapproved_reviews_by_default()
+    public function test_latestReceivedReviews_not_returning_unapproved_reviews_by_default()
     {
         $newMentee = Mentor::factory()->create();
 
         $newReview = $newMentee->review($this->mentor, 4, 'nice!!!', isApproved: false);
 
-        $reviews = $this->mentor->getLatestReceivedReviews();
+        $reviews = $this->mentor->latestReceivedReviews()->get();
 
         $this->assertCount(2, $reviews);
         $this->assertNotEquals($reviews->first()->id, $newReview->id);
     }
 
-    public function test_getLatestReceivedReviews_can_retrieves_unapproved_reviews_when_includeUnapproved_is_true()
+    public function test_latestReceivedReviews_can_retrieves_unapproved_reviews_when_includeUnapproved_is_true()
     {
         $newMentee = Mentor::factory()->create();
 
         $newReview = $newMentee->review($this->mentor, 4, 'nice!!!', isApproved: false);
 
-        $reviews = $this->mentor->getLatestReceivedReviews(includeUnapproved: true);
+        $reviews = $this->mentor->latestReceivedReviews(includeUnapproved: true)->get();
 
         $this->assertCount(3, $reviews);
         $this->assertEquals($reviews->first()->id, $newReview->id);