@cometchat/skills 4.4.2 → 5.0.1

package/skills/cometchat-flutter-v5-push/SKILL.md

@@ -1,285 +0,0 @@
----
-name: cometchat-flutter-v5-push
-description: "Use when implementing push notifications with CometChat Flutter UIKit v5. Covers FCM (Android), APNs (iOS), VoIP calls, token lifecycle, local notifications, and tap-to-navigate."
-license: "MIT"
-compatibility: "cometchat_chat_uikit ^5.2.14; cometchat_calls_uikit ^5.0.15; firebase_messaging; flutter_local_notifications; flutter_callkit_incoming"
-metadata:
-  author: "CometChat"
-  version: "3.0.0"
-  tags: "cometchat flutter v5 push notifications fcm apns voip callkit firebase"
----
-
-> **Ground truth:** `cometchat_chat_uikit: ^5.2` (legacy/maintenance-only; calls via raw `cometchat_calls_sdk ^5.0.2`) — pub-cache source + `ui-kit/flutter/v5`. **Official docs:** https://www.cometchat.com/docs/notifications/overview · **Docs MCP:** `claude mcp add --transport http cometchat-docs https://www.cometchat.com/docs/mcp` (or fetch the URL directly without MCP). Verify symbols against the installed package/source before relying on them.
-
-# CometChat Flutter UIKit v5 — Push Notifications
-
-Push notification setup for Android (FCM) and iOS (APNs + VoIP).
-
-## Dependencies
-
-```yaml
-dependencies:
-  firebase_core: ^3.9.0
-  firebase_messaging: ^15.1.6
-  flutter_local_notifications: ^18.0.0
-  flutter_callkit_incoming: # for VoIP call notifications
-  app_badge_plus: ^1.2.6  # badge count
-```
-
-## Architecture Overview
-
-```
-notifications/
-├── models/
-│   ├── payload.dart              # PayloadData model for parsing FCM data
-│   ├── call_action.dart          # CallAction enum (initiated, cancelled, unanswered)
-│   ├── call_type.dart            # CallType enum (audio, video)
-│   └── notification_message_type.dart  # Message type constants
-├── services/
-│   ├── android_notification_service/
-│   │   ├── firebase_services.dart       # FCM init, listeners, token management
-│   │   ├── local_notification_handler.dart  # Local notification display + tap handling
-│   │   ├── voip_notification_handler.dart   # VoIP call display, accept, decline
-│   │   └── notification_launch_handler.dart # Terminated state launch handling
-│   ├── iOS_notification_service/
-│   │   └── apns_services.dart           # APNs connector, VoIP token, CallKit
-│   └── cometchat_service/
-│       └── cometchat_services.dart      # PNRegistry (token registration/unregistration)
-```
-
-## Token Registration — `CometChatNotifications.registerPushToken`
-
-The kit's only public push surface is `CometChatNotifications.registerPushToken(platform, {providerId, fcmToken, deviceToken, voipToken, onSuccess, onError})` (and `unregisterPushToken({onSuccess, onError})`). The sample app wraps this in an extension named `PNRegistry on CometChatService` (see `sample_app_push_notifications/lib/notifications/services/cometchat_service/cometchat_services.dart`) that picks the right provider ID + platform constant for FCM-Android / FCM-iOS / APNs / APNs-VoIP. **Copy that helper into your project, or call `CometChatNotifications.registerPushToken` directly** — `PNRegistry` is a sample-app extension, not importable from any cometchat package.
-
-```dart
-// Direct kit API:
-import 'package:cometchat_chat_uikit/cometchat_chat_uikit.dart';
-
-await CometChatNotifications.registerPushToken(
-  PushPlatforms.FCM_FLUTTER_ANDROID,    // platform — first positional arg
-  providerId: fcmProviderId,            // dashboard FCM provider ID
-  fcmToken: token,                      // use fcmToken / deviceToken / voipToken depending on platform
-  onSuccess: (response) => debugPrint('registered: $response'),
-  onError: (e) => debugPrint('register failed: $e'),
-);
-
-// On logout:
-await CometChatNotifications.unregisterPushToken(
-  onSuccess: (_) {},
-  onError: (e) => debugPrint('unregister failed: $e'),
-);
-```
-
-```dart
-// Or use the sample-app PNRegistry helper after copying it into your project:
-PNRegistry.registerPNService(token, true, false);   // (token, isFcm, isVoip)
-PNRegistry.unregisterPNService();
-```
-
-Platform mapping:
-- FCM Android → `PushPlatforms.FCM_FLUTTER_ANDROID`
-- FCM iOS → `PushPlatforms.FCM_FLUTTER_IOS`
-- APNs Device → `PushPlatforms.APNS_FLUTTER_DEVICE`
-- APNs VoIP → `PushPlatforms.APNS_FLUTTER_VOIP`
-
-Provider IDs come from `AppCredentials.fcmProviderId` / `AppCredentials.apnProviderId` (your own constants — these are dashboard-configured values, not kit exports).
-
-The remaining examples below assume you've copied `PNRegistry` from the sample app. If you call `CometChatNotifications.registerPushToken` directly, swap the call sites accordingly.
-
-## Android — FCM Setup
-
-### 1. Background handler (must be top-level function)
-
-```dart
-@pragma('vm:entry-point')
-Future<void> firebaseMessagingBackgroundHandler(RemoteMessage rMessage) async {
-  LocalNotificationService.showNotification(rMessage.data, rMessage, "", false);
-  await VoipNotificationHandler.displayIncomingCall(rMessage);
-}
-```
-
-### 2. Initialize in dashboard/home screen
-
-```dart
-class FirebaseService {
-  Future<void> init(BuildContext context) async {
-    _firebaseMessaging = FirebaseMessaging.instance;
-    await requestPermissions();
-    await initListeners(context);
-
-    String? token = await _firebaseMessaging.getToken();
-    if (token != null) {
-      PNRegistry.registerPNService(token, true, false);
-    }
-  }
-}
-```
-
-### 3. Listener setup
-
-```dart
-// Background messages
-FirebaseMessaging.onBackgroundMessage(firebaseMessagingBackgroundHandler);
-
-// Token refresh
-_firebaseMessaging.onTokenRefresh.listen((token) {
-  PNRegistry.registerPNService(token, true, false);
-});
-
-// Foreground messages
-FirebaseMessaging.onMessage.listen((message) {
-  LocalNotificationService.showNotification(message.data, message, conversationId, isAgentic);
-});
-
-// Tap from background
-FirebaseMessaging.onMessageOpenedApp.listen((message) {
-  openNotification(context, message, conversationId);
-});
-
-// Tap from terminated state
-FirebaseMessaging.instance.getInitialMessage().then((message) {
-  if (message != null) openNotification(context, message, conversationId);
-});
-```
-
-## iOS — APNs Setup
-
-```dart
-final _connector = ApnsPushConnector();
-_connector.shouldPresent = (x) => Future.value(false);
-
-_connector.configure(
-  onLaunch: (message) async { openNotification(message, context, ""); },
-  onResume: (message) async { openNotification(message, context, conversationId); },
-  onMessage: (message) async { _showNotification(message.data, message, conversationId, isAgentic); },
-);
-
-_connector.requestNotificationPermissions();
-
-// APNs device token
-_connector.token.addListener(() {
-  PNRegistry.registerPNService(_connector.token.value!, false, false);
-});
-
-// VoIP token
-FlutterCallkitIncoming.getDevicePushTokenVoIP().then((voipToken) {
-  PNRegistry.registerPNService(voipToken, false, true);
-});
-```
-
-## VoIP Call Notifications
-
-### Display incoming call (both platforms)
-
-```dart
-static Future<void> displayIncomingCall(RemoteMessage rMessage) async {
-  PayloadData callPayload = PayloadData.fromJson(rMessage.data);
-  if (callPayload.type == 'call' && callPayload.callAction == CallAction.initiated) {
-    CallKitParams params = CallKitParams(
-      id: callPayload.sessionId,
-      nameCaller: callPayload.senderName,
-      type: (callPayload.callType == CallType.audio) ? 0 : 1,
-      duration: 45000,
-    );
-    await FlutterCallkitIncoming.showCallkitIncoming(params);
-  }
-}
-```
-
-### Accept/Decline via CallKit events
-
-```dart
-FlutterCallkitIncoming.onEvent.listen((CallEvent? callEvent) {
-  switch (callEvent?.event) {
-    case Event.actionCallAccept:
-      VoipNotificationHandler.acceptVoipCall(callEvent, context);
-      break;
-    case Event.actionCallDecline:
-      VoipNotificationHandler.declineVoipCall(callEvent);
-      break;
-    case Event.actionCallTimeout:
-    case Event.actionCallEnded:
-      VoipNotificationHandler.endCall(sessionId: callEvent?.body['id']);
-      break;
-  }
-});
-```
-
-## Local Notification Display
-
-Uses `flutter_local_notifications` with inbox-style grouping per conversation:
-
-```dart
-// Skip if user is viewing the same conversation
-if (conversationId == notifConversationId) return;
-
-// Skip call-type notifications (handled by CallKit)
-if (data["type"] == "call") return;
-
-// Show with stable ID per conversation (replaces previous)
-final notificationId = conversationId.hashCode;
-await flutterLocalNotificationsPlugin.show(notificationId, title, body, details, payload: jsonPayload);
-```
-
-## Tap-to-Navigate
-
-```dart
-static void handleNotificationTap(NotificationResponse? response) async {
-  if (response?.payload != null) {
-    final body = jsonDecode(response!.payload!);
-    NotificationDataModel model = NotificationDataModel.fromJson(body);
-
-    User? user; Group? group;
-    if (model.receiverType == "user") {
-      user = await CometChat.getUser(model.sender);
-    } else {
-      group = await CometChat.getGroup(model.receiver);
-    }
-
-    if (model.type == "chat" && (user != null || group != null)) {
-      Navigator.of(CallNavigationContext.navigatorKey.currentContext!).push(
-        MaterialPageRoute(builder: (_) => MessagesSample(user: user, group: group)),
-      );
-    }
-  }
-}
-```
-
-## Terminated State Handling
-
-```dart
-// In main()
-final launchDetails = await flutterLocalNotificationsPlugin.getNotificationAppLaunchDetails();
-if (launchDetails?.didNotificationLaunchApp == true) {
-  NotificationLaunchHandler.pendingNotificationResponse = launchDetails!.notificationResponse;
-}
-
-// In dashboard initState()
-Future.delayed(Duration(milliseconds: 300), () {
-  final response = NotificationLaunchHandler.pendingNotificationResponse;
-  if (response != null) {
-    NotificationLaunchHandler.pendingNotificationResponse = null;
-    LocalNotificationService.handleNotificationTap(response, isTerminatedState: true);
-  }
-});
-```
-
-## Logout — Unregister Token
-
-```dart
-PNRegistry.unregisterPNService();
-// Then: CometChatUIKit.logout(...)
-```
-
-## Checklist — Push Notifications
-
-- [ ] Firebase initialized before CometChat init
-- [ ] FCM token registered via `PNRegistry.registerPNService(token, true, false)`
-- [ ] APNs device + VoIP tokens registered on iOS
-- [ ] Background handler is top-level `@pragma('vm:entry-point')` function
-- [ ] Token refresh listener re-registers token
-- [ ] Local notifications skip current active conversation
-- [ ] Call notifications handled via `FlutterCallkitIncoming`, not local notifications
-- [ ] Tap-to-navigate uses `CallNavigationContext.navigatorKey.currentContext`
-- [ ] Tokens unregistered on logout via `PNRegistry.unregisterPNService()`
-- [ ] Terminated state launch handled via `NotificationLaunchHandler`

