3 namespace BookStack\Entities\Queries;
5 use BookStack\Entities\Models\Book;
6 use BookStack\Exceptions\NotFoundException;
7 use Illuminate\Database\Eloquent\Builder;
9 class BookQueries implements ProvidesEntityQueries
11 protected static array $listAttributes = [
12 'id', 'slug', 'name', 'description',
13 'created_at', 'updated_at', 'image_id', 'owned_by',
16 public function start(): Builder
21 public function findVisibleById(int $id): ?Book
23 return $this->start()->scopes('visible')->find($id);
26 public function findVisibleByIdOrFail(int $id): Book
28 return $this->start()->scopes('visible')->findOrFail($id);
31 public function findVisibleBySlugOrFail(string $slug): Book
33 /** @var ?Book $book */
34 $book = $this->start()
36 ->where('slug', '=', $slug)
40 throw new NotFoundException(trans('errors.book_not_found'));
46 public function visibleForList(): Builder
48 return $this->start()->scopes('visible')
49 ->select(static::$listAttributes);
52 public function visibleForListWithCover(): Builder
54 return $this->visibleForList()->with('cover');
57 public function recentlyViewedForCurrentUser(): Builder
59 return $this->visibleForList()
60 ->scopes('withLastView')
61 ->having('last_viewed_at', '>', 0)
62 ->orderBy('last_viewed_at', 'desc');
65 public function popularForList(): Builder
67 return $this->visibleForList()
68 ->scopes('withViewCount')
69 ->having('view_count', '>', 0)
70 ->orderBy('view_count', 'desc');