Files
plezy/lib/screens/profile/profile_switch_screen.dart
T
edde746 860ce1e11a feat(profiles): show the first linked connection's user picture
A local profile had no picture of its own and always fell back to
initials. It now borrows the user picture of the connection it was
linked to first — oldest Connection.createdAt, ties broken by
connection id, since the join table carries no creation time.

Jellyfin links resolve to /Users/{id}/Images/Primary, keyed by the
PrimaryImageTag now captured at authentication and refreshed from the
/Users/Me body checkHealth already fetches. That endpoint is anonymous
on every Jellyfin release, so the URL carries no api_key and the access
token stays out of the image cache key. Plex links resolve the Home
user the link points at against PlexHomeService's live cache, so no
account-level lookup is needed and the picture tracks Plex's own
refresh.

The picture is derived per snapshot and never written back onto a
Profile: ProfileDetailScreen upserts the model it holds, so a
persisted URL would go stale and outlive the connection it came from.
Plex Home profiles are untouched, including one whose Plex avatar is
unset — it keeps its initials rather than borrowing a lent connection's
picture.

close #1667
2026-08-04 02:22:44 +02:00

562 lines
21 KiB
Dart

import 'dart:async';
import 'package:flutter/material.dart';
import 'package:material_symbols_icons/symbols.dart';
import 'package:provider/provider.dart';
import '../../connection/connection_registry.dart';
import '../../focus/focusable_wrapper.dart';
import '../../i18n/strings.g.dart';
import '../../media/media_backend.dart';
import '../../mixins/mounted_set_state_mixin.dart';
import '../../profiles/active_profile_provider.dart';
import '../../profiles/plex_home_service.dart';
import '../../profiles/profile.dart';
import '../../profiles/profile_activation.dart';
import '../../profiles/profile_avatar.dart';
import '../../profiles/profile_connection.dart';
import '../../profiles/profile_connection_registry.dart';
import '../../profiles/profile_registry.dart';
import '../../profiles/profiles_view.dart';
import '../../services/app_exit_service.dart';
import '../../services/storage_service.dart';
import '../../theme/mono_tokens.dart';
import '../../widgets/app_icon.dart';
import '../../widgets/app_menu.dart';
import '../../widgets/backend_badge.dart';
import '../../widgets/focusable_popup_menu_button.dart';
import '../../widgets/focused_scroll_scaffold.dart';
import '../../widgets/profile_switching_overlay.dart';
import '../libraries/state_messages.dart';
import 'add_local_profile_screen.dart';
import 'profile_teardown.dart';
import 'profile_detail_screen.dart';
/// Flat picker showing every [Profile] in the system — Plex Home users
/// auto-surfaced from connected accounts, plus user-created locals.
///
/// Each tile shows avatar, name, an Active badge for the current profile,
/// and one backend chip per connection bound to the profile (parent Plex
/// account + any borrowed connections for Plex Home users).
class ProfileSwitchScreen extends StatefulWidget {
final bool requireSelection;
const ProfileSwitchScreen({super.key, this.requireSelection = false});
@override
State<ProfileSwitchScreen> createState() => _ProfileSwitchScreenState();
}
class _ProfileSwitchScreenState extends State<ProfileSwitchScreen> with MountedSetStateMixin {
bool _allowPop = false;
final Map<String, FocusNode> _profileFocusNodes = {};
final Map<String, FocusNode> _profileMenuFocusNodes = {};
final Map<String, GlobalKey<AppMenuButtonState<_TileAction>>> _profileMenuKeys = {};
bool _focusRequested = false;
bool _switching = false;
Stream<ProfilesView>? _viewStream;
StorageService? _viewStreamStorage;
StorageService? _storage;
Future<StorageService>? _storageFuture;
@override
void didChangeDependencies() {
super.didChangeDependencies();
_ensureViewStream();
if (_storage == null) {
unawaited(
(_storageFuture ??= StorageService.getInstance()).then((s) {
setStateIfMounted(() => _storage = s);
}),
);
}
}
void _ensureViewStream() {
if (_viewStream != null && identical(_viewStreamStorage, _storage)) return;
_viewStreamStorage = _storage;
_viewStream = watchProfilesView(
profiles: context.read<ProfileRegistry>(),
profileConnections: context.read<ProfileConnectionRegistry>(),
connections: context.read<ConnectionRegistry>(),
plexHome: context.read<PlexHomeService>(),
storage: _storage,
);
}
@override
void dispose() {
for (final node in _profileFocusNodes.values) {
node.dispose();
}
for (final node in _profileMenuFocusNodes.values) {
node.dispose();
}
super.dispose();
}
@override
Widget build(BuildContext context) {
_ensureViewStream();
return PopScope(
canPop: !widget.requireSelection || _allowPop,
onPopInvokedWithResult: (didPop, _) {
if (!didPop && widget.requireSelection) {
unawaited(AppExitService.requestExit());
}
},
child: StreamBuilder<ProfilesView>(
stream: _viewStream,
builder: (context, snapshot) {
// No initialData: rendering ProfilesView.empty while the first
// combine is in flight flashes the "No profiles available" error
// state on every open.
final loading = snapshot.data == null;
final view = snapshot.data ?? ProfilesView.empty;
_pruneProfileFocusResources(view.profiles.map((p) => p.id).toSet());
// `context.select` only rebuilds when `activeId` actually
// changes. `context.watch` would rebuild on every provider
// notification — combined with the stream, that doubles the
// build cost on each profile-switch.
final activeId = context.select<ActiveProfileProvider, String?>((p) => p.activeId);
return Stack(
children: [
FocusedScrollScaffold(
title: Text(t.screens.switchProfile),
automaticallyImplyLeading: !widget.requireSelection,
onBackPressed: widget.requireSelection ? () => unawaited(AppExitService.requestExit()) : null,
slivers: [
if (view.profiles.isEmpty)
SliverFillRemaining(
child: loading
? const Center(child: CircularProgressIndicator())
: EmptyStateWidget(
message: t.messages.noProfilesAvailable,
subtitle: t.messages.contactAdminForProfiles,
icon: Symbols.person_off_rounded,
),
)
else
..._buildSections(view, activeId),
SliverPadding(
padding: const EdgeInsets.fromLTRB(16, 8, 16, 24),
sliver: SliverToBoxAdapter(
child: FocusableWrapper(
disableScale: true,
borderRadius: 100,
useBackgroundFocus: true,
descendantsAreFocusable: false,
onSelect: _switching ? null : _addLocalProfile,
child: OutlinedButton.icon(
onPressed: _switching ? null : _addLocalProfile,
icon: const AppIcon(Symbols.person_add_rounded, fill: 1),
label: Text(t.profiles.addPlezyProfile),
),
),
),
),
],
),
if (_switching) const ProfileSwitchingOverlay(),
],
);
},
),
);
}
FocusNode _profileFocusNode(Profile profile) {
return _profileFocusNodes.putIfAbsent(profile.id, () => FocusNode(debugLabel: 'ProfileTile:${profile.id}'));
}
FocusNode _profileMenuFocusNode(Profile profile) {
return _profileMenuFocusNodes.putIfAbsent(profile.id, () => FocusNode(debugLabel: 'ProfileActions:${profile.id}'));
}
GlobalKey<AppMenuButtonState<_TileAction>> _profileMenuKey(Profile profile) {
return _profileMenuKeys.putIfAbsent(profile.id, () => GlobalKey<AppMenuButtonState<_TileAction>>());
}
void _pruneProfileFocusResources(Set<String> activeIds) {
// Runs during build (from the StreamBuilder). Detach the map entries
// synchronously so tiles never receive a stale node, but defer the
// actual dispose to after the frame: on TV the pruned tile's node is
// often the one holding primary focus (the profile just signed out /
// deleted), and disposing the focused node mid-build wedges the focus
// system on DPAD-only devices.
final removed = <FocusNode>[];
for (final id in _profileFocusNodes.keys.toList()) {
if (!activeIds.contains(id)) {
final node = _profileFocusNodes.remove(id);
if (node != null) removed.add(node);
}
}
for (final id in _profileMenuFocusNodes.keys.toList()) {
if (!activeIds.contains(id)) {
final node = _profileMenuFocusNodes.remove(id);
if (node != null) removed.add(node);
}
}
for (final id in _profileMenuKeys.keys.toList()) {
if (!activeIds.contains(id)) {
_profileMenuKeys.remove(id);
}
}
if (removed.isNotEmpty) {
WidgetsBinding.instance.addPostFrameCallback((_) {
for (final node in removed) {
node.dispose();
}
});
}
}
void _openProfileMenu(Profile profile) {
_profileMenuKeys[profile.id]?.currentState?.showButtonMenu();
}
List<Widget> _buildSections(ProfilesView view, String? activeId) {
return [_profileList(view.profiles, view, activeId, autofocusFirst: true)];
}
SliverList _profileList(List<Profile> profiles, ProfilesView view, String? activeId, {required bool autofocusFirst}) {
return SliverList(
delegate: SliverChildBuilderDelegate((context, index) {
final profile = profiles[index];
final isActive = profile.id == activeId;
final tokensRef = tokens(context);
final tileRadii = groupItemRadii(context, index, profiles.length);
final isFirstSelectable = autofocusFirst && index == 0;
final profileFocusNode = _profileFocusNode(profile);
final menuFocusNode = _profileMenuFocusNode(profile);
final menuKey = _profileMenuKey(profile);
// All tile actions are disabled while a switch is binding: the
// overlay's barrier blocks pointers but not DPAD key events, and a
// Manage/Delete flow racing the in-flight switch corrupts state
// (e.g. a delete confirmation left open when the switch settles).
final actionsEnabled = !widget.requireSelection && !_switching;
final onManage = actionsEnabled ? () => _manageProfile(profile) : null;
final onDelete = profile.isLocal && actionsEnabled ? () => _deleteProfile(profile) : null;
final onSignOut = profile.isPlexHome && profile.parentConnectionId != null && actionsEnabled
? () => _signOutPlexAccount(profile)
: null;
final hasMenu = onManage != null || onDelete != null || onSignOut != null;
if (isFirstSelectable && !_focusRequested) {
_focusRequested = true;
WidgetsBinding.instance.addPostFrameCallback((_) {
if (mounted) profileFocusNode.requestFocus();
});
}
return Padding(
padding: EdgeInsets.fromLTRB(16, index == 0 ? 4 : tokensRef.groupGap, 16, 0),
child: FocusableWrapper(
autofocus: isFirstSelectable,
focusNode: profileFocusNode,
disableScale: true,
borderRadii: tileRadii,
enableLongPress: hasMenu,
onLongPress: hasMenu ? () => _openProfileMenu(profile) : null,
onNavigateRight: hasMenu ? () => menuFocusNode.requestFocus() : null,
onSelect: _switching || (isActive && !widget.requireSelection) ? null : () => _switchTo(profile),
child: Card(
shape: RoundedRectangleBorder(borderRadius: tileRadii),
clipBehavior: Clip.antiAlias,
child: _ProfileTile(
borderRadius: tileRadii,
profile: profile,
avatarUrl: view.avatarUrlByProfile[profile.id],
isActive: isActive && !widget.requireSelection,
chips: _chipsFor(profile, view),
onTap: () => _switchTo(profile),
onLongPress: hasMenu ? () => _openProfileMenu(profile) : null,
// Manage available for any profile — adding/removing
// borrowed connections is supported on plex_home too. Delete
// stays local-only (Plex Home users are owned by Plex).
onManage: onManage,
onDelete: onDelete,
onSignOut: onSignOut,
menuFocusNode: menuFocusNode,
menuKey: menuKey,
onMenuNavigateLeft: () => profileFocusNode.requestFocus(),
),
),
),
);
}, childCount: profiles.length),
);
}
Future<void> _manageProfile(Profile profile) async {
await Navigator.of(context).push(MaterialPageRoute(builder: (_) => ProfileDetailScreen(profile: profile)));
}
/// Drop the parent Plex account [profile] hangs off — same effect as
/// "Forget account" elsewhere in Plex apps. The shared teardown flow
/// removes the account, its virtual Plex Home profiles, and their
/// borrowed connections, then routes to auth when nothing selectable
/// remains (#1423).
Future<void> _signOutPlexAccount(Profile profile) async {
final parentId = profile.parentConnectionId;
if (parentId == null) return;
await confirmAndSignOutPlexAccount(context, accountConnectionId: parentId);
}
Future<void> _deleteProfile(Profile profile) async {
await confirmAndDeleteProfile(
context,
profile: profile,
title: t.profiles.deleteThisProfileTitle,
message: t.profiles.deleteThisProfileMessage(displayName: profile.displayName),
);
}
List<_ChipData> _chipsFor(Profile profile, ProfilesView view) {
final chips = <_ChipData>[];
// Plex Home profiles implicitly own their parent Plex connection (no
// join-table row), so prepend it before any borrowed connections.
if (profile.isPlexHome) {
final parentId = profile.parentConnectionId;
if (parentId != null) {
final conn = view.connectionsById[parentId];
if (conn != null) chips.add(_ChipData(backend: conn.backend, label: conn.displayLabel));
}
}
final pcs = visibleProfileConnections(
profile,
view.connectionsByProfile[profile.id] ?? const <ProfileConnection>[],
);
for (final pc in pcs) {
final conn = view.connectionsById[pc.connectionId];
if (conn != null) chips.add(_ChipData(backend: conn.backend, label: conn.displayLabel));
}
return chips;
}
Future<void> _addLocalProfile() async {
await Navigator.of(context).push<bool>(MaterialPageRoute(builder: (_) => const AddLocalProfileScreen()));
}
Future<void> _switchTo(Profile profile) async {
if (_switching) return;
setState(() => _switching = true);
try {
final route = ModalRoute.of(context);
final navigator = Navigator.of(context, rootNavigator: true);
final switched = await switchProfileFromUi(context, profile);
if (!mounted || !switched) return;
if (widget.requireSelection) {
setState(() => _allowPop = true);
}
// Pop only when this screen is still the top route. A blind
// `navigator.pop(true)` after the unbounded switch-await pops
// whatever is topmost — it can dismiss a confirmation dialog WITH
// `true` (auto-confirming a delete) or close the wrong screen.
if (route != null && route.isCurrent) {
navigator.pop(true);
}
} finally {
setStateIfMounted(() => _switching = false);
}
}
}
class _ProfileTile extends StatelessWidget {
final Profile profile;
final String? avatarUrl;
final bool isActive;
final BorderRadius borderRadius;
final List<_ChipData> chips;
final VoidCallback onTap;
final VoidCallback? onLongPress;
final VoidCallback? onManage;
final VoidCallback? onDelete;
final VoidCallback? onSignOut;
final FocusNode menuFocusNode;
final GlobalKey<AppMenuButtonState<_TileAction>> menuKey;
final VoidCallback onMenuNavigateLeft;
const _ProfileTile({
required this.profile,
required this.avatarUrl,
required this.isActive,
required this.borderRadius,
required this.chips,
required this.onTap,
this.onLongPress,
this.onManage,
this.onDelete,
this.onSignOut,
required this.menuFocusNode,
required this.menuKey,
required this.onMenuNavigateLeft,
});
@override
Widget build(BuildContext context) {
final theme = Theme.of(context);
final hasMenu = onManage != null || onDelete != null || onSignOut != null;
return InkWell(
canRequestFocus: false,
onTap: isActive ? null : onTap,
onLongPress: onLongPress,
borderRadius: borderRadius,
child: Padding(
padding: const EdgeInsets.all(12),
child: Row(
children: [
ProfileAvatar(profile: profile, size: 44, avatarUrl: avatarUrl),
const SizedBox(width: 14),
Expanded(
child: Column(
crossAxisAlignment: .start,
mainAxisSize: .min,
children: [
Row(
children: [
Flexible(
child: Text(profile.displayName, style: theme.textTheme.titleMedium, overflow: .ellipsis),
),
if (isActive) ...[
const SizedBox(width: 8),
Container(
padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 2),
decoration: BoxDecoration(
color: theme.colorScheme.primaryContainer,
borderRadius: BorderRadius.circular(6),
),
child: Text(
t.profiles.active,
style: theme.textTheme.labelSmall?.copyWith(color: theme.colorScheme.onPrimaryContainer),
),
),
],
],
),
const SizedBox(height: 4),
_ConnectionChips(chips: chips),
],
),
),
if (hasMenu)
_ProfileActionsButton(
menuKey: menuKey,
focusNode: menuFocusNode,
onNavigateLeft: onMenuNavigateLeft,
onSelected: _handleAction,
actions: [
if (onManage != null) _TileAction.manage,
if (onDelete != null) _TileAction.delete,
if (onSignOut != null) _TileAction.signOut,
],
)
else if (!isActive)
const Padding(padding: .only(left: 8), child: AppIcon(Symbols.chevron_right_rounded, fill: 1)),
],
),
),
);
}
void _handleAction(_TileAction action) {
WidgetsBinding.instance.addPostFrameCallback((_) {
switch (action) {
case _TileAction.manage:
onManage?.call();
break;
case _TileAction.delete:
onDelete?.call();
break;
case _TileAction.signOut:
onSignOut?.call();
break;
}
});
}
}
class _ProfileActionsButton extends StatelessWidget {
final GlobalKey<AppMenuButtonState<_TileAction>> menuKey;
final FocusNode focusNode;
final VoidCallback onNavigateLeft;
final ValueChanged<_TileAction> onSelected;
final List<_TileAction> actions;
const _ProfileActionsButton({
required this.menuKey,
required this.focusNode,
required this.onNavigateLeft,
required this.onSelected,
required this.actions,
});
@override
Widget build(BuildContext context) {
return FocusablePopupMenuButton<_TileAction>(
menuKey: menuKey,
focusNode: focusNode,
semanticLabel: t.profiles.manage,
onNavigateLeft: onNavigateLeft,
icon: const AppIcon(Symbols.more_vert_rounded, fill: 1),
tooltip: t.profiles.manage,
onSelected: onSelected,
itemBuilder: (_) => [for (final action in actions) AppMenuItem(value: action, label: action.label)],
);
}
}
extension _TileActionLabel on _TileAction {
String get label {
return switch (this) {
_TileAction.manage => t.profiles.manage,
_TileAction.delete => t.profiles.delete,
_TileAction.signOut => t.profiles.signOut,
};
}
}
enum _TileAction { manage, delete, signOut }
class _ConnectionChips extends StatelessWidget {
final List<_ChipData> chips;
const _ConnectionChips({required this.chips});
@override
Widget build(BuildContext context) {
final theme = Theme.of(context);
if (chips.isEmpty) {
return Text(t.profiles.noConnections, style: theme.textTheme.bodySmall?.copyWith(color: theme.colorScheme.error));
}
return Wrap(
spacing: 6,
runSpacing: 4,
children: [
for (final c in chips)
Container(
padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 3),
decoration: BoxDecoration(
color: theme.colorScheme.surfaceContainerHighest,
borderRadius: BorderRadius.circular(6),
),
child: Row(
mainAxisSize: .min,
children: [
BackendBadge(backend: c.backend, size: 12),
const SizedBox(width: 4),
Text(c.label, style: theme.textTheme.labelSmall),
],
),
),
],
);
}
}
class _ChipData {
final MediaBackend backend;
final String label;
const _ChipData({required this.backend, required this.label});
}