@cometchat/skills 4.4.1 → 5.0.0

package/skills/cometchat-flutter-v6-calls/references/call-layouts.md

@@ -1,105 +0,0 @@
-# Call layouts on Flutter V6 (Bloc)
-
-Same SDK shape; Bloc-driven layout state.
-
-**Canonical docs:** https://www.cometchat.com/docs/calls/flutter/call-layouts
-**Read first:** `cometchat-flutter-v5-calls/references/call-layouts.md` — SegmentedButton pattern + SDK API.
-
----
-
-## Cubit (single-state, no events overhead)
-
-A layout switcher is a great fit for a Cubit since it has only one piece of state with simple updates.
-
-`setLayout` is an **instance method on the `CallSession` singleton** (`cometchat_calls_sdk-5.0.2` `src/call_session.dart:394`), and the layout enum is `LayoutType { tile, sidebar, spotlight }` (`src/enums/layout_type.dart`) — there is no `CallLayout` type and no static `CometChatCalls.setLayout`.
-
-```dart
-class CallLayoutCubit extends Cubit<LayoutType> {
-  CallLayoutCubit() : super(LayoutType.tile);
-
-  void set(LayoutType next) {
-    CallSession.getInstance()?.setLayout(next);
-    emit(next);
-  }
-
-  void onSDKChanged(LayoutType next) {
-    emit(next);  // already changed by kit's switcher; just sync
-  }
-}
-```
-
-Hook the SDK event — `onCallLayoutChanged` is on `LayoutListeners`, attached via the `layoutListener` setter (`src/call_session.dart:98`):
-
-```dart
-// e.g. CallSession.getInstance()?.layoutListener = myLayoutListener;
-@override
-void onCallLayoutChanged(LayoutType layout) {
-  context.read<CallLayoutCubit>().onSDKChanged(layout);
-}
-```
-
----
-
-## Switcher widget
-
-```dart
-class LayoutSwitcher extends StatelessWidget {
-  const LayoutSwitcher({super.key});
-
-  @override
-  Widget build(BuildContext context) {
-    return BlocBuilder<CallLayoutCubit, LayoutType>(
-      builder: (context, layout) => SegmentedButton<LayoutType>(
-        segments: const [
-          ButtonSegment(value: LayoutType.tile, label: Text('Tile')),
-          ButtonSegment(value: LayoutType.sidebar, label: Text('Sidebar')),
-          ButtonSegment(value: LayoutType.spotlight, label: Text('Spotlight')),
-        ],
-        selected: {layout},
-        onSelectionChanged: (set) {
-          if (set.isNotEmpty) {
-            context.read<CallLayoutCubit>().set(set.first);
-          }
-        },
-      ),
-    );
-  }
-}
-```
-
----
-
-## Provide the cubit at call start
-
-```dart
-BlocProvider<CallLayoutCubit>(
-  create: (_) => CallLayoutCubit(),
-  child: const CallScreen(),
-);
-```
-
----
-
-## Anti-patterns
-
-V5 sister rules apply, plus V6-specific:
-
-1. **Using a full Bloc when Cubit fits.** Layout switcher is one-state-update — Cubit avoids the events boilerplate.
-2. **`BlocListener` for switcher rebuild.** Use `BlocBuilder` — switcher *is* a UI that depends on state, not a side-effect.
-
----
-
-## Verification checklist
-
-- [ ] `CallLayoutCubit` provided above the call screen
-- [ ] `BlocBuilder` wraps the switcher
-- [ ] `onCallLayoutChanged` syncs the cubit
-- [ ] Real-device smoke: switcher cycles all 3 on Android + iOS
-
----
-
-## Pointers
-
-- `cometchat-flutter-v5-calls/references/call-layouts.md` — V5 sister (GetX)
-- `cometchat-flutter-v6-calls` SKILL.md
-- Canonical docs: https://www.cometchat.com/docs/calls/flutter/call-layouts

package/skills/cometchat-flutter-v6-calls/references/call-session.md

