// E2E integration tests — requires a running Stalwart instance and a display. // Run via: stalwart-dev/integration_ui_test.sh // // Environment variables (set by the runner script): // STALWART_IMAP_HOST, STALWART_IMAP_PORT // STALWART_SMTP_HOST, STALWART_SMTP_PORT // STALWART_USER_B / STALWART_PASS_B (alice@example.com) import 'dart:io'; import 'package:enough_mail/enough_mail.dart' as imap; import 'package:flutter/material.dart'; import 'package:flutter_test/flutter_test.dart'; import 'package:integration_test/integration_test.dart'; import 'package:sharedinbox/core/models/account.dart'; import 'package:sharedinbox/core/storage/secure_storage.dart'; import 'package:sharedinbox/di.dart'; import 'package:sharedinbox/main.dart' as app; /// Plaintext IMAP connection — Stalwart dev server has no TLS certificate. Future _connectImapPlaintext( Account account, String username, String password, ) async { final client = imap.ImapClient( defaultResponseTimeout: const Duration(seconds: 20), ); await client.connectToServer( account.imapHost, account.imapPort, isSecure: false, ); await client.login(username, password); return client; } /// Plaintext SMTP connection — Stalwart dev server has no TLS certificate. Future _connectSmtpPlaintext( Account account, String username, String password, ) async { final atIndex = account.email.lastIndexOf('@'); final clientDomain = atIndex != -1 ? account.email.substring(atIndex + 1) : account.smtpHost; final client = imap.SmtpClient(clientDomain); await client.connectToServer( account.smtpHost, account.smtpPort, isSecure: false, ); await client.ehlo(); await client.authenticate(username, password); return client; } /// In-memory drop-in for SecureStorage — no D-Bus or keyring daemon required. class _InMemorySecureStorage implements SecureStorage { final _store = {}; @override Future write({required String key, required String? value}) async { if (value == null) { _store.remove(key); } else { _store[key] = value; } } @override Future read({required String key}) async => _store[key]; @override Future delete({required String key}) async => _store.remove(key); } final _sw = Stopwatch()..start(); void _log(String label) => debugPrint('[${_sw.elapsedMilliseconds}ms] $label'); /// Pumps the widget tree at [interval] until [finder] matches at least one /// widget, or [timeout] elapses (which throws). Replaces fixed `pump(N)` /// waits — stops as soon as the UI is ready rather than burning the full budget. Future pumpUntil( WidgetTester tester, Finder finder, { Duration timeout = const Duration(seconds: 15), Duration interval = const Duration(milliseconds: 200), }) async { final deadline = tester.binding.clock.now().add(timeout); while (!tester.any(finder)) { if (tester.binding.clock.now().isAfter(deadline)) { throw Exception('pumpUntil timed out waiting for $finder'); } await tester.pump(interval); } // pump(300ms) instead of pumpAndSettle(): a continuously-running animation // (e.g. a spinner in a concurrent test under CPU load) would prevent // pumpAndSettle() from ever settling. One bounded pump is enough for any // route transition to complete. await tester.pump(const Duration(milliseconds: 300)); } void main() { IntegrationTestWidgetsFlutterBinding.ensureInitialized(); late String imapHost; late int imapPort; late String smtpHost; late int smtpPort; late String userEmail; late String userPass; setUpAll(() { const required = [ 'STALWART_IMAP_HOST', 'STALWART_IMAP_PORT', 'STALWART_SMTP_HOST', 'STALWART_SMTP_PORT', 'STALWART_USER_B', 'STALWART_PASS_B', ]; final missing = required.where((k) => Platform.environment[k] == null).toList(); if (missing.isNotEmpty) { fail( 'Missing required environment variables: ${missing.join(', ')}. ' 'This test requires a running Stalwart instance — ' 'run via stalwart-dev/integration_ui_test.sh.', ); } imapHost = Platform.environment['STALWART_IMAP_HOST']!; imapPort = int.parse(Platform.environment['STALWART_IMAP_PORT']!); smtpHost = Platform.environment['STALWART_SMTP_HOST']!; smtpPort = int.parse(Platform.environment['STALWART_SMTP_PORT']!); userEmail = Platform.environment['STALWART_USER_B']!; userPass = Platform.environment['STALWART_PASS_B']!; }); testWidgets( 'E2E: add account, send mail to self, verify sent/inbox, search', (tester) async { // The Flutter Linux test runner defaults to a 1×1 window; give it a // real size so widgets are laid out and hittable. tester.view.physicalSize = const Size(1280, 800); tester.view.devicePixelRatio = 1.0; addTearDown(tester.view.resetPhysicalSize); addTearDown(tester.view.resetDevicePixelRatio); // Capture the test binding's error recorder and error-widget builder // BEFORE app.main() so teardown can restore both. app.main() overwrites // FlutterError.onError (crash-screen handler) and ErrorWidget.builder; // the test binding verifies both are unchanged after the test completes. final bindingError = FlutterError.onError; final bindingErrorWidgetBuilder = ErrorWidget.builder; _log('app start'); app.main( overrides: [ secureStorageProvider.overrideWithValue(_InMemorySecureStorage()), // Stalwart dev server has no TLS — use plaintext IMAP/SMTP throughout. imapConnectProvider.overrideWithValue(_connectImapPlaintext), smtpConnectProvider.overrideWithValue(_connectSmtpPlaintext), // Skip the real IMAP connection-check so _AccountTile never shows a // CircularProgressIndicator — pumpAndSettle() cannot settle while a // continuously-running animation is in the tree. accountConnectionStatusProvider.overrideWith((ref, _) async {}), ], ); // app.main() sets both FlutterError.onError (crash handler) and // ErrorWidget.builder (CrashScreen builder). The binding captures // ErrorWidget.builder BEFORE testBody() and verifies it is unchanged // AFTER testBody() returns — addTearDown fires too late for that check. // Restore ErrorWidget.builder here, immediately after app.main(). ErrorWidget.builder = bindingErrorWidgetBuilder; // Override the crash handler with a filter that forwards non-spurious // errors to the binding's recorder. addTearDown is fine for // FlutterError.onError because the binding checks it via _recordError // which is called on the next error, not in a post-body verify pass. FlutterError.onError = (details) { final msg = details.toString(); // DEFUNCT/DISPOSED: keyboard-dismiss or teardown layout errors on // Android/Linux that have no effect on real functionality. if (msg.contains('DEFUNCT') || msg.contains('DISPOSED')) return; // _zOrderIndex: Flutter 3.41.6 bug — _RawAutocompleteState.dispose() // removes _updateOptionsViewVisibility from the external FocusNode but // forgets to remove _onFocusChange. When the state is rebuilt with the // same FocusNode both listeners accumulate and the second hide() call // hits the _zOrderIndex != null assertion in overlay.dart:1681. // Tracked upstream: https://github.com/flutter/flutter/issues // This filter must be removed once we upgrade past the fix. if (msg.contains('_zOrderIndex')) return; bindingError?.call(details); }; addTearDown(() => FlutterError.onError = bindingError); await pumpUntil(tester, find.text('Welcome to sharedinbox.de')); _log('app settled'); // ── Add account ──────────────────────────────────────────────────────── await tester.tap(find.widgetWithIcon(FloatingActionButton, Icons.add)); await pumpUntil(tester, find.text('Add account')); // Step 1 — enter email and continue. await tester.enterText( find.widgetWithText(TextFormField, 'Email address'), userEmail, ); await tester.tap(find.widgetWithText(FilledButton, 'Continue')); // Auto-detection fails for example.com → falls back to "choose type". await pumpUntil( tester, find.widgetWithText(OutlinedButton, 'IMAP / SMTP'), timeout: const Duration(seconds: 30), ); await tester.tap(find.widgetWithText(OutlinedButton, 'IMAP / SMTP')); await tester.pumpAndSettle(); // Step 2 — IMAP / SMTP form. await tester.enterText( find.widgetWithText(TextFormField, 'Display name'), 'Alice', ); await tester.enterText( find.widgetWithText(TextFormField, 'Password'), userPass, ); // 'Host' appears twice: index 0 = IMAP, index 1 = SMTP. final imapHostField = find.widgetWithText(TextFormField, 'Host').at(0); await tester.ensureVisible(imapHostField); await tester.enterText(imapHostField, imapHost); // 'Port' appears twice: index 0 = IMAP, index 1 = SMTP. final imapPortField = find.widgetWithText(TextFormField, 'Port').at(0); await tester.ensureVisible(imapPortField); await tester.enterText(imapPortField, imapPort.toString()); final smtpHostField = find.widgetWithText(TextFormField, 'Host').at(1); await tester.ensureVisible(smtpHostField); await tester.enterText(smtpHostField, smtpHost); final smtpPortField = find.widgetWithText(TextFormField, 'Port').at(1); await tester.ensureVisible(smtpPortField); await tester.enterText(smtpPortField, smtpPort.toString()); final saveButton = find.widgetWithText(FilledButton, 'Save'); await tester.ensureVisible(saveButton); // Dismiss keyboard to stop cursor animation and avoid layout artifacts. FocusManager.instance.primaryFocus?.unfocus(); await tester.pumpAndSettle(); // Extra wait to ensure layout is fully stable on slow emulators. await tester.pump(const Duration(seconds: 2)); await tester.tap(saveButton); // Wait for the account tile to appear in the account list. Use a // ListTile-scoped finder so we don't exit early when 'Alice' still // appears in the form's EditableText before navigation pops back. final aliceTile = find.descendant( of: find.byType(ListTile), matching: find.text('Alice'), ); await pumpUntil(tester, aliceTile, timeout: const Duration(seconds: 30)); // ── Navigate to mailboxes ────────────────────────────────────────────── _log('navigate to mailboxes'); // On the slow Android emulator (software rendering), animations can lag. // Ensure the route transition is fully settled before tapping. await tester.pumpAndSettle(); await tester.tap(aliceTile); await pumpUntil(tester, find.text('INBOX')); _log('mailboxes settled'); expect(find.text('INBOX'), findsOneWidget); // ── Compose and send email to self ───────────────────────────────────── await tester.tap(find.text('INBOX')); await tester.pumpAndSettle(); await tester.tap(find.byIcon(Icons.edit)); await tester.pumpAndSettle(); final subject = 'E2E-${DateTime.now().millisecondsSinceEpoch}'; await tester.enterText( find.widgetWithText(TextFormField, 'To'), userEmail, ); // Explicitly unfocus the To field so RawAutocomplete closes its overlay // via a single FocusNode notification BEFORE Subject takes focus. // A plain pump() is insufficient — the double hide() fires synchronously // during the focus-dispatch triggered by the next enterText call. FocusManager.instance.primaryFocus?.unfocus(); await tester.pump(const Duration(milliseconds: 300)); await tester.enterText( find.widgetWithText(TextFormField, 'Subject'), subject, ); final bodyField = find.widgetWithText(TextFormField, 'Body'); await tester.ensureVisible(bodyField); await tester.enterText(bodyField, 'Hello from integration test!'); // Unfocus before sending so the autocomplete overlay closes cleanly // before ComposeScreen is popped, avoiding a second hide() on unmount. FocusManager.instance.primaryFocus?.unfocus(); await tester.pump(); _log('send email'); await tester.tap(find.byIcon(Icons.send)); // Wait for ComposeScreen to pop back to EmailListScreen after send. await pumpUntil(tester, find.byIcon(Icons.edit)); _log('send done'); // ComposeScreen pops back to EmailListScreen (INBOX) after send. // ── Check Sent folder ────────────────────────────────────────────────── // Use the drawer to switch folders (no back button on Linux desktop). await tester.tap(find.byTooltip('Open folders')); await tester.pumpAndSettle(); await tester.tap(find.text('Sent')); await tester.pumpAndSettle(); // Sync Sent folder to fetch the appended message. _log('sync Sent'); await tester.tap(find.byIcon(Icons.sync)); await pumpUntil(tester, find.text(subject)); _log('sync Sent done'); expect(find.text(subject), findsOneWidget); // ── Check Inbox ──────────────────────────────────────────────────────── await tester.tap(find.byTooltip('Open folders')); await tester.pumpAndSettle(); await tester.tap(find.text('INBOX')); await tester.pumpAndSettle(); // Sync INBOX — pump at short intervals so the StreamBuilder rebuilds as // soon as the DB stream emits after each sync. Re-tap sync every ~5 s // in case Stalwart's local delivery is slightly delayed. _log('sync INBOX'); await tester.tap(find.byIcon(Icons.sync)); var tick = 0; final inboxDeadline = DateTime.now().add(const Duration(seconds: 60)); while (!tester.any(find.text(subject))) { if (DateTime.now().isAfter(inboxDeadline)) { throw Exception('INBOX sync timed out — email never appeared'); } await tester.pump(const Duration(milliseconds: 200)); tick++; // Re-tap every ~5 s (25 × 200 ms) in case the first sync fired before // the email was delivered. if (tick % 25 == 0) { await tester.tap(find.byIcon(Icons.sync)); } } await tester.pumpAndSettle(); _log('sync INBOX done'); expect(find.text(subject), findsOneWidget); // ── Search ───────────────────────────────────────────────────────────── // Search by the 'E2E-' prefix — should match the message we just sent. // SearchBar is always visible in the AppBar bottom; no icon tap needed. _log('search'); await tester.enterText(find.byType(SearchBar), 'E2E-'); // Dismiss the IME keyboard so the results ListView.builder gets full // body height. On Android the soft keyboard reduces viewInsets.bottom, // leaving near-zero height for the body — ListView.builder then renders // 0 items and find.text() always fails even when results are present. FocusManager.instance.primaryFocus?.unfocus(); await tester.pump(); await pumpUntil( tester, find.text(subject), timeout: const Duration(seconds: 30), ); _log('search done'); expect(find.text(subject), findsOneWidget); }, ); }