fix: enhance PHPDoc annotations and add validation for user model in Like trait

Author: tanhongit

composer.json

@@ -53,6 +53,7 @@
     "phpstan/phpstan-phpunit": "^2.0"
   },
   "scripts": {
+    "a": "vendor/bin/phpstan analyse",
     "analyse": "vendor/bin/phpstan analyse",
     "format": "vendor/bin/php-cs-fixer fix --allow-risky=yes",
     "test": "vendor/bin/pest"

phpstan-baseline.neon

@@ -5,3 +5,5 @@ parameters:
 
         - message: '#Method CSlant\\LaravelLike\\Models\\Like::user\(\) return type with generic class Illuminate\\Database\\Eloquent\\Relations\\BelongsTo does not specify its types: TRelatedModel, TChildModel#'
           path: src/Models/Like.php
+        -
+          identifier: trait.unused

src/Models/Like.php

@@ -52,11 +52,16 @@ class Like extends Model
     /**
      * Get the user that owns the like.
      *
-     * @return BelongsTo
+     * @return BelongsTo<Model, self>
      */
     public function user(): BelongsTo
     {
         $userModel = (string) (config('like.users.model') ?? config('auth.providers.users.model'));
+
+        if (!is_a($userModel, Model::class, true)) {
+            throw new \InvalidArgumentException("The user model must be a valid Eloquent model class.");
+        }
+
         $userForeignKey = (string) (config('like.users.foreign_key') ?? 'user_id');
 
         return $this->belongsTo($userModel, $userForeignKey);

src/Traits/Like/LikeCount.php

@@ -11,8 +11,8 @@
  * @package CSlant\LaravelLike\Traits\Like
  * @mixin Model
  *
- * @method MorphMany likesTo()
- * @method MorphMany dislikesTo()
+ * @method MorphMany<self, Model> likesTo()
+ * @method MorphMany<self, Model> dislikesTo()
  */
 trait LikeCount
 {

src/Traits/Love/LoveCount.php

@@ -11,7 +11,7 @@
  * @package CSlant\LaravelLike\Traits\Love
  * @mixin Model
  *
- * @method MorphMany lovesTo()
+ * @method MorphMany<self, Model> lovesTo()
  */
 trait LoveCount
 {

src/UserHasInteraction.php

@@ -13,14 +13,14 @@
  *
  * @package CSlant\LaravelLike\Traits
  * @mixin Model
- * @method HasMany hasMany(string $related, string $foreignKey = null, string $localKey = null)
+ * @method HasMany<Like, Model> hasMany(string $related, string $foreignKey = null, string $localKey = null)
  */
 trait UserHasInteraction
 {
     /**
      * Get all likes of the user. This method is used for eager loading.
      *
-     * @return HasMany
+     * @return HasMany<Like, Model>
      */
     public function likes(): HasMany
     {