feat(cache): permitir uso de dados expirados como fallback em chamadas de API

Author: rodrigomiquilino

docs/index.html

@@ -2551,14 +2551,18 @@ <h4>Comunidade</h4>
             CACHE_KEY: 'wwm_api_cache_index',
             CACHE_TTL: 10 * 60 * 1000, // 10 minutos
 
-            get(key) {
+            get(key, allowExpired = false) {
                 try {
                     const cache = JSON.parse(localStorage.getItem(this.CACHE_KEY) || '{}');
                     const item = cache[key];
                     if (item && Date.now() - item.timestamp < this.CACHE_TTL) {
                         console.log(`[Cache HIT] ${key}`);
                         return item.data;
                     }
+                    if (item && allowExpired) {
+                        console.log(`[Cache STALE] ${key} (usando dados antigos)`);
+                        return item.data;
+                    }
                     if (item) {
                         console.log(`[Cache EXPIRED] ${key}`);
                     }
@@ -2584,19 +2588,43 @@ <h4>Comunidade</h4>
             }
         };
 
-        // API call com cache
+        // API call com cache e fallback para dados expirados
         async function cachedApiCall(cacheKey, url, options = {}) {
+            // Primeiro tenta cache válido
             const cached = CacheManager.get(cacheKey);
             if (cached) return cached;
 
-            const response = await fetch(url, options);
-            if (!response.ok) {
-                throw new Error(`API error: ${response.status}`);
+            try {
+                const response = await fetch(url, options);
+                
+                // Rate limit atingido
+                if (response.status === 403) {
+                    const staleData = CacheManager.get(cacheKey, true); // allowExpired
+                    if (staleData) {
+                        console.warn(`[Rate Limit] Usando cache expirado para ${cacheKey}`);
+                        return staleData;
+                    }
+                    const resetTime = response.headers.get('X-RateLimit-Reset');
+                    const resetDate = resetTime ? new Date(parseInt(resetTime) * 1000).toLocaleTimeString('pt-BR') : 'em breve';
+                    throw new Error(`Rate limit excedido. Tente novamente às ${resetDate}`);
+                }
+                
+                if (!response.ok) {
+                    throw new Error(`API error: ${response.status}`);
+                }
+                
+                const data = await response.json();
+                CacheManager.set(cacheKey, data);
+                return data;
+            } catch (error) {
+                // Em caso de erro de rede, tenta cache expirado
+                const staleData = CacheManager.get(cacheKey, true);
+                if (staleData) {
+                    console.warn(`[Fallback] Usando cache expirado para ${cacheKey}`);
+                    return staleData;
+                }
+                throw error;
             }
-            
-            const data = await response.json();
-            CacheManager.set(cacheKey, data);
-            return data;
         }
 
         // ========== STATE ==========

docs/translate.html

@@ -2431,7 +2431,7 @@ <h4><i class="fas fa-clipboard-list"></i> Sugestões (<span id="cart-count">0</s
             },
 
             // Recupera dados do cache se ainda válidos
-            get(key) {
+            get(key, allowExpired = false) {
                 try {
                     const cached = localStorage.getItem(CONFIG.CACHE_PREFIX + key);
                     if (!cached) return null;
@@ -2444,8 +2444,12 @@ <h4><i class="fas fa-clipboard-list"></i> Sugestões (<span id="cart-count">0</s
                         return cacheItem.data;
                     }
 
+                    if (allowExpired) {
+                        console.log(`[Cache STALE] ${key} (usando dados antigos)`);
+                        return cacheItem.data;
+                    }
+                    
                     console.log(`[Cache EXPIRED] ${key}`);
-                    localStorage.removeItem(CONFIG.CACHE_PREFIX + key);
                     return null;
                 } catch (e) {
                     return null;
@@ -2517,6 +2521,12 @@ <h4><i class="fas fa-clipboard-list"></i> Sugestões (<span id="cart-count">0</s
                             const resetDate = new Date(parseInt(resetTime) * 1000);
                             console.error(`[API] Rate limit exceeded. Resets at: ${resetDate.toLocaleTimeString()}`);
                         }
+                        // Tenta usar dados expirados como fallback
+                        const staleData = apiCache.get(cacheKey, true);
+                        if (staleData) {
+                            console.warn(`[API] Usando cache expirado como fallback para ${cacheKey}`);
+                            return { ok: true, data: staleData, fromCache: true, stale: true };
+                        }
                     }
                     return { ok: false, status: response.status, data: null };
                 }
@@ -2529,6 +2539,12 @@ <h4><i class="fas fa-clipboard-list"></i> Sugestões (<span id="cart-count">0</s
                 return { ok: true, data: data, fromCache: false };
             } catch (error) {
                 console.error(`[API] Fetch error for ${cacheKey}:`, error);
+                // Em caso de erro de rede, tenta cache expirado
+                const staleData = apiCache.get(cacheKey, true);
+                if (staleData) {
+                    console.warn(`[API] Usando cache expirado como fallback para ${cacheKey}`);
+                    return { ok: true, data: staleData, fromCache: true, stale: true };
+                }
                 return { ok: false, data: null, error };
             }
         }