@@ -1,229 +0,0 @@
-# Call session — joinSession with no ringing (Flutter V6 / Bloc)
-
-Bloc-driven adaptation of the upstream sample. Same SDK underneath as V5 (`cometchat_calls_sdk`); the V6 kit (`cometchat_chat_uikit ^6.0.0`) is OPTIONAL for session-only flows.
-
-**Read first:**
-- `cometchat-flutter-v5-calls/references/call-session.md` — V5 sister, canonical SDK API surface (callback shape, `SessionSettingsBuilder`, `SessionStatusListeners`)
-- `cometchat-react-calls/references/call-session.md` — full cross-platform architecture
-
-**Source of truth:** `calls-sdk-flutter-5/sample-apps/cometchat-calls-sample-app-flutter/lib/screens/call_screen.dart` (the SDK version is the same; only the state-management primitive differs between v5 GetX and v6 Bloc).
-
----
-
-## Hard rules
-
-All V5 rules apply (callback API, `SessionSettingsBuilder`, `SessionStatusListeners` interface, `CometChatOngoingCallService.launch/abort`, `SizedBox.expand`, no Chat SDK for session-only). The V6-specific delta is:
-
-1. **Cubit, not full Bloc.** Single 1-state-update flow — Cubit is the right primitive. Don't introduce events + reducer ceremony.
-2. **`BlocConsumer` for auto-pop on idle transition** — combines side-effect (Navigator.pop on terminated) with builder (loading / error / active UI).
-3. **Cubit holds the listener references**, not the widget. `close()` calls `removeSessionStatusListener` + `CometChatOngoingCallService.abort()`.
-
----
-
-## Cubit
-
-```dart
-import 'package:bloc/bloc.dart';
-import 'package:cometchat_calls_sdk/cometchat_calls_sdk.dart';
-import 'package:equatable/equatable.dart';
-import 'package:flutter/widgets.dart';
-import 'package:permission_handler/permission_handler.dart';
-
-enum CallSessionStatus { idle, requesting, joining, active, leaving, error }
-
-class CallSessionState extends Equatable {
-  final CallSessionStatus status;
-  final Widget? videoWidget;
-  final String? error;
-  const CallSessionState({this.status = CallSessionStatus.idle, this.videoWidget, this.error});
-
-  CallSessionState copyWith({
-    CallSessionStatus? status,
-    Widget? videoWidget,
-    String? error,
-  }) =>
-      CallSessionState(
-        status: status ?? this.status,
-        videoWidget: videoWidget ?? this.videoWidget,
-        error: error ?? this.error,
-      );
-
-  @override
-  List<Object?> get props => [status, videoWidget, error];
-}
-
-class CallSessionCubit extends Cubit<CallSessionState> implements SessionStatusListeners {
-  CallSessionCubit() : super(const CallSessionState());
-
-  CallSession? _callSession;
-
-  Future<void> join(String sessionId) async {
-    if (state.status != CallSessionStatus.idle) return;
-    emit(state.copyWith(status: CallSessionStatus.requesting));
-
-    final cam = await Permission.camera.request();
-    final mic = await Permission.microphone.request();
-    if (!cam.isGranted || !mic.isGranted) {
-      emit(state.copyWith(status: CallSessionStatus.error, error: 'Permission denied'));
-      return;
-    }
-
-    emit(state.copyWith(status: CallSessionStatus.joining));
-
-    final settings = (SessionSettingsBuilder()
-          .setTitle('CometChat Meeting')
-          .startVideoPaused(false)
-          .startAudioMuted(false))
-        .build();
-
-    CometChatCalls.joinSession(
-      sessionId: sessionId,
-      sessionSettings: settings,
-      onSuccess: (Widget? widget) {
-        _callSession = CallSession.getInstance();
-        _callSession?.addSessionStatusListener(this);
-        CometChatOngoingCallService.launch();
-        emit(state.copyWith(status: CallSessionStatus.active, videoWidget: widget));
-      },
-      onError: (CometChatCallsException error) {
-        emit(state.copyWith(status: CallSessionStatus.error, error: error.message ?? 'Failed'));
-      },
-    );
-  }
-
-  Future<void> leave() async {
-    if (state.status == CallSessionStatus.idle) return;
-    emit(state.copyWith(status: CallSessionStatus.leaving));
-    try {
-      await _callSession?.leaveSession();
-    } catch (_) {
-      // best-effort
-    }
-    await CometChatOngoingCallService.abort();
-    emit(const CallSessionState());  // back to idle
-  }
-
-  // --- SessionStatusListeners ---
-  @override
-  void onSessionJoined() {
-    CometChatOngoingCallService.launch();
-  }
-
-  // All termination events funnel through ONE guarded _handleTermination().
-  // The v5 Calls SDK fires onSessionLeft + onConnectionClosed in sequence on
-  // every hangup. Without the guard, abort() + emit() fire 3 times (wasteful
-  // and races with cubit close on rapid leave/rejoin).
-  bool _isTerminating = false;
-  void _handleTermination() {
-    if (_isTerminating) return;
-    _isTerminating = true;
-    CometChatOngoingCallService.abort();
-    emit(const CallSessionState());
-  }
-
-  @override
-  void onSessionLeft() => _handleTermination();
-
-  @override
-  void onConnectionClosed() => _handleTermination();
-
-  @override
-  void onSessionTimedOut() => _handleTermination();
-
-  @override
-  void onConnectionLost() {}
-  @override
-  void onConnectionRestored() {}
-
-  @override
-  Future<void> close() async {
-    _callSession?.removeSessionStatusListener(this);
-    if (state.status != CallSessionStatus.idle) {
-      await CometChatOngoingCallService.abort();
-      try {
-        await _callSession?.leaveSession();
-      } catch (_) {}
-    }
-    return super.close();
-  }
-}
-```
-
----
-
-## Call room widget
-
-```dart
-class CallRoom extends StatelessWidget {
-  final String sessionId;
-  const CallRoom({super.key, required this.sessionId});
-
-  @override
-  Widget build(BuildContext context) {
-    return BlocProvider<CallSessionCubit>(
-      create: (_) => CallSessionCubit()..join(sessionId),
-      child: BlocConsumer<CallSessionCubit, CallSessionState>(
-        listenWhen: (prev, curr) =>
-            prev.status != CallSessionStatus.idle && curr.status == CallSessionStatus.idle,
-        listener: (context, state) => Navigator.of(context).pop(),
-        builder: (context, state) {
-          if (state.status == CallSessionStatus.error) {
-            return Scaffold(
-              backgroundColor: Colors.black,
-              body: Center(child: Text('Error: ${state.error}', style: const TextStyle(color: Colors.white))),
-            );
-          }
-          if (state.status != CallSessionStatus.active || state.videoWidget == null) {
-            return const Scaffold(
-              backgroundColor: Colors.black,
-              body: Center(child: CircularProgressIndicator(color: Colors.white)),
-            );
-          }
-          return Scaffold(
-            backgroundColor: Colors.black,
-            body: SizedBox.expand(child: state.videoWidget),
-          );
-        },
-      ),
-    );
-  }
-}
-```
-
----
-
-## Anti-patterns
-
-V5 sister rules apply, plus V6-specific:
-
-1. **Storing the returned widget in the cubit's `_controller` field** as if it were a controller. The `Widget?` IS what you render — there is no controller layer in the v5 Calls SDK.
-2. **Full Bloc with events for a 1-state-update flow.** Cubit fits cleanly.
-3. **`BlocBuilder` instead of `BlocConsumer`.** Need both side-effect (auto-pop) and builder (loading/error UI).
-4. **Forgetting `..join(sessionId)` cascade.** Cubit created but never starts joining.
-5. **Forgetting to call `CometChatOngoingCallService.abort()` in `close()`.** Service notification persists after route pops.
-6. **`CometChatOngoingCallController` / `CometChatOngoingCallView`.** These do not exist in the v5 Calls SDK API. Use the `Widget?` returned by `onSuccess` directly.
-
----
-
-## Verification checklist
-
-- [ ] Cubit implements `SessionStatusListeners` and registers itself in `onSuccess`
-- [ ] `joinSession` called with `sessionId:`, `sessionSettings:`, `onSuccess:`, `onError:`
-- [ ] Settings built via `SessionSettingsBuilder()`, not `CallSettings`
-- [ ] `BlocProvider` creates cubit and triggers `..join(sessionId)`
-- [ ] `BlocConsumer.listener` pops route on idle transition
-- [ ] Loading / error UI for non-active states
-- [ ] Widget rendered via `SizedBox.expand(child: state.videoWidget)`
-- [ ] `close()` removes listener + aborts ongoing-call service + best-effort leaves
-- [ ] **Standalone session-only:** no `cometchat_chat_sdk` dependency — Calls SDK alone
-- [ ] Real-device smoke: same as V5 sister
-
----
-
-## Pointers
-
-- `cometchat-flutter-v5-calls/references/call-session.md` — V5 sister + canonical SDK API
-- `cometchat-flutter-v6-calls/SKILL.md` — V6 Bloc patterns
-- `cometchat-flutter-v6-calls/references/share-invite.md` — deep-link config
-- Upstream sample — `calls-sdk-flutter-5/sample-apps/cometchat-calls-sample-app-flutter/lib/screens/call_screen.dart` (SDK is the same)
-- Canonical docs: https://www.cometchat.com/docs/calls/flutter/join-session

