@cometchat/skills 4.3.0 → 4.4.0

package/skills/cometchat-android-v6-push/SKILL.md

@@ -3,13 +3,14 @@ name: cometchat-android-v6-push
 description: "CometChat Android UIKit v6 push notifications — FCM setup, chat/call notification handling, VoIP integration, and deep-linking"
 license: "MIT"
 compatibility: "Android 9.0+ (API 28); Kotlin 1.9+; com.cometchat:chatuikit-compose-android:6.x / com.cometchat:chatuikit-kotlin-android:6.x"
-allowed-tools: "shell, file-read, file-search, file-list"
 metadata:
   author: "CometChat"
   version: "3.0.0"
   tags: "cometchat, android, push, fcm, firebase, voip, notifications, calls"
 ---
 
+> **Ground truth:** `com.cometchat:chatuikit-{compose,kotlin}-android:6.x` (+ `calls-sdk-android:5.x`) — resolved AAR (javap) + `ui-kit/android/v6`. **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.
+
 > **Companion skills:** cometchat-android-v6-core (init/login), cometchat-android-v6-events (call events), cometchat-android-v6-builder-settings (calling config)
 
 ## Purpose
@@ -58,9 +59,49 @@ Add `google-services.json` to your app module's root directory.
 FirebaseApp.initializeApp(this)
 ```
 
+### 1.3 Register / unregister the push token (the kit's ONLY public push API)
+
+This is the single load-bearing client step. `CometChatNotifications.registerPushToken(...)` binds the FCM token to the logged-in CometChat user; `unregisterPushToken(...)` clears it. The Android `PushPlatforms` constant is **`FCM_ANDROID`** (verified in `com.cometchat.chat.enums.PushPlatforms` — the only Android value). Everything in §2 onward is sample-app glue you control; *this* is the real API.
+
+```kotlin
+import com.cometchat.chat.core.CometChatNotifications
+import com.cometchat.chat.enums.PushPlatforms
+import com.cometchat.chat.exceptions.CometChatException
+import com.google.firebase.messaging.FirebaseMessaging
+
+// Call AFTER CometChatUIKit.login(...) resolves (a token registered before
+// login is not bound to a user). Also call from FCMService.onNewToken when a
+// session already exists (token rotation).
+fun registerPushToken() {
+    FirebaseMessaging.getInstance().token.addOnCompleteListener { task ->
+        if (!task.isSuccessful) return@addOnCompleteListener
+        CometChatNotifications.registerPushToken(
+            task.result,
+            PushPlatforms.FCM_ANDROID,
+            "YOUR_PROVIDER_ID",  // FCM Provider ID from the CometChat dashboard (§4 setup)
+            object : CometChat.CallbackListener<String>() {
+                override fun onSuccess(s: String?) { /* registered */ }
+                override fun onError(e: CometChatException) { /* log + retry */ }
+            }
+        )
+    }
+}
+
+// Call BEFORE CometChatUIKit.logout() — otherwise the logged-out device keeps
+// receiving pushes for the previous user.
+fun unregisterPushToken(onDone: () -> Unit) {
+    CometChatNotifications.unregisterPushToken(object : CometChat.CallbackListener<String>() {
+        override fun onSuccess(s: String?) { onDone() }
+        override fun onError(e: CometChatException) { onDone() } // proceed with logout regardless
+    })
+}
+```
+
+Lifecycle: **register after login resolves** (and on `onNewToken` when a session exists), **unregister before logout**. This mirrors the verified `cometchat-android-v5-push` pattern — the registration API is identical across v5/v6 (it lives in the Chat SDK, not the UI Kit).
+
 ## 2. FCMService Implementation
 
-> **Heads-up — this is a reference pattern.** The classes referenced below (`CometChatVoIP`, `CometChatVoIPConnectionService`, `FCMMessageDTO`, `FCMCallDto`, `FCMService`, `VoIPPermissionListener`, `CometChatVoIPUtils`, `FCMMessageNotificationUtils`) are NOT exported from `com.cometchat:chatuikit-{compose,kotlin}-android:6.x`. They live in the `master-app-jetpack` sample app — copy the relevant source files into your project, or use them as a guide for writing your own equivalents. The kit's only public push surface is `CometChatNotifications.registerPushToken(...)` / `unregisterPushToken(...)`; everything below is glue you control.
+> **Heads-up — this is a reference pattern.** The classes referenced below (`CometChatVoIP`, `CometChatVoIPConnectionService`, `FCMMessageDTO`, `FCMCallDto`, `FCMService`, `VoIPPermissionListener`, `CometChatVoIPUtils`, `FCMMessageNotificationUtils`) are NOT exported from `com.cometchat:chatuikit-{compose,kotlin}-android:6.x`. They are sample-app glue (derived from the CometChat Android push sample app — note: not present in the v6 kit clone, so treat them as a copy-in/reference pattern) — copy the relevant source files into your project, or use them as a guide for writing your own equivalents. The kit's only public push surface is `CometChatNotifications.registerPushToken(...)` / `unregisterPushToken(...)`; everything below is glue you control.
 
 Pattern from `master-app-jetpack/fcm/FCMService.kt` (sample-app code, copy into your project):
 

package/skills/cometchat-android-v6-testing/SKILL.md

@@ -3,13 +3,14 @@ name: cometchat-android-v6-testing
 description: "CometChat Android UIKit v6 testing — unit testing ViewModels, Compose UI testing, Espresso, Maestro, and CI configuration"
 license: "MIT"
 compatibility: "Android 9.0+ (API 28); Kotlin 1.9+; com.cometchat:chatuikit-compose-android:6.x / com.cometchat:chatuikit-kotlin-android:6.x"
-allowed-tools: "shell, file-read, file-search, file-list"
 metadata:
   author: "CometChat"
   version: "3.0.0"
   tags: "cometchat, android, testing, junit, kotest, compose-testing, espresso, maestro"
 ---
 
+> **Ground truth:** `com.cometchat:chatuikit-{compose,kotlin}-android:6.x` (+ `calls-sdk-android:5.x`) — resolved AAR (javap) + `ui-kit/android/v6`. **Official docs:** https://www.cometchat.com/docs/ui-kit/android/v6/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.
+
 > **Companion skills:** cometchat-android-v6-extensions (ViewModel/DataSource architecture), cometchat-android-v6-compose-components, cometchat-android-v6-kotlin-components
 
 ## Purpose
@@ -111,7 +112,7 @@ fun `emitting message event is received by collector`() = runTest {
         CometChatEvents.messageEvents.collect { events.add(it) }
     }
 
-    CometChatEvents.emitMessageEventSync(
+    CometChatEvents.emitMessageEvent(
         CometChatMessageEvent.MessageSent(mockMessage, MessageStatus.SUCCESS)
     )
 
@@ -195,13 +196,15 @@ import io.kotest.property.forAll
 import io.kotest.property.Arb
 import io.kotest.property.arbitrary.string
 
-class BubbleFactoryKeyTest : FunSpec({
+class BubbleFactoryTest : FunSpec({
 
-    test("factory key format is always category_type") {
-        forAll(Arb.string(1..20), Arb.string(1..20)) { category, type ->
-            val key = BubbleFactory.getKey(category, type)
-            key == "${category}_${type}"
-        }
+    // NOTE: BubbleFactory has NO public getKey(category, type) helper — a factory
+    // is matched purely by the getCategory()/getType() pair it overrides. Test that
+    // your custom factory reports the category/type it intends to handle.
+    test("custom BubbleFactory reports its target category and type") {
+        val factory = MyPollBubbleFactory()   // your BubbleFactory subclass
+        factory.getCategory() shouldBe "custom"
+        factory.getType() shouldBe "extension_poll"
     }
 })
 ```

