sharedinbox/integration_test/app_e2e_test.dart

// 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<imap.ImapClient> _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<imap.SmtpClient> _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 = <String, String>{};

  @override
  Future<void> write({required String key, required String? value}) async {
    if (value == null) {
      _store.remove(key);
    } else {
      _store[key] = value;
    }
  }

  @override
  Future<String?> read({required String key}) async => _store[key];

  @override
  Future<void> 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<void> 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 navigation menu'));
      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 navigation menu'));
      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);
    },
  );
}