package/skills/cometchat-flutter-v6-calls/references/device-management.md

@@ -1,105 +0,0 @@
-# Device management on Flutter V6 (Bloc)
-
-Same SDK API as V5; Bloc-based state.
-
-**Canonical docs:** https://www.cometchat.com/docs/calls/flutter/device-management
-**Read first:** `cometchat-flutter-v5-calls/references/device-management.md` — SDK shape + flutter_callkit_incoming integration.
-
----
-
-## SDK API
-
-These are **instance methods on the `CallSession` singleton**, not static on `CometChatCalls` (verified `cometchat_calls_sdk-5.0.2`):
-
-- `CallSession.getInstance()?.switchCamera()` — front/back flip (`src/call_session.dart:205`).
-- Audio output is **not** a `setSpeakerEnabled(bool)` toggle (no such method exists). Use `CallSession.getInstance()?.setAudioModeType(AudioMode)` (`src/call_session.dart:381`), where `AudioMode` is the enum `{ speaker, earpiece, bluetooth }` (`src/enums/audio_mode.dart`).
-
----
-
-## Bloc-driven device state
-
-```dart
-class DeviceState extends Equatable {
-  final bool speakerOn;
-  final bool cameraIsBack;
-  const DeviceState({this.speakerOn = false, this.cameraIsBack = false});
-  DeviceState copyWith({bool? speakerOn, bool? cameraIsBack}) =>
-    DeviceState(
-      speakerOn: speakerOn ?? this.speakerOn,
-      cameraIsBack: cameraIsBack ?? this.cameraIsBack,
-    );
-  @override List<Object> get props => [speakerOn, cameraIsBack];
-}
-
-abstract class DeviceEvent {}
-class ToggleSpeaker extends DeviceEvent {}
-class FlipCamera extends DeviceEvent {}
-
-class DeviceBloc extends Bloc<DeviceEvent, DeviceState> {
-  DeviceBloc() : super(const DeviceState()) {
-    on<ToggleSpeaker>((event, emit) {
-      final next = !state.speakerOn;
-      // No setSpeakerEnabled(bool); route audio via the AudioMode enum.
-      CallSession.getInstance()?.setAudioModeType(
-        next ? AudioMode.speaker : AudioMode.earpiece,
-      );
-      emit(state.copyWith(speakerOn: next));
-    });
-    on<FlipCamera>((event, emit) {
-      CallSession.getInstance()?.switchCamera();
-      emit(state.copyWith(cameraIsBack: !state.cameraIsBack));
-    });
-  }
-}
-```
-
----
-
-## Toggle widgets
-
-```dart
-class SpeakerToggle extends StatelessWidget {
-  const SpeakerToggle({super.key});
-
-  @override
-  Widget build(BuildContext context) {
-    return BlocBuilder<DeviceBloc, DeviceState>(
-      buildWhen: (prev, curr) => prev.speakerOn != curr.speakerOn,
-      builder: (context, state) => IconButton(
-        icon: Icon(state.speakerOn ? Icons.volume_up : Icons.hearing),
-        onPressed: () => context.read<DeviceBloc>().add(ToggleSpeaker()),
-        tooltip: state.speakerOn ? 'Switch to earpiece' : 'Switch to speaker',
-      ),
-    );
-  }
-}
-```
-
-`buildWhen` prevents re-rendering on unrelated state changes — important during a video call where rebuild thrash hurts performance.
-
----
-
-## Anti-patterns
-
-Same as V5; plus V6-specific:
-
-1. **`buildWhen` omitted.** Every state emit re-renders every BlocBuilder.
-2. **Calling SDK methods inside Bloc handlers without try/catch.** Throwing inside the handler crashes the bloc.
-
----
-
-## Verification checklist
-
-- [ ] DeviceBloc with `ToggleSpeaker` + `FlipCamera` events
-- [ ] BlocBuilder uses `buildWhen` for narrow rebuilds
-- [ ] State is `Equatable` with proper `props`
-- [ ] Real-device smoke: speaker toggle, camera flip both work
-
----
-
-## Pointers
-
-- `cometchat-flutter-v5-calls/references/device-management.md` — V5 sister
-- `cometchat-flutter-v6-calls` SKILL.md
-- `cometchat-flutter-v6-calls/references/raise-hand.md` — Bloc pattern sibling
-- Canonical docs: https://www.cometchat.com/docs/calls/flutter/device-management

