feat: add event-driven auto backup triggers after wallet changes

Fire a debounced auto-backup when a transaction note is saved or an address book contact is created, edited, or deleted.

closes #306

Author: sneurlax

lib/main.dart

@@ -498,6 +498,9 @@ class _MaterialAppWithThemeState extends ConsumerState<MaterialAppWithTheme>
           case BackupFrequencyType.afterClosingAWallet:
             // ignore this case here
             break;
+          case BackupFrequencyType.afterChanges:
+            // handled by note and address book edit events
+            break;
         }
       }
 

lib/pages/settings_views/global_settings_view/stack_backup_views/edit_auto_backup_view.dart

@@ -73,6 +73,7 @@ class _EditAutoBackupViewState extends ConsumerState<EditAutoBackupView> {
     BackupFrequencyType.everyTenMinutes,
     BackupFrequencyType.everyAppStart,
     BackupFrequencyType.afterClosingAWallet,
+    BackupFrequencyType.afterChanges,
   ];
 
   String passwordFeedback =
@@ -572,6 +573,9 @@ class _EditAutoBackupViewState extends ConsumerState<EditAutoBackupView> {
                       case BackupFrequencyType.afterClosingAWallet:
                         message = "After closing a cryptocurrency wallet";
                         break;
+                      case BackupFrequencyType.afterChanges:
+                        message = "After editing a note or contact";
+                        break;
                     }
 
                     return DropdownMenuItem(

lib/pages/settings_views/global_settings_view/stack_backup_views/sub_views/backup_frequency_type_select_sheet.dart

@@ -30,6 +30,8 @@ class BackupFrequencyTypeSelectSheet extends ConsumerWidget {
         return "Every app start";
       case BackupFrequencyType.afterClosingAWallet:
         return "After closing a cryptocurrency wallet";
+      case BackupFrequencyType.afterChanges:
+        return "After editing a note or contact";
     }
   }
 

lib/pages/wallet_view/transaction_views/edit_note_view.dart

@@ -13,6 +13,7 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
 
 import '../../../models/isar/models/transaction_note.dart';
 import '../../../providers/providers.dart';
+import '../../../services/auto_swb_service.dart';
 import '../../../themes/stack_colors.dart';
 import '../../../utilities/constants.dart';
 import '../../../utilities/text_styles.dart';
@@ -198,6 +199,10 @@ class _EditNoteViewState extends ConsumerState<EditNoteView> {
                                 ),
                           );
 
+                      AutoSWBService.requestBackupAfterChange(
+                        ref.read(prefsChangeNotifierProvider),
+                      );
+
                       if (mounted) {
                         Navigator.of(context).pop();
                       }
@@ -217,6 +222,11 @@ class _EditNoteViewState extends ConsumerState<EditNoteView> {
                                 value: _noteController.text,
                               ),
                         );
+
+                    AutoSWBService.requestBackupAfterChange(
+                      ref.read(prefsChangeNotifierProvider),
+                    );
+
                     if (mounted) {
                       Navigator.of(context).pop();
                     }

lib/pages_desktop_specific/settings/settings_menu/backup_and_restore/create_auto_backup.dart

