Add support for importing custom API configuration from clipboard and enhance offline sessions display

Author: MrAlders0n

docs/CUSTOM_API_ENDPOINT.md

@@ -192,6 +192,27 @@ Your endpoint should return any `2xx` HTTP status code on success. The response
 
 MeshMapper does **not** retry failed custom API requests. Each batch is sent exactly once.
 
+## Configuration Link for End Users
+
+As an endpoint operator, you can generate a configuration link that your users paste into their clipboard. In MeshMapper Settings > API Endpoints, they tap **Import from Clipboard** to auto-fill the URL and API key.
+
+**Format:**
+
+```
+meshmapper://custom-api?url=your-server.com/api/wardrive&key=your-api-key-here
+```
+
+- `url` — Your endpoint host and path, **without** `https://` (MeshMapper prepends it automatically).
+- `key` — The API key the user should send. This will be set as their `X-API-Key` header value.
+
+**Example:**
+
+```
+meshmapper://custom-api?url=data.myproject.org/ingest/wardrive&key=sk_live_abc123def456
+```
+
+The user copies this link, opens MeshMapper Settings > API Endpoints, and taps "Import from Clipboard." Both fields are populated instantly.
+
 ## Security Notes
 
 - **HTTPS required**: MeshMapper validates that the configured URL uses HTTPS. HTTP endpoints are rejected at the settings level.

lib/screens/settings_screen.dart

@@ -554,6 +554,30 @@ class _SettingsScreenState extends State<SettingsScreen> {
             ),
           ]),
 
+          // Offline Sessions
+          _buildSection(context, 'Offline Sessions', [
+            if (appState.offlineSessions.isEmpty)
+              ListTile(
+                leading: Icon(Icons.cloud_off, color: Colors.grey.shade400),
+                title: Text(
+                  'No offline sessions stored',
+                  style: TextStyle(color: Colors.grey.shade500),
+                ),
+                subtitle: Text(
+                  'Sessions recorded in offline mode will appear here',
+                  style: TextStyle(fontSize: 12, color: Colors.grey.shade400),
+                ),
+              )
+            else
+              ...appState.offlineSessions.map((session) => _OfflineSessionTile(
+                session: session,
+                uploadEnabled: !appState.isUploadingOfflineSession,
+                onUpload: () => _uploadOfflineSession(context, appState, session.filename),
+                onDelete: () => _confirmDeleteOfflineSession(context, appState, session.filename),
+                onDownload: () => _downloadOfflineSession(context, appState, session.filename),
+              )),
+          ]),
+
           // API Endpoints
           _buildSection(context, 'API Endpoints', [
             const ListTile(
@@ -591,31 +615,13 @@ class _SettingsScreenState extends State<SettingsScreen> {
                 trailing: const Icon(Icons.chevron_right),
                 onTap: isAutoMode ? null : () => _showCustomApiKeyDialog(context, appState),
               ),
-            ],
-          ]),
-
-          // Offline Sessions
-          _buildSection(context, 'Offline Sessions', [
-            if (appState.offlineSessions.isEmpty)
               ListTile(
-                leading: Icon(Icons.cloud_off, color: Colors.grey.shade400),
-                title: Text(
-                  'No offline sessions stored',
-                  style: TextStyle(color: Colors.grey.shade500),
-                ),
-                subtitle: Text(
-                  'Sessions recorded in offline mode will appear here',
-                  style: TextStyle(fontSize: 12, color: Colors.grey.shade400),
-                ),
-              )
-            else
-              ...appState.offlineSessions.map((session) => _OfflineSessionTile(
-                session: session,
-                uploadEnabled: !appState.isUploadingOfflineSession,
-                onUpload: () => _uploadOfflineSession(context, appState, session.filename),
-                onDelete: () => _confirmDeleteOfflineSession(context, appState, session.filename),
-                onDownload: () => _downloadOfflineSession(context, appState, session.filename),
-              )),
+                leading: const Icon(Icons.content_paste),
+                title: const Text('Import from Clipboard'),
+                subtitle: const Text('Paste a meshmapper:// config link'),
+                onTap: isAutoMode ? null : () => _importCustomApiFromClipboard(context, appState),
+              ),
+            ],
           ]),
 
           // About
