feat: message requests with accept or decline flow

doc/roadmap.txt

···
       - handle app crash during send (resume on restart)
 
 Phase 5: Message Requests and Accept Flow
-- [ ] MessageRequestCard widget:
+- [x] MessageRequestCard widget:
       - display sender profile (avatar, display name, handle)
       - message preview
       - accept and decline buttons
-- [ ] Accept flow:
+- [x] Accept flow:
       - call chat.bsky.convo.acceptConvo
       - move conversation to main list
       - enable sending messages
-- [ ] Decline flow:
+- [x] Decline flow:
       - hide conversation (client-side only)
       - user can still accept later
 

lib/src/features/dms/presentation/conversation_list_screen.dart

···
 import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:go_router/go_router.dart';
+import 'package:lazurite/src/features/dms/presentation/widgets/message_request_card.dart';
 
 import '../../../core/animations/animation_utils.dart';
 import '../../../core/widgets/empty_state.dart';
···
 
 class _ConversationListScreenState extends ConsumerState<ConversationListScreen> {
   final ScrollController _scrollController = ScrollController();
+  final Set<String> _declinedConvoIds = {};
 
   @override
   void initState() {
···
     }
   }
 
+  void _declineConversation(String convoId) {
+    setState(() {
+      _declinedConvoIds.add(convoId);
+    });
+    ScaffoldMessenger.of(context).showSnackBar(
+      SnackBar(
+        content: const Text('Message request declined'),
+        action: SnackBarAction(
+          label: 'Undo',
+          onPressed: () {
+            setState(() {
+              _declinedConvoIds.remove(convoId);
+            });
+          },
+        ),
+      ),
+    );
+  }
+
   @override
   Widget build(BuildContext context) {
     final state = ref.watch(conversationListProvider);
···
               );
             }
 
