*/ public function index(GetUsersRequest $request): array { $users = QueryBuilder::for(User::query()) ->allowedFilters(['email', 'uuid', 'username', 'external_id']) ->allowedSorts(['id', 'uuid']) ->paginate($request->query('per_page') ?? 50); return $this->fractal->collection($users) ->transformWith($this->getTransformer(UserTransformer::class)) ->toArray(); } /** * View user * * Handle a request to view a single user. Includes any relations that * were defined in the request. * * @return array */ public function view(GetUsersRequest $request, User $user): array { return $this->fractal->item($user) ->transformWith($this->getTransformer(UserTransformer::class)) ->toArray(); } /** * Update user * * 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. * * @return array * * @throws \App\Exceptions\Model\DataValidationException */ 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(); } /** * Assign role to user * * Assign roles to a user. * * @return array */ public function assignRoles(AssignUserRolesRequest $request, User $user): array { foreach ($request->input('roles') as $role) { if ($role === Role::getRootAdmin()->id) { continue; } $user->assignRole($role); } $response = $this->fractal->item($user) ->transformWith($this->getTransformer(UserTransformer::class)); return $response->toArray(); } /** * Unassign role from user * * Removes roles from a user. * * @return array */ public function removeRoles(AssignUserRolesRequest $request, User $user): array { foreach ($request->input('roles') as $role) { if ($role === Role::getRootAdmin()->id) { continue; } $user->removeRole($role); } $response = $this->fractal->item($user) ->transformWith($this->getTransformer(UserTransformer::class)); return $response->toArray(); } /** * Create user * * Store a new user on the system. Returns the created user and an HTTP/201 * header on successful creation. * * @throws \Exception * @throws \App\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); } /** * Delete user * * Handle a request to delete a user from the Panel. Returns a HTTP/204 response on successful deletion. */ public function delete(DeleteUserRequest $request, User $user): JsonResponse { $user->delete(); return new JsonResponse([], JsonResponse::HTTP_NO_CONTENT); } }