creationService = $creationService; $this->deletionService = $deletionService; $this->repository = $repository; $this->updateService = $updateService; } /** * Handle request to list all users on the panel. Returns a JSON-API representation * of a collection of users including any defined relations passed in * the request. * * @param \Pterodactyl\Http\Requests\Api\Application\Users\GetUsersRequest $request * @return array */ public function index(GetUsersRequest $request): array { $users = $this->repository->setSearchTerm($request->input('search'))->paginated(50); return $this->fractal->collection($users) ->transformWith($this->getTransformer(UserTransformer::class)) ->toArray(); } /** * Handle a request to view a single user. Includes any relations that * were defined in the request. * * @param \Pterodactyl\Http\Requests\Api\Application\Users\GetUsersRequest $request * @return array */ public function view(GetUsersRequest $request): array { return $this->fractal->item($request->getModel(User::class)) ->transformWith($this->getTransformer(UserTransformer::class)) ->toArray(); } /** * Update an existing user on the system and return the response. Returns the * updated user model response on success. Supports handling of token revocation * errors when switching a user from an admin to a normal user. * * Revocation errors are returned under the 'revocation_errors' key in the response * meta. If there are no errors this is an empty array. * * @param \Pterodactyl\Http\Requests\Api\Application\Users\UpdateUserRequest $request * @param \Pterodactyl\Models\User $user * @return array * * @throws \Pterodactyl\Exceptions\Model\DataValidationException * @throws \Pterodactyl\Exceptions\Repository\RecordNotFoundException */ public function update(UpdateUserRequest $request, User $user): array { $this->updateService->setUserLevel(User::USER_LEVEL_ADMIN); $user = $this->updateService->handle($user, $request->validated()); $response = $this->fractal->item($user) ->transformWith($this->getTransformer(UserTransformer::class)); return $response->toArray(); } /** * Store a new user on the system. Returns the created user and a HTTP/201 * header on successful creation. * * @param \Pterodactyl\Http\Requests\Api\Application\Users\StoreUserRequest $request * @return \Illuminate\Http\JsonResponse * * @throws \Exception * @throws \Pterodactyl\Exceptions\Model\DataValidationException */ public function store(StoreUserRequest $request): JsonResponse { $user = $this->creationService->handle($request->validated()); return $this->fractal->item($user) ->transformWith($this->getTransformer(UserTransformer::class)) ->addMeta([ 'resource' => route('api.application.users.view', [ 'user' => $user->id, ]), ]) ->respond(201); } /** * Handle a request to delete a user from the Panel. Returns a HTTP/204 response * on successful deletion. * * @param \Pterodactyl\Http\Requests\Api\Application\Users\DeleteUserRequest $request * @return \Illuminate\Http\Response * * @throws \Pterodactyl\Exceptions\DisplayException */ public function delete(DeleteUserRequest $request): Response { $this->deletionService->handle($request->getModel(User::class)); return response('', 204); } }