fix(mobile): cache invalidation, startup refresh, and autocorrect

Author: batalabs

apps/mobile/v1/src/components/AppWrapper.tsx

@@ -5,6 +5,7 @@ import { ActivityIndicator,View } from 'react-native';
 import { useMasterPassword } from '../hooks/useMasterPassword';
 import { logger } from '../lib/logger';
 import AuthScreen from '../screens/AuthScreen';
+import { apiCache } from '../services/api/cache';
 import { useSyncOnReconnect } from '../services/sync/useSyncOnReconnect';
 import { useTheme } from '../theme';
 import { MasterPasswordScreen } from './MasterPasswordDialog';
@@ -34,6 +35,14 @@ export const AppWrapper: React.FC<AppWrapperProps> = ({ children }) => {
   // Automatically sync pending mutations when device comes back online
   useSyncOnReconnect();
 
+  // Clear API cache on app mount to prevent stale data from previous session
+  useEffect(() => {
+    apiCache.clearAll();
+    if (__DEV__) {
+      console.log('[AppWrapper] Cleared API cache on app startup');
+    }
+  }, []);
+
   // Detect userId change SYNCHRONOUSLY in render
   if (userId !== lastUserIdRef.current) {
     lastUserIdRef.current = userId;

apps/mobile/v1/src/screens/FoldersScreen.tsx

@@ -113,6 +113,7 @@ export default function FoldersScreen() {
   // Check if screen is focused
   const isFocused = useIsFocused();
   const loadTimerRef = useRef<NodeJS.Timeout | null>(null);
+  const isFirstMountRef = useRef(true);
 
   // Load folders data
   const loadFoldersData = useCallback(async (isRefresh = false, forceRefresh = false) => {
@@ -191,8 +192,14 @@ export default function FoldersScreen() {
         clearTimeout(loadTimerRef.current);
       }
 
-      // Load immediately
-      loadFoldersData();
+      // Force refresh on first mount to ensure fresh data (prevents stale counts on app reload)
+      const shouldForceRefresh = isFirstMountRef.current;
+      if (isFirstMountRef.current) {
+        isFirstMountRef.current = false;
+      }
+
+      // Load immediately with force refresh on first mount
+      loadFoldersData(false, shouldForceRefresh);
     }
 
     return () => {

apps/mobile/v1/src/services/api/notes.ts

@@ -186,19 +186,23 @@ export function createNotesApi(getToken: AuthTokenGetter, getUserId: () => strin
 
         // If offline, calculate from database with short-lived cache
         if (!online) {
-          // Check short-lived cache to avoid recalculation on rapid re-renders
           const cacheKey = CACHE_KEYS.COUNTS(folderId);
-          const cached = apiCache.get<NoteCounts>(cacheKey);
-          if (cached) {
-            if (__DEV__) {
-              console.log('[API] Returning cached offline counts');
+
+          // Check short-lived cache to avoid recalculation on rapid re-renders
+          // Skip cache if forceRefresh is true (e.g., on app startup to avoid stale data)
+          if (!forceRefresh) {
+            const cached = apiCache.get<NoteCounts>(cacheKey);
+            if (cached) {
+              if (__DEV__) {
+                console.log('[API] Returning cached offline counts');
+              }
+              return cached;
             }
-            return cached;
           }
 
           // Calculate counts from local SQLite cache
           if (__DEV__) {
-            console.log('[API] Device offline - calculating counts from local cache');
+            console.log('[API] Device offline - calculating counts from local cache', { forceRefresh });
           }
 
           try {
@@ -207,7 +211,10 @@ export function createNotesApi(getToken: AuthTokenGetter, getUserId: () => strin
 
             // Cache for only 2 seconds - offline counts are "best effort" and may be stale
             // This prevents stale counts from persisting when network comes back online
-            apiCache.set(cacheKey, counts, 2_000); // 2s TTL (reduced from 10s)
+            // Don't cache if forceRefresh is true to ensure next call gets fresh data
+            if (!forceRefresh) {
+              apiCache.set(cacheKey, counts, 2_000); // 2s TTL (reduced from 10s)
+            }
 
             return counts;
           } catch (error) {