Die Ansichten sprechen nicht mehr mit Plex

Start, Suche, Mediathek, Detailseiten und Downloads arbeiten jetzt mit
`MediaItem` und dem `MediaBackend`-Vertrag. Damit sind sie fertig für
einen zweiten Server, ohne dass an ihnen noch etwas zu tun wäre.

Dabei sind ein paar Namen ehrlicher geworden: aus `grandparentTitle`
wurde `seriesTitle`, aus `viewedLeafCount` `playedEpisodeCount`. Und
`TagStrip` nahm bisher Plex-Marken mit Kennung und Rolle entgegen, um
davon nur den Namen anzuzeigen — Genres sind jetzt schlicht Zeichenketten.

`Arrangement` ist aus PlexKit heraus und generisch: dieselbe Rechnung
gilt für jede Liste, die jemand selbst zusammenstellt. Phase 3 baut die
konfigurierbare Seitenleiste darauf, statt sie ein zweites Mal — und ein
zweites Mal falsch — zu schreiben.

Die Fehlerübersetzung gibt es nur noch einmal. Es waren zwei, und sie
waren bereits auseinandergelaufen: derselbe Fehler bekam je nach
Bildschirm eine andere Erklärung.

Das Nachladen der Mediathek bleibt unangetastet: eine lange Liste, die
fünf Einträge vor dem Ende nachlädt. `MediaPage` heißt zwar Seite, ist
aber eine technische Portion — Blättern mit „weiter zu Seite 2" gehört
nicht in eine Mediathek, in der man stöbert. Der Kommentar dort sagt das
jetzt ausdrücklich, damit es niemand später „aufräumt".

Player, Live-TV und die Download-Engine sprechen noch unmittelbar mit
Plex. Sie folgen als Nächstes.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Packages/FlixyKit/Sources/PlexKit/Models/HubArrangement.swift

@@ -1,67 +0,0 @@
-import Foundation
-
-/// Wie die Reihen der Startseite angeordnet werden.
-///
-/// Reine Rechnung ohne Speicher und ohne Oberfläche — die Stelle, an der die
-/// zwei unangenehmen Fälle entschieden werden: was mit Reihen geschieht, die
-/// der Server neu liefert, und was mit gespeicherten, die es nicht mehr gibt.
-public struct HubArrangement: Sendable, Equatable {
-    /// Ausdrücklich ausgeblendete Reihen.
-    public var hidden: Set<String>
-    /// Die gewünschte Reihenfolge. Reihen, die hier fehlen, landen am Ende.
-    public var order: [String]
-
-    public init(hidden: Set<String> = [], order: [String] = []) {
-        self.hidden = hidden
-        self.order = order
-    }
-
-    /// Wendet Auswahl und Reihenfolge an.
-    ///
-    /// Unbekannte Reihen landen am Ende statt zu verschwinden. Sie zu
-    /// verwerfen wäre die einfachere Regel — und der Grund dafür, dass ein
-    /// neu angelegtes Regal auf dem Server in der App nie aufgetaucht wäre.
-    public func apply(to hubs: [PlexHub]) -> [PlexHub] {
-        let visible = hubs.filter { !hidden.contains($0.hubIdentifier) }
-        guard !order.isEmpty else { return visible }
-
-        let positions = Dictionary(
-            order.enumerated().map { ($1, $0) },
-            // Ein doppelter Eintrag in der gespeicherten Reihenfolge — etwa
-            // nach einem fehlgeschlagenen Schreibvorgang — soll nicht
-            // abstürzen. Die erste Position gewinnt.
-            uniquingKeysWith: { first, _ in first }
-        )
-
-        return visible.enumerated().sorted { left, right in
-            let leftPosition = positions[left.element.hubIdentifier] ?? Int.max
-            let rightPosition = positions[right.element.hubIdentifier] ?? Int.max
-            // Bei gleicher Position — beide unbekannt — bleibt die Reihenfolge
-            // des Servers erhalten. Ohne diese Rückfalllinie wäre die
-            // Anordnung neuer Reihen zufällig.
-            if leftPosition == rightPosition { return left.offset < right.offset }
-            return leftPosition < rightPosition
-        }.map(\.element)
-    }
-
-    /// Die Liste für den Einstellungsbildschirm: gespeicherte Reihenfolge
-    /// zuerst, danach alles, was der Server sonst noch liefert.
-    ///
-    /// Gespeicherte Reihen, die es nicht mehr gibt, fallen dabei heraus — sie
-    /// anzuzeigen hieße, eine Reihe anzubieten, die nie erscheinen kann.
-    public func arrangedIdentifiers(from hubs: [PlexHub]) -> [String] {
-        var result: [String] = []
-        var seen = Set<String>()
-
-        for identifier in order
-        where !seen.contains(identifier) && hubs.contains(where: { $0.hubIdentifier == identifier }) {
-            result.append(identifier)
-            seen.insert(identifier)
-        }
-        for hub in hubs where !seen.contains(hub.hubIdentifier) {
-            result.append(hub.hubIdentifier)
-            seen.insert(hub.hubIdentifier)
-        }
-        return result
-    }
-}

Packages/FlixyKit/Sources/PlexKit/PlexBackend.swift

@@ -49,7 +49,11 @@ public struct PlexBackend: MediaBackend {
                 offset: offset,
                 limit: limit
             )
-            return MediaPage(items: page.items.map(\.asMediaItem), totalCount: page.totalSize)
+            return MediaPage(
+                items: page.items.map(\.asMediaItem),
+                offset: page.offset,
+                totalCount: page.totalSize
+            )
         }
     }
 
@@ -95,6 +99,29 @@ public struct PlexBackend: MediaBackend {
         server.rawImageURL(path: path)
     }
 
+    // MARK: - Herunterladen
+
+    public nonisolated func downloadURL(for file: MediaFile) -> URL? {
+        guard let key = file.key else { return nil }
+        // Nur der Schlüssel wird gebraucht; alles andere steckt schon in der
+        // Adresse oder ist für den Abruf ohne Belang.
+        return server.downloadURL(part: PlexPart(id: 0, key: key))
+    }
+
+    public nonisolated func compressedDownloadURL(
+        itemID: String,
+        versionIndex: Int,
+        maximumBitrate: Int,
+        resolution: String?
+    ) -> URL? {
+        server.transcodedDownloadURL(
+            ratingKey: itemID,
+            mediaIndex: versionIndex,
+            maximumBitrate: maximumBitrate,
+            resolution: resolution
+        )
+    }
+
     // MARK: - Zustand melden
 
     public func markWatched(id: String) async throws(MediaBackendError) {