Skip to content

A self-hosted media server and file management system

feat: series relationship edits

aminnausinfc035479fcbc
diff --git a/app/Http/Controllers/Api/V1/Metadata/SeriesRelationsController.php b/app/Http/Controllers/Api/V1/Metadata/SeriesRelationsController.php
new file mode 100644
index 00000000..cc3f5ac7
--- /dev/null
+++ b/app/Http/Controllers/Api/V1/Metadata/SeriesRelationsController.php
@@ -0,0 +1,64 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Metadata;
+
+use App\Enums\SeriesRelationType;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\SeriesRelationsUpdateRequest;
+use App\Http\Resources\SeriesResource;
+use App\Models\Series;
+use App\Traits\LogsModelChanges;
+use Illuminate\Support\Facades\Auth;
+use Illuminate\Support\Facades\DB;
+
+class SeriesRelationsController extends Controller {
+ use LogsModelChanges;
+
+ public function update(SeriesRelationsUpdateRequest $request, Series $series) {
+ if ($this->syncRelations($series, $request->input('upserts', []), $request->input('deletes', []))) {
+ $this->logModelChanges($series, ['relations_changed' => true], Auth::user());
+ }
+
+ $series->load(['directRelations.folder', 'directRelations.primaryPoster', 'inverseRelations.folder', 'inverseRelations.primaryPoster']);
+
+ return response()->json(new SeriesResource($series));
+ }
+
+ private function syncRelations(Series $series, array $upserts, array $deletes): bool {
+ return DB::transaction(function () use ($series, $upserts, $deletes) {
+ $changed = false;
+
+ // delete a relationship in either direction
+ $deletePair = fn (int $otherId) => DB::table('series_relations')
+ ->where(fn ($q) => $q->where('series_id', $series->id)->where('related_series_id', $otherId))
+ ->orWhere(fn ($q) => $q->where('series_id', $otherId)->where('related_series_id', $series->id))
+ ->delete();
+
+ foreach ($deletes as $otherId) {
+ $changed = $deletePair((int) $otherId) > 0 || $changed;
+ }
+
+ foreach ($upserts as $entry) {
+ $otherId = (int) $entry['series_id'];
+ $type = SeriesRelationType::from($entry['type']);
+
+ // flip relationship based on isStorable
+ [$subject, $object, $stored] = $type->isStorable() ? [$series->id, $otherId, $type] : [$otherId, $series->id, $type->inverse()];
+
+ $deletePair($otherId); // direction or type may differ, and the pair index allows one row
+
+ DB::table('series_relations')->insert([
+ 'series_id' => $subject,
+ 'related_series_id' => $object,
+ 'type' => $stored->value,
+ 'created_at' => now(),
+ 'updated_at' => now(),
+ ]);
+
+ $changed = true;
+ }
+
+ return $changed;
+ });
+ }
+}
diff --git a/routes/api.php b/routes/api.php
index 50da53b6..e4a15c47 100755
--- a/routes/api.php
+++ b/routes/api.php
@@ -12,6 +12,7 @@ use App\Http\Controllers\Api\V1\FolderController;
use App\Http\Controllers\Api\V1\JobController;
use App\Http\Controllers\Api\V1\Media\MediaController;
use App\Http\Controllers\Api\V1\Metadata\FontController;
+use App\Http\Controllers\Api\V1\Metadata\SeriesRelationsController;
use App\Http\Controllers\Api\V1\Metadata\StoryboardController;
use App\Http\Controllers\Api\V1\Metadata\SubtitleController;
use App\Http\Controllers\Api\V1\Metadata\TranscriptController;
@@ -106,11 +107,15 @@ Route::group(['middleware' => ['auth:sanctum']], function () {
Route::resource('/categories', CategoryController::class)->only(['index']);
+ Route::get('series/search', [SeriesController::class, 'search']);
+
Route::prefix('/series/{series}')->group(function () {
// Download Access Control
Route::put('/downloads', [SeriesController::class, 'updateDownloadSettings']);
// Images
Route::patch('/images', [SeriesController::class, 'updateImages']);
+ // Relations with other series(folders)
+ Route::put('/relations', [SeriesRelationsController::class, 'update']);
// Size History
Route::get('/size-history', [SeriesController::class, 'sizeHistory']);
});