package/skills/cometchat-android-v6-troubleshooting/SKILL.md

@@ -3,13 +3,14 @@ name: cometchat-android-v6-troubleshooting
 description: "CometChat Android UIKit v6 troubleshooting — diagnostic table, common issues, and fixes for both Kotlin Views and Compose stacks"
 license: "MIT"
 compatibility: "Android 9.0+ (API 28); Kotlin 1.9+; com.cometchat:chatuikit-compose-android:6.x / com.cometchat:chatuikit-kotlin-android:6.x"
-allowed-tools: "shell, file-read, file-search, file-list"
 metadata:
   author: "CometChat"
   version: "3.0.1"
   tags: "cometchat, android, troubleshooting, debugging, errors, issues"
 ---
 
+> **Ground truth:** `com.cometchat:chatuikit-{compose,kotlin}-android:6.x` (+ `calls-sdk-android:5.x`) — resolved AAR (javap) + `ui-kit/android/v6`. **Official docs:** https://www.cometchat.com/docs/ui-kit/android/v6/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.
+
 > **Companion skills:** cometchat-android-v6-core (init/login), cometchat-android-v6-compose-theming, cometchat-android-v6-kotlin-theming, cometchat-android-v6-push
 
 ## Purpose
@@ -49,6 +50,7 @@ Diagnose and fix common issues with CometChat Android UIKit v6 across both Kotli
 | Call notifications not showing | VoIP permissions missing | Request READ_PHONE_STATE, MANAGE_OWN_CALLS, ANSWER_PHONE_CALLS |
 | Calls SDK not initialized | `enableCalling` not set | Set `setEnableCalling(true)` on `UIKitSettingsBuilder` |
 | `CometChatCalls` class not found | Missing calls SDK dependency | Add `com.cometchat:calls-sdk-android` to dependencies |
