Refactor error handling in API and app state provider to include additional session and authorization error cases

Author: MrAlders0n

ios/Flutter/Generated.xcconfig

@@ -8,7 +8,7 @@ FLUTTER_BUILD_NAME=1.0.0
 FLUTTER_BUILD_NUMBER=1
 EXCLUDED_ARCHS[sdk=iphonesimulator*]=i386
 EXCLUDED_ARCHS[sdk=iphoneos*]=armv7
-DART_DEFINES=QVBQLTE3NjkyMDM1NzA=,RkxVVFRFUl9WRVJTSU9OPTMuMzguNw==,RkxVVFRFUl9DSEFOTkVMPXN0YWJsZQ==,RkxVVFRFUl9HSVRfVVJMPWh0dHBzOi8vZ2l0aHViLmNvbS9mbHV0dGVyL2ZsdXR0ZXIuZ2l0,RkxVVFRFUl9GUkFNRVdPUktfUkVWSVNJT049M2I2MmVmYzJhMw==,RkxVVFRFUl9FTkdJTkVfUkVWSVNJT049NzhmYzMwMTJlNA==,RkxVVFRFUl9EQVJUX1ZFUlNJT049My4xMC43
+DART_DEFINES=RkxVVFRFUl9WRVJTSU9OPTMuMzguNw==,RkxVVFRFUl9DSEFOTkVMPXN0YWJsZQ==,RkxVVFRFUl9HSVRfVVJMPWh0dHBzOi8vZ2l0aHViLmNvbS9mbHV0dGVyL2ZsdXR0ZXIuZ2l0,RkxVVFRFUl9GUkFNRVdPUktfUkVWSVNJT049M2I2MmVmYzJhMw==,RkxVVFRFUl9FTkdJTkVfUkVWSVNJT049NzhmYzMwMTJlNA==,RkxVVFRFUl9EQVJUX1ZFUlNJT049My4xMC43
 DART_OBFUSCATION=false
 TRACK_WIDGET_CREATION=true
 TREE_SHAKE_ICONS=false

ios/Flutter/flutter_export_environment.sh

@@ -7,7 +7,7 @@ export "FLUTTER_TARGET=/Users/schnobbc/Documents/Github/MeshMapper_Flutter_App/l
 export "FLUTTER_BUILD_DIR=build"
 export "FLUTTER_BUILD_NAME=1.0.0"
 export "FLUTTER_BUILD_NUMBER=1"
-export "DART_DEFINES=QVBQLTE3NjkyMDM1NzA=,RkxVVFRFUl9WRVJTSU9OPTMuMzguNw==,RkxVVFRFUl9DSEFOTkVMPXN0YWJsZQ==,RkxVVFRFUl9HSVRfVVJMPWh0dHBzOi8vZ2l0aHViLmNvbS9mbHV0dGVyL2ZsdXR0ZXIuZ2l0,RkxVVFRFUl9GUkFNRVdPUktfUkVWSVNJT049M2I2MmVmYzJhMw==,RkxVVFRFUl9FTkdJTkVfUkVWSVNJT049NzhmYzMwMTJlNA==,RkxVVFRFUl9EQVJUX1ZFUlNJT049My4xMC43"
+export "DART_DEFINES=RkxVVFRFUl9WRVJTSU9OPTMuMzguNw==,RkxVVFRFUl9DSEFOTkVMPXN0YWJsZQ==,RkxVVFRFUl9HSVRfVVJMPWh0dHBzOi8vZ2l0aHViLmNvbS9mbHV0dGVyL2ZsdXR0ZXIuZ2l0,RkxVVFRFUl9GUkFNRVdPUktfUkVWSVNJT049M2I2MmVmYzJhMw==,RkxVVFRFUl9FTkdJTkVfUkVWSVNJT049NzhmYzMwMTJlNA==,RkxVVFRFUl9EQVJUX1ZFUlNJT049My4xMC43"
 export "DART_OBFUSCATION=false"
 export "TRACK_WIDGET_CREATION=true"
 export "TREE_SHAKE_ICONS=false"