package/skills/cometchat-flutter-v5-testing/SKILL.md

@@ -1,401 +0,0 @@
----
-name: cometchat-flutter-v5-testing
-description: Testing patterns for CometChat Flutter UIKit v5 (GetX-based). Covers flutter_test (built-in), mocktail for SDK mocking, widget tests around CometChat widgets, integration_test for real-device flows, golden tests for theming, and CI on GitHub Actions / Codemagic. Sister skill of cometchat-flutter-v6-testing — the cohorts have different state-management primitives (GetX vs Bloc) so test patterns differ.
-license: "MIT"
-compatibility: "Flutter >= 2.5, Dart >= 2.17; flutter_test (built-in); mocktail >= 1.0; integration_test (built-in); cometchat_chat_uikit ^5.2; cometchat_calls_uikit ^5.0"
-metadata:
-  author: "CometChat"
-  version: "4.0.0"
-  tags: "cometchat flutter v5 testing flutter-test mocktail widget-test integration-test golden-test getx ci codemagic"
----
-
-## Purpose
-
-Test recipes for Flutter UIKit v5. Covers the GetX-flavored patterns; v6 (Bloc) has its own skill (`cometchat-flutter-v6-testing`).
-
-**Read these other skills first:**
-- `cometchat-flutter-v5-core` — UIKitSettingsBuilder, init/login order, GetX scope rules
-- `cometchat-flutter-v5-events` — event subscription patterns the tests assert against
-
-**Ground truth:** **Official docs:** https://www.cometchat.com/docs/ui-kit/flutter/v5/overview · **Docs MCP:** `claude mcp add --transport http cometchat-docs https://www.cometchat.com/docs/mcp` (or fetch the URL directly without MCP).
-- flutter_test — https://api.flutter.dev/flutter/flutter_test/flutter_test-library.html
-- mocktail — https://pub.dev/packages/mocktail
-
----
-
-## 1. Test layers
-
-| Layer | Test runner | Speed | What it covers |
-|---|---|---|---|
-| Unit | `flutter test` (Dart VM) | Fastest | Pure Dart logic — services, models |
-| Widget | `flutter test` (test environment) | Fast | Single widget, mocked dependencies |
-| Integration | `flutter test integration_test/` (real device or simulator) | Slow | Full app flow, real SDK or mocked |
-| Golden | `flutter test --update-goldens` then assert | Fast | Visual regression |
-
-The skill writes all four; CI runs unit + widget + golden by default; integration runs on demand.
-
----
-
-## 2. Mocking the SDK with mocktail
-
-```yaml
-# pubspec.yaml — dev dependencies
-dev_dependencies:
-  flutter_test:
-    sdk: flutter
-  mocktail: ^1.0.0
-  integration_test:
-    sdk: flutter
-```
-
-### Wrap the SDK in protocols (testable abstraction)
-
-```dart
-// lib/services/cometchat_service.dart
-import 'package:cometchat_calls_uikit/cometchat_calls_uikit.dart';
-
-abstract class CometChatService {
-  Future<void> init();
-  Future<User> login(String uid);
-  Future<void> logout();
-  User? getLoggedInUser();
-  Future<TextMessage> sendMessage(TextMessage message);
-}
-
-class CometChatServiceImpl implements CometChatService {
-  @override
-  Future<void> init() async {
-    final settings = (UIKitSettingsBuilder()
-          ..appId = CometChatConfig.appId
-          ..region = CometChatConfig.region
-          ..authKey = CometChatConfig.authKey
-          ..subscriptionType = CometChatSubscriptionType.allUsers
-          ..callingExtension = CometChatCallingExtension())
-        .build();
-    await CometChatUIKit.init(uiKitSettings: settings);
-  }
-
-  @override
-  Future<User> login(String uid) async {
-    final completer = Completer<User>();
-    CometChatUIKit.login(uid, onSuccess: completer.complete, onError: completer.completeError);
-    return completer.future;
-  }
-
-  @override
-  Future<void> logout() async {
-    final completer = Completer<void>();
-    CometChatUIKit.logout(onSuccess: () => completer.complete(), onError: completer.completeError);
-    return completer.future;
-  }
-
-  @override
-  // Sync accessor → the static field. CometChatUIKit.getLoggedInUser() is async
-  // (Future<User?>) and would not satisfy this `User?` signature.
-  User? getLoggedInUser() => CometChatUIKit.loggedInUser;
-
-  @override
-  Future<TextMessage> sendMessage(TextMessage message) async {
-    final completer = Completer<TextMessage>();
-    // sendTextMessage takes message as positional, not named (verified cometchat_ui_kit.dart:357).
-    CometChatUIKit.sendTextMessage(message, onSuccess: completer.complete, onError: completer.completeError);
-    return completer.future;
-  }
-}
-```
-
-Inject via your DI / GetX scope:
-
-```dart
-final cometchatService = Get.put<CometChatService>(CometChatServiceImpl());
-```
-
-In tests, swap with a mock:
-
-```dart
-class MockCometChatService extends Mock implements CometChatService {}
-
-setUp(() {
-  Get.reset();
-  final mock = MockCometChatService();
-  when(() => mock.init()).thenAnswer((_) async {});
-  when(() => mock.login(any())).thenAnswer((_) async => testUser);
-  Get.put<CometChatService>(mock);
-});
-
-tearDown(() {
-  Get.reset();
-});
-```
-
-**`Get.reset()`** between tests is critical — GetX's singleton container persists across tests otherwise.
-
----
-
-## 3. Widget tests
-
-```dart
-import 'package:flutter/material.dart';
-import 'package:flutter_test/flutter_test.dart';
-import 'package:mocktail/mocktail.dart';
-import 'package:get/get.dart';
-import 'package:your_app/screens/chat_screen.dart';
-import 'package:your_app/services/cometchat_service.dart';
-
-class MockCometChatService extends Mock implements CometChatService {}
-
-void main() {
-  late MockCometChatService mock;
-
-  setUp(() {
-    Get.reset();
-    mock = MockCometChatService();
-    when(() => mock.init()).thenAnswer((_) async {});
-    when(() => mock.login(any())).thenAnswer((_) async => User(uid: 'cometchat-uid-1', name: 'Alice'));
-    Get.put<CometChatService>(mock);
-  });
-
-  tearDown(() => Get.reset());
-
-  testWidgets('shows loading until login resolves', (tester) async {
-    final loginCompleter = Completer<User>();
-    when(() => mock.login(any())).thenAnswer((_) => loginCompleter.future);
-
-    await tester.pumpWidget(MaterialApp(home: ChatScreen()));
-    await tester.pump();                                     // start the build
-
-    expect(find.byType(CircularProgressIndicator), findsOneWidget);
-
-    // User constructor requires both uid AND name (verified User constructor in chat-sdk-flutter).
-    loginCompleter.complete(User(uid: 'cometchat-uid-1', name: 'Alice'));
-    await tester.pumpAndSettle();
-
-    expect(find.byType(CircularProgressIndicator), findsNothing);
-    expect(find.text('Conversations'), findsOneWidget);
-  });
-
-  testWidgets('shows error when login fails', (tester) async {
-    when(() => mock.login(any())).thenThrow(Exception('401 Unauthorized'));
-
-    await tester.pumpWidget(MaterialApp(home: ChatScreen()));
-    await tester.pumpAndSettle();
-
-    expect(find.textContaining('Unauthorized'), findsOneWidget);
-  });
-}
-```
-
-`pumpAndSettle()` waits for animations + Futures to complete.
-
----
-
-## 4. Mocking CometChat widgets that ship with the kit
-
-`CometChatConversations`, `CometChatMessageList`, etc. are real widgets that try to render against a real SDK during tests. Two strategies:
-
-### Strategy A — Replace at the import level
-
-If your widget composition is small (3-5 CometChat widgets), make them swappable:
-
-```dart
-// chat_screen.dart
-class ChatScreen extends StatelessWidget {
-  final WidgetBuilder conversationsBuilder;
-
-  const ChatScreen({this.conversationsBuilder = _defaultConversations});
-
-  static Widget _defaultConversations(BuildContext context) =>
-      const CometChatConversations();
-
-  @override
-  Widget build(BuildContext context) => Scaffold(body: conversationsBuilder(context));
-}
-
-// In tests:
-testWidgets('chat screen renders', (tester) async {
-  await tester.pumpWidget(MaterialApp(
-    home: ChatScreen(conversationsBuilder: (_) => const Text('mock convo list')),
-  ));
-  expect(find.text('mock convo list'), findsOneWidget);
-});
-```
-
-### Strategy B — Skip widget tests, focus on service tests
-
-For larger compositions, test the service layer (which is fully mockable) and rely on integration tests for widget assertions. Pragmatic for v5 because the kit's widgets aren't designed for unit testing.
-
----
-
-## 5. Integration tests
-
-```dart
-// integration_test/chat_test.dart
-import 'package:flutter/material.dart';
-import 'package:flutter_test/flutter_test.dart';
-import 'package:integration_test/integration_test.dart';
-import 'package:your_app/main.dart' as app;
-
-void main() {
-  IntegrationTestWidgetsFlutterBinding.ensureInitialized();
-
-  testWidgets('login and see conversations', (tester) async {
-    app.main();
-    await tester.pumpAndSettle(Duration(seconds: 10));      // generous for real SDK init
-
-    expect(find.text('Welcome'), findsOneWidget);
-
-    await tester.tap(find.text('Messages'));
-    await tester.pumpAndSettle();
-
-    // Real SDK + real test app: assert that at least one conversation exists
-    // (cometchat-uid-1 has pre-seeded conversations with uid-2..5)
-    expect(find.byType(ListTile), findsAtLeastNWidgets(1));
-  });
-}
-```
-
-Run on a real device or simulator:
-
-```bash
-flutter test integration_test/chat_test.dart
-```
-
-For CI:
-
-```bash
-flutter test integration_test/chat_test.dart --device-id=emulator-5554
-```
-
----
-
-## 6. Golden tests
-
-```dart
-testWidgets('chat bubble renders correctly in light theme', (tester) async {
-  await tester.pumpWidget(MaterialApp(
-    theme: ThemeData.light(),
-    home: Scaffold(
-      body: ChatBubble(
-        // TextMessage requires: text, receiverUid, type, receiverType + sender (User object).
-        // senderUid is NOT a TextMessage constructor param — set via sender (User).
-        message: TextMessage(
-          text: 'Hello',
-          receiverUid: 'bob',
-          type: 'text',
-          receiverType: 'user',
-          sender: User(uid: 'alice', name: 'Alice'),
-        ),
-      ),
-    ),
-  ));
-
-  await expectLater(
-    find.byType(ChatBubble),
-    matchesGoldenFile('goldens/chat_bubble_light.png'),
-  );
-});
-```
-
-First run:
-
-```bash
-flutter test --update-goldens
-```
-
-Commit the `goldens/` folder. Subsequent runs assert against it.
-
-**Gotcha:** golden tests are pixel-perfect; small rendering differences between Flutter versions / OS versions cause failures. Pin Flutter SDK version in CI.
-
----
-
-## 7. CI configuration
-
-### GitHub Actions
-
-```yaml
-name: tests
-on: [push, pull_request]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: subosito/flutter-action@v2
-        with: { flutter-version: 3.16.0, channel: stable }
-      - run: flutter pub get
-      - run: flutter test
-        env:
-          COMETCHAT_TEST_APP_ID:    ${{ secrets.TEST_COMETCHAT_APP_ID }}
-          COMETCHAT_TEST_REGION:    ${{ secrets.TEST_COMETCHAT_REGION }}
-          COMETCHAT_TEST_AUTH_KEY:  ${{ secrets.TEST_COMETCHAT_AUTH_KEY }}
-
-  integration:
-    runs-on: macos-13
-    needs: test
-    steps:
-      - uses: actions/checkout@v4
-      - uses: subosito/flutter-action@v2
-        with: { flutter-version: 3.16.0, channel: stable }
-      - uses: futureware-tech/simulator-action@v3
-        with: { model: "iPhone 15", os: iOS, os_version: "17.0" }
-      - run: flutter pub get
-      - run: |
-          flutter test integration_test/chat_test.dart \
-            --dart-define=COMETCHAT_APP_ID=${{ secrets.TEST_COMETCHAT_APP_ID }} \
-            --dart-define=COMETCHAT_REGION=${{ secrets.TEST_COMETCHAT_REGION }} \
-            --dart-define=COMETCHAT_AUTH_KEY=${{ secrets.TEST_COMETCHAT_AUTH_KEY }}
-```
-
-### Codemagic
-
-Codemagic is Flutter-native. Add a workflow:
-
-```yaml
-workflows:
-  test:
-    name: Flutter tests
-    instance_type: mac_mini_m1
-    scripts:
-      - name: Get dependencies
-        script: flutter pub get
-      - name: Run tests
-        script: flutter test
-      - name: Run integration tests
-        script: |
-          flutter test integration_test/chat_test.dart \
-            --dart-define=COMETCHAT_APP_ID=$COMETCHAT_APP_ID \
-            ...
-```
-
-Codemagic's env vars come from the project settings UI.
-
----
-
-## 8. Anti-patterns
-
-1. **Skipping `Get.reset()`** between tests. GetX singletons persist across tests; "test 2 inherits test 1's state" flakes are common.
-2. **Awaiting `pumpAndSettle()` with no timeout.** Real SDK calls can hang; tests timeout after 30s with no useful error. Pass `Duration(seconds: 10)` explicitly.
-3. **Using `mocktail` without registering all dependencies.** `Get.put` requires every injected service; partial mocks crash with "not registered."
-4. **Hardcoding the Auth Key in test files.** Use `--dart-define` flags. Same rule as production.
-5. **Goldens that depend on system fonts.** They render differently on macOS vs Linux CI. Use `Roboto` (Material default) and pin Flutter SDK version.
-6. **Real WebSocket calls in unit tests.** The CometChat SDK opens a WebSocket on init; if you call real `init` in a unit test, the test slows to seconds and may flake. Mock the service.
-
-## 9. Verification checklist
-
-- [ ] `CometChatService` abstraction (or similar) wrapping the SDK
-- [ ] `MockCometChatService` in test setup; `Get.put<CometChatService>(mock)` per test
-- [ ] `Get.reset()` in tearDown
-- [ ] At least one widget test for "loading state until login resolves"
-- [ ] At least one widget test for "error UI on init/login failure"
-- [ ] Golden tests for at least one chat surface (light + dark theme)
-- [ ] Integration test in `integration_test/` for the login + see conversations flow
-- [ ] CI separates unit + integration; uses dedicated CometChat test app via `--dart-define`
-- [ ] Flutter SDK version pinned in CI (no "channel: stable" alone)
-
-## 10. Pointers
-
-- `cometchat-flutter-v5-core` — UIKitSettingsBuilder, init/login order
-- `cometchat-flutter-v5-events` — listener subscription patterns
-- `cometchat-flutter-v5-troubleshooting` — when tests pass but production breaks
-- `cometchat-flutter-v6-testing` — V6 patterns (Bloc-based; different)