feat(announcements): require app update after swap 418

Author: ethicnology

FEATURES.md

@@ -62,6 +62,7 @@ graph TB
     ADDRESS_MGMT --> LABELS
     ALL_SEED_VIEW --> APP_UNLOCK
     ANNOUNCEMENTS --> SETTINGS
+    ANNOUNCEMENTS --> SWAPS
     APP_STARTUP --> WALLETS
     BIP85 --> SECRETS
     BIP85 --> SETTINGS

lib/features/announcements/announcements_locator.dart

@@ -3,9 +3,11 @@ import 'package:bb_mobile/features/announcements/data/announcement_dismissal_rep
 import 'package:bb_mobile/features/announcements/data/datasources/announcement_dismissal_datasource.dart';
 import 'package:bb_mobile/features/announcements/domain/usecases/dismiss_announcement_usecase.dart';
 import 'package:bb_mobile/features/announcements/domain/usecases/get_visible_announcements_usecase.dart';
+import 'package:bb_mobile/features/announcements/domain/usecases/watch_app_update_announcement_usecase.dart';
 import 'package:bb_mobile/features/announcements/domain/repositories/announcement_dismissal_repository.dart';
 import 'package:bb_mobile/features/announcements/presentation/announcements_cubit.dart';
 import 'package:get_it/get_it.dart';
