Files
Flaro/Packages/FlixyKit/Sources/MediaKit/MediaQuery.swift
T
ScarriffleandClaude Opus 5 effdcd4532 MediaBackend: der Vertrag, den Plex und Jellyfin beide erfüllen
Ein Protokoll für das, was jeder Server können muss — blättern, Bilder
liefern, Zustand melden. Bewusst schmal: alles, was nur einer kann,
steht nicht darin, sondern als abfragbare Fähigkeit. Ein gemeinsamer
Nenner, der alles umfasst, wäre keiner mehr.

Deshalb `BackendCapability`. Plex kennt keine Favoriten, Jellyfin keine
Plex-Empfänger — und eine Oberfläche, die Knöpfe für Dinge zeigt, die
der Server nicht kann, ist schlimmer als eine, die sie weglässt. Plex
meldet hier ausdrücklich keine Favoriten und wirft, wenn jemand es
trotzdem versucht; stillschweigend nichts zu tun wäre die schlechtere
Antwort.

`MediaQuery` ersetzt `LibraryQuery` nach oben hin. Deren Sortierwerte
waren Plex' Drahtformat („titleSort:asc"), was hieß: entweder lernt
Jellyfin Plex' Schreibweise, oder jede Ansicht muss wissen, mit wem sie
spricht.

`PlexBackend` ist eine Hülle, keine Umschreibung — die Endpunkte bleiben,
wo sie sind. Der Fehlerübersetzer nimmt den ungetypten Wurf, weil Swift
getippte Fehler durch eine Closure hindurch nicht ableiten kann; der
zweite `catch` ist dabei keine Zierde, sondern verhindert, dass ein
unerwarteter Fehler durchfällt und die Signatur zur Lüge macht.

Die App benutzt noch nichts davon.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-13 12:37:37 +02:00

62 lines
2.0 KiB
Swift

import Foundation
/// Wonach eine Mediathek durchsucht wird.
///
/// Gefiltert und sortiert wird **auf dem Server**. Alles hierher zu holen und
/// selbst zu sieben wäre bei einer Mediathek mit fünftausend Folgen
/// aussichtslos — und die Server können es ohnehin besser.
///
/// Die Sortierarten sind neutral benannt. Vorher standen hier Plex'
/// Drahtwerte (`"titleSort:asc"`), was bedeutete: entweder Jellyfin lernt
/// Plex' Schreibweise, oder jede Ansicht muss wissen, mit wem sie spricht.
public struct MediaQuery: Sendable, Equatable {
public enum Sort: String, Sendable, Equatable, CaseIterable {
case titleAscending, titleDescending
case recentlyAdded
case releaseDate
case rating
case lastPlayed
}
/// Wonach gefiltert werden kann.
public enum Field: String, Sendable, Equatable {
case genre, year, contentRating, resolution
}
public var sort: Sort
public var unwatchedOnly: Bool
public var favouritesOnly: Bool
public var genre: String?
public var year: Int?
public var contentRating: String?
public var resolution: String?
/// Freitextsuche innerhalb der Mediathek.
public var searchText: String?
public init(
sort: Sort = .titleAscending,
unwatchedOnly: Bool = false,
favouritesOnly: Bool = false,
genre: String? = nil,
year: Int? = nil,
contentRating: String? = nil,
resolution: String? = nil,
searchText: String? = nil
) {
self.sort = sort
self.unwatchedOnly = unwatchedOnly
self.favouritesOnly = favouritesOnly
self.genre = genre
self.year = year
self.contentRating = contentRating
self.resolution = resolution
self.searchText = searchText
}
/// Ob überhaupt eingeschränkt wird — steuert die Anzeige des Filterknopfs.
public var isFiltering: Bool {
unwatchedOnly || favouritesOnly || genre != nil || year != nil
|| contentRating != nil || resolution != nil
}
}