Sanitize user facing error

assets/locales/en.po

@@ -1523,3 +1523,15 @@ msgstr "Got it"
 
 msgid "vpn_conflict_connect_anyway"
 msgstr "Connect Anyway"
+
+msgid "err_check_connection"
+msgstr "Unable to connect. Check your internet connection."
+
+msgid "err_service_unavailable"
+msgstr "Service temporarily unavailable. Trying again..."
+
+msgid "err_connection_failed"
+msgstr "Connection failed. Please try again."
+
+msgid "err_ruleset_failed"
+msgstr "Unable to load routing configuration. Retrying..."

lib/core/extensions/error.dart

@@ -78,18 +78,69 @@ extension ErrorExetension on Object {
       if (description.contains('Cannot use your own code for promotion')) {
         return "referral_code_own_invalid".i18n;
       }
-      return description;
+
+      final categoryKey = _classifyVpnError(description);
+      if (categoryKey != null) return categoryKey.i18n;
+
+      return "an_error_occurred".i18n;
     }
 
     if (this is StateError) {
-      return (this as StateError).message;
+      final categoryKey = _classifyVpnError((this as StateError).message);
+      if (categoryKey != null) return categoryKey.i18n;
+      return "an_error_occurred".i18n;
     }
     if (this is Exception) {
-      return (this as Exception).toString();
+      final categoryKey = _classifyVpnError((this as Exception).toString());
+      if (categoryKey != null) return categoryKey.i18n;
+      return "an_error_occurred".i18n;
     }
 
-    return "error_occurred".i18n;
+    return "an_error_occurred".i18n;
+  }
+}
+
+/// Classifies VPN-related errors into user-friendly
+/// categories based on regex patterns.
+final List<(RegExp, String)> _vpnErrorPatterns = [
+  (
+    RegExp(
+      r'no such host|dns|network is unreachable|i/o timeout|no route to host|connection refused',
+      caseSensitive: false,
+    ),
+    'err_check_connection',
+  ),
+  (
+    RegExp(r'\b503\b|service unavailable', caseSensitive: false),
+    'err_service_unavailable',
+  ),
+  (
+    RegExp(r'ruleset|geosite|geoip|smart routing', caseSensitive: false),
+    'err_ruleset_failed',
+  ),
+  (
+    RegExp(
+      r'tunnel|tun device|setup failed|failed to start vpn|libbox',
+      caseSensitive: false,
+    ),
+    'err_connection_failed',
+  ),
+];
+
+String? _classifyVpnError(String description) {
+  if (description.isEmpty) return null;
+  for (final (pattern, key) in _vpnErrorPatterns) {
+    if (pattern.hasMatch(description)) return key;
   }
+  return null;
+}
+
+/// Returns a localized user-facing message for a raw error string. Use this
+/// at boundaries where errors arrive as plain strings (e.g. FFI results)
+/// rather than as `Exception` instances, instead of wrapping them in
+/// `Exception(...)` just to route through `localizedDescription`.
+String localizeRawError(String rawError) {
+  return (_classifyVpnError(rawError) ?? 'an_error_occurred').i18n;
 }
 
 /// Strips the radiance IPC prefix from error messages.

lib/core/services/app_purchase.dart