lib/providers/app_state_provider.dart

@@ -1605,6 +1605,18 @@ class AppStateProvider extends ChangeNotifier {
         return 'Session has expired. Please reconnect.';
       case 'bad_session':
         return 'Invalid session. Please reconnect.';
+      case 'outofdate':
+        return 'App version outdated. Please update to the latest version.';
+      case 'session_invalid':
+        return 'Session is invalid. Please reconnect.';
+      case 'session_revoked':
+        return 'Session was revoked. Please reconnect.';
+      case 'invalid_key':
+        return 'Invalid API key. Please check configuration.';
+      case 'unauthorized':
+        return 'Unauthorized. Please reconnect.';
+      case 'rate_limited':
+        return 'Rate limited. Please slow down.';
       default:
         return serverMessage ?? 'Unknown error occurred.';
     }
@@ -1623,6 +1635,13 @@ class AppStateProvider extends ChangeNotifier {
       return;
     }
 
+    // Special case: outofdate is a critical error requiring app update
+    if (reason == 'outofdate') {
+      _statusMessageService.setPersistentError(userMessage, StatusColor.error);
+      debugLog('[API] App version outdated - update required');
+      return;
+    }
+
     // Log error and add to error log
     debugError('[API] Auth error: $reason - $userMessage');
     logError(userMessage, severity: ErrorSeverity.error);
@@ -1641,12 +1660,42 @@ class AppStateProvider extends ChangeNotifier {
     final userMessage = _getErrorMessage(reason, message);
     debugError('[API] Session error: $reason - $userMessage');
 
+    // Rate limiting should warn but not disconnect (per PORTED_APP behavior)
+    if (reason == 'rate_limited') {
+      _statusMessageService.setDynamicStatus(userMessage, StatusColor.warning);
+      debugLog('[API] Rate limited - continuing without disconnect');
+      return;
+    }
+
     // Show error message
     _statusMessageService.setDynamicStatus(userMessage, StatusColor.error);
     logError(userMessage, severity: ErrorSeverity.error);
 
+    // Session errors that require disconnect
+    const sessionErrors = {
+      'session_expired',
+      'session_invalid',
+      'session_revoked',
+      'bad_session',
+    };
+
+    // Authorization errors that require disconnect
+    const authErrors = {
+      'invalid_key',
+      'unauthorized',
+      'bad_key',
+    };
+
+    // Zone errors that require disconnect
+    const zoneErrors = {
+      'outside_zone',
+      'zone_full',
+    };
+
     // Handle errors that require disconnect
-    if (reason == 'session_expired' || reason == 'bad_session' || reason == 'outside_zone') {
+    if (sessionErrors.contains(reason) ||
+        authErrors.contains(reason) ||
+        zoneErrors.contains(reason)) {
       debugLog('[API] Session error requires disconnect: $reason');
       // Don't call requestAuth disconnect - session is already invalid on server
       // Just cleanup locally and disconnect

lib/services/api_service.dart

@@ -358,7 +358,18 @@ class ApiService {
 
       // Check for session errors that require disconnect
       final reason = result['reason'] as String?;
-      if (reason == 'session_expired' || reason == 'bad_session' || reason == 'outside_zone') {
+
+      // All errors that require session invalidation and disconnect
+      const criticalErrors = {
+        // Session errors
+        'session_expired', 'session_invalid', 'session_revoked', 'bad_session',
+        // Auth errors
+        'invalid_key', 'unauthorized', 'bad_key',
+        // Zone errors
+        'outside_zone', 'zone_full',
+      };
+
+      if (criticalErrors.contains(reason)) {
         debugError('[API] Upload batch session error: $reason');
         final message = result['message'] as String?;
         // Clear session locally since it's invalid on server