@@ -86,6 +86,7 @@ class _CreateAutoBackup extends ConsumerState<CreateAutoBackup> {
     BackupFrequencyType.everyTenMinutes,
     BackupFrequencyType.everyAppStart,
     BackupFrequencyType.afterClosingAWallet,
+    BackupFrequencyType.afterChanges,
   ];
 
   Future<void> _enableAutoBackup() async {
@@ -616,6 +617,9 @@ class _CreateAutoBackup extends ConsumerState<CreateAutoBackup> {
                             case BackupFrequencyType.afterClosingAWallet:
                               message = "After closing a cryptocurrency wallet";
                               break;
+                            case BackupFrequencyType.afterChanges:
+                              message = "After editing a note or contact";
+                              break;
                           }
 
                           return DropdownMenuItem(

lib/providers/global/auto_swb_service_provider.dart

@@ -13,7 +13,11 @@ import 'secure_store_provider.dart';
 import '../../services/auto_swb_service.dart';
 
 final autoSWBServiceProvider = ChangeNotifierProvider<AutoSWBService>(
-  (ref) => AutoSWBService(
-    secureStorageInterface: ref.read(secureStoreProvider),
-  ),
+  (ref) {
+    final service = AutoSWBService(
+      secureStorageInterface: ref.read(secureStoreProvider),
+    );
+    AutoSWBService.instance = service;
+    return service;
+  },
 );

lib/services/address_book_service.dart

@@ -12,6 +12,8 @@ import 'package:flutter/cupertino.dart';
 import 'package:flutter/foundation.dart';
 import '../db/isar/main_db.dart';
 import '../models/isar/models/contact_entry.dart';
+import '../utilities/prefs.dart';
+import 'auto_swb_service.dart';
 
 class AddressBookService extends ChangeNotifier {
   ContactEntry getContactById(String id) {
@@ -66,6 +68,7 @@ class AddressBookService extends ChangeNotifier {
     } else {
       await MainDB.instance.putContactEntry(contactEntry: contact);
       notifyListeners();
+      AutoSWBService.requestBackupAfterChange(Prefs.instance);
       return true;
     }
   }
@@ -75,12 +78,14 @@ class AddressBookService extends ChangeNotifier {
     // over write the contact with edited version
     await MainDB.instance.putContactEntry(contactEntry: editedContact);
     notifyListeners();
+    AutoSWBService.requestBackupAfterChange(Prefs.instance);
     return true;
   }
 
   /// Remove address book contact entry from db if it exists
   Future<void> removeContact(String id) async {
     await MainDB.instance.deleteContactEntry(id: id);
     notifyListeners();
+    AutoSWBService.requestBackupAfterChange(Prefs.instance);
   }
 }

lib/services/auto_swb_service.dart

@@ -16,6 +16,7 @@ import 'package:flutter/foundation.dart';
 import 'package:tuple/tuple.dart';
 
 import '../pages/settings_views/global_settings_view/stack_backup_views/helpers/restore_create_backup.dart';
+import '../utilities/enums/backup_frequency_type.dart';
 import '../utilities/flutter_secure_storage_interface.dart';
 import '../utilities/fs.dart';
 import '../utilities/logger.dart';
@@ -24,7 +25,12 @@ import '../utilities/prefs.dart';
 enum AutoSWBStatus { idle, backingUp, error }
 
 class AutoSWBService extends ChangeNotifier {
+  /// Static instance reference set by the provider layer so that non-widget
+  /// code (e.g. `Wallet`) can request a backup without Riverpod access.
+  static AutoSWBService? instance;
+
   Timer? _timer;
+  Timer? _debounceTimer;
 
   AutoSWBStatus _status = AutoSWBStatus.idle;
   AutoSWBStatus get status => _status;
@@ -36,6 +42,36 @@ class AutoSWBService extends ChangeNotifier {
 
   AutoSWBService({required this.secureStorageInterface});
 
+  /// Convenience method to request a backup after an editable change such as
+  /// a transaction note or address book contact edit. Only triggers if
+  /// auto-backup is enabled and the frequency is set to
+  /// [BackupFrequencyType.afterChanges].
+  static void requestBackupAfterChange(Prefs prefs) {
+    if (instance == null) return;
+    if (!prefs.isAutoBackupEnabled) return;
+    if (prefs.backupFrequencyType != BackupFrequencyType.afterChanges) return;
+
+    Logging.instance.d(
+      "AutoSWBService.requestBackupAfterChange() triggered",
+    );
+    instance!.requestBackup();
+  }
+
+  /// Request a debounced backup. Multiple calls within [debounceDuration]
+  /// will be collapsed into a single backup. This prevents backup storms
+  /// during wallet sync or rapid changes.
+  void requestBackup({
+    Duration debounceDuration = const Duration(seconds: 5),
+  }) {
+    _debounceTimer?.cancel();
+    _debounceTimer = Timer(debounceDuration, () {
+      Logging.instance.d(
+        "AutoSWBService.requestBackup() debounce fired, running doBackup()",
+      );
+      doBackup();
+    });
+  }
+
   /// Attempt a backup.
   Future<void> doBackup() async {
     if (_status == AutoSWBStatus.backingUp) {
@@ -199,6 +235,8 @@ class AutoSWBService extends ChangeNotifier {
 
   @override
   void dispose() {
+    _debounceTimer?.cancel();
+    _debounceTimer = null;
     stopPeriodicBackupTimer(shouldNotifyListeners: false);
     super.dispose();
   }

lib/utilities/enums/backup_frequency_type.dart

@@ -12,4 +12,5 @@ enum BackupFrequencyType {
   everyTenMinutes,
   everyAppStart,
   afterClosingAWallet,
+  afterChanges,
 }

lib/utilities/format.dart

@@ -141,6 +141,8 @@ abstract class Format {
         return "Every app start";
       case BackupFrequencyType.afterClosingAWallet:
         return "After closing a cryptocurrency wallet";
+      case BackupFrequencyType.afterChanges:
+        return "After editing a note or contact";
     }
   }
 }