[ 'name' => 'required|string|max:255', 'description' => 'string|max:1000', 'books' => 'array', ], 'update' => [ 'name' => 'string|min:1|max:255', 'description' => 'string|max:1000', 'books' => 'array', ], ]; /** * BookshelfApiController constructor. * @param BookshelfRepo $bookshelfRepo */ public function __construct(BookshelfRepo $bookshelfRepo) { $this->bookshelfRepo = $bookshelfRepo; } /** * Get a listing of shelves visible to the user. */ public function list() { $shelves = Bookshelf::visible(); return $this->apiListingResponse($shelves, [ 'id', 'name', 'slug', 'description', 'created_at', 'updated_at', 'created_by', 'updated_by', 'image_id', ]); } /** * Create a new shelf in the system. * An array of books IDs can be provided in the request. These * will be added to the shelf in the same order as provided. * @throws ValidationException */ public function create(Request $request) { $this->checkPermission('bookshelf-create-all'); $requestData = $this->validate($request, $this->rules['create']); $bookIds = $request->get('books', []); $shelf = $this->bookshelfRepo->create($requestData, $bookIds); Activity::add($shelf, 'bookshelf_create', $shelf->id); return response()->json($shelf); } /** * View the details of a single shelf. */ public function read(string $id) { $shelf = Bookshelf::visible()->with([ 'tags', 'cover', 'createdBy', 'updatedBy', 'books' => function (BelongsToMany $query) { $query->visible()->get(['id', 'name', 'slug']); } ])->findOrFail($id); return response()->json($shelf); } /** * Update the details of a single shelf. * An array of books IDs can be provided in the request. These * will be added to the shelf in the same order as provided and overwrite * any existing book assignments. * @throws ValidationException */ public function update(Request $request, string $id) { $shelf = Bookshelf::visible()->findOrFail($id); $this->checkOwnablePermission('bookshelf-update', $shelf); $requestData = $this->validate($request, $this->rules['update']); $bookIds = $request->get('books', null); $shelf = $this->bookshelfRepo->update($shelf, $requestData, $bookIds); Activity::add($shelf, 'bookshelf_update', $shelf->id); return response()->json($shelf); } /** * Delete a single shelf from the system. * @throws Exception */ public function delete(string $id) { $shelf = Bookshelf::visible()->findOrFail($id); $this->checkOwnablePermission('bookshelf-delete', $shelf); $this->bookshelfRepo->destroy($shelf); Activity::addMessage('bookshelf_delete', $shelf->name); return response('', 204); } }