-            final requests = conversations.where((c) => !c.isAccepted).toList();
+            final requests = conversations
+                .where((c) => !c.isAccepted && !_declinedConvoIds.contains(c.convoId))
+                .toList();
             final active = conversations.where((c) => c.isAccepted).toList();
 
             return PullToRefreshWrapper(
···
                     SliverList(
                       delegate: SliverChildBuilderDelegate((context, index) {
                         final convo = requests[index];
-                        return ConversationListItem(
+                        return MessageRequestCard(
                           conversation: convo,
                           onTap: () => context.push('/messages/${convo.convoId}'),
+                          onAccept: () async {
+                            await ref
+                                .read(conversationListProvider.notifier)
+                                .acceptConversation(convo.convoId);
+                          },
+                          onDecline: () => _declineConversation(convo.convoId),
                         );
                       }, childCount: requests.length),
                     ),

lib/src/features/dms/presentation/widgets/message_request_card.dart

···
+import 'package:flutter/material.dart';
+
+import '../../../../core/utils/date_formatter.dart';
+import '../../../../core/widgets/avatar.dart';
+import '../../domain/dm_conversation.dart';
+
+/// A card widget for displaying a message request.
+///
+/// Shows the sender's profile, message preview, and accept/decline buttons
+/// for unaccepted conversation requests.
+class MessageRequestCard extends StatelessWidget {
+  const MessageRequestCard({
+    super.key,
+    required this.conversation,
+    required this.onAccept,
+    required this.onDecline,
+    this.onTap,
+  });
+
+  /// The conversation request to display.
+  final DmConversation conversation;
+
+  /// Called when the user accepts the request.
+  final VoidCallback onAccept;
+
+  /// Called when the user declines the request (client-side hide).
+  final VoidCallback onDecline;
+
+  /// Called when the user taps the card to view the conversation.
+  final VoidCallback? onTap;
+
+  @override
+  Widget build(BuildContext context) {
+    final theme = Theme.of(context);
+    final colorScheme = theme.colorScheme;
+    final otherParty = conversation.otherParty;
+    final lastMessageAt = conversation.lastMessageAt;
+
+    return Card(
+      margin: const EdgeInsets.symmetric(horizontal: 16, vertical: 8),
+      child: InkWell(
+        onTap: onTap,
+        borderRadius: BorderRadius.circular(12),
+        child: Padding(
+          padding: const EdgeInsets.all(16),
+          child: Column(
+            crossAxisAlignment: CrossAxisAlignment.start,
+            children: [
+              Row(
+                children: [
+                  Avatar(imageUrl: otherParty.avatar, radius: 24),
+                  const SizedBox(width: 12),
+                  Expanded(
+                    child: Column(
+                      crossAxisAlignment: CrossAxisAlignment.start,
+                      children: [
+                        Text(
+                          otherParty.displayName ?? otherParty.handle,
+                          style: theme.textTheme.titleMedium?.copyWith(
+                            fontWeight: FontWeight.bold,
+                          ),
+                          maxLines: 1,
+                          overflow: TextOverflow.ellipsis,
+                        ),
+                        const SizedBox(height: 2),
+                        Text(
+                          '@${otherParty.handle}',
+                          style: theme.textTheme.bodySmall?.copyWith(
+                            color: colorScheme.onSurfaceVariant,
+                          ),
+                          maxLines: 1,
+                          overflow: TextOverflow.ellipsis,
+                        ),
+                      ],
+                    ),
+                  ),
+                  if (lastMessageAt != null) ...[
+                    const SizedBox(width: 8),
+                    Text(
+                      DateFormatter.formatRelative(lastMessageAt),
+                      style: theme.textTheme.bodySmall?.copyWith(
+                        color: colorScheme.onSurfaceVariant,
+                      ),
+                    ),
+                  ],
+                ],
+              ),
+              const SizedBox(height: 12),
+              if (conversation.lastMessageText != null) ...[
+                Container(
+                  padding: const EdgeInsets.all(12),
+                  decoration: BoxDecoration(
+                    color: colorScheme.surfaceContainerHighest,
+                    borderRadius: BorderRadius.circular(8),
+                  ),
+                  child: Row(
+                    children: [
+                      Icon(
+                        Icons.chat_bubble_outline,
+                        size: 16,
+                        color: colorScheme.onSurfaceVariant,
+                      ),
+                      const SizedBox(width: 8),
+                      Expanded(
+                        child: Text(
+                          conversation.lastMessageText!,
+                          style: theme.textTheme.bodyMedium?.copyWith(
+                            color: colorScheme.onSurface,
+                          ),
+                          maxLines: 2,
+                          overflow: TextOverflow.ellipsis,
+                        ),
+                      ),
+                    ],
+                  ),
+                ),
+                const SizedBox(height: 16),
+              ],
+              Row(
+                children: [
+                  Expanded(
+                    child: OutlinedButton(
+                      onPressed: onDecline,
+                      style: OutlinedButton.styleFrom(
+                        foregroundColor: colorScheme.onSurfaceVariant,
+                      ),
+                      child: const Text('Decline'),
+                    ),
+                  ),
+                  const SizedBox(width: 12),
+                  Expanded(
+                    child: FilledButton(onPressed: onAccept, child: const Text('Accept')),
+                  ),
+                ],
+              ),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+}

lib/src/infrastructure/db/tables.dart

···
   ];
 }
 
-/// Stores local app settings as key-value pairs.
+/// Stores device-level app settings as key-value pairs.
 ///
-/// Used for theme mode, theme pack ID, font scale, and other user preferences.
+/// Used for theme mode, theme pack ID, font scale, and similar UI preferences.
+/// These settings are intentionally global (not scoped by ownerDid) because they
+/// represent device-level preferences that apply across all user accounts.
+///
+/// For example, if a user prefers dark mode or a specific font size, these
+/// settings persist when switching between accounts on the same device.
+///
 /// Key-value design allows adding new settings without schema migrations.
 class LocalSettings extends Table {
   /// Setting key (e.g., 'themeMode', 'themePackId').
···
   Set<Column> get primaryKey => {type, ownerDid};
 }
 
-/// Stores user-customized themes.
+/// Stores device-level custom theme definitions.
 ///
 /// Custom themes are based on a built-in theme pack with color role overrides.
+/// These themes are intentionally global (not scoped by ownerDid) as they
+/// represent device-level visual customizations that apply to all user accounts.
+///
+/// Users can create and share custom themes across their accounts on the device,
+/// providing a consistent visual experience regardless of which account is active.
+///
 /// The overrides and other data are stored as JSON for flexibility.
 class CustomThemes extends Table {
   /// Unique identifier for this custom theme.
···
   Set<Column> get primaryKey => {id};
 }
 
-/// Stores animation preferences for accessibility and motion control.
+/// Stores device-level animation preferences for accessibility and motion control.
+///
+/// These preferences are intentionally global (not scoped by ownerDid) because
+/// they reflect device-level accessibility needs that should apply consistently
+/// across all user accounts.
+/// For instance, if a user has motion sensitivity or
+/// prefers reduced animations, this preference should persist when switching
+/// between accounts on the same device.
 ///
 /// Uses key-value storage for flexibility, similar to LocalSettings.
 /// Keys: 'mode' (AnimationMode enum as string), 'speedMultiplier' (double as string).

test/src/features/dms/presentation/conversation_list_screen_test.dart

···
 import 'package:lazurite/src/features/dms/domain/dm_message.dart' as dmm;
 import 'package:lazurite/src/features/dms/presentation/conversation_list_screen.dart';
 import 'package:lazurite/src/features/dms/presentation/widgets/conversation_list_item.dart';
+import 'package:lazurite/src/features/dms/presentation/widgets/message_request_card.dart';
 import 'package:lazurite/src/features/dms/providers.dart';
 import 'package:lazurite/src/infrastructure/db/app_database.dart';
 import 'package:mocktail/mocktail.dart';
···
 
       expect(find.text('Message Requests'), findsOneWidget);
       expect(find.text('All Messages'), findsOneWidget);
-      expect(find.byType(ConversationListItem), findsNWidgets(2));
+      expect(find.byType(MessageRequestCard), findsOneWidget);
+      expect(find.byType(ConversationListItem), findsOneWidget);
     });
 
     testWidgets('triggers refresh on pull to refresh', (tester) async {

test/src/features/dms/presentation/widgets/message_request_card_test.dart

···
+import 'package:flutter/material.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:lazurite/src/features/dms/domain/dm_conversation.dart';
+import 'package:lazurite/src/features/dms/presentation/widgets/message_request_card.dart';
+import 'package:lazurite/src/infrastructure/db/app_database.dart';
+
+import '../../../../../helpers/pump_app.dart';
+
+void main() {
+  group('MessageRequestCard', () {
+    final now = DateTime.now();
+    const profile = Profile(
+      did: 'did:web:alice',
+      handle: 'alice.bsky.social',
+      displayName: 'Alice',
+    );
+    final conversation = DmConversation(
+      convoId: '123',
+      members: [profile],
+      lastMessageText: 'Hello, is this a scam?',
+      lastMessageAt: now,
+      unreadCount: 1,
+      isAccepted: false,
+      isMuted: false,
+    );
+
+    testWidgets('renders sender display name', (tester) async {
+      await tester.pumpApp(
+        Scaffold(
+          body: MessageRequestCard(conversation: conversation, onAccept: () {}, onDecline: () {}),
+        ),
+      );
+
+      expect(find.text('Alice'), findsOneWidget);
+    });
+
+    testWidgets('renders sender handle', (tester) async {
+      await tester.pumpApp(
+        Scaffold(
+          body: MessageRequestCard(conversation: conversation, onAccept: () {}, onDecline: () {}),
+        ),
+      );
+
+      expect(find.text('@alice.bsky.social'), findsOneWidget);
+    });
+
+    testWidgets('renders message preview', (tester) async {
+      await tester.pumpApp(
+        Scaffold(
+          body: MessageRequestCard(conversation: conversation, onAccept: () {}, onDecline: () {}),
+        ),
+      );
+
+      expect(find.text('Hello, is this a scam?'), findsOneWidget);
+    });
+
+    testWidgets('renders accept and decline buttons', (tester) async {
+      await tester.pumpApp(
+        Scaffold(
+          body: MessageRequestCard(conversation: conversation, onAccept: () {}, onDecline: () {}),
+        ),
+      );
+
+      expect(find.text('Accept'), findsOneWidget);
+      expect(find.text('Decline'), findsOneWidget);
+    });
+
+    testWidgets('calls onAccept when accept button tapped', (tester) async {
+      bool accepted = false;
+      await tester.pumpApp(
+        Scaffold(
+          body: MessageRequestCard(
+            conversation: conversation,
+            onAccept: () => accepted = true,
+            onDecline: () {},
+          ),
+        ),
+      );
+
+      await tester.tap(find.text('Accept'));
+      expect(accepted, isTrue);
+    });
+
+    testWidgets('calls onDecline when decline button tapped', (tester) async {
+      bool declined = false;
+      await tester.pumpApp(
+        Scaffold(
+          body: MessageRequestCard(
+            conversation: conversation,
+            onAccept: () {},
+            onDecline: () => declined = true,
+          ),
+        ),
+      );
+
+      await tester.tap(find.text('Decline'));
+      expect(declined, isTrue);
+    });
+
+    testWidgets('calls onTap when card is tapped', (tester) async {
+      bool tapped = false;
+      await tester.pumpApp(
+        Scaffold(
+          body: MessageRequestCard(
+            conversation: conversation,
+            onAccept: () {},
+            onDecline: () {},
+            onTap: () => tapped = true,
+          ),
+        ),
+      );
+
+      await tester.tap(find.text('Alice'));
+      expect(tapped, isTrue);
+    });
+
+    testWidgets('uses handle when display name is null', (tester) async {
+      const profileNoName = Profile(did: 'did:web:bob', handle: 'bob.bsky.social');
+      final convoNoName = conversation.copyWith(members: [profileNoName]);
+
+      await tester.pumpApp(
+        Scaffold(
+          body: MessageRequestCard(conversation: convoNoName, onAccept: () {}, onDecline: () {}),
+        ),
+      );
+
+      expect(find.text('bob.bsky.social'), findsOneWidget);
+      expect(find.text('@bob.bsky.social'), findsOneWidget);
+    });
+
+    testWidgets('does not render message preview when null', (tester) async {
+      final noMessage = DmConversation(
+        convoId: '456',
+        members: [profile],
+        lastMessageText: null,
+        lastMessageAt: now,
+        unreadCount: 0,
+        isAccepted: false,
+        isMuted: false,
+      );
+
+      await tester.pumpApp(
+        Scaffold(
+          body: MessageRequestCard(conversation: noMessage, onAccept: () {}, onDecline: () {}),
+        ),
+      );
+
+      expect(find.byIcon(Icons.chat_bubble_outline), findsNothing);
+    });
+  });
+}