Files
Flaro/Packages/FlixyKit/Sources/PlexKit/Client/PlexError.swift
T
GuidoandClaude Opus 5 1ed64bf166 Phase 0: Projektgerüst, Design-Tokens und Navigation
Legt das Fundament für den Plex-Client an:

- XcodeGen-Projekt nach dem Muster von Onyx (com.scarriffleservices,
  strict concurrency, Projektdatei nicht eingecheckt)
- FlixyKit mit vier Modulen: PlexKit, FlixyDesign, FlixyPlayback,
  FlixyDownloads. macOS steht als Plattform mit drin, damit die
  Logik-Tests ohne Simulator laufen.
- FlixyDesign: dunkle Farb-Tokens, Schriftskala, Poster- und
  Querformat-Kacheln, Aufmacher-Bild. Die Akzentfarbe fließt über die
  Umgebung und wird per WCAG-Rechnung lesbar gehalten.
- PlexKit: Kopfzeilen-Identität, Transport-Protokoll, Fehlerarten und
  die Medienmodelle samt nachsichtigem Decoder.
- FlixyPlayback: VideoPlayerEngine-Protokoll und PlaybackDecider — die
  eine Funktion, an der Phase 2 das Transcoding andockt.
- Ausfahrbare Seitenleiste auf dem iPhone, Split-View auf dem iPad.
- 45 Tests, alle grün.

VLCKit 4.0.0-a24 ist vorab geprüft: baut über SPM unter Swift 6 mit
strict concurrency. Die iOS-Slice ist mit 239 MB allerdings gewichtig,
deshalb bekommt sie in Phase 1 ein eigenes Target.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-11 16:04:40 +02:00

40 lines
1.7 KiB
Swift

import Foundation
/// Was beim Sprechen mit Plex schiefgehen kann.
///
/// Bewusst grob geschnitten: die Oberfläche muss unterscheiden können, ob sie
/// zur Anmeldung zurückschicken (`unauthorized`), einen Wiederholen-Knopf
/// zeigen (`transport`) oder einen Fehler melden soll. Feinere Abstufungen
/// hätten kein anderes Verhalten zur Folge.
public enum PlexError: Error, Sendable, Equatable {
/// Token fehlt oder wurde am Server zurückgezogen.
case unauthorized
/// Angefragte Ressource gibt es nicht — etwa ein gelöschter Titel.
case notFound
/// Der Server hat geantwortet, aber mit einem Fehlerstatus.
case server(status: Int)
/// Verbindung kam nicht zustande. Der Grund steht als Text drin, damit die
/// Fehlermeldung konkret werden kann statt „Etwas ist schiefgelaufen".
case transport(description: String)
/// Antwort kam an, ließ sich aber nicht lesen. Fast immer ein Zeichen
/// dafür, dass ein Feld in einer neueren Plex-Version anders heißt.
case decoding(description: String)
/// Es war kein Weg zum Server erreichbar — weder lokal noch über plex.tv.
case noReachableConnection
/// Ob ein erneuter Versuch überhaupt Aussicht auf Erfolg hat. Steuert, ob
/// die Oberfläche einen Wiederholen-Knopf anbietet.
public var isRetryable: Bool {
switch self {
case .transport, .noReachableConnection:
true
case .server(let status):
// 5xx ist ein Serverproblem und kann vorübergehen; 4xx liegt an
// der Anfrage und wird beim zweiten Mal genauso scheitern.
status >= 500
case .unauthorized, .notFound, .decoding:
false
}
}
}