fix(mobile): persist web cache and stabilize plugins

- keep last successful crossbar.web response for widgets

- set app data dir for foreground and background workers

- guard plugin discovery against transient empty scans

- bump version to 1.8.0+15

Author: insign

AGENTS.md

@@ -80,7 +80,7 @@ Quando terminar as tarefas solicitadas faça as seguintes etapas:
 ## 2. Identidade do Projeto
 
 - **Nome**: Crossbar (Universal Plugin System)
-- **Versão Atual**: `1.7.2+14` (atualize ao final de cada sessão).
+- **Versão Atual**: `1.8.0+15` (atualize ao final de cada sessão).
 - **Stack**: Flutter `3.38.3` (CI), Dart `3.10+`.
 - **Objetivo**: Sistema de plugins compatível com BitBar/Argos para Linux, Windows, macOS, Android e iOS.
 - **Status**: Estável (v1.0+). Todas as fases do plano original concluídas.

lib/core/plugin_manager.dart

@@ -21,6 +21,7 @@ class PluginManager {
   final PluginExecutor _pluginExecutor = PluginExecutor();
   final PluginConfigService _configService = PluginConfigService();
   static const int maxConcurrent = 10;
+  int _emptyDiscoveryStreak = 0;
 
   static const List<String> supportedLanguages = [
     'bash',
@@ -85,21 +86,29 @@ class PluginManager {
   }
 
   Future<void> discoverPlugins() async {
-    _plugins.clear();
-
     final pluginsDirPath = await pluginsDirectory;
     final pluginsDir = Directory(pluginsDirPath);
 
     if (!await pluginsDir.exists()) {
+      if (_plugins.isNotEmpty) {
+        _emptyDiscoveryStreak++;
+        if (_emptyDiscoveryStreak < 2) {
+          return;
+        }
+      }
+      _emptyDiscoveryStreak = 0;
+      _plugins.clear();
       return;
     }
 
     // Map to group plugins by their directory and base name
     // Key: directory_path:base_name
     final groups = <String, List<File>>{};
+    var foundFiles = 0;
 
     await for (final entity in pluginsDir.list(recursive: true)) {
       if (entity is File && _isValidPluginFile(entity.path)) {
+        foundFiles++;
         final dir = path.dirname(entity.path);
         final fileName = path.basename(entity.path);
 
@@ -112,16 +121,34 @@ class PluginManager {
       }
     }
 
+    final discovered = <Plugin>[];
+
     for (final entry in groups.entries) {
       final files = entry.value;
       if (files.isEmpty) continue;
 
       // Create a single plugin representing this group
       final plugin = await _createPluginFromGroup(files);
       if (plugin != null) {
-        _plugins.add(plugin);
+        discovered.add(plugin);
       }
     }
+
+    if (_plugins.isNotEmpty) {
+      final emptyDiscovery =
+          foundFiles == 0 || (foundFiles > 0 && discovered.isEmpty);
+      if (emptyDiscovery) {
+        _emptyDiscoveryStreak++;
+        if (_emptyDiscoveryStreak < 2) {
+          return;
+        }
+      }
+    }
+
+    _emptyDiscoveryStreak = 0;
+    _plugins
+      ..clear()
+      ..addAll(discovered);
   }
 
   String _extractPluginBaseName(String fileName) {
@@ -479,5 +506,6 @@ class PluginManager {
 
   void clear() {
     _plugins.clear();
+    _emptyDiscoveryStreak = 0;
   }
 }

lib/main.dart

@@ -1,10 +1,10 @@
 import 'dart:io';
 import 'dart:ui';
 
+import 'package:crossbar_core/crossbar_core.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter/services.dart';
-
-import 'package:crossbar_core/crossbar_core.dart';
+import 'package:path_provider/path_provider.dart';
 import 'core/api/android_native_bridge.dart';
 import 'core/plugin_manager.dart';
 import 'services/background_service.dart';
@@ -47,6 +47,11 @@ void main(List<String> args) async {
       CrossbarBridge.instance.androidBridge = AndroidNativeBridge();
     }
 
+    if (Platform.isAndroid || Platform.isIOS) {
+      final appDir = await getApplicationDocumentsDirectory();
+      CrossbarBridge.instance.appDataDir = appDir.path;
+    }
+
     // Register Android widget refresh handler EARLY
     // This catches refresh requests even before services are fully initialized
     if (Platform.isAndroid) {

lib/services/background_service.dart

@@ -1,7 +1,10 @@
 import 'dart:convert';
 import 'dart:io';
 
+import 'package:crossbar_core/crossbar_core.dart';
+import 'package:flutter/widgets.dart';
 import 'package:home_widget/home_widget.dart';
+import 'package:path_provider/path_provider.dart';
 import 'package:workmanager/workmanager.dart';
 
 import '../core/plugin_executor.dart';
@@ -34,6 +37,10 @@ void callbackDispatcher() {
 
 /// Updates widgets in background without full app initialization
 Future<void> _updateWidgetsInBackground() async {
+  WidgetsFlutterBinding.ensureInitialized();
+  final appDir = await getApplicationDocumentsDirectory();
+  CrossbarBridge.instance.appDataDir = appDir.path;
+
   // Initialize HomeWidget
   await HomeWidget.setAppGroupId('group.crossbar.widgets');
 

packages/crossbar_core/lib/src/core/bridge/crossbar_bridge.dart

@@ -25,6 +25,12 @@ class CrossbarBridge {
   AndroidBridgeInterface _androidBridge =
       AndroidNativeBridge(); // Default to stub
 
+  String? _appDataDir;
+
+  /// Optional app-private data directory (mobile).
+  set appDataDir(String? value) => _appDataDir = value;
+  String? get appDataDir => _appDataDir;
+
   /// Inject a platform-specific implementation (e.g. from Flutter)
   set androidBridge(AndroidBridgeInterface bridge) => _androidBridge = bridge;
 

packages/crossbar_core/lib/src/core/lua_runner.dart

@@ -103,7 +103,7 @@ class LuaRunner {
     _registerConfigTable(lua, configValues);
     _registerConfigGet(lua, configValues);
     _registerStorage(lua, pluginId);
-    _registerWeb(lua);
+    _registerWeb(lua, pluginId);
     _registerSyncNoArgFunc(lua, 'platform', () => _bridge.platform);
     _registerSyncNoArgFunc(lua, 'homeDir', () => _bridge.homeDir);
     _registerSyncNoArgBool(lua, 'isMobile', () => _bridge.isMobile);
@@ -336,7 +336,7 @@ class LuaRunner {
     lua.setField(-2, 'execResult');
   }
 
-  void _registerWeb(LuaState lua) {
+  void _registerWeb(LuaState lua, String pluginId) {
     lua.pushDartFunction((ls) {
       final url = ls.getTop() >= 1 ? ls.toStr(1) : null;
       if (url == null || url.isEmpty) {
@@ -361,18 +361,26 @@ class LuaRunner {
       }
 
       if (_bridge.isMobile) {
-        final cacheKey = _buildWebCacheKey(
+        final cacheKey = '$pluginId|${_buildWebCacheKey(
           url,
           method: method,
           headers: headers,
           body: body,
           timeout: timeout,
           raw: raw,
-        );
+        )}';
+
+        var cached = _webCache[cacheKey];
+        if (cached == null) {
+          cached = _readWebCache(pluginId, cacheKey);
+          if (cached != null) {
+            _webCache[cacheKey] = cached;
+          }
+        }
 
-        final cached = _webCache[cacheKey];
         if (!_webInFlight.contains(cacheKey)) {
           _webInFlight.add(cacheKey);
+          final cachedSnapshot = cached;
           _bridge
               .web(
             url,
@@ -382,8 +390,14 @@ class LuaRunner {
             timeout: timeout ?? 30,
           )
               .then((response) {
-            _webCache[cacheKey] = response;
+            if (_isSuccessfulWebResponse(response)) {
+              _webCache[cacheKey] = response;
+              _writeWebCache(pluginId, cacheKey, response);
+            } else if (cachedSnapshot == null) {
+              _webCache[cacheKey] = response;
+            }
           }).catchError((e) {
+            if (cachedSnapshot != null) return;
             _webCache[cacheKey] = {
               'error': true,
               'message': e.toString(),
@@ -500,6 +514,57 @@ class LuaRunner {
     }
   }
 
+  String _resolveWebCacheBaseDir() {
+    final appDir = _bridge.appDataDir;
+    if (appDir != null && appDir.isNotEmpty && appDir != '~') {
+      return appDir;
+    }
+    if (_bridge.isMobile) {
+      return Directory.systemTemp.path;
+    }
+    return _bridge.homeDir;
+  }
+
+  File _webCacheFile(String pluginId, String cacheKey) {
+    final safeId = _sanitizePluginId(pluginId.isEmpty ? 'unknown' : pluginId);
+    final baseDir = _resolveWebCacheBaseDir();
+    final dir = Directory(path.join(baseDir, 'crossbar_web_cache', safeId));
+    final fileName = _bridge.hash(cacheKey);
+    return File(path.join(dir.path, '$fileName.json'));
+  }
+
+  dynamic _readWebCache(String pluginId, String cacheKey) {
+    final file = _webCacheFile(pluginId, cacheKey);
+    if (!file.existsSync()) return null;
+    try {
+      return jsonDecode(file.readAsStringSync());
+    } catch (_) {
+      return null;
+    }
+  }
+
+  void _writeWebCache(String pluginId, String cacheKey, dynamic value) {
+    try {
+      final file = _webCacheFile(pluginId, cacheKey);
+      final dir = file.parent;
+      if (!dir.existsSync()) {
+        dir.createSync(recursive: true);
+      }
+      file.writeAsStringSync(jsonEncode(value));
+    } catch (_) {
+      // Ignore cache write errors
+    }
+  }
+
+  bool _isSuccessfulWebResponse(dynamic response) {
+    if (response is Map) {
+      if (response['error'] == true) return false;
+      final status = response['status'];
+      if (status is int && status >= 400) return false;
+    }
+    return true;
+  }
+
   void _registerStorage(LuaState lua, String pluginId) {
     lua.pushDartFunction((ls) {
       final key = ls.getTop() >= 1 ? ls.toStr(1) : null;

pubspec.yaml

@@ -1,7 +1,7 @@
 name: crossbar
 description: Universal Plugin System for Taskbar/Menu Bar - Cross-platform BitBar/Argos alternative
 publish_to: "none"
-version: 1.7.2+14
+version: 1.8.0+15
 
 environment:
   sdk: ^3.10.0