+| Calls broken on `chatuikit:6.0.0` (call button targets wrong user, in-call screen blank, etc.) | Known v6.0.0 calls defects — `CometChatCallButtons` captures the first-rendered user globally + 4 related bugs | Apply the **5 documented workarounds (W1–W5)** in `cometchat-android-v6-calls` (§"Five required workarounds"). The kit ships broken for calls at 6.0.0 but works end-to-end with W1–W5 (validated on device). Don't hand-patch blind — use that section. |
 | Build fails with duplicate classes | Conflicting annotation libs | Add `exclude(group = "org.jetbrains", module = "annotations-java5")` to configurations |
 | `compileSdk` error | SDK too low | Set `compileSdk = 36` |
 | `minSdk` error | API level too low | Set `minSdk = 28` — v6 requires Android 9.0+ |
@@ -155,6 +157,12 @@ If message list doesn't scroll properly, ensure the layout gives it flexible hei
 
 ## 5. Push Notification Issues
 
+### 5.0 No notifications shown on Android 13+ (API 33+)
+
+- **Symptom**: FCM messages arrive (visible in logcat) but no system notification appears on Android 13+.
+- **Cause**: `POST_NOTIFICATIONS` is a **runtime** permission on API 33+ — declaring it in the manifest isn't enough.
+- **Fix**: Declare `<uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>` AND request it at runtime (`ActivityCompat.requestPermissions(...)` / the Activity Result API) before you expect notifications. Below API 33 it's granted implicitly.
+
 ### 5.1 SDK Not Initialized in FCM Service
 
 ```kotlin
@@ -170,11 +178,24 @@ override fun onMessageReceived(message: RemoteMessage) {
 
 ### 5.2 VoIP Permission Check
 
+> ⚠️ **`CometChatVoIP` is NOT a v6 kit/SDK API.** It exists only as an app-local helper in the **V5** sample app; the v6 sample even asserts it must not be referenced (`PreservationPropertyTest.kt:78`). Check the permissions directly with `ContextCompat.checkSelfPermission` (or copy the V5 helper into your project if you want its convenience wrappers):
+
 ```kotlin
-// All three permissions are required for VoIP
-val hasPermissions = CometChatVoIP.hasReadPhoneStatePermission(context) &&
-    CometChatVoIP.hasManageOwnCallsPermission(context) &&
-    CometChatVoIP.hasAnswerPhoneCallsPermission(context)
+import androidx.core.content.ContextCompat
+import android.content.pm.PackageManager
+import android.Manifest
+
+// All three permissions are required for VoIP calling
+fun hasVoipPermissions(context: Context): Boolean {
+    val needed = listOf(
+        Manifest.permission.READ_PHONE_STATE,
+        Manifest.permission.MANAGE_OWN_CALLS,
+        Manifest.permission.ANSWER_PHONE_CALLS,
+    )
+    return needed.all {
+        ContextCompat.checkSelfPermission(context, it) == PackageManager.PERMISSION_GRANTED
+    }
+}
 ```
 
 ## 6. Dependency Conflicts