A self-hosted media server and file management system
Vue ffmpegfile-serverjellyfinlaravelmediamedia-playermedia-servermediabrowsermediaservermusicmusic-librarymusic-playermusicplayerself-hostedvuejs
<?php
namespace App\Http\Controllers\Api\V1;
use App\Data\Images\ImageUpdateData;
use App\Enums\ImageType;
use App\Http\Controllers\Controller;
use App\Http\Requests\Series\SeriesImageUpdateRequest;
use App\Http\Requests\SeriesStoreRequest;
use App\Http\Requests\SeriesUpdateRequest;
use App\Http\Resources\SeriesResource;
use App\Http\Resources\SeriesSizeHistoryResource;
use App\Models\Folder;
use App\Models\FolderTag;
use App\Models\Series;
use App\Models\SeriesSizeHistory;
use App\Services\Images\ImageService;
use App\Traits\HasMeaningfulChanges;
use App\Traits\HasModelHelpers;
use App\Traits\HasTags;
use App\Traits\HttpResponses;
use App\Traits\LogsModelChanges;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Gate;
class SeriesController extends Controller {
use HasMeaningfulChanges;
use HasModelHelpers;
use HasTags;
use HttpResponses;
use LogsModelChanges;
/* User can:
*
* - List all series (to search ? admin page ?)
* - Store (Create series if row for folder does not already exist)
* - Update (User updates details)
*
* User cannot:
* - Show (Series data is added to each folder. Theres no reason to get one row on its own)
* - Delete (User should not be able to delete series row | maybe admin can but thats later)
*/
/**
* Display a listing of the resource.
*/
public function index() {
return $this->success(
SeriesResource::collection(
Series::all()
)
);
}
/**
* Store a newly created resource in storage.
*/
public function store(SeriesStoreRequest $request) {
$validated = $request->validated();
$folder = Folder::findOrFail($validated['folder_id']);
$compositeId = $folder->path;
$existing = Series::where('composite_id', $compositeId)->first();
if ($this->conflictsWithAnother('folder_id', $existing, $validated['folder_id'])) {
return $this->error($existing, 'Series already exists for another folder!', 500);
}
$validated['editor_id'] = Auth::id();
$validated['edited_at'] = now();
$validated['composite_id'] = $compositeId;
$series = $existing
? $this->updateExisting($existing, $validated, true)
: Series::create($validated);
$this->generateTagRelationships($series->id, $request->tags, $request->deleted_tags, 'series_id', FolderTag::class);
return response()->json(new SeriesResource($this->eagerLoadSeries($series)));
}
/**
* Simple search used for relations
*/
public function search(Request $request) {
$q = trim((string) $request->query('q'));
abort_if(mb_strlen($q) < 2, 422);
$isAdmin = Gate::allows('admin');
$query = Series::query()->whereNotNull('folder_id')
->where(
fn ($w) => $w
->where('title', 'ilike', "%{$q}%")
->orWhereHas('folder', fn ($f) => $f->where('name', 'ilike', "%{$q}%"))
->orWhereHas('folder.category', fn ($l) => $l->where('name', 'ilike', "%{$q}%"))
)
->when(! $isAdmin, fn ($w) => $w->whereHas('folder.category', fn ($l) => $l->where('is_private', false)))
->with(['folder.category', 'primaryPoster']);
return SeriesResource::collection($query->limit(10)->get());
}
/**
* Update the specified resource in storage.
*/
public function update(SeriesUpdateRequest $request, Series $series) {
$validated = $request->validated();
$series->fill($validated);
$tagsChanged = $this->generateTagRelationships($series->id, $request->tags, $request->deleted_tags, 'series_id', FolderTag::class);
if ($series->isDirty() || $tagsChanged) {
$user = Auth::user();
if ($this->hasMeaningfulChanges($series, Series::IGNORED_EDITABLE_FIELDS)) {
$series->fill(['editor_id' => $user->id, 'edited_at' => now()]);
}
$this->logModelChanges($series, ['tags_changed' => $tagsChanged], $user);
$series->timestamps = false;
$series->save();
$series->timestamps = true;
}
return response()->json(new SeriesResource($this->eagerLoadSeries($series)));
}
/**
* Update the specified resource in storage.
*/
public function updateDownloadSettings(Request $request, Series $series) {
if (Auth::id() !== 1) {
return $this->forbidden();
}
$validated = $request->validate([
'downloads_enabled' => 'sometimes|boolean',
]);
$series->update($validated);
return response($series->only(['downloads_enabled']));
}
public function updateImages(SeriesImageUpdateRequest $request, Series $series, ImageService $imageService) {
$this->authorize('editor');
$user = Auth::user();
$imageUpdateData = ImageUpdateData::fromRequest($request, $user, Gate::allows('admin'));
$image = $imageService->resolveUpdatedImage($series, $imageUpdateData);
if ($imageUpdateData->mode !== 'remove' && ! $image) {
abort(422, 'Image could not be resolved.');
}
match ($imageUpdateData->imageType) {
ImageType::POSTER => [$series->primary_poster_id = $image?->id, $series->poster_updated_at = now()],
ImageType::BANNER => [$series->primary_banner_id = $image?->id, $series->banner_updated_at = now()],
default => null,
};
if ($series->isDirty()) {
$series->fill(['editor_id' => $imageUpdateData->user->id, 'edited_at' => now()]);
$this->logModelChanges($series, ['request' => ['type' => 'update images', ...$request->validated()]], $imageUpdateData->user);
$series->save();
}
$imageService->softDeleteImages($series, $imageUpdateData);
$series->refresh();
return response()->json(new SeriesResource($this->eagerLoadSeries($series)));
}
public function sizeHistory(Series $series) {
$history = SeriesSizeHistory::where('series_id', $series?->id)
->orderBy('recorded_at')
->get();
return response()->json(SeriesSizeHistoryResource::collection($history));
}
private function eagerLoadSeries(Series $series): Series {
$series->load([
'folderTags.tag',
'primaryPoster',
'primaryBanner',
'images.user',
]);
return $series;
}
}