plezy/test/services/jellyfin_auth_service_test.dart

import 'dart:async';
import 'dart:convert';

import 'package:fake_async/fake_async.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:http/http.dart' as http;
import 'package:http/testing.dart';
import 'package:plezy/connection/connection.dart';
import 'package:plezy/exceptions/media_server_exceptions.dart';
import 'package:plezy/services/jellyfin_auth_service.dart';
import 'package:plezy/services/jellyfin_endpoint_discovery.dart';
import 'package:plezy/utils/log_redaction_manager.dart';
import 'package:plezy/utils/media_server_timeouts.dart';

import '../test_helpers/backend_client_fixtures.dart';

/// Helpers for stubbing http responses keyed by request path.
typedef _Handler = FutureOr<http.Response> Function(http.BaseRequest req);

http.Response _ok(Object json) => http.Response(jsonEncode(json), 200, headers: {'content-type': 'application/json'});
http.Response _bareOk(String body) => http.Response(body, 200, headers: {'content-type': 'application/json'});
http.Response _status(int code, [Object? json]) =>
    http.Response(json == null ? '' : jsonEncode(json), code, headers: {'content-type': 'application/json'});

JellyfinConnection _existingConn({String accessToken = 'tok-old'}) => testJellyfinConnection(
  userName: 'edde',
  accessToken: accessToken,
  deviceId: 'dev-xyz',
  createdAt: DateTime.fromMillisecondsSinceEpoch(0),
);

JellyfinConnectionAuthService _service({required _Handler handler}) {
  return JellyfinConnectionAuthService(
    clientName: 'Plezy',
    clientVersion: 'test',
    deviceName: 'TestDevice',
    testHttpClientFactory: () => MockClient((req) async => handler(req)),
  );
}

Future<JellyfinConnection> _authenticateByNameWithUser(Map<String, Object?> user) {
  final svc = _service(
    handler: (req) {
      if (req.url.path == '/System/Info/Public') {
        return _ok({'Id': 'srv-1', 'ServerName': 'Home'});
      }
      if (req.url.path == '/Users/AuthenticateByName') {
        return _ok({'AccessToken': 'tok-new', 'User': user});
      }
      return _status(404);
    },
  );

  return svc.authenticateByName(
    baseUrl: 'https://jf.example.com',
    username: 'edde',
    password: 'pw',
    deviceId: 'dev-xyz',
  );
}

Future<Object> _captureError(Future<dynamic> future) async {
  try {
    await future;
  } catch (error) {
    return error;
  }
  throw StateError('Expected future to fail');
}

const _serverInfo = JellyfinServerInfo(serverName: 'Home', machineId: 'srv-1', version: '10.9.0');