@@ -991,6 +997,7 @@ class _SettingsScreenState extends State<SettingsScreen> {
       case 'bike': return 'Bike';
       case 'boat': return 'Boat';
       case 'walk': return 'Walk';
+      case 'pacman': return 'Pac-Man';
       case 'arrow':
       default: return 'Arrow';
     }
@@ -2301,6 +2308,63 @@ class _SettingsScreenState extends State<SettingsScreen> {
     );
   }
 
+  Future<void> _importCustomApiFromClipboard(BuildContext context, AppStateProvider appState) async {
+    final clipData = await Clipboard.getData('text/plain');
+    final text = clipData?.text?.trim();
+
+    if (text == null || text.isEmpty) {
+      if (context.mounted) AppToast.error(context, 'Clipboard is empty');
+      return;
+    }
+
+    // Expected format: meshmapper://custom-api?url=example.com/api.php&key=xxxxxxxxxx
+    if (!text.startsWith('meshmapper://')) {
+      if (context.mounted) {
+        AppToast.error(context, 'No meshmapper:// link found in clipboard');
+      }
+      return;
+    }
+
+    try {
+      final uri = Uri.parse(text);
+      final rawUrl = uri.queryParameters['url'];
+      final key = uri.queryParameters['key'];
+
+      if (rawUrl == null || rawUrl.isEmpty) {
+        if (context.mounted) AppToast.error(context, 'Link is missing the url parameter');
+        return;
+      }
+      if (key == null || key.isEmpty) {
+        if (context.mounted) AppToast.error(context, 'Link is missing the key parameter');
+        return;
+      }
+
+      final fullUrl = 'https://$rawUrl';
+
+      // Validate the constructed URL
+      final parsed = Uri.tryParse(fullUrl);
+      if (parsed == null || !parsed.hasAuthority) {
+        if (context.mounted) AppToast.error(context, 'Invalid URL in link: $rawUrl');
+        return;
+      }
+
+      appState.updatePreferences(
+        appState.preferences.copyWith(
+          customApiUrl: fullUrl,
+          customApiKey: key,
+        ),
+      );
+
+      if (context.mounted) {
+        AppToast.success(context, 'Imported endpoint: $rawUrl');
+      }
+      debugLog('[CUSTOM API] Imported endpoint from clipboard: $fullUrl');
+    } catch (e) {
+      debugError('[CUSTOM API] Failed to parse clipboard link: $e');
+      if (context.mounted) AppToast.error(context, 'Invalid meshmapper:// link');
+    }
+  }
+
   void _showCloseAppConfirmation(BuildContext context, AppStateProvider appState) {
     final isConnected = appState.isConnected;
 

lib/widgets/map_widget.dart

@@ -702,6 +702,9 @@ class _MapWidgetState extends State<MapWidget> with TickerProviderStateMixin {
                   userAgentPackageName: 'com.meshmapper.app',
                   maxZoom: 17,
                   retinaMode: mapStyle.supportsRetina && RetinaMode.isHighDensity(context),
+                  tileDisplay: const TileDisplay.fadeIn(
+                    reloadStartOpacity: 1.0,
+                  ),
                   tileProvider: SilentCancellableNetworkTileProvider(),
                 );
               },
@@ -715,19 +718,21 @@ class _MapWidgetState extends State<MapWidget> with TickerProviderStateMixin {
               minZoom: 3,
               maxZoom: 17,
               tileDisplay: const TileDisplay.fadeIn(
-                reloadStartOpacity: 1.0, // Keep old tile visible until new one loads
+                reloadStartOpacity: 1.0,
               ),
               tileProvider: SilentCancellableNetworkTileProvider(),
             ),
 
           // Coverage markers (TX, RX, DISC, Trace) — sorted by timestamp, newest on top
