3 namespace BookStack\Entities\Repos;
5 use BookStack\Activity\ActivityType;
6 use BookStack\Entities\Models\Bookshelf;
7 use BookStack\Entities\Queries\BookQueries;
8 use BookStack\Entities\Tools\TrashCan;
9 use BookStack\Facades\Activity;
10 use BookStack\Util\DatabaseTransaction;
15 public function __construct(
16 protected BaseRepo $baseRepo,
17 protected BookQueries $bookQueries,
18 protected TrashCan $trashCan,
23 * Create a new shelf in the system.
25 public function create(array $input, array $bookIds): Bookshelf
27 return (new DatabaseTransaction(function () use ($input, $bookIds) {
28 $shelf = new Bookshelf();
29 $this->baseRepo->create($shelf, $input);
30 $this->baseRepo->updateCoverImage($shelf, $input['image'] ?? null);
31 $this->updateBooks($shelf, $bookIds);
32 Activity::add(ActivityType::BOOKSHELF_CREATE, $shelf);
38 * Update an existing shelf in the system using the given input.
40 public function update(Bookshelf $shelf, array $input, ?array $bookIds): Bookshelf
42 $this->baseRepo->update($shelf, $input);
44 if (!is_null($bookIds)) {
45 $this->updateBooks($shelf, $bookIds);
48 if (array_key_exists('image', $input)) {
49 $this->baseRepo->updateCoverImage($shelf, $input['image'], $input['image'] === null);
52 Activity::add(ActivityType::BOOKSHELF_UPDATE, $shelf);
58 * Update which books are assigned to this shelf by syncing the given book ids.
59 * Function ensures the managed books are visible to the current user and existing,
60 * and that the user does not alter the assignment of books that are not visible to them.
62 protected function updateBooks(Bookshelf $shelf, array $bookIds): void
64 $numericIDs = collect($bookIds)->map(function ($id) {
68 $existingBookIds = $shelf->books()->pluck('id')->toArray();
69 $visibleExistingBookIds = $this->bookQueries->visibleForList()
70 ->whereIn('id', $existingBookIds)
73 $nonVisibleExistingBookIds = array_values(array_diff($existingBookIds, $visibleExistingBookIds));
75 $newIdsToAssign = $this->bookQueries->visibleForList()
76 ->whereIn('id', $bookIds)
80 $maxNewIndex = max($numericIDs->keys()->toArray() ?: [0]);
83 foreach ($newIdsToAssign as $id) {
84 $syncData[$id] = ['order' => $numericIDs->search($id)];
87 foreach ($nonVisibleExistingBookIds as $index => $id) {
88 $syncData[$id] = ['order' => $maxNewIndex + ($index + 1)];
91 $shelf->books()->sync($syncData);
95 * Remove a bookshelf from the system.
99 public function destroy(Bookshelf $shelf)
101 $this->trashCan->softDestroyShelf($shelf);
102 Activity::add(ActivityType::BOOKSHELF_DELETE, $shelf);
103 $this->trashCan->autoClearOld();