void main() {
  setUp(LogRedactionManager.clearTrackedValues);
  tearDown(LogRedactionManager.clearTrackedValues);

  group('JellyfinConnectionAuthService.probe', () {
    test('returns server info on a well-formed /System/Info/Public response', () async {
      final svc = _service(
        handler: (req) {
          expect(req.url.path, '/System/Info/Public');
          expect(req.method, 'GET');
          return _ok({'Id': 'srv-1', 'ServerName': 'Home', 'Version': '10.9.0'});
        },
      );

      final info = await svc.probe('https://jf.example.com/');
      expect(info.serverName, 'Home');
      expect(info.machineId, 'srv-1');
      expect(info.version, '10.9.0');
    });

    test('falls back to LocalAddress when ServerName is absent', () async {
      final svc = _service(handler: (_) => _ok({'Id': 'srv-1', 'LocalAddress': 'http://192.168.1.10:8096'}));
      final info = await svc.probe('https://jf.example.com');
      expect(info.serverName, 'http://192.168.1.10:8096');
    });

    test('throws MediaServerUrlException when payload is not JSON', () async {
      final svc = _service(handler: (_) => http.Response('plain text', 200));
      await expectLater(svc.probe('https://jf.example.com'), throwsA(isA<MediaServerUrlException>()));
    });

    test('throws MediaServerUrlException when payload is missing Id/ServerName', () async {
      final svc = _service(handler: (_) => _ok({'Version': '10.9.0'}));
      await expectLater(svc.probe('https://jf.example.com'), throwsA(isA<MediaServerUrlException>()));
    });

    test('throws MediaServerUrlException on transport HTTP error', () async {
      final svc = _service(handler: (_) => _status(500, {'error': 'oops'}));
      await expectLater(svc.probe('https://jf.example.com'), throwsA(isA<MediaServerUrlException>()));
    });

    test('applies the shared jellyfinProbe timeout to the injected auth client', () {
      fakeAsync((async) {
        final response = Completer<http.Response>();
        final svc = _service(handler: (_) => response.future);
        Object? probeError;

        unawaited(_captureError(svc.probe('https://jf.example.com')).then((error) => probeError = error));
        async.flushMicrotasks();

        async.elapse(MediaServerTimeouts.jellyfinProbe - const Duration(milliseconds: 1));
        async.flushMicrotasks();
        expect(probeError, isNull);

        async.elapse(const Duration(milliseconds: 2));
        async.flushMicrotasks();
        expect(probeError, isA<MediaServerUrlException>());
      });
    });

    test('registers base URL redaction before the first probe request', () async {
      final svc = _service(
        handler: (req) {
          final redacted = LogRedactionManager.redact(req.url.toString());
          expect(redacted, isNot(contains('private-jellyfin.example.com')));
          return _ok({'Id': 'srv-1', 'ServerName': 'Home'});
        },
      );

      await svc.probe('https://private-jellyfin.example.com');
    });
  });

  group('JellyfinConnectionAuthService.authenticateByName', () {
    test('returns a JellyfinConnection on success', () async {
      final svc = _service(
        handler: (req) {
          if (req.url.path == '/System/Info/Public') {
            return _ok({'Id': 'srv-1', 'ServerName': 'Home', 'Version': '10.9.0'});
          }
          if (req.url.path == '/Users/AuthenticateByName') {
            expect(req.method, 'POST');
            return _ok({
              'AccessToken': 'tok-new',
              'User': {'Id': 'user-7', 'Name': 'edde'},
            });
          }
          return _status(404);
        },
      );

      final conn = await svc.authenticateByName(
        baseUrl: 'https://jf.example.com',
        baseUrls: const ['https://jf.example.com', 'https://jf.lan:8096'],
        username: 'edde',
        password: 'pw',
        deviceId: 'dev-xyz',
      );
      expect(conn.accessToken, 'tok-new');
      expect(conn.baseUrl, 'https://jf.example.com');
      expect(conn.baseUrls, ['https://jf.example.com', 'https://jf.lan:8096']);
      expect(conn.userId, 'user-7');
      expect(conn.userName, 'edde');
      expect(conn.serverMachineId, 'srv-1');
      // Composite id keeps multi-user-per-server unambiguous.
      expect(conn.id, 'srv-1/user-7');
    });

    test('captures the user primary image tag', () async {
      final conn = await _authenticateByNameWithUser({'Id': 'user-7', 'Name': 'edde', 'PrimaryImageTag': 'avatar-tag'});

      expect(conn.primaryImageTag, 'avatar-tag');
    });

    test('uses no primary image tag when Jellyfin omits the key', () async {
      final conn = await _authenticateByNameWithUser({'Id': 'user-7', 'Name': 'edde'});

      expect(conn.primaryImageTag, isNull);
    });

    test('uses no primary image tag when Jellyfin returns null', () async {
      final conn = await _authenticateByNameWithUser({'Id': 'user-7', 'Name': 'edde', 'PrimaryImageTag': null});

      expect(conn.primaryImageTag, isNull);
    });

    test('ignores empty and whitespace-only primary image tags', () async {
      for (final tag in ['', '   \t ']) {
        final conn = await _authenticateByNameWithUser({'Id': 'user-7', 'Name': 'edde', 'PrimaryImageTag': tag});

        expect(conn.primaryImageTag, isNull, reason: 'tag: "$tag"');
      }
    });

    test('a malformed primary image tag does not fail sign-in', () async {
      final cases = <(Object, String)>[
        (12345, '12345'),
        (['unexpected'], '[unexpected]'),
        ({'unexpected': 'tag'}, '{unexpected: tag}'),
      ];

      for (final (tag, expected) in cases) {
        final conn = await _authenticateByNameWithUser({'Id': 'user-7', 'Name': 'edde', 'PrimaryImageTag': tag});

        expect(conn, isA<JellyfinConnection>());
        expect(conn.primaryImageTag, expected, reason: 'tag: $tag');
      }
    });

    test('throws MediaServerAuthException on 401', () async {
      final svc = _service(
        handler: (req) {
          if (req.url.path == '/System/Info/Public') {
            return _ok({'Id': 'srv-1', 'ServerName': 'Home'});
          }
          return _status(401);
        },
      );

      await expectLater(
        svc.authenticateByName(
          baseUrl: 'https://jf.example.com',
          username: 'edde',
          password: 'wrong',
          deviceId: 'dev-xyz',
        ),
        throwsA(isA<MediaServerAuthException>()),
      );
    });

    test('throws MediaServerAuthException on malformed JSON 401', () async {
      final svc = _service(
        handler: (req) {
          if (req.url.path == '/System/Info/Public') {
            return _ok({'Id': 'srv-1', 'ServerName': 'Home'});
          }
          return http.Response('{bad json', 401, headers: {'content-type': 'application/json'});
        },
      );

      await expectLater(
        svc.authenticateByName(
          baseUrl: 'https://jf.example.com',
          username: 'edde',
          password: 'wrong',
          deviceId: 'dev-xyz',
        ),
        throwsA(isA<MediaServerAuthException>().having((e) => e.statusCode, 'statusCode', 401)),
      );
    });

    test('throws MediaServerAuthException when AccessToken is missing', () async {
      final svc = _service(
        handler: (req) {
          if (req.url.path == '/System/Info/Public') {
            return _ok({'Id': 'srv-1', 'ServerName': 'Home'});
          }
          return _ok({
            'User': {'Id': 'user-7', 'Name': 'edde'},
          });
        },
      );

      await expectLater(
        svc.authenticateByName(
          baseUrl: 'https://jf.example.com',
          username: 'edde',
          password: 'pw',
          deviceId: 'dev-xyz',
        ),
        throwsA(isA<MediaServerAuthException>()),
      );
    });
  });

  group('JellyfinConnectionAuthService.isQuickConnectEnabled', () {
    test('returns true when the server replies with bare `true`', () async {
      final svc = _service(
        handler: (req) {
          expect(req.url.path, '/QuickConnect/Enabled');
          return _bareOk('true');
        },
      );
      expect(await svc.isQuickConnectEnabled('https://jf.example.com'), isTrue);
    });

    test('returns false when the server replies with bare `false`', () async {
      final svc = _service(handler: (_) => _bareOk('false'));
      expect(await svc.isQuickConnectEnabled('https://jf.example.com'), isFalse);
    });

    test('returns false on 404 (Jellyfin <10.7)', () async {
      final svc = _service(handler: (_) => _status(404));
      expect(await svc.isQuickConnectEnabled('https://jf.example.com'), isFalse);
    });

    test('returns false on transport error', () async {
      final svc = JellyfinConnectionAuthService(
        clientName: 'Plezy',
        clientVersion: 'test',
        deviceName: 'TestDevice',
        testHttpClientFactory: () => MockClient((_) async => throw http.ClientException('network down')),
      );
      expect(await svc.isQuickConnectEnabled('https://jf.example.com'), isFalse);
    });
  });

  group('JellyfinConnectionAuthService.initiateQuickConnect', () {
    test('returns code/secret on a successful GET', () async {
      final svc = _service(
        handler: (req) {
          expect(req.url.path, '/QuickConnect/Initiate');
          expect(req.method, 'GET');
          return _ok({'Code': 'ABCDE', 'Secret': 'sec-xyz'});
        },
      );

      final qc = await svc.initiateQuickConnect(baseUrl: 'https://jf.example.com', deviceId: 'dev-xyz');
      expect(qc.code, 'ABCDE');
      expect(qc.secret, 'sec-xyz');
    });

    test('falls back to POST on 405', () async {
      var sawGet = false;
      final svc = _service(
        handler: (req) {
          expect(req.url.path, '/QuickConnect/Initiate');
          if (req.method == 'GET') {
            sawGet = true;
            return _status(405);
          }
          expect(req.method, 'POST');
          return _ok({'Code': 'ABCDE', 'Secret': 'sec-xyz'});
        },
      );

      final qc = await svc.initiateQuickConnect(baseUrl: 'https://jf.example.com', deviceId: 'dev-xyz');
      expect(sawGet, isTrue);
      expect(qc.code, 'ABCDE');
    });

    test('throws MediaServerAuthException on 401/403', () async {
      final svc = _service(handler: (_) => _status(403));
      await expectLater(
        svc.initiateQuickConnect(baseUrl: 'https://jf.example.com', deviceId: 'dev-xyz'),
        throwsA(isA<MediaServerAuthException>()),
      );
    });

    test('throws MediaServerAuthException on malformed JSON 401', () async {
      final svc = _service(
        handler: (_) => http.Response('{bad json', 401, headers: {'content-type': 'application/json'}),
      );

      await expectLater(
        svc.initiateQuickConnect(baseUrl: 'https://jf.example.com', deviceId: 'dev-xyz'),
        throwsA(isA<MediaServerAuthException>().having((e) => e.statusCode, 'statusCode', 401)),
      );
    });
  });

  group('JellyfinConnectionAuthService.authenticateByQuickConnect', () {
    test('returns a JellyfinConnection after the user approves', () async {
      var pollCount = 0;
      final svc = _service(
        handler: (req) {
          if (req.url.path == '/System/Info/Public') {
            return _ok({'Id': 'srv-1', 'ServerName': 'Home'});
          }
          if (req.url.path == '/QuickConnect/Connect') {
            pollCount++;
            // Return Authenticated=true on second poll.
            return _ok({'Authenticated': pollCount >= 2});
          }
          if (req.url.path == '/Users/AuthenticateWithQuickConnect') {
            return _ok({
              'AccessToken': 'tok-qc',
              'User': {'Id': 'user-9', 'Name': 'edde'},
            });
          }
          return _status(404);
        },
      );

      final conn = await svc.authenticateByQuickConnect(
        baseUrl: 'https://jf.example.com',
        secret: 'sec',
        deviceId: 'dev-xyz',
        timeout: const Duration(seconds: 30),
      );
      expect(conn, isNotNull);
      expect(conn!.accessToken, 'tok-qc');
      expect(conn.userId, 'user-9');
    });

    test('captures the user primary image tag', () async {
      final svc = _service(
        handler: (req) {
          if (req.url.path == '/System/Info/Public') {
            return _ok({'Id': 'srv-1', 'ServerName': 'Home'});
          }
          if (req.url.path == '/QuickConnect/Connect') {
            return _ok({'Authenticated': true});
          }
          if (req.url.path == '/Users/AuthenticateWithQuickConnect') {
            return _ok({
              'AccessToken': 'tok-qc',
              'User': {'Id': 'user-9', 'Name': 'edde', 'PrimaryImageTag': 'quick-connect-avatar'},
            });
          }
          return _status(404);
        },
      );

      final conn = await svc.authenticateByQuickConnect(
        baseUrl: 'https://jf.example.com',
        secret: 'sec',
        deviceId: 'dev-xyz',
        timeout: const Duration(seconds: 30),
      );

      expect(conn, isNotNull);
      expect(conn!.primaryImageTag, 'quick-connect-avatar');
    });

    test('returns null when secret expires server-side (404 mid-poll)', () async {
      final svc = _service(
        handler: (req) {
          if (req.url.path == '/System/Info/Public') return _ok({'Id': 'srv-1', 'ServerName': 'Home'});
          if (req.url.path == '/QuickConnect/Connect') return _status(404);
          return _status(500);
        },
      );

      final conn = await svc.authenticateByQuickConnect(
        baseUrl: 'https://jf.example.com',
        secret: 'sec',
        deviceId: 'dev-xyz',
        timeout: const Duration(seconds: 5),
      );
      expect(conn, isNull);
    });

    test('returns null when malformed JSON 404 happens mid-poll', () async {
      final svc = _service(
        handler: (req) {
          if (req.url.path == '/System/Info/Public') return _ok({'Id': 'srv-1', 'ServerName': 'Home'});
          if (req.url.path == '/QuickConnect/Connect') {
            return http.Response('{bad json', 404, headers: {'content-type': 'application/json'});
          }
          return _status(500);
        },
      );

      final conn = await svc.authenticateByQuickConnect(
        baseUrl: 'https://jf.example.com',
        secret: 'sec',
        deviceId: 'dev-xyz',
        timeout: const Duration(seconds: 5),
      );
      expect(conn, isNull);
    });

    test('returns null when shouldCancel becomes true', () async {
      final svc = _service(
        handler: (req) {
          if (req.url.path == '/System/Info/Public') return _ok({'Id': 'srv-1', 'ServerName': 'Home'});
          return _ok({'Authenticated': false});
        },
      );

      final conn = await svc.authenticateByQuickConnect(
        baseUrl: 'https://jf.example.com',
        secret: 'sec',
        deviceId: 'dev-xyz',
        timeout: const Duration(seconds: 30),
        shouldCancel: () => true,
      );
      expect(conn, isNull);
    });

    test('throws MediaServerAuthException when poll returns 401', () async {
      final svc = _service(
        handler: (req) {
          if (req.url.path == '/System/Info/Public') return _ok({'Id': 'srv-1', 'ServerName': 'Home'});
          return _status(401);
        },
      );

      await expectLater(
        svc.authenticateByQuickConnect(
          baseUrl: 'https://jf.example.com',
          secret: 'sec',
          deviceId: 'dev-xyz',
          timeout: const Duration(seconds: 5),
        ),
        throwsA(isA<MediaServerAuthException>()),
      );
    });

    test('throws MediaServerAuthException when malformed JSON poll returns 401', () async {
      final svc = _service(
        handler: (req) {
          if (req.url.path == '/System/Info/Public') return _ok({'Id': 'srv-1', 'ServerName': 'Home'});
          return http.Response('{bad json', 401, headers: {'content-type': 'application/json'});
        },
      );

      await expectLater(
        svc.authenticateByQuickConnect(
          baseUrl: 'https://jf.example.com',
          secret: 'sec',
          deviceId: 'dev-xyz',
          timeout: const Duration(seconds: 5),
        ),
        throwsA(isA<MediaServerAuthException>().having((e) => e.statusCode, 'statusCode', 401)),
      );
    });

    test('throws MediaServerAuthException when exchange returns 400', () async {
      final svc = _service(
        handler: (req) {
          if (req.url.path == '/System/Info/Public') return _ok({'Id': 'srv-1', 'ServerName': 'Home'});
          if (req.url.path == '/QuickConnect/Connect') return _ok({'Authenticated': true});
          if (req.url.path == '/Users/AuthenticateWithQuickConnect') return _status(400);
          return _status(500);
        },
      );

      await expectLater(
        svc.authenticateByQuickConnect(
          baseUrl: 'https://jf.example.com',
          secret: 'sec',
          deviceId: 'dev-xyz',
          timeout: const Duration(seconds: 5),
        ),
        throwsA(isA<MediaServerAuthException>().having((e) => e.statusCode, 'statusCode', 400)),
      );
    });

    test('throws MediaServerAuthException when malformed JSON exchange returns 400', () async {
      final svc = _service(
        handler: (req) {
          if (req.url.path == '/System/Info/Public') return _ok({'Id': 'srv-1', 'ServerName': 'Home'});
          if (req.url.path == '/QuickConnect/Connect') return _ok({'Authenticated': true});
          if (req.url.path == '/Users/AuthenticateWithQuickConnect') {
            return http.Response('{bad json', 400, headers: {'content-type': 'application/json'});
          }
          return _status(500);
        },
      );

      await expectLater(
        svc.authenticateByQuickConnect(
          baseUrl: 'https://jf.example.com',
          secret: 'sec',
          deviceId: 'dev-xyz',
          timeout: const Duration(seconds: 5),
        ),
        throwsA(isA<MediaServerAuthException>().having((e) => e.statusCode, 'statusCode', 400)),
      );
    });
  });

  group('Jellyfin authentication response parity', () {
    test('password and Quick Connect exchange use the same timeout', () {
      fakeAsync((async) {
        final passwordResponse = Completer<http.Response>();
        final quickConnectResponse = Completer<http.Response>();
        final passwordService = _service(handler: (_) => passwordResponse.future);
        final quickConnectService = _service(
          handler: (req) {
            if (req.url.path == '/QuickConnect/Connect') return _ok({'Authenticated': true});
            return quickConnectResponse.future;
          },
        );

        Object? passwordError;
        Object? quickConnectError;
        unawaited(
          _captureError(
            passwordService.authenticateByName(
              baseUrl: 'https://jf.example.com',
              username: 'edde',
              password: 'pw',
              deviceId: 'dev-xyz',
              serverInfo: _serverInfo,
            ),
          ).then((error) => passwordError = error),
        );
        unawaited(
          _captureError(
            quickConnectService.authenticateByQuickConnect(
              baseUrl: 'https://jf.example.com',
              secret: 'sec',
              deviceId: 'dev-xyz',
              serverInfo: _serverInfo,
            ),
          ).then((error) => quickConnectError = error),
        );

        async.flushMicrotasks();
        expect(passwordError, isNull);
        expect(quickConnectError, isNull);

        async.elapse(MediaServerTimeouts.jellyfinProbe + const Duration(milliseconds: 1));
        async.flushMicrotasks();

        for (final error in [passwordError, quickConnectError]) {
          expect(
            error,
            isA<MediaServerHttpException>().having(
              (exception) => exception.type,
              'type',
              MediaServerHttpErrorType.connectionTimeout,
            ),
          );
        }
      });
    });

    test('password and Quick Connect exchange preserve non-auth HTTP errors', () async {
      final passwordService = _service(handler: (_) => _status(500));
      final quickConnectService = _service(
        handler: (req) => req.url.path == '/QuickConnect/Connect' ? _ok({'Authenticated': true}) : _status(500),
      );

      final errors = [
        await _captureError(
          passwordService.authenticateByName(
            baseUrl: 'https://jf.example.com',
            username: 'edde',
            password: 'pw',
            deviceId: 'dev-xyz',
            serverInfo: _serverInfo,
          ),
        ),
        await _captureError(
          quickConnectService.authenticateByQuickConnect(
            baseUrl: 'https://jf.example.com',
            secret: 'sec',
            deviceId: 'dev-xyz',
            serverInfo: _serverInfo,
          ),
        ),
      ];

      for (final error in errors) {
        expect(error, isA<MediaServerHttpException>().having((exception) => exception.statusCode, 'statusCode', 500));
      }
    });
  });

  group('JellyfinConnectionAuthService.validate', () {
    test('returns true when /Users/Me responds 200', () async {
      final svc = _service(
        handler: (req) {
          expect(req.url.path, '/Users/Me');
          return _ok({'Id': 'user-1'});
        },
      );

      expect(await svc.validate(_existingConn()), isTrue);
    });

    test('returns false on 401/403', () async {
      final svc = _service(handler: (_) => _status(401));
      expect(await svc.validate(_existingConn()), isFalse);
    });

    test('returns false for non-Jellyfin connections', () async {
      final svc = _service(handler: (_) => _ok({}));
      // Use a Plex connection placeholder (any non-Jellyfin Connection works).
      final notJellyfin = PlexAccountConnection(
        id: 'plex-1',
        accountToken: 'tok',
        clientIdentifier: 'cid',
        accountLabel: 'Plex',
        createdAt: DateTime.fromMillisecondsSinceEpoch(0),
      );
      expect(await svc.validate(notJellyfin), isFalse);
    });
  });

  group('JellyfinConnectionAuthService.refresh', () {
    test('returns connection with online status + lastAuthenticatedAt on success', () async {
      final svc = _service(handler: (_) => _ok({'Id': 'user-1'}));
      final refreshed = await svc.refresh(_existingConn());
      expect(refreshed, isA<JellyfinConnection>());
      expect((refreshed as JellyfinConnection).status, ConnectionStatus.online);
      expect(refreshed.lastAuthenticatedAt, isNotNull);
    });

    test('returns connection with authError status when validate fails', () async {
      final svc = _service(handler: (_) => _status(401));
      final refreshed = await svc.refresh(_existingConn());
      expect((refreshed as JellyfinConnection).status, ConnectionStatus.authError);
    });

    test('returns the same Connection unchanged for non-Jellyfin', () async {
      final svc = _service(handler: (_) => _ok({}));
      final plex = PlexAccountConnection(
        id: 'plex-1',
        accountToken: 'tok',
        clientIdentifier: 'cid',
        accountLabel: 'Plex',
        createdAt: DateTime.fromMillisecondsSinceEpoch(0),
      );
      expect(await svc.refresh(plex), same(plex));
    });
  });

  group('JellyfinConnectionAuthService.signOut', () {
    test('fires POST /Sessions/Logout against the right base URL', () async {
      var sawLogout = false;
      final svc = _service(
        handler: (req) {
          if (req.url.path == '/Sessions/Logout') {
            sawLogout = true;
            expect(req.method, 'POST');
            return _ok({});
          }
          return _status(404);
        },
      );

      await svc.signOut(_existingConn());
      expect(sawLogout, isTrue);
    });

    test('does not throw when the server fails (best-effort)', () async {
      final svc = _service(handler: (_) => _status(500));
      await svc.signOut(_existingConn()); // expect: no throw
    });

    test('is a no-op for non-Jellyfin connections', () async {
      var fired = false;
      final svc = _service(
        handler: (_) {
          fired = true;
          return _ok({});
        },
      );

      final plex = PlexAccountConnection(
        id: 'plex-1',
        accountToken: 'tok',
        clientIdentifier: 'cid',
        accountLabel: 'Plex',
        createdAt: DateTime.fromMillisecondsSinceEpoch(0),
      );
      await svc.signOut(plex);
      expect(fired, isFalse);
    });
  });

  group('Jellyfin authentication request identity', () {
    test('password login sends the complete MediaBrowser header', () async {
      late http.BaseRequest request;
      final svc = _service(
        handler: (captured) {
          request = captured;
          return _ok({
            'AccessToken': 'tok-new',
            'User': {'Id': 'user-7', 'Name': 'edde'},
          });
        },
      );

      await svc.authenticateByName(
        baseUrl: 'https://jf.example.com',
        username: 'edde',
        password: 'pw',
        deviceId: 'dev-xyz',
        serverInfo: _serverInfo,
      );

      expect(request.method, 'POST');
      expect(
        request.headers['authorization'],
        'MediaBrowser Client="Plezy", Device="TestDevice", DeviceId="dev-xyz", Version="test"',
      );
      expect(request.headers['content-type'], 'application/json');
    });

    test('Quick Connect sends the same complete MediaBrowser header', () async {
      late http.BaseRequest request;
      final svc = _service(
        handler: (captured) {
          request = captured;
          return _ok({'Code': 'ABCDE', 'Secret': 'sec-xyz'});
        },
      );

      await svc.initiateQuickConnect(baseUrl: 'https://jf.example.com', deviceId: 'dev-xyz');

      expect(request.method, 'GET');
      expect(
        request.headers['authorization'],
        'MediaBrowser Client="Plezy", Device="TestDevice", DeviceId="dev-xyz", Version="test"',
      );
    });

    test('rejects an empty device ID before sending a request', () async {
      var requests = 0;
      final svc = _service(
        handler: (_) {
          requests++;
          return _status(500);
        },
      );

      await expectLater(
        svc.authenticateByName(
          baseUrl: 'https://jf.example.com',
          username: 'edde',
          password: 'pw',
          deviceId: '',
          serverInfo: _serverInfo,
        ),
        throwsArgumentError,
      );
      expect(requests, 0);
    });
  });
}