+import 'package:bb_mobile/features/swap/public/swap_facade.dart';
 
 class AnnouncementsLocator {
   static void setup(GetIt locator) {
@@ -22,9 +24,13 @@ class AnnouncementsLocator {
     // Use-cases
     locator.registerFactory<GetVisibleAnnouncementsUsecase>(
       () => GetVisibleAnnouncementsUsecase(
-        dismissalRepository: locator<AnnouncementDismissalRepository>(),
+        locator<AnnouncementDismissalRepository>(),
+        locator<SwapFacade>(),
       ),
     );
+    locator.registerFactory<WatchAppUpdateAnnouncementUsecase>(
+      () => WatchAppUpdateAnnouncementUsecase(locator<SwapFacade>()),
+    );
     locator.registerFactory<DismissAnnouncementUsecase>(
       () => DismissAnnouncementUsecase(
         dismissalRepository: locator<AnnouncementDismissalRepository>(),
@@ -37,6 +43,8 @@ class AnnouncementsLocator {
         getVisibleAnnouncementsUsecase:
             locator<GetVisibleAnnouncementsUsecase>(),
         dismissAnnouncementUsecase: locator<DismissAnnouncementUsecase>(),
+        watchAppUpdateAnnouncementUsecase:
+            locator<WatchAppUpdateAnnouncementUsecase>(),
       ),
     );
   }

lib/features/announcements/domain/entities/announcement.dart

@@ -14,7 +14,7 @@ enum AnnouncementId {
   /// Shown once the wallet has transaction history and payjoin is disabled,
   /// inviting the user to enable payjoin for better on-chain privacy.
   payjoinPrivacy,
-
+  appUpdateRequired,
 }
 
 /// Visual/semantic tone of an announcement, mapped to theme colors in the UI.
@@ -32,6 +32,10 @@ final class NavigateAction extends AnnouncementAction {
   const NavigateAction();
 }
 
+final class NoAction extends AnnouncementAction {
+  const NoAction();
+}
+
 /// How re-display works after the user dismisses an announcement.
 sealed class DismissPolicy {
   const DismissPolicy();

lib/features/announcements/domain/entities/announcement_catalog.dart

@@ -5,7 +5,9 @@ import 'package:bb_mobile/features/announcements/domain/entities/announcement.da
 /// Extend this (and the gathering in `GetVisibleAnnouncementsUsecase`) as new
 /// announcements need new signals.
 class AnnouncementSignals {
-  const AnnouncementSignals();
+  final bool isAppUpdateRequired;
+
+  const AnnouncementSignals({required this.isAppUpdateRequired});
 }
 
 /// A catalog entry: an [Announcement] definition paired with the predicate that
@@ -31,7 +33,15 @@ class AnnouncementCatalogEntry {
 /// entry here with its trigger, and add the title/description l10n mapping in
 /// `presentation/announcement_l10n.dart`.
 ///
-/// Currently EMPTY on purpose. The payjoin-privacy nudge was removed
-/// (product decision 2026-07-25): payjoin education lives in the enable-time
-/// disclaimer and the payjoin settings screen, not on home.
-final List<AnnouncementCatalogEntry> announcementCatalog = [];
+final List<AnnouncementCatalogEntry> announcementCatalog = [
+  AnnouncementCatalogEntry(
+    announcement: Announcement(
+      id: AnnouncementId.appUpdateRequired,
+      priority: 0,
+      tone: AnnouncementTone.warning,
+      action: const NoAction(),
+      dismissPolicy: SnoozeDismiss(const Duration(days: 1)),
+    ),
+    trigger: (signals) => signals.isAppUpdateRequired,
+  ),
+];

lib/features/announcements/domain/usecases/get_visible_announcements_usecase.dart

@@ -3,6 +3,7 @@ import 'package:bb_mobile/features/announcements/domain/announcements_failure.da
 import 'package:bb_mobile/features/announcements/domain/entities/announcement.dart';
 import 'package:bb_mobile/features/announcements/domain/entities/announcement_catalog.dart';
 import 'package:bb_mobile/features/announcements/domain/repositories/announcement_dismissal_repository.dart';
+import 'package:bb_mobile/features/swap/public/swap_facade.dart';
 
 /// Orchestrates which announcements are currently visible on the home carousel.
 ///
@@ -11,18 +12,19 @@ import 'package:bb_mobile/features/announcements/domain/repositories/announcemen
 /// dismissed (respecting the per-announcement dismiss policy), and returns
 /// the survivors ordered by ascending priority. All decision *rules* live on
 /// the entities / catalog; this use-case only wires signals to them. (The
-/// catalog is currently empty — see its doc comment — so this returns an
-/// empty list until a future announcement is added.)
 class GetVisibleAnnouncementsUsecase {
   final AnnouncementDismissalRepository _dismissalRepository;
+  final SwapFacade _swapFacade;
 
-  GetVisibleAnnouncementsUsecase({required this._dismissalRepository});
+  GetVisibleAnnouncementsUsecase(this._dismissalRepository, this._swapFacade);
 
   Future<Result<List<Announcement>, AnnouncementsFailure>> execute() async {
     try {
       final dismissals = await _dismissalRepository.getDismissals();
 
-      const signals = AnnouncementSignals();
+      final signals = AnnouncementSignals(
+        isAppUpdateRequired: _swapFacade.isAppUpdateRequired,
+      );
       final dismissedAtById = {for (final d in dismissals) d.id: d.dismissedAt};
       final now = DateTime.now().toUtc();
 

lib/features/announcements/domain/usecases/watch_app_update_announcement_usecase.dart

@@ -0,0 +1,9 @@
+import 'package:bb_mobile/features/swap/public/swap_facade.dart';
+
+class WatchAppUpdateAnnouncementUsecase {
+  final SwapFacade _swapFacade;
+
+  WatchAppUpdateAnnouncementUsecase(this._swapFacade);
+
+  Stream<bool> execute() => _swapFacade.watchAppUpdateRequired();
+}

lib/features/announcements/presentation/announcement_l10n.dart

@@ -9,9 +9,13 @@ import 'package:flutter/widgets.dart';
 extension AnnouncementL10n on Announcement {
   String title(BuildContext context) => switch (id) {
     AnnouncementId.payjoinPrivacy => context.loc.announcementPayjoinTitle,
+    AnnouncementId.appUpdateRequired =>
+      context.loc.announcementAppUpdateRequiredTitle,
   };
 
   String description(BuildContext context) => switch (id) {
     AnnouncementId.payjoinPrivacy => context.loc.announcementPayjoinDescription,
+    AnnouncementId.appUpdateRequired =>
+      context.loc.announcementAppUpdateRequiredDescription,
   };
 }

lib/features/announcements/presentation/announcements_cubit.dart

@@ -1,7 +1,10 @@
+import 'dart:async';
+
 import 'package:bb_mobile/features/announcements/domain/announcements_failure.dart';
 import 'package:bb_mobile/features/announcements/domain/usecases/dismiss_announcement_usecase.dart';
 import 'package:bb_mobile/features/announcements/domain/entities/announcement.dart';
 import 'package:bb_mobile/features/announcements/domain/usecases/get_visible_announcements_usecase.dart';
+import 'package:bb_mobile/features/announcements/domain/usecases/watch_app_update_announcement_usecase.dart';
 import 'package:flutter_bloc/flutter_bloc.dart';
 import 'package:freezed_annotation/freezed_annotation.dart';
 
@@ -17,15 +20,22 @@ part 'announcements_state.dart';
 class AnnouncementsCubit extends Cubit<AnnouncementsState> {
   final GetVisibleAnnouncementsUsecase _getVisibleAnnouncementsUsecase;
   final DismissAnnouncementUsecase _dismissAnnouncementUsecase;
+  late final StreamSubscription<bool> _appUpdateRequiredSubscription;
 
   bool _refreshing = false;
   bool _refreshQueued = false;
 
-  // No signal subscriptions: the catalog is currently empty.
   AnnouncementsCubit({
     required this._getVisibleAnnouncementsUsecase,
     required this._dismissAnnouncementUsecase,
-  }) : super(const AnnouncementsState());
+    required WatchAppUpdateAnnouncementUsecase
+    watchAppUpdateAnnouncementUsecase,
+  }) : super(const AnnouncementsState()) {
+    _appUpdateRequiredSubscription = watchAppUpdateAnnouncementUsecase
+        .execute()
+        .where((isRequired) => isRequired)
+        .listen((_) => unawaited(refresh()));
+  }
 
   /// (Re)loads the visible announcements. Called on mount and whenever a
   /// trigger signal changes.
@@ -65,4 +75,10 @@ class AnnouncementsCubit extends Cubit<AnnouncementsState> {
       (failure) async => emit(state.copyWith(failure: failure)),
     );
   }
+
+  @override
+  Future<void> close() async {
+    await _appUpdateRequiredSubscription.cancel();
+    return super.close();
+  }
 }

lib/features/announcements/ui/announcement_navigation.dart

@@ -9,5 +9,8 @@ import 'package:bb_mobile/features/settings/public/settings_facade.dart';
 extension AnnouncementNavigation on Announcement {
   SettingsRoute get route => switch (id) {
     AnnouncementId.payjoinPrivacy => SettingsRoute.payjoinSettings,
+    AnnouncementId.appUpdateRequired => throw UnsupportedError(
+      'The app update announcement does not navigate',
+    ),
   };
 }

lib/features/announcements/ui/widgets/announcement_carousel.dart

@@ -72,6 +72,7 @@ class _CarouselBodyState extends State<_CarouselBody> {
   /// card. Scales with the user's text size so larger accessibility settings
   /// never overflow.
   static const double _baseCardHeight = 90;
+  static const double _longCardHeight = 170;
 
   /// Extra height reserved for the page-indicator dots strip, only when more
   /// than one announcement is shown — reserving it for a single card renders
@@ -97,6 +98,8 @@ class _CarouselBodyState extends State<_CarouselBody> {
     switch (announcement.action) {
       case NavigateAction():
         context.pushNamed(announcement.route.name);
+      case NoAction():
+        break;
     }
   }
 
@@ -105,7 +108,9 @@ class _CarouselBodyState extends State<_CarouselBody> {
     final choice = await AnnouncementDismissDialog.show(context);
     switch (choice) {
       case AnnouncementDismissChoice.read:
-        if (mounted) _onTap(announcement);
+        if (mounted && announcement.action is NavigateAction) {
+          _onTap(announcement);
+        }
       case AnnouncementDismissChoice.dismiss:
         await cubit.dismiss(announcement.id);
       case null:
@@ -123,8 +128,14 @@ class _CarouselBodyState extends State<_CarouselBody> {
     // Adapt to the user's text-scale setting so the card grows with larger
     // accessibility font sizes instead of overflowing.
     final textScale = MediaQuery.textScalerOf(context).scale(1);
+    final baseHeight =
+        announcements.any(
+          (announcement) => announcement.id == AnnouncementId.appUpdateRequired,
+        )
+        ? _longCardHeight
+        : _baseCardHeight;
     final cardHeight =
-        (_baseCardHeight + (showDots ? _dotsStripHeight : 0)) * textScale;
+        (baseHeight + (showDots ? _dotsStripHeight : 0)) * textScale;
 
     return SizedBox(
       height: cardHeight,