+          // During focus mode, the focused marker is excluded and rendered in its own top layer
         MarkerLayer(
           markers: _buildCoverageMarkers(
             txPings: appState.txPings,
             rxPings: appState.rxPings,
             discEntries: appState.discLogEntries,
             discDropEnabled: appState.discDropEnabled,
             traceEntries: appState.traceLogEntries,
+            excludeFocused: _focusedPingLocation != null,
           ),
         ),
 
@@ -776,6 +781,16 @@ class _MapWidgetState extends State<MapWidget> with TickerProviderStateMixin {
               onlyConnected: true,
             ),
           ),
+          // Focused ping marker (above everything except GPS)
+          MarkerLayer(
+            markers: _buildFocusedPingMarker(
+              txPings: appState.txPings,
+              rxPings: appState.rxPings,
+              discEntries: appState.discLogEntries,
+              discDropEnabled: appState.discDropEnabled,
+              traceEntries: appState.traceLogEntries,
+            ),
+          ),
         ] else
           // Normal mode: single layer with all repeaters
           MarkerLayer(
@@ -1782,22 +1797,60 @@ class _MapWidgetState extends State<MapWidget> with TickerProviderStateMixin {
     required List<DiscLogEntry> discEntries,
     required bool discDropEnabled,
     required List<TraceLogEntry> traceEntries,
+    bool excludeFocused = false,
   }) {
     final timestamped = <(DateTime, Marker)>[
       for (final ping in txPings)
-        (ping.timestamp, _buildTxMarker(ping)),
+        if (!excludeFocused || !_isFocusedPing(ping.latitude, ping.longitude, ping.timestamp))
+          (ping.timestamp, _buildTxMarker(ping)),
       for (final ping in rxPings)
-        (ping.timestamp, _buildRxMarker(ping)),
+        if (!excludeFocused || !_isFocusedPing(ping.latitude, ping.longitude, ping.timestamp))
+          (ping.timestamp, _buildRxMarker(ping)),
       for (final entry in discEntries)
-        (entry.timestamp, _buildDiscMarker(entry, discDropEnabled)),
+        if (!excludeFocused || !_isFocusedPing(entry.latitude, entry.longitude, entry.timestamp))
+          (entry.timestamp, _buildDiscMarker(entry, discDropEnabled)),
       for (final entry in traceEntries)
-        (entry.timestamp, _buildTraceMarker(entry)),
+        if (!excludeFocused || !_isFocusedPing(entry.latitude, entry.longitude, entry.timestamp))
+          (entry.timestamp, _buildTraceMarker(entry)),
     ];
 
     timestamped.sort((a, b) => a.$1.compareTo(b.$1));
     return timestamped.map((e) => e.$2).toList();
   }
 
+  /// Build just the focused ping marker for rendering in its own top layer.
+  List<Marker> _buildFocusedPingMarker({
+    required List<TxPing> txPings,
+    required List<RxPing> rxPings,
+    required List<DiscLogEntry> discEntries,
+    required bool discDropEnabled,
+    required List<TraceLogEntry> traceEntries,
+  }) {
+    if (_focusedPingLocation == null) return [];
+
+    for (final ping in txPings) {
+      if (_isFocusedPing(ping.latitude, ping.longitude, ping.timestamp)) {
+        return [_buildTxMarker(ping)];
+      }
+    }
+    for (final ping in rxPings) {
+      if (_isFocusedPing(ping.latitude, ping.longitude, ping.timestamp)) {
+        return [_buildRxMarker(ping)];
+      }
+    }
+    for (final entry in discEntries) {
+      if (_isFocusedPing(entry.latitude, entry.longitude, entry.timestamp)) {
+        return [_buildDiscMarker(entry, discDropEnabled)];
+      }
+    }
+    for (final entry in traceEntries) {
+      if (_isFocusedPing(entry.latitude, entry.longitude, entry.timestamp)) {
+        return [_buildTraceMarker(entry)];
+      }
+    }
+    return [];
+  }
+
   /// Check if a ping at given lat/lon/timestamp is the currently focused ping.
   bool _isFocusedPing(double lat, double lon, DateTime timestamp) {
     return _focusedPingLocation != null &&