@@ -309,15 +309,15 @@ class AppPurchase {
     final fetchResult = await lanternService.fetchUserData();
     final fetchedUser = fetchResult.fold((failure) {
       appLogger.warning(
-        '[AppPurchase] Failed to fetch latest user data for purchase check: ${failure.localizedErrorMessage}',
+        '[AppPurchase] Failed to fetch latest user data for purchase check: ${failure.error}',
       );
       return null;
     }, (user) => user);
 
     final user = fetchedUser ??
         (await lanternService.getUserData()).fold((failure) {
           appLogger.warning(
-            '[AppPurchase] Failed to load cached user data for purchase check: ${failure.localizedErrorMessage}',
+            '[AppPurchase] Failed to load cached user data for purchase check: ${failure.error}',
           );
           return null;
         }, (user) => user);

lib/features/account/account.dart

@@ -437,7 +437,7 @@ class Account extends HookConsumerWidget {
     result.fold(
       (l) {
         context.hideLoadingDialog();
-        appLogger.error('Logout error: ${l.localizedErrorMessage}');
+        appLogger.error('Logout error: ${l.error}');
         context.showSnackBar(l.localizedErrorMessage);
       },
       (user) {

lib/features/account/delete_account.dart

@@ -171,7 +171,7 @@ class _DeleteAccountState extends ConsumerState<DeleteAccount> {
     result.fold(
       (failure) {
         appLogger
-            .error('Account deletion failed: ${failure.localizedErrorMessage}');
+            .error('Account deletion failed: ${failure.error}');
         context.hideLoadingDialog();
         context.showSnackBarError(failure.localizedErrorMessage);
       },

lib/features/auth/choose_payment_method.dart

@@ -215,6 +215,7 @@ class ChoosePaymentMethod extends HookConsumerWidget {
           },
           onError: (error) {
             finishPaymentRedirect(paymentRedirectInFlight);
+
             ///error while subscribing
             appLogger.error('Error subscribing to plan: $error');
             if (error is StripeException) {
@@ -322,9 +323,7 @@ class ChoosePaymentMethod extends HookConsumerWidget {
       await result.fold<Future<void>>(
         (failure) async {
           context.hideLoadingDialog();
-          appLogger.error(
-            'Error redirecting to payment: ${failure.localizedErrorMessage}',
-          );
+          appLogger.error('Error redirecting to payment: ${failure.error}');
           context.showSnackBar(failure.localizedErrorMessage);
         },
         (url) async {

lib/features/auth/create_password.dart

@@ -104,7 +104,7 @@ class CreatePassword extends HookConsumerWidget {
       (failure) {
         context.hideLoadingDialog();
         appLogger.error(
-          'Failed to create password: ${failure.localizedErrorMessage}',
+          'Failed to create password: ${failure.error}',
         );
         context.showSnackBarError(failure.localizedErrorMessage);
       },

lib/features/home/provider/feature_flag_notifier.dart

@@ -20,7 +20,7 @@ class FeatureFlagNotifier extends _$FeatureFlagNotifier {
     result.fold(
       (failure) {
         appLogger.error(
-            'Error fetching feature flags: ${failure.localizedErrorMessage}');
+            'Error fetching feature flags: ${failure.error}');
       },
       (flags) {
         try {

lib/features/home/provider/home_notifier.dart

@@ -20,7 +20,7 @@ class HomeNotifier extends _$HomeNotifier {
     return result.fold(
       (failure) {
         appLogger.error(
-          'Error getting user data: ${failure.localizedErrorMessage}',
+          'Error getting user data: ${failure.error}',
         );
         throw Exception('Failed to get user data');
       },
@@ -38,7 +38,7 @@ class HomeNotifier extends _$HomeNotifier {
     result.fold(
       (failure) {
         appLogger.error(
-          'Error fetching user data: ${failure.localizedErrorMessage}',
+          'Error fetching user data: ${failure.error}',
         );
       },
       (userData) {
@@ -56,7 +56,7 @@ class HomeNotifier extends _$HomeNotifier {
     result.fold(
       (failure) {
         appLogger.error(
-          'Error refreshing user data: ${failure.localizedErrorMessage}',
+          'Error refreshing user data: ${failure.error}',
         );
         state = AsyncValue.error(failure, StackTrace.current);
       },

lib/features/language/language.dart

@@ -104,7 +104,7 @@ class LanguageListView extends HookConsumerWidget {
       either.fold(
         (failure) {
           appLogger
-              .error('Error updating locale: ${failure.localizedErrorMessage}');
+              .error('Error updating locale: ${failure.error}');
         },
         (r) {
           appLogger.debug('Locale updated to: $newLocale');

lib/features/macos_extension/macos_extension_dialog.dart

@@ -141,7 +141,7 @@ class _MacOSExtensionDialogState extends ConsumerState<MacOSExtensionDialog> {
 
     result.fold(
       (failure) {
-        appLogger.error("Failure: ${failure.localizedErrorMessage}");
+        appLogger.error("Failure: ${failure.error}");
         AppDialog.errorDialog(
           context: context,
           title: 'error'.i18n,

lib/features/plans/provider/plans_notifier.dart

@@ -93,7 +93,6 @@ class PlansNotifier extends _$PlansNotifier {
   }
 
   void setSelectedPlan(Plan plan) {
-    appLogger.info('[PlansNotifier] setSelectedPlan: ${plan.id}');
     userSelectedPlan = plan;
   }
 

lib/features/private_server/manually_server_setup.dart

@@ -181,7 +181,7 @@ class _ManuallyServerSetupState extends ConsumerState<ManuallyServerSetup> {
     result.fold(
       (failure) {
         appLogger
-            .error("Failed to add server: ${failure.localizedErrorMessage}");
+            .error("Failed to add server: ${failure.error}");
         context.hideLoadingDialog();
         context.showSnackBar(failure.localizedErrorMessage);
       },

lib/features/private_server/private_server_deploy.dart

@@ -179,7 +179,7 @@ class _PrivateServerDeployState extends ConsumerState<PrivateServerDeploy> {
         context.hideLoadingDialog();
         // Handle failure case, e.g., show an error message
         appLogger
-            .error("Failed to cancel deployment: ${l.localizedErrorMessage}");
+            .error("Failed to cancel deployment: ${l.error}");
         context.showSnackBar(l.localizedErrorMessage);
       },
       (r) {

lib/features/system_tray/provider/system_tray_notifier.dart

@@ -128,7 +128,7 @@ class SystemTrayNotifier extends _$SystemTrayNotifier with TrayListener {
         .connectToServer(ServerLocationType.lanternLocation, server.tag);
     result.fold(
       (failure) => appLogger.error(
-        'Failed to connect: ${failure.localizedErrorMessage}',
+        'Failed to connect: ${failure.error}',
       ),
       (success) {
         appLogger.info('Connecting to ${server.location.country} - ${server.location.city}');

lib/features/vpn/provider/available_servers_notifier.dart

@@ -16,7 +16,7 @@ class AvailableServersNotifier extends _$AvailableServersNotifier {
     return result.fold(
       (failure) {
         appLogger.error(
-          'Error getting available servers: ${failure.localizedErrorMessage}',
+          'Error getting available servers: ${failure.error}',
         );
         throw Exception('Failed to load available servers');
       },
@@ -40,7 +40,7 @@ class AvailableServersNotifier extends _$AvailableServersNotifier {
     result.fold(
       (failure) {
         appLogger.error(
-          'Error getting available servers: ${failure.localizedErrorMessage}',
+          'Error getting available servers: ${failure.error}',
         );
       },
       (servers) {

lib/features/vpn/server_selection.dart

@@ -239,7 +239,7 @@ class _ServerSelectionState extends ConsumerState<ServerSelection> {
               retryResult.fold((failure) {
                 context.showSnackBar(failure.localizedErrorMessage);
                 appLogger.error(
-                  "Error changing VPN state: ${failure.localizedErrorMessage}",
+                  "Error changing VPN state: ${failure.error}",
                 );
               }, (_) => appRouter.popUntilRoot());
             },

lib/features/vpn/vpn_switch.dart

@@ -113,7 +113,7 @@ class VPNSwitch extends HookConsumerWidget {
                 (failure) {
                   context.showSnackBar(failure.localizedErrorMessage);
                   appLogger.error(
-                      "Error changing VPN state: ${failure.localizedErrorMessage}");
+                      "Error changing VPN state: ${failure.error}");
                 },
                 (_) => null,
               );
@@ -122,7 +122,7 @@ class VPNSwitch extends HookConsumerWidget {
         } else {
           context.showSnackBar(failure.localizedErrorMessage);
           appLogger.error(
-              "Error changing VPN state: ${failure.localizedErrorMessage}");
+              "Error changing VPN state: ${failure.error}");
         }
       },
       (_) => null,

lib/lantern/lantern_ffi_service.dart

@@ -523,7 +523,12 @@ class LanternFFIService implements LanternCoreService {
         // Not JSON — fall through with the raw string.
       }
       appLogger.error('$action split tunnel error: $errMsg');
-      return left(Failure(error: errMsg, localizedErrorMessage: errMsg));
+      return left(
+        Failure(
+          error: errMsg,
+          localizedErrorMessage: localizeRawError(errMsg),
+        ),
+      );
     } catch (e) {
       return left(
         Failure(
@@ -589,7 +594,13 @@ class LanternFFIService implements LanternCoreService {
         }
       });
       if (result.isNotEmpty && !_ffiOkResults.contains(result)) {
-        return left(Failure(error: result, localizedErrorMessage: result));
+        appLogger.error('startVPN error: $result');
+        return left(
+          Failure(
+            error: result,
+            localizedErrorMessage: localizeRawError(result),
+          ),
+        );
       }
       appLogger.debug('startVPN result: $result');
       return right(result.isEmpty ? 'ok' : result);
@@ -670,7 +681,13 @@ class LanternFFIService implements LanternCoreService {
         }
       });
       if (result.isNotEmpty && !_ffiOkResults.contains(result)) {
-        return left(Failure(error: result, localizedErrorMessage: result));
+        appLogger.error('stopVPN error: $result');
+        return left(
+          Failure(
+            error: result,
+            localizedErrorMessage: localizeRawError(result),
+          ),
+        );
       }
       appLogger.debug('stopVPN result: $result');
       return right(result.isEmpty ? 'ok' : result);