package/skills/cometchat-flutter-v6-calls/references/group-calls.md

@@ -1,190 +0,0 @@
-# Group calls — broadcast meeting pattern (Flutter V6)
-
-Group calls use a **different signaling channel than 1:1 user calls**. The Ringing flow (`CometChat.initiateCall` → `onIncomingCallReceived` on peer) is **1:1 user only**. For groups, the kit broadcasts a **custom message of type `"meeting"`** to the group; receivers see a "Join meeting" card in `CometChatMessageList` (kit) or need an explicit `MessageListener.onCustomMessageReceived` (custom UI).
-
-By-design kit behavior — same semantic across all CometChat kits.
-
-**Canonical docs:** https://www.cometchat.com/docs/calls/flutter/group-calls
-
-V6 specifics: Flutter V6 folds calls into `cometchat_chat_uikit ^6.0.1` (no separate calls package). Bloc-based state. The outgoing→in-call transition bug that existed in `6.0.0-beta2` is **FIXED in 6.0.1 GA** (see SKILL.md §1.7) — the kit-driven path now works for groups too, **provided `navigatorKey: CallNavigationContext.navigatorKey` is wired on your MaterialApp**. The custom-UI path below remains a valid alternative (and is required if you render your own call surface).
-
----
-
-## Architecture
-
-```
-Caller (uidA, member of groupX)        CometChat                Receivers (members of groupX)
-  │                                       │                              │
-  │ CometChatCallButtons / custom code    │                              │
-  │ sends CustomMessage(GUID, GROUP,      │                              │
-  │   "meeting", { callType, sessionId }) │                              │
-  ├──────────────────────────────────────>│                              │
-  │                                       │ onCustomMessageReceived      │
-  │                                       ├─────────────────────────────>│
-  │ caller pushes OngoingCall screen      │  receiver taps Join          │
-  │  with sessionID = groupGuid           │  → joinSession(GUID)         │
-  ├──────────────────────────────────────>│ <─────────────────────────── │
-  │            ───── WebRTC session active (sessionId = group GUID) ─────│
-```
-
-| Channel | 1:1 user calls | Group calls |
-|---|---|---|
-| Signaling | `CometChat.initiateCall(call, callback)` | `CometChat.sendCustomMessage(message, callback)` (type="meeting") |
-| Receiver event | `CallListener.onIncomingCallReceived` | `MessageListener.onCustomMessageReceived` |
-| Session ID | server-generated unique | group's GUID (persistent) |
-
----
-
-## Hard rules
-
-1. **Group calls broadcast a custom message; they do NOT use the call listener.** Custom UI must add a `MessageListener`.
-2. **Session ID = group GUID.** Persistent.
-3. **`navigatorKey` is mandatory for the kit's group call screen** (SKILL.md §1.7). With it wired, the kit's outgoing→ongoing transition works on 6.0.1 (the beta2 bug is fixed). Without it, the outgoing-call screen never renders — this is the one remaining requirement, not a reason to avoid the kit path.
-4. **`navigatorKey: CallNavigationContext.navigatorKey` required on MaterialApp** if using ANY kit-driven call UI path (group or 1:1) — same as the SKILL rule.
-5. **No `CometChat.endCall` for groups.** Use `CometChatUIKitCalls.endSession()` only.
-
----
-
-## Caller side — kit-based
-
-```dart
-import 'package:cometchat_chat_uikit/cometchat_chat_uikit.dart';
-
-CometChatCallButtons(
-  group: group,
-)
-```
-
-Tap → kit sends meeting `CustomMessage` + opens outgoing-call screen.
-
-> **✅ On 6.0.1 the outgoing→in-call transition works** once `navigatorKey: CallNavigationContext.navigatorKey` is wired on MaterialApp (SKILL §1.7). Without that wiring the caller sees "Calling..." indefinitely — so wire it. The custom-UI path below is an alternative for apps that render their own call surface.
-
-## Caller side — custom UI (alternative to the kit path)
-
-```dart
-import 'package:flutter_chat_sdk/flutter_chat_sdk.dart';
-
-Future<void> startGroupCall(BuildContext context, String groupGuid, String callType) async {
-  final sessionId = groupGuid;
-  final customData = {'callType': callType, 'sessionId': sessionId};
-
-  final meetingMessage = CustomMessage(
-    receiverUid: groupGuid,
-    receiverType: CometChatReceiverType.group,
-    customData: customData,
-    type: 'meeting',
-  )
-    ..category = MessageCategoryConstants.custom
-    ..metadata = {
-      'incrementUnreadCount': true,
-      'pushNotification': 'meeting',
-      ...customData,
-    };
-
-  await CometChat.sendCustomMessage(
-    meetingMessage,
-    onSuccess: (msg) {
-      // Caller navigates to YOUR OngoingCall screen (not the kit's)
-      Navigator.of(context).pushNamed('/ongoing-call', arguments: {
-        'sessionId': sessionId,
-        'callType': callType,
-      });
-    },
-    onError: (e) {/* surface error */},
-  );
-}
-```
-
-Then in your custom `/ongoing-call` screen, join the session against your own RTC view — same primitives the kit uses internally, but you control the navigation. On the raw Calls SDK the current API is the **named-parameter** `CometChatCalls.joinSession(callToken:` (or `sessionId:`)`, sessionSettings:, onSuccess:, onError:)` (`cometchat_calls_sdk-5.0.2` `src/plugin/cometchatcalls.dart:735`). The old positional `CometChatCalls.startSession(...)` is `@Deprecated` — do not use it. (If you stay on the kit wrapper `CometChatUIKitCalls`, use its kit-side join API — that is kit-side, not the raw SDK.)
-
----
-
-## Receiver side — kit-based
-
-`CometChatMessageList(group: group)` (or whichever message-list widget V6 ships) auto-renders the meeting message as a "Join meeting" card. Tap → kit calls `generateToken` + pushes the ongoing-call screen.
-
-> Same `navigatorKey` requirement applies on the receiver side for the kit-driven join flow on 6.0.1. With it wired, the join→ongoing transition works; the custom join flow below is the alternative.
-
-## Receiver side — custom UI (alternative)
-
-```dart
-import 'package:flutter_chat_sdk/flutter_chat_sdk.dart';
-
-const groupMeetingListenerId = 'APP_ROOT_GROUP_MEETING_LISTENER';
-
-class MeetingListener {
-  void register({required void Function(IncomingMeetingInfo) onIncoming}) {
-    CometChat.addMessageListener(
-      groupMeetingListenerId,
-      MessageListener(
-        onCustomMessageReceived: (msg) {
-          if (msg.category != MessageCategoryConstants.custom) return;
-          if (msg.type != 'meeting') return;
-
-          final customData = msg.customData ?? {};
-          onIncoming(IncomingMeetingInfo(
-            sessionId: customData['sessionId'] as String? ?? msg.receiverUid,
-            callType: customData['callType'] as String? ?? 'video',
-            fromUid: msg.sender?.uid ?? 'unknown',
-            groupGuid: msg.receiverUid,
-          ));
-        },
-      ),
-    );
-  }
-
-  void unregister() => CometChat.removeMessageListener(groupMeetingListenerId);
-}
-```
-
-In a Bloc-based app, dispatch an event into your CallBloc; the listener's `onIncoming` callback wraps the Bloc emit.
-
-Register AFTER `CometChatUIKit.login` succeeds (e.g. in the auth Bloc's `_onLoginSuccess` state transition).
-
----
-
-## Edge cases
-
-### V6 calls status (resolved)
-
-The beta2 outgoing-call → in-call transition bug is **FIXED in 6.0.1 GA** (validated 2026-05-27 on Pixel 3 — see SKILL.md §1.7). Production Flutter customers can use V6 for both 1:1 and group calls; the only requirement is the `navigatorKey: CallNavigationContext.navigatorKey` MaterialApp wiring.
-
-### Late joining
-
-Meeting persists in chat. Tap any time to join.
-
-### Push notifications
-
-Meeting `CustomMessage.metadata.pushNotification = "meeting"` — delivered as regular FCM/APNs. To get CallKit/ConnectionService ring on iOS/Android, intercept the push and route to `flutter_callkit_incoming` manually.
-
----
-
-## Anti-patterns
-
-1. **Only `CometChat.addCallListener` registered.** Won't fire for groups.
-2. **Using the kit's group call screen WITHOUT wiring `navigatorKey`.** The screen never renders. Wire `CallNavigationContext.navigatorKey` (the beta2 transition bug itself is fixed in 6.0.1).
-3. **`CometChat.endCall(sessionId)` after group hangup.** No call entity.
-4. **`MessageListener` registered before login.** Silently dropped.
-5. **Skipping `navigatorKey` setup** for any kit-driven call path.
-
----
-
-## Verification checklist
-
-- [ ] V6 SKILL.md §1.7 `navigatorKey` requirement met (MaterialApp has CallNavigationContext.navigatorKey)
-- [ ] If kit caller: `CometChatCallButtons(group: group)` — but verify outgoing-call transition works post-vendor-fix
-- [ ] If custom caller: `CometChat.sendCustomMessage(type: 'meeting', category: custom, customData: {callType, sessionId})`
-- [ ] If kit receiver: `CometChatMessageList(group: group)` — see V6 vendor blocker caveat
-- [ ] If custom receiver: `CometChat.addMessageListener` registered AFTER login with category+type filter
-- [ ] On hangup: `CometChatUIKitCalls.endSession()` only
-- [ ] Late-joining tested
-- [ ] Push notifications fire for offline members
-
----
-
-## Pointers
-
-- `cometchat-flutter-v6-calls/SKILL.md` §1.7 — `navigatorKey` requirement + V6 vendor blocker context
-- `ringing-integration.md` — 1:1 user calls (different channel)
-- Cross-platform reference (semantic ground-truth): `cometchat-react-calls/references/group-calls.md`
-- Canonical docs: https://www.cometchat.com/docs/calls/flutter/group-calls