Merge branch 'feature/youtube-gast-zugang'

# Conflicts:
#	CHANGELOG.md
#	test/downloads/online_screen_test.dart

lib/services/baka_auth.dart

@@ -47,6 +47,7 @@ class BakaAuth extends ChangeNotifier {
 
   String? _token;
   String _benutzer = '';
+  int? _verbleibend;
 
   /// Laufender Login-Versuch aus [autoAnmelden] — solange er offen ist,
   /// hängt sich ein überlappender Aufruf daran statt einen zweiten
@@ -61,6 +62,11 @@ class BakaAuth extends ChangeNotifier {
   bool get istAngemeldet => _token != null && _token!.isNotEmpty;
   String get benutzer => _benutzer;
 
+  /// Zuletzt vom Server gemeldeter Kontingent-Stand (100/Tag) — nur fürs
+  /// Anzeigen, die Wahrheit bleibt beim Server. `null` vor dem ersten
+  /// Download in dieser Session.
+  int? get verbleibend => _verbleibend;
+
   /// Header für Anfragen an den Proxy. Ohne Anmeldung ohne `Authorization`.
   Map<String, String> get authHeader => {
         if (istAngemeldet) 'Authorization': 'Bearer $_token',
@@ -131,9 +137,16 @@ class BakaAuth extends ChangeNotifier {
     }
   }
 
+  /// Übernimmt den zuletzt vom Server gemeldeten Kontingent-Stand.
+  void merkeVerbleibend(int n) {
+    _verbleibend = n;
+    notifyListeners();
+  }
+
   Future<void> abmelden() async {
     _token = null;
     _benutzer = '';
+    _verbleibend = null;
     await _speicher.loeschen(_tokenKey);
     await _speicher.loeschen(_userKey);
     notifyListeners();

lib/services/gast_zugang.dart

@@ -0,0 +1,93 @@
+import 'dart:convert';
+
+import 'package:flutter/foundation.dart';
+import 'package:http/http.dart' as http;
+
+import 'baka_auth.dart' show TokenSpeicher, SicherenSpeicher;
+import 'yt_download_service.dart';
+
+/// Anonymer Gast-Zugang zum YouTube-Proxy: kein Passwort, aber mit
+/// serverseitig durchgesetztem Tages-Limit (der Proxy zählt und meldet den
+/// Stand über `guest_remaining` in der yt-dl-Antwort zurück). Ergänzt
+/// [BakaAuth]/`baka_auth.dart`, ersetzt es nicht.
+class GastZugang extends ChangeNotifier {
+  GastZugang({http.Client? client, TokenSpeicher? speicher})
+      : _client = client ?? http.Client(),
+        _speicher = speicher ?? const SicherenSpeicher();
+
+  static const proxyUrl = YtDownloadService.proxyUrl;
+  static const _tokenKey = 'guest_token';
+
+  final http.Client _client;
+  final TokenSpeicher _speicher;
+
+  String? _token;
+  int? _verbleibend;
+
+  bool get hatToken => _token != null && _token!.isNotEmpty;
+
+  /// Zuletzt vom Server gemeldeter Kontingent-Stand — nur fürs Anzeigen,
+  /// die Wahrheit bleibt beim Server. `null` vor dem ersten Download.
+  int? get verbleibend => _verbleibend;
+
+  /// Header für Anfragen an den Proxy. Ohne Token leer.
+  Map<String, String> get gastHeader =>
+      {if (hatToken) 'X-Guest-Token': _token!};
+
+  /// Stellt einen früher geholten Gast-Token wieder her (App-Start).
+  Future<void> laden() async {
+    _token = await _speicher.lesen(_tokenKey);
+    notifyListeners();
+  }
+
+  /// Holt einen neuen Gast-Token vom Proxy. Gibt `null` bei Erfolg zurück,
+  /// sonst den Fehlertext.
+  Future<String?> holeToken() async {
+    final http.Response antwort;
+    try {
+      antwort = await _client
+          .post(Uri.parse('$proxyUrl/api/guest-token'))
+          .timeout(const Duration(seconds: 15));
+    } catch (e) {
+      debugPrint('Gast-Token nicht erreichbar: $e');
+      return 'Proxy nicht erreichbar';
+    }
+
+    if (antwort.statusCode != 200) {
+      return 'Gast-Zugang fehlgeschlagen (${antwort.statusCode})';
+    }
+
+    Map<String, dynamic> daten;
+    try {
+      daten = jsonDecode(antwort.body) as Map<String, dynamic>;
+    } catch (_) {
+      return 'Proxy antwortet unverständlich (${antwort.statusCode})';
+    }
+
+    final token = daten['guest_token'] as String?;
+    if (token == null || token.isEmpty) {
+      return 'Proxy hat keinen Gast-Token geliefert';
+    }
+    _token = token;
+    await _speicher.schreiben(_tokenKey, token);
+    notifyListeners();
+    return null;
+  }
+
+  /// Übernimmt den zuletzt vom Server gemeldeten Kontingent-Stand.
+  void merkeVerbleibend(int n) {
+    _verbleibend = n;
+    notifyListeners();
+  }
+
+  /// Verwirft den Gast-Zugang wieder — nötig, damit ein Gast doch noch zum
+  /// Baka-Konto wechseln kann. Ohne das wäre `_AnmeldeDialog` (der einzige
+  /// Einstieg in der App für Baka-Login, auch für den Melo-Cloud-Sync)
+  /// dauerhaft unerreichbar, sobald einmal ein Gast-Token besteht.
+  Future<void> verwerfen() async {
+    _token = null;
+    _verbleibend = null;
+    await _speicher.loeschen(_tokenKey);
+    notifyListeners();
+  }
+}

lib/services/yt_download_service.dart

@@ -6,6 +6,7 @@ import 'package:flutter/foundation.dart';
 import 'package:http/http.dart' as http;
 
 import 'baka_auth.dart';
+import 'gast_zugang.dart';
 
 /// Entfernt alles, was in einem Dateinamen Ärger macht.
 String sichererDateiname(String titel) =>
@@ -35,12 +36,13 @@ class YtErgebnis {
 /// Lädt Musik über den Baka-YouTube-Proxy herunter. Der Proxy erledigt die
 /// eigentliche Arbeit und liefert eine fertige MP3; die App speichert sie nur.
 class YtDownloadService extends ChangeNotifier {
-  YtDownloadService({required this.auth, http.Client? client})
+  YtDownloadService({required this.auth, this.gast, http.Client? client})
       : _client = client ?? http.Client();
 
   static const proxyUrl = 'https://yt.baka-net.de';
 
   final BakaAuth auth;
+  final GastZugang? gast;
   final http.Client _client;
 
   bool _laeuft = false;
@@ -95,7 +97,8 @@ class YtDownloadService extends ChangeNotifier {
     final abbruch = _abbruch = Completer<void>();
     notifyListeners();
 
-    if (!auth.istAngemeldet) {
+    final gastAktiv = !auth.istAngemeldet && (gast?.hatToken ?? false);
+    if (!auth.istAngemeldet && !gastAktiv) {
       _scheitere('Bitte zuerst beim Baka-Konto anmelden');
       return null;
     }
@@ -103,6 +106,7 @@ class YtDownloadService extends ChangeNotifier {
       _scheitere('Das ist keine YouTube-Adresse');
       return null;
     }
+    final zugangsHeader = gastAktiv ? gast!.gastHeader : auth.authHeader;
 
     // ─── 1/2: Proxy fragen — er lädt das Video und wandelt es um ───
     _melde('Proxy wird gefragt …');
@@ -113,7 +117,7 @@ class YtDownloadService extends ChangeNotifier {
             .post(
               Uri.parse('$proxyUrl/api/yt-dl'),
               headers: {
-                ...auth.authHeader,
+                ...zugangsHeader,
                 'Content-Type': 'application/json'
               },
               body: jsonEncode({'url': url, 'cookies': cookies}),
@@ -137,7 +141,10 @@ class YtDownloadService extends ChangeNotifier {
     }
 
     if (antwort.statusCode == 401) {
-      _scheitere('Anmeldung abgelaufen — bitte neu anmelden');
+      if (gastAktiv) unawaited(gast!.holeToken());
+      _scheitere(gastAktiv
+          ? 'Gast-Zugang abgelaufen — bitte erneut versuchen'
+          : 'Anmeldung abgelaufen — bitte neu anmelden');
       return null;
     }
     if (antwort.statusCode != 200) {
@@ -149,6 +156,14 @@ class YtDownloadService extends ChangeNotifier {
     final titel = daten['titel'] as String? ?? 'Unbekannt';
     final dauer = (daten['dauer'] as int?) ?? 0;
     final mp3Url = daten['mp3_url'] as String? ?? '/api/dl/audio.mp3';
+    final gastRest = daten['guest_remaining'] as int?;
+    if (gastAktiv && gastRest != null) {
+      gast!.merkeVerbleibend(gastRest);
+    }
+    final cloudRest = daten['cloud_remaining'] as int?;
+    if (!gastAktiv && cloudRest != null) {
+      auth.merkeVerbleibend(cloudRest);
+    }
 
     // ─── 2/2: fertige MP3 abholen und speichern ───
     _melde('Lade „$titel“ …');
@@ -161,7 +176,7 @@ class YtDownloadService extends ChangeNotifier {
     try {
       final mp3 = await _abbrechbar(
         _client
-            .get(Uri.parse('$proxyUrl$mp3Url'), headers: auth.authHeader)
+            .get(Uri.parse('$proxyUrl$mp3Url'), headers: zugangsHeader)
             .timeout(const Duration(seconds: 180)),
         abbruch,
       );

lib/services/yt_search_service.dart

@@ -5,6 +5,7 @@ import 'package:flutter/foundation.dart';
 import 'package:http/http.dart' as http;
 
 import 'baka_auth.dart';
+import 'gast_zugang.dart';
 import 'yt_download_service.dart';
 
 /// Ein Treffer der YouTube-Suche über den Baka-Proxy.
@@ -44,12 +45,13 @@ String? youtubeVideoId(String url) {
 /// Durchsucht YouTube über den Baka-Proxy (`/api/search`, yt-dlp-gestützt) —
 /// dieselbe Anmeldung wie [YtDownloadService].
 class YtSearchService extends ChangeNotifier {
-  YtSearchService({required this.auth, http.Client? client})
+  YtSearchService({required this.auth, this.gast, http.Client? client})
       : _client = client ?? http.Client();
 
   static const proxyUrl = YtDownloadService.proxyUrl;
 
   final BakaAuth auth;
+  final GastZugang? gast;
   final http.Client _client;
 
   bool _laeuft = false;
@@ -64,7 +66,8 @@ class YtSearchService extends ChangeNotifier {
     final q = query.trim();
     if (q.isEmpty) return;
 
-    if (!auth.istAngemeldet) {
+    final gastAktiv = !auth.istAngemeldet && (gast?.hatToken ?? false);
+    if (!auth.istAngemeldet && !gastAktiv) {
       _treffer = const [];
       _fehler = 'Bitte zuerst beim Baka-Konto anmelden';
       notifyListeners();
@@ -80,7 +83,7 @@ class YtSearchService extends ChangeNotifier {
     final http.Response antwort;
     try {
       antwort = await _client
-          .get(uri, headers: auth.authHeader)
+          .get(uri, headers: gastAktiv ? gast!.gastHeader : auth.authHeader)
           .timeout(const Duration(seconds: 20));
     } on TimeoutException {
       _scheitere('Die Suche braucht zu lange — bitte später erneut versuchen');
@@ -92,7 +95,10 @@ class YtSearchService extends ChangeNotifier {
     }
 
     if (antwort.statusCode == 401) {
-      _scheitere('Anmeldung abgelaufen — bitte neu anmelden');
+      if (gastAktiv) unawaited(gast!.holeToken());
+      _scheitere(gastAktiv
+          ? 'Gast-Zugang abgelaufen — bitte erneut versuchen'
+          : 'Anmeldung abgelaufen — bitte neu anmelden');
       return;
     }
     if (antwort.statusCode != 200) {