refactor: fix bad return types with Psalter (#2435)

app/Http/Controllers/Api/ApiPetController.php

@@ -15,7 +15,7 @@ class ApiPetController extends ApiController
     /**
      * Get the list of pet.
      *
-     * @return \Illuminate\Http\Response
+     * @return \Illuminate\Http\Resources\Json\AnonymousResourceCollection|\Illuminate\Http\JsonResponse
      */
     public function index(Request $request)
     {
@@ -32,8 +32,10 @@ class ApiPetController extends ApiController
 
     /**
      * Get the detail of a given pet.
-     * @param  Request $request
-     * @return \Illuminate\Http\Response
+     *
+     * @param Request $request
+     *
+     * @return PetResource|\Illuminate\Http\JsonResponse
      */
     public function show(Request $request, $id)
     {
@@ -50,8 +52,10 @@ class ApiPetController extends ApiController
 
     /**
      * Store the pet.
-     * @param  Request $request
-     * @return \Illuminate\Http\Response
+     *
+     * @param Request $request
+     *
+     * @return PetResource|\Illuminate\Http\JsonResponse
      */
     public function store(Request $request)
     {
@@ -74,9 +78,11 @@ class ApiPetController extends ApiController
 
     /**
      * Update the pet.
-     * @param  Request $request
-     * @param  int $petId
-     * @return \Illuminate\Http\Response
+     *
+     * @param Request $request
+     * @param int $petId
+     *
+     * @return PetResource|\Illuminate\Http\JsonResponse
      */
     public function update(Request $request, $petId)
     {
@@ -106,7 +112,7 @@ class ApiPetController extends ApiController
      * Validate the request for update.
      *
      * @param  Request $request
-     * @return mixed
+     * @return \Illuminate\Http\JsonResponse|true
      */
     private function validateUpdate(Request $request)
     {
@@ -134,9 +140,11 @@ class ApiPetController extends ApiController
 
     /**
      * Delete a pet.
-     * @param  Request $request
-     * @param  int $petId
-     * @return \Illuminate\Http\Response
+     *
+     * @param Request $request
+     * @param int $petId
+     *
+     * @return \Illuminate\Http\JsonResponse
      */
     public function destroy(Request $request, $petId)
     {
@@ -155,9 +163,11 @@ class ApiPetController extends ApiController
 
     /**
      * Get the list of pets for the given contact.
-     * @param  Request $request
-     * @param  int $contactId
-     * @return \Illuminate\Http\Response
+     *
+     * @param Request $request
+     * @param int $contactId
+     *
+     * @return \Illuminate\Http\Resources\Json\AnonymousResourceCollection|\Illuminate\Http\JsonResponse
      */
     public function pets(Request $request, $contactId)
     {